@linker-design-plus/timeline-track 2.0.13 → 2.0.14

package/README.md

@@ -103,6 +103,9 @@ timeline.on('history_change', (_event, data) => {
 
 - 播放 / 暂停：`Space`
 - 删除片段：`Delete` / `Backspace`
+- 复制片段：`Mod+C`
+- 剪切片段：`Mod+X`
+- 粘贴片段：`Mod+V`
 - 分离 / 还原音频：`Mod+Alt+A`
 - 分割片段：`Mod+B`
 - 撤销：`Mod+Z`

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

@@ -1,5 +1,6 @@
 import type { ActiveClipPlaybackInfo, Clip, ClipVisualTransform, PlayState, PreviewAspectRatio, PreviewMediaSource, PreviewSourceResolver, TextPreviewFontConfig, TimeMs } from '../models/types';
 import type { SourceMediaRegistry } from '../resources/sourceMediaRegistry';
+import type { DiagnosticsCenter, DiagnosticEmitInput } from '../../utils/diagnostics';
 export interface TimelinePreviewSyncPayload {
     activeClips: ActiveClipPlaybackInfo[];
     nextClips: ActiveClipPlaybackInfo[];
@@ -8,6 +9,7 @@ export interface TimelinePreviewSyncPayload {
     currentTime: TimeMs;
     playState: PlayState;
     speed: number;
+    interactionMode?: 'steady' | 'seek' | 'scrub';
     primarySelectedClipId?: string | null;
     syncRequestId?: number;
 }
@@ -69,6 +71,8 @@ export interface TimelinePreviewBackendOptions {
     previewSourceResolver?: PreviewSourceResolver;
     textPreviewFont?: TextPreviewFontConfig | null;
     sourceMediaRegistry?: SourceMediaRegistry;
+    diagnostics?: DiagnosticsCenter;
+    getDiagnosticsContext?: () => Partial<DiagnosticEmitInput>;
     rootClassName?: string;
     frameClassName?: string;
     slotClassNamePrefix?: string;

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

@@ -2,11 +2,17 @@ import type { TimelineKeyboardShortcutsConfig } from '../models';
 export interface TimelineKeyboardShortcutsControllerCallbacks {
     togglePlay(): void;
     deleteSelectedClips(): void;
+    copySelectedClips(): void;
+    cutSelectedClips(): void;
+    pasteClipboardClips(): Promise<boolean> | boolean;
     toggleSelectedClipsAudio(): Promise<boolean>;
     splitCurrentClip(): void;
     undo(): boolean;
     redo(): boolean;
     canDeleteSelectedClips(): boolean;
+    canCopySelectedClips(): boolean;
+    canCutSelectedClips(): boolean;
+    canPasteClipboardClips(): boolean;
     canSplitSelectedClip(): boolean;
     canToggleSelectedClipsAudio(): boolean;
 }

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

@@ -1,6 +1,7 @@
 import type { ActiveClipPlaybackInfo, ClipVisualTransform, PlayState, PreviewAspectRatio, PreviewSourceResolver, TextPreviewFontConfig, TimeMs, TrackType } from '../models/types';
 import type { SourceMediaRegistry } from '../resources/sourceMediaRegistry';
 import type { PreviewPendingState, PreviewRuntimeState } from './previewBackend';
+import { type DiagnosticEmitInput, type DiagnosticsCenter } from '../../utils/diagnostics';
 interface TimelinePreviewSessionCallbacks {
     onBufferingStateChange?: (isBuffering: boolean) => void;
     onSourceLoadingChange?: (pending: number) => void;
@@ -14,6 +15,8 @@ interface TimelinePreviewSessionDependencies {
     createMediaElement?: (kind: TrackType, role: 'current' | 'preload') => HTMLMediaElement;
     createAspectRatioProbe?: () => HTMLVideoElement;
     createAudioContext?: () => AudioContext | null;
+    diagnostics?: DiagnosticsCenter;
+    getDiagnosticsContext?: () => Partial<DiagnosticEmitInput>;
     rootClassName?: string;
     frameClassName?: string;
     slotClassNamePrefix?: string;
@@ -29,6 +32,7 @@ export interface TimelinePreviewSyncPayload {
     currentTime: TimeMs;
     playState: PlayState;
     speed: number;
+    interactionMode?: 'steady' | 'seek' | 'scrub';
     primarySelectedClipId?: string | null;
     syncRequestId?: number;
 }
@@ -73,8 +77,10 @@ export declare class TimelinePreviewSession {
     private pendingState;
     private activeSyncRequestId;
     private isSyncProjecting;
+    private readonly deferredPreloadSlotKeys;
+    private deferredPreloadFlushScheduled;
     constructor(callbacks?: TimelinePreviewSessionCallbacks, dependencies?: TimelinePreviewSessionDependencies);
-    private logLoadTrace;
+    private emitDiagnostic;
     private buildSlotTraceData;
     hasPreview(): boolean;
     attach(container: HTMLElement): void;
@@ -85,6 +91,7 @@ export declare class TimelinePreviewSession {
     getAspectRatio(): PreviewAspectRatio;
     private createMediaElement;
     private createSlot;
+    private resetSlotRecoveryTracking;
     private destroySlot;
     private getTrackSlots;
     private swapTrackSlots;
@@ -95,8 +102,24 @@ export declare class TimelinePreviewSession {
     private slotNeedsRecovery;
     private recoverSlot;
     private finishSlotRecovery;
+    private getSlotKey;
+    private isActiveCurrentSlot;
+    private hasBlockingActiveCurrentSlot;
+    private shouldDeferPreloadTarget;
+    private shouldDeferPreloadRecovery;
+    private buildDeferredPreloadTarget;
+    private deferPreloadTarget;
+    private deferPreloadRecovery;
+    private scheduleDeferredPreloadFlush;
+    private flushDeferredPreloads;
     private applyResolvedSlotState;
     private isCurrentRequest;
+    private shouldIgnoreExpectedEmptied;
+    private shouldIgnoreExpectedAbort;
+    private shouldIgnoreClearedSlotRecoverableEvent;
+    private shouldSkipImmediatePreloadRecovery;
+    private isBackgroundPreloadSlot;
+    private parkPreloadSlot;
     private failSlot;
     private configureAudioRouting;
     private syncCurrentSlot;

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

@@ -2,6 +2,7 @@ import { type TimelinePreviewBackend } from '../controllers';
 import { TimelineConfig, Clip, ClipConfig, TimeMs, PlayState, Action, TimelineEvent, EventListener as TimelineEventListener, TimelineExportData, Track as TrackEntity, ThumbnailProvider, TrackInsertionPlacement, TrackType, ActiveClipPlaybackInfo, PreviewAspectRatio, PreviewMountConfig, PreviewBackendType, SelectedClipAudioAction, ClipConfigVoicePanelOptions } from '../models';
 import type { ResolvedPlaybackPlan } from '../controllers/timelinePlaybackResolver';
 import { TimelineClipConfigController } from '../controllers/timelineClipConfigController';
+import { type DiagnosticExportPackage, type DiagnosticLiveSnapshot, type DiagnosticsListener, type DiagnosticsLiveListener, type DiagnosticSessionSnapshot } from '../../utils/diagnostics';
 export declare class TimelineManager {
     private timeline;
     private tracks;
@@ -63,13 +64,27 @@ export declare class TimelineManager {
     private readonly bodyCanvasHostClickListener;
     private readonly rootWheelListener;
     private keyboardShortcutsController;
+    private clipClipboard;
     private mountManager;
     private pendingDraftData;
     private selectionStore;
     private multiDragSession;
     private clipRemovalBatchDepth;
     private splitOperationDepth;
+    private readonly diagnostics;
+    private diagnosticsPanel;
+    private previewRuntimeState;
+    private previewActiveClipIds;
+    private playbackAttemptId;
+    private lastPreviewSyncedPlayState;
+    private previewSyncInteractionMode;
     constructor(config?: Partial<TimelineConfig>);
+    private createPlaybackAttemptId;
+    private refreshPlaybackAttempt;
+    private emitDiagnostic;
+    private buildDiagnosticsRuntimeState;
+    private buildPreviewDiagnosticsContext;
+    private mountDiagnosticsPanel;
     private getTimelineStore;
     private getTimelineCommands;
     private getTrackCollection;
@@ -141,6 +156,7 @@ export declare class TimelineManager {
     private getAutoAspectRatioClip;
     private registerPreviewAutoAspectRatioClip;
     private syncPreviewSession;
+    private syncPreviewPlaybackStateIfNeeded;
     private beginPendingPreview;
     updatePendingPreviewState(): void;
     private buildPreviewPendingState;
@@ -321,9 +337,20 @@ export declare class TimelineManager {
     private applyGeneratedAudioClipResult;
     private syncTextClipDurationToAudio;
     private doesClipOverlapOnTrack;
+    private doesClipGroupOverlapOnTrack;
     private findNearestAvailableTrackForClip;
-    private relocateGeneratedAudioClipIfNeeded;
+    private resolveOverlapRelocationTargetTrackId;
+    private relocateClipToAvoidOverlap;
+    private buildClipboardPasteGroups;
+    private createTracksForTypeBoundary;
+    private buildClipboardPasteGroupPlacementClips;
+    private ensureClipboardPasteSourceTracks;
+    private resolveClipboardPasteTypeGroupAssignments;
+    private resolvePreferredTrackIndexForPasteGroup;
+    private resolveClipboardPasteTrackAssignments;
+    private relocateClipIfNeeded;
     private regenerateVoiceLinkedAudioClips;
+    private getSelectedTextClipsForVoiceGeneration;
     private handleVoiceGenerateAction;
     private primeOrLoadClipThumbnails;
     private markClipThumbnailLoadCompleted;
@@ -383,6 +410,15 @@ export declare class TimelineManager {
     toggleSelection(clipId: string): void;
     isClipSelected(clipId: string): boolean;
     deleteSelectedClips(): void;
+    copySelectedClips(): boolean;
+    cutSelectedClips(): boolean;
+    pasteClipboardClips(): Promise<boolean>;
+    private deleteSelectedClipsWithHistoryLabel;
+    private captureSelectedClipsToClipboard;
+    private cloneClipForClipboard;
+    private buildClipboardPasteClipConfig;
+    private resolveClipboardPasteTrackId;
+    private generateClipId;
     separateSelectedClipsAudio(): void;
     selectAllClips(): void;
     private emitSelectionChangeEvent;
@@ -406,6 +442,9 @@ export declare class TimelineManager {
     getSelectedClip(): Clip | null;
     getPrimarySelectedClip(): Clip | null;
     getSelectedClips(): Clip[];
+    canCopySelectedClips(): boolean;
+    canCutSelectedClips(): boolean;
+    canPasteClipboardClips(): boolean;
     canDeleteSelectedClips(): boolean;
     canSplitSelectedClip(): boolean;
     getSelectedClipAudioAction(): SelectedClipAudioAction;
@@ -421,6 +460,12 @@ export declare class TimelineManager {
     getPreviewBackendType(): Exclude<PreviewBackendType, 'auto'>;
     hasAttachedPreview(): boolean;
     getPreviewAspectRatio(): PreviewAspectRatio;
+    getDiagnosticsSnapshot(): DiagnosticSessionSnapshot;
+    subscribeDiagnostics(listener: DiagnosticsListener): () => void;
+    getDiagnosticsLiveSnapshot(recentEventLimit?: number): DiagnosticLiveSnapshot;
+    subscribeDiagnosticsLive(listener: DiagnosticsLiveListener, recentEventLimit?: number): () => void;
+    exportDiagnosticsPackage(): DiagnosticExportPackage;
+    clearDiagnostics(sessionOnly?: boolean): void;
     setPreviewAspectRatio(aspectRatio: {
         width: number;
         height: number;

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

@@ -3,6 +3,7 @@ import type { Action, Clip, ClipStateUpdate, Track, TrackRestoreAnchor } from '.
 export declare class TimelineHistoryRecorder {
     private readonly history;
     constructor(history: HistoryManager);
+    createAddClipAction(clip: Clip): Action;
     recordAddClip(clip: Clip): 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;

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

@@ -1,12 +1,8 @@
+export type { DiagnosticEvent, DiagnosticExportPackage, DiagnosticLiveEvent, DiagnosticLiveSnapshot, DiagnosticsConfig, DiagnosticsLiveListener, DiagnosticSessionSnapshot } from '../../utils/diagnostics/types';
+import type { DiagnosticsConfig } from '../../utils/diagnostics/types';
 export type TrackType = 'video' | 'audio' | 'text';
 export type PlayState = 'playing' | 'paused';
 export type TimeMs = number;
-export type LogLevel = 'debug' | 'info' | 'warn' | 'error';
-export interface LogConfig {
-    enabled?: boolean;
-    level?: LogLevel;
-    moduleLevels?: Record<string, LogLevel>;
-}
 export interface ThumbnailProvider {
     /**
      * 获取片段的封面图片
@@ -187,7 +183,7 @@ export type ThemeConfig = Partial<Theme>;
 export type ResolvedTimelineConfig = Omit<TimelineConfig, 'theme'> & {
     theme: Theme;
 };
-export type TimelineKeyboardShortcutAction = 'togglePlay' | 'deleteSelectedClips' | 'toggleSelectedClipsAudio' | 'splitCurrentClip' | 'undo' | 'redo';
+export type TimelineKeyboardShortcutAction = 'togglePlay' | 'deleteSelectedClips' | 'copySelectedClips' | 'cutSelectedClips' | 'pasteClipboardClips' | 'toggleSelectedClipsAudio' | 'splitCurrentClip' | 'undo' | 'redo';
 export type TimelineKeyboardShortcutBindings = Partial<Record<TimelineKeyboardShortcutAction, string | string[]>>;
 export interface TimelineKeyboardShortcutsConfig {
     enabled?: boolean;
@@ -203,7 +199,7 @@ export interface TimelineConfig {
     container?: HTMLElement;
     theme?: ThemeConfig;
     timeScaleHeight?: number;
-    logConfig?: LogConfig;
+    diagnostics?: DiagnosticsConfig;
     speed?: number;
     dragActivationThreshold?: number;
     enableClipSnap?: boolean;
@@ -453,7 +449,7 @@ export interface EventListener {
 export interface TimelineManagerConfig {
     initialDuration?: TimeMs;
     initialZoom?: number;
-    logConfig?: LogConfig;
+    diagnostics?: DiagnosticsConfig;
     thumbnailProvider?: ThumbnailProvider;
 }
 export interface TimelineExportData {