@mieweb/ui 0.6.1-dev.168 → 0.6.1-dev.170

package/dist/transcript-oaWqY3yr.d.cts

@@ -0,0 +1,81 @@
+/**
+ * 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 {
+    /** Reference to original word in transcript.words */
+    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;
+}
+/**
+ * Represents a contiguous segment of playback from the original media.
+ * Used when playing back an edited timeline with potentially reordered/deleted words.
+ */
+interface PlaybackSegment {
+    startMs: number;
+    endMs: number;
+    /** Indices into the editedWords array that this segment covers */
+    editedIndices: number[];
+}
+/** Available playback speed multipliers */
+type PlaybackSpeed = 0.5 | 0.75 | 1 | 1.25 | 1.5 | 1.75 | 2;
+/** Array of all available speed options for dropdowns */
+declare const PLAYBACK_SPEEDS: PlaybackSpeed[];
+/**
+ * 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;
+}
+
+export { type EditableWord as E, type PlaybackSpeed as P, type SpeedMarker as S, type Transcript as T, type WordType as W, type PlaybackSegment as a, type TranscriptWord as b, PLAYBACK_SPEEDS as c, type Speaker as d, type TranscriptSegment as e };

package/dist/transcript-oaWqY3yr.d.ts

@@ -0,0 +1,81 @@
+/**
+ * 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 {
+    /** Reference to original word in transcript.words */
+    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;
+}
+/**
+ * Represents a contiguous segment of playback from the original media.
+ * Used when playing back an edited timeline with potentially reordered/deleted words.
+ */
+interface PlaybackSegment {
+    startMs: number;
+    endMs: number;
+    /** Indices into the editedWords array that this segment covers */
+    editedIndices: number[];
+}
+/** Available playback speed multipliers */
+type PlaybackSpeed = 0.5 | 0.75 | 1 | 1.25 | 1.5 | 1.75 | 2;
+/** Array of all available speed options for dropdowns */
+declare const PLAYBACK_SPEEDS: PlaybackSpeed[];
+/**
+ * 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;
+}
+
+export { type EditableWord as E, type PlaybackSpeed as P, type SpeedMarker as S, type Transcript as T, type WordType as W, type PlaybackSegment as a, type TranscriptWord as b, PLAYBACK_SPEEDS as c, type Speaker as d, type TranscriptSegment as e };

package/dist/useTranscriptEdits-BUylQFg0.d.cts

@@ -0,0 +1,168 @@
+import { E as EditableWord, T as Transcript, S as SpeedMarker, P as PlaybackSpeed, a as PlaybackSegment, b as TranscriptWord } from './transcript-oaWqY3yr.cjs';
+
+/**
+ * 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`.
+ */
+
+/** Default filler words offered for removal */
+declare const DEFAULT_FILLER_WORDS: string[];
+/** Default minimum silence duration in milliseconds to detect and insert */
+declare const DEFAULT_MIN_SILENCE_MS = 400;
+/** Default threshold for "newline" silences - longer pauses that indicate paragraph breaks */
+declare const DEFAULT_NL_SILENCE_MS = 1500;
+/** Clipboard data for cut/copy/paste operations */
+interface TranscriptClipboard {
+    words: EditableWord[];
+    operation: 'cut' | 'copy';
+}
+/** Count and total duration of silences above a given threshold (seconds) */
+interface SilenceThresholdCount {
+    threshold: number;
+    count: number;
+    durationMs: number;
+}
+/**
+ * Builds playback segments from the edited word list.
+ * Consecutive words in original order are merged into single segments.
+ * Inserted (pasted) words each get their own segment since they may be duplicates.
+ */
+declare function buildPlaybackSegments(editedWords: EditableWord[]): PlaybackSegment[];
+/**
+ * Get the effective playback speed at a given word index.
+ * Finds the most recent speed marker at or before the word index,
+ * or returns the default speed if no marker applies.
+ */
+declare function getSpeedAtIndex(wordIndex: number, speedMarkers: SpeedMarker[], defaultSpeed: PlaybackSpeed): PlaybackSpeed;
+/**
+ * Detect silences between words and return a new array with silence pseudo-words inserted.
+ * Silences are detected as gaps between the endMs of one word and startMs of the next.
+ * Silences >= nlSilenceMs are marked as 'silence-newline' for visual line breaks.
+ */
+declare function insertSilences(words: TranscriptWord[], minSilenceMs?: number, nlSilenceMs?: number): TranscriptWord[];
+/** Initialize editable words from transcript, inserting detected silences */
+declare function initEditableWords(transcript: Transcript, minSilenceMs?: number, nlSilenceMs?: number): EditableWord[];
+interface UseTranscriptEditsOptions {
+    /** The source transcript (canonical, immutable) */
+    transcript: Transcript;
+    /** Initial edited words (from saved edits) */
+    initialEditedWords?: EditableWord[];
+    /** Initial undo stack (from saved edits) */
+    initialUndoStack?: EditableWord[][];
+    /** Fired after every mutation (for persistence) */
+    onChange?: (editedWords: EditableWord[], undoStack: EditableWord[][]) => void;
+    /** Minimum silence duration (ms) to detect and insert. Default 400 */
+    minSilenceMs?: number;
+    /** Threshold (ms) for "newline" silences (paragraph breaks). Default 1500 */
+    nlSilenceMs?: number;
+}
+interface TranscriptEditStats {
+    /** Non-deleted spoken words (silences excluded) */
+    activeWordCount: number;
+    /** Non-deleted silence entries */
+    activeSilenceCount: number;
+    /** Deleted spoken words */
+    deletedWordCount: number;
+    /** Deleted silence entries */
+    deletedSilenceCount: number;
+    /** Total duration of non-deleted entries, adjusted for speed markers */
+    editedDurationMs: number;
+}
+interface FillerAnalysis {
+    /** Occurrence count per normalized word (fillers and every active word) */
+    matchCounts: Map<string, number>;
+    /** Total duration (ms) per normalized word */
+    durations: Map<string, number>;
+    /** Count + total duration of active silences above each analysis threshold */
+    silenceCounts: SilenceThresholdCount[];
+    /** The built-in filler word list */
+    defaultFillerWords: string[];
+}
+interface UseTranscriptEditsResult {
+    /** The edited timeline (words + silence pseudo-words) */
+    editedWords: EditableWord[];
+    /** Undo snapshots, oldest first */
+    undoStack: EditableWord[][];
+    /** Internal clipboard from the last cut/copy, or null */
+    clipboard: TranscriptClipboard | null;
+    /** Whether any edit has been made (deletions, insertions, text edits, speed markers) */
+    hasEdits: boolean;
+    /** Push the current editedWords onto the undo stack (call before external batch mutations) */
+    pushUndo: () => void;
+    /** Restore the most recent undo snapshot */
+    undo: () => void;
+    /** Toggle the deleted flag on a single word */
+    toggleWordDeleted: (index: number) => void;
+    /**
+     * Toggle the deleted state of a contiguous range. The first index acts as
+     * the anchor: all words are set to the opposite of the anchor's state
+     * (delete all if anchor active, restore all if anchor deleted).
+     */
+    deleteRange: (indices: number[]) => void;
+    /** Cut words at the given indices into the clipboard (marks them deleted) */
+    cut: (indices: number[]) => void;
+    /** Copy non-deleted words at the given indices into the clipboard */
+    copy: (indices: number[]) => void;
+    /**
+     * Paste the clipboard at a word index. `before` (default true) inserts
+     * before the word at `atIndex`; false inserts after it. Returns the index
+     * where the first pasted word landed, or null if the clipboard was empty.
+     */
+    paste: (atIndex: number, before?: boolean) => number | null;
+    /** Replace a word's text (no-op if unchanged) */
+    setWordText: (index: number, text: string) => void;
+    /** Split a silence at the given index into segments with the given durations (seconds) */
+    splitSilence: (index: number, durationsSec: number[]) => void;
+    /** Toggle the word at the index deleted (editor "delete" action) */
+    deleteWord: (index: number) => void;
+    /** Replace the entire edit state from an external source (e.g. an editable script view); undo-safe */
+    replaceEditedWords: (next: EditableWord[]) => void;
+    /** Mark matching filler words (and silences above the given seconds threshold) deleted */
+    removeFillers: (fillerWords: string[], removeSilenceAboveSec: number | null) => void;
+    /** Rebuild silence detection with new thresholds, preserving word deletions */
+    setSilenceThresholds: (minMs: number, nlMs: number) => void;
+    /** Current silence detection thresholds (ms) */
+    silenceThresholds: {
+        minSilenceMs: number;
+        nlSilenceMs: number;
+    };
+    /** Speed markers, sorted by word index */
+    speedMarkers: SpeedMarker[];
+    /** Default playback speed when no marker applies */
+    defaultSpeed: PlaybackSpeed;
+    /** Set the default playback speed */
+    setDefaultSpeed: (speed: PlaybackSpeed) => void;
+    /** Add/update/remove a speed marker (re-selecting the same speed removes it) */
+    toggleSpeedMarker: (index: number, speed: PlaybackSpeed) => void;
+    /** Remove the speed marker at a word index, if any */
+    removeSpeedMarker: (index: number) => void;
+    /** Effective playback speed at a word index */
+    getSpeedAtIndex: (index: number) => PlaybackSpeed;
+    /** The speed marker at a word index, if any */
+    getSpeedMarkerAtIndex: (index: number) => SpeedMarker | undefined;
+    /** Contiguous playback segments built from the edited timeline */
+    playbackSegments: PlaybackSegment[];
+    /** Word/silence counts and speed-adjusted edited duration */
+    stats: TranscriptEditStats;
+    /** Filler word and silence analysis for removal UIs */
+    fillerAnalysis: FillerAnalysis;
+}
+/**
+ * Headless transcript-editing hook. See module docs for scope.
+ *
+ * Undo semantics: each mutation snapshots the full `editedWords` array onto
+ * a single-level stack before applying; `undo` pops one snapshot. Speed
+ * markers and silence-threshold changes are NOT part of the undo stack
+ * (matching the source component).
+ */
+declare function useTranscriptEdits(options: UseTranscriptEditsOptions): UseTranscriptEditsResult;
+
+export { DEFAULT_FILLER_WORDS as D, type FillerAnalysis as F, type SilenceThresholdCount as S, type TranscriptClipboard as T, type UseTranscriptEditsOptions as U, DEFAULT_MIN_SILENCE_MS as a, DEFAULT_NL_SILENCE_MS as b, type TranscriptEditStats as c, type UseTranscriptEditsResult as d, buildPlaybackSegments as e, insertSilences as f, getSpeedAtIndex as g, initEditableWords as i, useTranscriptEdits as u };

package/dist/useTranscriptEdits-CWYnjbGP.d.ts

@@ -0,0 +1,168 @@
+import { E as EditableWord, T as Transcript, S as SpeedMarker, P as PlaybackSpeed, a as PlaybackSegment, b as TranscriptWord } from './transcript-oaWqY3yr.js';
+
+/**
+ * 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`.
+ */
+
+/** Default filler words offered for removal */
+declare const DEFAULT_FILLER_WORDS: string[];
+/** Default minimum silence duration in milliseconds to detect and insert */
+declare const DEFAULT_MIN_SILENCE_MS = 400;
+/** Default threshold for "newline" silences - longer pauses that indicate paragraph breaks */
+declare const DEFAULT_NL_SILENCE_MS = 1500;
+/** Clipboard data for cut/copy/paste operations */
+interface TranscriptClipboard {
+    words: EditableWord[];
+    operation: 'cut' | 'copy';
+}
+/** Count and total duration of silences above a given threshold (seconds) */
+interface SilenceThresholdCount {
+    threshold: number;
+    count: number;
+    durationMs: number;
+}
+/**
+ * Builds playback segments from the edited word list.
+ * Consecutive words in original order are merged into single segments.
+ * Inserted (pasted) words each get their own segment since they may be duplicates.
+ */
+declare function buildPlaybackSegments(editedWords: EditableWord[]): PlaybackSegment[];
+/**
+ * Get the effective playback speed at a given word index.
+ * Finds the most recent speed marker at or before the word index,
+ * or returns the default speed if no marker applies.
+ */
+declare function getSpeedAtIndex(wordIndex: number, speedMarkers: SpeedMarker[], defaultSpeed: PlaybackSpeed): PlaybackSpeed;
+/**
+ * Detect silences between words and return a new array with silence pseudo-words inserted.
+ * Silences are detected as gaps between the endMs of one word and startMs of the next.
+ * Silences >= nlSilenceMs are marked as 'silence-newline' for visual line breaks.
+ */
+declare function insertSilences(words: TranscriptWord[], minSilenceMs?: number, nlSilenceMs?: number): TranscriptWord[];
+/** Initialize editable words from transcript, inserting detected silences */
+declare function initEditableWords(transcript: Transcript, minSilenceMs?: number, nlSilenceMs?: number): EditableWord[];
+interface UseTranscriptEditsOptions {
+    /** The source transcript (canonical, immutable) */
+    transcript: Transcript;
+    /** Initial edited words (from saved edits) */
+    initialEditedWords?: EditableWord[];
+    /** Initial undo stack (from saved edits) */
+    initialUndoStack?: EditableWord[][];
+    /** Fired after every mutation (for persistence) */
+    onChange?: (editedWords: EditableWord[], undoStack: EditableWord[][]) => void;
+    /** Minimum silence duration (ms) to detect and insert. Default 400 */
+    minSilenceMs?: number;
+    /** Threshold (ms) for "newline" silences (paragraph breaks). Default 1500 */
+    nlSilenceMs?: number;
+}
+interface TranscriptEditStats {
+    /** Non-deleted spoken words (silences excluded) */
+    activeWordCount: number;
+    /** Non-deleted silence entries */
+    activeSilenceCount: number;
+    /** Deleted spoken words */
+    deletedWordCount: number;
+    /** Deleted silence entries */
+    deletedSilenceCount: number;
+    /** Total duration of non-deleted entries, adjusted for speed markers */
+    editedDurationMs: number;
+}
+interface FillerAnalysis {
+    /** Occurrence count per normalized word (fillers and every active word) */
+    matchCounts: Map<string, number>;
+    /** Total duration (ms) per normalized word */
+    durations: Map<string, number>;
+    /** Count + total duration of active silences above each analysis threshold */
+    silenceCounts: SilenceThresholdCount[];
+    /** The built-in filler word list */
+    defaultFillerWords: string[];
+}
+interface UseTranscriptEditsResult {
+    /** The edited timeline (words + silence pseudo-words) */
+    editedWords: EditableWord[];
+    /** Undo snapshots, oldest first */
+    undoStack: EditableWord[][];
+    /** Internal clipboard from the last cut/copy, or null */
+    clipboard: TranscriptClipboard | null;
+    /** Whether any edit has been made (deletions, insertions, text edits, speed markers) */
+    hasEdits: boolean;
+    /** Push the current editedWords onto the undo stack (call before external batch mutations) */
+    pushUndo: () => void;
+    /** Restore the most recent undo snapshot */
+    undo: () => void;
+    /** Toggle the deleted flag on a single word */
+    toggleWordDeleted: (index: number) => void;
+    /**
+     * Toggle the deleted state of a contiguous range. The first index acts as
+     * the anchor: all words are set to the opposite of the anchor's state
+     * (delete all if anchor active, restore all if anchor deleted).
+     */
+    deleteRange: (indices: number[]) => void;
+    /** Cut words at the given indices into the clipboard (marks them deleted) */
+    cut: (indices: number[]) => void;
+    /** Copy non-deleted words at the given indices into the clipboard */
+    copy: (indices: number[]) => void;
+    /**
+     * Paste the clipboard at a word index. `before` (default true) inserts
+     * before the word at `atIndex`; false inserts after it. Returns the index
+     * where the first pasted word landed, or null if the clipboard was empty.
+     */
+    paste: (atIndex: number, before?: boolean) => number | null;
+    /** Replace a word's text (no-op if unchanged) */
+    setWordText: (index: number, text: string) => void;
+    /** Split a silence at the given index into segments with the given durations (seconds) */
+    splitSilence: (index: number, durationsSec: number[]) => void;
+    /** Toggle the word at the index deleted (editor "delete" action) */
+    deleteWord: (index: number) => void;
+    /** Replace the entire edit state from an external source (e.g. an editable script view); undo-safe */
+    replaceEditedWords: (next: EditableWord[]) => void;
+    /** Mark matching filler words (and silences above the given seconds threshold) deleted */
+    removeFillers: (fillerWords: string[], removeSilenceAboveSec: number | null) => void;
+    /** Rebuild silence detection with new thresholds, preserving word deletions */
+    setSilenceThresholds: (minMs: number, nlMs: number) => void;
+    /** Current silence detection thresholds (ms) */
+    silenceThresholds: {
+        minSilenceMs: number;
+        nlSilenceMs: number;
+    };
+    /** Speed markers, sorted by word index */
+    speedMarkers: SpeedMarker[];
+    /** Default playback speed when no marker applies */
+    defaultSpeed: PlaybackSpeed;
+    /** Set the default playback speed */
+    setDefaultSpeed: (speed: PlaybackSpeed) => void;
+    /** Add/update/remove a speed marker (re-selecting the same speed removes it) */
+    toggleSpeedMarker: (index: number, speed: PlaybackSpeed) => void;
+    /** Remove the speed marker at a word index, if any */
+    removeSpeedMarker: (index: number) => void;
+    /** Effective playback speed at a word index */
+    getSpeedAtIndex: (index: number) => PlaybackSpeed;
+    /** The speed marker at a word index, if any */
+    getSpeedMarkerAtIndex: (index: number) => SpeedMarker | undefined;
+    /** Contiguous playback segments built from the edited timeline */
+    playbackSegments: PlaybackSegment[];
+    /** Word/silence counts and speed-adjusted edited duration */
+    stats: TranscriptEditStats;
+    /** Filler word and silence analysis for removal UIs */
+    fillerAnalysis: FillerAnalysis;
+}
+/**
+ * Headless transcript-editing hook. See module docs for scope.
+ *
+ * Undo semantics: each mutation snapshots the full `editedWords` array onto
+ * a single-level stack before applying; `undo` pops one snapshot. Speed
+ * markers and silence-threshold changes are NOT part of the undo stack
+ * (matching the source component).
+ */
+declare function useTranscriptEdits(options: UseTranscriptEditsOptions): UseTranscriptEditsResult;
+
+export { DEFAULT_FILLER_WORDS as D, type FillerAnalysis as F, type SilenceThresholdCount as S, type TranscriptClipboard as T, type UseTranscriptEditsOptions as U, DEFAULT_MIN_SILENCE_MS as a, DEFAULT_NL_SILENCE_MS as b, type TranscriptEditStats as c, type UseTranscriptEditsResult as d, buildPlaybackSegments as e, insertSilences as f, getSpeedAtIndex as g, initEditableWords as i, useTranscriptEdits as u };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mieweb/ui",
-  "version": "0.6.1-dev.168",
+  "version": "0.6.1-dev.170",
   "description": "A themeable, accessible React component library built with Tailwind CSS",
   "author": "Medical Informatics Engineering, Inc.",
   "license": "SEE LICENSE IN LICENSE",