@linker-design-plus/timeline-track 2.0.22 → 2.0.24

package/dist/core/controllers/previewBackend.d.ts

@@ -26,6 +26,8 @@ export interface TimelinePreviewBackendCallbacks {
     onTextRotationCommit?: (clipId: string, rotation: number) => void;
     onPendingPreviewRetry?: () => void;
     onRuntimeError?: (error: unknown) => void;
+    /** 预览层文字交互（点击字幕或文字变换控件）时若时间线处于播放中，用于请求暂停 */
+    onPauseIfPlaying?: () => void;
 }
 export interface PreviewPendingState {
     mode: 'seek' | 'scrub';

package/dist/core/controllers/previewTransformOverlay.d.ts

@@ -17,6 +17,8 @@ interface PreviewTransformOverlayCallbacks {
     onFontSizeCommit?: (clipId: string, fontSize: number) => void;
     onRotationChange?: (clipId: string, rotation: number | null) => void;
     onRotationCommit?: (clipId: string, rotation: number) => void;
+    /** 文字片段预览变换框上开始拖拽/缩放/旋转（播放中时应暂停） */
+    onTextTransformInteractionStart?: () => void;
 }
 export declare class PreviewTransformOverlay {
     private frameElement;

package/dist/core/controllers/timelinePreviewSession.d.ts

@@ -14,6 +14,7 @@ interface TimelinePreviewSessionCallbacks {
     onTextFontSizeCommit?: (clipId: string, fontSize: number) => void;
     onTextRotationCommit?: (clipId: string, rotation: number) => void;
     onPendingPreviewRetry?: () => void;
+    onPauseIfPlaying?: () => void;
 }
 interface TimelinePreviewSessionDependencies {
     createMediaElement?: (kind: TrackType, role: 'current' | 'preload') => HTMLMediaElement;
@@ -86,7 +87,9 @@ export declare class TimelinePreviewSession {
     private isSyncProjecting;
     private readonly deferredPreloadSlotKeys;
     private deferredPreloadFlushScheduled;
+    private lastSyncedPlayState;
     constructor(callbacks?: TimelinePreviewSessionCallbacks, dependencies?: TimelinePreviewSessionDependencies);
+    private requestPauseIfPlaying;
     private emitDiagnostic;
     private buildSlotTraceData;
     hasPreview(): boolean;

package/dist/core/facade/timelineManager.d.ts

@@ -82,6 +82,8 @@ export declare class TimelineManager {
     private previewSyncInteractionMode;
     private readonly resourceCacheManager;
     private voiceLinkedTextRegenerationTimer;
+    private pendingVoiceLinkedTextRegeneration;
+    private historyRecordingSuppressionDepth;
     constructor(config?: Partial<TimelineConfig>);
     private createPlaybackAttemptId;
     private refreshPlaybackAttempt;
@@ -121,6 +123,9 @@ export declare class TimelineManager {
     private getDefaultTrackForHistory;
     private getTimelineHistoryRecorder;
     private getTimelineHistoryExecutor;
+    private withHistoryBoundary;
+    private shouldSkipHistoryRecording;
+    private withHistoryTransaction;
     private get selectedClipId();
     private set selectedClipId(value);
     private ensureConfigState;
@@ -215,6 +220,8 @@ export declare class TimelineManager {
     private animate;
     private syncPlaybackClockToPreviewBuffering;
     private clearPreviewBufferingSuspendTimeout;
+    /** 播放头不得超过全部片段的最大 endTime（与 canPlay / 播放结束对齐）；无片段时不设上限（由别处处理空轨道） */
+    private clampPlaybackSeekTime;
     setCurrentTime(time: TimeMs): void;
     getCurrentTime(): TimeMs;
     setEnableClipSnap(enabled: boolean): void;
@@ -340,6 +347,9 @@ export declare class TimelineManager {
     private buildGeneratedAudioClipName;
     private normalizeGeneratedAudioDuration;
     private getVoiceLinkedAudioClips;
+    private hasVoiceLinkedAudioClipsToRegenerate;
+    private scheduleVoiceLinkedTextRegeneration;
+    private flushPendingVoiceLinkedTextRegeneration;
     private applyGeneratedAudioClipResult;
     private syncTextClipDurationToAudio;
     private doesClipOverlapOnTrack;
@@ -349,6 +359,7 @@ export declare class TimelineManager {
     private relocateClipToAvoidOverlap;
     private buildClipboardPasteGroups;
     private createTracksForTypeBoundary;
+    private selectBestClipboardPasteStartIndex;
     private buildClipboardPasteGroupPlacementClips;
     private ensureClipboardPasteSourceTracks;
     private resolveClipboardPasteTypeGroupAssignments;
@@ -539,6 +550,14 @@ export declare class TimelineManager {
     private haveSameClipIds;
     private restoreDraggedClipSnapshot;
     private syncMultiDragPeerClips;
+    private createMultiDragPlacementContext;
+    private doesMultiDragPlacementOverlap;
+    private reserveMultiDragPlacement;
+    private registerMultiDragPlacementTrack;
+    private findNearestAvailableTrackForMultiDragPlacement;
+    private resolveMultiDragOverlapTargetTrackId;
+    private commitMultiDragPlacements;
+    private finalizeMultiDragSameTrack;
     private previewMultiDragCrossTrack;
     private finalizeMultiDragCrossTrack;
     private resolveTrackIndexDelta;
@@ -551,7 +570,6 @@ export declare class TimelineManager {
     private ensureTrackIdByRelativeIndex;
     private findTrackIdByRelativeIndex;
     private getTrackIdsByType;
-    private updateClipPositionWithHistory;
     private updateClipPositionSilently;
     private ensureSelectionBoxRect;
     private showSelectionBoxRect;

package/dist/core/history/timelineHistoryRecorder.d.ts

@@ -2,6 +2,7 @@ import { HistoryManager } from '../history/history';
 import type { Action, Clip, ClipStateUpdate, Track, TrackRestoreAnchor } from '../models/types';
 export declare class TimelineHistoryRecorder {
     private readonly history;
+    private readonly transactionStack;
     constructor(history: HistoryManager);
     createAddClipAction(clip: Clip): Action;
     recordAddClip(clip: Clip): Action;
@@ -16,5 +17,10 @@ export declare class TimelineHistoryRecorder {
     createSeparateClipAudioAction(videoClipBefore: Clip, videoClipAfter: Clip, audioClip: Clip | null, audioTrackId: string | null): Action;
     createRestoreClipAudioAction(videoClipBefore: Clip, videoClipAfter: Clip, audioClip: Clip | null, audioTrackId: string | null): Action;
     recordCompoundAction(actions: Action[], label?: string): Action | null;
-    private createClipUpdateAction;
+    createClipUpdateAction(clip: Clip, originalClip?: Clip, clipUpdates?: ClipStateUpdate[]): Action | null;
+    withTransaction<T>(label: string | undefined, callback: () => T): T;
+    withTransaction<T>(label: string | undefined, callback: () => Promise<T>): Promise<T>;
+    recordAction(action: Action): Action;
+    private finalizeTransaction;
+    private normalizeTransactionActions;
 }