@meframe/core 0.3.0 → 0.3.2

package/dist/controllers/PlaybackController.d.ts

@@ -29,6 +29,7 @@ export declare class PlaybackController implements IPlaybackController, PreviewH
     private seekFlushRafId;
     private seekInFlight;
     private readonly SEEK_CANCEL_DISTANCE_US;
+    private isSeekActive;
     private windowEnd;
     private readonly WINDOW_DURATION;
     private readonly PREHEAT_DISTANCE;

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

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

package/dist/controllers/PlaybackController.js

@@ -1,4 +1,4 @@
-import { PlaybackActionType, PlaybackState, PlaybackCommandType } from "./types.js";
+import { PlaybackState, PlaybackActionType, PlaybackCommandType } from "./types.js";
 import { MeframeEvent } from "../event/events.js";
 import { WaiterReplacedError, MP4MoovNotFoundError } from "../utils/errors.js";
 import { VideoComposer } from "../stages/compose/VideoComposer.js";
@@ -37,8 +37,11 @@ class PlaybackController {
   seekFlushRafId = null;
   seekInFlight = null;
   // If user drags far away while a seek is decoding, cancel it to avoid visible lag.
-  SEEK_CANCEL_DISTANCE_US = 5e5;
-  // 500ms
+  SEEK_CANCEL_DISTANCE_US = 5e6;
+  // 5s
+  isSeekActive() {
+    return this.pendingSeekTimeUs !== null || this.seekInFlight !== null || this.fsm.snapshot.state === PlaybackState.Seeking;
+  }
   // Unified window management for both video and audio
   windowEnd = 0;
   WINDOW_DURATION = 3e6;
@@ -131,7 +134,8 @@ class PlaybackController {
       if (this.seekInFlight?.targetUs === target) {
         this.seekInFlight = null;
       }
-      if (this.pendingSeekTimeUs === null && !this.orchestrator.cacheManager.isExporting) {
+      const shouldPreheatAfterSeek = this.pendingSeekTimeUs === null && !this.orchestrator.cacheManager.isExporting && this.fsm.snapshot.state === PlaybackState.Playing;
+      if (shouldPreheatAfterSeek) {
         void this.preheatNextWindow();
       }
       if (this.pendingSeekTimeUs !== null && this.seekFlushRafId === null) {
@@ -368,6 +372,9 @@ class PlaybackController {
       }
       case PlaybackCommandType.StartRafLoop: {
         this.startPlaybackLoop(token);
+        if (!this.orchestrator.cacheManager.isExporting && this.fsm.snapshot.state === PlaybackState.Playing) {
+          void this.preheatNextWindow();
+        }
         return;
       }
     }
@@ -458,26 +465,24 @@ class PlaybackController {
     this.orchestrator.cacheManager.setWindow(timeUs);
   }
   checkAndPreheatWindow() {
-    if (this.orchestrator.cacheManager.isExporting) {
-      return;
-    }
-    if (this.preheatInProgress || this.fsm.snapshot.state !== PlaybackState.Playing) {
-      return;
-    }
+    const isExporting = this.orchestrator.cacheManager.isExporting;
+    const isPreheatBusy = this.preheatInProgress;
+    const isPlaying = this.fsm.snapshot.state === PlaybackState.Playing;
     const distanceToWindowEnd = this.windowEnd - this.currentTimeUs;
     if (distanceToWindowEnd < 0) {
       this.initWindow(this.currentTimeUs);
       return;
     }
-    if (distanceToWindowEnd > 0 && distanceToWindowEnd <= this.PREHEAT_DISTANCE) {
-      void this.preheatNextWindow();
-    }
+    const isWithinPreheatDistance = distanceToWindowEnd > 0 && distanceToWindowEnd <= this.PREHEAT_DISTANCE;
+    const shouldSkipPreheat = isExporting || isPreheatBusy || !isPlaying || !isWithinPreheatDistance || this.isSeekActive();
+    if (shouldSkipPreheat) return;
+    void this.preheatNextWindow();
   }
   async preheatNextWindow() {
-    if (this.orchestrator.cacheManager.isExporting) {
-      return;
-    }
-    if (this.preheatInProgress) return;
+    const isExporting = this.orchestrator.cacheManager.isExporting;
+    const isPreheatBusy = this.preheatInProgress;
+    const shouldSkipPreheat = isExporting || isPreheatBusy || this.isSeekActive();
+    if (shouldSkipPreheat) return;
     this.preheatInProgress = true;
     try {
       const windowStart = this.currentTimeUs;

package/dist/controllers/PlaybackController.js.map

@@ -1 +1 @@
-{"version":3,"file":"PlaybackController.js","sources":["../../src/controllers/PlaybackController.ts"],"sourcesContent":["import type {\n  IPlaybackController,\n  PlaybackOptions,\n  IEventBus,\n  PreviewHandle,\n  TimeUs,\n} from './types';\nimport {\n  PlaybackActionType,\n  PlaybackCommandType,\n  PlaybackState,\n  type OpToken,\n  type PlaybackAction,\n  type PlaybackCommand,\n} from './types';\nimport { MeframeEvent } from '../event/events';\nimport type { Orchestrator } from '../orchestrator';\nimport type { RequestMode } from '../orchestrator/types';\nimport { MP4MoovNotFoundError, WaiterReplacedError } from '../utils/errors';\nimport { VideoComposer } from '../stages/compose/VideoComposer';\nimport { isVideoClip } from '../model/types';\nimport type { AudioPreviewSession } from '../orchestrator/AudioPreviewSession';\n\nimport { PlaybackStateMachine } from './PlaybackStateMachine';\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 time (external)\n  currentTimeUs: TimeUs = 0;\n  private playbackRate = 1.0;\n  private volume = 1.0;\n  private loop = false;\n\n  // Time base\n  private rafId: number | null = null;\n  private startTimeUs: TimeUs = 0; // AudioContext timeline origin (microseconds)\n\n  // Frame stats\n  private frameCount = 0;\n  private lastFrameTime = 0;\n  private fps = 0;\n\n  // Audio\n  private audioContext: AudioContext;\n  private audioSession: AudioPreviewSession;\n  private lastAudioScheduleTime = 0;\n  private readonly AUDIO_SCHEDULE_INTERVAL = 250_000; // 250ms\n\n  // State machine\n  private fsm = new PlaybackStateMachine();\n\n  // Coalesced seek (scrubbing): latest-wins, flush at most once per rAF.\n  // UI is fire-and-forget; this avoids spawning/canceling on-demand decoders too aggressively.\n  private pendingSeekTimeUs: TimeUs | null = null;\n  private pendingSeekWaiters: Array<() => void> = [];\n  private seekFlushRafId: number | null = null;\n  private seekInFlight: { targetUs: TimeUs; done: Promise<void> } | null = null;\n  // If user drags far away while a seek is decoding, cancel it to avoid visible lag.\n  private readonly SEEK_CANCEL_DISTANCE_US: TimeUs = 500_000; // 500ms\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.audio.preview;\n    this.eventBus = eventBus;\n    this.canvas = options.canvas;\n    this.audioContext = new AudioContext();\n\n    const model = orchestrator.compositionModel;\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    if (options.startUs !== undefined) {\n      this.currentTimeUs = options.startUs;\n    }\n    if (options.rate !== undefined) {\n      this.playbackRate = options.rate;\n    }\n    if (options.loop !== undefined) {\n      this.loop = options.loop;\n    }\n\n    this.setupEventListeners();\n\n    if (options.autoStart) {\n      this.play();\n    }\n  }\n\n  async renderCover(): Promise<void> {\n    await this.renderCurrentFrame(0, { mode: 'blocking' });\n  }\n\n  // ========= Public API =========\n\n  play(): void {\n    this.dispatch({ type: PlaybackActionType.Play });\n  }\n\n  pause(): void {\n    this.dispatch({ type: PlaybackActionType.Pause });\n  }\n\n  stop(): void {\n    this.dispatch({ type: PlaybackActionType.Stop });\n  }\n\n  async seek(timeUs: TimeUs): Promise<void> {\n    this.pendingSeekTimeUs = timeUs;\n\n    const done = new Promise<void>((resolve) => {\n      this.pendingSeekWaiters.push(resolve);\n    });\n\n    if (this.seekFlushRafId === null) {\n      this.seekFlushRafId = requestAnimationFrame(() => {\n        this.seekFlushRafId = null;\n        void this.flushCoalescedSeek();\n      });\n    }\n\n    // Fire-and-forget in typical UI, but keep await semantics:\n    // resolve only after the seek that includes this request has completed.\n    await done;\n  }\n\n  private async flushCoalescedSeek(): Promise<void> {\n    const target = this.pendingSeekTimeUs;\n    if (target === null) {\n      const waiters = this.pendingSeekWaiters;\n      this.pendingSeekWaiters = [];\n      for (const resolve of waiters) resolve();\n      return;\n    }\n\n    // If a seek is in flight, prefer letting it complete to keep scrubbing continuous.\n    // But if the user jumps far enough, cancel the in-flight seek to reduce lag.\n    if (this.seekInFlight) {\n      const distance = Math.abs(target - this.seekInFlight.targetUs);\n      if (distance <= this.SEEK_CANCEL_DISTANCE_US) {\n        // Keep latest pending and wait for in-flight completion.\n        return;\n      }\n      // Far jump: cancel by starting a new seek (token bump cancels old chain at await boundaries).\n      this.seekInFlight = null;\n    }\n\n    // Start a seek for the latest target and clear pending.\n    this.pendingSeekTimeUs = null;\n    const { done } = this.dispatch({\n      type: PlaybackActionType.Seek,\n      timeUs: target,\n      durationUs: this.duration,\n    });\n\n    this.seekInFlight = { targetUs: target, done };\n\n    void done.finally(() => {\n      // Resolve awaiters after the seek finishes (tests and some callers rely on this).\n      const waiters = this.pendingSeekWaiters;\n      this.pendingSeekWaiters = [];\n      for (const resolve of waiters) resolve();\n\n      // Only clear if this in-flight is still the same one.\n      if (this.seekInFlight?.targetUs === target) {\n        this.seekInFlight = null;\n      }\n\n      // If we are continuing playback after a seek, proactively preheat the upcoming window.\n      // Otherwise playback can \"stick\" on the seek frame until the normal preheat threshold is reached.\n      if (this.pendingSeekTimeUs === null && !this.orchestrator.cacheManager.isExporting) {\n        void this.preheatNextWindow();\n      }\n\n      // If new seek came in while we were decoding, flush again next frame.\n      if (this.pendingSeekTimeUs !== null && this.seekFlushRafId === null) {\n        this.seekFlushRafId = requestAnimationFrame(() => {\n          this.seekFlushRafId = null;\n          void this.flushCoalescedSeek();\n        });\n      }\n    });\n  }\n\n  setRate(rate: number): void {\n    const currentTimeUs = this.currentTimeUs;\n    this.playbackRate = rate;\n\n    // Keep currentTimeUs stable; update the time base for AudioContext clock mapping.\n    this.startTimeUs = this.audioContext.currentTime * 1_000_000 - currentTimeUs / rate;\n    this.audioSession.setPlaybackRate(this.playbackRate);\n\n    this.eventBus.emit(MeframeEvent.PlaybackRateChange, { rate });\n  }\n\n  setVolume(volume: number): void {\n    this.volume = Math.max(0, Math.min(1, volume));\n    this.audioSession.setVolume(this.volume);\n    this.eventBus.emit(MeframeEvent.PlaybackVolumeChange, { volume: this.volume });\n  }\n\n  setMute(muted: boolean): void {\n    if (muted) {\n      this.audioSession.stopPlayback();\n      return;\n    }\n    if (this.fsm.snapshot.state === PlaybackState.Playing) {\n      void 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    return this.orchestrator.compositionModel?.durationUs ?? 0;\n  }\n\n  get isPlaying(): boolean {\n    return this.fsm.snapshot.state === PlaybackState.Playing;\n  }\n\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  // ========= State machine wiring =========\n\n  private dispatch(action: PlaybackAction): { token: OpToken; done: Promise<void> } {\n    const { token, commands } = this.fsm.dispatch(action, { currentTimeUs: this.currentTimeUs });\n    const done = this.executeCommands(commands, token);\n    return { token, done };\n  }\n\n  private executeCommands(commands: PlaybackCommand[], token: OpToken): Promise<void> {\n    const maybe = this.executeSeq(commands, token, 0);\n    return maybe ?? Promise.resolve();\n  }\n\n  private executeSeq(\n    commands: PlaybackCommand[],\n    token: OpToken,\n    startIndex: number\n  ): Promise<void> | void {\n    for (let i = startIndex; i < commands.length; i++) {\n      if (!this.isCurrentToken(token)) return;\n      const maybe = this.executeCommand(commands[i]!, token);\n      if (maybe) {\n        return maybe.then(() => {\n          if (!this.isCurrentToken(token)) return;\n          const cont = this.executeSeq(commands, token, i + 1);\n          return cont ?? Promise.resolve();\n        });\n      }\n    }\n  }\n\n  private executePar(commands: PlaybackCommand[], token: OpToken): Promise<any> | void {\n    const promises: Promise<void>[] = [];\n    for (const c of commands) {\n      if (!this.isCurrentToken(token)) return;\n      const maybe = this.executeCommand(c, token);\n      if (maybe) promises.push(maybe);\n    }\n    if (promises.length === 0) return;\n    return Promise.all(promises);\n  }\n\n  private executeCommand(command: PlaybackCommand, token: OpToken): Promise<any> | void {\n    if (!this.isCurrentToken(token)) return;\n\n    switch (command.type) {\n      case PlaybackCommandType.Seq:\n        return this.executeSeq(command.commands, token, 0);\n      case PlaybackCommandType.Par:\n        return this.executePar(command.commands, token);\n      case PlaybackCommandType.Try: {\n        const handleError = (error: unknown): Promise<void> | void => {\n          if (!this.isCurrentToken(token)) return;\n          if (command.ignoreWaiterReplacedError && error instanceof WaiterReplacedError) return;\n          if (command.logPrefix) console.error(command.logPrefix, error);\n          const onErrorDone = command.onError ? this.dispatch(command.onError).done : undefined;\n          const normalizeError = (e: unknown): Error => {\n            if (e instanceof Error) return e;\n            return new Error(typeof e === 'string' ? e : JSON.stringify(e));\n          };\n          const emit = () => {\n            if (command.emitPlaybackError) {\n              const err = normalizeError(error);\n              const recoverable =\n                // Waiter replaced is expected during rapid seek; safe to ignore.\n                err instanceof WaiterReplacedError ||\n                // Missing moov may be caused by incomplete/corrupted cache and can be retried via recovery.\n                err instanceof MP4MoovNotFoundError;\n              // PlaybackError: direct playback channel error for advanced consumers.\n              this.eventBus.emit(MeframeEvent.PlaybackError, err);\n              // Error: generic error channel expected by higher-level wrappers (e.g. @meframe/axii).\n              this.eventBus.emit(MeframeEvent.Error, {\n                source: 'playback',\n                error: err,\n                context: {\n                  command: command.logPrefix,\n                  onError: command.onError?.type,\n                },\n                recoverable,\n              });\n            }\n          };\n          if (onErrorDone) {\n            return onErrorDone.then(() => {\n              emit();\n            });\n          }\n          emit();\n        };\n\n        try {\n          const maybe = this.executeCommand(command.command, token);\n          if (maybe) {\n            return maybe.catch(handleError);\n          }\n          return;\n        } catch (error) {\n          return handleError(error) ?? Promise.resolve();\n        }\n      }\n      case PlaybackCommandType.Dispatch:\n        return this.dispatch(command.action).done;\n      case PlaybackCommandType.SetTime: {\n        this.currentTimeUs = command.timeUs;\n        return;\n      }\n      case PlaybackCommandType.SetFrozenTime:\n      case PlaybackCommandType.SetWantsPlay:\n      case PlaybackCommandType.SetState: {\n        // managed inside fsm\n        return;\n      }\n      case PlaybackCommandType.CancelRaf: {\n        this.cancelRaf();\n        return;\n      }\n      case PlaybackCommandType.StopAudio: {\n        this.audioSession.stopPlayback();\n        return;\n      }\n      case PlaybackCommandType.ResetAudioPlaybackStates: {\n        this.audioSession.resetPlaybackStates();\n        return;\n      }\n      case PlaybackCommandType.ResetAudioSession: {\n        this.audioSession.reset();\n        return;\n      }\n      case PlaybackCommandType.ClearCanvas: {\n        this.clearCanvas();\n        return;\n      }\n      case PlaybackCommandType.SetLastAudioScheduleTime: {\n        this.lastAudioScheduleTime = command.timeUs;\n        return;\n      }\n      case PlaybackCommandType.SetStartTimeBase: {\n        this.startTimeUs = command.startTimeUs;\n        return;\n      }\n      case PlaybackCommandType.SyncTimeBaseToAudioClock: {\n        this.startTimeUs =\n          this.audioContext.currentTime * 1_000_000 - command.timeUs / this.playbackRate;\n        return;\n      }\n      case PlaybackCommandType.InitWindow: {\n        this.initWindow(command.timeUs);\n        return;\n      }\n      case PlaybackCommandType.SetCacheWindow: {\n        this.orchestrator.cacheManager.setWindow(command.timeUs);\n        return;\n      }\n      case PlaybackCommandType.Emit: {\n        if (command.payload === undefined) {\n          this.eventBus.emit(command.event as any);\n        } else {\n          this.eventBus.emit(command.event as any, command.payload);\n        }\n        return;\n      }\n      case PlaybackCommandType.RenderFrame: {\n        return this.renderCurrentFrame(command.timeUs, {\n          mode: command.mode,\n          relativeTimeUs: command.relativeTimeUs,\n        });\n      }\n      case PlaybackCommandType.EnsureAudio: {\n        return this.audioSession.ensureAudioForTime(command.timeUs, {\n          mode: command.mode,\n        });\n      }\n      case PlaybackCommandType.GetFrame: {\n        return this.orchestrator.getFrame(command.timeUs, {\n          mode: command.mode,\n          preheat: command.preheat,\n          scrub: command.scrub,\n        });\n      }\n      case PlaybackCommandType.StartAudioPlayback: {\n        return this.audioSession.startPlayback(command.timeUs, this.audioContext);\n      }\n      case PlaybackCommandType.ProbeStartReady: {\n        const audioReady = this.audioSession.isPreviewMixBlockCached(command.timeUs);\n        const videoReady = this.isVideoResourceReadyAtTime(command.timeUs);\n\n        if (audioReady && videoReady) return;\n\n        // Kick background preparation (best-effort).\n        if (!audioReady) {\n          void this.audioSession.ensureAudioForTime(command.timeUs, { mode: 'probe' });\n        }\n        if (!videoReady) {\n          void this.orchestrator.getFrame(command.timeUs, { mode: 'probe' });\n        }\n\n        // Enter buffering and bump token to cancel the remaining start sequence.\n        this.dispatch({\n          type: PlaybackActionType.EnterBuffering,\n          timeUs: command.timeUs,\n          bumpToken: true,\n          reason: 'startup',\n        });\n        return;\n      }\n      case PlaybackCommandType.StartRafLoop: {\n        this.startPlaybackLoop(token);\n        return;\n      }\n    }\n  }\n\n  private cancelRaf(): void {\n    if (this.rafId !== null) {\n      cancelAnimationFrame(this.rafId);\n      this.rafId = null;\n    }\n  }\n\n  private isCurrentToken(token: OpToken): boolean {\n    return token === this.fsm.snapshot.token;\n  }\n\n  private startPlaybackLoop(token: OpToken): void {\n    this.rafId = requestAnimationFrame(() => {\n      void this.onRafTick(token);\n    });\n  }\n\n  private async onRafTick(token: OpToken): Promise<void> {\n    if (!this.isCurrentToken(token) || this.fsm.snapshot.state !== PlaybackState.Playing) {\n      return;\n    }\n\n    const candidateTimeUs =\n      (this.audioContext.currentTime * 1_000_000 - this.startTimeUs) * this.playbackRate;\n    this.dispatch({\n      type: PlaybackActionType.ClockTick,\n      candidateTimeUs,\n      durationUs: this.duration,\n      loop: this.loop,\n      audioNowUs: this.audioContext.currentTime * 1_000_000,\n    });\n\n    if (!this.isCurrentToken(token) || this.fsm.snapshot.state !== PlaybackState.Playing) {\n      return;\n    }\n\n    // Audio probe: if the audio window isn't ready, enter buffering (freeze timeline)\n    // and kick background audio preparation.\n    // Note: preview audio readiness is driven by 60s mix-block cache inside AudioPreviewSession.\n    // We intentionally avoid additional resource-window probing here to prevent buffering oscillation.\n\n    // Throttle audio scheduling.\n    if (this.currentTimeUs - this.lastAudioScheduleTime >= this.AUDIO_SCHEDULE_INTERVAL) {\n      // Fire-and-forget: AudioPreviewSession runs its own background scheduling loop.\n      // We avoid awaiting here to keep the render loop responsive.\n      void this.audioSession.scheduleAudio(this.currentTimeUs, this.audioContext);\n      this.lastAudioScheduleTime = this.currentTimeUs;\n    }\n\n    // If we're close to the 60s block boundary and the next mixed block isn't ready yet,\n    // enter buffering to avoid hard silence at the boundary.\n    if (this.audioSession.shouldEnterBufferingForUpcomingPreviewAudio(this.currentTimeUs)) {\n      // Best-effort preheat; buffering path will call EnsureAudio(blocking).\n      void this.audioSession.ensureAudioForTime(this.currentTimeUs, { mode: 'probe' });\n      this.dispatch({\n        type: PlaybackActionType.EnterBuffering,\n        timeUs: this.currentTimeUs,\n        reason: 'audio',\n      });\n      return;\n    }\n\n    const renderState = await this.orchestrator.getRenderState(this.currentTimeUs, {\n      mode: 'probe',\n    });\n    if (!this.isCurrentToken(token) || this.fsm.snapshot.state !== PlaybackState.Playing) {\n      return;\n    }\n\n    if (!renderState) {\n      // If the current clip's resource is in a terminal error state, buffering will oscillate\n      // (probe keeps returning null, buffering resolves quickly, then repeats). In this case,\n      // keep playing and present an empty frame instead.\n      if (this.isTerminalVideoErrorAtTime(this.currentTimeUs)) {\n        this.clearCanvas();\n        this.finalizeFrameAndContinue(token);\n        return;\n      }\n\n      this.dispatch({ type: PlaybackActionType.EnterBuffering, timeUs: this.currentTimeUs });\n      return;\n    }\n\n    await this.compose(this.currentTimeUs, renderState);\n    if (!this.isCurrentToken(token) || this.fsm.snapshot.state !== PlaybackState.Playing) return;\n\n    this.finalizeFrameAndContinue(token);\n  }\n\n  private finalizeFrameAndContinue(token: OpToken): void {\n    this.updateFps();\n    this.frameCount++;\n\n    // Unified cache window update.\n    this.orchestrator.cacheManager.setWindow(this.currentTimeUs);\n    this.checkAndPreheatWindow();\n\n    if (!this.isCurrentToken(token) || this.fsm.snapshot.state !== PlaybackState.Playing) {\n      return;\n    }\n\n    this.startPlaybackLoop(token);\n  }\n\n  private updateFps(): void {\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\n  private initWindow(timeUs: TimeUs): void {\n    this.windowEnd = timeUs + this.WINDOW_DURATION;\n    this.preheatInProgress = false;\n    this.orchestrator.cacheManager.setWindow(timeUs);\n  }\n\n  private checkAndPreheatWindow(): void {\n    // Export uses main-thread decode + heavy OPFS IO; disable preview preheat to avoid contention.\n    if (this.orchestrator.cacheManager.isExporting) {\n      return;\n    }\n    if (this.preheatInProgress || this.fsm.snapshot.state !== PlaybackState.Playing) {\n      return;\n    }\n\n    const distanceToWindowEnd = this.windowEnd - this.currentTimeUs;\n    if (distanceToWindowEnd < 0) {\n      this.initWindow(this.currentTimeUs);\n      return;\n    }\n\n    if (distanceToWindowEnd > 0 && distanceToWindowEnd <= this.PREHEAT_DISTANCE) {\n      void this.preheatNextWindow();\n    }\n  }\n\n  async preheatNextWindow(): Promise<void> {\n    // Export uses main-thread decode + heavy OPFS IO; disable preview preheat to avoid contention.\n    if (this.orchestrator.cacheManager.isExporting) {\n      return;\n    }\n    if (this.preheatInProgress) return;\n\n    this.preheatInProgress = true;\n    try {\n      const windowStart = this.currentTimeUs;\n      const windowEnd = windowStart + this.WINDOW_DURATION;\n\n      const clipsInWindow =\n        this.orchestrator.compositionModel?.getClipsInRange(windowStart, windowEnd) ?? [];\n      const preheatPromises: Promise<any>[] = [];\n\n      for (const clip of clipsInWindow) {\n        if (!isVideoClip(clip)) continue;\n\n        const clipWindowStart = Math.max(0, windowStart - clip.startUs);\n        const clipWindowEnd = Math.min(clip.durationUs, windowEnd - clip.startUs);\n        if (clipWindowStart >= clipWindowEnd) continue;\n\n        preheatPromises.push(\n          this.orchestrator.preheatClipWindow(clip.id, clipWindowStart, clipWindowEnd, windowStart)\n        );\n      }\n\n      // Audio preheat is handled inside AudioPreviewSession via mix-block scheduling & cache.\n\n      await Promise.all(preheatPromises);\n      this.windowEnd = windowEnd;\n    } catch (error) {\n      console.warn('[PlaybackController] Preheat failed:', error);\n    } finally {\n      this.preheatInProgress = false;\n    }\n  }\n\n  private async renderCurrentFrame(\n    timeUs: TimeUs,\n    options: { mode: RequestMode; relativeTimeUs?: TimeUs }\n  ): Promise<void> {\n    if (!this.videoComposer) {\n      console.error('[PlaybackController] VideoComposer not initialized');\n      return;\n    }\n\n    const renderState = await this.orchestrator.getRenderState(timeUs, {\n      mode: options.mode,\n      relativeTimeUs: options.relativeTimeUs,\n    });\n\n    if (!renderState) {\n      // No render state (e.g. missing clip, resource error, or probe returned null).\n      // Present an empty frame instead of freezing the last canvas content.\n      this.clearCanvas();\n      return;\n    }\n\n    await this.compose(timeUs, renderState);\n  }\n\n  private async compose(\n    timeUs: TimeUs,\n    renderState: { layers: any[]; transition?: any }\n  ): Promise<void> {\n    if (!this.videoComposer) return;\n    await this.videoComposer.composeFrame({\n      timeUs,\n      layers: renderState.layers,\n      transition: renderState.transition,\n    });\n  }\n\n  private clearCanvas(): void {\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\n  // ========= Cleanup / event handlers =========\n\n  dispose(): void {\n    this.stop();\n\n    if (this.seekFlushRafId !== null) {\n      cancelAnimationFrame(this.seekFlushRafId);\n      this.seekFlushRafId = null;\n    }\n    this.pendingSeekTimeUs = null;\n    const waiters = this.pendingSeekWaiters;\n    this.pendingSeekWaiters = [];\n    for (const resolve of waiters) resolve();\n\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    if (this.fsm.snapshot.state === PlaybackState.Idle && this.currentTimeUs === 0) {\n      void this.renderCurrentFrame(0, { mode: 'blocking' });\n    }\n  };\n\n  private onModelSet = (): void => {\n    if (!this.videoComposer || !this.orchestrator.compositionModel) return;\n\n    // Model switching cancels in-flight async chains, but must NOT enter buffering or reset time/state.\n    // Buffering runs a long async sequence; if cancelled mid-way it can leave the FSM stuck.\n    this.dispatch({ type: PlaybackActionType.ModelSet });\n\n    const model = this.orchestrator.compositionModel;\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    // Best-effort background audio preheat (non-blocking).\n    if (!this.orchestrator.cacheManager.isExporting) {\n      void this.audioSession.ensureAudioForTime(this.currentTimeUs, { mode: 'probe' });\n    }\n    void this.renderCurrentFrame(this.currentTimeUs, { mode: 'blocking' });\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  private isVideoResourceReadyAtTime(timeUs: TimeUs): boolean {\n    const model = this.orchestrator.compositionModel;\n    if (!model) return true;\n    const clip = model.getClipsAtTime(timeUs, model.mainTrackId)[0];\n    if (!clip || !('resourceId' in clip) || typeof (clip as any).resourceId !== 'string')\n      return true;\n    const resourceId = (clip as any).resourceId as string;\n    const resource = model.getResource(resourceId);\n    // For terminal errors, do NOT enter buffering loops.\n    // getRenderState() will return null and we will present an empty frame.\n    return (\n      resource?.state === 'ready' ||\n      (resource?.state === 'error' && resource.error?.terminal === true)\n    );\n  }\n\n  private isTerminalVideoErrorAtTime(timeUs: TimeUs): boolean {\n    const model = this.orchestrator.compositionModel;\n    if (!model) return false;\n    const clip = model.getClipsAtTime(timeUs, model.mainTrackId)[0];\n    if (!clip || !('resourceId' in clip) || typeof (clip as any).resourceId !== 'string') {\n      return false;\n    }\n    const resourceId = (clip as any).resourceId as string;\n    const resource = model.getResource(resourceId);\n    return (\n      resource?.type === 'video' && resource.state === 'error' && resource.error?.terminal === true\n    );\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  PlaybackOptions,\n  IEventBus,\n  PreviewHandle,\n  TimeUs,\n} from './types';\nimport {\n  PlaybackActionType,\n  PlaybackCommandType,\n  PlaybackState,\n  type OpToken,\n  type PlaybackAction,\n  type PlaybackCommand,\n} from './types';\nimport { MeframeEvent } from '../event/events';\nimport type { Orchestrator } from '../orchestrator';\nimport type { RequestMode } from '../orchestrator/types';\nimport { MP4MoovNotFoundError, WaiterReplacedError } from '../utils/errors';\nimport { VideoComposer } from '../stages/compose/VideoComposer';\nimport { isVideoClip } from '../model/types';\nimport type { AudioPreviewSession } from '../orchestrator/AudioPreviewSession';\n\nimport { PlaybackStateMachine } from './PlaybackStateMachine';\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 time (external)\n  currentTimeUs: TimeUs = 0;\n  private playbackRate = 1.0;\n  private volume = 1.0;\n  private loop = false;\n\n  // Time base\n  private rafId: number | null = null;\n  private startTimeUs: TimeUs = 0; // AudioContext timeline origin (microseconds)\n\n  // Frame stats\n  private frameCount = 0;\n  private lastFrameTime = 0;\n  private fps = 0;\n\n  // Audio\n  private audioContext: AudioContext;\n  private audioSession: AudioPreviewSession;\n  private lastAudioScheduleTime = 0;\n  private readonly AUDIO_SCHEDULE_INTERVAL = 250_000; // 250ms\n\n  // State machine\n  private fsm = new PlaybackStateMachine();\n\n  // Coalesced seek (scrubbing): latest-wins, flush at most once per rAF.\n  // UI is fire-and-forget; this avoids spawning/canceling on-demand decoders too aggressively.\n  private pendingSeekTimeUs: TimeUs | null = null;\n  private pendingSeekWaiters: Array<() => void> = [];\n  private seekFlushRafId: number | null = null;\n  private seekInFlight: { targetUs: TimeUs; done: Promise<void> } | null = null;\n  // If user drags far away while a seek is decoding, cancel it to avoid visible lag.\n  private readonly SEEK_CANCEL_DISTANCE_US: TimeUs = 5_000_000; // 5s\n\n  private isSeekActive(): boolean {\n    return (\n      this.pendingSeekTimeUs !== null ||\n      this.seekInFlight !== null ||\n      this.fsm.snapshot.state === PlaybackState.Seeking\n    );\n  }\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.audio.preview;\n    this.eventBus = eventBus;\n    this.canvas = options.canvas;\n    this.audioContext = new AudioContext();\n\n    const model = orchestrator.compositionModel;\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    if (options.startUs !== undefined) {\n      this.currentTimeUs = options.startUs;\n    }\n    if (options.rate !== undefined) {\n      this.playbackRate = options.rate;\n    }\n    if (options.loop !== undefined) {\n      this.loop = options.loop;\n    }\n\n    this.setupEventListeners();\n\n    if (options.autoStart) {\n      this.play();\n    }\n  }\n\n  async renderCover(): Promise<void> {\n    await this.renderCurrentFrame(0, { mode: 'blocking' });\n  }\n\n  // ========= Public API =========\n\n  play(): void {\n    this.dispatch({ type: PlaybackActionType.Play });\n  }\n\n  pause(): void {\n    this.dispatch({ type: PlaybackActionType.Pause });\n  }\n\n  stop(): void {\n    this.dispatch({ type: PlaybackActionType.Stop });\n  }\n\n  async seek(timeUs: TimeUs): Promise<void> {\n    this.pendingSeekTimeUs = timeUs;\n\n    const done = new Promise<void>((resolve) => {\n      this.pendingSeekWaiters.push(resolve);\n    });\n\n    if (this.seekFlushRafId === null) {\n      this.seekFlushRafId = requestAnimationFrame(() => {\n        this.seekFlushRafId = null;\n        void this.flushCoalescedSeek();\n      });\n    }\n\n    // Fire-and-forget in typical UI, but keep await semantics:\n    // resolve only after the seek that includes this request has completed.\n    await done;\n  }\n\n  private async flushCoalescedSeek(): Promise<void> {\n    const target = this.pendingSeekTimeUs;\n    if (target === null) {\n      const waiters = this.pendingSeekWaiters;\n      this.pendingSeekWaiters = [];\n      for (const resolve of waiters) resolve();\n      return;\n    }\n\n    // If a seek is in flight, prefer letting it complete to keep scrubbing continuous.\n    // But if the user jumps far enough, cancel the in-flight seek to reduce lag.\n    if (this.seekInFlight) {\n      const distance = Math.abs(target - this.seekInFlight.targetUs);\n      if (distance <= this.SEEK_CANCEL_DISTANCE_US) {\n        // Keep latest pending and wait for in-flight completion.\n        return;\n      }\n      // Far jump: cancel by starting a new seek (token bump cancels old chain at await boundaries).\n      this.seekInFlight = null;\n    }\n\n    // Start a seek for the latest target and clear pending.\n    this.pendingSeekTimeUs = null;\n    const { done } = this.dispatch({\n      type: PlaybackActionType.Seek,\n      timeUs: target,\n      durationUs: this.duration,\n    });\n\n    this.seekInFlight = { targetUs: target, done };\n\n    void done.finally(() => {\n      // Resolve awaiters after the seek finishes (tests and some callers rely on this).\n      const waiters = this.pendingSeekWaiters;\n      this.pendingSeekWaiters = [];\n      for (const resolve of waiters) resolve();\n\n      // Only clear if this in-flight is still the same one.\n      if (this.seekInFlight?.targetUs === target) {\n        this.seekInFlight = null;\n      }\n\n      // If we are continuing playback after a seek, proactively preheat the upcoming window.\n      // Otherwise playback can \"stick\" on the seek frame until the normal preheat threshold is reached.\n      const shouldPreheatAfterSeek =\n        this.pendingSeekTimeUs === null &&\n        !this.orchestrator.cacheManager.isExporting &&\n        this.fsm.snapshot.state === PlaybackState.Playing;\n      if (shouldPreheatAfterSeek) {\n        void this.preheatNextWindow();\n      }\n\n      // If new seek came in while we were decoding, flush again next frame.\n      if (this.pendingSeekTimeUs !== null && this.seekFlushRafId === null) {\n        this.seekFlushRafId = requestAnimationFrame(() => {\n          this.seekFlushRafId = null;\n          void this.flushCoalescedSeek();\n        });\n      }\n    });\n  }\n\n  setRate(rate: number): void {\n    const currentTimeUs = this.currentTimeUs;\n    this.playbackRate = rate;\n\n    // Keep currentTimeUs stable; update the time base for AudioContext clock mapping.\n    this.startTimeUs = this.audioContext.currentTime * 1_000_000 - currentTimeUs / rate;\n    this.audioSession.setPlaybackRate(this.playbackRate);\n\n    this.eventBus.emit(MeframeEvent.PlaybackRateChange, { rate });\n  }\n\n  setVolume(volume: number): void {\n    this.volume = Math.max(0, Math.min(1, volume));\n    this.audioSession.setVolume(this.volume);\n    this.eventBus.emit(MeframeEvent.PlaybackVolumeChange, { volume: this.volume });\n  }\n\n  setMute(muted: boolean): void {\n    if (muted) {\n      this.audioSession.stopPlayback();\n      return;\n    }\n    if (this.fsm.snapshot.state === PlaybackState.Playing) {\n      void 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    return this.orchestrator.compositionModel?.durationUs ?? 0;\n  }\n\n  get isPlaying(): boolean {\n    return this.fsm.snapshot.state === PlaybackState.Playing;\n  }\n\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  // ========= State machine wiring =========\n\n  private dispatch(action: PlaybackAction): { token: OpToken; done: Promise<void> } {\n    const { token, commands } = this.fsm.dispatch(action, { currentTimeUs: this.currentTimeUs });\n    const done = this.executeCommands(commands, token);\n    return { token, done };\n  }\n\n  private executeCommands(commands: PlaybackCommand[], token: OpToken): Promise<void> {\n    const maybe = this.executeSeq(commands, token, 0);\n    return maybe ?? Promise.resolve();\n  }\n\n  private executeSeq(\n    commands: PlaybackCommand[],\n    token: OpToken,\n    startIndex: number\n  ): Promise<void> | void {\n    for (let i = startIndex; i < commands.length; i++) {\n      if (!this.isCurrentToken(token)) return;\n      const maybe = this.executeCommand(commands[i]!, token);\n      if (maybe) {\n        return maybe.then(() => {\n          if (!this.isCurrentToken(token)) return;\n          const cont = this.executeSeq(commands, token, i + 1);\n          return cont ?? Promise.resolve();\n        });\n      }\n    }\n  }\n\n  private executePar(commands: PlaybackCommand[], token: OpToken): Promise<any> | void {\n    const promises: Promise<void>[] = [];\n    for (const c of commands) {\n      if (!this.isCurrentToken(token)) return;\n      const maybe = this.executeCommand(c, token);\n      if (maybe) promises.push(maybe);\n    }\n    if (promises.length === 0) return;\n    return Promise.all(promises);\n  }\n\n  private executeCommand(command: PlaybackCommand, token: OpToken): Promise<any> | void {\n    if (!this.isCurrentToken(token)) return;\n\n    switch (command.type) {\n      case PlaybackCommandType.Seq:\n        return this.executeSeq(command.commands, token, 0);\n      case PlaybackCommandType.Par:\n        return this.executePar(command.commands, token);\n      case PlaybackCommandType.Try: {\n        const handleError = (error: unknown): Promise<void> | void => {\n          if (!this.isCurrentToken(token)) return;\n          if (command.ignoreWaiterReplacedError && error instanceof WaiterReplacedError) return;\n          if (command.logPrefix) console.error(command.logPrefix, error);\n          const onErrorDone = command.onError ? this.dispatch(command.onError).done : undefined;\n          const normalizeError = (e: unknown): Error => {\n            if (e instanceof Error) return e;\n            return new Error(typeof e === 'string' ? e : JSON.stringify(e));\n          };\n          const emit = () => {\n            if (command.emitPlaybackError) {\n              const err = normalizeError(error);\n              const recoverable =\n                // Waiter replaced is expected during rapid seek; safe to ignore.\n                err instanceof WaiterReplacedError ||\n                // Missing moov may be caused by incomplete/corrupted cache and can be retried via recovery.\n                err instanceof MP4MoovNotFoundError;\n              // PlaybackError: direct playback channel error for advanced consumers.\n              this.eventBus.emit(MeframeEvent.PlaybackError, err);\n              // Error: generic error channel expected by higher-level wrappers (e.g. @meframe/axii).\n              this.eventBus.emit(MeframeEvent.Error, {\n                source: 'playback',\n                error: err,\n                context: {\n                  command: command.logPrefix,\n                  onError: command.onError?.type,\n                },\n                recoverable,\n              });\n            }\n          };\n          if (onErrorDone) {\n            return onErrorDone.then(() => {\n              emit();\n            });\n          }\n          emit();\n        };\n\n        try {\n          const maybe = this.executeCommand(command.command, token);\n          if (maybe) {\n            return maybe.catch(handleError);\n          }\n          return;\n        } catch (error) {\n          return handleError(error) ?? Promise.resolve();\n        }\n      }\n      case PlaybackCommandType.Dispatch:\n        return this.dispatch(command.action).done;\n      case PlaybackCommandType.SetTime: {\n        this.currentTimeUs = command.timeUs;\n        return;\n      }\n      case PlaybackCommandType.SetFrozenTime:\n      case PlaybackCommandType.SetWantsPlay:\n      case PlaybackCommandType.SetState: {\n        // managed inside fsm\n        return;\n      }\n      case PlaybackCommandType.CancelRaf: {\n        this.cancelRaf();\n        return;\n      }\n      case PlaybackCommandType.StopAudio: {\n        this.audioSession.stopPlayback();\n        return;\n      }\n      case PlaybackCommandType.ResetAudioPlaybackStates: {\n        this.audioSession.resetPlaybackStates();\n        return;\n      }\n      case PlaybackCommandType.ResetAudioSession: {\n        this.audioSession.reset();\n        return;\n      }\n      case PlaybackCommandType.ClearCanvas: {\n        this.clearCanvas();\n        return;\n      }\n      case PlaybackCommandType.SetLastAudioScheduleTime: {\n        this.lastAudioScheduleTime = command.timeUs;\n        return;\n      }\n      case PlaybackCommandType.SetStartTimeBase: {\n        this.startTimeUs = command.startTimeUs;\n        return;\n      }\n      case PlaybackCommandType.SyncTimeBaseToAudioClock: {\n        this.startTimeUs =\n          this.audioContext.currentTime * 1_000_000 - command.timeUs / this.playbackRate;\n        return;\n      }\n      case PlaybackCommandType.InitWindow: {\n        this.initWindow(command.timeUs);\n        return;\n      }\n      case PlaybackCommandType.SetCacheWindow: {\n        this.orchestrator.cacheManager.setWindow(command.timeUs);\n        return;\n      }\n      case PlaybackCommandType.Emit: {\n        if (command.payload === undefined) {\n          this.eventBus.emit(command.event as any);\n        } else {\n          this.eventBus.emit(command.event as any, command.payload);\n        }\n        return;\n      }\n      case PlaybackCommandType.RenderFrame: {\n        return this.renderCurrentFrame(command.timeUs, {\n          mode: command.mode,\n          relativeTimeUs: command.relativeTimeUs,\n        });\n      }\n      case PlaybackCommandType.EnsureAudio: {\n        return this.audioSession.ensureAudioForTime(command.timeUs, {\n          mode: command.mode,\n        });\n      }\n      case PlaybackCommandType.GetFrame: {\n        return this.orchestrator.getFrame(command.timeUs, {\n          mode: command.mode,\n          preheat: command.preheat,\n          scrub: command.scrub,\n        });\n      }\n      case PlaybackCommandType.StartAudioPlayback: {\n        return this.audioSession.startPlayback(command.timeUs, this.audioContext);\n      }\n      case PlaybackCommandType.ProbeStartReady: {\n        const audioReady = this.audioSession.isPreviewMixBlockCached(command.timeUs);\n        const videoReady = this.isVideoResourceReadyAtTime(command.timeUs);\n\n        if (audioReady && videoReady) return;\n\n        // Kick background preparation (best-effort).\n        if (!audioReady) {\n          void this.audioSession.ensureAudioForTime(command.timeUs, { mode: 'probe' });\n        }\n        if (!videoReady) {\n          void this.orchestrator.getFrame(command.timeUs, { mode: 'probe' });\n        }\n\n        // Enter buffering and bump token to cancel the remaining start sequence.\n        this.dispatch({\n          type: PlaybackActionType.EnterBuffering,\n          timeUs: command.timeUs,\n          bumpToken: true,\n          reason: 'startup',\n        });\n        return;\n      }\n      case PlaybackCommandType.StartRafLoop: {\n        this.startPlaybackLoop(token);\n        if (\n          !this.orchestrator.cacheManager.isExporting &&\n          this.fsm.snapshot.state === PlaybackState.Playing\n        ) {\n          void this.preheatNextWindow();\n        }\n        return;\n      }\n    }\n  }\n\n  private cancelRaf(): void {\n    if (this.rafId !== null) {\n      cancelAnimationFrame(this.rafId);\n      this.rafId = null;\n    }\n  }\n\n  private isCurrentToken(token: OpToken): boolean {\n    return token === this.fsm.snapshot.token;\n  }\n\n  private startPlaybackLoop(token: OpToken): void {\n    this.rafId = requestAnimationFrame(() => {\n      void this.onRafTick(token);\n    });\n  }\n\n  private async onRafTick(token: OpToken): Promise<void> {\n    if (!this.isCurrentToken(token) || this.fsm.snapshot.state !== PlaybackState.Playing) {\n      return;\n    }\n\n    const candidateTimeUs =\n      (this.audioContext.currentTime * 1_000_000 - this.startTimeUs) * this.playbackRate;\n    this.dispatch({\n      type: PlaybackActionType.ClockTick,\n      candidateTimeUs,\n      durationUs: this.duration,\n      loop: this.loop,\n      audioNowUs: this.audioContext.currentTime * 1_000_000,\n    });\n\n    if (!this.isCurrentToken(token) || this.fsm.snapshot.state !== PlaybackState.Playing) {\n      return;\n    }\n\n    // Audio probe: if the audio window isn't ready, enter buffering (freeze timeline)\n    // and kick background audio preparation.\n    // Note: preview audio readiness is driven by 60s mix-block cache inside AudioPreviewSession.\n    // We intentionally avoid additional resource-window probing here to prevent buffering oscillation.\n\n    // Throttle audio scheduling.\n    if (this.currentTimeUs - this.lastAudioScheduleTime >= this.AUDIO_SCHEDULE_INTERVAL) {\n      // Fire-and-forget: AudioPreviewSession runs its own background scheduling loop.\n      // We avoid awaiting here to keep the render loop responsive.\n      void this.audioSession.scheduleAudio(this.currentTimeUs, this.audioContext);\n      this.lastAudioScheduleTime = this.currentTimeUs;\n    }\n\n    // If we're close to the 60s block boundary and the next mixed block isn't ready yet,\n    // enter buffering to avoid hard silence at the boundary.\n    if (this.audioSession.shouldEnterBufferingForUpcomingPreviewAudio(this.currentTimeUs)) {\n      // Best-effort preheat; buffering path will call EnsureAudio(blocking).\n      void this.audioSession.ensureAudioForTime(this.currentTimeUs, { mode: 'probe' });\n      this.dispatch({\n        type: PlaybackActionType.EnterBuffering,\n        timeUs: this.currentTimeUs,\n        reason: 'audio',\n      });\n      return;\n    }\n\n    const renderState = await this.orchestrator.getRenderState(this.currentTimeUs, {\n      mode: 'probe',\n    });\n    if (!this.isCurrentToken(token) || this.fsm.snapshot.state !== PlaybackState.Playing) {\n      return;\n    }\n\n    if (!renderState) {\n      // If the current clip's resource is in a terminal error state, buffering will oscillate\n      // (probe keeps returning null, buffering resolves quickly, then repeats). In this case,\n      // keep playing and present an empty frame instead.\n      if (this.isTerminalVideoErrorAtTime(this.currentTimeUs)) {\n        this.clearCanvas();\n        this.finalizeFrameAndContinue(token);\n        return;\n      }\n\n      this.dispatch({ type: PlaybackActionType.EnterBuffering, timeUs: this.currentTimeUs });\n      return;\n    }\n\n    await this.compose(this.currentTimeUs, renderState);\n    if (!this.isCurrentToken(token) || this.fsm.snapshot.state !== PlaybackState.Playing) return;\n\n    this.finalizeFrameAndContinue(token);\n  }\n\n  private finalizeFrameAndContinue(token: OpToken): void {\n    this.updateFps();\n    this.frameCount++;\n\n    // Unified cache window update.\n    this.orchestrator.cacheManager.setWindow(this.currentTimeUs);\n    this.checkAndPreheatWindow();\n\n    if (!this.isCurrentToken(token) || this.fsm.snapshot.state !== PlaybackState.Playing) {\n      return;\n    }\n\n    this.startPlaybackLoop(token);\n  }\n\n  private updateFps(): void {\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\n  private initWindow(timeUs: TimeUs): void {\n    this.windowEnd = timeUs + this.WINDOW_DURATION;\n    this.preheatInProgress = false;\n    this.orchestrator.cacheManager.setWindow(timeUs);\n  }\n\n  private checkAndPreheatWindow(): void {\n    const isExporting = this.orchestrator.cacheManager.isExporting;\n    const isPreheatBusy = this.preheatInProgress;\n    const isPlaying = this.fsm.snapshot.state === PlaybackState.Playing;\n    const distanceToWindowEnd = this.windowEnd - this.currentTimeUs;\n    if (distanceToWindowEnd < 0) {\n      this.initWindow(this.currentTimeUs);\n      return;\n    }\n    const isWithinPreheatDistance =\n      distanceToWindowEnd > 0 && distanceToWindowEnd <= this.PREHEAT_DISTANCE;\n    const shouldSkipPreheat =\n      isExporting || isPreheatBusy || !isPlaying || !isWithinPreheatDistance || this.isSeekActive();\n    if (shouldSkipPreheat) return;\n    void this.preheatNextWindow();\n  }\n\n  async preheatNextWindow(): Promise<void> {\n    // Export uses main-thread decode + heavy OPFS IO; disable preview preheat to avoid contention.\n    const isExporting = this.orchestrator.cacheManager.isExporting;\n    const isPreheatBusy = this.preheatInProgress;\n    const shouldSkipPreheat = isExporting || isPreheatBusy || this.isSeekActive();\n    if (shouldSkipPreheat) return;\n\n    this.preheatInProgress = true;\n    try {\n      const windowStart = this.currentTimeUs;\n      const windowEnd = windowStart + this.WINDOW_DURATION;\n\n      const clipsInWindow =\n        this.orchestrator.compositionModel?.getClipsInRange(windowStart, windowEnd) ?? [];\n      const preheatPromises: Promise<any>[] = [];\n      for (const clip of clipsInWindow) {\n        if (!isVideoClip(clip)) continue;\n\n        const clipWindowStart = Math.max(0, windowStart - clip.startUs);\n        const clipWindowEnd = Math.min(clip.durationUs, windowEnd - clip.startUs);\n        if (clipWindowStart >= clipWindowEnd) continue;\n\n        preheatPromises.push(\n          this.orchestrator.preheatClipWindow(clip.id, clipWindowStart, clipWindowEnd, windowStart)\n        );\n      }\n\n      // Audio preheat is handled inside AudioPreviewSession via mix-block scheduling & cache.\n\n      await Promise.all(preheatPromises);\n      this.windowEnd = windowEnd;\n    } catch (error) {\n      console.warn('[PlaybackController] Preheat failed:', error);\n    } finally {\n      this.preheatInProgress = false;\n    }\n  }\n\n  private async renderCurrentFrame(\n    timeUs: TimeUs,\n    options: { mode: RequestMode; relativeTimeUs?: TimeUs }\n  ): Promise<void> {\n    if (!this.videoComposer) {\n      console.error('[PlaybackController] VideoComposer not initialized');\n      return;\n    }\n\n    const renderState = await this.orchestrator.getRenderState(timeUs, {\n      mode: options.mode,\n      relativeTimeUs: options.relativeTimeUs,\n    });\n\n    if (!renderState) {\n      // No render state (e.g. missing clip, resource error, or probe returned null).\n      // Present an empty frame instead of freezing the last canvas content.\n      this.clearCanvas();\n      return;\n    }\n\n    await this.compose(timeUs, renderState);\n  }\n\n  private async compose(\n    timeUs: TimeUs,\n    renderState: { layers: any[]; transition?: any }\n  ): Promise<void> {\n    if (!this.videoComposer) return;\n    await this.videoComposer.composeFrame({\n      timeUs,\n      layers: renderState.layers,\n      transition: renderState.transition,\n    });\n  }\n\n  private clearCanvas(): void {\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\n  // ========= Cleanup / event handlers =========\n\n  dispose(): void {\n    this.stop();\n\n    if (this.seekFlushRafId !== null) {\n      cancelAnimationFrame(this.seekFlushRafId);\n      this.seekFlushRafId = null;\n    }\n    this.pendingSeekTimeUs = null;\n    const waiters = this.pendingSeekWaiters;\n    this.pendingSeekWaiters = [];\n    for (const resolve of waiters) resolve();\n\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    if (this.fsm.snapshot.state === PlaybackState.Idle && this.currentTimeUs === 0) {\n      void this.renderCurrentFrame(0, { mode: 'blocking' });\n    }\n  };\n\n  private onModelSet = (): void => {\n    if (!this.videoComposer || !this.orchestrator.compositionModel) return;\n\n    // Model switching cancels in-flight async chains, but must NOT enter buffering or reset time/state.\n    // Buffering runs a long async sequence; if cancelled mid-way it can leave the FSM stuck.\n    this.dispatch({ type: PlaybackActionType.ModelSet });\n\n    const model = this.orchestrator.compositionModel;\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    // Best-effort background audio preheat (non-blocking).\n    if (!this.orchestrator.cacheManager.isExporting) {\n      void this.audioSession.ensureAudioForTime(this.currentTimeUs, { mode: 'probe' });\n    }\n    void this.renderCurrentFrame(this.currentTimeUs, { mode: 'blocking' });\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  private isVideoResourceReadyAtTime(timeUs: TimeUs): boolean {\n    const model = this.orchestrator.compositionModel;\n    if (!model) return true;\n    const clip = model.getClipsAtTime(timeUs, model.mainTrackId)[0];\n    if (!clip || !('resourceId' in clip) || typeof (clip as any).resourceId !== 'string')\n      return true;\n    const resourceId = (clip as any).resourceId as string;\n    const resource = model.getResource(resourceId);\n    // For terminal errors, do NOT enter buffering loops.\n    // getRenderState() will return null and we will present an empty frame.\n    return (\n      resource?.state === 'ready' ||\n      (resource?.state === 'error' && resource.error?.terminal === true)\n    );\n  }\n\n  private isTerminalVideoErrorAtTime(timeUs: TimeUs): boolean {\n    const model = this.orchestrator.compositionModel;\n    if (!model) return false;\n    const clip = model.getClipsAtTime(timeUs, model.mainTrackId)[0];\n    if (!clip || !('resourceId' in clip) || typeof (clip as any).resourceId !== 'string') {\n      return false;\n    }\n    const resourceId = (clip as any).resourceId as string;\n    const resource = model.getResource(resourceId);\n    return (\n      resource?.type === 'video' && resource.state === 'error' && resource.error?.terminal === true\n    );\n  }\n}\n"],"names":[],"mappings":"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"}

package/dist/orchestrator/ExportScheduler.d.ts

@@ -45,6 +45,7 @@ export declare class ExportScheduler {
      */
     private processAudioInWindows;
     private processVideoClipsSequentially;
+    private decideAudioStrategy;
 }
 export {};
 //# sourceMappingURL=ExportScheduler.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"ExportScheduler.d.ts","sourceRoot":"","sources":["../../src/orchestrator/ExportScheduler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAClD,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AACrD,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAC/D,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AACtD,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAE1D,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAE7C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AACxE,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC7C,OAAO,EAAgB,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAEhE,UAAU,mBAAmB;IAC3B,UAAU,EAAE,UAAU,CAAC;IACvB,OAAO,EAAE,kBAAkB,CAAC;IAC5B,YAAY,EAAE,YAAY,CAAC;IAC3B,cAAc,EAAE,cAAc,CAAC;IAC/B,UAAU,EAAE,UAAU,CAAC;IACvB,YAAY,EAAE,kBAAkB,CAAC;IACjC,qBAAqB,EAAE,MAAM,MAAM,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC;IACrD,QAAQ,EAAE,QAAQ,CAAC,eAAe,CAAC,CAAC;CACrC;AAED,UAAU,qBAAsB,SAAQ,aAAa;IACnD,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,UAAU,CAAC,EAAE,gBAAgB,CAAC;IAC9B,UAAU,CAAC,EAAE,MAAM,GAAG,QAAQ,CAAC;IAC/B,SAAS,CAAC,EAAE,CAAC,IAAI,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;IACzD,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,qBAAa,eAAe;IAC1B,OAAO,CAAC,IAAI,CAAsB;gBAEtB,IAAI,EAAE,mBAAmB;IAI/B,OAAO,CAAC,KAAK,EAAE,gBAAgB,EAAE,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC;YAa9E,eAAe;IAyH7B;;OAEG;YACW,gBAAgB;IA+D9B;;;;OAIG;YACW,qBAAqB;YA0BrB,6BAA6B;CA0G5C"}
+{"version":3,"file":"ExportScheduler.d.ts","sourceRoot":"","sources":["../../src/orchestrator/ExportScheduler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAClD,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AACrD,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAC/D,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AACtD,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAE1D,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAE7C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AACxE,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC7C,OAAO,EAAgB,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAGhE,UAAU,mBAAmB;IAC3B,UAAU,EAAE,UAAU,CAAC;IACvB,OAAO,EAAE,kBAAkB,CAAC;IAC5B,YAAY,EAAE,YAAY,CAAC;IAC3B,cAAc,EAAE,cAAc,CAAC;IAC/B,UAAU,EAAE,UAAU,CAAC;IACvB,YAAY,EAAE,kBAAkB,CAAC;IACjC,qBAAqB,EAAE,MAAM,MAAM,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC;IACrD,QAAQ,EAAE,QAAQ,CAAC,eAAe,CAAC,CAAC;CACrC;AAED,UAAU,qBAAsB,SAAQ,aAAa;IACnD,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,UAAU,CAAC,EAAE,gBAAgB,CAAC;IAC9B,UAAU,CAAC,EAAE,MAAM,GAAG,QAAQ,CAAC;IAC/B,SAAS,CAAC,EAAE,CAAC,IAAI,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;IACzD,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,qBAAa,eAAe;IAC1B,OAAO,CAAC,IAAI,CAAsB;gBAEtB,IAAI,EAAE,mBAAmB;IAI/B,OAAO,CAAC,KAAK,EAAE,gBAAgB,EAAE,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC;YAa9E,eAAe;IA6I7B;;OAEG;YACW,gBAAgB;IA+D9B;;;;OAIG;YACW,qBAAqB;YA0BrB,6BAA6B;YA2G7B,mBAAmB;CA6ClC"}

package/dist/orchestrator/ExportScheduler.js

@@ -1,6 +1,7 @@
 import { VideoClipSession } from "./VideoClipSession.js";
 import { hasResourceId } from "../model/types.js";
 import { MeframeEvent } from "../event/events.js";
+import { AudioChunkEncoder } from "../stages/encode/AudioChunkEncoder.js";
 class ExportScheduler {
   deps;
   constructor(deps) {
@@ -48,10 +49,24 @@ class ExportScheduler {
     this.deps.cacheManager.beginExport();
     try {
       await this.preloadResources(model, resourceLoader, eventBus, checkStatus);
+      const hasAudioSamples = this.deps.cacheManager.audioSampleCache.getTotalBytes() > 0;
+      const { enableAudio, disabledReason } = await this.decideAudioStrategy({
+        hasAudioSamples,
+        requestedFormat: options.format ?? "mp4",
+        requestedAudioCodec: options.audioCodec ?? "aac"
+      });
+      if (disabledReason) {
+        eventBus.emit(MeframeEvent.ExportProgress, {
+          progress: 0.4,
+          stage: "encoding",
+          message: disabledReason
+        });
+      }
       muxManager.start({
         width,
         height,
         fps,
+        enableAudio,
         output: exportMode === "stream" ? {
           kind: "stream",
           onData: (data, position) => {
@@ -64,10 +79,17 @@ class ExportScheduler {
       });
       const mainTrack = model.tracks.find((t) => t.id === model.mainTrackId);
       if (mainTrack && mainTrack.clips.length > 0) {
-        const hasAudioSamples = this.deps.cacheManager.audioSampleCache.getTotalBytes() > 0;
-        const audioPromise = hasAudioSamples ? this.processAudioInWindows(model.durationUs, audioSession, muxManager, checkStatus) : Promise.resolve();
+        const audioPromise = enableAudio ? this.processAudioInWindows(model.durationUs, audioSession, muxManager, checkStatus) : Promise.resolve();
         await this.processVideoClipsSequentially(mainTrack.clips, muxManager, model, checkStatus);
-        await audioPromise;
+        try {
+          await audioPromise;
+        } catch (error) {
+          eventBus.emit(MeframeEvent.ExportProgress, {
+            progress: 0.95,
+            stage: "encoding",
+            message: `Audio skipped (runtime failure): ${error instanceof Error ? error.message : String(error)}`
+          });
+        }
       } else {
         console.warn("[ExportScheduler] No video clips found");
       }
@@ -241,6 +263,37 @@ class ExportScheduler {
       nextClipStartUs = lastChunkEndUs;
     }
   }
+  async decideAudioStrategy(input) {
+    if (!input.hasAudioSamples) {
+      return { enableAudio: false };
+    }
+    if (input.requestedFormat !== "mp4") {
+      return {
+        enableAudio: false,
+        disabledReason: `Audio skipped: format ${input.requestedFormat} is not supported.`
+      };
+    }
+    if (input.requestedAudioCodec !== "aac") {
+      return {
+        enableAudio: false,
+        disabledReason: `Audio skipped: mp4 output currently supports only AAC (requested ${input.requestedAudioCodec}).`
+      };
+    }
+    if (typeof AudioEncoder === "undefined") {
+      return {
+        enableAudio: false,
+        disabledReason: "Audio skipped: WebCodecs AudioEncoder is not available in this browser/runtime (AAC required for mp4)."
+      };
+    }
+    const support = await AudioEncoder.isConfigSupported(AudioChunkEncoder.DEFAULT_CONFIG);
+    if (!support.supported) {
+      return {
+        enableAudio: false,
+        disabledReason: "Audio skipped: WebCodecs AAC (mp4a.40.2) AudioEncoder is not supported in this browser/runtime."
+      };
+    }
+    return { enableAudio: true };
+  }
 }
 export {
   ExportScheduler

package/dist/orchestrator/ExportScheduler.js.map

@@ -1 +1 @@
-{"version":3,"file":"ExportScheduler.js","sources":["../../src/orchestrator/ExportScheduler.ts"],"sourcesContent":["import { CompositionModel } from '../model';\nimport { ExportOptions } from '../types';\nimport { WorkerPool } from '../worker/WorkerPool';\nimport { CompositionPlanner } from './CompositionPlanner';\nimport { CacheManager } from '../cache/CacheManager';\nimport { ResourceLoader } from '../stages/load/ResourceLoader';\nimport { MuxManager } from '../stages/mux/MuxManager';\nimport { AudioExportSession } from './AudioExportSession';\nimport { VideoClipSession } from './VideoClipSession';\nimport { WorkerType } from '../worker/types';\nimport { hasResourceId, type TimeUs } from '../model/types';\nimport type { ExportController } from '../controllers/ExportController';\nimport { EventBus } from '../event/EventBus';\nimport { MeframeEvent, EventPayloadMap } from '../event/events';\n\ninterface ExportSchedulerDeps {\n  workerPool: WorkerPool;\n  planner: CompositionPlanner;\n  cacheManager: CacheManager;\n  resourceLoader: ResourceLoader;\n  muxManager: MuxManager;\n  audioSession: AudioExportSession;\n  workerConfigsProvider: () => Record<WorkerType, any>;\n  eventBus: EventBus<EventPayloadMap>;\n}\n\ninterface ExtendedExportOptions extends ExportOptions {\n  signal?: AbortSignal;\n  controller?: ExportController;\n  exportMode?: 'blob' | 'stream';\n  onMuxData?: (data: Uint8Array, position: number) => void;\n  muxChunkSizeBytes?: number;\n  muxChunked?: boolean;\n}\n\nexport class ExportScheduler {\n  private deps: ExportSchedulerDeps;\n\n  constructor(deps: ExportSchedulerDeps) {\n    this.deps = deps;\n  }\n\n  async execute(model: CompositionModel, options: ExtendedExportOptions): Promise<Blob | null> {\n    this.deps.cacheManager.clear();\n\n    const projectId = this.deps.cacheManager.resourceCache.projectId;\n\n    if (!navigator.locks) {\n      return this.executeInternal(model, options);\n    }\n\n    const lockName = `meframe-resource-${projectId}`;\n    return navigator.locks.request(lockName, () => this.executeInternal(model, options));\n  }\n\n  private async executeInternal(\n    model: CompositionModel,\n    options: ExtendedExportOptions\n  ): Promise<Blob | null> {\n    const { muxManager, audioSession, eventBus, resourceLoader } = this.deps;\n    const signal = options.signal;\n    const controller = options.controller;\n    const exportMode = options.exportMode ?? 'blob';\n\n    if (exportMode === 'stream' && typeof options.onMuxData !== 'function') {\n      throw new Error('onMuxData callback is required when exportMode is stream');\n    }\n\n    let streamedBytes = 0;\n\n    const checkStatus = async () => {\n      if (signal?.aborted) {\n        throw new DOMException('Export aborted', 'AbortError');\n      }\n      // TODO: ugly\n      if (controller?.isPaused()) {\n        // Wait until resumed\n        while (controller.isPaused()) {\n          if (signal?.aborted) throw new DOMException('Export aborted', 'AbortError');\n          await new Promise((resolve) => setTimeout(resolve, 100));\n        }\n      }\n    };\n\n    const width = options.width || model.renderConfig?.width || 720;\n    const height = options.height || model.renderConfig?.height || 1280;\n    const fps = options.fps || model.fps || 30;\n\n    eventBus.emit(MeframeEvent.ExportStart, {\n      format: options.format || 'mp4',\n      width,\n      height,\n      fps,\n      durationUs: model.durationUs,\n    });\n\n    this.deps.cacheManager.beginExport();\n\n    try {\n      // 1. Preload and parse all resources (0-40%)\n      await this.preloadResources(model, resourceLoader, eventBus, checkStatus);\n\n      // 2. Start Muxer\n      muxManager.start({\n        width,\n        height,\n        fps,\n        output:\n          exportMode === 'stream'\n            ? {\n                kind: 'stream',\n                onData: (data, position) => {\n                  streamedBytes = Math.max(streamedBytes, position + data.byteLength);\n                  options.onMuxData?.(data, position);\n                },\n                chunkSize: options.muxChunkSizeBytes,\n                chunked: options.muxChunked,\n              }\n            : { kind: 'blob' },\n      });\n\n      // 3. Process Video and Audio\n      const mainTrack = model.tracks.find((t) => t.id === model.mainTrackId);\n      if (mainTrack && mainTrack.clips.length > 0) {\n        // Skip audio pipeline entirely if no audio samples exist (common for video-only projects).\n        // This reduces CPU time and avoids initializing AudioEncoder unnecessarily.\n        const hasAudioSamples = this.deps.cacheManager.audioSampleCache.getTotalBytes() > 0;\n\n        const audioPromise = hasAudioSamples\n          ? this.processAudioInWindows(model.durationUs, audioSession, muxManager, checkStatus)\n          : Promise.resolve();\n\n        // Process video clips sequentially\n        await this.processVideoClipsSequentially(mainTrack.clips, muxManager, model, checkStatus);\n\n        // Wait for audio encoding to complete\n        await audioPromise;\n      } else {\n        console.warn('[ExportScheduler] No video clips found');\n      }\n\n      // Finalize audio session (close encoder)\n      await audioSession.finalizeExportAudio();\n\n      if (signal?.aborted) {\n        throw new DOMException('Export aborted', 'AbortError');\n      }\n\n      // 4. Finalize\n      const blob = await muxManager.finalize();\n\n      eventBus.emit(MeframeEvent.ExportComplete, {\n        size: blob?.size ?? streamedBytes,\n        durationMs: model.durationUs / 1000,\n        format: options.format || 'mp4',\n      });\n\n      // Some clients rely on a final progress=1 event to mark completion (e.g. UI progress bars).\n      // Keep it emitted after ExportComplete for backward compatibility.\n      eventBus.emit(MeframeEvent.ExportProgress, {\n        progress: 1,\n        stage: 'muxing',\n      });\n\n      return blob;\n    } catch (error) {\n      eventBus.emit(MeframeEvent.ExportError, {\n        error: error instanceof Error ? error : new Error(String(error)),\n        stage: 'export',\n      });\n      throw error;\n    } finally {\n      this.deps.cacheManager.endExport();\n    }\n  }\n\n  /**\n   * Preload all resources (0-40% progress)\n   */\n  private async preloadResources(\n    model: CompositionModel,\n    resourceLoader: ResourceLoader,\n    eventBus: EventBus<EventPayloadMap>,\n    checkStatus: () => Promise<void>\n  ): Promise<void> {\n    eventBus.emit(MeframeEvent.ExportProgress, {\n      progress: 0,\n      stage: 'preparing',\n      message: 'Loading and parsing resources...',\n    });\n\n    // Collect resources in horizontal order (clip index priority)\n    const tracks = model.tracks.filter((track) => ['video', 'audio'].includes(track.kind));\n    if (tracks.length === 0) return;\n\n    const maxClipCount = Math.max(...tracks.map((track) => track.clips.length));\n    const resourcesToLoad: string[] = [];\n    const seen = new Set<string>();\n\n    // Horizontal collection: clip[0] from all tracks, then clip[1], etc.\n    for (let clipIndex = 0; clipIndex < maxClipCount; clipIndex++) {\n      for (const track of tracks) {\n        const clip = track.clips[clipIndex];\n        if (clip && hasResourceId(clip)) {\n          if (!seen.has(clip.resourceId)) {\n            seen.add(clip.resourceId);\n            resourcesToLoad.push(clip.resourceId);\n          }\n        }\n      }\n    }\n\n    // Load resources with progress updates (concurrent; ResourceLoader already enforces maxConcurrent).\n    const total = resourcesToLoad.length;\n    let completed = 0;\n\n    await Promise.all(\n      resourcesToLoad.map(async (resourceId) => {\n        await checkStatus();\n        await resourceLoader.load(resourceId, { isPreload: false });\n\n        // Export must be strict: if a resource is in error state (including terminal mismatch),\n        // fail fast instead of silently producing a partial/blank output.\n        const resource = model.getResource(resourceId);\n        if (resource?.state === 'error') {\n          const details = resource.error?.message ?? 'Unknown resource error';\n          throw new Error(`Export preload failed for ${resourceId}: ${details}`);\n        }\n\n        completed++;\n\n        // Update progress: 0-40%\n        const progress = total > 0 ? (completed / total) * 0.4 : 0.4;\n        eventBus.emit(MeframeEvent.ExportProgress, {\n          progress,\n          stage: 'preparing',\n          message: `Loading resources... (${completed}/${total})`,\n        });\n      })\n    );\n  }\n\n  /**\n   * Process audio in 60-second windows\n   * - Videos ≤60s: Single pass (zero boundaries)\n   * - Videos >60s: 60s windows (minimal boundaries, ~23MB per window)\n   */\n  private async processAudioInWindows(\n    totalDurationUs: TimeUs,\n    audioSession: AudioExportSession,\n    muxManager: MuxManager,\n    checkStatus: () => Promise<void>\n  ): Promise<void> {\n    const WINDOW_DURATION_US = 5 * 60 * 1_000_000; // 5 minutes\n    let currentUs = 0;\n\n    while (currentUs < totalDurationUs) {\n      await checkStatus();\n\n      const endUs = Math.min(currentUs + WINDOW_DURATION_US, totalDurationUs);\n\n      await audioSession.mixAndEncodeSegment(currentUs, endUs, (chunk, meta) =>\n        muxManager.writeAudioChunk(chunk, meta)\n      );\n\n      // Clear audio cache after encoding each window to prevent memory accumulation\n      // This is safe because audio data is already encoded and won't be reused\n      this.deps.cacheManager.clearAudioCache();\n\n      currentUs = endUs;\n    }\n  }\n\n  private async processVideoClipsSequentially(\n    clips: any[],\n    muxManager: MuxManager,\n    model: CompositionModel,\n    checkStatus: () => Promise<void>\n  ) {\n    // Use actual last written timestamp + duration as offset for next clip\n    // This avoids duplicate PTS when mp4-muxer rounds microseconds to timescale\n    let nextClipStartUs = 0;\n    // Track last chunk's end time (timestamp + duration) for precise offset calculation\n    let lastChunkEndUs = 0;\n\n    for (let i = 0; i < clips.length; i++) {\n      const clip = clips[i];\n      const currentClipOffsetUs = nextClipStartUs;\n\n      await checkStatus(); // Check before starting new clip\n\n      const sessionId = `${clip.id}-export`;\n      let streamFinishedResolver: () => void;\n      let streamFinishedRejecter: (err: any) => void;\n      const streamFinishedPromise = new Promise<void>((resolve, reject) => {\n        streamFinishedResolver = resolve;\n        streamFinishedRejecter = reject;\n      });\n\n      const session = await VideoClipSession.create({\n        clipId: clip.id,\n        sessionId,\n        planner: this.deps.planner,\n        workerPool: this.deps.workerPool,\n        cacheManager: this.deps.cacheManager,\n        compositionModel: model,\n        workerConfigs: this.deps.workerConfigsProvider(),\n        resourceLoader: this.deps.resourceLoader,\n        callbacks: {\n          onEncodedStreamReady: async (stream, track) => {\n            if (track === 'video') {\n              const reader = stream.getReader();\n              try {\n                while (true) {\n                  await checkStatus();\n\n                  const { done, value } = await reader.read();\n                  if (done) break;\n                  if (value) {\n                    const originalChunk = value.chunk;\n                    const metadata = value.metadata;\n                    const chunkDuration = originalChunk.duration ?? 33333; // Default ~30fps\n\n                    const remappedTimestamp = originalChunk.timestamp + currentClipOffsetUs;\n\n                    const buffer = new ArrayBuffer(originalChunk.byteLength);\n                    originalChunk.copyTo(buffer);\n\n                    const remappedChunk = new EncodedVideoChunk({\n                      type: originalChunk.type,\n                      timestamp: remappedTimestamp,\n                      duration: chunkDuration,\n                      data: buffer,\n                    });\n\n                    muxManager.writeVideoChunk(remappedChunk, metadata);\n\n                    // Track end time for next clip's offset\n                    lastChunkEndUs = remappedTimestamp + chunkDuration;\n\n                    // Emit progress: 40-100%\n                    const encodingProgress = remappedTimestamp / model.durationUs;\n                    const totalProgress = 0.4 + encodingProgress * 0.6; // 40% + (0-60%)\n\n                    this.deps.eventBus.emit(MeframeEvent.ExportProgress, {\n                      progress: Math.min(1.0, totalProgress),\n                      stage: 'encoding',\n                      timeUs: remappedTimestamp,\n                    });\n                  }\n                }\n                streamFinishedResolver();\n              } catch (error) {\n                if (error instanceof DOMException && error.name === 'AbortError') {\n                  streamFinishedRejecter(error);\n                } else {\n                  console.error(`[ExportScheduler] Stream error for clip ${clip.id}:`, error);\n                  streamFinishedRejecter(error);\n                }\n              } finally {\n                reader.releaseLock();\n              }\n            }\n          },\n          // Note: Attachment resources are loaded in VideoClipSession.connectPipeline\n          // before sending video stream, ensuring watermarks appear from the first frame\n        },\n      });\n\n      await session.activate();\n      await streamFinishedPromise;\n\n      await session.dispose();\n\n      // Use actual last chunk end time as next clip's start\n      // This ensures no timestamp overlap even after muxer rounding\n      nextClipStartUs = lastChunkEndUs;\n    }\n  }\n}\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"ExportScheduler.js","sources":["../../src/orchestrator/ExportScheduler.ts"],"sourcesContent":["import { CompositionModel } from '../model';\nimport { ExportOptions } from '../types';\nimport { WorkerPool } from '../worker/WorkerPool';\nimport { CompositionPlanner } from './CompositionPlanner';\nimport { CacheManager } from '../cache/CacheManager';\nimport { ResourceLoader } from '../stages/load/ResourceLoader';\nimport { MuxManager } from '../stages/mux/MuxManager';\nimport { AudioExportSession } from './AudioExportSession';\nimport { VideoClipSession } from './VideoClipSession';\nimport { WorkerType } from '../worker/types';\nimport { hasResourceId, type TimeUs } from '../model/types';\nimport type { ExportController } from '../controllers/ExportController';\nimport { EventBus } from '../event/EventBus';\nimport { MeframeEvent, EventPayloadMap } from '../event/events';\nimport { AudioChunkEncoder } from '../stages/encode/AudioChunkEncoder';\n\ninterface ExportSchedulerDeps {\n  workerPool: WorkerPool;\n  planner: CompositionPlanner;\n  cacheManager: CacheManager;\n  resourceLoader: ResourceLoader;\n  muxManager: MuxManager;\n  audioSession: AudioExportSession;\n  workerConfigsProvider: () => Record<WorkerType, any>;\n  eventBus: EventBus<EventPayloadMap>;\n}\n\ninterface ExtendedExportOptions extends ExportOptions {\n  signal?: AbortSignal;\n  controller?: ExportController;\n  exportMode?: 'blob' | 'stream';\n  onMuxData?: (data: Uint8Array, position: number) => void;\n  muxChunkSizeBytes?: number;\n  muxChunked?: boolean;\n}\n\nexport class ExportScheduler {\n  private deps: ExportSchedulerDeps;\n\n  constructor(deps: ExportSchedulerDeps) {\n    this.deps = deps;\n  }\n\n  async execute(model: CompositionModel, options: ExtendedExportOptions): Promise<Blob | null> {\n    this.deps.cacheManager.clear();\n\n    const projectId = this.deps.cacheManager.resourceCache.projectId;\n\n    if (!navigator.locks) {\n      return this.executeInternal(model, options);\n    }\n\n    const lockName = `meframe-resource-${projectId}`;\n    return navigator.locks.request(lockName, () => this.executeInternal(model, options));\n  }\n\n  private async executeInternal(\n    model: CompositionModel,\n    options: ExtendedExportOptions\n  ): Promise<Blob | null> {\n    const { muxManager, audioSession, eventBus, resourceLoader } = this.deps;\n    const signal = options.signal;\n    const controller = options.controller;\n    const exportMode = options.exportMode ?? 'blob';\n\n    if (exportMode === 'stream' && typeof options.onMuxData !== 'function') {\n      throw new Error('onMuxData callback is required when exportMode is stream');\n    }\n\n    let streamedBytes = 0;\n\n    const checkStatus = async () => {\n      if (signal?.aborted) {\n        throw new DOMException('Export aborted', 'AbortError');\n      }\n      // TODO: ugly\n      if (controller?.isPaused()) {\n        // Wait until resumed\n        while (controller.isPaused()) {\n          if (signal?.aborted) throw new DOMException('Export aborted', 'AbortError');\n          await new Promise((resolve) => setTimeout(resolve, 100));\n        }\n      }\n    };\n\n    const width = options.width || model.renderConfig?.width || 720;\n    const height = options.height || model.renderConfig?.height || 1280;\n    const fps = options.fps || model.fps || 30;\n\n    eventBus.emit(MeframeEvent.ExportStart, {\n      format: options.format || 'mp4',\n      width,\n      height,\n      fps,\n      durationUs: model.durationUs,\n    });\n\n    this.deps.cacheManager.beginExport();\n\n    try {\n      // 1. Preload and parse all resources (0-40%)\n      await this.preloadResources(model, resourceLoader, eventBus, checkStatus);\n\n      const hasAudioSamples = this.deps.cacheManager.audioSampleCache.getTotalBytes() > 0;\n      const { enableAudio, disabledReason } = await this.decideAudioStrategy({\n        hasAudioSamples,\n        requestedFormat: options.format ?? 'mp4',\n        requestedAudioCodec: options.audioCodec ?? 'aac',\n      });\n      if (disabledReason) {\n        eventBus.emit(MeframeEvent.ExportProgress, {\n          progress: 0.4,\n          stage: 'encoding',\n          message: disabledReason,\n        });\n      }\n\n      // 2. Start Muxer\n      muxManager.start({\n        width,\n        height,\n        fps,\n        enableAudio,\n        output:\n          exportMode === 'stream'\n            ? {\n                kind: 'stream',\n                onData: (data, position) => {\n                  streamedBytes = Math.max(streamedBytes, position + data.byteLength);\n                  options.onMuxData?.(data, position);\n                },\n                chunkSize: options.muxChunkSizeBytes,\n                chunked: options.muxChunked,\n              }\n            : { kind: 'blob' },\n      });\n\n      // 3. Process Video and Audio\n      const mainTrack = model.tracks.find((t) => t.id === model.mainTrackId);\n      if (mainTrack && mainTrack.clips.length > 0) {\n        const audioPromise = enableAudio\n          ? this.processAudioInWindows(model.durationUs, audioSession, muxManager, checkStatus)\n          : Promise.resolve();\n\n        // Process video clips sequentially\n        await this.processVideoClipsSequentially(mainTrack.clips, muxManager, model, checkStatus);\n\n        // Wait for audio encoding to complete\n        try {\n          await audioPromise;\n        } catch (error) {\n          // If audio encode fails (e.g. unsupported AAC), keep export running as video-only MP4.\n          eventBus.emit(MeframeEvent.ExportProgress, {\n            progress: 0.95,\n            stage: 'encoding',\n            message: `Audio skipped (runtime failure): ${error instanceof Error ? error.message : String(error)}`,\n          });\n        }\n      } else {\n        console.warn('[ExportScheduler] No video clips found');\n      }\n\n      // Finalize audio session (close encoder)\n      await audioSession.finalizeExportAudio();\n\n      if (signal?.aborted) {\n        throw new DOMException('Export aborted', 'AbortError');\n      }\n\n      // 4. Finalize\n      const blob = await muxManager.finalize();\n\n      eventBus.emit(MeframeEvent.ExportComplete, {\n        size: blob?.size ?? streamedBytes,\n        durationMs: model.durationUs / 1000,\n        format: options.format || 'mp4',\n      });\n\n      // Some clients rely on a final progress=1 event to mark completion (e.g. UI progress bars).\n      // Keep it emitted after ExportComplete for backward compatibility.\n      eventBus.emit(MeframeEvent.ExportProgress, {\n        progress: 1,\n        stage: 'muxing',\n      });\n\n      return blob;\n    } catch (error) {\n      eventBus.emit(MeframeEvent.ExportError, {\n        error: error instanceof Error ? error : new Error(String(error)),\n        stage: 'export',\n      });\n      throw error;\n    } finally {\n      this.deps.cacheManager.endExport();\n    }\n  }\n\n  /**\n   * Preload all resources (0-40% progress)\n   */\n  private async preloadResources(\n    model: CompositionModel,\n    resourceLoader: ResourceLoader,\n    eventBus: EventBus<EventPayloadMap>,\n    checkStatus: () => Promise<void>\n  ): Promise<void> {\n    eventBus.emit(MeframeEvent.ExportProgress, {\n      progress: 0,\n      stage: 'preparing',\n      message: 'Loading and parsing resources...',\n    });\n\n    // Collect resources in horizontal order (clip index priority)\n    const tracks = model.tracks.filter((track) => ['video', 'audio'].includes(track.kind));\n    if (tracks.length === 0) return;\n\n    const maxClipCount = Math.max(...tracks.map((track) => track.clips.length));\n    const resourcesToLoad: string[] = [];\n    const seen = new Set<string>();\n\n    // Horizontal collection: clip[0] from all tracks, then clip[1], etc.\n    for (let clipIndex = 0; clipIndex < maxClipCount; clipIndex++) {\n      for (const track of tracks) {\n        const clip = track.clips[clipIndex];\n        if (clip && hasResourceId(clip)) {\n          if (!seen.has(clip.resourceId)) {\n            seen.add(clip.resourceId);\n            resourcesToLoad.push(clip.resourceId);\n          }\n        }\n      }\n    }\n\n    // Load resources with progress updates (concurrent; ResourceLoader already enforces maxConcurrent).\n    const total = resourcesToLoad.length;\n    let completed = 0;\n\n    await Promise.all(\n      resourcesToLoad.map(async (resourceId) => {\n        await checkStatus();\n        await resourceLoader.load(resourceId, { isPreload: false });\n\n        // Export must be strict: if a resource is in error state (including terminal mismatch),\n        // fail fast instead of silently producing a partial/blank output.\n        const resource = model.getResource(resourceId);\n        if (resource?.state === 'error') {\n          const details = resource.error?.message ?? 'Unknown resource error';\n          throw new Error(`Export preload failed for ${resourceId}: ${details}`);\n        }\n\n        completed++;\n\n        // Update progress: 0-40%\n        const progress = total > 0 ? (completed / total) * 0.4 : 0.4;\n        eventBus.emit(MeframeEvent.ExportProgress, {\n          progress,\n          stage: 'preparing',\n          message: `Loading resources... (${completed}/${total})`,\n        });\n      })\n    );\n  }\n\n  /**\n   * Process audio in 60-second windows\n   * - Videos ≤60s: Single pass (zero boundaries)\n   * - Videos >60s: 60s windows (minimal boundaries, ~23MB per window)\n   */\n  private async processAudioInWindows(\n    totalDurationUs: TimeUs,\n    audioSession: AudioExportSession,\n    muxManager: MuxManager,\n    checkStatus: () => Promise<void>\n  ): Promise<void> {\n    const WINDOW_DURATION_US = 5 * 60 * 1_000_000; // 5 minutes\n    let currentUs = 0;\n\n    while (currentUs < totalDurationUs) {\n      await checkStatus();\n\n      const endUs = Math.min(currentUs + WINDOW_DURATION_US, totalDurationUs);\n\n      await audioSession.mixAndEncodeSegment(currentUs, endUs, (chunk, meta) =>\n        muxManager.writeAudioChunk(chunk, meta)\n      );\n\n      // Clear audio cache after encoding each window to prevent memory accumulation\n      // This is safe because audio data is already encoded and won't be reused\n      this.deps.cacheManager.clearAudioCache();\n\n      currentUs = endUs;\n    }\n  }\n\n  private async processVideoClipsSequentially(\n    clips: any[],\n    muxManager: MuxManager,\n    model: CompositionModel,\n    checkStatus: () => Promise<void>\n  ) {\n    // Use actual last written timestamp + duration as offset for next clip\n    // This avoids duplicate PTS when mp4-muxer rounds microseconds to timescale\n    let nextClipStartUs = 0;\n    // Track last chunk's end time (timestamp + duration) for precise offset calculation\n    let lastChunkEndUs = 0;\n\n    for (let i = 0; i < clips.length; i++) {\n      const clip = clips[i];\n      const currentClipOffsetUs = nextClipStartUs;\n\n      await checkStatus(); // Check before starting new clip\n\n      const sessionId = `${clip.id}-export`;\n      let streamFinishedResolver: () => void;\n      let streamFinishedRejecter: (err: any) => void;\n      const streamFinishedPromise = new Promise<void>((resolve, reject) => {\n        streamFinishedResolver = resolve;\n        streamFinishedRejecter = reject;\n      });\n\n      const session = await VideoClipSession.create({\n        clipId: clip.id,\n        sessionId,\n        planner: this.deps.planner,\n        workerPool: this.deps.workerPool,\n        cacheManager: this.deps.cacheManager,\n        compositionModel: model,\n        workerConfigs: this.deps.workerConfigsProvider(),\n        resourceLoader: this.deps.resourceLoader,\n        callbacks: {\n          onEncodedStreamReady: async (stream, track) => {\n            if (track === 'video') {\n              const reader = stream.getReader();\n              try {\n                while (true) {\n                  await checkStatus();\n\n                  const { done, value } = await reader.read();\n                  if (done) break;\n                  if (value) {\n                    const originalChunk = value.chunk;\n                    const metadata = value.metadata;\n                    const chunkDuration = originalChunk.duration ?? 33333; // Default ~30fps\n\n                    const remappedTimestamp = originalChunk.timestamp + currentClipOffsetUs;\n\n                    const buffer = new ArrayBuffer(originalChunk.byteLength);\n                    originalChunk.copyTo(buffer);\n\n                    const remappedChunk = new EncodedVideoChunk({\n                      type: originalChunk.type,\n                      timestamp: remappedTimestamp,\n                      duration: chunkDuration,\n                      data: buffer,\n                    });\n\n                    muxManager.writeVideoChunk(remappedChunk, metadata);\n\n                    // Track end time for next clip's offset\n                    lastChunkEndUs = remappedTimestamp + chunkDuration;\n\n                    // Emit progress: 40-100%\n                    const encodingProgress = remappedTimestamp / model.durationUs;\n                    const totalProgress = 0.4 + encodingProgress * 0.6; // 40% + (0-60%)\n\n                    this.deps.eventBus.emit(MeframeEvent.ExportProgress, {\n                      progress: Math.min(1.0, totalProgress),\n                      stage: 'encoding',\n                      timeUs: remappedTimestamp,\n                    });\n                  }\n                }\n                streamFinishedResolver();\n              } catch (error) {\n                if (error instanceof DOMException && error.name === 'AbortError') {\n                  streamFinishedRejecter(error);\n                } else {\n                  console.error(`[ExportScheduler] Stream error for clip ${clip.id}:`, error);\n                  streamFinishedRejecter(error);\n                }\n              } finally {\n                reader.releaseLock();\n              }\n            }\n          },\n          // Note: Attachment resources are loaded in VideoClipSession.connectPipeline\n          // before sending video stream, ensuring watermarks appear from the first frame\n        },\n      });\n\n      await session.activate();\n      await streamFinishedPromise;\n\n      await session.dispose();\n\n      // Use actual last chunk end time as next clip's start\n      // This ensures no timestamp overlap even after muxer rounding\n      nextClipStartUs = lastChunkEndUs;\n    }\n  }\n\n  private async decideAudioStrategy(input: {\n    hasAudioSamples: boolean;\n    requestedFormat: NonNullable<ExportOptions['format']>;\n    requestedAudioCodec: NonNullable<ExportOptions['audioCodec']>;\n  }): Promise<{ enableAudio: boolean; disabledReason?: string }> {\n    if (!input.hasAudioSamples) {\n      return { enableAudio: false };\n    }\n\n    // Current implementation is MP4-only muxing.\n    if (input.requestedFormat !== 'mp4') {\n      return {\n        enableAudio: false,\n        disabledReason: `Audio skipped: format ${input.requestedFormat} is not supported.`,\n      };\n    }\n\n    // MP4 mux currently assumes AAC.\n    if (input.requestedAudioCodec !== 'aac') {\n      return {\n        enableAudio: false,\n        disabledReason: `Audio skipped: mp4 output currently supports only AAC (requested ${input.requestedAudioCodec}).`,\n      };\n    }\n\n    // Probe AAC support in WebCodecs. On some Linux Chrome builds AAC encode is unavailable.\n    if (typeof AudioEncoder === 'undefined') {\n      return {\n        enableAudio: false,\n        disabledReason:\n          'Audio skipped: WebCodecs AudioEncoder is not available in this browser/runtime (AAC required for mp4).',\n      };\n    }\n\n    const support = await AudioEncoder.isConfigSupported(AudioChunkEncoder.DEFAULT_CONFIG);\n    if (!support.supported) {\n      return {\n        enableAudio: false,\n        disabledReason:\n          'Audio skipped: WebCodecs AAC (mp4a.40.2) AudioEncoder is not supported in this browser/runtime.',\n      };\n    }\n\n    return { enableAudio: true };\n  }\n}\n"],"names":[],"mappings":"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"}

package/dist/stages/mux/MP4Muxer.d.ts

@@ -25,6 +25,7 @@ export declare class MP4Muxer {
         fastStart?: false | 'in-memory' | 'fragmented';
         videoChunkMeta?: any;
         audioChunkMeta?: any;
+        enableAudio?: boolean;
     }, output?: MuxOutputConfig);
     private videoChunkCount;
     writeVideoChunk(chunk: EncodedVideoChunk, metadata?: EncodedVideoChunkMetadata): void;

package/dist/stages/mux/MP4Muxer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"MP4Muxer.d.ts","sourceRoot":"","sources":["../../../src/stages/mux/MP4Muxer.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,eAAe,GACvB;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAChB;IACE,IAAI,EAAE,QAAQ,CAAC;IACf,MAAM,EAAE,CAAC,IAAI,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;IACrD,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEN;;;GAGG;AACH,qBAAa,QAAQ;IACnB,OAAO,CAAC,KAAK,CAA0C;IACvD,OAAO,CAAC,eAAe,CAAQ;IAC/B,OAAO,CAAC,eAAe,CAAQ;IAC/B,OAAO,CAAC,cAAc,CAAa;IACnC,OAAO,CAAC,cAAc,CAAa;IACnC,OAAO,CAAC,mBAAmB,CAAuB;IAClD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAU;gBAGjC,MAAM,EAAE;QACN,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,MAAM,CAAC;QACf,GAAG,EAAE,MAAM,CAAC;QACZ,SAAS,CAAC,EAAE,KAAK,GAAG,WAAW,GAAG,YAAY,CAAC;QAC/C,cAAc,CAAC,EAAE,GAAG,CAAC;QACrB,cAAc,CAAC,EAAE,GAAG,CAAC;KACtB,EACD,MAAM,GAAE,eAAkC;IAuD5C,OAAO,CAAC,eAAe,CAAK;IAE5B,eAAe,CAAC,KAAK,EAAE,iBAAiB,EAAE,QAAQ,CAAC,EAAE,yBAAyB,GAAG,IAAI;IAwBrF,OAAO,CAAC,eAAe,CAAK;IAE5B,eAAe,CAAC,KAAK,EAAE,iBAAiB,EAAE,QAAQ,CAAC,EAAE,yBAAyB,GAAG,IAAI;IAuDrF,QAAQ,IAAI,IAAI,GAAG,IAAI;CASxB"}
+{"version":3,"file":"MP4Muxer.d.ts","sourceRoot":"","sources":["../../../src/stages/mux/MP4Muxer.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,eAAe,GACvB;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAChB;IACE,IAAI,EAAE,QAAQ,CAAC;IACf,MAAM,EAAE,CAAC,IAAI,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;IACrD,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEN;;;GAGG;AACH,qBAAa,QAAQ;IACnB,OAAO,CAAC,KAAK,CAA0C;IACvD,OAAO,CAAC,eAAe,CAAQ;IAC/B,OAAO,CAAC,eAAe,CAAQ;IAC/B,OAAO,CAAC,cAAc,CAAa;IACnC,OAAO,CAAC,cAAc,CAAa;IACnC,OAAO,CAAC,mBAAmB,CAAuB;IAClD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAU;gBAGjC,MAAM,EAAE;QACN,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,MAAM,CAAC;QACf,GAAG,EAAE,MAAM,CAAC;QACZ,SAAS,CAAC,EAAE,KAAK,GAAG,WAAW,GAAG,YAAY,CAAC;QAC/C,cAAc,CAAC,EAAE,GAAG,CAAC;QACrB,cAAc,CAAC,EAAE,GAAG,CAAC;QACrB,WAAW,CAAC,EAAE,OAAO,CAAC;KACvB,EACD,MAAM,GAAE,eAAkC;IAyC5C,OAAO,CAAC,eAAe,CAAK;IAE5B,eAAe,CAAC,KAAK,EAAE,iBAAiB,EAAE,QAAQ,CAAC,EAAE,yBAAyB,GAAG,IAAI;IAwBrF,OAAO,CAAC,eAAe,CAAK;IAE5B,eAAe,CAAC,KAAK,EAAE,iBAAiB,EAAE,QAAQ,CAAC,EAAE,yBAAyB,GAAG,IAAI;IAuDrF,QAAQ,IAAI,IAAI,GAAG,IAAI;CASxB"}

package/dist/stages/mux/MP4Muxer.js

@@ -29,11 +29,14 @@ class MP4Muxer {
       fastStart: config.fastStart ?? "in-memory",
       firstTimestampBehavior: "offset"
     };
-    muxerConfig.audio = {
-      codec: "aac",
-      sampleRate: this.audioChunkMeta?.sampleRate || 48e3,
-      numberOfChannels: this.audioChunkMeta?.numberOfChannels || 2
-    };
+    const enableAudio = config.enableAudio ?? true;
+    if (enableAudio) {
+      muxerConfig.audio = {
+        codec: "aac",
+        sampleRate: this.audioChunkMeta?.sampleRate || 48e3,
+        numberOfChannels: this.audioChunkMeta?.numberOfChannels || 2
+      };
+    }
     this.muxer = new Muxer(muxerConfig);
   }
   videoChunkCount = 0;

package/dist/stages/mux/MP4Muxer.js.map

@@ -1 +1 @@
-{"version":3,"file":"MP4Muxer.js","sources":["../../../src/stages/mux/MP4Muxer.ts"],"sourcesContent":["import { Muxer, ArrayBufferTarget, StreamTarget } from 'mp4-muxer';\nimport { checkBrowserCompatibility } from '../../utils/platform-utils';\n\nexport type MuxOutputConfig =\n  | { kind: 'blob' }\n  | {\n      kind: 'stream';\n      onData: (data: Uint8Array, position: number) => void;\n      chunked?: boolean;\n      chunkSize?: number;\n    };\n\n/**\n * MP4Muxer - MP4 container multiplexer using mp4-muxer library\n * Supports video and audio track export\n */\nexport class MP4Muxer {\n  private muxer: Muxer<ArrayBufferTarget | StreamTarget>;\n  private firstVideoChunk = true;\n  private firstAudioChunk = true;\n  private videoChunkMeta: any = null;\n  private audioChunkMeta: any = null;\n  private lastAudioDurationUs: number | null = null;\n  private readonly isSafari: boolean;\n\n  constructor(\n    config: {\n      width: number;\n      height: number;\n      fps: number;\n      fastStart?: false | 'in-memory' | 'fragmented';\n      videoChunkMeta?: any;\n      audioChunkMeta?: any;\n    },\n    output: MuxOutputConfig = { kind: 'blob' }\n  ) {\n    this.isSafari = checkBrowserCompatibility().browserInfo.name === 'Safari';\n\n    this.videoChunkMeta = config.videoChunkMeta;\n    this.audioChunkMeta = config.audioChunkMeta;\n\n    const target =\n      output.kind === 'stream'\n        ? new StreamTarget({\n            onData: output.onData,\n            chunked: output.chunked ?? true,\n            chunkSize: output.chunkSize ?? 16 * 1024 * 1024, // 16 MiB default to reduce writes\n          })\n        : new ArrayBufferTarget();\n\n    const muxerConfig: any = {\n      target,\n      video: {\n        codec: 'avc',\n        width: config.width,\n        height: config.height,\n        frameRate: config.fps,\n      },\n      fastStart: config.fastStart ?? 'in-memory',\n      firstTimestampBehavior: 'offset',\n    };\n\n    // Add audio configuration if provided\n    // If not provided initially, we assume AAC (standard for web)\n    // but mp4-muxer might need it.\n    // Actually mp4-muxer allows adding track configuration later?\n    // No, it requires it in constructor or inferred?\n    // If audioChunkMeta is missing, we can't configure audio fully here.\n    // But mp4-muxer docs say: \"If you don't provide options.audio, no audio track will be created.\"\n    // So we MUST provide options.audio if we want audio.\n    // If we don't have meta yet, we guess?\n    // Or we rely on audio export always providing AAC 48k?\n    // Let's assume AAC 48k 2ch as default if we want audio support.\n    // Or better: if audioChunkMeta is null, we enable audio with defaults.\n\n    // However, for robustness, we should probably wait for first chunk to configure muxer?\n    // But MuxManager calls `start` then `writeVideoChunk` then `writeAudioChunk`.\n    // Audio might come later.\n    //\n    // Let's assume we always want audio track capability.\n    muxerConfig.audio = {\n      codec: 'aac',\n      sampleRate: this.audioChunkMeta?.sampleRate || 48000,\n      numberOfChannels: this.audioChunkMeta?.numberOfChannels || 2,\n    };\n\n    this.muxer = new Muxer(muxerConfig);\n  }\n\n  private videoChunkCount = 0;\n\n  writeVideoChunk(chunk: EncodedVideoChunk, metadata?: EncodedVideoChunkMetadata): void {\n    let meta: EncodedVideoChunkMetadata | undefined;\n\n    if (this.firstVideoChunk) {\n      if (metadata && metadata.decoderConfig) {\n        this.videoChunkMeta = metadata.decoderConfig;\n      }\n\n      if (this.videoChunkMeta) {\n        meta = { decoderConfig: this.videoChunkMeta };\n      }\n\n      // Ensure we have metadata for first chunk if it's a keyframe\n      if (chunk.type === 'key' && !meta) {\n        console.warn('[MP4Muxer] First video chunk is keyframe but missing decoderConfig');\n      }\n\n      this.firstVideoChunk = false;\n    }\n\n    this.videoChunkCount++;\n    this.muxer.addVideoChunk(chunk, meta);\n  }\n\n  private audioChunkCount = 0;\n\n  writeAudioChunk(chunk: EncodedAudioChunk, metadata?: EncodedAudioChunkMetadata): void {\n    const isTiny = chunk.byteLength <= 16;\n    // Safari may emit tiny (e.g. 6 bytes) \"audio\" chunks that are not valid AAC frames.\n    // If we mux them, Safari may treat the whole audio track as undecodable (no sound).\n    if (isTiny) {\n      if (this.isSafari) return;\n\n      // mp4-muxer treats durations as authoritative; dropping *valid* small chunks can collapse silence gaps and cause stutter.\n      // So (non-Safari) only drop tiny chunks when they are clearly invalid (duration missing/<=0).\n      if (!chunk.duration || chunk.duration <= 0) return;\n    }\n\n    let meta: EncodedAudioChunkMetadata | undefined;\n\n    if (this.firstAudioChunk) {\n      if (metadata && metadata.decoderConfig) {\n        this.audioChunkMeta = metadata.decoderConfig;\n      }\n\n      if (this.audioChunkMeta) {\n        meta = { decoderConfig: this.audioChunkMeta };\n      }\n\n      this.firstAudioChunk = false;\n    }\n\n    // Some platforms output duration=0/undefined for audio chunks.\n    // mp4-muxer uses duration to build the timeline; 0 duration can collapse time and remove intended gaps.\n    // Try to synthesize a sane duration:\n    // - Prefer the chunk's own duration when >0\n    // - Otherwise use AAC-LC frame duration (1024 samples) inferred from decoderConfig sampleRate if known\n    const hasValidDuration = !!chunk.duration && chunk.duration > 0;\n    if (!hasValidDuration) {\n      const sampleRate =\n        (metadata as any)?.decoderConfig?.sampleRate ?? this.audioChunkMeta?.sampleRate ?? 48_000;\n      const inferredDurationUs =\n        this.lastAudioDurationUs ?? Math.max(1, Math.round((1024 / sampleRate) * 1_000_000));\n\n      const buffer = new ArrayBuffer(chunk.byteLength);\n      chunk.copyTo(buffer);\n      chunk = new EncodedAudioChunk({\n        type: chunk.type,\n        timestamp: chunk.timestamp,\n        duration: inferredDurationUs,\n        data: buffer,\n      });\n      this.lastAudioDurationUs = inferredDurationUs;\n    } else {\n      this.lastAudioDurationUs = chunk.duration!;\n    }\n\n    this.audioChunkCount++;\n    this.muxer.addAudioChunk(chunk, meta);\n  }\n\n  finalize(): Blob | null {\n    this.muxer.finalize();\n    if (this.muxer.target instanceof ArrayBufferTarget) {\n      const buffer = this.muxer.target.buffer;\n      return new Blob([buffer], { type: 'video/mp4' });\n    }\n    // Stream target has already delivered data via onData callback.\n    return null;\n  }\n}\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"MP4Muxer.js","sources":["../../../src/stages/mux/MP4Muxer.ts"],"sourcesContent":["import { Muxer, ArrayBufferTarget, StreamTarget } from 'mp4-muxer';\nimport { checkBrowserCompatibility } from '../../utils/platform-utils';\n\nexport type MuxOutputConfig =\n  | { kind: 'blob' }\n  | {\n      kind: 'stream';\n      onData: (data: Uint8Array, position: number) => void;\n      chunked?: boolean;\n      chunkSize?: number;\n    };\n\n/**\n * MP4Muxer - MP4 container multiplexer using mp4-muxer library\n * Supports video and audio track export\n */\nexport class MP4Muxer {\n  private muxer: Muxer<ArrayBufferTarget | StreamTarget>;\n  private firstVideoChunk = true;\n  private firstAudioChunk = true;\n  private videoChunkMeta: any = null;\n  private audioChunkMeta: any = null;\n  private lastAudioDurationUs: number | null = null;\n  private readonly isSafari: boolean;\n\n  constructor(\n    config: {\n      width: number;\n      height: number;\n      fps: number;\n      fastStart?: false | 'in-memory' | 'fragmented';\n      videoChunkMeta?: any;\n      audioChunkMeta?: any;\n      enableAudio?: boolean;\n    },\n    output: MuxOutputConfig = { kind: 'blob' }\n  ) {\n    this.isSafari = checkBrowserCompatibility().browserInfo.name === 'Safari';\n\n    this.videoChunkMeta = config.videoChunkMeta;\n    this.audioChunkMeta = config.audioChunkMeta;\n\n    const target =\n      output.kind === 'stream'\n        ? new StreamTarget({\n            onData: output.onData,\n            chunked: output.chunked ?? true,\n            chunkSize: output.chunkSize ?? 16 * 1024 * 1024, // 16 MiB default to reduce writes\n          })\n        : new ArrayBufferTarget();\n\n    const muxerConfig: any = {\n      target,\n      video: {\n        codec: 'avc',\n        width: config.width,\n        height: config.height,\n        frameRate: config.fps,\n      },\n      fastStart: config.fastStart ?? 'in-memory',\n      firstTimestampBehavior: 'offset',\n    };\n\n    const enableAudio = config.enableAudio ?? true;\n    // mp4-muxer: If you don't provide options.audio, no audio track will be created.\n    if (enableAudio) {\n      muxerConfig.audio = {\n        codec: 'aac',\n        sampleRate: this.audioChunkMeta?.sampleRate || 48000,\n        numberOfChannels: this.audioChunkMeta?.numberOfChannels || 2,\n      };\n    }\n\n    this.muxer = new Muxer(muxerConfig);\n  }\n\n  private videoChunkCount = 0;\n\n  writeVideoChunk(chunk: EncodedVideoChunk, metadata?: EncodedVideoChunkMetadata): void {\n    let meta: EncodedVideoChunkMetadata | undefined;\n\n    if (this.firstVideoChunk) {\n      if (metadata && metadata.decoderConfig) {\n        this.videoChunkMeta = metadata.decoderConfig;\n      }\n\n      if (this.videoChunkMeta) {\n        meta = { decoderConfig: this.videoChunkMeta };\n      }\n\n      // Ensure we have metadata for first chunk if it's a keyframe\n      if (chunk.type === 'key' && !meta) {\n        console.warn('[MP4Muxer] First video chunk is keyframe but missing decoderConfig');\n      }\n\n      this.firstVideoChunk = false;\n    }\n\n    this.videoChunkCount++;\n    this.muxer.addVideoChunk(chunk, meta);\n  }\n\n  private audioChunkCount = 0;\n\n  writeAudioChunk(chunk: EncodedAudioChunk, metadata?: EncodedAudioChunkMetadata): void {\n    const isTiny = chunk.byteLength <= 16;\n    // Safari may emit tiny (e.g. 6 bytes) \"audio\" chunks that are not valid AAC frames.\n    // If we mux them, Safari may treat the whole audio track as undecodable (no sound).\n    if (isTiny) {\n      if (this.isSafari) return;\n\n      // mp4-muxer treats durations as authoritative; dropping *valid* small chunks can collapse silence gaps and cause stutter.\n      // So (non-Safari) only drop tiny chunks when they are clearly invalid (duration missing/<=0).\n      if (!chunk.duration || chunk.duration <= 0) return;\n    }\n\n    let meta: EncodedAudioChunkMetadata | undefined;\n\n    if (this.firstAudioChunk) {\n      if (metadata && metadata.decoderConfig) {\n        this.audioChunkMeta = metadata.decoderConfig;\n      }\n\n      if (this.audioChunkMeta) {\n        meta = { decoderConfig: this.audioChunkMeta };\n      }\n\n      this.firstAudioChunk = false;\n    }\n\n    // Some platforms output duration=0/undefined for audio chunks.\n    // mp4-muxer uses duration to build the timeline; 0 duration can collapse time and remove intended gaps.\n    // Try to synthesize a sane duration:\n    // - Prefer the chunk's own duration when >0\n    // - Otherwise use AAC-LC frame duration (1024 samples) inferred from decoderConfig sampleRate if known\n    const hasValidDuration = !!chunk.duration && chunk.duration > 0;\n    if (!hasValidDuration) {\n      const sampleRate =\n        (metadata as any)?.decoderConfig?.sampleRate ?? this.audioChunkMeta?.sampleRate ?? 48_000;\n      const inferredDurationUs =\n        this.lastAudioDurationUs ?? Math.max(1, Math.round((1024 / sampleRate) * 1_000_000));\n\n      const buffer = new ArrayBuffer(chunk.byteLength);\n      chunk.copyTo(buffer);\n      chunk = new EncodedAudioChunk({\n        type: chunk.type,\n        timestamp: chunk.timestamp,\n        duration: inferredDurationUs,\n        data: buffer,\n      });\n      this.lastAudioDurationUs = inferredDurationUs;\n    } else {\n      this.lastAudioDurationUs = chunk.duration!;\n    }\n\n    this.audioChunkCount++;\n    this.muxer.addAudioChunk(chunk, meta);\n  }\n\n  finalize(): Blob | null {\n    this.muxer.finalize();\n    if (this.muxer.target instanceof ArrayBufferTarget) {\n      const buffer = this.muxer.target.buffer;\n      return new Blob([buffer], { type: 'video/mp4' });\n    }\n    // Stream target has already delivered data via onData callback.\n    return null;\n  }\n}\n"],"names":[],"mappings":";;AAgBO,MAAM,SAAS;AAAA,EACZ;AAAA,EACA,kBAAkB;AAAA,EAClB,kBAAkB;AAAA,EAClB,iBAAsB;AAAA,EACtB,iBAAsB;AAAA,EACtB,sBAAqC;AAAA,EAC5B;AAAA,EAEjB,YACE,QASA,SAA0B,EAAE,MAAM,UAClC;AACA,SAAK,WAAW,0BAAA,EAA4B,YAAY,SAAS;AAEjE,SAAK,iBAAiB,OAAO;AAC7B,SAAK,iBAAiB,OAAO;AAE7B,UAAM,SACJ,OAAO,SAAS,WACZ,IAAI,aAAa;AAAA,MACf,QAAQ,OAAO;AAAA,MACf,SAAS,OAAO,WAAW;AAAA,MAC3B,WAAW,OAAO,aAAa,KAAK,OAAO;AAAA;AAAA,IAAA,CAC5C,IACD,IAAI,kBAAA;AAEV,UAAM,cAAmB;AAAA,MACvB;AAAA,MACA,OAAO;AAAA,QACL,OAAO;AAAA,QACP,OAAO,OAAO;AAAA,QACd,QAAQ,OAAO;AAAA,QACf,WAAW,OAAO;AAAA,MAAA;AAAA,MAEpB,WAAW,OAAO,aAAa;AAAA,MAC/B,wBAAwB;AAAA,IAAA;AAG1B,UAAM,cAAc,OAAO,eAAe;AAE1C,QAAI,aAAa;AACf,kBAAY,QAAQ;AAAA,QAClB,OAAO;AAAA,QACP,YAAY,KAAK,gBAAgB,cAAc;AAAA,QAC/C,kBAAkB,KAAK,gBAAgB,oBAAoB;AAAA,MAAA;AAAA,IAE/D;AAEA,SAAK,QAAQ,IAAI,MAAM,WAAW;AAAA,EACpC;AAAA,EAEQ,kBAAkB;AAAA,EAE1B,gBAAgB,OAA0B,UAA4C;AACpF,QAAI;AAEJ,QAAI,KAAK,iBAAiB;AACxB,UAAI,YAAY,SAAS,eAAe;AACtC,aAAK,iBAAiB,SAAS;AAAA,MACjC;AAEA,UAAI,KAAK,gBAAgB;AACvB,eAAO,EAAE,eAAe,KAAK,eAAA;AAAA,MAC/B;AAGA,UAAI,MAAM,SAAS,SAAS,CAAC,MAAM;AACjC,gBAAQ,KAAK,oEAAoE;AAAA,MACnF;AAEA,WAAK,kBAAkB;AAAA,IACzB;AAEA,SAAK;AACL,SAAK,MAAM,cAAc,OAAO,IAAI;AAAA,EACtC;AAAA,EAEQ,kBAAkB;AAAA,EAE1B,gBAAgB,OAA0B,UAA4C;AACpF,UAAM,SAAS,MAAM,cAAc;AAGnC,QAAI,QAAQ;AACV,UAAI,KAAK,SAAU;AAInB,UAAI,CAAC,MAAM,YAAY,MAAM,YAAY,EAAG;AAAA,IAC9C;AAEA,QAAI;AAEJ,QAAI,KAAK,iBAAiB;AACxB,UAAI,YAAY,SAAS,eAAe;AACtC,aAAK,iBAAiB,SAAS;AAAA,MACjC;AAEA,UAAI,KAAK,gBAAgB;AACvB,eAAO,EAAE,eAAe,KAAK,eAAA;AAAA,MAC/B;AAEA,WAAK,kBAAkB;AAAA,IACzB;AAOA,UAAM,mBAAmB,CAAC,CAAC,MAAM,YAAY,MAAM,WAAW;AAC9D,QAAI,CAAC,kBAAkB;AACrB,YAAM,aACH,UAAkB,eAAe,cAAc,KAAK,gBAAgB,cAAc;AACrF,YAAM,qBACJ,KAAK,uBAAuB,KAAK,IAAI,GAAG,KAAK,MAAO,OAAO,aAAc,GAAS,CAAC;AAErF,YAAM,SAAS,IAAI,YAAY,MAAM,UAAU;AAC/C,YAAM,OAAO,MAAM;AACnB,cAAQ,IAAI,kBAAkB;AAAA,QAC5B,MAAM,MAAM;AAAA,QACZ,WAAW,MAAM;AAAA,QACjB,UAAU;AAAA,QACV,MAAM;AAAA,MAAA,CACP;AACD,WAAK,sBAAsB;AAAA,IAC7B,OAAO;AACL,WAAK,sBAAsB,MAAM;AAAA,IACnC;AAEA,SAAK;AACL,SAAK,MAAM,cAAc,OAAO,IAAI;AAAA,EACtC;AAAA,EAEA,WAAwB;AACtB,SAAK,MAAM,SAAA;AACX,QAAI,KAAK,MAAM,kBAAkB,mBAAmB;AAClD,YAAM,SAAS,KAAK,MAAM,OAAO;AACjC,aAAO,IAAI,KAAK,CAAC,MAAM,GAAG,EAAE,MAAM,aAAa;AAAA,IACjD;AAEA,WAAO;AAAA,EACT;AACF;"}

package/dist/stages/mux/MuxManager.d.ts

@@ -9,6 +9,7 @@ export declare class MuxManager {
         height: number;
         fps: number;
         output?: MuxOutputConfig;
+        enableAudio?: boolean;
     }): void;
     writeVideoChunk(chunk: EncodedVideoChunk, metadata?: EncodedVideoChunkMetadata): void;
     writeAudioChunk(chunk: EncodedAudioChunk, metadata?: EncodedAudioChunkMetadata): void;

package/dist/stages/mux/MuxManager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"MuxManager.d.ts","sourceRoot":"","sources":["../../../src/stages/mux/MuxManager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAY,KAAK,eAAe,EAAE,MAAM,YAAY,CAAC;AAE5D,qBAAa,UAAU;IACrB,OAAO,CAAC,KAAK,CAAyB;IACtC,OAAO,CAAC,MAAM,CAAgC;;IAI9C,KAAK,CAAC,MAAM,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,eAAe,CAAA;KAAE;IAgBtF,eAAe,CAAC,KAAK,EAAE,iBAAiB,EAAE,QAAQ,CAAC,EAAE,yBAAyB;IAK9E,eAAe,CAAC,KAAK,EAAE,iBAAiB,EAAE,QAAQ,CAAC,EAAE,yBAAyB;IAS9E,QAAQ,IAAI,IAAI,GAAG,IAAI;CAOxB"}
+{"version":3,"file":"MuxManager.d.ts","sourceRoot":"","sources":["../../../src/stages/mux/MuxManager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAY,KAAK,eAAe,EAAE,MAAM,YAAY,CAAC;AAE5D,qBAAa,UAAU;IACrB,OAAO,CAAC,KAAK,CAAyB;IACtC,OAAO,CAAC,MAAM,CAAgC;;IAI9C,KAAK,CAAC,MAAM,EAAE;QACZ,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,MAAM,CAAC;QACf,GAAG,EAAE,MAAM,CAAC;QACZ,MAAM,CAAC,EAAE,eAAe,CAAC;QACzB,WAAW,CAAC,EAAE,OAAO,CAAC;KACvB;IAiBD,eAAe,CAAC,KAAK,EAAE,iBAAiB,EAAE,QAAQ,CAAC,EAAE,yBAAyB;IAK9E,eAAe,CAAC,KAAK,EAAE,iBAAiB,EAAE,QAAQ,CAAC,EAAE,yBAAyB;IAS9E,QAAQ,IAAI,IAAI,GAAG,IAAI;CAOxB"}

package/dist/stages/mux/MuxManager.js

@@ -13,7 +13,8 @@ class MuxManager {
         fps: config.fps,
         // For blob output, prefer fast start by keeping chunks in memory.
         // For stream output, prefer minimal memory usage: metadata at end (non-fMP4).
-        fastStart: this.output.kind === "stream" ? false : "in-memory"
+        fastStart: this.output.kind === "stream" ? false : "in-memory",
+        enableAudio: config.enableAudio ?? true
         // Metadata will be handled by first chunks
       },
       this.output

package/dist/stages/mux/MuxManager.js.map

@@ -1 +1 @@
-{"version":3,"file":"MuxManager.js","sources":["../../../src/stages/mux/MuxManager.ts"],"sourcesContent":["import { MP4Muxer, type MuxOutputConfig } from './MP4Muxer';\n\nexport class MuxManager {\n  private muxer: MP4Muxer | null = null;\n  private output: MuxOutputConfig | null = null;\n\n  constructor() {}\n\n  start(config: { width: number; height: number; fps: number; output?: MuxOutputConfig }) {\n    this.output = config.output ?? { kind: 'blob' };\n    this.muxer = new MP4Muxer(\n      {\n        width: config.width,\n        height: config.height,\n        fps: config.fps,\n        // For blob output, prefer fast start by keeping chunks in memory.\n        // For stream output, prefer minimal memory usage: metadata at end (non-fMP4).\n        fastStart: this.output.kind === 'stream' ? false : 'in-memory',\n        // Metadata will be handled by first chunks\n      },\n      this.output\n    );\n  }\n\n  writeVideoChunk(chunk: EncodedVideoChunk, metadata?: EncodedVideoChunkMetadata) {\n    if (!this.muxer) throw new Error('Muxer not started');\n    this.muxer.writeVideoChunk(chunk, metadata);\n  }\n\n  writeAudioChunk(chunk: EncodedAudioChunk, metadata?: EncodedAudioChunkMetadata) {\n    // Check if muxer is available (it might have been finalized already if audio is late)\n    if (!this.muxer) {\n      console.warn('[MuxManager] writeAudioChunk called after finalization, dropping chunk');\n      return;\n    }\n    this.muxer.writeAudioChunk(chunk, metadata);\n  }\n\n  finalize(): Blob | null {\n    if (!this.muxer) throw new Error('Muxer not started');\n    const blob = this.muxer.finalize();\n    this.muxer = null;\n    this.output = null;\n    return blob;\n  }\n}\n"],"names":[],"mappings":";AAEO,MAAM,WAAW;AAAA,EACd,QAAyB;AAAA,EACzB,SAAiC;AAAA,EAEzC,cAAc;AAAA,EAAC;AAAA,EAEf,MAAM,QAAkF;AACtF,SAAK,SAAS,OAAO,UAAU,EAAE,MAAM,OAAA;AACvC,SAAK,QAAQ,IAAI;AAAA,MACf;AAAA,QACE,OAAO,OAAO;AAAA,QACd,QAAQ,OAAO;AAAA,QACf,KAAK,OAAO;AAAA;AAAA;AAAA,QAGZ,WAAW,KAAK,OAAO,SAAS,WAAW,QAAQ;AAAA;AAAA,MAAA;AAAA,MAGrD,KAAK;AAAA,IAAA;AAAA,EAET;AAAA,EAEA,gBAAgB,OAA0B,UAAsC;AAC9E,QAAI,CAAC,KAAK,MAAO,OAAM,IAAI,MAAM,mBAAmB;AACpD,SAAK,MAAM,gBAAgB,OAAO,QAAQ;AAAA,EAC5C;AAAA,EAEA,gBAAgB,OAA0B,UAAsC;AAE9E,QAAI,CAAC,KAAK,OAAO;AACf,cAAQ,KAAK,wEAAwE;AACrF;AAAA,IACF;AACA,SAAK,MAAM,gBAAgB,OAAO,QAAQ;AAAA,EAC5C;AAAA,EAEA,WAAwB;AACtB,QAAI,CAAC,KAAK,MAAO,OAAM,IAAI,MAAM,mBAAmB;AACpD,UAAM,OAAO,KAAK,MAAM,SAAA;AACxB,SAAK,QAAQ;AACb,SAAK,SAAS;AACd,WAAO;AAAA,EACT;AACF;"}
+{"version":3,"file":"MuxManager.js","sources":["../../../src/stages/mux/MuxManager.ts"],"sourcesContent":["import { MP4Muxer, type MuxOutputConfig } from './MP4Muxer';\n\nexport class MuxManager {\n  private muxer: MP4Muxer | null = null;\n  private output: MuxOutputConfig | null = null;\n\n  constructor() {}\n\n  start(config: {\n    width: number;\n    height: number;\n    fps: number;\n    output?: MuxOutputConfig;\n    enableAudio?: boolean;\n  }) {\n    this.output = config.output ?? { kind: 'blob' };\n    this.muxer = new MP4Muxer(\n      {\n        width: config.width,\n        height: config.height,\n        fps: config.fps,\n        // For blob output, prefer fast start by keeping chunks in memory.\n        // For stream output, prefer minimal memory usage: metadata at end (non-fMP4).\n        fastStart: this.output.kind === 'stream' ? false : 'in-memory',\n        enableAudio: config.enableAudio ?? true,\n        // Metadata will be handled by first chunks\n      },\n      this.output\n    );\n  }\n\n  writeVideoChunk(chunk: EncodedVideoChunk, metadata?: EncodedVideoChunkMetadata) {\n    if (!this.muxer) throw new Error('Muxer not started');\n    this.muxer.writeVideoChunk(chunk, metadata);\n  }\n\n  writeAudioChunk(chunk: EncodedAudioChunk, metadata?: EncodedAudioChunkMetadata) {\n    // Check if muxer is available (it might have been finalized already if audio is late)\n    if (!this.muxer) {\n      console.warn('[MuxManager] writeAudioChunk called after finalization, dropping chunk');\n      return;\n    }\n    this.muxer.writeAudioChunk(chunk, metadata);\n  }\n\n  finalize(): Blob | null {\n    if (!this.muxer) throw new Error('Muxer not started');\n    const blob = this.muxer.finalize();\n    this.muxer = null;\n    this.output = null;\n    return blob;\n  }\n}\n"],"names":[],"mappings":";AAEO,MAAM,WAAW;AAAA,EACd,QAAyB;AAAA,EACzB,SAAiC;AAAA,EAEzC,cAAc;AAAA,EAAC;AAAA,EAEf,MAAM,QAMH;AACD,SAAK,SAAS,OAAO,UAAU,EAAE,MAAM,OAAA;AACvC,SAAK,QAAQ,IAAI;AAAA,MACf;AAAA,QACE,OAAO,OAAO;AAAA,QACd,QAAQ,OAAO;AAAA,QACf,KAAK,OAAO;AAAA;AAAA;AAAA,QAGZ,WAAW,KAAK,OAAO,SAAS,WAAW,QAAQ;AAAA,QACnD,aAAa,OAAO,eAAe;AAAA;AAAA,MAAA;AAAA,MAGrC,KAAK;AAAA,IAAA;AAAA,EAET;AAAA,EAEA,gBAAgB,OAA0B,UAAsC;AAC9E,QAAI,CAAC,KAAK,MAAO,OAAM,IAAI,MAAM,mBAAmB;AACpD,SAAK,MAAM,gBAAgB,OAAO,QAAQ;AAAA,EAC5C;AAAA,EAEA,gBAAgB,OAA0B,UAAsC;AAE9E,QAAI,CAAC,KAAK,OAAO;AACf,cAAQ,KAAK,wEAAwE;AACrF;AAAA,IACF;AACA,SAAK,MAAM,gBAAgB,OAAO,QAAQ;AAAA,EAC5C;AAAA,EAEA,WAAwB;AACtB,QAAI,CAAC,KAAK,MAAO,OAAM,IAAI,MAAM,mBAAmB;AACpD,UAAM,OAAO,KAAK,MAAM,SAAA;AACxB,SAAK,QAAQ;AACb,SAAK,SAAS;AACd,WAAO;AAAA,EACT;AACF;"}

package/package.json

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