@factorialco/f0-react 4.59.0 → 4.60.0

package/dist/experimental.d.ts

@@ -3315,7 +3315,15 @@ declare const defaultTranslations: {
         readonly position: "{{current}} of {{total}}";
         readonly viewDetail: "View detail";
         readonly hideDetail: "Hide detail";
+        readonly viewTranscription: "View transcription";
+        readonly hideTranscription: "Hide transcription";
+        readonly viewSummary: "View summary";
+        readonly hideSummary: "Hide summary";
         readonly details: "Recording details";
+        readonly summary: "Summary";
+        readonly transcription: "Transcription";
+        readonly language: "Language";
+        readonly audio: "Audio";
     };
     readonly actions: {
         readonly add: "Add";
@@ -4132,6 +4140,7 @@ declare const defaultTranslations: {
         readonly paused: "Paused";
         readonly mute: "Mute";
         readonly unmute: "Unmute";
+        readonly noAudio: "No audio";
         readonly volume: "Volume";
         readonly seekLabel: "Seek";
         readonly enterFullscreen: "Enter fullscreen";
@@ -4139,6 +4148,12 @@ declare const defaultTranslations: {
         readonly playbackSpeed: "Playback speed ({{rate}})";
         readonly playbackSpeedLabel: "Playback speed";
         readonly timeProgress: "{{current}} of {{total}}";
+        readonly captions: "Captions";
+        readonly audioDescription: "Audio description";
+        readonly audio: "Audio";
+        readonly subtitles: "Subtitles";
+        readonly settings: "Settings";
+        readonly off: "Off";
     };
 };
 

package/dist/experimental.js

@@ -1,10 +1,10 @@
-import { v as Sl, B as kl, x as Tl, y as Rl, z as Vo, A as Tn, E as ln, G as El, H as ue, J as zt, u as pe, R as Ll, K as zl, L as so, M as Hn, N as mn, O as Ve, Q as Al, U as Fl, V as ve, W as Pl, X as Ml, Y as Ie, Z as ea, _ as Ol, $ as Dl, m as Me, a0 as er, S as ie, a1 as Vt, a2 as Bl, a3 as _l, a4 as Hl, a5 as $l, a6 as Wl, a7 as ct, a8 as ta, a9 as na, aa as At, ab as $n, ac as jl, e as ra, ad as Wt, ae as oa, af as tr, w as tt, r as We, ag as Wn, ah as ia, ai as Vl, aj as aa, ak as Ue, s as Qe, al as Ul, am as Gl, an as Kl, ao as ql, ap as Yl, aq as Et, ar as nr, as as Xl, at as Ql, au as Jl, av as Zl, aw as rr, ax as sa, j as la, ay as ec, az as tc, k as jn, aA as nc, aB as ca, aC as rc, aD as oc, aE as ic, aF as ac, aG as sc, aH as da, aI as ua, aJ as fa, aK as Br, aL as ha, aM as _r, aN as ma, aO as lc, aP as cc, aQ as dc, aR as pa, aS as uc, aT as nt, aU as Zt, aV as Hr, aW as ga, aX as fc, aY as or, aZ as hc, a_ as mc, a$ as pc, b0 as Jt, b1 as gc, b2 as bc, b3 as dn, b4 as Uo, b5 as $r, b6 as vc, b7 as xc, b as ba, b8 as yc, a as wc, b9 as ir, ba as Nc, g as Cc, F as Ic, bb as Sc, bc as va, bd as kc, o as lo, be as Tc, bf as co, bg as en, bh as Rc, bi as Ec, bj as Lc, bk as zc, bl as xa, bm as Ac, bn as Fc, bo as Pc, bp as Wr, bq as Mc, br as Oc, bs as Dc, bt as uo, bu as Bc, bv as _c, bw as Hc, bx as $c, by as Wc, bz as jc, bA as Vc, bB as ya, bC as wa, bD as Na, bE as Uc, bF as Gc, bG as Kc, bH as qc, bI as Yc, bJ as Ca, bK as Xc, bL as Qc, bM as Ia, bN as fo, bO as Jc, bP as Zc, bQ as ed, n as td, bR as nd, bS as Sa, bT as rd, bU as od, bV as ka, bW as Ta, bX as Ra, l as Vn, bY as id, bZ as Go, b_ as Ea, b$ as ad, c0 as sd, c1 as ld, c2 as jr, c3 as Vr, c4 as cd, c5 as dd, c6 as ud, c7 as fd, c8 as hd, c9 as md, ca as pd, cb as St, cc as ho, cd as mo, ce as po, cf as La, cg as go, ch as za, ci as Aa, cj as gd, ck as bd, cl as vd, cm as xd, cn as yd, co as wd, cp as Nd, cq as Ko, cr as Cd, cs as Id, ct as qo, cu as Sd, cv as kd, cw as Td, cx as Rd, cy as Fa, cz as Ed, cA as Ld } from "./F0CanvasPanel-Bm-rOddX.js";
-import { cL as R0, cK as E0, cX as L0, cH as z0, cI as A0, cB as F0, cC as P0, cC as M0, cD as O0, cE as D0, c_ as B0, cJ as _0, cT as H0, cU as $0, cY as W0, cF as j0, cN as V0, cM as U0, T as G0, h as K0, cV as q0, c$ as Y0, cW as X0, cZ as Q0, cS as J0, cP as Z0, cR as ex, cO as tx, cG as nx, cQ as rx } from "./F0CanvasPanel-Bm-rOddX.js";
+import { v as Sl, B as kl, x as Tl, y as Rl, z as Vo, A as Tn, E as ln, G as El, H as ue, J as zt, u as pe, R as Ll, K as zl, L as so, M as Hn, N as mn, O as Ve, Q as Al, U as Fl, V as ve, W as Pl, X as Ml, Y as Ie, Z as ea, _ as Ol, $ as Dl, m as Me, a0 as er, S as ie, a1 as Vt, a2 as Bl, a3 as _l, a4 as Hl, a5 as $l, a6 as Wl, a7 as ct, a8 as ta, a9 as na, aa as At, ab as $n, ac as jl, e as ra, ad as Wt, ae as oa, af as tr, w as tt, r as We, ag as Wn, ah as ia, ai as Vl, aj as aa, ak as Ue, s as Qe, al as Ul, am as Gl, an as Kl, ao as ql, ap as Yl, aq as Et, ar as nr, as as Xl, at as Ql, au as Jl, av as Zl, aw as rr, ax as sa, j as la, ay as ec, az as tc, k as jn, aA as nc, aB as ca, aC as rc, aD as oc, aE as ic, aF as ac, aG as sc, aH as da, aI as ua, aJ as fa, aK as Br, aL as ha, aM as _r, aN as ma, aO as lc, aP as cc, aQ as dc, aR as pa, aS as uc, aT as nt, aU as Zt, aV as Hr, aW as ga, aX as fc, aY as or, aZ as hc, a_ as mc, a$ as pc, b0 as Jt, b1 as gc, b2 as bc, b3 as dn, b4 as Uo, b5 as $r, b6 as vc, b7 as xc, b as ba, b8 as yc, a as wc, b9 as ir, ba as Nc, g as Cc, F as Ic, bb as Sc, bc as va, bd as kc, o as lo, be as Tc, bf as co, bg as en, bh as Rc, bi as Ec, bj as Lc, bk as zc, bl as xa, bm as Ac, bn as Fc, bo as Pc, bp as Wr, bq as Mc, br as Oc, bs as Dc, bt as uo, bu as Bc, bv as _c, bw as Hc, bx as $c, by as Wc, bz as jc, bA as Vc, bB as ya, bC as wa, bD as Na, bE as Uc, bF as Gc, bG as Kc, bH as qc, bI as Yc, bJ as Ca, bK as Xc, bL as Qc, bM as Ia, bN as fo, bO as Jc, bP as Zc, bQ as ed, n as td, bR as nd, bS as Sa, bT as rd, bU as od, bV as ka, bW as Ta, bX as Ra, l as Vn, bY as id, bZ as Go, b_ as Ea, b$ as ad, c0 as sd, c1 as ld, c2 as jr, c3 as Vr, c4 as cd, c5 as dd, c6 as ud, c7 as fd, c8 as hd, c9 as md, ca as pd, cb as St, cc as ho, cd as mo, ce as po, cf as La, cg as go, ch as za, ci as Aa, cj as gd, ck as bd, cl as vd, cm as xd, cn as yd, co as wd, cp as Nd, cq as Ko, cr as Cd, cs as Id, ct as qo, cu as Sd, cv as kd, cw as Td, cx as Rd, cy as Fa, cz as Ed, cA as Ld } from "./F0CanvasPanel-DZnIZ1lj.js";
+import { cL as R0, cK as E0, cX as L0, cH as z0, cI as A0, cB as F0, cC as P0, cC as M0, cD as O0, cE as D0, c_ as B0, cJ as _0, cT as H0, cU as $0, cY as W0, cF as j0, cN as V0, cM as U0, T as G0, h as K0, cV as q0, c$ as Y0, cW as X0, cZ as Q0, cS as J0, cP as Z0, cR as ex, cO as tx, cG as nx, cQ as rx } from "./F0CanvasPanel-DZnIZ1lj.js";
 import { jsx as n, jsxs as m, Fragment as De } from "react/jsx-runtime";
 import Q, { forwardRef as Ae, useRef as _, useTransition as zd, useState as $, useLayoutEffect as ar, useId as Ur, useContext as Nt, createContext as st, useEffect as te, useCallback as K, useMemo as he, Fragment as Rt, isValidElement as Ad, cloneElement as Pa, Suspense as bo, lazy as tn, createElement as Mn, memo as Ma, Children as Oa } from "react";
 import { d as S, T as Fd, a as Pd, b as Md, f as Je, c as Od } from "./tooltip-BH6Se8A4.js";
-import { C as Dd, P as Bd, a as Nn, M as _d, p as Hd, b as $d, R as Yo, c as Da, u as Wd, e as jd, f as Vd, g as Ud, h as Gd, i as Kd, O as Ba, j as _a, S as qd, A as Yd, B as Xd, L as Qd, k as Jd, V as Zd, l as eu, m as tu, n as nu } from "./index-CbHjzW27.js";
-import { a3 as ix, a4 as ax, t as sx, v as lx, r as cx, J as dx, w as ux, E as fx, ae as hx, I as mx, s as px, a1 as gx, ag as bx, af as vx, U as xx, aj as yx, F as wx, _ as Nx, X as Cx, N as Ix, al as Sx, Q as kx, $ as Tx, a0 as Rx, x as Ex, ah as Lx, ai as zx, T as Ax, a2 as Fx, ab as Px, ad as Mx, y as Ox, D as Dx, G as Bx, Y as _x, ak as Hx, Z as $x, W as Wx, am as jx, z as Vx, H as Ux, o as Gx, q as Kx, a7 as qx, a8 as Yx, a5 as Xx, ac as Qx, K as Jx, a9 as Zx, a6 as e1, aa as t1 } from "./index-CbHjzW27.js";
+import { C as Dd, P as Bd, a as Nn, M as _d, p as Hd, b as $d, R as Yo, c as Da, u as Wd, e as jd, f as Vd, g as Ud, h as Gd, i as Kd, O as Ba, j as _a, S as qd, A as Yd, B as Xd, L as Qd, k as Jd, V as Zd, l as eu, m as tu, n as nu } from "./index-B00tg7uM.js";
+import { a3 as ix, a4 as ax, t as sx, v as lx, r as cx, J as dx, w as ux, E as fx, ae as hx, I as mx, s as px, a1 as gx, ag as bx, af as vx, U as xx, aj as yx, F as wx, _ as Nx, X as Cx, N as Ix, al as Sx, Q as kx, $ as Tx, a0 as Rx, x as Ex, ah as Lx, ai as zx, T as Ax, a2 as Fx, ab as Px, ad as Mx, y as Ox, D as Dx, G as Bx, Y as _x, ak as Hx, Z as $x, W as Wx, am as jx, z as Vx, H as Ux, o as Gx, q as Kx, a7 as qx, a8 as Yx, a5 as Xx, ac as Qx, K as Jx, a9 as Zx, a6 as e1, aa as t1 } from "./index-B00tg7uM.js";
 import ru from "react-dom";
 const ou = Sl("Search", [
   ["circle", { cx: "11", cy: "11", r: "8", key: "4ej97u" }],
@@ -8425,7 +8425,7 @@ const $h = {
     ] })
   ] }) });
 }, Jh = tn(
-  () => import("./index-BihWWw-L.js").then((e) => e.i).then((e) => ({
+  () => import("./index-BjppyLWI.js").then((e) => e.i).then((e) => ({
     default: e.F0PdfViewer
   }))
 ), Zh = () => {
@@ -12641,7 +12641,7 @@ const Wp = (e) => {
       }
     )
   ] });
-}, Jp = tn(() => import("./ChatPdfThumbnail-DECZZzOT.js")), Zp = tn(() => import("./ChatSheetThumbnail-BvnxT-4A.js")), eg = tn(() => import("./ChatDocxThumbnail-DzNPNFya.js")), tg = tn(() => import("./ChatTextThumbnail-yVt_iYi7.js")), Fr = 288, ng = 160, rg = (e) => {
+}, Jp = tn(() => import("./ChatPdfThumbnail-C6f0btcZ.js")), Zp = tn(() => import("./ChatSheetThumbnail-BvnxT-4A.js")), eg = tn(() => import("./ChatDocxThumbnail-DzNPNFya.js")), tg = tn(() => import("./ChatTextThumbnail-yVt_iYi7.js")), Fr = 288, ng = 160, rg = (e) => {
   const [t, r] = $(!1);
   return te(() => {
     const o = e.current;

package/dist/f0.d.ts

@@ -1268,6 +1268,38 @@ export declare type AttachedFile = {
     errorMessage?: string;
 };
 
+/**
+ * Structured detail content for {@link F0AudioPlayerCardProps.content}.
+ *
+ * Pass a `summary` and/or a `transcription` string and the card builds the
+ * tabbed "View detail" panel for you, with labels pulled from translations
+ * (`audioPlayer.summary` / `audioPlayer.transcription`) — you no longer wire up
+ * the tabs yourself as with the deprecated `details` array.
+ *
+ * A transcription is what makes an audio-only recording accessible
+ * (WCAG 2.1 SC 1.2.1, Audio-only). When you omit `transcription`, the card
+ * still tries to derive one from the audio file's own text tracks; if none can
+ * be passed or derived, the recording is flagged in the accessibility checks.
+ *
+ * Both fields are localizable — pass a per-locale list
+ * (`[{ locale, label?, value }]`) to offer several languages, and a language
+ * selector appears in the detail panel (a single selection drives both tabs).
+ */
+export declare interface AudioPlayerContent {
+    /**
+     * Plain-text summary of the recording, shown in the "Summary" tab.
+     * Localizable.
+     */
+    summary?: Localized<string>;
+    /**
+     * Plain-text transcription of the recording, shown in the "Transcription"
+     * tab. Line breaks are preserved. When omitted, the card attempts to derive
+     * a transcription from the audio file's embedded/attached text tracks.
+     * Localizable.
+     */
+    transcription?: Localized<string>;
+}
+
 export declare interface AudioPlayerControls extends AudioPlayerState {
     play: () => void;
     pause: () => void;
@@ -1276,6 +1308,11 @@ export declare interface AudioPlayerControls extends AudioPlayerState {
     setPlaybackRate: (rate: number) => void;
 }
 
+/**
+ * @deprecated Prefer the structured `content` prop
+ * ({@link AudioPlayerContent}). The raw tab array is still honoured for now for
+ * backward compatibility, but will be removed in a future release.
+ */
 export declare interface AudioPlayerDetailTab {
     /** Stable value used to identify the tab. */
     value: string;
@@ -4529,7 +4566,15 @@ export declare const defaultTranslations: {
         readonly position: "{{current}} of {{total}}";
         readonly viewDetail: "View detail";
         readonly hideDetail: "Hide detail";
+        readonly viewTranscription: "View transcription";
+        readonly hideTranscription: "Hide transcription";
+        readonly viewSummary: "View summary";
+        readonly hideSummary: "Hide summary";
         readonly details: "Recording details";
+        readonly summary: "Summary";
+        readonly transcription: "Transcription";
+        readonly language: "Language";
+        readonly audio: "Audio";
     };
     readonly actions: {
         readonly add: "Add";
@@ -5346,6 +5391,7 @@ export declare const defaultTranslations: {
         readonly paused: "Paused";
         readonly mute: "Mute";
         readonly unmute: "Unmute";
+        readonly noAudio: "No audio";
         readonly volume: "Volume";
         readonly seekLabel: "Seek";
         readonly enterFullscreen: "Enter fullscreen";
@@ -5353,6 +5399,12 @@ export declare const defaultTranslations: {
         readonly playbackSpeed: "Playback speed ({{rate}})";
         readonly playbackSpeedLabel: "Playback speed";
         readonly timeProgress: "{{current}} of {{total}}";
+        readonly captions: "Captions";
+        readonly audioDescription: "Audio description";
+        readonly audio: "Audio";
+        readonly subtitles: "Subtitles";
+        readonly settings: "Settings";
+        readonly off: "Off";
     };
 };
 
@@ -7113,10 +7165,23 @@ export declare interface F0AudioPlayerCardProps extends F0AudioPlayerProps {
      * is always rendered by the card.
      */
     actions?: AudioPlayerMenuAction[];
+    /**
+     * Structured detail content revealed by a "View detail" toggle in the header:
+     * a `summary` and/or a `transcription`. The card renders the tabs with
+     * translated labels. Providing a `transcription` (or shipping one in the
+     * audio file) keeps the recording accessible. Takes precedence over the
+     * deprecated `details` prop when both are set.
+     */
+    content?: AudioPlayerContent;
     /**
      * Tabbed detail content revealed by a "View detail" toggle in the header
      * (e.g. a Summary and a Transcript tab). When omitted or empty, no toggle and
      * no panel are rendered and the card behaves like a plain recording player.
+     *
+     * @deprecated Use the structured {@link F0AudioPlayerCardProps.content} prop
+     * instead (`{ summary, transcription }`). This raw tab array is still
+     * honoured for backward compatibility but will be removed in a future
+     * release.
      */
     details?: AudioPlayerDetailTab[];
     /**
@@ -7146,8 +7211,19 @@ export declare interface F0AudioPlayerProps extends WithDataTestIdProps, DataAtt
      * the URL the first time playback is requested. Use the function form for
      * on-demand credentials (e.g. presigned URLs) so the URL is only fetched on
      * user intent.
+     *
+     * Localizable — pass a per-locale list of dubbed recordings to offer
+     * selectable audio languages; a language selector then appears (in the card's
+     * kebab menu, or inline on the bare player).
+     */
+    src: Localized<string | (() => Promise<string>)>;
+    /**
+     * Initial language for localized content — the audio `src` and, on the card,
+     * the detail `content` (summary/transcription). Matched against the provided
+     * locales exactly or by primary subtag, then the viewer's browser language,
+     * then the first provided. Only relevant when more than one language is given.
      */
-    src: string | (() => Promise<string>);
+    defaultLanguage?: string;
     /**
      * Known total duration in seconds. Lets the player show the total time and an
      * active seek bar before the audio loads (e.g. with `preload="none"`).
@@ -11973,11 +12049,54 @@ export declare const F0VideoPlayer: WithDataTestIdReturnType_3<typeof F0VideoPla
  *   useRestrictForwardSeek  → blocks seeking past the furthest-watched point.
  *   <Controls>              → presentation only; interactions delegated back here.
  */
-declare function F0VideoPlayerInternal({ src, autoPlay, autoFocus, restrictForwardSeek, onTrackAction, onMilestone, onComplete, ...dataAttributes }: F0VideoPlayerProps): JSX_2.Element;
+declare function F0VideoPlayerInternal({ src, poster, silent, persistControls, content, defaultLanguage, autoPlay, autoFocus, restrictForwardSeek, onTrackAction, onMilestone, onComplete, ...dataAttributes }: F0VideoPlayerProps): JSX_2.Element;
 
 export declare interface F0VideoPlayerProps extends DataAttributes_2 {
-    /** Video source URL. */
-    src: string;
+    /**
+     * Video source URL. Localizable — pass a per-locale list of dubbed renditions
+     * to offer selectable audio languages; an "Audio" selector then appears,
+     * independent of the subtitle/caption language.
+     */
+    src: Localized<string>;
+    /**
+     * Initial language for localized content, matched against the provided
+     * locales exactly or by primary subtag, then the viewer's browser language,
+     * then the first provided. Applies to both the audio (`src`) and the text
+     * (`content`) language selections. Only relevant when more than one language
+     * is available.
+     */
+    defaultLanguage?: string;
+    /**
+     * Image URL shown while the video loads and before playback starts (the
+     * native `<video>` poster). Cleared by the browser once playback begins.
+     */
+    poster?: string;
+    /**
+     * Marks the video as having no audio (video-only). Captions (WCAG 2.1
+     * SC 1.2.2) don't apply to silent media, so this exempts the player from the
+     * captions requirement — `data-video-captions` is set to `"no-audio"` instead
+     * of `"missing"`. Note video-only content may still need a text/audio
+     * alternative for its visual information (SC 1.2.1) — audio description still
+     * works over a silent video (its description audio plays even though the video
+     * itself is muted). Browsers can't reliably detect the absence of audio before
+     * playback, so this is declared explicitly.
+     * @default false
+     */
+    silent?: boolean;
+    /**
+     * Structured content for the player. Currently carries `captions` (a WebVTT
+     * URL or raw WebVTT string) shown over the video during playback and
+     * toggled with the "CC" control. When `captions` is omitted, captions
+     * embedded in the video file are used instead.
+     */
+    content?: VideoPlayerContent;
+    /**
+     * Keep the controls bar visible during playback instead of auto-hiding it.
+     * By default the controls show while the video is paused and auto-hide while
+     * it plays (revealing on hover or keyboard focus); set this to keep them
+     * visible the whole time. Default `false`.
+     */
+    persistControls?: boolean;
     /** Start playing on mount. Default `false`. */
     autoPlay?: boolean;
     /** Focus the player on mount so keyboard shortcuts work immediately. Default `false`. */
@@ -13702,6 +13821,26 @@ export declare interface LoadingStateProps {
     label: string;
 }
 
+/** A single value, or the same value provided in multiple languages. */
+declare type Localized<T> = T | LocalizedOption<T>[];
+
+/**
+ * Shared helpers for content that can be provided in one language (a plain
+ * value) or several (a list of per-locale entries) — used by the media players
+ * for captions, descriptions, transcriptions and summaries.
+ */
+declare interface LocalizedOption<T> {
+    /** BCP-47 language tag, e.g. `"en"`, `"es"`, `"en-US"`. */
+    locale: string;
+    /**
+     * Display label for the language picker. Defaults to the language name for
+     * `locale` (via `Intl.DisplayNames`), so this is only needed to override it.
+     */
+    label?: string;
+    /** The value for this locale. */
+    value: T;
+}
+
 export declare type LockedQuestionNotice = {
     description: string;
 };
@@ -17702,6 +17841,26 @@ export declare interface UseDataSourceItemNavigationReturn<R extends RecordType>
     previousItemUrl: string | null;
 }
 
+/**
+ * Derives a transcription from the audio element's text tracks, so a recording
+ * that ships its own transcript surfaces one even when the consumer doesn't
+ * pass `content.transcription`.
+ *
+ * Tracks are read in-band-first (embedded in the file), then from out-of-band
+ * `<track>` children as a fallback — both live on `audio.textTracks`. Cues load
+ * asynchronously, so the hook watches for tracks and cue changes and re-reads
+ * until it finds text.
+ *
+ * @param audioRef   ref to the player's `<audio>` element
+ * @param currentSrc the resolved source URL; derivation restarts when it
+ *                   changes so a new file's tracks replace the old ones
+ * @param enabled    when `false`, derivation is skipped (e.g. a transcription
+ *                   was already passed explicitly) and the hook returns
+ *                   `undefined`
+ * @returns the joined cue text, or `undefined` while none is available
+ */
+export declare const useDerivedTranscription: (audioRef: RefObject<HTMLAudioElement>, currentSrc: string | undefined, enabled: boolean) => string | undefined;
+
 export declare function useDndEvents(handler: (e: {
     phase: "start" | "over" | "drop" | "cancel";
     source: DragPayload;
@@ -18293,6 +18452,56 @@ showRatio?: boolean;
 valueFormatter?: (value: string | number | undefined) => string | number;
 } & RefAttributes<HTMLDivElement>, "ref"> & RefAttributes<HTMLElement | SVGElement>>>;
 
+/**
+ * Structured content for the video player.
+ *
+ * Every field accepts either a single value or a localized list
+ * (`[{ locale, label?, value }]`) — pass several languages and a language
+ * selector appears in the controls. A single shared selection drives captions,
+ * descriptions and the described source together (each falls back to its first
+ * entry for languages it doesn't provide). See `F0VideoPlayerProps.defaultLanguage`.
+ *
+ * `captions` are timed text shown over the video during playback (WCAG 2.1
+ * SC 1.2.2, Captions). Pass either a WebVTT resource URL or a raw WebVTT string
+ * (the player turns raw VTT into a blob track, so no CORS setup is needed); a
+ * remote URL requires the video host to allow cross-origin reads. When omitted,
+ * the player uses any caption/subtitle track embedded in the video file. A
+ * captions toggle in the controls shows/hides them (a filled glyph when on, a
+ * line glyph when off).
+ *
+ * Audio description (WCAG 2.1 SC 1.2.5) conveys on-screen visual information as
+ * audio, complementary to captions — both are independent and can be on at
+ * once. Provide it in one of two ways, toggled with the audio-description
+ * control (a filled "AD" badge when on, a line badge when off):
+ * - `describedSrc`: a pre-produced media rendition with description mixed into
+ *   the audio. Toggling swaps the source, preserving position and play state.
+ *   Highest quality; assumed the same length as `src`.
+ * - `descriptions`: a WebVTT `kind="descriptions"` script (URL or raw VTT),
+ *   delivered at runtime — the video pauses on each cue so the description can
+ *   be spoken (extended audio description), then resumes. Used only when
+ *   `describedSrc` is absent.
+ */
+export declare interface VideoPlayerContent {
+    /**
+     * WebVTT URL, or raw WebVTT content, for captions shown during playback.
+     * Localizable — pass a per-locale list to offer captions in several languages.
+     */
+    captions?: Localized<string>;
+    /**
+     * A pre-produced described media source (description mixed into the audio),
+     * swapped in when audio description is enabled. Takes precedence over
+     * `descriptions`. Should match `src`'s duration so the position carries
+     * across the swap. Localizable.
+     */
+    describedSrc?: Localized<string>;
+    /**
+     * WebVTT URL, or raw WebVTT content, of a `kind="descriptions"` script.
+     * Delivered at runtime with extended (pausing) audio description when no
+     * `describedSrc` is provided. Localizable.
+     */
+    descriptions?: Localized<string>;
+}
+
 declare type VisualizacionTypeDefinition<Props, Settings = Record<string, never>> = {
     render: (props: Props) => JSX.Element;
     name: string;