@meframe/core 0.0.48 → 0.1.0

package/dist/controllers/PlaybackController.d.ts

@@ -28,6 +28,8 @@ export declare class PlaybackController implements IPlaybackController, PreviewH
     private readonly WINDOW_DURATION;
     private readonly PREHEAT_DISTANCE;
     private preheatInProgress;
+    private lastAudioScheduleTime;
+    private readonly AUDIO_SCHEDULE_INTERVAL;
     constructor(orchestrator: Orchestrator, eventBus: IEventBus, options: PlaybackOptions);
     renderCover(): Promise<void>;
     play(): void;

package/dist/controllers/PlaybackController.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"PlaybackController.d.ts","sourceRoot":"","sources":["../../src/controllers/PlaybackController.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,mBAAmB,EAEnB,eAAe,EACf,SAAS,EACT,aAAa,EACb,MAAM,EACP,MAAM,SAAS,CAAC;AAGjB,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAKpD;;;GAGG;AACH,qBAAa,kBAAmB,YAAW,mBAAmB,EAAE,aAAa;IAC3E,OAAO,CAAC,YAAY,CAAe;IACnC,OAAO,CAAC,QAAQ,CAAY;IAC5B,OAAO,CAAC,MAAM,CAAsC;IACpD,OAAO,CAAC,aAAa,CAA8B;IAGnD,aAAa,EAAE,MAAM,CAAK;IAC1B,OAAO,CAAC,KAAK,CAAyB;IACtC,OAAO,CAAC,YAAY,CAAO;IAC3B,OAAO,CAAC,MAAM,CAAO;IACrB,OAAO,CAAC,IAAI,CAAS;IAGrB,OAAO,CAAC,KAAK,CAAuB;IACpC,OAAO,CAAC,WAAW,CAAa;IAGhC,OAAO,CAAC,UAAU,CAAK;IACvB,OAAO,CAAC,aAAa,CAAK;IAC1B,OAAO,CAAC,GAAG,CAAK;IAChB,OAAO,CAAC,YAAY,CAAe;IACnC,OAAO,CAAC,YAAY,CAAqB;IAGzC,OAAO,CAAC,aAAa,CAAK;IAC1B,OAAO,CAAC,oBAAoB,CAAS;IAGrC,OAAO,CAAC,SAAS,CAAa;IAC9B,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAa;IAC7C,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAa;IAC9C,OAAO,CAAC,iBAAiB,CAAS;gBAEtB,YAAY,EAAE,YAAY,EAAE,QAAQ,EAAE,SAAS,EAAE,OAAO,EAAE,eAAe;IA4C/E,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC;IAKlC,IAAI,IAAI,IAAI;YAYE,aAAa;IAgC3B,KAAK,IAAI,IAAI;IAiBb,IAAI,IAAI,IAAI;IAuBN,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAyFzC,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAW3B,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAO/B,OAAO,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI;IAQ7B,OAAO,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI;IAI5B,IAAI,QAAQ,IAAI,MAAM,CAOrB;IAED,IAAI,SAAS,IAAI,OAAO,CAEvB;IAGD,MAAM,IAAI,IAAI;IAId,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,OAAO,EAAE,GAAG,KAAK,IAAI,GAAG,IAAI;IAIxD,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,OAAO,EAAE,GAAG,KAAK,IAAI,GAAG,IAAI;IAKzD,OAAO,CAAC,YAAY;IAiEpB,OAAO,CAAC,UAAU;IAiClB;;;OAGG;IACH,OAAO,CAAC,UAAU;IAQlB;;;;;;;OAOG;IACH,OAAO,CAAC,qBAAqB;IAmB7B;;;;OAIG;IACG,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC;IA0ClC,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;YAiCzC,uBAAuB;IAuDrC,OAAO,CAAC,SAAS;IAKjB,OAAO,IAAI,IAAI;IAUf,OAAO,CAAC,YAAY,CASlB;IAEF,OAAO,CAAC,UAAU,CAiBhB;IAEF,OAAO,CAAC,mBAAmB;CAI5B"}
+{"version":3,"file":"PlaybackController.d.ts","sourceRoot":"","sources":["../../src/controllers/PlaybackController.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,mBAAmB,EAEnB,eAAe,EACf,SAAS,EACT,aAAa,EACb,MAAM,EACP,MAAM,SAAS,CAAC;AAGjB,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAKpD;;;GAGG;AACH,qBAAa,kBAAmB,YAAW,mBAAmB,EAAE,aAAa;IAC3E,OAAO,CAAC,YAAY,CAAe;IACnC,OAAO,CAAC,QAAQ,CAAY;IAC5B,OAAO,CAAC,MAAM,CAAsC;IACpD,OAAO,CAAC,aAAa,CAA8B;IAGnD,aAAa,EAAE,MAAM,CAAK;IAC1B,OAAO,CAAC,KAAK,CAAyB;IACtC,OAAO,CAAC,YAAY,CAAO;IAC3B,OAAO,CAAC,MAAM,CAAO;IACrB,OAAO,CAAC,IAAI,CAAS;IAGrB,OAAO,CAAC,KAAK,CAAuB;IACpC,OAAO,CAAC,WAAW,CAAa;IAGhC,OAAO,CAAC,UAAU,CAAK;IACvB,OAAO,CAAC,aAAa,CAAK;IAC1B,OAAO,CAAC,GAAG,CAAK;IAChB,OAAO,CAAC,YAAY,CAAe;IACnC,OAAO,CAAC,YAAY,CAAqB;IAGzC,OAAO,CAAC,aAAa,CAAK;IAC1B,OAAO,CAAC,oBAAoB,CAAS;IAGrC,OAAO,CAAC,SAAS,CAAa;IAC9B,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAa;IAC7C,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAa;IAC9C,OAAO,CAAC,iBAAiB,CAAS;IAGlC,OAAO,CAAC,qBAAqB,CAAK;IAClC,OAAO,CAAC,QAAQ,CAAC,uBAAuB,CAAW;gBAEvC,YAAY,EAAE,YAAY,EAAE,QAAQ,EAAE,SAAS,EAAE,OAAO,EAAE,eAAe;IA4C/E,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC;IAKlC,IAAI,IAAI,IAAI;YAYE,aAAa;IAgC3B,KAAK,IAAI,IAAI;IAiBb,IAAI,IAAI,IAAI;IAwBN,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA2FzC,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAW3B,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAO/B,OAAO,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI;IAQ7B,OAAO,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI;IAI5B,IAAI,QAAQ,IAAI,MAAM,CAOrB;IAED,IAAI,SAAS,IAAI,OAAO,CAEvB;IAGD,MAAM,IAAI,IAAI;IAId,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,OAAO,EAAE,GAAG,KAAK,IAAI,GAAG,IAAI;IAIxD,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,OAAO,EAAE,GAAG,KAAK,IAAI,GAAG,IAAI;IAKzD,OAAO,CAAC,YAAY;IAuEpB,OAAO,CAAC,UAAU;IAkClB;;;OAGG;IACH,OAAO,CAAC,UAAU;IAQlB;;;;;;;OAOG;IACH,OAAO,CAAC,qBAAqB;IAmB7B;;;;OAIG;IACG,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC;IA0ClC,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;YAiCzC,uBAAuB;IA0DrC,OAAO,CAAC,SAAS;IAKjB,OAAO,IAAI,IAAI;IAUf,OAAO,CAAC,YAAY,CASlB;IAEF,OAAO,CAAC,UAAU,CAiBhB;IAEF,OAAO,CAAC,mBAAmB;CAI5B"}

package/dist/controllers/PlaybackController.js

@@ -33,6 +33,10 @@ class PlaybackController {
   PREHEAT_DISTANCE = 1e6;
   // 1s preheat trigger distance
   preheatInProgress = false;
+  // Audio scheduling throttle to reduce CPU overhead
+  lastAudioScheduleTime = 0;
+  AUDIO_SCHEDULE_INTERVAL = 1e5;
+  // 100ms (~3 frames at 30fps)
   constructor(orchestrator, eventBus, options) {
     this.orchestrator = orchestrator;
     this.audioSession = orchestrator.audioSession;
@@ -69,9 +73,7 @@ class PlaybackController {
   // Playback control
   play() {
     if (this.state === "playing") return;
-    if (this.state === "ended") {
-      this.audioSession.resetPlaybackStates();
-    }
+    this.lastAudioScheduleTime = 0;
     this.wasPlayingBeforeSeek = true;
     this.startPlayback();
   }
@@ -113,6 +115,7 @@ class PlaybackController {
     this.wasPlayingBeforeSeek = false;
     this.frameCount = 0;
     this.lastFrameTime = 0;
+    this.lastAudioScheduleTime = 0;
     const ctx = this.canvas.getContext("2d");
     if (ctx && "clearRect" in ctx) {
       ctx.clearRect(0, 0, this.canvas.width, this.canvas.height);
@@ -129,7 +132,7 @@ class PlaybackController {
       this.rafId = null;
     }
     this.audioSession.stopPlayback();
-    this.audioSession.resetPlaybackStates();
+    this.lastAudioScheduleTime = 0;
     const clamped = this.clampTime(timeUs);
     this.currentTimeUs = clamped;
     this.currentSeekId++;
@@ -241,8 +244,11 @@ class PlaybackController {
       if (this.state !== "playing") {
         return;
       }
-      await this.audioSession.ensureAudioForTime(this.currentTimeUs, { immediate: true });
-      await this.audioSession.scheduleAudio(this.currentTimeUs, this.audioContext);
+      if (this.currentTimeUs - this.lastAudioScheduleTime >= this.AUDIO_SCHEDULE_INTERVAL) {
+        await this.audioSession.ensureAudioForTime(this.currentTimeUs, { immediate: true });
+        await this.audioSession.scheduleAudio(this.currentTimeUs, this.audioContext);
+        this.lastAudioScheduleTime = this.currentTimeUs;
+      }
       await this.renderCurrentFrame(this.currentTimeUs);
       if (this.state !== "playing") {
         return;
@@ -267,6 +273,7 @@ class PlaybackController {
         this.currentTimeUs = 0;
         this.startTimeUs = this.audioContext.currentTime * 1e6;
         this.audioSession.resetPlaybackStates();
+        this.lastAudioScheduleTime = 0;
         this.initWindow(0);
       } else {
         this.pause();
@@ -380,6 +387,7 @@ class PlaybackController {
       }
       this.state = "playing";
       this.startTimeUs = this.audioContext.currentTime * 1e6 - timeUs / this.playbackRate;
+      this.lastAudioScheduleTime = 0;
       await this.audioSession.startPlayback(timeUs, this.audioContext);
       this.eventBus.emit(MeframeEvent.PlaybackPlay);
       if (!this.rafId) {

package/dist/controllers/PlaybackController.js.map

@@ -1 +1 @@
-{"version":3,"file":"PlaybackController.js","sources":["../../src/controllers/PlaybackController.ts"],"sourcesContent":["import type {\n  IPlaybackController,\n  PlaybackState,\n  PlaybackOptions,\n  IEventBus,\n  PreviewHandle,\n  TimeUs,\n} from './types';\nimport { MeframeEvent } from '../event/events';\nimport type { GlobalAudioSession } from '../orchestrator/GlobalAudioSession';\nimport type { Orchestrator } from '../orchestrator';\nimport { WaiterReplacedError } from '../utils/errors';\nimport { VideoComposer } from '../stages/compose/VideoComposer';\nimport { isVideoClip } from '../model/types';\n\n/**\n * Playback controller for preview\n * Internal implementation - not exposed directly to external consumers\n */\nexport class PlaybackController implements IPlaybackController, PreviewHandle {\n  private orchestrator: Orchestrator;\n  private eventBus: IEventBus;\n  private canvas: HTMLCanvasElement | OffscreenCanvas;\n  private videoComposer: VideoComposer | null = null;\n\n  // Playback state\n  currentTimeUs: TimeUs = 0;\n  private state: PlaybackState = 'idle';\n  private playbackRate = 1.0;\n  private volume = 1.0;\n  private loop = false;\n\n  // Animation loop\n  private rafId: number | null = null;\n  private startTimeUs: TimeUs = 0; // Playback start position in AudioContext timeline (microseconds)\n\n  // Frame tracking\n  private frameCount = 0;\n  private lastFrameTime = 0;\n  private fps = 0;\n  private audioContext: AudioContext;\n  private audioSession: GlobalAudioSession;\n\n  // Seek tracking\n  private currentSeekId = 0;\n  private wasPlayingBeforeSeek = false;\n\n  // Unified window management for both video and audio\n  private windowEnd: TimeUs = 0;\n  private readonly WINDOW_DURATION = 3_000_000; // 3s decode window\n  private readonly PREHEAT_DISTANCE = 1_000_000; // 1s preheat trigger distance\n  private preheatInProgress = false;\n\n  constructor(orchestrator: Orchestrator, eventBus: IEventBus, options: PlaybackOptions) {\n    this.orchestrator = orchestrator;\n    this.audioSession = orchestrator.audioSession;\n    this.eventBus = eventBus;\n    this.canvas = options.canvas;\n    this.audioContext = new AudioContext();\n\n    // Initialize VideoComposer for real-time composition\n    // Pass canvas as externalCanvas for direct rendering\n    const model = orchestrator.compositionModel;\n\n    // FIX: Prioritize model renderConfig over canvas current dimensions\n    // The canvas should act as a viewport into the renderConfig resolution\n    const width = model?.renderConfig?.width || this.canvas.width || 720;\n    const height = model?.renderConfig?.height || this.canvas.height || 1280;\n\n    this.videoComposer = new VideoComposer({\n      width,\n      height,\n      fps: model?.fps || 30,\n      backgroundColor: model?.renderConfig?.backgroundColor || '#000',\n      externalCanvas: this.canvas,\n    });\n\n    // Set initial time if provided\n    if (options.startUs !== undefined) {\n      this.currentTimeUs = options.startUs;\n    }\n\n    if (options.rate !== undefined) {\n      this.playbackRate = options.rate;\n    }\n\n    if (options.loop !== undefined) {\n      this.loop = options.loop;\n    }\n\n    if (options.autoStart) {\n      this.play();\n    }\n\n    this.setupEventListeners();\n  }\n\n  async renderCover(): Promise<void> {\n    await this.renderCurrentFrame(0);\n  }\n\n  // Playback control\n  play(): void {\n    if (this.state === 'playing') return;\n\n    // If playback has ended, reset audio scheduling states for clean replay\n    if (this.state === 'ended') {\n      this.audioSession.resetPlaybackStates();\n    }\n\n    this.wasPlayingBeforeSeek = true; // User wants to play\n    this.startPlayback();\n  }\n\n  private async startPlayback(): Promise<void> {\n    const wasIdle = this.state === 'idle';\n    const seekId = this.currentSeekId;\n    this.state = 'playing';\n\n    try {\n      // Render first frame (may trigger buffering if cache miss)\n      await this.renderCurrentFrame(this.currentTimeUs);\n\n      // Check if seek happened during render or playback was stopped/paused\n      if (seekId !== this.currentSeekId || this.state !== 'playing') {\n        return;\n      }\n\n      // Initialize windows BEFORE starting audio playback\n      this.initWindow(this.currentTimeUs);\n\n      await this.audioSession.startPlayback(this.currentTimeUs, this.audioContext);\n\n      this.startTimeUs =\n        this.audioContext!.currentTime * 1_000_000 - this.currentTimeUs / this.playbackRate;\n\n      this.playbackLoop();\n\n      this.eventBus.emit(MeframeEvent.PlaybackPlay);\n    } catch (error) {\n      console.error('[PlaybackController] Failed to start playback:', error);\n      this.state = wasIdle ? 'idle' : 'paused';\n      this.eventBus.emit(MeframeEvent.PlaybackError, error as Error);\n    }\n  }\n\n  pause(): void {\n    this.state = 'paused';\n    this.wasPlayingBeforeSeek = false; // User explicitly paused\n\n    if (this.rafId !== null) {\n      cancelAnimationFrame(this.rafId);\n      this.rafId = null;\n    }\n\n    this.audioSession.stopPlayback();\n\n    // Cancel any ongoing async operations (buffering, seeking, etc.)\n    this.currentSeekId++;\n\n    this.eventBus.emit(MeframeEvent.PlaybackPause);\n  }\n\n  stop(): void {\n    this.pause();\n    this.currentTimeUs = 0;\n    this.state = 'idle';\n    this.wasPlayingBeforeSeek = false; // Reset seek state\n    this.frameCount = 0; // Reset frame counter\n    this.lastFrameTime = 0; // Reset frame timing\n\n    // Clear canvas\n    const ctx = this.canvas.getContext('2d') as\n      | CanvasRenderingContext2D\n      | OffscreenCanvasRenderingContext2D\n      | null;\n    if (ctx && 'clearRect' in ctx) {\n      ctx.clearRect(0, 0, this.canvas.width, this.canvas.height);\n    }\n\n    this.audioSession.reset();\n    this.audioSession.resetPlaybackStates();\n\n    this.eventBus.emit(MeframeEvent.PlaybackStop);\n  }\n\n  async seek(timeUs: TimeUs): Promise<void> {\n    const previousState = this.state;\n\n    this.orchestrator.cancelActiveDecoding();\n\n    // Stop playback without changing wasPlayingBeforeSeek\n    if (this.rafId !== null) {\n      cancelAnimationFrame(this.rafId);\n      this.rafId = null;\n    }\n    this.audioSession.stopPlayback();\n\n    // Reset audio playback states for all clips\n    this.audioSession.resetPlaybackStates();\n\n    const clamped = this.clampTime(timeUs);\n    this.currentTimeUs = clamped;\n    this.currentSeekId++; // Invalidate previous seek operations\n\n    // Initialize window at seek position\n    this.initWindow(clamped);\n\n    this.state = 'seeking';\n\n    const seekId = this.currentSeekId;\n\n    try {\n      // Fast path: Try to render nearest keyframe immediately to avoid black screen\n      const keyframeTimeUs = await this.orchestrator.tryRenderKeyframe(clamped);\n      if (keyframeTimeUs !== null) {\n        // Render keyframe from L1 cache\n        const renderState = await this.orchestrator.getRenderState(clamped, {\n          immediate: true,\n          relativeTimeUs: keyframeTimeUs,\n        });\n        if (renderState && this.videoComposer) {\n          await this.videoComposer.composeFrame({\n            timeUs: clamped,\n            layers: renderState.layers,\n            transition: renderState.transition,\n          });\n        }\n      }\n\n      // Check if another seek happened during keyframe render\n      if (seekId !== this.currentSeekId) {\n        return;\n      }\n\n      // Ensure audio windows ready for seek position (blocking mode)\n      await this.audioSession.ensureAudioForTime(clamped, { immediate: false });\n\n      // Force decode entire window even if keyframe is in L1\n      // preheat: true skips L1 check and decodes full window (60-120 frames)\n      await this.orchestrator.getFrame(clamped, {\n        immediate: false,\n        preheat: true,\n      });\n\n      if (seekId !== this.currentSeekId) {\n        return;\n      }\n\n      await this.renderCurrentFrame(clamped);\n\n      // Check if another seek happened during render\n      if (seekId !== this.currentSeekId) {\n        return;\n      }\n\n      this.eventBus.emit(MeframeEvent.PlaybackSeek, { timeUs: this.currentTimeUs });\n\n      if (this.wasPlayingBeforeSeek) {\n        await this.startPlayback();\n      } else {\n        this.state = previousState === 'idle' ? 'idle' : 'paused';\n      }\n    } catch (error) {\n      // Check if this seek is still current\n      if (seekId !== this.currentSeekId) {\n        return;\n      }\n      console.error('[PlaybackController] Seek error:', error);\n      this.eventBus.emit(MeframeEvent.PlaybackError, error as Error);\n      this.state = previousState === 'idle' ? 'idle' : 'paused';\n    }\n  }\n\n  // Playback properties\n  setRate(rate: number): void {\n    // Adjust audio start time to maintain current position\n    const currentTimeUs = this.currentTimeUs;\n    this.playbackRate = rate;\n    this.startTimeUs = this.audioContext!.currentTime * 1_000_000 - currentTimeUs / rate;\n\n    this.eventBus.emit(MeframeEvent.PlaybackRateChange, { rate });\n\n    this.audioSession.setPlaybackRate(this.playbackRate);\n  }\n\n  setVolume(volume: number): void {\n    this.volume = Math.max(0, Math.min(1, volume));\n    this.eventBus.emit(MeframeEvent.PlaybackVolumeChange, { volume: this.volume });\n\n    this.audioSession.setVolume(this.volume);\n  }\n\n  setMute(muted: boolean): void {\n    if (muted) {\n      this.audioSession.stopPlayback();\n    } else if (this.state === 'playing') {\n      this.audioSession.startPlayback(this.currentTimeUs, this.audioContext);\n    }\n  }\n\n  setLoop(loop: boolean): void {\n    this.loop = loop;\n  }\n\n  get duration(): TimeUs {\n    const modelDuration = this.orchestrator.compositionModel?.durationUs;\n    if (modelDuration !== undefined) {\n      return modelDuration;\n    }\n\n    return 0;\n  }\n\n  get isPlaying(): boolean {\n    return this.state === 'playing';\n  }\n\n  // Resume is just an alias for play\n  resume(): void {\n    this.play();\n  }\n\n  on(event: string, handler: (payload: any) => void): void {\n    this.eventBus.on(event as MeframeEvent, handler);\n  }\n\n  off(event: string, handler: (payload: any) => void): void {\n    this.eventBus.off(event as MeframeEvent, handler);\n  }\n\n  // Private methods\n  private playbackLoop(): void {\n    // State Check #1: Loop entry (from recursive call)\n    // Prevents next frame from starting if state changed during previous frame\n    // Captures: pause(), stop(), seek() called during frame processing\n    if (this.state !== 'playing') {\n      if (this.rafId !== null) {\n        cancelAnimationFrame(this.rafId);\n        this.rafId = null;\n      }\n      return;\n    }\n\n    this.rafId = requestAnimationFrame(async () => {\n      // State Check #2: RAF callback start (async boundary)\n      // Captures state changes during RAF delay (~16ms)\n      // Scenario: User pauses/seeks between requestAnimationFrame call and callback execution\n      if (this.state !== 'playing') {\n        return;\n      }\n\n      this.updateTime();\n\n      // State Check #3: After updateTime (playback end detection)\n      // CRITICAL: Prevents ensureAudioForTime/scheduleAudio from polluting cache\n      // When playback ends, currentTimeUs is reset to 0 for clean replay\n      // Without this check, audio operations would execute with wrong position\n      if (this.state !== 'playing') {\n        return;\n      }\n\n      // Ensure audio windows ready (aligned with video architecture)\n      // Use immediate mode during playback (non-blocking)\n      await this.audioSession.ensureAudioForTime(this.currentTimeUs, { immediate: true });\n\n      // Lookahead audio scheduling (OfflineAudioMixer approach)\n      await this.audioSession.scheduleAudio(this.currentTimeUs, this.audioContext);\n\n      await this.renderCurrentFrame(this.currentTimeUs);\n\n      // State Check #4: After render (buffering detection)\n      // Captures: renderCurrentFrame() triggered buffering (cache miss)\n      // Optimization: Early exit to avoid unnecessary FPS calculation and setWindow\n      // Not strictly required (next loop's Check #1 would catch it), but improves responsiveness\n      if (this.state !== 'playing') {\n        return;\n      }\n\n      // Calculate FPS based on actual frame timing\n      const now = performance.now();\n      if (this.lastFrameTime > 0) {\n        const deltaTime = now - this.lastFrameTime;\n        const instantFps = 1000 / deltaTime;\n        this.fps = this.fps > 0 ? this.fps * 0.9 + instantFps * 0.1 : instantFps;\n      }\n      this.lastFrameTime = now;\n\n      this.frameCount++;\n\n      // Update unified window for video and audio\n      this.orchestrator.cacheManager.setWindow(this.currentTimeUs);\n\n      this.playbackLoop();\n    });\n  }\n\n  private updateTime(): void {\n    const elapsedUs =\n      (this.audioContext!.currentTime * 1_000_000 - this.startTimeUs) * this.playbackRate;\n    this.currentTimeUs = elapsedUs;\n\n    // Check if reached end\n    if (this.currentTimeUs >= this.duration) {\n      if (this.loop) {\n        this.currentTimeUs = 0;\n        this.startTimeUs = this.audioContext!.currentTime * 1_000_000;\n        // Reset audio scheduling states to avoid stale state from previous playback\n        this.audioSession.resetPlaybackStates();\n        // Reset window to start position\n        this.initWindow(0);\n      } else {\n        this.pause();\n        // Set to 0 instead of duration to prevent audio operations in final frame\n        // from polluting cache with wrong position data\n        this.currentTimeUs = 0;\n        this.state = 'ended';\n        this.eventBus.emit(MeframeEvent.PlaybackEnded, { timeUs: this.duration });\n      }\n    }\n\n    // Emit time update\n    this.eventBus.emit(MeframeEvent.PlaybackTimeUpdate, { timeUs: this.currentTimeUs });\n\n    // Check if approaching window edge - trigger async preheat\n    this.checkAndPreheatWindow();\n    // Note: setWindow is now called in Orchestrator.renderFrame()\n    // this.orchestrator.cacheManager.setWindow(this.currentTimeUs);\n  }\n\n  /**\n   * Initialize window at given time (called on play/seek)\n   * Sets unified window for both video and audio\n   */\n  private initWindow(timeUs: TimeUs): void {\n    this.windowEnd = timeUs + this.WINDOW_DURATION;\n    this.preheatInProgress = false; // Reset preheat state\n\n    // Set unified window center for both video and audio\n    this.orchestrator.cacheManager.setWindow(timeUs);\n  }\n\n  /**\n   * Check if approaching window end and trigger preheat for next window\n   *\n   * Strategy: Unified sliding window for both video and audio\n   * - Current window: [windowStart, windowEnd] (3s duration)\n   * - When playback reaches windowEnd - 1s, preheat next window\n   * - Next window: [windowEnd, windowEnd + 3s]\n   */\n  private checkAndPreheatWindow(): void {\n    // Skip if already preheating or not playing\n    if (this.preheatInProgress || this.state !== 'playing') {\n      return;\n    }\n\n    // Check if approaching window end\n    const distanceToWindowEnd = this.windowEnd - this.currentTimeUs;\n    if (distanceToWindowEnd < 0) {\n      this.initWindow(this.currentTimeUs);\n      return;\n    }\n\n    // Trigger preheat when 1s from window end\n    if (distanceToWindowEnd > 0 && distanceToWindowEnd <= this.PREHEAT_DISTANCE) {\n      this.preheatNextWindow();\n    }\n  }\n\n  /**\n   * Preheat next window by decoding from current playback time\n   * Supports cross-clip window preheating for seamless playback\n   * Preheats both video and audio in parallel\n   */\n  async preheatNextWindow(): Promise<void> {\n    this.preheatInProgress = true;\n    try {\n      const windowStart = this.currentTimeUs;\n      const windowEnd = windowStart + this.WINDOW_DURATION;\n\n      // Get all clips in window range (may span multiple clips)\n      const clipsInWindow =\n        this.orchestrator.compositionModel?.getClipsInRange(windowStart, windowEnd) ?? [];\n      const preheatPromises: Promise<any>[] = [];\n\n      // Preheat video for each clip in window\n      for (const clip of clipsInWindow) {\n        if (!isVideoClip(clip)) continue;\n\n        // Calculate clip-relative window boundaries\n        const clipWindowStart = Math.max(0, windowStart - clip.startUs);\n        const clipWindowEnd = Math.min(clip.durationUs, windowEnd - clip.startUs);\n\n        // Skip if window doesn't overlap with this clip\n        if (clipWindowStart >= clipWindowEnd) continue;\n\n        preheatPromises.push(\n          this.orchestrator.preheatClipWindow(clip.id, clipWindowStart, clipWindowEnd, windowStart)\n        );\n      }\n\n      // Preheat audio (non-blocking mode for background decoding)\n      preheatPromises.push(this.audioSession.ensureAudioForTime(windowStart, { immediate: false }));\n\n      await Promise.all(preheatPromises);\n\n      // Update window bounds after successful preheat\n      this.windowEnd = windowEnd;\n    } catch (error) {\n      // Preheat failures are not critical\n      console.warn('[PlaybackController] Preheat failed:', error);\n    } finally {\n      this.preheatInProgress = false;\n    }\n  }\n\n  async renderCurrentFrame(timeUs: TimeUs): Promise<void> {\n    if (!this.videoComposer) {\n      console.error('[PlaybackController] VideoComposer not initialized');\n      return;\n    }\n\n    try {\n      // Get render state (layers) from orchestrator\n      // Use immediate mode when playing to detect buffering\n      const renderState = await this.orchestrator.getRenderState(timeUs, {\n        immediate: this.state === 'playing',\n      });\n\n      if (!renderState) {\n        // If renderState is null during playback, we hit a cache miss/buffer underrun\n        if (this.state === 'playing') {\n          await this.handlePlaybackBuffering(timeUs);\n        }\n        return;\n      }\n\n      // Compose directly to canvas\n      await this.videoComposer.composeFrame({\n        timeUs,\n        layers: renderState.layers,\n        transition: renderState.transition,\n      });\n    } catch (error) {\n      console.error('Render error:', error);\n      this.eventBus.emit(MeframeEvent.PlaybackError, error as Error);\n    }\n  }\n\n  private async handlePlaybackBuffering(timeUs: TimeUs): Promise<void> {\n    // Prevent re-entrance: if not playing, skip\n    if (this.state !== 'playing') {\n      return;\n    }\n\n    const seekId = this.currentSeekId;\n    this.state = 'buffering';\n    this.eventBus.emit(MeframeEvent.PlaybackBuffering);\n\n    // Pause audio immediately to prevent desync\n    this.audioSession.stopPlayback();\n\n    try {\n      // Update window center for buffering position\n      this.orchestrator.cacheManager.setWindow(timeUs);\n\n      // Force load frame (blocking)\n      // This ensures the resource is downloaded and decoded\n      await this.orchestrator.getFrame(timeUs, { immediate: false });\n\n      // Also ensure audio is ready (blocking mode for buffering)\n      await this.audioSession.ensureAudioForTime(timeUs, { immediate: false });\n\n      // Check if seek happened during buffering or playback was stopped/paused\n      if (seekId !== this.currentSeekId || this.state !== 'buffering') {\n        return;\n      }\n\n      this.state = 'playing';\n      this.startTimeUs = this.audioContext!.currentTime * 1_000_000 - timeUs / this.playbackRate;\n\n      // Resume audio synced with timeline\n      await this.audioSession.startPlayback(timeUs, this.audioContext);\n\n      this.eventBus.emit(MeframeEvent.PlaybackPlay);\n\n      if (!this.rafId) {\n        this.playbackLoop();\n      }\n    } catch (error) {\n      // Ignore WaiterReplacedError (happens during fast seeks)\n      if (error instanceof WaiterReplacedError) {\n        return;\n      }\n      // Check if seek happened during error handling\n      if (seekId !== this.currentSeekId) {\n        return;\n      }\n      console.error('[PlaybackController] Buffering error:', error);\n      this.state = 'paused';\n      this.eventBus.emit(MeframeEvent.PlaybackError, error as Error);\n    }\n  }\n\n  private clampTime(timeUs: TimeUs): TimeUs {\n    return Math.max(0, Math.min(timeUs, this.duration));\n  }\n\n  // Cleanup\n  dispose(): void {\n    this.stop();\n    this.eventBus.off(MeframeEvent.CacheCover, this.onCacheCover);\n    this.eventBus.off(MeframeEvent.ModelSet, this.onModelSet);\n    if (this.videoComposer) {\n      this.videoComposer.dispose();\n      this.videoComposer = null;\n    }\n  }\n\n  private onCacheCover = (): void => {\n    // Optimization for Quick Start / Fast First Frame:\n    // When the first frame of a resource is decoded (e.g. via side-channel parsing),\n    // we immediately render it if we are at the start of the timeline.\n    // This significantly improves perceived loading speed for compatible formats (e.g. fragmented MP4 with moov at start).\n    // For standard formats or when not at time 0, this might be redundant as normal playback loop handles it.\n    if (this.state === 'idle' && this.currentTimeUs === 0) {\n      this.renderCurrentFrame(0);\n    }\n  };\n\n  private onModelSet = (): void => {\n    if (!this.videoComposer || !this.orchestrator.compositionModel) return;\n\n    const model = this.orchestrator.compositionModel;\n    // Update VideoComposer configuration with new model dimensions and fps\n    this.videoComposer.updateConfig({\n      width: model.renderConfig?.width || 720,\n      height: model.renderConfig?.height || 1280,\n      fps: model.fps || 30,\n      backgroundColor: model.renderConfig?.backgroundColor || '#000',\n    });\n\n    // Preheat audio for first frame (non-blocking)\n    this.audioSession.ensureAudioForTime(this.currentTimeUs, { immediate: false });\n\n    // Re-render current frame to reflect dimension changes immediately\n    this.renderCurrentFrame(this.currentTimeUs);\n  };\n\n  private setupEventListeners(): void {\n    this.eventBus.on(MeframeEvent.CacheCover, this.onCacheCover);\n    this.eventBus.on(MeframeEvent.ModelSet, this.onModelSet);\n  }\n}\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"PlaybackController.js","sources":["../../src/controllers/PlaybackController.ts"],"sourcesContent":["import type {\n  IPlaybackController,\n  PlaybackState,\n  PlaybackOptions,\n  IEventBus,\n  PreviewHandle,\n  TimeUs,\n} from './types';\nimport { MeframeEvent } from '../event/events';\nimport type { GlobalAudioSession } from '../orchestrator/GlobalAudioSession';\nimport type { Orchestrator } from '../orchestrator';\nimport { WaiterReplacedError } from '../utils/errors';\nimport { VideoComposer } from '../stages/compose/VideoComposer';\nimport { isVideoClip } from '../model/types';\n\n/**\n * Playback controller for preview\n * Internal implementation - not exposed directly to external consumers\n */\nexport class PlaybackController implements IPlaybackController, PreviewHandle {\n  private orchestrator: Orchestrator;\n  private eventBus: IEventBus;\n  private canvas: HTMLCanvasElement | OffscreenCanvas;\n  private videoComposer: VideoComposer | null = null;\n\n  // Playback state\n  currentTimeUs: TimeUs = 0;\n  private state: PlaybackState = 'idle';\n  private playbackRate = 1.0;\n  private volume = 1.0;\n  private loop = false;\n\n  // Animation loop\n  private rafId: number | null = null;\n  private startTimeUs: TimeUs = 0; // Playback start position in AudioContext timeline (microseconds)\n\n  // Frame tracking\n  private frameCount = 0;\n  private lastFrameTime = 0;\n  private fps = 0;\n  private audioContext: AudioContext;\n  private audioSession: GlobalAudioSession;\n\n  // Seek tracking\n  private currentSeekId = 0;\n  private wasPlayingBeforeSeek = false;\n\n  // Unified window management for both video and audio\n  private windowEnd: TimeUs = 0;\n  private readonly WINDOW_DURATION = 3_000_000; // 3s decode window\n  private readonly PREHEAT_DISTANCE = 1_000_000; // 1s preheat trigger distance\n  private preheatInProgress = false;\n\n  // Audio scheduling throttle to reduce CPU overhead\n  private lastAudioScheduleTime = 0;\n  private readonly AUDIO_SCHEDULE_INTERVAL = 100_000; // 100ms (~3 frames at 30fps)\n\n  constructor(orchestrator: Orchestrator, eventBus: IEventBus, options: PlaybackOptions) {\n    this.orchestrator = orchestrator;\n    this.audioSession = orchestrator.audioSession;\n    this.eventBus = eventBus;\n    this.canvas = options.canvas;\n    this.audioContext = new AudioContext();\n\n    // Initialize VideoComposer for real-time composition\n    // Pass canvas as externalCanvas for direct rendering\n    const model = orchestrator.compositionModel;\n\n    // FIX: Prioritize model renderConfig over canvas current dimensions\n    // The canvas should act as a viewport into the renderConfig resolution\n    const width = model?.renderConfig?.width || this.canvas.width || 720;\n    const height = model?.renderConfig?.height || this.canvas.height || 1280;\n\n    this.videoComposer = new VideoComposer({\n      width,\n      height,\n      fps: model?.fps || 30,\n      backgroundColor: model?.renderConfig?.backgroundColor || '#000',\n      externalCanvas: this.canvas,\n    });\n\n    // Set initial time if provided\n    if (options.startUs !== undefined) {\n      this.currentTimeUs = options.startUs;\n    }\n\n    if (options.rate !== undefined) {\n      this.playbackRate = options.rate;\n    }\n\n    if (options.loop !== undefined) {\n      this.loop = options.loop;\n    }\n\n    if (options.autoStart) {\n      this.play();\n    }\n\n    this.setupEventListeners();\n  }\n\n  async renderCover(): Promise<void> {\n    await this.renderCurrentFrame(0);\n  }\n\n  // Playback control\n  play(): void {\n    if (this.state === 'playing') return;\n\n    // Always reset throttle timer when starting/resuming playback\n    // This ensures audio scheduling triggers immediately on first frame\n    this.lastAudioScheduleTime = 0;\n\n    this.wasPlayingBeforeSeek = true; // User wants to play\n    this.startPlayback();\n    // Note: resetPlaybackStates() is called inside startPlayback() → audioSession.startPlayback()\n  }\n\n  private async startPlayback(): Promise<void> {\n    const wasIdle = this.state === 'idle';\n    const seekId = this.currentSeekId;\n    this.state = 'playing';\n\n    try {\n      // Render first frame (may trigger buffering if cache miss)\n      await this.renderCurrentFrame(this.currentTimeUs);\n\n      // Check if seek happened during render or playback was stopped/paused\n      if (seekId !== this.currentSeekId || this.state !== 'playing') {\n        return;\n      }\n\n      // Initialize windows BEFORE starting audio playback\n      this.initWindow(this.currentTimeUs);\n\n      await this.audioSession.startPlayback(this.currentTimeUs, this.audioContext);\n\n      this.startTimeUs =\n        this.audioContext!.currentTime * 1_000_000 - this.currentTimeUs / this.playbackRate;\n\n      this.playbackLoop();\n\n      this.eventBus.emit(MeframeEvent.PlaybackPlay);\n    } catch (error) {\n      console.error('[PlaybackController] Failed to start playback:', error);\n      this.state = wasIdle ? 'idle' : 'paused';\n      this.eventBus.emit(MeframeEvent.PlaybackError, error as Error);\n    }\n  }\n\n  pause(): void {\n    this.state = 'paused';\n    this.wasPlayingBeforeSeek = false; // User explicitly paused\n\n    if (this.rafId !== null) {\n      cancelAnimationFrame(this.rafId);\n      this.rafId = null;\n    }\n\n    this.audioSession.stopPlayback();\n\n    // Cancel any ongoing async operations (buffering, seeking, etc.)\n    this.currentSeekId++;\n\n    this.eventBus.emit(MeframeEvent.PlaybackPause);\n  }\n\n  stop(): void {\n    this.pause();\n    this.currentTimeUs = 0;\n    this.state = 'idle';\n    this.wasPlayingBeforeSeek = false; // Reset seek state\n    this.frameCount = 0; // Reset frame counter\n    this.lastFrameTime = 0; // Reset frame timing\n    this.lastAudioScheduleTime = 0; // Reset throttle timer\n\n    // Clear canvas\n    const ctx = this.canvas.getContext('2d') as\n      | CanvasRenderingContext2D\n      | OffscreenCanvasRenderingContext2D\n      | null;\n    if (ctx && 'clearRect' in ctx) {\n      ctx.clearRect(0, 0, this.canvas.width, this.canvas.height);\n    }\n\n    this.audioSession.reset();\n    this.audioSession.resetPlaybackStates();\n\n    this.eventBus.emit(MeframeEvent.PlaybackStop);\n  }\n\n  async seek(timeUs: TimeUs): Promise<void> {\n    const previousState = this.state;\n\n    this.orchestrator.cancelActiveDecoding();\n\n    // Stop playback without changing wasPlayingBeforeSeek\n    if (this.rafId !== null) {\n      cancelAnimationFrame(this.rafId);\n      this.rafId = null;\n    }\n    this.audioSession.stopPlayback();\n\n    // Reset throttle timer for seek\n    this.lastAudioScheduleTime = 0;\n    // Note: resetPlaybackStates() will be called in startPlayback() if needed\n    // Calling it here would be premature as there may be a delay before startPlayback()\n\n    const clamped = this.clampTime(timeUs);\n    this.currentTimeUs = clamped;\n    this.currentSeekId++; // Invalidate previous seek operations\n\n    // Initialize window at seek position\n    this.initWindow(clamped);\n\n    this.state = 'seeking';\n\n    const seekId = this.currentSeekId;\n\n    try {\n      // Fast path: Try to render nearest keyframe immediately to avoid black screen\n      const keyframeTimeUs = await this.orchestrator.tryRenderKeyframe(clamped);\n      if (keyframeTimeUs !== null) {\n        // Render keyframe from L1 cache\n        const renderState = await this.orchestrator.getRenderState(clamped, {\n          immediate: true,\n          relativeTimeUs: keyframeTimeUs,\n        });\n        if (renderState && this.videoComposer) {\n          await this.videoComposer.composeFrame({\n            timeUs: clamped,\n            layers: renderState.layers,\n            transition: renderState.transition,\n          });\n        }\n      }\n\n      // Check if another seek happened during keyframe render\n      if (seekId !== this.currentSeekId) {\n        return;\n      }\n\n      // Ensure audio windows ready for seek position (blocking mode)\n      await this.audioSession.ensureAudioForTime(clamped, { immediate: false });\n\n      // Force decode entire window even if keyframe is in L1\n      // preheat: true skips L1 check and decodes full window (60-120 frames)\n      await this.orchestrator.getFrame(clamped, {\n        immediate: false,\n        preheat: true,\n      });\n\n      if (seekId !== this.currentSeekId) {\n        return;\n      }\n\n      await this.renderCurrentFrame(clamped);\n\n      // Check if another seek happened during render\n      if (seekId !== this.currentSeekId) {\n        return;\n      }\n\n      this.eventBus.emit(MeframeEvent.PlaybackSeek, { timeUs: this.currentTimeUs });\n\n      if (this.wasPlayingBeforeSeek) {\n        await this.startPlayback();\n      } else {\n        this.state = previousState === 'idle' ? 'idle' : 'paused';\n      }\n    } catch (error) {\n      // Check if this seek is still current\n      if (seekId !== this.currentSeekId) {\n        return;\n      }\n      console.error('[PlaybackController] Seek error:', error);\n      this.eventBus.emit(MeframeEvent.PlaybackError, error as Error);\n      this.state = previousState === 'idle' ? 'idle' : 'paused';\n    }\n  }\n\n  // Playback properties\n  setRate(rate: number): void {\n    // Adjust audio start time to maintain current position\n    const currentTimeUs = this.currentTimeUs;\n    this.playbackRate = rate;\n    this.startTimeUs = this.audioContext!.currentTime * 1_000_000 - currentTimeUs / rate;\n\n    this.eventBus.emit(MeframeEvent.PlaybackRateChange, { rate });\n\n    this.audioSession.setPlaybackRate(this.playbackRate);\n  }\n\n  setVolume(volume: number): void {\n    this.volume = Math.max(0, Math.min(1, volume));\n    this.eventBus.emit(MeframeEvent.PlaybackVolumeChange, { volume: this.volume });\n\n    this.audioSession.setVolume(this.volume);\n  }\n\n  setMute(muted: boolean): void {\n    if (muted) {\n      this.audioSession.stopPlayback();\n    } else if (this.state === 'playing') {\n      this.audioSession.startPlayback(this.currentTimeUs, this.audioContext);\n    }\n  }\n\n  setLoop(loop: boolean): void {\n    this.loop = loop;\n  }\n\n  get duration(): TimeUs {\n    const modelDuration = this.orchestrator.compositionModel?.durationUs;\n    if (modelDuration !== undefined) {\n      return modelDuration;\n    }\n\n    return 0;\n  }\n\n  get isPlaying(): boolean {\n    return this.state === 'playing';\n  }\n\n  // Resume is just an alias for play\n  resume(): void {\n    this.play();\n  }\n\n  on(event: string, handler: (payload: any) => void): void {\n    this.eventBus.on(event as MeframeEvent, handler);\n  }\n\n  off(event: string, handler: (payload: any) => void): void {\n    this.eventBus.off(event as MeframeEvent, handler);\n  }\n\n  // Private methods\n  private playbackLoop(): void {\n    // State Check #1: Loop entry (from recursive call)\n    // Prevents next frame from starting if state changed during previous frame\n    // Captures: pause(), stop(), seek() called during frame processing\n    if (this.state !== 'playing') {\n      if (this.rafId !== null) {\n        cancelAnimationFrame(this.rafId);\n        this.rafId = null;\n      }\n      return;\n    }\n\n    this.rafId = requestAnimationFrame(async () => {\n      // State Check #2: RAF callback start (async boundary)\n      // Captures state changes during RAF delay (~16ms)\n      // Scenario: User pauses/seeks between requestAnimationFrame call and callback execution\n      if (this.state !== 'playing') {\n        return;\n      }\n\n      this.updateTime();\n\n      // State Check #3: After updateTime (playback end detection)\n      // CRITICAL: Prevents ensureAudioForTime/scheduleAudio from polluting cache\n      // When playback ends, currentTimeUs is reset to 0 for clean replay\n      // Without this check, audio operations would execute with wrong position\n      if (this.state !== 'playing') {\n        return;\n      }\n\n      // Throttle audio scheduling to reduce CPU overhead (every 100ms instead of every frame)\n      // This reduces audio operations from 30fps to ~10fps without audible impact\n      if (this.currentTimeUs - this.lastAudioScheduleTime >= this.AUDIO_SCHEDULE_INTERVAL) {\n        // Ensure audio windows ready (aligned with video architecture)\n        // Use immediate mode during playback (non-blocking)\n        await this.audioSession.ensureAudioForTime(this.currentTimeUs, { immediate: true });\n\n        // Lookahead audio scheduling (OfflineAudioMixer approach)\n        await this.audioSession.scheduleAudio(this.currentTimeUs, this.audioContext);\n\n        this.lastAudioScheduleTime = this.currentTimeUs;\n      }\n\n      await this.renderCurrentFrame(this.currentTimeUs);\n\n      // State Check #4: After render (buffering detection)\n      // Captures: renderCurrentFrame() triggered buffering (cache miss)\n      // Optimization: Early exit to avoid unnecessary FPS calculation and setWindow\n      // Not strictly required (next loop's Check #1 would catch it), but improves responsiveness\n      if (this.state !== 'playing') {\n        return;\n      }\n\n      // Calculate FPS based on actual frame timing\n      const now = performance.now();\n      if (this.lastFrameTime > 0) {\n        const deltaTime = now - this.lastFrameTime;\n        const instantFps = 1000 / deltaTime;\n        this.fps = this.fps > 0 ? this.fps * 0.9 + instantFps * 0.1 : instantFps;\n      }\n      this.lastFrameTime = now;\n\n      this.frameCount++;\n\n      // Update unified window for video and audio\n      this.orchestrator.cacheManager.setWindow(this.currentTimeUs);\n\n      this.playbackLoop();\n    });\n  }\n\n  private updateTime(): void {\n    const elapsedUs =\n      (this.audioContext!.currentTime * 1_000_000 - this.startTimeUs) * this.playbackRate;\n    this.currentTimeUs = elapsedUs;\n\n    // Check if reached end\n    if (this.currentTimeUs >= this.duration) {\n      if (this.loop) {\n        this.currentTimeUs = 0;\n        this.startTimeUs = this.audioContext!.currentTime * 1_000_000;\n        // Reset audio scheduling states to avoid stale state from previous playback\n        this.audioSession.resetPlaybackStates();\n        this.lastAudioScheduleTime = 0; // Reset throttle timer for loop\n        // Reset window to start position\n        this.initWindow(0);\n      } else {\n        this.pause();\n        // Set to 0 instead of duration to prevent audio operations in final frame\n        // from polluting cache with wrong position data\n        this.currentTimeUs = 0;\n        this.state = 'ended';\n        this.eventBus.emit(MeframeEvent.PlaybackEnded, { timeUs: this.duration });\n      }\n    }\n\n    // Emit time update\n    this.eventBus.emit(MeframeEvent.PlaybackTimeUpdate, { timeUs: this.currentTimeUs });\n\n    // Check if approaching window edge - trigger async preheat\n    this.checkAndPreheatWindow();\n    // Note: setWindow is now called in Orchestrator.renderFrame()\n    // this.orchestrator.cacheManager.setWindow(this.currentTimeUs);\n  }\n\n  /**\n   * Initialize window at given time (called on play/seek)\n   * Sets unified window for both video and audio\n   */\n  private initWindow(timeUs: TimeUs): void {\n    this.windowEnd = timeUs + this.WINDOW_DURATION;\n    this.preheatInProgress = false; // Reset preheat state\n\n    // Set unified window center for both video and audio\n    this.orchestrator.cacheManager.setWindow(timeUs);\n  }\n\n  /**\n   * Check if approaching window end and trigger preheat for next window\n   *\n   * Strategy: Unified sliding window for both video and audio\n   * - Current window: [windowStart, windowEnd] (3s duration)\n   * - When playback reaches windowEnd - 1s, preheat next window\n   * - Next window: [windowEnd, windowEnd + 3s]\n   */\n  private checkAndPreheatWindow(): void {\n    // Skip if already preheating or not playing\n    if (this.preheatInProgress || this.state !== 'playing') {\n      return;\n    }\n\n    // Check if approaching window end\n    const distanceToWindowEnd = this.windowEnd - this.currentTimeUs;\n    if (distanceToWindowEnd < 0) {\n      this.initWindow(this.currentTimeUs);\n      return;\n    }\n\n    // Trigger preheat when 1s from window end\n    if (distanceToWindowEnd > 0 && distanceToWindowEnd <= this.PREHEAT_DISTANCE) {\n      this.preheatNextWindow();\n    }\n  }\n\n  /**\n   * Preheat next window by decoding from current playback time\n   * Supports cross-clip window preheating for seamless playback\n   * Preheats both video and audio in parallel\n   */\n  async preheatNextWindow(): Promise<void> {\n    this.preheatInProgress = true;\n    try {\n      const windowStart = this.currentTimeUs;\n      const windowEnd = windowStart + this.WINDOW_DURATION;\n\n      // Get all clips in window range (may span multiple clips)\n      const clipsInWindow =\n        this.orchestrator.compositionModel?.getClipsInRange(windowStart, windowEnd) ?? [];\n      const preheatPromises: Promise<any>[] = [];\n\n      // Preheat video for each clip in window\n      for (const clip of clipsInWindow) {\n        if (!isVideoClip(clip)) continue;\n\n        // Calculate clip-relative window boundaries\n        const clipWindowStart = Math.max(0, windowStart - clip.startUs);\n        const clipWindowEnd = Math.min(clip.durationUs, windowEnd - clip.startUs);\n\n        // Skip if window doesn't overlap with this clip\n        if (clipWindowStart >= clipWindowEnd) continue;\n\n        preheatPromises.push(\n          this.orchestrator.preheatClipWindow(clip.id, clipWindowStart, clipWindowEnd, windowStart)\n        );\n      }\n\n      // Preheat audio (non-blocking mode for background decoding)\n      preheatPromises.push(this.audioSession.ensureAudioForTime(windowStart, { immediate: false }));\n\n      await Promise.all(preheatPromises);\n\n      // Update window bounds after successful preheat\n      this.windowEnd = windowEnd;\n    } catch (error) {\n      // Preheat failures are not critical\n      console.warn('[PlaybackController] Preheat failed:', error);\n    } finally {\n      this.preheatInProgress = false;\n    }\n  }\n\n  async renderCurrentFrame(timeUs: TimeUs): Promise<void> {\n    if (!this.videoComposer) {\n      console.error('[PlaybackController] VideoComposer not initialized');\n      return;\n    }\n\n    try {\n      // Get render state (layers) from orchestrator\n      // Use immediate mode when playing to detect buffering\n      const renderState = await this.orchestrator.getRenderState(timeUs, {\n        immediate: this.state === 'playing',\n      });\n\n      if (!renderState) {\n        // If renderState is null during playback, we hit a cache miss/buffer underrun\n        if (this.state === 'playing') {\n          await this.handlePlaybackBuffering(timeUs);\n        }\n        return;\n      }\n\n      // Compose directly to canvas\n      await this.videoComposer.composeFrame({\n        timeUs,\n        layers: renderState.layers,\n        transition: renderState.transition,\n      });\n    } catch (error) {\n      console.error('Render error:', error);\n      this.eventBus.emit(MeframeEvent.PlaybackError, error as Error);\n    }\n  }\n\n  private async handlePlaybackBuffering(timeUs: TimeUs): Promise<void> {\n    // Prevent re-entrance: if not playing, skip\n    if (this.state !== 'playing') {\n      return;\n    }\n\n    const seekId = this.currentSeekId;\n    this.state = 'buffering';\n    this.eventBus.emit(MeframeEvent.PlaybackBuffering);\n\n    // Pause audio immediately to prevent desync\n    this.audioSession.stopPlayback();\n\n    try {\n      // Update window center for buffering position\n      this.orchestrator.cacheManager.setWindow(timeUs);\n\n      // Force load frame (blocking)\n      // This ensures the resource is downloaded and decoded\n      await this.orchestrator.getFrame(timeUs, { immediate: false });\n\n      // Also ensure audio is ready (blocking mode for buffering)\n      await this.audioSession.ensureAudioForTime(timeUs, { immediate: false });\n\n      // Check if seek happened during buffering or playback was stopped/paused\n      if (seekId !== this.currentSeekId || this.state !== 'buffering') {\n        return;\n      }\n\n      this.state = 'playing';\n      this.startTimeUs = this.audioContext!.currentTime * 1_000_000 - timeUs / this.playbackRate;\n\n      // Reset throttle timer after buffering to ensure immediate audio scheduling\n      this.lastAudioScheduleTime = 0;\n\n      // Resume audio synced with timeline\n      await this.audioSession.startPlayback(timeUs, this.audioContext);\n\n      this.eventBus.emit(MeframeEvent.PlaybackPlay);\n\n      if (!this.rafId) {\n        this.playbackLoop();\n      }\n    } catch (error) {\n      // Ignore WaiterReplacedError (happens during fast seeks)\n      if (error instanceof WaiterReplacedError) {\n        return;\n      }\n      // Check if seek happened during error handling\n      if (seekId !== this.currentSeekId) {\n        return;\n      }\n      console.error('[PlaybackController] Buffering error:', error);\n      this.state = 'paused';\n      this.eventBus.emit(MeframeEvent.PlaybackError, error as Error);\n    }\n  }\n\n  private clampTime(timeUs: TimeUs): TimeUs {\n    return Math.max(0, Math.min(timeUs, this.duration));\n  }\n\n  // Cleanup\n  dispose(): void {\n    this.stop();\n    this.eventBus.off(MeframeEvent.CacheCover, this.onCacheCover);\n    this.eventBus.off(MeframeEvent.ModelSet, this.onModelSet);\n    if (this.videoComposer) {\n      this.videoComposer.dispose();\n      this.videoComposer = null;\n    }\n  }\n\n  private onCacheCover = (): void => {\n    // Optimization for Quick Start / Fast First Frame:\n    // When the first frame of a resource is decoded (e.g. via side-channel parsing),\n    // we immediately render it if we are at the start of the timeline.\n    // This significantly improves perceived loading speed for compatible formats (e.g. fragmented MP4 with moov at start).\n    // For standard formats or when not at time 0, this might be redundant as normal playback loop handles it.\n    if (this.state === 'idle' && this.currentTimeUs === 0) {\n      this.renderCurrentFrame(0);\n    }\n  };\n\n  private onModelSet = (): void => {\n    if (!this.videoComposer || !this.orchestrator.compositionModel) return;\n\n    const model = this.orchestrator.compositionModel;\n    // Update VideoComposer configuration with new model dimensions and fps\n    this.videoComposer.updateConfig({\n      width: model.renderConfig?.width || 720,\n      height: model.renderConfig?.height || 1280,\n      fps: model.fps || 30,\n      backgroundColor: model.renderConfig?.backgroundColor || '#000',\n    });\n\n    // Preheat audio for first frame (non-blocking)\n    this.audioSession.ensureAudioForTime(this.currentTimeUs, { immediate: false });\n\n    // Re-render current frame to reflect dimension changes immediately\n    this.renderCurrentFrame(this.currentTimeUs);\n  };\n\n  private setupEventListeners(): void {\n    this.eventBus.on(MeframeEvent.CacheCover, this.onCacheCover);\n    this.eventBus.on(MeframeEvent.ModelSet, this.onModelSet);\n  }\n}\n"],"names":[],"mappings":"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"}

package/dist/model/RcFrame.d.ts

@@ -8,25 +8,40 @@ export interface RcFrameMetadata {
     sizeEstimate?: number;
     globalTimeUs?: TimeUs;
 }
-type UseHandler<T> = (frame: VideoFrame) => T | Promise<T>;
+type UseHandler<T> = (frame: VideoFrame) => T;
+/**
+ * RcFrame - Lightweight VideoFrame wrapper with metadata
+ *
+ * Design:
+ * - Carries metadata (timestamp, clipId, trackId, size) for cache management
+ * - Provides unified .use() interface for accessing the frame
+ * - Direct frame access (no clone) for optimal performance
+ * - Manages frame lifecycle with simple .close() wrapper
+ *
+ * IMPORTANT: Handler MUST NOT call frame.close() - lifecycle is managed by RcFrame
+ */
 export declare class RcFrame {
-    private activeUses;
-    private closing;
+    private closed;
     private readonly baseFrame;
     private readonly metadata;
-    private readonly onZero?;
-    private closePromise;
-    private closeResolve;
     private constructor();
-    static wrap(frame: VideoFrame, metadata: RcFrameMetadata, onZero?: () => void): RcFrame;
+    static wrap(frame: VideoFrame, metadata: RcFrameMetadata): RcFrame;
     get timestampUs(): TimeUs;
     get durationUs(): TimeUs;
     get trackId(): string;
     get clipId(): string;
     get globalTimeUs(): TimeUs | undefined;
     get sizeEstimate(): number;
-    use<T>(handler: UseHandler<T>): Promise<T>;
-    close(): Promise<void>;
+    /**
+     * Execute handler with direct access to the underlying VideoFrame
+     *
+     * CRITICAL: Handler MUST NOT call frame.close()
+     * The frame lifecycle is managed by RcFrame.close()
+     *
+     * This design avoids expensive clone() operations for real-time playback performance
+     */
+    use<T>(handler: UseHandler<T>): T;
+    close(): void;
 }
 export {};
 //# sourceMappingURL=RcFrame.d.ts.map

package/dist/model/RcFrame.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"RcFrame.d.ts","sourceRoot":"","sources":["../../src/model/RcFrame.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAEtC,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAID,KAAK,UAAU,CAAC,CAAC,IAAI,CAAC,KAAK,EAAE,UAAU,KAAK,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;AAE3D,qBAAa,OAAO;IAClB,OAAO,CAAC,UAAU,CAAK;IACvB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAa;IACvC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAkB;IAC3C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAa;IAErC,OAAO,CAAC,YAAY,CAA8B;IAClD,OAAO,CAAC,YAAY,CAA6B;IAEjD,OAAO;IAMP,MAAM,CAAC,IAAI,CAAC,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,CAAC,EAAE,MAAM,IAAI,GAAG,OAAO;IAIvF,IAAI,WAAW,IAAI,MAAM,CAExB;IAED,IAAI,UAAU,IAAI,MAAM,CAEvB;IAED,IAAI,OAAO,IAAI,MAAM,CAEpB;IAED,IAAI,MAAM,IAAI,MAAM,CAEnB;IAED,IAAI,YAAY,IAAI,MAAM,GAAG,SAAS,CAErC;IAED,IAAI,YAAY,IAAI,MAAM,CAUzB;IAEK,GAAG,CAAC,CAAC,EAAE,OAAO,EAAE,UAAU,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAmB1C,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAkC7B"}
+{"version":3,"file":"RcFrame.d.ts","sourceRoot":"","sources":["../../src/model/RcFrame.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAEtC,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAGD,KAAK,UAAU,CAAC,CAAC,IAAI,CAAC,KAAK,EAAE,UAAU,KAAK,CAAC,CAAC;AAE9C;;;;;;;;;;GAUG;AACH,qBAAa,OAAO;IAClB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAa;IACvC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAkB;IAE3C,OAAO;IAKP,MAAM,CAAC,IAAI,CAAC,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,eAAe,GAAG,OAAO;IAIlE,IAAI,WAAW,IAAI,MAAM,CAExB;IAED,IAAI,UAAU,IAAI,MAAM,CAEvB;IAED,IAAI,OAAO,IAAI,MAAM,CAEpB;IAED,IAAI,MAAM,IAAI,MAAM,CAEnB;IAED,IAAI,YAAY,IAAI,MAAM,GAAG,SAAS,CAErC;IAED,IAAI,YAAY,IAAI,MAAM,CAUzB;IAED;;;;;;;OAOG;IACH,GAAG,CAAC,CAAC,EAAE,OAAO,EAAE,UAAU,CAAC,CAAC,CAAC,GAAG,CAAC;IAOjC,KAAK,IAAI,IAAI;CAOd"}

package/dist/model/RcFrame.js

@@ -1,20 +1,14 @@
 const DEFAULT_SIZE_ESTIMATE = 1920 * 1080 * 4;
-const CLOSE_TIMEOUT_MS = 3e3;
 class RcFrame {
-  activeUses = 0;
-  closing = false;
+  closed = false;
   baseFrame;
   metadata;
-  onZero;
-  closePromise = null;
-  closeResolve = null;
-  constructor(frame, metadata, onZero) {
+  constructor(frame, metadata) {
     this.baseFrame = frame;
     this.metadata = metadata;
-    this.onZero = onZero;
   }
-  static wrap(frame, metadata, onZero) {
-    return new RcFrame(frame, metadata, onZero);
+  static wrap(frame, metadata) {
+    return new RcFrame(frame, metadata);
   }
   get timestampUs() {
     return this.metadata.timestampUs;
@@ -42,50 +36,26 @@ class RcFrame {
     }
     return DEFAULT_SIZE_ESTIMATE;
   }
-  async use(handler) {
-    if (this.closing) {
-      throw new Error("RcFrame is closing, cannot use frame");
-    }
-    const cloned = this.baseFrame.clone();
-    this.activeUses += 1;
-    try {
-      return await handler(cloned);
-    } finally {
-      cloned.close();
-      this.activeUses -= 1;
-      if (this.activeUses === 0 && this.closing && this.closeResolve) {
-        this.closeResolve();
-      }
+  /**
+   * Execute handler with direct access to the underlying VideoFrame
+   *
+   * CRITICAL: Handler MUST NOT call frame.close()
+   * The frame lifecycle is managed by RcFrame.close()
+   *
+   * This design avoids expensive clone() operations for real-time playback performance
+   */
+  use(handler) {
+    if (this.closed) {
+      throw new Error("RcFrame already closed");
     }
+    return handler(this.baseFrame);
   }
-  async close() {
-    if (this.closing) {
-      return this.closePromise ?? Promise.resolve();
-    }
-    this.closing = true;
-    if (this.activeUses === 0) {
-      this.baseFrame.close();
-      this.onZero?.();
-      return Promise.resolve();
-    }
-    if (!this.closePromise) {
-      this.closePromise = new Promise((resolve) => {
-        this.closeResolve = () => {
-          this.baseFrame.close();
-          this.onZero?.();
-          resolve();
-        };
-      });
-      setTimeout(() => {
-        if (this.closeResolve) {
-          this.baseFrame.close();
-          this.onZero?.();
-          this.closeResolve();
-          this.closeResolve = null;
-        }
-      }, CLOSE_TIMEOUT_MS).unref?.();
+  close() {
+    if (this.closed) {
+      return;
     }
-    return this.closePromise;
+    this.baseFrame.close();
+    this.closed = true;
   }
 }
 export {

package/dist/model/RcFrame.js.map

@@ -1 +1 @@
-{"version":3,"file":"RcFrame.js","sources":["../../src/model/RcFrame.ts"],"sourcesContent":["import type { TimeUs } from './types';\n\nexport interface RcFrameMetadata {\n  trackId: string;\n  clipId: string;\n  timestampUs: TimeUs;\n  durationUs: TimeUs;\n  sizeEstimate?: number;\n  globalTimeUs?: TimeUs; // Global composition timeline timestamp for window eviction\n}\n\nconst DEFAULT_SIZE_ESTIMATE = 1920 * 1080 * 4;\nconst CLOSE_TIMEOUT_MS = 3_000;\ntype UseHandler<T> = (frame: VideoFrame) => T | Promise<T>;\n\nexport class RcFrame {\n  private activeUses = 0;\n  private closing = false;\n  private readonly baseFrame: VideoFrame;\n  private readonly metadata: RcFrameMetadata;\n  private readonly onZero?: () => void;\n\n  private closePromise: Promise<void> | null = null;\n  private closeResolve: (() => void) | null = null;\n\n  private constructor(frame: VideoFrame, metadata: RcFrameMetadata, onZero?: () => void) {\n    this.baseFrame = frame;\n    this.metadata = metadata;\n    this.onZero = onZero;\n  }\n\n  static wrap(frame: VideoFrame, metadata: RcFrameMetadata, onZero?: () => void): RcFrame {\n    return new RcFrame(frame, metadata, onZero);\n  }\n\n  get timestampUs(): TimeUs {\n    return this.metadata.timestampUs;\n  }\n\n  get durationUs(): TimeUs {\n    return this.metadata.durationUs;\n  }\n\n  get trackId(): string {\n    return this.metadata.trackId;\n  }\n\n  get clipId(): string {\n    return this.metadata.clipId;\n  }\n\n  get globalTimeUs(): TimeUs | undefined {\n    return this.metadata.globalTimeUs;\n  }\n\n  get sizeEstimate(): number {\n    if (typeof this.metadata.sizeEstimate === 'number') {\n      return this.metadata.sizeEstimate;\n    }\n    const width = (this.baseFrame as any).codedWidth || (this.baseFrame as any).displayWidth;\n    const height = (this.baseFrame as any).codedHeight || (this.baseFrame as any).displayHeight;\n    if (width && height) {\n      return width * height * 4;\n    }\n    return DEFAULT_SIZE_ESTIMATE;\n  }\n\n  async use<T>(handler: UseHandler<T>): Promise<T> {\n    if (this.closing) {\n      throw new Error('RcFrame is closing, cannot use frame');\n    }\n\n    const cloned = this.baseFrame.clone();\n    this.activeUses += 1;\n\n    try {\n      return await handler(cloned);\n    } finally {\n      cloned.close();\n      this.activeUses -= 1;\n      if (this.activeUses === 0 && this.closing && this.closeResolve) {\n        this.closeResolve();\n      }\n    }\n  }\n\n  async close(): Promise<void> {\n    if (this.closing) {\n      return this.closePromise ?? Promise.resolve();\n    }\n\n    this.closing = true;\n\n    if (this.activeUses === 0) {\n      this.baseFrame.close();\n      this.onZero?.();\n      return Promise.resolve();\n    }\n\n    if (!this.closePromise) {\n      this.closePromise = new Promise<void>((resolve) => {\n        this.closeResolve = () => {\n          this.baseFrame.close();\n          this.onZero?.();\n          resolve();\n        };\n      });\n\n      setTimeout(() => {\n        if (this.closeResolve) {\n          this.baseFrame.close();\n          this.onZero?.();\n          this.closeResolve();\n          this.closeResolve = null;\n        }\n      }, CLOSE_TIMEOUT_MS).unref?.();\n    }\n\n    return this.closePromise;\n  }\n}\n"],"names":[],"mappings":"AAWA,MAAM,wBAAwB,OAAO,OAAO;AAC5C,MAAM,mBAAmB;AAGlB,MAAM,QAAQ;AAAA,EACX,aAAa;AAAA,EACb,UAAU;AAAA,EACD;AAAA,EACA;AAAA,EACA;AAAA,EAET,eAAqC;AAAA,EACrC,eAAoC;AAAA,EAEpC,YAAY,OAAmB,UAA2B,QAAqB;AACrF,SAAK,YAAY;AACjB,SAAK,WAAW;AAChB,SAAK,SAAS;AAAA,EAChB;AAAA,EAEA,OAAO,KAAK,OAAmB,UAA2B,QAA8B;AACtF,WAAO,IAAI,QAAQ,OAAO,UAAU,MAAM;AAAA,EAC5C;AAAA,EAEA,IAAI,cAAsB;AACxB,WAAO,KAAK,SAAS;AAAA,EACvB;AAAA,EAEA,IAAI,aAAqB;AACvB,WAAO,KAAK,SAAS;AAAA,EACvB;AAAA,EAEA,IAAI,UAAkB;AACpB,WAAO,KAAK,SAAS;AAAA,EACvB;AAAA,EAEA,IAAI,SAAiB;AACnB,WAAO,KAAK,SAAS;AAAA,EACvB;AAAA,EAEA,IAAI,eAAmC;AACrC,WAAO,KAAK,SAAS;AAAA,EACvB;AAAA,EAEA,IAAI,eAAuB;AACzB,QAAI,OAAO,KAAK,SAAS,iBAAiB,UAAU;AAClD,aAAO,KAAK,SAAS;AAAA,IACvB;AACA,UAAM,QAAS,KAAK,UAAkB,cAAe,KAAK,UAAkB;AAC5E,UAAM,SAAU,KAAK,UAAkB,eAAgB,KAAK,UAAkB;AAC9E,QAAI,SAAS,QAAQ;AACnB,aAAO,QAAQ,SAAS;AAAA,IAC1B;AACA,WAAO;AAAA,EACT;AAAA,EAEA,MAAM,IAAO,SAAoC;AAC/C,QAAI,KAAK,SAAS;AAChB,YAAM,IAAI,MAAM,sCAAsC;AAAA,IACxD;AAEA,UAAM,SAAS,KAAK,UAAU,MAAA;AAC9B,SAAK,cAAc;AAEnB,QAAI;AACF,aAAO,MAAM,QAAQ,MAAM;AAAA,IAC7B,UAAA;AACE,aAAO,MAAA;AACP,WAAK,cAAc;AACnB,UAAI,KAAK,eAAe,KAAK,KAAK,WAAW,KAAK,cAAc;AAC9D,aAAK,aAAA;AAAA,MACP;AAAA,IACF;AAAA,EACF;AAAA,EAEA,MAAM,QAAuB;AAC3B,QAAI,KAAK,SAAS;AAChB,aAAO,KAAK,gBAAgB,QAAQ,QAAA;AAAA,IACtC;AAEA,SAAK,UAAU;AAEf,QAAI,KAAK,eAAe,GAAG;AACzB,WAAK,UAAU,MAAA;AACf,WAAK,SAAA;AACL,aAAO,QAAQ,QAAA;AAAA,IACjB;AAEA,QAAI,CAAC,KAAK,cAAc;AACtB,WAAK,eAAe,IAAI,QAAc,CAAC,YAAY;AACjD,aAAK,eAAe,MAAM;AACxB,eAAK,UAAU,MAAA;AACf,eAAK,SAAA;AACL,kBAAA;AAAA,QACF;AAAA,MACF,CAAC;AAED,iBAAW,MAAM;AACf,YAAI,KAAK,cAAc;AACrB,eAAK,UAAU,MAAA;AACf,eAAK,SAAA;AACL,eAAK,aAAA;AACL,eAAK,eAAe;AAAA,QACtB;AAAA,MACF,GAAG,gBAAgB,EAAE,QAAA;AAAA,IACvB;AAEA,WAAO,KAAK;AAAA,EACd;AACF;"}
+{"version":3,"file":"RcFrame.js","sources":["../../src/model/RcFrame.ts"],"sourcesContent":["import type { TimeUs } from './types';\n\nexport interface RcFrameMetadata {\n  trackId: string;\n  clipId: string;\n  timestampUs: TimeUs;\n  durationUs: TimeUs;\n  sizeEstimate?: number;\n  globalTimeUs?: TimeUs; // Global composition timeline timestamp for window eviction\n}\n\nconst DEFAULT_SIZE_ESTIMATE = 1920 * 1080 * 4;\ntype UseHandler<T> = (frame: VideoFrame) => T;\n\n/**\n * RcFrame - Lightweight VideoFrame wrapper with metadata\n *\n * Design:\n * - Carries metadata (timestamp, clipId, trackId, size) for cache management\n * - Provides unified .use() interface for accessing the frame\n * - Direct frame access (no clone) for optimal performance\n * - Manages frame lifecycle with simple .close() wrapper\n *\n * IMPORTANT: Handler MUST NOT call frame.close() - lifecycle is managed by RcFrame\n */\nexport class RcFrame {\n  private closed = false;\n  private readonly baseFrame: VideoFrame;\n  private readonly metadata: RcFrameMetadata;\n\n  private constructor(frame: VideoFrame, metadata: RcFrameMetadata) {\n    this.baseFrame = frame;\n    this.metadata = metadata;\n  }\n\n  static wrap(frame: VideoFrame, metadata: RcFrameMetadata): RcFrame {\n    return new RcFrame(frame, metadata);\n  }\n\n  get timestampUs(): TimeUs {\n    return this.metadata.timestampUs;\n  }\n\n  get durationUs(): TimeUs {\n    return this.metadata.durationUs;\n  }\n\n  get trackId(): string {\n    return this.metadata.trackId;\n  }\n\n  get clipId(): string {\n    return this.metadata.clipId;\n  }\n\n  get globalTimeUs(): TimeUs | undefined {\n    return this.metadata.globalTimeUs;\n  }\n\n  get sizeEstimate(): number {\n    if (typeof this.metadata.sizeEstimate === 'number') {\n      return this.metadata.sizeEstimate;\n    }\n    const width = (this.baseFrame as any).codedWidth || (this.baseFrame as any).displayWidth;\n    const height = (this.baseFrame as any).codedHeight || (this.baseFrame as any).displayHeight;\n    if (width && height) {\n      return width * height * 4;\n    }\n    return DEFAULT_SIZE_ESTIMATE;\n  }\n\n  /**\n   * Execute handler with direct access to the underlying VideoFrame\n   *\n   * CRITICAL: Handler MUST NOT call frame.close()\n   * The frame lifecycle is managed by RcFrame.close()\n   *\n   * This design avoids expensive clone() operations for real-time playback performance\n   */\n  use<T>(handler: UseHandler<T>): T {\n    if (this.closed) {\n      throw new Error('RcFrame already closed');\n    }\n    return handler(this.baseFrame);\n  }\n\n  close(): void {\n    if (this.closed) {\n      return;\n    }\n    this.baseFrame.close();\n    this.closed = true;\n  }\n}\n"],"names":[],"mappings":"AAWA,MAAM,wBAAwB,OAAO,OAAO;AAcrC,MAAM,QAAQ;AAAA,EACX,SAAS;AAAA,EACA;AAAA,EACA;AAAA,EAET,YAAY,OAAmB,UAA2B;AAChE,SAAK,YAAY;AACjB,SAAK,WAAW;AAAA,EAClB;AAAA,EAEA,OAAO,KAAK,OAAmB,UAAoC;AACjE,WAAO,IAAI,QAAQ,OAAO,QAAQ;AAAA,EACpC;AAAA,EAEA,IAAI,cAAsB;AACxB,WAAO,KAAK,SAAS;AAAA,EACvB;AAAA,EAEA,IAAI,aAAqB;AACvB,WAAO,KAAK,SAAS;AAAA,EACvB;AAAA,EAEA,IAAI,UAAkB;AACpB,WAAO,KAAK,SAAS;AAAA,EACvB;AAAA,EAEA,IAAI,SAAiB;AACnB,WAAO,KAAK,SAAS;AAAA,EACvB;AAAA,EAEA,IAAI,eAAmC;AACrC,WAAO,KAAK,SAAS;AAAA,EACvB;AAAA,EAEA,IAAI,eAAuB;AACzB,QAAI,OAAO,KAAK,SAAS,iBAAiB,UAAU;AAClD,aAAO,KAAK,SAAS;AAAA,IACvB;AACA,UAAM,QAAS,KAAK,UAAkB,cAAe,KAAK,UAAkB;AAC5E,UAAM,SAAU,KAAK,UAAkB,eAAgB,KAAK,UAAkB;AAC9E,QAAI,SAAS,QAAQ;AACnB,aAAO,QAAQ,SAAS;AAAA,IAC1B;AACA,WAAO;AAAA,EACT;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAUA,IAAO,SAA2B;AAChC,QAAI,KAAK,QAAQ;AACf,YAAM,IAAI,MAAM,wBAAwB;AAAA,IAC1C;AACA,WAAO,QAAQ,KAAK,SAAS;AAAA,EAC/B;AAAA,EAEA,QAAc;AACZ,QAAI,KAAK,QAAQ;AACf;AAAA,IACF;AACA,SAAK,UAAU,MAAA;AACf,SAAK,SAAS;AAAA,EAChB;AACF;"}

package/dist/orchestrator/GlobalAudioSession.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"GlobalAudioSession.d.ts","sourceRoot":"","sources":["../../src/orchestrator/GlobalAudioSession.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"GlobalAudioSession.d.ts","sourceRoot":"","sources":["../../src/orchestrator/GlobalAudioSession.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAE7C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AACjD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AACpE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAEvD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAK1D,UAAU,gBAAgB;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,SAAS,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,UAAU,gBAAgB;IACxB,YAAY,EAAE,YAAY,CAAC;IAC3B,UAAU,EAAE,UAAU,CAAC;IACvB,cAAc,EAAE,cAAc,CAAC;IAC/B,QAAQ,EAAE,QAAQ,CAAC,eAAe,CAAC,CAAC;IACpC,kBAAkB,EAAE,MAAM,GAAG,CAAC;CAC/B;AAED,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,KAAK,CAAoB;IACjC,OAAO,CAAC,WAAW,CAAqB;IACxC,OAAO,CAAC,IAAI,CAAmB;IAC/B,OAAO,CAAC,KAAK,CAAiC;IAC9C,OAAO,CAAC,YAAY,CAA6B;IACjD,OAAO,CAAC,MAAM,CAAO;IACrB,OAAO,CAAC,YAAY,CAAO;IAC3B,OAAO,CAAC,SAAS,CAAS;IAG1B,OAAO,CAAC,gBAAgB,CAAK;IAC7B,OAAO,CAAC,iBAAiB,CAAK;IAC9B,OAAO,CAAC,gBAAgB,CAAoC;IAC5D,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAO;IACtC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAO;gBAE1B,IAAI,EAAE,gBAAgB;IAKlC,QAAQ,CAAC,KAAK,EAAE,gBAAgB,GAAG,IAAI;IAIvC,WAAW,CAAC,OAAO,EAAE,gBAAgB,GAAG,IAAI;IAMtC,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAUpF,qBAAqB,IAAI,OAAO,CAAC,IAAI,CAAC;IA6CtC,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAS7C,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAgB9E,YAAY,IAAI,IAAI;IAKpB,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAIjC;;;OAGG;IACG,aAAa,CAAC,iBAAiB,EAAE,MAAM,EAAE,YAAY,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAsGzF;;OAEG;IACH,mBAAmB,IAAI,IAAI;IAM3B,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAO/B,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAOnC,KAAK,IAAI,IAAI;IAMb;;OAEG;IACG,mBAAmB,CACvB,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,CAAC,KAAK,EAAE,iBAAiB,EAAE,QAAQ,CAAC,EAAE,yBAAyB,KAAK,IAAI,GAChF,OAAO,CAAC,IAAI,CAAC;IAyBhB;;;OAGG;YACW,qBAAqB;IAKnC,OAAO,CAAC,aAAa,CAAkC;IACvD,OAAO,CAAC,mBAAmB,CAGX;IAChB,OAAO,CAAC,mBAAmB,CAAuD;YAEpE,wBAAwB;IAkBhC,mBAAmB,IAAI,OAAO,CAAC,IAAI,CAAC;IAS1C,OAAO,CAAC,mBAAmB;IAc3B;;;OAGG;YACW,uBAAuB;IAyDrC;;;;;;;OAOG;IACG,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAStF;;;OAGG;YACW,iBAAiB;IA4C/B;;;;OAIG;YACW,kBAAkB;IAsEhC,OAAO,CAAC,sBAAsB;IAoB9B,OAAO,CAAC,oBAAoB;CAe7B"}

package/dist/orchestrator/GlobalAudioSession.js

@@ -107,6 +107,16 @@ class GlobalAudioSession {
       this.nextContentTimeUs = currentTimelineUs;
     }
     while (this.nextScheduleTime < lookaheadTime) {
+      if (this.nextScheduleTime < audioContext.currentTime) {
+        const timeDrift = audioContext.currentTime - this.nextScheduleTime;
+        if (timeDrift > 0.02) {
+          this.nextScheduleTime = audioContext.currentTime + 0.02;
+          const skippedUs = Math.round(timeDrift * 1e6);
+          this.nextContentTimeUs += skippedUs;
+        } else {
+          this.nextScheduleTime = audioContext.currentTime + 0.01;
+        }
+      }
       const chunkDurationUs = Math.round(this.CHUNK_DURATION * 1e6);
       const startUs = this.nextContentTimeUs;
       const endUs = startUs + chunkDurationUs;
@@ -119,6 +129,18 @@ class GlobalAudioSession {
           loadResource: true
         });
         const mixedBuffer = await this.mixer.mix(startUs, endUs);
+        if (this.nextScheduleTime < audioContext.currentTime) {
+          const timeDrift = audioContext.currentTime - this.nextScheduleTime;
+          if (timeDrift > 0.02) {
+            console.warn(
+              `[Audio] Skip chunk due to time drift: ${(timeDrift * 1e3).toFixed(1)}ms`
+            );
+            this.nextScheduleTime = audioContext.currentTime + 0.02;
+            this.nextContentTimeUs += chunkDurationUs;
+            continue;
+          }
+          this.nextScheduleTime = audioContext.currentTime + 0.01;
+        }
         const source = audioContext.createBufferSource();
         source.buffer = mixedBuffer;
         source.playbackRate.value = this.playbackRate;
@@ -216,8 +238,8 @@ class GlobalAudioSession {
   stopAllAudioSources() {
     for (const source of this.scheduledSources) {
       try {
-        source.stop();
         source.disconnect();
+        source.stop(0);
       } catch {
       }
     }