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

package/README.md

@@ -89,6 +89,7 @@ timeline.on('history_change', (_event, data) => {
 - `updateClip(clipId, updates)` / `removeClip(clipId)`
 - `selectClip(clipId)` / `clearSelection()` / `getSelectedClip()`
 - `splitCurrentClip()` / `removeClipGaps()`
+- `getRenderedHeight()`
 - `undo()` / `redo()` / `clearHistory()`
 - `attachPreview(containerOrConfig)` / `detachPreview()`
 - `exportTimeline()` / `loadDraft(data)`

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

@@ -94,8 +94,6 @@ export declare class ClipConfigPanel {
     private syncVoiceStateForClip;
     private syncActiveTab;
     private supportsVoicePanel;
-    private resolveDefaultVoiceFilterTag;
-    private getVisibleVoiceOptions;
     private ensureVoiceFilters;
     private handleVoiceFilterChange;
     private handleVoiceSelect;

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

@@ -79,6 +79,7 @@ export declare class ClipConfigPanelRenderer extends LitDomRenderer<ClipConfigPa
     private renderVoiceLoadingOverlay;
     private renderEmptyState;
     private renderPanel;
+    private renderTabPanel;
     private renderTabBar;
     private renderActionBar;
     private renderVoiceActionBar;

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

@@ -19,6 +19,7 @@ export interface TimelinePreviewBackendCallbacks {
     onSyncProcessed?: (syncRequestId?: number) => void;
     onRuntimeStateChange?: (state: PreviewRuntimeState) => void;
     onAspectRatioChange?: (aspectRatio: PreviewAspectRatio) => void;
+    onPreviewClipSelect?: (clipId: string) => void;
     onVisualTransformCommit?: (clipId: string, visualTransform: ClipVisualTransform) => void;
     onPendingPreviewRetry?: () => void;
     onRuntimeError?: (error: unknown) => void;

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

@@ -3,6 +3,7 @@ import type { DomRenderer } from '../renderers/domRenderer';
 export interface PreviewPendingOverlayViewModel {
     pendingState: PreviewPendingState | null;
     runtimeState: PreviewRuntimeState;
+    isBuffering: boolean;
 }
 export declare class PreviewPendingOverlayRenderer implements DomRenderer<PreviewPendingOverlayViewModel> {
     private container;

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

@@ -17,6 +17,7 @@ export interface ClipSelectPlan {
 export declare function applyClipMutationEffects(handlers: ClipMutationEffectHandlers): void;
 export declare function applyClipUpdateEffects(handlers: ClipUpdateMutationEffectHandlers): void;
 export declare function shouldReloadClipThumbnails(clip: Clip, originalClip?: Clip, hasThumbnailProvider?: boolean): boolean;
+export declare function calculatePlaybackEndTime(clips: Pick<Clip, 'endTime'>[]): number;
 export declare function calculateCanPlayState(clips: Pick<Clip, 'endTime'>[], currentTime: number): boolean;
 interface SyncCanPlayStateOptions {
     currentCanPlay: boolean;

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

@@ -8,6 +8,7 @@ interface TimelinePreviewSessionCallbacks {
     onSyncProcessed?: (syncRequestId?: number) => void;
     onRuntimeStateChange?: (state: PreviewRuntimeState) => void;
     onAspectRatioChange?: (aspectRatio: PreviewAspectRatio) => void;
+    onPreviewClipSelect?: (clipId: string) => void;
     onVisualTransformCommit?: (clipId: string, visualTransform: ClipVisualTransform) => void;
     onPendingPreviewRetry?: () => void;
 }

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

@@ -151,6 +151,7 @@ export declare class TimelineManager {
     private getTracksSortedByOrder;
     private getPlaybackTracksSnapshot;
     private buildPlaybackPlan;
+    private hasTimelineVideoClip;
     private getPreviewAutoAspectRatioClipOrderMap;
     private getNextPreviewAutoAspectRatioOrder;
     private getAutoAspectRatioClip;
@@ -160,6 +161,7 @@ export declare class TimelineManager {
     private beginPendingPreview;
     updatePendingPreviewState(): void;
     private buildPreviewPendingState;
+    private buildPreviewIndicatorState;
     private clearPendingPreviewState;
     private resetPreviewRuntimeState;
     private destroyPreviewSession;
@@ -375,6 +377,13 @@ export declare class TimelineManager {
     getPlayState(): PlayState;
     setDuration(duration: TimeMs): void;
     getDuration(): TimeMs;
+    /**
+     * 获取当前时间轴内容完整渲染高度。
+     *
+     * 该高度包含顶部时间刻度、所有轨道内容和底部横向滚动条，可供外部容器
+     * 在需要贴合内容时作为高度参考。
+     */
+    getRenderedHeight(): number;
     /**
      * 调整时间轴大小以适配容器
      * @param width 新的宽度
@@ -479,6 +488,7 @@ export declare class TimelineManager {
     removeSelectedClips(): boolean;
     canSeparateClipAudio(clipId: string): boolean;
     canRestoreClipAudio(clipId: string): boolean;
+    private pausePlaybackForAudioSeparation;
     private resolvePreferredSeparatedAudioTrackId;
     separateClipAudio(clipId: string): Promise<string | null>;
     restoreClipAudio(clipId: string): boolean;
@@ -543,6 +553,7 @@ export declare class TimelineManager {
     private handleBoxSelectEnd;
     private isPointOnClip;
     private getClipsIntersectingBox;
+    private resolveTrackRenderHeight;
     private addClipToTrack;
     private cloneTrackSnapshot;
     private ensureTrackFromHistorySnapshot;

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

@@ -22,7 +22,6 @@ export interface TextClipStyle {
     rotation: number;
     strokeColor: string;
     strokeWidth: number;
-    lineHeight: number;
     paddingX: number;
 }
 export declare const DEFAULT_TEXT_CLIP_STYLE: TextClipStyle;