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

package/dist/utils/diagnostics/DiagnosticsCenter.d.ts

@@ -0,0 +1,47 @@
+import type { DiagnosticEmitInput, DiagnosticEvent, DiagnosticExportPackage, DiagnosticLiveSnapshot, DiagnosticsConfig, DiagnosticsListener, DiagnosticsLiveListener, DiagnosticRuntimeState, DiagnosticSessionMetadata, DiagnosticSessionSnapshot } from './types';
+export declare class DiagnosticsCenter {
+    private readonly config;
+    private readonly listeners;
+    private readonly liveListeners;
+    private state;
+    private currentSessionId;
+    private latestFailureWindow;
+    private activeFailureCapture;
+    private notifyTimeoutId;
+    private persistTimeoutId;
+    constructor(config?: DiagnosticsConfig);
+    startSession(metadata?: DiagnosticSessionMetadata | null): DiagnosticSessionSnapshot;
+    getCurrentSessionId(): string | null;
+    emit(input: DiagnosticEmitInput): DiagnosticEvent | null;
+    subscribe(listener: DiagnosticsListener): () => void;
+    subscribeLive(listener: DiagnosticsLiveListener, recentEventLimit?: number): () => void;
+    getSnapshot(sessionId?: string | null): DiagnosticSessionSnapshot;
+    getLiveSnapshot(sessionId?: string | null, recentEventLimit?: number): DiagnosticLiveSnapshot;
+    exportPackage(options?: {
+        sessionId?: string | null;
+        recentFailureContext?: number;
+        recentEventsFallback?: number;
+    }): DiagnosticExportPackage;
+    clear(sessionOnly?: boolean): void;
+    private ensureCurrentSession;
+    private resolveSession;
+    private createEvent;
+    private trimSessionEvents;
+    private findCoalescedEvent;
+    private buildEventIdentity;
+    private areEventIdentitiesEqual;
+    private updateCoalescedEvent;
+    private normalizeUrl;
+    private emitToConsole;
+    private scheduleNotify;
+    private notifyNow;
+    private schedulePersist;
+    private persistNow;
+    private clearScheduledTasks;
+    private restoreIndexedDbState;
+    private captureFailureWindow;
+    private buildFailureWindow;
+    private resolveExportFailureWindow;
+    private persistToLocalStorage;
+}
+export declare function mergeDiagnosticRuntimeState(base: DiagnosticRuntimeState | null | undefined, next: DiagnosticRuntimeState | null | undefined): DiagnosticRuntimeState | null;

package/dist/utils/diagnostics/DiagnosticsPanel.d.ts

@@ -0,0 +1,13 @@
+import type { DiagnosticsCenter } from './DiagnosticsCenter';
+export declare class DiagnosticsPanel {
+    private readonly diagnostics;
+    private container;
+    private summaryElement;
+    private failureElement;
+    private eventListElement;
+    private unsubscribe;
+    constructor(diagnostics: DiagnosticsCenter);
+    mount(host: HTMLElement): void;
+    destroy(): void;
+    private render;
+}

package/dist/utils/diagnostics/devConsole.d.ts

@@ -0,0 +1,8 @@
+type LazyDataFactory = () => unknown;
+export declare const devConsole: {
+    debug(_scope: string, _message: string, _data?: unknown): void;
+    debugLazy(_scope: string, _messageFactory: () => string, _dataFactory?: LazyDataFactory): void;
+    warn(scope: string, message: string, data?: unknown): void;
+    error(scope: string, message: string, data?: unknown): void;
+};
+export {};

package/dist/utils/diagnostics/index.d.ts

@@ -0,0 +1,4 @@
+export { DiagnosticsCenter, mergeDiagnosticRuntimeState } from './DiagnosticsCenter';
+export { DiagnosticsPanel } from './DiagnosticsPanel';
+export { devConsole } from './devConsole';
+export type { DiagnosticCategory, DiagnosticEmitInput, DiagnosticEvent, DiagnosticExportPackage, DiagnosticHardwareInfo, DiagnosticLiveEvent, DiagnosticLiveSnapshot, DiagnosticMediaState, DiagnosticNetworkInfo, DiagnosticRuntimeState, DiagnosticsConfig, DiagnosticsListener, DiagnosticsLiveListener, DiagnosticSessionMetadata, DiagnosticSessionSnapshot, DiagnosticSessionSummary, DiagnosticSeverity } from './types';

package/dist/utils/diagnostics/types.d.ts

@@ -0,0 +1,173 @@
+export type DiagnosticSeverity = 'debug' | 'info' | 'warn' | 'error';
+export type DiagnosticCategory = 'session' | 'resource' | 'playback' | 'runtime' | 'recovery' | 'ui-trigger';
+export interface DiagnosticsConfig {
+    enabled?: boolean;
+    persist?: boolean;
+    storageQuotaMb?: number;
+    maxSessions?: number;
+    maxHotEvents?: number;
+    includeFullSourceUrl?: boolean;
+    enablePanel?: boolean;
+    consoleSeverityThreshold?: DiagnosticSeverity;
+}
+export interface DiagnosticMediaError {
+    code: number | null;
+    message: string | null;
+}
+export interface DiagnosticMediaState {
+    currentTime: number | null;
+    duration: number | null;
+    readyState: number | null;
+    networkState: number | null;
+    paused: boolean | null;
+    ended: boolean | null;
+    playbackRate: number | null;
+    currentSrc: string | null;
+    bufferedEnd: number | null;
+    videoWidth: number | null;
+    videoHeight: number | null;
+    error: DiagnosticMediaError | null;
+    [key: string]: unknown;
+}
+export interface DiagnosticRuntimeState {
+    currentTimeMs?: number;
+    playState?: string;
+    speed?: number;
+    pendingMode?: 'seek' | 'scrub' | null;
+    loadingCount?: number;
+    isBuffering?: boolean;
+    runtimePhase?: string;
+    selectedClipId?: string | null;
+    activeClipIds?: string[];
+    previewAspectRatio?: {
+        mode: string;
+        width: number;
+        height: number;
+    } | null;
+    [key: string]: unknown;
+}
+export interface DiagnosticErrorPayload {
+    name: string | null;
+    message: string | null;
+    stack: string | null;
+    cause: unknown;
+}
+export interface DiagnosticHardwareInfo {
+    platform: string | null;
+    hardwareConcurrency: number | null;
+    deviceMemory: number | null;
+    maxTouchPoints: number | null;
+    language: string | null;
+    languages: string[] | null;
+}
+export interface DiagnosticNetworkInfo {
+    online: boolean | null;
+    effectiveType: string | null;
+    downlinkMbps: number | null;
+    rttMs: number | null;
+    saveData: boolean | null;
+    connectionType: string | null;
+}
+export interface DiagnosticEvent {
+    eventId: string;
+    sessionId: string;
+    sequence: number;
+    timestamp: number;
+    isoTime: string;
+    perfTimeMs: number | null;
+    severity: DiagnosticSeverity;
+    category: DiagnosticCategory;
+    eventName: string;
+    message: string | null;
+    syncRequestId: number | null;
+    playbackAttemptId: string | null;
+    previewBackend: string | null;
+    trackId: string | null;
+    clipId: string | null;
+    slotKey: string | null;
+    sourceUrl: string | null;
+    desiredSourceUrl: string | null;
+    actualSourceUrl: string | null;
+    mediaState: DiagnosticMediaState | null;
+    runtimeState: DiagnosticRuntimeState | null;
+    error: DiagnosticErrorPayload | null;
+    extra: Record<string, unknown> | null;
+}
+export interface DiagnosticSessionMetadata {
+    packageName?: string | null;
+    packageVersion?: string | null;
+    userAgent?: string | null;
+    href?: string | null;
+    configuredPreviewBackend?: string | null;
+    hardware?: DiagnosticHardwareInfo | null;
+    network?: DiagnosticNetworkInfo | null;
+    environmentCapturedAt?: string | null;
+    environmentExportedAt?: string | null;
+    [key: string]: unknown;
+}
+export interface DiagnosticSessionSummary {
+    totalEvents: number;
+    severityCounts: Record<DiagnosticSeverity, number>;
+    categoryCounts: Record<DiagnosticCategory, number>;
+    failureCount: number;
+    lastFailureEvent: Pick<DiagnosticEvent, 'eventId' | 'eventName' | 'timestamp' | 'isoTime' | 'message' | 'trackId' | 'clipId' | 'syncRequestId' | 'playbackAttemptId'> | null;
+}
+export interface DiagnosticSessionSnapshot {
+    sessionId: string;
+    startedAt: number;
+    updatedAt: number;
+    metadata: DiagnosticSessionMetadata | null;
+    events: DiagnosticEvent[];
+    summary: DiagnosticSessionSummary;
+}
+export interface DiagnosticLiveEvent {
+    sequence: number;
+    timestamp: number;
+    isoTime: string;
+    severity: DiagnosticSeverity;
+    category: DiagnosticCategory;
+    eventName: string;
+    message: string | null;
+    syncRequestId: number | null;
+    playbackAttemptId: string | null;
+    trackId: string | null;
+    clipId: string | null;
+    extra: Record<string, unknown> | null;
+    error: DiagnosticErrorPayload | null;
+}
+export interface DiagnosticLiveSnapshot {
+    sessionId: string;
+    startedAt: number;
+    updatedAt: number;
+    metadata: DiagnosticSessionMetadata | null;
+    summary: DiagnosticSessionSummary;
+    recentEvents: DiagnosticLiveEvent[];
+}
+export interface DiagnosticExportPackage {
+    exportedAt: string;
+    session: Omit<DiagnosticSessionSnapshot, 'events'>;
+    rawEvents: DiagnosticEvent[];
+    failureWindow: DiagnosticEvent[];
+    failureWindowSource: 'live' | 'persisted' | 'recent-events';
+}
+export interface DiagnosticEmitInput {
+    severity: DiagnosticSeverity;
+    category: DiagnosticCategory;
+    eventName: string;
+    message?: string | null;
+    syncRequestId?: number | null;
+    playbackAttemptId?: string | null;
+    previewBackend?: string | null;
+    trackId?: string | null;
+    clipId?: string | null;
+    slotKey?: string | null;
+    sourceUrl?: string | null;
+    desiredSourceUrl?: string | null;
+    actualSourceUrl?: string | null;
+    mediaState?: DiagnosticMediaState | null;
+    runtimeState?: DiagnosticRuntimeState | null;
+    error?: unknown;
+    extra?: Record<string, unknown> | null;
+}
+export type DiagnosticsListener = (snapshot: DiagnosticSessionSnapshot) => void;
+export type DiagnosticsLiveListener = (snapshot: DiagnosticLiveSnapshot) => void;

package/dist/utils/mediaElement.d.ts

@@ -0,0 +1 @@
+export declare function disableVideoPictureInPicture(video: HTMLVideoElement): void;

package/package.json

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

package/dist/utils/logging/Logger.d.ts

@@ -1,30 +0,0 @@
-import type { LogConfig } from '../../core/models/types';
-export declare class Logger {
-    private static config;
-    private static dedupeWindowMs;
-    private static readonly dedupeState;
-    /**
-     * 配置日志系统
-     * @param config 日志配置
-     */
-    static setConfig(config?: LogConfig): void;
-    /**
-     * 输出调试级别日志
-     * @param module 模块名称
-     * @param message 日志消息
-     * @param data 附加数据
-     */
-    static debug(module: string, message: string, data?: any): void;
-    static debugLazy(module: string, messageFactory: () => string, dataFactory?: () => any): void;
-    static info(module: string, message: string, data?: any): void;
-    static infoLazy(module: string, messageFactory: () => string, dataFactory?: () => any): void;
-    static warn(module: string, message: string, data?: any): void;
-    static warnLazy(module: string, messageFactory: () => string, dataFactory?: () => any): void;
-    static error(module: string, message: string, data?: any): void;
-    /**
-     * 设置去重窗口，减少高频日志刷屏
-     */
-    static setDedupeWindowMs(windowMs: number): void;
-    private static emit;
-    private static resolveConsoleMethod;
-}

package/dist/utils/logging/PreviewLoadTraceStore.d.ts

@@ -1,37 +0,0 @@
-export type PreviewLoadTraceLevel = 'debug' | 'info' | 'warn' | 'error';
-export interface PreviewLoadTraceEntry {
-    id: string;
-    sessionId: string;
-    createdAt: number;
-    isoTime: string;
-    perfTimeMs: number | null;
-    level: PreviewLoadTraceLevel;
-    event: string;
-    data: Record<string, unknown> | null;
-}
-export interface PreviewLoadTraceSnapshot {
-    storageKey: string;
-    currentSessionId: string;
-    updatedAt: number;
-    entries: PreviewLoadTraceEntry[];
-}
-type PreviewLoadTraceListener = (snapshot: PreviewLoadTraceSnapshot) => void;
-export declare class PreviewLoadTraceStore {
-    private state;
-    private readonly listeners;
-    constructor();
-    getStorageKey(): string;
-    getSnapshot(): PreviewLoadTraceSnapshot;
-    subscribe(listener: PreviewLoadTraceListener): () => void;
-    append(input: {
-        level: PreviewLoadTraceLevel;
-        event: string;
-        data?: Record<string, unknown> | null;
-    }): PreviewLoadTraceEntry;
-    clear(): void;
-    exportJson(limit?: number): string;
-    private persist;
-    private emit;
-}
-export declare const previewLoadTraceStore: PreviewLoadTraceStore;
-export {};

package/dist/utils/logging/index.d.ts

@@ -1,2 +0,0 @@
-export { Logger } from './Logger';
-export { PreviewLoadTraceStore, previewLoadTraceStore, type PreviewLoadTraceEntry, type PreviewLoadTraceLevel, type PreviewLoadTraceSnapshot } from './PreviewLoadTraceStore';