@editframe/elements 0.38.0 → 0.39.0

package/dist/gui/PlaybackController.js.map

@@ -1 +1 @@
-{"version":3,"file":"PlaybackController.js","names":["#FPS","#host","#playingProvider","#playing","#loopProvider","#loop","#currentTimeMsProvider","#durationMsProvider","#currentTime","#processingPendingSeek","#pendingSeekTime","#seekInProgress","#runSeek","#seekAbortController","#notifyListeners","#removed","#initializeTime","#selfRenderPromise","#selfRenderDirty","#startSelfRender","#selfRenderAbortController","#listeners","#pendingAudioContext","#playbackAudioContext","rawTimeMs: number","#playbackWrapTimeSeconds","#loopingPlayback","#MS_PER_FRAME","#updatePlaybackTime","#playbackAnimationFrameRequest","#syncPlayheadToAudioContext","#AUDIO_PLAYBACK_SLICE_MS"],"sources":["../../src/gui/PlaybackController.ts"],"sourcesContent":["import { ContextProvider } from \"@lit/context\";\nimport type { ReactiveController, ReactiveControllerHost } from \"lit\";\nimport { currentTimeContext } from \"./currentTimeContext.js\";\nimport { durationContext } from \"./durationContext.js\";\nimport { loopContext, playingContext } from \"./playingContext.js\";\nimport {\n  updateAnimations,\n  type AnimatableElement,\n} from \"../elements/updateAnimations.js\";\nimport type {\n  RenderFrameOptions,\n  FrameRenderable,\n} from \"../preview/FrameController.js\";\n\ninterface PlaybackHost extends HTMLElement, ReactiveControllerHost {\n  currentTimeMs: number;\n  durationMs: number;\n  endTimeMs: number;\n  /** Centralized frame controller (present on EFTimegroup) */\n  frameController?: {\n    renderFrame(timeMs: number, options?: RenderFrameOptions): Promise<void>;\n    abort(): void;\n  };\n  renderAudio?(fromMs: number, toMs: number): Promise<AudioBuffer>;\n  waitForMediaDurations?(signal?: AbortSignal): Promise<void>;\n  saveTimeToLocalStorage?(time: number): void;\n  loadTimeFromLocalStorage?(): number | undefined;\n  requestUpdate(property?: string): void;\n  updateComplete: Promise<boolean>;\n  playing: boolean;\n  loop: boolean;\n  play(): void;\n  pause(): void;\n  playbackController?: PlaybackController;\n  parentTimegroup?: any;\n  rootTimegroup?: any;\n}\n\nexport type PlaybackControllerUpdateEvent = {\n  property: \"playing\" | \"loop\" | \"currentTimeMs\";\n  value: boolean | number;\n};\n\n/**\n * Manages playback state and audio-driven timing for root temporal elements\n *\n * Created automatically when a temporal element becomes a root (no parent timegroup)\n * Provides playback contexts (playing, loop, currentTimeMs, durationMs) to descendants\n * Handles:\n * - Audio-driven playback with Web Audio API\n * - Seek and frame rendering throttling\n * - Time state management with pending seek handling\n * - Playback loop behavior\n *\n * Works with any temporal element (timegroups or standalone media) via PlaybackHost interface\n */\nexport class PlaybackController implements ReactiveController {\n  #host: PlaybackHost;\n  #playing = false;\n  #loop = false;\n  #listeners = new Set<(event: PlaybackControllerUpdateEvent) => void>();\n  #playingProvider: ContextProvider<typeof playingContext>;\n  #loopProvider: ContextProvider<typeof loopContext>;\n  #currentTimeMsProvider: ContextProvider<typeof currentTimeContext>;\n  #durationMsProvider: ContextProvider<typeof durationContext>;\n\n  #FPS = 30;\n  #MS_PER_FRAME = 1000 / this.#FPS;\n  #playbackAudioContext: AudioContext | null = null;\n  #playbackAnimationFrameRequest: number | null = null;\n  #pendingAudioContext: AudioContext | null = null;\n  #AUDIO_PLAYBACK_SLICE_MS = ((47 * 1024) / 48000) * 1000;\n\n  #currentTime: number | undefined = undefined;\n  #seekInProgress = false;\n  #pendingSeekTime: number | undefined;\n  #processingPendingSeek = false;\n  #loopingPlayback = false; // Track if we're in a looping playback session\n  #playbackWrapTimeSeconds = 0; // The AudioContext time when we wrapped\n\n  #seekAbortController: AbortController | null = null;\n\n  constructor(host: PlaybackHost) {\n    this.#host = host;\n    host.addController(this);\n\n    this.#playingProvider = new ContextProvider(host, {\n      context: playingContext,\n      initialValue: this.#playing,\n    });\n    this.#loopProvider = new ContextProvider(host, {\n      context: loopContext,\n      initialValue: this.#loop,\n    });\n    this.#currentTimeMsProvider = new ContextProvider(host, {\n      context: currentTimeContext,\n      initialValue: host.currentTimeMs,\n    });\n    this.#durationMsProvider = new ContextProvider(host, {\n      context: durationContext,\n      initialValue: host.durationMs,\n    });\n  }\n\n  get currentTime(): number {\n    const rawTime = this.#currentTime ?? 0;\n    // Quantize to frame boundaries based on host's fps\n    const fps = (this.#host as any).fps ?? 30;\n    if (!fps || fps <= 0) return rawTime;\n    const frameDurationS = 1 / fps;\n    const quantizedTime = Math.round(rawTime / frameDurationS) * frameDurationS;\n    // Clamp to valid range after quantization to prevent exceeding duration\n    const durationS = this.#host.durationMs / 1000;\n    return Math.max(0, Math.min(quantizedTime, durationS));\n  }\n\n  set currentTime(time: number) {\n    time = Math.max(0, Math.min(this.#host.durationMs / 1000, time));\n    if (Number.isNaN(time)) {\n      return;\n    }\n    if (time === this.#currentTime && !this.#processingPendingSeek) {\n      return;\n    }\n    if (this.#pendingSeekTime === time) {\n      return;\n    }\n\n    if (this.#seekInProgress) {\n      this.#pendingSeekTime = time;\n      this.#currentTime = time;\n      return;\n    }\n\n    this.#currentTime = time;\n    this.#seekInProgress = true;\n\n    this.#runSeek(time).finally(async () => {\n      // CRITICAL: Coordinate animations after seek completes\n      // This ensures animations are positioned correctly, not playing naturally\n      const { updateAnimations } =\n        await import(\"../elements/updateAnimations.js\");\n      updateAnimations(this.#host as any);\n\n      if (\n        this.#pendingSeekTime !== undefined &&\n        this.#pendingSeekTime !== time\n      ) {\n        const pendingTime = this.#pendingSeekTime;\n        this.#pendingSeekTime = undefined;\n        this.#processingPendingSeek = true;\n        try {\n          this.currentTime = pendingTime;\n        } finally {\n          this.#processingPendingSeek = false;\n        }\n      } else {\n        this.#pendingSeekTime = undefined;\n      }\n    });\n  }\n\n  async #runSeek(targetTime: number): Promise<number | undefined> {\n    // Abort any in-flight seek\n    this.#seekAbortController?.abort();\n    this.#seekAbortController = new AbortController();\n    const signal = this.#seekAbortController.signal;\n\n    try {\n      signal.throwIfAborted();\n\n      await this.#host.waitForMediaDurations?.(signal);\n      signal.throwIfAborted();\n\n      const newTime = Math.max(\n        0,\n        Math.min(targetTime, this.#host.durationMs / 1000),\n      );\n      this.#currentTime = newTime;\n      this.#host.requestUpdate(\"currentTime\");\n      this.#currentTimeMsProvider.setValue(this.currentTimeMs);\n      this.#notifyListeners({\n        property: \"currentTimeMs\",\n        value: this.currentTimeMs,\n      });\n\n      signal.throwIfAborted();\n\n      await this.runThrottledFrameTask();\n      signal.throwIfAborted();\n\n      // Save to localStorage for persistence (only if not restoring to avoid loops)\n      const isRestoring =\n        (this.#host as any).isRestoringFromLocalStorage?.() ?? false;\n      if (!isRestoring) {\n        this.#host.saveTimeToLocalStorage?.(newTime);\n      } else {\n        (this.#host as any).setRestoringFromLocalStorage?.(false);\n      }\n      this.#seekInProgress = false;\n      return newTime;\n    } catch (error) {\n      if (error instanceof DOMException && error.name === \"AbortError\") {\n        // Expected - don't log\n        return undefined;\n      }\n      throw error;\n    }\n  }\n\n  get playing(): boolean {\n    return this.#playing;\n  }\n\n  setPlaying(value: boolean): void {\n    if (this.#playing === value) return;\n    this.#playing = value;\n    this.#playingProvider.setValue(value);\n    this.#host.requestUpdate(\"playing\");\n    this.#notifyListeners({ property: \"playing\", value });\n\n    if (value) {\n      this.startPlayback();\n    } else {\n      this.stopPlayback();\n    }\n  }\n\n  get loop(): boolean {\n    return this.#loop;\n  }\n\n  setLoop(value: boolean): void {\n    if (this.#loop === value) return;\n    this.#loop = value;\n    this.#loopProvider.setValue(value);\n    this.#host.requestUpdate(\"loop\");\n    this.#notifyListeners({ property: \"loop\", value });\n  }\n\n  get currentTimeMs(): number {\n    return this.currentTime * 1000;\n  }\n\n  setCurrentTimeMs(value: number): void {\n    this.currentTime = value / 1000;\n  }\n\n  // Update time during playback without triggering a seek\n  // Used by #syncPlayheadToAudioContext to avoid frame drops\n  #updatePlaybackTime(timeMs: number): void {\n    // Clamp to valid range to prevent time exceeding duration\n    const durationMs = this.#host.durationMs;\n    const clampedTimeMs = Math.max(0, Math.min(timeMs, durationMs));\n    const timeSec = clampedTimeMs / 1000;\n    if (this.#currentTime === timeSec) {\n      return;\n    }\n    this.#currentTime = timeSec;\n    this.#host.requestUpdate(\"currentTime\");\n    this.#currentTimeMsProvider.setValue(clampedTimeMs);\n    this.#notifyListeners({\n      property: \"currentTimeMs\",\n      value: clampedTimeMs,\n    });\n    // Trigger frame rendering without the async seek mechanism\n    this.runThrottledFrameTask();\n  }\n\n  play(): void {\n    this.setPlaying(true);\n  }\n\n  pause(): void {\n    this.setPlaying(false);\n  }\n\n  #removed = false;\n\n  hostConnected(): void {\n    // Defer all operations to avoid blocking during initialization\n    // This prevents deadlocks when many timegroups are initializing simultaneously\n    requestAnimationFrame(() => {\n      requestAnimationFrame(() => {\n        // Check if this controller was removed before the RAF callback executed.\n        // This happens when wrapWithWorkbench moves the element, causing disconnect/reconnect.\n        if (this.#removed || this.#host.playbackController !== this) {\n          return;\n        }\n\n        if (this.#playing) {\n          this.startPlayback();\n        } else {\n          this.#initializeTime();\n        }\n      });\n    });\n  }\n\n  async #initializeTime(): Promise<void> {\n    try {\n      const waitPromise = this.#host.waitForMediaDurations?.();\n      if (waitPromise) {\n        await waitPromise;\n      }\n    } catch (err) {\n      const isAbortError =\n        (err instanceof DOMException && err.name === \"AbortError\") ||\n        (err instanceof Error &&\n          (err.name === \"AbortError\" ||\n            err.message.includes(\"signal is aborted\") ||\n            err.message.includes(\"The user aborted a request\")));\n      if (!isAbortError) {\n        console.error(\"Error in PlaybackController hostConnected:\", err);\n      }\n      return;\n    }\n\n    if (this.#removed || this.#host.playbackController !== this) {\n      return;\n    }\n\n    const maybeLoadedTime = this.#host.loadTimeFromLocalStorage?.();\n    if (maybeLoadedTime !== undefined) {\n      (this.#host as any).setRestoringFromLocalStorage?.(true);\n      this.currentTime = maybeLoadedTime;\n    } else if (this.#currentTime === undefined) {\n      this.currentTime = 0;\n    }\n  }\n\n  hostDisconnected(): void {\n    this.pause();\n  }\n\n  hostUpdated(): void {\n    this.#durationMsProvider.setValue(this.#host.durationMs);\n    this.#currentTimeMsProvider.setValue(this.currentTimeMs);\n  }\n\n  #selfRenderAbortController?: AbortController;\n  #selfRenderPromise?: Promise<void>;\n  #selfRenderDirty = false;\n\n  /**\n   * Run frame rendering via FrameController, or directly on the host if it\n   * implements FrameRenderable (standalone media element without a Timegroup).\n   */\n  async runThrottledFrameTask(): Promise<void> {\n    const timeMs = this.currentTimeMs;\n\n    if (this.#host.frameController) {\n      try {\n        await this.#host.frameController.renderFrame(timeMs, {\n          onAnimationsUpdate: (root: Element) => {\n            updateAnimations(root as unknown as AnimatableElement);\n          },\n        });\n      } catch (error) {\n        if (error instanceof DOMException && error.name === \"AbortError\")\n          return;\n        console.error(\"FrameController error:\", error);\n      }\n      return;\n    }\n\n    // Standalone FrameRenderable host (e.g. bare ef-video without a Timegroup)\n    const host = this.#host as unknown as Partial<FrameRenderable>;\n    if (!host.prepareFrame || !host.renderFrame) return;\n\n    // If a render is in-flight, mark dirty so we re-render after it\n    // completes (source mapping may have changed due to trim drag).\n    if (this.#selfRenderPromise) {\n      this.#selfRenderDirty = true;\n      return this.#selfRenderPromise;\n    }\n\n    return this.#startSelfRender(host, timeMs);\n  }\n\n  #startSelfRender(\n    host: Partial<FrameRenderable>,\n    timeMs: number,\n  ): Promise<void> {\n    this.#selfRenderAbortController?.abort();\n    this.#selfRenderAbortController = new AbortController();\n    const signal = this.#selfRenderAbortController.signal;\n    this.#selfRenderDirty = false;\n\n    this.#selfRenderPromise = (async () => {\n      try {\n        await host.prepareFrame!(timeMs, signal);\n        signal.throwIfAborted();\n        host.renderFrame!(timeMs);\n        updateAnimations(this.#host as unknown as AnimatableElement);\n      } catch (error) {\n        if (error instanceof DOMException && error.name === \"AbortError\")\n          return;\n        if ((error as any)?.name === \"AbortError\") return;\n        console.error(\"Standalone frame render error:\", error);\n      } finally {\n        this.#selfRenderPromise = undefined;\n        // Re-render if source mapping changed while we were rendering\n        if (this.#selfRenderDirty) {\n          this.#startSelfRender(host, this.currentTimeMs);\n        }\n      }\n    })();\n\n    return this.#selfRenderPromise;\n  }\n\n  addListener(listener: (event: PlaybackControllerUpdateEvent) => void): void {\n    this.#listeners.add(listener);\n  }\n\n  removeListener(\n    listener: (event: PlaybackControllerUpdateEvent) => void,\n  ): void {\n    this.#listeners.delete(listener);\n  }\n\n  #notifyListeners(event: PlaybackControllerUpdateEvent): void {\n    for (const listener of this.#listeners) {\n      listener(event);\n    }\n  }\n\n  remove(): void {\n    this.#removed = true; // Mark as removed to abort any pending RAF callbacks\n    this.stopPlayback();\n    this.#listeners.clear();\n    this.#host.removeController(this);\n  }\n\n  setPendingAudioContext(context: AudioContext): void {\n    this.#pendingAudioContext = context;\n  }\n\n  #syncPlayheadToAudioContext(startMs: number) {\n    const audioContextTime = this.#playbackAudioContext?.currentTime ?? 0;\n    const endMs = this.#host.endTimeMs;\n\n    // Calculate raw time based on audio context\n    let rawTimeMs: number;\n    if (\n      this.#playbackWrapTimeSeconds > 0 &&\n      audioContextTime >= this.#playbackWrapTimeSeconds\n    ) {\n      // After wrap: time since wrap, wrapped to duration\n      const timeSinceWrap =\n        (audioContextTime - this.#playbackWrapTimeSeconds) * 1000;\n      rawTimeMs = timeSinceWrap % endMs;\n    } else {\n      // Before wrap or no wrap: normal calculation\n      rawTimeMs = startMs + audioContextTime * 1000;\n\n      // If looping and we've reached the end, wrap around\n      if (this.#loopingPlayback && rawTimeMs >= endMs) {\n        rawTimeMs = rawTimeMs % endMs;\n      }\n    }\n\n    const nextTimeMs =\n      Math.round(rawTimeMs / this.#MS_PER_FRAME) * this.#MS_PER_FRAME;\n\n    // During playback, update time directly without triggering seek\n    // This avoids frame drops at the loop boundary\n    this.#updatePlaybackTime(nextTimeMs);\n\n    // Only check for end if we haven't already handled looping\n    if (!this.#loopingPlayback && nextTimeMs >= endMs) {\n      this.maybeLoopPlayback();\n      return;\n    }\n\n    this.#playbackAnimationFrameRequest = requestAnimationFrame(() => {\n      this.#syncPlayheadToAudioContext(startMs);\n    });\n  }\n\n  private async maybeLoopPlayback() {\n    if (this.#loop) {\n      // Loop enabled: reset to beginning and restart playback\n      // We restart the audio system directly without changing #playing state\n      // to keep the play button in sync\n      this.setCurrentTimeMs(0);\n      // Restart in next frame without awaiting to minimize gap\n      requestAnimationFrame(() => {\n        this.startPlayback();\n      });\n    } else {\n      // No loop: reset to beginning and stop\n      // This ensures play button works when clicked again\n      this.setCurrentTimeMs(0);\n      this.pause();\n    }\n  }\n\n  private async stopPlayback() {\n    if (this.#playbackAudioContext) {\n      if (this.#playbackAudioContext.state !== \"closed\") {\n        await this.#playbackAudioContext.close();\n      }\n    }\n    if (this.#playbackAnimationFrameRequest) {\n      cancelAnimationFrame(this.#playbackAnimationFrameRequest);\n    }\n    this.#playbackAudioContext = null;\n    this.#playbackAnimationFrameRequest = null;\n    this.#pendingAudioContext = null;\n  }\n\n  private async startPlayback() {\n    // Guard against starting playback on a removed controller\n    if (this.#removed) {\n      return;\n    }\n\n    await this.stopPlayback();\n    const host = this.#host;\n    if (!host) {\n      return;\n    }\n\n    if (host.waitForMediaDurations) {\n      await host.waitForMediaDurations();\n    }\n\n    // Check again after async - controller could have been removed\n    if (this.#removed) {\n      return;\n    }\n\n    const currentMs = this.currentTimeMs;\n    const fromMs = currentMs;\n    const toMs = host.endTimeMs;\n\n    if (fromMs >= toMs) {\n      this.pause();\n      return;\n    }\n\n    let bufferCount = 0;\n    // Check for pre-resumed AudioContext from synchronous user interaction\n    if (this.#pendingAudioContext) {\n      this.#playbackAudioContext = this.#pendingAudioContext;\n      this.#pendingAudioContext = null;\n    } else {\n      this.#playbackAudioContext = new AudioContext({\n        latencyHint: \"playback\",\n      });\n    }\n    this.#loopingPlayback = this.#loop; // Remember if we're in a looping session\n    this.#playbackWrapTimeSeconds = 0; // Reset wrap time\n\n    if (this.#playbackAnimationFrameRequest) {\n      cancelAnimationFrame(this.#playbackAnimationFrameRequest);\n    }\n    this.#syncPlayheadToAudioContext(currentMs);\n    const playbackContext = this.#playbackAudioContext;\n\n    // Check if context is suspended (fallback for newly-created contexts)\n    if (playbackContext.state === \"suspended\") {\n      // Attempt to resume (may not work on mobile if user interaction context is lost)\n      try {\n        await playbackContext.resume();\n        // Check state again after resume attempt\n        if (playbackContext.state === \"suspended\") {\n          console.warn(\n            \"AudioContext is suspended and resume() failed. \" +\n              \"On mobile devices, AudioContext.resume() must be called synchronously within a user interaction handler. \" +\n              \"Media playback will not work until user has interacted with page.\",\n          );\n          this.setPlaying(false);\n          return;\n        }\n      } catch (error) {\n        console.warn(\n          \"Failed to resume AudioContext:\",\n          error,\n          \"On mobile devices, AudioContext.resume() must be called synchronously within a user interaction handler.\",\n        );\n        this.setPlaying(false);\n        return;\n      }\n    }\n    await playbackContext.suspend();\n\n    // Track the logical media time (what position in the media we're rendering)\n    // vs the AudioContext schedule time (when to play it)\n    let logicalTimeMs = currentMs;\n    let audioContextTimeMs = 0; // Tracks the schedule position in the AudioContext timeline\n    let hasWrapped = false;\n\n    const fillBuffer = async () => {\n      if (bufferCount > 2) {\n        return;\n      }\n      const canFillBuffer = await queueBufferSource();\n      if (canFillBuffer) {\n        fillBuffer().catch(() => {});\n      }\n    };\n\n    const queueBufferSource = async () => {\n      // Check if we've already wrapped and aren't looping anymore\n      if (hasWrapped && !this.#loopingPlayback) {\n        return false;\n      }\n\n      const startMs = logicalTimeMs;\n      const endMs = Math.min(\n        logicalTimeMs + this.#AUDIO_PLAYBACK_SLICE_MS,\n        toMs,\n      );\n\n      // Will this slice reach the end?\n      const willReachEnd = endMs >= toMs;\n\n      if (!host.renderAudio) {\n        return false;\n      }\n\n      const audioBuffer = await host.renderAudio(startMs, endMs);\n      bufferCount++;\n      const source = playbackContext.createBufferSource();\n      source.buffer = audioBuffer;\n      source.connect(playbackContext.destination);\n      // Schedule this buffer to play at the current audioContextTime position\n      source.start(audioContextTimeMs / 1000);\n\n      const sliceDurationMs = endMs - startMs;\n\n      source.onended = () => {\n        bufferCount--;\n\n        if (willReachEnd) {\n          if (!this.#loopingPlayback) {\n            // Not looping, end playback\n            this.maybeLoopPlayback();\n          } else {\n            // Looping: continue filling buffer after wrap\n            fillBuffer().catch(() => {});\n          }\n        } else {\n          // Continue filling buffer\n          fillBuffer().catch(() => {});\n        }\n      };\n\n      // Advance the AudioContext schedule time\n      audioContextTimeMs += sliceDurationMs;\n\n      // If this buffer reaches the end and we're looping, immediately queue the wraparound\n      if (willReachEnd && this.#loopingPlayback) {\n        // Mark that we've wrapped\n        hasWrapped = true;\n        // Store when we wrapped (relative to when playback started, which is time 0 in AudioContext)\n        // This is the duration from start to end\n        this.#playbackWrapTimeSeconds = (toMs - fromMs) / 1000;\n        // Reset logical time to beginning\n        logicalTimeMs = 0;\n        // Continue buffering will happen in fillBuffer() call below\n      } else {\n        // Normal advance\n        logicalTimeMs = endMs;\n      }\n\n      return true;\n    };\n\n    try {\n      await fillBuffer();\n      await playbackContext.resume();\n    } catch (error) {\n      // Ignore errors if AudioContext is closed or during test cleanup\n      if (\n        error instanceof Error &&\n        (error.name === \"InvalidStateError\" || error.message.includes(\"closed\"))\n      ) {\n        return;\n      }\n      throw error;\n    }\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"PlaybackController.js","names":["#FPS","#host","#playingProvider","#playing","#loopProvider","#loop","#currentTimeMsProvider","#durationMsProvider","#currentTime","#processingPendingSeek","#pendingSeekTime","#seekInProgress","#runSeek","#seekAbortController","#notifyListeners","#removed","#initializeTime","#selfRenderSuspended","#selfRenderAbortController","#selfRenderPromise","#selfRenderDirty","#startSelfRender","#listeners","#pendingAudioContext","#playbackAudioContext","rawTimeMs: number","#playbackWrapTimeSeconds","#loopingPlayback","#MS_PER_FRAME","#updatePlaybackTime","#playbackAnimationFrameRequest","#syncPlayheadToAudioContext","#AUDIO_PLAYBACK_SLICE_MS"],"sources":["../../src/gui/PlaybackController.ts"],"sourcesContent":["import { ContextProvider } from \"@lit/context\";\nimport type { ReactiveController, ReactiveControllerHost } from \"lit\";\nimport { currentTimeContext } from \"./currentTimeContext.js\";\nimport { durationContext } from \"./durationContext.js\";\nimport { loopContext, playingContext } from \"./playingContext.js\";\nimport {\n  updateAnimations,\n  type AnimatableElement,\n} from \"../elements/updateAnimations.js\";\nimport type {\n  RenderFrameOptions,\n  FrameRenderable,\n} from \"../preview/FrameController.js\";\n\ninterface PlaybackHost extends HTMLElement, ReactiveControllerHost {\n  currentTimeMs: number;\n  durationMs: number;\n  endTimeMs: number;\n  /** Centralized frame controller (present on EFTimegroup) */\n  frameController?: {\n    renderFrame(timeMs: number, options?: RenderFrameOptions): Promise<void>;\n    abort(): void;\n  };\n  renderAudio?(fromMs: number, toMs: number): Promise<AudioBuffer>;\n  waitForMediaDurations?(signal?: AbortSignal): Promise<void>;\n  saveTimeToLocalStorage?(time: number): void;\n  loadTimeFromLocalStorage?(): number | undefined;\n  requestUpdate(property?: string): void;\n  updateComplete: Promise<boolean>;\n  playing: boolean;\n  loop: boolean;\n  play(): void;\n  pause(): void;\n  playbackController?: PlaybackController;\n  parentTimegroup?: any;\n  rootTimegroup?: any;\n}\n\nexport type PlaybackControllerUpdateEvent = {\n  property: \"playing\" | \"loop\" | \"currentTimeMs\";\n  value: boolean | number;\n};\n\n/**\n * Manages playback state and audio-driven timing for root temporal elements\n *\n * Created automatically when a temporal element becomes a root (no parent timegroup)\n * Provides playback contexts (playing, loop, currentTimeMs, durationMs) to descendants\n * Handles:\n * - Audio-driven playback with Web Audio API\n * - Seek and frame rendering throttling\n * - Time state management with pending seek handling\n * - Playback loop behavior\n *\n * Works with any temporal element (timegroups or standalone media) via PlaybackHost interface\n */\nexport class PlaybackController implements ReactiveController {\n  #host: PlaybackHost;\n  #playing = false;\n  #loop = false;\n  #listeners = new Set<(event: PlaybackControllerUpdateEvent) => void>();\n  #playingProvider: ContextProvider<typeof playingContext>;\n  #loopProvider: ContextProvider<typeof loopContext>;\n  #currentTimeMsProvider: ContextProvider<typeof currentTimeContext>;\n  #durationMsProvider: ContextProvider<typeof durationContext>;\n\n  #FPS = 30;\n  #MS_PER_FRAME = 1000 / this.#FPS;\n  #playbackAudioContext: AudioContext | null = null;\n  #playbackAnimationFrameRequest: number | null = null;\n  #pendingAudioContext: AudioContext | null = null;\n  #AUDIO_PLAYBACK_SLICE_MS = ((47 * 1024) / 48000) * 1000;\n\n  #currentTime: number | undefined = undefined;\n  #seekInProgress = false;\n  #pendingSeekTime: number | undefined;\n  #processingPendingSeek = false;\n  #loopingPlayback = false; // Track if we're in a looping playback session\n  #playbackWrapTimeSeconds = 0; // The AudioContext time when we wrapped\n\n  #seekAbortController: AbortController | null = null;\n\n  constructor(host: PlaybackHost) {\n    this.#host = host;\n    host.addController(this);\n\n    this.#playingProvider = new ContextProvider(host, {\n      context: playingContext,\n      initialValue: this.#playing,\n    });\n    this.#loopProvider = new ContextProvider(host, {\n      context: loopContext,\n      initialValue: this.#loop,\n    });\n    this.#currentTimeMsProvider = new ContextProvider(host, {\n      context: currentTimeContext,\n      initialValue: host.currentTimeMs,\n    });\n    this.#durationMsProvider = new ContextProvider(host, {\n      context: durationContext,\n      initialValue: host.durationMs,\n    });\n  }\n\n  get currentTime(): number {\n    const rawTime = this.#currentTime ?? 0;\n    // Quantize to frame boundaries based on host's fps\n    const fps = (this.#host as any).fps ?? 30;\n    if (!fps || fps <= 0) return rawTime;\n    const frameDurationS = 1 / fps;\n    const quantizedTime = Math.round(rawTime / frameDurationS) * frameDurationS;\n    // Clamp to valid range after quantization to prevent exceeding duration\n    const durationS = this.#host.durationMs / 1000;\n    return Math.max(0, Math.min(quantizedTime, durationS));\n  }\n\n  set currentTime(time: number) {\n    time = Math.max(0, Math.min(this.#host.durationMs / 1000, time));\n    if (Number.isNaN(time)) {\n      return;\n    }\n    if (time === this.#currentTime && !this.#processingPendingSeek) {\n      return;\n    }\n    if (this.#pendingSeekTime === time) {\n      return;\n    }\n\n    if (this.#seekInProgress) {\n      this.#pendingSeekTime = time;\n      this.#currentTime = time;\n      return;\n    }\n\n    this.#currentTime = time;\n    this.#seekInProgress = true;\n\n    this.#runSeek(time).finally(async () => {\n      // CRITICAL: Coordinate animations after seek completes\n      // This ensures animations are positioned correctly, not playing naturally\n      const { updateAnimations } =\n        await import(\"../elements/updateAnimations.js\");\n      updateAnimations(this.#host as any);\n\n      if (\n        this.#pendingSeekTime !== undefined &&\n        this.#pendingSeekTime !== time\n      ) {\n        const pendingTime = this.#pendingSeekTime;\n        this.#pendingSeekTime = undefined;\n        this.#processingPendingSeek = true;\n        try {\n          this.currentTime = pendingTime;\n        } finally {\n          this.#processingPendingSeek = false;\n        }\n      } else {\n        this.#pendingSeekTime = undefined;\n      }\n    });\n  }\n\n  async #runSeek(targetTime: number): Promise<number | undefined> {\n    // Abort any in-flight seek\n    this.#seekAbortController?.abort();\n    this.#seekAbortController = new AbortController();\n    const signal = this.#seekAbortController.signal;\n\n    try {\n      signal.throwIfAborted();\n\n      await this.#host.waitForMediaDurations?.(signal);\n      signal.throwIfAborted();\n\n      const newTime = Math.max(\n        0,\n        Math.min(targetTime, this.#host.durationMs / 1000),\n      );\n      this.#currentTime = newTime;\n      this.#host.requestUpdate(\"currentTime\");\n      this.#currentTimeMsProvider.setValue(this.currentTimeMs);\n      this.#notifyListeners({\n        property: \"currentTimeMs\",\n        value: this.currentTimeMs,\n      });\n\n      signal.throwIfAborted();\n\n      await this.runThrottledFrameTask();\n      signal.throwIfAborted();\n\n      // Save to localStorage for persistence (only if not restoring to avoid loops)\n      const isRestoring =\n        (this.#host as any).isRestoringFromLocalStorage?.() ?? false;\n      if (!isRestoring) {\n        this.#host.saveTimeToLocalStorage?.(newTime);\n      } else {\n        (this.#host as any).setRestoringFromLocalStorage?.(false);\n      }\n      this.#seekInProgress = false;\n      return newTime;\n    } catch (error) {\n      if (error instanceof DOMException && error.name === \"AbortError\") {\n        // Expected - don't log\n        return undefined;\n      }\n      throw error;\n    }\n  }\n\n  get playing(): boolean {\n    return this.#playing;\n  }\n\n  setPlaying(value: boolean): void {\n    if (this.#playing === value) return;\n    this.#playing = value;\n    this.#playingProvider.setValue(value);\n    this.#host.requestUpdate(\"playing\");\n    this.#notifyListeners({ property: \"playing\", value });\n\n    if (value) {\n      this.startPlayback();\n    } else {\n      this.stopPlayback();\n    }\n  }\n\n  get loop(): boolean {\n    return this.#loop;\n  }\n\n  setLoop(value: boolean): void {\n    if (this.#loop === value) return;\n    this.#loop = value;\n    this.#loopProvider.setValue(value);\n    this.#host.requestUpdate(\"loop\");\n    this.#notifyListeners({ property: \"loop\", value });\n  }\n\n  get currentTimeMs(): number {\n    return this.currentTime * 1000;\n  }\n\n  setCurrentTimeMs(value: number): void {\n    this.currentTime = value / 1000;\n  }\n\n  // Update time during playback without triggering a seek\n  // Used by #syncPlayheadToAudioContext to avoid frame drops\n  #updatePlaybackTime(timeMs: number): void {\n    // Clamp to valid range to prevent time exceeding duration\n    const durationMs = this.#host.durationMs;\n    const clampedTimeMs = Math.max(0, Math.min(timeMs, durationMs));\n    const timeSec = clampedTimeMs / 1000;\n    if (this.#currentTime === timeSec) {\n      return;\n    }\n    this.#currentTime = timeSec;\n    this.#host.requestUpdate(\"currentTime\");\n    this.#currentTimeMsProvider.setValue(clampedTimeMs);\n    this.#notifyListeners({\n      property: \"currentTimeMs\",\n      value: clampedTimeMs,\n    });\n    // Trigger frame rendering without the async seek mechanism\n    this.runThrottledFrameTask();\n  }\n\n  play(): void {\n    this.setPlaying(true);\n  }\n\n  pause(): void {\n    this.setPlaying(false);\n  }\n\n  #removed = false;\n\n  hostConnected(): void {\n    // Defer all operations to avoid blocking during initialization\n    // This prevents deadlocks when many timegroups are initializing simultaneously\n    requestAnimationFrame(() => {\n      requestAnimationFrame(() => {\n        // Check if this controller was removed before the RAF callback executed.\n        // This happens when wrapWithWorkbench moves the element, causing disconnect/reconnect.\n        if (this.#removed || this.#host.playbackController !== this) {\n          return;\n        }\n\n        if (this.#playing) {\n          this.startPlayback();\n        } else {\n          this.#initializeTime();\n        }\n      });\n    });\n  }\n\n  async #initializeTime(): Promise<void> {\n    try {\n      const waitPromise = this.#host.waitForMediaDurations?.();\n      if (waitPromise) {\n        await waitPromise;\n      }\n    } catch (err) {\n      const isAbortError =\n        (err instanceof DOMException && err.name === \"AbortError\") ||\n        (err instanceof Error &&\n          (err.name === \"AbortError\" ||\n            err.message.includes(\"signal is aborted\") ||\n            err.message.includes(\"The user aborted a request\")));\n      if (!isAbortError) {\n        console.error(\"Error in PlaybackController hostConnected:\", err);\n      }\n      return;\n    }\n\n    if (this.#removed || this.#host.playbackController !== this) {\n      return;\n    }\n\n    const maybeLoadedTime = this.#host.loadTimeFromLocalStorage?.();\n    if (maybeLoadedTime !== undefined) {\n      (this.#host as any).setRestoringFromLocalStorage?.(true);\n      this.currentTime = maybeLoadedTime;\n    } else if (this.#currentTime === undefined) {\n      this.currentTime = 0;\n    }\n  }\n\n  hostDisconnected(): void {\n    this.pause();\n  }\n\n  hostUpdated(): void {\n    this.#durationMsProvider.setValue(this.#host.durationMs);\n    this.#currentTimeMsProvider.setValue(this.currentTimeMs);\n  }\n\n  #selfRenderAbortController?: AbortController;\n  #selfRenderPromise?: Promise<void>;\n  #selfRenderDirty = false;\n  #selfRenderSuspended = false;\n\n  suspendSelfRender(): void {\n    this.#selfRenderSuspended = true;\n    this.#selfRenderAbortController?.abort();\n    this.#selfRenderAbortController = undefined;\n  }\n\n  resumeSelfRender(): void {\n    this.#selfRenderSuspended = false;\n  }\n\n  /**\n   * Run frame rendering via FrameController, or directly on the host if it\n   * implements FrameRenderable (standalone media element without a Timegroup).\n   */\n  async runThrottledFrameTask(): Promise<void> {\n    const timeMs = this.currentTimeMs;\n\n    if (this.#host.frameController) {\n      try {\n        await this.#host.frameController.renderFrame(timeMs, {\n          onAnimationsUpdate: (root: Element) => {\n            updateAnimations(root as unknown as AnimatableElement);\n          },\n        });\n      } catch (error) {\n        if (error instanceof DOMException && error.name === \"AbortError\")\n          return;\n        console.error(\"FrameController error:\", error);\n      }\n      return;\n    }\n\n    // Standalone FrameRenderable host (e.g. bare ef-video without a Timegroup)\n    const host = this.#host as unknown as Partial<FrameRenderable>;\n    if (!host.prepareFrame || !host.renderFrame) return;\n\n    if (this.#selfRenderSuspended) return;\n\n    // If a render is in-flight, mark dirty so we re-render after it\n    // completes (source mapping may have changed due to trim drag).\n    if (this.#selfRenderPromise) {\n      this.#selfRenderDirty = true;\n      return this.#selfRenderPromise;\n    }\n\n    return this.#startSelfRender(host, timeMs);\n  }\n\n  #startSelfRender(\n    host: Partial<FrameRenderable>,\n    timeMs: number,\n  ): Promise<void> {\n    this.#selfRenderAbortController?.abort();\n    this.#selfRenderAbortController = new AbortController();\n    const signal = this.#selfRenderAbortController.signal;\n    this.#selfRenderDirty = false;\n\n    this.#selfRenderPromise = (async () => {\n      try {\n        await host.prepareFrame!(timeMs, signal);\n        signal.throwIfAborted();\n        host.renderFrame!(timeMs);\n        updateAnimations(this.#host as unknown as AnimatableElement);\n      } catch (error) {\n        if (error instanceof DOMException && error.name === \"AbortError\")\n          return;\n        if ((error as any)?.name === \"AbortError\") return;\n        console.error(\"Standalone frame render error:\", error);\n      } finally {\n        this.#selfRenderPromise = undefined;\n        // Re-render if source mapping changed while we were rendering\n        if (this.#selfRenderDirty && !this.#selfRenderSuspended) {\n          this.#startSelfRender(host, this.currentTimeMs);\n        }\n      }\n    })();\n\n    return this.#selfRenderPromise;\n  }\n\n  addListener(listener: (event: PlaybackControllerUpdateEvent) => void): void {\n    this.#listeners.add(listener);\n  }\n\n  removeListener(\n    listener: (event: PlaybackControllerUpdateEvent) => void,\n  ): void {\n    this.#listeners.delete(listener);\n  }\n\n  #notifyListeners(event: PlaybackControllerUpdateEvent): void {\n    for (const listener of this.#listeners) {\n      listener(event);\n    }\n  }\n\n  remove(): void {\n    this.#removed = true; // Mark as removed to abort any pending RAF callbacks\n    this.stopPlayback();\n    this.#listeners.clear();\n    this.#host.removeController(this);\n  }\n\n  setPendingAudioContext(context: AudioContext): void {\n    this.#pendingAudioContext = context;\n  }\n\n  #syncPlayheadToAudioContext(startMs: number) {\n    const audioContextTime = this.#playbackAudioContext?.currentTime ?? 0;\n    const endMs = this.#host.endTimeMs;\n\n    // Calculate raw time based on audio context\n    let rawTimeMs: number;\n    if (\n      this.#playbackWrapTimeSeconds > 0 &&\n      audioContextTime >= this.#playbackWrapTimeSeconds\n    ) {\n      // After wrap: time since wrap, wrapped to duration\n      const timeSinceWrap =\n        (audioContextTime - this.#playbackWrapTimeSeconds) * 1000;\n      rawTimeMs = timeSinceWrap % endMs;\n    } else {\n      // Before wrap or no wrap: normal calculation\n      rawTimeMs = startMs + audioContextTime * 1000;\n\n      // If looping and we've reached the end, wrap around\n      if (this.#loopingPlayback && rawTimeMs >= endMs) {\n        rawTimeMs = rawTimeMs % endMs;\n      }\n    }\n\n    const nextTimeMs =\n      Math.round(rawTimeMs / this.#MS_PER_FRAME) * this.#MS_PER_FRAME;\n\n    // During playback, update time directly without triggering seek\n    // This avoids frame drops at the loop boundary\n    this.#updatePlaybackTime(nextTimeMs);\n\n    // Only check for end if we haven't already handled looping\n    if (!this.#loopingPlayback && nextTimeMs >= endMs) {\n      this.maybeLoopPlayback();\n      return;\n    }\n\n    this.#playbackAnimationFrameRequest = requestAnimationFrame(() => {\n      this.#syncPlayheadToAudioContext(startMs);\n    });\n  }\n\n  private async maybeLoopPlayback() {\n    if (this.#loop) {\n      // Loop enabled: reset to beginning and restart playback\n      // We restart the audio system directly without changing #playing state\n      // to keep the play button in sync\n      this.setCurrentTimeMs(0);\n      // Restart in next frame without awaiting to minimize gap\n      requestAnimationFrame(() => {\n        this.startPlayback();\n      });\n    } else {\n      // No loop: reset to beginning and stop\n      // This ensures play button works when clicked again\n      this.setCurrentTimeMs(0);\n      this.pause();\n    }\n  }\n\n  private async stopPlayback() {\n    if (this.#playbackAudioContext) {\n      if (this.#playbackAudioContext.state !== \"closed\") {\n        await this.#playbackAudioContext.close();\n      }\n    }\n    if (this.#playbackAnimationFrameRequest) {\n      cancelAnimationFrame(this.#playbackAnimationFrameRequest);\n    }\n    this.#playbackAudioContext = null;\n    this.#playbackAnimationFrameRequest = null;\n    this.#pendingAudioContext = null;\n  }\n\n  private async startPlayback() {\n    // Guard against starting playback on a removed controller\n    if (this.#removed) {\n      return;\n    }\n\n    await this.stopPlayback();\n    const host = this.#host;\n    if (!host) {\n      return;\n    }\n\n    if (host.waitForMediaDurations) {\n      await host.waitForMediaDurations();\n    }\n\n    // Check again after async - controller could have been removed\n    if (this.#removed) {\n      return;\n    }\n\n    const currentMs = this.currentTimeMs;\n    const fromMs = currentMs;\n    const toMs = host.endTimeMs;\n\n    if (fromMs >= toMs) {\n      this.pause();\n      return;\n    }\n\n    let bufferCount = 0;\n    // Check for pre-resumed AudioContext from synchronous user interaction\n    if (this.#pendingAudioContext) {\n      this.#playbackAudioContext = this.#pendingAudioContext;\n      this.#pendingAudioContext = null;\n    } else {\n      this.#playbackAudioContext = new AudioContext({\n        latencyHint: \"playback\",\n      });\n    }\n    this.#loopingPlayback = this.#loop; // Remember if we're in a looping session\n    this.#playbackWrapTimeSeconds = 0; // Reset wrap time\n\n    if (this.#playbackAnimationFrameRequest) {\n      cancelAnimationFrame(this.#playbackAnimationFrameRequest);\n    }\n    this.#syncPlayheadToAudioContext(currentMs);\n    const playbackContext = this.#playbackAudioContext;\n\n    // Check if context is suspended (fallback for newly-created contexts)\n    if (playbackContext.state === \"suspended\") {\n      // Attempt to resume (may not work on mobile if user interaction context is lost)\n      try {\n        await playbackContext.resume();\n        // Check state again after resume attempt\n        if (playbackContext.state === \"suspended\") {\n          console.warn(\n            \"AudioContext is suspended and resume() failed. \" +\n              \"On mobile devices, AudioContext.resume() must be called synchronously within a user interaction handler. \" +\n              \"Media playback will not work until user has interacted with page.\",\n          );\n          this.setPlaying(false);\n          return;\n        }\n      } catch (error) {\n        console.warn(\n          \"Failed to resume AudioContext:\",\n          error,\n          \"On mobile devices, AudioContext.resume() must be called synchronously within a user interaction handler.\",\n        );\n        this.setPlaying(false);\n        return;\n      }\n    }\n    await playbackContext.suspend();\n\n    // Track the logical media time (what position in the media we're rendering)\n    // vs the AudioContext schedule time (when to play it)\n    let logicalTimeMs = currentMs;\n    let audioContextTimeMs = 0; // Tracks the schedule position in the AudioContext timeline\n    let hasWrapped = false;\n\n    const fillBuffer = async () => {\n      if (bufferCount > 2) {\n        return;\n      }\n      const canFillBuffer = await queueBufferSource();\n      if (canFillBuffer) {\n        fillBuffer().catch(() => {});\n      }\n    };\n\n    const queueBufferSource = async () => {\n      // Check if we've already wrapped and aren't looping anymore\n      if (hasWrapped && !this.#loopingPlayback) {\n        return false;\n      }\n\n      const startMs = logicalTimeMs;\n      const endMs = Math.min(\n        logicalTimeMs + this.#AUDIO_PLAYBACK_SLICE_MS,\n        toMs,\n      );\n\n      // Will this slice reach the end?\n      const willReachEnd = endMs >= toMs;\n\n      if (!host.renderAudio) {\n        return false;\n      }\n\n      const audioBuffer = await host.renderAudio(startMs, endMs);\n      bufferCount++;\n      const source = playbackContext.createBufferSource();\n      source.buffer = audioBuffer;\n      source.connect(playbackContext.destination);\n      // Schedule this buffer to play at the current audioContextTime position\n      source.start(audioContextTimeMs / 1000);\n\n      const sliceDurationMs = endMs - startMs;\n\n      source.onended = () => {\n        bufferCount--;\n\n        if (willReachEnd) {\n          if (!this.#loopingPlayback) {\n            // Not looping, end playback\n            this.maybeLoopPlayback();\n          } else {\n            // Looping: continue filling buffer after wrap\n            fillBuffer().catch(() => {});\n          }\n        } else {\n          // Continue filling buffer\n          fillBuffer().catch(() => {});\n        }\n      };\n\n      // Advance the AudioContext schedule time\n      audioContextTimeMs += sliceDurationMs;\n\n      // If this buffer reaches the end and we're looping, immediately queue the wraparound\n      if (willReachEnd && this.#loopingPlayback) {\n        // Mark that we've wrapped\n        hasWrapped = true;\n        // Store when we wrapped (relative to when playback started, which is time 0 in AudioContext)\n        // This is the duration from start to end\n        this.#playbackWrapTimeSeconds = (toMs - fromMs) / 1000;\n        // Reset logical time to beginning\n        logicalTimeMs = 0;\n        // Continue buffering will happen in fillBuffer() call below\n      } else {\n        // Normal advance\n        logicalTimeMs = endMs;\n      }\n\n      return true;\n    };\n\n    try {\n      await fillBuffer();\n      await playbackContext.resume();\n    } catch (error) {\n      // Ignore errors if AudioContext is closed or during test cleanup\n      if (\n        error instanceof Error &&\n        (error.name === \"InvalidStateError\" || error.message.includes(\"closed\"))\n      ) {\n        return;\n      }\n      throw error;\n    }\n  }\n}\n"],"mappings":"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"}

package/dist/gui/ef-theme.css

@@ -65,6 +65,12 @@
   --ef-radius-sm: 0.25rem; /* 4px */
   --ef-radius-md: 0.375rem; /* 6px */
 
+  /* Loading state tokens */
+  --ef-color-loading-overlay-bg: rgba(0, 0, 0, 0.5);
+  --ef-color-loading-spinner-track: rgba(255, 255, 255, 0.15);
+  --ef-color-loading-spinner-fill: rgba(255, 255, 255, 0.85);
+  --ef-loading-shimmer-duration: 1.5s;
+
   /* Filmstrip component tokens (reference globals) */
   --filmstrip-bg: var(--ef-color-bg-inset);
   --filmstrip-item-bg: rgba(17, 17, 17, 0.9); /* Darker */
@@ -129,6 +135,11 @@
   --ef-color-type-captions: #0891B2; /* Cyan-600 */
   --ef-color-type-timegroup: #475569; /* Slate-600 */
 
+  /* Loading state tokens — light mode */
+  --ef-color-loading-overlay-bg: rgba(0, 0, 0, 0.3);
+  --ef-color-loading-spinner-track: rgba(0, 0, 0, 0.12);
+  --ef-color-loading-spinner-fill: rgba(0, 0, 0, 0.75);
+
   /* Filmstrip light mode adjustments */
   --filmstrip-item-bg: rgba(238, 238, 238, 0.95);
   --filmstrip-waveform-bg: rgba(0, 0, 0, 0.06);