@meframe/core 0.1.2 → 0.1.3

package/dist/Meframe.d.ts

@@ -58,6 +58,22 @@ export declare class Meframe {
      * Uses ExportController for direct export
      */
     export(options: ExportOptions): Promise<Blob>;
+    /**
+     * Cancel ongoing export operation
+     */
+    cancelExport(): void;
+    /**
+     * Pause ongoing export operation
+     */
+    pauseExport(): void;
+    /**
+     * Resume paused export operation
+     */
+    resumeExport(): void;
+    /**
+     * Check if export is paused
+     */
+    isExportPaused(): boolean;
     /**
      * Get current playback time
      */

package/dist/Meframe.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Meframe.d.ts","sourceRoot":"","sources":["../src/Meframe.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAC1F,OAAO,KAAK,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AACpF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEzD,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAK5D,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AACxD,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAgB,KAAK,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACpE,OAAO,EAAE,yBAAyB,EAAE,MAAM,wBAAwB,CAAC;AAGnE,qBAAa,OAAO;IAClB,wDAAwD;IACxD,KAAK,EAAE,YAAY,CAAU;IAC7B,mDAAmD;IACnD,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC;IAChC,4DAA4D;IAC5D,KAAK,EAAE,gBAAgB,GAAG,IAAI,CAAQ;IACtC,oCAAoC;IACpC,QAAQ,CAAC,aAAa,EAAE,aAAa,CAAC;IACtC,kDAAkD;IAClD,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAC,QAAQ,CAAC,eAAe,CAAC,EAAE,IAAI,GAAG,KAAK,GAAG,MAAM,CAAC,CAAC;IAExE,OAAO,CAAC,YAAY,CAAe;IACnC,OAAO,CAAC,QAAQ,CAA4B;IAC5C,OAAO,CAAC,kBAAkB,CAAmC;IAC7D,OAAO,CAAC,gBAAgB,CAAmB;IAC3C,OAAO,CAAC,MAAM,CAAC,CAAoB;IAEnC;;;OAGG;IACH,MAAM,CAAC,kBAAkB,IAAI,UAAU,CAAC,OAAO,yBAAyB,CAAC;IAIzE,OAAO;IAoBP;;OAEG;WACU,MAAM,CAAC,MAAM,GAAE,aAAkB,GAAG,OAAO,CAAC,OAAO,CAAC;IAcjE;;OAEG;YACW,UAAU;IAyBxB;;OAEG;IACG,mBAAmB,CAAC,KAAK,EAAE,gBAAgB,GAAG,oBAAoB,GAAG,OAAO,CAAC,IAAI,CAAC;IAuBxF;;OAEG;IACG,UAAU,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC;IAcxD;;OAEG;IACH,YAAY,CAAC,OAAO,CAAC,EAAE;QACrB,MAAM,CAAC,EAAE,iBAAiB,CAAC;QAC3B,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,SAAS,CAAC,EAAE,OAAO,CAAC;KACrB,GAAG,aAAa;IA6BjB;;;OAGG;IACG,MAAM,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IA+CnD;;OAEG;IACH,cAAc,IAAI,MAAM;IAIxB;;;OAGG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAYjC;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAoB9B;;OAEG;IACH,OAAO,CAAC,QAAQ;IAYhB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAM1B;;OAEG;IACH,OAAO,CAAC,WAAW;CAWpB"}
+{"version":3,"file":"Meframe.d.ts","sourceRoot":"","sources":["../src/Meframe.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAC1F,OAAO,KAAK,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AACpF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEzD,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAK5D,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AACxD,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAgB,KAAK,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACpE,OAAO,EAAE,yBAAyB,EAAE,MAAM,wBAAwB,CAAC;AAGnE,qBAAa,OAAO;IAClB,wDAAwD;IACxD,KAAK,EAAE,YAAY,CAAU;IAC7B,mDAAmD;IACnD,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC;IAChC,4DAA4D;IAC5D,KAAK,EAAE,gBAAgB,GAAG,IAAI,CAAQ;IACtC,oCAAoC;IACpC,QAAQ,CAAC,aAAa,EAAE,aAAa,CAAC;IACtC,kDAAkD;IAClD,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAC,QAAQ,CAAC,eAAe,CAAC,EAAE,IAAI,GAAG,KAAK,GAAG,MAAM,CAAC,CAAC;IAExE,OAAO,CAAC,YAAY,CAAe;IACnC,OAAO,CAAC,QAAQ,CAA4B;IAC5C,OAAO,CAAC,kBAAkB,CAAmC;IAC7D,OAAO,CAAC,gBAAgB,CAAmB;IAC3C,OAAO,CAAC,MAAM,CAAC,CAAoB;IAEnC;;;OAGG;IACH,MAAM,CAAC,kBAAkB,IAAI,UAAU,CAAC,OAAO,yBAAyB,CAAC;IAIzE,OAAO;IAoBP;;OAEG;WACU,MAAM,CAAC,MAAM,GAAE,aAAkB,GAAG,OAAO,CAAC,OAAO,CAAC;IAcjE;;OAEG;YACW,UAAU;IAyBxB;;OAEG;IACG,mBAAmB,CAAC,KAAK,EAAE,gBAAgB,GAAG,oBAAoB,GAAG,OAAO,CAAC,IAAI,CAAC;IAuBxF;;OAEG;IACG,UAAU,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC;IAcxD;;OAEG;IACH,YAAY,CAAC,OAAO,CAAC,EAAE;QACrB,MAAM,CAAC,EAAE,iBAAiB,CAAC;QAC3B,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,SAAS,CAAC,EAAE,OAAO,CAAC;KACrB,GAAG,aAAa;IA6BjB;;;OAGG;IACG,MAAM,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IA+CnD;;OAEG;IACH,YAAY,IAAI,IAAI;IAIpB;;OAEG;IACH,WAAW,IAAI,IAAI;IAInB;;OAEG;IACH,YAAY,IAAI,IAAI;IAIpB;;OAEG;IACH,cAAc,IAAI,OAAO;IAIzB;;OAEG;IACH,cAAc,IAAI,MAAM;IAIxB;;;OAGG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAYjC;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAoB9B;;OAEG;IACH,OAAO,CAAC,QAAQ;IAYhB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAM1B;;OAEG;IACH,OAAO,CAAC,WAAW;CAWpB"}

package/dist/Meframe.js

@@ -174,6 +174,30 @@ class Meframe {
       throw error;
     }
   }
+  /**
+   * Cancel ongoing export operation
+   */
+  cancelExport() {
+    this.exportController.cancel();
+  }
+  /**
+   * Pause ongoing export operation
+   */
+  pauseExport() {
+    this.exportController.pause();
+  }
+  /**
+   * Resume paused export operation
+   */
+  resumeExport() {
+    this.exportController.resume();
+  }
+  /**
+   * Check if export is paused
+   */
+  isExportPaused() {
+    return this.exportController.isPaused();
+  }
   /**
    * Get current playback time
    */

package/dist/Meframe.js.map

@@ -1 +1 @@
-{"version":3,"file":"Meframe.js","sources":["../src/Meframe.ts"],"sourcesContent":["/**\n * Meframe - Main entry point for the media processing framework\n */\n\nimport type { MeframeConfig, ResolvedConfig, MeframeState, ExportOptions } from './types';\nimport type { CompositionModelData, CompositionPatch, TimeUs } from './model/types';\nimport type { PreviewHandle } from './controllers/types';\nimport type { Plugin } from './plugins/types';\nimport { CompositionModel } from './model/CompositionModel';\nimport { loadConfig } from './config';\nimport { Orchestrator } from './orchestrator/Orchestrator';\nimport { PlaybackController } from './controllers/PlaybackController';\nimport { ExportController } from './controllers/ExportController';\nimport { PluginManager } from './plugins/PluginManager';\nimport { EventBus } from './event/EventBus';\nimport { MeframeEvent, type EventPayloadMap } from './event/events';\nimport { checkBrowserCompatibility } from './utils/platform-utils';\nimport { BrowserCompatibilityError } from './utils/errors';\n\nexport class Meframe {\n  /** Current state - managed internally via setState() */\n  state: MeframeState = 'idle';\n  /** Configuration - immutable after construction */\n  readonly config: ResolvedConfig;\n  /** Composition model - managed via setCompositionModel() */\n  model: CompositionModel | null = null;\n  /** Plugin manager for extensions */\n  readonly pluginManager: PluginManager;\n  /** Event bus for subscribing to Meframe events */\n  readonly events: Pick<EventBus<EventPayloadMap>, 'on' | 'off' | 'once'>;\n\n  private orchestrator: Orchestrator;\n  private eventBus: EventBus<EventPayloadMap>;\n  private playbackController: PlaybackController | null = null;\n  private exportController: ExportController;\n  private canvas?: HTMLCanvasElement;\n\n  /**\n   * Check if current browser is compatible with Meframe\n   * Returns compatibility info including browser name, version, and missing features\n   */\n  static checkCompatibility(): ReturnType<typeof checkBrowserCompatibility> {\n    return checkBrowserCompatibility();\n  }\n\n  private constructor(config: ResolvedConfig) {\n    this.config = config;\n    this.eventBus = new EventBus<EventPayloadMap>();\n    this.events = this.eventBus.asReadonly();\n    this.pluginManager = new PluginManager(this);\n\n    // Initialize orchestrator with configuration and shared eventBus\n    // Worker paths are passed via config\n    this.orchestrator = new Orchestrator({\n      projectId: config.global.projectId,\n      maxWorkers: (config as any).maxWorkers,\n      cacheConfig: config.cache as any,\n      eventBus: this.eventBus,\n      workerPath: config.global.workerPath,\n      workerExtension: config.global.workerExtension,\n    });\n\n    this.exportController = new ExportController(this.orchestrator);\n  }\n\n  /**\n   * Create a new Meframe instance\n   */\n  static async create(config: MeframeConfig = {}): Promise<Meframe> {\n    // Check browser compatibility first\n    const compatibility = checkBrowserCompatibility();\n    if (!compatibility.webCodecsAvailable || !compatibility.opfsAvailable) {\n      throw new BrowserCompatibilityError(compatibility);\n    }\n\n    // Load and resolve configuration using ConfigLoader\n    const resolvedConfig = await loadConfig({ override: config });\n    const instance = new Meframe(resolvedConfig);\n    await instance.initialize();\n    return instance;\n  }\n\n  /**\n   * Initialize the core engine\n   */\n  private async initialize(): Promise<void> {\n    this.setState('loading');\n\n    try {\n      // Initialize orchestrator (sets up workers and cache)\n      await this.orchestrator.initialize();\n\n      // Initialize plugins if provided\n      const plugins = (this.config as any).plugins;\n      if (plugins && Array.isArray(plugins)) {\n        for (const plugin of plugins) {\n          // Ensure plugin type matches the Plugin interface\n          if (plugin && typeof plugin === 'object' && 'name' in plugin && 'install' in plugin) {\n            this.pluginManager.register(plugin as Plugin);\n          }\n        }\n      }\n\n      this.setState('idle');\n    } catch (error) {\n      this.setState('error');\n      throw error;\n    }\n  }\n\n  /**\n   * Set the composition model\n   */\n  async setCompositionModel(model: CompositionModel | CompositionModelData): Promise<void> {\n    this.ensureNotDestroyed();\n\n    // Convert plain object to CompositionModel instance if needed\n    const compositionModel =\n      model instanceof CompositionModel ? model : new CompositionModel(model);\n\n    // Set the model in orchestrator\n    await this.orchestrator.setCompositionModel(compositionModel);\n    this.model = compositionModel;\n\n    this.setState('ready');\n    this.eventBus.emit(MeframeEvent.Ready, {\n      trackCount: model.tracks.length,\n      clipCount: model.tracks.reduce(\n        (acc: number, track: any) => acc + track.clips?.length || 0,\n        0\n      ),\n      durationUs: model.durationUs,\n    });\n    // await this.playbackController?.renderCover();\n  }\n\n  /**\n   * Apply a patch to the composition model\n   */\n  async applyPatch(patch: CompositionPatch): Promise<void> {\n    this.ensureNotDestroyed();\n\n    if (!this.model) {\n      throw new Error('No composition model set');\n    }\n\n    // Apply patch through orchestrator\n    await this.orchestrator.applyPatch(patch);\n\n    // Patch is applied to the model by orchestrator\n    this.model = this.orchestrator.compositionModel!;\n  }\n\n  /**\n   * Start preview and return a handle for control\n   */\n  startPreview(options?: {\n    canvas?: HTMLCanvasElement;\n    startUs?: TimeUs;\n    autoStart?: boolean;\n  }): PreviewHandle {\n    this.ensureReady();\n\n    // Use provided canvas or the one from config\n    const canvas = options?.canvas || this.canvas;\n    if (!canvas) {\n      throw new Error('Canvas is required for preview');\n    }\n\n    // Store canvas for later use\n    this.canvas = canvas;\n\n    // Create playback controller\n    if (!this.playbackController) {\n      this.playbackController = new PlaybackController(this.orchestrator as any, this.eventBus, {\n        canvas,\n        startUs: options?.startUs,\n        autoStart: options?.autoStart,\n      });\n    }\n\n    // Render initial frame\n    this.playbackController.renderCover();\n    this.playbackController.preheatNextWindow();\n\n    // Return preview handle\n    return this.playbackController;\n  }\n\n  /**\n   * Export the composition\n   * Uses ExportController for direct export\n   */\n  async export(options: ExportOptions): Promise<Blob> {\n    this.ensureReady();\n    this.playbackController?.pause();\n    this.setState('exporting');\n\n    try {\n      const model = this.model;\n      if (!model) {\n        throw new Error('No composition model set');\n      }\n\n      const width = options.width || (model as any).renderConfig?.width || 720;\n      const height = options.height || (model as any).renderConfig?.height || 1280;\n      const fps = options.fps || model.fps || 30;\n\n      this.eventBus.emit(MeframeEvent.ExportStart, {\n        format: options.format || 'mp4',\n        width,\n        height,\n        fps,\n        durationUs: model.durationUs,\n      });\n\n      // Delegate to ExportController\n      const blob = await this.exportController.export(model, options);\n\n      this.setState('ready');\n      this.eventBus.emit(MeframeEvent.ExportComplete, {\n        size: blob.size,\n        durationMs: model.durationUs / 1000,\n        format: options.format || 'mp4',\n      });\n      this.eventBus.emit(MeframeEvent.ExportProgress, {\n        progress: 1,\n      });\n\n      return blob;\n    } catch (error) {\n      this.setState('error');\n      this.eventBus.emit(MeframeEvent.ExportError, {\n        error: error as Error,\n        stage: 'export',\n      });\n      throw error;\n    }\n  }\n\n  /**\n   * Get current playback time\n   */\n  getCurrentTime(): number {\n    return this.playbackController?.currentTimeUs || 0;\n  }\n\n  /**\n   * Clear all L1/L2 cache data\n   * Useful for debugging or forcing re-render\n   */\n  async clearCache(): Promise<void> {\n    this.ensureReady();\n\n    // Stop playback first\n    this.playbackController?.stop();\n\n    // Clear cache through CacheManager\n    await this.orchestrator.cacheManager.clear();\n\n    console.log('[Meframe] Cache cleared successfully');\n  }\n\n  /**\n   * Clean up and destroy the instance\n   */\n  async dispose(): Promise<void> {\n    if (this.state === 'destroyed') return;\n\n    // Stop playback\n    this.playbackController?.stop();\n    this.playbackController?.dispose();\n    this.playbackController = null;\n\n    // Cleanup plugins\n    await this.pluginManager.disposeAll();\n\n    // Dispose orchestrator (stops workers and clears cache)\n    await this.orchestrator.dispose();\n\n    // Clear event bus\n    this.eventBus.dispose();\n\n    this.setState('destroyed');\n  }\n\n  /**\n   * Set internal state\n   */\n  private setState(state: MeframeState): void {\n    const oldState = this.state;\n    this.state = state;\n\n    // Emit state change event\n    // Use a generic event for now, can be added to MeframeEvent enum later\n    this.eventBus.emit('state:changed' as any, {\n      oldState,\n      newState: state,\n    });\n  }\n\n  /**\n   * Ensure the instance is not destroyed\n   */\n  private ensureNotDestroyed(): void {\n    if (this.state === 'destroyed') {\n      throw new Error('Core instance is destroyed');\n    }\n  }\n\n  /**\n   * Ensure the instance is ready\n   */\n  private ensureReady(): void {\n    this.ensureNotDestroyed();\n\n    if (!this.model) {\n      throw new Error('No composition model set');\n    }\n\n    if (this.state === 'loading' || this.state === 'idle') {\n      throw new Error('Core is not ready');\n    }\n  }\n}\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"Meframe.js","sources":["../src/Meframe.ts"],"sourcesContent":["/**\n * Meframe - Main entry point for the media processing framework\n */\n\nimport type { MeframeConfig, ResolvedConfig, MeframeState, ExportOptions } from './types';\nimport type { CompositionModelData, CompositionPatch, TimeUs } from './model/types';\nimport type { PreviewHandle } from './controllers/types';\nimport type { Plugin } from './plugins/types';\nimport { CompositionModel } from './model/CompositionModel';\nimport { loadConfig } from './config';\nimport { Orchestrator } from './orchestrator/Orchestrator';\nimport { PlaybackController } from './controllers/PlaybackController';\nimport { ExportController } from './controllers/ExportController';\nimport { PluginManager } from './plugins/PluginManager';\nimport { EventBus } from './event/EventBus';\nimport { MeframeEvent, type EventPayloadMap } from './event/events';\nimport { checkBrowserCompatibility } from './utils/platform-utils';\nimport { BrowserCompatibilityError } from './utils/errors';\n\nexport class Meframe {\n  /** Current state - managed internally via setState() */\n  state: MeframeState = 'idle';\n  /** Configuration - immutable after construction */\n  readonly config: ResolvedConfig;\n  /** Composition model - managed via setCompositionModel() */\n  model: CompositionModel | null = null;\n  /** Plugin manager for extensions */\n  readonly pluginManager: PluginManager;\n  /** Event bus for subscribing to Meframe events */\n  readonly events: Pick<EventBus<EventPayloadMap>, 'on' | 'off' | 'once'>;\n\n  private orchestrator: Orchestrator;\n  private eventBus: EventBus<EventPayloadMap>;\n  private playbackController: PlaybackController | null = null;\n  private exportController: ExportController;\n  private canvas?: HTMLCanvasElement;\n\n  /**\n   * Check if current browser is compatible with Meframe\n   * Returns compatibility info including browser name, version, and missing features\n   */\n  static checkCompatibility(): ReturnType<typeof checkBrowserCompatibility> {\n    return checkBrowserCompatibility();\n  }\n\n  private constructor(config: ResolvedConfig) {\n    this.config = config;\n    this.eventBus = new EventBus<EventPayloadMap>();\n    this.events = this.eventBus.asReadonly();\n    this.pluginManager = new PluginManager(this);\n\n    // Initialize orchestrator with configuration and shared eventBus\n    // Worker paths are passed via config\n    this.orchestrator = new Orchestrator({\n      projectId: config.global.projectId,\n      maxWorkers: (config as any).maxWorkers,\n      cacheConfig: config.cache as any,\n      eventBus: this.eventBus,\n      workerPath: config.global.workerPath,\n      workerExtension: config.global.workerExtension,\n    });\n\n    this.exportController = new ExportController(this.orchestrator);\n  }\n\n  /**\n   * Create a new Meframe instance\n   */\n  static async create(config: MeframeConfig = {}): Promise<Meframe> {\n    // Check browser compatibility first\n    const compatibility = checkBrowserCompatibility();\n    if (!compatibility.webCodecsAvailable || !compatibility.opfsAvailable) {\n      throw new BrowserCompatibilityError(compatibility);\n    }\n\n    // Load and resolve configuration using ConfigLoader\n    const resolvedConfig = await loadConfig({ override: config });\n    const instance = new Meframe(resolvedConfig);\n    await instance.initialize();\n    return instance;\n  }\n\n  /**\n   * Initialize the core engine\n   */\n  private async initialize(): Promise<void> {\n    this.setState('loading');\n\n    try {\n      // Initialize orchestrator (sets up workers and cache)\n      await this.orchestrator.initialize();\n\n      // Initialize plugins if provided\n      const plugins = (this.config as any).plugins;\n      if (plugins && Array.isArray(plugins)) {\n        for (const plugin of plugins) {\n          // Ensure plugin type matches the Plugin interface\n          if (plugin && typeof plugin === 'object' && 'name' in plugin && 'install' in plugin) {\n            this.pluginManager.register(plugin as Plugin);\n          }\n        }\n      }\n\n      this.setState('idle');\n    } catch (error) {\n      this.setState('error');\n      throw error;\n    }\n  }\n\n  /**\n   * Set the composition model\n   */\n  async setCompositionModel(model: CompositionModel | CompositionModelData): Promise<void> {\n    this.ensureNotDestroyed();\n\n    // Convert plain object to CompositionModel instance if needed\n    const compositionModel =\n      model instanceof CompositionModel ? model : new CompositionModel(model);\n\n    // Set the model in orchestrator\n    await this.orchestrator.setCompositionModel(compositionModel);\n    this.model = compositionModel;\n\n    this.setState('ready');\n    this.eventBus.emit(MeframeEvent.Ready, {\n      trackCount: model.tracks.length,\n      clipCount: model.tracks.reduce(\n        (acc: number, track: any) => acc + track.clips?.length || 0,\n        0\n      ),\n      durationUs: model.durationUs,\n    });\n    // await this.playbackController?.renderCover();\n  }\n\n  /**\n   * Apply a patch to the composition model\n   */\n  async applyPatch(patch: CompositionPatch): Promise<void> {\n    this.ensureNotDestroyed();\n\n    if (!this.model) {\n      throw new Error('No composition model set');\n    }\n\n    // Apply patch through orchestrator\n    await this.orchestrator.applyPatch(patch);\n\n    // Patch is applied to the model by orchestrator\n    this.model = this.orchestrator.compositionModel!;\n  }\n\n  /**\n   * Start preview and return a handle for control\n   */\n  startPreview(options?: {\n    canvas?: HTMLCanvasElement;\n    startUs?: TimeUs;\n    autoStart?: boolean;\n  }): PreviewHandle {\n    this.ensureReady();\n\n    // Use provided canvas or the one from config\n    const canvas = options?.canvas || this.canvas;\n    if (!canvas) {\n      throw new Error('Canvas is required for preview');\n    }\n\n    // Store canvas for later use\n    this.canvas = canvas;\n\n    // Create playback controller\n    if (!this.playbackController) {\n      this.playbackController = new PlaybackController(this.orchestrator as any, this.eventBus, {\n        canvas,\n        startUs: options?.startUs,\n        autoStart: options?.autoStart,\n      });\n    }\n\n    // Render initial frame\n    this.playbackController.renderCover();\n    this.playbackController.preheatNextWindow();\n\n    // Return preview handle\n    return this.playbackController;\n  }\n\n  /**\n   * Export the composition\n   * Uses ExportController for direct export\n   */\n  async export(options: ExportOptions): Promise<Blob> {\n    this.ensureReady();\n    this.playbackController?.pause();\n    this.setState('exporting');\n\n    try {\n      const model = this.model;\n      if (!model) {\n        throw new Error('No composition model set');\n      }\n\n      const width = options.width || (model as any).renderConfig?.width || 720;\n      const height = options.height || (model as any).renderConfig?.height || 1280;\n      const fps = options.fps || model.fps || 30;\n\n      this.eventBus.emit(MeframeEvent.ExportStart, {\n        format: options.format || 'mp4',\n        width,\n        height,\n        fps,\n        durationUs: model.durationUs,\n      });\n\n      // Delegate to ExportController\n      const blob = await this.exportController.export(model, options);\n\n      this.setState('ready');\n      this.eventBus.emit(MeframeEvent.ExportComplete, {\n        size: blob.size,\n        durationMs: model.durationUs / 1000,\n        format: options.format || 'mp4',\n      });\n      this.eventBus.emit(MeframeEvent.ExportProgress, {\n        progress: 1,\n      });\n\n      return blob;\n    } catch (error) {\n      this.setState('error');\n      this.eventBus.emit(MeframeEvent.ExportError, {\n        error: error as Error,\n        stage: 'export',\n      });\n      throw error;\n    }\n  }\n\n  /**\n   * Cancel ongoing export operation\n   */\n  cancelExport(): void {\n    this.exportController.cancel();\n  }\n\n  /**\n   * Pause ongoing export operation\n   */\n  pauseExport(): void {\n    this.exportController.pause();\n  }\n\n  /**\n   * Resume paused export operation\n   */\n  resumeExport(): void {\n    this.exportController.resume();\n  }\n\n  /**\n   * Check if export is paused\n   */\n  isExportPaused(): boolean {\n    return this.exportController.isPaused();\n  }\n\n  /**\n   * Get current playback time\n   */\n  getCurrentTime(): number {\n    return this.playbackController?.currentTimeUs || 0;\n  }\n\n  /**\n   * Clear all L1/L2 cache data\n   * Useful for debugging or forcing re-render\n   */\n  async clearCache(): Promise<void> {\n    this.ensureReady();\n\n    // Stop playback first\n    this.playbackController?.stop();\n\n    // Clear cache through CacheManager\n    await this.orchestrator.cacheManager.clear();\n\n    console.log('[Meframe] Cache cleared successfully');\n  }\n\n  /**\n   * Clean up and destroy the instance\n   */\n  async dispose(): Promise<void> {\n    if (this.state === 'destroyed') return;\n\n    // Stop playback\n    this.playbackController?.stop();\n    this.playbackController?.dispose();\n    this.playbackController = null;\n\n    // Cleanup plugins\n    await this.pluginManager.disposeAll();\n\n    // Dispose orchestrator (stops workers and clears cache)\n    await this.orchestrator.dispose();\n\n    // Clear event bus\n    this.eventBus.dispose();\n\n    this.setState('destroyed');\n  }\n\n  /**\n   * Set internal state\n   */\n  private setState(state: MeframeState): void {\n    const oldState = this.state;\n    this.state = state;\n\n    // Emit state change event\n    // Use a generic event for now, can be added to MeframeEvent enum later\n    this.eventBus.emit('state:changed' as any, {\n      oldState,\n      newState: state,\n    });\n  }\n\n  /**\n   * Ensure the instance is not destroyed\n   */\n  private ensureNotDestroyed(): void {\n    if (this.state === 'destroyed') {\n      throw new Error('Core instance is destroyed');\n    }\n  }\n\n  /**\n   * Ensure the instance is ready\n   */\n  private ensureReady(): void {\n    this.ensureNotDestroyed();\n\n    if (!this.model) {\n      throw new Error('No composition model set');\n    }\n\n    if (this.state === 'loading' || this.state === 'idle') {\n      throw new Error('Core is not ready');\n    }\n  }\n}\n"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@meframe/core",
-  "version": "0.1.2",
+  "version": "0.1.3",
   "description": "Next generation media processing framework based on WebCodecs",
   "type": "module",
   "main": "./dist/index.js",