@mieweb/ui 0.6.1-dev.169 → 0.6.1-dev.171

package/dist/hooks/index.cjs

@@ -1,7 +1,9 @@
 'use strict';
 
-var chunkDKGUOMBC_cjs = require('../chunk-DKGUOMBC.cjs');
+var chunkX7J45FU5_cjs = require('../chunk-X7J45FU5.cjs');
 var chunk2O7D6F67_cjs = require('../chunk-2O7D6F67.cjs');
+var chunkY4ESBDQ5_cjs = require('../chunk-Y4ESBDQ5.cjs');
+var chunkJYZW2PZS_cjs = require('../chunk-JYZW2PZS.cjs');
 var chunkIKMR2ADM_cjs = require('../chunk-IKMR2ADM.cjs');
 var chunkYVPC65ZJ_cjs = require('../chunk-YVPC65ZJ.cjs');
 var chunk6HFFWEM3_cjs = require('../chunk-6HFFWEM3.cjs');
@@ -13,48 +15,84 @@ require('../chunk-SCV7C55E.cjs');
 
 Object.defineProperty(exports, "useCommandK", {
   enumerable: true,
-  get: function () { return chunkDKGUOMBC_cjs.useCommandK; }
+  get: function () { return chunkX7J45FU5_cjs.useCommandK; }
 });
 Object.defineProperty(exports, "useIsDesktop", {
   enumerable: true,
-  get: function () { return chunkDKGUOMBC_cjs.useIsDesktop; }
+  get: function () { return chunkX7J45FU5_cjs.useIsDesktop; }
 });
 Object.defineProperty(exports, "useIsLargeDesktop", {
   enumerable: true,
-  get: function () { return chunkDKGUOMBC_cjs.useIsLargeDesktop; }
+  get: function () { return chunkX7J45FU5_cjs.useIsLargeDesktop; }
 });
 Object.defineProperty(exports, "useIsMobile", {
   enumerable: true,
-  get: function () { return chunkDKGUOMBC_cjs.useIsMobile; }
+  get: function () { return chunkX7J45FU5_cjs.useIsMobile; }
 });
 Object.defineProperty(exports, "useIsMobileOrTablet", {
   enumerable: true,
-  get: function () { return chunkDKGUOMBC_cjs.useIsMobileOrTablet; }
+  get: function () { return chunkX7J45FU5_cjs.useIsMobileOrTablet; }
 });
 Object.defineProperty(exports, "useIsSmallTablet", {
   enumerable: true,
-  get: function () { return chunkDKGUOMBC_cjs.useIsSmallTablet; }
+  get: function () { return chunkX7J45FU5_cjs.useIsSmallTablet; }
 });
 Object.defineProperty(exports, "useIsTablet", {
   enumerable: true,
-  get: function () { return chunkDKGUOMBC_cjs.useIsTablet; }
+  get: function () { return chunkX7J45FU5_cjs.useIsTablet; }
 });
 Object.defineProperty(exports, "useKeyboardShortcut", {
   enumerable: true,
-  get: function () { return chunkDKGUOMBC_cjs.useKeyboardShortcut; }
+  get: function () { return chunkX7J45FU5_cjs.useKeyboardShortcut; }
 });
 Object.defineProperty(exports, "useMediaQuery", {
   enumerable: true,
-  get: function () { return chunkDKGUOMBC_cjs.useMediaQuery; }
+  get: function () { return chunkX7J45FU5_cjs.useMediaQuery; }
 });
 Object.defineProperty(exports, "useScrollSpy", {
   enumerable: true,
-  get: function () { return chunkDKGUOMBC_cjs.useScrollSpy; }
+  get: function () { return chunkX7J45FU5_cjs.useScrollSpy; }
 });
 Object.defineProperty(exports, "useTheme", {
   enumerable: true,
   get: function () { return chunk2O7D6F67_cjs.useTheme; }
 });
+Object.defineProperty(exports, "DEFAULT_FILLER_WORDS", {
+  enumerable: true,
+  get: function () { return chunkY4ESBDQ5_cjs.DEFAULT_FILLER_WORDS; }
+});
+Object.defineProperty(exports, "DEFAULT_MIN_SILENCE_MS", {
+  enumerable: true,
+  get: function () { return chunkY4ESBDQ5_cjs.DEFAULT_MIN_SILENCE_MS; }
+});
+Object.defineProperty(exports, "DEFAULT_NL_SILENCE_MS", {
+  enumerable: true,
+  get: function () { return chunkY4ESBDQ5_cjs.DEFAULT_NL_SILENCE_MS; }
+});
+Object.defineProperty(exports, "buildPlaybackSegments", {
+  enumerable: true,
+  get: function () { return chunkY4ESBDQ5_cjs.buildPlaybackSegments; }
+});
+Object.defineProperty(exports, "getSpeedAtIndex", {
+  enumerable: true,
+  get: function () { return chunkY4ESBDQ5_cjs.getSpeedAtIndex; }
+});
+Object.defineProperty(exports, "initEditableWords", {
+  enumerable: true,
+  get: function () { return chunkY4ESBDQ5_cjs.initEditableWords; }
+});
+Object.defineProperty(exports, "insertSilences", {
+  enumerable: true,
+  get: function () { return chunkY4ESBDQ5_cjs.insertSilences; }
+});
+Object.defineProperty(exports, "useTranscriptEdits", {
+  enumerable: true,
+  get: function () { return chunkY4ESBDQ5_cjs.useTranscriptEdits; }
+});
+Object.defineProperty(exports, "useMediaTransport", {
+  enumerable: true,
+  get: function () { return chunkJYZW2PZS_cjs.useMediaTransport; }
+});
 Object.defineProperty(exports, "useClickOutside", {
   enumerable: true,
   get: function () { return chunkIKMR2ADM_cjs.useClickOutside; }

package/dist/hooks/index.d.cts

@@ -1,6 +1,8 @@
 export { R as ResolvedTheme, T as Theme, u as useTheme } from '../useTheme-B9SWu6ui.cjs';
 import * as React from 'react';
 import { RefObject } from 'react';
+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-BUylQFg0.cjs';
+import '../transcript-oaWqY3yr.cjs';
 
 interface UseScrollSpyOptions {
     /** CSS selector for the elements to observe (e.g. 'h2, h3, h4') */
@@ -273,4 +275,89 @@ declare function dragIndicatorClasses(drag: Pick<UseDragReorderReturn, 'dragging
  */
 declare function useLiveAnnouncement(): [string, (message: string) => void];
 
-export { type DragOverState, type KeyboardShortcutOptions, type UseDragReorderOptions, type UseDragReorderReturn, type UseScrollSpyOptions, type UseScrollSpyReturn, dragIndicatorClasses, reorderIds, useClickOutside, useCommandK, useDragReorder, useEscapeKey, useFocusTrap, useIsDesktop, useIsLargeDesktop, useIsMobile, useIsMobileOrTablet, useIsSmallTablet, useIsTablet, useKeyboardShortcut, useLiveAnnouncement, useMediaQuery, usePrefersReducedMotion, useScrollSpy };
+type MediaTransportState = 'idle' | 'loading' | 'playing' | 'paused' | 'error';
+interface UseMediaTransportOptions {
+    /** Fired on every native `timeupdate` and on metadata load, in milliseconds. */
+    onTimeUpdate?: (currentTimeMs: number, durationMs: number) => void;
+    /** Fired whenever the derived transport state changes. */
+    onStateChange?: (state: MediaTransportState) => void;
+    /** Fired when playback reaches the end. */
+    onEnded?: () => void;
+    /** Fired on a media error, with a descriptive Error. */
+    onError?: (error: Error) => void;
+    /** Initial playback rate (default `1`). Kept in sync with the element. */
+    initialRate?: number;
+    /** Transport state to enter when playback ends (default `'paused'`). */
+    endedState?: Extract<MediaTransportState, 'idle' | 'paused'>;
+    /** Reset the position to `0` when playback ends (default `false`). */
+    resetTimeOnEnd?: boolean;
+    /** Human-readable label used in the error message (default `'media'`). */
+    errorLabel?: string;
+}
+interface UseMediaTransportReturn {
+    /**
+     * Callback ref for the `<audio>`/`<video>` element to control. Pass this to
+     * the element's `ref` (or call it imperatively). Transport listeners attach
+     * when an element mounts and detach when it unmounts.
+     */
+    setMediaElement: (element: HTMLMediaElement | null) => void;
+    /** The currently attached media element, or `null`. */
+    mediaElement: HTMLMediaElement | null;
+    /** Derived transport state. */
+    state: MediaTransportState;
+    /** Current playback position in milliseconds. */
+    currentTimeMs: number;
+    /** Media duration in milliseconds (`0` until known / non-finite). */
+    durationMs: number;
+    /** Current playback rate. */
+    playbackRate: number;
+    /** `true` while `state === 'playing'`. */
+    isPlaying: boolean;
+    /** `true` while `state === 'loading'`. */
+    isLoading: boolean;
+    /** Start playback. */
+    play: () => void;
+    /** Pause playback. */
+    pause: () => void;
+    /** Toggle between play and pause. */
+    togglePlay: () => void;
+    /** Seek to a position in milliseconds. */
+    seekToMs: (timeMs: number) => void;
+    /** Set the playback rate multiplier. */
+    setPlaybackRate: (rate: number) => void;
+    /** Read the current position in milliseconds. */
+    getCurrentTimeMs: () => number;
+    /** Read the duration in milliseconds (`0` when unknown). */
+    getDurationMs: () => number;
+    /** Whether playback is currently paused (reads the element directly). */
+    isPaused: () => boolean;
+}
+/**
+ * Headless playback transport for a native `HTMLMediaElement`.
+ *
+ * Owns the derived transport state (idle/loading/playing/paused/error),
+ * position, duration and playback rate, and exposes imperative controls — all
+ * in **milliseconds**. It never creates or renders an element: pass the
+ * returned {@link UseMediaTransportReturn.setMediaElement} callback to an
+ * `<audio>`/`<video>` `ref` and the hook wires the native listeners.
+ *
+ * Shared by `MediaPlayer` (ms API) and, at the boundary, `AudioPlayer`
+ * (seconds API — convert with `ms / 1000`). The WaveSurfer waveform variant is
+ * out of scope; this hook targets native media transport only.
+ *
+ * @example
+ * ```tsx
+ * function Player({ src }: { src: string }) {
+ *   const t = useMediaTransport({ onEnded: () => console.log('done') });
+ *   return (
+ *     <div>
+ *       <video ref={t.setMediaElement} src={src} controls />
+ *       <button onClick={t.togglePlay}>{t.isPlaying ? 'Pause' : 'Play'}</button>
+ *     </div>
+ *   );
+ * }
+ * ```
+ */
+declare function useMediaTransport(options?: UseMediaTransportOptions): UseMediaTransportReturn;
+
+export { type DragOverState, type KeyboardShortcutOptions, type MediaTransportState, type UseDragReorderOptions, type UseDragReorderReturn, type UseMediaTransportOptions, type UseMediaTransportReturn, type UseScrollSpyOptions, type UseScrollSpyReturn, dragIndicatorClasses, reorderIds, useClickOutside, useCommandK, useDragReorder, useEscapeKey, useFocusTrap, useIsDesktop, useIsLargeDesktop, useIsMobile, useIsMobileOrTablet, useIsSmallTablet, useIsTablet, useKeyboardShortcut, useLiveAnnouncement, useMediaQuery, useMediaTransport, usePrefersReducedMotion, useScrollSpy };

package/dist/hooks/index.d.ts

@@ -1,6 +1,8 @@
 export { R as ResolvedTheme, T as Theme, u as useTheme } from '../useTheme-B9SWu6ui.js';
 import * as React from 'react';
 import { RefObject } from 'react';
+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-CWYnjbGP.js';
+import '../transcript-oaWqY3yr.js';
 
 interface UseScrollSpyOptions {
     /** CSS selector for the elements to observe (e.g. 'h2, h3, h4') */
@@ -273,4 +275,89 @@ declare function dragIndicatorClasses(drag: Pick<UseDragReorderReturn, 'dragging
  */
 declare function useLiveAnnouncement(): [string, (message: string) => void];
 
-export { type DragOverState, type KeyboardShortcutOptions, type UseDragReorderOptions, type UseDragReorderReturn, type UseScrollSpyOptions, type UseScrollSpyReturn, dragIndicatorClasses, reorderIds, useClickOutside, useCommandK, useDragReorder, useEscapeKey, useFocusTrap, useIsDesktop, useIsLargeDesktop, useIsMobile, useIsMobileOrTablet, useIsSmallTablet, useIsTablet, useKeyboardShortcut, useLiveAnnouncement, useMediaQuery, usePrefersReducedMotion, useScrollSpy };
+type MediaTransportState = 'idle' | 'loading' | 'playing' | 'paused' | 'error';
+interface UseMediaTransportOptions {
+    /** Fired on every native `timeupdate` and on metadata load, in milliseconds. */
+    onTimeUpdate?: (currentTimeMs: number, durationMs: number) => void;
+    /** Fired whenever the derived transport state changes. */
+    onStateChange?: (state: MediaTransportState) => void;
+    /** Fired when playback reaches the end. */
+    onEnded?: () => void;
+    /** Fired on a media error, with a descriptive Error. */
+    onError?: (error: Error) => void;
+    /** Initial playback rate (default `1`). Kept in sync with the element. */
+    initialRate?: number;
+    /** Transport state to enter when playback ends (default `'paused'`). */
+    endedState?: Extract<MediaTransportState, 'idle' | 'paused'>;
+    /** Reset the position to `0` when playback ends (default `false`). */
+    resetTimeOnEnd?: boolean;
+    /** Human-readable label used in the error message (default `'media'`). */
+    errorLabel?: string;
+}
+interface UseMediaTransportReturn {
+    /**
+     * Callback ref for the `<audio>`/`<video>` element to control. Pass this to
+     * the element's `ref` (or call it imperatively). Transport listeners attach
+     * when an element mounts and detach when it unmounts.
+     */
+    setMediaElement: (element: HTMLMediaElement | null) => void;
+    /** The currently attached media element, or `null`. */
+    mediaElement: HTMLMediaElement | null;
+    /** Derived transport state. */
+    state: MediaTransportState;
+    /** Current playback position in milliseconds. */
+    currentTimeMs: number;
+    /** Media duration in milliseconds (`0` until known / non-finite). */
+    durationMs: number;
+    /** Current playback rate. */
+    playbackRate: number;
+    /** `true` while `state === 'playing'`. */
+    isPlaying: boolean;
+    /** `true` while `state === 'loading'`. */
+    isLoading: boolean;
+    /** Start playback. */
+    play: () => void;
+    /** Pause playback. */
+    pause: () => void;
+    /** Toggle between play and pause. */
+    togglePlay: () => void;
+    /** Seek to a position in milliseconds. */
+    seekToMs: (timeMs: number) => void;
+    /** Set the playback rate multiplier. */
+    setPlaybackRate: (rate: number) => void;
+    /** Read the current position in milliseconds. */
+    getCurrentTimeMs: () => number;
+    /** Read the duration in milliseconds (`0` when unknown). */
+    getDurationMs: () => number;
+    /** Whether playback is currently paused (reads the element directly). */
+    isPaused: () => boolean;
+}
+/**
+ * Headless playback transport for a native `HTMLMediaElement`.
+ *
+ * Owns the derived transport state (idle/loading/playing/paused/error),
+ * position, duration and playback rate, and exposes imperative controls — all
+ * in **milliseconds**. It never creates or renders an element: pass the
+ * returned {@link UseMediaTransportReturn.setMediaElement} callback to an
+ * `<audio>`/`<video>` `ref` and the hook wires the native listeners.
+ *
+ * Shared by `MediaPlayer` (ms API) and, at the boundary, `AudioPlayer`
+ * (seconds API — convert with `ms / 1000`). The WaveSurfer waveform variant is
+ * out of scope; this hook targets native media transport only.
+ *
+ * @example
+ * ```tsx
+ * function Player({ src }: { src: string }) {
+ *   const t = useMediaTransport({ onEnded: () => console.log('done') });
+ *   return (
+ *     <div>
+ *       <video ref={t.setMediaElement} src={src} controls />
+ *       <button onClick={t.togglePlay}>{t.isPlaying ? 'Pause' : 'Play'}</button>
+ *     </div>
+ *   );
+ * }
+ * ```
+ */
+declare function useMediaTransport(options?: UseMediaTransportOptions): UseMediaTransportReturn;
+
+export { type DragOverState, type KeyboardShortcutOptions, type MediaTransportState, type UseDragReorderOptions, type UseDragReorderReturn, type UseMediaTransportOptions, type UseMediaTransportReturn, type UseScrollSpyOptions, type UseScrollSpyReturn, dragIndicatorClasses, reorderIds, useClickOutside, useCommandK, useDragReorder, useEscapeKey, useFocusTrap, useIsDesktop, useIsLargeDesktop, useIsMobile, useIsMobileOrTablet, useIsSmallTablet, useIsTablet, useKeyboardShortcut, useLiveAnnouncement, useMediaQuery, useMediaTransport, usePrefersReducedMotion, useScrollSpy };

package/dist/hooks/index.js

@@ -1,5 +1,7 @@
-export { useCommandK, useIsDesktop, useIsLargeDesktop, useIsMobile, useIsMobileOrTablet, useIsSmallTablet, useIsTablet, useKeyboardShortcut, useMediaQuery, useScrollSpy } from '../chunk-UVQEHZRF.js';
+export { useCommandK, useIsDesktop, useIsLargeDesktop, useIsMobile, useIsMobileOrTablet, useIsSmallTablet, useIsTablet, useKeyboardShortcut, useMediaQuery, useScrollSpy } from '../chunk-6VGXX6L6.js';
 export { useTheme } from '../chunk-KJZNEVYM.js';
+export { DEFAULT_FILLER_WORDS, DEFAULT_MIN_SILENCE_MS, DEFAULT_NL_SILENCE_MS, buildPlaybackSegments, getSpeedAtIndex, initEditableWords, insertSilences, useTranscriptEdits } from '../chunk-NTYGCBCL.js';
+export { useMediaTransport } from '../chunk-SQHMGT4W.js';
 export { useClickOutside } from '../chunk-OKBR6PX4.js';
 export { dragIndicatorClasses, reorderIds, useDragReorder, useLiveAnnouncement } from '../chunk-7ZVTLTJF.js';
 export { usePrefersReducedMotion } from '../chunk-HB7C7NB5.js';