@meframe/core 0.2.0 → 0.2.1

package/dist/orchestrator/AudioPreviewSession.js

@@ -0,0 +1,340 @@
+import { OfflineAudioMixer } from "../stages/compose/OfflineAudioMixer.js";
+import { AudioMixBlockCache } from "../cache/AudioMixBlockCache.js";
+class AudioPreviewSession {
+  constructor(deps) {
+    this.deps = deps;
+    this.mixer = new OfflineAudioMixer(deps.cacheManager, () => deps.preparer.getModel());
+  }
+  mixer;
+  audioContext = null;
+  volume = 1;
+  playbackRate = 1;
+  isPlaying = false;
+  // Preview strategy (unified):
+  // - Always schedule audio in fixed 60s "mix blocks"
+  // - Cache 2~3 mixed AudioBuffer blocks (LRU) to accelerate seek
+  // - Schedule ahead using AudioContext clock to avoid underrun
+  PREVIEW_BLOCK_DURATION_US = 60 * 1e6;
+  // 60s
+  PREVIEW_BLOCK_CACHE_SIZE = 3;
+  PREVIEW_SCHEDULE_AHEAD_SEC = 12;
+  // keep enough scheduled audio to hide mixing latency
+  PREVIEW_BUFFER_GUARD_US = 2e6;
+  // if next block isn't ready near boundary -> buffering
+  PREVIEW_BLOCK_FADE_SEC = 0.01;
+  // 10ms fade-in/out to avoid click at boundaries
+  previewBlockCache = new AudioMixBlockCache(this.PREVIEW_BLOCK_CACHE_SIZE);
+  previewScheduleTask = null;
+  previewScheduleToken = 0;
+  previewMixToken = 0;
+  previewNextBlockIndex = 0;
+  previewNextScheduleTime = 0;
+  // AudioContext time
+  previewFirstBlockOffsetUs = 0;
+  // seek offset within the first block
+  previewLastTimelineUs = 0;
+  previewLastStallWarnAt = 0;
+  // AudioContext time (sec)
+  previewScheduledSources = /* @__PURE__ */ new Set();
+  previewMixQueue = Promise.resolve();
+  invalidatePreviewMixCache() {
+    this.previewBlockCache.clear();
+    this.previewMixToken += 1;
+  }
+  enqueuePreviewMix(work, token) {
+    const run = () => work();
+    const next = this.previewMixQueue.then(
+      () => {
+        if (this.previewMixToken !== token) {
+          return null;
+        }
+        return run();
+      },
+      () => {
+        if (this.previewMixToken !== token) {
+          return null;
+        }
+        return run();
+      }
+    );
+    this.previewMixQueue = next.then(
+      () => void 0,
+      () => void 0
+    );
+    return next;
+  }
+  async ensureAudioForTime(timeUs, options) {
+    const model = this.deps.preparer.getModel();
+    if (!model) return;
+    const mode = options?.mode ?? "blocking";
+    const blockIndex = Math.floor(Math.max(0, timeUs) / this.PREVIEW_BLOCK_DURATION_US);
+    if (mode === "probe") {
+      void this.getOrCreateMixedBlock(blockIndex);
+      const blockEndUs2 = (blockIndex + 1) * this.PREVIEW_BLOCK_DURATION_US;
+      const remainingToBoundaryUs2 = blockEndUs2 - Math.max(0, timeUs);
+      const lookaheadUs = Math.floor(this.PREVIEW_SCHEDULE_AHEAD_SEC * 1e6);
+      if (remainingToBoundaryUs2 > 0 && remainingToBoundaryUs2 <= lookaheadUs) {
+        void this.getOrCreateMixedBlock(blockIndex + 1);
+      }
+      return;
+    }
+    await this.getOrCreateMixedBlock(blockIndex);
+    const blockEndUs = (blockIndex + 1) * this.PREVIEW_BLOCK_DURATION_US;
+    const remainingToBoundaryUs = blockEndUs - Math.max(0, timeUs);
+    if (remainingToBoundaryUs > 0 && remainingToBoundaryUs <= this.PREVIEW_BUFFER_GUARD_US) {
+      await this.getOrCreateMixedBlock(blockIndex + 1);
+    }
+  }
+  isPreviewMixBlockCached(timeUs) {
+    const blockIndex = Math.floor(Math.max(0, timeUs) / this.PREVIEW_BLOCK_DURATION_US);
+    return this.previewBlockCache.get(blockIndex) !== null;
+  }
+  shouldEnterBufferingForUpcomingPreviewAudio(timeUs) {
+    const model = this.deps.preparer.getModel();
+    if (!model) return false;
+    const clampedUs = Math.max(0, timeUs);
+    const blockIndex = Math.floor(clampedUs / this.PREVIEW_BLOCK_DURATION_US);
+    const nextBlockStartUs = (blockIndex + 1) * this.PREVIEW_BLOCK_DURATION_US;
+    if (nextBlockStartUs >= model.durationUs) return false;
+    const remainingToBoundaryUs = nextBlockStartUs - clampedUs;
+    if (remainingToBoundaryUs > this.PREVIEW_BUFFER_GUARD_US) return false;
+    return !this.isPreviewMixBlockCached(nextBlockStartUs);
+  }
+  async startPlayback(timeUs, audioContext) {
+    this.audioContext = audioContext;
+    if (audioContext.state === "suspended") {
+      await audioContext.resume();
+    }
+    await this.ensureAudioForTime(timeUs, { mode: "blocking" });
+    this.isPlaying = true;
+    this.startPreviewBlockScheduling(timeUs, audioContext);
+    await this.scheduleNextPreviewBlock(audioContext, this.previewScheduleToken);
+    void this.scheduleAudio(timeUs, audioContext);
+  }
+  stopPlayback() {
+    this.isPlaying = false;
+    this.stopAllPreviewSources();
+    this.cancelPreviewBlockScheduling();
+    this.previewMixToken += 1;
+  }
+  /**
+   * Schedule audio chunks ahead of playback cursor.
+   */
+  async scheduleAudio(currentTimelineUs, audioContext) {
+    if (!this.isPlaying || !this.deps.preparer.getModel() || !this.audioContext) {
+      return;
+    }
+    this.previewLastTimelineUs = currentTimelineUs;
+    if (this.previewScheduleTask) return;
+    if (this.previewNextScheduleTime === 0) {
+      this.startPreviewBlockScheduling(currentTimelineUs, audioContext);
+    }
+    const token = this.previewScheduleToken;
+    this.previewScheduleTask = this.runPreviewBlockSchedulingLoop(audioContext, token).finally(
+      () => {
+        if (this.previewScheduleToken === token) {
+          this.previewScheduleTask = null;
+        }
+      }
+    );
+  }
+  /**
+   * Reset playback states (called on seek)
+   */
+  resetPlaybackStates() {
+    this.stopAllPreviewSources();
+    this.cancelPreviewBlockScheduling();
+    this.previewMixToken += 1;
+  }
+  reset() {
+    this.stopPlayback();
+    this.deps.cacheManager.clearAudioCache();
+    this.previewBlockCache.clear();
+    this.deps.preparer.reset();
+  }
+  setVolume(volume) {
+    this.volume = volume;
+    const audioContext = this.audioContext;
+    if (!audioContext) return;
+    const t = audioContext.currentTime;
+    for (const { gain } of this.previewScheduledSources) {
+      try {
+        gain.gain.cancelScheduledValues(t);
+        gain.gain.setValueAtTime(gain.gain.value, t);
+        gain.gain.linearRampToValueAtTime(volume, t + 0.01);
+      } catch {
+      }
+    }
+  }
+  setPlaybackRate(rate) {
+    this.playbackRate = rate;
+    this.resetPlaybackStates();
+  }
+  startPreviewBlockScheduling(startTimelineUs, audioContext) {
+    this.cancelPreviewBlockScheduling();
+    this.stopAllPreviewSources();
+    const clampedUs = Math.max(0, startTimelineUs);
+    const blockIndex = Math.floor(clampedUs / this.PREVIEW_BLOCK_DURATION_US);
+    const blockStartUs = blockIndex * this.PREVIEW_BLOCK_DURATION_US;
+    this.previewFirstBlockOffsetUs = clampedUs - blockStartUs;
+    this.previewNextBlockIndex = blockIndex;
+    this.previewNextScheduleTime = audioContext.currentTime + 0.02;
+    this.previewLastTimelineUs = startTimelineUs;
+  }
+  cancelPreviewBlockScheduling() {
+    this.previewScheduleToken += 1;
+    this.previewScheduleTask = null;
+    this.previewNextBlockIndex = 0;
+    this.previewNextScheduleTime = 0;
+    this.previewFirstBlockOffsetUs = 0;
+    this.previewLastTimelineUs = 0;
+  }
+  realignPreviewSchedulingToTimeline(audioContext) {
+    const model = this.deps.preparer.getModel();
+    if (!model) return;
+    const clampedUs = Math.max(0, this.previewLastTimelineUs);
+    const blockIndex = Math.floor(clampedUs / this.PREVIEW_BLOCK_DURATION_US);
+    const blockStartUs = blockIndex * this.PREVIEW_BLOCK_DURATION_US;
+    if (blockStartUs >= model.durationUs) return;
+    this.stopAllPreviewSources();
+    this.previewFirstBlockOffsetUs = clampedUs - blockStartUs;
+    this.previewNextBlockIndex = blockIndex;
+    this.previewNextScheduleTime = audioContext.currentTime + 0.02;
+  }
+  async runPreviewBlockSchedulingLoop(audioContext, token) {
+    while (this.isPlaying && this.previewScheduleToken === token) {
+      const model = this.deps.preparer.getModel();
+      if (!model) return;
+      const nextBlockStartUs = this.previewNextBlockIndex * this.PREVIEW_BLOCK_DURATION_US;
+      if (nextBlockStartUs >= model.durationUs) {
+        this.previewNextScheduleTime = audioContext.currentTime + this.PREVIEW_SCHEDULE_AHEAD_SEC;
+        return;
+      }
+      const scheduleAheadTime = audioContext.currentTime + this.PREVIEW_SCHEDULE_AHEAD_SEC;
+      if (this.previewNextScheduleTime >= scheduleAheadTime) return;
+      const prevBlockIndex = this.previewNextBlockIndex;
+      const prevScheduleTime = this.previewNextScheduleTime;
+      await this.scheduleNextPreviewBlock(audioContext, token);
+      if (this.previewScheduleToken === token && this.previewNextBlockIndex === prevBlockIndex && this.previewNextScheduleTime === prevScheduleTime) {
+        const now = audioContext.currentTime;
+        if (now - this.previewLastStallWarnAt >= 1) {
+          this.previewLastStallWarnAt = now;
+          console.warn("[AudioPreviewSession] scheduling stalled; stop loop to avoid spin", {
+            prevBlockIndex,
+            prevScheduleTime,
+            now
+          });
+        }
+        return;
+      }
+    }
+  }
+  async getOrCreateMixedBlock(blockIndex) {
+    const model = this.deps.preparer.getModel();
+    if (!model) return null;
+    const token = this.previewMixToken;
+    return await this.previewBlockCache.getOrCreate(blockIndex, async () => {
+      return await this.enqueuePreviewMix(async () => {
+        const startUs = blockIndex * this.PREVIEW_BLOCK_DURATION_US;
+        const endUs = Math.min(startUs + this.PREVIEW_BLOCK_DURATION_US, model.durationUs);
+        await this.deps.preparer.ensureAudioForTimeRange(startUs, endUs, {
+          mode: "blocking",
+          loadResource: true
+        });
+        const mixed = await this.mixer.mix(startUs, endUs);
+        this.deps.cacheManager.clearAudioCache();
+        return mixed;
+      }, token);
+    });
+  }
+  async scheduleNextPreviewBlock(audioContext, token) {
+    const model = this.deps.preparer.getModel();
+    if (!this.isPlaying || !model) return;
+    if (this.previewScheduleToken !== token) return;
+    if (this.previewNextScheduleTime < audioContext.currentTime + 0.01) {
+      this.realignPreviewSchedulingToTimeline(audioContext);
+    }
+    const blockIndex = this.previewNextBlockIndex;
+    const blockStartUs = blockIndex * this.PREVIEW_BLOCK_DURATION_US;
+    if (blockStartUs >= model.durationUs) {
+      this.previewFirstBlockOffsetUs = 0;
+      this.previewNextBlockIndex = blockIndex + 1;
+      this.previewNextScheduleTime = audioContext.currentTime + this.PREVIEW_SCHEDULE_AHEAD_SEC;
+      return;
+    }
+    const buffer = await this.getOrCreateMixedBlock(blockIndex);
+    if (!buffer) {
+      this.previewFirstBlockOffsetUs = 0;
+      this.previewNextBlockIndex = blockIndex + 1;
+      this.previewNextScheduleTime = audioContext.currentTime + 0.02;
+      return;
+    }
+    if (this.previewScheduleToken !== token) return;
+    const rate = this.playbackRate || 1;
+    const offsetUs = this.previewFirstBlockOffsetUs;
+    let startTime = this.previewNextScheduleTime;
+    let offsetSec = offsetUs > 0 ? offsetUs / 1e6 : 0;
+    const now = audioContext.currentTime;
+    if (startTime < now + 0.01) {
+      const targetStartTime = now + 0.02;
+      const skippedSec = Math.max(0, (targetStartTime - startTime) * rate);
+      startTime = targetStartTime;
+      offsetSec += skippedSec;
+    }
+    if (offsetSec >= buffer.duration) {
+      this.previewFirstBlockOffsetUs = 0;
+      this.previewNextBlockIndex = blockIndex + 1;
+      this.previewNextScheduleTime = startTime;
+      return;
+    }
+    const remainingSec = Math.max(0, buffer.duration - offsetSec);
+    if (remainingSec <= 0) return;
+    const source = audioContext.createBufferSource();
+    source.buffer = buffer;
+    source.playbackRate.value = rate;
+    const gainNode = audioContext.createGain();
+    const volume = this.volume;
+    const fadeSec = Math.min(this.PREVIEW_BLOCK_FADE_SEC, remainingSec / 2);
+    gainNode.gain.setValueAtTime(0, startTime);
+    gainNode.gain.linearRampToValueAtTime(volume, startTime + fadeSec);
+    gainNode.gain.setValueAtTime(volume, startTime + Math.max(fadeSec, remainingSec - fadeSec));
+    gainNode.gain.linearRampToValueAtTime(0, startTime + remainingSec);
+    source.connect(gainNode);
+    gainNode.connect(audioContext.destination);
+    source.start(startTime, offsetSec);
+    const entry = { source, gain: gainNode };
+    this.previewScheduledSources.add(entry);
+    source.onended = () => {
+      try {
+        source.disconnect();
+        gainNode.disconnect();
+      } catch {
+      }
+      this.previewScheduledSources.delete(entry);
+    };
+    this.previewFirstBlockOffsetUs = 0;
+    this.previewNextBlockIndex = blockIndex + 1;
+    this.previewNextScheduleTime = startTime + remainingSec / rate;
+  }
+  stopAllPreviewSources() {
+    for (const { source, gain } of this.previewScheduledSources) {
+      try {
+        source.disconnect();
+      } catch {
+      }
+      try {
+        source.stop(0);
+      } catch {
+      }
+      try {
+        gain.disconnect();
+      } catch {
+      }
+    }
+    this.previewScheduledSources.clear();
+  }
+}
+export {
+  AudioPreviewSession
+};
+//# sourceMappingURL=AudioPreviewSession.js.map

package/dist/orchestrator/AudioPreviewSession.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AudioPreviewSession.js","sources":["../../src/orchestrator/AudioPreviewSession.ts"],"sourcesContent":["import type { TimeUs } from '../model/types';\nimport { OfflineAudioMixer } from '../stages/compose/OfflineAudioMixer';\nimport { AudioMixBlockCache } from '../cache/AudioMixBlockCache';\nimport type { CacheManager } from '../cache/CacheManager';\nimport type { RequestMode } from './types';\nimport type { AudioWindowPreparer } from './AudioWindowPreparer';\n\nexport class AudioPreviewSession {\n  private mixer: OfflineAudioMixer;\n  private audioContext: AudioContext | null = null;\n  private volume = 1.0;\n  private playbackRate = 1.0;\n  private isPlaying = false;\n\n  // Preview strategy (unified):\n  // - Always schedule audio in fixed 60s \"mix blocks\"\n  // - Cache 2~3 mixed AudioBuffer blocks (LRU) to accelerate seek\n  // - Schedule ahead using AudioContext clock to avoid underrun\n  private readonly PREVIEW_BLOCK_DURATION_US: TimeUs = 60 * 1_000_000; // 60s\n  private readonly PREVIEW_BLOCK_CACHE_SIZE = 3;\n  private readonly PREVIEW_SCHEDULE_AHEAD_SEC = 12.0; // keep enough scheduled audio to hide mixing latency\n  private readonly PREVIEW_BUFFER_GUARD_US: TimeUs = 2_000_000; // if next block isn't ready near boundary -> buffering\n  private readonly PREVIEW_BLOCK_FADE_SEC = 0.01; // 10ms fade-in/out to avoid click at boundaries\n\n  private previewBlockCache = new AudioMixBlockCache(this.PREVIEW_BLOCK_CACHE_SIZE);\n\n  private previewScheduleTask: Promise<void> | null = null;\n  private previewScheduleToken = 0;\n  private previewMixToken = 0;\n  private previewNextBlockIndex = 0;\n  private previewNextScheduleTime = 0; // AudioContext time\n  private previewFirstBlockOffsetUs: TimeUs = 0; // seek offset within the first block\n  private previewLastTimelineUs: TimeUs = 0;\n  private previewLastStallWarnAt = 0; // AudioContext time (sec)\n\n  private previewScheduledSources = new Set<{ source: AudioBufferSourceNode; gain: GainNode }>();\n  private previewMixQueue: Promise<unknown> = Promise.resolve();\n\n  constructor(private deps: { cacheManager: CacheManager; preparer: AudioWindowPreparer }) {\n    this.mixer = new OfflineAudioMixer(deps.cacheManager, () => deps.preparer.getModel());\n  }\n\n  invalidatePreviewMixCache(): void {\n    // Mixed AudioBuffer blocks embed per-clip audioConfig (volume/muted).\n    // When model is replaced via setCompositionModel, these blocks must be invalidated,\n    // otherwise preview may keep scheduling old AudioBuffers and volume changes won't take effect.\n    this.previewBlockCache.clear();\n    // Ensure any in-flight mix tasks are dropped.\n    this.previewMixToken += 1;\n  }\n\n  private enqueuePreviewMix<T>(work: () => Promise<T>, token: number): Promise<T | null> {\n    const run = () => work();\n    const next = this.previewMixQueue.then(\n      () => {\n        // If a seek/reset happened since this task was enqueued, drop it.\n        if (this.previewMixToken !== token) {\n          return null;\n        }\n        return run();\n      },\n      () => {\n        if (this.previewMixToken !== token) {\n          return null;\n        }\n        return run();\n      }\n    );\n    // Keep queue alive even if a task fails.\n    this.previewMixQueue = next.then(\n      () => undefined,\n      () => undefined\n    );\n    return next as Promise<T | null>;\n  }\n\n  async ensureAudioForTime(timeUs: TimeUs, options?: { mode?: RequestMode }): Promise<void> {\n    const model = this.deps.preparer.getModel();\n    if (!model) return;\n\n    const mode = options?.mode ?? 'blocking';\n\n    // Preview contract:\n    // - blocking: ensure the current 60s mixed block is ready (may be slow -> should be wrapped by buffering UI)\n    // - probe: best-effort preheat current and next block without blocking\n    const blockIndex = Math.floor(Math.max(0, timeUs) / this.PREVIEW_BLOCK_DURATION_US);\n\n    if (mode === 'probe') {\n      // Default: only preheat the current block.\n      void this.getOrCreateMixedBlock(blockIndex);\n\n      // If we're close enough to boundary (within scheduling lookahead), also preheat next block.\n      const blockEndUs = (blockIndex + 1) * this.PREVIEW_BLOCK_DURATION_US;\n      const remainingToBoundaryUs = blockEndUs - Math.max(0, timeUs);\n      const lookaheadUs = Math.floor(this.PREVIEW_SCHEDULE_AHEAD_SEC * 1_000_000);\n      if (remainingToBoundaryUs > 0 && remainingToBoundaryUs <= lookaheadUs) {\n        void this.getOrCreateMixedBlock(blockIndex + 1);\n      }\n      return;\n    }\n\n    await this.getOrCreateMixedBlock(blockIndex);\n\n    // If we're very close to the block boundary, also ensure the next block.\n    const blockEndUs = (blockIndex + 1) * this.PREVIEW_BLOCK_DURATION_US;\n    const remainingToBoundaryUs = blockEndUs - Math.max(0, timeUs);\n    if (remainingToBoundaryUs > 0 && remainingToBoundaryUs <= this.PREVIEW_BUFFER_GUARD_US) {\n      await this.getOrCreateMixedBlock(blockIndex + 1);\n    }\n  }\n\n  isPreviewMixBlockCached(timeUs: TimeUs): boolean {\n    const blockIndex = Math.floor(Math.max(0, timeUs) / this.PREVIEW_BLOCK_DURATION_US);\n    return this.previewBlockCache.get(blockIndex) !== null;\n  }\n\n  shouldEnterBufferingForUpcomingPreviewAudio(timeUs: TimeUs): boolean {\n    const model = this.deps.preparer.getModel();\n    if (!model) return false;\n\n    const clampedUs = Math.max(0, timeUs);\n    const blockIndex = Math.floor(clampedUs / this.PREVIEW_BLOCK_DURATION_US);\n    const nextBlockStartUs = (blockIndex + 1) * this.PREVIEW_BLOCK_DURATION_US;\n    if (nextBlockStartUs >= model.durationUs) return false;\n\n    const remainingToBoundaryUs = nextBlockStartUs - clampedUs;\n    if (remainingToBoundaryUs > this.PREVIEW_BUFFER_GUARD_US) return false;\n\n    // Probe next block readiness by checking cache at next block start time.\n    return !this.isPreviewMixBlockCached(nextBlockStartUs);\n  }\n\n  async startPlayback(timeUs: TimeUs, audioContext: AudioContext): Promise<void> {\n    this.audioContext = audioContext;\n\n    // Resume AudioContext if suspended (required by modern browsers)\n    if (audioContext.state === 'suspended') {\n      await audioContext.resume();\n    }\n\n    // Ensure audio is decoded and ready (blocking mode for startup).\n    await this.ensureAudioForTime(timeUs, { mode: 'blocking' });\n\n    this.isPlaying = true;\n\n    // Unified block scheduling: align to block index and schedule immediately.\n    this.startPreviewBlockScheduling(timeUs, audioContext);\n    // Schedule first block in blocking mode to avoid initial silence.\n    await this.scheduleNextPreviewBlock(audioContext, this.previewScheduleToken);\n    // Then keep scheduling in background.\n    void this.scheduleAudio(timeUs, audioContext);\n  }\n\n  stopPlayback(): void {\n    this.isPlaying = false;\n    this.stopAllPreviewSources();\n    this.cancelPreviewBlockScheduling();\n    this.previewMixToken += 1;\n  }\n\n  /**\n   * Schedule audio chunks ahead of playback cursor.\n   */\n  async scheduleAudio(currentTimelineUs: TimeUs, audioContext: AudioContext): Promise<void> {\n    if (!this.isPlaying || !this.deps.preparer.getModel() || !this.audioContext) {\n      return;\n    }\n\n    this.previewLastTimelineUs = currentTimelineUs;\n\n    // Keep scheduling in the background to avoid blocking the render loop.\n    if (this.previewScheduleTask) return;\n\n    // Initialize if needed (e.g. after model switch without explicit startPlayback).\n    if (this.previewNextScheduleTime === 0) {\n      this.startPreviewBlockScheduling(currentTimelineUs, audioContext);\n    }\n\n    const token = this.previewScheduleToken;\n    this.previewScheduleTask = this.runPreviewBlockSchedulingLoop(audioContext, token).finally(\n      () => {\n        if (this.previewScheduleToken === token) {\n          this.previewScheduleTask = null;\n        }\n      }\n    );\n  }\n\n  /**\n   * Reset playback states (called on seek)\n   */\n  resetPlaybackStates(): void {\n    this.stopAllPreviewSources();\n    this.cancelPreviewBlockScheduling();\n    this.previewMixToken += 1;\n  }\n\n  reset(): void {\n    this.stopPlayback();\n    this.deps.cacheManager.clearAudioCache();\n    this.previewBlockCache.clear();\n    this.deps.preparer.reset();\n  }\n\n  setVolume(volume: number): void {\n    this.volume = volume;\n    const audioContext = this.audioContext;\n    if (!audioContext) return;\n\n    // Apply volume to already scheduled nodes (small ramp to avoid click).\n    const t = audioContext.currentTime;\n    for (const { gain } of this.previewScheduledSources) {\n      try {\n        gain.gain.cancelScheduledValues(t);\n        gain.gain.setValueAtTime(gain.gain.value, t);\n        gain.gain.linearRampToValueAtTime(volume, t + 0.01);\n      } catch {\n        // ignore\n      }\n    }\n  }\n\n  setPlaybackRate(rate: number): void {\n    this.playbackRate = rate;\n    // Playback rate change requires restarting scheduling to keep sync with the timeline clock.\n    this.resetPlaybackStates();\n  }\n\n  private startPreviewBlockScheduling(startTimelineUs: TimeUs, audioContext: AudioContext): void {\n    this.cancelPreviewBlockScheduling();\n    this.stopAllPreviewSources();\n\n    const clampedUs = Math.max(0, startTimelineUs);\n    const blockIndex = Math.floor(clampedUs / this.PREVIEW_BLOCK_DURATION_US);\n    const blockStartUs = blockIndex * this.PREVIEW_BLOCK_DURATION_US;\n\n    this.previewFirstBlockOffsetUs = clampedUs - blockStartUs;\n    this.previewNextBlockIndex = blockIndex;\n    this.previewNextScheduleTime = audioContext.currentTime + 0.02;\n    this.previewLastTimelineUs = startTimelineUs;\n  }\n\n  private cancelPreviewBlockScheduling(): void {\n    this.previewScheduleToken += 1;\n    this.previewScheduleTask = null;\n    this.previewNextBlockIndex = 0;\n    this.previewNextScheduleTime = 0;\n    this.previewFirstBlockOffsetUs = 0;\n    this.previewLastTimelineUs = 0;\n  }\n\n  private realignPreviewSchedulingToTimeline(audioContext: AudioContext): void {\n    const model = this.deps.preparer.getModel();\n    if (!model) return;\n\n    const clampedUs = Math.max(0, this.previewLastTimelineUs);\n    const blockIndex = Math.floor(clampedUs / this.PREVIEW_BLOCK_DURATION_US);\n    const blockStartUs = blockIndex * this.PREVIEW_BLOCK_DURATION_US;\n    if (blockStartUs >= model.durationUs) return;\n\n    this.stopAllPreviewSources();\n    this.previewFirstBlockOffsetUs = clampedUs - blockStartUs;\n    this.previewNextBlockIndex = blockIndex;\n    this.previewNextScheduleTime = audioContext.currentTime + 0.02;\n  }\n\n  private async runPreviewBlockSchedulingLoop(\n    audioContext: AudioContext,\n    token: number\n  ): Promise<void> {\n    while (this.isPlaying && this.previewScheduleToken === token) {\n      const model = this.deps.preparer.getModel();\n      if (!model) return;\n\n      // End-of-timeline: nothing more to schedule.\n      const nextBlockStartUs = this.previewNextBlockIndex * this.PREVIEW_BLOCK_DURATION_US;\n      if (nextBlockStartUs >= model.durationUs) {\n        this.previewNextScheduleTime = audioContext.currentTime + this.PREVIEW_SCHEDULE_AHEAD_SEC;\n        return;\n      }\n\n      const scheduleAheadTime = audioContext.currentTime + this.PREVIEW_SCHEDULE_AHEAD_SEC;\n      if (this.previewNextScheduleTime >= scheduleAheadTime) return;\n\n      const prevBlockIndex = this.previewNextBlockIndex;\n      const prevScheduleTime = this.previewNextScheduleTime;\n\n      await this.scheduleNextPreviewBlock(audioContext, token);\n\n      // If scheduling made no progress, bail out to avoid a tight loop that can freeze UI.\n      if (\n        this.previewScheduleToken === token &&\n        this.previewNextBlockIndex === prevBlockIndex &&\n        this.previewNextScheduleTime === prevScheduleTime\n      ) {\n        const now = audioContext.currentTime;\n        if (now - this.previewLastStallWarnAt >= 1) {\n          this.previewLastStallWarnAt = now;\n          console.warn('[AudioPreviewSession] scheduling stalled; stop loop to avoid spin', {\n            prevBlockIndex,\n            prevScheduleTime,\n            now,\n          });\n        }\n        return;\n      }\n    }\n  }\n\n  private async getOrCreateMixedBlock(blockIndex: number): Promise<AudioBuffer | null> {\n    const model = this.deps.preparer.getModel();\n    if (!model) return null;\n\n    const token = this.previewMixToken;\n\n    return await this.previewBlockCache.getOrCreate(blockIndex, async () => {\n      return await this.enqueuePreviewMix(async () => {\n        const startUs = blockIndex * this.PREVIEW_BLOCK_DURATION_US;\n        const endUs = Math.min(startUs + this.PREVIEW_BLOCK_DURATION_US, model.durationUs);\n        await this.deps.preparer.ensureAudioForTimeRange(startUs, endUs, {\n          mode: 'blocking',\n          loadResource: true,\n        });\n        const mixed = await this.mixer.mix(startUs, endUs);\n\n        // Preview uses mixed AudioBuffer blocks as the primary cache.\n        this.deps.cacheManager.clearAudioCache();\n\n        return mixed;\n      }, token);\n    });\n  }\n\n  private async scheduleNextPreviewBlock(audioContext: AudioContext, token: number): Promise<void> {\n    const model = this.deps.preparer.getModel();\n    if (!this.isPlaying || !model) return;\n    if (this.previewScheduleToken !== token) return;\n\n    // If we're behind the audio clock, resync to avoid attempting to schedule in the past.\n    if (this.previewNextScheduleTime < audioContext.currentTime + 0.01) {\n      this.realignPreviewSchedulingToTimeline(audioContext);\n    }\n\n    const blockIndex = this.previewNextBlockIndex;\n    const blockStartUs = blockIndex * this.PREVIEW_BLOCK_DURATION_US;\n    if (blockStartUs >= model.durationUs) {\n      // End-of-timeline: advance state so scheduling loop can finish without stalling.\n      this.previewFirstBlockOffsetUs = 0;\n      this.previewNextBlockIndex = blockIndex + 1;\n      this.previewNextScheduleTime = audioContext.currentTime + this.PREVIEW_SCHEDULE_AHEAD_SEC;\n      return;\n    }\n\n    const buffer = await this.getOrCreateMixedBlock(blockIndex);\n    if (!buffer) {\n      // Could be cancelled (seek/reset) or an empty-range guard; advance to avoid stalling.\n      this.previewFirstBlockOffsetUs = 0;\n      this.previewNextBlockIndex = blockIndex + 1;\n      this.previewNextScheduleTime = audioContext.currentTime + 0.02;\n      return;\n    }\n    if (this.previewScheduleToken !== token) return;\n\n    const rate = this.playbackRate || 1.0;\n    const offsetUs = this.previewFirstBlockOffsetUs;\n    let startTime = this.previewNextScheduleTime;\n    let offsetSec = offsetUs > 0 ? offsetUs / 1_000_000 : 0;\n\n    // Mixing can be slow; after await, startTime might already be in the past.\n    const now = audioContext.currentTime;\n    if (startTime < now + 0.01) {\n      const targetStartTime = now + 0.02;\n      const skippedSec = Math.max(0, (targetStartTime - startTime) * rate);\n      startTime = targetStartTime;\n      offsetSec += skippedSec;\n    }\n\n    if (offsetSec >= buffer.duration) {\n      this.previewFirstBlockOffsetUs = 0;\n      this.previewNextBlockIndex = blockIndex + 1;\n      this.previewNextScheduleTime = startTime;\n      return;\n    }\n\n    const remainingSec = Math.max(0, buffer.duration - offsetSec);\n    if (remainingSec <= 0) return;\n\n    const source = audioContext.createBufferSource();\n    source.buffer = buffer;\n    source.playbackRate.value = rate;\n\n    const gainNode = audioContext.createGain();\n    const volume = this.volume;\n\n    // Fade in/out to avoid click at block boundaries.\n    const fadeSec = Math.min(this.PREVIEW_BLOCK_FADE_SEC, remainingSec / 2);\n    gainNode.gain.setValueAtTime(0, startTime);\n    gainNode.gain.linearRampToValueAtTime(volume, startTime + fadeSec);\n    gainNode.gain.setValueAtTime(volume, startTime + Math.max(fadeSec, remainingSec - fadeSec));\n    gainNode.gain.linearRampToValueAtTime(0, startTime + remainingSec);\n\n    source.connect(gainNode);\n    gainNode.connect(audioContext.destination);\n    source.start(startTime, offsetSec);\n\n    const entry = { source, gain: gainNode };\n    this.previewScheduledSources.add(entry);\n\n    source.onended = () => {\n      try {\n        source.disconnect();\n        gainNode.disconnect();\n      } catch {\n        // ignore\n      }\n      this.previewScheduledSources.delete(entry);\n    };\n\n    // Advance to next block\n    this.previewFirstBlockOffsetUs = 0;\n    this.previewNextBlockIndex = blockIndex + 1;\n    this.previewNextScheduleTime = startTime + remainingSec / rate;\n  }\n\n  private stopAllPreviewSources(): void {\n    for (const { source, gain } of this.previewScheduledSources) {\n      try {\n        source.disconnect();\n      } catch {\n        // ignore\n      }\n      try {\n        source.stop(0);\n      } catch {\n        // ignore\n      }\n      try {\n        gain.disconnect();\n      } catch {\n        // ignore\n      }\n    }\n    this.previewScheduledSources.clear();\n  }\n}\n"],"names":["blockEndUs","remainingToBoundaryUs"],"mappings":"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"}

package/dist/orchestrator/AudioWindowPreparer.d.ts

@@ -0,0 +1,62 @@
+import { TimeUs } from '../model/types';
+import { CompositionModel } from '../model';
+import { ResourceLoader } from '../stages/load/ResourceLoader';
+import { EventBus } from '../event/EventBus';
+import { EventPayloadMap } from '../event/events';
+import { CacheManager } from '../cache/CacheManager';
+import { RequestMode } from './types';
+
+interface AudioDataMessage {
+    sessionId: string;
+    audioData: AudioData;
+    clipStartUs: TimeUs;
+    clipDurationUs: TimeUs;
+}
+interface AudioWindowPreparerDeps {
+    cacheManager: CacheManager;
+    resourceLoader: ResourceLoader;
+    eventBus: EventBus<EventPayloadMap>;
+}
+export declare class AudioWindowPreparer {
+    private activeClips;
+    private deps;
+    private model;
+    constructor(deps: AudioWindowPreparerDeps);
+    setModel(model: CompositionModel): void;
+    getModel(): CompositionModel | null;
+    reset(): void;
+    onAudioData(message: AudioDataMessage): void;
+    /**
+     * Fast readiness probe for preview playback.
+     *
+     * This is intentionally synchronous and lightweight:
+     * - Only checks resource-level readiness (download + MP4 index parsing).
+     * - If any relevant resource isn't ready yet, return false.
+     * - Does NOT require audio samples / PCM window coverage (probe is resource-level only).
+     */
+    isAudioResourceWindowReady(startUs: TimeUs, endUs: TimeUs): boolean;
+    activateAllAudioClips(): Promise<void>;
+    deactivateClip(clipId: string): Promise<void>;
+    /**
+     * Core method to ensure audio for all clips in a time range
+     */
+    ensureAudioForTimeRange(startUs: TimeUs, endUs: TimeUs, options: {
+        mode?: RequestMode;
+        loadResource?: boolean;
+        strictMode?: boolean;
+    }): Promise<void>;
+    /**
+     * Ensure audio window for a clip
+     */
+    ensureAudioWindow(clipId: string, startUs: TimeUs, endUs: TimeUs, strictMode?: boolean): Promise<void>;
+    /**
+     * Decode audio window for a clip
+     */
+    private decodeAudioWindow;
+    /**
+     * Decode audio samples to PCM and cache
+     */
+    private decodeAudioSamples;
+}
+export {};
+//# sourceMappingURL=AudioWindowPreparer.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"AudioWindowPreparer.d.ts","sourceRoot":"","sources":["../../src/orchestrator/AudioWindowPreparer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AACjD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AACpE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAEvD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAG1D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAE3C,UAAU,gBAAgB;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,SAAS,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,UAAU,uBAAuB;IAC/B,YAAY,EAAE,YAAY,CAAC;IAC3B,cAAc,EAAE,cAAc,CAAC;IAC/B,QAAQ,EAAE,QAAQ,CAAC,eAAe,CAAC,CAAC;CACrC;AAED,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,WAAW,CAAqB;IACxC,OAAO,CAAC,IAAI,CAA0B;IACtC,OAAO,CAAC,KAAK,CAAiC;gBAElC,IAAI,EAAE,uBAAuB;IAIzC,QAAQ,CAAC,KAAK,EAAE,gBAAgB,GAAG,IAAI;IAIvC,QAAQ,IAAI,gBAAgB,GAAG,IAAI;IAInC,KAAK,IAAI,IAAI;IAKb,WAAW,CAAC,OAAO,EAAE,gBAAgB,GAAG,IAAI;IAM5C;;;;;;;OAOG;IACH,0BAA0B,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO;IAmB7D,qBAAqB,IAAI,OAAO,CAAC,IAAI,CAAC;IA6CtC,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IASnD;;OAEG;IACG,uBAAuB,CAC3B,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,EACb,OAAO,EAAE;QAAE,IAAI,CAAC,EAAE,WAAW,CAAC;QAAC,YAAY,CAAC,EAAE,OAAO,CAAC;QAAC,UAAU,CAAC,EAAE,OAAO,CAAA;KAAE,GAC5E,OAAO,CAAC,IAAI,CAAC;IAwEhB;;OAEG;IACG,iBAAiB,CACrB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,EACb,UAAU,GAAE,OAAe,GAC1B,OAAO,CAAC,IAAI,CAAC;IAShB;;OAEG;YACW,iBAAiB;IA8E/B;;OAEG;YACW,kBAAkB;CAiEjC"}