@mieweb/ui 0.6.1 → 0.7.0-dev.179

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/dist/utils/index.cjs

@@ -1,13 +1,38 @@
 'use strict';
 
-require('../chunk-74K3RRU7.cjs');
-var chunkCW75IKA6_cjs = require('../chunk-CW75IKA6.cjs');
+require('../chunk-AT732HC6.cjs');
+var chunkC7RVKV25_cjs = require('../chunk-C7RVKV25.cjs');
 var chunkL7YQBSEL_cjs = require('../chunk-L7YQBSEL.cjs');
+var chunkCW75IKA6_cjs = require('../chunk-CW75IKA6.cjs');
 var chunkOR5DRJCW_cjs = require('../chunk-OR5DRJCW.cjs');
 var chunkSCV7C55E_cjs = require('../chunk-SCV7C55E.cjs');
 
 
 
+Object.defineProperty(exports, "isHtmlEmpty", {
+  enumerable: true,
+  get: function () { return chunkC7RVKV25_cjs.isHtmlEmpty; }
+});
+Object.defineProperty(exports, "stripHtmlTags", {
+  enumerable: true,
+  get: function () { return chunkC7RVKV25_cjs.stripHtmlTags; }
+});
+Object.defineProperty(exports, "formatPhoneNumber", {
+  enumerable: true,
+  get: function () { return chunkL7YQBSEL_cjs.formatPhoneNumber; }
+});
+Object.defineProperty(exports, "isPhoneNumberEmpty", {
+  enumerable: true,
+  get: function () { return chunkL7YQBSEL_cjs.isPhoneNumberEmpty; }
+});
+Object.defineProperty(exports, "isValidPhoneNumber", {
+  enumerable: true,
+  get: function () { return chunkL7YQBSEL_cjs.isValidPhoneNumber; }
+});
+Object.defineProperty(exports, "unformatPhoneNumber", {
+  enumerable: true,
+  get: function () { return chunkL7YQBSEL_cjs.unformatPhoneNumber; }
+});
 Object.defineProperty(exports, "calculateAge", {
   enumerable: true,
   get: function () { return chunkCW75IKA6_cjs.calculateAge; }
@@ -48,22 +73,6 @@ Object.defineProperty(exports, "parseDateValue", {
   enumerable: true,
   get: function () { return chunkCW75IKA6_cjs.parseDateValue; }
 });
-Object.defineProperty(exports, "formatPhoneNumber", {
-  enumerable: true,
-  get: function () { return chunkL7YQBSEL_cjs.formatPhoneNumber; }
-});
-Object.defineProperty(exports, "isPhoneNumberEmpty", {
-  enumerable: true,
-  get: function () { return chunkL7YQBSEL_cjs.isPhoneNumberEmpty; }
-});
-Object.defineProperty(exports, "isValidPhoneNumber", {
-  enumerable: true,
-  get: function () { return chunkL7YQBSEL_cjs.isValidPhoneNumber; }
-});
-Object.defineProperty(exports, "unformatPhoneNumber", {
-  enumerable: true,
-  get: function () { return chunkL7YQBSEL_cjs.unformatPhoneNumber; }
-});
 Object.defineProperty(exports, "cn", {
   enumerable: true,
   get: function () { return chunkOR5DRJCW_cjs.cn; }

package/dist/utils/index.d.cts

@@ -1,4 +1,5 @@
 import { ClassValue } from 'clsx';
+export { i as isHtmlEmpty, s as stripHtmlTags } from '../html-MdxqSzjD.cjs';
 
 /**
  * Utility function to merge Tailwind CSS classes with proper precedence.

package/dist/utils/index.d.ts

@@ -1,4 +1,5 @@
 import { ClassValue } from 'clsx';
+export { i as isHtmlEmpty, s as stripHtmlTags } from '../html-MdxqSzjD.js';
 
 /**
  * Utility function to merge Tailwind CSS classes with proper precedence.

package/dist/utils/index.js

@@ -1,6 +1,7 @@
-import '../chunk-V2DF2GUE.js';
-export { calculateAge, dateToDisplayFormat, displayFormatToDateString, formatDateValue, isDateEmpty, isDateInFuture, isDateInPast, isValidDate, isValidDrivingAge, parseDateValue } from '../chunk-RC2YMOMS.js';
+import '../chunk-7XUN3OQT.js';
+export { isHtmlEmpty, stripHtmlTags } from '../chunk-ERLPVXOV.js';
 export { formatPhoneNumber, isPhoneNumberEmpty, isValidPhoneNumber, unformatPhoneNumber } from '../chunk-ZVPJ2MH6.js';
+export { calculateAge, dateToDisplayFormat, displayFormatToDateString, formatDateValue, isDateEmpty, isDateInFuture, isDateInPast, isValidDate, isValidDrivingAge, parseDateValue } from '../chunk-RC2YMOMS.js';
 export { cn } from '../chunk-F3SOEIN2.js';
 export { isStorybookDocsMode } from '../chunk-VSQF22GL.js';
 //# sourceMappingURL=index.js.map