@ttt-productions/media-viewer 0.10.8 → 0.10.10

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-export type { AudioVisualizerMode, MediaViewerType, FallbackMode, BaseMediaProps, ImageViewerProps, VideoViewerProps, AudioViewerProps, MediaPreviewProps, MediaViewerProps, MediaPlaybackProps, MediaPlaybackControls, MediaDiagnosticAdapter, AssetStatusHint, DiagnosisResult, RecoveryState, } from "./types.js";
+export type { AudioVisualizerMode, MediaViewerType, FallbackMode, BaseMediaProps, ImageViewerProps, VideoViewerProps, AudioViewerProps, MediaPreviewProps, MediaViewerProps, MediaPlaybackProps, MediaPlaybackControls, MediaProgressSampleReason, MediaDiagnosticAdapter, AssetStatusHint, DiagnosisResult, RecoveryState, } from "./types.js";
 export { BACKOFF_SCHEDULE_MS, MAX_RECOVERY_DURATION_MS, LOAD_WATCHDOG_MS, PHASE_MAX_WAIT_MS, applyJitter, backoffForAttempt, withinBudget, } from "./recovery.js";
 export { startWaveformLoop, drawIdleFrame } from "./visualizer.js";
 export type { StartWaveformLoopOptions } from "./visualizer.js";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,mBAAmB,EACnB,eAAe,EACf,YAAY,EACZ,cAAc,EACd,gBAAgB,EAChB,gBAAgB,EAChB,gBAAgB,EAChB,iBAAiB,EACjB,gBAAgB,EAChB,kBAAkB,EAClB,qBAAqB,EACrB,sBAAsB,EACtB,eAAe,EACf,eAAe,EACf,aAAa,GACd,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,mBAAmB,EACnB,wBAAwB,EACxB,gBAAgB,EAChB,iBAAiB,EACjB,WAAW,EACX,iBAAiB,EACjB,YAAY,GACb,MAAM,eAAe,CAAC;AAEvB,OAAO,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AACnE,YAAY,EAAE,wBAAwB,EAAE,MAAM,iBAAiB,CAAC;AAEhE,OAAO,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,mBAAmB,EACnB,eAAe,EACf,YAAY,EACZ,cAAc,EACd,gBAAgB,EAChB,gBAAgB,EAChB,gBAAgB,EAChB,iBAAiB,EACjB,gBAAgB,EAChB,kBAAkB,EAClB,qBAAqB,EACrB,yBAAyB,EACzB,sBAAsB,EACtB,eAAe,EACf,eAAe,EACf,aAAa,GACd,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,mBAAmB,EACnB,wBAAwB,EACxB,gBAAgB,EAChB,iBAAiB,EACjB,WAAW,EACX,iBAAiB,EACjB,YAAY,GACb,MAAM,eAAe,CAAC;AAEvB,OAAO,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AACnE,YAAY,EAAE,wBAAwB,EAAE,MAAM,iBAAiB,CAAC;AAEhE,OAAO,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAkBA,OAAO,EACL,mBAAmB,EACnB,wBAAwB,EACxB,gBAAgB,EAChB,iBAAiB,EACjB,WAAW,EACX,iBAAiB,EACjB,YAAY,GACb,MAAM,eAAe,CAAC;AAEvB,OAAO,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAGnE,OAAO,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAC","sourcesContent":["export type {\n  AudioVisualizerMode,\n  MediaViewerType,\n  FallbackMode,\n  BaseMediaProps,\n  ImageViewerProps,\n  VideoViewerProps,\n  AudioViewerProps,\n  MediaPreviewProps,\n  MediaViewerProps,\n  MediaPlaybackProps,\n  MediaPlaybackControls,\n  MediaDiagnosticAdapter,\n  AssetStatusHint,\n  DiagnosisResult,\n  RecoveryState,\n} from \"./types.js\";\n\nexport {\n  BACKOFF_SCHEDULE_MS,\n  MAX_RECOVERY_DURATION_MS,\n  LOAD_WATCHDOG_MS,\n  PHASE_MAX_WAIT_MS,\n  applyJitter,\n  backoffForAttempt,\n  withinBudget,\n} from \"./recovery.js\";\n\nexport { startWaveformLoop, drawIdleFrame } from \"./visualizer.js\";\nexport type { StartWaveformLoopOptions } from \"./visualizer.js\";\n\nexport { resolveInfiniteDuration } from \"./media-duration.js\";\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAmBA,OAAO,EACL,mBAAmB,EACnB,wBAAwB,EACxB,gBAAgB,EAChB,iBAAiB,EACjB,WAAW,EACX,iBAAiB,EACjB,YAAY,GACb,MAAM,eAAe,CAAC;AAEvB,OAAO,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAGnE,OAAO,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAC","sourcesContent":["export type {\n  AudioVisualizerMode,\n  MediaViewerType,\n  FallbackMode,\n  BaseMediaProps,\n  ImageViewerProps,\n  VideoViewerProps,\n  AudioViewerProps,\n  MediaPreviewProps,\n  MediaViewerProps,\n  MediaPlaybackProps,\n  MediaPlaybackControls,\n  MediaProgressSampleReason,\n  MediaDiagnosticAdapter,\n  AssetStatusHint,\n  DiagnosisResult,\n  RecoveryState,\n} from \"./types.js\";\n\nexport {\n  BACKOFF_SCHEDULE_MS,\n  MAX_RECOVERY_DURATION_MS,\n  LOAD_WATCHDOG_MS,\n  PHASE_MAX_WAIT_MS,\n  applyJitter,\n  backoffForAttempt,\n  withinBudget,\n} from \"./recovery.js\";\n\nexport { startWaveformLoop, drawIdleFrame } from \"./visualizer.js\";\nexport type { StartWaveformLoopOptions } from \"./visualizer.js\";\n\nexport { resolveInfiniteDuration } from \"./media-duration.js\";\n"]}

package/dist/react/index.d.ts

@@ -7,6 +7,6 @@ export type { AudioPlayerProps } from "./audio-player.js";
 export { MediaFallbackLink, shouldShowFallback, EmptyFallback, ErrorFallback } from "./fallback.js";
 export { useMediaRecovery } from "./use-media-recovery.js";
 export type { UseMediaRecoveryOptions, UseMediaRecoveryResult } from "./use-media-recovery.js";
-export { useMediaPlayback, PROGRESS_SAMPLE_INTERVAL_MS } from "./use-media-playback.js";
+export { useMediaPlayback, PROGRESS_SAMPLE_INTERVAL_MS, LATE_RESUME_ADOPT_WINDOW_SEC, } from "./use-media-playback.js";
 export type { UseMediaPlaybackResult } from "./use-media-playback.js";
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/react/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAC9D,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,YAAY,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAC1D,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AACpG,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,YAAY,EAAE,uBAAuB,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AAC/F,OAAO,EAAE,gBAAgB,EAAE,2BAA2B,EAAE,MAAM,yBAAyB,CAAC;AACxF,YAAY,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/react/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAC9D,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,YAAY,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAC1D,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AACpG,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,YAAY,EAAE,uBAAuB,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AAC/F,OAAO,EACL,gBAAgB,EAChB,2BAA2B,EAC3B,4BAA4B,GAC7B,MAAM,yBAAyB,CAAC;AACjC,YAAY,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC"}

package/dist/react/index.js

@@ -6,5 +6,5 @@ export { AudioViewer } from "./audio-viewer.js";
 export { AudioPlayer } from "./audio-player.js";
 export { MediaFallbackLink, shouldShowFallback, EmptyFallback, ErrorFallback } from "./fallback.js";
 export { useMediaRecovery } from "./use-media-recovery.js";
-export { useMediaPlayback, PROGRESS_SAMPLE_INTERVAL_MS } from "./use-media-playback.js";
+export { useMediaPlayback, PROGRESS_SAMPLE_INTERVAL_MS, LATE_RESUME_ADOPT_WINDOW_SEC, } from "./use-media-playback.js";
 //# sourceMappingURL=index.js.map

package/dist/react/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/react/index.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAC9D,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhD,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AACpG,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAE3D,OAAO,EAAE,gBAAgB,EAAE,2BAA2B,EAAE,MAAM,yBAAyB,CAAC","sourcesContent":["\"use client\";\n\nexport { MediaViewer, MediaPreview } from \"./media-viewer.js\";\nexport { ImageViewer } from \"./image-viewer.js\";\nexport { VideoViewer } from \"./video-viewer.js\";\nexport { AudioViewer } from \"./audio-viewer.js\";\nexport { AudioPlayer } from \"./audio-player.js\";\nexport type { AudioPlayerProps } from \"./audio-player.js\";\nexport { MediaFallbackLink, shouldShowFallback, EmptyFallback, ErrorFallback } from \"./fallback.js\";\nexport { useMediaRecovery } from \"./use-media-recovery.js\";\nexport type { UseMediaRecoveryOptions, UseMediaRecoveryResult } from \"./use-media-recovery.js\";\nexport { useMediaPlayback, PROGRESS_SAMPLE_INTERVAL_MS } from \"./use-media-playback.js\";\nexport type { UseMediaPlaybackResult } from \"./use-media-playback.js\";\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/react/index.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAC9D,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhD,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AACpG,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAE3D,OAAO,EACL,gBAAgB,EAChB,2BAA2B,EAC3B,4BAA4B,GAC7B,MAAM,yBAAyB,CAAC","sourcesContent":["\"use client\";\n\nexport { MediaViewer, MediaPreview } from \"./media-viewer.js\";\nexport { ImageViewer } from \"./image-viewer.js\";\nexport { VideoViewer } from \"./video-viewer.js\";\nexport { AudioViewer } from \"./audio-viewer.js\";\nexport { AudioPlayer } from \"./audio-player.js\";\nexport type { AudioPlayerProps } from \"./audio-player.js\";\nexport { MediaFallbackLink, shouldShowFallback, EmptyFallback, ErrorFallback } from \"./fallback.js\";\nexport { useMediaRecovery } from \"./use-media-recovery.js\";\nexport type { UseMediaRecoveryOptions, UseMediaRecoveryResult } from \"./use-media-recovery.js\";\nexport {\n  useMediaPlayback,\n  PROGRESS_SAMPLE_INTERVAL_MS,\n  LATE_RESUME_ADOPT_WINDOW_SEC,\n} from \"./use-media-playback.js\";\nexport type { UseMediaPlaybackResult } from \"./use-media-playback.js\";\n"]}

package/dist/react/media-viewer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"media-viewer.d.ts","sourceRoot":"","sources":["../../src/react/media-viewer.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAI/B,OAAO,KAAK,EAAE,iBAAiB,EAAiC,MAAM,aAAa,CAAC;AA6GpF,wBAAgB,WAAW,CAAC,KAAK,EAAE,iBAAiB,4BAyOnD;AAED,wBAAwB;AACxB,eAAO,MAAM,YAAY,oBAAc,CAAC"}
+{"version":3,"file":"media-viewer.d.ts","sourceRoot":"","sources":["../../src/react/media-viewer.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAI/B,OAAO,KAAK,EAAE,iBAAiB,EAAiC,MAAM,aAAa,CAAC;AA6GpF,wBAAgB,WAAW,CAAC,KAAK,EAAE,iBAAiB,4BA2OnD;AAED,wBAAwB;AACxB,eAAO,MAAM,YAAY,oBAAc,CAAC"}

package/dist/react/media-viewer.js

@@ -59,7 +59,7 @@ function RecoveryOverlay({ state, onManualRetry, isCircular }) {
 // Main component
 // ---------------------------------------------------------------------------
 export function MediaViewer(props) {
-    const { url, alt, type, className, unloadOnExit, isCircular = false, priority, skeleton, lazy, controls, autoPlay, muted, loop, posterUrl, preload, autoPlayOnVisible, onLoad, onError, onLoadChange, onEnded, onProgressSample, startAtSeconds, endOverlay, playbackControlsRef, audioVisualizerMode, audioPersistKey, audioExtraActions, fallbackMode = "link", fallbackLabel, filename, mime, name, recoveryAdapter, assetStatusHint, loadTimeoutMs, } = props;
+    const { url, alt, type, className, unloadOnExit, isCircular = false, enableZoom, priority, skeleton, lazy, controls, autoPlay, muted, loop, posterUrl, preload, autoPlayOnVisible, onLoad, onError, onLoadChange, onEnded, onProgressSample, startAtSeconds, endOverlay, playbackControlsRef, audioVisualizerMode, audioPersistKey, audioExtraActions, fallbackMode = "link", fallbackLabel, filename, mime, name, recoveryAdapter, assetStatusHint, loadTimeoutMs, } = props;
     const [hasError, setHasError] = React.useState(false);
     const [sourceUrl, setSourceUrl] = React.useState(null);
     // Remount key: incrementing this causes child media elements to unmount and
@@ -138,7 +138,7 @@ export function MediaViewer(props) {
     }
     const t = inferType({ type, mime, name, url: sourceUrl });
     if (t === "image") {
-        return (_jsx("div", { className: className, style: wrapperStyle, children: _jsx(ImageViewer, { url: sourceUrl, alt: alt, lazy: lazy, priority: priority, skeleton: skeleton, unloadOnExit: unloadOnExit, isCircular: isCircular, loadTimeoutMs: loadTimeoutMs, onLoad: handleLoad, onError: handleError, fallback: _jsx(ErrorFallback, { isCircular: isCircular }) }, remountKey) }));
+        return (_jsx("div", { className: className, style: wrapperStyle, children: _jsx(ImageViewer, { url: sourceUrl, alt: alt, lazy: lazy, priority: priority, skeleton: skeleton, unloadOnExit: unloadOnExit, isCircular: isCircular, enableZoom: enableZoom, loadTimeoutMs: loadTimeoutMs, onLoad: handleLoad, onError: handleError, fallback: _jsx(ErrorFallback, { isCircular: isCircular }) }, remountKey) }));
     }
     if (t === "video") {
         return (_jsx("div", { className: className, style: wrapperStyle, children: _jsx(VideoViewer, { url: sourceUrl, lazy: lazy, priority: priority, skeleton: skeleton, unloadOnExit: unloadOnExit, controls: controls, autoPlay: autoPlay, muted: muted, loop: loop, posterUrl: posterUrl, preload: preload, autoPlayOnVisible: autoPlayOnVisible, loadTimeoutMs: loadTimeoutMs, onLoad: handleLoad, onError: handleError, onEnded: onEnded, onProgressSample: onProgressSample, startAtSeconds: startAtSeconds, endOverlay: endOverlay, playbackControlsRef: playbackControlsRef }, remountKey) }));

package/dist/react/media-viewer.js.map

@@ -1 +1 @@
-{"version":3,"file":"media-viewer.js","sourceRoot":"","sources":["../../src/react/media-viewer.tsx"],"names":[],"mappings":"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","sourcesContent":["import * as React from \"react\";\nimport { getSimplifiedMediaType } from \"@ttt-productions/media-schemas\";\nimport type { SimplifiedMediaType } from \"@ttt-productions/media-schemas\";\n\nimport type { MediaPreviewProps, MediaViewerType, FallbackMode } from \"../types.js\";\nimport { MediaFallbackLink, shouldShowFallback, EmptyFallback, ErrorFallback } from \"./fallback.js\";\nimport { ImageViewer } from \"./image-viewer.js\";\nimport { VideoViewer } from \"./video-viewer.js\";\nimport { AudioViewer } from \"./audio-viewer.js\";\nimport { useMediaRecovery } from \"./use-media-recovery.js\";\nimport type { RecoveryState } from \"../recovery.js\";\n\nfunction inferType(props: { type?: MediaPreviewProps[\"type\"]; mime?: string; name?: string; url?: string }): MediaViewerType {\n  if (props.type) {\n    // Handle MIME strings like \"image/png\" -> \"image\"\n    const primary = typeof props.type === \"string\" ? props.type.split(\"/\")[0] : props.type;\n    if (primary === \"image\" || primary === \"video\" || primary === \"audio\") return primary;\n    if (primary === \"other\") return \"other\";\n  }\n\n  const hint = props.mime ?? props.name ?? props.url;\n  if (!hint) return \"other\";\n  const simplified: SimplifiedMediaType = getSimplifiedMediaType(hint);\n  return simplified;\n}\n\n// ---------------------------------------------------------------------------\n// Recovery-phase UI helpers\n// ---------------------------------------------------------------------------\n\nfunction RecoveryOverlay({ state, onManualRetry, isCircular }: {\n  state: RecoveryState;\n  onManualRetry: () => void;\n  isCircular?: boolean;\n}) {\n  const wrapStyle: React.CSSProperties = {\n    display: \"flex\",\n    flexDirection: \"column\",\n    alignItems: \"center\",\n    justifyContent: \"center\",\n    width: \"100%\",\n    height: \"100%\",\n    gap: \"0.5rem\",\n    ...(isCircular ? { borderRadius: \"50%\" } : {}),\n  };\n\n  if (state.phase === \"processing\") {\n    return (\n      <div className=\"mv-recovery-processing\" style={wrapStyle}>\n        <span className=\"mv-recovery-label\">Processing media&hellip;</span>\n      </div>\n    );\n  }\n\n  if (state.phase === \"finalizing\") {\n    return (\n      <div className=\"mv-recovery-finalizing\" style={wrapStyle}>\n        <span className=\"mv-recovery-label\">Finishing media&hellip;</span>\n      </div>\n    );\n  }\n\n  if (state.phase === \"transient-retry\" || state.phase === \"propagating\") {\n    return (\n      <div className=\"mv-recovery-retrying\" style={wrapStyle}>\n        <span className=\"mv-recovery-label\">Loading&hellip;</span>\n      </div>\n    );\n  }\n\n  if (state.phase === \"auth-retry\") {\n    return (\n      <div className=\"mv-recovery-auth\" style={wrapStyle}>\n        <span className=\"mv-recovery-label\">Refreshing access&hellip;</span>\n      </div>\n    );\n  }\n\n  if (state.phase === \"hard-unavailable\") {\n    return (\n      <div className=\"mv-recovery-hard\" style={wrapStyle}>\n        <ErrorFallback isCircular={isCircular} />\n        {state.reason === \"auth\" ? (\n          <span className=\"mv-recovery-label\">Access denied.</span>\n        ) : (\n          <span className=\"mv-recovery-label\">Media unavailable.</span>\n        )}\n      </div>\n    );\n  }\n\n  if (state.phase === \"max-wait-fallback\") {\n    return (\n      <div className=\"mv-recovery-max-wait\" style={wrapStyle}>\n        <span className=\"mv-recovery-label\">This media is taking longer than expected.</span>\n        <button\n          type=\"button\"\n          className=\"mv-recovery-retry-btn\"\n          onClick={onManualRetry}\n        >\n          Retry\n        </button>\n      </div>\n    );\n  }\n\n  return null;\n}\n\n// ---------------------------------------------------------------------------\n// Main component\n// ---------------------------------------------------------------------------\n\nexport function MediaViewer(props: MediaPreviewProps) {\n  const {\n    url,\n    alt,\n    type,\n    className,\n    unloadOnExit,\n    isCircular = false,\n    priority,\n    skeleton,\n    lazy,\n    controls,\n    autoPlay,\n    muted,\n    loop,\n    posterUrl,\n    preload,\n    autoPlayOnVisible,\n    onLoad,\n    onError,\n    onLoadChange,\n    onEnded,\n    onProgressSample,\n    startAtSeconds,\n    endOverlay,\n    playbackControlsRef,\n    audioVisualizerMode,\n    audioPersistKey,\n    audioExtraActions,\n    fallbackMode = \"link\",\n    fallbackLabel,\n    filename,\n    mime,\n    name,\n    recoveryAdapter,\n    assetStatusHint,\n    loadTimeoutMs,\n  } = props;\n\n  const [hasError, setHasError] = React.useState(false);\n  const [sourceUrl, setSourceUrl] = React.useState<string | null>(null);\n\n  // Remount key: incrementing this causes child media elements to unmount and\n  // re-mount from scratch, re-issuing the HTTP request.\n  const [remountKey, setRemountKey] = React.useState(0);\n\n  const handleRemount = React.useCallback(() => {\n    setHasError(false);\n    setRemountKey((k) => k + 1);\n  }, []);\n\n  // Recovery hook (no-op when recoveryAdapter is omitted)\n  const { recoveryState, onMediaError, onMediaLoad, manualRetry } =\n    useMediaRecovery({\n      url: typeof url === \"string\" ? url : null,\n      adapter: recoveryAdapter,\n      statusHint: assetStatusHint,\n      onRemount: handleRemount,\n    });\n\n  React.useEffect(() => {\n    setHasError(false);\n    let objectUrl: string | null = null;\n\n    if (typeof url === \"string\") {\n      setSourceUrl(url);\n    } else if (url instanceof Blob) {\n      objectUrl = URL.createObjectURL(url);\n      setSourceUrl(objectUrl);\n    } else {\n      setSourceUrl(null);\n    }\n\n    return () => {\n      if (objectUrl) URL.revokeObjectURL(objectUrl);\n    };\n  }, [url]);\n\n  const handleError = React.useCallback(() => {\n    setHasError(true);\n    onError?.();\n    // If a recovery adapter is provided, delegate to the recovery hook.\n    if (recoveryAdapter) {\n      onMediaError();\n    }\n  }, [onError, recoveryAdapter, onMediaError]);\n\n  const handleLoad = React.useCallback(() => {\n    setHasError(false);\n    onLoad?.();\n    // Signal successful load to the recovery state machine.\n    if (recoveryAdapter) {\n      onMediaLoad();\n    }\n  }, [onLoad, recoveryAdapter, onMediaLoad]);\n\n  const circularStyle: React.CSSProperties = isCircular\n    ? { borderRadius: \"50%\", overflow: \"hidden\" }\n    : {};\n\n  const wrapperStyle: React.CSSProperties = {\n    position: \"relative\",\n    width: \"100%\",\n    height: \"100%\",\n    ...circularStyle,\n  };\n\n  // When recovery is active and in a terminal/blocking state, show the overlay.\n  const isInRecovery =\n    recoveryAdapter !== undefined &&\n    recoveryState.phase !== \"idle\" &&\n    recoveryState.phase !== \"loaded\" &&\n    recoveryState.phase !== \"loading\";\n\n  // No URL -> empty fallback\n  if (!sourceUrl) {\n    return (\n      <div className={className} style={wrapperStyle}>\n        <EmptyFallback isCircular={isCircular} />\n      </div>\n    );\n  }\n\n  // Recovery overlay (for all non-idle/non-loaded recovery states)\n  if (isInRecovery && hasError) {\n    return (\n      <div className={className} style={wrapperStyle}>\n        <RecoveryOverlay\n          state={recoveryState}\n          onManualRetry={manualRetry}\n          isCircular={isCircular}\n        />\n      </div>\n    );\n  }\n\n  // Vanilla error (no recovery adapter) -> error fallback\n  if (hasError && !recoveryAdapter) {\n    return (\n      <div className={className} style={wrapperStyle}>\n        <ErrorFallback isCircular={isCircular} />\n      </div>\n    );\n  }\n\n  const t = inferType({ type, mime, name, url: sourceUrl });\n\n  if (t === \"image\") {\n    return (\n      <div className={className} style={wrapperStyle}>\n        <ImageViewer\n          key={remountKey}\n          url={sourceUrl}\n          alt={alt}\n          lazy={lazy}\n          priority={priority}\n          skeleton={skeleton}\n          unloadOnExit={unloadOnExit}\n          isCircular={isCircular}\n          loadTimeoutMs={loadTimeoutMs}\n          onLoad={handleLoad}\n          onError={handleError}\n          fallback={<ErrorFallback isCircular={isCircular} />}\n        />\n      </div>\n    );\n  }\n\n  if (t === \"video\") {\n    return (\n      <div className={className} style={wrapperStyle}>\n        <VideoViewer\n          key={remountKey}\n          url={sourceUrl}\n          lazy={lazy}\n          priority={priority}\n          skeleton={skeleton}\n          unloadOnExit={unloadOnExit}\n          controls={controls}\n          autoPlay={autoPlay}\n          muted={muted}\n          loop={loop}\n          posterUrl={posterUrl}\n          preload={preload}\n          autoPlayOnVisible={autoPlayOnVisible}\n          loadTimeoutMs={loadTimeoutMs}\n          onLoad={handleLoad}\n          onError={handleError}\n          onEnded={onEnded}\n          onProgressSample={onProgressSample}\n          startAtSeconds={startAtSeconds}\n          endOverlay={endOverlay}\n          playbackControlsRef={playbackControlsRef}\n        />\n      </div>\n    );\n  }\n\n  if (t === \"audio\") {\n    return (\n      <div className={className} style={wrapperStyle}>\n        <AudioViewer\n          key={remountKey}\n          url={sourceUrl}\n          lazy={lazy}\n          priority={priority}\n          skeleton={skeleton}\n          autoPlay={autoPlay}\n          loop={loop}\n          preload={preload}\n          visualizerMode={audioVisualizerMode}\n          persistKey={audioPersistKey}\n          extraActions={audioExtraActions}\n          loadTimeoutMs={loadTimeoutMs}\n          onLoad={handleLoad}\n          onLoadChange={onLoadChange}\n          onError={handleError}\n          onEnded={onEnded}\n          onProgressSample={onProgressSample}\n          startAtSeconds={startAtSeconds}\n          endOverlay={endOverlay}\n          playbackControlsRef={playbackControlsRef}\n        />\n      </div>\n    );\n  }\n\n  // Unknown type -> fallback link\n  return shouldShowFallback(fallbackMode as FallbackMode) ? (\n    <div className={className} style={wrapperStyle}>\n      <MediaFallbackLink url={sourceUrl} filename={filename} label={fallbackLabel ?? \"Download\"} />\n    </div>\n  ) : null;\n}\n\n/** Back-compat alias */\nexport const MediaPreview = MediaViewer;\n"]}
+{"version":3,"file":"media-viewer.js","sourceRoot":"","sources":["../../src/react/media-viewer.tsx"],"names":[],"mappings":"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","sourcesContent":["import * as React from \"react\";\nimport { getSimplifiedMediaType } from \"@ttt-productions/media-schemas\";\nimport type { SimplifiedMediaType } from \"@ttt-productions/media-schemas\";\n\nimport type { MediaPreviewProps, MediaViewerType, FallbackMode } from \"../types.js\";\nimport { MediaFallbackLink, shouldShowFallback, EmptyFallback, ErrorFallback } from \"./fallback.js\";\nimport { ImageViewer } from \"./image-viewer.js\";\nimport { VideoViewer } from \"./video-viewer.js\";\nimport { AudioViewer } from \"./audio-viewer.js\";\nimport { useMediaRecovery } from \"./use-media-recovery.js\";\nimport type { RecoveryState } from \"../recovery.js\";\n\nfunction inferType(props: { type?: MediaPreviewProps[\"type\"]; mime?: string; name?: string; url?: string }): MediaViewerType {\n  if (props.type) {\n    // Handle MIME strings like \"image/png\" -> \"image\"\n    const primary = typeof props.type === \"string\" ? props.type.split(\"/\")[0] : props.type;\n    if (primary === \"image\" || primary === \"video\" || primary === \"audio\") return primary;\n    if (primary === \"other\") return \"other\";\n  }\n\n  const hint = props.mime ?? props.name ?? props.url;\n  if (!hint) return \"other\";\n  const simplified: SimplifiedMediaType = getSimplifiedMediaType(hint);\n  return simplified;\n}\n\n// ---------------------------------------------------------------------------\n// Recovery-phase UI helpers\n// ---------------------------------------------------------------------------\n\nfunction RecoveryOverlay({ state, onManualRetry, isCircular }: {\n  state: RecoveryState;\n  onManualRetry: () => void;\n  isCircular?: boolean;\n}) {\n  const wrapStyle: React.CSSProperties = {\n    display: \"flex\",\n    flexDirection: \"column\",\n    alignItems: \"center\",\n    justifyContent: \"center\",\n    width: \"100%\",\n    height: \"100%\",\n    gap: \"0.5rem\",\n    ...(isCircular ? { borderRadius: \"50%\" } : {}),\n  };\n\n  if (state.phase === \"processing\") {\n    return (\n      <div className=\"mv-recovery-processing\" style={wrapStyle}>\n        <span className=\"mv-recovery-label\">Processing media&hellip;</span>\n      </div>\n    );\n  }\n\n  if (state.phase === \"finalizing\") {\n    return (\n      <div className=\"mv-recovery-finalizing\" style={wrapStyle}>\n        <span className=\"mv-recovery-label\">Finishing media&hellip;</span>\n      </div>\n    );\n  }\n\n  if (state.phase === \"transient-retry\" || state.phase === \"propagating\") {\n    return (\n      <div className=\"mv-recovery-retrying\" style={wrapStyle}>\n        <span className=\"mv-recovery-label\">Loading&hellip;</span>\n      </div>\n    );\n  }\n\n  if (state.phase === \"auth-retry\") {\n    return (\n      <div className=\"mv-recovery-auth\" style={wrapStyle}>\n        <span className=\"mv-recovery-label\">Refreshing access&hellip;</span>\n      </div>\n    );\n  }\n\n  if (state.phase === \"hard-unavailable\") {\n    return (\n      <div className=\"mv-recovery-hard\" style={wrapStyle}>\n        <ErrorFallback isCircular={isCircular} />\n        {state.reason === \"auth\" ? (\n          <span className=\"mv-recovery-label\">Access denied.</span>\n        ) : (\n          <span className=\"mv-recovery-label\">Media unavailable.</span>\n        )}\n      </div>\n    );\n  }\n\n  if (state.phase === \"max-wait-fallback\") {\n    return (\n      <div className=\"mv-recovery-max-wait\" style={wrapStyle}>\n        <span className=\"mv-recovery-label\">This media is taking longer than expected.</span>\n        <button\n          type=\"button\"\n          className=\"mv-recovery-retry-btn\"\n          onClick={onManualRetry}\n        >\n          Retry\n        </button>\n      </div>\n    );\n  }\n\n  return null;\n}\n\n// ---------------------------------------------------------------------------\n// Main component\n// ---------------------------------------------------------------------------\n\nexport function MediaViewer(props: MediaPreviewProps) {\n  const {\n    url,\n    alt,\n    type,\n    className,\n    unloadOnExit,\n    isCircular = false,\n    enableZoom,\n    priority,\n    skeleton,\n    lazy,\n    controls,\n    autoPlay,\n    muted,\n    loop,\n    posterUrl,\n    preload,\n    autoPlayOnVisible,\n    onLoad,\n    onError,\n    onLoadChange,\n    onEnded,\n    onProgressSample,\n    startAtSeconds,\n    endOverlay,\n    playbackControlsRef,\n    audioVisualizerMode,\n    audioPersistKey,\n    audioExtraActions,\n    fallbackMode = \"link\",\n    fallbackLabel,\n    filename,\n    mime,\n    name,\n    recoveryAdapter,\n    assetStatusHint,\n    loadTimeoutMs,\n  } = props;\n\n  const [hasError, setHasError] = React.useState(false);\n  const [sourceUrl, setSourceUrl] = React.useState<string | null>(null);\n\n  // Remount key: incrementing this causes child media elements to unmount and\n  // re-mount from scratch, re-issuing the HTTP request.\n  const [remountKey, setRemountKey] = React.useState(0);\n\n  const handleRemount = React.useCallback(() => {\n    setHasError(false);\n    setRemountKey((k) => k + 1);\n  }, []);\n\n  // Recovery hook (no-op when recoveryAdapter is omitted)\n  const { recoveryState, onMediaError, onMediaLoad, manualRetry } =\n    useMediaRecovery({\n      url: typeof url === \"string\" ? url : null,\n      adapter: recoveryAdapter,\n      statusHint: assetStatusHint,\n      onRemount: handleRemount,\n    });\n\n  React.useEffect(() => {\n    setHasError(false);\n    let objectUrl: string | null = null;\n\n    if (typeof url === \"string\") {\n      setSourceUrl(url);\n    } else if (url instanceof Blob) {\n      objectUrl = URL.createObjectURL(url);\n      setSourceUrl(objectUrl);\n    } else {\n      setSourceUrl(null);\n    }\n\n    return () => {\n      if (objectUrl) URL.revokeObjectURL(objectUrl);\n    };\n  }, [url]);\n\n  const handleError = React.useCallback(() => {\n    setHasError(true);\n    onError?.();\n    // If a recovery adapter is provided, delegate to the recovery hook.\n    if (recoveryAdapter) {\n      onMediaError();\n    }\n  }, [onError, recoveryAdapter, onMediaError]);\n\n  const handleLoad = React.useCallback(() => {\n    setHasError(false);\n    onLoad?.();\n    // Signal successful load to the recovery state machine.\n    if (recoveryAdapter) {\n      onMediaLoad();\n    }\n  }, [onLoad, recoveryAdapter, onMediaLoad]);\n\n  const circularStyle: React.CSSProperties = isCircular\n    ? { borderRadius: \"50%\", overflow: \"hidden\" }\n    : {};\n\n  const wrapperStyle: React.CSSProperties = {\n    position: \"relative\",\n    width: \"100%\",\n    height: \"100%\",\n    ...circularStyle,\n  };\n\n  // When recovery is active and in a terminal/blocking state, show the overlay.\n  const isInRecovery =\n    recoveryAdapter !== undefined &&\n    recoveryState.phase !== \"idle\" &&\n    recoveryState.phase !== \"loaded\" &&\n    recoveryState.phase !== \"loading\";\n\n  // No URL -> empty fallback\n  if (!sourceUrl) {\n    return (\n      <div className={className} style={wrapperStyle}>\n        <EmptyFallback isCircular={isCircular} />\n      </div>\n    );\n  }\n\n  // Recovery overlay (for all non-idle/non-loaded recovery states)\n  if (isInRecovery && hasError) {\n    return (\n      <div className={className} style={wrapperStyle}>\n        <RecoveryOverlay\n          state={recoveryState}\n          onManualRetry={manualRetry}\n          isCircular={isCircular}\n        />\n      </div>\n    );\n  }\n\n  // Vanilla error (no recovery adapter) -> error fallback\n  if (hasError && !recoveryAdapter) {\n    return (\n      <div className={className} style={wrapperStyle}>\n        <ErrorFallback isCircular={isCircular} />\n      </div>\n    );\n  }\n\n  const t = inferType({ type, mime, name, url: sourceUrl });\n\n  if (t === \"image\") {\n    return (\n      <div className={className} style={wrapperStyle}>\n        <ImageViewer\n          key={remountKey}\n          url={sourceUrl}\n          alt={alt}\n          lazy={lazy}\n          priority={priority}\n          skeleton={skeleton}\n          unloadOnExit={unloadOnExit}\n          isCircular={isCircular}\n          enableZoom={enableZoom}\n          loadTimeoutMs={loadTimeoutMs}\n          onLoad={handleLoad}\n          onError={handleError}\n          fallback={<ErrorFallback isCircular={isCircular} />}\n        />\n      </div>\n    );\n  }\n\n  if (t === \"video\") {\n    return (\n      <div className={className} style={wrapperStyle}>\n        <VideoViewer\n          key={remountKey}\n          url={sourceUrl}\n          lazy={lazy}\n          priority={priority}\n          skeleton={skeleton}\n          unloadOnExit={unloadOnExit}\n          controls={controls}\n          autoPlay={autoPlay}\n          muted={muted}\n          loop={loop}\n          posterUrl={posterUrl}\n          preload={preload}\n          autoPlayOnVisible={autoPlayOnVisible}\n          loadTimeoutMs={loadTimeoutMs}\n          onLoad={handleLoad}\n          onError={handleError}\n          onEnded={onEnded}\n          onProgressSample={onProgressSample}\n          startAtSeconds={startAtSeconds}\n          endOverlay={endOverlay}\n          playbackControlsRef={playbackControlsRef}\n        />\n      </div>\n    );\n  }\n\n  if (t === \"audio\") {\n    return (\n      <div className={className} style={wrapperStyle}>\n        <AudioViewer\n          key={remountKey}\n          url={sourceUrl}\n          lazy={lazy}\n          priority={priority}\n          skeleton={skeleton}\n          autoPlay={autoPlay}\n          loop={loop}\n          preload={preload}\n          visualizerMode={audioVisualizerMode}\n          persistKey={audioPersistKey}\n          extraActions={audioExtraActions}\n          loadTimeoutMs={loadTimeoutMs}\n          onLoad={handleLoad}\n          onLoadChange={onLoadChange}\n          onError={handleError}\n          onEnded={onEnded}\n          onProgressSample={onProgressSample}\n          startAtSeconds={startAtSeconds}\n          endOverlay={endOverlay}\n          playbackControlsRef={playbackControlsRef}\n        />\n      </div>\n    );\n  }\n\n  // Unknown type -> fallback link\n  return shouldShowFallback(fallbackMode as FallbackMode) ? (\n    <div className={className} style={wrapperStyle}>\n      <MediaFallbackLink url={sourceUrl} filename={filename} label={fallbackLabel ?? \"Download\"} />\n    </div>\n  ) : null;\n}\n\n/** Back-compat alias */\nexport const MediaPreview = MediaViewer;\n"]}

package/dist/react/use-media-playback.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-media-playback.d.ts","sourceRoot":"","sources":["../../src/react/use-media-playback.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,KAAK,EAAE,qBAAqB,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAE7E;;;GAGG;AACH,eAAO,MAAM,2BAA2B,OAAO,CAAC;AAEhD;;;;;;;GAOG;AACH,eAAO,MAAM,4BAA4B,IAAI,CAAC;AAE9C,MAAM,MAAM,sBAAsB,GAAG;IACnC,4DAA4D;IAC5D,QAAQ,EAAE,OAAO,CAAC;IAClB,sEAAsE;IACtE,QAAQ,EAAE;QACR,gBAAgB,EAAE,CAAC,CAAC,EAAE,KAAK,CAAC,cAAc,CAAC,gBAAgB,CAAC,KAAK,IAAI,CAAC;QACtE,YAAY,EAAE,CAAC,CAAC,EAAE,KAAK,CAAC,cAAc,CAAC,gBAAgB,CAAC,KAAK,IAAI,CAAC;QAClE,MAAM,EAAE,CAAC,CAAC,EAAE,KAAK,CAAC,cAAc,CAAC,gBAAgB,CAAC,KAAK,IAAI,CAAC;QAC5D,OAAO,EAAE,CAAC,CAAC,EAAE,KAAK,CAAC,cAAc,CAAC,gBAAgB,CAAC,KAAK,IAAI,CAAC;QAC7D,QAAQ,EAAE,CAAC,CAAC,EAAE,KAAK,CAAC,cAAc,CAAC,gBAAgB,CAAC,KAAK,IAAI,CAAC;QAC9D,OAAO,EAAE,CAAC,CAAC,EAAE,KAAK,CAAC,cAAc,CAAC,gBAAgB,CAAC,KAAK,IAAI,CAAC;KAC9D,CAAC;CACH,CAAC;AAEF;;;;;;;;;;;;GAYG;AACH,wBAAgB,gBAAgB,CAC9B,UAAU,EAAE,KAAK,CAAC,SAAS,CAAC,gBAAgB,GAAG,IAAI,CAAC,EACpD,KAAK,EAAE,kBAAkB,EACzB,mBAAmB,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,qBAAqB,CAAC;AACtD;;;;;;GAMG;AACH,QAAQ,CAAC,EAAE,MAAM,GAChB,sBAAsB,CAmOxB"}
+{"version":3,"file":"use-media-playback.d.ts","sourceRoot":"","sources":["../../src/react/use-media-playback.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,KAAK,EACV,qBAAqB,EACrB,kBAAkB,EAEnB,MAAM,aAAa,CAAC;AAErB;;;GAGG;AACH,eAAO,MAAM,2BAA2B,OAAO,CAAC;AAEhD;;;;;;;GAOG;AACH,eAAO,MAAM,4BAA4B,IAAI,CAAC;AAE9C,MAAM,MAAM,sBAAsB,GAAG;IACnC,4DAA4D;IAC5D,QAAQ,EAAE,OAAO,CAAC;IAClB,sEAAsE;IACtE,QAAQ,EAAE;QACR,gBAAgB,EAAE,CAAC,CAAC,EAAE,KAAK,CAAC,cAAc,CAAC,gBAAgB,CAAC,KAAK,IAAI,CAAC;QACtE,YAAY,EAAE,CAAC,CAAC,EAAE,KAAK,CAAC,cAAc,CAAC,gBAAgB,CAAC,KAAK,IAAI,CAAC;QAClE,MAAM,EAAE,CAAC,CAAC,EAAE,KAAK,CAAC,cAAc,CAAC,gBAAgB,CAAC,KAAK,IAAI,CAAC;QAC5D,OAAO,EAAE,CAAC,CAAC,EAAE,KAAK,CAAC,cAAc,CAAC,gBAAgB,CAAC,KAAK,IAAI,CAAC;QAC7D,QAAQ,EAAE,CAAC,CAAC,EAAE,KAAK,CAAC,cAAc,CAAC,gBAAgB,CAAC,KAAK,IAAI,CAAC;QAC9D,OAAO,EAAE,CAAC,CAAC,EAAE,KAAK,CAAC,cAAc,CAAC,gBAAgB,CAAC,KAAK,IAAI,CAAC;KAC9D,CAAC;CACH,CAAC;AAEF;;;;;;;;;;;;GAYG;AACH,wBAAgB,gBAAgB,CAC9B,UAAU,EAAE,KAAK,CAAC,SAAS,CAAC,gBAAgB,GAAG,IAAI,CAAC,EACpD,KAAK,EAAE,kBAAkB,EACzB,mBAAmB,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,qBAAqB,CAAC;AACtD;;;;;;GAMG;AACH,QAAQ,CAAC,EAAE,MAAM,GAChB,sBAAsB,CAkPxB"}

package/dist/react/use-media-playback.js

@@ -78,12 +78,12 @@ mediaKey) {
         if (hasEnded)
             setHasEnded(false);
     }
-    const emitSample = React.useCallback((el) => {
+    const emitSample = React.useCallback((el, reason) => {
         const cb = onProgressSampleRef.current;
         if (!cb)
             return;
         const duration = Number.isFinite(el.duration) ? el.duration : 0;
-        cb(el.currentTime, duration);
+        cb(el.currentTime, duration, reason);
     }, []);
     const trackPosition = React.useCallback((el) => {
         if (hasStartedRef.current) {
@@ -155,10 +155,21 @@ mediaKey) {
         trackPosition(el);
         if (el.paused)
             return; // no periodic samples while paused
+        // Pre-seed suppression: until a resume position has been adopted, an
+        // element still near the start may be autoplaying from 0 while the app's
+        // async saved position is in flight. A periodic ~0 sample here would be
+        // written to durable state and CLOBBER that saved position before the
+        // seek lands. Stay silent for the adoption window; the seek's `seeked`
+        // flush reports the resumed position, and with no saved position at all
+        // periodic sampling simply begins a few seconds in (harmless). Deliberate
+        // pause/seeked/ended flushes are never suppressed — a user pausing at
+        // 0.5 s is genuine intent.
+        if (!seededRef.current && el.currentTime <= LATE_RESUME_ADOPT_WINDOW_SEC)
+            return;
         const now = Date.now();
         if (now - lastSampleAtRef.current >= PROGRESS_SAMPLE_INTERVAL_MS) {
             lastSampleAtRef.current = now;
-            emitSample(el);
+            emitSample(el, "periodic");
         }
     }, [emitSample, trackPosition]);
     const onPlay = React.useCallback(() => {
@@ -170,14 +181,16 @@ mediaKey) {
         trackPosition(el);
         // Flush a sample immediately on pause (final position for this segment).
         lastSampleAtRef.current = Date.now();
-        emitSample(el);
+        emitSample(el, "pause");
     }, [emitSample, trackPosition]);
     const onSeeked = React.useCallback((e) => {
         const el = e.currentTarget;
         trackPosition(el);
         // Flush a sample on seek completion so the app sees the new position.
+        // This is also how the programmatic initial-resume seek reports the
+        // adopted position — the element fires `seeked` after applyInitialSeek.
         lastSampleAtRef.current = Date.now();
-        emitSample(el);
+        emitSample(el, "seeked");
     }, [emitSample, trackPosition]);
     const onEndedHandler = React.useCallback((e) => {
         const el = e.currentTarget;
@@ -186,7 +199,7 @@ mediaKey) {
         lastPositionRef.current = el.currentTime;
         // Flush a final sample with the ended position.
         lastSampleAtRef.current = Date.now();
-        emitSample(el);
+        emitSample(el, "ended");
         setHasEnded(true);
         onEndedRef.current?.();
     }, [emitSample]);

package/dist/react/use-media-playback.js.map

@@ -1 +1 @@
-{"version":3,"file":"use-media-playback.js","sourceRoot":"","sources":["../../src/react/use-media-playback.ts"],"names":[],"mappings":"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","sourcesContent":["\"use client\";\n\nimport * as React from \"react\";\nimport type { MediaPlaybackControls, MediaPlaybackProps } from \"../types.js\";\n\n/**\n * Throttle interval for periodic progress samples. A sample fires at most once\n * per this many milliseconds of active (non-paused) playback via `timeupdate`.\n */\nexport const PROGRESS_SAMPLE_INTERVAL_MS = 5000;\n\n/**\n * How far an element may have played from the start and still ADOPT a\n * late-arriving `startAtSeconds`. Autoplay can begin playback before the app's\n * async resume position resolves (firefox reliably loses that race); a couple\n * of autoplayed seconds are not user intent, so the saved position still wins\n * inside this window. Beyond it, a late value is ignored — the user is\n * genuinely watching from where they are.\n */\nexport const LATE_RESUME_ADOPT_WINDOW_SEC = 3;\n\nexport type UseMediaPlaybackResult = {\n  /** Whether the media has ended (drives the end overlay). */\n  hasEnded: boolean;\n  /** Handlers to spread onto the underlying <video>/<audio> element. */\n  handlers: {\n    onLoadedMetadata: (e: React.SyntheticEvent<HTMLMediaElement>) => void;\n    onTimeUpdate: (e: React.SyntheticEvent<HTMLMediaElement>) => void;\n    onPlay: (e: React.SyntheticEvent<HTMLMediaElement>) => void;\n    onPause: (e: React.SyntheticEvent<HTMLMediaElement>) => void;\n    onSeeked: (e: React.SyntheticEvent<HTMLMediaElement>) => void;\n    onEnded: (e: React.SyntheticEvent<HTMLMediaElement>) => void;\n  };\n};\n\n/**\n * Shared playback API for VideoViewer and AudioViewer. Owns the additive\n * playback surface (onEnded, onProgressSample, startAtSeconds, endOverlay,\n * imperative controls) so both viewers behave identically. Adds NO observer —\n * everything is derived from native media element events (MEDIA-102).\n *\n * The element ref is supplied by the viewer (which already owns it for\n * autoplay/fullscreen). When the viewer unloads the element off-screen\n * (`unloadOnExit`) and remounts it on return, the last known playback position\n * is tracked in a component-scoped ref that outlives the element, so playback\n * resumes from where it left off — never from `startAtSeconds` again and never\n * from 0.\n */\nexport function useMediaPlayback(\n  elementRef: React.RefObject<HTMLMediaElement | null>,\n  props: MediaPlaybackProps,\n  playbackControlsRef?: React.Ref<MediaPlaybackControls>,\n  /**\n   * Stable identity for the CURRENT media source (the viewer passes its `url`).\n   * When this changes the media is a different asset, so all resume/progress/\n   * ended tracking is reset — a stale position from the previous media must NOT\n   * carry over onto the new element. Omit when the viewer never reuses one\n   * instance across sources.\n   */\n  mediaKey?: string,\n): UseMediaPlaybackResult {\n  const { onEnded, onProgressSample, startAtSeconds, endOverlay } = props;\n\n  const [hasEnded, setHasEnded] = React.useState(false);\n\n  // Latest callbacks/props via refs so handler identities stay stable and the\n  // element event handlers always see current values.\n  const onEndedRef = React.useRef(onEnded);\n  const onProgressSampleRef = React.useRef(onProgressSample);\n  onEndedRef.current = onEnded;\n  onProgressSampleRef.current = onProgressSample;\n\n  // The resume position implied by the CURRENT props: a positive\n  // startAtSeconds, or null when the caller supplies none. One declaration —\n  // the mount seed, the mediaKey reset, and the late-arrival effect all read it.\n  const seedFromProps =\n    typeof startAtSeconds === \"number\" && startAtSeconds > 0 ? startAtSeconds : null;\n\n  // Last known playback position. Seeded from startAtSeconds, then updated once\n  // playback has actually started. Survives the unloadOnExit unload/remount\n  // cycle because it lives on the (still-mounted) component instance.\n  const lastPositionRef = React.useRef<number | null>(seedFromProps);\n  // True once we have observed real playback progress — after this we resume\n  // from lastPositionRef, never re-apply the original startAtSeconds prop.\n  const hasStartedRef = React.useRef(false);\n  // True once a startAtSeconds seed has been ADOPTED (at mount or late-arrival).\n  // Owns the adopt-exactly-once rule for the late-arrival effect below — playback\n  // state is deliberately NOT that gate, because autoplay can start playback\n  // before an async resume position arrives (see LATE_RESUME_ADOPT_WINDOW_SEC).\n  const seededRef = React.useRef(seedFromProps !== null);\n\n  // Throttle bookkeeping for periodic samples (wall-clock, active playback only).\n  const lastSampleAtRef = React.useRef(0);\n\n  // Render-phase reset-on-source-change: when the media source (`mediaKey`)\n  // changes, the same component/hook instance is being reused for a DIFFERENT\n  // asset (e.g. a playlist swapping `url` in place). Reset every piece of\n  // per-source tracking so the previous media's position/ended/throttle state\n  // cannot bleed onto the new element. This is the sanctioned render-phase\n  // reset-on-prop-change pattern (not a set-state-in-effect).\n  const prevMediaKeyRef = React.useRef<string | undefined>(mediaKey);\n  if (prevMediaKeyRef.current !== mediaKey) {\n    prevMediaKeyRef.current = mediaKey;\n    lastPositionRef.current = seedFromProps;\n    hasStartedRef.current = false;\n    seededRef.current = seedFromProps !== null;\n    lastSampleAtRef.current = 0;\n    if (hasEnded) setHasEnded(false);\n  }\n\n  const emitSample = React.useCallback((el: HTMLMediaElement) => {\n    const cb = onProgressSampleRef.current;\n    if (!cb) return;\n    const duration = Number.isFinite(el.duration) ? el.duration : 0;\n    cb(el.currentTime, duration);\n  }, []);\n\n  const trackPosition = React.useCallback((el: HTMLMediaElement) => {\n    if (hasStartedRef.current) {\n      lastPositionRef.current = el.currentTime;\n    }\n  }, []);\n\n  const applyInitialSeek = React.useCallback((el: HTMLMediaElement, adoptWindowSec = 0.01) => {\n    const target = lastPositionRef.current;\n    if (typeof target !== \"number\" || target <= 0) return;\n    // Only seek an element still near the start. The DEFAULT window keeps the\n    // metadata handler idempotent (a metadata event on an already-positioned\n    // element is a no-op) and re-applies the LAST KNOWN position to the new\n    // element created by an unloadOnExit remount — resuming, never restarting.\n    // The late-arrival effect widens the window (LATE_RESUME_ADOPT_WINDOW_SEC)\n    // because autoplay may have advanced a little before the seed arrived.\n    if (el.currentTime > adoptWindowSec) return;\n    const dur = el.duration;\n    const clamped = Number.isFinite(dur) && dur > 0 ? Math.min(target, dur) : target;\n    try {\n      el.currentTime = clamped;\n    } catch {\n      /* setting currentTime before ready can throw in some engines; ignore */\n    }\n  }, []);\n\n  // Late-arriving resume position. `startAtSeconds` usually comes from an async\n  // app source (a user-prefs query); when that resolves AFTER this hook mounted,\n  // the mount-time seed above saw `undefined` and the element would silently\n  // start at 0. Adopt the value when it finally arrives — exactly ONCE\n  // (`seededRef`), and only while the element is within the small adoption\n  // window of the start, so a late value can never yank media the user is\n  // genuinely watching. Playback state is deliberately NOT the gate: under\n  // AUTOPLAY the element starts playing from 0 on its own, and by the time the\n  // prefs query resolves it has drifted a fraction of a second — firefox loses\n  // that race on every deep-link resume (live 2026-07-31, hosted path 14.4:\n  // expected ~224s, read 0.2s). A few autoplayed seconds are not user intent;\n  // jumping to the user's saved position IS the requested behavior. Beyond the\n  // window (a user genuinely re-watching from the top) the late value is\n  // ignored, same as before. A `mediaKey` change resets the refs in the\n  // render-phase block above, re-arming this for the new source; the seek is\n  // applied here because the element may already have fired `loadedmetadata`\n  // and will not fire it again — when metadata has not landed yet,\n  // `onLoadedMetadata` applies it.\n  React.useEffect(() => {\n    if (seedFromProps === null) return;\n    if (seededRef.current) return; // adopt exactly once; never override an applied seed\n    const el = elementRef.current;\n    if (el && el.currentTime > LATE_RESUME_ADOPT_WINDOW_SEC) return;\n    seededRef.current = true;\n    lastPositionRef.current = seedFromProps;\n    if (el) applyInitialSeek(el, LATE_RESUME_ADOPT_WINDOW_SEC);\n  }, [seedFromProps, applyInitialSeek, elementRef]);\n\n  const onLoadedMetadata = React.useCallback(\n    (e: React.SyntheticEvent<HTMLMediaElement>) => {\n      applyInitialSeek(e.currentTarget);\n    },\n    [applyInitialSeek],\n  );\n\n  const onTimeUpdate = React.useCallback(\n    (e: React.SyntheticEvent<HTMLMediaElement>) => {\n      const el = e.currentTarget;\n      // Any observed timeupdate while playing means playback has started; from\n      // now on we track live position for remount resume.\n      if (!el.paused && !el.ended) {\n        hasStartedRef.current = true;\n      }\n      trackPosition(el);\n      if (el.paused) return; // no periodic samples while paused\n      const now = Date.now();\n      if (now - lastSampleAtRef.current >= PROGRESS_SAMPLE_INTERVAL_MS) {\n        lastSampleAtRef.current = now;\n        emitSample(el);\n      }\n    },\n    [emitSample, trackPosition],\n  );\n\n  const onPlay = React.useCallback(() => {\n    // Playing again after an ended state (native replay) clears the overlay.\n    setHasEnded(false);\n  }, []);\n\n  const onPause = React.useCallback(\n    (e: React.SyntheticEvent<HTMLMediaElement>) => {\n      const el = e.currentTarget;\n      trackPosition(el);\n      // Flush a sample immediately on pause (final position for this segment).\n      lastSampleAtRef.current = Date.now();\n      emitSample(el);\n    },\n    [emitSample, trackPosition],\n  );\n\n  const onSeeked = React.useCallback(\n    (e: React.SyntheticEvent<HTMLMediaElement>) => {\n      const el = e.currentTarget;\n      trackPosition(el);\n      // Flush a sample on seek completion so the app sees the new position.\n      lastSampleAtRef.current = Date.now();\n      emitSample(el);\n    },\n    [emitSample, trackPosition],\n  );\n\n  const onEndedHandler = React.useCallback(\n    (e: React.SyntheticEvent<HTMLMediaElement>) => {\n      const el = e.currentTarget;\n      // Ended means the play cursor reached duration; record final position.\n      hasStartedRef.current = true;\n      lastPositionRef.current = el.currentTime;\n      // Flush a final sample with the ended position.\n      lastSampleAtRef.current = Date.now();\n      emitSample(el);\n      setHasEnded(true);\n      onEndedRef.current?.();\n    },\n    [emitSample],\n  );\n\n  // Imperative controls. restart() seeks to 0 and plays; seekTo(s) seeks.\n  React.useImperativeHandle(\n    playbackControlsRef,\n    (): MediaPlaybackControls => ({\n      restart() {\n        const el = elementRef.current;\n        if (!el) return;\n        try {\n          el.currentTime = 0;\n        } catch {\n          /* ignore */\n        }\n        lastPositionRef.current = 0;\n        setHasEnded(false);\n        void el.play().catch(() => {});\n      },\n      seekTo(seconds: number) {\n        const el = elementRef.current;\n        if (!el) return;\n        const dur = el.duration;\n        const clamped =\n          Number.isFinite(dur) && dur > 0 ? Math.min(Math.max(seconds, 0), dur) : Math.max(seconds, 0);\n        try {\n          el.currentTime = clamped;\n        } catch {\n          /* ignore */\n        }\n        hasStartedRef.current = true;\n        lastPositionRef.current = clamped;\n      },\n    }),\n    [elementRef],\n  );\n\n  // Ended state is cleared by onPlay (native replay / imperative restart).\n  // endOverlay itself is rendered by the viewer using `hasEnded`.\n  void endOverlay;\n\n  return {\n    hasEnded,\n    handlers: {\n      onLoadedMetadata,\n      onTimeUpdate,\n      onPlay,\n      onPause,\n      onSeeked,\n      onEnded: onEndedHandler,\n    },\n  };\n}\n"]}
+{"version":3,"file":"use-media-playback.js","sourceRoot":"","sources":["../../src/react/use-media-playback.ts"],"names":[],"mappings":"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","sourcesContent":["\"use client\";\n\nimport * as React from \"react\";\nimport type {\n  MediaPlaybackControls,\n  MediaPlaybackProps,\n  MediaProgressSampleReason,\n} from \"../types.js\";\n\n/**\n * Throttle interval for periodic progress samples. A sample fires at most once\n * per this many milliseconds of active (non-paused) playback via `timeupdate`.\n */\nexport const PROGRESS_SAMPLE_INTERVAL_MS = 5000;\n\n/**\n * How far an element may have played from the start and still ADOPT a\n * late-arriving `startAtSeconds`. Autoplay can begin playback before the app's\n * async resume position resolves (firefox reliably loses that race); a couple\n * of autoplayed seconds are not user intent, so the saved position still wins\n * inside this window. Beyond it, a late value is ignored — the user is\n * genuinely watching from where they are.\n */\nexport const LATE_RESUME_ADOPT_WINDOW_SEC = 3;\n\nexport type UseMediaPlaybackResult = {\n  /** Whether the media has ended (drives the end overlay). */\n  hasEnded: boolean;\n  /** Handlers to spread onto the underlying <video>/<audio> element. */\n  handlers: {\n    onLoadedMetadata: (e: React.SyntheticEvent<HTMLMediaElement>) => void;\n    onTimeUpdate: (e: React.SyntheticEvent<HTMLMediaElement>) => void;\n    onPlay: (e: React.SyntheticEvent<HTMLMediaElement>) => void;\n    onPause: (e: React.SyntheticEvent<HTMLMediaElement>) => void;\n    onSeeked: (e: React.SyntheticEvent<HTMLMediaElement>) => void;\n    onEnded: (e: React.SyntheticEvent<HTMLMediaElement>) => void;\n  };\n};\n\n/**\n * Shared playback API for VideoViewer and AudioViewer. Owns the additive\n * playback surface (onEnded, onProgressSample, startAtSeconds, endOverlay,\n * imperative controls) so both viewers behave identically. Adds NO observer —\n * everything is derived from native media element events (MEDIA-102).\n *\n * The element ref is supplied by the viewer (which already owns it for\n * autoplay/fullscreen). When the viewer unloads the element off-screen\n * (`unloadOnExit`) and remounts it on return, the last known playback position\n * is tracked in a component-scoped ref that outlives the element, so playback\n * resumes from where it left off — never from `startAtSeconds` again and never\n * from 0.\n */\nexport function useMediaPlayback(\n  elementRef: React.RefObject<HTMLMediaElement | null>,\n  props: MediaPlaybackProps,\n  playbackControlsRef?: React.Ref<MediaPlaybackControls>,\n  /**\n   * Stable identity for the CURRENT media source (the viewer passes its `url`).\n   * When this changes the media is a different asset, so all resume/progress/\n   * ended tracking is reset — a stale position from the previous media must NOT\n   * carry over onto the new element. Omit when the viewer never reuses one\n   * instance across sources.\n   */\n  mediaKey?: string,\n): UseMediaPlaybackResult {\n  const { onEnded, onProgressSample, startAtSeconds, endOverlay } = props;\n\n  const [hasEnded, setHasEnded] = React.useState(false);\n\n  // Latest callbacks/props via refs so handler identities stay stable and the\n  // element event handlers always see current values.\n  const onEndedRef = React.useRef(onEnded);\n  const onProgressSampleRef = React.useRef(onProgressSample);\n  onEndedRef.current = onEnded;\n  onProgressSampleRef.current = onProgressSample;\n\n  // The resume position implied by the CURRENT props: a positive\n  // startAtSeconds, or null when the caller supplies none. One declaration —\n  // the mount seed, the mediaKey reset, and the late-arrival effect all read it.\n  const seedFromProps =\n    typeof startAtSeconds === \"number\" && startAtSeconds > 0 ? startAtSeconds : null;\n\n  // Last known playback position. Seeded from startAtSeconds, then updated once\n  // playback has actually started. Survives the unloadOnExit unload/remount\n  // cycle because it lives on the (still-mounted) component instance.\n  const lastPositionRef = React.useRef<number | null>(seedFromProps);\n  // True once we have observed real playback progress — after this we resume\n  // from lastPositionRef, never re-apply the original startAtSeconds prop.\n  const hasStartedRef = React.useRef(false);\n  // True once a startAtSeconds seed has been ADOPTED (at mount or late-arrival).\n  // Owns the adopt-exactly-once rule for the late-arrival effect below — playback\n  // state is deliberately NOT that gate, because autoplay can start playback\n  // before an async resume position arrives (see LATE_RESUME_ADOPT_WINDOW_SEC).\n  const seededRef = React.useRef(seedFromProps !== null);\n\n  // Throttle bookkeeping for periodic samples (wall-clock, active playback only).\n  const lastSampleAtRef = React.useRef(0);\n\n  // Render-phase reset-on-source-change: when the media source (`mediaKey`)\n  // changes, the same component/hook instance is being reused for a DIFFERENT\n  // asset (e.g. a playlist swapping `url` in place). Reset every piece of\n  // per-source tracking so the previous media's position/ended/throttle state\n  // cannot bleed onto the new element. This is the sanctioned render-phase\n  // reset-on-prop-change pattern (not a set-state-in-effect).\n  const prevMediaKeyRef = React.useRef<string | undefined>(mediaKey);\n  if (prevMediaKeyRef.current !== mediaKey) {\n    prevMediaKeyRef.current = mediaKey;\n    lastPositionRef.current = seedFromProps;\n    hasStartedRef.current = false;\n    seededRef.current = seedFromProps !== null;\n    lastSampleAtRef.current = 0;\n    if (hasEnded) setHasEnded(false);\n  }\n\n  const emitSample = React.useCallback(\n    (el: HTMLMediaElement, reason: MediaProgressSampleReason) => {\n      const cb = onProgressSampleRef.current;\n      if (!cb) return;\n      const duration = Number.isFinite(el.duration) ? el.duration : 0;\n      cb(el.currentTime, duration, reason);\n    },\n    [],\n  );\n\n  const trackPosition = React.useCallback((el: HTMLMediaElement) => {\n    if (hasStartedRef.current) {\n      lastPositionRef.current = el.currentTime;\n    }\n  }, []);\n\n  const applyInitialSeek = React.useCallback((el: HTMLMediaElement, adoptWindowSec = 0.01) => {\n    const target = lastPositionRef.current;\n    if (typeof target !== \"number\" || target <= 0) return;\n    // Only seek an element still near the start. The DEFAULT window keeps the\n    // metadata handler idempotent (a metadata event on an already-positioned\n    // element is a no-op) and re-applies the LAST KNOWN position to the new\n    // element created by an unloadOnExit remount — resuming, never restarting.\n    // The late-arrival effect widens the window (LATE_RESUME_ADOPT_WINDOW_SEC)\n    // because autoplay may have advanced a little before the seed arrived.\n    if (el.currentTime > adoptWindowSec) return;\n    const dur = el.duration;\n    const clamped = Number.isFinite(dur) && dur > 0 ? Math.min(target, dur) : target;\n    try {\n      el.currentTime = clamped;\n    } catch {\n      /* setting currentTime before ready can throw in some engines; ignore */\n    }\n  }, []);\n\n  // Late-arriving resume position. `startAtSeconds` usually comes from an async\n  // app source (a user-prefs query); when that resolves AFTER this hook mounted,\n  // the mount-time seed above saw `undefined` and the element would silently\n  // start at 0. Adopt the value when it finally arrives — exactly ONCE\n  // (`seededRef`), and only while the element is within the small adoption\n  // window of the start, so a late value can never yank media the user is\n  // genuinely watching. Playback state is deliberately NOT the gate: under\n  // AUTOPLAY the element starts playing from 0 on its own, and by the time the\n  // prefs query resolves it has drifted a fraction of a second — firefox loses\n  // that race on every deep-link resume (live 2026-07-31, hosted path 14.4:\n  // expected ~224s, read 0.2s). A few autoplayed seconds are not user intent;\n  // jumping to the user's saved position IS the requested behavior. Beyond the\n  // window (a user genuinely re-watching from the top) the late value is\n  // ignored, same as before. A `mediaKey` change resets the refs in the\n  // render-phase block above, re-arming this for the new source; the seek is\n  // applied here because the element may already have fired `loadedmetadata`\n  // and will not fire it again — when metadata has not landed yet,\n  // `onLoadedMetadata` applies it.\n  React.useEffect(() => {\n    if (seedFromProps === null) return;\n    if (seededRef.current) return; // adopt exactly once; never override an applied seed\n    const el = elementRef.current;\n    if (el && el.currentTime > LATE_RESUME_ADOPT_WINDOW_SEC) return;\n    seededRef.current = true;\n    lastPositionRef.current = seedFromProps;\n    if (el) applyInitialSeek(el, LATE_RESUME_ADOPT_WINDOW_SEC);\n  }, [seedFromProps, applyInitialSeek, elementRef]);\n\n  const onLoadedMetadata = React.useCallback(\n    (e: React.SyntheticEvent<HTMLMediaElement>) => {\n      applyInitialSeek(e.currentTarget);\n    },\n    [applyInitialSeek],\n  );\n\n  const onTimeUpdate = React.useCallback(\n    (e: React.SyntheticEvent<HTMLMediaElement>) => {\n      const el = e.currentTarget;\n      // Any observed timeupdate while playing means playback has started; from\n      // now on we track live position for remount resume.\n      if (!el.paused && !el.ended) {\n        hasStartedRef.current = true;\n      }\n      trackPosition(el);\n      if (el.paused) return; // no periodic samples while paused\n      // Pre-seed suppression: until a resume position has been adopted, an\n      // element still near the start may be autoplaying from 0 while the app's\n      // async saved position is in flight. A periodic ~0 sample here would be\n      // written to durable state and CLOBBER that saved position before the\n      // seek lands. Stay silent for the adoption window; the seek's `seeked`\n      // flush reports the resumed position, and with no saved position at all\n      // periodic sampling simply begins a few seconds in (harmless). Deliberate\n      // pause/seeked/ended flushes are never suppressed — a user pausing at\n      // 0.5 s is genuine intent.\n      if (!seededRef.current && el.currentTime <= LATE_RESUME_ADOPT_WINDOW_SEC) return;\n      const now = Date.now();\n      if (now - lastSampleAtRef.current >= PROGRESS_SAMPLE_INTERVAL_MS) {\n        lastSampleAtRef.current = now;\n        emitSample(el, \"periodic\");\n      }\n    },\n    [emitSample, trackPosition],\n  );\n\n  const onPlay = React.useCallback(() => {\n    // Playing again after an ended state (native replay) clears the overlay.\n    setHasEnded(false);\n  }, []);\n\n  const onPause = React.useCallback(\n    (e: React.SyntheticEvent<HTMLMediaElement>) => {\n      const el = e.currentTarget;\n      trackPosition(el);\n      // Flush a sample immediately on pause (final position for this segment).\n      lastSampleAtRef.current = Date.now();\n      emitSample(el, \"pause\");\n    },\n    [emitSample, trackPosition],\n  );\n\n  const onSeeked = React.useCallback(\n    (e: React.SyntheticEvent<HTMLMediaElement>) => {\n      const el = e.currentTarget;\n      trackPosition(el);\n      // Flush a sample on seek completion so the app sees the new position.\n      // This is also how the programmatic initial-resume seek reports the\n      // adopted position — the element fires `seeked` after applyInitialSeek.\n      lastSampleAtRef.current = Date.now();\n      emitSample(el, \"seeked\");\n    },\n    [emitSample, trackPosition],\n  );\n\n  const onEndedHandler = React.useCallback(\n    (e: React.SyntheticEvent<HTMLMediaElement>) => {\n      const el = e.currentTarget;\n      // Ended means the play cursor reached duration; record final position.\n      hasStartedRef.current = true;\n      lastPositionRef.current = el.currentTime;\n      // Flush a final sample with the ended position.\n      lastSampleAtRef.current = Date.now();\n      emitSample(el, \"ended\");\n      setHasEnded(true);\n      onEndedRef.current?.();\n    },\n    [emitSample],\n  );\n\n  // Imperative controls. restart() seeks to 0 and plays; seekTo(s) seeks.\n  React.useImperativeHandle(\n    playbackControlsRef,\n    (): MediaPlaybackControls => ({\n      restart() {\n        const el = elementRef.current;\n        if (!el) return;\n        try {\n          el.currentTime = 0;\n        } catch {\n          /* ignore */\n        }\n        lastPositionRef.current = 0;\n        setHasEnded(false);\n        void el.play().catch(() => {});\n      },\n      seekTo(seconds: number) {\n        const el = elementRef.current;\n        if (!el) return;\n        const dur = el.duration;\n        const clamped =\n          Number.isFinite(dur) && dur > 0 ? Math.min(Math.max(seconds, 0), dur) : Math.max(seconds, 0);\n        try {\n          el.currentTime = clamped;\n        } catch {\n          /* ignore */\n        }\n        hasStartedRef.current = true;\n        lastPositionRef.current = clamped;\n      },\n    }),\n    [elementRef],\n  );\n\n  // Ended state is cleared by onPlay (native replay / imperative restart).\n  // endOverlay itself is rendered by the viewer using `hasEnded`.\n  void endOverlay;\n\n  return {\n    hasEnded,\n    handlers: {\n      onLoadedMetadata,\n      onTimeUpdate,\n      onPlay,\n      onPause,\n      onSeeked,\n      onEnded: onEndedHandler,\n    },\n  };\n}\n"]}

package/dist/types.d.ts

@@ -16,6 +16,13 @@ export type MediaPlaybackControls = {
     /** Seek to the given position (seconds), clamped to [0, duration]. */
     seekTo(seconds: number): void;
 };
+/**
+ * Why a progress sample was emitted. `periodic` is a throttled position report
+ * during playback and is safe for a consumer to coalesce or drop; the other
+ * three mark an exact moment the user's position changed and should be
+ * committed as-is.
+ */
+export type MediaProgressSampleReason = "periodic" | "pause" | "seeked" | "ended";
 /**
  * Additive, fully optional playback API shared by `VideoViewer` and
  * `AudioViewer`. Every field is optional; when all are absent the viewers
@@ -29,15 +36,22 @@ export type MediaPlaybackProps = {
      */
     onEnded?: () => void;
     /**
-     * Periodic playback-position reporting. Contract:
-     * - While playing, fires at most once every ~5 seconds of playback
-     *   (throttled off `timeupdate`).
-     * - Fires once immediately on pause, on seek completion (`seeked`), and on
-     *   ended — each carrying the exact position at that moment.
-     * - Never fires while paused (aside from the single pause-flush above).
+     * Playback-position reporting. Every sample carries the `reason` it was
+     * emitted for ({@link MediaProgressSampleReason}) as an additive third
+     * argument, so a consumer can throttle `periodic` reports while committing
+     * the exact-moment ones. Contract:
+     * - `periodic` — while playing, fires at most once every ~5 seconds of
+     *   playback (throttled off `timeupdate`). Never fires while paused, and is
+     *   SUPPRESSED near the start until the resume decision is settled: while no
+     *   `startAtSeconds` seed has been adopted and the element is still within
+     *   the late-resume adoption window, an autoplaying element reports nothing,
+     *   so a position of ~0 can never overwrite a saved one.
+     * - `pause` / `seeked` / `ended` — fires once immediately on that event with
+     *   the exact position, never suppressed. The programmatic resume seek that
+     *   applies `startAtSeconds` reports as `seeked` with the resumed position.
      * `durationSeconds` is `0` until the element's duration is known.
      */
-    onProgressSample?: (currentTimeSeconds: number, durationSeconds: number) => void;
+    onProgressSample?: (currentTimeSeconds: number, durationSeconds: number, reason: MediaProgressSampleReason) => void;
     /**
      * Initial playback position (seconds), applied once the element has metadata.
      * May arrive late (e.g. from an async prefs read that resolves after the
@@ -117,6 +131,10 @@ export type MediaPreviewProps = {
     className?: string;
     unloadOnExit?: boolean;
     isCircular?: boolean;
+    /** Image type only — forwarded to ImageViewer's click-to-zoom toggle (which
+     *  defaults ON). Pass `false` to render a plain, non-zooming image surface.
+     *  Ignored for video/audio/other types. */
+    enableZoom?: ImageViewerProps["enableZoom"];
     priority?: boolean;
     skeleton?: boolean;
     lazy?: boolean;

package/dist/types.d.ts.map

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

package/dist/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"","sourcesContent":["import type * as React from \"react\";\nimport type { MediaDiagnosticAdapter, AssetStatusHint } from \"./recovery.js\";\nimport type { AudioVisualizerMode } from \"./visualizer.js\";\n\nexport type { MediaDiagnosticAdapter, AssetStatusHint, DiagnosisResult, RecoveryState } from \"./recovery.js\";\nexport type { AudioVisualizerMode } from \"./visualizer.js\";\n\nexport type MediaViewerType = \"image\" | \"video\" | \"audio\" | \"other\";\nexport type FallbackMode = \"none\" | \"link\";\n\n/**\n * Imperative playback controls, exposed via the `playbackControlsRef` prop on\n * `VideoViewer` / `AudioViewer` (and forwarded by `MediaPreview` for\n * video/audio). Obtain via `React.useRef<MediaPlaybackControls>(null)`.\n */\nexport type MediaPlaybackControls = {\n  /** Seek to 0 and play from the start. Clears any end-overlay. */\n  restart(): void;\n  /** Seek to the given position (seconds), clamped to [0, duration]. */\n  seekTo(seconds: number): void;\n};\n\n/**\n * Additive, fully optional playback API shared by `VideoViewer` and\n * `AudioViewer`. Every field is optional; when all are absent the viewers\n * behave exactly as before.\n */\nexport type MediaPlaybackProps = {\n  /**\n   * Fires when the media element ends (native `ended` event) with the play\n   * cursor at duration. NOTE: when `loop` is set the browser restarts natively\n   * and emits no `ended` event, so `onEnded` never fires in that mode.\n   */\n  onEnded?: () => void;\n\n  /**\n   * Periodic playback-position reporting. Contract:\n   * - While playing, fires at most once every ~5 seconds of playback\n   *   (throttled off `timeupdate`).\n   * - Fires once immediately on pause, on seek completion (`seeked`), and on\n   *   ended — each carrying the exact position at that moment.\n   * - Never fires while paused (aside from the single pause-flush above).\n   * `durationSeconds` is `0` until the element's duration is known.\n   */\n  onProgressSample?: (currentTimeSeconds: number, durationSeconds: number) => void;\n\n  /**\n   * Initial playback position (seconds), applied once the element has metadata.\n   * May arrive late (e.g. from an async prefs read that resolves after the\n   * viewer mounted): a value that appears while playback has not yet begun is\n   * adopted and applied to the already-loaded element. Once real playback has\n   * begun a later value is ignored — it never yanks playing media.\n   * Survives the `unloadOnExit` unload/remount cycle: once playback has started\n   * the viewer tracks the live position internally and resumes from the LAST\n   * KNOWN position on remount — it does not re-apply this prop and does not\n   * restart at 0.\n   */\n  startAtSeconds?: number;\n\n  /**\n   * Rendered as an overlay covering the media area when the media has ended.\n   * Removed when playback restarts (native replay or imperative `restart()`).\n   * The overlay only intercepts pointer events while shown and renders above\n   * the element. In a native-fullscreen exit state the overlay reappears over\n   * the inline element (it is part of normal document flow, not the fullscreen\n   * layer).\n   */\n  endOverlay?: React.ReactNode;\n\n  /** Imperative controls handle — see {@link MediaPlaybackControls}. */\n  playbackControlsRef?: React.Ref<MediaPlaybackControls>;\n};\n\nexport type BaseMediaProps = {\n  url: string;\n  className?: string;\n  mediaClassName?: string;\n  lazy?: boolean;\n  priority?: boolean;\n  skeleton?: boolean;\n  onLoad?: () => void;\n  onError?: () => void;\n  fallback?: React.ReactNode;\n  /**\n   * Load-watchdog budget in ms (default LOAD_WATCHDOG_MS). A visible, loading\n   * element that produces neither a load/metadata nor an error event within\n   * this budget synthesizes an error so the asset resolves to a bounded\n   * terminal state instead of an eternal skeleton. `0` disables.\n   */\n  loadTimeoutMs?: number;\n};\n\nexport type ImageViewerProps = BaseMediaProps & {\n  alt?: string;\n  enableZoom?: boolean;\n  unloadOnExit?: boolean;\n  isCircular?: boolean;\n  preventGestures?: boolean;\n};\n\nexport type VideoViewerProps = BaseMediaProps & MediaPlaybackProps & {\n  controls?: boolean;\n  autoPlay?: boolean;\n  muted?: boolean;\n  loop?: boolean;\n  posterUrl?: string;\n  enableFullscreen?: boolean;\n  unloadOnExit?: boolean;\n  preload?: \"auto\" | \"metadata\" | \"none\";\n  autoPlayOnVisible?: boolean;\n};\n\nexport type AudioViewerProps = BaseMediaProps & MediaPlaybackProps & {\n  autoPlay?: boolean;\n  loop?: boolean;\n  preload?: \"auto\" | \"metadata\" | \"none\";\n  onLoadChange?: (isLoading: boolean) => void;\n\n  // AudioViewer always uses the package-owned control surface. Native browser\n  // audio controls are intentionally not part of the public contract.\n  /** Initial visualizer mode (\"line\" oscilloscope | \"bars\" EQ). A persisted user choice wins. */\n  visualizerMode?: AudioVisualizerMode;\n  /** localStorage key base for the minimize/mode prefs. `null` disables persistence. */\n  persistKey?: string | null;\n  /** App-injected action buttons rendered at the end of the player control row. */\n  extraActions?: React.ReactNode;\n};\n\nexport type MediaPreviewProps = {\n  url?: string | File | Blob | null;\n  alt?: string;\n  type?: MediaViewerType | string;\n  className?: string;\n  unloadOnExit?: boolean;\n  isCircular?: boolean;\n  priority?: boolean;\n  skeleton?: boolean;\n  lazy?: boolean;\n  /** Video controls only. Audio always renders the canonical package-owned controls. */\n  controls?: boolean;\n  autoPlay?: boolean;\n  muted?: boolean;\n  loop?: boolean;\n  posterUrl?: string;\n  preload?: \"auto\" | \"metadata\" | \"none\";\n  autoPlayOnVisible?: boolean;\n  onLoad?: () => void;\n  onError?: () => void;\n  onLoadChange?: (isLoading: boolean) => void;\n\n  // -------------------------------------------------------------------------\n  // Playback API (additive, optional) — forwarded to the video/audio viewer.\n  // Ignored for image/other types. See MediaPlaybackProps for the contract.\n  // -------------------------------------------------------------------------\n  onEnded?: MediaPlaybackProps[\"onEnded\"];\n  onProgressSample?: MediaPlaybackProps[\"onProgressSample\"];\n  startAtSeconds?: MediaPlaybackProps[\"startAtSeconds\"];\n  endOverlay?: MediaPlaybackProps[\"endOverlay\"];\n  playbackControlsRef?: MediaPlaybackProps[\"playbackControlsRef\"];\n\n  // Audio always uses the package-owned player. These props customize that\n  // single control surface and are ignored for every other media type.\n  audioVisualizerMode?: AudioVisualizerMode;\n  audioPersistKey?: string | null;\n  audioExtraActions?: React.ReactNode;\n\n  fallbackMode?: FallbackMode;\n  fallbackLabel?: string;\n  filename?: string;\n  mime?: string;\n  name?: string;\n\n  // -------------------------------------------------------------------------\n  // Recovery adapter (additive, optional — backward-compatible)\n  // -------------------------------------------------------------------------\n  /**\n   * Injected diagnostic adapter. When provided, element load errors for\n   * assets the app believes are live will trigger the bounded recovery state\n   * machine. When omitted, the existing error fallback behavior is unchanged.\n   */\n  recoveryAdapter?: MediaDiagnosticAdapter;\n\n  /**\n   * Optional app hint about the server-side lifecycle state of the asset.\n   * Drives which recovery phase is shown (e.g. processing → skeleton,\n   * finalizing → spinner, failed/rejected → hard error immediately).\n   */\n  assetStatusHint?: AssetStatusHint;\n\n  /** Load-watchdog budget forwarded to the underlying viewer — see BaseMediaProps. */\n  loadTimeoutMs?: number;\n};\n\n/** Back-compat alias */\nexport type MediaViewerProps = MediaPreviewProps;\n"]}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"","sourcesContent":["import type * as React from \"react\";\nimport type { MediaDiagnosticAdapter, AssetStatusHint } from \"./recovery.js\";\nimport type { AudioVisualizerMode } from \"./visualizer.js\";\n\nexport type { MediaDiagnosticAdapter, AssetStatusHint, DiagnosisResult, RecoveryState } from \"./recovery.js\";\nexport type { AudioVisualizerMode } from \"./visualizer.js\";\n\nexport type MediaViewerType = \"image\" | \"video\" | \"audio\" | \"other\";\nexport type FallbackMode = \"none\" | \"link\";\n\n/**\n * Imperative playback controls, exposed via the `playbackControlsRef` prop on\n * `VideoViewer` / `AudioViewer` (and forwarded by `MediaPreview` for\n * video/audio). Obtain via `React.useRef<MediaPlaybackControls>(null)`.\n */\nexport type MediaPlaybackControls = {\n  /** Seek to 0 and play from the start. Clears any end-overlay. */\n  restart(): void;\n  /** Seek to the given position (seconds), clamped to [0, duration]. */\n  seekTo(seconds: number): void;\n};\n\n/**\n * Why a progress sample was emitted. `periodic` is a throttled position report\n * during playback and is safe for a consumer to coalesce or drop; the other\n * three mark an exact moment the user's position changed and should be\n * committed as-is.\n */\nexport type MediaProgressSampleReason = \"periodic\" | \"pause\" | \"seeked\" | \"ended\";\n\n/**\n * Additive, fully optional playback API shared by `VideoViewer` and\n * `AudioViewer`. Every field is optional; when all are absent the viewers\n * behave exactly as before.\n */\nexport type MediaPlaybackProps = {\n  /**\n   * Fires when the media element ends (native `ended` event) with the play\n   * cursor at duration. NOTE: when `loop` is set the browser restarts natively\n   * and emits no `ended` event, so `onEnded` never fires in that mode.\n   */\n  onEnded?: () => void;\n\n  /**\n   * Playback-position reporting. Every sample carries the `reason` it was\n   * emitted for ({@link MediaProgressSampleReason}) as an additive third\n   * argument, so a consumer can throttle `periodic` reports while committing\n   * the exact-moment ones. Contract:\n   * - `periodic` — while playing, fires at most once every ~5 seconds of\n   *   playback (throttled off `timeupdate`). Never fires while paused, and is\n   *   SUPPRESSED near the start until the resume decision is settled: while no\n   *   `startAtSeconds` seed has been adopted and the element is still within\n   *   the late-resume adoption window, an autoplaying element reports nothing,\n   *   so a position of ~0 can never overwrite a saved one.\n   * - `pause` / `seeked` / `ended` — fires once immediately on that event with\n   *   the exact position, never suppressed. The programmatic resume seek that\n   *   applies `startAtSeconds` reports as `seeked` with the resumed position.\n   * `durationSeconds` is `0` until the element's duration is known.\n   */\n  onProgressSample?: (\n    currentTimeSeconds: number,\n    durationSeconds: number,\n    reason: MediaProgressSampleReason,\n  ) => void;\n\n  /**\n   * Initial playback position (seconds), applied once the element has metadata.\n   * May arrive late (e.g. from an async prefs read that resolves after the\n   * viewer mounted): a value that appears while playback has not yet begun is\n   * adopted and applied to the already-loaded element. Once real playback has\n   * begun a later value is ignored — it never yanks playing media.\n   * Survives the `unloadOnExit` unload/remount cycle: once playback has started\n   * the viewer tracks the live position internally and resumes from the LAST\n   * KNOWN position on remount — it does not re-apply this prop and does not\n   * restart at 0.\n   */\n  startAtSeconds?: number;\n\n  /**\n   * Rendered as an overlay covering the media area when the media has ended.\n   * Removed when playback restarts (native replay or imperative `restart()`).\n   * The overlay only intercepts pointer events while shown and renders above\n   * the element. In a native-fullscreen exit state the overlay reappears over\n   * the inline element (it is part of normal document flow, not the fullscreen\n   * layer).\n   */\n  endOverlay?: React.ReactNode;\n\n  /** Imperative controls handle — see {@link MediaPlaybackControls}. */\n  playbackControlsRef?: React.Ref<MediaPlaybackControls>;\n};\n\nexport type BaseMediaProps = {\n  url: string;\n  className?: string;\n  mediaClassName?: string;\n  lazy?: boolean;\n  priority?: boolean;\n  skeleton?: boolean;\n  onLoad?: () => void;\n  onError?: () => void;\n  fallback?: React.ReactNode;\n  /**\n   * Load-watchdog budget in ms (default LOAD_WATCHDOG_MS). A visible, loading\n   * element that produces neither a load/metadata nor an error event within\n   * this budget synthesizes an error so the asset resolves to a bounded\n   * terminal state instead of an eternal skeleton. `0` disables.\n   */\n  loadTimeoutMs?: number;\n};\n\nexport type ImageViewerProps = BaseMediaProps & {\n  alt?: string;\n  enableZoom?: boolean;\n  unloadOnExit?: boolean;\n  isCircular?: boolean;\n  preventGestures?: boolean;\n};\n\nexport type VideoViewerProps = BaseMediaProps & MediaPlaybackProps & {\n  controls?: boolean;\n  autoPlay?: boolean;\n  muted?: boolean;\n  loop?: boolean;\n  posterUrl?: string;\n  enableFullscreen?: boolean;\n  unloadOnExit?: boolean;\n  preload?: \"auto\" | \"metadata\" | \"none\";\n  autoPlayOnVisible?: boolean;\n};\n\nexport type AudioViewerProps = BaseMediaProps & MediaPlaybackProps & {\n  autoPlay?: boolean;\n  loop?: boolean;\n  preload?: \"auto\" | \"metadata\" | \"none\";\n  onLoadChange?: (isLoading: boolean) => void;\n\n  // AudioViewer always uses the package-owned control surface. Native browser\n  // audio controls are intentionally not part of the public contract.\n  /** Initial visualizer mode (\"line\" oscilloscope | \"bars\" EQ). A persisted user choice wins. */\n  visualizerMode?: AudioVisualizerMode;\n  /** localStorage key base for the minimize/mode prefs. `null` disables persistence. */\n  persistKey?: string | null;\n  /** App-injected action buttons rendered at the end of the player control row. */\n  extraActions?: React.ReactNode;\n};\n\nexport type MediaPreviewProps = {\n  url?: string | File | Blob | null;\n  alt?: string;\n  type?: MediaViewerType | string;\n  className?: string;\n  unloadOnExit?: boolean;\n  isCircular?: boolean;\n  /** Image type only — forwarded to ImageViewer's click-to-zoom toggle (which\n   *  defaults ON). Pass `false` to render a plain, non-zooming image surface.\n   *  Ignored for video/audio/other types. */\n  enableZoom?: ImageViewerProps[\"enableZoom\"];\n  priority?: boolean;\n  skeleton?: boolean;\n  lazy?: boolean;\n  /** Video controls only. Audio always renders the canonical package-owned controls. */\n  controls?: boolean;\n  autoPlay?: boolean;\n  muted?: boolean;\n  loop?: boolean;\n  posterUrl?: string;\n  preload?: \"auto\" | \"metadata\" | \"none\";\n  autoPlayOnVisible?: boolean;\n  onLoad?: () => void;\n  onError?: () => void;\n  onLoadChange?: (isLoading: boolean) => void;\n\n  // -------------------------------------------------------------------------\n  // Playback API (additive, optional) — forwarded to the video/audio viewer.\n  // Ignored for image/other types. See MediaPlaybackProps for the contract.\n  // -------------------------------------------------------------------------\n  onEnded?: MediaPlaybackProps[\"onEnded\"];\n  onProgressSample?: MediaPlaybackProps[\"onProgressSample\"];\n  startAtSeconds?: MediaPlaybackProps[\"startAtSeconds\"];\n  endOverlay?: MediaPlaybackProps[\"endOverlay\"];\n  playbackControlsRef?: MediaPlaybackProps[\"playbackControlsRef\"];\n\n  // Audio always uses the package-owned player. These props customize that\n  // single control surface and are ignored for every other media type.\n  audioVisualizerMode?: AudioVisualizerMode;\n  audioPersistKey?: string | null;\n  audioExtraActions?: React.ReactNode;\n\n  fallbackMode?: FallbackMode;\n  fallbackLabel?: string;\n  filename?: string;\n  mime?: string;\n  name?: string;\n\n  // -------------------------------------------------------------------------\n  // Recovery adapter (additive, optional — backward-compatible)\n  // -------------------------------------------------------------------------\n  /**\n   * Injected diagnostic adapter. When provided, element load errors for\n   * assets the app believes are live will trigger the bounded recovery state\n   * machine. When omitted, the existing error fallback behavior is unchanged.\n   */\n  recoveryAdapter?: MediaDiagnosticAdapter;\n\n  /**\n   * Optional app hint about the server-side lifecycle state of the asset.\n   * Drives which recovery phase is shown (e.g. processing → skeleton,\n   * finalizing → spinner, failed/rejected → hard error immediately).\n   */\n  assetStatusHint?: AssetStatusHint;\n\n  /** Load-watchdog budget forwarded to the underlying viewer — see BaseMediaProps. */\n  loadTimeoutMs?: number;\n};\n\n/** Back-compat alias */\nexport type MediaViewerProps = MediaPreviewProps;\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ttt-productions/media-viewer",
-  "version": "0.10.8",
+  "version": "0.10.10",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/ttt-productions/ttt-packages.git",
@@ -33,7 +33,7 @@
     "prepublishOnly": "npm run clean && npm run build"
   },
   "dependencies": {
-    "@ttt-productions/media-schemas": "^0.14.4",
+    "@ttt-productions/media-schemas": "^0.14.5",
     "@ttt-productions/ui-core": "^0.11.12"
   },
   "peerDependencies": {