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

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

@@ -58,10 +58,10 @@ export declare class TimelineManager {
     private previewStateController?;
     private previewPlaybackSuspendedByBuffering;
     private previewPlaybackAutoResume;
-    private previewBufferingSuspendTimeoutId;
     private lastSelectedClipId;
     private previewAspectRatio;
     private readonly bodyViewportScrollListener;
+    private stageMouseDownListener;
     private readonly bodyCanvasHostClickListener;
     private readonly rootWheelListener;
     private keyboardShortcutsController;
@@ -106,10 +106,7 @@ export declare class TimelineManager {
     set runtimePreviewBackendOverride(value: Exclude<PreviewBackendType, 'auto'> | null);
     get activePreviewCallbackToken(): number;
     set activePreviewCallbackToken(value: number);
-    private get previewSourceLoadingCount();
-    private set previewSourceLoadingCount(value);
-    get previewBuffering(): boolean;
-    set previewBuffering(value: boolean);
+    private getPreviewLoadingState;
     private get pendingPreviewState();
     private set pendingPreviewState(value);
     get nextPendingPreviewSyncRequestId(): number;
@@ -159,7 +156,8 @@ export declare class TimelineManager {
     private getTracksSortedByOrder;
     private getPlaybackTracksSnapshot;
     private buildPlaybackPlan;
-    private hasTimelineVideoClip;
+    private playbackPlanHasActiveVideoClip;
+    private hasActiveTimelineVideoClip;
     private getPreviewAutoAspectRatioClipOrderMap;
     private getNextPreviewAutoAspectRatioOrder;
     private getAutoAspectRatioClip;
@@ -167,11 +165,18 @@ export declare class TimelineManager {
     private buildPreviewSyncSignature;
     private shouldSkipSteadyPlaybackPreviewSync;
     private syncPreviewSession;
+    private resolvePreviewSyncPlayState;
     private syncPreviewPlaybackStateIfNeeded;
+    private shouldUsePreviewClockPlayback;
+    private handlePreviewClockStateChange;
+    private isPreviewClockForCurrentActiveClip;
+    private shouldCommitUnavailablePreviewClock;
+    private commitPlaybackTimeFromPreviewClock;
+    private syncPreviewAfterPreviewClockCommitIfNeeded;
+    private resumeWallClockPlaybackIfPreviewClockUnavailable;
     private beginPendingPreview;
     updatePendingPreviewState(): void;
     private buildPreviewPendingState;
-    private buildPreviewIndicatorState;
     private clearPendingPreviewState;
     private resetPreviewRuntimeState;
     private destroyPreviewSession;
@@ -218,8 +223,12 @@ export declare class TimelineManager {
     pause(): void;
     togglePlay(): void;
     private animate;
-    private syncPlaybackClockToPreviewBuffering;
-    private clearPreviewBufferingSuspendTimeout;
+    private cancelPlaybackAnimationFrame;
+    private emitPlayStateChangeEvent;
+    private suspendPlaybackForMediaPending;
+    private resumePlaybackAfterMediaPending;
+    private shouldSuspendPreviewPlaybackForLoadingState;
+    private syncPlaybackClockToPreviewLoadingState;
     /** 播放头不得超过全部片段的最大 endTime（与 canPlay / 播放结束对齐）；无片段时不设上限（由别处处理空轨道） */
     private clampPlaybackSeekTime;
     setCurrentTime(time: TimeMs): void;
@@ -346,6 +355,9 @@ export declare class TimelineManager {
     private findClipById;
     private buildGeneratedAudioClipName;
     private normalizeGeneratedAudioDuration;
+    private resolveVoiceTextContent;
+    private findSourceTextClipForTtsAudio;
+    private resolveTtsAudioVoiceGenerationSource;
     private getVoiceLinkedAudioClips;
     private hasVoiceLinkedAudioClipsToRegenerate;
     private scheduleVoiceLinkedTextRegeneration;

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

@@ -37,7 +37,7 @@ export declare class HistoryManager {
     /**
      * 创建添加片段操作
      */
-    createAddClipAction(clip: Clip): AddClipAction;
+    createAddClipAction(clip: Clip, targetTrackId?: string | null, targetTrackSnapshot?: Track | null, targetTrackRestoreAnchor?: TrackRestoreAnchor | null): AddClipAction;
     /**
      * 创建移除片段操作
      */

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

@@ -23,6 +23,7 @@ export declare class TimelineHistoryExecutor {
     private executeRedoInternal;
     private restoreMovedClip;
     private normalizeRemoveClipActionData;
+    private normalizeAddClipActionData;
     private resolveTrackIdForHistorySnapshot;
     private resolveRestoreAnchor;
 }

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

@@ -4,8 +4,8 @@ export declare class TimelineHistoryRecorder {
     private readonly history;
     private readonly transactionStack;
     constructor(history: HistoryManager);
-    createAddClipAction(clip: Clip): Action;
-    recordAddClip(clip: Clip): Action;
+    createAddClipAction(clip: Clip, targetTrackId?: string | null, targetTrackSnapshot?: Track | null, targetTrackRestoreAnchor?: TrackRestoreAnchor | null): Action;
+    recordAddClip(clip: Clip, targetTrackId?: string | null, targetTrackSnapshot?: Track | null, targetTrackRestoreAnchor?: TrackRestoreAnchor | null): Action;
     createRemoveClipAction(clip: Clip, sourceTrackId?: string | null, sourceTrackSnapshot?: Track | null, sourceTrackRestoreAnchor?: TrackRestoreAnchor | null): Action;
     recordRemoveClip(clip: Clip, sourceTrackId?: string | null, sourceTrackSnapshot?: Track | null, sourceTrackRestoreAnchor?: TrackRestoreAnchor | null): Action;
     recordClipUpdate(clip: Clip, originalClip?: Clip, clipUpdates?: ClipStateUpdate[]): Action | null;

package/dist/core/models/constants.d.ts

@@ -9,6 +9,20 @@ export declare const ZOOM_PRESETS: {
     LARGE: number;
     MAX: number;
 };
+export declare const DEFAULT_TIMELINE_DURATION_MS = 3600000;
+export declare const ZOOM_GESTURE: {
+    SENSITIVITY_FACTOR: number;
+    CONVERGENCE_THRESHOLD: number;
+};
+export declare const DEFAULT_TEXT_CLIP_DURATION_MS = 3000;
+export declare const VOICE_LINKED_TEXT_REGEN_DEBOUNCE_MS = 450;
+export declare const SNAP_SCORING: {
+    ANCHOR_INDEX_WEIGHT: number;
+};
+export declare const TEXT_CLIP_FONT_SIZE_LIMITS: {
+    MIN: number;
+    MAX: number;
+};
 export declare const ZOOM_ANIMATION: {
     DURATION: number;
     EASING: string;

package/dist/core/models/types.d.ts

@@ -58,6 +58,8 @@ export interface VoiceOption {
     audiofile?: string;
     source?: Record<string, unknown>;
 }
+export declare function isAudioOnlyTtsClipCandidate(clip: Pick<ClipConfig, 'type' | 'textContent' | 'ttsVoiceId'> | Pick<ClipEntity, 'type' | 'textContent' | 'ttsVoiceId'> | Pick<Clip, 'type' | 'textContent' | 'ttsVoiceId'>): boolean;
+export declare function isTtsAudioClip(clip: Pick<ClipConfig, 'type' | 'ttsSourceTextClipId' | 'textContent' | 'ttsVoiceId'> | Pick<ClipEntity, 'type' | 'ttsSourceTextClipId' | 'textContent' | 'ttsVoiceId'> | Pick<Clip, 'type' | 'ttsSourceTextClipId' | 'textContent' | 'ttsVoiceId'>): boolean;
 export interface GenerateVoiceRequest {
     requestId: string;
     sourceTextClipId: string;
@@ -270,9 +272,15 @@ export interface ClipStateUpdate {
     newState: Clip;
     previousState: Clip;
 }
+export type AddClipActionData = Clip | {
+    clip: Clip;
+    targetTrackId: string | null;
+    targetTrackSnapshot: Track | null;
+    targetTrackRestoreAnchor: TrackRestoreAnchor | null;
+};
 export interface AddClipAction {
     type: 'add_clip';
-    data: Clip;
+    data: AddClipActionData;
     timestamp: number;
 }
 export interface RemoveClipAction {
@@ -404,7 +412,7 @@ export interface HistoryState {
     past: Action[];
     future: Action[];
 }
-export type TimelineEvent = 'time_change' | 'play_state_change' | 'clip_added' | 'clip_removed' | 'clip_updated' | 'zoom_change' | 'history_change' | 'track_duration_change' | 'clip_selected' | 'selected_clip_change' | 'speed_change' | 'can_play_change' | 'buffering_state_change' | 'source_loading_change' | 'preview_aspect_ratio_change' | 'draft_loaded' | 'selection_change';
+export type TimelineEvent = 'time_change' | 'play_state_change' | 'clip_added' | 'clip_removed' | 'clip_updated' | 'zoom_change' | 'history_change' | 'track_duration_change' | 'clip_selected' | 'selected_clip_change' | 'speed_change' | 'can_play_change' | 'loading_state_change' | 'preview_aspect_ratio_change' | 'draft_loaded' | 'selection_change';
 export interface TimeChangeData {
     time: TimeMs;
 }
@@ -437,12 +445,12 @@ export interface ClipRemovedEventData {
 export interface CanPlayChangeData {
     canPlay: boolean;
 }
-export interface BufferingStateChangeData {
-    isBuffering: boolean;
-}
-export interface SourceLoadingChangeData {
+export type LoadingStateStatus = 'idle' | 'loading' | 'ready' | 'failed';
+export type LoadingStateReason = 'syncing' | 'resolving-source' | 'seeking' | 'media-pending' | 'failed' | null;
+export interface LoadingStateChangeData {
+    status: LoadingStateStatus;
     isLoading: boolean;
-    pending: number;
+    reason: LoadingStateReason;
 }
 export interface PreviewAspectRatioChangeData {
     aspectRatio: PreviewAspectRatio;