@arbidocs/react 0.5.111 → 0.5.112

package/dist/documents/VoiceNoteRecorder.js

@@ -0,0 +1,166 @@
+import { Fragment, jsx, jsxs } from "react/jsx-runtime";
+import { useEffect, useState } from "react";
+import { Mic, Pause, Play, Square, Trash2, Check, Loader2, RotateCcw } from "lucide-react";
+import { Button } from "../ui/button.js";
+import { AudioViewer } from "../viewers/AudioViewer.js";
+import { useAudioRecorder } from "./useAudioRecorder.js";
+import { MicWaveformIndicator } from "./MicWaveformIndicator.js";
+function VoiceNoteRecorder({
+  onSave,
+  onDiscard,
+  onError,
+  title = "Voice Memo",
+  isSaving = false,
+  transcribe
+}) {
+  const recorder = useAudioRecorder();
+  const [transcript, setTranscript] = useState(null);
+  const [isTranscribing, setIsTranscribing] = useState(false);
+  useEffect(() => {
+    if (recorder.error) onError?.(recorder.error);
+  }, [recorder.error]);
+  useEffect(() => {
+    if (recorder.state !== "stopped" || !recorder.blob) {
+      setTranscript(null);
+      setIsTranscribing(false);
+      return;
+    }
+    if (!transcribe) return;
+    let cancelled = false;
+    setIsTranscribing(true);
+    transcribe(recorder.blob).then((text) => {
+      if (!cancelled) setTranscript(text);
+    }).catch(() => {
+    }).finally(() => {
+      if (!cancelled) setIsTranscribing(false);
+    });
+    return () => {
+      cancelled = true;
+    };
+  }, [recorder.state, recorder.blob]);
+  const handleSave = () => {
+    if (!recorder.blob) return;
+    void onSave(recorder.blob, recorder.mimeType);
+  };
+  return /* @__PURE__ */ jsxs("div", { className: "flex h-full flex-col items-center justify-center gap-6 p-8", children: [
+    recorder.state === "idle" && /* @__PURE__ */ jsxs(Fragment, { children: [
+      /* @__PURE__ */ jsx(
+        Button,
+        {
+          type: "button",
+          size: "lg",
+          className: "h-16 w-16 rounded-full p-0",
+          onClick: () => void recorder.start(),
+          "data-testid": "voice-note-record-button",
+          children: /* @__PURE__ */ jsx(Mic, { className: "h-6 w-6" })
+        }
+      ),
+      /* @__PURE__ */ jsx("p", { className: "text-sm text-muted-foreground", children: "Press to start recording" })
+    ] }),
+    (recorder.state === "recording" || recorder.state === "paused") && /* @__PURE__ */ jsxs(Fragment, { children: [
+      /* @__PURE__ */ jsx(
+        MicWaveformIndicator,
+        {
+          level: recorder.level,
+          elapsedMs: recorder.elapsedMs,
+          paused: recorder.state === "paused"
+        }
+      ),
+      /* @__PURE__ */ jsxs("div", { className: "flex items-center gap-3", children: [
+        recorder.state === "recording" ? /* @__PURE__ */ jsxs(
+          Button,
+          {
+            type: "button",
+            variant: "outline",
+            onClick: recorder.pause,
+            "data-testid": "voice-note-pause-button",
+            children: [
+              /* @__PURE__ */ jsx(Pause, { className: "mr-1.5 h-4 w-4" }),
+              "Pause"
+            ]
+          }
+        ) : /* @__PURE__ */ jsxs(
+          Button,
+          {
+            type: "button",
+            variant: "outline",
+            onClick: recorder.resume,
+            "data-testid": "voice-note-resume-button",
+            children: [
+              /* @__PURE__ */ jsx(Play, { className: "mr-1.5 h-4 w-4" }),
+              "Resume"
+            ]
+          }
+        ),
+        /* @__PURE__ */ jsxs(Button, { type: "button", onClick: recorder.stop, "data-testid": "voice-note-stop-button", children: [
+          /* @__PURE__ */ jsx(Square, { className: "mr-1.5 h-3.5 w-3.5 fill-current" }),
+          "Stop"
+        ] })
+      ] })
+    ] }),
+    recorder.state === "stopped" && recorder.blob && /* @__PURE__ */ jsxs(Fragment, { children: [
+      /* @__PURE__ */ jsx("div", { className: "w-full max-w-md", children: /* @__PURE__ */ jsx(AudioViewer, { blob: recorder.blob, title }) }),
+      (isTranscribing || transcript) && /* @__PURE__ */ jsx(
+        "div",
+        {
+          className: "w-full max-w-md rounded-md border border-border bg-muted/30 p-3 text-sm text-muted-foreground",
+          "data-testid": "voice-note-rough-transcript",
+          children: isTranscribing ? /* @__PURE__ */ jsxs("span", { className: "flex items-center gap-1.5", children: [
+            /* @__PURE__ */ jsx(Loader2, { className: "h-3.5 w-3.5 animate-spin" }),
+            "Transcribing\u2026"
+          ] }) : /* @__PURE__ */ jsxs(Fragment, { children: [
+            /* @__PURE__ */ jsx("p", { className: "mb-1 text-xs font-semibold uppercase tracking-wide", children: "Rough transcript" }),
+            /* @__PURE__ */ jsx("p", { children: transcript })
+          ] })
+        }
+      ),
+      /* @__PURE__ */ jsxs("div", { className: "flex items-center gap-3", children: [
+        /* @__PURE__ */ jsxs(
+          Button,
+          {
+            type: "button",
+            variant: "outline",
+            onClick: onDiscard,
+            disabled: isSaving,
+            "data-testid": "voice-note-discard-button",
+            children: [
+              /* @__PURE__ */ jsx(Trash2, { className: "mr-1.5 h-4 w-4" }),
+              "Discard"
+            ]
+          }
+        ),
+        /* @__PURE__ */ jsxs(
+          Button,
+          {
+            type: "button",
+            variant: "outline",
+            onClick: recorder.reset,
+            disabled: isSaving,
+            "data-testid": "voice-note-record-again-button",
+            children: [
+              /* @__PURE__ */ jsx(RotateCcw, { className: "mr-1.5 h-4 w-4" }),
+              "Record again"
+            ]
+          }
+        ),
+        /* @__PURE__ */ jsxs(
+          Button,
+          {
+            type: "button",
+            onClick: handleSave,
+            disabled: isSaving,
+            "data-testid": "voice-note-save-button",
+            children: [
+              isSaving ? /* @__PURE__ */ jsx(Loader2, { className: "mr-1.5 h-4 w-4 animate-spin" }) : /* @__PURE__ */ jsx(Check, { className: "mr-1.5 h-4 w-4" }),
+              isSaving ? "Saving\u2026" : "Save"
+            ]
+          }
+        )
+      ] })
+    ] })
+  ] });
+}
+export {
+  VoiceNoteRecorder
+};
+//# sourceMappingURL=VoiceNoteRecorder.js.map

package/dist/documents/VoiceNoteRecorder.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/documents/VoiceNoteRecorder.tsx"],
+  "sourcesContent": ["/**\n * VoiceNoteRecorder\n *\n * A toggle-style recorder (press to start, pause/resume, stop, review, then\n * save or discard) as opposed to a press-and-hold mic. Shares its\n * capture/metering engine (useAudioRecorder) and its REC-badge/timer/waveform\n * visual (MicWaveformIndicator) with any other recorder a host app builds.\n *\n * REUSE-FIRST: no app coupling. The host supplies `onSave`/`onDiscard` (and\n * optionally `onError`) \u2014 this component owns only the recording UI and\n * in-memory blob, never persistence. Nothing is uploaded until the host's\n * `onSave` is called and resolves.\n */\n\nimport { useEffect, useState } from 'react'\nimport { Mic, Pause, Play, Square, Trash2, Check, Loader2, RotateCcw } from 'lucide-react'\nimport { Button } from '../ui/button'\nimport { AudioViewer } from '../viewers/AudioViewer'\nimport { useAudioRecorder } from './useAudioRecorder'\nimport { MicWaveformIndicator } from './MicWaveformIndicator'\n\nexport interface VoiceNoteRecorderProps {\n  /** Called with the reviewed recording when the user hits Save. Resolve to\n   *  let the host close/replace this recorder; the recorder shows a saving\n   *  spinner while the promise is pending. */\n  onSave: (blob: Blob, mimeType: string | null) => Promise<void> | void\n  /** Called when the user discards the draft. */\n  onDiscard: () => void\n  /** Surfaces recorder failures (e.g. denied mic permission) \u2014 wire this to\n   *  the host's own notification system. Without it, failures are silent. */\n  onError?: (message: string) => void\n  /** Title passed through to the playback preview. */\n  title?: string\n  /** External saving state, e.g. while the host's onSave promise is\n   *  pending \u2014 disables actions and shows a spinner on Save. */\n  isSaving?: boolean\n  /**\n   * Optional: called once with the finished recording as soon as it stops,\n   * to produce a quick rough transcript shown inline during review. Purely\n   * client-side and ephemeral \u2014 it's never uploaded and has no bearing on\n   * what onSave receives; a host with real (e.g. diarized) transcription as\n   * part of its normal document processing can skip this prop entirely.\n   */\n  transcribe?: (blob: Blob) => Promise<string>\n}\n\nexport function VoiceNoteRecorder({\n  onSave,\n  onDiscard,\n  onError,\n  title = 'Voice Memo',\n  isSaving = false,\n  transcribe,\n}: VoiceNoteRecorderProps) {\n  const recorder = useAudioRecorder()\n  const [transcript, setTranscript] = useState<string | null>(null)\n  const [isTranscribing, setIsTranscribing] = useState(false)\n\n  useEffect(() => {\n    if (recorder.error) onError?.(recorder.error)\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, [recorder.error])\n\n  // Kick off the rough transcript the moment a recording is ready to review,\n  // so it's usually done by the time the user has looked at the playback\n  // controls. Reset on any state other than 'stopped' (re-record, discard)\n  // so a stale transcript from a previous take never lingers.\n  useEffect(() => {\n    if (recorder.state !== 'stopped' || !recorder.blob) {\n      setTranscript(null)\n      setIsTranscribing(false)\n      return\n    }\n    if (!transcribe) return\n    let cancelled = false\n    setIsTranscribing(true)\n    transcribe(recorder.blob)\n      .then((text) => {\n        if (!cancelled) setTranscript(text)\n      })\n      .catch(() => {\n        // Best-effort: a failed rough transcript just means the review UI\n        // shows nothing extra \u2014 the real transcript still arrives later.\n      })\n      .finally(() => {\n        if (!cancelled) setIsTranscribing(false)\n      })\n    return () => {\n      cancelled = true\n    }\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, [recorder.state, recorder.blob])\n\n  const handleSave = () => {\n    if (!recorder.blob) return\n    void onSave(recorder.blob, recorder.mimeType)\n  }\n\n  return (\n    <div className=\"flex h-full flex-col items-center justify-center gap-6 p-8\">\n      {recorder.state === 'idle' && (\n        <>\n          <Button\n            type=\"button\"\n            size=\"lg\"\n            className=\"h-16 w-16 rounded-full p-0\"\n            onClick={() => void recorder.start()}\n            data-testid=\"voice-note-record-button\"\n          >\n            <Mic className=\"h-6 w-6\" />\n          </Button>\n          <p className=\"text-sm text-muted-foreground\">Press to start recording</p>\n        </>\n      )}\n\n      {(recorder.state === 'recording' || recorder.state === 'paused') && (\n        <>\n          <MicWaveformIndicator\n            level={recorder.level}\n            elapsedMs={recorder.elapsedMs}\n            paused={recorder.state === 'paused'}\n          />\n          <div className=\"flex items-center gap-3\">\n            {recorder.state === 'recording' ? (\n              <Button\n                type=\"button\"\n                variant=\"outline\"\n                onClick={recorder.pause}\n                data-testid=\"voice-note-pause-button\"\n              >\n                <Pause className=\"mr-1.5 h-4 w-4\" />\n                Pause\n              </Button>\n            ) : (\n              <Button\n                type=\"button\"\n                variant=\"outline\"\n                onClick={recorder.resume}\n                data-testid=\"voice-note-resume-button\"\n              >\n                <Play className=\"mr-1.5 h-4 w-4\" />\n                Resume\n              </Button>\n            )}\n            <Button type=\"button\" onClick={recorder.stop} data-testid=\"voice-note-stop-button\">\n              <Square className=\"mr-1.5 h-3.5 w-3.5 fill-current\" />\n              Stop\n            </Button>\n          </div>\n        </>\n      )}\n\n      {recorder.state === 'stopped' && recorder.blob && (\n        <>\n          <div className=\"w-full max-w-md\">\n            <AudioViewer blob={recorder.blob} title={title} />\n          </div>\n          {(isTranscribing || transcript) && (\n            <div\n              className=\"w-full max-w-md rounded-md border border-border bg-muted/30 p-3 text-sm text-muted-foreground\"\n              data-testid=\"voice-note-rough-transcript\"\n            >\n              {isTranscribing ? (\n                <span className=\"flex items-center gap-1.5\">\n                  <Loader2 className=\"h-3.5 w-3.5 animate-spin\" />\n                  Transcribing\u2026\n                </span>\n              ) : (\n                <>\n                  <p className=\"mb-1 text-xs font-semibold uppercase tracking-wide\">\n                    Rough transcript\n                  </p>\n                  <p>{transcript}</p>\n                </>\n              )}\n            </div>\n          )}\n          <div className=\"flex items-center gap-3\">\n            <Button\n              type=\"button\"\n              variant=\"outline\"\n              onClick={onDiscard}\n              disabled={isSaving}\n              data-testid=\"voice-note-discard-button\"\n            >\n              <Trash2 className=\"mr-1.5 h-4 w-4\" />\n              Discard\n            </Button>\n            <Button\n              type=\"button\"\n              variant=\"outline\"\n              onClick={recorder.reset}\n              disabled={isSaving}\n              data-testid=\"voice-note-record-again-button\"\n            >\n              <RotateCcw className=\"mr-1.5 h-4 w-4\" />\n              Record again\n            </Button>\n            <Button\n              type=\"button\"\n              onClick={handleSave}\n              disabled={isSaving}\n              data-testid=\"voice-note-save-button\"\n            >\n              {isSaving ? (\n                <Loader2 className=\"mr-1.5 h-4 w-4 animate-spin\" />\n              ) : (\n                <Check className=\"mr-1.5 h-4 w-4\" />\n              )}\n              {isSaving ? 'Saving\u2026' : 'Save'}\n            </Button>\n          </div>\n        </>\n      )}\n    </div>\n  )\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/documents/audio-segmenter.js

@@ -0,0 +1,63 @@
+const DEFAULT_SEGMENTER_CONFIG = {
+  voiceThreshold: 0.3,
+  silenceMs: 700,
+  maxMs: 1e4,
+  minVoiceMs: 600
+};
+const INITIAL_SEGMENTER_STATE = { phase: "idle" };
+function levelFromRms(rms) {
+  return Math.sqrt(Math.min(1, rms * 8));
+}
+function end(state, at, reason, config) {
+  return {
+    type: "end",
+    at,
+    startedAt: state.startedAt,
+    voiceMs: state.voiceMs,
+    keep: state.voiceMs >= config.minVoiceMs,
+    reason
+  };
+}
+function stepSegmenter(state, level, t, config = DEFAULT_SEGMENTER_CONFIG) {
+  const voice = level >= config.voiceThreshold;
+  if (state.phase === "idle") {
+    if (!voice) return { state, events: [] };
+    return {
+      state: { phase: "voice", startedAt: t, lastVoiceAt: t, lastSampleAt: t, voiceMs: 0 },
+      events: [{ type: "start", at: t }]
+    };
+  }
+  const dt = Math.max(0, t - state.lastSampleAt);
+  const next = {
+    ...state,
+    lastSampleAt: t,
+    lastVoiceAt: voice ? t : state.lastVoiceAt,
+    voiceMs: state.voiceMs + (voice ? dt : 0)
+  };
+  if (t - next.startedAt >= config.maxMs) {
+    const events = [end(next, t, "max", config)];
+    if (!voice) return { state: { phase: "idle" }, events };
+    events.push({ type: "start", at: t });
+    return {
+      state: { phase: "voice", startedAt: t, lastVoiceAt: t, lastSampleAt: t, voiceMs: 0 },
+      events
+    };
+  }
+  const silence = config.silenceMs + (next.voiceMs < config.minVoiceMs ? config.holdShortMs ?? 0 : 0);
+  if (!voice && t - next.lastVoiceAt >= silence) {
+    return { state: { phase: "idle" }, events: [end(next, t, "silence", config)] };
+  }
+  return { state: next, events: [] };
+}
+function flushSegmenter(state, t, config = DEFAULT_SEGMENTER_CONFIG) {
+  if (state.phase === "idle") return { state, events: [] };
+  return { state: { phase: "idle" }, events: [end(state, t, "flush", config)] };
+}
+export {
+  DEFAULT_SEGMENTER_CONFIG,
+  INITIAL_SEGMENTER_STATE,
+  flushSegmenter,
+  levelFromRms,
+  stepSegmenter
+};
+//# sourceMappingURL=audio-segmenter.js.map

package/dist/documents/audio-segmenter.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/documents/audio-segmenter.ts"],
+  "sourcesContent": ["/**\n * audio-segmenter \u2014 the voice-activity state machine behind `useAudioRecorder`'s\n * segmenting mode. Pure: fed one (level, time) sample per meter tick, it says\n * when a speech segment starts and when it ends, and whether the segment held\n * enough voice to be worth keeping. The hook owns the MediaRecorders; this\n * owns only the decisions, so it is unit-testable with synthetic levels.\n *\n * A segment starts on the first sample at or above `voiceThreshold`, ends after\n * `silenceMs` without voice or at `maxMs` (a cut while still speaking starts the\n * next segment on the same sample), and is dropped when it held less than\n * `minVoiceMs` of voice \u2014 a cough, a click, a door.\n */\n\nexport interface SegmenterConfig {\n  /** Meter level (0-1, as `useAudioRecorder` reports it) that counts as voice. */\n  voiceThreshold: number\n  /** Silence that ends a segment. */\n  silenceMs: number\n  /** Longest segment; a longer utterance is cut into several. */\n  maxMs: number\n  /** Segments with less voice than this are dropped. */\n  minVoiceMs: number\n  /**\n   * Extra silence a segment that is still too short waits for more voice before it ends (0 = none).\n   * A short word and a short phrase a pause apart \u2014 \"Perfect.\" \u2026 \"Thank you both.\" \u2014 then make one\n   * segment instead of two dropped ones.\n   */\n  holdShortMs?: number\n}\n\nexport const DEFAULT_SEGMENTER_CONFIG: SegmenterConfig = {\n  voiceThreshold: 0.3,\n  silenceMs: 700,\n  maxMs: 10_000,\n  minVoiceMs: 600,\n}\n\nexport type SegmenterState =\n  | { phase: 'idle' }\n  | {\n      phase: 'voice'\n      /** When the segment started (the clock of the samples). */\n      startedAt: number\n      /** The last sample that carried voice. */\n      lastVoiceAt: number\n      /** The previous sample, to integrate voice time between samples. */\n      lastSampleAt: number\n      /** Voice accumulated so far. */\n      voiceMs: number\n    }\n\nexport type SegmenterEvent =\n  | { type: 'start'; at: number }\n  | {\n      type: 'end'\n      at: number\n      startedAt: number\n      voiceMs: number\n      /** False when the segment held too little voice: discard it. */\n      keep: boolean\n      reason: 'silence' | 'max' | 'flush'\n    }\n\nexport const INITIAL_SEGMENTER_STATE: SegmenterState = { phase: 'idle' }\n\n/**\n * The meter level (0-1) of an RMS amplitude, as the segmenter's thresholds expect it. Normal\n * speech RMS is tiny (a laptop mic at conversational distance rarely exceeds ~0.1), so it is\n * boosted, then a sqrt (perceptual) curve makes quiet-to-moderate speech clearly visible.\n */\nexport function levelFromRms(rms: number): number {\n  return Math.sqrt(Math.min(1, rms * 8))\n}\n\nfunction end(\n  state: Extract<SegmenterState, { phase: 'voice' }>,\n  at: number,\n  reason: 'silence' | 'max' | 'flush',\n  config: SegmenterConfig\n): SegmenterEvent {\n  return {\n    type: 'end',\n    at,\n    startedAt: state.startedAt,\n    voiceMs: state.voiceMs,\n    keep: state.voiceMs >= config.minVoiceMs,\n    reason,\n  }\n}\n\n/** Feed one meter sample. Returns the next state and what happened (0-2 events). */\nexport function stepSegmenter(\n  state: SegmenterState,\n  level: number,\n  t: number,\n  config: SegmenterConfig = DEFAULT_SEGMENTER_CONFIG\n): { state: SegmenterState; events: SegmenterEvent[] } {\n  const voice = level >= config.voiceThreshold\n  if (state.phase === 'idle') {\n    if (!voice) return { state, events: [] }\n    return {\n      state: { phase: 'voice', startedAt: t, lastVoiceAt: t, lastSampleAt: t, voiceMs: 0 },\n      events: [{ type: 'start', at: t }],\n    }\n  }\n  const dt = Math.max(0, t - state.lastSampleAt)\n  const next = {\n    ...state,\n    lastSampleAt: t,\n    lastVoiceAt: voice ? t : state.lastVoiceAt,\n    voiceMs: state.voiceMs + (voice ? dt : 0),\n  }\n  if (t - next.startedAt >= config.maxMs) {\n    const events: SegmenterEvent[] = [end(next, t, 'max', config)]\n    if (!voice) return { state: { phase: 'idle' }, events }\n    events.push({ type: 'start', at: t })\n    return {\n      state: { phase: 'voice', startedAt: t, lastVoiceAt: t, lastSampleAt: t, voiceMs: 0 },\n      events,\n    }\n  }\n  const silence =\n    config.silenceMs + (next.voiceMs < config.minVoiceMs ? (config.holdShortMs ?? 0) : 0)\n  if (!voice && t - next.lastVoiceAt >= silence) {\n    return { state: { phase: 'idle' }, events: [end(next, t, 'silence', config)] }\n  }\n  return { state: next, events: [] }\n}\n\n/** Close the open segment, if any (recording stopped). */\nexport function flushSegmenter(\n  state: SegmenterState,\n  t: number,\n  config: SegmenterConfig = DEFAULT_SEGMENTER_CONFIG\n): { state: SegmenterState; events: SegmenterEvent[] } {\n  if (state.phase === 'idle') return { state, events: [] }\n  return { state: { phase: 'idle' }, events: [end(state, t, 'flush', config)] }\n}\n"],
+  "mappings": "AA8BO,MAAM,2BAA4C;AAAA,EACvD,gBAAgB;AAAA,EAChB,WAAW;AAAA,EACX,OAAO;AAAA,EACP,YAAY;AACd;AA4BO,MAAM,0BAA0C,EAAE,OAAO,OAAO;AAOhE,SAAS,aAAa,KAAqB;AAChD,SAAO,KAAK,KAAK,KAAK,IAAI,GAAG,MAAM,CAAC,CAAC;AACvC;AAEA,SAAS,IACP,OACA,IACA,QACA,QACgB;AAChB,SAAO;AAAA,IACL,MAAM;AAAA,IACN;AAAA,IACA,WAAW,MAAM;AAAA,IACjB,SAAS,MAAM;AAAA,IACf,MAAM,MAAM,WAAW,OAAO;AAAA,IAC9B;AAAA,EACF;AACF;AAGO,SAAS,cACd,OACA,OACA,GACA,SAA0B,0BAC2B;AACrD,QAAM,QAAQ,SAAS,OAAO;AAC9B,MAAI,MAAM,UAAU,QAAQ;AAC1B,QAAI,CAAC,MAAO,QAAO,EAAE,OAAO,QAAQ,CAAC,EAAE;AACvC,WAAO;AAAA,MACL,OAAO,EAAE,OAAO,SAAS,WAAW,GAAG,aAAa,GAAG,cAAc,GAAG,SAAS,EAAE;AAAA,MACnF,QAAQ,CAAC,EAAE,MAAM,SAAS,IAAI,EAAE,CAAC;AAAA,IACnC;AAAA,EACF;AACA,QAAM,KAAK,KAAK,IAAI,GAAG,IAAI,MAAM,YAAY;AAC7C,QAAM,OAAO;AAAA,IACX,GAAG;AAAA,IACH,cAAc;AAAA,IACd,aAAa,QAAQ,IAAI,MAAM;AAAA,IAC/B,SAAS,MAAM,WAAW,QAAQ,KAAK;AAAA,EACzC;AACA,MAAI,IAAI,KAAK,aAAa,OAAO,OAAO;AACtC,UAAM,SAA2B,CAAC,IAAI,MAAM,GAAG,OAAO,MAAM,CAAC;AAC7D,QAAI,CAAC,MAAO,QAAO,EAAE,OAAO,EAAE,OAAO,OAAO,GAAG,OAAO;AACtD,WAAO,KAAK,EAAE,MAAM,SAAS,IAAI,EAAE,CAAC;AACpC,WAAO;AAAA,MACL,OAAO,EAAE,OAAO,SAAS,WAAW,GAAG,aAAa,GAAG,cAAc,GAAG,SAAS,EAAE;AAAA,MACnF;AAAA,IACF;AAAA,EACF;AACA,QAAM,UACJ,OAAO,aAAa,KAAK,UAAU,OAAO,aAAc,OAAO,eAAe,IAAK;AACrF,MAAI,CAAC,SAAS,IAAI,KAAK,eAAe,SAAS;AAC7C,WAAO,EAAE,OAAO,EAAE,OAAO,OAAO,GAAG,QAAQ,CAAC,IAAI,MAAM,GAAG,WAAW,MAAM,CAAC,EAAE;AAAA,EAC/E;AACA,SAAO,EAAE,OAAO,MAAM,QAAQ,CAAC,EAAE;AACnC;AAGO,SAAS,eACd,OACA,GACA,SAA0B,0BAC2B;AACrD,MAAI,MAAM,UAAU,OAAQ,QAAO,EAAE,OAAO,QAAQ,CAAC,EAAE;AACvD,SAAO,EAAE,OAAO,EAAE,OAAO,OAAO,GAAG,QAAQ,CAAC,IAAI,OAAO,GAAG,SAAS,MAAM,CAAC,EAAE;AAC9E;",
+  "names": []
+}

package/dist/documents/capture-frame.js

@@ -0,0 +1,21 @@
+function captureFrameAsBlob(video, mimeType = "image/png") {
+  return new Promise((resolve, reject) => {
+    const canvas = document.createElement("canvas");
+    canvas.width = video.videoWidth;
+    canvas.height = video.videoHeight;
+    const ctx = canvas.getContext("2d");
+    if (!ctx) {
+      reject(new Error("Canvas 2D context is not available"));
+      return;
+    }
+    ctx.drawImage(video, 0, 0, canvas.width, canvas.height);
+    canvas.toBlob((blob) => {
+      if (blob) resolve(blob);
+      else reject(new Error("Failed to capture the photo"));
+    }, mimeType);
+  });
+}
+export {
+  captureFrameAsBlob
+};
+//# sourceMappingURL=capture-frame.js.map

package/dist/documents/capture-frame.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/documents/capture-frame.ts"],
+  "sourcesContent": ["/**\n * Captures the current frame of a live `<video>` element (bound to a camera\n * `MediaStream`, e.g. via useCameraStream) as an image Blob \u2014 the shutter\n * action for photo capture. Draws to an off-screen canvas rather than reading\n * pixels any other way, since `HTMLCanvasElement.toBlob` is the one\n * cross-browser path from \"a decoded video frame\" to \"an encoded image file\".\n */\nexport function captureFrameAsBlob(video: HTMLVideoElement, mimeType = 'image/png'): Promise<Blob> {\n  return new Promise((resolve, reject) => {\n    const canvas = document.createElement('canvas')\n    canvas.width = video.videoWidth\n    canvas.height = video.videoHeight\n    const ctx = canvas.getContext('2d')\n    if (!ctx) {\n      reject(new Error('Canvas 2D context is not available'))\n      return\n    }\n    ctx.drawImage(video, 0, 0, canvas.width, canvas.height)\n    canvas.toBlob((blob) => {\n      if (blob) resolve(blob)\n      else reject(new Error('Failed to capture the photo'))\n    }, mimeType)\n  })\n}\n"],
+  "mappings": "AAOO,SAAS,mBAAmB,OAAyB,WAAW,aAA4B;AACjG,SAAO,IAAI,QAAQ,CAAC,SAAS,WAAW;AACtC,UAAM,SAAS,SAAS,cAAc,QAAQ;AAC9C,WAAO,QAAQ,MAAM;AACrB,WAAO,SAAS,MAAM;AACtB,UAAM,MAAM,OAAO,WAAW,IAAI;AAClC,QAAI,CAAC,KAAK;AACR,aAAO,IAAI,MAAM,oCAAoC,CAAC;AACtD;AAAA,IACF;AACA,QAAI,UAAU,OAAO,GAAG,GAAG,OAAO,OAAO,OAAO,MAAM;AACtD,WAAO,OAAO,CAAC,SAAS;AACtB,UAAI,KAAM,SAAQ,IAAI;AAAA,UACjB,QAAO,IAAI,MAAM,6BAA6B,CAAC;AAAA,IACtD,GAAG,QAAQ;AAAA,EACb,CAAC;AACH;",
+  "names": []
+}

package/dist/documents/chunked-recorder.js

@@ -0,0 +1,190 @@
+const AUDIO_MIME_PREFERENCE = [
+  "audio/webm;codecs=opus",
+  "audio/ogg;codecs=opus",
+  "audio/mp4;codecs=mp4a.40.2",
+  "audio/mp4"
+];
+const VIDEO_MIME_PREFERENCE = [
+  "video/webm;codecs=av01,opus",
+  "video/webm;codecs=av1,opus",
+  "video/webm;codecs=vp9,opus",
+  "video/webm;codecs=vp8,opus",
+  "video/webm",
+  "video/mp4"
+];
+function pickRecorderMimeType(kind, isTypeSupported = (t) => typeof MediaRecorder !== "undefined" && MediaRecorder.isTypeSupported(t)) {
+  const list = kind === "audio" ? AUDIO_MIME_PREFERENCE : VIDEO_MIME_PREFERENCE;
+  for (const type of list) {
+    try {
+      if (isTypeSupported(type)) return type;
+    } catch {
+    }
+  }
+  return list[list.length - 1];
+}
+function createChunkedRecorder(options) {
+  const now = options.now ?? (() => Date.now());
+  const mode = options.mode ?? "restart";
+  let running = false;
+  let index = 0;
+  let timer = null;
+  let tail = Promise.resolve();
+  const recorderInit = () => ({
+    mimeType: options.mimeType,
+    ...options.audioBitsPerSecond ? { audioBitsPerSecond: options.audioBitsPerSecond } : {},
+    ...options.videoBitsPerSecond ? { videoBitsPerSecond: options.videoBitsPerSecond } : {}
+  });
+  const fail = (err) => {
+    running = false;
+    if (timer !== null) clearTimeout(timer);
+    timer = null;
+    options.onError?.(err);
+  };
+  const beginPart = () => {
+    let recorder;
+    try {
+      recorder = new MediaRecorder(options.stream, recorderInit());
+    } catch (err) {
+      fail(err);
+      return void 0;
+    }
+    const chunks = [];
+    const part = { recorder, startedAt: now(), chunks };
+    recorder.ondataavailable = (e) => {
+      if (e.data.size > 0) chunks.push(e.data);
+    };
+    recorder.onstart = () => {
+      part.startedAt = now();
+    };
+    try {
+      recorder.start();
+    } catch (err) {
+      fail(err);
+      return void 0;
+    }
+    return part;
+  };
+  const endPart = (part) => new Promise((resolve) => {
+    const { recorder, startedAt, chunks } = part;
+    const durationMs = Math.max(0, now() - startedAt);
+    const partIndex = index++;
+    const emit = () => {
+      if (chunks.length) {
+        const type = recorder.mimeType || options.mimeType;
+        options.onChunk({
+          blob: new Blob(chunks, { type }),
+          mimeType: type,
+          index: partIndex,
+          startedAt,
+          durationMs,
+          standalone: true
+        });
+      }
+      resolve();
+    };
+    if (recorder.state === "inactive") {
+      emit();
+      return;
+    }
+    recorder.onstop = emit;
+    recorder.stop();
+  });
+  let open;
+  const rotate = () => {
+    if (!running || !open) return;
+    const finished = open;
+    open = beginPart();
+    tail = tail.then(() => endPart(finished));
+    if (running) timer = setTimeout(rotate, options.chunkMs);
+  };
+  let sliceStartedAt = 0;
+  let sliceRecorder = null;
+  let stopResolve = null;
+  const startTimeslice = () => {
+    let recorder;
+    try {
+      recorder = new MediaRecorder(options.stream, recorderInit());
+    } catch (err) {
+      fail(err);
+      return;
+    }
+    sliceRecorder = recorder;
+    sliceStartedAt = now();
+    recorder.ondataavailable = (e) => {
+      const at = now();
+      const startedAt = sliceStartedAt;
+      sliceStartedAt = at;
+      if (!e.data.size) return;
+      const type = recorder.mimeType || options.mimeType;
+      const partIndex = index++;
+      options.onChunk({
+        blob: e.data,
+        mimeType: type,
+        index: partIndex,
+        startedAt,
+        durationMs: Math.max(0, at - startedAt),
+        standalone: partIndex === 0
+      });
+    };
+    recorder.onstop = () => {
+      stopResolve?.();
+      stopResolve = null;
+    };
+    try {
+      recorder.start();
+    } catch (err) {
+      sliceRecorder = null;
+      fail(err);
+      return;
+    }
+    timer = setInterval(() => {
+      if (recorder.state === "recording") recorder.requestData();
+    }, options.chunkMs);
+  };
+  return {
+    get running() {
+      return running;
+    },
+    start() {
+      if (running) return;
+      running = true;
+      index = 0;
+      if (mode === "timeslice") {
+        startTimeslice();
+        return;
+      }
+      open = beginPart();
+      if (running) timer = setTimeout(rotate, options.chunkMs);
+    },
+    stop() {
+      if (!running && !open && !sliceRecorder) return tail;
+      running = false;
+      if (timer !== null) {
+        clearTimeout(timer);
+        clearInterval(timer);
+      }
+      timer = null;
+      if (mode === "timeslice") {
+        const recorder = sliceRecorder;
+        sliceRecorder = null;
+        if (!recorder || recorder.state === "inactive") return tail;
+        tail = new Promise((resolve) => {
+          stopResolve = resolve;
+          recorder.stop();
+        });
+        return tail;
+      }
+      const finished = open;
+      open = void 0;
+      if (finished) tail = tail.then(() => endPart(finished));
+      return tail;
+    }
+  };
+}
+export {
+  AUDIO_MIME_PREFERENCE,
+  VIDEO_MIME_PREFERENCE,
+  createChunkedRecorder,
+  pickRecorderMimeType
+};
+//# sourceMappingURL=chunked-recorder.js.map

package/dist/documents/chunked-recorder.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/documents/chunked-recorder.ts"],
+  "sourcesContent": ["/**\n * Chunked MediaRecorder engine \u2014 records a stream in fixed-length parts for a\n * long-running recording that is uploaded as it goes (call recording).\n *\n * Two ways to cut the parts:\n *   - `restart` (default): every `chunkMs` the recorder is stopped and a new\n *     one started on the same stream, so EVERY part is a standalone file with\n *     its own container header (playable, decodable and transcribable on its\n *     own). The gap between two parts is the few ms between stop and start.\n *   - `timeslice`: one recorder, `requestData()` every `chunkMs` \u2014 the parts\n *     are consecutive byte ranges of ONE file (only the first carries the\n *     header), so concatenating them in order gives the whole recording with\n *     no gap. Used where the parts are only ever played back as one file.\n *\n * Framework-free (no React) so it can be driven by `useAudioRecorder`'s\n * chunk mode and directly by a host that records a composed stream.\n */\n\n/** One part of a chunked recording. */\nexport interface RecordedChunk {\n  blob: Blob\n  mimeType: string\n  /** 0, 1, 2\u2026 in recording order (per recorder instance). */\n  index: number\n  /** Wall-clock start of the part, ms since epoch. */\n  startedAt: number\n  durationMs: number\n  /** `restart`: always true. `timeslice`: only the first part starts a file. */\n  standalone: boolean\n}\n\nexport interface ChunkedRecorderOptions {\n  stream: MediaStream\n  /** MediaRecorder MIME type (pick it with {@link pickRecorderMimeType}). */\n  mimeType: string\n  /** Part length, ms (~30 s for call recording). */\n  chunkMs: number\n  mode?: 'restart' | 'timeslice'\n  audioBitsPerSecond?: number\n  videoBitsPerSecond?: number\n  onChunk(chunk: RecordedChunk): void\n  /** Called when a MediaRecorder fails; the recorder stops. */\n  onError?(error: unknown): void\n  /** Wall clock (tests). */\n  now?: () => number\n}\n\nexport interface ChunkedRecorder {\n  readonly running: boolean\n  start(): void\n  /** Stop and flush the tail part; resolves once it was handed to `onChunk`. */\n  stop(): Promise<void>\n}\n\n/** Audio MIME types in preference order: Opus/WebM, then AAC/MP4 (Safari). */\nexport const AUDIO_MIME_PREFERENCE = [\n  'audio/webm;codecs=opus',\n  'audio/ogg;codecs=opus',\n  'audio/mp4;codecs=mp4a.40.2',\n  'audio/mp4',\n] as const\n\n/** Video MIME types in preference order: AV1, VP9, VP8 (with Opus), then MP4. */\nexport const VIDEO_MIME_PREFERENCE = [\n  'video/webm;codecs=av01,opus',\n  'video/webm;codecs=av1,opus',\n  'video/webm;codecs=vp9,opus',\n  'video/webm;codecs=vp8,opus',\n  'video/webm',\n  'video/mp4',\n] as const\n\n/**\n * The first MIME type `isTypeSupported` accepts, or the last of the list (the\n * broadest container) when it accepts none.\n */\nexport function pickRecorderMimeType(\n  kind: 'audio' | 'video',\n  isTypeSupported: (type: string) => boolean = (t) =>\n    typeof MediaRecorder !== 'undefined' && MediaRecorder.isTypeSupported(t)\n): string {\n  const list: readonly string[] = kind === 'audio' ? AUDIO_MIME_PREFERENCE : VIDEO_MIME_PREFERENCE\n  for (const type of list) {\n    try {\n      if (isTypeSupported(type)) return type\n    } catch {\n      // A browser that throws on an unknown type: try the next one.\n    }\n  }\n  return list[list.length - 1]\n}\n\nexport function createChunkedRecorder(options: ChunkedRecorderOptions): ChunkedRecorder {\n  const now = options.now ?? (() => Date.now())\n  const mode = options.mode ?? 'restart'\n  let running = false\n  let index = 0\n  let timer: ReturnType<typeof setInterval> | ReturnType<typeof setTimeout> | null = null\n  let tail: Promise<void> = Promise.resolve()\n\n  const recorderInit = (): MediaRecorderOptions => ({\n    mimeType: options.mimeType,\n    ...(options.audioBitsPerSecond ? { audioBitsPerSecond: options.audioBitsPerSecond } : {}),\n    ...(options.videoBitsPerSecond ? { videoBitsPerSecond: options.videoBitsPerSecond } : {}),\n  })\n\n  const fail = (err: unknown) => {\n    running = false\n    if (timer !== null) clearTimeout(timer as ReturnType<typeof setTimeout>)\n    timer = null\n    options.onError?.(err)\n  }\n\n  /** `restart`: one recorder per part; resolves when that part was emitted. */\n  const beginPart = ():\n    { recorder: MediaRecorder; startedAt: number; chunks: Blob[] } | undefined => {\n    let recorder: MediaRecorder\n    try {\n      recorder = new MediaRecorder(options.stream, recorderInit())\n    } catch (err) {\n      fail(err)\n      return undefined\n    }\n    const chunks: Blob[] = []\n    const part = { recorder, startedAt: now(), chunks }\n    recorder.ondataavailable = (e) => {\n      if (e.data.size > 0) chunks.push(e.data)\n    }\n    // Capture begins at the recorder's `start` event, which can come a second or more after\n    // start() while the encoder spins up. Time the part from there: a part timed from start()\n    // carries that latency as phantom silence at its start, and a transcript cut there splits a\n    // sentence spoken across the part boundary.\n    recorder.onstart = () => {\n      part.startedAt = now()\n    }\n    try {\n      recorder.start()\n    } catch (err) {\n      fail(err)\n      return undefined\n    }\n    return part\n  }\n\n  const endPart = (part: { recorder: MediaRecorder; startedAt: number; chunks: Blob[] }) =>\n    new Promise<void>((resolve) => {\n      const { recorder, startedAt, chunks } = part\n      const durationMs = Math.max(0, now() - startedAt)\n      const partIndex = index++\n      const emit = () => {\n        if (chunks.length) {\n          const type = recorder.mimeType || options.mimeType\n          options.onChunk({\n            blob: new Blob(chunks, { type }),\n            mimeType: type,\n            index: partIndex,\n            startedAt,\n            durationMs,\n            standalone: true,\n          })\n        }\n        resolve()\n      }\n      if (recorder.state === 'inactive') {\n        emit()\n        return\n      }\n      recorder.onstop = emit\n      recorder.stop()\n    })\n\n  let open: { recorder: MediaRecorder; startedAt: number; chunks: Blob[] } | undefined\n\n  const rotate = () => {\n    if (!running || !open) return\n    const finished = open\n    // Start the next part before the previous one flushes: no gap but the start latency.\n    open = beginPart()\n    tail = tail.then(() => endPart(finished))\n    if (running) timer = setTimeout(rotate, options.chunkMs)\n  }\n\n  // `timeslice`: one recorder; each dataavailable is a part.\n  let sliceStartedAt = 0\n  let sliceRecorder: MediaRecorder | null = null\n  let stopResolve: (() => void) | null = null\n\n  const startTimeslice = () => {\n    let recorder: MediaRecorder\n    try {\n      recorder = new MediaRecorder(options.stream, recorderInit())\n    } catch (err) {\n      fail(err)\n      return\n    }\n    sliceRecorder = recorder\n    sliceStartedAt = now()\n    recorder.ondataavailable = (e) => {\n      const at = now()\n      const startedAt = sliceStartedAt\n      sliceStartedAt = at\n      if (!e.data.size) return\n      const type = recorder.mimeType || options.mimeType\n      const partIndex = index++\n      options.onChunk({\n        blob: e.data,\n        mimeType: type,\n        index: partIndex,\n        startedAt,\n        durationMs: Math.max(0, at - startedAt),\n        standalone: partIndex === 0,\n      })\n    }\n    recorder.onstop = () => {\n      stopResolve?.()\n      stopResolve = null\n    }\n    try {\n      recorder.start()\n    } catch (err) {\n      sliceRecorder = null\n      fail(err)\n      return\n    }\n    timer = setInterval(() => {\n      if (recorder.state === 'recording') recorder.requestData()\n    }, options.chunkMs)\n  }\n\n  return {\n    get running() {\n      return running\n    },\n    start() {\n      if (running) return\n      running = true\n      index = 0\n      if (mode === 'timeslice') {\n        startTimeslice()\n        return\n      }\n      open = beginPart()\n      if (running) timer = setTimeout(rotate, options.chunkMs)\n    },\n    stop() {\n      if (!running && !open && !sliceRecorder) return tail\n      running = false\n      if (timer !== null) {\n        clearTimeout(timer as ReturnType<typeof setTimeout>)\n        clearInterval(timer as ReturnType<typeof setInterval>)\n      }\n      timer = null\n      if (mode === 'timeslice') {\n        const recorder = sliceRecorder\n        sliceRecorder = null\n        if (!recorder || recorder.state === 'inactive') return tail\n        tail = new Promise<void>((resolve) => {\n          stopResolve = resolve\n          // stop() fires a final dataavailable (the tail), then stop.\n          recorder.stop()\n        })\n        return tail\n      }\n      const finished = open\n      open = undefined\n      if (finished) tail = tail.then(() => endPart(finished))\n      return tail\n    },\n  }\n}\n"],
+  "mappings": "AAuDO,MAAM,wBAAwB;AAAA,EACnC;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AAGO,MAAM,wBAAwB;AAAA,EACnC;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AAMO,SAAS,qBACd,MACA,kBAA6C,CAAC,MAC5C,OAAO,kBAAkB,eAAe,cAAc,gBAAgB,CAAC,GACjE;AACR,QAAM,OAA0B,SAAS,UAAU,wBAAwB;AAC3E,aAAW,QAAQ,MAAM;AACvB,QAAI;AACF,UAAI,gBAAgB,IAAI,EAAG,QAAO;AAAA,IACpC,QAAQ;AAAA,IAER;AAAA,EACF;AACA,SAAO,KAAK,KAAK,SAAS,CAAC;AAC7B;AAEO,SAAS,sBAAsB,SAAkD;AACtF,QAAM,MAAM,QAAQ,QAAQ,MAAM,KAAK,IAAI;AAC3C,QAAM,OAAO,QAAQ,QAAQ;AAC7B,MAAI,UAAU;AACd,MAAI,QAAQ;AACZ,MAAI,QAA+E;AACnF,MAAI,OAAsB,QAAQ,QAAQ;AAE1C,QAAM,eAAe,OAA6B;AAAA,IAChD,UAAU,QAAQ;AAAA,IAClB,GAAI,QAAQ,qBAAqB,EAAE,oBAAoB,QAAQ,mBAAmB,IAAI,CAAC;AAAA,IACvF,GAAI,QAAQ,qBAAqB,EAAE,oBAAoB,QAAQ,mBAAmB,IAAI,CAAC;AAAA,EACzF;AAEA,QAAM,OAAO,CAAC,QAAiB;AAC7B,cAAU;AACV,QAAI,UAAU,KAAM,cAAa,KAAsC;AACvE,YAAQ;AACR,YAAQ,UAAU,GAAG;AAAA,EACvB;AAGA,QAAM,YAAY,MAC8D;AAC9E,QAAI;AACJ,QAAI;AACF,iBAAW,IAAI,cAAc,QAAQ,QAAQ,aAAa,CAAC;AAAA,IAC7D,SAAS,KAAK;AACZ,WAAK,GAAG;AACR,aAAO;AAAA,IACT;AACA,UAAM,SAAiB,CAAC;AACxB,UAAM,OAAO,EAAE,UAAU,WAAW,IAAI,GAAG,OAAO;AAClD,aAAS,kBAAkB,CAAC,MAAM;AAChC,UAAI,EAAE,KAAK,OAAO,EAAG,QAAO,KAAK,EAAE,IAAI;AAAA,IACzC;AAKA,aAAS,UAAU,MAAM;AACvB,WAAK,YAAY,IAAI;AAAA,IACvB;AACA,QAAI;AACF,eAAS,MAAM;AAAA,IACjB,SAAS,KAAK;AACZ,WAAK,GAAG;AACR,aAAO;AAAA,IACT;AACA,WAAO;AAAA,EACT;AAEA,QAAM,UAAU,CAAC,SACf,IAAI,QAAc,CAAC,YAAY;AAC7B,UAAM,EAAE,UAAU,WAAW,OAAO,IAAI;AACxC,UAAM,aAAa,KAAK,IAAI,GAAG,IAAI,IAAI,SAAS;AAChD,UAAM,YAAY;AAClB,UAAM,OAAO,MAAM;AACjB,UAAI,OAAO,QAAQ;AACjB,cAAM,OAAO,SAAS,YAAY,QAAQ;AAC1C,gBAAQ,QAAQ;AAAA,UACd,MAAM,IAAI,KAAK,QAAQ,EAAE,KAAK,CAAC;AAAA,UAC/B,UAAU;AAAA,UACV,OAAO;AAAA,UACP;AAAA,UACA;AAAA,UACA,YAAY;AAAA,QACd,CAAC;AAAA,MACH;AACA,cAAQ;AAAA,IACV;AACA,QAAI,SAAS,UAAU,YAAY;AACjC,WAAK;AACL;AAAA,IACF;AACA,aAAS,SAAS;AAClB,aAAS,KAAK;AAAA,EAChB,CAAC;AAEH,MAAI;AAEJ,QAAM,SAAS,MAAM;AACnB,QAAI,CAAC,WAAW,CAAC,KAAM;AACvB,UAAM,WAAW;AAEjB,WAAO,UAAU;AACjB,WAAO,KAAK,KAAK,MAAM,QAAQ,QAAQ,CAAC;AACxC,QAAI,QAAS,SAAQ,WAAW,QAAQ,QAAQ,OAAO;AAAA,EACzD;AAGA,MAAI,iBAAiB;AACrB,MAAI,gBAAsC;AAC1C,MAAI,cAAmC;AAEvC,QAAM,iBAAiB,MAAM;AAC3B,QAAI;AACJ,QAAI;AACF,iBAAW,IAAI,cAAc,QAAQ,QAAQ,aAAa,CAAC;AAAA,IAC7D,SAAS,KAAK;AACZ,WAAK,GAAG;AACR;AAAA,IACF;AACA,oBAAgB;AAChB,qBAAiB,IAAI;AACrB,aAAS,kBAAkB,CAAC,MAAM;AAChC,YAAM,KAAK,IAAI;AACf,YAAM,YAAY;AAClB,uBAAiB;AACjB,UAAI,CAAC,EAAE,KAAK,KAAM;AAClB,YAAM,OAAO,SAAS,YAAY,QAAQ;AAC1C,YAAM,YAAY;AAClB,cAAQ,QAAQ;AAAA,QACd,MAAM,EAAE;AAAA,QACR,UAAU;AAAA,QACV,OAAO;AAAA,QACP;AAAA,QACA,YAAY,KAAK,IAAI,GAAG,KAAK,SAAS;AAAA,QACtC,YAAY,cAAc;AAAA,MAC5B,CAAC;AAAA,IACH;AACA,aAAS,SAAS,MAAM;AACtB,oBAAc;AACd,oBAAc;AAAA,IAChB;AACA,QAAI;AACF,eAAS,MAAM;AAAA,IACjB,SAAS,KAAK;AACZ,sBAAgB;AAChB,WAAK,GAAG;AACR;AAAA,IACF;AACA,YAAQ,YAAY,MAAM;AACxB,UAAI,SAAS,UAAU,YAAa,UAAS,YAAY;AAAA,IAC3D,GAAG,QAAQ,OAAO;AAAA,EACpB;AAEA,SAAO;AAAA,IACL,IAAI,UAAU;AACZ,aAAO;AAAA,IACT;AAAA,IACA,QAAQ;AACN,UAAI,QAAS;AACb,gBAAU;AACV,cAAQ;AACR,UAAI,SAAS,aAAa;AACxB,uBAAe;AACf;AAAA,MACF;AACA,aAAO,UAAU;AACjB,UAAI,QAAS,SAAQ,WAAW,QAAQ,QAAQ,OAAO;AAAA,IACzD;AAAA,IACA,OAAO;AACL,UAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,cAAe,QAAO;AAChD,gBAAU;AACV,UAAI,UAAU,MAAM;AAClB,qBAAa,KAAsC;AACnD,sBAAc,KAAuC;AAAA,MACvD;AACA,cAAQ;AACR,UAAI,SAAS,aAAa;AACxB,cAAM,WAAW;AACjB,wBAAgB;AAChB,YAAI,CAAC,YAAY,SAAS,UAAU,WAAY,QAAO;AACvD,eAAO,IAAI,QAAc,CAAC,YAAY;AACpC,wBAAc;AAEd,mBAAS,KAAK;AAAA,QAChB,CAAC;AACD,eAAO;AAAA,MACT;AACA,YAAM,WAAW;AACjB,aAAO;AACP,UAAI,SAAU,QAAO,KAAK,KAAK,MAAM,QAAQ,QAAQ,CAAC;AACtD,aAAO;AAAA,IACT;AAAA,EACF;AACF;",
+  "names": []
+}

package/dist/documents/document-download.js

@@ -0,0 +1,53 @@
+import { getDocumentDate } from "./document-fields.js";
+import { getDocumentTitle } from "../entities/DocumentEntity.js";
+function fallbackFileName(doc) {
+  if (doc.file_name) return doc.file_name;
+  const title = getDocumentTitle(doc, `document-${doc.external_id}`);
+  const extension = doc.file_type || "pdf";
+  const ext = extension.startsWith(".") ? extension : `.${extension}`;
+  return title.toLowerCase().endsWith(ext.toLowerCase()) ? title : `${title}${ext}`;
+}
+const COLUMN_MAPPING = {
+  file_name: {
+    header: "File Name",
+    getValue: (d) => d.file_name || getDocumentTitle(d, `document-${d.external_id}.pdf`)
+  },
+  title: { header: "Title", getValue: (d) => getDocumentTitle(d) },
+  n_pages: { header: "Pages", getValue: (d) => d.n_pages || "" },
+  doc_date: { header: "Document Date", getValue: (d) => getDocumentDate(d) || "" },
+  doc_id: { header: "Document ID", getValue: (d) => d.external_id },
+  status: { header: "Status", getValue: (d) => d.status || "" },
+  uploaded: { header: "Upload Date", getValue: (d) => d.created_at || "" },
+  updated_at: { header: "Last Modified", getValue: (d) => d.updated_at || "" },
+  file_type: { header: "File Type", getValue: (d) => d.file_type || "" },
+  file_size: { header: "File Size", getValue: (d) => d.file_size || "" },
+  shared: { header: "Shared", getValue: (d) => d.shared ? "Yes" : "No" }
+};
+function buildDocumentMetadataRows(documents, selectedColumns) {
+  const columns = selectedColumns || Object.keys(COLUMN_MAPPING);
+  return documents.map((doc) => {
+    const row = {};
+    for (const colId of columns) {
+      const standard = COLUMN_MAPPING[colId];
+      if (standard) {
+        row[standard.header] = standard.getValue(doc);
+      } else if (colId.startsWith("tag-")) {
+        const bare = colId.replace(/^tag-/, "");
+        const doctag = doc.doctags?.find((dt) => dt.tag_ext_id === colId || dt.tag_ext_id === bare);
+        if (doctag) row[colId] = doctag.note || "Yes";
+      }
+    }
+    return row;
+  });
+}
+function archiveName(workspaceName, suffix) {
+  const date = (/* @__PURE__ */ new Date()).toISOString().split("T")[0];
+  const sanitizedName = (workspaceName || "workspace").replace(/[^a-z0-9-_]/gi, "_");
+  return `${date}_${sanitizedName}_${suffix}.zip`;
+}
+export {
+  archiveName,
+  buildDocumentMetadataRows,
+  fallbackFileName
+};
+//# sourceMappingURL=document-download.js.map

package/dist/documents/document-download.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/documents/document-download.ts"],
+  "sourcesContent": ["/**\n * Document download building blocks shared by the documents ZIP (`useDownloadDocuments`) and a\n * workspace export archive: name a file and the archive, and build the metadata rows of\n * `index.csv`. Fetching and saving are the document tools' `fetchDocumentFile` and `downloadBlob`.\n */\n\nimport type { WorkspaceDocument as Doc } from './documents-cache'\nimport { getDocumentDate } from './document-fields'\nimport { getDocumentTitle } from '../entities/DocumentEntity'\n\n/** The ZIP entry name for a document when the server did not name it. */\nexport function fallbackFileName(doc: Doc): string {\n  if (doc.file_name) return doc.file_name\n  const title = getDocumentTitle(doc, `document-${doc.external_id}`)\n  const extension = doc.file_type || 'pdf'\n  const ext = extension.startsWith('.') ? extension : `.${extension}`\n  return title.toLowerCase().endsWith(ext.toLowerCase()) ? title : `${title}${ext}`\n}\n\nconst COLUMN_MAPPING: Record<string, { header: string; getValue: (d: Doc) => string | number }> = {\n  file_name: {\n    header: 'File Name',\n    getValue: (d) => d.file_name || getDocumentTitle(d, `document-${d.external_id}.pdf`),\n  },\n  title: { header: 'Title', getValue: (d) => getDocumentTitle(d) },\n  n_pages: { header: 'Pages', getValue: (d) => d.n_pages || '' },\n  doc_date: { header: 'Document Date', getValue: (d) => getDocumentDate(d) || '' },\n  doc_id: { header: 'Document ID', getValue: (d) => d.external_id },\n  status: { header: 'Status', getValue: (d) => d.status || '' },\n  uploaded: { header: 'Upload Date', getValue: (d) => d.created_at || '' },\n  updated_at: { header: 'Last Modified', getValue: (d) => d.updated_at || '' },\n  file_type: { header: 'File Type', getValue: (d) => d.file_type || '' },\n  file_size: { header: 'File Size', getValue: (d) => d.file_size || '' },\n  shared: { header: 'Shared', getValue: (d) => (d.shared ? 'Yes' : 'No') },\n}\n\n/**\n * One `index.csv` row per document for the chosen columns (`undefined` = every\n * standard column). A `tag-\u2026` column holds that tag's value, or \"Yes\" for a\n * label without one.\n */\nexport function buildDocumentMetadataRows(\n  documents: Doc[],\n  selectedColumns?: string[]\n): Record<string, string | number>[] {\n  const columns = selectedColumns || Object.keys(COLUMN_MAPPING)\n  return documents.map((doc) => {\n    const row: Record<string, string | number> = {}\n    for (const colId of columns) {\n      const standard = COLUMN_MAPPING[colId]\n      if (standard) {\n        row[standard.header] = standard.getValue(doc)\n      } else if (colId.startsWith('tag-')) {\n        // Column ids are tag ext ids; older callers passed them without the prefix.\n        const bare = colId.replace(/^tag-/, '')\n        const doctag = doc.doctags?.find((dt) => dt.tag_ext_id === colId || dt.tag_ext_id === bare)\n        if (doctag) row[colId] = doctag.note || 'Yes'\n      }\n    }\n    return row\n  })\n}\n\n/** `2026-10-15_My_Workspace_<suffix>.zip` */\nexport function archiveName(workspaceName: string | undefined, suffix: string): string {\n  const date = new Date().toISOString().split('T')[0]\n  const sanitizedName = (workspaceName || 'workspace').replace(/[^a-z0-9-_]/gi, '_')\n  return `${date}_${sanitizedName}_${suffix}.zip`\n}\n"],
+  "mappings": "AAOA,SAAS,uBAAuB;AAChC,SAAS,wBAAwB;AAG1B,SAAS,iBAAiB,KAAkB;AACjD,MAAI,IAAI,UAAW,QAAO,IAAI;AAC9B,QAAM,QAAQ,iBAAiB,KAAK,YAAY,IAAI,WAAW,EAAE;AACjE,QAAM,YAAY,IAAI,aAAa;AACnC,QAAM,MAAM,UAAU,WAAW,GAAG,IAAI,YAAY,IAAI,SAAS;AACjE,SAAO,MAAM,YAAY,EAAE,SAAS,IAAI,YAAY,CAAC,IAAI,QAAQ,GAAG,KAAK,GAAG,GAAG;AACjF;AAEA,MAAM,iBAA4F;AAAA,EAChG,WAAW;AAAA,IACT,QAAQ;AAAA,IACR,UAAU,CAAC,MAAM,EAAE,aAAa,iBAAiB,GAAG,YAAY,EAAE,WAAW,MAAM;AAAA,EACrF;AAAA,EACA,OAAO,EAAE,QAAQ,SAAS,UAAU,CAAC,MAAM,iBAAiB,CAAC,EAAE;AAAA,EAC/D,SAAS,EAAE,QAAQ,SAAS,UAAU,CAAC,MAAM,EAAE,WAAW,GAAG;AAAA,EAC7D,UAAU,EAAE,QAAQ,iBAAiB,UAAU,CAAC,MAAM,gBAAgB,CAAC,KAAK,GAAG;AAAA,EAC/E,QAAQ,EAAE,QAAQ,eAAe,UAAU,CAAC,MAAM,EAAE,YAAY;AAAA,EAChE,QAAQ,EAAE,QAAQ,UAAU,UAAU,CAAC,MAAM,EAAE,UAAU,GAAG;AAAA,EAC5D,UAAU,EAAE,QAAQ,eAAe,UAAU,CAAC,MAAM,EAAE,cAAc,GAAG;AAAA,EACvE,YAAY,EAAE,QAAQ,iBAAiB,UAAU,CAAC,MAAM,EAAE,cAAc,GAAG;AAAA,EAC3E,WAAW,EAAE,QAAQ,aAAa,UAAU,CAAC,MAAM,EAAE,aAAa,GAAG;AAAA,EACrE,WAAW,EAAE,QAAQ,aAAa,UAAU,CAAC,MAAM,EAAE,aAAa,GAAG;AAAA,EACrE,QAAQ,EAAE,QAAQ,UAAU,UAAU,CAAC,MAAO,EAAE,SAAS,QAAQ,KAAM;AACzE;AAOO,SAAS,0BACd,WACA,iBACmC;AACnC,QAAM,UAAU,mBAAmB,OAAO,KAAK,cAAc;AAC7D,SAAO,UAAU,IAAI,CAAC,QAAQ;AAC5B,UAAM,MAAuC,CAAC;AAC9C,eAAW,SAAS,SAAS;AAC3B,YAAM,WAAW,eAAe,KAAK;AACrC,UAAI,UAAU;AACZ,YAAI,SAAS,MAAM,IAAI,SAAS,SAAS,GAAG;AAAA,MAC9C,WAAW,MAAM,WAAW,MAAM,GAAG;AAEnC,cAAM,OAAO,MAAM,QAAQ,SAAS,EAAE;AACtC,cAAM,SAAS,IAAI,SAAS,KAAK,CAAC,OAAO,GAAG,eAAe,SAAS,GAAG,eAAe,IAAI;AAC1F,YAAI,OAAQ,KAAI,KAAK,IAAI,OAAO,QAAQ;AAAA,MAC1C;AAAA,IACF;AACA,WAAO;AAAA,EACT,CAAC;AACH;AAGO,SAAS,YAAY,eAAmC,QAAwB;AACrF,QAAM,QAAO,oBAAI,KAAK,GAAE,YAAY,EAAE,MAAM,GAAG,EAAE,CAAC;AAClD,QAAM,iBAAiB,iBAAiB,aAAa,QAAQ,iBAAiB,GAAG;AACjF,SAAO,GAAG,IAAI,IAAI,aAAa,IAAI,MAAM;AAC3C;",
+  "names": []
+}