@mieweb/ui 0.10.0-dev.9 → 0.11.0-dev.0

package/dist/components/Markdown/index.cjs

@@ -1,12 +1,14 @@
 'use strict';
 
-var chunkZPSJ2UV6_cjs = require('../../chunk-ZPSJ2UV6.cjs');
-var chunk3QEVGSFG_cjs = require('../../chunk-3QEVGSFG.cjs');
-var chunkIX6KFB3K_cjs = require('../../chunk-IX6KFB3K.cjs');
-var chunk7ZXAQTV4_cjs = require('../../chunk-7ZXAQTV4.cjs');
-var chunk5MCBWTIF_cjs = require('../../chunk-5MCBWTIF.cjs');
-var chunkUV2FVNWT_cjs = require('../../chunk-UV2FVNWT.cjs');
-require('../../chunk-VNYW4C4J.cjs');
+var chunkNAH65KPK_cjs = require('../../chunk-NAH65KPK.cjs');
+var chunkSW2E7XKY_cjs = require('../../chunk-SW2E7XKY.cjs');
+var chunkERACGSDY_cjs = require('../../chunk-ERACGSDY.cjs');
+var chunk32ZCJOSR_cjs = require('../../chunk-32ZCJOSR.cjs');
+var chunkIGDO62KR_cjs = require('../../chunk-IGDO62KR.cjs');
+var chunkRIUQP2QS_cjs = require('../../chunk-RIUQP2QS.cjs');
+require('../../chunk-EACNRR3C.cjs');
+require('../../chunk-ANMX7YDL.cjs');
+require('../../chunk-DXEPYK3I.cjs');
 require('../../chunk-S5RVSXDV.cjs');
 require('../../chunk-EUAMEVVI.cjs');
 
@@ -14,39 +16,39 @@ require('../../chunk-EUAMEVVI.cjs');
 
 Object.defineProperty(exports, "CodeBlock", {
   enumerable: true,
-  get: function () { return chunkZPSJ2UV6_cjs.CodeBlock; }
+  get: function () { return chunkNAH65KPK_cjs.CodeBlock; }
 });
 Object.defineProperty(exports, "MarkdownRenderer", {
   enumerable: true,
-  get: function () { return chunkZPSJ2UV6_cjs.MarkdownRenderer; }
+  get: function () { return chunkNAH65KPK_cjs.MarkdownRenderer; }
 });
 Object.defineProperty(exports, "highlightCode", {
   enumerable: true,
-  get: function () { return chunkZPSJ2UV6_cjs.highlightCode; }
+  get: function () { return chunkNAH65KPK_cjs.highlightCode; }
 });
 Object.defineProperty(exports, "useMarkdown", {
   enumerable: true,
-  get: function () { return chunkZPSJ2UV6_cjs.useMarkdown; }
-});
-Object.defineProperty(exports, "SurveyBlock", {
-  enumerable: true,
-  get: function () { return chunk3QEVGSFG_cjs.SurveyBlock; }
+  get: function () { return chunkNAH65KPK_cjs.useMarkdown; }
 });
 Object.defineProperty(exports, "CsvBlock", {
   enumerable: true,
-  get: function () { return chunkIX6KFB3K_cjs.CsvBlock; }
+  get: function () { return chunkSW2E7XKY_cjs.CsvBlock; }
 });
 Object.defineProperty(exports, "HtmlPreviewBlock", {
   enumerable: true,
-  get: function () { return chunk7ZXAQTV4_cjs.HtmlPreviewBlock; }
+  get: function () { return chunkERACGSDY_cjs.HtmlPreviewBlock; }
 });
 Object.defineProperty(exports, "MermaidBlock", {
   enumerable: true,
-  get: function () { return chunk5MCBWTIF_cjs.MermaidBlock; }
+  get: function () { return chunk32ZCJOSR_cjs.MermaidBlock; }
+});
+Object.defineProperty(exports, "SurveyBlock", {
+  enumerable: true,
+  get: function () { return chunkIGDO62KR_cjs.SurveyBlock; }
 });
 Object.defineProperty(exports, "FenceBlock", {
   enumerable: true,
-  get: function () { return chunkUV2FVNWT_cjs.FenceBlock; }
+  get: function () { return chunkRIUQP2QS_cjs.FenceBlock; }
 });
 //# sourceMappingURL=index.cjs.map
 //# sourceMappingURL=index.cjs.map

package/dist/components/Markdown/index.js

@@ -1,10 +1,12 @@
-export { CodeBlock, MarkdownRenderer, highlightCode, useMarkdown } from '../../chunk-MNILXWVY.js';
-export { SurveyBlock } from '../../chunk-DEDN5HAG.js';
-export { CsvBlock } from '../../chunk-TMMVIUUN.js';
-export { HtmlPreviewBlock } from '../../chunk-V7D3YGUV.js';
-export { MermaidBlock } from '../../chunk-KZFBQ7GY.js';
-export { FenceBlock } from '../../chunk-H4ZXMQQW.js';
-import '../../chunk-GOALNQZ2.js';
+export { CodeBlock, MarkdownRenderer, highlightCode, useMarkdown } from '../../chunk-QJ2L5RU6.js';
+export { CsvBlock } from '../../chunk-P7D7BYFE.js';
+export { HtmlPreviewBlock } from '../../chunk-FGLIP6YR.js';
+export { MermaidBlock } from '../../chunk-7QW6TU4X.js';
+export { SurveyBlock } from '../../chunk-RSJGTWLM.js';
+export { FenceBlock } from '../../chunk-HDY7YQFX.js';
+import '../../chunk-N5JDL4VE.js';
+import '../../chunk-WFBUBT54.js';
+import '../../chunk-GVM6DTR5.js';
 import '../../chunk-TQONQSJO.js';
 import '../../chunk-PX6F3LHL.js';
 //# sourceMappingURL=index.js.map

package/dist/components/MediaEditor/index.cjs

@@ -1,23 +1,25 @@
 'use strict';
 
-var chunkWNZAYBVB_cjs = require('../../chunk-WNZAYBVB.cjs');
+var chunkO6BJMVGT_cjs = require('../../chunk-O6BJMVGT.cjs');
 require('../../chunk-MYAU2ZUC.cjs');
-require('../../chunk-XEAT7XJG.cjs');
+require('../../chunk-KQ6GLYFZ.cjs');
 require('../../chunk-7AECNMYV.cjs');
 require('../../chunk-NPKPCYAT.cjs');
 require('../../chunk-NUFUV43P.cjs');
-require('../../chunk-JYZW2PZS.cjs');
-require('../../chunk-UQ3VVR6A.cjs');
+require('../../chunk-254QK722.cjs');
+require('../../chunk-UPWIJC6I.cjs');
+require('../../chunk-LC3JL2HB.cjs');
 require('../../chunk-I44YNYI6.cjs');
 require('../../chunk-Z5S5JEJD.cjs');
-require('../../chunk-FSGEDDF2.cjs');
-require('../../chunk-AOHJILLU.cjs');
-require('../../chunk-7ZDPD5ZX.cjs');
 require('../../chunk-NNEFAUHV.cjs');
 require('../../chunk-FHY3K6PL.cjs');
+require('../../chunk-FSGEDDF2.cjs');
+require('../../chunk-AOHJILLU.cjs');
 require('../../chunk-SCV7C55E.cjs');
-require('../../chunk-VNYW4C4J.cjs');
-require('../../chunk-NV2CWBI2.cjs');
+require('../../chunk-EACNRR3C.cjs');
+require('../../chunk-ANMX7YDL.cjs');
+require('../../chunk-DXEPYK3I.cjs');
+require('../../chunk-IEY3ZJIT.cjs');
 require('../../chunk-S5RVSXDV.cjs');
 require('../../chunk-EUAMEVVI.cjs');
 
@@ -25,23 +27,23 @@ require('../../chunk-EUAMEVVI.cjs');
 
 Object.defineProperty(exports, "FillerWordsModal", {
   enumerable: true,
-  get: function () { return chunkWNZAYBVB_cjs.FillerWordsModal; }
+  get: function () { return chunkO6BJMVGT_cjs.FillerWordsModal; }
 });
 Object.defineProperty(exports, "MediaEditor", {
   enumerable: true,
-  get: function () { return chunkWNZAYBVB_cjs.MediaEditor; }
+  get: function () { return chunkO6BJMVGT_cjs.MediaEditor; }
 });
 Object.defineProperty(exports, "SilenceSettingsModal", {
   enumerable: true,
-  get: function () { return chunkWNZAYBVB_cjs.SilenceSettingsModal; }
+  get: function () { return chunkO6BJMVGT_cjs.SilenceSettingsModal; }
 });
 Object.defineProperty(exports, "SpeedMarkerMenu", {
   enumerable: true,
-  get: function () { return chunkWNZAYBVB_cjs.SpeedMarkerMenu; }
+  get: function () { return chunkO6BJMVGT_cjs.SpeedMarkerMenu; }
 });
 Object.defineProperty(exports, "WordEditorModal", {
   enumerable: true,
-  get: function () { return chunkWNZAYBVB_cjs.WordEditorModal; }
+  get: function () { return chunkO6BJMVGT_cjs.WordEditorModal; }
 });
 //# sourceMappingURL=index.cjs.map
 //# sourceMappingURL=index.cjs.map

package/dist/components/MediaEditor/index.d.cts

@@ -1,9 +1,78 @@
 import * as class_variance_authority_types from 'class-variance-authority/types';
 import * as React from 'react';
 import { VariantProps } from 'class-variance-authority';
-import { T as Transcript, E as EditableWord, S as SpeedMarker, P as PlaybackSpeed } from '../../transcript-Cg7uSW-C.cjs';
 import { MediaKind, MediaPlayerRef } from '../MediaPlayer/index.cjs';
-import { S as SilenceThresholdCount } from '../../useTranscriptEdits-CGzlemHT.cjs';
+
+/**
+ * Transcript schema for @mieweb/ui media components.
+ *
+ * Provider-agnostic and persistence-agnostic. Canonical time unit is
+ * **milliseconds** (consumers with seconds-based data, e.g. osheet, adapt
+ * at the boundary).
+ *
+ * Shared by TranscriptView, MediaEditor, and useTranscriptEdits.
+ */
+/** Type of transcript word - 'word' for spoken content, 'silence' for detected gaps, 'silence-newline' for longer pauses */
+type WordType = 'word' | 'silence' | 'silence-newline';
+interface TranscriptWord {
+    text: string;
+    startMs: number;
+    endMs: number;
+    /** References Speaker.id when diarization is available */
+    speakerId?: string;
+    confidence?: number;
+    /** Type of word: 'word' for spoken content, 'silence' for detected gaps. Defaults to 'word' */
+    wordType?: WordType;
+}
+/** A diarized segment of contiguous speech (osheet-style granularity) */
+interface TranscriptSegment {
+    text: string;
+    startMs: number;
+    endMs: number;
+    /** References Speaker.id when diarization is available */
+    speakerId?: string;
+    words: TranscriptWord[];
+}
+interface Speaker {
+    id: string;
+    /** Display name (e.g. 'Clinician', 'Patient'). Hosts may remap via speakerLabels props. */
+    name?: string;
+}
+interface Transcript {
+    durationMs: number;
+    speakers?: Speaker[];
+    words: TranscriptWord[];
+    segments?: TranscriptSegment[];
+}
+/**
+ * An editable word that references the original transcript word.
+ * Used in the edited timeline to track deletions and reordering.
+ */
+interface EditableWord {
+    /** Index into the SILENCE-INSERTED baseline timeline (transcript.words
+     *  with detected silence pseudo-words interleaved) — NOT into
+     *  transcript.words. -1 for split/inserted entries with no baseline slot.
+     *  Consumers persisting edits should key by this timeline. */
+    originalIndex: number;
+    /** The word data (from original transcript) */
+    word: TranscriptWord;
+    /** Whether this word is marked as deleted */
+    deleted: boolean;
+    /** Whether this word was inserted (pasted from clipboard) */
+    inserted?: boolean;
+}
+/** Available playback speed multipliers */
+type PlaybackSpeed = 0.5 | 0.75 | 1 | 1.25 | 1.5 | 1.75 | 2;
+/**
+ * A speed marker applied to a word in the transcript.
+ * The speed applies from this word until the next speed marker or end of transcript.
+ */
+interface SpeedMarker {
+    /** Index in the editedWords array where the speed marker is placed */
+    wordIndex: number;
+    /** The playback speed multiplier */
+    speed: PlaybackSpeed;
+}
 
 interface MediaEditorProps extends VariantProps<typeof mediaEditorVariants> {
     /** Media URL */
@@ -85,6 +154,26 @@ declare const mediaEditorVariants: (props?: ({
  */
 declare const MediaEditor: React.ForwardRefExoticComponent<MediaEditorProps & React.RefAttributes<HTMLDivElement>>;
 
+/**
+ * useTranscriptEdits — headless transcript-editing state hook.
+ *
+ * Extracted from pulseclip's TranscriptViewer for @mieweb/ui. Holds the
+ * edited word timeline (deletions, insertions, text edits, silence
+ * splitting), a single-level undo stack, an internal clipboard, speed
+ * markers, and derived playback/statistics data.
+ *
+ * Controlled + persistence-agnostic: no DOM, no fetches. Selection lives in
+ * the UI layer — mutations take explicit indices. State flows out via
+ * `onChange` and back in via `initialEditedWords` / `initialUndoStack`.
+ */
+
+/** Count and total duration of silences above a given threshold (seconds) */
+interface SilenceThresholdCount {
+    threshold: number;
+    count: number;
+    durationMs: number;
+}
+
 /**
  * FillerWordsModal — select filler words (and long silences) to mark deleted.
  *

package/dist/components/MediaEditor/index.d.ts

@@ -1,9 +1,78 @@
 import * as class_variance_authority_types from 'class-variance-authority/types';
 import * as React from 'react';
 import { VariantProps } from 'class-variance-authority';
-import { T as Transcript, E as EditableWord, S as SpeedMarker, P as PlaybackSpeed } from '../../transcript-Cg7uSW-C.js';
 import { MediaKind, MediaPlayerRef } from '../MediaPlayer/index.js';
-import { S as SilenceThresholdCount } from '../../useTranscriptEdits-D32bLs0l.js';
+
+/**
+ * Transcript schema for @mieweb/ui media components.
+ *
+ * Provider-agnostic and persistence-agnostic. Canonical time unit is
+ * **milliseconds** (consumers with seconds-based data, e.g. osheet, adapt
+ * at the boundary).
+ *
+ * Shared by TranscriptView, MediaEditor, and useTranscriptEdits.
+ */
+/** Type of transcript word - 'word' for spoken content, 'silence' for detected gaps, 'silence-newline' for longer pauses */
+type WordType = 'word' | 'silence' | 'silence-newline';
+interface TranscriptWord {
+    text: string;
+    startMs: number;
+    endMs: number;
+    /** References Speaker.id when diarization is available */
+    speakerId?: string;
+    confidence?: number;
+    /** Type of word: 'word' for spoken content, 'silence' for detected gaps. Defaults to 'word' */
+    wordType?: WordType;
+}
+/** A diarized segment of contiguous speech (osheet-style granularity) */
+interface TranscriptSegment {
+    text: string;
+    startMs: number;
+    endMs: number;
+    /** References Speaker.id when diarization is available */
+    speakerId?: string;
+    words: TranscriptWord[];
+}
+interface Speaker {
+    id: string;
+    /** Display name (e.g. 'Clinician', 'Patient'). Hosts may remap via speakerLabels props. */
+    name?: string;
+}
+interface Transcript {
+    durationMs: number;
+    speakers?: Speaker[];
+    words: TranscriptWord[];
+    segments?: TranscriptSegment[];
+}
+/**
+ * An editable word that references the original transcript word.
+ * Used in the edited timeline to track deletions and reordering.
+ */
+interface EditableWord {
+    /** Index into the SILENCE-INSERTED baseline timeline (transcript.words
+     *  with detected silence pseudo-words interleaved) — NOT into
+     *  transcript.words. -1 for split/inserted entries with no baseline slot.
+     *  Consumers persisting edits should key by this timeline. */
+    originalIndex: number;
+    /** The word data (from original transcript) */
+    word: TranscriptWord;
+    /** Whether this word is marked as deleted */
+    deleted: boolean;
+    /** Whether this word was inserted (pasted from clipboard) */
+    inserted?: boolean;
+}
+/** Available playback speed multipliers */
+type PlaybackSpeed = 0.5 | 0.75 | 1 | 1.25 | 1.5 | 1.75 | 2;
+/**
+ * A speed marker applied to a word in the transcript.
+ * The speed applies from this word until the next speed marker or end of transcript.
+ */
+interface SpeedMarker {
+    /** Index in the editedWords array where the speed marker is placed */
+    wordIndex: number;
+    /** The playback speed multiplier */
+    speed: PlaybackSpeed;
+}
 
 interface MediaEditorProps extends VariantProps<typeof mediaEditorVariants> {
     /** Media URL */
@@ -85,6 +154,26 @@ declare const mediaEditorVariants: (props?: ({
  */
 declare const MediaEditor: React.ForwardRefExoticComponent<MediaEditorProps & React.RefAttributes<HTMLDivElement>>;
 
+/**
+ * useTranscriptEdits — headless transcript-editing state hook.
+ *
+ * Extracted from pulseclip's TranscriptViewer for @mieweb/ui. Holds the
+ * edited word timeline (deletions, insertions, text edits, silence
+ * splitting), a single-level undo stack, an internal clipboard, speed
+ * markers, and derived playback/statistics data.
+ *
+ * Controlled + persistence-agnostic: no DOM, no fetches. Selection lives in
+ * the UI layer — mutations take explicit indices. State flows out via
+ * `onChange` and back in via `initialEditedWords` / `initialUndoStack`.
+ */
+
+/** Count and total duration of silences above a given threshold (seconds) */
+interface SilenceThresholdCount {
+    threshold: number;
+    count: number;
+    durationMs: number;
+}
+
 /**
  * FillerWordsModal — select filler words (and long silences) to mark deleted.
  *

package/dist/components/MediaEditor/index.js

@@ -1,21 +1,23 @@
-export { FillerWordsModal, MediaEditor, SilenceSettingsModal, SpeedMarkerMenu, WordEditorModal } from '../../chunk-ENKFJJZX.js';
+export { FillerWordsModal, MediaEditor, SilenceSettingsModal, SpeedMarkerMenu, WordEditorModal } from '../../chunk-S2JZL4JC.js';
 import '../../chunk-2BPIVWAK.js';
-import '../../chunk-VKELAMAZ.js';
+import '../../chunk-N54FYWG6.js';
 import '../../chunk-753Z3NXL.js';
 import '../../chunk-UUI7WXI5.js';
 import '../../chunk-6CGM5H4J.js';
-import '../../chunk-SQHMGT4W.js';
-import '../../chunk-S7WCHDBO.js';
+import '../../chunk-GW4RFJZ5.js';
+import '../../chunk-VCI2Y7ST.js';
+import '../../chunk-TWQSMUE6.js';
 import '../../chunk-6NZXWKUE.js';
 import '../../chunk-3IMM2PM4.js';
-import '../../chunk-62ZOA6PX.js';
-import '../../chunk-WSNMQQ4P.js';
-import '../../chunk-5JJ2DAE4.js';
 import '../../chunk-4SMSH4OY.js';
 import '../../chunk-T4ME7QCT.js';
+import '../../chunk-62ZOA6PX.js';
+import '../../chunk-WSNMQQ4P.js';
 import '../../chunk-VSQF22GL.js';
-import '../../chunk-GOALNQZ2.js';
-import '../../chunk-XCP454Q6.js';
+import '../../chunk-N5JDL4VE.js';
+import '../../chunk-WFBUBT54.js';
+import '../../chunk-GVM6DTR5.js';
+import '../../chunk-F4N67NAF.js';
 import '../../chunk-TQONQSJO.js';
 import '../../chunk-PX6F3LHL.js';
 //# sourceMappingURL=index.js.map

package/dist/components/MediaFeed/index.cjs

@@ -0,0 +1,29 @@
+'use strict';
+
+var chunkAJPFQF3H_cjs = require('../../chunk-AJPFQF3H.cjs');
+require('../../chunk-GLXTVCHN.cjs');
+require('../../chunk-KQ6GLYFZ.cjs');
+require('../../chunk-254QK722.cjs');
+require('../../chunk-P22YCUVM.cjs');
+require('../../chunk-Q3YVLO52.cjs');
+require('../../chunk-GKDHMNUA.cjs');
+require('../../chunk-LC3JL2HB.cjs');
+require('../../chunk-NNEFAUHV.cjs');
+require('../../chunk-FHY3K6PL.cjs');
+require('../../chunk-SCV7C55E.cjs');
+require('../../chunk-YW2AKBLS.cjs');
+require('../../chunk-EACNRR3C.cjs');
+require('../../chunk-ANMX7YDL.cjs');
+require('../../chunk-DXEPYK3I.cjs');
+require('../../chunk-IEY3ZJIT.cjs');
+require('../../chunk-S5RVSXDV.cjs');
+require('../../chunk-EUAMEVVI.cjs');
+
+
+
+Object.defineProperty(exports, "MediaFeed", {
+  enumerable: true,
+  get: function () { return chunkAJPFQF3H_cjs.MediaFeed; }
+});
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/components/MediaFeed/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"index.cjs"}

package/dist/components/MediaFeed/index.d.cts

@@ -0,0 +1,104 @@
+import * as React from 'react';
+
+/** A caller-owned media resource. Provider embeds can also use `renderMedia`. */
+interface MediaFeedMedia {
+    kind: 'image' | 'video' | 'audio' | 'youtube';
+    src: string;
+    poster?: string;
+    alt?: string;
+}
+interface MediaFeedAuthor {
+    name: string;
+    avatar?: string;
+}
+/** An explicit Play gesture, separate from item selection and automatic playback. */
+interface MediaFeedPlaybackRequest {
+    itemId: string;
+    /** Use a fresh token for each gesture, including repeated Play on the same item. */
+    requestId: string | number;
+}
+/** Custom players must stop playback whenever `active` is false. */
+interface MediaFeedRenderContext<T> {
+    item: T;
+    active: boolean;
+    autoPlay: boolean;
+    muted: boolean;
+    loop: boolean;
+    /** A pending manual Play token for this active item. Handle each token once. */
+    playbackRequestId?: string | number;
+}
+/** Every string authored by the feed can be localized by its host. */
+interface MediaFeedLabels {
+    feed: string;
+    loading: string;
+    empty: string;
+    error: string;
+    retry: string;
+    fullscreen: string;
+    close: string;
+    previous: string;
+    next: string;
+    play: string;
+    pause: string;
+    blockedAutoplay: string;
+    mediaError: string;
+    openSource: string;
+    youtubeNotice: string;
+    item: (position: number, total: number) => string;
+    position: (position: number, total: number) => string;
+}
+/** Keys match the feed's `data-slot` attributes. */
+interface MediaFeedClassNames {
+    root?: string;
+    viewport?: string;
+    item?: string;
+    media?: string;
+    details?: string;
+    author?: string;
+    title?: string;
+    caption?: string;
+    actions?: string;
+    status?: string;
+    controls?: string;
+    fullscreen?: string;
+}
+interface MediaFeedProps<T> extends Omit<React.HTMLAttributes<HTMLDivElement>, 'children' | 'onError'> {
+    /** Records in presentation order. The feed never fetches or mutates them. */
+    items: readonly T[];
+    /** A stable, unique ID for each record. */
+    getId: (item: T) => string;
+    getMedia: (item: T) => MediaFeedMedia;
+    getTitle?: (item: T) => string;
+    getCaption?: (item: T) => React.ReactNode;
+    getAuthor?: (item: T) => MediaFeedAuthor;
+    /** Host-owned actions, such as reactions or opening a conversation. */
+    renderActions?: (item: T) => React.ReactNode;
+    /** Replace the built-in player, respecting its active playback boundary. */
+    renderMedia?: (media: MediaFeedMedia, context: MediaFeedRenderContext<T>) => React.ReactNode;
+    /** Controlled selection. Changes scroll the selected record into view. */
+    activeItemId?: string;
+    /** Initial selection for an uncontrolled feed. */
+    defaultActiveItemId?: string;
+    /** Fires for user navigation and visibility changes, with the original item. */
+    onActiveItemChange?: (item: T) => void;
+    /**
+     * Attempt explicit playback once the requested item is selected and visible.
+     * This bypasses reduced-motion/autoplay suppression for that gesture only;
+     * it does not change selection. Browsers can still require another gesture.
+     */
+    playbackRequest?: MediaFeedPlaybackRequest;
+    loading?: boolean;
+    error?: string | null;
+    onRetry?: () => void | Promise<void>;
+    /** Attempt visible playback unless reduced motion is preferred; a gesture may be required. */
+    autoPlay?: boolean;
+    /** Native playback begins muted by default. Native controls can unmute it. */
+    muted?: boolean;
+    loop?: boolean;
+    labels?: Partial<MediaFeedLabels>;
+    classNames?: MediaFeedClassNames;
+}
+
+declare const MediaFeed: <T>(props: MediaFeedProps<T> & React.RefAttributes<HTMLDivElement>) => React.ReactElement;
+
+export { MediaFeed, type MediaFeedAuthor, type MediaFeedClassNames, type MediaFeedLabels, type MediaFeedMedia, type MediaFeedPlaybackRequest, type MediaFeedProps, type MediaFeedRenderContext };

package/dist/components/MediaFeed/index.d.ts

@@ -0,0 +1,104 @@
+import * as React from 'react';
+
+/** A caller-owned media resource. Provider embeds can also use `renderMedia`. */
+interface MediaFeedMedia {
+    kind: 'image' | 'video' | 'audio' | 'youtube';
+    src: string;
+    poster?: string;
+    alt?: string;
+}
+interface MediaFeedAuthor {
+    name: string;
+    avatar?: string;
+}
+/** An explicit Play gesture, separate from item selection and automatic playback. */
+interface MediaFeedPlaybackRequest {
+    itemId: string;
+    /** Use a fresh token for each gesture, including repeated Play on the same item. */
+    requestId: string | number;
+}
+/** Custom players must stop playback whenever `active` is false. */
+interface MediaFeedRenderContext<T> {
+    item: T;
+    active: boolean;
+    autoPlay: boolean;
+    muted: boolean;
+    loop: boolean;
+    /** A pending manual Play token for this active item. Handle each token once. */
+    playbackRequestId?: string | number;
+}
+/** Every string authored by the feed can be localized by its host. */
+interface MediaFeedLabels {
+    feed: string;
+    loading: string;
+    empty: string;
+    error: string;
+    retry: string;
+    fullscreen: string;
+    close: string;
+    previous: string;
+    next: string;
+    play: string;
+    pause: string;
+    blockedAutoplay: string;
+    mediaError: string;
+    openSource: string;
+    youtubeNotice: string;
+    item: (position: number, total: number) => string;
+    position: (position: number, total: number) => string;
+}
+/** Keys match the feed's `data-slot` attributes. */
+interface MediaFeedClassNames {
+    root?: string;
+    viewport?: string;
+    item?: string;
+    media?: string;
+    details?: string;
+    author?: string;
+    title?: string;
+    caption?: string;
+    actions?: string;
+    status?: string;
+    controls?: string;
+    fullscreen?: string;
+}
+interface MediaFeedProps<T> extends Omit<React.HTMLAttributes<HTMLDivElement>, 'children' | 'onError'> {
+    /** Records in presentation order. The feed never fetches or mutates them. */
+    items: readonly T[];
+    /** A stable, unique ID for each record. */
+    getId: (item: T) => string;
+    getMedia: (item: T) => MediaFeedMedia;
+    getTitle?: (item: T) => string;
+    getCaption?: (item: T) => React.ReactNode;
+    getAuthor?: (item: T) => MediaFeedAuthor;
+    /** Host-owned actions, such as reactions or opening a conversation. */
+    renderActions?: (item: T) => React.ReactNode;
+    /** Replace the built-in player, respecting its active playback boundary. */
+    renderMedia?: (media: MediaFeedMedia, context: MediaFeedRenderContext<T>) => React.ReactNode;
+    /** Controlled selection. Changes scroll the selected record into view. */
+    activeItemId?: string;
+    /** Initial selection for an uncontrolled feed. */
+    defaultActiveItemId?: string;
+    /** Fires for user navigation and visibility changes, with the original item. */
+    onActiveItemChange?: (item: T) => void;
+    /**
+     * Attempt explicit playback once the requested item is selected and visible.
+     * This bypasses reduced-motion/autoplay suppression for that gesture only;
+     * it does not change selection. Browsers can still require another gesture.
+     */
+    playbackRequest?: MediaFeedPlaybackRequest;
+    loading?: boolean;
+    error?: string | null;
+    onRetry?: () => void | Promise<void>;
+    /** Attempt visible playback unless reduced motion is preferred; a gesture may be required. */
+    autoPlay?: boolean;
+    /** Native playback begins muted by default. Native controls can unmute it. */
+    muted?: boolean;
+    loop?: boolean;
+    labels?: Partial<MediaFeedLabels>;
+    classNames?: MediaFeedClassNames;
+}
+
+declare const MediaFeed: <T>(props: MediaFeedProps<T> & React.RefAttributes<HTMLDivElement>) => React.ReactElement;
+
+export { MediaFeed, type MediaFeedAuthor, type MediaFeedClassNames, type MediaFeedLabels, type MediaFeedMedia, type MediaFeedPlaybackRequest, type MediaFeedProps, type MediaFeedRenderContext };

package/dist/components/MediaFeed/index.js

@@ -0,0 +1,20 @@
+export { MediaFeed } from '../../chunk-2X54ZLT6.js';
+import '../../chunk-RISZWWEQ.js';
+import '../../chunk-N54FYWG6.js';
+import '../../chunk-GW4RFJZ5.js';
+import '../../chunk-H2Y7HZV5.js';
+import '../../chunk-DVDT7TX7.js';
+import '../../chunk-TI3TQQ7F.js';
+import '../../chunk-TWQSMUE6.js';
+import '../../chunk-4SMSH4OY.js';
+import '../../chunk-T4ME7QCT.js';
+import '../../chunk-VSQF22GL.js';
+import '../../chunk-XDU65GLW.js';
+import '../../chunk-N5JDL4VE.js';
+import '../../chunk-WFBUBT54.js';
+import '../../chunk-GVM6DTR5.js';
+import '../../chunk-F4N67NAF.js';
+import '../../chunk-TQONQSJO.js';
+import '../../chunk-PX6F3LHL.js';
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map