@epicbagel/saas-kit 1.11.1 → 1.13.0

package/dist/primitives/chat.d.ts

@@ -154,7 +154,11 @@ interface ChatInputProps {
     uploadingLabel?: string;
     /** Show the inline voice dictation button. Defaults to true. */
     voice?: boolean;
-    /** A separate live voice control alongside dictation. The host owns its transport and lifecycle. */
+    /**
+     * Live voice controls, separate from dictation. With no text or staged files,
+     * the round voice action replaces Send; an active call keeps its controls
+     * above the input. The host owns the transport and lifecycle.
+     */
     voiceSession?: VoiceSessionControlsProps;
     /** Title shown inside the voice overlay. */
     voiceTitle?: string;
@@ -164,6 +168,7 @@ interface ChatInputProps {
      * Label for the submit button. When set, the button renders as a labelled
      * primary action (`{label} →`) instead of the default icon-only send — use
      * it to name the outcome, e.g. "Propose 3 times", "Create link", "Send".
+     * An empty composer with live voice still shows the voice action first.
      */
     submitLabel?: ReactNode;
     /** Auto-focus the textarea on mount. */
@@ -200,9 +205,10 @@ interface ChatInputProps {
 /**
  * Compact text input: a form around one bordered input group, with any
  * staged files on top, a textarea that grows with its text, then an action
- * bar (the file menu and voice mic on the left, the submit button on the
- * right). Always text-first; voice is a secondary affordance. Enter sends;
- * Shift+Enter newlines, and Enter that commits an IME candidate never sends.
+ * bar ending in one primary action. When live voice is available, an empty
+ * composer shows its round start action; text or staged files replace it
+ * with Send. Dictation remains a separate mic. Enter sends; Shift+Enter
+ * newlines, and Enter that commits an IME candidate never sends or starts a call.
  *
  * The submit button is icon-only by default; pass `submitLabel` to name the
  * outcome ("Propose 3 times", "Create link") — it then renders as a labelled
@@ -294,7 +300,8 @@ interface ChatProps {
      * Label for the submit button (empty-state input). When set, the button
      * names the outcome (`{label} →`) instead of the icon-only send — e.g.
      * "Propose 3 times". Once the conversation is active the input reverts to
-     * the compact icon send.
+     * the compact icon send. With live voice available, an empty composer shows
+     * the voice action until text or files are staged.
      */
     submitLabel?: ReactNode;
     /** Files currently staged in the composer. */
@@ -357,7 +364,7 @@ interface ChatProps {
     fileDropDescription?: ReactNode;
     /** Enable voice dictation. Defaults to true. */
     voice?: boolean;
-    /** Controlled live voice UI, used instead of browser dictation when provided. */
+    /** Controlled live voice UI; its empty-input action is separate from the dictation mic. */
     voiceSession?: VoiceSessionControlsProps;
     /** Title shown inside the voice overlay. */
     voiceTitle?: string;

package/dist/primitives/chat.js

@@ -1,5 +1,8 @@
 "use client";
 "use client";
+import {
+  VoiceDictationButton
+} from "../chunk-JKVVTFAP.js";
 import {
   VoiceSessionControls
 } from "../chunk-KF4X37DP.js";
@@ -8,9 +11,6 @@ import {
   TraceLine,
   TraceTitle
 } from "../chunk-Z45YKVAM.js";
-import {
-  VoiceDictationButton
-} from "../chunk-EDEN7TAL.js";
 import {
   Suggestion,
   Suggestions
@@ -86,7 +86,7 @@ import "../chunk-GJ7S3L6R.js";
 import {
   useCopyToClipboard
 } from "../chunk-ZWZAAGQF.js";
-import "../chunk-HLAHOVEI.js";
+import "../chunk-RPSRCB5O.js";
 import {
   useIsMobile
 } from "../chunk-PIU5SSUV.js";
@@ -402,8 +402,9 @@ function ChatInput({
   const [editing, setEditing] = useState(false);
   const focusVersion = useRef(0);
   const isDisabled = pending || disabled;
+  const hasText = Boolean(value.trim());
   const attachmentsReady = attachments.length > 0 && attachments.every((item) => item.state !== "uploading");
-  const canSubmit = !isDisabled && (Boolean(value.trim()) || attachmentsReady);
+  const canSubmit = !isDisabled && (hasText || attachmentsReady);
   const liveVoiceActive = voiceSession && voiceSession.state !== "disconnected" && voiceSession.state !== "error";
   const submit = () => {
     const trimmed = value.trim();
@@ -555,8 +556,7 @@ function ChatInput({
                           )
                         }
                       ),
-                      voiceSession && !liveVoiceActive && /* @__PURE__ */ jsx(VoiceSessionControls, { ...voiceSession, disabled: voiceSession.disabled || isDisabled }),
-                      submitLabel ? /* @__PURE__ */ jsxs(
+                      voiceSession && !liveVoiceActive && !hasText && attachments.length === 0 ? /* @__PURE__ */ jsx(VoiceSessionControls, { ...voiceSession, disabled: voiceSession.disabled || isDisabled }) : submitLabel ? /* @__PURE__ */ jsxs(
                         Button,
                         {
                           type: "submit",
@@ -572,11 +572,15 @@ function ChatInput({
                         Button,
                         {
                           type: "submit",
-                          size: spacious && !compact ? "icon-lg" : "icon",
+                          size: !voiceSession && spacious && !compact ? "icon-lg" : "icon",
+                          shape: voiceSession ? "circle" : void 0,
                           disabled: !canSubmit,
                           "aria-label": "Send",
                           "data-chat-action": "submit",
-                          className: cn(spacious && "rounded-xl", compactOnBlur && "min-h-[44px] min-w-[44px] shrink-0"),
+                          className: cn(
+                            spacious && !voiceSession && "rounded-xl",
+                            (voiceSession || compactOnBlur) && "min-h-[44px] min-w-[44px] shrink-0"
+                          ),
                           children: /* @__PURE__ */ jsx(ArrowUp, { className: cn(spacious && "h-5 w-5") })
                         }
                       )

package/dist/primitives/dictation-provider.cjs

@@ -2,7 +2,7 @@
 "use client";
 
 
-var _chunkZZ7ICQR2cjs = require('../chunk-ZZ7ICQR2.cjs');
+var _chunk7Q4EFCUIcjs = require('../chunk-7Q4EFCUI.cjs');
 
 
-exports.DictationProvider = _chunkZZ7ICQR2cjs.DictationProvider;
+exports.DictationProvider = _chunk7Q4EFCUIcjs.DictationProvider;

package/dist/primitives/dictation-provider.d.cts

@@ -1,2 +1,2 @@
-export { DictationProvider, DictationProviderProps, DictationTranscribe, DictationTranscribeOptions } from '../hooks/use-dictation.cjs';
+export { DictationProvider, DictationProviderProps, DictationStream, DictationStreamOptions, DictationStreamSession, DictationTranscribe, DictationTranscribeOptions } from '../hooks/use-dictation.cjs';
 import 'react';

package/dist/primitives/dictation-provider.d.ts

@@ -1,2 +1,2 @@
-export { DictationProvider, DictationProviderProps, DictationTranscribe, DictationTranscribeOptions } from '../hooks/use-dictation.js';
+export { DictationProvider, DictationProviderProps, DictationStream, DictationStreamOptions, DictationStreamSession, DictationTranscribe, DictationTranscribeOptions } from '../hooks/use-dictation.js';
 import 'react';

package/dist/primitives/dictation-provider.js

@@ -2,7 +2,7 @@
 "use client";
 import {
   DictationProvider
-} from "../chunk-HLAHOVEI.js";
+} from "../chunk-RPSRCB5O.js";
 export {
   DictationProvider
 };

package/dist/primitives/notes.cjs

@@ -0,0 +1,259 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _nullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } } function _optionalChain(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; }"use client";
+"use client";
+
+
+var _chunkSJB4DPGQcjs = require('../chunk-SJB4DPGQ.cjs');
+
+
+var _chunkVKYRB37Ocjs = require('../chunk-VKYRB37O.cjs');
+
+
+var _chunkR3DQS6U4cjs = require('../chunk-R3DQS6U4.cjs');
+
+
+var _chunk2HV2KKOEcjs = require('../chunk-2HV2KKOE.cjs');
+
+
+var _chunkJ467F76Icjs = require('../chunk-J467F76I.cjs');
+
+
+var _chunk373W6VADcjs = require('../chunk-373W6VAD.cjs');
+
+
+var _chunkT2ZFSPE4cjs = require('../chunk-T2ZFSPE4.cjs');
+require('../chunk-VGTINL5Q.cjs');
+
+
+var _chunkI6GUOEBOcjs = require('../chunk-I6GUOEBO.cjs');
+
+
+var _chunkCLYAASFNcjs = require('../chunk-CLYAASFN.cjs');
+
+
+var _chunkVBPPFC7Xcjs = require('../chunk-VBPPFC7X.cjs');
+
+
+var _chunkJDEXZGIYcjs = require('../chunk-JDEXZGIY.cjs');
+require('../chunk-KWLSBTB2.cjs');
+
+// src/primitives/notes.tsx
+var _lucidereact = require('lucide-react');
+var _react = require('react');
+var _jsxruntime = require('react/jsx-runtime');
+function present(value) {
+  return value != null && value !== false && value !== "";
+}
+function NoteList({
+  count,
+  loading = false,
+  title = "Notes",
+  empty = { title: "No notes yet" },
+  composer,
+  children,
+  border = "bottom",
+  ...props
+}) {
+  return /* @__PURE__ */ _jsxruntime.jsxs.call(void 0, _chunkVKYRB37Ocjs.PanelSection, { "data-slot": "note-list", border, ...props, children: [
+    /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _chunkSJB4DPGQcjs.SectionHeader, { label: title, count: loading ? void 0 : count }),
+    loading ? /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _chunkJ467F76Icjs.Stack, { direction: "vertical", gap: "sm", marginTop: "md", children: /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _chunkVBPPFC7Xcjs.Skeleton, { preset: "row", radius: "xl" }) }) : count > 0 ? /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _chunkJ467F76Icjs.Stack, { direction: "vertical", gap: "sm", marginTop: "md", children }) : /* @__PURE__ */ _jsxruntime.jsx.call(void 0, 
+      _chunkCLYAASFNcjs.EmptyState,
+      {
+        variant: "empty",
+        size: "inline",
+        icon: _lucidereact.StickyNote,
+        title: empty.title,
+        description: _nullishCoalesce(empty.description, () => ( ""))
+      }
+    ),
+    composer
+  ] });
+}
+var NOTE_CARD_LABELS = {
+  voice: "\xB7 voice",
+  delete: "Delete note"
+};
+var NOTE_ICON = { voice: _lucidereact.Mic, agent: _lucidereact.Sparkles, note: _lucidereact.MessageSquare };
+function NoteCard({
+  author,
+  kind = "note",
+  pinned,
+  scope,
+  date,
+  text,
+  onDelete,
+  revealDelete = "hover",
+  labels,
+  ...props
+}) {
+  const voiceLabel = _optionalChain([labels, 'optionalAccess', _ => _.voice]) !== void 0 ? labels.voice : NOTE_CARD_LABELS.voice;
+  const deleteLabel = _nullishCoalesce(_optionalChain([labels, 'optionalAccess', _2 => _2.delete]), () => ( NOTE_CARD_LABELS.delete));
+  return /* @__PURE__ */ _jsxruntime.jsxs.call(void 0, _chunkR3DQS6U4cjs.Card, { interaction: "group", surface: pinned ? "card" : "muted", padding: "row", ...props, children: [
+    /* @__PURE__ */ _jsxruntime.jsxs.call(void 0, _chunkJ467F76Icjs.Stack, { direction: "horizontal", gap: "xs", align: "center", justify: "between", marginBottom: "md", minWidth: "zero", wrap: true, children: [
+      /* @__PURE__ */ _jsxruntime.jsxs.call(void 0, _chunkJ467F76Icjs.Stack, { direction: "horizontal", gap: "sm", align: "center", textSize: "xs", tone: "muted", minWidth: "zero", className: "max-w-full", wrap: true, children: [
+        /* @__PURE__ */ _jsxruntime.jsxs.call(void 0, _chunk373W6VADcjs.Text, { variant: "inherit", as: "span", display: "inline-flex", weight: "medium", tone: "soft", minWidth: "zero", className: "max-w-full", children: [
+          /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _chunkT2ZFSPE4cjs.Icon, { icon: NOTE_ICON[kind], size: "xs" }),
+          /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _chunk373W6VADcjs.Text, { variant: "inherit", as: "span", minWidth: "zero", className: "[overflow-wrap:anywhere]", children: author })
+        ] }),
+        pinned && /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _chunkI6GUOEBOcjs.Badge, { as: "span", variant: "info", size: "micro", weight: "semibold", title: pinned.title, className: "max-w-full whitespace-normal [overflow-wrap:anywhere]", children: pinned.label }),
+        kind === "voice" && present(voiceLabel) && /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _chunk373W6VADcjs.Text, { variant: "inherit", as: "span", tone: "subtle", children: voiceLabel }),
+        scope && /* @__PURE__ */ _jsxruntime.jsx.call(void 0, 
+          _chunkI6GUOEBOcjs.Badge,
+          {
+            as: "span",
+            variant: scope.highlighted ? "info" : "default",
+            size: "micro",
+            weight: "semibold",
+            title: scope.title,
+            className: "max-w-full whitespace-normal [overflow-wrap:anywhere]",
+            children: scope.label
+          }
+        )
+      ] }),
+      /* @__PURE__ */ _jsxruntime.jsxs.call(void 0, _chunkJ467F76Icjs.Stack, { direction: "horizontal", gap: "xs", align: "center", minWidth: "zero", className: "max-w-full", children: [
+        present(date) ? /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _chunk373W6VADcjs.Text, { variant: "inherit", as: "span", size: "xs", tone: "muted", minWidth: "zero", className: "[overflow-wrap:anywhere]", children: date }) : null,
+        onDelete && /* @__PURE__ */ _jsxruntime.jsx.call(void 0, 
+          _chunkJDEXZGIYcjs.Button,
+          {
+            type: "button",
+            size: "icon-sm",
+            reveal: revealDelete === "always" ? "always" : "parent-hover-responsive",
+            variant: "ghost-destructive",
+            onClick: () => onDelete(),
+            title: deleteLabel,
+            children: /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _chunkT2ZFSPE4cjs.Icon, { icon: _lucidereact.Trash2, size: "sm" })
+          }
+        )
+      ] })
+    ] }),
+    present(text) && /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _chunk373W6VADcjs.Text, { size: "sm", whitespace: "pre-wrap", className: "break-words [overflow-wrap:anywhere]", children: text })
+  ] });
+}
+function Notes({ notes, ...props }) {
+  return /* @__PURE__ */ _jsxruntime.jsx.call(void 0, NoteList, { "data-slot": "notes", count: notes.length, ...props, children: notes.map(({ id, ...note }) => /* @__PURE__ */ _jsxruntime.jsx.call(void 0, NoteCard, { ...note }, id)) });
+}
+var COMPOSER_LABELS = {
+  voice: "Tap to speak",
+  type: "or type instead",
+  input: "Note",
+  placeholder: "Type your note\u2026",
+  cancel: "Cancel",
+  submit: "Add note",
+  error: "Could not save your note. Try again."
+};
+function NoteComposer({
+  onVoice,
+  onSubmit,
+  suggestions = [],
+  labels,
+  value,
+  onValueChange,
+  editing,
+  onEditingChange,
+  onCancel,
+  disabled = false,
+  error,
+  maxLength,
+  ...props
+}) {
+  const copy = { ...COMPOSER_LABELS, ...labels };
+  const [draft, setDraft] = _react.useState.call(void 0, "");
+  const [localEditing, setLocalEditing] = _react.useState.call(void 0, false);
+  const [saving, setSaving] = _react.useState.call(void 0, false);
+  const [failed, setFailed] = _react.useState.call(void 0, false);
+  const pending = _react.useRef.call(void 0, false);
+  const mounted = _react.useRef.call(void 0, true);
+  const errorId = _react.useId.call(void 0, );
+  const text = _nullishCoalesce(value, () => ( draft));
+  const latestText = _react.useRef.call(void 0, text);
+  latestText.current = text;
+  const busy = disabled || saving;
+  const message = _nullishCoalesce(error, () => ( (failed ? copy.error : null)));
+  const typing = (_nullishCoalesce(editing, () => ( localEditing))) || Boolean(text) || Boolean(message) || !onVoice;
+  _react.useEffect.call(void 0, () => {
+    mounted.current = true;
+    return () => {
+      mounted.current = false;
+    };
+  }, []);
+  function changeText(next) {
+    if (value === void 0) setDraft(next);
+    _optionalChain([onValueChange, 'optionalCall', _3 => _3(next)]);
+    latestText.current = next;
+  }
+  function changeEditing(next) {
+    if (editing === void 0) setLocalEditing(next);
+    _optionalChain([onEditingChange, 'optionalCall', _4 => _4(next)]);
+  }
+  function cancel() {
+    if (disabled || pending.current) return;
+    changeText("");
+    changeEditing(false);
+    setFailed(false);
+    _optionalChain([onCancel, 'optionalCall', _5 => _5()]);
+  }
+  async function submit(input) {
+    const trimmed = input.trim();
+    if (disabled || pending.current || !trimmed || maxLength != null && trimmed.length > maxLength) return;
+    pending.current = true;
+    setSaving(true);
+    setFailed(false);
+    const previous = latestText.current;
+    try {
+      await onSubmit(trimmed);
+      if (!mounted.current) return;
+      if (value === void 0 && latestText.current === previous) {
+        changeText("");
+        changeEditing(false);
+      }
+    } catch (e) {
+      if (!mounted.current) return;
+      if (latestText.current === previous) changeText(input);
+      changeEditing(true);
+      setFailed(true);
+    } finally {
+      pending.current = false;
+      if (mounted.current) setSaving(false);
+    }
+  }
+  return /* @__PURE__ */ _jsxruntime.jsxs.call(void 0, _chunkJ467F76Icjs.Stack, { "data-slot": "note-composer", direction: "vertical", gap: "sm", marginTop: "md", "aria-busy": saving, ...props, children: [
+    message ? /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _chunk373W6VADcjs.Text, { id: errorId, role: "alert", size: "sm", tone: "destructive", children: message }) : null,
+    typing ? /* @__PURE__ */ _jsxruntime.jsxs.call(void 0, _jsxruntime.Fragment, { children: [
+      /* @__PURE__ */ _jsxruntime.jsx.call(void 0, 
+        _chunk2HV2KKOEcjs.Textarea,
+        {
+          "aria-label": copy.input,
+          "aria-describedby": message ? errorId : void 0,
+          resize: "vertical",
+          placeholder: copy.placeholder,
+          value: text,
+          onChange: (event) => changeText(event.target.value),
+          maxLength,
+          disabled: busy,
+          autoFocus: Boolean(onVoice)
+        }
+      ),
+      /* @__PURE__ */ _jsxruntime.jsxs.call(void 0, _chunkJ467F76Icjs.Stack, { direction: "horizontal", gap: "sm", align: "center", wrap: true, children: [
+        /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _chunkJDEXZGIYcjs.Button, { type: "button", size: "sm", variant: "ghost", onClick: cancel, disabled: busy, children: copy.cancel }),
+        /* @__PURE__ */ _jsxruntime.jsxs.call(void 0, _chunkJDEXZGIYcjs.Button, { type: "button", size: "sm", onClick: () => void submit(text), disabled: busy || !text.trim() || maxLength != null && text.trim().length > maxLength, children: [
+          saving ? /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _chunkT2ZFSPE4cjs.Icon, { icon: _lucidereact.Loader2, size: "sm", spin: true }) : null,
+          copy.submit
+        ] })
+      ] })
+    ] }) : /* @__PURE__ */ _jsxruntime.jsxs.call(void 0, _jsxruntime.Fragment, { children: [
+      /* @__PURE__ */ _jsxruntime.jsxs.call(void 0, _chunkJ467F76Icjs.Stack, { direction: "vertical", gap: "sm", align: "center", paddingY: "md", children: [
+        /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _chunkJDEXZGIYcjs.Button, { type: "button", variant: "outline", size: "voice", "aria-label": copy.voice, disabled: busy, onClick: () => {
+          if (!pending.current && !disabled) _optionalChain([onVoice, 'optionalCall', _6 => _6()]);
+        }, children: /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _chunkT2ZFSPE4cjs.Icon, { icon: _lucidereact.Mic, size: 28, tone: "muted" }) }),
+        /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _chunk373W6VADcjs.Text, { variant: "inherit", as: "span", size: "sm", weight: "medium", children: copy.voice }),
+        /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _chunkJDEXZGIYcjs.Button, { type: "button", variant: "quiet", size: "bare", disabled: busy, onClick: () => changeEditing(true), children: copy.type })
+      ] }),
+      suggestions.length > 0 ? /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _chunkJ467F76Icjs.Stack, { direction: "horizontal", gap: "xs", justify: "center", wrap: true, children: suggestions.map((suggestion) => /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _chunkJDEXZGIYcjs.Button, { type: "button", variant: "outline-muted", size: "suggestion", disabled: busy, onClick: () => void submit(suggestion), children: suggestion }, suggestion)) }) : null
+    ] })
+  ] });
+}
+
+
+
+
+
+exports.NoteCard = NoteCard; exports.NoteComposer = NoteComposer; exports.NoteList = NoteList; exports.Notes = Notes;

package/dist/primitives/notes.d.cts

@@ -0,0 +1,123 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import { HTMLAttributes, ReactNode } from 'react';
+
+interface NotesEmptyCopy {
+    title: string;
+    description?: string;
+}
+interface NoteListProps extends Omit<HTMLAttributes<HTMLElement>, "title" | "children"> {
+    /** How many notes there are. Zero shows the empty state instead of `children`. */
+    count: number;
+    /** A skeleton row in place of the list, and no count yet. */
+    loading?: boolean;
+    /** The section heading. */
+    title?: ReactNode;
+    /** The blank slate's wording. Defaults to "No notes yet". */
+    empty?: NotesEmptyCopy;
+    /** Below the notes, usually a NoteComposer. */
+    composer?: ReactNode;
+    /** The notes, usually NoteCards, newest or pinned first. */
+    children?: ReactNode;
+    /** The kit PanelSection's divider. */
+    border?: "none" | "top" | "bottom";
+}
+/**
+ * A notes section, as a counted section: a skeleton row while they
+ * load, then the host's note cards, or the kit's empty state when there are
+ * none, with the composer underneath so a new note lands below the last.
+ *
+ * The root is the kit PanelSection, marked `data-slot="note-list"`.
+ */
+declare function NoteList({ count, loading, title, empty, composer, children, border, ...props }: NoteListProps): react_jsx_runtime.JSX.Element;
+/** How a note was left, which picks its glyph: dictated, written by an assistant, or typed. */
+type NoteKind = "voice" | "agent" | "note";
+/** Marks a note that stays at the top of the list and is edited elsewhere. */
+interface NotePinned {
+    /** The badge text, such as "Client note · pinned". */
+    label: ReactNode;
+    /** The badge tooltip, such as where to edit it. */
+    title?: string;
+}
+/** The context this note belongs to. */
+interface NoteScope {
+    /** The badge text, such as a project name or "General". */
+    label: ReactNode;
+    /** The badge tooltip. */
+    title?: string;
+    /** An info-toned badge, for a note tied to a context, instead of the neutral one. */
+    highlighted?: boolean;
+}
+interface NoteCardLabels {
+    /** After the author on a dictated note. Pass `null` to leave it out. */
+    voice: ReactNode;
+    /** The delete button's tooltip and accessible name. */
+    delete: string;
+}
+interface NoteCardProps extends Omit<HTMLAttributes<HTMLDivElement>, "children"> {
+    /** Who left it, already resolved to a display name. */
+    author: ReactNode;
+    kind?: NoteKind;
+    /** Pins the note: it sits on the card surface, not the muted one, with this badge. */
+    pinned?: NotePinned;
+    scope?: NoteScope;
+    /** When it was left, already formatted. */
+    date?: ReactNode;
+    /** The note, kept as written: line breaks are preserved. */
+    text?: ReactNode;
+    /** Adds a delete button. Confirm in the host before deleting anything. */
+    onDelete?: () => void;
+    /** Whether the delete button is always shown or appears on hover. Use `always` on touch screens. */
+    revealDelete?: "always" | "hover";
+    labels?: Partial<NoteCardLabels>;
+}
+/**
+ * One attributed note: who left it and how, an optional pinned badge, its
+ * optional context, when, and the text, with a delete button that appears
+ * on hover or always. The host resolves authors and context and confirms
+ * deletes.
+ *
+ * The root is the kit Card and keeps the kit's own `data-slot="card"`, which
+ * theme stylesheets select on.
+ */
+declare function NoteCard({ author, kind, pinned, scope, date, text, onDelete, revealDelete, labels, ...props }: NoteCardProps): react_jsx_runtime.JSX.Element;
+/** A display record: hosts resolve identity, context and dates before rendering. */
+interface NoteItem extends Pick<NoteCardProps, "author" | "kind" | "pinned" | "scope" | "date" | "text" | "onDelete" | "revealDelete" | "labels"> {
+    id: string | number;
+}
+interface NotesProps extends Omit<NoteListProps, "count" | "children"> {
+    /** Displayed in the supplied order. Stable IDs keep each note's identity. */
+    notes: readonly NoteItem[];
+}
+/** Reusable notes area. The array owns the count and the rendered cards. */
+declare function Notes({ notes, ...props }: NotesProps): react_jsx_runtime.JSX.Element;
+interface NoteComposerLabels {
+    voice: string;
+    type: string;
+    input: string;
+    placeholder: string;
+    cancel: string;
+    submit: string;
+    error: string;
+}
+interface NoteComposerProps extends Omit<HTMLAttributes<HTMLElement>, "children" | "onSubmit" | "onChange"> {
+    /** Starts the host's recorder. Without it the composer opens for typing. */
+    onVoice?: () => void;
+    /** Receives trimmed text. Resolve only once saved; reject to preserve the draft. */
+    onSubmit: (text: string) => Promise<void>;
+    suggestions?: readonly string[];
+    labels?: Partial<NoteComposerLabels>;
+    /** Controlled text. In this mode the host clears or replaces it after saving. */
+    value?: string;
+    onValueChange?: (text: string) => void;
+    /** The host can keep a recovered draft open even when its text becomes empty. */
+    editing?: boolean;
+    onEditingChange?: (editing: boolean) => void;
+    onCancel?: () => void;
+    disabled?: boolean;
+    error?: ReactNode;
+    maxLength?: number;
+}
+/** Voice or text composer with one pending save and recoverable drafts. */
+declare function NoteComposer({ onVoice, onSubmit, suggestions, labels, value, onValueChange, editing, onEditingChange, onCancel, disabled, error, maxLength, ...props }: NoteComposerProps): react_jsx_runtime.JSX.Element;
+
+export { NoteCard, type NoteCardLabels, type NoteCardProps, NoteComposer, type NoteComposerLabels, type NoteComposerProps, type NoteItem, type NoteKind, NoteList, type NoteListProps, type NotePinned, type NoteScope, Notes, type NotesEmptyCopy, type NotesProps };

package/dist/primitives/notes.d.ts

@@ -0,0 +1,123 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import { HTMLAttributes, ReactNode } from 'react';
+
+interface NotesEmptyCopy {
+    title: string;
+    description?: string;
+}
+interface NoteListProps extends Omit<HTMLAttributes<HTMLElement>, "title" | "children"> {
+    /** How many notes there are. Zero shows the empty state instead of `children`. */
+    count: number;
+    /** A skeleton row in place of the list, and no count yet. */
+    loading?: boolean;
+    /** The section heading. */
+    title?: ReactNode;
+    /** The blank slate's wording. Defaults to "No notes yet". */
+    empty?: NotesEmptyCopy;
+    /** Below the notes, usually a NoteComposer. */
+    composer?: ReactNode;
+    /** The notes, usually NoteCards, newest or pinned first. */
+    children?: ReactNode;
+    /** The kit PanelSection's divider. */
+    border?: "none" | "top" | "bottom";
+}
+/**
+ * A notes section, as a counted section: a skeleton row while they
+ * load, then the host's note cards, or the kit's empty state when there are
+ * none, with the composer underneath so a new note lands below the last.
+ *
+ * The root is the kit PanelSection, marked `data-slot="note-list"`.
+ */
+declare function NoteList({ count, loading, title, empty, composer, children, border, ...props }: NoteListProps): react_jsx_runtime.JSX.Element;
+/** How a note was left, which picks its glyph: dictated, written by an assistant, or typed. */
+type NoteKind = "voice" | "agent" | "note";
+/** Marks a note that stays at the top of the list and is edited elsewhere. */
+interface NotePinned {
+    /** The badge text, such as "Client note · pinned". */
+    label: ReactNode;
+    /** The badge tooltip, such as where to edit it. */
+    title?: string;
+}
+/** The context this note belongs to. */
+interface NoteScope {
+    /** The badge text, such as a project name or "General". */
+    label: ReactNode;
+    /** The badge tooltip. */
+    title?: string;
+    /** An info-toned badge, for a note tied to a context, instead of the neutral one. */
+    highlighted?: boolean;
+}
+interface NoteCardLabels {
+    /** After the author on a dictated note. Pass `null` to leave it out. */
+    voice: ReactNode;
+    /** The delete button's tooltip and accessible name. */
+    delete: string;
+}
+interface NoteCardProps extends Omit<HTMLAttributes<HTMLDivElement>, "children"> {
+    /** Who left it, already resolved to a display name. */
+    author: ReactNode;
+    kind?: NoteKind;
+    /** Pins the note: it sits on the card surface, not the muted one, with this badge. */
+    pinned?: NotePinned;
+    scope?: NoteScope;
+    /** When it was left, already formatted. */
+    date?: ReactNode;
+    /** The note, kept as written: line breaks are preserved. */
+    text?: ReactNode;
+    /** Adds a delete button. Confirm in the host before deleting anything. */
+    onDelete?: () => void;
+    /** Whether the delete button is always shown or appears on hover. Use `always` on touch screens. */
+    revealDelete?: "always" | "hover";
+    labels?: Partial<NoteCardLabels>;
+}
+/**
+ * One attributed note: who left it and how, an optional pinned badge, its
+ * optional context, when, and the text, with a delete button that appears
+ * on hover or always. The host resolves authors and context and confirms
+ * deletes.
+ *
+ * The root is the kit Card and keeps the kit's own `data-slot="card"`, which
+ * theme stylesheets select on.
+ */
+declare function NoteCard({ author, kind, pinned, scope, date, text, onDelete, revealDelete, labels, ...props }: NoteCardProps): react_jsx_runtime.JSX.Element;
+/** A display record: hosts resolve identity, context and dates before rendering. */
+interface NoteItem extends Pick<NoteCardProps, "author" | "kind" | "pinned" | "scope" | "date" | "text" | "onDelete" | "revealDelete" | "labels"> {
+    id: string | number;
+}
+interface NotesProps extends Omit<NoteListProps, "count" | "children"> {
+    /** Displayed in the supplied order. Stable IDs keep each note's identity. */
+    notes: readonly NoteItem[];
+}
+/** Reusable notes area. The array owns the count and the rendered cards. */
+declare function Notes({ notes, ...props }: NotesProps): react_jsx_runtime.JSX.Element;
+interface NoteComposerLabels {
+    voice: string;
+    type: string;
+    input: string;
+    placeholder: string;
+    cancel: string;
+    submit: string;
+    error: string;
+}
+interface NoteComposerProps extends Omit<HTMLAttributes<HTMLElement>, "children" | "onSubmit" | "onChange"> {
+    /** Starts the host's recorder. Without it the composer opens for typing. */
+    onVoice?: () => void;
+    /** Receives trimmed text. Resolve only once saved; reject to preserve the draft. */
+    onSubmit: (text: string) => Promise<void>;
+    suggestions?: readonly string[];
+    labels?: Partial<NoteComposerLabels>;
+    /** Controlled text. In this mode the host clears or replaces it after saving. */
+    value?: string;
+    onValueChange?: (text: string) => void;
+    /** The host can keep a recovered draft open even when its text becomes empty. */
+    editing?: boolean;
+    onEditingChange?: (editing: boolean) => void;
+    onCancel?: () => void;
+    disabled?: boolean;
+    error?: ReactNode;
+    maxLength?: number;
+}
+/** Voice or text composer with one pending save and recoverable drafts. */
+declare function NoteComposer({ onVoice, onSubmit, suggestions, labels, value, onValueChange, editing, onEditingChange, onCancel, disabled, error, maxLength, ...props }: NoteComposerProps): react_jsx_runtime.JSX.Element;
+
+export { NoteCard, type NoteCardLabels, type NoteCardProps, NoteComposer, type NoteComposerLabels, type NoteComposerProps, type NoteItem, type NoteKind, NoteList, type NoteListProps, type NotePinned, type NoteScope, Notes, type NotesEmptyCopy, type NotesProps };