@linker-design-plus/timeline-track 2.0.21 → 2.0.23

package/dist/components/panel/ClipConfigPanel.d.ts

@@ -13,6 +13,17 @@ export interface ClipConfigPanelTheme {
     buttonActiveBorder: string;
     buttonActiveText: string;
 }
+export type ClipConfigPanelGroupKind = 'video' | 'audio' | 'text' | 'mixed' | 'empty';
+export interface ClipConfigPanelSelectionState {
+    primaryClip: Clip | null;
+    selectedClips: Clip[];
+    selectionCount: number;
+    groupKind: ClipConfigPanelGroupKind;
+    supportsVoiceBatch: boolean;
+    supportsTextContentBatch: boolean;
+    supportsVisualBatch: boolean;
+    supportsVolumeBatch: boolean;
+}
 export declare const defaultDarkTheme: ClipConfigPanelTheme;
 export interface ClipConfigPanelConfig {
     container: HTMLElement;
@@ -75,6 +86,7 @@ export declare class ClipConfigPanel {
     private readonly onGenerateVoice?;
     private readonly voiceCatalog;
     private currentClip;
+    private selectionState;
     private activeTab;
     private readonly iconCache;
     private pendingPreferredTab;
@@ -91,13 +103,15 @@ export declare class ClipConfigPanel {
     private previewingVoiceId;
     constructor(config: ClipConfigPanelConfig);
     setClip(clip: Clip | null): void;
+    setSelectionState(selectionState: ClipConfigPanelSelectionState): void;
     setPreferredTab(tab: 'voice' | null): void;
     setVoiceGenerationBusy(isBusy: boolean): void;
     destroy(): void;
     private render;
     private getAvailableTabs;
+    private getEmptyStateMessage;
     private resetVoiceState;
-    private syncVoiceStateForClip;
+    private syncVoiceStateForSelection;
     private syncActiveTab;
     private supportsVoicePanel;
     private ensureVoiceFilters;

package/dist/components/panel/ClipConfigPanelRenderer.d.ts

@@ -1,7 +1,7 @@
 import { type TemplateResult } from 'lit';
 import { type Clip, type VoiceOption } from '../../core/models';
 import { LitDomRenderer } from '../../core/renderers/domRenderer';
-import type { ClipConfigPanelTheme } from './ClipConfigPanel';
+import type { ClipConfigPanelSelectionState, ClipConfigPanelTheme } from './ClipConfigPanel';
 export type ClipConfigPanelTabKey = 'visual' | 'audio' | 'text' | 'voice';
 export interface ClipConfigPanelCallbacks {
     onTabChange: (tab: ClipConfigPanelTabKey) => void;
@@ -18,9 +18,12 @@ export interface ClipConfigPanelCallbacks {
 }
 export interface ClipConfigPanelViewModel {
     clip: Clip | null;
+    selectionState: ClipConfigPanelSelectionState;
     activeTab: ClipConfigPanelTabKey;
+    availableTabs: ClipConfigPanelTabKey[];
     theme: ClipConfigPanelTheme;
-    emptyStateIconSvg: string;
+    emptyStateMessage: string | null;
+    isTextContentEditable: boolean;
     loadingIconSvg: string;
     selectedIconSvg: string;
     textDraftContent: string;
@@ -107,7 +110,6 @@ export declare class ClipConfigPanelRenderer extends LitDomRenderer<ClipConfigPa
     private renderLabeledNumberInput;
     private getContainerStyle;
     private getSliderStyle;
-    private getAvailableTabs;
     private supportsVoicePanel;
     private getTransform;
     private calculatePresetPosition;

package/dist/components/track/Track.d.ts

@@ -133,7 +133,7 @@ export declare class Track {
     private buildPreviewClip;
     private constrainResizePreviewToTrackBounds;
     private getResizeLeftBoundaryStart;
-    private getResizeRightBoundaryEnd;
+    private computeResizeRightPushFollowers;
     private buildResizeLeftPreviewClip;
     private buildResizeRightPreviewClip;
     private applyClipSnap;

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

@@ -3,6 +3,7 @@ export interface TimelineClipConfigControllerConfig {
     container: HTMLElement;
     theme: Theme;
     getPrimarySelectedClip: () => Clip | null;
+    getSelectedClips: () => Clip[];
     voiceCatalog: VoiceOption[];
     updateClip: (clipId: string, updates: Partial<Clip>) => void;
     onGenerateVoice?: (clip: Clip, voice: VoiceOption, followTextUpdates: boolean) => Promise<void>;
@@ -10,6 +11,7 @@ export interface TimelineClipConfigControllerConfig {
 export declare class TimelineClipConfigController {
     private panel;
     private config;
+    private currentSelectionState;
     private isInternalUpdate;
     init(config: TimelineClipConfigControllerConfig): void;
     update(): void;
@@ -17,5 +19,7 @@ export declare class TimelineClipConfigController {
     destroy(): void;
     setPreferredTab(tab: 'voice' | null): void;
     setVoiceGenerationBusy(isBusy: boolean): void;
+    private buildSelectionState;
+    private resolveUpdateTargets;
     private convertTheme;
 }

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

@@ -81,6 +81,9 @@ export declare class TimelineManager {
     private lastSteadyPlaybackPreviewSyncAt;
     private previewSyncInteractionMode;
     private readonly resourceCacheManager;
+    private voiceLinkedTextRegenerationTimer;
+    private pendingVoiceLinkedTextRegeneration;
+    private historyRecordingSuppressionDepth;
     constructor(config?: Partial<TimelineConfig>);
     private createPlaybackAttemptId;
     private refreshPlaybackAttempt;
@@ -120,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;
@@ -214,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;
@@ -339,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;
@@ -348,6 +359,7 @@ export declare class TimelineManager {
     private relocateClipToAvoidOverlap;
     private buildClipboardPasteGroups;
     private createTracksForTypeBoundary;
+    private selectBestClipboardPasteStartIndex;
     private buildClipboardPasteGroupPlacementClips;
     private ensureClipboardPasteSourceTracks;
     private resolveClipboardPasteTypeGroupAssignments;
@@ -356,6 +368,7 @@ export declare class TimelineManager {
     private relocateClipIfNeeded;
     private regenerateVoiceLinkedAudioClips;
     private getSelectedTextClipsForVoiceGeneration;
+    private getSelectedTtsAudioClipsForVoiceGeneration;
     private handleVoiceGenerateAction;
     private primeOrLoadClipThumbnails;
     private markClipThumbnailLoadCompleted;
@@ -537,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;
@@ -549,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;
 }

package/dist/core/layout/timelineManagerDom.d.ts

@@ -1,6 +1,6 @@
 import type { Theme } from '../models/types';
 import { type TimelineManagerLayoutElements } from './TimelineManagerLayoutRenderer';
-export declare const TIMELINE_MANAGER_LEFT_PANEL_WIDTH = 200;
+export declare const TIMELINE_MANAGER_LEFT_PANEL_WIDTH = 80;
 export declare const TIMELINE_MANAGER_SCROLLBAR_SIZE = 8;
 export type { TimelineManagerLayoutElements };
 export interface CreateTimelineManagerLayoutOptions {