@meframe/core 0.0.47 → 0.0.49

package/dist/cache/l1/AudioL1Cache.js.map

@@ -1 +1 @@
-{"version":3,"file":"AudioL1Cache.js","sources":["../../../src/cache/l1/AudioL1Cache.ts"],"sourcesContent":["import type { TimeUs } from '../../model/types';\nimport { binarySearchFirst, binarySearchOverlapping } from '../../utils/binary-search';\nimport { extractPlanesFromAudioData } from '../../utils/audio-data';\n\ninterface AudioDataSlot {\n  timestampUs: TimeUs; // Clip-relative timestamp\n  durationUs: TimeUs;\n  planes: Float32Array[]; // PCM data for this slot\n  sampleRate: number;\n  numberOfChannels: number;\n  globalTimeUs?: TimeUs; // Global timeline time (for window management)\n}\n\nexport type { AudioDataSlot };\n\nexport class AudioL1Cache {\n  // Aligned with VideoL1Cache: array of discrete audio data slots per clip\n  private audioDataByClip = new Map<string, AudioDataSlot[]>();\n\n  // Unified window management (aligned with VideoL1Cache)\n  // All clips share the same global window center\n  private windowCenter: TimeUs = 0;\n\n  // Window radius aligned with video (±3.5s, but we use 5s for audio safety margin)\n  private readonly WINDOW_RADIUS = 5_000_000; // ±5s\n  private readonly EVICT_THROTTLE_MS = 500;\n  private lastEvictTime = 0;\n\n  putClipAudioData(\n    clipId: string,\n    audioData: AudioData,\n    _clipDurationUs: TimeUs,\n    globalTimeUs?: TimeUs\n  ): void {\n    const numberOfChannels = audioData.numberOfChannels ?? 2;\n    const numberOfFrames = audioData.numberOfFrames ?? 0;\n    const sampleRate = audioData.sampleRate ?? 48_000;\n    const audioTimestampUs = audioData.timestamp ?? 0;\n    const audioDurationUs =\n      audioData.duration ?? Math.round((numberOfFrames / sampleRate) * 1_000_000);\n\n    if (!numberOfChannels || !numberOfFrames) {\n      audioData.close();\n      return;\n    }\n\n    // Extract PCM data\n    const planes = extractPlanesFromAudioData(audioData, numberOfChannels, numberOfFrames);\n    audioData.close();\n\n    // Create audio data slot (aligned with video architecture)\n    const slot: AudioDataSlot = {\n      timestampUs: audioTimestampUs,\n      durationUs: audioDurationUs,\n      planes,\n      sampleRate,\n      numberOfChannels,\n      globalTimeUs,\n    };\n    // Get or create slots array for this clip\n    let slots = this.audioDataByClip.get(clipId);\n    if (!slots) {\n      slots = [];\n      this.audioDataByClip.set(clipId, slots);\n    }\n\n    // Insert slot in sorted order (aligned with VideoL1Cache.addFrame)\n    const insertIndex = this.findInsertIndex(slots, audioTimestampUs);\n\n    // Deduplication: Check for duplicate or near-duplicate timestamp\n    // Tolerance of 1ms to handle floating-point precision and concurrent decode attempts\n    const DUPLICATE_THRESHOLD_US = 0.5 * audioDurationUs;\n\n    if (insertIndex < slots.length) {\n      const existingSlot = slots[insertIndex]!;\n      const timeDiff = Math.abs(existingSlot.timestampUs - audioTimestampUs);\n\n      if (timeDiff < DUPLICATE_THRESHOLD_US) {\n        // Near-duplicate detected, skip insertion\n        return;\n      }\n    }\n\n    // Also check previous slot to catch overlapping duplicates\n    if (insertIndex > 0) {\n      const prevSlot = slots[insertIndex - 1]!;\n      const timeDiff = Math.abs(prevSlot.timestampUs - audioTimestampUs);\n\n      if (timeDiff < DUPLICATE_THRESHOLD_US) {\n        // Near-duplicate detected, skip insertion\n        return;\n      }\n    }\n\n    // Insert new slot\n    slots.splice(insertIndex, 0, slot);\n  }\n\n  getSlotsInWindow(clipId: string, startUs: TimeUs, endUs: TimeUs): AudioDataSlot[] | null {\n    const slots = this.audioDataByClip.get(clipId);\n    if (!slots || slots.length === 0) {\n      return null;\n    }\n\n    // Use binary search to find overlapping slots\n    const overlappingSlots = binarySearchOverlapping(slots, startUs, endUs, (slot) => ({\n      start: slot.timestampUs,\n      end: slot.timestampUs + slot.durationUs,\n    }));\n\n    if (overlappingSlots.length === 0) {\n      return null;\n    }\n\n    return overlappingSlots;\n  }\n\n  getPCM(clipId: string, startUs: TimeUs, endUs: TimeUs): Float32Array[] | null {\n    const slots = this.audioDataByClip.get(clipId);\n    if (!slots || slots.length === 0) {\n      return null;\n    }\n\n    // Use binary search to find overlapping slots (O(log n + k) vs O(n))\n    // Aligned with video GOP/frame search\n    const overlappingSlots = binarySearchOverlapping(slots, startUs, endUs, (slot) => ({\n      start: slot.timestampUs,\n      end: slot.timestampUs + slot.durationUs,\n    }));\n\n    if (overlappingSlots.length === 0) {\n      return null;\n    }\n\n    const requestedDurationUs = endUs - startUs;\n\n    // Validate sample rate consistency across all slots\n    const firstSlot = overlappingSlots[0]!;\n    const uniformSampleRate = firstSlot.sampleRate;\n    const uniformChannels = firstSlot.numberOfChannels;\n\n    // Check if all slots have the same sample rate and channel count\n    const hasUniformRate = overlappingSlots.every(\n      (s) => s.sampleRate === uniformSampleRate && s.numberOfChannels === uniformChannels\n    );\n\n    if (!hasUniformRate) {\n      console.error(\n        `[AudioL1Cache] Inconsistent sample rates detected for clip ${clipId}:`,\n        overlappingSlots.map((s) => ({\n          timestamp: s.timestampUs,\n          sampleRate: s.sampleRate,\n          channels: s.numberOfChannels,\n        }))\n      );\n      // Return null to avoid corrupted audio data\n      // This will trigger re-decode with correct sample rate\n      return null;\n    }\n\n    // Calculate total frame count needed\n    const totalFrames = Math.ceil((requestedDurationUs / 1_000_000) * uniformSampleRate);\n\n    // Initialize result arrays\n    const result: Float32Array[] = Array.from(\n      { length: uniformChannels },\n      () => new Float32Array(totalFrames)\n    );\n\n    // Copy data from each overlapping slot\n    // Note: Slots are guaranteed non-overlapping by putClipAudioData deduplication\n    for (const slot of overlappingSlots) {\n      const slotStartUs = slot.timestampUs;\n      const slotEndUs = slotStartUs + slot.durationUs;\n\n      // Calculate intersection with requested range\n      const copyStartUs = Math.max(slotStartUs, startUs);\n      const copyEndUs = Math.min(slotEndUs, endUs);\n\n      if (copyStartUs >= copyEndUs) continue;\n\n      // Convert time to frame indices (all slots have same sample rate after validation)\n      const srcOffsetFrames = Math.floor(\n        ((copyStartUs - slotStartUs) / 1_000_000) * uniformSampleRate\n      );\n      const dstOffsetFrames = Math.floor(((copyStartUs - startUs) / 1_000_000) * uniformSampleRate);\n      const copyFrameCount = Math.ceil(((copyEndUs - copyStartUs) / 1_000_000) * uniformSampleRate);\n\n      // Copy each channel\n      for (let ch = 0; ch < uniformChannels; ch++) {\n        const srcPlane = slot.planes[ch];\n        const dstPlane = result[ch];\n        if (!srcPlane || !dstPlane) continue;\n\n        // Boundary check\n        const actualCopyFrames = Math.min(\n          copyFrameCount,\n          srcPlane.length - srcOffsetFrames,\n          dstPlane.length - dstOffsetFrames\n        );\n\n        if (actualCopyFrames > 0) {\n          const srcSlice = srcPlane.subarray(srcOffsetFrames, srcOffsetFrames + actualCopyFrames);\n          dstPlane.set(srcSlice, dstOffsetFrames);\n        }\n      }\n    }\n\n    return result;\n  }\n\n  getPCMWithMetadata(\n    clipId: string,\n    startUs: TimeUs,\n    endUs: TimeUs\n  ): { planes: Float32Array[]; sampleRate: number; numberOfChannels: number } | null {\n    const slots = this.audioDataByClip.get(clipId);\n    if (!slots || slots.length === 0) {\n      return null;\n    }\n\n    const planes = this.getPCM(clipId, startUs, endUs);\n    if (!planes) {\n      return null;\n    }\n\n    // Use first slot's metadata\n    const firstSlot = slots[0]!;\n    return {\n      planes,\n      sampleRate: firstSlot.sampleRate,\n      numberOfChannels: firstSlot.numberOfChannels,\n    };\n  }\n\n  hasClipPCM(clipId: string): boolean {\n    return this.audioDataByClip.has(clipId);\n  }\n\n  /**\n   * Check if a slot with specific timestamp exists (used for incremental decoding)\n   */\n  hasSlotAt(clipId: string, timestampUs: TimeUs, toleranceUs: number = 1000): boolean {\n    const slots = this.audioDataByClip.get(clipId);\n    if (!slots) return false;\n\n    // Since slots are sorted, we can use binary search\n    const index = this.findInsertIndex(slots, timestampUs);\n\n    // Check index and index-1 (in case findInsertIndex lands after)\n    if (index < slots.length) {\n      const slot = slots[index];\n      if (slot && Math.abs(slot.timestampUs - timestampUs) < toleranceUs) return true;\n    }\n    if (index > 0) {\n      const slot = slots[index - 1];\n      if (slot && Math.abs(slot.timestampUs - timestampUs) < toleranceUs) return true;\n    }\n    return false;\n  }\n\n  /**\n   * Check if sufficient PCM data exists for the requested time window\n   * Returns true only if at least 99% of requested duration is available\n   */\n  hasWindowData(clipId: string, startUs: TimeUs, endUs: TimeUs): boolean {\n    const slots = this.audioDataByClip.get(clipId);\n    if (!slots || slots.length === 0) {\n      return false;\n    }\n\n    // Use binary search to find overlapping slots (performance optimization)\n    const overlappingSlots = binarySearchOverlapping(slots, startUs, endUs, (slot) => ({\n      start: slot.timestampUs,\n      end: slot.timestampUs + slot.durationUs,\n    }));\n\n    if (overlappingSlots.length === 0) {\n      return false;\n    }\n\n    // Calculate total duration covered\n    let coveredDurationUs = 0;\n    const requestedDurationUs = endUs - startUs;\n\n    for (const slot of overlappingSlots) {\n      const slotEndUs = slot.timestampUs + slot.durationUs;\n\n      // Calculate overlap with requested range\n      const overlapStart = Math.max(slot.timestampUs, startUs);\n      const overlapEnd = Math.min(slotEndUs, endUs);\n\n      if (overlapStart < overlapEnd) {\n        coveredDurationUs += overlapEnd - overlapStart;\n      }\n    }\n\n    // Consider window data sufficient if we have at least 99% coverage\n    // We use 0.99 instead of 1.0 to tolerate minor floating-point precision errors\n    return coveredDurationUs >= requestedDurationUs * 0.99;\n  }\n\n  clearClipPCM(clipId: string): void {\n    this.audioDataByClip.delete(clipId);\n  }\n\n  /**\n   * Update window center (unified global window)\n   * Aligned with VideoL1Cache strategy: maintains a window of ±RADIUS around center\n   */\n  setWindow(centerGlobalUs: TimeUs): void {\n    this.windowCenter = centerGlobalUs;\n    this.checkEviction();\n  }\n\n  private checkEviction(): void {\n    const now = Date.now();\n    if (now - this.lastEvictTime > this.EVICT_THROTTLE_MS) {\n      this.evictOutOfWindow();\n      this.lastEvictTime = now;\n    }\n  }\n\n  /**\n   * Evict audio slots outside the global window (aligned with VideoL1Cache)\n   * Skip if eviction is disabled (e.g., during export)\n   */\n  private evictOutOfWindow(): void {\n    const windowStart = Math.max(0, this.windowCenter - this.WINDOW_RADIUS);\n    const windowEnd = this.windowCenter + this.WINDOW_RADIUS;\n\n    for (const [clipId, slots] of this.audioDataByClip) {\n      const toKeep: AudioDataSlot[] = [];\n\n      for (const slot of slots) {\n        const globalTime = slot.globalTimeUs;\n\n        // Slots without globalTimeUs are kept (legacy)\n        if (globalTime === undefined) {\n          toKeep.push(slot);\n          continue;\n        }\n\n        // Keep slots within window\n        if (globalTime >= windowStart && globalTime <= windowEnd) {\n          toKeep.push(slot);\n        }\n        // Slots outside window are discarded (no close needed for Float32Array)\n      }\n\n      if (toKeep.length > 0) {\n        this.audioDataByClip.set(clipId, toKeep);\n      } else {\n        this.audioDataByClip.delete(clipId);\n      }\n    }\n  }\n\n  /**\n   * Find insertion index for a new slot (aligned with VideoL1Cache)\n   */\n  private findInsertIndex(slots: AudioDataSlot[], timestamp: TimeUs): number {\n    return binarySearchFirst(slots, (slot) => slot.timestampUs >= timestamp);\n  }\n\n  flush(): void {\n    this.audioDataByClip.clear();\n  }\n\n  clear(): void {\n    this.flush();\n    this.audioDataByClip.clear();\n    this.windowCenter = 0;\n  }\n\n  dispose(): void {\n    this.clear();\n  }\n}\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"AudioL1Cache.js","sources":["../../../src/cache/l1/AudioL1Cache.ts"],"sourcesContent":["import type { TimeUs } from '../../model/types';\nimport { binarySearchFirst, binarySearchOverlapping } from '../../utils/binary-search';\nimport { extractPlanesFromAudioData } from '../../utils/audio-data';\n\ninterface AudioDataSlot {\n  timestampUs: TimeUs; // Resource timestamp (aligned with VideoL1Cache)\n  durationUs: TimeUs;\n  planes: Float32Array[]; // PCM data for this slot\n  sampleRate: number;\n  numberOfChannels: number;\n  globalTimeUs?: TimeUs; // Global timeline time (for window management)\n}\n\nexport type { AudioDataSlot };\n\nexport class AudioL1Cache {\n  // Aligned with VideoL1Cache: array of discrete audio data slots per clip\n  private audioDataByClip = new Map<string, AudioDataSlot[]>();\n\n  // Unified window management (aligned with VideoL1Cache)\n  // All clips share the same global window center\n  private windowCenter: TimeUs = 0;\n\n  // Window radius aligned with video (±3.5s, but we use 5s for audio safety margin)\n  private readonly WINDOW_RADIUS = 5_000_000; // ±5s\n  private readonly EVICT_THROTTLE_MS = 500;\n  private lastEvictTime = 0;\n\n  putClipAudioData(\n    clipId: string,\n    audioData: AudioData,\n    _clipDurationUs: TimeUs,\n    globalTimeUs?: TimeUs\n  ): void {\n    const numberOfChannels = audioData.numberOfChannels ?? 2;\n    const numberOfFrames = audioData.numberOfFrames ?? 0;\n    const sampleRate = audioData.sampleRate ?? 48_000;\n    const audioTimestampUs = audioData.timestamp ?? 0;\n    const audioDurationUs =\n      audioData.duration ?? Math.round((numberOfFrames / sampleRate) * 1_000_000);\n\n    if (!numberOfChannels || !numberOfFrames) {\n      audioData.close();\n      return;\n    }\n\n    // Extract PCM data\n    const planes = extractPlanesFromAudioData(audioData, numberOfChannels, numberOfFrames);\n    audioData.close();\n\n    // Create audio data slot (aligned with video architecture)\n    const slot: AudioDataSlot = {\n      timestampUs: audioTimestampUs,\n      durationUs: audioDurationUs,\n      planes,\n      sampleRate,\n      numberOfChannels,\n      globalTimeUs,\n    };\n    // Get or create slots array for this clip\n    let slots = this.audioDataByClip.get(clipId);\n    if (!slots) {\n      slots = [];\n      this.audioDataByClip.set(clipId, slots);\n    }\n\n    // Insert slot in sorted order (aligned with VideoL1Cache.addFrame)\n    const insertIndex = this.findInsertIndex(slots, audioTimestampUs);\n\n    // Deduplication: Check for duplicate or near-duplicate timestamp\n    // Tolerance of 1ms to handle floating-point precision and concurrent decode attempts\n    const DUPLICATE_THRESHOLD_US = 0.5 * audioDurationUs;\n\n    if (insertIndex < slots.length) {\n      const existingSlot = slots[insertIndex]!;\n      const timeDiff = Math.abs(existingSlot.timestampUs - audioTimestampUs);\n\n      if (timeDiff < DUPLICATE_THRESHOLD_US) {\n        // Near-duplicate detected, skip insertion\n        return;\n      }\n    }\n\n    // Also check previous slot to catch overlapping duplicates\n    if (insertIndex > 0) {\n      const prevSlot = slots[insertIndex - 1]!;\n      const timeDiff = Math.abs(prevSlot.timestampUs - audioTimestampUs);\n\n      if (timeDiff < DUPLICATE_THRESHOLD_US) {\n        // Near-duplicate detected, skip insertion\n        return;\n      }\n    }\n\n    // Insert new slot\n    slots.splice(insertIndex, 0, slot);\n  }\n\n  getSlotsInWindow(clipId: string, startUs: TimeUs, endUs: TimeUs): AudioDataSlot[] | null {\n    const slots = this.audioDataByClip.get(clipId);\n    if (!slots || slots.length === 0) {\n      return null;\n    }\n\n    // Use binary search to find overlapping slots\n    const overlappingSlots = binarySearchOverlapping(slots, startUs, endUs, (slot) => ({\n      start: slot.timestampUs,\n      end: slot.timestampUs + slot.durationUs,\n    }));\n\n    if (overlappingSlots.length === 0) {\n      return null;\n    }\n\n    return overlappingSlots;\n  }\n\n  getPCM(clipId: string, startUs: TimeUs, endUs: TimeUs): Float32Array[] | null {\n    const slots = this.audioDataByClip.get(clipId);\n    if (!slots || slots.length === 0) {\n      return null;\n    }\n\n    // Use binary search to find overlapping slots (O(log n + k) vs O(n))\n    // Aligned with video GOP/frame search\n    const overlappingSlots = binarySearchOverlapping(slots, startUs, endUs, (slot) => ({\n      start: slot.timestampUs,\n      end: slot.timestampUs + slot.durationUs,\n    }));\n\n    if (overlappingSlots.length === 0) {\n      return null;\n    }\n\n    const requestedDurationUs = endUs - startUs;\n\n    // Validate sample rate consistency across all slots\n    const firstSlot = overlappingSlots[0]!;\n    const uniformSampleRate = firstSlot.sampleRate;\n    const uniformChannels = firstSlot.numberOfChannels;\n\n    // Check if all slots have the same sample rate and channel count\n    const hasUniformRate = overlappingSlots.every(\n      (s) => s.sampleRate === uniformSampleRate && s.numberOfChannels === uniformChannels\n    );\n\n    if (!hasUniformRate) {\n      console.error(\n        `[AudioL1Cache] Inconsistent sample rates detected for clip ${clipId}:`,\n        overlappingSlots.map((s) => ({\n          timestamp: s.timestampUs,\n          sampleRate: s.sampleRate,\n          channels: s.numberOfChannels,\n        }))\n      );\n      // Return null to avoid corrupted audio data\n      // This will trigger re-decode with correct sample rate\n      return null;\n    }\n\n    // Calculate total frame count needed\n    const totalFrames = Math.ceil((requestedDurationUs / 1_000_000) * uniformSampleRate);\n\n    // Initialize result arrays\n    const result: Float32Array[] = Array.from(\n      { length: uniformChannels },\n      () => new Float32Array(totalFrames)\n    );\n\n    // Copy data from each overlapping slot\n    // Note: Slots are guaranteed non-overlapping by putClipAudioData deduplication\n    for (const slot of overlappingSlots) {\n      const slotStartUs = slot.timestampUs;\n      const slotEndUs = slotStartUs + slot.durationUs;\n\n      // Calculate intersection with requested range\n      const copyStartUs = Math.max(slotStartUs, startUs);\n      const copyEndUs = Math.min(slotEndUs, endUs);\n\n      if (copyStartUs >= copyEndUs) continue;\n\n      // Convert time to frame indices (all slots have same sample rate after validation)\n      const srcOffsetFrames = Math.floor(\n        ((copyStartUs - slotStartUs) / 1_000_000) * uniformSampleRate\n      );\n      const dstOffsetFrames = Math.floor(((copyStartUs - startUs) / 1_000_000) * uniformSampleRate);\n      const copyFrameCount = Math.ceil(((copyEndUs - copyStartUs) / 1_000_000) * uniformSampleRate);\n\n      // Copy each channel\n      for (let ch = 0; ch < uniformChannels; ch++) {\n        const srcPlane = slot.planes[ch];\n        const dstPlane = result[ch];\n        if (!srcPlane || !dstPlane) continue;\n\n        // Boundary check\n        const actualCopyFrames = Math.min(\n          copyFrameCount,\n          srcPlane.length - srcOffsetFrames,\n          dstPlane.length - dstOffsetFrames\n        );\n\n        if (actualCopyFrames > 0) {\n          const srcSlice = srcPlane.subarray(srcOffsetFrames, srcOffsetFrames + actualCopyFrames);\n          dstPlane.set(srcSlice, dstOffsetFrames);\n        }\n      }\n    }\n\n    return result;\n  }\n\n  getPCMWithMetadata(\n    clipId: string,\n    startUs: TimeUs,\n    endUs: TimeUs\n  ): { planes: Float32Array[]; sampleRate: number; numberOfChannels: number } | null {\n    const slots = this.audioDataByClip.get(clipId);\n    if (!slots || slots.length === 0) {\n      return null;\n    }\n\n    const planes = this.getPCM(clipId, startUs, endUs);\n    if (!planes) {\n      return null;\n    }\n\n    // Use first slot's metadata\n    const firstSlot = slots[0]!;\n    return {\n      planes,\n      sampleRate: firstSlot.sampleRate,\n      numberOfChannels: firstSlot.numberOfChannels,\n    };\n  }\n\n  hasClipPCM(clipId: string): boolean {\n    return this.audioDataByClip.has(clipId);\n  }\n\n  /**\n   * Check if a slot with specific timestamp exists (used for incremental decoding)\n   */\n  hasSlotAt(clipId: string, timestampUs: TimeUs, toleranceUs: number = 1000): boolean {\n    const slots = this.audioDataByClip.get(clipId);\n    if (!slots) return false;\n\n    // Since slots are sorted, we can use binary search\n    const index = this.findInsertIndex(slots, timestampUs);\n\n    // Check index and index-1 (in case findInsertIndex lands after)\n    if (index < slots.length) {\n      const slot = slots[index];\n      if (slot && Math.abs(slot.timestampUs - timestampUs) < toleranceUs) return true;\n    }\n    if (index > 0) {\n      const slot = slots[index - 1];\n      if (slot && Math.abs(slot.timestampUs - timestampUs) < toleranceUs) return true;\n    }\n    return false;\n  }\n\n  /**\n   * Check if sufficient PCM data exists for the requested time window\n   * Returns true only if at least 99% of requested duration is available\n   */\n  hasWindowData(clipId: string, startUs: TimeUs, endUs: TimeUs): boolean {\n    const slots = this.audioDataByClip.get(clipId);\n    if (!slots || slots.length === 0) {\n      return false;\n    }\n\n    // Use binary search to find overlapping slots (performance optimization)\n    const overlappingSlots = binarySearchOverlapping(slots, startUs, endUs, (slot) => ({\n      start: slot.timestampUs,\n      end: slot.timestampUs + slot.durationUs,\n    }));\n\n    if (overlappingSlots.length === 0) {\n      return false;\n    }\n\n    // Calculate total duration covered\n    let coveredDurationUs = 0;\n    const requestedDurationUs = endUs - startUs;\n\n    for (const slot of overlappingSlots) {\n      const slotEndUs = slot.timestampUs + slot.durationUs;\n\n      // Calculate overlap with requested range\n      const overlapStart = Math.max(slot.timestampUs, startUs);\n      const overlapEnd = Math.min(slotEndUs, endUs);\n\n      if (overlapStart < overlapEnd) {\n        coveredDurationUs += overlapEnd - overlapStart;\n      }\n    }\n\n    // Consider window data sufficient if we have at least 99% coverage\n    // We use 0.99 instead of 1.0 to tolerate minor floating-point precision errors\n    return coveredDurationUs >= requestedDurationUs * 0.99;\n  }\n\n  clearClipPCM(clipId: string): void {\n    this.audioDataByClip.delete(clipId);\n  }\n\n  /**\n   * Update window center (unified global window)\n   * Aligned with VideoL1Cache strategy: maintains a window of ±RADIUS around center\n   */\n  setWindow(centerGlobalUs: TimeUs): void {\n    this.windowCenter = centerGlobalUs;\n    this.checkEviction();\n  }\n\n  private checkEviction(): void {\n    const now = Date.now();\n    if (now - this.lastEvictTime > this.EVICT_THROTTLE_MS) {\n      this.evictOutOfWindow();\n      this.lastEvictTime = now;\n    }\n  }\n\n  /**\n   * Evict audio slots outside the global window (aligned with VideoL1Cache)\n   * Skip if eviction is disabled (e.g., during export)\n   */\n  private evictOutOfWindow(): void {\n    const windowStart = Math.max(0, this.windowCenter - this.WINDOW_RADIUS);\n    const windowEnd = this.windowCenter + this.WINDOW_RADIUS;\n\n    for (const [clipId, slots] of this.audioDataByClip) {\n      const toKeep: AudioDataSlot[] = [];\n\n      for (const slot of slots) {\n        const globalTime = slot.globalTimeUs;\n\n        // Slots without globalTimeUs are kept (legacy)\n        if (globalTime === undefined) {\n          toKeep.push(slot);\n          continue;\n        }\n\n        // Keep slots within window\n        if (globalTime >= windowStart && globalTime <= windowEnd) {\n          toKeep.push(slot);\n        }\n        // Slots outside window are discarded (no close needed for Float32Array)\n      }\n\n      if (toKeep.length > 0) {\n        this.audioDataByClip.set(clipId, toKeep);\n      } else {\n        this.audioDataByClip.delete(clipId);\n      }\n    }\n  }\n\n  /**\n   * Find insertion index for a new slot (aligned with VideoL1Cache)\n   */\n  private findInsertIndex(slots: AudioDataSlot[], timestamp: TimeUs): number {\n    return binarySearchFirst(slots, (slot) => slot.timestampUs >= timestamp);\n  }\n\n  flush(): void {\n    this.audioDataByClip.clear();\n  }\n\n  clear(): void {\n    this.flush();\n    this.audioDataByClip.clear();\n    this.windowCenter = 0;\n  }\n\n  dispose(): void {\n    this.clear();\n  }\n}\n"],"names":[],"mappings":"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"}

package/dist/controllers/PlaybackController.d.ts

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

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

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

package/dist/controllers/PlaybackController.js

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

package/dist/controllers/PlaybackController.js.map

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

package/dist/model/RcFrame.d.ts

@@ -9,24 +9,35 @@ export interface RcFrameMetadata {
     globalTimeUs?: TimeUs;
 }
 type UseHandler<T> = (frame: VideoFrame) => T | Promise<T>;
+/**
+ * RcFrame - Lightweight VideoFrame wrapper with metadata
+ *
+ * Design:
+ * - Carries metadata (timestamp, clipId, trackId, size) for cache management
+ * - Provides unified .use() interface for accessing the frame
+ * - Uses clone() to safely share frame across async operations
+ * - Manages frame lifecycle with simple .close() wrapper
+ */
 export declare class RcFrame {
-    private activeUses;
-    private closing;
+    private closed;
     private readonly baseFrame;
     private readonly metadata;
-    private readonly onZero?;
-    private closePromise;
-    private closeResolve;
     private constructor();
-    static wrap(frame: VideoFrame, metadata: RcFrameMetadata, onZero?: () => void): RcFrame;
+    static wrap(frame: VideoFrame, metadata: RcFrameMetadata): RcFrame;
     get timestampUs(): TimeUs;
     get durationUs(): TimeUs;
     get trackId(): string;
     get clipId(): string;
     get globalTimeUs(): TimeUs | undefined;
     get sizeEstimate(): number;
+    /**
+     * Execute handler with access to a cloned VideoFrame
+     *
+     * The cloned frame is automatically closed after handler completes
+     * This ensures safe async usage without lifecycle management complexity
+     */
     use<T>(handler: UseHandler<T>): Promise<T>;
-    close(): Promise<void>;
+    close(): void;
 }
 export {};
 //# sourceMappingURL=RcFrame.d.ts.map

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

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

package/dist/model/RcFrame.js

@@ -1,20 +1,14 @@
 const DEFAULT_SIZE_ESTIMATE = 1920 * 1080 * 4;
-const CLOSE_TIMEOUT_MS = 3e3;
 class RcFrame {
-  activeUses = 0;
-  closing = false;
+  closed = false;
   baseFrame;
   metadata;
-  onZero;
-  closePromise = null;
-  closeResolve = null;
-  constructor(frame, metadata, onZero) {
+  constructor(frame, metadata) {
     this.baseFrame = frame;
     this.metadata = metadata;
-    this.onZero = onZero;
   }
-  static wrap(frame, metadata, onZero) {
-    return new RcFrame(frame, metadata, onZero);
+  static wrap(frame, metadata) {
+    return new RcFrame(frame, metadata);
   }
   get timestampUs() {
     return this.metadata.timestampUs;
@@ -42,50 +36,29 @@ class RcFrame {
     }
     return DEFAULT_SIZE_ESTIMATE;
   }
+  /**
+   * Execute handler with access to a cloned VideoFrame
+   *
+   * The cloned frame is automatically closed after handler completes
+   * This ensures safe async usage without lifecycle management complexity
+   */
   async use(handler) {
-    if (this.closing) {
-      throw new Error("RcFrame is closing, cannot use frame");
+    if (this.closed) {
+      throw new Error("RcFrame already closed");
     }
     const cloned = this.baseFrame.clone();
-    this.activeUses += 1;
     try {
       return await handler(cloned);
     } finally {
       cloned.close();
-      this.activeUses -= 1;
-      if (this.activeUses === 0 && this.closing && this.closeResolve) {
-        this.closeResolve();
-      }
     }
   }
-  async close() {
-    if (this.closing) {
-      return this.closePromise ?? Promise.resolve();
+  close() {
+    if (this.closed) {
+      return;
     }
-    this.closing = true;
-    if (this.activeUses === 0) {
-      this.baseFrame.close();
-      this.onZero?.();
-      return Promise.resolve();
-    }
-    if (!this.closePromise) {
-      this.closePromise = new Promise((resolve) => {
-        this.closeResolve = () => {
-          this.baseFrame.close();
-          this.onZero?.();
-          resolve();
-        };
-      });
-      setTimeout(() => {
-        if (this.closeResolve) {
-          this.baseFrame.close();
-          this.onZero?.();
-          this.closeResolve();
-          this.closeResolve = null;
-        }
-      }, CLOSE_TIMEOUT_MS).unref?.();
-    }
-    return this.closePromise;
+    this.baseFrame.close();
+    this.closed = true;
   }
 }
 export {

package/dist/model/RcFrame.js.map

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

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

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

package/dist/orchestrator/GlobalAudioSession.js

@@ -250,7 +250,10 @@ class GlobalAudioSession {
       }
       const clipRelativeStartUs = Math.max(0, startUs - clip.startUs);
       const clipRelativeEndUs = Math.min(clip.durationUs, endUs - clip.startUs);
-      await this.ensureAudioWindow(clip.id, clipRelativeStartUs, clipRelativeEndUs);
+      const trimStartUs = clip.trimStartUs ?? 0;
+      const resourceStartUs = clipRelativeStartUs + trimStartUs;
+      const resourceEndUs = clipRelativeEndUs + trimStartUs;
+      await this.ensureAudioWindow(clip.id, resourceStartUs, resourceEndUs);
     });
     if (immediate) {
       void Promise.all(ensurePromises);