@linker-design-plus/timeline-track 2.1.5 → 2.2.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@linker-design-plus/timeline-track",
-  "version": "2.1.5",
+  "version": "2.2.0",
   "description": "A TypeScript-based video editing library with timeline and track functionality",
   "main": "dist/index.cjs.js",
   "module": "dist/index.es.js",

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

@@ -1,25 +0,0 @@
-import type { ActiveClipPlaybackInfo } from '../models/types';
-import { type PreviewSlotRecoveryReason } from './previewSlotPolicy';
-export interface PreviewRecoveryAttemptInput {
-    entry: ActiveClipPlaybackInfo;
-    desiredSource: string;
-    reason: PreviewSlotRecoveryReason;
-    previousRecoveryKey: string | null;
-    previousRetryCount: number;
-    maxImmediateRecoveryRetries: number;
-    recoveryTimeBucketMs: number;
-    isBackgroundPreload: boolean;
-}
-export type PreviewRecoveryAttemptResult = {
-    status: 'continue';
-    recoveryKey: string;
-    retryCount: number;
-} | {
-    status: 'park';
-    message: string;
-    parkReason: 'retries-exhausted';
-} | {
-    status: 'fail';
-    message: string;
-};
-export declare function resolveRecoveryAttempt(input: PreviewRecoveryAttemptInput): PreviewRecoveryAttemptResult;

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

@@ -1,42 +0,0 @@
-import type { PlayState } from '../models/types';
-import type { PreviewSlotPhase } from './previewBackend';
-export interface PreviewSlotRecoveryStateLike {
-    isActive: boolean;
-    phase: PreviewSlotPhase;
-    errorMessage: string | null;
-    retryCount: number;
-    recoveryKey: string | null;
-    forceRecover: boolean;
-    isLoading: boolean;
-    isResolvingSource: boolean;
-    isBuffering: boolean;
-    isSeeking: boolean;
-    consecutiveStalledCount: number;
-    expectedEmptiedEvents: number;
-    recoverableEventCount: number;
-    loadStartedSinceRecover: boolean;
-}
-export interface PreviewTrackedCurrentVideoSlotStatus {
-    failed: boolean;
-    resolving: boolean;
-    seeking: boolean;
-    mediaUnready: boolean;
-    ready: boolean;
-}
-export declare function clearSlotFailureForBoundClipChange(slot: PreviewSlotRecoveryStateLike): void;
-export declare function resetSlotRecoveryTrackingState(slot: PreviewSlotRecoveryStateLike, forceRecover?: boolean): void;
-export declare function clearSlotState(slot: PreviewSlotRecoveryStateLike): void;
-export declare function parkPreloadSlotState(slot: PreviewSlotRecoveryStateLike): void;
-export declare function settleResolvedSourceWithoutRecoveryState(slot: Pick<PreviewSlotRecoveryStateLike, 'isActive' | 'phase' | 'isResolvingSource' | 'isLoading' | 'isBuffering' | 'errorMessage'>): void;
-export declare function finalizeAppliedSlotPhase(slot: Pick<PreviewSlotRecoveryStateLike, 'isActive' | 'isLoading' | 'isSeeking' | 'phase' | 'errorMessage'>): void;
-export declare function beginDeferredPreloadState(slot: Pick<PreviewSlotRecoveryStateLike, 'phase' | 'forceRecover' | 'isLoading' | 'isResolvingSource' | 'isSeeking' | 'isBuffering' | 'errorMessage'>, hasAssignedSource: boolean): void;
-export declare function reconcileTrackedCurrentVideoSlotState(slot: PreviewSlotRecoveryStateLike, input: {
-    hasDesiredSource: boolean;
-    sourceMatched: boolean;
-    withinSeekThreshold: boolean;
-    readyState: number;
-    haveCurrentDataState: number;
-}): PreviewTrackedCurrentVideoSlotStatus;
-export declare function failSlotState(slot: Pick<PreviewSlotRecoveryStateLike, 'phase' | 'isLoading' | 'isResolvingSource' | 'isSeeking' | 'isBuffering' | 'errorMessage' | 'forceRecover' | 'expectedEmptiedEvents'>, errorMessage: string): void;
-export declare function beginPreloadPrimingState(slot: Pick<PreviewSlotRecoveryStateLike, 'isActive' | 'isBuffering' | 'isSeeking'>): void;
-export declare function beginSlotRecoveryState(slot: PreviewSlotRecoveryStateLike, playState: PlayState): void;

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

@@ -1,59 +0,0 @@
-import type { ActiveClipPlaybackInfo, PlayState } from '../models/types';
-import type { PreviewSlotPhase } from './previewBackend';
-export type PreviewSlotRecoveryReason = 'reconcile' | 'stalled' | 'abort' | 'emptied' | 'error';
-export interface ResolvedSlotSourceLike {
-    stableSourceUrl: string;
-    url: string;
-    objectUrl: string | null;
-}
-export interface ReusableBoundSlotSourceInput {
-    currentSourceKey: string;
-    nextSourceKey: string;
-    desiredSource: string | null;
-    stableSourceUrl: string | null;
-    objectUrl: string | null;
-}
-export interface PreviewSlotRecoveryNeedInput {
-    desiredSource: string;
-    configuredSource: string | null;
-    assignedSource: string | null;
-    forceRecover: boolean;
-    isActive: boolean;
-    isLoading: boolean;
-    isSeeking: boolean;
-    isBuffering: boolean;
-    phase: PreviewSlotPhase;
-    networkState: number | null;
-    readyState: number | null;
-    networkEmptyState: number;
-    haveCurrentDataState: number;
-}
-export interface PreviewSlotRecoveryNeedResult {
-    needsRecovery: boolean;
-    recoveryReason: string | null;
-    actualSource: string | null;
-    configuredSource: string | null;
-    shouldWarn: boolean;
-}
-export declare function buildRecoveryKey(entry: ActiveClipPlaybackInfo, desiredSource: string, reason: PreviewSlotRecoveryReason, recoveryTimeBucketMs: number): string;
-export declare function getReusableBoundSlotSource(input: ReusableBoundSlotSourceInput): ResolvedSlotSourceLike | null;
-export declare function doesSlotSourceMatchDesired(configuredSource: string | null, assignedSource: string | null, desiredSource: string | null): boolean;
-export declare function evaluateSlotRecoveryNeed(input: PreviewSlotRecoveryNeedInput): PreviewSlotRecoveryNeedResult;
-export declare function getSlotSeekThresholdSeconds(role: 'current' | 'preload', playbackRate: number): number;
-export declare function shouldHardResetRecoveredSource(previousActualSource: string | null, reason: PreviewSlotRecoveryReason, retryCount: number): boolean;
-export declare function buildCurrentSlotTarget(input: {
-    role: 'current' | 'preload';
-    entry: ActiveClipPlaybackInfo;
-    requestedPlayState: PlayState;
-    isActive: boolean;
-    playbackRate: number;
-    syncRequestId?: number;
-}): {
-    role: 'current' | 'preload';
-    entry: ActiveClipPlaybackInfo;
-    playState: PlayState;
-    speed: number;
-    visible: boolean;
-    zIndex: number;
-    syncRequestId?: number;
-};

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

@@ -1,218 +0,0 @@
-import type { ActiveClipPlaybackInfo, ClipVisualTransform, PlayState, PreviewAspectRatio, PreviewSourceResolver, TextPreviewFontConfig, TimeMs, TrackType } from '../models/types';
-import type { SourceMediaRegistry } from '../resources/sourceMediaRegistry';
-import type { ResourceCacheManager } from '../resources/resourceCache';
-import type { PreviewPendingState, PreviewRuntimeState } from './previewBackend';
-import { type DiagnosticEmitInput, type DiagnosticsCenter } from '../../utils/diagnostics';
-interface TimelinePreviewSessionCallbacks {
-    onSyncProcessed?: (syncRequestId?: number) => void;
-    onRuntimeStateChange?: (state: PreviewRuntimeState) => void;
-    onAspectRatioChange?: (aspectRatio: PreviewAspectRatio) => void;
-    onPreviewClipSelect?: (clipId: string) => void;
-    onVisualTransformCommit?: (clipId: string, visualTransform: ClipVisualTransform) => void;
-    onTextFontSizeCommit?: (clipId: string, fontSize: number) => void;
-    onTextRotationCommit?: (clipId: string, rotation: number) => void;
-    onPendingPreviewRetry?: () => void;
-    onPauseIfPlaying?: () => void;
-}
-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;
-    previewSourceResolver?: PreviewSourceResolver;
-    textPreviewFont?: TextPreviewFontConfig | null;
-    sourceMediaRegistry?: SourceMediaRegistry;
-    resourceCacheManager?: ResourceCacheManager | null;
-}
-export interface TimelinePreviewSyncPayload {
-    activeClips: ActiveClipPlaybackInfo[];
-    nextClips: ActiveClipPlaybackInfo[];
-    firstVideoClip: ActiveClipPlaybackInfo | null;
-    autoAspectRatioClip: ActiveClipPlaybackInfo | null;
-    currentTime: TimeMs;
-    playState: PlayState;
-    requestedPlayState?: PlayState;
-    speed: number;
-    interactionMode?: 'steady' | 'seek' | 'scrub';
-    primarySelectedClipId?: string | null;
-    syncRequestId?: number;
-}
-export declare class TimelinePreviewSession {
-    private container;
-    private rootElement;
-    private frameElement;
-    private textOverlayRoot;
-    private pendingOverlayElement;
-    private readonly pendingOverlayRenderer;
-    private resizeObserver;
-    private readonly trackSlots;
-    private readonly textPreviewEntries;
-    private audioContext;
-    private masterGainNode;
-    private loadingProbeTimeoutId;
-    private clockProbeTimeoutId;
-    private playbackGroupSuspended;
-    private lastRuntimeSignature;
-    private lastRuntimeState;
-    private lastSettledSyncRequestId;
-    private primarySelectedClipId;
-    private transientVisualTransform;
-    private transientFontSize;
-    private transientRotation;
-    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;
-    private aspectRatioProbeSrc;
-    private aspectRatioProbeResolveToken;
-    private pendingState;
-    private activeSyncRequestId;
-    private isSyncProjecting;
-    private readonly deferredPreloadSlotKeys;
-    private deferredPreloadFlushScheduled;
-    private lastSyncedPlayState;
-    private pendingClockAlignmentTargetTime;
-    constructor(callbacks?: TimelinePreviewSessionCallbacks, dependencies?: TimelinePreviewSessionDependencies);
-    private requestPauseIfPlaying;
-    private emitDiagnostic;
-    private buildSlotTraceData;
-    hasPreview(): boolean;
-    attach(container: HTMLElement): void;
-    detach(): void;
-    setPendingState(state: PreviewPendingState | null): void;
-    sync(payload: TimelinePreviewSyncPayload): void;
-    applyAspectRatio(aspectRatio: PreviewAspectRatio): void;
-    getAspectRatio(): PreviewAspectRatio;
-    private createMediaElement;
-    private createSlot;
-    private resetSlotRecoveryTracking;
-    private destroySlot;
-    private releaseSlotObjectUrl;
-    private clearPendingRuntimeSource;
-    private rememberSlotObjectUrl;
-    private revokeResolvedObjectUrl;
-    private getTrackSlots;
-    private swapTrackSlots;
-    private applyTrackPlan;
-    private applySlotTarget;
-    private settleResolvedSourceWithoutRecovery;
-    private resolveDesiredSource;
-    private decorateSlotSourceUrl;
-    private resolvePlayableSlotSource;
-    private emitRuntimeSourceDiagnostic;
-    private getReusableResolvedSlotSource;
-    private getReusableBoundSlotSource;
-    private slotNeedsRecovery;
-    private recoverSlot;
-    private finishSlotRecovery;
-    private getSlotKey;
-    private isActiveCurrentSlot;
-    private isTrackedActiveCurrentVideoSlot;
-    private hasBlockingActiveCurrentSlot;
-    private shouldDeferPreloadTarget;
-    private shouldDeferPreloadRecovery;
-    private buildDeferredPreloadTarget;
-    private deferPreloadTarget;
-    private deferPreloadRecovery;
-    private scheduleDeferredPreloadFlush;
-    private flushDeferredPreloads;
-    private applyResolvedSlotState;
-    private buildCurrentTargetForSlot;
-    private isCurrentRequest;
-    private isCurrentSourceTarget;
-    private shouldIgnoreExpectedEmptied;
-    private shouldIgnoreExpectedAbort;
-    private shouldIgnoreClearedSlotRecoverableEvent;
-    private shouldSkipImmediatePreloadRecovery;
-    private isBackgroundPreloadSlot;
-    private parkPreloadSlot;
-    private failSlot;
-    private configureAudioRouting;
-    private syncCurrentSlot;
-    private resetSlotPlaybackProgressProbe;
-    private updateSlotPlaybackProgressState;
-    private maybeResumeRequestedPlayback;
-    private canRuntimeCheckRetryBufferedPlayback;
-    private shouldClearRecoveredBufferingSignal;
-    private preparePreloadSlot;
-    private setSlotVisible;
-    private getAudioContext;
-    private getMasterGainNode;
-    private resumeAudioContext;
-    private updateFrameLayout;
-    private maybeResolveAutoAspectRatio;
-    private resolveAspectRatioProbeSource;
-    private buildPreviewSourceCacheKey;
-    private getAspectRatioProbe;
-    private tryResolveAutoAspectRatioFromSlot;
-    private handleResolvedAutoAspectRatio;
-    private refreshRuntimeState;
-    private buildPreviewClockState;
-    private buildPreviewClockStateFromSlot;
-    private resolveClockBlockedReason;
-    private getPreviewClockSourceSlot;
-    private buildPreviewClockSourceCandidate;
-    private comparePreviewClockSourceCandidates;
-    private isPreviewClockCandidateAlignedToTarget;
-    private getPreviewClockTargetAlignmentThresholdMs;
-    private isPreviewClockSlotAlignedToPendingTarget;
-    private updatePendingClockAlignmentTarget;
-    private syncActivePlaybackGroupSuspension;
-    private getSlotMediaTimeMs;
-    private getSlotTimelineTime;
-    private refreshPendingOverlay;
-    private buildPreviewLoadingState;
-    private evaluateTrackedCurrentVideoSlot;
-    private failStalledMediaPendingSlotIfNeeded;
-    private resetSlotMediaPendingProbe;
-    private doesSlotSourceMatchDesired;
-    private getSlotSeekThresholdSeconds;
-    private finalizeSourceResolutionResult;
-    private syncLoadingProbe;
-    private syncClockProbe;
-    private clearLoadingProbe;
-    private clearClockProbe;
-    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 syncSlotFailureVisualState;
-    private buildSelectedOverlayState;
-    private getFrameSize;
-    private getDocument;
-    private toFrameLocalPoint;
-    private getTextPreviewBaselineMetrics;
-    private getMediaSize;
-    private getEffectiveVisualTransform;
-}
-export {};