@kanzo-tech/ai 0.16.0 → 0.17.0

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@kanzo-tech/ai",
-  "version": "0.16.0",
-  "description": "Kanzo AI surfaces — the transcript, the composer, a model's reasoning and the calls it makes, plus the field affordances that stream into a value. Sibling of @kanzo-tech/ui, not part of it: a Message has a role and one of the roles is `assistant`, which is domain knowledge the generic vocabulary does not carry.",
+  "version": "0.17.0",
+  "description": "Kanzo AI surfaces — a field the model helps fill (Assist) and a conversation with one (Chat), over the AI SDK through @kanzo-tech/llm. Sibling of @kanzo-tech/ui, not part of it.",
   "type": "module",
   "license": "MIT",
   "sideEffects": [
@@ -19,42 +19,42 @@
       "types": "./dist/index.d.ts",
       "import": "./dist/index.js"
     },
-    "./markdown": {
-      "types": "./dist/markdown.d.ts",
-      "import": "./dist/markdown.js"
-    },
     "./tailwind.css": "./src/tailwind.css",
     "./package.json": "./package.json"
   },
-  "//peers": "Everything on the root barrel draws with @kanzo-tech/ui's parts and Ark's machines, so both are required peers rather than dependencies — two copies of Ark would mean two portals and two focus traps. streamdown is the one OPTIONAL peer, and it is why ./markdown exists: it measures 495 kB minified and 128 kB brotli on its own, against a 20 kB budget for the whole root barrel, so a host that renders plain text must not pay for a markdown parser. Same door as @kanzo-tech/ui/editor and @kanzo-tech/ui/analytics.",
+  "//peers": "@kanzo-tech/ui and Ark are required peers rather than dependencies — two copies of Ark would mean two portals and two focus traps. `ai` and `@ai-sdk/react` are REQUIRED peers for the reason @kanzo-tech/llm gives: the host's agent and these components must share one UIMessage, one transport and one useChat. streamdown is a dependency now: Chat renders markdown, and a conversation that draws plain text is not one this package offers.",
   "peerDependencies": {
+    "@ai-sdk/react": "^4.0.0",
     "@ark-ui/react": "^5.37.2",
+    "ai": "^7.0.0",
     "lucide-react": ">=1",
     "react": ">=19",
     "react-dom": ">=19",
-    "streamdown": ">=2",
-    "@kanzo-tech/ui": "0.16.0"
+    "@kanzo-tech/ui": "0.17.0"
   },
   "dependencies": {
-    "tailwind-variants": "^3.2.2"
+    "streamdown": "^2.5.0",
+    "tailwind-variants": "^3.2.2",
+    "@kanzo-tech/llm": "0.17.0"
   },
   "devDependencies": {
+    "@ai-sdk/react": "^4.0.129",
     "@ark-ui/react": "^5.37.2",
     "@testing-library/dom": "^10.4.1",
     "@testing-library/react": "^16.3.2",
     "@testing-library/user-event": "^14.6.1",
     "@types/react": "^19.0.0",
     "@types/react-dom": "^19.0.0",
+    "ai": "^7.0.126",
     "jsdom": "^29.1.1",
     "lucide-react": "^1.23.0",
     "react": "^19.0.0",
     "react-dom": "^19.0.0",
     "rollup-plugin-preserve-directives": "^0.4.0",
-    "streamdown": "^2.5.0",
-    "@kanzo-tech/ui": "0.16.0",
-    "@kanzo-tech/theme": "0.16.0"
+    "@kanzo-tech/theme": "0.17.0",
+    "@kanzo-tech/ui": "0.17.0"
   },
-  "//size-limit": "First measurement taken at the split, so this budget is a change detector from day one rather than a number inherited from somewhere. The four AI-assist modules that moved here cost @kanzo-tech/ui's root barrel about 4 kB when they arrived (38 -> 42 kB, recorded in that package's own note); the barrel is rebaselined down by the same move.",
+  "//size-limit": "The root barrel, measured without the peers and dependencies a host already has. Assist and Chat tree-shake apart: a host that only assists fields does not ship the transcript, and the markdown parser comes with Chat alone.",
   "size-limit": [
     {
       "name": "root barrel (JS)",
@@ -66,31 +66,15 @@
         "react/jsx-runtime",
         "@ark-ui/react",
         "@kanzo-tech/ui",
-        "lucide-react",
-        "tailwind-variants"
-      ]
-    },
-    {
-      "name": "markdown subpath (JS)",
-      "path": "dist/markdown.js",
-      "limit": "3 kB",
-      "ignore": [
-        "react",
-        "react-dom",
-        "react/jsx-runtime",
-        "@ark-ui/react",
-        "@kanzo-tech/ui",
+        "@kanzo-tech/llm",
         "lucide-react",
         "tailwind-variants",
-        "streamdown"
+        "streamdown",
+        "ai",
+        "@ai-sdk/react"
       ]
     }
   ],
-  "peerDependenciesMeta": {
-    "streamdown": {
-      "optional": true
-    }
-  },
   "repository": {
     "type": "git",
     "url": "git+https://github.com/Kanzo-Tech/ui.git",

package/dist/complete.d.ts

@@ -1,87 +0,0 @@
-import { AiMarkProps } from './ai-mark.js';
-import { InlineCompletionRequest } from './use-ai.js';
-import * as React from "react";
-export interface CompleteRootProps {
-    complete: (request: InlineCompletionRequest) => AsyncIterable<string>;
-    value: string;
-    onValueChange: (value: string) => void;
-    debounceMs?: number;
-    minLength?: number;
-    /**
-     * What a screen reader hears once, when a suggestion lands.
-     *
-     * @default "Suggestion ready. Press Tab to accept, Escape to dismiss."
-     */
-    announcement?: string;
-    className?: string;
-    children: React.ReactNode;
-}
-export declare function CompleteRoot(props: CompleteRootProps): React.JSX.Element;
-export declare function CompleteTextarea({ children }: {
-    children: React.ReactElement;
-}): React.JSX.Element;
-/**
- * The ✨, bound to the stream — the same mark `SuggestTrigger` wears, so an assisted field looks
- * assisted whichever of the two it has.
- *
- * Pressing it **takes what is on offer and asks when there is nothing**. That is one gesture with
- * two readings on purpose: it is the only way to accept without a keyboard, and the only way back
- * after Escape, which otherwise ends the field's assistance until the next keystroke.
- */
-export declare function CompleteMark(props: Omit<AiMarkProps, "busy" | "offering"> & {
-    /**
-     * The accessible name while a suggestion is on offer, when `label` names the mark at rest.
-     *
-     * @default "Accept suggestion"
-     */
-    offeringLabel?: string;
-}): React.JSX.Element;
-/**
- * The continuation drawn where it will land, over the field itself. It wraps and scrolls with the
- * field rather than measuring whether a line of it fits.
- */
-export declare function CompleteGhost({ className }: {
-    className?: string;
-}): React.JSX.Element;
-/**
- * The keys, while there is something to take.
- *
- * The compound already told one class of reader: the `sr-only` region announces *Press Tab to
- * accept, Escape to dismiss* the moment an offer lands. A sighted keyboard user got nothing —
- * `CompleteHint` carries the keys too, so a composition that uses the ghost taught the gesture
- * nowhere. This is the visible twin of that sentence, and it is a part rather than a fixture
- * because only the caller knows where it fits: beside the ✨ in a `block-end` addon, under the
- * field, nowhere at all on a form of eleven where one line of instruction beats eleven.
- *
- * There is no reference to copy. Gmail taught Tab with a popup shown once ever; Copilot puts a
- * toolbar under the pointer, which is a gesture a keyboard cannot make. Naming the key next to the
- * offer is the version that works for both.
- */
-export declare function CompleteKeys({ acceptLabel, className, dismissLabel, }: {
-    /** The word after the `Tab` key. */
-    acceptLabel?: string;
-    className?: string;
-    /** The word after the `Esc` key. */
-    dismissLabel?: string;
-}): React.JSX.Element | null;
-/** Below-field alternative to `CompleteGhost`, for a field the overlay cannot sit over. */
-export declare function CompleteHint({ acceptLabel, className, dismissLabel, }: {
-    /** The word after the `Tab` key, as on `CompleteKeys`. */
-    acceptLabel?: string;
-    className?: string;
-    /** The word after the `Esc` key, as on `CompleteKeys`. */
-    dismissLabel?: string;
-}): React.JSX.Element | null;
-/**
- * What went wrong, in place. Renders nothing when nothing did.
- *
- * `Suggest` has always shown its failures — the strip prints them where the candidates would be —
- * and this side showed none at all: the ✨ stopped spinning and the field said nothing, because
- * `error` was on the hook and no part read it. It is a separate part rather than a line inside
- * `CompleteHint` because the ghost surface is usually `CompleteGhost`, an overlay with no room
- * under it, and a failure has to be readable in both.
- */
-export declare function CompleteError({ className }: {
-    className?: string;
-}): React.JSX.Element | null;
-//# sourceMappingURL=complete.d.ts.map

package/dist/complete.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"complete.d.ts","sourceRoot":"","sources":["../src/complete.tsx"],"names":[],"mappings":"AAGA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,OAAO,EAAU,KAAK,WAAW,EAAE,MAAM,cAAc,CAAC;AACxD,OAAO,EAEL,KAAK,uBAAuB,EAG7B,MAAM,aAAa,CAAC;AA+FrB,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,CAAC,OAAO,EAAE,uBAAuB,KAAK,aAAa,CAAC,MAAM,CAAC,CAAC;IACtE,KAAK,EAAE,MAAM,CAAC;IACd,aAAa,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACvC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;OAIG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;CAC3B;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,iBAAiB,qBAyLpD;AAED,wBAAgB,gBAAgB,CAAC,EAAE,QAAQ,EAAE,EAAE;IAAE,QAAQ,EAAE,KAAK,CAAC,YAAY,CAAA;CAAE,qBAkB9E;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAC1B,KAAK,EAAE,IAAI,CAAC,WAAW,EAAE,MAAM,GAAG,UAAU,CAAC,GAAG;IAC9C;;;;OAIG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB,qBAmBF;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,EAAE,SAAS,EAAE,EAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,qBA8FlE;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,YAAY,CAAC,EAC3B,WAAsB,EACtB,SAAS,EACT,YAAwB,GACzB,EAAE;IACD,oCAAoC;IACpC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,oCAAoC;IACpC,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,4BAgBA;AAED,2FAA2F;AAC3F,wBAAgB,YAAY,CAAC,EAC3B,WAAW,EACX,SAAS,EACT,YAAY,GACb,EAAE;IACD,0DAA0D;IAC1D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,0DAA0D;IAC1D,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,4BAYA;AAGD;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAAC,EAAE,SAAS,EAAE,EAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,4BAYlE"}

package/dist/complete.js

@@ -1,278 +0,0 @@
-"use client";
-import { jsx as m, jsxs as v } from "react/jsx-runtime";
-import { ark as f } from "@ark-ui/react/factory";
-import * as c from "react";
-import { cn as y, Kbd as H } from "@kanzo-tech/ui";
-import { AiMark as _ } from "./ai-mark.js";
-import { useInlineCompletion as G, MIN_COMPLETE_LENGTH as O } from "./use-ai.js";
-const M = c.createContext(null), x = (r) => {
-  const e = c.useContext(M);
-  if (!e) throw new Error(`${r} must render inside <CompleteRoot>`);
-  return e;
-}, z = [
-  "fontFamily",
-  "fontSize",
-  "fontWeight",
-  "fontStyle",
-  "letterSpacing",
-  "lineHeight",
-  "textTransform",
-  "paddingTop",
-  "paddingRight",
-  "paddingBottom",
-  "paddingLeft",
-  "borderTopWidth",
-  "borderRightWidth",
-  "borderBottomWidth",
-  "borderLeftWidth"
-], S = (r) => Number.parseFloat(r) || 0, V = (r, e) => {
-  const i = getComputedStyle(r), s = i.direction === "rtl", l = r.getBoundingClientRect(), a = e.getBoundingClientRect(), b = r.offsetWidth - r.clientWidth - S(i.borderLeftWidth) - S(i.borderRightWidth), u = {
-    borderStyle: "solid",
-    borderColor: "transparent",
-    insetBlockStart: l.top - a.top,
-    insetBlockEnd: a.bottom - l.bottom,
-    insetInlineStart: s ? a.right - l.right : l.left - a.left,
-    insetInlineEnd: (s ? l.left - a.left : a.right - l.right) + (b > 0 ? b : 0)
-  };
-  for (const d of z) u[d] = i[d];
-  return { metrics: u, rtl: s };
-}, j = { metrics: {}, rtl: !1 }, q = "[mask-image:linear-gradient(to_bottom,#000_calc(100%-0.9lh),transparent)]", $ = (r) => {
-  var e;
-  return ((e = /^\s*\S+/.exec(r)) == null ? void 0 : e[0]) ?? "";
-};
-function ee(r) {
-  const {
-    announcement: e = "Suggestion ready. Press Tab to accept, Escape to dismiss.",
-    complete: i,
-    value: s,
-    onValueChange: l,
-    debounceMs: a,
-    minLength: b,
-    className: u,
-    children: d
-  } = r, o = G({ complete: i, debounceMs: a, minLength: b }), p = c.useRef(null), W = c.useRef(null), [h, R] = c.useState(s.length), [k, A] = c.useState(j), g = o.ghost, E = c.useRef(null);
-  c.useLayoutEffect(() => {
-    const t = p.current, n = E.current;
-    !t || n === null || (E.current = null, t.setSelectionRange(n, n), R(n));
-  }, [s]), c.useLayoutEffect(() => {
-    const t = p.current, n = W.current;
-    if (!t || !n) return;
-    const C = () => A(V(t, n));
-    if (C(), typeof ResizeObserver > "u") return;
-    const N = new ResizeObserver(C);
-    return N.observe(t), N.observe(n), () => N.disconnect();
-  }, []);
-  const K = o.dismiss, L = c.useCallback(() => {
-    const t = p.current;
-    if (!t || E.current !== null) return;
-    const n = t.selectionStart ?? t.value.length;
-    if ((t.selectionEnd ?? n) !== n) {
-      K();
-      return;
-    }
-    R(n);
-  }, [K]);
-  c.useEffect(() => {
-    const t = p.current;
-    if (!t) return;
-    const n = () => {
-      document.activeElement === t && L();
-    };
-    return document.addEventListener("selectionchange", n), () => document.removeEventListener("selectionchange", n);
-  }, [L]);
-  const D = c.useCallback(
-    (t) => {
-      const n = t.target, C = n.selectionStart ?? n.value.length;
-      R(C), l(n.value), o.setValue(n.value, C);
-    },
-    [o, l]
-  ), w = c.useCallback(
-    (t) => {
-      const n = s.slice(0, h) + t + s.slice(h);
-      return E.current = h + t.length, l(n), { next: n, at: h + t.length };
-    },
-    [h, l, s]
-  ), T = c.useCallback(() => {
-    var t;
-    g && (w(g), o.dismiss(), (t = p.current) == null || t.focus());
-  }, [o, g, w]), B = c.useCallback(() => {
-    const t = $(g);
-    if (!t) return;
-    const { next: n, at: C } = w(t);
-    o.setValue(n, C);
-  }, [o, g, w]), I = c.useCallback(() => {
-    const t = p.current, n = t && t === document.activeElement ? t.selectionStart ?? h : h;
-    R(n), o.ask(s, n), t == null || t.focus(), t == null || t.setSelectionRange(n, n);
-  }, [h, o, s]), P = c.useCallback(
-    (t) => {
-      if (t.defaultPrevented || !g) return;
-      const n = k.rtl ? "ArrowLeft" : "ArrowRight";
-      t.key === "Tab" ? (t.preventDefault(), T()) : t.key === n && (t.ctrlKey || t.metaKey) ? (t.preventDefault(), B()) : t.key === "Escape" && o.dismiss();
-    },
-    [T, B, o, k.rtl, g]
-  ), F = {
-    fieldRef: p,
-    value: s,
-    ghost: g,
-    caret: h,
-    rtl: k.rtl,
-    status: o.status,
-    error: o.error,
-    askable: s.trim().length >= (b ?? O),
-    metrics: k.metrics,
-    onChange: D,
-    onKeyDown: P,
-    syncCaret: L,
-    accept: T,
-    request: I
-  };
-  return /* @__PURE__ */ m(M.Provider, { value: F, children: /* @__PURE__ */ v(f.div, { className: y("relative w-full min-w-0", u), "data-slot": "complete", ref: W, children: [
-    d,
-    /* @__PURE__ */ m(f.span, { "aria-live": "polite", className: "sr-only", "data-slot": "complete-status", children: g ? e : "" })
-  ] }) });
-}
-function te({ children: r }) {
-  const e = x("CompleteTextarea");
-  return /* @__PURE__ */ m(
-    f.textarea,
-    {
-      "aria-keyshortcuts": e.ghost ? "Tab Escape" : void 0,
-      asChild: !0,
-      "data-slot": "complete-textarea",
-      onChange: e.onChange,
-      onClick: e.syncCaret,
-      onKeyDown: e.onKeyDown,
-      onKeyUp: e.syncCaret,
-      onSelect: e.syncCaret,
-      ref: e.fieldRef,
-      value: e.value,
-      children: r
-    }
-  );
-}
-function ne(r) {
-  const { label: e = "AI assist", offeringLabel: i = "Accept suggestion", ...s } = r, l = x("CompleteMark"), a = l.ghost.length > 0;
-  return /* @__PURE__ */ m(
-    _,
-    {
-      busy: l.status === "loading" && !a,
-      disabled: !a && !l.askable,
-      label: a ? i : e,
-      offering: a,
-      onClick: a ? l.accept : l.request,
-      ...s
-    }
-  );
-}
-function re({ className: r }) {
-  const e = x("CompleteGhost"), i = c.useRef(null), [s, l] = c.useState(!1);
-  c.useLayoutEffect(() => {
-    const u = e.fieldRef.current, d = i.current;
-    if (!u || !d) return;
-    if (!e.ghost) {
-      u.style.removeProperty("min-height");
-      return;
-    }
-    const o = getComputedStyle(u), p = d.scrollHeight + S(o.borderTopWidth) + S(o.borderBottomWidth);
-    p > u.getBoundingClientRect().height + 1 && u.style.setProperty("min-height", `${p}px`);
-  }, [e.fieldRef, e.ghost, e.value]), c.useLayoutEffect(() => {
-    const u = e.fieldRef.current, d = i.current;
-    if (!u || !d) return;
-    const o = () => {
-      d.scrollLeft = u.scrollLeft, d.scrollTop = u.scrollTop;
-    };
-    return o(), l(d.scrollHeight > d.clientHeight), u.addEventListener("scroll", o), () => u.removeEventListener("scroll", o);
-  }, [e.caret, e.fieldRef, e.value, e.ghost]);
-  const a = e.ghost.length > 0, b = Math.min(e.caret, e.value.length);
-  return /* @__PURE__ */ v(
-    f.div,
-    {
-      "aria-hidden": !0,
-      className: y(
-        "pointer-events-none absolute inset-0 overflow-hidden text-transparent",
-        "whitespace-pre-wrap break-words",
-        // **A continuation that does not fit fades; it is not guillotined.** The box is
-        // `overflow: hidden`, so without this a too-long ghost ends on a hard edge — mid-letter
-        // against the ✨. Applied only when the measurement above says it is genuinely cut, which
-        // is now only when a caller has pinned the field's height.
-        s && q,
-        !a && "invisible",
-        r
-      ),
-      "data-slot": "complete-ghost",
-      ref: i,
-      style: e.metrics,
-      children: [
-        /* @__PURE__ */ m(f.span, { className: "invisible", children: e.value.slice(0, b) }),
-        /* @__PURE__ */ m(f.span, { className: "text-faint", children: e.ghost }),
-        /* @__PURE__ */ m(f.span, { className: "invisible", children: e.value.slice(b) })
-      ]
-    }
-  );
-}
-function U({
-  acceptLabel: r = "accept",
-  className: e,
-  dismissLabel: i = "dismiss"
-}) {
-  return x("CompleteKeys").ghost ? /* @__PURE__ */ v(
-    f.span,
-    {
-      className: y("inline-flex items-center gap-2 text-muted-foreground text-xs", e),
-      "data-slot": "complete-keys",
-      children: [
-        /* @__PURE__ */ v(f.span, { className: "inline-flex items-center gap-1 whitespace-nowrap", children: [
-          /* @__PURE__ */ m(H, { children: "Tab" }),
-          " ",
-          r
-        ] }),
-        /* @__PURE__ */ v(f.span, { className: "inline-flex items-center gap-1 whitespace-nowrap", children: [
-          /* @__PURE__ */ m(H, { children: "Esc" }),
-          " ",
-          i
-        ] })
-      ]
-    }
-  ) : null;
-}
-function se({
-  acceptLabel: r,
-  className: e,
-  dismissLabel: i
-}) {
-  const s = x("CompleteHint");
-  return s.ghost ? /* @__PURE__ */ v(
-    f.p,
-    {
-      className: y("mt-1.5 whitespace-pre-wrap break-words text-muted-foreground text-sm", e),
-      "data-slot": "complete-hint",
-      children: [
-        /* @__PURE__ */ m(f.span, { className: "text-faint", children: s.ghost.replace(/^\s+/, "") }),
-        " ",
-        /* @__PURE__ */ m(U, { acceptLabel: r, dismissLabel: i })
-      ]
-    }
-  ) : null;
-}
-function oe({ className: r }) {
-  const e = x("CompleteError");
-  return e.error === null ? null : /* @__PURE__ */ m(
-    f.p,
-    {
-      className: y("mt-1.5 text-destructive-foreground text-sm", r),
-      "data-slot": "complete-error",
-      role: "alert",
-      children: e.error
-    }
-  );
-}
-export {
-  oe as CompleteError,
-  re as CompleteGhost,
-  se as CompleteHint,
-  U as CompleteKeys,
-  ne as CompleteMark,
-  ee as CompleteRoot,
-  te as CompleteTextarea
-};
-//# sourceMappingURL=complete.js.map

package/dist/complete.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"complete.js","sources":["../src/complete.tsx"],"sourcesContent":["\"use client\";\n\nimport { ark } from \"@ark-ui/react/factory\";\nimport * as React from \"react\";\nimport { cn, Kbd } from \"@kanzo-tech/ui\";\nimport { AiMark, type AiMarkProps } from \"./ai-mark.js\";\nimport {\n  type AiStatus,\n  type InlineCompletionRequest,\n  MIN_COMPLETE_LENGTH,\n  useInlineCompletion,\n} from \"./use-ai.js\";\n\n/**\n * A `<textarea>`, and there is no `<input>` branch any more.\n *\n * **A one-line field takes candidates, not a continuation.** A continuation drawn over an\n * `<input>` can only ever show what fits in the remaining width — the field's own `scrollLeft`\n * cannot reveal text that is not in its value — so a long offer was unreadable by any gesture and\n * accepting it meant accepting blind. No reference does it either: Gmail continues a body, Copilot\n * an editor, and every single-line field in the wild offers a *list*. That is `Suggest`, and it is\n * already here.\n */\ntype FieldEl = HTMLTextAreaElement;\n\ninterface CompleteCtx {\n  fieldRef: React.RefObject<FieldEl | null>;\n  value: string;\n  /** What is on offer at the caret. Empty when there is nothing. */\n  ghost: string;\n  /** Where the offer goes. The ghost is drawn here, not at the end of the value. */\n  caret: number;\n  rtl: boolean;\n  status: AiStatus;\n  error: string | null;\n  /** The value is long enough for `complete` to be asked at all. */\n  askable: boolean;\n  metrics: React.CSSProperties;\n  onChange: (e: React.ChangeEvent<FieldEl>) => void;\n  onKeyDown: (e: React.KeyboardEvent<FieldEl>) => void;\n  syncCaret: () => void;\n  accept: () => void;\n  request: () => void;\n}\n\nconst Ctx = React.createContext<CompleteCtx | null>(null);\nconst useCtx = (part: string) => {\n  const c = React.useContext(Ctx);\n  if (!c) throw new Error(`${part} must render inside <CompleteRoot>`);\n  return c;\n};\n\nconst METRICS = [\n  \"fontFamily\", \"fontSize\", \"fontWeight\", \"fontStyle\", \"letterSpacing\", \"lineHeight\",\n  \"textTransform\", \"paddingTop\", \"paddingRight\", \"paddingBottom\", \"paddingLeft\",\n  \"borderTopWidth\", \"borderRightWidth\", \"borderBottomWidth\", \"borderLeftWidth\",\n] as const;\n\ninterface FieldShape {\n  metrics: React.CSSProperties;\n  rtl: boolean;\n}\n\n// The overlay is positioned against the FIELD, not against the root, because the two are not the\n// same box once the ✨ lives inside an `InputGroup`: the group carries the border the input no\n// longer has, and a mirror pinned to the root paints a character-width off.\nconst px = (v: string) => Number.parseFloat(v) || 0;\n\nconst readField = (el: FieldEl, root: HTMLElement): FieldShape => {\n  const cs = getComputedStyle(el);\n  const rtl = cs.direction === \"rtl\";\n  const box = el.getBoundingClientRect();\n  const outer = root.getBoundingClientRect();\n  // A scrolling textarea takes its scrollbar out of the text's width, and it takes it from the\n  // inline-END side in both directions. Without this the mirror wraps a word earlier or later than\n  // the field does wherever scrollbars are not overlays — which is not macOS, so it is exactly the\n  // kind of divergence nobody sees here.\n  const gutter = el.offsetWidth - el.clientWidth - px(cs.borderLeftWidth) - px(cs.borderRightWidth);\n  const metrics: Record<string, string | number> = {\n    borderStyle: \"solid\",\n    borderColor: \"transparent\",\n    insetBlockStart: box.top - outer.top,\n    insetBlockEnd: outer.bottom - box.bottom,\n    insetInlineStart: rtl ? outer.right - box.right : box.left - outer.left,\n    insetInlineEnd:\n      (rtl ? box.left - outer.left : outer.right - box.right) + (gutter > 0 ? gutter : 0),\n  };\n  for (const k of METRICS) metrics[k] = cs[k as keyof CSSStyleDeclaration] as string;\n  return { metrics: metrics as React.CSSProperties, rtl };\n};\n\nconst REST: FieldShape = { metrics: {}, rtl: false };\n\n/**\n * A safety net rather than the answer. The field grows to fit its offer, so it runs out of height\n * only where a caller has pinned a `max-height` — and there a fade beats a slice.\n *\n * There were three of these. The two horizontal ones masked a continuation that overran a\n * single-line field, which is the case that no longer exists.\n */\nconst GHOST_FADE =\n  \"[mask-image:linear-gradient(to_bottom,#000_calc(100%-0.9lh),transparent)]\";\n\n/** Leading space plus the next word — what one press of the accept-a-word key takes. */\nconst nextWord = (ghost: string) => /^\\s*\\S+/.exec(ghost)?.[0] ?? \"\";\n\nexport interface CompleteRootProps {\n  complete: (request: InlineCompletionRequest) => AsyncIterable<string>;\n  value: string;\n  onValueChange: (value: string) => void;\n  debounceMs?: number;\n  minLength?: number;\n  /**\n   * What a screen reader hears once, when a suggestion lands.\n   *\n   * @default \"Suggestion ready. Press Tab to accept, Escape to dismiss.\"\n   */\n  announcement?: string;\n  className?: string;\n  children: React.ReactNode;\n}\n\nexport function CompleteRoot(props: CompleteRootProps) {\n  const {\n    announcement = \"Suggestion ready. Press Tab to accept, Escape to dismiss.\",\n    complete,\n    value,\n    onValueChange,\n    debounceMs,\n    minLength,\n    className,\n    children,\n  } = props;\n  const completion = useInlineCompletion({ complete, debounceMs, minLength });\n  const fieldRef = React.useRef<FieldEl | null>(null);\n  const rootRef = React.useRef<HTMLDivElement>(null);\n  const [caret, setCaret] = React.useState(value.length);\n  const [field, setField] = React.useState<FieldShape>(REST);\n\n  const ghost = completion.ghost;\n\n  // Where the caret must land after WE changed the value. The browser puts it wherever it likes\n  // when React writes a new `value`, and taking a word out of the middle of a sentence is the case\n  // that makes it obvious.\n  const landing = React.useRef<number | null>(null);\n\n  React.useLayoutEffect(() => {\n    const el = fieldRef.current;\n    const at = landing.current;\n    if (!el || at === null) return;\n    landing.current = null;\n    el.setSelectionRange(at, at);\n    setCaret(at);\n  }, [value]);\n\n  // The ghost mirror wears the field's real metrics, so it aligns whatever the size/className.\n  React.useLayoutEffect(() => {\n    const el = fieldRef.current;\n    const root = rootRef.current;\n    if (!el || !root) return;\n    const sync = () => setField(readField(el, root));\n    sync();\n    if (typeof ResizeObserver === \"undefined\") return;\n    const ro = new ResizeObserver(sync);\n    ro.observe(el);\n    ro.observe(root);\n    return () => ro.disconnect();\n  }, []);\n\n  const dismiss = completion.dismiss;\n\n  /**\n   * **A range is not an insertion point, so an offer cannot survive one.**\n   *\n   * `selectionStart` is the HEAD of a selection, not a caret. Selecting a sentence — or pressing\n   * ⌘A — moved our caret to the start of it while the offer stayed live, and the continuation was\n   * then drawn from there: on top of the words it was made to follow. Taking it with Tab spliced it\n   * in at the same wrong place, because `insert` splits the value at this number too.\n   *\n   * The fix is not to draw it somewhere else. `InlineCompletionRequest` is explicitly the\n   * degenerate range — an insertion point — so while text is selected there is no place the offer\n   * *could* go, and the honest answer is to let it go. Collapsing the selection asks again, which\n   * costs a debounce and no more.\n   */\n  const syncCaret = React.useCallback(() => {\n    const el = fieldRef.current;\n    if (!el || landing.current !== null) return;\n    const start = el.selectionStart ?? el.value.length;\n    if ((el.selectionEnd ?? start) !== start) {\n      dismiss();\n      return;\n    }\n    setCaret(start);\n  }, [dismiss]);\n\n  /**\n   * The caret is where the ghost is **drawn**, so ours drifting from the field's is not a missed\n   * update — it paints a continuation on top of the value. Seen live: a ghost starting at character\n   * zero, over the sentence it was continuing.\n   *\n   * `selectionchange` is the only event that reports every way a caret moves — arrows, clicks,\n   * drags, Home/End, and a script calling `setSelectionRange`. `click` and `keyup` catch most of\n   * them and are kept because they fire first; this catches the rest.\n   */\n  React.useEffect(() => {\n    const el = fieldRef.current;\n    if (!el) return;\n    const onSelectionChange = () => {\n      if (document.activeElement === el) syncCaret();\n    };\n    document.addEventListener(\"selectionchange\", onSelectionChange);\n    return () => document.removeEventListener(\"selectionchange\", onSelectionChange);\n  }, [syncCaret]);\n\n  const onChange = React.useCallback(\n    (e: React.ChangeEvent<FieldEl>) => {\n      const el = e.target;\n      const at = el.selectionStart ?? el.value.length;\n      setCaret(at);\n      onValueChange(el.value);\n      completion.setValue(el.value, at);\n    },\n    [completion, onValueChange],\n  );\n\n  /** Put `text` in at the caret and leave the caret after it. */\n  const insert = React.useCallback(\n    (text: string) => {\n      const next = value.slice(0, caret) + text + value.slice(caret);\n      landing.current = caret + text.length;\n      onValueChange(next);\n      return { next, at: caret + text.length };\n    },\n    [caret, onValueChange, value],\n  );\n\n  const accept = React.useCallback(() => {\n    if (!ghost) return;\n    insert(ghost);\n    completion.dismiss();\n    fieldRef.current?.focus();\n  }, [completion, ghost, insert]);\n\n  // Taking one word is not a new request and not a second machine: the word goes in, the caret\n  // moves past it, and the offer survives by the same rule that keeps it alive when the reader\n  // types that word themselves. There used to be a `taken` offset here doing it by hand.\n  const acceptWord = React.useCallback(() => {\n    const word = nextWord(ghost);\n    if (!word) return;\n    const { next, at } = insert(word);\n    completion.setValue(next, at);\n  }, [completion, ghost, insert]);\n\n  const request = React.useCallback(() => {\n    const el = fieldRef.current;\n    // Where the offer goes, and the two have to agree. Focusing a field nobody has focused yet puts\n    // the DOM caret at 0 while our own is still at the end, and the ghost would then be drawn in one\n    // place and inserted in another.\n    const at = el && el === document.activeElement ? (el.selectionStart ?? caret) : caret;\n    setCaret(at);\n    completion.ask(value, at);\n    el?.focus();\n    el?.setSelectionRange(at, at);\n  }, [caret, completion, value]);\n\n  const onKeyDown = React.useCallback(\n    (e: React.KeyboardEvent<FieldEl>) => {\n      if (e.defaultPrevented || !ghost) return;\n      // Forward, not right: the key that means \"next word\" is mirrored under RTL, and this is the\n      // one place in the compound where a key stands for a direction.\n      const forward = field.rtl ? \"ArrowLeft\" : \"ArrowRight\";\n      if (e.key === \"Tab\") {\n        e.preventDefault();\n        accept();\n      } else if (e.key === forward && (e.ctrlKey || e.metaKey)) {\n        e.preventDefault();\n        acceptWord();\n      } else if (e.key === \"Escape\") {\n        completion.dismiss();\n      }\n    },\n    [accept, acceptWord, completion, field.rtl, ghost],\n  );\n\n  const ctx: CompleteCtx = {\n    fieldRef, value, ghost, caret,\n    rtl: field.rtl,\n    status: completion.status,\n    error: completion.error,\n    askable: value.trim().length >= (minLength ?? MIN_COMPLETE_LENGTH),\n    metrics: field.metrics,\n    onChange, onKeyDown, syncCaret, accept, request,\n  };\n\n  return (\n    <Ctx.Provider value={ctx}>\n      <ark.div className={cn(\"relative w-full min-w-0\", className)} data-slot=\"complete\" ref={rootRef}>\n        {children}\n        {/* The ghost itself is `aria-hidden` and streams a chunk a frame, so announcing IT would\n            read the same sentence twenty times. This sentence changes once, when there is\n            something to take. */}\n        <ark.span aria-live=\"polite\" className=\"sr-only\" data-slot=\"complete-status\">\n          {ghost ? announcement : \"\"}\n        </ark.span>\n      </ark.div>\n    </Ctx.Provider>\n  );\n}\n\nexport function CompleteTextarea({ children }: { children: React.ReactElement }) {\n  const ctx = useCtx(\"CompleteTextarea\");\n  return (\n    <ark.textarea\n      aria-keyshortcuts={ctx.ghost ? \"Tab Escape\" : undefined}\n      asChild\n      data-slot=\"complete-textarea\"\n      onChange={ctx.onChange}\n      onClick={ctx.syncCaret}\n      onKeyDown={ctx.onKeyDown}\n      onKeyUp={ctx.syncCaret}\n      onSelect={ctx.syncCaret}\n      ref={ctx.fieldRef as React.Ref<HTMLTextAreaElement>}\n      value={ctx.value}\n    >\n      {children}\n    </ark.textarea>\n  );\n}\n\n/**\n * The ✨, bound to the stream — the same mark `SuggestTrigger` wears, so an assisted field looks\n * assisted whichever of the two it has.\n *\n * Pressing it **takes what is on offer and asks when there is nothing**. That is one gesture with\n * two readings on purpose: it is the only way to accept without a keyboard, and the only way back\n * after Escape, which otherwise ends the field's assistance until the next keystroke.\n */\nexport function CompleteMark(\n  props: Omit<AiMarkProps, \"busy\" | \"offering\"> & {\n    /**\n     * The accessible name while a suggestion is on offer, when `label` names the mark at rest.\n     *\n     * @default \"Accept suggestion\"\n     */\n    offeringLabel?: string;\n  }\n) {\n  const { label = \"AI assist\", offeringLabel = \"Accept suggestion\", ...rest } = props;\n  const ctx = useCtx(\"CompleteMark\");\n  const offering = ctx.ghost.length > 0;\n\n  return (\n    <AiMark\n      busy={ctx.status === \"loading\" && !offering}\n      // The one binding that legitimately differs from `SuggestMark`, and it is domain and not\n      // taste: there is nothing to continue below `minLength`, while a candidate source can answer\n      // from an empty field. Everything else about the two marks is bound identically.\n      disabled={!offering && !ctx.askable}\n      label={offering ? offeringLabel : label}\n      offering={offering}\n      onClick={offering ? ctx.accept : ctx.request}\n      {...rest}\n    />\n  );\n}\n\n/**\n * The continuation drawn where it will land, over the field itself. It wraps and scrolls with the\n * field rather than measuring whether a line of it fits.\n */\nexport function CompleteGhost({ className }: { className?: string }) {\n  const ctx = useCtx(\"CompleteGhost\");\n  const boxRef = React.useRef<HTMLDivElement>(null);\n  const [clipped, setClipped] = React.useState(false);\n\n  /**\n   * **A continuation that does not fit makes the field taller. It is not cut.**\n   *\n   * The fade below was the old answer and it was the wrong one: a wrapping field runs out of\n   * *height*, and a mask on the last line still reads as a sentence sliced through the middle of a\n   * line of type — with, on a `block-end` addon, the ✨ and the keys painted over the slice. Seen on\n   * `docs/ai/fields`. An editor gets away with clipping because it can push the following lines\n   * down; a `<textarea>` cannot, because the ghost is not in its value. So the field takes the\n   * height the offer needs while the offer is on the table, and gives it back when it is not — which\n   * is what a textarea does anyway when you type into it. `rows` becomes a floor rather than a fixed\n   * size, which is what `rows` already means.\n   *\n   * **It grows and never shrinks while one offer is live.** Taking a word makes the ghost shorter,\n   * and re-measuring down on every word would make the box jitter under the reader mid-sentence for\n   * no gain — somebody taking a word is about to take another. It resets the moment there is no\n   * ghost, which is every accept, every dismiss and every keystroke that kills the offer.\n   *\n   */\n  React.useLayoutEffect(() => {\n    const el = ctx.fieldRef.current;\n    const box = boxRef.current;\n    if (!el || !box) return;\n    if (!ctx.ghost) {\n      el.style.removeProperty(\"min-height\");\n      return;\n    }\n    // `minHeight` and not `height`, measured: a `block-end` addon turns the group into a column\n    // flex container and the field is `flex: 1 1 0%` in it, so the flex algorithm computes the used\n    // height and an explicit `height` is ignored outright — the inline `104px` was on the element\n    // and the box stayed 64. Raising the floor is what the flex algorithm does honour, and it is\n    // also what this means: `rows` is a floor, and the offer asks for a taller one.\n    const cs = getComputedStyle(el);\n    const needed = box.scrollHeight + px(cs.borderTopWidth) + px(cs.borderBottomWidth);\n    if (needed > el.getBoundingClientRect().height + 1)\n      el.style.setProperty(\"min-height\", `${needed}px`);\n  }, [ctx.fieldRef, ctx.ghost, ctx.value]);\n\n  // An `overflow: hidden` box is still scrollable from script, so the mirror can be parked exactly\n  // where the field parked its own text — which is what lets a ghost longer than the remaining\n  // line be clipped at the edge instead of hidden entirely.\n  React.useLayoutEffect(() => {\n    const el = ctx.fieldRef.current;\n    const box = boxRef.current;\n    if (!el || !box) return;\n    const sync = () => {\n      box.scrollLeft = el.scrollLeft;\n      box.scrollTop = el.scrollTop;\n    };\n    sync();\n    // Does the continuation fit in the space the field actually has? Measured rather than\n    // assumed, because the answer changes with the field's size, with the value, and with every\n    // chunk that arrives — and after the effect above it should be `false` unless a caller pinned\n    // the height.\n    setClipped(box.scrollHeight > box.clientHeight);\n    el.addEventListener(\"scroll\", sync);\n    return () => el.removeEventListener(\"scroll\", sync);\n  }, [ctx.caret, ctx.fieldRef, ctx.value, ctx.ghost]);\n\n\n  const show = ctx.ghost.length > 0;\n  // A caret past the end of the value would split it in the wrong place; the value is the authority.\n  const at = Math.min(ctx.caret, ctx.value.length);\n\n  return (\n    <ark.div\n      aria-hidden\n      className={cn(\n        \"pointer-events-none absolute inset-0 overflow-hidden text-transparent\",\n        \"whitespace-pre-wrap break-words\",\n        // **A continuation that does not fit fades; it is not guillotined.** The box is\n        // `overflow: hidden`, so without this a too-long ghost ends on a hard edge — mid-letter\n        // against the ✨. Applied only when the measurement above says it is genuinely cut, which\n        // is now only when a caller has pinned the field's height.\n        clipped && GHOST_FADE,\n        !show && \"invisible\",\n        className,\n      )}\n      data-slot=\"complete-ghost\"\n      ref={boxRef}\n      style={ctx.metrics}\n    >\n      {/* The value holds its own space so the ghost starts exactly at the caret — `hidden` would\n          collapse it. Split in two rather than one leading run: an offer is made *at* the caret,\n          and what comes after it has to keep its place or the tail of the sentence shifts. */}\n      <ark.span className=\"invisible\">{ctx.value.slice(0, at)}</ark.span>\n      <ark.span className=\"text-faint\">{ctx.ghost}</ark.span>\n      <ark.span className=\"invisible\">{ctx.value.slice(at)}</ark.span>\n    </ark.div>\n  );\n}\n\n/**\n * The keys, while there is something to take.\n *\n * The compound already told one class of reader: the `sr-only` region announces *Press Tab to\n * accept, Escape to dismiss* the moment an offer lands. A sighted keyboard user got nothing —\n * `CompleteHint` carries the keys too, so a composition that uses the ghost taught the gesture\n * nowhere. This is the visible twin of that sentence, and it is a part rather than a fixture\n * because only the caller knows where it fits: beside the ✨ in a `block-end` addon, under the\n * field, nowhere at all on a form of eleven where one line of instruction beats eleven.\n *\n * There is no reference to copy. Gmail taught Tab with a popup shown once ever; Copilot puts a\n * toolbar under the pointer, which is a gesture a keyboard cannot make. Naming the key next to the\n * offer is the version that works for both.\n */\nexport function CompleteKeys({\n  acceptLabel = \"accept\",\n  className,\n  dismissLabel = \"dismiss\",\n}: {\n  /** The word after the `Tab` key. */\n  acceptLabel?: string;\n  className?: string;\n  /** The word after the `Esc` key. */\n  dismissLabel?: string;\n}) {\n  const ctx = useCtx(\"CompleteKeys\");\n  if (!ctx.ghost) return null;\n  return (\n    <ark.span\n      className={cn(\"inline-flex items-center gap-2 text-muted-foreground text-xs\", className)}\n      data-slot=\"complete-keys\"\n    >\n      <ark.span className=\"inline-flex items-center gap-1 whitespace-nowrap\">\n        <Kbd>Tab</Kbd> {acceptLabel}\n      </ark.span>\n      <ark.span className=\"inline-flex items-center gap-1 whitespace-nowrap\">\n        <Kbd>Esc</Kbd> {dismissLabel}\n      </ark.span>\n    </ark.span>\n  );\n}\n\n/** Below-field alternative to `CompleteGhost`, for a field the overlay cannot sit over. */\nexport function CompleteHint({\n  acceptLabel,\n  className,\n  dismissLabel,\n}: {\n  /** The word after the `Tab` key, as on `CompleteKeys`. */\n  acceptLabel?: string;\n  className?: string;\n  /** The word after the `Esc` key, as on `CompleteKeys`. */\n  dismissLabel?: string;\n}) {\n  const ctx = useCtx(\"CompleteHint\");\n  if (!ctx.ghost) return null;\n  return (\n    <ark.p\n      className={cn(\"mt-1.5 whitespace-pre-wrap break-words text-muted-foreground text-sm\", className)}\n      data-slot=\"complete-hint\"\n    >\n      <ark.span className=\"text-faint\">{ctx.ghost.replace(/^\\s+/, \"\")}</ark.span>{\" \"}\n      <CompleteKeys acceptLabel={acceptLabel} dismissLabel={dismissLabel} />\n    </ark.p>\n  );\n}\n\n\n/**\n * What went wrong, in place. Renders nothing when nothing did.\n *\n * `Suggest` has always shown its failures — the strip prints them where the candidates would be —\n * and this side showed none at all: the ✨ stopped spinning and the field said nothing, because\n * `error` was on the hook and no part read it. It is a separate part rather than a line inside\n * `CompleteHint` because the ghost surface is usually `CompleteGhost`, an overlay with no room\n * under it, and a failure has to be readable in both.\n */\nexport function CompleteError({ className }: { className?: string }) {\n  const ctx = useCtx(\"CompleteError\");\n  if (ctx.error === null) return null;\n  return (\n    <ark.p\n      className={cn(\"mt-1.5 text-destructive-foreground text-sm\", className)}\n      data-slot=\"complete-error\"\n      role=\"alert\"\n    >\n      {ctx.error}\n    </ark.p>\n  );\n}\n"],"names":[],"mappings":";;;;;;;AA6CA;AAEE;AACA;AACA;AACF;AAEgB;AACd;AAAc;AAAY;AAAc;AAAa;AAAiB;AACtE;AAAiB;AAAc;AAAgB;AAAiB;AAChE;AAAkB;AAAoB;AACxC;AAaE;AASiD;AAClC;AACA;AACoB;AACC;AACiC;AAEgB;AAErF;AACA;AACF;;AAeoC;AAA8B;AAkB3D;AACL;AAAM;AACW;AACf;AACA;AACA;AACA;AACA;AACA;AACA;AAeF;AACE;AAEA;AAGW;AAKX;AAEA;AACA;AAEA;AACA;AACA;AAEgB;AAGlB;AAgBE;AACA;AACA;AACA;AACE;AACA;AAAA;AAEF;AAAc;AAYhB;AACE;AACA;AACA;AACE;AAAmC;AAErC;AAC8E;AAGhF;AAAuB;AAEnB;AAEA;AAEgC;AAClC;AAC0B;AAIP;AAEjB;AACA;AAEgC;AAClC;AAC4B;;AAI5B;AAGkB;AAOlB;AACA;AACA;AACA;AAA4B;AAI5B;AAKA;AAG0B;AAGJ;AAEpB;AAGA;AACA;AAOa;AAEf;AACiD;AAG1B;AACvB;AAAU;AAAO;AAAO;AACb;AACQ;AACD;AAC4B;AAC/B;AACf;AAAU;AAAW;AAAW;AAAQ;AAG1C;AAGO;AAAA;AAMD;AAIR;AAEO;AACL;AACA;AACE;AAAK;AAAJ;AAC+C;AACvC;AACG;AACI;AACD;AACE;AACF;AACC;AACL;AACE;AAEV;AAAA;AAGP;AAUO;AAUL;AAIA;AACE;AAAC;AAAA;AACoC;AAIP;AACM;AAClC;AACqC;AACjC;AAAA;AAGV;AAMO;AACL;AAsBA;AACE;AAEA;AACA;AACE;AACA;AAAA;AAOF;AAEA;AACkD;AAOlD;AAEA;AACA;AACE;AACmB;AAErB;AAOkD;AAIpD;AAIA;AACE;AAAK;AAAJ;AACY;AACA;AACT;AACA;AAAA;AAAA;AAAA;AAAA;AAKW;AACF;AACT;AAAA;AAEQ;AACL;AACM;AAKX;AAAwD;AACZ;AACS;AAAA;AAAA;AAG3D;AAgBO;AAAsB;AACb;AACd;AAEF;AAQE;AAEE;AAAK;AAAJ;AACwF;AAC7E;AAEV;AACE;AAAQ;AAAM;AAAE;AAClB;AAEE;AAAQ;AAAM;AAAE;AAClB;AAAA;AAAA;AAGN;AAGO;AAAsB;AAC3B;AACA;AAEF;AAOE;AACA;AAEE;AAAK;AAAJ;AACgG;AACrF;AAEV;AAAgE;AAAY;AACR;AAAA;AAAA;AAG1E;AAYO;AACL;AACA;AAEE;AAAK;AAAJ;AACsE;AAC3D;AACL;AAEA;AAAA;AAGX;;;;;;;;;;"}

package/dist/message-part.d.ts

@@ -1,122 +0,0 @@
-import { MessageRole } from './message.js';
-import { RunState } from './task.js';
-/**
- * A turn as a **list of parts**, and the join every component in this package was missing.
- *
- * `Message`, `MessageText`, `Reasoning`, `Tool` and `Task` were each correct and none of them was
- * wired to the next: a host held its own shape and translated into five sets of props by hand.
- * keasy's `AskMessage` is the worked example — it carries `sql`, `reasoning`, `explanation` and a
- * `phase` of `'generating' | 'executing' | 'explaining' | 'done'`, which is a tool part, a reasoning
- * part, a text part and a state, hand-rolled. **That is the second consumer, and it existed before
- * this file did.** So this is not a protocol invented ahead of its need.
- *
- * The shape mirrors the AI SDK's `UIMessage`, deliberately and without depending on it — the four
- * properties that make theirs work are the four copied here:
- *
- * 1. **A message is a list of parts, not a string.** One `.map` with one `switch` on `part.type`
- *    renders a whole turn.
- * 2. **State lives on the part**, so a renderer is told what to draw rather than inferring it.
- * 3. **Generic in metadata and tools**, so a product extends the union instead of forking it.
- * 4. **Transport stays separate.** Ours already is, and is smaller than theirs: a caller passes a
- *    function returning an `AsyncIterable`. Nothing here replaces that seam.
- *
- * ## Four variants, not nine
- *
- * Theirs has nine. `file`, `data-*`, `step-start` and `dynamic-tool` have no call site here, and
- * `source` is **declined rather than deferred**: discovery does not cite a document, it runs a
- * query, and provenance that is a statement plus rows is a tool call. It arrives the day an answer
- * rests on a text somebody wrote.
- *
- * ## The two state vocabularies are the ones already in the package
- *
- * `RunState` — `pending` · `running` · `done` · `failed` — is `Task`'s and `Tool`'s, from one table
- * with one label map and one icon family. It is not restated here, and the reference's
- * `input-streaming | input-available | output-available | output-error` is not adopted: four states
- * under two spellings is the drift this repo keeps deleting.
- *
- * `StreamState` is the other one, and it is two values because text and reasoning have two.
- *
- * ## What this file is not
- *
- * **It renders nothing.** There is no `<Message parts={…} />` here and that is the shape rather than
- * an omission: which part a product renders, in what order, with what chrome around it, is the
- * thing that differs per product — and a component that owned the `switch` would own those answers
- * too. The `switch` belongs to the host; what this gives it is a union exhaustive enough that
- * TypeScript tells the host when a case is missing.
- */
-/** Where a streamed part has got to. Two values, because text and reasoning have two. */
-export type StreamState = "streaming" | "done";
-/** Prose the model wrote. `MessageText` draws it. */
-export interface AiTextPart {
-    type: "text";
-    text: string;
-    state?: StreamState;
-}
-/**
- * The model's own working, folded away. `Reasoning` draws it.
- *
- * **No duration here**, and that is checked rather than assumed: `Reasoning` times itself off the
- * `streaming` transition and renders *Thought for N seconds* from its own state. A `seconds` on the
- * part would be a second measurement of one fact, and the one no component reads.
- */
-export interface AiReasoningPart {
-    type: "reasoning";
-    text: string;
-    state?: StreamState;
-}
-/**
- * One call the model made. `Tool` draws it.
- *
- * `input` and `output` are `unknown` here and **children** at the component: `ToolInput` and
- * `ToolOutput` take what you render rather than a JSON blob, because we always know what the tool
- * was. The part still carries the values, because a host that wants the JSON tree has to have them.
- *
- * `NAME` is the axis a product extends along. Give it a union of your tool names and a `switch` on
- * `part.name` narrows `input` and `output` if you declare them per name.
- */
-export interface AiToolPart<NAME extends string = string> {
-    type: "tool";
-    name: NAME;
-    state?: RunState;
-    input?: unknown;
-    output?: unknown;
-    /** Set when `state` is `failed`. */
-    errorText?: string;
-}
-/**
- * One step of work, ours and with no equivalent in the reference. `Task` draws it.
- *
- * Two fields, because `Task` has two parts: `TaskTitle` takes the words and `TaskStatus` reads the
- * state off the root and says it. There is no list of sub-lines on the part because there is none
- * on the component — a step that wants children is a step whose host renders them.
- */
-export interface AiTaskPart {
-    type: "task";
-    title: string;
-    state?: RunState;
-}
-export type AiMessagePart<NAME extends string = string> = AiTextPart | AiReasoningPart | AiToolPart<NAME> | AiTaskPart;
-/**
- * One turn.
- *
- * `METADATA` is where a product hangs what only it knows — a request id, a cost, who asked. It is
- * unconstrained on purpose: constraining it is how a transport type ends up describing one product.
- */
-export interface AiMessage<METADATA = unknown, NAME extends string = string> {
-    id: string;
-    role: MessageRole;
-    metadata?: METADATA;
-    parts: AiMessagePart<NAME>[];
-}
-/**
- * The guards, because they are what make a host's `switch` readable.
- *
- * Each is a type predicate, so `parts.filter(isToolPart)` is an `AiToolPart[]` and not a cast. That
- * is the whole reason they exist rather than the host writing `part.type === "tool"`: the equality
- * narrows inside a `switch` and does not survive a `.filter`.
- */
-export declare const isTextPart: (part: AiMessagePart) => part is AiTextPart;
-export declare const isReasoningPart: (part: AiMessagePart) => part is AiReasoningPart;
-export declare const isToolPart: <NAME extends string>(part: AiMessagePart<NAME>) => part is AiToolPart<NAME>;
-export declare const isTaskPart: (part: AiMessagePart) => part is AiTaskPart;
-//# sourceMappingURL=message-part.d.ts.map

package/dist/message-part.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"message-part.d.ts","sourceRoot":"","sources":["../src/message-part.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAE1C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2CG;AAEH,yFAAyF;AACzF,MAAM,MAAM,WAAW,GAAG,WAAW,GAAG,MAAM,CAAC;AAE/C,qDAAqD;AACrD,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,WAAW,CAAC;CACrB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,WAAW,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,WAAW,CAAC;CACrB;AAED;;;;;;;;;GASG;AACH,MAAM,WAAW,UAAU,CAAC,IAAI,SAAS,MAAM,GAAG,MAAM;IACtD,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,IAAI,CAAC;IACX,KAAK,CAAC,EAAE,QAAQ,CAAC;IACjB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,oCAAoC;IACpC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,QAAQ,CAAC;CAClB;AAED,MAAM,MAAM,aAAa,CAAC,IAAI,SAAS,MAAM,GAAG,MAAM,IAClD,UAAU,GACV,eAAe,GACf,UAAU,CAAC,IAAI,CAAC,GAChB,UAAU,CAAC;AAEf;;;;;GAKG;AACH,MAAM,WAAW,SAAS,CAAC,QAAQ,GAAG,OAAO,EAAE,IAAI,SAAS,MAAM,GAAG,MAAM;IACzE,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,WAAW,CAAC;IAClB,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,KAAK,EAAE,aAAa,CAAC,IAAI,CAAC,EAAE,CAAC;CAC9B;AAED;;;;;;GAMG;AACH,eAAO,MAAM,UAAU,GAAI,MAAM,aAAa,KAAG,IAAI,IAAI,UAAkC,CAAC;AAE5F,eAAO,MAAM,eAAe,GAAI,MAAM,aAAa,KAAG,IAAI,IAAI,eACnC,CAAC;AAE5B,eAAO,MAAM,UAAU,GAAI,IAAI,SAAS,MAAM,EAC5C,MAAM,aAAa,CAAC,IAAI,CAAC,KACxB,IAAI,IAAI,UAAU,CAAC,IAAI,CAAyB,CAAC;AAEpD,eAAO,MAAM,UAAU,GAAI,MAAM,aAAa,KAAG,IAAI,IAAI,UAAkC,CAAC"}