@mieweb/ui 0.11.0-dev.35 → 0.11.0-dev.37

package/dist/{chunk-QHCAWDMG.cjs → chunk-HDZQLTBP.cjs}

@@ -74,6 +74,7 @@ function useMediaTransport(options = {}) {
     };
     const onDurationChange = () => setDurationMs(toMs(element.duration));
     const onTimeUpdateEvt = () => emitTime();
+    const onRateChange = () => setPlaybackRateState(element.playbackRate);
     const onPlay = () => setState("playing");
     const onPlaying = () => setState("playing");
     const onPause = () => setState("paused");
@@ -96,6 +97,7 @@ function useMediaTransport(options = {}) {
     element.addEventListener("loadedmetadata", onLoadedMetadata);
     element.addEventListener("durationchange", onDurationChange);
     element.addEventListener("timeupdate", onTimeUpdateEvt);
+    element.addEventListener("ratechange", onRateChange);
     element.addEventListener("play", onPlay);
     element.addEventListener("playing", onPlaying);
     element.addEventListener("pause", onPause);
@@ -110,6 +112,7 @@ function useMediaTransport(options = {}) {
       element.removeEventListener("loadedmetadata", onLoadedMetadata);
       element.removeEventListener("durationchange", onDurationChange);
       element.removeEventListener("timeupdate", onTimeUpdateEvt);
+      element.removeEventListener("ratechange", onRateChange);
       element.removeEventListener("play", onPlay);
       element.removeEventListener("playing", onPlaying);
       element.removeEventListener("pause", onPause);
@@ -129,7 +132,8 @@ function useMediaTransport(options = {}) {
   const togglePlay = react.useCallback(() => {
     const el = elementRef.current;
     if (!el) return;
-    if (el.paused) void el.play();
+    if (el.paused) void el.play()?.catch(() => {
+    });
     else el.pause();
   }, []);
   const seekToMs = react.useCallback((timeMs) => {
@@ -173,5 +177,5 @@ function useMediaTransport(options = {}) {
 }
 
 exports.useMediaTransport = useMediaTransport;
-//# sourceMappingURL=chunk-QHCAWDMG.cjs.map
-//# sourceMappingURL=chunk-QHCAWDMG.cjs.map
+//# sourceMappingURL=chunk-HDZQLTBP.cjs.map
+//# sourceMappingURL=chunk-HDZQLTBP.cjs.map

package/dist/chunk-HDZQLTBP.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/hooks/useMediaTransport.ts"],"names":["useState","useRef","useCallback","useEffect"],"mappings":"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","file":"chunk-HDZQLTBP.cjs","sourcesContent":["import { useCallback, useEffect, useRef, useState } from 'react';\n\n// =============================================================================\n// Types\n// =============================================================================\n\nexport type MediaTransportState =\n  | 'idle'\n  | 'loading'\n  | 'playing'\n  | 'paused'\n  | 'error';\n\nexport interface UseMediaTransportOptions {\n  /** Fired on every native `timeupdate` and on metadata load, in milliseconds. */\n  onTimeUpdate?: (currentTimeMs: number, durationMs: number) => void;\n  /** Fired whenever the derived transport state changes. */\n  onStateChange?: (state: MediaTransportState) => void;\n  /** Fired when playback reaches the end. */\n  onEnded?: () => void;\n  /** Fired on a media error, with a descriptive Error. */\n  onError?: (error: Error) => void;\n  /** Initial playback rate (default `1`). Kept in sync with the element. */\n  initialRate?: number;\n  /** Transport state to enter when playback ends (default `'paused'`). */\n  endedState?: Extract<MediaTransportState, 'idle' | 'paused'>;\n  /** Reset the position to `0` when playback ends (default `false`). */\n  resetTimeOnEnd?: boolean;\n  /** Human-readable label used in the error message (default `'media'`). */\n  errorLabel?: string;\n}\n\nexport interface UseMediaTransportReturn {\n  /**\n   * Callback ref for the `<audio>`/`<video>` element to control. Pass this to\n   * the element's `ref` (or call it imperatively). Transport listeners attach\n   * when an element mounts and detach when it unmounts.\n   */\n  setMediaElement: (element: HTMLMediaElement | null) => void;\n  /** The currently attached media element, or `null`. */\n  mediaElement: HTMLMediaElement | null;\n\n  /** Derived transport state. */\n  state: MediaTransportState;\n  /** Current playback position in milliseconds. */\n  currentTimeMs: number;\n  /** Media duration in milliseconds (`0` until known / non-finite). */\n  durationMs: number;\n  /** Current playback rate. */\n  playbackRate: number;\n  /** `true` while `state === 'playing'`. */\n  isPlaying: boolean;\n  /** `true` while `state === 'loading'`. */\n  isLoading: boolean;\n\n  /** Start playback. */\n  play: () => void;\n  /** Pause playback. */\n  pause: () => void;\n  /** Toggle between play and pause. */\n  togglePlay: () => void;\n  /** Seek to a position in milliseconds. */\n  seekToMs: (timeMs: number) => void;\n  /** Set the playback rate multiplier. */\n  setPlaybackRate: (rate: number) => void;\n  /** Read the current position in milliseconds. */\n  getCurrentTimeMs: () => number;\n  /** Read the duration in milliseconds (`0` when unknown). */\n  getDurationMs: () => number;\n  /** Whether playback is currently paused (reads the element directly). */\n  isPaused: () => boolean;\n}\n\n// =============================================================================\n// Helpers\n// =============================================================================\n\nconst toMs = (seconds: number): number =>\n  Number.isFinite(seconds) ? seconds * 1000 : 0;\n\n// =============================================================================\n// Hook\n// =============================================================================\n\n/**\n * Headless playback transport for a native `HTMLMediaElement`.\n *\n * Owns the derived transport state (idle/loading/playing/paused/error),\n * position, duration and playback rate, and exposes imperative controls — all\n * in **milliseconds**. It never creates or renders an element: pass the\n * returned {@link UseMediaTransportReturn.setMediaElement} callback to an\n * `<audio>`/`<video>` `ref` and the hook wires the native listeners.\n *\n * Shared by `MediaPlayer` (ms API) and TranscriptPlayer's `usePlayback` (seconds,\n * converted at the boundary). The WaveSurfer waveform variant is\n * out of scope; this hook targets native media transport only.\n *\n * @example\n * ```tsx\n * function Player({ src }: { src: string }) {\n *   const t = useMediaTransport({ onEnded: () => console.log('done') });\n *   return (\n *     <div>\n *       <video ref={t.setMediaElement} src={src} controls />\n *       <button onClick={t.togglePlay}>{t.isPlaying ? 'Pause' : 'Play'}</button>\n *     </div>\n *   );\n * }\n * ```\n */\nexport function useMediaTransport(\n  options: UseMediaTransportOptions = {}\n): UseMediaTransportReturn {\n  const {\n    onTimeUpdate,\n    onStateChange,\n    onEnded,\n    onError,\n    initialRate = 1,\n    endedState = 'paused',\n    resetTimeOnEnd = false,\n    errorLabel = 'media',\n  } = options;\n\n  const [element, setElementState] = useState<HTMLMediaElement | null>(null);\n  const [state, setStateRaw] = useState<MediaTransportState>('idle');\n  const stateRef = useRef<MediaTransportState>('idle');\n  const [currentTimeMs, setCurrentTimeMs] = useState(0);\n  const [durationMs, setDurationMs] = useState(0);\n  const [playbackRate, setPlaybackRateState] = useState(initialRate);\n\n  const elementRef = useRef<HTMLMediaElement | null>(null);\n\n  // Keep the latest callbacks/options in a ref so the listener effect does not\n  // re-subscribe on every render when callers pass inline functions.\n  const handlers = useRef({\n    onTimeUpdate,\n    onStateChange,\n    onEnded,\n    onError,\n    endedState,\n    resetTimeOnEnd,\n    errorLabel,\n  });\n  handlers.current = {\n    onTimeUpdate,\n    onStateChange,\n    onEnded,\n    onError,\n    endedState,\n    resetTimeOnEnd,\n    errorLabel,\n  };\n\n  const setState = useCallback((next: MediaTransportState) => {\n    if (stateRef.current === next) return;\n    stateRef.current = next;\n    setStateRaw(next);\n    // Consumers often update parent state here. Keep that notification outside\n    // React's state updater, which may run during render or twice in StrictMode.\n    handlers.current.onStateChange?.(next);\n  }, []);\n\n  const setMediaElement = useCallback((el: HTMLMediaElement | null) => {\n    elementRef.current = el;\n    setElementState(el);\n  }, []);\n\n  // Attach native transport listeners whenever an element mounts.\n  useEffect(() => {\n    if (!element) {\n      // A detached element (e.g. the source was removed) leaves nothing playing or loaded;\n      // an error stays visible to hosts that swap the element for an error panel.\n      if (stateRef.current !== 'error') setState('idle');\n      setDurationMs(0);\n      setCurrentTimeMs(0);\n      return;\n    }\n\n    const emitTime = () => {\n      const ms = toMs(element.currentTime);\n      const dur = toMs(element.duration);\n      setCurrentTimeMs(ms);\n      handlers.current.onTimeUpdate?.(ms, dur);\n    };\n\n    const onLoadStart = () => setState('loading');\n    // canplay can also follow a seek mid-playback; only leave the loading state here.\n    const onCanPlay = () => {\n      if (stateRef.current === 'loading')\n        setState(element.paused ? 'idle' : 'playing');\n    };\n    const onLoadedMetadata = () => {\n      setDurationMs(toMs(element.duration));\n      emitTime();\n    };\n    // MediaRecorder webm often reports Infinity until the end is known.\n    const onDurationChange = () => setDurationMs(toMs(element.duration));\n    const onTimeUpdateEvt = () => emitTime();\n    // The speed can change outside these controls (iOS's own full screen player).\n    const onRateChange = () => setPlaybackRateState(element.playbackRate);\n    const onPlay = () => setState('playing');\n    const onPlaying = () => setState('playing');\n    const onPause = () => setState('paused');\n    const onEndedEvt = () => {\n      setState(handlers.current.endedState);\n      if (handlers.current.resetTimeOnEnd) {\n        element.currentTime = 0;\n        setCurrentTimeMs(0);\n      }\n      handlers.current.onEnded?.();\n    };\n    const onErrorEvt = () => {\n      setState('error');\n      handlers.current.onError?.(\n        new Error(`Failed to load ${handlers.current.errorLabel}`)\n      );\n    };\n\n    element.addEventListener('loadstart', onLoadStart);\n    element.addEventListener('canplay', onCanPlay);\n    element.addEventListener('loadedmetadata', onLoadedMetadata);\n    element.addEventListener('durationchange', onDurationChange);\n    element.addEventListener('timeupdate', onTimeUpdateEvt);\n    element.addEventListener('ratechange', onRateChange);\n    element.addEventListener('play', onPlay);\n    element.addEventListener('playing', onPlaying);\n    element.addEventListener('pause', onPause);\n    element.addEventListener('ended', onEndedEvt);\n    element.addEventListener('error', onErrorEvt);\n\n    // Sync on attach; a new element must not inherit the previous one's duration or play state.\n    setDurationMs(toMs(element.duration));\n    if (element.paused && stateRef.current === 'playing') setState('paused');\n    // e.g. a 404 that failed before hydration attached these listeners.\n    if (element.error) onErrorEvt();\n\n    return () => {\n      element.removeEventListener('loadstart', onLoadStart);\n      element.removeEventListener('canplay', onCanPlay);\n      element.removeEventListener('loadedmetadata', onLoadedMetadata);\n      element.removeEventListener('durationchange', onDurationChange);\n      element.removeEventListener('timeupdate', onTimeUpdateEvt);\n      element.removeEventListener('ratechange', onRateChange);\n      element.removeEventListener('play', onPlay);\n      element.removeEventListener('playing', onPlaying);\n      element.removeEventListener('pause', onPause);\n      element.removeEventListener('ended', onEndedEvt);\n      element.removeEventListener('error', onErrorEvt);\n    };\n  }, [element, setState]);\n\n  // Keep the element's playback rate in sync with hook state.\n  useEffect(() => {\n    if (element) element.playbackRate = playbackRate;\n  }, [element, playbackRate]);\n\n  const play = useCallback(() => {\n    void elementRef.current?.play();\n  }, []);\n\n  const pause = useCallback(() => {\n    elementRef.current?.pause();\n  }, []);\n\n  const togglePlay = useCallback(() => {\n    const el = elementRef.current;\n    if (!el) return;\n    // A refused start (autoplay policy) leaves it paused; nothing to report.\n    if (el.paused) void el.play()?.catch(() => {});\n    else el.pause();\n  }, []);\n\n  const seekToMs = useCallback((timeMs: number) => {\n    const el = elementRef.current;\n    if (el) {\n      el.currentTime = timeMs / 1000;\n      setCurrentTimeMs(timeMs);\n    }\n  }, []);\n\n  const setPlaybackRate = useCallback((rate: number) => {\n    setPlaybackRateState(rate);\n    if (elementRef.current) elementRef.current.playbackRate = rate;\n  }, []);\n\n  const getCurrentTimeMs = useCallback(\n    () => toMs(elementRef.current?.currentTime ?? 0),\n    []\n  );\n\n  const getDurationMs = useCallback(\n    () => toMs(elementRef.current?.duration ?? 0),\n    []\n  );\n\n  const isPaused = useCallback(() => elementRef.current?.paused ?? true, []);\n\n  return {\n    setMediaElement,\n    mediaElement: element,\n    state,\n    currentTimeMs,\n    durationMs,\n    playbackRate,\n    isPlaying: state === 'playing',\n    isLoading: state === 'loading',\n    play,\n    pause,\n    togglePlay,\n    seekToMs,\n    setPlaybackRate,\n    getCurrentTimeMs,\n    getDurationMs,\n    isPaused,\n  };\n}\n"]}