@epicbagel/saas-kit 1.11.0 → 1.12.0

package/dist/{chunk-UOVA4YKW.js → chunk-KF4X37DP.js}

@@ -33,8 +33,7 @@ var DEFAULT_LABELS = {
   retry: "Retry voice chat",
   endShort: "End voice",
   muteShort: "Mute",
-  unmuteShort: "Unmute",
-  transcriptPlaceholder: "Speak to continue the conversation."
+  unmuteShort: "Unmute"
 };
 function VoiceSessionControls({
   state,
@@ -44,7 +43,6 @@ function VoiceSessionControls({
   onMutedChange,
   disabled = false,
   error,
-  transcript,
   volumeBands,
   audioLevels,
   labels,
@@ -79,18 +77,7 @@ function VoiceSessionControls({
                 volumeBands: muted && state === "listening" ? SILENCE : volumeBands ?? liveBands
               }
             ),
-            /* @__PURE__ */ jsxs("div", { className: "min-w-0 flex-1 space-y-1", children: [
-              /* @__PURE__ */ jsx("span", { role: "status", className: "block text-sm font-medium text-primary", children: muted && state === "listening" ? copy.muted : copy[state] }),
-              /* @__PURE__ */ jsx(
-                "p",
-                {
-                  "data-slot": "voice-session-transcript",
-                  title: transcript || void 0,
-                  className: cn("truncate text-sm font-normal", transcript ? "text-foreground" : "text-muted-foreground"),
-                  children: transcript || copy.transcriptPlaceholder
-                }
-              )
-            ] })
+            /* @__PURE__ */ jsx("span", { role: "status", className: "min-w-0 flex-1 text-sm font-medium text-primary", children: muted && state === "listening" ? copy.muted : copy[state] })
           ] }),
           /* @__PURE__ */ jsxs("div", { className: "ml-auto flex shrink-0 items-center gap-2", children: [
             /* @__PURE__ */ jsxs(

package/dist/chunk-QWUMIAYD.cjs

@@ -0,0 +1,294 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _interopRequireWildcard(obj) { if (obj && obj.__esModule) { return obj; } else { var newObj = {}; if (obj != null) { for (var key in obj) { if (Object.prototype.hasOwnProperty.call(obj, key)) { newObj[key] = obj[key]; } } } newObj.default = obj; return newObj; } } function _optionalChain(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; }"use client";
+
+
+var _chunkNKWHDI4Ccjs = require('./chunk-NKWHDI4C.cjs');
+
+
+var _chunkJDEXZGIYcjs = require('./chunk-JDEXZGIY.cjs');
+
+
+var _chunkKWLSBTB2cjs = require('./chunk-KWLSBTB2.cjs');
+
+
+var _chunk7Q4EFCUIcjs = require('./chunk-7Q4EFCUI.cjs');
+
+// src/primitives/voice-dictation-button.tsx
+
+
+
+
+
+
+
+var _react = require('react');
+var _reactdialog = require('@radix-ui/react-dialog'); var DialogPrimitive = _interopRequireWildcard(_reactdialog);
+var _reactpopover = require('@radix-ui/react-popover'); var PopoverPrimitive = _interopRequireWildcard(_reactpopover);
+var _lucidereact = require('lucide-react');
+var _jsxruntime = require('react/jsx-runtime');
+function VoiceDictationButton({
+  onCommit,
+  onCancel,
+  title = "Dictate your message",
+  caption = "Recording",
+  lang = "en-US",
+  continuous = true,
+  className,
+  size = "sm",
+  showLabel = false,
+  children,
+  disabled = false,
+  visibility = "visible",
+  shrink = true,
+  anchorRef
+}) {
+  const [open, setOpen] = _react.useState.call(void 0, false);
+  const [anchor, setAnchor] = _react.useState.call(void 0, null);
+  const desktop = _react.useSyncExternalStore.call(void 0, subscribeDesktop, isDesktop, () => false);
+  const anchored = desktop && isVisibleAnchor(anchor);
+  const placement = _react.useRef.call(void 0, anchored);
+  placement.current = anchored;
+  const isOpen = _react.useRef.call(void 0, open);
+  isOpen.current = open;
+  const descriptionId = _react.useId.call(void 0, );
+  const capture = _chunk7Q4EFCUIcjs.useDictation.call(void 0, { lang, continuous });
+  const { transcript, interimTranscript: interim, supported, error } = capture;
+  const generation = _react.useRef.call(void 0, 0);
+  const finishing = _react.useRef.call(void 0, false);
+  const previousFocus = _react.useRef.call(void 0, null);
+  const cancelControl = _react.useRef.call(void 0, null);
+  const elapsed = useRecordingTime(capture.state);
+  const busy = capture.state === "requesting" || capture.state === "transcribing";
+  const openOverlay = _react.useCallback.call(void 0, (event) => {
+    const focused = document.activeElement instanceof HTMLElement ? document.activeElement : null;
+    const explicit = _optionalChain([anchorRef, 'optionalAccess', _ => _.current]);
+    const invokingButton = _optionalChain([focused, 'optionalAccess', _2 => _2.matches, 'call', _3 => _3("button:not(:disabled), [role='button']:not([aria-disabled='true'])")]) ? focused : null;
+    const resolved = isVisibleAnchor(explicit) ? explicit : isVisibleAnchor(event.currentTarget) ? event.currentTarget : isVisibleAnchor(invokingButton) ? invokingButton : null;
+    previousFocus.current = _optionalChain([resolved, 'optionalAccess', _4 => _4.matches, 'call', _5 => _5("button, a[href], input, select, textarea, [tabindex]")]) ? resolved : focused;
+    setAnchor(resolved);
+    generation.current++;
+    finishing.current = false;
+    setOpen(true);
+    void capture.start();
+  }, [anchorRef, capture.start]);
+  const closeOverlay = _react.useCallback.call(void 0, () => {
+    generation.current++;
+    finishing.current = false;
+    capture.cancel();
+    setOpen(false);
+  }, [capture.cancel]);
+  const handleDone = _react.useCallback.call(void 0, async () => {
+    if (finishing.current || busy) return;
+    _optionalChain([cancelControl, 'access', _6 => _6.current, 'optionalAccess', _7 => _7.focus, 'call', _8 => _8({ preventScroll: true })]);
+    if (capture.state === "error" && !capture.canRetry) {
+      void capture.start();
+      return;
+    }
+    finishing.current = true;
+    const started = generation.current;
+    const final = await (capture.canRetry ? capture.retry() : capture.stop());
+    if (started !== generation.current) return;
+    finishing.current = false;
+    if (final === null) return;
+    closeOverlay();
+    if (final) onCommit(final);
+    else _optionalChain([onCancel, 'optionalCall', _9 => _9()]);
+  }, [busy, capture.canRetry, capture.retry, capture.start, capture.state, capture.stop, onCommit, onCancel, closeOverlay]);
+  const handleCancel = _react.useCallback.call(void 0, () => {
+    closeOverlay();
+    _optionalChain([onCancel, 'optionalCall', _10 => _10()]);
+  }, [closeOverlay, onCancel]);
+  _react.useEffect.call(void 0, () => {
+    if (open && capture.state === "idle") handleCancel();
+  }, [capture.state, handleCancel, open]);
+  _react.useEffect.call(void 0, () => {
+    return () => {
+      generation.current++;
+    };
+  }, []);
+  if (!supported) return null;
+  const displayTranscript = `${transcript}${interim ? (transcript ? " " : "") + interim : ""}`;
+  const closeAutoFocus = (event) => {
+    event.preventDefault();
+    if (!isOpen.current && _optionalChain([previousFocus, 'access', _11 => _11.current, 'optionalAccess', _12 => _12.isConnected])) previousFocus.current.focus();
+  };
+  const onKeyDown = (event) => {
+    if (event.key === "Enter" && !event.shiftKey && !(event.target instanceof HTMLElement && event.target.closest("button, input, textarea, select"))) {
+      event.preventDefault();
+      void handleDone();
+    }
+  };
+  const content = /* @__PURE__ */ _jsxruntime.jsxs.call(void 0, _jsxruntime.Fragment, { children: [
+    /* @__PURE__ */ _jsxruntime.jsxs.call(void 0, "div", { className: _chunkKWLSBTB2cjs.cn.call(void 0, "flex min-w-0 items-start justify-between gap-3", !anchored && "w-full max-w-xl self-center"), children: [
+      /* @__PURE__ */ _jsxruntime.jsxs.call(void 0, "div", { className: "min-w-0 space-y-1", children: [
+        /* @__PURE__ */ _jsxruntime.jsx.call(void 0, "h2", { className: _chunkKWLSBTB2cjs.cn.call(void 0, "font-medium", anchored ? "text-sm" : "text-lg"), children: title || "Voice dictation" }),
+        /* @__PURE__ */ _jsxruntime.jsxs.call(void 0, "span", { role: "status", className: "flex items-center gap-1.5 text-xs text-muted-foreground", children: [
+          busy ? /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _lucidereact.LoaderCircle, { "aria-hidden": "true", className: "size-3.5 animate-spin motion-reduce:animate-none" }) : /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _lucidereact.Mic, { "aria-hidden": "true", className: "size-3.5" }),
+          capture.state === "transcribing" ? "Finishing transcript\u2026" : capture.state === "requesting" ? "Starting dictation\u2026" : error ? "Recording not saved" : capture.state === "ready" ? "Ready" : caption
+        ] })
+      ] }),
+      /* @__PURE__ */ _jsxruntime.jsxs.call(void 0, "time", { "aria-label": "Recording duration", dateTime: `PT${elapsed}S`, className: "pt-0.5 font-mono text-xs tabular-nums text-muted-foreground", children: [
+        Math.floor(elapsed / 60).toString().padStart(2, "0"),
+        ":",
+        (elapsed % 60).toString().padStart(2, "0")
+      ] })
+    ] }),
+    /* @__PURE__ */ _jsxruntime.jsxs.call(void 0, "div", { className: _chunkKWLSBTB2cjs.cn.call(void 0, "flex min-h-0 flex-col gap-3", !anchored && "w-full max-w-xl flex-1 justify-center self-center py-8 text-center"), children: [
+      capture.audioLevels && /* @__PURE__ */ _jsxruntime.jsx.call(void 0, DictationWaveform, { source: capture.audioLevels, state: capture.state, className: !anchored ? "h-20" : void 0 }),
+      /* @__PURE__ */ _jsxruntime.jsx.call(void 0, "p", { id: descriptionId, className: "text-xs text-muted-foreground", children: capture.state === "transcribing" ? "Finishing your last words\u2026" : capture.state === "requesting" ? "Allow microphone access to start." : error ? capture.canRetry ? "Retry this take or record again." : "Try recording again." : "Speak, then choose Done to add the text." }),
+      displayTranscript && /* @__PURE__ */ _jsxruntime.jsxs.call(void 0, "p", { className: "max-h-40 overflow-y-auto text-sm leading-relaxed", children: [
+        transcript,
+        interim && /* @__PURE__ */ _jsxruntime.jsxs.call(void 0, "span", { className: "text-muted-foreground", children: [
+          transcript ? " " : "",
+          interim
+        ] })
+      ] }),
+      error && /* @__PURE__ */ _jsxruntime.jsx.call(void 0, "p", { role: "alert", className: "text-xs text-destructive", children: error }),
+      !error && capture.previewError && /* @__PURE__ */ _jsxruntime.jsx.call(void 0, "p", { role: "status", className: "text-xs text-muted-foreground", children: capture.previewError })
+    ] }),
+    /* @__PURE__ */ _jsxruntime.jsxs.call(void 0, "div", { className: _chunkKWLSBTB2cjs.cn.call(void 0, "gap-2", anchored ? "flex flex-wrap items-center justify-end" : "mt-auto grid w-full max-w-xl grid-cols-2 gap-3 self-center"), children: [
+      /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _chunkJDEXZGIYcjs.Button, { ref: cancelControl, type: "button", variant: "ghost", size: "sm", className: anchored ? "min-h-[44px]" : "min-h-[48px]", onClick: handleCancel, children: "Cancel" }),
+      capture.canRetry && /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _chunkJDEXZGIYcjs.Button, { type: "button", variant: "outline", size: "sm", className: anchored ? "min-h-[44px]" : "order-first col-span-2 min-h-[48px]", onClick: () => {
+        _optionalChain([cancelControl, 'access', _13 => _13.current, 'optionalAccess', _14 => _14.focus, 'call', _15 => _15({ preventScroll: true })]);
+        void capture.start();
+      }, children: "Record again" }),
+      /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _chunkJDEXZGIYcjs.Button, { type: "button", size: "sm", className: anchored ? "min-h-[44px]" : "min-h-[48px]", onClick: () => void handleDone(), disabled: busy, children: capture.state === "transcribing" ? "Transcribing\u2026" : capture.canRetry ? "Retry transcription" : error ? "Try again" : "Done" })
+    ] })
+  ] });
+  return /* @__PURE__ */ _jsxruntime.jsxs.call(void 0, _jsxruntime.Fragment, { children: [
+    children ? /* @__PURE__ */ _jsxruntime.jsx.call(void 0, 
+      "button",
+      {
+        type: "button",
+        onClick: openOverlay,
+        disabled,
+        "aria-label": "Start dictation",
+        className: _chunkKWLSBTB2cjs.cn.call(void 0, visibility === "hidden" && "hidden", className),
+        children
+      }
+    ) : /* @__PURE__ */ _jsxruntime.jsx.call(void 0, 
+      _chunkJDEXZGIYcjs.Button,
+      {
+        type: "button",
+        onClick: openOverlay,
+        disabled,
+        variant: "outline",
+        size,
+        "aria-label": "Start dictation",
+        className: _chunkKWLSBTB2cjs.cn.call(void 0, "transition-colors", visibility === "hidden" && "hidden", !shrink && "shrink-0", className),
+        children: /* @__PURE__ */ _jsxruntime.jsxs.call(void 0, "span", { className: "flex items-center justify-center gap-2", children: [
+          /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _lucidereact.Mic, { className: "h-4 w-4" }),
+          showLabel && /* @__PURE__ */ _jsxruntime.jsx.call(void 0, "span", { children: "Speak" })
+        ] })
+      }
+    ),
+    /* @__PURE__ */ _jsxruntime.jsxs.call(void 0, PopoverPrimitive.Root, { modal: true, open: open && anchored, onOpenChange: (next) => {
+      if (!next && placement.current) handleCancel();
+    }, children: [
+      anchored && /* @__PURE__ */ _jsxruntime.jsx.call(void 0, PopoverPrimitive.Anchor, { virtualRef: { current: anchor } }),
+      /* @__PURE__ */ _jsxruntime.jsx.call(void 0, PopoverPrimitive.Portal, { children: /* @__PURE__ */ _jsxruntime.jsx.call(void 0, 
+        PopoverPrimitive.Content,
+        {
+          "aria-label": "Voice dictation",
+          "aria-describedby": descriptionId,
+          "data-slot": "voice-dictation-panel",
+          "data-state": capture.state,
+          "data-placement": "anchored",
+          side: "top",
+          align: "center",
+          sideOffset: 8,
+          collisionPadding: 12,
+          avoidCollisions: true,
+          onCloseAutoFocus: closeAutoFocus,
+          onKeyDown,
+          onEscapeKeyDown: (event) => event.stopPropagation(),
+          className: "z-[200] flex max-h-[var(--radix-popover-content-available-height)] w-96 max-w-[calc(100vw-1.5rem)] flex-col gap-3 overflow-y-auto rounded-2xl border border-border bg-background p-4 text-foreground shadow-lg outline-hidden",
+          children: content
+        }
+      ) })
+    ] }),
+    /* @__PURE__ */ _jsxruntime.jsx.call(void 0, DialogPrimitive.Root, { open: open && !anchored, onOpenChange: (next) => {
+      if (!next && !placement.current) handleCancel();
+    }, children: /* @__PURE__ */ _jsxruntime.jsxs.call(void 0, DialogPrimitive.Portal, { children: [
+      /* @__PURE__ */ _jsxruntime.jsx.call(void 0, DialogPrimitive.Overlay, { className: "fixed inset-0 z-[199] bg-background" }),
+      /* @__PURE__ */ _jsxruntime.jsxs.call(void 0, 
+        DialogPrimitive.Content,
+        {
+          "aria-label": "Voice dictation",
+          "aria-labelledby": void 0,
+          "data-slot": "voice-dictation-panel",
+          "data-state": capture.state,
+          "data-placement": "fullscreen",
+          onCloseAutoFocus: closeAutoFocus,
+          onKeyDown,
+          onEscapeKeyDown: (event) => event.stopPropagation(),
+          className: "fixed inset-0 z-[200] flex h-dvh w-screen flex-col gap-6 overflow-y-auto overscroll-contain bg-background px-6 pt-[max(1.5rem,env(safe-area-inset-top))] pb-[max(1.5rem,env(safe-area-inset-bottom))] text-foreground outline-hidden",
+          children: [
+            /* @__PURE__ */ _jsxruntime.jsx.call(void 0, DialogPrimitive.Title, { className: "sr-only", children: "Voice dictation" }),
+            /* @__PURE__ */ _jsxruntime.jsx.call(void 0, DialogPrimitive.Description, { className: "sr-only", children: "Record your message, then choose Done to add the text. Cancel discards the recording." }),
+            content
+          ]
+        }
+      )
+    ] }) })
+  ] });
+}
+var SILENCE = [];
+var silence = () => SILENCE;
+function DictationWaveform({ source, state, className }) {
+  const bands = _react.useSyncExternalStore.call(void 0, source.subscribe, source.getSnapshot, silence);
+  return /* @__PURE__ */ _jsxruntime.jsx.call(void 0, 
+    _chunkNKWHDI4Ccjs.AgentAudioVisualizerBar,
+    {
+      "aria-hidden": "true",
+      "data-slot": "dictation-waveform",
+      size: "icon",
+      barCount: 24,
+      state: state === "recording" ? "listening" : state === "transcribing" ? "thinking" : state === "requesting" ? "connecting" : "disconnected",
+      volumeBands: state === "recording" ? bands : void 0,
+      className: _chunkKWLSBTB2cjs.cn.call(void 0, "h-9 w-full text-foreground", className)
+    }
+  );
+}
+function useRecordingTime(state) {
+  const [elapsed, setElapsed] = _react.useState.call(void 0, 0);
+  const startedAt = _react.useRef.call(void 0, null);
+  _react.useEffect.call(void 0, () => {
+    if (state !== "recording") {
+      if (state === "idle" || state === "requesting") setElapsed(0);
+      else if (startedAt.current !== null) setElapsed(Math.floor((performance.now() - startedAt.current) / 1e3));
+      startedAt.current = null;
+      return;
+    }
+    startedAt.current = performance.now();
+    const update = () => setElapsed(Math.floor((performance.now() - startedAt.current) / 1e3));
+    update();
+    const timer = setInterval(update, 1e3);
+    return () => {
+      clearInterval(timer);
+    };
+  }, [state]);
+  return elapsed;
+}
+var DESKTOP_QUERY = "(min-width: 768px)";
+function isDesktop() {
+  return typeof window !== "undefined" && !!_optionalChain([window, 'access', _16 => _16.matchMedia, 'optionalCall', _17 => _17(DESKTOP_QUERY), 'access', _18 => _18.matches]);
+}
+function subscribeDesktop(changed) {
+  const media = _optionalChain([window, 'access', _19 => _19.matchMedia, 'optionalCall', _20 => _20(DESKTOP_QUERY)]);
+  _optionalChain([media, 'optionalAccess', _21 => _21.addEventListener, 'call', _22 => _22("change", changed)]);
+  return () => _optionalChain([media, 'optionalAccess', _23 => _23.removeEventListener, 'call', _24 => _24("change", changed)]);
+}
+function isVisibleAnchor(element) {
+  if (!_optionalChain([element, 'optionalAccess', _25 => _25.isConnected]) || !element.getClientRects().length) return false;
+  const rect = element.getBoundingClientRect();
+  if (!rect.width || !rect.height) return false;
+  for (let parent = element; parent; parent = parent.parentElement) {
+    const style = getComputedStyle(parent);
+    if (parent.hidden || style.display === "none" || style.visibility === "hidden" || style.visibility === "collapse" || Number.parseFloat(style.opacity) === 0) return false;
+  }
+  return true;
+}
+
+
+
+exports.VoiceDictationButton = VoiceDictationButton;

package/dist/{chunk-HLAHOVEI.js → chunk-RPSRCB5O.js}

@@ -3,11 +3,11 @@
 // src/hooks/use-dictation.ts
 import { createContext, createElement, useCallback, useContext, useEffect, useMemo, useRef, useState } from "react";
 var DictationContext = createContext(null);
-function DictationProvider({ transcribe, scopeKey, children }) {
+function DictationProvider({ transcribe, stream, scopeKey, children }) {
   const scope = useRef({ key: scopeKey, generation: 0 });
   if (scope.current.key !== scopeKey) scope.current = { key: scopeKey, generation: scope.current.generation + 1 };
   const generation = scope.current.generation;
-  const value = useMemo(() => ({ transcribe, scope, generation }), [transcribe, generation]);
+  const value = useMemo(() => ({ transcribe, stream, scope, generation }), [transcribe, stream, generation]);
   return createElement(DictationContext.Provider, { value }, children);
 }
 var EMPTY = { state: "idle", transcript: "", interimTranscript: "", error: null, canRetry: false };
@@ -128,6 +128,8 @@ function releaseTracks(session) {
 }
 function dispose(session) {
   session.controller.abort();
+  session.streamController?.abort();
+  session.live?.cancel();
   if (session.nativeTimer) clearTimeout(session.nativeTimer);
   const recorder = session.recorder;
   if (recorder) {
@@ -158,6 +160,7 @@ function dispose(session) {
 function useDictation({ lang = "en-US", continuous = true, onTranscript } = {}) {
   const provider = useContext(DictationContext);
   const transcribe = provider?.transcribe ?? null;
+  const startStream = provider?.stream ?? null;
   const scope = provider?.scope ?? null;
   const scopeGeneration = provider?.generation ?? 0;
   const [snapshot, setSnapshot] = useState(EMPTY);
@@ -169,8 +172,8 @@ function useDictation({ lang = "en-US", continuous = true, onTranscript } = {})
   activeScope.current = scope;
   callback.current = onTranscript;
   useEffect(() => {
-    setSupported(transcribe ? typeof navigator !== "undefined" && !!navigator.mediaDevices?.getUserMedia && typeof MediaRecorder !== "undefined" : typeof recognitionConstructor() === "function");
-  }, [transcribe]);
+    setSupported(transcribe || startStream ? typeof navigator !== "undefined" && !!navigator.mediaDevices?.getUserMedia && typeof MediaRecorder !== "undefined" : typeof recognitionConstructor() === "function");
+  }, [transcribe, startStream]);
   const cancel = useCallback(() => {
     const session = current.current;
     current.current = null;
@@ -200,9 +203,12 @@ function useDictation({ lang = "en-US", continuous = true, onTranscript } = {})
     const session = {
       language: lang,
       transcribe,
+      startStream,
+      liveFailed: false,
       scope,
       scopeGeneration,
       controller: new AbortController(),
+      streamController: startStream ? new AbortController() : void 0,
       phase: "requesting",
       chunks: [],
       capture: new Promise((resolve) => {
@@ -217,11 +223,11 @@ function useDictation({ lang = "en-US", continuous = true, onTranscript } = {})
       transcript: "",
       interim: "",
       notified: /* @__PURE__ */ new Set(),
-      audioLevels: transcribe ? createAudioLevels() : void 0
+      audioLevels: transcribe || startStream ? createAudioLevels() : void 0
     };
     current.current = session;
     setSnapshot({ ...EMPTY, state: "requesting" });
-    if (transcribe) {
+    if (transcribe || startStream) {
       try {
         if (!navigator.mediaDevices?.getUserMedia || typeof MediaRecorder === "undefined") throw new Error("unsupported");
         const stream = await navigator.mediaDevices.getUserMedia({ audio: true });
@@ -250,16 +256,53 @@ function useDictation({ lang = "en-US", continuous = true, onTranscript } = {})
         };
         recorder.onerror = () => {
           if (!isCurrent(session)) return;
+          session.liveFailed = true;
+          session.live?.cancel();
           releaseTracks(session);
           session.phase = "error";
           session.resolveCapture(null);
           setSnapshot({ ...EMPTY, state: "error", error: "Recording was interrupted. Try again." });
         };
         recorder.start();
+        if (startStream) {
+          const failed = (error) => {
+            if (!isCurrent(session) || session.phase === "ready" || session.phase === "error") return;
+            session.liveFailed = true;
+            session.live?.cancel();
+            if (transcribe) {
+              setSnapshot((previous) => ({ ...previous, previewError: "Live text is unavailable. Choose Done to transcribe this recording." }));
+            } else {
+              releaseTracks(session);
+              if (recorder.state !== "inactive") recorder.stop();
+              session.phase = "error";
+              setSnapshot((previous) => ({ ...previous, state: "error", error: error.message || "Live transcription stopped. Try again." }));
+            }
+          };
+          try {
+            const live = await startStream(stream, {
+              language: lang,
+              signal: session.streamController.signal,
+              onTranscript: (preview) => {
+                if (!isCurrent(session) || session.liveFailed || session.phase === "error" || session.phase === "ready") return;
+                session.transcript = preview.transcript;
+                session.interim = preview.interimTranscript;
+                setSnapshot((previous) => ({ ...previous, transcript: preview.transcript, interimTranscript: preview.interimTranscript }));
+              },
+              onError: failed
+            });
+            if (!isCurrent(session) || session.liveFailed || session.phase === "error") {
+              live.cancel();
+            } else session.live = live;
+          } catch (error) {
+            failed(error instanceof Error ? error : new Error("Live transcription could not start. Try again."));
+          }
+          if (!isCurrent(session) || session.phase !== "requesting") return;
+        }
         session.phase = "recording";
         session.stopMeter = meterStream(stream, session.audioLevels, () => isCurrent(session) && session.phase === "recording");
-        setSnapshot({ ...EMPTY, state: "recording" });
+        setSnapshot((previous) => ({ ...previous, state: "recording" }));
       } catch (error) {
+        session.live?.cancel();
         releaseTracks(session);
         if (!isCurrent(session)) return;
         session.phase = "error";
@@ -320,13 +363,13 @@ function useDictation({ lang = "en-US", continuous = true, onTranscript } = {})
       session.phase = "error";
       setSnapshot({ ...EMPTY, state: "error", error: microphoneError(error) });
     }
-  }, [cancel, continuous, isCurrent, lang, scope, scopeGeneration, transcribe]);
+  }, [cancel, continuous, isCurrent, lang, scope, scopeGeneration, transcribe, startStream]);
   const finish = useCallback(async (session) => {
     if (!isCurrent(session)) return null;
     releaseMeter(session);
     session.phase = "transcribing";
     setSnapshot((previous) => ({ ...previous, state: "transcribing", error: null, canRetry: false }));
-    if (!session.transcribe) {
+    if (!session.transcribe && !session.startStream) {
       if (!session.nativeEnded) {
         session.nativeTimer = setTimeout(() => {
           try {
@@ -357,8 +400,24 @@ function useDictation({ lang = "en-US", continuous = true, onTranscript } = {})
         if (!isCurrent(session) || !blob) return null;
         session.blob = blob;
       }
-      if (!session.blob.size) throw new Error("No audio was recorded. Try again.");
-      text = (await session.transcribe(session.blob, { language: session.language, signal: session.controller.signal })).trim();
+      if (session.live && !session.liveFailed) {
+        try {
+          const final = await session.live.finish();
+          if (session.liveFailed) throw new Error("Live transcription was interrupted. Please retry this recording.");
+          text = final.trim();
+        } catch (error) {
+          session.liveFailed = true;
+          if (!session.transcribe) throw error;
+        } finally {
+          session.live.cancel();
+        }
+      }
+      if (!isCurrent(session)) return null;
+      if (text === void 0) {
+        if (!session.transcribe) throw new Error("Live transcription could not finish. Please record again.");
+        if (!session.blob.size) throw new Error("No audio was recorded. Try again.");
+        text = (await session.transcribe(session.blob, { language: session.language, signal: session.controller.signal })).trim();
+      }
       if (!isCurrent(session)) return null;
       if (!text) throw new Error("No speech was detected. Record again.");
     } catch (error) {
@@ -366,7 +425,8 @@ function useDictation({ lang = "en-US", continuous = true, onTranscript } = {})
       releaseTracks(session);
       session.phase = "error";
       const message = error instanceof Error && error.message ? error.message : "Transcription failed. Try again.";
-      setSnapshot({ ...EMPTY, state: "error", error: message, canRetry: !!session.blob?.size });
+      session.live?.cancel();
+      setSnapshot((previous) => ({ ...previous, state: "error", error: message, canRetry: !!session.transcribe && !!session.blob?.size }));
       return null;
     }
     session.transcript = text;
@@ -383,8 +443,13 @@ function useDictation({ lang = "en-US", continuous = true, onTranscript } = {})
       return Promise.resolve(null);
     }
     if (session.phase === "requesting") {
-      cancel();
-      return Promise.resolve(null);
+      if (!session.transcribe || session.recorder?.state !== "recording") {
+        cancel();
+        return Promise.resolve(null);
+      }
+      session.liveFailed = true;
+      session.streamController?.abort();
+      session.live?.cancel();
     }
     if (session.finish) return session.finish;
     if (session.phase === "error") return Promise.resolve(null);

package/dist/{chunk-7QTFYEPE.cjs → chunk-YMI3X2YL.cjs}

@@ -33,8 +33,7 @@ var DEFAULT_LABELS = {
   retry: "Retry voice chat",
   endShort: "End voice",
   muteShort: "Mute",
-  unmuteShort: "Unmute",
-  transcriptPlaceholder: "Speak to continue the conversation."
+  unmuteShort: "Unmute"
 };
 function VoiceSessionControls({
   state,
@@ -44,7 +43,6 @@ function VoiceSessionControls({
   onMutedChange,
   disabled = false,
   error,
-  transcript,
   volumeBands,
   audioLevels,
   labels,
@@ -79,18 +77,7 @@ function VoiceSessionControls({
                 volumeBands: muted && state === "listening" ? SILENCE : _nullishCoalesce(volumeBands, () => ( liveBands))
               }
             ),
-            /* @__PURE__ */ _jsxruntime.jsxs.call(void 0, "div", { className: "min-w-0 flex-1 space-y-1", children: [
-              /* @__PURE__ */ _jsxruntime.jsx.call(void 0, "span", { role: "status", className: "block text-sm font-medium text-primary", children: muted && state === "listening" ? copy.muted : copy[state] }),
-              /* @__PURE__ */ _jsxruntime.jsx.call(void 0, 
-                "p",
-                {
-                  "data-slot": "voice-session-transcript",
-                  title: transcript || void 0,
-                  className: _chunkKWLSBTB2cjs.cn.call(void 0, "truncate text-sm font-normal", transcript ? "text-foreground" : "text-muted-foreground"),
-                  children: transcript || copy.transcriptPlaceholder
-                }
-              )
-            ] })
+            /* @__PURE__ */ _jsxruntime.jsx.call(void 0, "span", { role: "status", className: "min-w-0 flex-1 text-sm font-medium text-primary", children: muted && state === "listening" ? copy.muted : copy[state] })
           ] }),
           /* @__PURE__ */ _jsxruntime.jsxs.call(void 0, "div", { className: "ml-auto flex shrink-0 items-center gap-2", children: [
             /* @__PURE__ */ _jsxruntime.jsxs.call(void 0, 

package/dist/hooks/use-dictation.cjs

@@ -3,8 +3,8 @@
 
 
 
-var _chunkZZ7ICQR2cjs = require('../chunk-ZZ7ICQR2.cjs');
+var _chunk7Q4EFCUIcjs = require('../chunk-7Q4EFCUI.cjs');
 
 
 
-exports.DictationProvider = _chunkZZ7ICQR2cjs.DictationProvider; exports.useDictation = _chunkZZ7ICQR2cjs.useDictation;
+exports.DictationProvider = _chunk7Q4EFCUIcjs.DictationProvider; exports.useDictation = _chunk7Q4EFCUIcjs.useDictation;

package/dist/hooks/use-dictation.d.cts

@@ -9,8 +9,27 @@ interface DictationTranscribeOptions {
 }
 /** The host authenticates this request; provider credentials never belong in the kit. */
 type DictationTranscribe = (audio: Blob, options: DictationTranscribeOptions) => Promise<string>;
+interface DictationStreamOptions extends DictationTranscribeOptions {
+    /** Replace the current preview. These updates must never save a note. */
+    onTranscript: (preview: {
+        transcript: string;
+        interimTranscript: string;
+    }) => void;
+    onError: (error: Error) => void;
+}
+interface DictationStreamSession {
+    /** Drain the final audio and resolve the complete, final transcript. */
+    finish: () => Promise<string>;
+    /** Release the transport without committing any text. Must be idempotent. */
+    cancel: () => void;
+}
+/** The host owns transport/authentication; use the supplied microphone stream. */
+type DictationStream = (audio: MediaStream, options: DictationStreamOptions) => Promise<DictationStreamSession>;
 interface DictationProviderProps {
-    transcribe: DictationTranscribe;
+    /** Complete-recording transcription, also used to retry a failed stream. */
+    transcribe?: DictationTranscribe;
+    /** Optional live transcription. Preview events never invoke onTranscript. */
+    stream?: DictationStream;
     /** Change when the acting user or workspace changes to discard its active take. */
     scopeKey?: string;
     children: ReactNode;
@@ -22,12 +41,13 @@ type DictationScope = {
     };
 };
 type DictationContextValue = {
-    transcribe: DictationTranscribe;
+    transcribe?: DictationTranscribe;
+    stream?: DictationStream;
     scope: DictationScope;
     generation: number;
 };
-/** Use recorded audio + the host's API for every descendant dictation control. */
-declare function DictationProvider({ transcribe, scopeKey, children }: DictationProviderProps): React.FunctionComponentElement<React.ProviderProps<DictationContextValue | null>>;
+/** Use the host's live or recorded-audio API for every descendant control. */
+declare function DictationProvider({ transcribe, stream, scopeKey, children }: DictationProviderProps): React.FunctionComponentElement<React.ProviderProps<DictationContextValue | null>>;
 type DictationState = "idle" | "requesting" | "recording" | "transcribing" | "ready" | "error";
 interface UseDictationOptions {
     lang?: string;
@@ -42,6 +62,8 @@ interface DictationCapture {
     transcript: string;
     interimTranscript: string;
     error: string | null;
+    /** A live preview failed, but the recorded take can still be transcribed on Done. */
+    previewError?: string;
     canRetry: boolean;
     /** Live bands from the recording stream. Native speech recognition exposes no audio meter. */
     audioLevels?: {
@@ -58,4 +80,4 @@ interface DictationCapture {
 /** Shared microphone lifecycle. Without a provider, existing native dictation keeps working. */
 declare function useDictation({ lang, continuous, onTranscript }?: UseDictationOptions): DictationCapture;
 
-export { type DictationCapture, DictationProvider, type DictationProviderProps, type DictationState, type DictationTranscribe, type DictationTranscribeOptions, type UseDictationOptions, useDictation };
+export { type DictationCapture, DictationProvider, type DictationProviderProps, type DictationState, type DictationStream, type DictationStreamOptions, type DictationStreamSession, type DictationTranscribe, type DictationTranscribeOptions, type UseDictationOptions, useDictation };