@linker-design-plus/timeline-track 1.0.7 → 1.0.9

package/README.md

@@ -362,6 +362,7 @@ new TimelineManager(config?: Partial<TimelineConfig>)
 | `zoom_change` | 缩放比例变化 | `{ zoom: number }` |
 | `history_change` | 历史记录变更 | `{ canUndo: boolean, canRedo: boolean }` |
 | `track_duration_change` | 轨道总时长变化 | `{ duration: number }` |
+| `buffering_state_change` | 视频缓冲状态变化 | `{ isBuffering: boolean }` |
 
 ### ClipConfig 接口
 

package/dist/components/Timeline.d.ts

@@ -13,7 +13,6 @@ export declare class Timeline {
     private onZoomChange;
     private onScrollChange;
     private animationFrameId;
-    private isZooming;
     private scrollbarHeight;
     private scrollbarY;
     private isScrollbarDragging;

package/dist/core/constants.d.ts

@@ -19,3 +19,4 @@ export declare const TIME_SCALE: {
     MAX_HEIGHT: number;
 };
 export declare const TIMELINE_LEFT_PADDING = 15;
+export declare const MIN_CLIP_LINE_WIDTH = 6;

package/dist/core/timelineManager.d.ts

@@ -1,4 +1,4 @@
-import { TimelineConfig, Clip, ClipConfig, TimeMs, PlayState, Action, TimelineEvent, EventListener, VideoPreviewConfig, TimelineExportData, ThumbnailProvider } from './types';
+import { TimelineConfig, Clip, ClipConfig, TimeMs, PlayState, Action, TimelineEvent, EventListener as TimelineEventListener, VideoPreviewConfig, TimelineExportData, ThumbnailProvider } from './types';
 export declare class TimelineManager {
     private timeline;
     private tracks;
@@ -20,6 +20,11 @@ export declare class TimelineManager {
     private lastTrackDuration;
     private thumbnailProvider;
     private canPlay;
+    private isBuffering;
+    private sourceLoadingCount;
+    private playStateBeforeBuffering;
+    private isPausingForBuffering;
+    private videoBufferingListeners;
     constructor(config?: Partial<TimelineConfig>);
     init(container: HTMLElement): void;
     play(): void;
@@ -29,6 +34,11 @@ export declare class TimelineManager {
     setCurrentTime(time: TimeMs): void;
     getCurrentTime(): TimeMs;
     setZoom(zoom: number): void;
+    /**
+     * 以游标（playhead）为中心设置缩放，用于外置 slider 等非幕布上的缩放操作
+     * 调整 scrollLeft 使游标在屏幕上的位置保持不变
+     */
+    setZoomCenteredOnPlayhead(zoom: number): void;
     getZoom(): number;
     /**
      * 设置播放倍速
@@ -45,6 +55,17 @@ export declare class TimelineManager {
      * @returns 是否可以播放
      */
     getCanPlay(): boolean;
+    /**
+     * 当前是否存在视频源加载任务（例如 addClip 期间读取视频时长）
+     */
+    isSourceLoading(): boolean;
+    /**
+     * 获取视频源加载状态
+     */
+    getSourceLoadingState(): {
+        isLoading: boolean;
+        pending: number;
+    };
     /**
      * 设置缩略图提供器
      * @param provider 缩略图提供器
@@ -68,6 +89,11 @@ export declare class TimelineManager {
      */
     refreshAllClipThumbnails(): Promise<boolean[]>;
     addClip(clipConfig: ClipConfig): Promise<string>;
+    /**
+     * 批量添加片段。批量模式下仅维护一段连续的视频源加载状态。
+     */
+    addClips(clipConfigs: ClipConfig[]): Promise<string[]>;
+    private addClipInternal;
     removeClip(clipId: string): void;
     updateClip(clipId: string, updates: Partial<Clip>): void;
     splitClip(clipId: string, time: TimeMs): void;
@@ -109,9 +135,11 @@ export declare class TimelineManager {
     private handleClipSelect;
     private handleActionUndo;
     private handleActionRedo;
-    on(event: TimelineEvent, listener: EventListener): void;
-    off(event: TimelineEvent, listener: EventListener): void;
+    on(event: TimelineEvent, listener: TimelineEventListener): void;
+    off(event: TimelineEvent, listener: TimelineEventListener): void;
     private emitEvent;
+    private beginSourceLoading;
+    private endSourceLoading;
     getPlayState(): PlayState;
     setDuration(duration: TimeMs): void;
     getDuration(): TimeMs;
@@ -168,12 +196,17 @@ export declare class TimelineManager {
     /** 清除历史堆栈 */
     clearHistory(): void;
     private handleVideoTimeUpdate;
+    private getLastClipByEndTime;
     private handlePlayStateChange;
     private handleClipChange;
     private findClipAtTime;
     private loadClipToVideo;
+    private attachVideoBufferingListeners;
+    private detachVideoBufferingListeners;
+    private enterBuffering;
+    private exitBuffering;
     /**
-     * 检查轨道总时长是否变化，如果变化则触发事件
+     * 检查轨道总时长是否变化，如果变化则触发事件并更新时间轴时长
      */
     private checkTrackDurationChange;
 }

package/dist/core/types.d.ts

@@ -123,7 +123,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' | 'speed_change' | 'can_play_change';
+export type TimelineEvent = 'time_change' | 'play_state_change' | 'clip_added' | 'clip_removed' | 'clip_updated' | 'zoom_change' | 'history_change' | 'track_duration_change' | 'clip_selected' | 'speed_change' | 'can_play_change' | 'buffering_state_change' | 'source_loading_change';
 export interface TimeChangeData {
     time: TimeMs;
 }
@@ -142,6 +142,13 @@ export interface ClipRemovedEventData {
 export interface CanPlayChangeData {
     canPlay: boolean;
 }
+export interface BufferingStateChangeData {
+    isBuffering: boolean;
+}
+export interface SourceLoadingChangeData {
+    isLoading: boolean;
+    pending: number;
+}
 export interface EventListener {
     (event: TimelineEvent, data?: any): void;
 }