@linker-design-plus/timeline-track 2.1.6 → 2.2.1

package/dist/core/preview/textPreviewLayout.d.ts

@@ -0,0 +1,79 @@
+import type { ClipVisualTransform, TextClipLayoutMode, TextClipResolvedLayout, TextClipStyle } from '../models/types';
+import { type PreviewFrameSize, type PreviewRect } from '../controllers/previewTransformMath';
+/** 文本 visualTransform 使用框中心锚点。 */
+export declare const TEXT_CLIP_ANCHOR_VERSION_CENTER = 1;
+export interface TextLayoutStyleOverride {
+    fontSize?: number;
+    rotation?: number;
+    layoutWidth?: number;
+    layoutHeight?: number;
+}
+export interface TextPreviewBoxLayout {
+    layoutWidth: number;
+    layoutHeight: number;
+    frameRect: PreviewRect;
+    visualTransform: ClipVisualTransform;
+}
+export interface ComputeTextPreviewBoxInput {
+    frameSize: PreviewFrameSize;
+    baselineScale: number;
+    visualTransform: ClipVisualTransform;
+    textStyle: TextClipStyle;
+    contentText: string;
+    styleOverride?: TextLayoutStyleOverride | null;
+}
+/** 将 baseline 画布上的字号/内边距/描边换算为当前预览帧像素（短边 720 等比缩放）。 */
+export declare function scaleTextMetricsToFrame(fontSize: number, paddingX: number, strokeWidth: number, baselineScale: number): {
+    fontSize: number;
+    paddingX: number;
+    strokeWidth: number;
+};
+/** 布局换行宽度 fallback（仅 migrate / 无 layoutWidth 时）。 */
+export declare function resolveTextEntryMaxWidthPx(frameWidth: number, baselineScale: number, paddingX: number, anchorX?: number): number;
+export declare function estimateTextLayoutHeightBaseline(fontSize: number, contentText: string, layoutWidthBaseline: number, paddingX: number): number;
+export declare function resolveDefaultTextCenterTransform(frameSize: PreviewFrameSize, layoutHeightBaseline: number, baselineScale: number): ClipVisualTransform;
+export declare function resolveDefaultTextCenterTransformForBaselineFrame(baselineFrameHeight: number, layoutHeightBaseline?: number): ClipVisualTransform;
+export declare function usesLegacyBottomAnchorY(textStyle: TextClipStyle, transformY: number): boolean;
+export declare function resolveTextBoxCenterY(frameSize: PreviewFrameSize, transform: ClipVisualTransform, textStyle: TextClipStyle, displayHeightPx: number): number;
+export declare function migrateBottomAnchorTransformToCenter(transform: ClipVisualTransform, frameSize: PreviewFrameSize, displayHeightPx: number): ClipVisualTransform;
+export declare function resolveTextVisualTransformForPreview(transform: Partial<ClipVisualTransform> | null | undefined, textStyle: TextClipStyle, frameSize: PreviewFrameSize, displayHeightPx: number): ClipVisualTransform;
+/** clip 已持久化 layoutHeight 表示用户手动调整过文本框，预览应固定高度并截断溢出。 */
+export declare function hasManualTextLayoutSize(textStyle: TextClipStyle): boolean;
+export declare function resolveTextClipLayoutMode(textStyle?: Partial<TextClipStyle> | null): TextClipLayoutMode;
+export declare function resolveTextLayoutDimensions(input: ComputeTextPreviewBoxInput): {
+    layoutWidth: number;
+    layoutHeight: number;
+};
+export declare function computeTextPreviewBox(input: ComputeTextPreviewBoxInput): TextPreviewBoxLayout;
+/** 按指针相对框中心的轴向距离独立缩放宽高（不保持宽高比）。 */
+export declare function scaleTextLayoutFromPointer(pointerX: number, pointerY: number, centerX: number, centerY: number, baselineScale: number): {
+    layoutWidth: number;
+    layoutHeight: number;
+};
+export declare function buildTextPreviewBoxForEntry(entry: {
+    clip: {
+        textStyle?: Partial<TextClipStyle> | null;
+        textContent?: string;
+        name?: string;
+        visualTransform?: Partial<ClipVisualTransform> | null;
+    };
+}, frameSize: PreviewFrameSize, baselineScale: number, styleOverride?: TextLayoutStyleOverride | null): TextPreviewBoxLayout;
+export interface BuildTextClipResolvedLayoutInput {
+    frameSize: PreviewFrameSize;
+    composition: {
+        width: number;
+        height: number;
+    };
+    lastLayout: TextPreviewBoxLayout;
+    layoutMode: TextClipLayoutMode;
+}
+export declare function buildAutoMeasuredTextPreviewBoxLayout(input: {
+    layout: TextPreviewBoxLayout;
+    frameSize: PreviewFrameSize;
+    baselineScale: number;
+    visualTransform: ClipVisualTransform;
+    textStyle: TextClipStyle;
+    measuredHeightPx: number;
+}): TextPreviewBoxLayout;
+export declare function buildTextClipResolvedLayout(input: BuildTextClipResolvedLayoutInput): TextClipResolvedLayout;
+export declare function areTextClipResolvedLayoutsEqual(left?: TextClipResolvedLayout | null, right?: TextClipResolvedLayout | null, epsilon?: number): boolean;

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

@@ -0,0 +1,65 @@
+import type { ActiveClipPlaybackInfo, PlayState, TrackType } from '../models/types';
+import type { PreviewSlotPhase } from '../controllers/previewBackend';
+export interface ResolvedSlotSource {
+    stableSourceUrl: string;
+    url: string;
+    objectUrl: string | null;
+    sizeBytes: number | null;
+}
+export interface SlotGeneration {
+    syncGen: number;
+    sourceGen: number;
+}
+export interface PlaybackSlotState {
+    trackId: string;
+    kind: TrackType;
+    role: 'current' | 'preload';
+    element: HTMLMediaElement;
+    wrapper: HTMLDivElement | null;
+    failureOverlay: HTMLDivElement | null;
+    failureLabel: HTMLDivElement | null;
+    entry: ActiveClipPlaybackInfo | null;
+    stableSourceUrl: string | null;
+    boundStableKey: string | null;
+    desiredSource: string | null;
+    objectUrl: string | null;
+    requestedPlayState: PlayState;
+    isActive: boolean;
+    isLoading: boolean;
+    isResolvingSource: boolean;
+    isBuffering: boolean;
+    isSeeking: boolean;
+    phase: PreviewSlotPhase;
+    errorMessage: string | null;
+    hasReadyEventSinceSourceChange: boolean;
+    pendingClockAlignmentMediaTime: number | null;
+    sourceGen: number;
+    sourceNode: MediaElementAudioSourceNode | null;
+    gainNode: GainNode | null;
+    audioRoutingFailed: boolean;
+    cleanup: Array<() => void>;
+    sourceMatchesDesired(): boolean;
+}
+export interface TrackedVideoSlotStatus {
+    failed: boolean;
+    resolving: boolean;
+    seeking: boolean;
+    mediaUnready: boolean;
+    ready: boolean;
+}
+export interface PreviewEngineCallbacks {
+    onSyncProcessed?: (syncRequestId?: number) => void;
+    onRuntimeStateChange?: (state: import('../controllers/previewBackend').PreviewRuntimeState) => void;
+    onAspectRatioChange?: (aspectRatio: import('../models/types').PreviewAspectRatio) => void;
+    onPreviewClipSelect?: (clipId: string) => void;
+    onVisualTransformCommit?: (clipId: string, visualTransform: import('../models/types').ClipVisualTransform) => void;
+    onTextFontSizeCommit?: (clipId: string, fontSize: number) => void;
+    onTextRotationCommit?: (clipId: string, rotation: number) => void;
+    onTextLayoutCommit?: (clipId: string, layout: {
+        layoutWidth: number;
+        layoutHeight: number;
+    }) => void;
+    onTextLayoutResolved?: (clipId: string, layout: import('../models/types').TextClipResolvedLayout) => void;
+    onPendingPreviewRetry?: () => void;
+    onPauseIfPlaying?: () => void;
+}