@athenaintel/react 0.23.2 → 0.24.0

package/dist/dictation/DictationStrip.d.ts

@@ -0,0 +1,27 @@
+import type { FC } from 'react';
+import { type AudioLevelHistory } from './audio-level-history';
+import type { DictationStatus, DictationTranscript } from './dictation-state';
+export interface DictationStripProps {
+    status: DictationStatus;
+    transcript: DictationTranscript;
+    /** Microphone stream to visualize; null draws the resting baseline. */
+    stream: MediaStream | null;
+    /** Number of bars across the strip. Defaults to 48. */
+    bars?: number;
+    /** Status while the engine flushes. Defaults to `Finishing…`. */
+    stoppingLabel?: string;
+    className?: string;
+}
+/**
+ * The bars. A rolling level history renders newest-right: unfilled slots are
+ * the dotted baseline, filled slots grow with the microphone level.
+ */
+export declare const DictationWaveform: FC<{
+    history: AudioLevelHistory;
+    className?: string;
+}>;
+/**
+ * The composer's recording mode: a live waveform in place of the text editor
+ * and the interim transcript as a caption under it.
+ */
+export declare const DictationStrip: FC<DictationStripProps>;

package/dist/dictation/DictationStrip.js

@@ -0,0 +1,61 @@
+import { jsxs, jsx } from "react/jsx-runtime";
+import { useAudioLevelHistory } from "./audio-level-history.js";
+import { cn } from "cnfast";
+const MIN_BAR_HEIGHT_PX = 3;
+const MAX_BAR_HEIGHT_PX = 24;
+function barHeight(level) {
+  return Math.round(MIN_BAR_HEIGHT_PX + level * (MAX_BAR_HEIGHT_PX - MIN_BAR_HEIGHT_PX));
+}
+const DictationWaveform = ({
+  history,
+  className
+}) => /* @__PURE__ */ jsx(
+  "div",
+  {
+    className: cn("aui-dictation-waveform flex h-6 items-center gap-[3px]", className),
+    "aria-hidden": "true",
+    children: history.map((level, index) => /* @__PURE__ */ jsx(
+      "span",
+      {
+        className: cn(
+          "aui-dictation-bar w-[3px] shrink-0 rounded-full transition-[height] duration-75",
+          level === null ? "bg-muted-foreground/30" : "bg-foreground/80"
+        ),
+        style: { height: level === null ? MIN_BAR_HEIGHT_PX : barHeight(level) }
+      },
+      index
+    ))
+  }
+);
+const DictationStrip = ({
+  status,
+  transcript,
+  stream,
+  bars = 48,
+  stoppingLabel = "Finishing…",
+  className
+}) => {
+  const history = useAudioLevelHistory(stream, { size: bars });
+  const caption = [transcript.final, transcript.interim].filter(Boolean).join(" ");
+  const statusLabel = status === "starting" ? "Starting microphone…" : status === "stopping" ? stoppingLabel : "Listening…";
+  return /* @__PURE__ */ jsxs(
+    "div",
+    {
+      className: cn("aui-dictation-strip flex min-h-10 flex-col gap-1 px-1.5 py-2", className),
+      role: "status",
+      "aria-live": "polite",
+      children: [
+        /* @__PURE__ */ jsxs("div", { className: "flex items-center gap-3", children: [
+          /* @__PURE__ */ jsx("span", { className: "aui-dictation-status text-muted-foreground shrink-0 text-xs", children: statusLabel }),
+          /* @__PURE__ */ jsx(DictationWaveform, { history, className: "min-w-0 flex-1 justify-end overflow-hidden" })
+        ] }),
+        caption && /* @__PURE__ */ jsx("p", { className: "aui-dictation-caption text-muted-foreground line-clamp-2 text-sm", children: caption })
+      ]
+    }
+  );
+};
+export {
+  DictationStrip,
+  DictationWaveform
+};
+//# sourceMappingURL=DictationStrip.js.map

package/dist/dictation/DictationStrip.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DictationStrip.js","sources":["../../src/dictation/DictationStrip.tsx"],"sourcesContent":["import type { FC } from 'react';\nimport { cn } from '../lib/utils';\nimport { type AudioLevelHistory, useAudioLevelHistory } from './audio-level-history';\nimport type { DictationStatus, DictationTranscript } from './dictation-state';\n\nexport interface DictationStripProps {\n  status: DictationStatus;\n  transcript: DictationTranscript;\n  /** Microphone stream to visualize; null draws the resting baseline. */\n  stream: MediaStream | null;\n  /** Number of bars across the strip. Defaults to 48. */\n  bars?: number;\n  /** Status while the engine flushes. Defaults to `Finishing…`. */\n  stoppingLabel?: string;\n  className?: string;\n}\n\nconst MIN_BAR_HEIGHT_PX = 3;\nconst MAX_BAR_HEIGHT_PX = 24;\n\nfunction barHeight(level: number): number {\n  return Math.round(MIN_BAR_HEIGHT_PX + level * (MAX_BAR_HEIGHT_PX - MIN_BAR_HEIGHT_PX));\n}\n\n/**\n * The bars. A rolling level history renders newest-right: unfilled slots are\n * the dotted baseline, filled slots grow with the microphone level.\n */\nexport const DictationWaveform: FC<{ history: AudioLevelHistory; className?: string }> = ({\n  history,\n  className,\n}) => (\n  <div\n    className={cn('aui-dictation-waveform flex h-6 items-center gap-[3px]', className)}\n    aria-hidden=\"true\"\n  >\n    {history.map((level, index) => (\n      <span\n        // Slots are positional; the history is a fixed-size window.\n        key={index}\n        className={cn(\n          'aui-dictation-bar w-[3px] shrink-0 rounded-full transition-[height] duration-75',\n          level === null ? 'bg-muted-foreground/30' : 'bg-foreground/80',\n        )}\n        style={{ height: level === null ? MIN_BAR_HEIGHT_PX : barHeight(level) }}\n      />\n    ))}\n  </div>\n);\n\n/**\n * The composer's recording mode: a live waveform in place of the text editor\n * and the interim transcript as a caption under it.\n */\nexport const DictationStrip: FC<DictationStripProps> = ({\n  status,\n  transcript,\n  stream,\n  bars = 48,\n  stoppingLabel = 'Finishing…',\n  className,\n}) => {\n  const history = useAudioLevelHistory(stream, { size: bars });\n  const caption = [transcript.final, transcript.interim].filter(Boolean).join(' ');\n  const statusLabel =\n    status === 'starting' ? 'Starting microphone…' : status === 'stopping' ? stoppingLabel : 'Listening…';\n\n  return (\n    <div\n      className={cn('aui-dictation-strip flex min-h-10 flex-col gap-1 px-1.5 py-2', className)}\n      role=\"status\"\n      aria-live=\"polite\"\n    >\n      <div className=\"flex items-center gap-3\">\n        <span className=\"aui-dictation-status text-muted-foreground shrink-0 text-xs\">{statusLabel}</span>\n        <DictationWaveform history={history} className=\"min-w-0 flex-1 justify-end overflow-hidden\" />\n      </div>\n      {caption && (\n        <p className=\"aui-dictation-caption text-muted-foreground line-clamp-2 text-sm\">{caption}</p>\n      )}\n    </div>\n  );\n};\n"],"names":[],"mappings":";;;AAiBA,MAAM,oBAAoB;AAC1B,MAAM,oBAAoB;AAE1B,SAAS,UAAU,OAAuB;AACxC,SAAO,KAAK,MAAM,oBAAoB,SAAS,oBAAoB,kBAAkB;AACvF;AAMO,MAAM,oBAA4E,CAAC;AAAA,EACxF;AAAA,EACA;AACF,MACE;AAAA,EAAC;AAAA,EAAA;AAAA,IACC,WAAW,GAAG,0DAA0D,SAAS;AAAA,IACjF,eAAY;AAAA,IAEX,UAAA,QAAQ,IAAI,CAAC,OAAO,UACnB;AAAA,MAAC;AAAA,MAAA;AAAA,QAGC,WAAW;AAAA,UACT;AAAA,UACA,UAAU,OAAO,2BAA2B;AAAA,QAAA;AAAA,QAE9C,OAAO,EAAE,QAAQ,UAAU,OAAO,oBAAoB,UAAU,KAAK,EAAA;AAAA,MAAE;AAAA,MALlE;AAAA,IAAA,CAOR;AAAA,EAAA;AACH;AAOK,MAAM,iBAA0C,CAAC;AAAA,EACtD;AAAA,EACA;AAAA,EACA;AAAA,EACA,OAAO;AAAA,EACP,gBAAgB;AAAA,EAChB;AACF,MAAM;AACJ,QAAM,UAAU,qBAAqB,QAAQ,EAAE,MAAM,MAAM;AAC3D,QAAM,UAAU,CAAC,WAAW,OAAO,WAAW,OAAO,EAAE,OAAO,OAAO,EAAE,KAAK,GAAG;AAC/E,QAAM,cACJ,WAAW,aAAa,yBAAyB,WAAW,aAAa,gBAAgB;AAE3F,SACE;AAAA,IAAC;AAAA,IAAA;AAAA,MACC,WAAW,GAAG,gEAAgE,SAAS;AAAA,MACvF,MAAK;AAAA,MACL,aAAU;AAAA,MAEV,UAAA;AAAA,QAAA,qBAAC,OAAA,EAAI,WAAU,2BACb,UAAA;AAAA,UAAA,oBAAC,QAAA,EAAK,WAAU,+DAA+D,UAAA,aAAY;AAAA,UAC3F,oBAAC,mBAAA,EAAkB,SAAkB,WAAU,6CAAA,CAA6C;AAAA,QAAA,GAC9F;AAAA,QACC,WACC,oBAAC,KAAA,EAAE,WAAU,oEAAoE,UAAA,QAAA,CAAQ;AAAA,MAAA;AAAA,IAAA;AAAA,EAAA;AAIjG;"}

package/dist/dictation/audio-level-history.cjs

@@ -0,0 +1,68 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const react = require("react");
+function emptyAudioLevelHistory(size) {
+  return new Array(Math.max(0, size)).fill(null);
+}
+function pushAudioLevel(history, level) {
+  if (history.length === 0) return history;
+  const clamped = Math.min(1, Math.max(0, level));
+  return [...history.slice(1), clamped];
+}
+function displayLevelFromSamples(samples, gain = 4) {
+  if (samples.length === 0) return 0;
+  let sum = 0;
+  for (let i = 0; i < samples.length; i += 1) {
+    const sample = samples[i] ?? 0;
+    sum += sample * sample;
+  }
+  const rms = Math.sqrt(sum / samples.length);
+  return Math.min(1, rms * gain);
+}
+function useAudioLevelHistory(stream, { size, intervalMs = 50 }) {
+  const [history, setHistory] = react.useState(() => emptyAudioLevelHistory(size));
+  react.useEffect(() => {
+    setHistory(emptyAudioLevelHistory(size));
+    if (!stream || typeof window === "undefined") return;
+    const AudioContextCtor = window.AudioContext ?? window.webkitAudioContext;
+    if (!AudioContextCtor) return;
+    let audioContext;
+    try {
+      audioContext = new AudioContextCtor();
+    } catch {
+      return;
+    }
+    const analyser = audioContext.createAnalyser();
+    analyser.fftSize = 1024;
+    analyser.smoothingTimeConstant = 0;
+    let source = null;
+    try {
+      source = audioContext.createMediaStreamSource(stream);
+      source.connect(analyser);
+    } catch {
+      void audioContext.close();
+      return;
+    }
+    const samples = new Float32Array(analyser.fftSize);
+    const interval = window.setInterval(() => {
+      analyser.getFloatTimeDomainData(samples);
+      const level = displayLevelFromSamples(samples);
+      setHistory((current) => pushAudioLevel(current, level));
+    }, intervalMs);
+    return () => {
+      window.clearInterval(interval);
+      try {
+        source == null ? void 0 : source.disconnect();
+        analyser.disconnect();
+      } catch {
+      }
+      void audioContext.close();
+    };
+  }, [stream, size, intervalMs]);
+  return history;
+}
+exports.displayLevelFromSamples = displayLevelFromSamples;
+exports.emptyAudioLevelHistory = emptyAudioLevelHistory;
+exports.pushAudioLevel = pushAudioLevel;
+exports.useAudioLevelHistory = useAudioLevelHistory;
+//# sourceMappingURL=audio-level-history.cjs.map

package/dist/dictation/audio-level-history.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"audio-level-history.cjs","sources":["../../src/dictation/audio-level-history.ts"],"sourcesContent":["import { useEffect, useState } from 'react';\n\n/**\n * A rolling window of microphone levels (0..1), newest last, for the\n * composer's waveform strip. `size` slots are always present: unfilled slots\n * are `null` so the strip can draw them as the resting dotted baseline.\n */\nexport type AudioLevelHistory = ReadonlyArray<number | null>;\n\nexport function emptyAudioLevelHistory(size: number): AudioLevelHistory {\n  return new Array<number | null>(Math.max(0, size)).fill(null);\n}\n\n/** Append one level, dropping the oldest slot. Pure. */\nexport function pushAudioLevel(history: AudioLevelHistory, level: number): AudioLevelHistory {\n  if (history.length === 0) return history;\n  const clamped = Math.min(1, Math.max(0, level));\n  return [...history.slice(1), clamped];\n}\n\n/**\n * RMS of a PCM sample window scaled to 0..1 for display. Speech peaks sit\n * around 0.1-0.3 RMS, so a gain lifts them into the visible range while the\n * noise floor (about 0.005) stays flat.\n */\nexport function displayLevelFromSamples(samples: ArrayLike<number>, gain = 4): number {\n  if (samples.length === 0) return 0;\n  let sum = 0;\n  for (let i = 0; i < samples.length; i += 1) {\n    const sample = samples[i] ?? 0;\n    sum += sample * sample;\n  }\n  const rms = Math.sqrt(sum / samples.length);\n  return Math.min(1, rms * gain);\n}\n\ninterface UseAudioLevelHistoryOptions {\n  /** Number of bars in the strip. */\n  size: number;\n  /** Sample cadence in ms; 50ms gives ~20 bars per second. */\n  intervalMs?: number;\n}\n\n/**\n * Sample a `MediaStream` through an `AnalyserNode` into a rolling level\n * history. Returns the resting baseline when `stream` is null.\n */\nexport function useAudioLevelHistory(\n  stream: MediaStream | null,\n  { size, intervalMs = 50 }: UseAudioLevelHistoryOptions,\n): AudioLevelHistory {\n  const [history, setHistory] = useState<AudioLevelHistory>(() => emptyAudioLevelHistory(size));\n\n  useEffect(() => {\n    setHistory(emptyAudioLevelHistory(size));\n    if (!stream || typeof window === 'undefined') return;\n    const AudioContextCtor =\n      window.AudioContext ??\n      (window as typeof window & { webkitAudioContext?: typeof AudioContext }).webkitAudioContext;\n    if (!AudioContextCtor) return;\n\n    let audioContext: AudioContext;\n    try {\n      audioContext = new AudioContextCtor();\n    } catch {\n      return;\n    }\n    const analyser = audioContext.createAnalyser();\n    analyser.fftSize = 1024;\n    analyser.smoothingTimeConstant = 0;\n    let source: MediaStreamAudioSourceNode | null = null;\n    try {\n      source = audioContext.createMediaStreamSource(stream);\n      source.connect(analyser);\n    } catch {\n      void audioContext.close();\n      return;\n    }\n    const samples = new Float32Array(analyser.fftSize);\n    const interval = window.setInterval(() => {\n      analyser.getFloatTimeDomainData(samples);\n      const level = displayLevelFromSamples(samples);\n      setHistory((current) => pushAudioLevel(current, level));\n    }, intervalMs);\n\n    return () => {\n      window.clearInterval(interval);\n      try {\n        source?.disconnect();\n        analyser.disconnect();\n      } catch {\n        // Already disconnected.\n      }\n      void audioContext.close();\n    };\n  }, [stream, size, intervalMs]);\n\n  return history;\n}\n"],"names":["useState","useEffect"],"mappings":";;;AASO,SAAS,uBAAuB,MAAiC;AACtE,SAAO,IAAI,MAAqB,KAAK,IAAI,GAAG,IAAI,CAAC,EAAE,KAAK,IAAI;AAC9D;AAGO,SAAS,eAAe,SAA4B,OAAkC;AAC3F,MAAI,QAAQ,WAAW,EAAG,QAAO;AACjC,QAAM,UAAU,KAAK,IAAI,GAAG,KAAK,IAAI,GAAG,KAAK,CAAC;AAC9C,SAAO,CAAC,GAAG,QAAQ,MAAM,CAAC,GAAG,OAAO;AACtC;AAOO,SAAS,wBAAwB,SAA4B,OAAO,GAAW;AACpF,MAAI,QAAQ,WAAW,EAAG,QAAO;AACjC,MAAI,MAAM;AACV,WAAS,IAAI,GAAG,IAAI,QAAQ,QAAQ,KAAK,GAAG;AAC1C,UAAM,SAAS,QAAQ,CAAC,KAAK;AAC7B,WAAO,SAAS;AAAA,EAClB;AACA,QAAM,MAAM,KAAK,KAAK,MAAM,QAAQ,MAAM;AAC1C,SAAO,KAAK,IAAI,GAAG,MAAM,IAAI;AAC/B;AAaO,SAAS,qBACd,QACA,EAAE,MAAM,aAAa,MACF;AACnB,QAAM,CAAC,SAAS,UAAU,IAAIA,MAAAA,SAA4B,MAAM,uBAAuB,IAAI,CAAC;AAE5FC,QAAAA,UAAU,MAAM;AACd,eAAW,uBAAuB,IAAI,CAAC;AACvC,QAAI,CAAC,UAAU,OAAO,WAAW,YAAa;AAC9C,UAAM,mBACJ,OAAO,gBACN,OAAwE;AAC3E,QAAI,CAAC,iBAAkB;AAEvB,QAAI;AACJ,QAAI;AACF,qBAAe,IAAI,iBAAA;AAAA,IACrB,QAAQ;AACN;AAAA,IACF;AACA,UAAM,WAAW,aAAa,eAAA;AAC9B,aAAS,UAAU;AACnB,aAAS,wBAAwB;AACjC,QAAI,SAA4C;AAChD,QAAI;AACF,eAAS,aAAa,wBAAwB,MAAM;AACpD,aAAO,QAAQ,QAAQ;AAAA,IACzB,QAAQ;AACN,WAAK,aAAa,MAAA;AAClB;AAAA,IACF;AACA,UAAM,UAAU,IAAI,aAAa,SAAS,OAAO;AACjD,UAAM,WAAW,OAAO,YAAY,MAAM;AACxC,eAAS,uBAAuB,OAAO;AACvC,YAAM,QAAQ,wBAAwB,OAAO;AAC7C,iBAAW,CAAC,YAAY,eAAe,SAAS,KAAK,CAAC;AAAA,IACxD,GAAG,UAAU;AAEb,WAAO,MAAM;AACX,aAAO,cAAc,QAAQ;AAC7B,UAAI;AACF,yCAAQ;AACR,iBAAS,WAAA;AAAA,MACX,QAAQ;AAAA,MAER;AACA,WAAK,aAAa,MAAA;AAAA,IACpB;AAAA,EACF,GAAG,CAAC,QAAQ,MAAM,UAAU,CAAC;AAE7B,SAAO;AACT;;;;;"}

package/dist/dictation/audio-level-history.d.ts

@@ -0,0 +1,27 @@
+/**
+ * A rolling window of microphone levels (0..1), newest last, for the
+ * composer's waveform strip. `size` slots are always present: unfilled slots
+ * are `null` so the strip can draw them as the resting dotted baseline.
+ */
+export type AudioLevelHistory = ReadonlyArray<number | null>;
+export declare function emptyAudioLevelHistory(size: number): AudioLevelHistory;
+/** Append one level, dropping the oldest slot. Pure. */
+export declare function pushAudioLevel(history: AudioLevelHistory, level: number): AudioLevelHistory;
+/**
+ * RMS of a PCM sample window scaled to 0..1 for display. Speech peaks sit
+ * around 0.1-0.3 RMS, so a gain lifts them into the visible range while the
+ * noise floor (about 0.005) stays flat.
+ */
+export declare function displayLevelFromSamples(samples: ArrayLike<number>, gain?: number): number;
+interface UseAudioLevelHistoryOptions {
+    /** Number of bars in the strip. */
+    size: number;
+    /** Sample cadence in ms; 50ms gives ~20 bars per second. */
+    intervalMs?: number;
+}
+/**
+ * Sample a `MediaStream` through an `AnalyserNode` into a rolling level
+ * history. Returns the resting baseline when `stream` is null.
+ */
+export declare function useAudioLevelHistory(stream: MediaStream | null, { size, intervalMs }: UseAudioLevelHistoryOptions): AudioLevelHistory;
+export {};

package/dist/dictation/audio-level-history.js

@@ -0,0 +1,68 @@
+import { useState, useEffect } from "react";
+function emptyAudioLevelHistory(size) {
+  return new Array(Math.max(0, size)).fill(null);
+}
+function pushAudioLevel(history, level) {
+  if (history.length === 0) return history;
+  const clamped = Math.min(1, Math.max(0, level));
+  return [...history.slice(1), clamped];
+}
+function displayLevelFromSamples(samples, gain = 4) {
+  if (samples.length === 0) return 0;
+  let sum = 0;
+  for (let i = 0; i < samples.length; i += 1) {
+    const sample = samples[i] ?? 0;
+    sum += sample * sample;
+  }
+  const rms = Math.sqrt(sum / samples.length);
+  return Math.min(1, rms * gain);
+}
+function useAudioLevelHistory(stream, { size, intervalMs = 50 }) {
+  const [history, setHistory] = useState(() => emptyAudioLevelHistory(size));
+  useEffect(() => {
+    setHistory(emptyAudioLevelHistory(size));
+    if (!stream || typeof window === "undefined") return;
+    const AudioContextCtor = window.AudioContext ?? window.webkitAudioContext;
+    if (!AudioContextCtor) return;
+    let audioContext;
+    try {
+      audioContext = new AudioContextCtor();
+    } catch {
+      return;
+    }
+    const analyser = audioContext.createAnalyser();
+    analyser.fftSize = 1024;
+    analyser.smoothingTimeConstant = 0;
+    let source = null;
+    try {
+      source = audioContext.createMediaStreamSource(stream);
+      source.connect(analyser);
+    } catch {
+      void audioContext.close();
+      return;
+    }
+    const samples = new Float32Array(analyser.fftSize);
+    const interval = window.setInterval(() => {
+      analyser.getFloatTimeDomainData(samples);
+      const level = displayLevelFromSamples(samples);
+      setHistory((current) => pushAudioLevel(current, level));
+    }, intervalMs);
+    return () => {
+      window.clearInterval(interval);
+      try {
+        source == null ? void 0 : source.disconnect();
+        analyser.disconnect();
+      } catch {
+      }
+      void audioContext.close();
+    };
+  }, [stream, size, intervalMs]);
+  return history;
+}
+export {
+  displayLevelFromSamples,
+  emptyAudioLevelHistory,
+  pushAudioLevel,
+  useAudioLevelHistory
+};
+//# sourceMappingURL=audio-level-history.js.map

package/dist/dictation/audio-level-history.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"audio-level-history.js","sources":["../../src/dictation/audio-level-history.ts"],"sourcesContent":["import { useEffect, useState } from 'react';\n\n/**\n * A rolling window of microphone levels (0..1), newest last, for the\n * composer's waveform strip. `size` slots are always present: unfilled slots\n * are `null` so the strip can draw them as the resting dotted baseline.\n */\nexport type AudioLevelHistory = ReadonlyArray<number | null>;\n\nexport function emptyAudioLevelHistory(size: number): AudioLevelHistory {\n  return new Array<number | null>(Math.max(0, size)).fill(null);\n}\n\n/** Append one level, dropping the oldest slot. Pure. */\nexport function pushAudioLevel(history: AudioLevelHistory, level: number): AudioLevelHistory {\n  if (history.length === 0) return history;\n  const clamped = Math.min(1, Math.max(0, level));\n  return [...history.slice(1), clamped];\n}\n\n/**\n * RMS of a PCM sample window scaled to 0..1 for display. Speech peaks sit\n * around 0.1-0.3 RMS, so a gain lifts them into the visible range while the\n * noise floor (about 0.005) stays flat.\n */\nexport function displayLevelFromSamples(samples: ArrayLike<number>, gain = 4): number {\n  if (samples.length === 0) return 0;\n  let sum = 0;\n  for (let i = 0; i < samples.length; i += 1) {\n    const sample = samples[i] ?? 0;\n    sum += sample * sample;\n  }\n  const rms = Math.sqrt(sum / samples.length);\n  return Math.min(1, rms * gain);\n}\n\ninterface UseAudioLevelHistoryOptions {\n  /** Number of bars in the strip. */\n  size: number;\n  /** Sample cadence in ms; 50ms gives ~20 bars per second. */\n  intervalMs?: number;\n}\n\n/**\n * Sample a `MediaStream` through an `AnalyserNode` into a rolling level\n * history. Returns the resting baseline when `stream` is null.\n */\nexport function useAudioLevelHistory(\n  stream: MediaStream | null,\n  { size, intervalMs = 50 }: UseAudioLevelHistoryOptions,\n): AudioLevelHistory {\n  const [history, setHistory] = useState<AudioLevelHistory>(() => emptyAudioLevelHistory(size));\n\n  useEffect(() => {\n    setHistory(emptyAudioLevelHistory(size));\n    if (!stream || typeof window === 'undefined') return;\n    const AudioContextCtor =\n      window.AudioContext ??\n      (window as typeof window & { webkitAudioContext?: typeof AudioContext }).webkitAudioContext;\n    if (!AudioContextCtor) return;\n\n    let audioContext: AudioContext;\n    try {\n      audioContext = new AudioContextCtor();\n    } catch {\n      return;\n    }\n    const analyser = audioContext.createAnalyser();\n    analyser.fftSize = 1024;\n    analyser.smoothingTimeConstant = 0;\n    let source: MediaStreamAudioSourceNode | null = null;\n    try {\n      source = audioContext.createMediaStreamSource(stream);\n      source.connect(analyser);\n    } catch {\n      void audioContext.close();\n      return;\n    }\n    const samples = new Float32Array(analyser.fftSize);\n    const interval = window.setInterval(() => {\n      analyser.getFloatTimeDomainData(samples);\n      const level = displayLevelFromSamples(samples);\n      setHistory((current) => pushAudioLevel(current, level));\n    }, intervalMs);\n\n    return () => {\n      window.clearInterval(interval);\n      try {\n        source?.disconnect();\n        analyser.disconnect();\n      } catch {\n        // Already disconnected.\n      }\n      void audioContext.close();\n    };\n  }, [stream, size, intervalMs]);\n\n  return history;\n}\n"],"names":[],"mappings":";AASO,SAAS,uBAAuB,MAAiC;AACtE,SAAO,IAAI,MAAqB,KAAK,IAAI,GAAG,IAAI,CAAC,EAAE,KAAK,IAAI;AAC9D;AAGO,SAAS,eAAe,SAA4B,OAAkC;AAC3F,MAAI,QAAQ,WAAW,EAAG,QAAO;AACjC,QAAM,UAAU,KAAK,IAAI,GAAG,KAAK,IAAI,GAAG,KAAK,CAAC;AAC9C,SAAO,CAAC,GAAG,QAAQ,MAAM,CAAC,GAAG,OAAO;AACtC;AAOO,SAAS,wBAAwB,SAA4B,OAAO,GAAW;AACpF,MAAI,QAAQ,WAAW,EAAG,QAAO;AACjC,MAAI,MAAM;AACV,WAAS,IAAI,GAAG,IAAI,QAAQ,QAAQ,KAAK,GAAG;AAC1C,UAAM,SAAS,QAAQ,CAAC,KAAK;AAC7B,WAAO,SAAS;AAAA,EAClB;AACA,QAAM,MAAM,KAAK,KAAK,MAAM,QAAQ,MAAM;AAC1C,SAAO,KAAK,IAAI,GAAG,MAAM,IAAI;AAC/B;AAaO,SAAS,qBACd,QACA,EAAE,MAAM,aAAa,MACF;AACnB,QAAM,CAAC,SAAS,UAAU,IAAI,SAA4B,MAAM,uBAAuB,IAAI,CAAC;AAE5F,YAAU,MAAM;AACd,eAAW,uBAAuB,IAAI,CAAC;AACvC,QAAI,CAAC,UAAU,OAAO,WAAW,YAAa;AAC9C,UAAM,mBACJ,OAAO,gBACN,OAAwE;AAC3E,QAAI,CAAC,iBAAkB;AAEvB,QAAI;AACJ,QAAI;AACF,qBAAe,IAAI,iBAAA;AAAA,IACrB,QAAQ;AACN;AAAA,IACF;AACA,UAAM,WAAW,aAAa,eAAA;AAC9B,aAAS,UAAU;AACnB,aAAS,wBAAwB;AACjC,QAAI,SAA4C;AAChD,QAAI;AACF,eAAS,aAAa,wBAAwB,MAAM;AACpD,aAAO,QAAQ,QAAQ;AAAA,IACzB,QAAQ;AACN,WAAK,aAAa,MAAA;AAClB;AAAA,IACF;AACA,UAAM,UAAU,IAAI,aAAa,SAAS,OAAO;AACjD,UAAM,WAAW,OAAO,YAAY,MAAM;AACxC,eAAS,uBAAuB,OAAO;AACvC,YAAM,QAAQ,wBAAwB,OAAO;AAC7C,iBAAW,CAAC,YAAY,eAAe,SAAS,KAAK,CAAC;AAAA,IACxD,GAAG,UAAU;AAEb,WAAO,MAAM;AACX,aAAO,cAAc,QAAQ;AAC7B,UAAI;AACF,yCAAQ;AACR,iBAAS,WAAA;AAAA,MACX,QAAQ;AAAA,MAER;AACA,WAAK,aAAa,MAAA;AAAA,IACpB;AAAA,EACF,GAAG,CAAC,QAAQ,MAAM,UAAU,CAAC;AAE7B,SAAO;AACT;"}

package/dist/dictation/dictation-controls.cjs

@@ -0,0 +1,60 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const jsxRuntime = require("react/jsx-runtime");
+const lucideReact = require("lucide-react");
+const tooltipIconButton = require("../chat/tooltip-icon-button.cjs");
+const cnfast = require("cnfast");
+const DictationMicButton = ({
+  onClick,
+  disabled,
+  className,
+  title = "Dictate a message"
+}) => /* @__PURE__ */ jsxRuntime.jsx(
+  tooltipIconButton.TooltipIconButton,
+  {
+    tooltip: title,
+    side: "bottom",
+    type: "button",
+    variant: "ghost",
+    size: "icon",
+    className: cnfast.cn("aui-composer-dictate size-8 rounded-full text-muted-foreground hover:text-foreground", className),
+    "aria-label": title,
+    onClick,
+    disabled,
+    children: /* @__PURE__ */ jsxRuntime.jsx(lucideReact.MicIcon, { className: "aui-composer-dictate-icon size-4" })
+  }
+);
+const DictationCancelButton = ({ onClick, disabled, className }) => /* @__PURE__ */ jsxRuntime.jsx(
+  tooltipIconButton.TooltipIconButton,
+  {
+    tooltip: "Cancel dictation",
+    side: "bottom",
+    type: "button",
+    variant: "outline",
+    size: "icon",
+    className: cnfast.cn("aui-composer-dictate-cancel size-8 rounded-full", className),
+    "aria-label": "Cancel dictation",
+    onClick,
+    disabled,
+    children: /* @__PURE__ */ jsxRuntime.jsx(lucideReact.XIcon, { className: "size-4" })
+  }
+);
+const DictationStopButton = ({ onClick, disabled, className }) => /* @__PURE__ */ jsxRuntime.jsx(
+  tooltipIconButton.TooltipIconButton,
+  {
+    tooltip: "Stop and review",
+    side: "bottom",
+    type: "button",
+    variant: "outline",
+    size: "icon",
+    className: cnfast.cn("aui-composer-dictate-stop size-8 rounded-full", className),
+    "aria-label": "Stop dictation",
+    onClick,
+    disabled,
+    children: /* @__PURE__ */ jsxRuntime.jsx(lucideReact.SquareIcon, { className: "size-3 fill-current" })
+  }
+);
+exports.DictationCancelButton = DictationCancelButton;
+exports.DictationMicButton = DictationMicButton;
+exports.DictationStopButton = DictationStopButton;
+//# sourceMappingURL=dictation-controls.cjs.map

package/dist/dictation/dictation-controls.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"dictation-controls.cjs","sources":["../../src/dictation/dictation-controls.tsx"],"sourcesContent":["import type { FC } from 'react';\nimport { MicIcon, SquareIcon, XIcon } from 'lucide-react';\nimport { TooltipIconButton } from '../chat/tooltip-icon-button';\nimport { cn } from '../lib/utils';\n\ninterface DictationControlProps {\n  onClick: () => void;\n  disabled?: boolean;\n  className?: string;\n}\n\n/** Toolbar mic: starts a dictation session. */\nexport const DictationMicButton: FC<DictationControlProps & { title?: string }> = ({\n  onClick,\n  disabled,\n  className,\n  title = 'Dictate a message',\n}) => (\n  <TooltipIconButton\n    tooltip={title}\n    side=\"bottom\"\n    type=\"button\"\n    variant=\"ghost\"\n    size=\"icon\"\n    className={cn('aui-composer-dictate size-8 rounded-full text-muted-foreground hover:text-foreground', className)}\n    aria-label={title}\n    onClick={onClick}\n    disabled={disabled}\n  >\n    <MicIcon className=\"aui-composer-dictate-icon size-4\" />\n  </TooltipIconButton>\n);\n\n/** Recording mode, left side: discard the session. */\nexport const DictationCancelButton: FC<DictationControlProps> = ({ onClick, disabled, className }) => (\n  <TooltipIconButton\n    tooltip=\"Cancel dictation\"\n    side=\"bottom\"\n    type=\"button\"\n    variant=\"outline\"\n    size=\"icon\"\n    className={cn('aui-composer-dictate-cancel size-8 rounded-full', className)}\n    aria-label=\"Cancel dictation\"\n    onClick={onClick}\n    disabled={disabled}\n  >\n    <XIcon className=\"size-4\" />\n  </TooltipIconButton>\n);\n\n/** Recording mode, right side: stop and put the words in the composer. */\nexport const DictationStopButton: FC<DictationControlProps> = ({ onClick, disabled, className }) => (\n  <TooltipIconButton\n    tooltip=\"Stop and review\"\n    side=\"bottom\"\n    type=\"button\"\n    variant=\"outline\"\n    size=\"icon\"\n    className={cn('aui-composer-dictate-stop size-8 rounded-full', className)}\n    aria-label=\"Stop dictation\"\n    onClick={onClick}\n    disabled={disabled}\n  >\n    <SquareIcon className=\"size-3 fill-current\" />\n  </TooltipIconButton>\n);\n"],"names":["jsx","TooltipIconButton","cn","MicIcon","XIcon","SquareIcon"],"mappings":";;;;;;AAYO,MAAM,qBAAqE,CAAC;AAAA,EACjF;AAAA,EACA;AAAA,EACA;AAAA,EACA,QAAQ;AACV,MACEA,2BAAAA;AAAAA,EAACC,kBAAAA;AAAAA,EAAA;AAAA,IACC,SAAS;AAAA,IACT,MAAK;AAAA,IACL,MAAK;AAAA,IACL,SAAQ;AAAA,IACR,MAAK;AAAA,IACL,WAAWC,OAAAA,GAAG,wFAAwF,SAAS;AAAA,IAC/G,cAAY;AAAA,IACZ;AAAA,IACA;AAAA,IAEA,UAAAF,2BAAAA,IAACG,YAAAA,SAAA,EAAQ,WAAU,mCAAA,CAAmC;AAAA,EAAA;AACxD;AAIK,MAAM,wBAAmD,CAAC,EAAE,SAAS,UAAU,gBACpFH,2BAAAA;AAAAA,EAACC,kBAAAA;AAAAA,EAAA;AAAA,IACC,SAAQ;AAAA,IACR,MAAK;AAAA,IACL,MAAK;AAAA,IACL,SAAQ;AAAA,IACR,MAAK;AAAA,IACL,WAAWC,OAAAA,GAAG,mDAAmD,SAAS;AAAA,IAC1E,cAAW;AAAA,IACX;AAAA,IACA;AAAA,IAEA,UAAAF,2BAAAA,IAACI,YAAAA,OAAA,EAAM,WAAU,SAAA,CAAS;AAAA,EAAA;AAC5B;AAIK,MAAM,sBAAiD,CAAC,EAAE,SAAS,UAAU,gBAClFJ,2BAAAA;AAAAA,EAACC,kBAAAA;AAAAA,EAAA;AAAA,IACC,SAAQ;AAAA,IACR,MAAK;AAAA,IACL,MAAK;AAAA,IACL,SAAQ;AAAA,IACR,MAAK;AAAA,IACL,WAAWC,OAAAA,GAAG,iDAAiD,SAAS;AAAA,IACxE,cAAW;AAAA,IACX;AAAA,IACA;AAAA,IAEA,UAAAF,2BAAAA,IAACK,YAAAA,YAAA,EAAW,WAAU,sBAAA,CAAsB;AAAA,EAAA;AAC9C;;;;"}

package/dist/dictation/dictation-controls.d.ts

@@ -0,0 +1,15 @@
+import type { FC } from 'react';
+interface DictationControlProps {
+    onClick: () => void;
+    disabled?: boolean;
+    className?: string;
+}
+/** Toolbar mic: starts a dictation session. */
+export declare const DictationMicButton: FC<DictationControlProps & {
+    title?: string;
+}>;
+/** Recording mode, left side: discard the session. */
+export declare const DictationCancelButton: FC<DictationControlProps>;
+/** Recording mode, right side: stop and put the words in the composer. */
+export declare const DictationStopButton: FC<DictationControlProps>;
+export {};

package/dist/dictation/dictation-controls.js

@@ -0,0 +1,60 @@
+import { jsx } from "react/jsx-runtime";
+import { SquareIcon, MicIcon, XIcon } from "lucide-react";
+import { TooltipIconButton } from "../chat/tooltip-icon-button.js";
+import { cn } from "cnfast";
+const DictationMicButton = ({
+  onClick,
+  disabled,
+  className,
+  title = "Dictate a message"
+}) => /* @__PURE__ */ jsx(
+  TooltipIconButton,
+  {
+    tooltip: title,
+    side: "bottom",
+    type: "button",
+    variant: "ghost",
+    size: "icon",
+    className: cn("aui-composer-dictate size-8 rounded-full text-muted-foreground hover:text-foreground", className),
+    "aria-label": title,
+    onClick,
+    disabled,
+    children: /* @__PURE__ */ jsx(MicIcon, { className: "aui-composer-dictate-icon size-4" })
+  }
+);
+const DictationCancelButton = ({ onClick, disabled, className }) => /* @__PURE__ */ jsx(
+  TooltipIconButton,
+  {
+    tooltip: "Cancel dictation",
+    side: "bottom",
+    type: "button",
+    variant: "outline",
+    size: "icon",
+    className: cn("aui-composer-dictate-cancel size-8 rounded-full", className),
+    "aria-label": "Cancel dictation",
+    onClick,
+    disabled,
+    children: /* @__PURE__ */ jsx(XIcon, { className: "size-4" })
+  }
+);
+const DictationStopButton = ({ onClick, disabled, className }) => /* @__PURE__ */ jsx(
+  TooltipIconButton,
+  {
+    tooltip: "Stop and review",
+    side: "bottom",
+    type: "button",
+    variant: "outline",
+    size: "icon",
+    className: cn("aui-composer-dictate-stop size-8 rounded-full", className),
+    "aria-label": "Stop dictation",
+    onClick,
+    disabled,
+    children: /* @__PURE__ */ jsx(SquareIcon, { className: "size-3 fill-current" })
+  }
+);
+export {
+  DictationCancelButton,
+  DictationMicButton,
+  DictationStopButton
+};
+//# sourceMappingURL=dictation-controls.js.map

package/dist/dictation/dictation-controls.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dictation-controls.js","sources":["../../src/dictation/dictation-controls.tsx"],"sourcesContent":["import type { FC } from 'react';\nimport { MicIcon, SquareIcon, XIcon } from 'lucide-react';\nimport { TooltipIconButton } from '../chat/tooltip-icon-button';\nimport { cn } from '../lib/utils';\n\ninterface DictationControlProps {\n  onClick: () => void;\n  disabled?: boolean;\n  className?: string;\n}\n\n/** Toolbar mic: starts a dictation session. */\nexport const DictationMicButton: FC<DictationControlProps & { title?: string }> = ({\n  onClick,\n  disabled,\n  className,\n  title = 'Dictate a message',\n}) => (\n  <TooltipIconButton\n    tooltip={title}\n    side=\"bottom\"\n    type=\"button\"\n    variant=\"ghost\"\n    size=\"icon\"\n    className={cn('aui-composer-dictate size-8 rounded-full text-muted-foreground hover:text-foreground', className)}\n    aria-label={title}\n    onClick={onClick}\n    disabled={disabled}\n  >\n    <MicIcon className=\"aui-composer-dictate-icon size-4\" />\n  </TooltipIconButton>\n);\n\n/** Recording mode, left side: discard the session. */\nexport const DictationCancelButton: FC<DictationControlProps> = ({ onClick, disabled, className }) => (\n  <TooltipIconButton\n    tooltip=\"Cancel dictation\"\n    side=\"bottom\"\n    type=\"button\"\n    variant=\"outline\"\n    size=\"icon\"\n    className={cn('aui-composer-dictate-cancel size-8 rounded-full', className)}\n    aria-label=\"Cancel dictation\"\n    onClick={onClick}\n    disabled={disabled}\n  >\n    <XIcon className=\"size-4\" />\n  </TooltipIconButton>\n);\n\n/** Recording mode, right side: stop and put the words in the composer. */\nexport const DictationStopButton: FC<DictationControlProps> = ({ onClick, disabled, className }) => (\n  <TooltipIconButton\n    tooltip=\"Stop and review\"\n    side=\"bottom\"\n    type=\"button\"\n    variant=\"outline\"\n    size=\"icon\"\n    className={cn('aui-composer-dictate-stop size-8 rounded-full', className)}\n    aria-label=\"Stop dictation\"\n    onClick={onClick}\n    disabled={disabled}\n  >\n    <SquareIcon className=\"size-3 fill-current\" />\n  </TooltipIconButton>\n);\n"],"names":[],"mappings":";;;;AAYO,MAAM,qBAAqE,CAAC;AAAA,EACjF;AAAA,EACA;AAAA,EACA;AAAA,EACA,QAAQ;AACV,MACE;AAAA,EAAC;AAAA,EAAA;AAAA,IACC,SAAS;AAAA,IACT,MAAK;AAAA,IACL,MAAK;AAAA,IACL,SAAQ;AAAA,IACR,MAAK;AAAA,IACL,WAAW,GAAG,wFAAwF,SAAS;AAAA,IAC/G,cAAY;AAAA,IACZ;AAAA,IACA;AAAA,IAEA,UAAA,oBAAC,SAAA,EAAQ,WAAU,mCAAA,CAAmC;AAAA,EAAA;AACxD;AAIK,MAAM,wBAAmD,CAAC,EAAE,SAAS,UAAU,gBACpF;AAAA,EAAC;AAAA,EAAA;AAAA,IACC,SAAQ;AAAA,IACR,MAAK;AAAA,IACL,MAAK;AAAA,IACL,SAAQ;AAAA,IACR,MAAK;AAAA,IACL,WAAW,GAAG,mDAAmD,SAAS;AAAA,IAC1E,cAAW;AAAA,IACX;AAAA,IACA;AAAA,IAEA,UAAA,oBAAC,OAAA,EAAM,WAAU,SAAA,CAAS;AAAA,EAAA;AAC5B;AAIK,MAAM,sBAAiD,CAAC,EAAE,SAAS,UAAU,gBAClF;AAAA,EAAC;AAAA,EAAA;AAAA,IACC,SAAQ;AAAA,IACR,MAAK;AAAA,IACL,MAAK;AAAA,IACL,SAAQ;AAAA,IACR,MAAK;AAAA,IACL,WAAW,GAAG,iDAAiD,SAAS;AAAA,IACxE,cAAW;AAAA,IACX;AAAA,IACA;AAAA,IAEA,UAAA,oBAAC,YAAA,EAAW,WAAU,sBAAA,CAAsB;AAAA,EAAA;AAC9C;"}

package/dist/dictation/dictation-engine.cjs

@@ -0,0 +1,128 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const DICTATION_ENGINE_ERROR_KINDS = {
+  /** The user denied the microphone, or the browser blocked it. */
+  permission: "permission",
+  /** No speech engine is available in this browser. */
+  unsupported: "unsupported",
+  /** The engine could not reach its recognizer. */
+  connection: "connection",
+  /** The engine heard nothing for its silence window. */
+  noSpeech: "no-speech",
+  unknown: "unknown"
+};
+function resolveSpeechRecognitionCtor() {
+  if (typeof window === "undefined") return null;
+  const scope = window;
+  return scope.SpeechRecognition ?? scope.webkitSpeechRecognition ?? null;
+}
+function classifyWebSpeechError(code) {
+  switch (code) {
+    case "not-allowed":
+    case "service-not-allowed":
+      return {
+        kind: DICTATION_ENGINE_ERROR_KINDS.permission,
+        message: "Microphone access was denied. Allow the microphone for this site and try again."
+      };
+    case "network":
+      return {
+        kind: DICTATION_ENGINE_ERROR_KINDS.connection,
+        message: "Speech recognition could not connect. Check your connection and try again."
+      };
+    case "no-speech":
+      return {
+        kind: DICTATION_ENGINE_ERROR_KINDS.noSpeech,
+        message: "No speech was heard."
+      };
+    case "audio-capture":
+      return {
+        kind: DICTATION_ENGINE_ERROR_KINDS.permission,
+        message: "No microphone was found."
+      };
+    case "aborted":
+      return { kind: DICTATION_ENGINE_ERROR_KINDS.unknown, message: "Dictation was interrupted." };
+    default:
+      return { kind: DICTATION_ENGINE_ERROR_KINDS.unknown, message: "Dictation stopped unexpectedly." };
+  }
+}
+function foldWebSpeechResults(results, resultIndex) {
+  var _a;
+  let final = "";
+  let interim = "";
+  for (let i = resultIndex; i < results.length; i += 1) {
+    const result = results[i];
+    const transcript = ((_a = result == null ? void 0 : result[0]) == null ? void 0 : _a.transcript) ?? "";
+    if (!transcript) continue;
+    if (result.isFinal) final = final ? `${final} ${transcript.trim()}` : transcript.trim();
+    else interim = interim ? `${interim} ${transcript.trim()}` : transcript.trim();
+  }
+  return { final, interim };
+}
+function createWebSpeechDictationEngine() {
+  return {
+    id: "web-speech",
+    isSupported: () => resolveSpeechRecognitionCtor() !== null,
+    start: ({ lang, callbacks }) => {
+      const Ctor = resolveSpeechRecognitionCtor();
+      if (!Ctor) {
+        callbacks.onError({
+          kind: DICTATION_ENGINE_ERROR_KINDS.unsupported,
+          message: "This browser has no speech recognition."
+        });
+        callbacks.onEnd();
+        return { stop: () => void 0, abort: () => void 0 };
+      }
+      const recognition = new Ctor();
+      recognition.continuous = true;
+      recognition.interimResults = true;
+      recognition.lang = lang;
+      let ended = false;
+      const end = () => {
+        if (ended) return;
+        ended = true;
+        recognition.onresult = null;
+        recognition.onerror = null;
+        recognition.onend = null;
+        callbacks.onEnd();
+      };
+      recognition.onresult = (event) => {
+        callbacks.onTranscript(foldWebSpeechResults(event.results, event.resultIndex));
+      };
+      recognition.onerror = (event) => {
+        if (event.error === "aborted") return;
+        callbacks.onError(classifyWebSpeechError(event.error));
+      };
+      recognition.onend = end;
+      try {
+        recognition.start();
+      } catch (error) {
+        callbacks.onError({
+          kind: DICTATION_ENGINE_ERROR_KINDS.unknown,
+          message: error instanceof Error ? error.message : "Dictation could not start."
+        });
+        end();
+      }
+      return {
+        stop: () => {
+          try {
+            recognition.stop();
+          } catch {
+            end();
+          }
+        },
+        abort: () => {
+          try {
+            recognition.abort();
+          } finally {
+            end();
+          }
+        }
+      };
+    }
+  };
+}
+exports.DICTATION_ENGINE_ERROR_KINDS = DICTATION_ENGINE_ERROR_KINDS;
+exports.classifyWebSpeechError = classifyWebSpeechError;
+exports.createWebSpeechDictationEngine = createWebSpeechDictationEngine;
+exports.foldWebSpeechResults = foldWebSpeechResults;
+//# sourceMappingURL=dictation-engine.cjs.map

package/dist/dictation/dictation-engine.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"dictation-engine.cjs","sources":["../../src/dictation/dictation-engine.ts"],"sourcesContent":["/**\n * Speech-to-text engines behind the composer's dictation mode.\n *\n * An engine turns microphone audio into a stream of transcript updates. The\n * SDK ships the browser's own `SpeechRecognition` engine (Chrome, Edge,\n * Safari), which needs no backend. A host can plug in another engine (for\n * example a relay to a server-side recognizer) through the `engine` option\n * of `useDictation` / `<AthenaChat dictation>`; the composer UI is engine\n * agnostic.\n */\n\nexport interface DictationTranscriptUpdate {\n  /** Text the engine has committed. Appended to earlier committed text. */\n  final: string;\n  /** Text still being recognized; replaced on the next update. */\n  interim: string;\n}\n\nexport interface DictationEngineCallbacks {\n  onTranscript: (update: DictationTranscriptUpdate) => void;\n  /** The engine stopped on its own (silence timeout, network, permission). */\n  onEnd: () => void;\n  onError: (error: DictationEngineError) => void;\n}\n\nexport interface DictationEngineSession {\n  /** Ask the engine to finish. `onEnd` fires once it has flushed. */\n  stop: () => void;\n  /** Tear the engine down without waiting for a flush. */\n  abort: () => void;\n}\n\nexport interface DictationEngine {\n  /** Stable identifier surfaced in diagnostics (e.g. `web-speech`). */\n  readonly id: string;\n  /**\n   * Whether this engine can run in the current browser. When false the\n   * composer hides the mic instead of rendering a control that cannot work.\n   */\n  isSupported: () => boolean;\n  /**\n   * How long `stop()` may wait for the final transcript before the session\n   * is forced closed. Engines that transcribe after recording need more than\n   * the live default (1.5s).\n   */\n  readonly flushTimeoutMs?: number;\n  /** Status shown while flushing (e.g. `Transcribing…`); defaults to `Finishing…`. */\n  readonly stoppingLabel?: string;\n  /**\n   * Start recognizing. `stream` is the microphone stream the composer already\n   * opened for the waveform; engines that read audio themselves (Web Speech)\n   * ignore it, relay engines encode it.\n   */\n  start: (options: {\n    stream: MediaStream | null;\n    lang: string;\n    callbacks: DictationEngineCallbacks;\n  }) => DictationEngineSession;\n}\n\nexport const DICTATION_ENGINE_ERROR_KINDS = {\n  /** The user denied the microphone, or the browser blocked it. */\n  permission: 'permission',\n  /** No speech engine is available in this browser. */\n  unsupported: 'unsupported',\n  /** The engine could not reach its recognizer. */\n  connection: 'connection',\n  /** The engine heard nothing for its silence window. */\n  noSpeech: 'no-speech',\n  unknown: 'unknown',\n} as const;\n\nexport type DictationEngineErrorKind =\n  (typeof DICTATION_ENGINE_ERROR_KINDS)[keyof typeof DICTATION_ENGINE_ERROR_KINDS];\n\nexport interface DictationEngineError {\n  kind: DictationEngineErrorKind;\n  /** One line the composer can show the user. */\n  message: string;\n}\n\n// ─── Web Speech API engine ──────────────────────────────────────────\n\n// The Web Speech API has no lib.dom entry in every TypeScript version the SDK\n// supports, and browsers still vendor-prefix the constructor.\ninterface SpeechRecognitionAlternativeLike {\n  transcript: string;\n}\ninterface SpeechRecognitionResultLike {\n  isFinal: boolean;\n  readonly length: number;\n  [index: number]: SpeechRecognitionAlternativeLike;\n}\ninterface SpeechRecognitionEventLike extends Event {\n  resultIndex: number;\n  results: ArrayLike<SpeechRecognitionResultLike>;\n}\ninterface SpeechRecognitionErrorEventLike extends Event {\n  error: string;\n  message?: string;\n}\ninterface SpeechRecognitionLike extends EventTarget {\n  continuous: boolean;\n  interimResults: boolean;\n  lang: string;\n  start: () => void;\n  stop: () => void;\n  abort: () => void;\n  onresult: ((event: SpeechRecognitionEventLike) => void) | null;\n  onerror: ((event: SpeechRecognitionErrorEventLike) => void) | null;\n  onend: (() => void) | null;\n}\ntype SpeechRecognitionCtor = new () => SpeechRecognitionLike;\n\nfunction resolveSpeechRecognitionCtor(): SpeechRecognitionCtor | null {\n  if (typeof window === 'undefined') return null;\n  const scope = window as unknown as {\n    SpeechRecognition?: SpeechRecognitionCtor;\n    webkitSpeechRecognition?: SpeechRecognitionCtor;\n  };\n  return scope.SpeechRecognition ?? scope.webkitSpeechRecognition ?? null;\n}\n\n/** Map a Web Speech `error` code to the engine's error vocabulary. */\nexport function classifyWebSpeechError(code: string): DictationEngineError {\n  switch (code) {\n    case 'not-allowed':\n    case 'service-not-allowed':\n      return {\n        kind: DICTATION_ENGINE_ERROR_KINDS.permission,\n        message: 'Microphone access was denied. Allow the microphone for this site and try again.',\n      };\n    case 'network':\n      return {\n        kind: DICTATION_ENGINE_ERROR_KINDS.connection,\n        message: 'Speech recognition could not connect. Check your connection and try again.',\n      };\n    case 'no-speech':\n      return {\n        kind: DICTATION_ENGINE_ERROR_KINDS.noSpeech,\n        message: 'No speech was heard.',\n      };\n    case 'audio-capture':\n      return {\n        kind: DICTATION_ENGINE_ERROR_KINDS.permission,\n        message: 'No microphone was found.',\n      };\n    case 'aborted':\n      return { kind: DICTATION_ENGINE_ERROR_KINDS.unknown, message: 'Dictation was interrupted.' };\n    default:\n      return { kind: DICTATION_ENGINE_ERROR_KINDS.unknown, message: 'Dictation stopped unexpectedly.' };\n  }\n}\n\n/**\n * Fold one Web Speech result event into `{ final, interim }`. Finalized\n * alternatives from `resultIndex` onward are joined with a space; the rest is\n * the interim tail. Pure so it can be tested without a browser.\n */\nexport function foldWebSpeechResults(\n  results: ArrayLike<SpeechRecognitionResultLike>,\n  resultIndex: number,\n): DictationTranscriptUpdate {\n  let final = '';\n  let interim = '';\n  for (let i = resultIndex; i < results.length; i += 1) {\n    const result = results[i];\n    const transcript = result?.[0]?.transcript ?? '';\n    if (!transcript) continue;\n    if (result.isFinal) final = final ? `${final} ${transcript.trim()}` : transcript.trim();\n    else interim = interim ? `${interim} ${transcript.trim()}` : transcript.trim();\n  }\n  return { final, interim };\n}\n\n/**\n * The browser's own recognizer. Zero dependencies and zero backend; Chrome\n * and Edge stream partial results, Safari returns results in chunks, Firefox\n * has no implementation (`isSupported()` is false there).\n */\nexport function createWebSpeechDictationEngine(): DictationEngine {\n  return {\n    id: 'web-speech',\n    isSupported: () => resolveSpeechRecognitionCtor() !== null,\n    start: ({ lang, callbacks }) => {\n      const Ctor = resolveSpeechRecognitionCtor();\n      if (!Ctor) {\n        callbacks.onError({\n          kind: DICTATION_ENGINE_ERROR_KINDS.unsupported,\n          message: 'This browser has no speech recognition.',\n        });\n        callbacks.onEnd();\n        return { stop: () => undefined, abort: () => undefined };\n      }\n      const recognition = new Ctor();\n      recognition.continuous = true;\n      recognition.interimResults = true;\n      recognition.lang = lang;\n      let ended = false;\n      const end = () => {\n        if (ended) return;\n        ended = true;\n        recognition.onresult = null;\n        recognition.onerror = null;\n        recognition.onend = null;\n        callbacks.onEnd();\n      };\n      recognition.onresult = (event) => {\n        callbacks.onTranscript(foldWebSpeechResults(event.results, event.resultIndex));\n      };\n      recognition.onerror = (event) => {\n        // `aborted` follows our own abort(); the session already ended.\n        if (event.error === 'aborted') return;\n        callbacks.onError(classifyWebSpeechError(event.error));\n      };\n      recognition.onend = end;\n      try {\n        recognition.start();\n      } catch (error) {\n        callbacks.onError({\n          kind: DICTATION_ENGINE_ERROR_KINDS.unknown,\n          message: error instanceof Error ? error.message : 'Dictation could not start.',\n        });\n        end();\n      }\n      return {\n        stop: () => {\n          try {\n            recognition.stop();\n          } catch {\n            end();\n          }\n        },\n        abort: () => {\n          try {\n            recognition.abort();\n          } finally {\n            end();\n          }\n        },\n      };\n    },\n  };\n}\n"],"names":[],"mappings":"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"}