@meframe/core 0.0.31 → 0.0.33

package/dist/Meframe.d.ts

@@ -1,5 +1,5 @@
 import { MeframeConfig, ResolvedConfig, MeframeState, ExportOptions } from './types';
-import { CompositionModelData, CompositionPatch, SetCompositionModelOptions, TimeUs } from './model/types';
+import { CompositionModelData, CompositionPatch, TimeUs } from './model/types';
 import { PreviewHandle } from './controllers/types';
 import { CompositionModel } from './model/CompositionModel';
 import { PluginManager } from './plugins/PluginManager';
@@ -34,7 +34,7 @@ export declare class Meframe {
     /**
      * Set the composition model
      */
-    setCompositionModel(model: CompositionModel | CompositionModelData, options?: SetCompositionModelOptions): Promise<void>;
+    setCompositionModel(model: CompositionModel | CompositionModelData): Promise<void>;
     /**
      * Apply a patch to the composition model
      */

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,EACV,oBAAoB,EACpB,gBAAgB,EAChB,0BAA0B,EAC1B,MAAM,EACP,MAAM,eAAe,CAAC;AACvB,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;AAEpE,qBAAa,OAAO;IAClB,wDAAwD;IACxD,KAAK,EAAE,YAAY,CAAU;IAC7B,mDAAmD;IACnD,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC;IAChC,2DAA2D;IAC3D,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,CAAsC;IAErD,OAAO;IAoBP;;OAEG;WACU,MAAM,CAAC,MAAM,GAAE,aAAkB,GAAG,OAAO,CAAC,OAAO,CAAC;IAQjE;;OAEG;YACW,UAAU;IAyBxB;;OAEG;IACG,mBAAmB,CACvB,KAAK,EAAE,gBAAgB,GAAG,oBAAoB,EAC9C,OAAO,CAAC,EAAE,0BAA0B,GACnC,OAAO,CAAC,IAAI,CAAC;IAuBhB;;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,GAAG,eAAe,CAAC;QAC7C,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,GAAG,aAAa;IA4BjB;;;OAGG;IACG,MAAM,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IA8CnD;;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;AAEpE,qBAAa,OAAO;IAClB,wDAAwD;IACxD,KAAK,EAAE,YAAY,CAAU;IAC7B,mDAAmD;IACnD,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC;IAChC,2DAA2D;IAC3D,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,CAAsC;IAErD,OAAO;IAoBP;;OAEG;WACU,MAAM,CAAC,MAAM,GAAE,aAAkB,GAAG,OAAO,CAAC,OAAO,CAAC;IAQjE;;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,GAAG,eAAe,CAAC;QAC7C,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,GAAG,aAAa;IA4BjB;;;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"}

package/dist/Meframe.js

@@ -71,10 +71,10 @@ class Meframe {
   /**
    * Set the composition model
    */
-  async setCompositionModel(model, options) {
+  async setCompositionModel(model) {
     this.ensureNotDestroyed();
     const compositionModel = model instanceof CompositionModel ? model : new CompositionModel(model);
-    await this.orchestrator.setCompositionModel(compositionModel, options);
+    await this.orchestrator.setCompositionModel(compositionModel);
     this.model = compositionModel;
     this.setState("ready");
     this.eventBus.emit(MeframeEvent.Ready, {
@@ -123,6 +123,7 @@ class Meframe {
    */
   async export(options) {
     this.ensureReady();
+    this.playbackController?.pause();
     this.setState("exporting");
     try {
       const model = this.model;

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 {\n  CompositionModelData,\n  CompositionPatch,\n  SetCompositionModelOptions,\n  TimeUs,\n} 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';\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 setCompositionTree() */\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 | OffscreenCanvas;\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    // 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(\n    model: CompositionModel | CompositionModelData,\n    options?: SetCompositionModelOptions\n  ): 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, options);\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 | OffscreenCanvas;\n    startUs?: TimeUs;\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      });\n      this.playbackController.setAudioSession(this.orchestrator.audioSession);\n    }\n\n    // Render initial frame\n    this.playbackController.renderCover();\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.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';\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 setCompositionTree() */\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 | OffscreenCanvas;\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    // 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 | OffscreenCanvas;\n    startUs?: TimeUs;\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      });\n      this.playbackController.setAudioSession(this.orchestrator.audioSession);\n    }\n\n    // Render initial frame\n    this.playbackController.renderCover();\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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"}

package/dist/cache/CacheManager.d.ts

@@ -6,7 +6,6 @@ import { EventPayloadMap } from '../event/events';
 import { ResourceCache } from './resource/ResourceCache';
 import { MP4IndexCache } from './resource/MP4IndexCache';
 import { AudioSampleCache } from './resource/AudioSampleCache';
-import { ImageBitmapCache } from './resource/ImageBitmapCache';
 import { MP4Index } from '../stages/demux/types';
 
 interface CacheManagerConfig {
@@ -27,7 +26,6 @@ interface CacheManagerConfig {
  * - ResourceCache (OPFS) for original MP4 files
  * - MP4IndexCache (RAM) for GOP/Sample indexes
  * - AudioSampleCache (RAM) for extracted audio chunks
- * - ImageBitmapCache (RAM) for decoded images
  */
 export declare class CacheManager {
     readonly videoL1Cache: VideoL1Cache;
@@ -35,36 +33,39 @@ export declare class CacheManager {
     readonly resourceCache: ResourceCache;
     readonly mp4IndexCache: MP4IndexCache;
     readonly audioSampleCache: AudioSampleCache;
-    readonly imageBitmapCache: ImageBitmapCache;
     private clipReadyWaiters;
     private eventBus?;
     constructor(config: CacheManagerConfig, eventBus?: EventBus<EventPayloadMap>);
     init(): Promise<void>;
     /**
-     * Set window center for L1 cache management
-     * L1 cache uses center ±3s window (defined in VideoL1Cache)
+     * Set window center for L1 cache management (unified for video and audio)
+     * L1 cache uses center ±3.5s window for video, ±5s for audio
      */
     setWindow(centerTimeUs: TimeUs): void;
     /**
      * Check if resource exists in OPFS cache
      */
     hasResourceInCache(resourceId: string): Promise<boolean>;
+    /**
+     * Read byte range from resource (for GOP-level access)
+     */
+    readResourceRange(resourceId: string, start: number, end: number): Promise<ArrayBuffer>;
     /**
      * Get MP4 index for a resource
      */
     getMP4Index(resourceId: string): MP4Index | null;
-    acceptMixedAudio(stream: ReadableStream<AudioData>, metadata: {
-        sampleRate: number;
-        numberOfChannels: number;
-    }): void;
-    putClipAudioData(clipId: string, audioData: AudioData, clipDurationUs: TimeUs): void;
-    getClipPCM(clipId: string, startUs: TimeUs, endUs: TimeUs): Float32Array[] | null;
+    putClipAudioData(clipId: string, audioData: AudioData, clipDurationUs: TimeUs, globalTimeUs?: TimeUs): void;
     getClipPCMWithMetadata(clipId: string, startUs: TimeUs, endUs: TimeUs): {
         planes: Float32Array[];
         sampleRate: number;
         numberOfChannels: number;
     } | null;
     hasClipPCM(clipId: string): boolean;
+    /**
+     * Check if sufficient PCM data exists for the requested time window
+     * Returns true only if at least 80% of requested duration is available
+     */
+    hasWindowPCM(clipId: string, startUs: TimeUs, endUs: TimeUs): boolean;
     resetAudioCache(): void;
     clearClipAudioData(clipId: string): void;
     /**
@@ -83,12 +84,6 @@ export declare class CacheManager {
      * @param clipId - Clip identifier
      */
     getFrame(timeUs: TimeUs, clipId: string): RcFrame | null;
-    /**
-     * Wait for frame to be available in cache
-     * @param timeUs - Clip-relative timestamp (0-based)
-     * @param clipId - Clip identifier
-     * @param options - Wait options (timeout, tolerance, etc.)
-     */
     invalidateClip(clipId: string): Promise<void>;
     /**
      * Evict a clip from L1 cache

package/dist/cache/CacheManager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"CacheManager.d.ts","sourceRoot":"","sources":["../../src/cache/CacheManager.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"CacheManager.d.ts","sourceRoot":"","sources":["../../src/cache/CacheManager.ts"],"names":[],"mappings":"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"}

package/dist/cache/CacheManager.js

@@ -6,14 +6,12 @@ import { OPFSManager } from "./storage/opfs/OPFSManager.js";
 import { ResourceCache } from "./resource/ResourceCache.js";
 import { MP4IndexCache } from "./resource/MP4IndexCache.js";
 import { AudioSampleCache } from "./resource/AudioSampleCache.js";
-import { ImageBitmapCache } from "./resource/ImageBitmapCache.js";
 class CacheManager {
   videoL1Cache;
   audioL1Cache;
   resourceCache;
   mp4IndexCache;
   audioSampleCache;
-  imageBitmapCache;
   clipReadyWaiters = /* @__PURE__ */ new Map();
   eventBus;
   constructor(config, eventBus) {
@@ -23,18 +21,18 @@ class CacheManager {
     this.resourceCache = new ResourceCache(opfsManager, config.resource.projectId);
     this.mp4IndexCache = new MP4IndexCache();
     this.audioSampleCache = new AudioSampleCache();
-    this.imageBitmapCache = new ImageBitmapCache(100);
     this.eventBus = eventBus;
   }
   async init() {
     await this.resourceCache.init();
   }
   /**
-   * Set window center for L1 cache management
-   * L1 cache uses center ±3s window (defined in VideoL1Cache)
+   * Set window center for L1 cache management (unified for video and audio)
+   * L1 cache uses center ±3.5s window for video, ±5s for audio
    */
   setWindow(centerTimeUs) {
     this.videoL1Cache.setWindow(centerTimeUs);
+    this.audioL1Cache.setWindow(centerTimeUs);
   }
   /**
    * Check if resource exists in OPFS cache
@@ -42,181 +40,20 @@ class CacheManager {
   async hasResourceInCache(resourceId) {
     return await this.resourceCache.hasResource(resourceId);
   }
+  /**
+   * Read byte range from resource (for GOP-level access)
+   */
+  async readResourceRange(resourceId, start, end) {
+    return await this.resourceCache.readRange(resourceId, start, end);
+  }
   /**
    * Get MP4 index for a resource
    */
   getMP4Index(resourceId) {
     return this.mp4IndexCache.get(resourceId);
   }
-  // async receiveComposedFrames(
-  //   stream: ReadableStream<VideoFrame>,
-  //   params: {
-  //     clipId: string;
-  //     trackId: string;
-  //     fps: number;
-  //     clipStartUs?: TimeUs;
-  //     onFrame: (info: { clipId: string; timeUs: TimeUs }) => void;
-  //   }
-  // ): Promise<void> {
-  //   const reader = stream.getReader();
-  //   const process = async (): Promise<void> => {
-  //     const { done, value } = await reader.read();
-  //     if (done) {
-  //       reader.releaseLock();
-  //       return;
-  //     }
-  //     if (value) {
-  //       const fps = params.fps > 0 ? params.fps : 30;
-  //       const frameDuration = Math.round(1_000_000 / fps);
-  //       const frame = value;
-  //       const timestamp = frame.timestamp ?? 0;
-  //       const rcFrame = this.videoL1Cache.addFrame(
-  //         frame,
-  //         params.clipId,
-  //         frameDuration,
-  //         params.trackId
-  //       );
-  //       // Calculate global time for event emission
-  //       const globalTimeUs = (params.clipStartUs ?? 0) + timestamp;
-  //       this.checkAndNotifyClipReady(params.clipId, timestamp);
-  //       // Emit cover event only for the first frame of the composition (global time = 0)
-  //       if (globalTimeUs === 0) {
-  //         this.eventBus?.emit(MeframeEvent.CacheCover, {
-  //           timeUs: globalTimeUs,
-  //           clipId: params.clipId,
-  //           level: 'L1',
-  //           size: rcFrame.sizeEstimate ?? 0,
-  //         });
-  //       }
-  //       const info = { clipId: params.clipId, timeUs: timestamp };
-  //       this.eventBus?.emit(MeframeEvent.ComposeFrameReady, {
-  //         timeUs: globalTimeUs,
-  //         frameNumber: Math.floor(globalTimeUs / frameDuration),
-  //         renderTimeMs: 0,
-  //         trackId: params.trackId,
-  //         clipId: params.clipId,
-  //       });
-  //       params.onFrame(info);
-  //     }
-  //     await process();
-  //   };
-  //   try {
-  //     await process();
-  //   } catch (error) {
-  //     this.eventBus?.emit(MeframeEvent.ComposeFrameDropped, {
-  //       timeUs: 0,
-  //       reason: 'compose_slow',
-  //     });
-  //     reader.releaseLock();
-  //     console.error('[CacheManager] receiveComposedFrames error: ', error);
-  //   }
-  // }
-  // async receiveEncodedChunks(
-  //   stream: ReadableStream<{ chunk: EncodedVideoChunk; metadata: EncodedVideoChunkMetadata }>,
-  //   clipId: string,
-  //   track: 'video' | 'audio',
-  //   options?: {
-  //     onComplete?: (metadata: EncodedVideoChunkMetadata) => void;
-  //     onError?: (error: Error) => void;
-  //   }
-  // ): Promise<void> {
-  //   const reader = stream.getReader();
-  //   const chunks: Array<EncodedVideoChunk | EncodedAudioChunk> = [];
-  //   const batchSize = track === 'video' ? 30 : 50;
-  //   let decoderConfig: any = null;
-  //   let metadata: EncodedVideoChunkMetadata | EncodedAudioChunkMetadata | undefined;
-  //   const process = async (): Promise<void> => {
-  //     const { done, value } = await reader.read();
-  //     const { chunk, metadata: chunkMetadata } = value ?? {};
-  //     if (chunkMetadata) {
-  //       metadata = chunkMetadata;
-  //       // Extract decoderConfig from first chunk's metadata
-  //       if (!decoderConfig && chunkMetadata.decoderConfig) {
-  //         decoderConfig = chunkMetadata.decoderConfig;
-  //       }
-  //     }
-  //     if (done) {
-  //       // Flush remaining chunks on stream end
-  //       if (chunks.length > 0) {
-  //         await this.l2Cache.put(clipId, chunks, track, {
-  //           isComplete: true,
-  //           metadata: decoderConfig,
-  //         });
-  //         const firstChunk = chunks[0];
-  //         if (firstChunk) {
-  //           this.eventBus?.emit(MeframeEvent.CacheWrite, {
-  //             clipId,
-  //             timeUs: firstChunk.timestamp,
-  //             level: 'L2',
-  //             size: chunks.reduce((sum, c) => sum + c.byteLength, 0),
-  //           });
-  //         }
-  //       } else {
-  //         // Mark as complete even if no chunks in final batch
-  //         await this.l2Cache.markComplete(clipId, track);
-  //       }
-  //       reader.releaseLock();
-  //       // Notify completion
-  //       if (options?.onComplete) {
-  //         options.onComplete(metadata!);
-  //       }
-  //       return;
-  //     }
-  //     if (chunk) {
-  //       chunks.push(chunk);
-  //       this.eventBus?.emit(MeframeEvent.EncodeChunkReady, {
-  //         timeUs: chunk.timestamp,
-  //         durationUs: chunk.duration ?? 0,
-  //         track,
-  //         size: chunk.byteLength,
-  //       });
-  //       // Batch write to L2 when buffer is full
-  //       if (chunks.length >= batchSize) {
-  //         const batchToWrite = chunks.splice(0);
-  //         if (batchToWrite.length > 0) {
-  //           await this.l2Cache.put(clipId, batchToWrite, track, {
-  //             metadata: decoderConfig,
-  //           });
-  //           this.eventBus?.emit(MeframeEvent.CacheWrite, {
-  //             clipId,
-  //             timeUs: chunk.timestamp,
-  //             level: 'L2',
-  //             size: batchToWrite.reduce((sum, c) => sum + c.byteLength, 0),
-  //           });
-  //         }
-  //       }
-  //     }
-  //     await process();
-  //   };
-  //   try {
-  //     await process();
-  //   } catch (error) {
-  //     // Flush any accumulated chunks before throwing
-  //     if (chunks.length > 0) {
-  //       await this.l2Cache.put(clipId, chunks, track, {
-  //         metadata: decoderConfig,
-  //       });
-  //     }
-  //     this.eventBus?.emit(MeframeEvent.EncodeChunkError, {
-  //       timeUs: 0,
-  //       track,
-  //       error: error as Error,
-  //     });
-  //     reader.releaseLock();
-  //     // Notify error
-  //     if (options?.onError) {
-  //       options.onError(error as Error);
-  //     }
-  //   }
-  // }
-  acceptMixedAudio(stream, metadata) {
-    this.audioL1Cache.attachStream(stream, metadata);
-  }
-  putClipAudioData(clipId, audioData, clipDurationUs) {
-    this.audioL1Cache.putClipAudioData(clipId, audioData, clipDurationUs);
-  }
-  getClipPCM(clipId, startUs, endUs) {
-    return this.audioL1Cache.getPCM(clipId, startUs, endUs);
+  putClipAudioData(clipId, audioData, clipDurationUs, globalTimeUs) {
+    this.audioL1Cache.putClipAudioData(clipId, audioData, clipDurationUs, globalTimeUs);
   }
   getClipPCMWithMetadata(clipId, startUs, endUs) {
     return this.audioL1Cache.getPCMWithMetadata(clipId, startUs, endUs);
@@ -224,6 +61,13 @@ class CacheManager {
   hasClipPCM(clipId) {
     return this.audioL1Cache.hasClipPCM(clipId);
   }
+  /**
+   * Check if sufficient PCM data exists for the requested time window
+   * Returns true only if at least 80% of requested duration is available
+   */
+  hasWindowPCM(clipId, startUs, endUs) {
+    return this.audioL1Cache.hasWindowData(clipId, startUs, endUs);
+  }
   resetAudioCache() {
     this.audioL1Cache.clear();
   }
@@ -268,75 +112,6 @@ class CacheManager {
   getFrame(timeUs, clipId) {
     return this.videoL1Cache.get(timeUs, clipId);
   }
-  /**
-   * Wait for frame to be available in cache
-   * @param timeUs - Clip-relative timestamp (0-based)
-   * @param clipId - Clip identifier
-   * @param options - Wait options (timeout, tolerance, etc.)
-   */
-  // waitForFrame(
-  //   timeUs: TimeUs,
-  //   clipId: string,
-  //   options: WaitForFrameOptions = {}
-  // ): Promise<WaitForFrameResult> {
-  //   const existing = this.videoL1Cache.get(timeUs, clipId);
-  //   if (existing) {
-  //     return Promise.resolve({ frame: existing, source: 'l1', timestampUs: timeUs, clipId });
-  //   }
-  //   const requestKey = this.makeRequestKey(clipId, timeUs);
-  //   const existingPromise = this.pendingFramePromises.get(requestKey);
-  //   if (existingPromise) {
-  //     return existingPromise;
-  //   }
-  //   const promise = new Promise<WaitForFrameResult>((resolve, reject) => {
-  //     const toleranceUs = Math.max(
-  //       options.toleranceUs ?? DEFAULT_WAIT_TOLERANCE_US,
-  //       DEFAULT_WAIT_TOLERANCE_US
-  //     );
-  //     const waiter: FrameWaiter = {
-  //       requestKey,
-  //       clipId,
-  //       targetTimeUs: timeUs,
-  //       resolve,
-  //       reject,
-  //       toleranceUs,
-  //     };
-  //     let waiters = this.frameWaiters.get(clipId);
-  //     if (!waiters) {
-  //       waiters = new Set();
-  //       this.frameWaiters.set(clipId, waiters);
-  //     }
-  //     waiters.add(waiter);
-  //     const signal = options.signal;
-  //     if (signal) {
-  //       const onAbort = (): void => {
-  //         this.removeWaiter(waiter);
-  //         this.cleanupWaiter(waiter);
-  //         reject(new DOMException('Render aborted', 'AbortError'));
-  //       };
-  //       if (signal.aborted) {
-  //         onAbort();
-  //         return;
-  //       }
-  //       signal.addEventListener('abort', onAbort, { once: true });
-  //       waiter.abortCleanup = () => {
-  //         signal.removeEventListener('abort', onAbort);
-  //       };
-  //     }
-  //     if (options.timeoutMs && options.timeoutMs > 0) {
-  //       waiter.timeoutId = setTimeout(() => {
-  //         this.removeWaiter(waiter);
-  //         this.cleanupWaiter(waiter);
-  //         reject(new Error('waitForFrame timeout'));
-  //       }, options.timeoutMs);
-  //     }
-  //   });
-  //   const trackedPromise = promise.finally(() => {
-  //     this.pendingFramePromises.delete(requestKey);
-  //   });
-  //   this.pendingFramePromises.set(requestKey, trackedPromise);
-  //   return trackedPromise;
-  // }
   async invalidateClip(clipId) {
     this.videoL1Cache.invalidateClip(clipId);
   }
@@ -423,43 +198,6 @@ class CacheManager {
       }
     }
   }
-  // private cleanupWaiter(waiter: FrameWaiter): void {
-  //   if (waiter.timeoutId) {
-  //     clearTimeout(waiter.timeoutId);
-  //     waiter.timeoutId = undefined;
-  //   }
-  //   if (waiter.abortCleanup) {
-  //     waiter.abortCleanup();
-  //     waiter.abortCleanup = undefined;
-  //   }
-  // }
-  // private removeWaiter(waiter: FrameWaiter): void {
-  //   const waiters = this.frameWaiters.get(waiter.clipId);
-  //   if (!waiters) return;
-  //   waiters.delete(waiter);
-  //   if (waiters.size === 0) {
-  //     this.frameWaiters.delete(waiter.clipId);
-  //   }
-  // }
-  // private matchesTimestamp(
-  //   targetTimeUs: TimeUs,
-  //   actualTimeUs: TimeUs,
-  //   frameDurationUs: TimeUs,
-  //   toleranceUs: TimeUs
-  // ): boolean {
-  //   if (targetTimeUs === actualTimeUs) return true;
-  //   const delta = Math.abs(targetTimeUs - actualTimeUs);
-  //   if (delta <= toleranceUs) {
-  //     return true;
-  //   }
-  //   if (actualTimeUs >= targetTimeUs && actualTimeUs < targetTimeUs + frameDurationUs) {
-  //     return true;
-  //   }
-  //   return false;
-  // }
-  // private makeRequestKey(clipId: string, timeUs: TimeUs): string {
-  //   return `${clipId}:${timeUs}`;
-  // }
 }
 export {
   CacheManager