@linker-design-plus/timeline-track 2.0.10 → 2.0.12

package/README.md

@@ -39,7 +39,12 @@ const timeline = new TimelineManager({
   container,
   zoom: 100,
   currentTime: 0,
-  previewBackend: 'dom'
+  previewBackend: 'dom',
+  keyboardShortcuts: {
+    bindings: {
+      togglePlay: 'Mod+Alt+P'
+    }
+  }
 });
 
 timeline.attachPreview(preview);
@@ -88,6 +93,21 @@ timeline.on('history_change', (_event, data) => {
 - `attachPreview(containerOrConfig)` / `detachPreview()`
 - `exportTimeline()` / `loadDraft(data)`
 
+快捷键配置：
+
+- `keyboardShortcuts: false` 可彻底关闭快捷键
+- `keyboardShortcuts.bindings` 可按动作覆盖默认键位
+- 时间轴挂载后默认在当前页面生效
+
+默认快捷键：
+
+- 播放 / 暂停：`Space`
+- 删除片段：`Delete` / `Backspace`
+- 分离 / 还原音频：`Mod+Alt+A`
+- 分割片段：`Mod+B`
+- 撤销：`Mod+Z`
+- 还原：`Mod+Shift+Z`，Windows 另支持 `Ctrl+Y`
+
 常用事件：
 
 - `time_change`
@@ -190,3 +210,4 @@ pnpm exec tsc -p tsconfig.json --noEmit
 - [docs/interaction-model.md](./docs/interaction-model.md): 指针交互分层和拖拽约束
 - [docs/refactor-roadmap.md](./docs/refactor-roadmap.md): 主线重构归档与后续收敛方向
 - [docs/maintenance-audit.md](./docs/maintenance-audit.md): 本轮仓库审计、验证结果和依赖建议
+- [docs/review-remediation-plan.md](./docs/review-remediation-plan.md): 基于审查结论的修复计划与阶段性落地建议

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

@@ -1,4 +1,4 @@
-import type { Clip } from '../../core/models';
+import { type Clip, type VoiceOption } from '../../core/models';
 export interface ClipConfigPanelTheme {
     backgroundColor: string;
     borderColor: string;
@@ -17,54 +17,92 @@ export declare const defaultDarkTheme: ClipConfigPanelTheme;
 export interface ClipConfigPanelConfig {
     container: HTMLElement;
     theme?: ClipConfigPanelTheme;
+    voiceCatalog?: VoiceOption[];
     onClipUpdate?: (clipId: string, updates: Partial<Clip>) => void;
+    onGenerateVoice?: (clip: Clip, voice: VoiceOption, followTextUpdates: boolean) => Promise<void>;
 }
+export declare const CSS_CLASSES: {
+    readonly container: "clip-config-panel";
+    readonly tabBar: "clip-config-tab-bar";
+    readonly tabButton: "clip-config-tab-button";
+    readonly content: "clip-config-content";
+    readonly visualPanel: "clip-config-visual-panel";
+    readonly audioPanel: "clip-config-audio-panel";
+    readonly textPanel: "clip-config-text-panel";
+    readonly voicePanel: "clip-config-voice-panel";
+    readonly actionBar: "clip-config-action-bar";
+    readonly section: "clip-config-section";
+    readonly sectionTitle: "clip-config-section-title";
+    readonly row: "clip-config-row";
+    readonly label: "clip-config-label";
+    readonly slider: "clip-config-slider";
+    readonly input: "clip-config-input";
+    readonly textarea: "clip-config-textarea";
+    readonly colorInput: "clip-config-color-input";
+    readonly presetGrid: "clip-config-preset-grid";
+    readonly presetButton: "clip-config-preset-button";
+    readonly resetButton: "clip-config-reset-button";
+    readonly emptyState: "clip-config-empty-state";
+    readonly filterGroup: "clip-config-filter-group";
+    readonly filterButton: "clip-config-filter-button";
+    readonly voiceCardGrid: "clip-config-voice-grid";
+    readonly voiceCard: "clip-config-voice-card";
+    readonly voiceCardAvatar: "clip-config-voice-avatar";
+    readonly voiceCardMeta: "clip-config-voice-meta";
+    readonly voiceCardTitle: "clip-config-voice-title";
+    readonly voiceCardSubtitle: "clip-config-voice-subtitle";
+    readonly voiceCardCheck: "clip-config-voice-check";
+    readonly voiceCheckbox: "clip-config-voice-checkbox";
+    readonly primaryButton: "clip-config-primary-button";
+    readonly errorText: "clip-config-error-text";
+    readonly voiceLoadingOverlay: "clip-config-voice-loading-overlay";
+    readonly voiceLoadingCard: "clip-config-voice-loading-card";
+    readonly voiceLoadingIcon: "clip-config-voice-loading-icon";
+    readonly voiceLoadingText: "clip-config-voice-loading-text";
+};
 export declare class ClipConfigPanel {
-    private container;
-    private rootElement;
-    private theme;
-    private onClipUpdate?;
+    private readonly container;
+    private readonly theme;
+    private readonly renderer;
+    private readonly onClipUpdate?;
+    private readonly onGenerateVoice?;
+    private readonly voiceCatalog;
     private currentClip;
     private activeTab;
-    private iconCache;
-    private tabBar;
-    private contentArea;
-    private visualPanel;
-    private audioPanel;
-    private xSlider;
-    private xInput;
-    private ySlider;
-    private yInput;
-    private scaleSlider;
-    private scaleInput;
-    private volumeSlider;
-    private volumeInput;
+    private readonly iconCache;
+    private pendingPreferredTab;
+    private selectedVoiceId;
+    private activeVoiceFilterTag;
+    private textDraftContent;
+    private followTextUpdates;
+    private voiceLoadingBusyCount;
+    private isVoiceLoadingOverlayRendered;
+    private isVoiceLoadingOverlayExiting;
+    private voiceLoadingOverlayHideTimer;
+    private voiceErrorMessage;
     constructor(config: ClipConfigPanelConfig);
     setClip(clip: Clip | null): void;
+    setPreferredTab(tab: 'voice' | null): void;
+    setVoiceGenerationBusy(isBusy: boolean): void;
     destroy(): void;
-    private getAvailableTabs;
     private render;
-    private applyBaseTheme;
-    private renderEmptyState;
-    private renderPanel;
-    private renderTabBar;
-    private updateTabBarState;
-    private renderContentArea;
-    private updateContentVisibility;
-    private renderVisualPanel;
-    private renderAudioPanel;
-    private renderActionBar;
-    private renderPositionControl;
-    private renderPresetGrid;
-    private calculatePresetPosition;
-    private renderScaleControl;
-    private renderVolumeControl;
+    private getAvailableTabs;
+    private resetVoiceState;
+    private syncVoiceStateForClip;
+    private syncActiveTab;
+    private supportsVoicePanel;
+    private resolveDefaultVoiceFilterTag;
+    private getVisibleVoiceOptions;
+    private ensureVoiceFilters;
+    private handleVoiceFilterChange;
+    private handleVoiceSelect;
+    private handleVoiceFollowTextUpdatesChange;
+    private handleGenerateVoice;
     private handleVolumeChange;
-    private updateVolumeControls;
     private clampValue;
-    private updateUIControls;
-    private updateSliderAndInput;
-    private updateSliderVisual;
     private handleTransformChange;
     private handleTransformChanges;
+    private handleTextContentInput;
+    private handleTextContentCommit;
+    private handleTextStyleChange;
 }

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

@@ -0,0 +1,104 @@
+import { type TemplateResult } from 'lit';
+import { type Clip, type VoiceOption } from '../../core/models';
+import { LitDomRenderer } from '../../core/renderers/domRenderer';
+import type { ClipConfigPanelTheme } from './ClipConfigPanel';
+export type ClipConfigPanelTabKey = 'visual' | 'audio' | 'text' | 'voice';
+export interface ClipConfigPanelCallbacks {
+    onTabChange: (tab: ClipConfigPanelTabKey) => void;
+    onTransformChange: (property: 'x' | 'y' | 'scale', value: number) => void;
+    onPresetSelect: (x: number, y: number) => void;
+    onVolumeChange: (value: number) => void;
+    onTextContentInput: (value: string) => void;
+    onTextContentCommit: () => void;
+    onTextStyleChange: (property: 'fontSize' | 'color' | 'rotation' | 'x' | 'y', value: number | string) => void;
+    onVoiceFilterChange: (tag: string) => void;
+    onVoiceSelect: (voiceId: string) => void;
+    onVoiceFollowTextUpdatesChange: (value: boolean) => void;
+    onGenerateVoice: () => Promise<void>;
+}
+export interface ClipConfigPanelViewModel {
+    clip: Clip | null;
+    activeTab: ClipConfigPanelTabKey;
+    theme: ClipConfigPanelTheme;
+    emptyStateIconSvg: string;
+    loadingIconSvg: string;
+    selectedIconSvg: string;
+    textDraftContent: string;
+    voiceCatalog: VoiceOption[];
+    selectedVoiceId: string | null;
+    activeVoiceFilterTag: string | null;
+    followTextUpdates: boolean;
+    isVoiceLoadingOverlayVisible: boolean;
+    isVoiceLoadingOverlayExiting: boolean;
+    voiceErrorMessage: string | null;
+    callbacks: ClipConfigPanelCallbacks;
+}
+export declare const CLIP_CONFIG_CSS_CLASSES: {
+    readonly container: "clip-config-panel";
+    readonly tabBar: "clip-config-tab-bar";
+    readonly tabButton: "clip-config-tab-button";
+    readonly content: "clip-config-content";
+    readonly visualPanel: "clip-config-visual-panel";
+    readonly audioPanel: "clip-config-audio-panel";
+    readonly textPanel: "clip-config-text-panel";
+    readonly voicePanel: "clip-config-voice-panel";
+    readonly actionBar: "clip-config-action-bar";
+    readonly section: "clip-config-section";
+    readonly sectionTitle: "clip-config-section-title";
+    readonly row: "clip-config-row";
+    readonly label: "clip-config-label";
+    readonly slider: "clip-config-slider";
+    readonly input: "clip-config-input";
+    readonly textarea: "clip-config-textarea";
+    readonly colorInput: "clip-config-color-input";
+    readonly presetGrid: "clip-config-preset-grid";
+    readonly presetButton: "clip-config-preset-button";
+    readonly resetButton: "clip-config-reset-button";
+    readonly emptyState: "clip-config-empty-state";
+    readonly filterGroup: "clip-config-filter-group";
+    readonly filterButton: "clip-config-filter-button";
+    readonly voiceCardGrid: "clip-config-voice-grid";
+    readonly voiceCard: "clip-config-voice-card";
+    readonly voiceCardAvatar: "clip-config-voice-avatar";
+    readonly voiceCardMeta: "clip-config-voice-meta";
+    readonly voiceCardTitle: "clip-config-voice-title";
+    readonly voiceCardSubtitle: "clip-config-voice-subtitle";
+    readonly voiceCardCheck: "clip-config-voice-check";
+    readonly voiceCheckbox: "clip-config-voice-checkbox";
+    readonly primaryButton: "clip-config-primary-button";
+    readonly errorText: "clip-config-error-text";
+    readonly voiceLoadingOverlay: "clip-config-voice-loading-overlay";
+    readonly voiceLoadingCard: "clip-config-voice-loading-card";
+    readonly voiceLoadingIcon: "clip-config-voice-loading-icon";
+    readonly voiceLoadingText: "clip-config-voice-loading-text";
+};
+export declare class ClipConfigPanelRenderer extends LitDomRenderer<ClipConfigPanelViewModel> {
+    protected renderTemplate(viewModel: ClipConfigPanelViewModel): TemplateResult;
+    private renderVoiceLoadingOverlay;
+    private renderEmptyState;
+    private renderPanel;
+    private renderTabBar;
+    private renderActionBar;
+    private renderVoiceActionBar;
+    private renderVisualPanel;
+    private renderPositionSection;
+    private renderScaleSection;
+    private renderAudioPanel;
+    private renderTextPanel;
+    private renderVoicePanel;
+    private renderFilterButton;
+    private renderVoiceCard;
+    private renderPositionControl;
+    private renderPresetGrid;
+    private renderSectionTitle;
+    private renderRangeInput;
+    private renderNumberInput;
+    private renderLabeledNumberInput;
+    private getContainerStyle;
+    private getSliderStyle;
+    private getAvailableTabs;
+    private supportsVoicePanel;
+    private getTransform;
+    private calculatePresetPosition;
+    private resizeSvg;
+}

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

@@ -20,8 +20,9 @@ export declare class TrackInfoPanel {
     private width;
     private timeScaleHeight;
     private includeTimeScaleSpacer;
-    private trackList;
-    private iconCache;
+    private scrollTop;
+    private readonly renderer;
+    private readonly iconCache;
     private onMuteTrack?;
     constructor(config: TrackInfoPanelConfig, _onRenameTrack?: (trackId: string, newName: string) => void, _onDeleteTrack?: (trackId: string) => void, onMuteTrack?: (trackId: string, isMuted: boolean) => void);
     private init;
@@ -29,6 +30,5 @@ export declare class TrackInfoPanel {
     getTracks(): Track[];
     render(): void;
     setScrollTop(scrollTop: number): void;
-    private createTrackItem;
     destroy(): void;
 }

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

@@ -0,0 +1,33 @@
+import { type TemplateResult } from 'lit';
+import { Track } from '../../core/models';
+import { LitDomRenderer } from '../../core/renderers/domRenderer';
+export interface TrackInfoPanelTheme {
+    background: string;
+    border: string;
+    text: string;
+    buttonBackground: string;
+    buttonHover: string;
+    buttonDanger: string;
+}
+export interface TrackInfoPanelViewModel {
+    tracks: Track[];
+    scrollTop: number;
+    theme: TrackInfoPanelTheme;
+    timeScaleHeight: number;
+    includeTimeScaleSpacer: boolean;
+    onMuteTrack?: (trackId: string, isMuted: boolean) => void;
+    icons: {
+        textTrack: string;
+        videoTrack: string;
+        audioTrack: string;
+        display: string;
+        hide: string;
+        volume: string;
+        volumeMuted: string;
+    };
+}
+export declare class TrackInfoPanelRenderer extends LitDomRenderer<TrackInfoPanelViewModel> {
+    protected renderTemplate(viewModel: TrackInfoPanelViewModel): TemplateResult;
+    private renderTrackItem;
+    private resizeSvg;
+}

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

@@ -99,6 +99,9 @@ export declare class Track {
     private readonly handleEdgeAutoScrollFrame;
     private handleTrackBackgroundClick;
     private handleTrackBackgroundMouseDown;
+    private getClipDisplayLabel;
+    private getClipAudioBadgeText;
+    private isSourceBoundClip;
     updateClipSelection(clipId: string, isSelected: boolean): void;
     private createClipGroup;
     private handleClipClick;
@@ -130,6 +133,7 @@ export declare class Track {
     setCurrentTime(_time: TimeMs): void;
     setScrollLeft(scrollLeft: number): void;
     private updateClipVisibility;
+    private updateClipViewportState;
     setTrackY(trackY: number): void;
     setTrackStackOrder(order: number): void;
     setDragOverlayLayer(layer: Konva.Layer | null): void;

package/dist/core/commands/timelineCommands.d.ts

@@ -61,6 +61,7 @@ export type TrackPlacementCommandResult = {
     status: 'create_track';
     trackType: TrackType;
     suggestedTrackName: string;
+    insertionPlacement: TrackInsertionPlacement;
 };
 export type CrossTrackMoveCommandResult = {
     status: 'missing_target_track_by_position';

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

@@ -10,6 +10,7 @@ export { TimelinePlaybackResolver } from './timelinePlaybackResolver';
 export { TimelinePreviewSession } from './timelinePreviewSession';
 export { TimelinePreviewRuntimeController } from './timelinePreviewRuntimeController';
 export { TimelinePreviewStateController, type TimelinePendingPreviewState } from './timelinePreviewStateController';
+export { TimelineKeyboardShortcutsController, type TimelineKeyboardShortcutsControllerCallbacks } from './timelineKeyboardShortcutsController';
 export * from './timelineSelectionController';
 export * from './timelineTrackMutationController';
 export { TimelineTrackInfoPanelController } from './timelineTrackInfoPanelController';

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

@@ -1,4 +1,5 @@
-import type { ActiveClipPlaybackInfo, Clip, ClipVisualTransform, PlayState, PreviewAspectRatio, PreviewMediaSource, PreviewSourceResolver, TimeMs } from '../models/types';
+import type { ActiveClipPlaybackInfo, Clip, ClipVisualTransform, PlayState, PreviewAspectRatio, PreviewMediaSource, PreviewSourceResolver, TextPreviewFontConfig, TimeMs } from '../models/types';
+import type { SourceMediaRegistry } from '../resources/sourceMediaRegistry';
 export interface TimelinePreviewSyncPayload {
     activeClips: ActiveClipPlaybackInfo[];
     nextClips: ActiveClipPlaybackInfo[];
@@ -66,6 +67,8 @@ export interface PreviewBackendClockState {
 export interface TimelinePreviewBackendOptions {
     callbacks?: TimelinePreviewBackendCallbacks;
     previewSourceResolver?: PreviewSourceResolver;
+    textPreviewFont?: TextPreviewFontConfig | null;
+    sourceMediaRegistry?: SourceMediaRegistry;
     rootClassName?: string;
     frameClassName?: string;
     slotClassNamePrefix?: string;

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

@@ -0,0 +1,17 @@
+import type { PreviewPendingState, PreviewRuntimeState } from './previewBackend';
+import type { DomRenderer } from '../renderers/domRenderer';
+export interface PreviewPendingOverlayViewModel {
+    pendingState: PreviewPendingState | null;
+    runtimeState: PreviewRuntimeState;
+}
+export declare class PreviewPendingOverlayRenderer implements DomRenderer<PreviewPendingOverlayViewModel> {
+    private container;
+    private statusElement;
+    private detailElement;
+    private actionElement;
+    private readonly onRetry;
+    constructor(onRetry: () => void);
+    mount(container: HTMLElement): void;
+    update(viewModel: PreviewPendingOverlayViewModel): void;
+    destroy(): void;
+}

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

@@ -1,9 +1,11 @@
-import { Theme, Clip } from '../models';
+import { Theme, Clip, type VoiceOption } from '../models';
 export interface TimelineClipConfigControllerConfig {
     container: HTMLElement;
     theme: Theme;
     getPrimarySelectedClip: () => Clip | null;
+    voiceCatalog: VoiceOption[];
     updateClip: (clipId: string, updates: Partial<Clip>) => void;
+    onGenerateVoice?: (clip: Clip, voice: VoiceOption, followTextUpdates: boolean) => Promise<void>;
 }
 export declare class TimelineClipConfigController {
     private panel;
@@ -13,5 +15,7 @@ export declare class TimelineClipConfigController {
     update(): void;
     updateFromExternal(): void;
     destroy(): void;
+    setPreferredTab(tab: 'voice' | null): void;
+    setVoiceGenerationBusy(isBusy: boolean): void;
     private convertTheme;
 }

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

@@ -1,6 +1,7 @@
 import type { Clip, PlayState } from '../models/types';
 export interface ClipMutationEffectHandlers {
     notifySelectionChange: () => void;
+    emitSelectionChangeEvent?: () => void;
     emitSelectedClipChangeIfNeeded: () => void;
     handleClipChange: () => void;
     checkTrackDurationChange?: () => void;

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

@@ -0,0 +1,29 @@
+import type { TimelineKeyboardShortcutsConfig } from '../models';
+export interface TimelineKeyboardShortcutsControllerCallbacks {
+    togglePlay(): void;
+    deleteSelectedClips(): void;
+    toggleSelectedClipsAudio(): Promise<boolean>;
+    splitCurrentClip(): void;
+    undo(): boolean;
+    redo(): boolean;
+    canDeleteSelectedClips(): boolean;
+    canSplitSelectedClip(): boolean;
+    canToggleSelectedClipsAudio(): boolean;
+}
+export interface TimelineKeyboardShortcutsControllerOptions {
+    root: HTMLElement;
+    config?: false | TimelineKeyboardShortcutsConfig;
+    callbacks: TimelineKeyboardShortcutsControllerCallbacks;
+    isMacLike?: boolean;
+}
+export declare class TimelineKeyboardShortcutsController {
+    private readonly callbacks;
+    private readonly bindings;
+    private readonly enabled;
+    private readonly keydownListener;
+    constructor(options: TimelineKeyboardShortcutsControllerOptions);
+    init(): void;
+    destroy(): void;
+    private handleKeydown;
+    private dispatchAction;
+}

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

@@ -1,4 +1,5 @@
-import type { ActiveClipPlaybackInfo, ClipVisualTransform, PlayState, PreviewAspectRatio, PreviewSourceResolver, TimeMs, TrackType } from '../models/types';
+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';
 interface TimelinePreviewSessionCallbacks {
     onBufferingStateChange?: (isBuffering: boolean) => void;
@@ -17,6 +18,8 @@ interface TimelinePreviewSessionDependencies {
     frameClassName?: string;
     slotClassNamePrefix?: string;
     previewSourceResolver?: PreviewSourceResolver;
+    textPreviewFont?: TextPreviewFontConfig | null;
+    sourceMediaRegistry?: SourceMediaRegistry;
 }
 export interface TimelinePreviewSyncPayload {
     activeClips: ActiveClipPlaybackInfo[];
@@ -33,12 +36,12 @@ export declare class TimelinePreviewSession {
     private container;
     private rootElement;
     private frameElement;
+    private textOverlayRoot;
     private pendingOverlayElement;
-    private pendingOverlayStatusElement;
-    private pendingOverlayDetailElement;
-    private pendingOverlayActionElement;
+    private readonly pendingOverlayRenderer;
     private resizeObserver;
     private readonly trackSlots;
+    private readonly textPreviewEntries;
     private audioContext;
     private masterGainNode;
     private loadingCount;
@@ -49,9 +52,18 @@ export declare class TimelinePreviewSession {
     private lastSettledSyncRequestId;
     private primarySelectedClipId;
     private transientVisualTransform;
+    private textPreviewDragState;
+    private textPreviewFontStyleElement;
+    private textPreviewFontSignature;
+    private textPreviewFontLoadState;
+    private textPreviewFontLoadToken;
     private readonly callbacks;
     private readonly dependencies;
     private readonly transformOverlay;
+    private readonly boundTextPreviewPointerMove;
+    private readonly boundTextPreviewPointerUp;
+    private readonly boundTextPreviewVisibilityChange;
+    private readonly boundTextPreviewWindowBlur;
     private requestedAspectRatio;
     private resolvedAutoAspectRatio;
     private aspectRatioProbe;
@@ -96,6 +108,7 @@ export declare class TimelinePreviewSession {
     private updateFrameLayout;
     private maybeResolveAutoAspectRatio;
     private resolveAspectRatioProbeSource;
+    private buildPreviewSourceCacheKey;
     private getAspectRatioProbe;
     private tryResolveAutoAspectRatioFromSlot;
     private handleResolvedAutoAspectRatio;
@@ -105,9 +118,28 @@ export declare class TimelinePreviewSession {
     private refreshPendingOverlay;
     private handlePreviewTransformChange;
     private refreshVisualLayout;
+    private syncTextPreviewEntries;
+    private clearTextPreviewEntries;
+    private removeTextPreviewEntry;
+    private applyTextPreviewEntry;
+    private refreshTextPreviewLayout;
+    private refreshTextPreviewEntries;
+    private createTextPreviewPointerDownHandler;
+    private bindTextPreviewDocumentListeners;
+    private unbindTextPreviewDocumentListeners;
+    private handleTextPreviewPointerMove;
+    private finishTextPreviewDrag;
+    private refreshTextPreviewInteractionState;
+    private getTextPreviewFontConfig;
+    private getTextPreviewFontFamily;
+    private ensureTextPreviewFontReady;
+    private resetTextPreviewFontState;
     private refreshSlotVisualLayout;
     private buildSelectedOverlayState;
     private getFrameSize;
+    private getDocument;
+    private toFrameLocalPoint;
+    private getTextPreviewBaselineMetrics;
     private getMediaSize;
     private getEffectiveVisualTransform;
 }

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

@@ -1,4 +1,4 @@
-import type { Clip } from '../models/types';
+import type { Clip, SelectedClipAudioAction, SelectionChangeData } from '../models/types';
 export interface SelectedClipSnapshot {
     clip: Clip | null;
     hasSelectedClip: boolean;
@@ -7,11 +7,17 @@ interface ResolveSelectedClipOptions {
     getPrimarySelectedClip: () => Clip | null;
     findFallbackSelectedClip?: () => Clip | null;
 }
+interface ResolveSelectionChangeOptions extends ResolveSelectedClipOptions {
+    getSelectedClipIds: () => string[];
+    canSplitSelectedClip: () => boolean;
+    getSelectedClipAudioAction: () => SelectedClipAudioAction;
+}
 interface EmitSelectedClipChangeOptions {
     lastSelectedClipId: string | null;
     resolveSelectedClip: () => SelectedClipSnapshot;
     emitSelectedClipChange: (payload: SelectedClipSnapshot) => void;
 }
 export declare function resolveSelectedClipSnapshot(options: ResolveSelectedClipOptions): SelectedClipSnapshot;
+export declare function resolveSelectionChangeData(options: ResolveSelectionChangeOptions): SelectionChangeData;
 export declare function emitSelectedClipChangeIfNeeded(options: EmitSelectedClipChangeOptions): string | null;
 export {};

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

@@ -1,8 +1,8 @@
 import type { MoveClipToTrackCommandResult, RemoveClipCommandResult, TrackPlacementCommandResult } from '../commands/timelineCommands';
-import type { Clip, TrackType } from '../models/types';
+import type { Clip, TrackInsertionPlacement, TrackType } from '../models/types';
 import type { TimelineTrackCollection } from '../tracks/timelineTrackCollection';
 interface CreateTrackHandler {
-    (type: TrackType, name?: string): string;
+    (type: TrackType, name?: string, insertionPlacement?: TrackInsertionPlacement, referenceTrackId?: string): string;
 }
 interface ApplyClipPlacementOptions {
     clip: Clip;