@mieweb/ui 0.10.0-dev.11 → 0.10.0-dev.13

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

@@ -62,10 +62,10 @@ declare const audioRecorderVariants: (props?: ({
     variant?: "default" | "minimal" | "elevated" | null | undefined;
 } & class_variance_authority_types.ClassProp) | undefined) => string;
 declare const waveformContainerVariants: (props?: ({
-    state?: "paused" | "idle" | "recording" | "listening" | "stopped" | "playback" | null | undefined;
+    state?: "idle" | "listening" | "recording" | "paused" | "stopped" | "playback" | null | undefined;
 } & class_variance_authority_types.ClassProp) | undefined) => string;
 declare const controlButtonVariants: (props?: ({
-    variant?: "primary" | "secondary" | "ghost" | "danger" | null | undefined;
+    variant?: "primary" | "secondary" | "danger" | "ghost" | null | undefined;
     size?: "sm" | "md" | "lg" | null | undefined;
 } & class_variance_authority_types.ClassProp) | undefined) => string;
 declare function formatTime(seconds: number): string;

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

@@ -1,8 +1,14 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import * as React from 'react';
 import { VariantProps } from 'class-variance-authority';
-import { inputVariants, RequiredMarkVariant } from '../Input/index.cjs';
-import 'class-variance-authority/types';
+import * as class_variance_authority_types from 'class-variance-authority/types';
+
+declare const inputVariants: (props?: ({
+    size?: "sm" | "md" | "lg" | null | undefined;
+    hasError?: boolean | null | undefined;
+    labelVariant?: "stacked" | "floating" | null | undefined;
+} & class_variance_authority_types.ClassProp) | undefined) => string;
+type RequiredMarkVariant = 'default' | 'warning';
 
 interface AutocompleteProps<T> extends Pick<VariantProps<typeof inputVariants>, 'size'> {
     /** Candidate items to search through. */

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

@@ -1,8 +1,14 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import * as React from 'react';
 import { VariantProps } from 'class-variance-authority';
-import { inputVariants, RequiredMarkVariant } from '../Input/index.js';
-import 'class-variance-authority/types';
+import * as class_variance_authority_types from 'class-variance-authority/types';
+
+declare const inputVariants: (props?: ({
+    size?: "sm" | "md" | "lg" | null | undefined;
+    hasError?: boolean | null | undefined;
+    labelVariant?: "stacked" | "floating" | null | undefined;
+} & class_variance_authority_types.ClassProp) | undefined) => string;
+type RequiredMarkVariant = 'default' | 'warning';
 
 interface AutocompleteProps<T> extends Pick<VariantProps<typeof inputVariants>, 'size'> {
     /** Candidate items to search through. */

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

@@ -3,7 +3,7 @@ import * as React from 'react';
 import { VariantProps } from 'class-variance-authority';
 
 declare const avatarVariants: (props?: ({
-    size?: "sm" | "md" | "lg" | "xl" | "xs" | null | undefined;
+    size?: "xs" | "sm" | "md" | "lg" | "xl" | null | undefined;
     ring?: boolean | null | undefined;
 } & class_variance_authority_types.ClassProp) | undefined) => string;
 interface AvatarProps extends React.HTMLAttributes<HTMLDivElement>, VariantProps<typeof avatarVariants> {

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

@@ -3,7 +3,7 @@ import * as React from 'react';
 import { VariantProps } from 'class-variance-authority';
 
 declare const avatarVariants: (props?: ({
-    size?: "sm" | "md" | "lg" | "xl" | "xs" | null | undefined;
+    size?: "xs" | "sm" | "md" | "lg" | "xl" | null | undefined;
     ring?: boolean | null | undefined;
 } & class_variance_authority_types.ClassProp) | undefined) => string;
 interface AvatarProps extends React.HTMLAttributes<HTMLDivElement>, VariantProps<typeof avatarVariants> {

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

@@ -3,7 +3,7 @@ import * as React from 'react';
 import { VariantProps } from 'class-variance-authority';
 
 declare const badgeVariants: (props?: ({
-    variant?: "default" | "secondary" | "outline" | "danger" | "warning" | "success" | null | undefined;
+    variant?: "default" | "secondary" | "success" | "warning" | "danger" | "outline" | null | undefined;
     size?: "sm" | "md" | "lg" | null | undefined;
 } & class_variance_authority_types.ClassProp) | undefined) => string;
 interface BadgeProps extends React.HTMLAttributes<HTMLSpanElement>, VariantProps<typeof badgeVariants> {

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

@@ -3,7 +3,7 @@ import * as React from 'react';
 import { VariantProps } from 'class-variance-authority';
 
 declare const badgeVariants: (props?: ({
-    variant?: "default" | "secondary" | "outline" | "danger" | "warning" | "success" | null | undefined;
+    variant?: "default" | "secondary" | "success" | "warning" | "danger" | "outline" | null | undefined;
     size?: "sm" | "md" | "lg" | null | undefined;
 } & class_variance_authority_types.ClassProp) | undefined) => string;
 interface BadgeProps extends React.HTMLAttributes<HTMLSpanElement>, VariantProps<typeof badgeVariants> {

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

@@ -1,9 +1,96 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import * as class_variance_authority_types from 'class-variance-authority/types';
 import { VariantProps } from 'class-variance-authority';
-import { c as ViewLabels, a as ViewBaseProps, S as Stage } from '../../types-CbWXIKbe.cjs';
-import 'react';
-import 'luxon';
+import * as React from 'react';
+
+/**
+ * The contract every component in the `Modules/Views` family reads through.
+ *
+ * A page describes its collection once — which field is the id, the title, the
+ * status, the start date — and every view understands it. That is the whole
+ * reason the family exists: without it each view needs its own adapter and you
+ * end up re-implementing the same board per entity.
+ *
+ * Views are headless. Nothing here fetches, subscribes, or navigates.
+ * See CONTRIBUTING → "Modules: headless data components".
+ */
+
+/**
+ * Which layout is on screen. `overview` and `table` are rendered by the host
+ * through `ViewSet` slots rather than by a component in this family — a tabular
+ * collection is `DataVisNitroGrid`, and an overview is domain content.
+ */
+type ViewId = 'overview' | 'list' | 'board' | 'calendar' | 'gantt' | 'roadmap' | 'table';
+/**
+ * A semantic colour name, resolved to `--mieweb-*` tokens by each view.
+ *
+ * Accessors return one of these rather than a class string so a caller cannot
+ * hardcode a palette that breaks under another brand or in dark mode.
+ */
+type Accent = 'primary' | 'success' | 'warning' | 'destructive' | 'info' | 'neutral';
+/** A named stage: a board column, and the segments of a stage bar. */
+interface Stage {
+    id: string;
+    label: string;
+    accent?: Accent;
+}
+/**
+ * How a view reads one item. Only `getId` and `getTitle` are always required;
+ * each view documents which of the rest it needs (a board needs `getStatus`, a
+ * Gantt needs `getStart`) and renders an explanatory empty state without them.
+ */
+interface ViewAccessors<T> {
+    getId: (item: T) => string;
+    getTitle: (item: T) => string;
+    /** Secondary line under the title. */
+    getSubtitle?: (item: T) => string | undefined;
+    /** Board column and list group; matched against `Stage['id']`. */
+    getStatus?: (item: T) => string;
+    /** Gantt bar start, calendar placement. */
+    getStart?: (item: T) => Date | string | null | undefined;
+    /** Gantt bar end, calendar span. Falls back to the start when absent. */
+    getEnd?: (item: T) => Date | string | null | undefined;
+    /** Swimlane in a roadmap, row group in a Gantt. */
+    getGroup?: (item: T) => string | undefined;
+    getAccent?: (item: T) => Accent;
+}
+/** Strings a view renders. Every one is overridable; the defaults are English. */
+interface ViewLabels {
+    /** Accessible name of the view switcher group. */
+    viewSwitcher: string;
+    loading: string;
+    empty: string;
+    error: string;
+    /** Action on the error state. */
+    retry: string;
+    /** Heading for the group a record with no status or group falls into. */
+    ungrouped: string;
+}
+/**
+ * Props every view accepts. Views are controlled: selection, the active view and
+ * filter state live in the page, and every change is handed back.
+ */
+interface ViewBaseProps<T> {
+    items: T[];
+    accessors: ViewAccessors<T>;
+    loading?: boolean;
+    error?: Error | null;
+    selectedId?: string | null;
+    /** Called when the user activates an item. */
+    onOpen?: (id: string, item: T) => void;
+    /** Return a URL to render each item as a real anchor — middle-clickable and crawlable. */
+    getHref?: (id: string, item: T) => string;
+    /** Render one item. Receives the active view so one function can serve several. */
+    renderItem?: (item: T, context: {
+        view: ViewId;
+    }) => React.ReactNode;
+    /** Replaces the built-in empty state. */
+    emptyState?: React.ReactNode;
+    labels?: Partial<ViewLabels>;
+    /** Pins "today" so stories, tests and visual snapshots stay deterministic. */
+    now?: Date;
+    className?: string;
+}
 
 type BoardViewSlot = 'column' | 'columnHeader' | 'card' | 'selectedCard' | 'state';
 interface BoardLabels extends ViewLabels {
@@ -32,7 +119,7 @@ interface BoardViewProps<T> extends ViewBaseProps<T>, VariantProps<typeof cardVa
     headingLevel?: 'h2' | 'h3' | 'h4';
 }
 declare const cardVariants: (props?: ({
-    density?: "compact" | "comfortable" | null | undefined;
+    density?: "comfortable" | "compact" | null | undefined;
     interactive?: boolean | null | undefined;
     selected?: boolean | null | undefined;
     pending?: boolean | null | undefined;

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

@@ -1,9 +1,96 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import * as class_variance_authority_types from 'class-variance-authority/types';
 import { VariantProps } from 'class-variance-authority';
-import { c as ViewLabels, a as ViewBaseProps, S as Stage } from '../../types-CbWXIKbe.js';
-import 'react';
-import 'luxon';
+import * as React from 'react';
+
+/**
+ * The contract every component in the `Modules/Views` family reads through.
+ *
+ * A page describes its collection once — which field is the id, the title, the
+ * status, the start date — and every view understands it. That is the whole
+ * reason the family exists: without it each view needs its own adapter and you
+ * end up re-implementing the same board per entity.
+ *
+ * Views are headless. Nothing here fetches, subscribes, or navigates.
+ * See CONTRIBUTING → "Modules: headless data components".
+ */
+
+/**
+ * Which layout is on screen. `overview` and `table` are rendered by the host
+ * through `ViewSet` slots rather than by a component in this family — a tabular
+ * collection is `DataVisNitroGrid`, and an overview is domain content.
+ */
+type ViewId = 'overview' | 'list' | 'board' | 'calendar' | 'gantt' | 'roadmap' | 'table';
+/**
+ * A semantic colour name, resolved to `--mieweb-*` tokens by each view.
+ *
+ * Accessors return one of these rather than a class string so a caller cannot
+ * hardcode a palette that breaks under another brand or in dark mode.
+ */
+type Accent = 'primary' | 'success' | 'warning' | 'destructive' | 'info' | 'neutral';
+/** A named stage: a board column, and the segments of a stage bar. */
+interface Stage {
+    id: string;
+    label: string;
+    accent?: Accent;
+}
+/**
+ * How a view reads one item. Only `getId` and `getTitle` are always required;
+ * each view documents which of the rest it needs (a board needs `getStatus`, a
+ * Gantt needs `getStart`) and renders an explanatory empty state without them.
+ */
+interface ViewAccessors<T> {
+    getId: (item: T) => string;
+    getTitle: (item: T) => string;
+    /** Secondary line under the title. */
+    getSubtitle?: (item: T) => string | undefined;
+    /** Board column and list group; matched against `Stage['id']`. */
+    getStatus?: (item: T) => string;
+    /** Gantt bar start, calendar placement. */
+    getStart?: (item: T) => Date | string | null | undefined;
+    /** Gantt bar end, calendar span. Falls back to the start when absent. */
+    getEnd?: (item: T) => Date | string | null | undefined;
+    /** Swimlane in a roadmap, row group in a Gantt. */
+    getGroup?: (item: T) => string | undefined;
+    getAccent?: (item: T) => Accent;
+}
+/** Strings a view renders. Every one is overridable; the defaults are English. */
+interface ViewLabels {
+    /** Accessible name of the view switcher group. */
+    viewSwitcher: string;
+    loading: string;
+    empty: string;
+    error: string;
+    /** Action on the error state. */
+    retry: string;
+    /** Heading for the group a record with no status or group falls into. */
+    ungrouped: string;
+}
+/**
+ * Props every view accepts. Views are controlled: selection, the active view and
+ * filter state live in the page, and every change is handed back.
+ */
+interface ViewBaseProps<T> {
+    items: T[];
+    accessors: ViewAccessors<T>;
+    loading?: boolean;
+    error?: Error | null;
+    selectedId?: string | null;
+    /** Called when the user activates an item. */
+    onOpen?: (id: string, item: T) => void;
+    /** Return a URL to render each item as a real anchor — middle-clickable and crawlable. */
+    getHref?: (id: string, item: T) => string;
+    /** Render one item. Receives the active view so one function can serve several. */
+    renderItem?: (item: T, context: {
+        view: ViewId;
+    }) => React.ReactNode;
+    /** Replaces the built-in empty state. */
+    emptyState?: React.ReactNode;
+    labels?: Partial<ViewLabels>;
+    /** Pins "today" so stories, tests and visual snapshots stay deterministic. */
+    now?: Date;
+    className?: string;
+}
 
 type BoardViewSlot = 'column' | 'columnHeader' | 'card' | 'selectedCard' | 'state';
 interface BoardLabels extends ViewLabels {
@@ -32,7 +119,7 @@ interface BoardViewProps<T> extends ViewBaseProps<T>, VariantProps<typeof cardVa
     headingLevel?: 'h2' | 'h3' | 'h4';
 }
 declare const cardVariants: (props?: ({
-    density?: "compact" | "comfortable" | null | undefined;
+    density?: "comfortable" | "compact" | null | undefined;
     interactive?: boolean | null | undefined;
     selected?: boolean | null | undefined;
     pending?: boolean | null | undefined;

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

@@ -3,7 +3,7 @@ import * as React from 'react';
 import { VariantProps } from 'class-variance-authority';
 
 declare const buttonVariants: (props?: ({
-    variant?: "link" | "primary" | "secondary" | "ghost" | "outline" | "danger" | null | undefined;
+    variant?: "link" | "secondary" | "danger" | "outline" | "primary" | "ghost" | null | undefined;
     size?: "sm" | "md" | "lg" | "icon" | null | undefined;
     fullWidth?: boolean | null | undefined;
     effect?: "none" | "sheen" | "orbit" | null | undefined;

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

@@ -3,7 +3,7 @@ import * as React from 'react';
 import { VariantProps } from 'class-variance-authority';
 
 declare const buttonVariants: (props?: ({
-    variant?: "link" | "primary" | "secondary" | "ghost" | "outline" | "danger" | null | undefined;
+    variant?: "link" | "secondary" | "danger" | "outline" | "primary" | "ghost" | null | undefined;
     size?: "sm" | "md" | "lg" | "icon" | null | undefined;
     fullWidth?: boolean | null | undefined;
     effect?: "none" | "sheen" | "orbit" | null | undefined;

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

@@ -1,7 +1,6 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
-import { c as ViewLabels, a as ViewBaseProps } from '../../types-CbWXIKbe.cjs';
+import { V as ViewLabels, a as ViewBaseProps } from '../../types-DsdZvEI1.cjs';
 import 'react';
-import 'luxon';
 
 type CalendarViewSlot = 'toolbar' | 'weekday' | 'day' | 'outsideDay' | 'today' | 'entry' | 'selectedEntry' | 'state';
 interface CalendarLabels extends ViewLabels {

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

@@ -1,7 +1,6 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
-import { c as ViewLabels, a as ViewBaseProps } from '../../types-CbWXIKbe.js';
+import { V as ViewLabels, a as ViewBaseProps } from '../../types-DsdZvEI1.js';
 import 'react';
-import 'luxon';
 
 type CalendarViewSlot = 'toolbar' | 'weekday' | 'day' | 'outsideDay' | 'today' | 'entry' | 'selectedEntry' | 'state';
 interface CalendarLabels extends ViewLabels {

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

@@ -4,13 +4,13 @@ import { VariantProps } from 'class-variance-authority';
 
 declare const cardVariants: (props?: ({
     padding?: "none" | "sm" | "md" | "lg" | "xl" | null | undefined;
-    variant?: "default" | "ghost" | "filled" | "elevated" | "outlined" | null | undefined;
+    variant?: "default" | "elevated" | "outlined" | "ghost" | "filled" | null | undefined;
     interactive?: boolean | null | undefined;
     selected?: boolean | null | undefined;
-    orientation?: "horizontal" | "vertical" | null | undefined;
+    orientation?: "vertical" | "horizontal" | null | undefined;
 } & class_variance_authority_types.ClassProp) | undefined) => string;
 declare const cardAccentVariants: (props?: ({
-    color?: "primary" | "warning" | "success" | "info" | "destructive" | null | undefined;
+    color?: "primary" | "success" | "warning" | "destructive" | "info" | null | undefined;
 } & class_variance_authority_types.ClassProp) | undefined) => string;
 interface CardProps extends React.HTMLAttributes<HTMLDivElement>, VariantProps<typeof cardVariants> {
     /** Semantic HTML element to render as */

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

@@ -4,13 +4,13 @@ import { VariantProps } from 'class-variance-authority';
 
 declare const cardVariants: (props?: ({
     padding?: "none" | "sm" | "md" | "lg" | "xl" | null | undefined;
-    variant?: "default" | "ghost" | "filled" | "elevated" | "outlined" | null | undefined;
+    variant?: "default" | "elevated" | "outlined" | "ghost" | "filled" | null | undefined;
     interactive?: boolean | null | undefined;
     selected?: boolean | null | undefined;
-    orientation?: "horizontal" | "vertical" | null | undefined;
+    orientation?: "vertical" | "horizontal" | null | undefined;
 } & class_variance_authority_types.ClassProp) | undefined) => string;
 declare const cardAccentVariants: (props?: ({
-    color?: "primary" | "warning" | "success" | "info" | "destructive" | null | undefined;
+    color?: "primary" | "success" | "warning" | "destructive" | "info" | null | undefined;
 } & class_variance_authority_types.ClassProp) | undefined) => string;
 interface CardProps extends React.HTMLAttributes<HTMLDivElement>, VariantProps<typeof cardVariants> {
     /** Semantic HTML element to render as */

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

@@ -1,6 +1,7 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import * as React from 'react';
-import { A as AnchoredPlacement } from '../../useAnchoredPosition-CKwLSQW8.cjs';
+
+type AnchoredPlacement = 'bottom-start' | 'bottom-end' | 'bottom' | 'top-start' | 'top-end' | 'top' | 'right-start' | 'right-end' | 'right' | 'left-start' | 'left-end' | 'left';
 
 type DropdownPlacement = AnchoredPlacement;
 interface DropdownProps {

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

@@ -1,6 +1,7 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import * as React from 'react';
-import { A as AnchoredPlacement } from '../../useAnchoredPosition-CKwLSQW8.js';
+
+type AnchoredPlacement = 'bottom-start' | 'bottom-end' | 'bottom' | 'top-start' | 'top-end' | 'top' | 'right-start' | 'right-end' | 'right' | 'left-start' | 'left-end' | 'left';
 
 type DropdownPlacement = AnchoredPlacement;
 interface DropdownProps {

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

@@ -1,7 +1,6 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
-import { c as ViewLabels, a as ViewBaseProps } from '../../types-CbWXIKbe.cjs';
+import { V as ViewLabels, a as ViewBaseProps } from '../../types-DsdZvEI1.cjs';
 import 'react';
-import 'luxon';
 
 /**
  * Column width in time. `month` and `quarter` are what a roadmap is — the

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

@@ -1,7 +1,6 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
-import { c as ViewLabels, a as ViewBaseProps } from '../../types-CbWXIKbe.js';
+import { V as ViewLabels, a as ViewBaseProps } from '../../types-DsdZvEI1.js';
 import 'react';
-import 'luxon';
 
 /**
  * Column width in time. `month` and `quarter` are what a roadmap is — the

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

@@ -1,9 +1,8 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import * as class_variance_authority_types from 'class-variance-authority/types';
 import { VariantProps } from 'class-variance-authority';
-import { a as ViewBaseProps, S as Stage } from '../../types-CbWXIKbe.cjs';
+import { a as ViewBaseProps, S as Stage } from '../../types-DsdZvEI1.cjs';
 import 'react';
-import 'luxon';
 
 type ListViewSlot = 'group' | 'groupHeader' | 'item' | 'selectedItem' | 'state';
 interface ListViewProps<T> extends ViewBaseProps<T>, VariantProps<typeof itemVariants> {
@@ -24,7 +23,7 @@ interface ListViewProps<T> extends ViewBaseProps<T>, VariantProps<typeof itemVar
     headingLevel?: 'h2' | 'h3' | 'h4';
 }
 declare const itemVariants: (props?: ({
-    density?: "compact" | "comfortable" | null | undefined;
+    density?: "comfortable" | "compact" | null | undefined;
     interactive?: boolean | null | undefined;
     selected?: boolean | null | undefined;
 } & class_variance_authority_types.ClassProp) | undefined) => string;

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

@@ -1,9 +1,8 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import * as class_variance_authority_types from 'class-variance-authority/types';
 import { VariantProps } from 'class-variance-authority';
-import { a as ViewBaseProps, S as Stage } from '../../types-CbWXIKbe.js';
+import { a as ViewBaseProps, S as Stage } from '../../types-DsdZvEI1.js';
 import 'react';
-import 'luxon';
 
 type ListViewSlot = 'group' | 'groupHeader' | 'item' | 'selectedItem' | 'state';
 interface ListViewProps<T> extends ViewBaseProps<T>, VariantProps<typeof itemVariants> {
@@ -24,7 +23,7 @@ interface ListViewProps<T> extends ViewBaseProps<T>, VariantProps<typeof itemVar
     headingLevel?: 'h2' | 'h3' | 'h4';
 }
 declare const itemVariants: (props?: ({
-    density?: "compact" | "comfortable" | null | undefined;
+    density?: "comfortable" | "compact" | null | undefined;
     interactive?: boolean | null | undefined;
     selected?: boolean | null | undefined;
 } & class_variance_authority_types.ClassProp) | undefined) => string;

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.
  *