@meframe/core 0.0.12 → 0.0.14

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;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,CAAiC;IACzD,OAAO,CAAC,MAAM,CAAC,CAAsC;IAErD,OAAO;IAiBP;;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;IAsBxF;;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;IAkDjB;;;OAGG;IACG,MAAM,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IA6FnD;;;OAGG;IACG,kBAAkB,IAAI,OAAO,CAAC;QAClC,KAAK,EAAE,OAAO,CAAC;QACf,UAAU,EAAE,MAAM,CAAC;QACnB,WAAW,EAAE,MAAM,CAAC;QACpB,YAAY,EAAE,MAAM,EAAE,CAAC;QACvB,QAAQ,EAAE,MAAM,CAAC;KAClB,CAAC;IAmCF;;OAEG;IACH,cAAc,IAAI,MAAM;IAIxB;;;OAGG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAejC;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAwB9B;;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,CAAiC;IACzD,OAAO,CAAC,MAAM,CAAC,CAAsC;IAErD,OAAO;IAiBP;;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;IAqBxF;;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;IAoDjB;;;OAGG;IACG,MAAM,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IA6FnD;;;OAGG;IACG,kBAAkB,IAAI,OAAO,CAAC;QAClC,KAAK,EAAE,OAAO,CAAC;QACf,UAAU,EAAE,MAAM,CAAC;QACnB,WAAW,EAAE,MAAM,CAAC;QACpB,YAAY,EAAE,MAAM,EAAE,CAAC;QACvB,QAAQ,EAAE,MAAM,CAAC;KAClB,CAAC;IAoCF;;OAEG;IACH,cAAc,IAAI,MAAM;IAIxB;;;OAGG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAejC;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAwB9B;;OAEG;IACH,OAAO,CAAC,QAAQ;IAYhB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAM1B;;OAEG;IACH,OAAO,CAAC,WAAW;CAWpB"}

package/dist/Meframe.js

@@ -82,7 +82,6 @@ class Meframe {
       ),
       durationUs: model.durationUs
     });
-    this.playbackController?.seek(0);
   }
   /**
    * Apply a patch to the composition model
@@ -128,6 +127,7 @@ class Meframe {
     this.playbackController.on(MeframeEvent.PlaybackStop, () => {
       this.preRenderService?.setPlaybackActive(false);
     });
+    this.playbackController?.renderCurrentFrame(0);
     return this.playbackController;
   }
   /**
@@ -222,8 +222,8 @@ class Meframe {
         coverage: 0
       };
     }
-    const videoTracks = this.model.tracks.filter((t) => t.kind === "video");
-    const allClips = videoTracks.flatMap((t) => t.clips);
+    const mainTrack = this.model.findTrack(this.model.mainTrackId);
+    const allClips = mainTrack?.clips ?? [];
     const missingClips = [];
     let cachedCount = 0;
     for (const clip of allClips) {

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 { PreRenderService } from './controllers/PreRenderService';\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 preRenderService: PreRenderService | null = null;\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      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\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    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    this.playbackController?.seek(0);\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    // Start pre-render service for background caching\n    if (!this.preRenderService) {\n      this.preRenderService = new PreRenderService(this.orchestrator as any, this.events);\n      this.preRenderService.start();\n    }\n\n    // Connect playback controller to pre-render service\n    // Update pre-render position when playback position changes\n    this.playbackController.on(MeframeEvent.PlaybackTimeUpdate, (payload: any) => {\n      this.preRenderService?.updatePlaybackTime(payload.timeUs);\n    });\n\n    // Update playback active state\n    this.playbackController.on(MeframeEvent.PlaybackPlay, () => {\n      this.preRenderService?.setPlaybackActive(true);\n    });\n\n    this.playbackController.on(MeframeEvent.PlaybackPause, () => {\n      this.preRenderService?.setPlaybackActive(false);\n    });\n\n    this.playbackController.on(MeframeEvent.PlaybackStop, () => {\n      this.preRenderService?.setPlaybackActive(false);\n    });\n\n    // Return preview handle\n    return this.playbackController;\n  }\n\n  /**\n   * Export the composition\n   * Uses L2 cache for fast export, muxes in main thread\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      // 1. Check L2 cache readiness\n      const readiness = await this.getExportReadiness();\n\n      if (!readiness.ready) {\n        // Emit preparing event\n        this.eventBus.emit(MeframeEvent.ExportPreparing, {\n          totalClips: readiness.totalClips,\n          cachedClips: readiness.cachedClips,\n          missingClips: readiness.missingClips,\n        });\n\n        // Ensure PreRenderService is started\n        if (!this.preRenderService) {\n          this.preRenderService = new PreRenderService(this.orchestrator as any, this.events);\n          this.preRenderService.start();\n        }\n\n        // Create AbortController for timeout control\n        const abortController = new AbortController();\n        const timeoutMs = 5 * 60 * 1000; // 5 minutes\n        const timeoutId = setTimeout(() => {\n          abortController.abort();\n        }, timeoutMs);\n\n        try {\n          // Actively trigger missing clips L2 rendering\n          await this.preRenderService.ensureClipsInL2(readiness.missingClips, {\n            onProgress: (completed, total) => {\n              this.eventBus.emit(MeframeEvent.ExportProgress, {\n                progress: completed / total,\n                stage: 'preparing',\n                message: `Preparing cache: ${completed}/${total} clips`,\n              });\n            },\n            signal: abortController.signal,\n          });\n        } catch (error) {\n          if (error instanceof DOMException && error.name === 'AbortError') {\n            throw new Error(`Export preparation timeout after ${timeoutMs / 1000}s`);\n          }\n          throw error;\n        } finally {\n          clearTimeout(timeoutId);\n        }\n      }\n\n      // 2. Continue normal export flow\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 orchestrator\n      const blob = await this.orchestrator.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   * Check export readiness\n   * Returns coverage info for L2 cache\n   */\n  async getExportReadiness(): Promise<{\n    ready: boolean;\n    totalClips: number;\n    cachedClips: number;\n    missingClips: string[];\n    coverage: number;\n  }> {\n    if (!this.model) {\n      return {\n        ready: false,\n        totalClips: 0,\n        cachedClips: 0,\n        missingClips: [],\n        coverage: 0,\n      };\n    }\n\n    const videoTracks = this.model.tracks.filter((t) => t.kind === 'video');\n    const allClips = videoTracks.flatMap((t) => t.clips);\n\n    const missingClips: string[] = [];\n    let cachedCount = 0;\n\n    for (const clip of allClips) {\n      const inL2 = await this.orchestrator.cacheManager.hasClipInL2(clip.id, 'video');\n      if (inL2) {\n        cachedCount++;\n      } else {\n        missingClips.push(clip.id);\n      }\n    }\n\n    return {\n      ready: missingClips.length === 0,\n      totalClips: allClips.length,\n      cachedClips: cachedCount,\n      missingClips,\n      coverage: allClips.length > 0 ? cachedCount / allClips.length : 0,\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    // Stop pre-render service\n    this.preRenderService?.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    // Stop pre-render service\n    this.preRenderService?.stop();\n    this.preRenderService = 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 { PreRenderService } from './controllers/PreRenderService';\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 preRenderService: PreRenderService | null = null;\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      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\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    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  }\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    // Start pre-render service for background caching\n    if (!this.preRenderService) {\n      this.preRenderService = new PreRenderService(this.orchestrator as any, this.events);\n      this.preRenderService.start();\n    }\n\n    // Connect playback controller to pre-render service\n    // Update pre-render position when playback position changes\n    this.playbackController.on(MeframeEvent.PlaybackTimeUpdate, (payload: any) => {\n      this.preRenderService?.updatePlaybackTime(payload.timeUs);\n    });\n\n    // Update playback active state\n    this.playbackController.on(MeframeEvent.PlaybackPlay, () => {\n      this.preRenderService?.setPlaybackActive(true);\n    });\n\n    this.playbackController.on(MeframeEvent.PlaybackPause, () => {\n      this.preRenderService?.setPlaybackActive(false);\n    });\n\n    this.playbackController.on(MeframeEvent.PlaybackStop, () => {\n      this.preRenderService?.setPlaybackActive(false);\n    });\n\n    this.playbackController?.renderCurrentFrame(0);\n\n    // Return preview handle\n    return this.playbackController;\n  }\n\n  /**\n   * Export the composition\n   * Uses L2 cache for fast export, muxes in main thread\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      // 1. Check L2 cache readiness\n      const readiness = await this.getExportReadiness();\n\n      if (!readiness.ready) {\n        // Emit preparing event\n        this.eventBus.emit(MeframeEvent.ExportPreparing, {\n          totalClips: readiness.totalClips,\n          cachedClips: readiness.cachedClips,\n          missingClips: readiness.missingClips,\n        });\n\n        // Ensure PreRenderService is started\n        if (!this.preRenderService) {\n          this.preRenderService = new PreRenderService(this.orchestrator as any, this.events);\n          this.preRenderService.start();\n        }\n\n        // Create AbortController for timeout control\n        const abortController = new AbortController();\n        const timeoutMs = 5 * 60 * 1000; // 5 minutes\n        const timeoutId = setTimeout(() => {\n          abortController.abort();\n        }, timeoutMs);\n\n        try {\n          // Actively trigger missing clips L2 rendering\n          await this.preRenderService.ensureClipsInL2(readiness.missingClips, {\n            onProgress: (completed, total) => {\n              this.eventBus.emit(MeframeEvent.ExportProgress, {\n                progress: completed / total,\n                stage: 'preparing',\n                message: `Preparing cache: ${completed}/${total} clips`,\n              });\n            },\n            signal: abortController.signal,\n          });\n        } catch (error) {\n          if (error instanceof DOMException && error.name === 'AbortError') {\n            throw new Error(`Export preparation timeout after ${timeoutMs / 1000}s`);\n          }\n          throw error;\n        } finally {\n          clearTimeout(timeoutId);\n        }\n      }\n\n      // 2. Continue normal export flow\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 orchestrator\n      const blob = await this.orchestrator.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   * Check export readiness\n   * Returns coverage info for L2 cache\n   */\n  async getExportReadiness(): Promise<{\n    ready: boolean;\n    totalClips: number;\n    cachedClips: number;\n    missingClips: string[];\n    coverage: number;\n  }> {\n    if (!this.model) {\n      return {\n        ready: false,\n        totalClips: 0,\n        cachedClips: 0,\n        missingClips: [],\n        coverage: 0,\n      };\n    }\n\n    // Only check main track clips (attachments are already included)\n    const mainTrack = this.model.findTrack(this.model.mainTrackId);\n    const allClips = mainTrack?.clips ?? [];\n\n    const missingClips: string[] = [];\n    let cachedCount = 0;\n\n    for (const clip of allClips) {\n      const inL2 = await this.orchestrator.cacheManager.hasClipInL2(clip.id, 'video');\n      if (inL2) {\n        cachedCount++;\n      } else {\n        missingClips.push(clip.id);\n      }\n    }\n\n    return {\n      ready: missingClips.length === 0,\n      totalClips: allClips.length,\n      cachedClips: cachedCount,\n      missingClips,\n      coverage: allClips.length > 0 ? cachedCount / allClips.length : 0,\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    // Stop pre-render service\n    this.preRenderService?.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    // Stop pre-render service\n    this.preRenderService?.stop();\n    this.preRenderService = 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

@@ -15,17 +15,6 @@ interface CacheManagerConfig {
         projectId: string;
     };
 }
-interface WaitForFrameOptions {
-    signal?: AbortSignal;
-    timeoutMs?: number;
-    toleranceUs?: number;
-}
-export interface WaitForFrameResult {
-    frame: RcFrame | null;
-    source: 'l1' | 'wait';
-    timestampUs: TimeUs;
-    clipId: string;
-}
 /**
  * Simplified CacheManager for 2-Clip strategy
  *
@@ -38,8 +27,6 @@ export declare class CacheManager {
     private readonly videoL1Cache;
     private readonly audioL1Cache;
     readonly l2Cache: L2Cache;
-    private pendingFramePromises;
-    private frameWaiters;
     private clipReadyWaiters;
     private eventBus?;
     constructor(config: CacheManagerConfig, eventBus?: EventBus<EventPayloadMap>);
@@ -78,18 +65,17 @@ export declare class CacheManager {
     hasClipPCM(clipId: string): boolean;
     resetAudioCache(): void;
     /**
-     * Get frame from cache (L1 or L2 decode)
+     * Get frame from L1 cache
      * @param timeUs - Clip-relative timestamp (0-based)
      * @param clipId - Clip identifier
      */
-    getFrame(timeUs: TimeUs, clipId: string): Promise<RcFrame | null>;
+    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.)
      */
-    waitForFrame(timeUs: TimeUs, clipId: string, options?: WaitForFrameOptions): Promise<WaitForFrameResult>;
     invalidateClip(clipId: string): Promise<void>;
     /**
      * Evict a clip from L1 cache
@@ -98,14 +84,16 @@ export declare class CacheManager {
     /**
      * Check if a clip is cached in L1
      */
-    isClipCached(clipId: string): boolean;
+    hasClipInL1(clipId: string): boolean;
     /**
      * Wait for a clip to have minimum frames cached
      * Used by PlaybackController for buffering state
+     * Only one waiter per clip - new waiter replaces old one
      */
     waitForClipReady(clipId: string, options?: {
         minFrameCount?: number;
         timeoutMs?: number;
+        startTimeUs?: TimeUs;
     }): Promise<boolean>;
     clear(): Promise<void>;
     getMetadata(): {
@@ -134,13 +122,11 @@ export declare class CacheManager {
      * Get chunk metadata (decoderConfig) from L2 cache
      */
     getL2Metadata(clipId: string, track: 'video' | 'audio'): Promise<any | null>;
-    private decodeFromL2;
-    private notifyFrameWaiters;
-    private notifyClipReadyWaiters;
-    private cleanupWaiter;
-    private removeWaiter;
-    private matchesTimestamp;
-    private makeRequestKey;
+    /**
+     * Check if incoming frame satisfies clip ready condition
+     * O(1) complexity - only checks single waiter and increments counter
+     */
+    private checkAndNotifyClipReady;
 }
 export {};
 //# sourceMappingURL=CacheManager.d.ts.map

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

@@ -2,13 +2,11 @@ import { VideoL1Cache } from "./l1/VideoL1Cache.js";
 import { L2Cache } from "./L2Cache.js";
 import { MeframeEvent } from "../event/events.js";
 import { AudioL1Cache } from "./l1/AudioL1Cache.js";
-const DEFAULT_WAIT_TOLERANCE_US = 33333;
+import { WaiterReplacedError } from "../utils/errors.js";
 class CacheManager {
   videoL1Cache;
   audioL1Cache;
   l2Cache;
-  pendingFramePromises = /* @__PURE__ */ new Map();
-  frameWaiters = /* @__PURE__ */ new Map();
   clipReadyWaiters = /* @__PURE__ */ new Map();
   eventBus;
   constructor(config, eventBus) {
@@ -48,8 +46,8 @@ class CacheManager {
           await process();
           return;
         }
-        this.notifyFrameWaiters(params.clipId, timestamp, frameDuration, rcFrame);
         const globalTimeUs = (params.clipStartUs ?? 0) + timestamp;
+        this.checkAndNotifyClipReady(params.clipId, timestamp);
         if (globalTimeUs === 0) {
           this.eventBus?.emit(MeframeEvent.CacheCover, {
             timeUs: globalTimeUs,
@@ -184,30 +182,12 @@ class CacheManager {
     this.audioL1Cache.reset();
   }
   /**
-   * Get frame from cache (L1 or L2 decode)
+   * Get frame from L1 cache
    * @param timeUs - Clip-relative timestamp (0-based)
    * @param clipId - Clip identifier
    */
-  async getFrame(timeUs, clipId) {
-    const rcFrame = this.videoL1Cache.get(timeUs, clipId);
-    if (rcFrame) {
-      return rcFrame;
-    }
-    const decodeKey = this.makeRequestKey(clipId, timeUs);
-    const pending = this.pendingFramePromises.get(decodeKey);
-    if (pending) {
-      const result = await pending;
-      return result.frame;
-    }
-    const decodePromise = this.decodeFromL2(timeUs, clipId);
-    const tracked = decodePromise.finally(() => {
-      this.pendingFramePromises.delete(decodeKey);
-    });
-    this.pendingFramePromises.set(
-      decodeKey,
-      tracked.then((frame) => ({ frame, source: "wait", timestampUs: timeUs, clipId }))
-    );
-    return tracked;
+  getFrame(timeUs, clipId) {
+    return this.videoL1Cache.get(timeUs, clipId);
   }
   /**
    * Wait for frame to be available in cache
@@ -215,65 +195,69 @@ class CacheManager {
    * @param clipId - Clip identifier
    * @param options - Wait options (timeout, tolerance, etc.)
    */
-  waitForFrame(timeUs, clipId, options = {}) {
-    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((resolve, reject) => {
-      const toleranceUs = Math.max(
-        options.toleranceUs ?? DEFAULT_WAIT_TOLERANCE_US,
-        DEFAULT_WAIT_TOLERANCE_US
-      );
-      const waiter = {
-        requestKey,
-        clipId,
-        targetTimeUs: timeUs,
-        resolve,
-        reject,
-        toleranceUs
-      };
-      let waiters = this.frameWaiters.get(clipId);
-      if (!waiters) {
-        waiters = /* @__PURE__ */ new Set();
-        this.frameWaiters.set(clipId, waiters);
-      }
-      waiters.add(waiter);
-      const signal = options.signal;
-      if (signal) {
-        const onAbort = () => {
-          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;
-  }
+  // 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) {
     console.log(`[CacheManager] invalidateClip(${clipId}) - clearing L1 and L2`);
     this.videoL1Cache.invalidateRange(0, Infinity, clipId);
@@ -288,39 +272,42 @@ class CacheManager {
   /**
    * Check if a clip is cached in L1
    */
-  isClipCached(clipId) {
-    return this.videoL1Cache.isClipCached(clipId);
+  hasClipInL1(clipId) {
+    return this.videoL1Cache.hasClip(clipId);
   }
   /**
    * Wait for a clip to have minimum frames cached
    * Used by PlaybackController for buffering state
+   * Only one waiter per clip - new waiter replaces old one
    */
   waitForClipReady(clipId, options = {}) {
     const minFrameCount = options.minFrameCount ?? 30;
-    const currentFrameCount = this.videoL1Cache.getClipFrameCount(clipId);
+    const startTimeUs = options.startTimeUs ?? 0;
+    const currentFrameCount = this.videoL1Cache.getClipFrameCount(clipId, startTimeUs);
     if (currentFrameCount >= minFrameCount) {
       return Promise.resolve(true);
     }
+    const oldWaiter = this.clipReadyWaiters.get(clipId);
+    if (oldWaiter) {
+      if (oldWaiter.timeoutId) {
+        clearTimeout(oldWaiter.timeoutId);
+      }
+      oldWaiter.reject(new WaiterReplacedError(clipId));
+    }
     return new Promise((resolve, reject) => {
       const waiter = {
         clipId,
         minFrameCount,
+        startTimeUs,
+        currentCount: currentFrameCount,
         resolve,
         reject
       };
-      const waiters = this.clipReadyWaiters.get(clipId) || [];
-      waiters.push(waiter);
-      this.clipReadyWaiters.set(clipId, waiters);
+      this.clipReadyWaiters.set(clipId, waiter);
       if (options.timeoutMs && options.timeoutMs > 0) {
         waiter.timeoutId = setTimeout(() => {
-          const waiters2 = this.clipReadyWaiters.get(clipId);
-          if (waiters2) {
-            const remaining = waiters2.filter((w) => w !== waiter);
-            if (remaining.length === 0) {
-              this.clipReadyWaiters.delete(clipId);
-            } else {
-              this.clipReadyWaiters.set(clipId, remaining);
-            }
+          if (this.clipReadyWaiters.get(clipId) === waiter) {
+            this.clipReadyWaiters.delete(clipId);
           }
           resolve(false);
         }, options.timeoutMs);
@@ -363,99 +350,64 @@ class CacheManager {
   async getL2Metadata(clipId, track) {
     return this.l2Cache.getClipMetadata(clipId, track);
   }
-  async decodeFromL2(timeUs, clipId) {
-    const encodedChunk = await this.l2Cache.get(timeUs, clipId);
-    if (!encodedChunk) {
-      return null;
-    }
-    return null;
-  }
-  notifyFrameWaiters(clipId, timestampUs, frameDurationUs, frame) {
-    const waiters = this.frameWaiters.get(clipId);
-    if (!waiters || waiters.size === 0) {
-      return;
-    }
-    const resolved = [];
-    for (const waiter of waiters) {
-      const matches = this.matchesTimestamp(
-        waiter.targetTimeUs,
-        timestampUs,
-        frameDurationUs,
-        waiter.toleranceUs
-      );
-      if (!matches) continue;
-      resolved.push(waiter);
-      this.cleanupWaiter(waiter);
-      waiter.resolve({
-        frame,
-        source: "wait",
-        timestampUs,
-        clipId
-      });
-    }
-    for (const waiter of resolved) {
-      waiters.delete(waiter);
-    }
-    if (waiters.size === 0) {
-      this.frameWaiters.delete(clipId);
-    }
-    this.notifyClipReadyWaiters(clipId);
-  }
-  notifyClipReadyWaiters(clipId) {
-    const waiters = this.clipReadyWaiters.get(clipId);
-    if (!waiters || waiters.length === 0) {
+  /**
+   * Check if incoming frame satisfies clip ready condition
+   * O(1) complexity - only checks single waiter and increments counter
+   */
+  checkAndNotifyClipReady(clipId, frameTimestampUs) {
+    const waiter = this.clipReadyWaiters.get(clipId);
+    if (!waiter) {
       return;
     }
-    const frameCount = this.videoL1Cache.getClipFrameCount(clipId);
-    const resolved = [];
-    for (const waiter of waiters) {
-      if (frameCount >= waiter.minFrameCount) {
-        resolved.push(waiter);
+    const shouldCount = waiter.startTimeUs === 0 || frameTimestampUs >= waiter.startTimeUs;
+    if (shouldCount) {
+      waiter.currentCount++;
+      if (waiter.currentCount >= waiter.minFrameCount) {
         if (waiter.timeoutId) {
           clearTimeout(waiter.timeoutId);
         }
         waiter.resolve(true);
+        this.clipReadyWaiters.delete(clipId);
       }
     }
-    const remaining = waiters.filter((w) => !resolved.includes(w));
-    if (remaining.length === 0) {
-      this.clipReadyWaiters.delete(clipId);
-    } else {
-      this.clipReadyWaiters.set(clipId, remaining);
-    }
-  }
-  cleanupWaiter(waiter) {
-    if (waiter.timeoutId) {
-      clearTimeout(waiter.timeoutId);
-      waiter.timeoutId = void 0;
-    }
-    if (waiter.abortCleanup) {
-      waiter.abortCleanup();
-      waiter.abortCleanup = void 0;
-    }
-  }
-  removeWaiter(waiter) {
-    const waiters = this.frameWaiters.get(waiter.clipId);
-    if (!waiters) return;
-    waiters.delete(waiter);
-    if (waiters.size === 0) {
-      this.frameWaiters.delete(waiter.clipId);
-    }
-  }
-  matchesTimestamp(targetTimeUs, actualTimeUs, frameDurationUs, toleranceUs) {
-    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;
-  }
-  makeRequestKey(clipId, timeUs) {
-    return `${clipId}:${timeUs}`;
   }
+  // 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