@meframe/core 0.0.1

package/dist/controllers/PlaybackController.js

@@ -0,0 +1,369 @@
+import { MeframeEvent } from "../event/events.js";
+import { quantizeTimestampToFrame } from "../utils/time-utils.js";
+class PlaybackController {
+  orchestrator;
+  eventBus;
+  canvas;
+  ctx;
+  // Playback state
+  _currentTimeUs = 0;
+  _state = "idle";
+  playbackRate = 1;
+  volume = 1;
+  loop = false;
+  // Animation loop
+  rafId = null;
+  startTime = 0;
+  // Frame tracking
+  frameCount = 0;
+  lastFrameTime = 0;
+  fps = 0;
+  audioContext = null;
+  audioSource = null;
+  audioGainNode = null;
+  audioSession = null;
+  // Buffering state
+  isBuffering = false;
+  constructor(orchestrator, eventBus, options) {
+    this.orchestrator = orchestrator;
+    this.eventBus = eventBus;
+    this.canvas = options.canvas;
+    const ctx = this.canvas.getContext("2d", {
+      alpha: false,
+      desynchronized: true,
+      colorSpace: "srgb"
+    });
+    if (!ctx) {
+      throw new Error("Failed to get 2D context from canvas");
+    }
+    this.ctx = ctx;
+    this.ctx.imageSmoothingEnabled = true;
+    this.ctx.imageSmoothingQuality = "high";
+    if (options.startUs !== void 0) {
+      this._currentTimeUs = options.startUs;
+    }
+    if (options.rate !== void 0) {
+      this.playbackRate = options.rate;
+    }
+    if (options.loop !== void 0) {
+      this.loop = options.loop;
+    }
+    if (options.autoStart) {
+      this.play();
+    }
+  }
+  // Playback control
+  play() {
+    if (this._state === "playing") return;
+    void this.startPlayback();
+  }
+  async startPlayback() {
+    const wasIdle = this._state === "idle";
+    this._state = "buffering";
+    this.eventBus.emit(MeframeEvent.PlaybackBuffering);
+    try {
+      await this.orchestrator.ensureClipCache(this._currentTimeUs);
+      const ready = await this.orchestrator.waitForClipReady(this._currentTimeUs, {
+        minFrameCount: 30,
+        timeoutMs: 3e3
+      });
+      if (!ready) {
+        console.warn("[PlaybackController] Buffering timeout, starting anyway");
+      }
+      this._state = "playing";
+      this.startTime = performance.now() - this._currentTimeUs / 1e3 / this.playbackRate;
+      await this.ensureAudioContext();
+      this.startAudioPlayback();
+      this.playbackLoop();
+      this.eventBus.emit(MeframeEvent.PlaybackPlay);
+    } catch (error) {
+      console.error("[PlaybackController] Failed to start playback:", error);
+      this._state = wasIdle ? "idle" : "paused";
+      this.eventBus.emit(MeframeEvent.PlaybackError, error);
+    }
+  }
+  pause() {
+    if (this._state !== "playing") return;
+    this._state = "paused";
+    if (this.rafId !== null) {
+      cancelAnimationFrame(this.rafId);
+      this.rafId = null;
+    }
+    this.stopAudioPlayback();
+    this.eventBus.emit(MeframeEvent.PlaybackPause);
+  }
+  stop() {
+    this.pause();
+    this._currentTimeUs = 0;
+    this._state = "idle";
+    this.frameCount = 0;
+    this.lastFrameTime = 0;
+    this.fps = 0;
+    this.ctx.clearRect(0, 0, this.canvas.width, this.canvas.height);
+    this.audioSession?.reset();
+    this.stopAudioPlayback();
+    this.eventBus.emit(MeframeEvent.PlaybackStop);
+  }
+  async seek(timeUs) {
+    const wasPlaying = this._state === "playing";
+    const previousState = this._state;
+    if (wasPlaying) {
+      this.pause();
+    }
+    const clamped = this.clampTime(timeUs);
+    this._currentTimeUs = clamped;
+    this._state = "seeking";
+    this.stopAudioPlayback();
+    try {
+      await this.orchestrator.ensureClipCache(clamped);
+      const ready = await this.orchestrator.waitForClipReady(clamped, {
+        minFrameCount: 10,
+        timeoutMs: 2e3
+      });
+      if (!ready) {
+        console.warn("[PlaybackController] Seek buffering timeout");
+      }
+      await this.renderCurrentFrame(clamped);
+      this.eventBus.emit(MeframeEvent.PlaybackSeek, { timeUs: this._currentTimeUs });
+    } catch (error) {
+      console.error("[PlaybackController] Seek error:", error);
+      this.eventBus.emit(MeframeEvent.PlaybackError, error);
+    } finally {
+      if (wasPlaying) {
+        this._state = "playing";
+        this.startTime = performance.now() - this._currentTimeUs / 1e3 / this.playbackRate;
+        await this.ensureAudioContext();
+        this.startAudioPlayback();
+        if (!this.rafId) {
+          this.playbackLoop();
+        }
+      } else {
+        this._state = previousState === "idle" ? "idle" : "paused";
+      }
+    }
+  }
+  // Playback properties
+  setRate(rate) {
+    const elapsed = performance.now() - this.startTime;
+    this.playbackRate = rate;
+    this.startTime = performance.now() - elapsed / rate;
+    this.eventBus.emit(MeframeEvent.PlaybackRateChange, { rate });
+    if (this.audioSource) {
+      this.audioSource.playbackRate.value = this.playbackRate;
+    }
+  }
+  setVolume(volume) {
+    this.volume = Math.max(0, Math.min(1, volume));
+    this.eventBus.emit(MeframeEvent.PlaybackVolumeChange, { volume: this.volume });
+    if (this.audioGainNode) {
+      this.audioGainNode.gain.value = this.volume;
+    }
+  }
+  setMute(muted) {
+    if (muted) {
+      this.stopAudioPlayback();
+    } else if (this._state === "playing") {
+      this.startAudioPlayback();
+    }
+  }
+  setLoop(loop) {
+    this.loop = loop;
+  }
+  // State properties
+  get currentTime() {
+    if (this._state === "playing") {
+      const elapsed = (performance.now() - this.startTime) * this.playbackRate;
+      this._currentTimeUs = Math.min(elapsed * 1e3, this.duration);
+    }
+    return this._currentTimeUs;
+  }
+  get duration() {
+    const modelDuration = this.orchestrator.compositionModel?.durationUs;
+    if (modelDuration !== void 0) {
+      return modelDuration;
+    }
+    return 0;
+  }
+  get state() {
+    return this._state;
+  }
+  get playing() {
+    return this._state === "playing";
+  }
+  setAudioSession(session) {
+    this.audioSession = session;
+  }
+  // Resume is just an alias for play
+  resume() {
+    this.play();
+  }
+  // Private methods
+  playbackLoop() {
+    if (this._state !== "playing") {
+      if (this.rafId !== null) {
+        cancelAnimationFrame(this.rafId);
+        this.rafId = null;
+      }
+      return;
+    }
+    const frameStartTime = performance.now();
+    this.rafId = requestAnimationFrame(async () => {
+      if (this._state !== "playing") {
+        return;
+      }
+      this.updateTime();
+      await this.renderCurrentFrame();
+      if (this._state !== "playing") {
+        return;
+      }
+      const now = performance.now();
+      if (this.lastFrameTime > 0) {
+        const deltaTime = now - this.lastFrameTime;
+        const instantFps = 1e3 / deltaTime;
+        this.fps = this.fps > 0 ? this.fps * 0.9 + instantFps * 0.1 : instantFps;
+      }
+      this.lastFrameTime = now;
+      this.frameCount++;
+      const primaryClip = this.orchestrator.compositionModel?.primaryClip;
+      if (primaryClip) {
+        this.eventBus.emit(MeframeEvent.ComposeFrameReady, {
+          timeUs: this._currentTimeUs,
+          frameNumber: this.frameCount,
+          renderTimeMs: now - frameStartTime,
+          trackId: primaryClip.trackId || "main",
+          clipId: primaryClip.id
+        });
+      }
+      this.playbackLoop();
+    });
+  }
+  updateTime() {
+    const elapsed = (performance.now() - this.startTime) * this.playbackRate;
+    const rawTimeUs = elapsed * 1e3;
+    const fps = this.orchestrator.compositionModel?.fps;
+    this._currentTimeUs = quantizeTimestampToFrame(rawTimeUs, 0, fps, "nearest");
+    if (this._currentTimeUs >= this.duration) {
+      if (this.loop) {
+        this._currentTimeUs = 0;
+        this.startTime = performance.now();
+      } else {
+        this._currentTimeUs = this.duration;
+        this.pause();
+        this._state = "ended";
+        this.eventBus.emit(MeframeEvent.PlaybackEnded, { timeUs: this._currentTimeUs });
+      }
+    }
+    this.eventBus.emit(MeframeEvent.PlaybackTimeUpdate, { timeUs: this._currentTimeUs });
+  }
+  async renderCurrentFrame(timeUs) {
+    try {
+      const targetTime = timeUs ?? this._currentTimeUs;
+      const rcFrame = await this.orchestrator.renderFrame(targetTime);
+      if (!rcFrame) {
+        if (this._state === "playing") {
+          await this.handlePlaybackBuffering(targetTime);
+        }
+        return;
+      }
+      await rcFrame.use((frame) => {
+        this.ctx.imageSmoothingEnabled = true;
+        this.ctx.imageSmoothingQuality = "high";
+        this.ctx.drawImage(frame, 0, 0, this.canvas.width, this.canvas.height);
+      });
+    } catch (error) {
+      console.error("Render error:", error);
+      this.eventBus.emit(MeframeEvent.PlaybackError, error);
+    }
+  }
+  async handlePlaybackBuffering(timeUs) {
+    if (this.isBuffering) {
+      return;
+    }
+    const wasPlaying = this._state === "playing";
+    if (!wasPlaying) return;
+    this.isBuffering = true;
+    this._state = "buffering";
+    this.eventBus.emit(MeframeEvent.PlaybackBuffering);
+    console.log(`[PlaybackController] Buffering at ${timeUs}µs (clip transition)`);
+    try {
+      await this.orchestrator.ensureClipCache(timeUs);
+      const ready = await this.orchestrator.waitForClipReady(timeUs, {
+        minFrameCount: 15,
+        // 0.5s @30fps - faster resume
+        timeoutMs: 2e3
+      });
+      if (!ready) {
+        console.warn("[PlaybackController] Buffering timeout during playback");
+      }
+      this._state = "playing";
+      this.startTime = performance.now() - timeUs / 1e3 / this.playbackRate;
+      this.eventBus.emit(MeframeEvent.PlaybackPlay);
+      if (!this.rafId) {
+        this.playbackLoop();
+      }
+    } catch (error) {
+      console.error("[PlaybackController] Buffering error:", error);
+      this._state = "paused";
+      this.eventBus.emit(MeframeEvent.PlaybackError, error);
+    } finally {
+      this.isBuffering = false;
+    }
+  }
+  clampTime(timeUs) {
+    return Math.max(0, Math.min(timeUs, this.duration));
+  }
+  // Cleanup
+  dispose() {
+    this.stop();
+  }
+  async ensureAudioContext() {
+    if (this.audioContext) {
+      return;
+    }
+    this.audioContext = new AudioContext();
+    this.audioGainNode = this.audioContext.createGain();
+    this.audioGainNode.gain.value = this.volume;
+    this.audioGainNode.connect(this.audioContext.destination);
+  }
+  startAudioPlayback() {
+    if (!this.audioContext || !this.audioSession || !this.audioGainNode) {
+      return;
+    }
+    this.stopAudioPlayback();
+    const startUs = this._currentTimeUs;
+    this.audioSession.ensureMixedPCM(startUs).then((audioBuffer) => {
+      if (!audioBuffer || !this.audioContext || !this.audioGainNode) {
+        return;
+      }
+      const source = this.audioContext.createBufferSource();
+      source.buffer = audioBuffer;
+      source.playbackRate.value = this.playbackRate;
+      source.onended = () => {
+        this.audioSource = null;
+        if (this._state === "playing") {
+          this.startAudioPlayback();
+        }
+      };
+      source.connect(this.audioGainNode);
+      source.start();
+      this.audioSource = source;
+    }).catch((error) => {
+      console.error("[PlaybackController] Audio playback error:", error);
+    });
+  }
+  stopAudioPlayback() {
+    if (this.audioSource) {
+      try {
+        this.audioSource.stop();
+      } catch (error) {
+        console.warn("[PlaybackController] stop audio failed", error);
+      }
+      this.audioSource.disconnect();
+      this.audioSource = null;
+    }
+  }
+}
+export {
+  PlaybackController
+};
+//# sourceMappingURL=PlaybackController.js.map

package/dist/controllers/PlaybackController.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PlaybackController.js","sources":["../../src/controllers/PlaybackController.ts"],"sourcesContent":["import type {\n  IPlaybackController,\n  PlaybackState,\n  PlaybackOptions,\n  IOrchestratorForControl,\n  IEventBus,\n} from './types';\nimport type { TimeUs } from '../model/types';\nimport { MeframeEvent } from '../event/events';\nimport { quantizeTimestampToFrame } from '../utils/time-utils';\nimport type { GlobalAudioSession } from '../stages/compose/GlobalAudioSession';\n\n/**\n * Playback controller for preview\n * Internal implementation - not exposed directly to external consumers\n */\nexport class PlaybackController implements IPlaybackController {\n  private orchestrator: IOrchestratorForControl;\n  private eventBus: IEventBus;\n  private canvas: HTMLCanvasElement | OffscreenCanvas;\n  private ctx: CanvasRenderingContext2D | OffscreenCanvasRenderingContext2D;\n\n  // Playback state\n  private _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 startTime = 0;\n\n  // Frame tracking\n  private frameCount = 0;\n  private lastFrameTime = 0;\n  private fps = 0;\n  private audioContext: AudioContext | null = null;\n  private audioSource: AudioBufferSourceNode | null = null;\n  private audioGainNode: GainNode | null = null;\n  private audioSession: GlobalAudioSession | null = null;\n\n  // Buffering state\n  private isBuffering = false;\n\n  constructor(\n    orchestrator: IOrchestratorForControl,\n    eventBus: IEventBus,\n    options: PlaybackOptions\n  ) {\n    this.orchestrator = orchestrator;\n    this.eventBus = eventBus;\n    this.canvas = options.canvas;\n\n    // Get 2D context with high quality settings\n    const ctx = this.canvas.getContext('2d', {\n      alpha: false,\n      desynchronized: true,\n      colorSpace: 'srgb',\n    } as any);\n    if (!ctx) {\n      throw new Error('Failed to get 2D context from canvas');\n    }\n    this.ctx = ctx as CanvasRenderingContext2D | OffscreenCanvasRenderingContext2D;\n\n    // Configure high quality rendering\n    this.ctx.imageSmoothingEnabled = true;\n    this.ctx.imageSmoothingQuality = 'high';\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\n  // Playback control\n  play(): void {\n    if (this._state === 'playing') return;\n\n    void this.startPlayback();\n  }\n\n  private async startPlayback(): Promise<void> {\n    const wasIdle = this._state === 'idle';\n\n    this._state = 'buffering';\n    this.eventBus.emit(MeframeEvent.PlaybackBuffering);\n\n    try {\n      await this.orchestrator.ensureClipCache(this._currentTimeUs);\n\n      const ready = await this.orchestrator.waitForClipReady(this._currentTimeUs, {\n        minFrameCount: 30,\n        timeoutMs: 3_000,\n      });\n\n      if (!ready) {\n        console.warn('[PlaybackController] Buffering timeout, starting anyway');\n      }\n\n      this._state = 'playing';\n      this.startTime = performance.now() - this._currentTimeUs / 1000 / this.playbackRate;\n      await this.ensureAudioContext();\n      this.startAudioPlayback();\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    if (this._state !== 'playing') return;\n\n    this._state = 'paused';\n\n    if (this.rafId !== null) {\n      cancelAnimationFrame(this.rafId);\n      this.rafId = null;\n    }\n\n    this.stopAudioPlayback();\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.frameCount = 0; // Reset frame counter\n    this.lastFrameTime = 0; // Reset frame timing\n    this.fps = 0; // Reset FPS\n\n    // Clear canvas\n    this.ctx.clearRect(0, 0, this.canvas.width, this.canvas.height);\n\n    this.audioSession?.reset();\n    this.stopAudioPlayback();\n\n    this.eventBus.emit(MeframeEvent.PlaybackStop);\n  }\n\n  async seek(timeUs: TimeUs): Promise<void> {\n    const wasPlaying = this._state === 'playing';\n    const previousState = this._state;\n\n    if (wasPlaying) {\n      this.pause();\n    }\n\n    const clamped = this.clampTime(timeUs);\n    this._currentTimeUs = clamped;\n\n    this._state = 'seeking';\n    this.stopAudioPlayback();\n\n    try {\n      await this.orchestrator.ensureClipCache(clamped);\n\n      const ready = await this.orchestrator.waitForClipReady(clamped, {\n        minFrameCount: 10,\n        timeoutMs: 2_000,\n      });\n\n      if (!ready) {\n        console.warn('[PlaybackController] Seek buffering timeout');\n      }\n\n      await this.renderCurrentFrame(clamped);\n      this.eventBus.emit(MeframeEvent.PlaybackSeek, { timeUs: this._currentTimeUs });\n    } catch (error) {\n      console.error('[PlaybackController] Seek error:', error);\n      this.eventBus.emit(MeframeEvent.PlaybackError, error as Error);\n    } finally {\n      if (wasPlaying) {\n        this._state = 'playing';\n        this.startTime = performance.now() - this._currentTimeUs / 1000 / this.playbackRate;\n        await this.ensureAudioContext();\n        this.startAudioPlayback();\n        if (!this.rafId) {\n          this.playbackLoop();\n        }\n      } else {\n        this._state = previousState === 'idle' ? 'idle' : 'paused';\n      }\n    }\n  }\n\n  // Playback properties\n  setRate(rate: number): void {\n    // Adjust start time to maintain current position\n    const elapsed = performance.now() - this.startTime;\n    this.playbackRate = rate;\n    this.startTime = performance.now() - elapsed / rate;\n\n    this.eventBus.emit(MeframeEvent.PlaybackRateChange, { rate });\n\n    if (this.audioSource) {\n      this.audioSource.playbackRate.value = this.playbackRate;\n    }\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    if (this.audioGainNode) {\n      this.audioGainNode.gain.value = this.volume;\n    }\n  }\n\n  setMute(muted: boolean): void {\n    if (muted) {\n      this.stopAudioPlayback();\n    } else if (this._state === 'playing') {\n      this.startAudioPlayback();\n    }\n  }\n\n  setLoop(loop: boolean): void {\n    this.loop = loop;\n  }\n\n  // State properties\n  get currentTime(): TimeUs {\n    if (this._state === 'playing') {\n      const elapsed = (performance.now() - this.startTime) * this.playbackRate;\n      this._currentTimeUs = Math.min(elapsed * 1000, this.duration);\n    }\n    return this._currentTimeUs;\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 state(): PlaybackState {\n    return this._state;\n  }\n\n  get playing(): boolean {\n    return this._state === 'playing';\n  }\n\n  setAudioSession(session: GlobalAudioSession): void {\n    this.audioSession = session;\n  }\n\n  // Resume is just an alias for play\n  resume(): void {\n    this.play();\n  }\n\n  // Private methods\n  private playbackLoop(): void {\n    // Only continue loop if actively playing (not buffering/paused/etc)\n    if (this._state !== 'playing') {\n      if (this.rafId !== null) {\n        cancelAnimationFrame(this.rafId);\n        this.rafId = null;\n      }\n      return;\n    }\n\n    const frameStartTime = performance.now();\n\n    this.rafId = requestAnimationFrame(async () => {\n      // Check state again after async boundary\n      if (this._state !== 'playing') {\n        return;\n      }\n\n      this.updateTime();\n\n      await this.renderCurrentFrame();\n\n      // Check if still playing after render (might have entered buffering)\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      // Emit frame rendered event for plugins\n      const primaryClip = this.orchestrator.compositionModel?.primaryClip;\n      if (primaryClip) {\n        this.eventBus.emit(MeframeEvent.ComposeFrameReady, {\n          timeUs: this._currentTimeUs,\n          frameNumber: this.frameCount,\n          renderTimeMs: now - frameStartTime,\n          trackId: primaryClip.trackId || 'main',\n          clipId: primaryClip.id,\n        });\n      }\n\n      this.playbackLoop();\n    });\n  }\n\n  private updateTime(): void {\n    const elapsed = (performance.now() - this.startTime) * this.playbackRate;\n    const rawTimeUs = elapsed * 1000;\n    const fps = this.orchestrator.compositionModel?.fps;\n    this._currentTimeUs = quantizeTimestampToFrame(rawTimeUs, 0, fps, 'nearest');\n\n    // Check if reached end\n    if (this._currentTimeUs >= this.duration) {\n      if (this.loop) {\n        this._currentTimeUs = 0;\n        this.startTime = performance.now();\n      } else {\n        this._currentTimeUs = this.duration;\n        this.pause();\n        this._state = 'ended';\n        this.eventBus.emit(MeframeEvent.PlaybackEnded, { timeUs: this._currentTimeUs });\n      }\n    }\n\n    // Emit time update\n    this.eventBus.emit(MeframeEvent.PlaybackTimeUpdate, { timeUs: this._currentTimeUs });\n  }\n\n  private async renderCurrentFrame(timeUs?: TimeUs): Promise<void> {\n    try {\n      const targetTime = timeUs ?? this._currentTimeUs;\n      const rcFrame = await this.orchestrator.renderFrame(targetTime);\n\n      if (!rcFrame) {\n        // Cache miss during playback - trigger buffering\n        if (this._state === 'playing') {\n          await this.handlePlaybackBuffering(targetTime);\n        }\n        return;\n      }\n\n      await rcFrame.use((frame) => {\n        // Ensure high quality rendering for every frame\n        this.ctx.imageSmoothingEnabled = true;\n        this.ctx.imageSmoothingQuality = 'high';\n        this.ctx.drawImage(frame, 0, 0, this.canvas.width, this.canvas.height);\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 duplicate buffering requests\n    if (this.isBuffering) {\n      return;\n    }\n\n    // Pause the playback loop\n    const wasPlaying = this._state === 'playing';\n    if (!wasPlaying) return;\n\n    this.isBuffering = true;\n    this._state = 'buffering';\n    this.eventBus.emit(MeframeEvent.PlaybackBuffering);\n\n    console.log(`[PlaybackController] Buffering at ${timeUs}µs (clip transition)`);\n\n    try {\n      // Ensure clip cache for current time\n      await this.orchestrator.ensureClipCache(timeUs);\n\n      // Wait for minimum frames (smaller buffer for clip transitions)\n      const ready = await this.orchestrator.waitForClipReady(timeUs, {\n        minFrameCount: 15, // 0.5s @30fps - faster resume\n        timeoutMs: 2_000,\n      });\n\n      if (!ready) {\n        console.warn('[PlaybackController] Buffering timeout during playback');\n      }\n\n      // Resume playback\n      this._state = 'playing';\n      this.startTime = performance.now() - timeUs / 1000 / this.playbackRate;\n      this.eventBus.emit(MeframeEvent.PlaybackPlay);\n\n      // Restart playback loop\n      if (!this.rafId) {\n        this.playbackLoop();\n      }\n    } catch (error) {\n      console.error('[PlaybackController] Buffering error:', error);\n      this._state = 'paused';\n      this.eventBus.emit(MeframeEvent.PlaybackError, error as Error);\n    } finally {\n      this.isBuffering = false;\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  }\n\n  private async ensureAudioContext(): Promise<void> {\n    if (this.audioContext) {\n      return;\n    }\n\n    this.audioContext = new AudioContext();\n    this.audioGainNode = this.audioContext.createGain();\n    this.audioGainNode.gain.value = this.volume;\n    this.audioGainNode.connect(this.audioContext.destination);\n  }\n\n  private startAudioPlayback(): void {\n    if (!this.audioContext || !this.audioSession || !this.audioGainNode) {\n      return;\n    }\n\n    this.stopAudioPlayback();\n\n    const startUs = this._currentTimeUs;\n\n    this.audioSession\n      .ensureMixedPCM(startUs)\n      .then((audioBuffer) => {\n        if (!audioBuffer || !this.audioContext || !this.audioGainNode) {\n          return;\n        }\n\n        const source = this.audioContext.createBufferSource();\n        source.buffer = audioBuffer;\n        source.playbackRate.value = this.playbackRate;\n        source.onended = () => {\n          this.audioSource = null;\n          if (this._state === 'playing') {\n            this.startAudioPlayback();\n          }\n        };\n\n        source.connect(this.audioGainNode);\n        source.start();\n        this.audioSource = source;\n      })\n      .catch((error) => {\n        console.error('[PlaybackController] Audio playback error:', error);\n      });\n  }\n\n  private stopAudioPlayback(): void {\n    if (this.audioSource) {\n      try {\n        this.audioSource.stop();\n      } catch (error) {\n        console.warn('[PlaybackController] stop audio failed', error);\n      }\n      this.audioSource.disconnect();\n      this.audioSource = null;\n    }\n  }\n}\n"],"names":[],"mappings":"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"}

package/dist/controllers/PreRenderService.d.ts

@@ -0,0 +1,34 @@
+import { IPreRenderService, RenderStrategy, PreRenderStatus, IOrchestratorForControl } from './types';
+import { TimeUs } from '../model/types';
+
+/**
+ * Simplified background pre-render service for 3-Clip strategy
+ *
+ * In the 3-Clip strategy, ClipFetchQueue already handles Prev/Current/Next caching.
+ * This service is kept minimal for compatibility but does minimal work.
+ */
+export declare class PreRenderService implements IPreRenderService {
+    private orchestrator;
+    private _isRunning;
+    private renderLoopId;
+    private _framesRendered;
+    private _currentTimeUs;
+    private strategy;
+    constructor(orchestrator: IOrchestratorForControl, _eventBus: any);
+    start(): void;
+    stop(): void;
+    pause(): void;
+    resume(): void;
+    setWindow(size: TimeUs): void;
+    setStrategy(strategy: Partial<RenderStrategy>): void;
+    setPriority(_priority: 'low' | 'normal' | 'high'): void;
+    clearQueue(): void;
+    queueRange(_startUs: TimeUs, _endUs: TimeUs, _priority?: number): void;
+    updatePlaybackTime(timeUs: TimeUs): void;
+    get isRunning(): boolean;
+    get queueSize(): number;
+    get status(): PreRenderStatus;
+    private scheduleNextRender;
+    private renderTick;
+}
+//# sourceMappingURL=PreRenderService.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"PreRenderService.d.ts","sourceRoot":"","sources":["../../src/controllers/PreRenderService.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,iBAAiB,EACjB,cAAc,EACd,eAAe,EACf,uBAAuB,EACxB,MAAM,SAAS,CAAC;AACjB,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAE7C;;;;;GAKG;AACH,qBAAa,gBAAiB,YAAW,iBAAiB;IACxD,OAAO,CAAC,YAAY,CAA0B;IAC9C,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,YAAY,CAAuB;IAC3C,OAAO,CAAC,eAAe,CAAK;IAC5B,OAAO,CAAC,cAAc,CAAa;IACnC,OAAO,CAAC,QAAQ,CAKd;gBAEU,YAAY,EAAE,uBAAuB,EAAE,SAAS,EAAE,GAAG;IAIjE,KAAK,IAAI,IAAI;IAMb,IAAI,IAAI,IAAI;IASZ,KAAK,IAAI,IAAI;IAIb,MAAM,IAAI,IAAI;IAId,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAI7B,WAAW,CAAC,QAAQ,EAAE,OAAO,CAAC,cAAc,CAAC,GAAG,IAAI;IAIpD,WAAW,CAAC,SAAS,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,IAAI;IAIvD,UAAU,IAAI,IAAI;IAIlB,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI;IAItE,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAIxC,IAAI,SAAS,IAAI,OAAO,CAEvB;IAED,IAAI,SAAS,IAAI,MAAM,CAEtB;IAED,IAAI,MAAM,IAAI,eAAe,CAO5B;IAED,OAAO,CAAC,kBAAkB;YAYZ,UAAU;CASzB"}

package/dist/controllers/PreRenderService.js

@@ -0,0 +1,83 @@
+class PreRenderService {
+  orchestrator;
+  _isRunning = false;
+  renderLoopId = null;
+  _framesRendered = 0;
+  _currentTimeUs = 0;
+  strategy = {
+    direction: "forward",
+    lookahead: 3e6,
+    lookbehind: 2e6,
+    keyframesOnly: false
+  };
+  constructor(orchestrator, _eventBus) {
+    this.orchestrator = orchestrator;
+  }
+  start() {
+    if (this._isRunning) return;
+    this._isRunning = true;
+    this.scheduleNextRender();
+  }
+  stop() {
+    this._isRunning = false;
+    if (this.renderLoopId !== null) {
+      cancelIdleCallback(this.renderLoopId);
+      this.renderLoopId = null;
+    }
+  }
+  pause() {
+    this.stop();
+  }
+  resume() {
+    this.start();
+  }
+  setWindow(size) {
+    this.strategy.lookahead = size;
+  }
+  setStrategy(strategy) {
+    this.strategy = { ...this.strategy, ...strategy };
+  }
+  setPriority(_priority) {
+  }
+  clearQueue() {
+  }
+  queueRange(_startUs, _endUs, _priority) {
+  }
+  updatePlaybackTime(timeUs) {
+    this._currentTimeUs = timeUs;
+  }
+  get isRunning() {
+    return this._isRunning;
+  }
+  get queueSize() {
+    return 0;
+  }
+  get status() {
+    return {
+      isRunning: this._isRunning,
+      framesRendered: this._framesRendered,
+      queueSize: 0,
+      currentTimeUs: this._currentTimeUs
+    };
+  }
+  scheduleNextRender() {
+    if (!this._isRunning) return;
+    this.renderLoopId = requestIdleCallback(
+      async () => {
+        await this.renderTick();
+        this.scheduleNextRender();
+      },
+      { timeout: 100 }
+    );
+  }
+  async renderTick() {
+    if (!this._isRunning || !this.orchestrator.compositionModel) {
+      return;
+    }
+    await this.orchestrator.ensureClipCache(this._currentTimeUs);
+  }
+}
+export {
+  PreRenderService
+};
+//# sourceMappingURL=PreRenderService.js.map

package/dist/controllers/PreRenderService.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PreRenderService.js","sources":["../../src/controllers/PreRenderService.ts"],"sourcesContent":["import type {\n  IPreRenderService,\n  RenderStrategy,\n  PreRenderStatus,\n  IOrchestratorForControl,\n} from './types';\nimport type { TimeUs } from '../model/types';\n\n/**\n * Simplified background pre-render service for 3-Clip strategy\n *\n * In the 3-Clip strategy, ClipFetchQueue already handles Prev/Current/Next caching.\n * This service is kept minimal for compatibility but does minimal work.\n */\nexport class PreRenderService implements IPreRenderService {\n  private orchestrator: IOrchestratorForControl;\n  private _isRunning = false;\n  private renderLoopId: number | null = null;\n  private _framesRendered = 0;\n  private _currentTimeUs: TimeUs = 0;\n  private strategy: RenderStrategy = {\n    direction: 'forward',\n    lookahead: 3_000_000,\n    lookbehind: 2_000_000,\n    keyframesOnly: false,\n  };\n\n  constructor(orchestrator: IOrchestratorForControl, _eventBus: any) {\n    this.orchestrator = orchestrator;\n  }\n\n  start(): void {\n    if (this._isRunning) return;\n    this._isRunning = true;\n    this.scheduleNextRender();\n  }\n\n  stop(): void {\n    this._isRunning = false;\n\n    if (this.renderLoopId !== null) {\n      cancelIdleCallback(this.renderLoopId);\n      this.renderLoopId = null;\n    }\n  }\n\n  pause(): void {\n    this.stop();\n  }\n\n  resume(): void {\n    this.start();\n  }\n\n  setWindow(size: TimeUs): void {\n    this.strategy.lookahead = size;\n  }\n\n  setStrategy(strategy: Partial<RenderStrategy>): void {\n    this.strategy = { ...this.strategy, ...strategy };\n  }\n\n  setPriority(_priority: 'low' | 'normal' | 'high'): void {\n    // Simplified - no-op for 3-Clip strategy\n  }\n\n  clearQueue(): void {\n    // Simplified - no-op for 3-Clip strategy\n  }\n\n  queueRange(_startUs: TimeUs, _endUs: TimeUs, _priority?: number): void {\n    // Simplified - no-op for 3-Clip strategy\n  }\n\n  updatePlaybackTime(timeUs: TimeUs): void {\n    this._currentTimeUs = timeUs;\n  }\n\n  get isRunning(): boolean {\n    return this._isRunning;\n  }\n\n  get queueSize(): number {\n    return 0;\n  }\n\n  get status(): PreRenderStatus {\n    return {\n      isRunning: this._isRunning,\n      framesRendered: this._framesRendered,\n      queueSize: 0,\n      currentTimeUs: this._currentTimeUs,\n    };\n  }\n\n  private scheduleNextRender(): void {\n    if (!this._isRunning) return;\n\n    this.renderLoopId = requestIdleCallback(\n      async () => {\n        await this.renderTick();\n        this.scheduleNextRender();\n      },\n      { timeout: 100 }\n    );\n  }\n\n  private async renderTick(): Promise<void> {\n    if (!this._isRunning || !this.orchestrator.compositionModel) {\n      return;\n    }\n\n    // In 3-Clip strategy, just ensure clips are cached\n    // ClipFetchQueue handles the actual fetching\n    await this.orchestrator.ensureClipCache(this._currentTimeUs);\n  }\n}\n"],"names":[],"mappings":"AAcO,MAAM,iBAA8C;AAAA,EACjD;AAAA,EACA,aAAa;AAAA,EACb,eAA8B;AAAA,EAC9B,kBAAkB;AAAA,EAClB,iBAAyB;AAAA,EACzB,WAA2B;AAAA,IACjC,WAAW;AAAA,IACX,WAAW;AAAA,IACX,YAAY;AAAA,IACZ,eAAe;AAAA,EAAA;AAAA,EAGjB,YAAY,cAAuC,WAAgB;AACjE,SAAK,eAAe;AAAA,EACtB;AAAA,EAEA,QAAc;AACZ,QAAI,KAAK,WAAY;AACrB,SAAK,aAAa;AAClB,SAAK,mBAAA;AAAA,EACP;AAAA,EAEA,OAAa;AACX,SAAK,aAAa;AAElB,QAAI,KAAK,iBAAiB,MAAM;AAC9B,yBAAmB,KAAK,YAAY;AACpC,WAAK,eAAe;AAAA,IACtB;AAAA,EACF;AAAA,EAEA,QAAc;AACZ,SAAK,KAAA;AAAA,EACP;AAAA,EAEA,SAAe;AACb,SAAK,MAAA;AAAA,EACP;AAAA,EAEA,UAAU,MAAoB;AAC5B,SAAK,SAAS,YAAY;AAAA,EAC5B;AAAA,EAEA,YAAY,UAAyC;AACnD,SAAK,WAAW,EAAE,GAAG,KAAK,UAAU,GAAG,SAAA;AAAA,EACzC;AAAA,EAEA,YAAY,WAA4C;AAAA,EAExD;AAAA,EAEA,aAAmB;AAAA,EAEnB;AAAA,EAEA,WAAW,UAAkB,QAAgB,WAA0B;AAAA,EAEvE;AAAA,EAEA,mBAAmB,QAAsB;AACvC,SAAK,iBAAiB;AAAA,EACxB;AAAA,EAEA,IAAI,YAAqB;AACvB,WAAO,KAAK;AAAA,EACd;AAAA,EAEA,IAAI,YAAoB;AACtB,WAAO;AAAA,EACT;AAAA,EAEA,IAAI,SAA0B;AAC5B,WAAO;AAAA,MACL,WAAW,KAAK;AAAA,MAChB,gBAAgB,KAAK;AAAA,MACrB,WAAW;AAAA,MACX,eAAe,KAAK;AAAA,IAAA;AAAA,EAExB;AAAA,EAEQ,qBAA2B;AACjC,QAAI,CAAC,KAAK,WAAY;AAEtB,SAAK,eAAe;AAAA,MAClB,YAAY;AACV,cAAM,KAAK,WAAA;AACX,aAAK,mBAAA;AAAA,MACP;AAAA,MACA,EAAE,SAAS,IAAA;AAAA,IAAI;AAAA,EAEnB;AAAA,EAEA,MAAc,aAA4B;AACxC,QAAI,CAAC,KAAK,cAAc,CAAC,KAAK,aAAa,kBAAkB;AAC3D;AAAA,IACF;AAIA,UAAM,KAAK,aAAa,gBAAgB,KAAK,cAAc;AAAA,EAC7D;AACF;"}

package/dist/controllers/PreRenderTaskQueue.d.ts

@@ -0,0 +1,21 @@
+import { RenderTask } from './types';
+
+/**
+ * Priority queue for pre-render tasks
+ */
+export declare class PreRenderTaskQueue {
+    private queue;
+    private taskMap;
+    enqueue(task: RenderTask): void;
+    dequeue(): RenderTask | null;
+    peek(): RenderTask | null;
+    isEmpty(): boolean;
+    size(): number;
+    clear(): void;
+    remove(timeUs: number, clipId: string): boolean;
+    removeRange(startUs: number, endUs: number, clipId?: string): number;
+    getAll(): RenderTask[];
+    private sortQueue;
+    private getTaskKey;
+}
+//# sourceMappingURL=PreRenderTaskQueue.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"PreRenderTaskQueue.d.ts","sourceRoot":"","sources":["../../src/controllers/PreRenderTaskQueue.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAE1C;;GAEG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,KAAK,CAAoB;IACjC,OAAO,CAAC,OAAO,CAAiC;IAEhD,OAAO,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI;IAiB/B,OAAO,IAAI,UAAU,GAAG,IAAI;IAS5B,IAAI,IAAI,UAAU,GAAG,IAAI;IAIzB,OAAO,IAAI,OAAO;IAIlB,IAAI,IAAI,MAAM;IAId,KAAK,IAAI,IAAI;IAKb,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO;IAiB/C,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM;IAoBpE,MAAM,IAAI,UAAU,EAAE;IAItB,OAAO,CAAC,SAAS;IAIjB,OAAO,CAAC,UAAU;CAGnB"}

package/dist/controllers/PreviewHandle.d.ts

@@ -0,0 +1,23 @@
+import { PreviewHandle, TimeUs } from './types';
+import { PlaybackController } from './PlaybackController';
+import { EventBus } from '../event/EventBus';
+import { EventPayloadMap } from '../event/events';
+
+/**
+ * PreviewHandle implementation for playback control
+ */
+export declare class PreviewHandleImpl implements PreviewHandle {
+    private controller;
+    private eventBus;
+    constructor(controller: PlaybackController, eventBus: EventBus<EventPayloadMap>);
+    play(): void;
+    seek(timeUs: TimeUs): void;
+    setRate(rate: number): void;
+    pause(): void;
+    resume(): void;
+    stop(): void;
+    get currentTimeUs(): TimeUs;
+    on(event: string, handler: Function): void;
+    off(event: string, handler: Function): void;
+}
+//# sourceMappingURL=PreviewHandle.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"PreviewHandle.d.ts","sourceRoot":"","sources":["../../src/controllers/PreviewHandle.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACrD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC/D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAEvD;;GAEG;AACH,qBAAa,iBAAkB,YAAW,aAAa;IACrD,OAAO,CAAC,UAAU,CAAqB;IACvC,OAAO,CAAC,QAAQ,CAA4B;gBAEhC,UAAU,EAAE,kBAAkB,EAAE,QAAQ,EAAE,QAAQ,CAAC,eAAe,CAAC;IAK/E,IAAI,IAAI,IAAI;IAIZ,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAI1B,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAI3B,KAAK,IAAI,IAAI;IAIb,MAAM,IAAI,IAAI;IAId,IAAI,IAAI,IAAI;IAIZ,IAAI,aAAa,IAAI,MAAM,CAE1B;IAED,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,GAAG,IAAI;IAI1C,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,GAAG,IAAI;CAG5C"}

package/dist/controllers/PreviewHandle.js

@@ -0,0 +1,39 @@
+class PreviewHandleImpl {
+  controller;
+  eventBus;
+  constructor(controller, eventBus) {
+    this.controller = controller;
+    this.eventBus = eventBus;
+  }
+  play() {
+    this.controller.play();
+  }
+  seek(timeUs) {
+    this.controller.seek(timeUs);
+  }
+  setRate(rate) {
+    this.controller.setRate(rate);
+  }
+  pause() {
+    this.controller.pause();
+  }
+  resume() {
+    this.controller.resume();
+  }
+  stop() {
+    this.controller.stop();
+  }
+  get currentTimeUs() {
+    return this.controller.currentTime;
+  }
+  on(event, handler) {
+    this.eventBus.on(event, handler);
+  }
+  off(event, handler) {
+    this.eventBus.off(event, handler);
+  }
+}
+export {
+  PreviewHandleImpl
+};
+//# sourceMappingURL=PreviewHandle.js.map

package/dist/controllers/PreviewHandle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PreviewHandle.js","sources":["../../src/controllers/PreviewHandle.ts"],"sourcesContent":["/**\n * PreviewHandle: Implementation of preview playback control handle\n */\n\nimport type { PreviewHandle, TimeUs } from './types';\nimport type { PlaybackController } from './PlaybackController';\nimport type { EventBus } from '../event/EventBus';\nimport type { EventPayloadMap } from '../event/events';\n\n/**\n * PreviewHandle implementation for playback control\n */\nexport class PreviewHandleImpl implements PreviewHandle {\n  private controller: PlaybackController;\n  private eventBus: EventBus<EventPayloadMap>;\n\n  constructor(controller: PlaybackController, eventBus: EventBus<EventPayloadMap>) {\n    this.controller = controller;\n    this.eventBus = eventBus;\n  }\n\n  play(): void {\n    this.controller.play();\n  }\n\n  seek(timeUs: TimeUs): void {\n    this.controller.seek(timeUs);\n  }\n\n  setRate(rate: number): void {\n    this.controller.setRate(rate);\n  }\n\n  pause(): void {\n    this.controller.pause();\n  }\n\n  resume(): void {\n    this.controller.resume();\n  }\n\n  stop(): void {\n    this.controller.stop();\n  }\n\n  get currentTimeUs(): TimeUs {\n    return this.controller.currentTime;\n  }\n\n  on(event: string, handler: Function): void {\n    this.eventBus.on(event as any, handler as any);\n  }\n\n  off(event: string, handler: Function): void {\n    this.eventBus.off(event as any, handler as any);\n  }\n}\n"],"names":[],"mappings":"AAYO,MAAM,kBAA2C;AAAA,EAC9C;AAAA,EACA;AAAA,EAER,YAAY,YAAgC,UAAqC;AAC/E,SAAK,aAAa;AAClB,SAAK,WAAW;AAAA,EAClB;AAAA,EAEA,OAAa;AACX,SAAK,WAAW,KAAA;AAAA,EAClB;AAAA,EAEA,KAAK,QAAsB;AACzB,SAAK,WAAW,KAAK,MAAM;AAAA,EAC7B;AAAA,EAEA,QAAQ,MAAoB;AAC1B,SAAK,WAAW,QAAQ,IAAI;AAAA,EAC9B;AAAA,EAEA,QAAc;AACZ,SAAK,WAAW,MAAA;AAAA,EAClB;AAAA,EAEA,SAAe;AACb,SAAK,WAAW,OAAA;AAAA,EAClB;AAAA,EAEA,OAAa;AACX,SAAK,WAAW,KAAA;AAAA,EAClB;AAAA,EAEA,IAAI,gBAAwB;AAC1B,WAAO,KAAK,WAAW;AAAA,EACzB;AAAA,EAEA,GAAG,OAAe,SAAyB;AACzC,SAAK,SAAS,GAAG,OAAc,OAAc;AAAA,EAC/C;AAAA,EAEA,IAAI,OAAe,SAAyB;AAC1C,SAAK,SAAS,IAAI,OAAc,OAAc;AAAA,EAChD;AACF;"}

package/dist/controllers/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Controllers module exports
+ */
+export { PlaybackController } from './PlaybackController';
+export { PreRenderService } from './PreRenderService';
+export { PreRenderTaskQueue } from './PreRenderTaskQueue';
+export type { IPreRenderService, RenderStrategy, PreRenderStatus, RenderTask, IPlaybackController, PlaybackState, PlaybackEvent, PlaybackOptions, PreviewHandle, TimeRange, PrioritizedClip, IOrchestratorForControl, IEventBus, FrameStats, } from './types';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/controllers/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAE1D,YAAY,EAEV,iBAAiB,EACjB,cAAc,EACd,eAAe,EACf,UAAU,EAGV,mBAAmB,EACnB,aAAa,EACb,aAAa,EACb,eAAe,EACf,aAAa,EAGb,SAAS,EACT,eAAe,EAGf,uBAAuB,EAGvB,SAAS,EAGT,UAAU,GACX,MAAM,SAAS,CAAC"}