@kanzo-tech/ai 0.16.0 → 0.17.0

package/dist/message-part.js

@@ -1,8 +0,0 @@
-const s = (t) => t.type === "text", o = (t) => t.type === "reasoning", e = (t) => t.type === "tool", a = (t) => t.type === "task";
-export {
-  o as isReasoningPart,
-  a as isTaskPart,
-  s as isTextPart,
-  e as isToolPart
-};
-//# sourceMappingURL=message-part.js.map

package/dist/message-part.js.map

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

package/dist/message-text.d.ts

@@ -1,44 +0,0 @@
-import { ark } from '@ark-ui/react/factory';
-import * as React from "react";
-/**
- * A streamed answer, arriving a word at a time.
- *
- * The shape is Streamdown's, which is what AI Elements renders an answer and a reasoning block
- * with — `packages/streamdown/lib/animate.ts` and its `styles.css`. Four things are taken from it
- * and each one is a bug this component would otherwise have:
- *
- * 1. **A word, not a chunk.** A model emits tokens and tokens cut words in half; animating what
- *    arrives makes half a word fade in and the other half a frame later. Streamdown splits the
- *    same way and glues the trailing whitespace onto the word before it, so a partial answer never
- *    ends on a naked space either.
- * 2. **Only what is new animates.** Words already on screen are not re-run. Here that falls out of
- *    the key: each word is keyed by its absolute character offset, so React keeps the elements it
- *    already mounted. Keyed by the word itself, the last one remounts on every frame while its own
- *    characters are still arriving — its arrival restarts each time and it flashes instead of
- *    settling. The text only ever grows at the end, which is what makes the offset stable.
- * 3. **A stagger, so a batch cascades instead of flashing.** A stream does not deliver one word per
- *    frame; it delivers twenty at once and then nothing for 200ms. Without a per-word delay the
- *    twenty fade in together, which is a flash — the thing the animation exists to avoid.
- * 4. **A budget on the cascade.** {@link MAX_CASCADE} is Streamdown's `MAX_ANIMATION_BACKLOG_MS`.
- *    A stagger applied naively to a fast stream schedules words further and further ahead of the
- *    text, so an unbounded queue of `opacity: 0` words builds up behind a stream that has already
- *    finished. Compressing the step to fit the budget — floored at {@link MIN_STEP}, so the batch
- *    still cascades rather than collapsing to zero — is what keeps the paint caught up.
- *
- * What is NOT taken, and it is the gap to know about: Streamdown exists mostly to render
- * **incomplete markdown**, closing an unterminated `**bold` or a half-arrived code fence so the
- * answer does not flicker as it completes. This takes a plain string and renders it as text, which
- * has no such problem and also no markdown. A source that streams markdown into this will want
- * that, and it is a dependency rather than a rewrite.
- *
- * Reduced motion is `motion-reduce:animate-none`: with the animation off the words are already at
- * their settled opacity, so there is nothing to unwind.
- */
-export interface MessageTextProps extends Omit<React.ComponentProps<typeof ark.div>, "children"> {
-    /** The answer so far. Grows; never rewritten. */
-    children: string;
-    /** More is coming. Draws the caret, and nothing else — the arrival is per word. */
-    streaming?: boolean;
-}
-export declare const MessageText: (props: MessageTextProps) => React.JSX.Element;
-//# sourceMappingURL=message-text.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"message-text.d.ts","sourceRoot":"","sources":["../src/message-text.tsx"],"names":[],"mappings":"AAEA,OAAO,EAAE,GAAG,EAAE,MAAM,uBAAuB,CAAC;AAC5C,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAG/B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,MAAM,WAAW,gBACf,SAAQ,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,OAAO,GAAG,CAAC,GAAG,CAAC,EAAE,UAAU,CAAC;IAC9D,iDAAiD;IACjD,QAAQ,EAAE,MAAM,CAAC;IACjB,mFAAmF;IACnF,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAYD,eAAO,MAAM,WAAW,GAAI,OAAO,gBAAgB,sBAsDlD,CAAC"}

package/dist/message-text.js

@@ -1,49 +0,0 @@
-"use client";
-import { jsxs as M, jsx as l } from "react/jsx-runtime";
-import { ark as v } from "@ark-ui/react/factory";
-import * as d from "react";
-import { cn as r } from "@kanzo-tech/ui";
-const w = /\S+\s*/g, h = 18, A = 320, N = 4, b = (p) => {
-  const { children: a, streaming: n = !1, className: u, slot: g, ...f } = p, o = d.useRef(n ? 0 : a.length), s = [...a.matchAll(w)], e = s.findIndex((t) => t.index >= o.current), i = e < 0 ? 0 : s.length - e, x = i > 1 ? Math.max(N, Math.min(h, A / (i - 1))) : h;
-  return d.useLayoutEffect(() => {
-    o.current = a.length;
-  }), /* @__PURE__ */ M(
-    v.div,
-    {
-      className: r("min-w-0 whitespace-pre-wrap break-words", u),
-      "data-streaming": n || void 0,
-      ...f,
-      "data-slot": g ?? "message-text",
-      children: [
-        s.map((t, m) => {
-          const c = e >= 0 && m >= e;
-          return /* @__PURE__ */ l(
-            "span",
-            {
-              className: r(c && "animate-arrive motion-reduce:animate-none"),
-              style: c ? { animationDelay: `${Math.round((m - e) * x)}ms` } : void 0,
-              children: t[0]
-            },
-            t.index
-          );
-        }),
-        /* @__PURE__ */ l(
-          "span",
-          {
-            "aria-hidden": !0,
-            className: r(
-              "ms-0.5 inline-block h-[1em] w-[0.5ch] align-[-0.1em] bg-current",
-              "animate-pulse motion-reduce:animate-none",
-              !n && "hidden"
-            ),
-            "data-slot": "message-caret"
-          }
-        )
-      ]
-    }
-  );
-};
-export {
-  b as MessageText
-};
-//# sourceMappingURL=message-text.js.map

package/dist/message-text.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"message-text.js","sources":["../src/message-text.tsx"],"sourcesContent":["\"use client\";\n\nimport { ark } from \"@ark-ui/react/factory\";\nimport * as React from \"react\";\nimport { cn } from \"@kanzo-tech/ui\";\n\n/**\n * A streamed answer, arriving a word at a time.\n *\n * The shape is Streamdown's, which is what AI Elements renders an answer and a reasoning block\n * with — `packages/streamdown/lib/animate.ts` and its `styles.css`. Four things are taken from it\n * and each one is a bug this component would otherwise have:\n *\n * 1. **A word, not a chunk.** A model emits tokens and tokens cut words in half; animating what\n *    arrives makes half a word fade in and the other half a frame later. Streamdown splits the\n *    same way and glues the trailing whitespace onto the word before it, so a partial answer never\n *    ends on a naked space either.\n * 2. **Only what is new animates.** Words already on screen are not re-run. Here that falls out of\n *    the key: each word is keyed by its absolute character offset, so React keeps the elements it\n *    already mounted. Keyed by the word itself, the last one remounts on every frame while its own\n *    characters are still arriving — its arrival restarts each time and it flashes instead of\n *    settling. The text only ever grows at the end, which is what makes the offset stable.\n * 3. **A stagger, so a batch cascades instead of flashing.** A stream does not deliver one word per\n *    frame; it delivers twenty at once and then nothing for 200ms. Without a per-word delay the\n *    twenty fade in together, which is a flash — the thing the animation exists to avoid.\n * 4. **A budget on the cascade.** {@link MAX_CASCADE} is Streamdown's `MAX_ANIMATION_BACKLOG_MS`.\n *    A stagger applied naively to a fast stream schedules words further and further ahead of the\n *    text, so an unbounded queue of `opacity: 0` words builds up behind a stream that has already\n *    finished. Compressing the step to fit the budget — floored at {@link MIN_STEP}, so the batch\n *    still cascades rather than collapsing to zero — is what keeps the paint caught up.\n *\n * What is NOT taken, and it is the gap to know about: Streamdown exists mostly to render\n * **incomplete markdown**, closing an unterminated `**bold` or a half-arrived code fence so the\n * answer does not flicker as it completes. This takes a plain string and renders it as text, which\n * has no such problem and also no markdown. A source that streams markdown into this will want\n * that, and it is a dependency rather than a rewrite.\n *\n * Reduced motion is `motion-reduce:animate-none`: with the animation off the words are already at\n * their settled opacity, so there is nothing to unwind.\n */\nexport interface MessageTextProps\n  extends Omit<React.ComponentProps<typeof ark.div>, \"children\"> {\n  /** The answer so far. Grows; never rewritten. */\n  children: string;\n  /** More is coming. Draws the caret, and nothing else — the arrival is per word. */\n  streaming?: boolean;\n}\n\n/** A run of non-space plus the space that follows it, so the whitespace travels with its word. */\nconst WORD = /\\S+\\s*/g;\n\n/** Milliseconds between two words of one batch, before the budget below compresses it. */\nconst STAGGER = 18;\n/** How far ahead of the text a batch may schedule. Streamdown's `MAX_ANIMATION_BACKLOG_MS`. */\nconst MAX_CASCADE = 320;\n/** The step never falls below this, so a compressed batch still cascades. Streamdown's floor. */\nconst MIN_STEP = 4;\n\nexport const MessageText = (props: MessageTextProps) => {\n  const { children, streaming = false, className, slot, ...rest } = props;\n\n  // What was on screen when the last render committed. **A message that mounts complete did not\n  // arrive**, so one that is not streaming at mount starts with all of it settled and animates\n  // nothing — a transcript loaded from history should not replay itself.\n  const settled = React.useRef(streaming ? 0 : children.length);\n\n  const words = [...children.matchAll(WORD)];\n  const from = words.findIndex((word) => word.index >= settled.current);\n  const fresh = from < 0 ? 0 : words.length - from;\n  const step =\n    fresh > 1 ? Math.max(MIN_STEP, Math.min(STAGGER, MAX_CASCADE / (fresh - 1))) : STAGGER;\n\n  // After paint, not during render: a ref written in the render body is wrong under StrictMode's\n  // double invoke, which is the same hazard Streamdown answers with `mark`/`rewind`.\n  React.useLayoutEffect(() => {\n    settled.current = children.length;\n  });\n\n  return (\n    <ark.div\n      className={cn(\"min-w-0 whitespace-pre-wrap break-words\", className)}\n      data-streaming={streaming || undefined}\n      {...rest}\n      data-slot={slot ?? \"message-text\"}\n    >\n      {words.map((word, index) => {\n        const arriving = from >= 0 && index >= from;\n        return (\n          <span\n            className={cn(arriving && \"animate-arrive motion-reduce:animate-none\")}\n            key={word.index}\n            style={arriving ? { animationDelay: `${Math.round((index - from) * step)}ms` } : undefined}\n          >\n            {word[0]}\n          </span>\n        );\n      })}\n      {/* Always rendered, hidden rather than unmounted: a component that renders one shape while\n          streaming and another when done re-mounts every word at the moment it finishes, and the\n          whole answer arrives a second time. `aria-hidden` because a caret is not content — the\n          live region that announces the turn is the caller's. */}\n      <span\n        aria-hidden\n        className={cn(\n          \"ms-0.5 inline-block h-[1em] w-[0.5ch] align-[-0.1em] bg-current\",\n          \"animate-pulse motion-reduce:animate-none\",\n          !streaming && \"hidden\",\n        )}\n        data-slot=\"message-caret\"\n      />\n    </ark.div>\n  );\n};\n"],"names":[],"mappings":";;;;;AAiDA;AAUE;AAeA;AACE;AAA2B;AAI3B;AAAK;AAAJ;AACmE;AACrC;AACzB;AACe;AAElB;AACC;AACA;AACE;AAAC;AAAA;AACsE;AAEY;AAE1E;AAAA;AAHG;AAAA;AAMf;AAKD;AAAC;AAAA;AACY;AACA;AACT;AACA;AACc;AAAA;AAEN;AAAA;AAAA;AACZ;AAAA;AAGN;;;;"}

package/dist/suggest.d.ts

@@ -1,82 +0,0 @@
-import { ark } from '@ark-ui/react/factory';
-import { Suggestions } from '@kanzo-tech/ui';
-import { AiMarkProps } from './ai-mark.js';
-import { Candidate } from './types.js';
-import * as React from "react";
-/** When the source is asked. */
-export type SuggestTrigger = 
-/** On a press of the ✨. Nothing is requested until somebody asks for it. */
-"press"
-/** As soon as the field takes focus. Prefetches, and bills a model for a tab-through. */
- | "focus";
-export interface SuggestRootProps extends Omit<React.ComponentProps<typeof ark.div>, "onSelect"> {
-    /** The source. Yields candidates; honour the `AbortSignal`. */
-    suggest: (signal?: AbortSignal) => AsyncIterable<Candidate>;
-    /** What the field already holds — these are never offered back. */
-    existing?: string[];
-    /** Where a chosen value goes. */
-    onPick: (value: string) => void;
-    /**
-     * How many to take from the stream.
-     *
-     * @default 6
-     */
-    limit?: number;
-    /**
-     * @default "press"
-     */
-    trigger?: SuggestTrigger;
-}
-/**
- * Candidate values for one field, offered **in the flow underneath it**.
- *
- * This replaced a popover, and the popover is the whole story. Hiding the candidates behind a door
- * bought nothing and cost six workarounds, every one of them downstream of the door and not of the
- * candidates: a non-modal popover, because a modal one put `pointer-events: none` on the very field
- * the values were for; a `data-autofocus`, because a popover has to hand focus somewhere; a
- * `Delete`/`Backspace` handler, because a button inside `role="option"` is unreachable by Tab; a
- * shared label id, because a popover names itself from a title and a listbox from a label; a ✕ that
- * had to be quieted because an offer looked identical to a committed tag; and a three-row window
- * with a refill loop in the hook to keep it full. None of them exist here.
- *
- * **Focus decides visibility, a press decides billing**, and they are deliberately not the same
- * gesture. The strip appears while the field has focus and there is something to show — which is
- * what keeps a form of eleven fields from becoming a wall, since only one field is focused at a
- * time. Asking is `trigger`, and it defaults to a press: a source that fires on focus bills a model
- * for a tab-through, and that is a decision a caller should make on purpose.
- */
-export declare function SuggestRoot(props: SuggestRootProps): React.JSX.Element;
-/**
- * The ✨ — **a mark, not a door.**
- *
- * At rest it says the field is model-assisted, which a reader can see without touching anything.
- * Pressing it asks. It no longer opens or closes a layer, so there is no `data-state` to light it
- * from and nothing to trap focus in.
- */
-export declare function SuggestMark(props: Omit<AiMarkProps, "busy" | "offering"> & {
-    /**
-     * The accessible name while candidates are on offer, when `label` names the mark at rest.
-     *
-     * @default "Suggest different values"
-     */
-    offeringLabel?: string;
-}): React.JSX.Element;
-export interface SuggestListProps extends React.ComponentProps<typeof Suggestions> {
-    /** Shown while the source is answering and has produced nothing yet. */
-    pending?: React.ReactNode;
-    /** Shown when the source finished with nothing to offer. */
-    empty?: React.ReactNode;
-}
-/**
- * The strip, and the only part that decides whether anything is on screen.
- *
- * It renders `Suggestions` from `@kanzo-tech/ui` — a row of buttons that knows nothing about a
- * model — so everything model-shaped stays on this side of the boundary: the ✨, the engine, and
- * the rationale that comes back with a candidate.
- *
- * The rationale is the highlighted pill's `title` rather than a line under the strip. The line was
- * tried and it moved the layout on every hover; a `title` is the browser's own tooltip, reaches the
- * keyboard through focus, and costs no box.
- */
-export declare function SuggestList(props: SuggestListProps): React.JSX.Element | null;
-//# sourceMappingURL=suggest.d.ts.map

package/dist/suggest.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"suggest.d.ts","sourceRoot":"","sources":["../src/suggest.tsx"],"names":[],"mappings":"AAGA,OAAO,EAAE,GAAG,EAAE,MAAM,uBAAuB,CAAC;AAC5C,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,EAAgD,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC3F,OAAO,EAAU,KAAK,WAAW,EAAE,MAAM,cAAc,CAAC;AAIxD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAqB5C,gCAAgC;AAChC,MAAM,MAAM,cAAc;AACxB,4EAA4E;AAC1E,OAAO;AACT,yFAAyF;GACvF,OAAO,CAAC;AAEZ,MAAM,WAAW,gBACf,SAAQ,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,OAAO,GAAG,CAAC,GAAG,CAAC,EAAE,UAAU,CAAC;IAC9D,+DAA+D;IAC/D,OAAO,EAAE,CAAC,MAAM,CAAC,EAAE,WAAW,KAAK,aAAa,CAAC,SAAS,CAAC,CAAC;IAC5D,mEAAmE;IACnE,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,iCAAiC;IACjC,MAAM,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAChC;;;;OAIG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;OAEG;IACH,OAAO,CAAC,EAAE,cAAc,CAAC;CAC1B;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,gBAAgB,qBA2ElD;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CACzB,KAAK,EAAE,IAAI,CAAC,WAAW,EAAE,MAAM,GAAG,UAAU,CAAC,GAAG;IAC9C;;;;OAIG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB,qBAoBF;AAED,MAAM,WAAW,gBAAiB,SAAQ,KAAK,CAAC,cAAc,CAAC,OAAO,WAAW,CAAC;IAChF,wEAAwE;IACxE,OAAO,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B,4DAA4D;IAC5D,KAAK,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;CACzB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,gBAAgB,4BAiElD"}

package/dist/suggest.js

@@ -1,123 +0,0 @@
-"use client";
-import { jsx as r, jsxs as x } from "react/jsx-runtime";
-import { XIcon as w } from "lucide-react";
-import { ark as d } from "@ark-ui/react/factory";
-import * as f from "react";
-import { ButtonGroup as L, Suggestion as M, Button as P, Spinner as R, Suggestions as T, cn as h } from "@kanzo-tech/ui";
-import { AiMark as j } from "./ai-mark.js";
-import { useSuggestions as A } from "./use-ai.js";
-const S = f.createContext(null), k = (o) => {
-  const n = f.useContext(S);
-  if (!n) throw new Error(`${o} must render inside <SuggestRoot>`);
-  return n;
-};
-function I(o) {
-  const {
-    suggest: n,
-    existing: c,
-    onPick: l,
-    limit: m,
-    trigger: a = "press",
-    children: t,
-    className: u,
-    onBlur: e,
-    onFocus: g,
-    slot: v,
-    ...b
-  } = o, s = A({ suggest: n, existing: c, limit: m }), [N, p] = f.useState(!1), y = (i) => {
-    l(i), s.dismiss(i);
-  }, C = () => {
-    s.status !== "loading" && (s.status === "error" || s.items.length > 0 ? s.refresh() : s.ask());
-  };
-  return /* @__PURE__ */ r(
-    S.Provider,
-    {
-      value: {
-        candidates: s.items,
-        status: s.status,
-        error: s.error,
-        active: N,
-        ask: C,
-        pick: y,
-        dismiss: s.dismiss
-      },
-      children: /* @__PURE__ */ r(
-        d.div,
-        {
-          className: h("flex w-full min-w-0 flex-col gap-2", u),
-          onBlur: (i) => {
-            e == null || e(i), i.currentTarget.contains(i.relatedTarget) || p(!1);
-          },
-          onFocus: (i) => {
-            g == null || g(i), p(!0), a === "focus" && s.ask();
-          },
-          ...b,
-          "data-slot": v ?? "suggest",
-          children: t
-        }
-      )
-    }
-  );
-}
-function X(o) {
-  const { label: n = "Suggest", offeringLabel: c = "Suggest different values", onClick: l, ...m } = o, a = k("SuggestMark"), t = a.candidates.length > 0;
-  return /* @__PURE__ */ r(
-    j,
-    {
-      busy: a.status === "loading" && !t,
-      label: t ? c : n,
-      offering: t,
-      onClick: (u) => {
-        l == null || l(u), u.defaultPrevented || a.ask();
-      },
-      ...m
-    }
-  );
-}
-function q(o) {
-  const { className: n, empty: c, pending: l, slot: m, ...a } = o, t = k("SuggestList");
-  if (!t.active) return null;
-  const u = t.error !== null ? /* @__PURE__ */ r(d.p, { className: "text-destructive-foreground text-sm", "data-slot": "suggest-error", children: t.error }) : t.candidates.length > 0 ? t.candidates.map((e) => {
-    const g = e.label ?? e.value;
-    return (
-      // **Two buttons, so a group — not a ✕ inside the pill.** `Suggestion` *is* a
-      // `<button>`, and a button inside a button is not a thing the DOM has; the dismiss has
-      // to be a sibling. `ButtonGroup` is the house cluster: it collapses the inner radii and
-      // overlaps the shared border, so the pair reads as one pill with a divided end, and it
-      // requires the accessible name that a `role="group"` owes.
-      /* @__PURE__ */ x(L, { "aria-label": g, slot: "suggest-item", children: [
-        /* @__PURE__ */ r(M, { onSelect: t.pick, title: e.rationale, value: e.value, children: g }),
-        /* @__PURE__ */ r(
-          P,
-          {
-            "aria-label": `Dismiss ${g}`,
-            className: "h-auto min-h-[24px] self-stretch px-2 py-1",
-            onClick: () => t.dismiss(e.value),
-            pill: !0,
-            size: "sm",
-            slot: "suggest-dismiss",
-            variant: "outline",
-            children: /* @__PURE__ */ r(w, {})
-          }
-        )
-      ] }, e.value)
-    );
-  }) : t.status === "loading" ? l ?? /* @__PURE__ */ x(
-    d.span,
-    {
-      className: "inline-flex items-center gap-2 text-muted-foreground text-sm",
-      "data-slot": "suggest-pending",
-      children: [
-        /* @__PURE__ */ r(R, { "aria-hidden": !0 }),
-        "Thinking…"
-      ]
-    }
-  ) : t.status === "ready" ? c ?? /* @__PURE__ */ r(d.span, { className: "text-muted-foreground text-sm", "data-slot": "suggest-empty", children: "Nothing to suggest." }) : null;
-  return u === null ? null : /* @__PURE__ */ r(T, { className: h("min-h-8", n), ...a, slot: m ?? "suggest-list", children: u });
-}
-export {
-  q as SuggestList,
-  X as SuggestMark,
-  I as SuggestRoot
-};
-//# sourceMappingURL=suggest.js.map

package/dist/suggest.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"suggest.js","sources":["../src/suggest.tsx"],"sourcesContent":["\"use client\";\n\nimport { XIcon } from \"lucide-react\";\nimport { ark } from \"@ark-ui/react/factory\";\nimport * as React from \"react\";\nimport { Button, ButtonGroup, cn, Spinner, Suggestion, Suggestions } from \"@kanzo-tech/ui\";\nimport { AiMark, type AiMarkProps } from \"./ai-mark.js\";\n// No alias any more, and that is the whole of this rename: the type and `@kanzo-tech/ui`'s\n// `Suggestion` component were both in scope in this file, both on public barrels, and one of them\n// had to be renamed at the import to be usable at all.\nimport type { Candidate } from \"./types.js\";\nimport { type AiStatus, useSuggestions } from \"./use-ai.js\";\n\ninterface SuggestCtx {\n  candidates: Candidate[];\n  status: AiStatus;\n  error: string | null;\n  /** The field, or something inside it, holds focus. */\n  active: boolean;\n  ask: () => void;\n  pick: (value: string) => void;\n  dismiss: (value: string) => void;\n}\n\nconst Ctx = React.createContext<SuggestCtx | null>(null);\nconst useCtx = (part: string): SuggestCtx => {\n  const context = React.useContext(Ctx);\n  if (!context) throw new Error(`${part} must render inside <SuggestRoot>`);\n  return context;\n};\n\n/** When the source is asked. */\nexport type SuggestTrigger =\n  /** On a press of the ✨. Nothing is requested until somebody asks for it. */\n  | \"press\"\n  /** As soon as the field takes focus. Prefetches, and bills a model for a tab-through. */\n  | \"focus\";\n\nexport interface SuggestRootProps\n  extends Omit<React.ComponentProps<typeof ark.div>, \"onSelect\"> {\n  /** The source. Yields candidates; honour the `AbortSignal`. */\n  suggest: (signal?: AbortSignal) => AsyncIterable<Candidate>;\n  /** What the field already holds — these are never offered back. */\n  existing?: string[];\n  /** Where a chosen value goes. */\n  onPick: (value: string) => void;\n  /**\n   * How many to take from the stream.\n   *\n   * @default 6\n   */\n  limit?: number;\n  /**\n   * @default \"press\"\n   */\n  trigger?: SuggestTrigger;\n}\n\n/**\n * Candidate values for one field, offered **in the flow underneath it**.\n *\n * This replaced a popover, and the popover is the whole story. Hiding the candidates behind a door\n * bought nothing and cost six workarounds, every one of them downstream of the door and not of the\n * candidates: a non-modal popover, because a modal one put `pointer-events: none` on the very field\n * the values were for; a `data-autofocus`, because a popover has to hand focus somewhere; a\n * `Delete`/`Backspace` handler, because a button inside `role=\"option\"` is unreachable by Tab; a\n * shared label id, because a popover names itself from a title and a listbox from a label; a ✕ that\n * had to be quieted because an offer looked identical to a committed tag; and a three-row window\n * with a refill loop in the hook to keep it full. None of them exist here.\n *\n * **Focus decides visibility, a press decides billing**, and they are deliberately not the same\n * gesture. The strip appears while the field has focus and there is something to show — which is\n * what keeps a form of eleven fields from becoming a wall, since only one field is focused at a\n * time. Asking is `trigger`, and it defaults to a press: a source that fires on focus bills a model\n * for a tab-through, and that is a decision a caller should make on purpose.\n */\nexport function SuggestRoot(props: SuggestRootProps) {\n  const {\n    suggest,\n    existing,\n    onPick,\n    limit,\n    trigger = \"press\",\n    children,\n    className,\n    onBlur,\n    onFocus,\n    slot,\n    ...rest\n  } = props;\n\n  const controller = useSuggestions({ suggest, existing, limit });\n  const [active, setActive] = React.useState(false);\n\n  const pick = (value: string) => {\n    onPick(value);\n    // A taken candidate is no longer a candidate. Nothing refills — the strip simply gets shorter,\n    // which is the honest picture of a source that has already answered.\n    controller.dismiss(value);\n  };\n\n  /**\n   * **One meaning for a press, in both compounds: give me the assistance.**\n   *\n   * `Complete` reads that as *take the continuation* when there is one, because a ghost is a single\n   * offer that needs a gesture to accept. A strip is N offers that already carry their own buttons,\n   * so here the next useful thing is a different set — and after a failure it is a retry. The hook's\n   * `ask` stays strict (idle only, so a press cannot re-bill a source that already answered) and\n   * this is where the policy lives, which is why it is in the compound and not in `AiMark`.\n   *\n   * Loading is the one state where nothing happens: the mark is a spinner then, and a spinner you\n   * can press is a lie.\n   */\n  const press = () => {\n    if (controller.status === \"loading\") return;\n    if (controller.status === \"error\" || controller.items.length > 0) controller.refresh();\n    else controller.ask();\n  };\n\n  return (\n    <Ctx.Provider\n      value={{\n        candidates: controller.items,\n        status: controller.status,\n        error: controller.error,\n        active,\n        ask: press,\n        pick,\n        dismiss: controller.dismiss,\n      }}\n    >\n      <ark.div\n        className={cn(\"flex w-full min-w-0 flex-col gap-2\", className)}\n        onBlur={(event) => {\n          onBlur?.(event);\n          // `relatedTarget` is where focus is going. Inside our own subtree it is a pill being\n          // clicked or the ✨ being tabbed to, and the strip must survive both.\n          if (!event.currentTarget.contains(event.relatedTarget)) setActive(false);\n        }}\n        onFocus={(event) => {\n          onFocus?.(event);\n          setActive(true);\n          if (trigger === \"focus\") controller.ask();\n        }}\n        {...rest}\n        data-slot={slot ?? \"suggest\"}\n      >\n        {children}\n      </ark.div>\n    </Ctx.Provider>\n  );\n}\n\n/**\n * The ✨ — **a mark, not a door.**\n *\n * At rest it says the field is model-assisted, which a reader can see without touching anything.\n * Pressing it asks. It no longer opens or closes a layer, so there is no `data-state` to light it\n * from and nothing to trap focus in.\n */\nexport function SuggestMark(\n  props: Omit<AiMarkProps, \"busy\" | \"offering\"> & {\n    /**\n     * The accessible name while candidates are on offer, when `label` names the mark at rest.\n     *\n     * @default \"Suggest different values\"\n     */\n    offeringLabel?: string;\n  }\n) {\n  const { label = \"Suggest\", offeringLabel = \"Suggest different values\", onClick, ...rest } = props;\n  const ctx = useCtx(\"SuggestMark\");\n  // Bound exactly as `CompleteMark` binds it. A mark that paints one way over a ghost and another\n  // over a strip reads as two products; `ai-mark.test.tsx` is the guard on that.\n  const offering = ctx.candidates.length > 0;\n\n  return (\n    <AiMark\n      busy={ctx.status === \"loading\" && !offering}\n      label={offering ? offeringLabel : label}\n      offering={offering}\n      onClick={(event) => {\n        onClick?.(event);\n        if (!event.defaultPrevented) ctx.ask();\n      }}\n      {...rest}\n    />\n  );\n}\n\nexport interface SuggestListProps extends React.ComponentProps<typeof Suggestions> {\n  /** Shown while the source is answering and has produced nothing yet. */\n  pending?: React.ReactNode;\n  /** Shown when the source finished with nothing to offer. */\n  empty?: React.ReactNode;\n}\n\n/**\n * The strip, and the only part that decides whether anything is on screen.\n *\n * It renders `Suggestions` from `@kanzo-tech/ui` — a row of buttons that knows nothing about a\n * model — so everything model-shaped stays on this side of the boundary: the ✨, the engine, and\n * the rationale that comes back with a candidate.\n *\n * The rationale is the highlighted pill's `title` rather than a line under the strip. The line was\n * tried and it moved the layout on every hover; a `title` is the browser's own tooltip, reaches the\n * keyboard through focus, and costs no box.\n */\nexport function SuggestList(props: SuggestListProps) {\n  const { className, empty, pending, slot, ...rest } = props;\n  const ctx = useCtx(\"SuggestList\");\n\n  if (!ctx.active) return null;\n\n  const body =\n    ctx.error !== null ? (\n      <ark.p className=\"text-destructive-foreground text-sm\" data-slot=\"suggest-error\">\n        {ctx.error}\n      </ark.p>\n    ) : ctx.candidates.length > 0 ? (\n      ctx.candidates.map((candidate) => {\n        const label = candidate.label ?? candidate.value;\n        return (\n          // **Two buttons, so a group — not a ✕ inside the pill.** `Suggestion` *is* a\n          // `<button>`, and a button inside a button is not a thing the DOM has; the dismiss has\n          // to be a sibling. `ButtonGroup` is the house cluster: it collapses the inner radii and\n          // overlaps the shared border, so the pair reads as one pill with a divided end, and it\n          // requires the accessible name that a `role=\"group\"` owes.\n          <ButtonGroup aria-label={label} key={candidate.value} slot=\"suggest-item\">\n            <Suggestion onSelect={ctx.pick} title={candidate.rationale} value={candidate.value}>\n              {label}\n            </Suggestion>\n            {/* Always drawn, never on hover: a hover-only control is unreachable by a keyboard and\n                absent on a touch pointer, and this strip is explicitly reachable by Tab. */}\n            <Button\n              aria-label={`Dismiss ${label}`}\n              className=\"h-auto min-h-[24px] self-stretch px-2 py-1\"\n              onClick={() => ctx.dismiss(candidate.value)}\n              pill\n              size=\"sm\"\n              slot=\"suggest-dismiss\"\n              variant=\"outline\"\n            >\n              <XIcon />\n            </Button>\n          </ButtonGroup>\n        );\n      })\n    ) : ctx.status === \"loading\" ? (\n      (pending ?? (\n        <ark.span\n          className=\"inline-flex items-center gap-2 text-muted-foreground text-sm\"\n          data-slot=\"suggest-pending\"\n        >\n          <Spinner aria-hidden />\n          Thinking…\n        </ark.span>\n      ))\n    ) : ctx.status === \"ready\" ? (\n      (empty ?? (\n        <ark.span className=\"text-muted-foreground text-sm\" data-slot=\"suggest-empty\">\n          Nothing to suggest.\n        </ark.span>\n      ))\n    ) : null;\n\n  if (body === null) return null;\n\n  return (\n    <Suggestions className={cn(\"min-h-8\", className)} {...rest} slot={slot ?? \"suggest-list\"}>\n      {body}\n    </Suggestions>\n  );\n}\n"],"names":[],"mappings":";;;;;;;;AAwBA;AAEE;AACA;AACA;AACF;AA+CO;AACL;AAAM;AACJ;AACA;AACA;AACA;AACU;AACV;AACA;AACA;AACA;AACA;AACG;AAOH;AAGwB;AAgBxB;AAEgB;AAGlB;AACE;AAAK;AAAJ;AACQ;AACkB;AACJ;AACD;AAClB;AACK;AACL;AACoB;AAAA;AAGtB;AAAK;AAAJ;AAC8D;AAE3D;AAGuE;AACzE;AAEE;AAEoC;AACtC;AACI;AACe;AAElB;AAAA;AAAA;AACH;AAGN;AASO;AAUL;AAMA;AACE;AAAC;AAAA;AACoC;AACD;AAClC;AAEE;AACiC;AACnC;AACI;AAAA;AAGV;AAoBO;AACL;AAGA;AAEA;AAOM;AACA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAOI;AAEA;AAGA;AAAC;AAAA;AAC6B;AAClB;AACgC;AACtC;AACC;AACA;AACG;AAED;AAAA;AAAA;AAEX;AAAA;AAKF;AAAK;AAAJ;AACW;AACA;AAEV;AAAqB;AAAE;AAAA;AAAA;AAY/B;AAOF;;;;;;"}

package/dist/task.d.ts

@@ -1,48 +0,0 @@
-import { ark } from '@ark-ui/react/factory';
-import * as React from "react";
-/**
- * The life of one step. Shared with `Tool`, which imports it — a tool call is a step with a name,
- * and giving the two their own four-word vocabularies is how they end up disagreeing.
- */
-export type RunState = "pending" | "running" | "done" | "failed";
-/** The word for each state, in one place because `Tool`'s badge says the same four. */
-export declare const RUN_LABEL: Record<RunState, string>;
-/**
- * The mark for each state — **shared with `Tool`, which imports it.** One icon family at one
- * stroke weight, tinted by the family's own `-foreground` token, which for a status family is the
- * readable-on-the-page variant rather than ink on a fill (`tokens.css` states both meanings).
- *
- * This was four `Status` dots, and `Status` is a presence dot: its recipe carries `ring-2
- * ring-background`, a halo for sitting on an avatar, which cut a 2px hole in the rail the marks
- * stand on. Fighting it took a `size-4` override of `size="lg"`'s 12px and a `bg-transparent
- * ring-1` hollowing for pending — a primitive argued with in three places is the wrong primitive.
- * `Tool` already drew these four states as icons; now there is one drawing of them, not two.
- *
- * Unsized on purpose: the parent sizes the glyph, so the same table serves a 16px rail mark and a
- * 12px badge icon.
- */
-export declare const RUN_MARK: Record<RunState, React.ReactNode>;
-export declare const TaskList: (props: React.ComponentProps<typeof ark.ol>) => React.JSX.Element;
-export interface TaskProps extends React.ComponentProps<typeof ark.li> {
-    state?: RunState;
-}
-/**
- * One labelled step. The state is declared here and read off `data-state` by the parts.
- *
- * The rail through the markers is the step's own `::after` rather than a border on the list: a run
- * of five has to read as one run, and the last step must not trail a line into nothing.
- */
-export declare const Task: (props: TaskProps) => React.JSX.Element;
-export declare const TaskTitle: (props: React.ComponentProps<typeof ark.span>) => React.JSX.Element;
-/**
- * The step's marker — {@link RUN_MARK} for this step's state, in a box the rail runs out of.
- *
- * The mark is decorative to a screen reader; the word beside it is what carries the state, and it
- * is written here as `sr-only` rather than assumed of the title. Pass children to say it in your
- * own words.
- *
- * The box is `size-5` and centred so the mark lands on the first line's optical centre: `text-sm`
- * is a 20px line box, and a marker aligned to the top of a wrapping title sits above its own text.
- */
-export declare const TaskStatus: (props: React.ComponentProps<typeof ark.span>) => React.JSX.Element;
-//# sourceMappingURL=task.d.ts.map

package/dist/task.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"task.d.ts","sourceRoot":"","sources":["../src/task.tsx"],"names":[],"mappings":"AAEA,OAAO,EAAE,GAAG,EAAE,MAAM,uBAAuB,CAAC;AAE5C,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAG/B;;;GAGG;AACH,MAAM,MAAM,QAAQ,GAAG,SAAS,GAAG,SAAS,GAAG,MAAM,GAAG,QAAQ,CAAC;AAEjE,uFAAuF;AACvF,eAAO,MAAM,SAAS,EAAE,MAAM,CAAC,QAAQ,EAAE,MAAM,CAK9C,CAAC;AAEF;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE,KAAK,CAAC,SAAS,CAKtD,CAAC;AAkBF,eAAO,MAAM,QAAQ,GAAI,OAAO,KAAK,CAAC,cAAc,CAAC,OAAO,GAAG,CAAC,EAAE,CAAC,sBAalE,CAAC;AAEF,MAAM,WAAW,SAAU,SAAQ,KAAK,CAAC,cAAc,CAAC,OAAO,GAAG,CAAC,EAAE,CAAC;IACpE,KAAK,CAAC,EAAE,QAAQ,CAAC;CAClB;AAED;;;;;GAKG;AACH,eAAO,MAAM,IAAI,GAAI,OAAO,SAAS,sBAoBpC,CAAC;AAEF,eAAO,MAAM,SAAS,GAAI,OAAO,KAAK,CAAC,cAAc,CAAC,OAAO,GAAG,CAAC,IAAI,CAAC,sBAUrE,CAAC;AAEF;;;;;;;;;GASG;AACH,eAAO,MAAM,UAAU,GAAI,OAAO,KAAK,CAAC,cAAc,CAAC,OAAO,GAAG,CAAC,IAAI,CAAC,sBAmBtE,CAAC"}

package/dist/task.js

@@ -1,91 +0,0 @@
-"use client";
-import { jsx as s, jsxs as u } from "react/jsx-runtime";
-import { ark as o } from "@ark-ui/react/factory";
-import { CircleXIcon as f, CircleCheckIcon as m, CircleDashedIcon as g } from "lucide-react";
-import * as c from "react";
-import { cn as l, Spinner as p } from "@kanzo-tech/ui";
-const x = {
-  pending: "Pending",
-  running: "Running",
-  done: "Done",
-  failed: "Failed"
-}, k = {
-  pending: /* @__PURE__ */ s(g, { className: "text-muted-foreground" }),
-  running: /* @__PURE__ */ s(p, { "aria-hidden": !0, className: "text-info-foreground" }),
-  done: /* @__PURE__ */ s(m, { className: "text-success-foreground" }),
-  failed: /* @__PURE__ */ s(f, { className: "text-destructive-foreground" })
-}, N = [
-  "min-w-0 flex-1 truncate leading-5",
-  "group-data-[state=pending]/task:text-muted-foreground",
-  "group-data-[state=failed]/task:text-destructive-foreground"
-].join(" "), d = c.createContext(null), h = (e) => {
-  const t = c.useContext(d);
-  if (!t) throw new Error(`${e} must render inside <Task>`);
-  return t;
-}, R = (e) => {
-  const { className: t, slot: a, ...r } = e;
-  return /* @__PURE__ */ s(
-    o.ol,
-    {
-      className: l("flex w-full list-none flex-col gap-2", t),
-      role: "list",
-      ...r,
-      "data-slot": a ?? "task-list"
-    }
-  );
-}, b = (e) => {
-  const { state: t = "pending", className: a, children: r, slot: i, ...n } = e;
-  return /* @__PURE__ */ s(d.Provider, { value: { state: t }, children: /* @__PURE__ */ s(
-    o.li,
-    {
-      className: l(
-        "group/task relative flex w-full items-start gap-2.5 text-sm",
-        "after:absolute after:top-5 after:-bottom-2 after:start-2.5 after:w-px after:bg-border",
-        "last:after:hidden",
-        a
-      ),
-      "data-state": t,
-      ...n,
-      "data-slot": i ?? "task",
-      children: r
-    }
-  ) });
-}, j = (e) => {
-  const { className: t, slot: a, ...r } = e;
-  return /* @__PURE__ */ s(
-    o.span,
-    {
-      className: l(N, t),
-      ...r,
-      "data-slot": a ?? "task-title"
-    }
-  );
-}, z = (e) => {
-  const { className: t, children: a, slot: r, ...i } = e, { state: n } = h("TaskStatus");
-  return /* @__PURE__ */ u(
-    o.span,
-    {
-      className: l(
-        "relative z-10 flex size-5 shrink-0 items-center justify-center",
-        "[&_svg:not([class*='size-'])]:size-4 [&_svg]:shrink-0",
-        t
-      ),
-      "data-state": n,
-      ...i,
-      "data-slot": r ?? "task-status",
-      children: [
-        k[n],
-        /* @__PURE__ */ s(o.span, { className: "sr-only", children: a ?? x[n] })
-      ]
-    }
-  );
-};
-export {
-  x as RUN_LABEL,
-  k as RUN_MARK,
-  b as Task,
-  R as TaskList,
-  z as TaskStatus,
-  j as TaskTitle
-};
-//# sourceMappingURL=task.js.map

package/dist/task.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"task.js","sources":["../src/task.tsx"],"sourcesContent":["\"use client\";\n\nimport { ark } from \"@ark-ui/react/factory\";\nimport { CircleCheckIcon, CircleDashedIcon, CircleXIcon } from \"lucide-react\";\nimport * as React from \"react\";\nimport { cn, Spinner } from \"@kanzo-tech/ui\";\n\n/**\n * The life of one step. Shared with `Tool`, which imports it — a tool call is a step with a name,\n * and giving the two their own four-word vocabularies is how they end up disagreeing.\n */\nexport type RunState = \"pending\" | \"running\" | \"done\" | \"failed\";\n\n/** The word for each state, in one place because `Tool`'s badge says the same four. */\nexport const RUN_LABEL: Record<RunState, string> = {\n  pending: \"Pending\",\n  running: \"Running\",\n  done: \"Done\",\n  failed: \"Failed\",\n};\n\n/**\n * The mark for each state — **shared with `Tool`, which imports it.** One icon family at one\n * stroke weight, tinted by the family's own `-foreground` token, which for a status family is the\n * readable-on-the-page variant rather than ink on a fill (`tokens.css` states both meanings).\n *\n * This was four `Status` dots, and `Status` is a presence dot: its recipe carries `ring-2\n * ring-background`, a halo for sitting on an avatar, which cut a 2px hole in the rail the marks\n * stand on. Fighting it took a `size-4` override of `size=\"lg\"`'s 12px and a `bg-transparent\n * ring-1` hollowing for pending — a primitive argued with in three places is the wrong primitive.\n * `Tool` already drew these four states as icons; now there is one drawing of them, not two.\n *\n * Unsized on purpose: the parent sizes the glyph, so the same table serves a 16px rail mark and a\n * 12px badge icon.\n */\nexport const RUN_MARK: Record<RunState, React.ReactNode> = {\n  pending: <CircleDashedIcon className=\"text-muted-foreground\" />,\n  running: <Spinner aria-hidden className=\"text-info-foreground\" />,\n  done: <CircleCheckIcon className=\"text-success-foreground\" />,\n  failed: <CircleXIcon className=\"text-destructive-foreground\" />,\n};\n\n/** The state reaches the title through the root's `data-state`, so the title needs no context. */\n// One weight across the five rows. The mark already says which step is running and which failed,\n// and a second emphasis on the same fact reads as three type styles in a five-row list.\nconst TITLE = [\n  \"min-w-0 flex-1 truncate leading-5\",\n  \"group-data-[state=pending]/task:text-muted-foreground\",\n  \"group-data-[state=failed]/task:text-destructive-foreground\",\n].join(\" \");\n\nconst Ctx = React.createContext<{ state: RunState } | null>(null);\nconst useCtx = (part: string) => {\n  const c = React.useContext(Ctx);\n  if (!c) throw new Error(`${part} must render inside <Task>`);\n  return c;\n};\n\nexport const TaskList = (props: React.ComponentProps<typeof ark.ol>) => {\n  const { className, slot, ...rest } = props;\n\n  return (\n    <ark.ol\n      className={cn(\"flex w-full list-none flex-col gap-2\", className)}\n      // `role=\"list\"`, because `list-none` takes the implicit one away in WebKit. See\n      // `DiagnosticList` in `@kanzo-tech/ui` for the argument.\n      role=\"list\"\n      {...rest}\n      data-slot={slot ?? \"task-list\"}\n    />\n  );\n};\n\nexport interface TaskProps extends React.ComponentProps<typeof ark.li> {\n  state?: RunState;\n}\n\n/**\n * One labelled step. The state is declared here and read off `data-state` by the parts.\n *\n * The rail through the markers is the step's own `::after` rather than a border on the list: a run\n * of five has to read as one run, and the last step must not trail a line into nothing.\n */\nexport const Task = (props: TaskProps) => {\n  const { state = \"pending\", className, children, slot, ...rest } = props;\n\n  return (\n    <Ctx.Provider value={{ state }}>\n      <ark.li\n        className={cn(\n          \"group/task relative flex w-full items-start gap-2.5 text-sm\",\n          \"after:absolute after:top-5 after:-bottom-2 after:start-2.5 after:w-px after:bg-border\",\n          \"last:after:hidden\",\n          className\n        )}\n        data-state={state}\n        {...rest}\n        data-slot={slot ?? \"task\"}\n      >\n        {children}\n      </ark.li>\n    </Ctx.Provider>\n  );\n};\n\nexport const TaskTitle = (props: React.ComponentProps<typeof ark.span>) => {\n  const { className, slot, ...rest } = props;\n\n  return (\n    <ark.span\n      className={cn(TITLE, className)}\n      {...rest}\n      data-slot={slot ?? \"task-title\"}\n    />\n  );\n};\n\n/**\n * The step's marker — {@link RUN_MARK} for this step's state, in a box the rail runs out of.\n *\n * The mark is decorative to a screen reader; the word beside it is what carries the state, and it\n * is written here as `sr-only` rather than assumed of the title. Pass children to say it in your\n * own words.\n *\n * The box is `size-5` and centred so the mark lands on the first line's optical centre: `text-sm`\n * is a 20px line box, and a marker aligned to the top of a wrapping title sits above its own text.\n */\nexport const TaskStatus = (props: React.ComponentProps<typeof ark.span>) => {\n  const { className, children, slot, ...rest } = props;\n  const { state } = useCtx(\"TaskStatus\");\n\n  return (\n    <ark.span\n      className={cn(\n        \"relative z-10 flex size-5 shrink-0 items-center justify-center\",\n        \"[&_svg:not([class*='size-'])]:size-4 [&_svg]:shrink-0\",\n        className\n      )}\n      data-state={state}\n      {...rest}\n      data-slot={slot ?? \"task-status\"}\n    >\n      {RUN_MARK[state]}\n      <ark.span className=\"sr-only\">{children ?? RUN_LABEL[state]}</ark.span>\n    </ark.span>\n  );\n};\n"],"names":[],"mappings":";;;;;;AAcO;AAA4C;AACxC;AACA;AACH;AAER;AAgB2D;AACI;AACE;AACJ;AAE7D;AAKc;AACZ;AACA;AAEF;AAIE;AACA;AACA;AACF;AAGE;AAEA;AACE;AAAK;AAAJ;AACgE;AAG1D;AACD;AACe;AAAA;AAGzB;AAaE;AAEA;AAEI;AAAK;AAAJ;AACY;AACT;AACA;AACA;AACA;AAAA;AAEU;AACR;AACe;AAElB;AAAA;AAIT;AAGE;AAEA;AACE;AAAK;AAAJ;AAC+B;AAC1B;AACe;AAAA;AAGzB;AAaE;AAGA;AACE;AAAK;AAAJ;AACY;AACT;AACA;AACA;AAAA;AAEU;AACR;AACe;AAElB;AAAc;AAC6C;AAAA;AAAA;AAGlE;;;;;;;;;"}

package/dist/types.d.ts

@@ -1,10 +0,0 @@
-/** A streamed value candidate produced by `useSuggestions`. */
-export interface Candidate {
-    /** Primitive value committed when the row is picked. */
-    value: string;
-    /** Human label; defaults to `value`. */
-    label?: string;
-    /** Optional rationale shown under the label. */
-    rationale?: string;
-}
-//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,MAAM,WAAW,SAAS;IACxB,wDAAwD;IACxD,KAAK,EAAE,MAAM,CAAC;IACd,wCAAwC;IACxC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,gDAAgD;IAChD,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB"}