@editframe/elements 0.38.1 → 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);

package/dist/gui/timeline/tracks/AudioTrack.js

@@ -35,6 +35,28 @@ let EFAudioTrack = class EFAudioTrack$1 extends TrackItem {
         height: 100%;
         pointer-events: none;
       }
+      .shimmer-placeholder {
+        position: absolute;
+        left: 0;
+        top: 2px;
+        bottom: 2px;
+        right: 0;
+        background: linear-gradient(
+          90deg,
+          color-mix(in srgb, var(--ef-color-type-audio, #10b981) 20%, transparent) 0%,
+          color-mix(in srgb, var(--ef-color-type-audio, #10b981) 42%, transparent) 50%,
+          color-mix(in srgb, var(--ef-color-type-audio, #10b981) 20%, transparent) 100%
+        );
+        background-size: 200% 100%;
+        border-radius: 2px;
+      }
+      .shimmer-placeholder.is-loading {
+        animation: shimmer var(--ef-loading-shimmer-duration, 1.5s) linear infinite;
+      }
+      @keyframes shimmer {
+        0% { background-position: 200% 0; }
+        100% { background-position: -200% 0; }
+      }
     `];
 	}
 	#lastSrc = null;
@@ -46,14 +68,15 @@ let EFAudioTrack = class EFAudioTrack$1 extends TrackItem {
 	* Load waveform data when the audio source changes
 	*/
 	async #loadWaveformData() {
-		const src = this.element?.src;
+		const audio = this.element;
+		const src = audio?.src;
 		if (!src || src === this.#lastSrc) return;
 		this.#lastSrc = src;
 		this.#abortController?.abort();
 		this.#abortController = new AbortController();
 		this._isLoading = true;
 		try {
-			const waveformData = await extractWaveformData(src, this.#abortController.signal);
+			const waveformData = await extractWaveformData(audio, this.#abortController.signal);
 			if (waveformData) {
 				this._waveformData = waveformData;
 				this.#scheduleRender();
@@ -221,35 +244,10 @@ let EFAudioTrack = class EFAudioTrack$1 extends TrackItem {
       </div>
     `;
 	}
-	/**
-	* Render placeholder while loading
-	*/
 	#renderPlaceholder() {
-		return html`
-      <div
-        style="
-          position: absolute;
-          left: 0;
-          top: 2px;
-          bottom: 2px;
-          right: 0;
-          background: linear-gradient(90deg, 
-            ${this.getElementTypeColor()}22 0%, 
-            ${this.getElementTypeColor()}44 50%,
-            ${this.getElementTypeColor()}22 100%
-          );
-          background-size: 200% 100%;
-          animation: ${this._isLoading ? "shimmer 1.5s infinite" : "none"};
-          border-radius: 2px;
-        "
-      ></div>
-      <style>
-        @keyframes shimmer {
-          0% { background-position: 200% 0; }
-          100% { background-position: -200% 0; }
-        }
-      </style>
-    `;
+		return html`<div
+      class="shimmer-placeholder ${this._isLoading ? "is-loading" : ""}"
+    ></div>`;
 	}
 };
 __decorate([consume({

package/dist/gui/timeline/tracks/AudioTrack.js.map

@@ -1 +1 @@
-{"version":3,"file":"AudioTrack.js","names":["EFAudioTrack","#loadWaveformData","#lastSrc","#abortController","#scheduleRender","#renderRequested","#renderWaveform","#getTrackPositionInfo","#hostHeight","#drawWaveformRegion","#resizeObserver","#renderPlaceholder"],"sources":["../../../../src/gui/timeline/tracks/AudioTrack.ts"],"sourcesContent":["import { consume } from \"@lit/context\";\nimport { css, html, nothing } from \"lit\";\nimport { customElement, state } from \"lit/decorators.js\";\nimport { createRef, ref } from \"lit/directives/ref.js\";\nimport { EFAudio } from \"../../../elements/EFAudio.js\";\nimport { TrackItem } from \"./TrackItem.js\";\nimport { extractWaveformData, type WaveformData } from \"./waveformUtils.js\";\nimport {\n  timelineStateContext,\n  type TimelineState,\n} from \"../timelineStateContext.js\";\n\n/** Padding in pixels to render beyond visible area (for smooth scrolling) */\nconst VIRTUAL_RENDER_PADDING_PX = 100;\n\n@customElement(\"ef-audio-track\")\nexport class EFAudioTrack extends TrackItem {\n  static styles = [\n    ...TrackItem.styles,\n    css`\n      .waveform-host {\n        position: absolute;\n        left: 0;\n        top: 2px;\n        right: 0;\n        bottom: 2px;\n        overflow: hidden;\n      }\n      .waveform-canvas {\n        display: block;\n        position: absolute;\n        top: 0;\n        height: 100%;\n        pointer-events: none;\n      }\n    `,\n  ];\n\n  canvasRef = createRef<HTMLCanvasElement>();\n\n  /** Timeline state context for viewport info */\n  @consume({ context: timelineStateContext, subscribe: true })\n  @state()\n  private _timelineState?: TimelineState;\n\n  @state()\n  private _waveformData: WaveformData | null = null;\n\n  @state()\n  private _isLoading = false;\n\n  #lastSrc: string | null = null;\n  #abortController: AbortController | null = null;\n  #resizeObserver?: ResizeObserver;\n  #renderRequested = false;\n  #hostHeight = 0;\n\n  /**\n   * Load waveform data when the audio source changes\n   */\n  async #loadWaveformData(): Promise<void> {\n    const audio = this.element as EFAudio;\n    const src = audio?.src;\n\n    // Skip if no source or same source already loaded\n    if (!src || src === this.#lastSrc) {\n      return;\n    }\n\n    this.#lastSrc = src;\n\n    // Cancel any in-progress load\n    this.#abortController?.abort();\n    this.#abortController = new AbortController();\n\n    this._isLoading = true;\n\n    try {\n      const waveformData = await extractWaveformData(\n        src,\n        this.#abortController.signal,\n      );\n\n      if (waveformData) {\n        this._waveformData = waveformData;\n        this.#scheduleRender();\n      }\n    } catch (error) {\n      if (!(error instanceof DOMException && error.name === \"AbortError\")) {\n        console.warn(\"Failed to load waveform data:\", error);\n      }\n    } finally {\n      this._isLoading = false;\n    }\n  }\n\n  /**\n   * Schedule a canvas render on the next animation frame\n   */\n  #scheduleRender(): void {\n    if (this.#renderRequested) return;\n    this.#renderRequested = true;\n\n    requestAnimationFrame(() => {\n      this.#renderRequested = false;\n      this.#renderWaveform();\n    });\n  }\n\n  /**\n   * Get the track's position info relative to timeline scroll\n   */\n  #getTrackPositionInfo(): {\n    trackStartPx: number;\n    trackWidthPx: number;\n    viewportScrollLeft: number;\n    viewportWidth: number;\n    pixelsPerMs: number;\n  } | null {\n    const audio = this.element as EFAudio;\n    const durationMs = audio.durationMs ?? 0;\n    if (durationMs === 0) return null;\n\n    const pixelsPerMs = this._timelineState?.pixelsPerMs ?? this.pixelsPerMs;\n    const trackWidthPx = durationMs * pixelsPerMs;\n\n    // Get track's absolute position from startTimeMs\n    const trackStartMs = audio.startTimeMs ?? 0;\n    const trackStartPx = trackStartMs * pixelsPerMs;\n\n    // Get viewport info from context\n    const viewportScrollLeft = this._timelineState?.viewportScrollLeft ?? 0;\n    const viewportWidth = this._timelineState?.viewportWidth ?? 800;\n\n    return {\n      trackStartPx,\n      trackWidthPx,\n      viewportScrollLeft,\n      viewportWidth,\n      pixelsPerMs,\n    };\n  }\n\n  /**\n   * Render the waveform to canvas with virtual rendering.\n   *\n   * The approach:\n   * 1. Calculate the visible portion of the track (intersection of track and viewport)\n   * 2. Position the canvas at that visible portion within the track\n   * 3. Draw only the waveform data for that visible time range\n   * 4. Update position and content as scroll/zoom changes\n   */\n  #renderWaveform(): void {\n    const canvas = this.canvasRef.value;\n    const waveformData = this._waveformData;\n\n    if (!canvas || !waveformData) return;\n\n    const positionInfo = this.#getTrackPositionInfo();\n    if (!positionInfo) return;\n\n    const {\n      trackStartPx,\n      trackWidthPx,\n      viewportScrollLeft,\n      viewportWidth,\n      pixelsPerMs,\n    } = positionInfo;\n\n    // Calculate visible region in absolute pixels (with padding for smooth scrolling)\n    const visibleLeftPx = viewportScrollLeft - VIRTUAL_RENDER_PADDING_PX;\n    const visibleRightPx =\n      viewportScrollLeft + viewportWidth + VIRTUAL_RENDER_PADDING_PX;\n\n    // Track boundaries in absolute pixels\n    const trackEndPx = trackStartPx + trackWidthPx;\n\n    // Check if track is visible at all\n    if (trackEndPx < visibleLeftPx || trackStartPx > visibleRightPx) {\n      // Track not visible, hide canvas\n      canvas.style.display = \"none\";\n      return;\n    }\n    canvas.style.display = \"block\";\n\n    // Calculate the intersection: what part of the track is visible\n    // All coordinates are now relative to the track's left edge (0 = track start)\n    const visibleStartInTrack = Math.max(0, visibleLeftPx - trackStartPx);\n    const visibleEndInTrack = Math.min(\n      trackWidthPx,\n      visibleRightPx - trackStartPx,\n    );\n    const visibleWidthPx = visibleEndInTrack - visibleStartInTrack;\n\n    if (visibleWidthPx <= 0) return;\n\n    const height = this.#hostHeight || 18;\n\n    // Set canvas size with DPR\n    const dpr = window.devicePixelRatio || 1;\n    const targetWidth = Math.ceil(visibleWidthPx * dpr);\n    const targetHeight = Math.ceil(height * dpr);\n\n    if (canvas.width !== targetWidth || canvas.height !== targetHeight) {\n      canvas.width = targetWidth;\n      canvas.height = targetHeight;\n    }\n\n    // Position canvas at the visible portion within the track\n    canvas.style.left = `${visibleStartInTrack}px`;\n    canvas.style.width = `${visibleWidthPx}px`;\n    canvas.style.height = `${height}px`;\n\n    const ctx = canvas.getContext(\"2d\");\n    if (!ctx) return;\n\n    ctx.setTransform(dpr, 0, 0, dpr, 0, 0);\n    ctx.clearRect(0, 0, visibleWidthPx, height);\n\n    // Calculate what time range to render\n    const audio = this.element as EFAudio;\n    const sourceInMs = audio.sourceStartMs ?? 0;\n\n    // Convert visible pixel range to time range\n    const timeStartMs = sourceInMs + visibleStartInTrack / pixelsPerMs;\n    const timeEndMs = sourceInMs + visibleEndInTrack / pixelsPerMs;\n\n    // Draw the waveform for the visible portion\n    this.#drawWaveformRegion(\n      ctx,\n      waveformData,\n      0, // Start drawing at x=0 of canvas (canvas is already positioned)\n      visibleWidthPx,\n      height,\n      timeStartMs,\n      timeEndMs,\n    );\n  }\n\n  /**\n   * Draw a region of the waveform to canvas\n   */\n  #drawWaveformRegion(\n    ctx: CanvasRenderingContext2D,\n    waveformData: WaveformData,\n    x: number,\n    width: number,\n    height: number,\n    startMs: number,\n    endMs: number,\n  ): void {\n    const { peaks, samplesPerSecond } = waveformData;\n\n    // Calculate sample range\n    const startSample = Math.floor((startMs / 1000) * samplesPerSecond);\n    const endSample = Math.ceil((endMs / 1000) * samplesPerSecond);\n    const sampleCount = endSample - startSample;\n\n    if (sampleCount <= 0 || width <= 0) return;\n\n    const centerY = height / 2;\n    const halfHeight = height / 2 - 2; // Leave 2px padding top/bottom\n    const color = this.getElementTypeColor();\n\n    ctx.fillStyle = color;\n    ctx.globalAlpha = 0.8;\n    ctx.beginPath();\n\n    // Draw top half (max values) left to right\n    const pixelsPerSample = width / sampleCount;\n\n    for (let i = 0; i <= sampleCount; i++) {\n      const sampleIndex = startSample + i;\n      const peakIndex = sampleIndex * 2;\n\n      // Clamp to valid range\n      if (peakIndex + 1 >= peaks.length) break;\n\n      const maxValue = peaks[peakIndex + 1] ?? 0;\n      const px = x + i * pixelsPerSample;\n      const py = centerY - maxValue * halfHeight;\n\n      if (i === 0) {\n        ctx.moveTo(px, py);\n      } else {\n        ctx.lineTo(px, py);\n      }\n    }\n\n    // Draw bottom half (min values) right to left\n    for (let i = sampleCount; i >= 0; i--) {\n      const sampleIndex = startSample + i;\n      const peakIndex = sampleIndex * 2;\n\n      // Clamp to valid range\n      if (peakIndex >= peaks.length) continue;\n\n      const minValue = peaks[peakIndex] ?? 0;\n      const px = x + i * pixelsPerSample;\n      const py = centerY - minValue * halfHeight;\n\n      ctx.lineTo(px, py);\n    }\n\n    ctx.closePath();\n    ctx.fill();\n\n    // Draw center line\n    ctx.globalAlpha = 0.3;\n    ctx.strokeStyle = color;\n    ctx.lineWidth = 1;\n    ctx.beginPath();\n    ctx.moveTo(x, centerY);\n    ctx.lineTo(x + width, centerY);\n    ctx.stroke();\n\n    ctx.globalAlpha = 1;\n  }\n\n  connectedCallback(): void {\n    super.connectedCallback();\n\n    // Start loading waveform data\n    this.#loadWaveformData();\n\n    // Observe size changes\n    this.#resizeObserver = new ResizeObserver((entries) => {\n      for (const entry of entries) {\n        this.#hostHeight =\n          entry.borderBoxSize?.[0]?.blockSize ?? entry.contentRect.height;\n        this.#scheduleRender();\n      }\n    });\n  }\n\n  disconnectedCallback(): void {\n    super.disconnectedCallback();\n    this.#abortController?.abort();\n    this.#resizeObserver?.disconnect();\n  }\n\n  updated(changedProperties: Map<string | number | symbol, unknown>): void {\n    super.updated(changedProperties);\n\n    // Check if we need to reload waveform data\n    const audio = this.element as EFAudio;\n    if (audio?.src !== this.#lastSrc) {\n      this.#loadWaveformData();\n    }\n\n    // Re-render when timeline state changes (scroll, zoom)\n    if (changedProperties.has(\"_timelineState\")) {\n      this.#scheduleRender();\n    }\n\n    // Attach resize observer to track container once rendered\n    if (this.canvasRef.value && this.#resizeObserver) {\n      const container = this.canvasRef.value.parentElement;\n      if (container) {\n        this.#resizeObserver.disconnect();\n        this.#resizeObserver.observe(container);\n      }\n    }\n\n    // Always schedule render after update to catch any changes\n    this.#scheduleRender();\n  }\n\n  contents() {\n    const audio = this.element as EFAudio;\n    if (!(audio instanceof EFAudio)) {\n      return nothing;\n    }\n\n    const durationMs = audio.durationMs ?? 0;\n    if (durationMs === 0) {\n      return nothing;\n    }\n\n    // Show loading placeholder if no waveform data yet\n    if (!this._waveformData) {\n      return this.#renderPlaceholder();\n    }\n\n    // The host fills the track container, canvas is positioned within it\n    return html`\n      <div class=\"waveform-host\">\n        <canvas ${ref(this.canvasRef)} class=\"waveform-canvas\"></canvas>\n      </div>\n    `;\n  }\n\n  /**\n   * Render placeholder while loading\n   */\n  #renderPlaceholder() {\n    return html`\n      <div\n        style=\"\n          position: absolute;\n          left: 0;\n          top: 2px;\n          bottom: 2px;\n          right: 0;\n          background: linear-gradient(90deg, \n            ${this.getElementTypeColor()}22 0%, \n            ${this.getElementTypeColor()}44 50%,\n            ${this.getElementTypeColor()}22 100%\n          );\n          background-size: 200% 100%;\n          animation: ${this._isLoading ? \"shimmer 1.5s infinite\" : \"none\"};\n          border-radius: 2px;\n        \"\n      ></div>\n      <style>\n        @keyframes shimmer {\n          0% { background-position: 200% 0; }\n          100% { background-position: -200% 0; }\n        }\n      </style>\n    `;\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"AudioTrack.js","names":["EFAudioTrack","#loadWaveformData","#lastSrc","#abortController","#scheduleRender","#renderRequested","#renderWaveform","#getTrackPositionInfo","#hostHeight","#drawWaveformRegion","#resizeObserver","#renderPlaceholder"],"sources":["../../../../src/gui/timeline/tracks/AudioTrack.ts"],"sourcesContent":["import { consume } from \"@lit/context\";\nimport { css, html, nothing } from \"lit\";\nimport { customElement, state } from \"lit/decorators.js\";\nimport { createRef, ref } from \"lit/directives/ref.js\";\nimport { EFAudio } from \"../../../elements/EFAudio.js\";\nimport { TrackItem } from \"./TrackItem.js\";\nimport { extractWaveformData, type WaveformData } from \"./waveformUtils.js\";\nimport {\n  timelineStateContext,\n  type TimelineState,\n} from \"../timelineStateContext.js\";\n\n/** Padding in pixels to render beyond visible area (for smooth scrolling) */\nconst VIRTUAL_RENDER_PADDING_PX = 100;\n\n@customElement(\"ef-audio-track\")\nexport class EFAudioTrack extends TrackItem {\n  static styles = [\n    ...TrackItem.styles,\n    css`\n      .waveform-host {\n        position: absolute;\n        left: 0;\n        top: 2px;\n        right: 0;\n        bottom: 2px;\n        overflow: hidden;\n      }\n      .waveform-canvas {\n        display: block;\n        position: absolute;\n        top: 0;\n        height: 100%;\n        pointer-events: none;\n      }\n      .shimmer-placeholder {\n        position: absolute;\n        left: 0;\n        top: 2px;\n        bottom: 2px;\n        right: 0;\n        background: linear-gradient(\n          90deg,\n          color-mix(in srgb, var(--ef-color-type-audio, #10b981) 20%, transparent) 0%,\n          color-mix(in srgb, var(--ef-color-type-audio, #10b981) 42%, transparent) 50%,\n          color-mix(in srgb, var(--ef-color-type-audio, #10b981) 20%, transparent) 100%\n        );\n        background-size: 200% 100%;\n        border-radius: 2px;\n      }\n      .shimmer-placeholder.is-loading {\n        animation: shimmer var(--ef-loading-shimmer-duration, 1.5s) linear infinite;\n      }\n      @keyframes shimmer {\n        0% { background-position: 200% 0; }\n        100% { background-position: -200% 0; }\n      }\n    `,\n  ];\n\n  canvasRef = createRef<HTMLCanvasElement>();\n\n  /** Timeline state context for viewport info */\n  @consume({ context: timelineStateContext, subscribe: true })\n  @state()\n  private _timelineState?: TimelineState;\n\n  @state()\n  private _waveformData: WaveformData | null = null;\n\n  @state()\n  private _isLoading = false;\n\n  #lastSrc: string | null = null;\n  #abortController: AbortController | null = null;\n  #resizeObserver?: ResizeObserver;\n  #renderRequested = false;\n  #hostHeight = 0;\n\n  /**\n   * Load waveform data when the audio source changes\n   */\n  async #loadWaveformData(): Promise<void> {\n    const audio = this.element as EFAudio;\n    const src = audio?.src;\n\n    // Skip if no source or same source already loaded\n    if (!src || src === this.#lastSrc) {\n      return;\n    }\n\n    this.#lastSrc = src;\n\n    // Cancel any in-progress load\n    this.#abortController?.abort();\n    this.#abortController = new AbortController();\n\n    this._isLoading = true;\n\n    try {\n      const waveformData = await extractWaveformData(\n        audio,\n        this.#abortController.signal,\n      );\n\n      if (waveformData) {\n        this._waveformData = waveformData;\n        this.#scheduleRender();\n      }\n    } catch (error) {\n      if (!(error instanceof DOMException && error.name === \"AbortError\")) {\n        console.warn(\"Failed to load waveform data:\", error);\n      }\n    } finally {\n      this._isLoading = false;\n    }\n  }\n\n  /**\n   * Schedule a canvas render on the next animation frame\n   */\n  #scheduleRender(): void {\n    if (this.#renderRequested) return;\n    this.#renderRequested = true;\n\n    requestAnimationFrame(() => {\n      this.#renderRequested = false;\n      this.#renderWaveform();\n    });\n  }\n\n  /**\n   * Get the track's position info relative to timeline scroll\n   */\n  #getTrackPositionInfo(): {\n    trackStartPx: number;\n    trackWidthPx: number;\n    viewportScrollLeft: number;\n    viewportWidth: number;\n    pixelsPerMs: number;\n  } | null {\n    const audio = this.element as EFAudio;\n    const durationMs = audio.durationMs ?? 0;\n    if (durationMs === 0) return null;\n\n    const pixelsPerMs = this._timelineState?.pixelsPerMs ?? this.pixelsPerMs;\n    const trackWidthPx = durationMs * pixelsPerMs;\n\n    // Get track's absolute position from startTimeMs\n    const trackStartMs = audio.startTimeMs ?? 0;\n    const trackStartPx = trackStartMs * pixelsPerMs;\n\n    // Get viewport info from context\n    const viewportScrollLeft = this._timelineState?.viewportScrollLeft ?? 0;\n    const viewportWidth = this._timelineState?.viewportWidth ?? 800;\n\n    return {\n      trackStartPx,\n      trackWidthPx,\n      viewportScrollLeft,\n      viewportWidth,\n      pixelsPerMs,\n    };\n  }\n\n  /**\n   * Render the waveform to canvas with virtual rendering.\n   *\n   * The approach:\n   * 1. Calculate the visible portion of the track (intersection of track and viewport)\n   * 2. Position the canvas at that visible portion within the track\n   * 3. Draw only the waveform data for that visible time range\n   * 4. Update position and content as scroll/zoom changes\n   */\n  #renderWaveform(): void {\n    const canvas = this.canvasRef.value;\n    const waveformData = this._waveformData;\n\n    if (!canvas || !waveformData) return;\n\n    const positionInfo = this.#getTrackPositionInfo();\n    if (!positionInfo) return;\n\n    const {\n      trackStartPx,\n      trackWidthPx,\n      viewportScrollLeft,\n      viewportWidth,\n      pixelsPerMs,\n    } = positionInfo;\n\n    // Calculate visible region in absolute pixels (with padding for smooth scrolling)\n    const visibleLeftPx = viewportScrollLeft - VIRTUAL_RENDER_PADDING_PX;\n    const visibleRightPx =\n      viewportScrollLeft + viewportWidth + VIRTUAL_RENDER_PADDING_PX;\n\n    // Track boundaries in absolute pixels\n    const trackEndPx = trackStartPx + trackWidthPx;\n\n    // Check if track is visible at all\n    if (trackEndPx < visibleLeftPx || trackStartPx > visibleRightPx) {\n      // Track not visible, hide canvas\n      canvas.style.display = \"none\";\n      return;\n    }\n    canvas.style.display = \"block\";\n\n    // Calculate the intersection: what part of the track is visible\n    // All coordinates are now relative to the track's left edge (0 = track start)\n    const visibleStartInTrack = Math.max(0, visibleLeftPx - trackStartPx);\n    const visibleEndInTrack = Math.min(\n      trackWidthPx,\n      visibleRightPx - trackStartPx,\n    );\n    const visibleWidthPx = visibleEndInTrack - visibleStartInTrack;\n\n    if (visibleWidthPx <= 0) return;\n\n    const height = this.#hostHeight || 18;\n\n    // Set canvas size with DPR\n    const dpr = window.devicePixelRatio || 1;\n    const targetWidth = Math.ceil(visibleWidthPx * dpr);\n    const targetHeight = Math.ceil(height * dpr);\n\n    if (canvas.width !== targetWidth || canvas.height !== targetHeight) {\n      canvas.width = targetWidth;\n      canvas.height = targetHeight;\n    }\n\n    // Position canvas at the visible portion within the track\n    canvas.style.left = `${visibleStartInTrack}px`;\n    canvas.style.width = `${visibleWidthPx}px`;\n    canvas.style.height = `${height}px`;\n\n    const ctx = canvas.getContext(\"2d\");\n    if (!ctx) return;\n\n    ctx.setTransform(dpr, 0, 0, dpr, 0, 0);\n    ctx.clearRect(0, 0, visibleWidthPx, height);\n\n    // Calculate what time range to render\n    const audio = this.element as EFAudio;\n    const sourceInMs = audio.sourceStartMs ?? 0;\n\n    // Convert visible pixel range to time range\n    const timeStartMs = sourceInMs + visibleStartInTrack / pixelsPerMs;\n    const timeEndMs = sourceInMs + visibleEndInTrack / pixelsPerMs;\n\n    // Draw the waveform for the visible portion\n    this.#drawWaveformRegion(\n      ctx,\n      waveformData,\n      0, // Start drawing at x=0 of canvas (canvas is already positioned)\n      visibleWidthPx,\n      height,\n      timeStartMs,\n      timeEndMs,\n    );\n  }\n\n  /**\n   * Draw a region of the waveform to canvas\n   */\n  #drawWaveformRegion(\n    ctx: CanvasRenderingContext2D,\n    waveformData: WaveformData,\n    x: number,\n    width: number,\n    height: number,\n    startMs: number,\n    endMs: number,\n  ): void {\n    const { peaks, samplesPerSecond } = waveformData;\n\n    // Calculate sample range\n    const startSample = Math.floor((startMs / 1000) * samplesPerSecond);\n    const endSample = Math.ceil((endMs / 1000) * samplesPerSecond);\n    const sampleCount = endSample - startSample;\n\n    if (sampleCount <= 0 || width <= 0) return;\n\n    const centerY = height / 2;\n    const halfHeight = height / 2 - 2; // Leave 2px padding top/bottom\n    const color = this.getElementTypeColor();\n\n    ctx.fillStyle = color;\n    ctx.globalAlpha = 0.8;\n    ctx.beginPath();\n\n    // Draw top half (max values) left to right\n    const pixelsPerSample = width / sampleCount;\n\n    for (let i = 0; i <= sampleCount; i++) {\n      const sampleIndex = startSample + i;\n      const peakIndex = sampleIndex * 2;\n\n      // Clamp to valid range\n      if (peakIndex + 1 >= peaks.length) break;\n\n      const maxValue = peaks[peakIndex + 1] ?? 0;\n      const px = x + i * pixelsPerSample;\n      const py = centerY - maxValue * halfHeight;\n\n      if (i === 0) {\n        ctx.moveTo(px, py);\n      } else {\n        ctx.lineTo(px, py);\n      }\n    }\n\n    // Draw bottom half (min values) right to left\n    for (let i = sampleCount; i >= 0; i--) {\n      const sampleIndex = startSample + i;\n      const peakIndex = sampleIndex * 2;\n\n      // Clamp to valid range\n      if (peakIndex >= peaks.length) continue;\n\n      const minValue = peaks[peakIndex] ?? 0;\n      const px = x + i * pixelsPerSample;\n      const py = centerY - minValue * halfHeight;\n\n      ctx.lineTo(px, py);\n    }\n\n    ctx.closePath();\n    ctx.fill();\n\n    // Draw center line\n    ctx.globalAlpha = 0.3;\n    ctx.strokeStyle = color;\n    ctx.lineWidth = 1;\n    ctx.beginPath();\n    ctx.moveTo(x, centerY);\n    ctx.lineTo(x + width, centerY);\n    ctx.stroke();\n\n    ctx.globalAlpha = 1;\n  }\n\n  connectedCallback(): void {\n    super.connectedCallback();\n\n    // Start loading waveform data\n    this.#loadWaveformData();\n\n    // Observe size changes\n    this.#resizeObserver = new ResizeObserver((entries) => {\n      for (const entry of entries) {\n        this.#hostHeight =\n          entry.borderBoxSize?.[0]?.blockSize ?? entry.contentRect.height;\n        this.#scheduleRender();\n      }\n    });\n  }\n\n  disconnectedCallback(): void {\n    super.disconnectedCallback();\n    this.#abortController?.abort();\n    this.#resizeObserver?.disconnect();\n  }\n\n  updated(changedProperties: Map<string | number | symbol, unknown>): void {\n    super.updated(changedProperties);\n\n    // Check if we need to reload waveform data\n    const audio = this.element as EFAudio;\n    if (audio?.src !== this.#lastSrc) {\n      this.#loadWaveformData();\n    }\n\n    // Re-render when timeline state changes (scroll, zoom)\n    if (changedProperties.has(\"_timelineState\")) {\n      this.#scheduleRender();\n    }\n\n    // Attach resize observer to track container once rendered\n    if (this.canvasRef.value && this.#resizeObserver) {\n      const container = this.canvasRef.value.parentElement;\n      if (container) {\n        this.#resizeObserver.disconnect();\n        this.#resizeObserver.observe(container);\n      }\n    }\n\n    // Always schedule render after update to catch any changes\n    this.#scheduleRender();\n  }\n\n  contents() {\n    const audio = this.element as EFAudio;\n    if (!(audio instanceof EFAudio)) {\n      return nothing;\n    }\n\n    const durationMs = audio.durationMs ?? 0;\n    if (durationMs === 0) {\n      return nothing;\n    }\n\n    // Show loading placeholder if no waveform data yet\n    if (!this._waveformData) {\n      return this.#renderPlaceholder();\n    }\n\n    // The host fills the track container, canvas is positioned within it\n    return html`\n      <div class=\"waveform-host\">\n        <canvas ${ref(this.canvasRef)} class=\"waveform-canvas\"></canvas>\n      </div>\n    `;\n  }\n\n  #renderPlaceholder() {\n    return html`<div\n      class=\"shimmer-placeholder ${this._isLoading ? \"is-loading\" : \"\"}\"\n    ></div>`;\n  }\n}\n"],"mappings":";;;;;;;;;;;;AAaA,MAAM,4BAA4B;AAG3B,yBAAMA,uBAAqB,UAAU;;;mBA4C9B,WAA8B;uBAQG;oBAGxB;;;gBAtDL,CACd,GAAG,UAAU,QACb,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;MAuCJ;;CAeD,WAA0B;CAC1B,mBAA2C;CAC3C;CACA,mBAAmB;CACnB,cAAc;;;;CAKd,OAAMC,mBAAmC;EACvC,MAAM,QAAQ,KAAK;EACnB,MAAM,MAAM,OAAO;AAGnB,MAAI,CAAC,OAAO,QAAQ,MAAKC,QACvB;AAGF,QAAKA,UAAW;AAGhB,QAAKC,iBAAkB,OAAO;AAC9B,QAAKA,kBAAmB,IAAI,iBAAiB;AAE7C,OAAK,aAAa;AAElB,MAAI;GACF,MAAM,eAAe,MAAM,oBACzB,OACA,MAAKA,gBAAiB,OACvB;AAED,OAAI,cAAc;AAChB,SAAK,gBAAgB;AACrB,UAAKC,gBAAiB;;WAEjB,OAAO;AACd,OAAI,EAAE,iBAAiB,gBAAgB,MAAM,SAAS,cACpD,SAAQ,KAAK,iCAAiC,MAAM;YAE9C;AACR,QAAK,aAAa;;;;;;CAOtB,kBAAwB;AACtB,MAAI,MAAKC,gBAAkB;AAC3B,QAAKA,kBAAmB;AAExB,8BAA4B;AAC1B,SAAKA,kBAAmB;AACxB,SAAKC,gBAAiB;IACtB;;;;;CAMJ,wBAMS;EACP,MAAM,QAAQ,KAAK;EACnB,MAAM,aAAa,MAAM,cAAc;AACvC,MAAI,eAAe,EAAG,QAAO;EAE7B,MAAM,cAAc,KAAK,gBAAgB,eAAe,KAAK;EAC7D,MAAM,eAAe,aAAa;AAUlC,SAAO;GACL,eARmB,MAAM,eAAe,KACN;GAQlC;GACA,oBANyB,KAAK,gBAAgB,sBAAsB;GAOpE,eANoB,KAAK,gBAAgB,iBAAiB;GAO1D;GACD;;;;;;;;;;;CAYH,kBAAwB;EACtB,MAAM,SAAS,KAAK,UAAU;EAC9B,MAAM,eAAe,KAAK;AAE1B,MAAI,CAAC,UAAU,CAAC,aAAc;EAE9B,MAAM,eAAe,MAAKC,sBAAuB;AACjD,MAAI,CAAC,aAAc;EAEnB,MAAM,EACJ,cACA,cACA,oBACA,eACA,gBACE;EAGJ,MAAM,gBAAgB,qBAAqB;EAC3C,MAAM,iBACJ,qBAAqB,gBAAgB;AAMvC,MAHmB,eAAe,eAGjB,iBAAiB,eAAe,gBAAgB;AAE/D,UAAO,MAAM,UAAU;AACvB;;AAEF,SAAO,MAAM,UAAU;EAIvB,MAAM,sBAAsB,KAAK,IAAI,GAAG,gBAAgB,aAAa;EACrE,MAAM,oBAAoB,KAAK,IAC7B,cACA,iBAAiB,aAClB;EACD,MAAM,iBAAiB,oBAAoB;AAE3C,MAAI,kBAAkB,EAAG;EAEzB,MAAM,SAAS,MAAKC,cAAe;EAGnC,MAAM,MAAM,OAAO,oBAAoB;EACvC,MAAM,cAAc,KAAK,KAAK,iBAAiB,IAAI;EACnD,MAAM,eAAe,KAAK,KAAK,SAAS,IAAI;AAE5C,MAAI,OAAO,UAAU,eAAe,OAAO,WAAW,cAAc;AAClE,UAAO,QAAQ;AACf,UAAO,SAAS;;AAIlB,SAAO,MAAM,OAAO,GAAG,oBAAoB;AAC3C,SAAO,MAAM,QAAQ,GAAG,eAAe;AACvC,SAAO,MAAM,SAAS,GAAG,OAAO;EAEhC,MAAM,MAAM,OAAO,WAAW,KAAK;AACnC,MAAI,CAAC,IAAK;AAEV,MAAI,aAAa,KAAK,GAAG,GAAG,KAAK,GAAG,EAAE;AACtC,MAAI,UAAU,GAAG,GAAG,gBAAgB,OAAO;EAI3C,MAAM,aADQ,KAAK,QACM,iBAAiB;EAG1C,MAAM,cAAc,aAAa,sBAAsB;EACvD,MAAM,YAAY,aAAa,oBAAoB;AAGnD,QAAKC,mBACH,KACA,cACA,GACA,gBACA,QACA,aACA,UACD;;;;;CAMH,oBACE,KACA,cACA,GACA,OACA,QACA,SACA,OACM;EACN,MAAM,EAAE,OAAO,qBAAqB;EAGpC,MAAM,cAAc,KAAK,MAAO,UAAU,MAAQ,iBAAiB;EAEnE,MAAM,cADY,KAAK,KAAM,QAAQ,MAAQ,iBAAiB,GAC9B;AAEhC,MAAI,eAAe,KAAK,SAAS,EAAG;EAEpC,MAAM,UAAU,SAAS;EACzB,MAAM,aAAa,SAAS,IAAI;EAChC,MAAM,QAAQ,KAAK,qBAAqB;AAExC,MAAI,YAAY;AAChB,MAAI,cAAc;AAClB,MAAI,WAAW;EAGf,MAAM,kBAAkB,QAAQ;AAEhC,OAAK,IAAI,IAAI,GAAG,KAAK,aAAa,KAAK;GAErC,MAAM,aADc,cAAc,KACF;AAGhC,OAAI,YAAY,KAAK,MAAM,OAAQ;GAEnC,MAAM,WAAW,MAAM,YAAY,MAAM;GACzC,MAAM,KAAK,IAAI,IAAI;GACnB,MAAM,KAAK,UAAU,WAAW;AAEhC,OAAI,MAAM,EACR,KAAI,OAAO,IAAI,GAAG;OAElB,KAAI,OAAO,IAAI,GAAG;;AAKtB,OAAK,IAAI,IAAI,aAAa,KAAK,GAAG,KAAK;GAErC,MAAM,aADc,cAAc,KACF;AAGhC,OAAI,aAAa,MAAM,OAAQ;GAE/B,MAAM,WAAW,MAAM,cAAc;GACrC,MAAM,KAAK,IAAI,IAAI;GACnB,MAAM,KAAK,UAAU,WAAW;AAEhC,OAAI,OAAO,IAAI,GAAG;;AAGpB,MAAI,WAAW;AACf,MAAI,MAAM;AAGV,MAAI,cAAc;AAClB,MAAI,cAAc;AAClB,MAAI,YAAY;AAChB,MAAI,WAAW;AACf,MAAI,OAAO,GAAG,QAAQ;AACtB,MAAI,OAAO,IAAI,OAAO,QAAQ;AAC9B,MAAI,QAAQ;AAEZ,MAAI,cAAc;;CAGpB,oBAA0B;AACxB,QAAM,mBAAmB;AAGzB,QAAKR,kBAAmB;AAGxB,QAAKS,iBAAkB,IAAI,gBAAgB,YAAY;AACrD,QAAK,MAAM,SAAS,SAAS;AAC3B,UAAKF,aACH,MAAM,gBAAgB,IAAI,aAAa,MAAM,YAAY;AAC3D,UAAKJ,gBAAiB;;IAExB;;CAGJ,uBAA6B;AAC3B,QAAM,sBAAsB;AAC5B,QAAKD,iBAAkB,OAAO;AAC9B,QAAKO,gBAAiB,YAAY;;CAGpC,QAAQ,mBAAiE;AACvE,QAAM,QAAQ,kBAAkB;AAIhC,MADc,KAAK,SACR,QAAQ,MAAKR,QACtB,OAAKD,kBAAmB;AAI1B,MAAI,kBAAkB,IAAI,iBAAiB,CACzC,OAAKG,gBAAiB;AAIxB,MAAI,KAAK,UAAU,SAAS,MAAKM,gBAAiB;GAChD,MAAM,YAAY,KAAK,UAAU,MAAM;AACvC,OAAI,WAAW;AACb,UAAKA,eAAgB,YAAY;AACjC,UAAKA,eAAgB,QAAQ,UAAU;;;AAK3C,QAAKN,gBAAiB;;CAGxB,WAAW;EACT,MAAM,QAAQ,KAAK;AACnB,MAAI,EAAE,iBAAiB,SACrB,QAAO;AAIT,OADmB,MAAM,cAAc,OACpB,EACjB,QAAO;AAIT,MAAI,CAAC,KAAK,cACR,QAAO,MAAKO,mBAAoB;AAIlC,SAAO,IAAI;;kBAEG,IAAI,KAAK,UAAU,CAAC;;;;CAKpC,qBAAqB;AACnB,SAAO,IAAI;mCACoB,KAAK,aAAa,eAAe,GAAG;;;;YAjWpE,QAAQ;CAAE,SAAS;CAAsB,WAAW;CAAM,CAAC,EAC3D,OAAO;YAGP,OAAO;YAGP,OAAO;2BAvDT,cAAc,iBAAiB"}

package/dist/gui/timeline/tracks/EFThumbnailStrip.d.ts

@@ -32,6 +32,7 @@ declare class EFThumbnailStrip extends EFThumbnailStrip_base {
     width: number;
     height: number;
   };
+  _isLoadingThumbnails: boolean;
   /**
    * Check if target is valid (EFVideo or root EFTimegroup)
    */

package/dist/gui/timeline/tracks/EFThumbnailStrip.js

@@ -61,6 +61,7 @@ let EFThumbnailStrip = class EFThumbnailStrip$1 extends TWMixin(LitElement) {
 			width: 0,
 			height: 0
 		};
+		this._isLoadingThumbnails = false;
 	}
 	static {
 		this.styles = [css`
@@ -96,6 +97,30 @@ let EFThumbnailStrip = class EFThumbnailStrip$1 extends TWMixin(LitElement) {
         image-rendering: pixelated;
         image-rendering: crisp-edges;
       }
+
+      .shimmer-overlay {
+        display: none;
+        position: absolute;
+        inset: 0;
+        background: linear-gradient(
+          90deg,
+          color-mix(in srgb, var(--ef-color-text, #fafafa) 12%, transparent) 0%,
+          color-mix(in srgb, var(--ef-color-text, #fafafa) 28%, transparent) 50%,
+          color-mix(in srgb, var(--ef-color-text, #fafafa) 12%, transparent) 100%
+        );
+        background-size: 200% 100%;
+        pointer-events: none;
+      }
+
+      .shimmer-overlay.active {
+        display: block;
+        animation: shimmer-strip var(--ef-loading-shimmer-duration, 1.5s) linear infinite;
+      }
+
+      @keyframes shimmer-strip {
+        0% { background-position: 200% 0; }
+        100% { background-position: -200% 0; }
+      }
     `];
 	}
 	#targetController;
@@ -328,6 +353,8 @@ let EFThumbnailStrip = class EFThumbnailStrip$1 extends TWMixin(LitElement) {
 			return { canvas: canvas ?? null };
 		});
 		this.#drawThumbnails(visibleThumbnails, results);
+		const hasEmptySlots = results.some((r) => r.canvas === null);
+		if (this._isLoadingThumbnails !== hasEmptySlots) this._isLoadingThumbnails = hasEmptySlots;
 	}
 	/**
 	* Update video thumbnail capture
@@ -343,9 +370,9 @@ let EFThumbnailStrip = class EFThumbnailStrip$1 extends TWMixin(LitElement) {
 		if (!mediaEngine) return;
 		const sourceTimestamps = uncached.map((t) => this.#getSourceTimeMs(t));
 		const extractor = new ThumbnailExtractor(mediaEngine);
-		const scrubRendition = mediaEngine.videoRendition;
-		if (!scrubRendition) return;
-		const results = await extractor.extractThumbnails(sourceTimestamps, scrubRendition, video.durationMs ?? 0, signal);
+		const videoTrack = mediaEngine.tracks.video ?? mediaEngine.tracks.scrub;
+		if (!videoTrack) return;
+		const results = await extractor.extractThumbnails(sourceTimestamps, videoTrack, video.durationMs ?? 0, signal);
 		for (let i = 0; i < uncached.length; i++) {
 			const thumbnail = results[i]?.thumbnail;
 			const timestamp = uncached[i];
@@ -555,11 +582,16 @@ let EFThumbnailStrip = class EFThumbnailStrip$1 extends TWMixin(LitElement) {
 		if (!this.isValidTarget) return html`<div class="error-message">
         Invalid target: "${this.targetElement.tagName?.toLowerCase() || "unknown"}" must be ef-video or root ef-timegroup
       </div>`;
-		return html`<div 
-      class="thumbnail-container" 
-      style="max-width: ${this.#effectiveDurationMs * this.#effectivePixelsPerMs}px;"
-      ${ref(this.#canvasContainer)}
-    ></div>`;
+		return html`
+      <div
+        class="thumbnail-container"
+        style="max-width: ${this.#effectiveDurationMs * this.#effectivePixelsPerMs}px;"
+        ${ref(this.#canvasContainer)}
+      ></div>
+      <div
+        class="shimmer-overlay ${this._isLoadingThumbnails ? "active" : ""}"
+      ></div>
+    `;
 	}
 };
 __decorate([property({ type: String })], EFThumbnailStrip.prototype, "target", void 0);
@@ -589,6 +621,7 @@ __decorate([consume({
 	subscribe: true
 }), state()], EFThumbnailStrip.prototype, "previewSettings", void 0);
 __decorate([state()], EFThumbnailStrip.prototype, "thumbnailDimensions", void 0);
+__decorate([state()], EFThumbnailStrip.prototype, "_isLoadingThumbnails", void 0);
 EFThumbnailStrip = __decorate([customElement("ef-thumbnail-strip")], EFThumbnailStrip);
 
 //#endregion