@mieweb/ui 0.7.1-dev.5 → 0.7.1-dev.7

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

@@ -0,0 +1,222 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import * as React from 'react';
+
+/** Another participant currently present in the room. */
+interface CollabPeer {
+    /** Display name published through presence. */
+    name: string;
+    /** Optional presence color (cursor/avatar tint). */
+    color?: string;
+}
+/** Static identity of the open collaboration room, shown in the debug panel. */
+interface CollabRoomInfo {
+    /** Room name on the sync server (e.g. `case/4`). */
+    name: string;
+    /** Transport URL the client connected to. */
+    url?: string;
+    /** This window's client id (stable per document), or null before connect. */
+    clientId?: number | null;
+    /** The acting application user id passed to the sync server. */
+    userId?: string;
+}
+/** Category of a collaboration event in the debug log. */
+type CollabLogKind = 'doc' | 'awareness' | 'sync' | 'patch';
+/** A single entry in the collaboration debug log. */
+interface CollabLogEntry {
+    /** Stable key for rendering. */
+    id: number | string;
+    /** Wall-clock time of the event (epoch ms). */
+    at: number;
+    /** Event category. */
+    kind: CollabLogKind;
+    /** Whether this window or a peer originated it. */
+    origin?: 'local' | 'remote';
+    /** Human-readable detail line. */
+    detail: string;
+}
+/** Every user-facing string, so apps can translate the widget. */
+interface CollabStatusLabels {
+    /** Trigger text once the initial sync completed. */
+    live: string;
+    /** Trigger text before the initial sync completes. */
+    connecting: string;
+    /** Summary of who else is editing, e.g. `Ann, Bo are editing`. */
+    editing: (names: string[]) => string;
+    /** Accessible name / tooltip of the trigger button. */
+    triggerLabel: string;
+    /** Heading of the room-occupants section. */
+    peersTitle: (count: number) => string;
+    /** Shown in the occupants section when nobody else is in the room. */
+    alone: React.ReactNode;
+    /** Heading of the debug panel. */
+    logTitle: (count: number) => string;
+    /** Accessible name of the panel close button. */
+    close: string;
+    /** Accessible name of the toggle that unclips long values. */
+    wrap: string;
+    /** Shown when the log is empty. */
+    empty: React.ReactNode;
+    roomTerm: string;
+    urlTerm: string;
+    clientTerm: string;
+    userTerm: string;
+    /** Suffix appended to the client id once synced / while connecting. */
+    clientSynced: string;
+    clientConnecting: string;
+}
+declare const defaultCollabStatusLabels: CollabStatusLabels;
+interface CollabStatusProps {
+    /** True once the room has completed its initial sync with the server. */
+    connected: boolean;
+    /** Other people in the room right now. */
+    peers?: CollabPeer[];
+    /** Recent collaboration events, newest first. */
+    log?: CollabLogEntry[];
+    /** Identity of the open room, shown at the top of the panel. */
+    room?: CollabRoomInfo | null;
+    /** Set false to render a status-only chip with no debug panel. */
+    showLog?: boolean;
+    /**
+     * Render the trigger as the bare connection dot, moving the status text into
+     * its accessible name. For headers with no room for a full chip.
+     */
+    compact?: boolean;
+    /**
+     * An app-level condition worth the same glance as the connection state, e.g.
+     * `"Unsaved changes"`. While set, the dot turns amber and the text joins the
+     * trigger's accessible name and heads the panel.
+     */
+    attention?: React.ReactNode;
+    /** Overrides for any user-facing string. */
+    labels?: Partial<CollabStatusLabels>;
+    /** Additional className for the trigger wrapper. */
+    className?: string;
+}
+/**
+ * Live-collaboration status chip: a connection dot, a `Live` / `Connecting…`
+ * label, a summary of who else is editing, and a click-to-open panel with the
+ * room identity, who is in the room, and a rolling log of collaboration
+ * events. Pass `compact` to shrink the trigger down to the dot alone, and
+ * `attention` to let an app condition ("Unsaved changes") share that dot.
+ *
+ * Transport-agnostic — it renders whatever presence state you hand it. For a
+ * Yjs (`y-websocket`) room, {@link useYjsCollabStatus} produces these props
+ * directly:
+ *
+ * @example
+ * ```tsx
+ * const doc = React.useMemo(() => new Y.Doc(), []);
+ * const provider = React.useMemo(
+ *   () => new WebsocketProvider('ws://localhost:1234', 'case/4', doc),
+ *   [doc]
+ * );
+ * const status = useYjsCollabStatus({ doc, provider, user: { name: 'Ann' } });
+ *
+ * return <CollabStatus {...status} />;
+ * ```
+ */
+declare function CollabStatus({ connected, peers, log, room, showLog, compact, attention, labels: labelOverrides, className, }: CollabStatusProps): react_jsx_runtime.JSX.Element;
+
+/** The subset of `Y.Doc` this hook observes. */
+interface YjsDocLike {
+    clientID: number;
+    on(event: string, handler: (...args: any[]) => void): void;
+    off(event: string, handler: (...args: any[]) => void): void;
+}
+/** The subset of `y-protocols/awareness`.`Awareness` this hook uses. */
+interface YjsAwarenessLike {
+    clientID: number;
+    getStates(): Map<number, Record<string, any>>;
+    setLocalStateField(field: string, value: unknown): void;
+    on(event: string, handler: (...args: any[]) => void): void;
+    off(event: string, handler: (...args: any[]) => void): void;
+}
+/** The subset of `y-websocket`.`WebsocketProvider` this hook uses. */
+interface YjsProviderLike {
+    awareness: YjsAwarenessLike;
+    /** True once the initial sync completed (y-websocket exposes this). */
+    synced?: boolean;
+    /** Room name, used as the default label in the debug panel. */
+    roomname?: string;
+    /** Server URL, used as the default label in the debug panel. */
+    url?: string;
+    on(event: string, handler: (...args: any[]) => void): void;
+    off(event: string, handler: (...args: any[]) => void): void;
+}
+/** A remote collaborator's edit that just changed the open document. */
+interface CollabRemoteEdit {
+    /** Human-readable labels of the fields that changed. */
+    fields: string[];
+    /** Who made the change, when attributable from presence. */
+    by?: string;
+    /** Timestamp; a new value signals a fresh growl/toast. */
+    at: number;
+}
+interface UseYjsCollabStatusOptions {
+    /** The shared document. Pass null to keep the hook inert. */
+    doc: YjsDocLike | null | undefined;
+    /** The sync provider (e.g. `y-websocket`). Pass null to keep it inert. */
+    provider: YjsProviderLike | null | undefined;
+    /**
+     * Presence identity published for this window. Defaults to
+     * `User <clientID>` so windows are distinguishable without a login.
+     */
+    user?: {
+        name?: string;
+        color?: string;
+    };
+    /** Room label for the debug panel. Defaults to `provider.roomname`. */
+    roomName?: string;
+    /** URL label for the debug panel. Defaults to `provider.url`. */
+    url?: string;
+    /** Application user id shown in the debug panel. */
+    userId?: string;
+    /** Maximum log entries kept in memory. Default 100. */
+    logCap?: number;
+}
+interface YjsCollabStatus {
+    /** True once the initial server sync completed. */
+    connected: boolean;
+    /** Other windows currently present in the room. */
+    peers: CollabPeer[];
+    /** Recent collaboration events, newest first. */
+    log: CollabLogEntry[];
+    /** Room identity for the debug panel. */
+    room: CollabRoomInfo | null;
+    /** The most recent remote edit, or null. */
+    lastRemoteEdit: CollabRemoteEdit | null;
+    /**
+     * Announce a local edit and the fields it touched, so other windows can
+     * attribute it. Also records a `patch` log entry.
+     */
+    publishActivity: (fields: string[]) => void;
+}
+/**
+ * Bind {@link CollabStatus} to a Yjs room: tracks initial-sync state, publishes
+ * this window's presence, tracks peers joining/leaving, attributes remote edits,
+ * and keeps a capped log of document/awareness/sync events.
+ *
+ * The return value is spreadable straight into the component.
+ *
+ * @example
+ * ```tsx
+ * import * as Y from 'yjs';
+ * import { WebsocketProvider } from 'y-websocket';
+ * import { CollabStatus, useYjsCollabStatus } from '@mieweb/ui';
+ *
+ * function Header({ caseId }: { caseId: string }) {
+ *   const doc = React.useMemo(() => new Y.Doc(), []);
+ *   const provider = React.useMemo(
+ *     () => new WebsocketProvider('ws://localhost:1234', `case/${caseId}`, doc),
+ *     [doc, caseId]
+ *   );
+ *   React.useEffect(() => () => provider.destroy(), [provider]);
+ *
+ *   const status = useYjsCollabStatus({ doc, provider, user: { name: 'Ann' } });
+ *   return <CollabStatus {...status} />;
+ * }
+ * ```
+ */
+declare function useYjsCollabStatus({ doc, provider, user, roomName, url, userId, logCap, }: UseYjsCollabStatusOptions): YjsCollabStatus;
+
+export { type CollabLogEntry, type CollabLogKind, type CollabPeer, type CollabRemoteEdit, type CollabRoomInfo, CollabStatus, type CollabStatusLabels, type CollabStatusProps, type UseYjsCollabStatusOptions, type YjsAwarenessLike, type YjsCollabStatus, type YjsDocLike, type YjsProviderLike, defaultCollabStatusLabels, useYjsCollabStatus };

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

@@ -0,0 +1,222 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import * as React from 'react';
+
+/** Another participant currently present in the room. */
+interface CollabPeer {
+    /** Display name published through presence. */
+    name: string;
+    /** Optional presence color (cursor/avatar tint). */
+    color?: string;
+}
+/** Static identity of the open collaboration room, shown in the debug panel. */
+interface CollabRoomInfo {
+    /** Room name on the sync server (e.g. `case/4`). */
+    name: string;
+    /** Transport URL the client connected to. */
+    url?: string;
+    /** This window's client id (stable per document), or null before connect. */
+    clientId?: number | null;
+    /** The acting application user id passed to the sync server. */
+    userId?: string;
+}
+/** Category of a collaboration event in the debug log. */
+type CollabLogKind = 'doc' | 'awareness' | 'sync' | 'patch';
+/** A single entry in the collaboration debug log. */
+interface CollabLogEntry {
+    /** Stable key for rendering. */
+    id: number | string;
+    /** Wall-clock time of the event (epoch ms). */
+    at: number;
+    /** Event category. */
+    kind: CollabLogKind;
+    /** Whether this window or a peer originated it. */
+    origin?: 'local' | 'remote';
+    /** Human-readable detail line. */
+    detail: string;
+}
+/** Every user-facing string, so apps can translate the widget. */
+interface CollabStatusLabels {
+    /** Trigger text once the initial sync completed. */
+    live: string;
+    /** Trigger text before the initial sync completes. */
+    connecting: string;
+    /** Summary of who else is editing, e.g. `Ann, Bo are editing`. */
+    editing: (names: string[]) => string;
+    /** Accessible name / tooltip of the trigger button. */
+    triggerLabel: string;
+    /** Heading of the room-occupants section. */
+    peersTitle: (count: number) => string;
+    /** Shown in the occupants section when nobody else is in the room. */
+    alone: React.ReactNode;
+    /** Heading of the debug panel. */
+    logTitle: (count: number) => string;
+    /** Accessible name of the panel close button. */
+    close: string;
+    /** Accessible name of the toggle that unclips long values. */
+    wrap: string;
+    /** Shown when the log is empty. */
+    empty: React.ReactNode;
+    roomTerm: string;
+    urlTerm: string;
+    clientTerm: string;
+    userTerm: string;
+    /** Suffix appended to the client id once synced / while connecting. */
+    clientSynced: string;
+    clientConnecting: string;
+}
+declare const defaultCollabStatusLabels: CollabStatusLabels;
+interface CollabStatusProps {
+    /** True once the room has completed its initial sync with the server. */
+    connected: boolean;
+    /** Other people in the room right now. */
+    peers?: CollabPeer[];
+    /** Recent collaboration events, newest first. */
+    log?: CollabLogEntry[];
+    /** Identity of the open room, shown at the top of the panel. */
+    room?: CollabRoomInfo | null;
+    /** Set false to render a status-only chip with no debug panel. */
+    showLog?: boolean;
+    /**
+     * Render the trigger as the bare connection dot, moving the status text into
+     * its accessible name. For headers with no room for a full chip.
+     */
+    compact?: boolean;
+    /**
+     * An app-level condition worth the same glance as the connection state, e.g.
+     * `"Unsaved changes"`. While set, the dot turns amber and the text joins the
+     * trigger's accessible name and heads the panel.
+     */
+    attention?: React.ReactNode;
+    /** Overrides for any user-facing string. */
+    labels?: Partial<CollabStatusLabels>;
+    /** Additional className for the trigger wrapper. */
+    className?: string;
+}
+/**
+ * Live-collaboration status chip: a connection dot, a `Live` / `Connecting…`
+ * label, a summary of who else is editing, and a click-to-open panel with the
+ * room identity, who is in the room, and a rolling log of collaboration
+ * events. Pass `compact` to shrink the trigger down to the dot alone, and
+ * `attention` to let an app condition ("Unsaved changes") share that dot.
+ *
+ * Transport-agnostic — it renders whatever presence state you hand it. For a
+ * Yjs (`y-websocket`) room, {@link useYjsCollabStatus} produces these props
+ * directly:
+ *
+ * @example
+ * ```tsx
+ * const doc = React.useMemo(() => new Y.Doc(), []);
+ * const provider = React.useMemo(
+ *   () => new WebsocketProvider('ws://localhost:1234', 'case/4', doc),
+ *   [doc]
+ * );
+ * const status = useYjsCollabStatus({ doc, provider, user: { name: 'Ann' } });
+ *
+ * return <CollabStatus {...status} />;
+ * ```
+ */
+declare function CollabStatus({ connected, peers, log, room, showLog, compact, attention, labels: labelOverrides, className, }: CollabStatusProps): react_jsx_runtime.JSX.Element;
+
+/** The subset of `Y.Doc` this hook observes. */
+interface YjsDocLike {
+    clientID: number;
+    on(event: string, handler: (...args: any[]) => void): void;
+    off(event: string, handler: (...args: any[]) => void): void;
+}
+/** The subset of `y-protocols/awareness`.`Awareness` this hook uses. */
+interface YjsAwarenessLike {
+    clientID: number;
+    getStates(): Map<number, Record<string, any>>;
+    setLocalStateField(field: string, value: unknown): void;
+    on(event: string, handler: (...args: any[]) => void): void;
+    off(event: string, handler: (...args: any[]) => void): void;
+}
+/** The subset of `y-websocket`.`WebsocketProvider` this hook uses. */
+interface YjsProviderLike {
+    awareness: YjsAwarenessLike;
+    /** True once the initial sync completed (y-websocket exposes this). */
+    synced?: boolean;
+    /** Room name, used as the default label in the debug panel. */
+    roomname?: string;
+    /** Server URL, used as the default label in the debug panel. */
+    url?: string;
+    on(event: string, handler: (...args: any[]) => void): void;
+    off(event: string, handler: (...args: any[]) => void): void;
+}
+/** A remote collaborator's edit that just changed the open document. */
+interface CollabRemoteEdit {
+    /** Human-readable labels of the fields that changed. */
+    fields: string[];
+    /** Who made the change, when attributable from presence. */
+    by?: string;
+    /** Timestamp; a new value signals a fresh growl/toast. */
+    at: number;
+}
+interface UseYjsCollabStatusOptions {
+    /** The shared document. Pass null to keep the hook inert. */
+    doc: YjsDocLike | null | undefined;
+    /** The sync provider (e.g. `y-websocket`). Pass null to keep it inert. */
+    provider: YjsProviderLike | null | undefined;
+    /**
+     * Presence identity published for this window. Defaults to
+     * `User <clientID>` so windows are distinguishable without a login.
+     */
+    user?: {
+        name?: string;
+        color?: string;
+    };
+    /** Room label for the debug panel. Defaults to `provider.roomname`. */
+    roomName?: string;
+    /** URL label for the debug panel. Defaults to `provider.url`. */
+    url?: string;
+    /** Application user id shown in the debug panel. */
+    userId?: string;
+    /** Maximum log entries kept in memory. Default 100. */
+    logCap?: number;
+}
+interface YjsCollabStatus {
+    /** True once the initial server sync completed. */
+    connected: boolean;
+    /** Other windows currently present in the room. */
+    peers: CollabPeer[];
+    /** Recent collaboration events, newest first. */
+    log: CollabLogEntry[];
+    /** Room identity for the debug panel. */
+    room: CollabRoomInfo | null;
+    /** The most recent remote edit, or null. */
+    lastRemoteEdit: CollabRemoteEdit | null;
+    /**
+     * Announce a local edit and the fields it touched, so other windows can
+     * attribute it. Also records a `patch` log entry.
+     */
+    publishActivity: (fields: string[]) => void;
+}
+/**
+ * Bind {@link CollabStatus} to a Yjs room: tracks initial-sync state, publishes
+ * this window's presence, tracks peers joining/leaving, attributes remote edits,
+ * and keeps a capped log of document/awareness/sync events.
+ *
+ * The return value is spreadable straight into the component.
+ *
+ * @example
+ * ```tsx
+ * import * as Y from 'yjs';
+ * import { WebsocketProvider } from 'y-websocket';
+ * import { CollabStatus, useYjsCollabStatus } from '@mieweb/ui';
+ *
+ * function Header({ caseId }: { caseId: string }) {
+ *   const doc = React.useMemo(() => new Y.Doc(), []);
+ *   const provider = React.useMemo(
+ *     () => new WebsocketProvider('ws://localhost:1234', `case/${caseId}`, doc),
+ *     [doc, caseId]
+ *   );
+ *   React.useEffect(() => () => provider.destroy(), [provider]);
+ *
+ *   const status = useYjsCollabStatus({ doc, provider, user: { name: 'Ann' } });
+ *   return <CollabStatus {...status} />;
+ * }
+ * ```
+ */
+declare function useYjsCollabStatus({ doc, provider, user, roomName, url, userId, logCap, }: UseYjsCollabStatusOptions): YjsCollabStatus;
+
+export { type CollabLogEntry, type CollabLogKind, type CollabPeer, type CollabRemoteEdit, type CollabRoomInfo, CollabStatus, type CollabStatusLabels, type CollabStatusProps, type UseYjsCollabStatusOptions, type YjsAwarenessLike, type YjsCollabStatus, type YjsDocLike, type YjsProviderLike, defaultCollabStatusLabels, useYjsCollabStatus };

package/dist/components/CollabStatus/index.js

@@ -0,0 +1,4 @@
+export { CollabStatus, defaultCollabStatusLabels, useYjsCollabStatus } from '../../chunk-3MGHTTZW.js';
+import '../../chunk-F3SOEIN2.js';
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/components/CollabStatus/index.js.map

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

package/dist/components/MediaEditor/index.cjs

@@ -1,6 +1,6 @@
 'use strict';
 
-var chunkMBESCEWS_cjs = require('../../chunk-MBESCEWS.cjs');
+var chunk5M2YSPJH_cjs = require('../../chunk-5M2YSPJH.cjs');
 require('../../chunk-GOKC4CCZ.cjs');
 require('../../chunk-BYUV3IZV.cjs');
 require('../../chunk-DFCZPVG4.cjs');
@@ -8,7 +8,7 @@ require('../../chunk-DAPZPT5N.cjs');
 require('../../chunk-KJPOFUF5.cjs');
 require('../../chunk-MSRU3XBH.cjs');
 require('../../chunk-A2QVQF54.cjs');
-require('../../chunk-O5UJRGRV.cjs');
+require('../../chunk-NPKPCYAT.cjs');
 require('../../chunk-NUFUV43P.cjs');
 require('../../chunk-JYZW2PZS.cjs');
 require('../../chunk-NNEFAUHV.cjs');
@@ -22,23 +22,23 @@ require('../../chunk-SCV7C55E.cjs');
 
 Object.defineProperty(exports, "FillerWordsModal", {
   enumerable: true,
-  get: function () { return chunkMBESCEWS_cjs.FillerWordsModal; }
+  get: function () { return chunk5M2YSPJH_cjs.FillerWordsModal; }
 });
 Object.defineProperty(exports, "MediaEditor", {
   enumerable: true,
-  get: function () { return chunkMBESCEWS_cjs.MediaEditor; }
+  get: function () { return chunk5M2YSPJH_cjs.MediaEditor; }
 });
 Object.defineProperty(exports, "SilenceSettingsModal", {
   enumerable: true,
-  get: function () { return chunkMBESCEWS_cjs.SilenceSettingsModal; }
+  get: function () { return chunk5M2YSPJH_cjs.SilenceSettingsModal; }
 });
 Object.defineProperty(exports, "SpeedMarkerMenu", {
   enumerable: true,
-  get: function () { return chunkMBESCEWS_cjs.SpeedMarkerMenu; }
+  get: function () { return chunk5M2YSPJH_cjs.SpeedMarkerMenu; }
 });
 Object.defineProperty(exports, "WordEditorModal", {
   enumerable: true,
-  get: function () { return chunkMBESCEWS_cjs.WordEditorModal; }
+  get: function () { return chunk5M2YSPJH_cjs.WordEditorModal; }
 });
 //# sourceMappingURL=index.cjs.map
 //# sourceMappingURL=index.cjs.map

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

@@ -3,7 +3,7 @@ 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-DgeVQMSi.cjs';
+import { S as SilenceThresholdCount } from '../../useTranscriptEdits-CGzlemHT.cjs';
 
 interface MediaEditorProps extends VariantProps<typeof mediaEditorVariants> {
     /** Media URL */
@@ -34,6 +34,29 @@ interface MediaEditorProps extends VariantProps<typeof mediaEditorVariants> {
     onCursorTimestampChange?: (timestampMs: number | null) => void;
     /** Fired whenever the edited words change — lets the host build raw-data views */
     onEditedWordsRender?: (editedWords: EditableWord[]) => void;
+    /**
+     * Undo beyond the editor's own history.
+     *
+     * The editor's undo is word-level, which is the right grain for typing and
+     * the wrong one for a host that also versions the document — undoing a batch
+     * change one word at a time is not undoing it. When a host provides this, the
+     * Undo control stays available once the editor's own stack is empty and hands
+     * over instead of going dead, so there is one Undo rather than two.
+     */
+    onUndoBeyond?: () => void;
+    /** Whether the host has anything left to undo. Keeps Undo live at depth 0. */
+    canUndoBeyond?: boolean;
+    /** What `onUndoBeyond` would undo, for the tooltip (e.g. a version name). */
+    undoBeyondLabel?: string;
+    /**
+     * Redo beyond the editor's own history — the counterpart to `onUndoBeyond`.
+     * The editor redoes its own word-level steps first and only calls this once
+     * they are exhausted, so the pair walks the same states in both directions.
+     */
+    onRedo?: () => void;
+    canRedo?: boolean;
+    /** What `onRedo` would redo, for the tooltip. */
+    redoLabel?: string;
     /** Optional ref to the internal MediaPlayer (host escape hatch, e.g. thumbnail capture) */
     playerRef?: React.Ref<MediaPlayerRef>;
     /** Additional class name */

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

@@ -3,7 +3,7 @@ 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-C0Hhy2pO.js';
+import { S as SilenceThresholdCount } from '../../useTranscriptEdits-D32bLs0l.js';
 
 interface MediaEditorProps extends VariantProps<typeof mediaEditorVariants> {
     /** Media URL */
@@ -34,6 +34,29 @@ interface MediaEditorProps extends VariantProps<typeof mediaEditorVariants> {
     onCursorTimestampChange?: (timestampMs: number | null) => void;
     /** Fired whenever the edited words change — lets the host build raw-data views */
     onEditedWordsRender?: (editedWords: EditableWord[]) => void;
+    /**
+     * Undo beyond the editor's own history.
+     *
+     * The editor's undo is word-level, which is the right grain for typing and
+     * the wrong one for a host that also versions the document — undoing a batch
+     * change one word at a time is not undoing it. When a host provides this, the
+     * Undo control stays available once the editor's own stack is empty and hands
+     * over instead of going dead, so there is one Undo rather than two.
+     */
+    onUndoBeyond?: () => void;
+    /** Whether the host has anything left to undo. Keeps Undo live at depth 0. */
+    canUndoBeyond?: boolean;
+    /** What `onUndoBeyond` would undo, for the tooltip (e.g. a version name). */
+    undoBeyondLabel?: string;
+    /**
+     * Redo beyond the editor's own history — the counterpart to `onUndoBeyond`.
+     * The editor redoes its own word-level steps first and only calls this once
+     * they are exhausted, so the pair walks the same states in both directions.
+     */
+    onRedo?: () => void;
+    canRedo?: boolean;
+    /** What `onRedo` would redo, for the tooltip. */
+    redoLabel?: string;
     /** Optional ref to the internal MediaPlayer (host escape hatch, e.g. thumbnail capture) */
     playerRef?: React.Ref<MediaPlayerRef>;
     /** Additional class name */

package/dist/components/MediaEditor/index.js

@@ -1,4 +1,4 @@
-export { FillerWordsModal, MediaEditor, SilenceSettingsModal, SpeedMarkerMenu, WordEditorModal } from '../../chunk-YVBSAIJ4.js';
+export { FillerWordsModal, MediaEditor, SilenceSettingsModal, SpeedMarkerMenu, WordEditorModal } from '../../chunk-GOAW2UCP.js';
 import '../../chunk-JBB25LFB.js';
 import '../../chunk-KOCTIB6U.js';
 import '../../chunk-XCLQZ4FV.js';
@@ -6,7 +6,7 @@ import '../../chunk-J7Z7467B.js';
 import '../../chunk-IUFDGB5O.js';
 import '../../chunk-PVUDXJAI.js';
 import '../../chunk-ZVSW2KS6.js';
-import '../../chunk-FKHMTRF2.js';
+import '../../chunk-UUI7WXI5.js';
 import '../../chunk-6CGM5H4J.js';
 import '../../chunk-SQHMGT4W.js';
 import '../../chunk-4SMSH4OY.js';

package/dist/hooks/index.cjs

@@ -2,7 +2,7 @@
 
 var chunk4GXECTPS_cjs = require('../chunk-4GXECTPS.cjs');
 var chunk2O7D6F67_cjs = require('../chunk-2O7D6F67.cjs');
-var chunkO5UJRGRV_cjs = require('../chunk-O5UJRGRV.cjs');
+var chunkNPKPCYAT_cjs = require('../chunk-NPKPCYAT.cjs');
 require('../chunk-NUFUV43P.cjs');
 var chunkJYZW2PZS_cjs = require('../chunk-JYZW2PZS.cjs');
 var chunkYVPC65ZJ_cjs = require('../chunk-YVPC65ZJ.cjs');
@@ -61,35 +61,35 @@ Object.defineProperty(exports, "useTheme", {
 });
 Object.defineProperty(exports, "DEFAULT_FILLER_WORDS", {
   enumerable: true,
-  get: function () { return chunkO5UJRGRV_cjs.DEFAULT_FILLER_WORDS; }
+  get: function () { return chunkNPKPCYAT_cjs.DEFAULT_FILLER_WORDS; }
 });
 Object.defineProperty(exports, "DEFAULT_MIN_SILENCE_MS", {
   enumerable: true,
-  get: function () { return chunkO5UJRGRV_cjs.DEFAULT_MIN_SILENCE_MS; }
+  get: function () { return chunkNPKPCYAT_cjs.DEFAULT_MIN_SILENCE_MS; }
 });
 Object.defineProperty(exports, "DEFAULT_NL_SILENCE_MS", {
   enumerable: true,
-  get: function () { return chunkO5UJRGRV_cjs.DEFAULT_NL_SILENCE_MS; }
+  get: function () { return chunkNPKPCYAT_cjs.DEFAULT_NL_SILENCE_MS; }
 });
 Object.defineProperty(exports, "buildPlaybackSegments", {
   enumerable: true,
-  get: function () { return chunkO5UJRGRV_cjs.buildPlaybackSegments; }
+  get: function () { return chunkNPKPCYAT_cjs.buildPlaybackSegments; }
 });
 Object.defineProperty(exports, "getSpeedAtIndex", {
   enumerable: true,
-  get: function () { return chunkO5UJRGRV_cjs.getSpeedAtIndex; }
+  get: function () { return chunkNPKPCYAT_cjs.getSpeedAtIndex; }
 });
 Object.defineProperty(exports, "initEditableWords", {
   enumerable: true,
-  get: function () { return chunkO5UJRGRV_cjs.initEditableWords; }
+  get: function () { return chunkNPKPCYAT_cjs.initEditableWords; }
 });
 Object.defineProperty(exports, "insertSilences", {
   enumerable: true,
-  get: function () { return chunkO5UJRGRV_cjs.insertSilences; }
+  get: function () { return chunkNPKPCYAT_cjs.insertSilences; }
 });
 Object.defineProperty(exports, "useTranscriptEdits", {
   enumerable: true,
-  get: function () { return chunkO5UJRGRV_cjs.useTranscriptEdits; }
+  get: function () { return chunkNPKPCYAT_cjs.useTranscriptEdits; }
 });
 Object.defineProperty(exports, "useMediaTransport", {
   enumerable: true,

package/dist/hooks/index.d.cts

@@ -2,7 +2,7 @@ export { R as ResolvedTheme, T as Theme, u as useTheme } from '../useTheme-B9SWu
 import * as React from 'react';
 import { RefObject } from 'react';
 export { A as AnchoredPlacement, U as UseAnchoredPositionOptions, a as UseAnchoredPositionReturn, u as useAnchoredPosition } from '../useAnchoredPosition-nXdSFKHf.cjs';
-export { D as DEFAULT_FILLER_WORDS, a as DEFAULT_MIN_SILENCE_MS, b as DEFAULT_NL_SILENCE_MS, F as FillerAnalysis, S as SilenceThresholdCount, T as TranscriptClipboard, c as TranscriptEditStats, U as UseTranscriptEditsOptions, d as UseTranscriptEditsResult, e as buildPlaybackSegments, g as getSpeedAtIndex, i as initEditableWords, f as insertSilences, u as useTranscriptEdits } from '../useTranscriptEdits-DgeVQMSi.cjs';
+export { D as DEFAULT_FILLER_WORDS, a as DEFAULT_MIN_SILENCE_MS, b as DEFAULT_NL_SILENCE_MS, F as FillerAnalysis, S as SilenceThresholdCount, T as TranscriptClipboard, c as TranscriptEditStats, U as UseTranscriptEditsOptions, d as UseTranscriptEditsResult, e as buildPlaybackSegments, g as getSpeedAtIndex, i as initEditableWords, f as insertSilences, u as useTranscriptEdits } from '../useTranscriptEdits-CGzlemHT.cjs';
 import '../transcript-Cg7uSW-C.cjs';
 
 interface UseScrollSpyOptions {

package/dist/hooks/index.d.ts

@@ -2,7 +2,7 @@ export { R as ResolvedTheme, T as Theme, u as useTheme } from '../useTheme-B9SWu
 import * as React from 'react';
 import { RefObject } from 'react';
 export { A as AnchoredPlacement, U as UseAnchoredPositionOptions, a as UseAnchoredPositionReturn, u as useAnchoredPosition } from '../useAnchoredPosition-nXdSFKHf.js';
-export { D as DEFAULT_FILLER_WORDS, a as DEFAULT_MIN_SILENCE_MS, b as DEFAULT_NL_SILENCE_MS, F as FillerAnalysis, S as SilenceThresholdCount, T as TranscriptClipboard, c as TranscriptEditStats, U as UseTranscriptEditsOptions, d as UseTranscriptEditsResult, e as buildPlaybackSegments, g as getSpeedAtIndex, i as initEditableWords, f as insertSilences, u as useTranscriptEdits } from '../useTranscriptEdits-C0Hhy2pO.js';
+export { D as DEFAULT_FILLER_WORDS, a as DEFAULT_MIN_SILENCE_MS, b as DEFAULT_NL_SILENCE_MS, F as FillerAnalysis, S as SilenceThresholdCount, T as TranscriptClipboard, c as TranscriptEditStats, U as UseTranscriptEditsOptions, d as UseTranscriptEditsResult, e as buildPlaybackSegments, g as getSpeedAtIndex, i as initEditableWords, f as insertSilences, u as useTranscriptEdits } from '../useTranscriptEdits-D32bLs0l.js';
 import '../transcript-Cg7uSW-C.js';
 
 interface UseScrollSpyOptions {