@nadicodeai/ui 12.1.95 → 12.1.97

package/dist/components/agent-card.d.ts

@@ -9,6 +9,21 @@ type AgentCardProps = Omit<React.ComponentProps<typeof Card>, "children"> & {
     /** The object's picture: an Agent's orb, an app's mark. A skill, which is text, has none. */
     visual?: ReactNode;
 };
+/**
+ * One Agent, or another pictured object, as a card in a gallery.
+ *
+ * @family Data
+ * @when A gallery of Agents or templates where each one is chosen by its picture and its job: the
+ * Agents to create from, the templates of a hub.
+ * @instead A list of Agents to open is `AgentListRow`. An Agent's own page opens with
+ * `AgentProfileCard`. A Library entry is `CatalogEntry`.
+ * @behaviour The picture (her orb at 96) on the leading side, the name and job, an optional status
+ * under them, and a footer with the meta and one action. A long name wraps inside the card.
+ * @words The name as the Agent calls herself; the job in one line (*Writes quotes from the price
+ * list*); the action verb and noun (*Use template*).
+ * @access The name is the card's heading text; the orb is decorative beside it; the action is a
+ * real button or link.
+ */
 declare function AgentCard({ action, className, job, meta, name, status, visual, ...props }: AgentCardProps): import("react").JSX.Element;
 export { AgentCard, type AgentCardProps };
 //# sourceMappingURL=agent-card.d.ts.map

package/dist/components/agent-card.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agent-card.d.ts","sourceRoot":"","sources":["../../src/components/agent-card.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAEvC,OAAO,EAAE,IAAI,EAA0C,MAAM,mBAAmB,CAAC;AAGjF,KAAK,cAAc,GAAG,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,OAAO,IAAI,CAAC,EAAE,UAAU,CAAC,GAAG;IAC1E,MAAM,CAAC,EAAE,SAAS,CAAC;IACnB,GAAG,EAAE,SAAS,CAAC;IACf,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,IAAI,EAAE,SAAS,CAAC;IAChB,MAAM,CAAC,EAAE,SAAS,CAAC;IACnB,6FAA6F;IAC7F,MAAM,CAAC,EAAE,SAAS,CAAC;CACpB,CAAC;AAMF,iBAAS,SAAS,CAAC,EACjB,MAAM,EACN,SAAS,EACT,GAAG,EACH,IAAI,EACJ,IAAI,EACJ,MAAM,EACN,MAAM,EACN,GAAG,KAAK,EACT,EAAE,cAAc,+BAwDhB;AAED,OAAO,EAAE,SAAS,EAAE,KAAK,cAAc,EAAE,CAAC"}
+{"version":3,"file":"agent-card.d.ts","sourceRoot":"","sources":["../../src/components/agent-card.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAEvC,OAAO,EAAE,IAAI,EAA0C,MAAM,mBAAmB,CAAC;AAGjF,KAAK,cAAc,GAAG,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,OAAO,IAAI,CAAC,EAAE,UAAU,CAAC,GAAG;IAC1E,MAAM,CAAC,EAAE,SAAS,CAAC;IACnB,GAAG,EAAE,SAAS,CAAC;IACf,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,IAAI,EAAE,SAAS,CAAC;IAChB,MAAM,CAAC,EAAE,SAAS,CAAC;IACnB,6FAA6F;IAC7F,MAAM,CAAC,EAAE,SAAS,CAAC;CACpB,CAAC;AAMF;;;;;;;;;;;;;;GAcG;AACH,iBAAS,SAAS,CAAC,EACjB,MAAM,EACN,SAAS,EACT,GAAG,EACH,IAAI,EACJ,IAAI,EACJ,MAAM,EACN,MAAM,EACN,GAAG,KAAK,EACT,EAAE,cAAc,+BAwDhB;AAED,OAAO,EAAE,SAAS,EAAE,KAAK,cAAc,EAAE,CAAC"}

package/dist/components/agent-card.js

@@ -4,6 +4,21 @@ import { cn } from "../lib/utils.js";
 function hasSlotContent(value) {
     return value !== null && value !== undefined && value !== false;
 }
+/**
+ * One Agent, or another pictured object, as a card in a gallery.
+ *
+ * @family Data
+ * @when A gallery of Agents or templates where each one is chosen by its picture and its job: the
+ * Agents to create from, the templates of a hub.
+ * @instead A list of Agents to open is `AgentListRow`. An Agent's own page opens with
+ * `AgentProfileCard`. A Library entry is `CatalogEntry`.
+ * @behaviour The picture (her orb at 96) on the leading side, the name and job, an optional status
+ * under them, and a footer with the meta and one action. A long name wraps inside the card.
+ * @words The name as the Agent calls herself; the job in one line (*Writes quotes from the price
+ * list*); the action verb and noun (*Use template*).
+ * @access The name is the card's heading text; the orb is decorative beside it; the action is a
+ * real button or link.
+ */
 function AgentCard({ action, className, job, meta, name, status, visual, ...props }) {
     const hasStatus = hasSlotContent(status);
     const hasMeta = hasSlotContent(meta);

package/dist/components/agent-list-row.d.ts

@@ -1,16 +1,18 @@
 import type { CSSProperties } from "react";
 import { type AgentOrbFigure, type AgentOrbState } from "./agent-orb.js";
+import { type StatusTone } from "./status-dot.js";
 /**
  * One Agent in a list of them: the orb, the name, and the line that says what
- * the Agent is doing now ("Answering on WhatsApp", "Working") or what it is
- * for. It is the row's presentation alone, so the consumer owns the control
- * around it: Nadia's Agents list puts it in the button that opens the Agent,
- * and a website scene puts it in a list item that opens nothing.
+ * the Agent is doing now or what it is for.
  *
- * Narrow, the orb stands alone and the words stay for a screen reader, which is
- * how Nadia's window draws the list when there is no room for the names.
+ * @family Navigation
+ * @when Nadia's Agents in her window's sidebar, and a website scene that shows a list of Agents.
+ * @instead An Agent as a record among others in a page's list is a RecordList row with an agent IdentityMark; an Agent's own page heads with ObjectPage.
+ * @behaviour It is the row's presentation alone: the consumer owns the control around it (Nadia's button that opens the Agent, a scene's list item that opens nothing). The current row's name is set in 500. A state tone puts a 6 px dot before the state line. Narrow, the orb stands alone and the words stay for a screen reader.
+ * @words The name, then one state line: what she is doing now ("Answering on Telegram", "Working") or what she is for ("Sorts requests"). The tone never says more than the line does.
+ * @access The orb is decorative; the name and the state line are the row's text, read by its control. The dot is hidden from assistive technology, so the line carries its meaning.
  */
-export declare function AgentListRow({ className, color, current, form, motionKey, name, narrow, size, state, stateLine, ...props }: Omit<React.ComponentProps<"span">, "color"> & {
+export declare function AgentListRow({ className, color, current, form, motionKey, name, narrow, size, state, stateLine, stateTone, ...props }: Omit<React.ComponentProps<"span">, "color"> & {
     /** The pigment of the Agent's chosen form; Nadia's striped ribbon keeps her own. */
     color?: CSSProperties["color"];
     /** The row the list is on now. */
@@ -24,5 +26,7 @@ export declare function AgentListRow({ className, color, current, form, motionKe
     state?: AgentOrbState;
     /** What the Agent is doing, or what it is for. Absent, the name stands alone. */
     stateLine?: string;
+    /** How the state line stands: a failure is `bad`. Absent, the line has no dot. */
+    stateTone?: StatusTone;
 }): import("react").JSX.Element;
 //# sourceMappingURL=agent-list-row.d.ts.map

package/dist/components/agent-list-row.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agent-list-row.d.ts","sourceRoot":"","sources":["../../src/components/agent-list-row.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAE3C,OAAO,EAAY,KAAK,cAAc,EAAE,KAAK,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAG3F;;;;;;;;;GASG;AACH,wBAAgB,YAAY,CAAC,EAC3B,SAAS,EACT,KAAK,EACL,OAAe,EACf,IAAI,EACJ,SAAS,EACT,IAAI,EACJ,MAAc,EACd,IAAS,EACT,KAAc,EACd,SAAS,EACT,GAAG,KAAK,EACT,EAAE,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,GAAG;IAC/C,oFAAoF;IACpF,KAAK,CAAC,EAAE,aAAa,CAAC,OAAO,CAAC,CAAC;IAC/B,kCAAkC;IAClC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,IAAI,EAAE,cAAc,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,0EAA0E;IAC1E,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC;IACpB,KAAK,CAAC,EAAE,aAAa,CAAC;IACtB,iFAAiF;IACjF,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,+BA4BA"}
+{"version":3,"file":"agent-list-row.d.ts","sourceRoot":"","sources":["../../src/components/agent-list-row.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAE3C,OAAO,EAAY,KAAK,cAAc,EAAE,KAAK,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAC3F,OAAO,EAAa,KAAK,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAGrE;;;;;;;;;;GAUG;AACH,wBAAgB,YAAY,CAAC,EAC3B,SAAS,EACT,KAAK,EACL,OAAe,EACf,IAAI,EACJ,SAAS,EACT,IAAI,EACJ,MAAc,EACd,IAAS,EACT,KAAc,EACd,SAAS,EACT,SAAS,EACT,GAAG,KAAK,EACT,EAAE,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,GAAG;IAC/C,oFAAoF;IACpF,KAAK,CAAC,EAAE,aAAa,CAAC,OAAO,CAAC,CAAC;IAC/B,kCAAkC;IAClC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,IAAI,EAAE,cAAc,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,0EAA0E;IAC1E,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC;IACpB,KAAK,CAAC,EAAE,aAAa,CAAC;IACtB,iFAAiF;IACjF,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,kFAAkF;IAClF,SAAS,CAAC,EAAE,UAAU,CAAC;CACxB,+BA+BA"}

package/dist/components/agent-list-row.js

@@ -1,17 +1,19 @@
 "use client";
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { AgentOrb } from "./agent-orb.js";
+import { StatusDot } from "./status-dot.js";
 import { cn } from "../lib/utils.js";
 /**
  * One Agent in a list of them: the orb, the name, and the line that says what
- * the Agent is doing now ("Answering on WhatsApp", "Working") or what it is
- * for. It is the row's presentation alone, so the consumer owns the control
- * around it: Nadia's Agents list puts it in the button that opens the Agent,
- * and a website scene puts it in a list item that opens nothing.
+ * the Agent is doing now or what it is for.
  *
- * Narrow, the orb stands alone and the words stay for a screen reader, which is
- * how Nadia's window draws the list when there is no room for the names.
+ * @family Navigation
+ * @when Nadia's Agents in her window's sidebar, and a website scene that shows a list of Agents.
+ * @instead An Agent as a record among others in a page's list is a RecordList row with an agent IdentityMark; an Agent's own page heads with ObjectPage.
+ * @behaviour It is the row's presentation alone: the consumer owns the control around it (Nadia's button that opens the Agent, a scene's list item that opens nothing). The current row's name is set in 500. A state tone puts a 6 px dot before the state line. Narrow, the orb stands alone and the words stay for a screen reader.
+ * @words The name, then one state line: what she is doing now ("Answering on Telegram", "Working") or what she is for ("Sorts requests"). The tone never says more than the line does.
+ * @access The orb is decorative; the name and the state line are the row's text, read by its control. The dot is hidden from assistive technology, so the line carries its meaning.
  */
-export function AgentListRow({ className, color, current = false, form, motionKey, name, narrow = false, size = 40, state = "idle", stateLine, ...props }) {
-    return (_jsxs("span", { className: cn("flex w-full min-w-0 items-center gap-3 text-left text-sm", narrow && "justify-center", className), "data-slot": "agent-list-row", "data-current": current || undefined, ...props, children: [_jsx(AgentOrb, { color: color, decorative: true, form: form, motionKey: motionKey, size: size, state: state }), _jsxs("span", { className: cn("grid min-w-0", narrow && "sr-only"), children: [_jsx("span", { className: cn("truncate text-foreground", current && "font-medium"), children: name }), stateLine ? (_jsx("span", { className: "truncate text-xs text-muted-foreground", children: stateLine })) : null] })] }));
+export function AgentListRow({ className, color, current = false, form, motionKey, name, narrow = false, size = 40, state = "idle", stateLine, stateTone, ...props }) {
+    return (_jsxs("span", { className: cn("flex w-full min-w-0 items-center gap-3 text-left text-sm", narrow && "justify-center", className), "data-slot": "agent-list-row", "data-current": current || undefined, ...props, children: [_jsx(AgentOrb, { color: color, decorative: true, form: form, motionKey: motionKey, size: size, state: state }), _jsxs("span", { className: cn("grid min-w-0", narrow && "sr-only"), children: [_jsx("span", { className: cn("truncate text-foreground", current && "font-medium"), children: name }), stateLine ? (_jsxs("span", { className: "flex min-w-0 items-center gap-1.5 text-xs text-muted-foreground", children: [stateTone ? _jsx(StatusDot, { className: "shrink-0", tone: stateTone }) : null, _jsx("span", { className: "truncate", children: stateLine })] })) : null] })] }));
 }

package/dist/components/agent-orb-appearance.d.ts

@@ -52,6 +52,10 @@ export declare const shapeForOrb: (form: AgentOrbForm) => string;
 /** The form an Agent wears until a person chooses one. */
 export declare const defaultAgentOrbForm: AgentOrbForm;
 export declare const defaultAgentOrbShape: string;
+type ResolvedAgentOrb = {
+    form: AgentOrbForm | "nadia";
+    color: AgentOrbColor | undefined;
+};
 /**
  * Resolve the stored strings to what `AgentOrb` draws. The root Agent is Nadia
  * and wears her striped ribbon whatever is stored, since her look is fixed. An
@@ -61,8 +65,5 @@ export declare const defaultAgentOrbShape: string;
  */
 export declare function resolveAgentOrb(stored: StoredAgentOrbAppearance, { root }?: {
     root?: boolean;
-}): {
-    form: AgentOrbForm | "nadia";
-    color: AgentOrbColor | undefined;
-};
+}): ResolvedAgentOrb;
 //# sourceMappingURL=agent-orb-appearance.d.ts.map

package/dist/components/agent-orb-appearance.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agent-orb-appearance.d.ts","sourceRoot":"","sources":["../../src/components/agent-orb-appearance.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAEzD,YAAY,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAEzE,uGAAuG;AACvG,MAAM,WAAW,wBAAwB;IACvC,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACvB;AAED,8EAA8E;AAC9E,eAAO,MAAM,aAAa,+EAQkB,CAAC;AAE7C;;;;;;;;;;GAUG;AACH,eAAO,MAAM,cAAc,0CAA2C,CAAC;AACvE,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,CAAC,CAAC;AAE5D;;;;;;GAMG;AACH,eAAO,MAAM,mBAAmB,EAAE,MAAM,CAAC,aAAa,EAAE,MAAM,CAI7D,CAAC;AAEF,uDAAuD;AACvD,eAAO,MAAM,mBAAmB,EAAE,MAAM,CAAC,aAAa,EAAE,MAAM,CAI7D,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,0BAA0B;;CAAgC,CAAC;AAaxE,oDAAoD;AACpD,eAAO,MAAM,WAAW,GAAI,MAAM,YAAY,KAAG,MAAuB,CAAC;AAEzE,0DAA0D;AAC1D,eAAO,MAAM,mBAAmB,EAAE,YAAsB,CAAC;AACzD,eAAO,MAAM,oBAAoB,EAAE,MAAyC,CAAC;AAsB7E;;;;;;GAMG;AACH,wBAAgB,eAAe,CAC7B,MAAM,EAAE,wBAAwB,EAChC,EAAE,IAAY,EAAE,GAAE;IAAE,IAAI,CAAC,EAAE,OAAO,CAAA;CAAO,GACxC;IAAE,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC;IAAC,KAAK,EAAE,aAAa,GAAG,SAAS,CAAA;CAAE,CAGpE"}
+{"version":3,"file":"agent-orb-appearance.d.ts","sourceRoot":"","sources":["../../src/components/agent-orb-appearance.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAEzD,YAAY,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAEzE,uGAAuG;AACvG,MAAM,WAAW,wBAAwB;IACvC,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACvB;AAED,8EAA8E;AAC9E,eAAO,MAAM,aAAa,+EAQkB,CAAC;AAE7C;;;;;;;;;;GAUG;AACH,eAAO,MAAM,cAAc,0CAA2C,CAAC;AACvE,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,CAAC,CAAC;AAE5D;;;;;;GAMG;AACH,eAAO,MAAM,mBAAmB,EAAE,MAAM,CAAC,aAAa,EAAE,MAAM,CAI7D,CAAC;AAEF,uDAAuD;AACvD,eAAO,MAAM,mBAAmB,EAAE,MAAM,CAAC,aAAa,EAAE,MAAM,CAI7D,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,0BAA0B;;CAAgC,CAAC;AAaxE,oDAAoD;AACpD,eAAO,MAAM,WAAW,GAAI,MAAM,YAAY,KAAG,MAAuB,CAAC;AAEzE,0DAA0D;AAC1D,eAAO,MAAM,mBAAmB,EAAE,YAAsB,CAAC;AACzD,eAAO,MAAM,oBAAoB,EAAE,MAAyC,CAAC;AAsB7E,KAAK,gBAAgB,GAAG;IAAE,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC;IAAC,KAAK,EAAE,aAAa,GAAG,SAAS,CAAA;CAAE,CAAC;AAE3F;;;;;;GAMG;AACH,wBAAgB,eAAe,CAC7B,MAAM,EAAE,wBAAwB,EAChC,EAAE,IAAY,EAAE,GAAE;IAAE,IAAI,CAAC,EAAE,OAAO,CAAA;CAAO,GACxC,gBAAgB,CAGlB"}

package/dist/components/agent-orb.d.ts

@@ -29,5 +29,21 @@ export type AgentOrbProps = AgentOrbBaseProps & ({
     decorative?: false;
     label: string;
 });
+/**
+ * An Agent, anywhere: her orb, the only thing that moves on its own.
+ *
+ * @family Status
+ * @when An Agent, anywhere: 20 in the sidebar, 32 in a row, 64 on her Profile card, 96 in an Agent
+ * card, 160 on entry. There is no other Agent picture.
+ * @instead A person is an `Avatar`. The system's own wait is the waiting line, never an orb. An orb
+ * in artwork takes `motion="ambient"` and claims no activity.
+ * @behaviour The only thing that moves on its own. Idle turns and breathes; working and thinking
+ * show their cue; waiting holds; blocked makes one effort and stops; done celebrates once. Reduced
+ * motion: still, busy breathes in opacity.
+ * @words Text sits beside the orb, never on it. Where the exact state matters a word names it:
+ * *Working*, *Waiting for you*.
+ * @access `role="img"` labelled with the Agent's name, and her state where it matters; `decorative`
+ * when her name is already beside it.
+ */
 export declare function AgentOrb({ form, color, size, presence, paused, state, motion, motionKey, decorative, label, className, }: AgentOrbProps): import("react").JSX.Element;
 //# sourceMappingURL=agent-orb.d.ts.map

package/dist/components/agent-orb.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agent-orb.d.ts","sourceRoot":"","sources":["../../src/components/agent-orb.tsx"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,aAAa,EAAqB,MAAM,OAAO,CAAC;AAE9D,OAAO,EACL,KAAK,cAAc,EACnB,KAAK,gBAAgB,EACrB,KAAK,YAAY,EAElB,MAAM,uBAAuB,CAAC;AAG/B,YAAY,EACV,cAAc,EACd,YAAY,EACZ,cAAc,EACd,gBAAgB,EAChB,YAAY,GACb,MAAM,uBAAuB,CAAC;AAE/B,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAClE,YAAY,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAElE,KAAK,iBAAiB,GAAG;IACvB,8EAA8E;IAC9E,IAAI,EAAE,cAAc,CAAC;IACrB,qFAAqF;IACrF,KAAK,CAAC,EAAE,aAAa,CAAC,OAAO,CAAC,CAAC;IAC/B,qEAAqE;IACrE,IAAI,CAAC,EAAE,YAAY,CAAC;IACpB,wFAAwF;IACxF,QAAQ,CAAC,EAAE,gBAAgB,CAAC;IAC5B,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG,iBAAiB,GAC3C,CAAC;IAAE,MAAM,CAAC,EAAE,QAAQ,CAAC;IAAC,KAAK,CAAC,EAAE,aAAa,CAAA;CAAE,GAAG;IAAE,MAAM,EAAE,SAAS,CAAC;IAAC,KAAK,CAAC,EAAE,KAAK,CAAA;CAAE,CAAC,GACrF,CAAC;IAAE,UAAU,EAAE,IAAI,CAAC;IAAC,KAAK,CAAC,EAAE,KAAK,CAAA;CAAE,GAAG;IAAE,UAAU,CAAC,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC;AAEhF,wBAAgB,QAAQ,CAAC,EACvB,IAAI,EACJ,KAAK,EACL,IAAS,EACT,QAAkB,EAClB,MAAc,EACd,KAAc,EACd,MAAiB,EACjB,SAAa,EACb,UAAkB,EAClB,KAAK,EACL,SAAS,GACV,EAAE,aAAa,+BAwDf"}
+{"version":3,"file":"agent-orb.d.ts","sourceRoot":"","sources":["../../src/components/agent-orb.tsx"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,aAAa,EAAqB,MAAM,OAAO,CAAC;AAE9D,OAAO,EACL,KAAK,cAAc,EACnB,KAAK,gBAAgB,EACrB,KAAK,YAAY,EAElB,MAAM,uBAAuB,CAAC;AAG/B,YAAY,EACV,cAAc,EACd,YAAY,EACZ,cAAc,EACd,gBAAgB,EAChB,YAAY,GACb,MAAM,uBAAuB,CAAC;AAE/B,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAClE,YAAY,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAElE,KAAK,iBAAiB,GAAG;IACvB,8EAA8E;IAC9E,IAAI,EAAE,cAAc,CAAC;IACrB,qFAAqF;IACrF,KAAK,CAAC,EAAE,aAAa,CAAC,OAAO,CAAC,CAAC;IAC/B,qEAAqE;IACrE,IAAI,CAAC,EAAE,YAAY,CAAC;IACpB,wFAAwF;IACxF,QAAQ,CAAC,EAAE,gBAAgB,CAAC;IAC5B,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG,iBAAiB,GAC3C,CAAC;IAAE,MAAM,CAAC,EAAE,QAAQ,CAAC;IAAC,KAAK,CAAC,EAAE,aAAa,CAAA;CAAE,GAAG;IAAE,MAAM,EAAE,SAAS,CAAC;IAAC,KAAK,CAAC,EAAE,KAAK,CAAA;CAAE,CAAC,GACrF,CAAC;IAAE,UAAU,EAAE,IAAI,CAAC;IAAC,KAAK,CAAC,EAAE,KAAK,CAAA;CAAE,GAAG;IAAE,UAAU,CAAC,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC;AAEhF;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,QAAQ,CAAC,EACvB,IAAI,EACJ,KAAK,EACL,IAAS,EACT,QAAkB,EAClB,MAAc,EACd,KAAc,EACd,MAAiB,EACjB,SAAa,EACb,UAAkB,EAClB,KAAK,EACL,SAAS,GACV,EAAE,aAAa,+BAyDf"}

package/dist/components/agent-orb.js

@@ -3,6 +3,22 @@ import { jsx as _jsx } from "react/jsx-runtime";
 import { useEffect, useRef } from "react";
 import { mountAgentOrb, } from "../internal/agent-orb.js";
 import { cn } from "../lib/utils.js";
+/**
+ * An Agent, anywhere: her orb, the only thing that moves on its own.
+ *
+ * @family Status
+ * @when An Agent, anywhere: 20 in the sidebar, 32 in a row, 64 on her Profile card, 96 in an Agent
+ * card, 160 on entry. There is no other Agent picture.
+ * @instead A person is an `Avatar`. The system's own wait is the waiting line, never an orb. An orb
+ * in artwork takes `motion="ambient"` and claims no activity.
+ * @behaviour The only thing that moves on its own. Idle turns and breathes; working and thinking
+ * show their cue; waiting holds; blocked makes one effort and stops; done celebrates once. Reduced
+ * motion: still, busy breathes in opacity.
+ * @words Text sits beside the orb, never on it. Where the exact state matters a word names it:
+ * *Working*, *Waiting for you*.
+ * @access `role="img"` labelled with the Agent's name, and her state where it matters; `decorative`
+ * when her name is already beside it.
+ */
 export function AgentOrb({ form, color, size = 32, presence = "plain", paused = false, state = "idle", motion = "status", motionKey = 0, decorative = false, label, className, }) {
     const canvas = useRef(null);
     const renderer = useRef(null);
@@ -39,5 +55,6 @@ export function AgentOrb({ form, color, size = 32, presence = "plain", paused =
     return (_jsx("canvas", { ref: canvas, "data-slot": "agent-orb", "data-form": form, "data-state": state, "data-motion": motion, role: decorative ? undefined : "img", "aria-hidden": decorative || undefined, "aria-label": decorative ? undefined : label, className: cn("inline-block size-(--nc-agent-orb-size) shrink-0 align-middle", className), width: size, height: size, 
         // The size is a class, not an inline rule, so a caller that sizes the
         // orb from its layout overrides it; the engine then paints that box.
+        // SAFETY: CSSProperties lists only standard properties; React sets each `--` custom property key here through style.setProperty.
         style: { color, "--nc-agent-orb-size": `${size}px` }, children: decorative ? null : label }));
 }

package/dist/components/agent-profile.d.ts

@@ -61,12 +61,21 @@ export type AgentProfileCardProps = {
     headingProps?: Omit<ComponentProps<"h1">, "children">;
 };
 /**
- * The card an Agent's Profile opens with in every product (DESIGN.md, "Page
- * compositions"): on the left her orb at 64, her name with the pencil, her
- * description and her facts; the pencil turns her name and description into
- * fields in place, above the same facts; on
- * the right her model and her reasoning; the card's footer saves both sides. Each product brings its own data,
- * fields and words; the shape, sizes and order are this component's.
+ * The card an Agent's Profile opens with in every product.
+ *
+ * @family Compositions
+ * @when The head of an Agent's Profile: who she is, what she does, her state, and her model and
+ * reasoning beside them.
+ * @instead An Agent in a gallery is `AgentCard`; in a list `AgentListRow`. Another object's page is
+ * `ObjectPage`.
+ * @behaviour Her orb at 64, her name with the pencil, her description and her facts on the left;
+ * her model and reasoning on the right; the card's footer saves both sides. The pencil turns her
+ * name and description into fields in place. A fact being read draws its place; a missing one keeps
+ * its label and a dash.
+ * @words Each product brings its own data, fields and words; the shape, sizes and order are this
+ * component's. Her state is a word: *Working*, *Waiting for you*.
+ * @access Her name is the page's `h1`, kept as the heading while she is edited; the pencil is named
+ * (*Edit Nadia*); the orb is decorative beside her name.
  */
 export declare function AgentProfileCard({ orb, name, description, descriptionMissingLabel, edit, editor, state, activity, origin, settings, footer, footerHint, actions, headingProps, }: AgentProfileCardProps): import("react").JSX.Element;
 export type ModelSelectProps = Omit<ComponentProps<typeof SelectPrimitive.Trigger>, "children" | "value" | "onChange"> & {
@@ -81,8 +90,18 @@ export type ModelSelectProps = Omit<ComponentProps<typeof SelectPrimitive.Trigge
     nameOf?: (model: string) => string;
 };
 /**
- * A model chosen from a list: the trigger and every option read the model the
- * way every surface does, with its maker's mark (`ModelIdentity`).
+ * A model chosen from a list, each read with its maker's mark.
+ *
+ * @family Choices
+ * @when Choosing the model an Agent runs on, from the models the product offers.
+ * @instead A model shown, not chosen, is `ModelIdentity`. A list people search across many makers
+ * is a `Combobox`.
+ * @behaviour A `Select` whose trigger and every option read the model as `ModelIdentity` does: the
+ * maker's mark, one name, the muted maker. It shows `placeholder` until a model is chosen.
+ * @words Model names come from `modelDisplayName`, or the product's own `nameOf` when its runtime
+ * names models itself. The placeholder says what to choose: *Choose a model*.
+ * @access The trigger takes a visible label; listbox and option roles from Base UI; the marks are
+ * decorative beside the names.
  */
 export declare function ModelSelect({ value, options, onValueChange, placeholder, nameOf, disabled, className, ...props }: ModelSelectProps): import("react").JSX.Element;
 export type SegmentedChoiceProps<Choice extends string> = Omit<ComponentProps<typeof RadioGroup>, "children" | "defaultValue" | "onValueChange" | "value"> & {
@@ -94,8 +113,18 @@ export type SegmentedChoiceProps<Choice extends string> = Omit<ComponentProps<ty
     onValueChange: (value: Choice) => void;
 };
 /**
- * One choice among a few short levels, drawn as segments that share a row,
- * such as an Agent's reasoning: Default, Low, Medium, High.
+ * One choice among a few short levels, drawn as segments that share a row.
+ *
+ * @family Choices
+ * @when One of two to five short levels a person compares at a glance, such as an Agent's
+ * reasoning: Default, Low, Medium, High.
+ * @instead Options that each need a sentence are choice tiles. Seven or more is a `Select`. The
+ * theme is `ThemeModeSwitcher`.
+ * @behaviour A `RadioGroup` drawn with the toggle classes: one outline, one seam between members,
+ * the chosen one in the selection fill. Arrows move and choose; it applies through the form it sits
+ * in.
+ * @words Each segment is one or two words of equal weight, in sentence case.
+ * @access A `radiogroup` named by its label; each segment a radio named by its word.
  */
 export declare function SegmentedChoice<Choice extends string>({ value, options, onValueChange, disabled, className, ...props }: SegmentedChoiceProps<Choice>): import("react").JSX.Element;
 //# sourceMappingURL=agent-profile.d.ts.map

package/dist/components/agent-profile.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agent-profile.d.ts","sourceRoot":"","sources":["../../src/components/agent-profile.tsx"],"names":[],"mappings":"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"}
+{"version":3,"file":"agent-profile.d.ts","sourceRoot":"","sources":["../../src/components/agent-profile.tsx"],"names":[],"mappings":"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"}

package/dist/components/agent-profile.js

@@ -20,12 +20,21 @@ function FactValue({ fact }) {
     return fact.pending ? (_jsx(Skeleton, { "aria-busy": "true", className: "h-4 w-24" })) : (_jsx(TableValue, { missingLabel: fact.missingLabel, value: fact.value }));
 }
 /**
- * The card an Agent's Profile opens with in every product (DESIGN.md, "Page
- * compositions"): on the left her orb at 64, her name with the pencil, her
- * description and her facts; the pencil turns her name and description into
- * fields in place, above the same facts; on
- * the right her model and her reasoning; the card's footer saves both sides. Each product brings its own data,
- * fields and words; the shape, sizes and order are this component's.
+ * The card an Agent's Profile opens with in every product.
+ *
+ * @family Compositions
+ * @when The head of an Agent's Profile: who she is, what she does, her state, and her model and
+ * reasoning beside them.
+ * @instead An Agent in a gallery is `AgentCard`; in a list `AgentListRow`. Another object's page is
+ * `ObjectPage`.
+ * @behaviour Her orb at 64, her name with the pencil, her description and her facts on the left;
+ * her model and reasoning on the right; the card's footer saves both sides. The pencil turns her
+ * name and description into fields in place. A fact being read draws its place; a missing one keeps
+ * its label and a dash.
+ * @words Each product brings its own data, fields and words; the shape, sizes and order are this
+ * component's. Her state is a word: *Working*, *Waiting for you*.
+ * @access Her name is the page's `h1`, kept as the heading while she is edited; the pencil is named
+ * (*Edit Nadia*); the orb is decorative beside her name.
  */
 export function AgentProfileCard({ orb, name, description, descriptionMissingLabel, edit, editor, state, activity, origin, settings, footer, footerHint, actions, headingProps, }) {
     const facts = [
@@ -38,18 +47,39 @@ export function AgentProfileCard({ orb, name, description, descriptionMissingLab
     return (_jsxs(Card, { className: "@container/agent-profile min-w-0", render: _jsx("section", { "aria-labelledby": headingProps?.id }), "data-slot": "agent-profile", children: [_jsxs(CardContent, { className: "grid min-w-0 gap-nadicode-lg @3xl/agent-profile:grid-cols-[minmax(0,1fr)_minmax(18rem,22rem)] @3xl/agent-profile:gap-nadicode-xl", children: [_jsxs("div", { className: "grid min-w-0 grid-cols-[auto_minmax(0,1fr)] items-start gap-nadicode-md", children: [_jsx("div", { className: "shrink-0", children: orb(AGENT_PROFILE_ORB_SIZE) }), editor ? (_jsxs("div", { className: "grid min-w-0 gap-nadicode-md", "data-slot": "agent-profile-editor", children: [_jsx("h1", { ...headingProps, className: cn("sr-only", headingProps?.className), children: name }), editor, factList] })) : (_jsxs("div", { className: "grid min-w-0 gap-1", children: [_jsxs("div", { className: "flex min-w-0 flex-wrap items-center gap-x-1 gap-y-nadicode-sm", children: [_jsx("h1", { ...headingProps, className: cn("min-w-0 text-heading-md break-words text-foreground outline-none", headingProps?.className), children: name }), edit ? (_jsx(Button, { "aria-label": edit.label, onClick: edit.onClick, ref: edit.ref, size: "icon", title: edit.label, type: "button", variant: "ghost", children: _jsx(PencilIcon, { "aria-hidden": "true", "data-icon": true }) })) : null, actions ? (_jsx("div", { className: "ml-auto flex shrink-0 items-center gap-2 pl-nadicode-sm", "data-slot": "agent-profile-actions", children: _jsx(PageActionsRow, { ...actions }) })) : null] }), _jsx("p", { className: "line-clamp-2 min-w-0 text-sm text-muted-foreground", title: text, children: _jsx(TableValue, { missingLabel: descriptionMissingLabel, value: text }) }), factList] }))] }), settings ? (_jsx("div", { className: "grid min-w-0 content-start gap-nadicode-md border-t border-border pt-nadicode-md @3xl/agent-profile:border-t-0 @3xl/agent-profile:border-l @3xl/agent-profile:pt-0 @3xl/agent-profile:pl-nadicode-lg", "data-slot": "agent-profile-settings", children: settings })) : null] }), _jsx(FooterStrip, { hint: footerHint, hintSlot: "agent-profile-hint", children: footer })] }));
 }
 /**
- * A model chosen from a list: the trigger and every option read the model the
- * way every surface does, with its maker's mark (`ModelIdentity`).
+ * A model chosen from a list, each read with its maker's mark.
+ *
+ * @family Choices
+ * @when Choosing the model an Agent runs on, from the models the product offers.
+ * @instead A model shown, not chosen, is `ModelIdentity`. A list people search across many makers
+ * is a `Combobox`.
+ * @behaviour A `Select` whose trigger and every option read the model as `ModelIdentity` does: the
+ * maker's mark, one name, the muted maker. It shows `placeholder` until a model is chosen.
+ * @words Model names come from `modelDisplayName`, or the product's own `nameOf` when its runtime
+ * names models itself. The placeholder says what to choose: *Choose a model*.
+ * @access The trigger takes a visible label; listbox and option roles from Base UI; the marks are
+ * decorative beside the names.
  */
 export function ModelSelect({ value, options, onValueChange, placeholder, nameOf, disabled, className, ...props }) {
     return (_jsxs(Select, { disabled: disabled, onValueChange: (model) => {
+            // oxlint-disable-next-line anti-slop/no-runtime-typeof -- Base UI's Select types the chosen value as unknown; this is where it is read.
             if (typeof model === "string")
                 onValueChange(model);
         }, value: value, children: [_jsx(SelectTrigger, { className: cn("w-full min-w-0", className), ...props, children: _jsx(SelectPrimitive.Value, { className: "flex min-w-0 flex-1 items-center gap-1.5 text-left", "data-slot": "select-value", children: (model) => model ? (_jsx(ModelIdentity, { className: "min-w-0", markSize: 20, model: model, name: nameOf?.(model) })) : (_jsx("span", { className: "text-placeholder", children: placeholder })) }) }), _jsx(SelectContent, { align: "start", alignItemWithTrigger: false, children: _jsx(SelectGroup, { children: options.map((model) => (_jsx(SelectItem, { value: model, children: _jsx(ModelIdentity, { markSize: 20, model: model, name: nameOf?.(model) }) }, model))) }) })] }));
 }
 /**
- * One choice among a few short levels, drawn as segments that share a row,
- * such as an Agent's reasoning: Default, Low, Medium, High.
+ * One choice among a few short levels, drawn as segments that share a row.
+ *
+ * @family Choices
+ * @when One of two to five short levels a person compares at a glance, such as an Agent's
+ * reasoning: Default, Low, Medium, High.
+ * @instead Options that each need a sentence are choice tiles. Seven or more is a `Select`. The
+ * theme is `ThemeModeSwitcher`.
+ * @behaviour A `RadioGroup` drawn with the toggle classes: one outline, one seam between members,
+ * the chosen one in the selection fill. Arrows move and choose; it applies through the form it sits
+ * in.
+ * @words Each segment is one or two words of equal weight, in sentence case.
+ * @access A `radiogroup` named by its label; each segment a radio named by its word.
  */
 export function SegmentedChoice({ value, options, onValueChange, disabled, className, ...props }) {
     return (_jsx(RadioGroup, { className: cn("flex h-control-height w-full gap-nadicode-xxs rounded-md bg-muted p-0.5", className), disabled: disabled, onValueChange: (next) => {

package/dist/components/alert-dialog.d.ts

@@ -1,6 +1,20 @@
 import * as React from "react";
 import { AlertDialog as AlertDialogPrimitive } from "@base-ui/react/alert-dialog";
 import { Button } from "./button.js";
+/**
+ * The blocking dialog primitive under `ConfirmDialog`.
+ *
+ * @family Menus
+ * @when Before an action that stops or loses something, through `ConfirmDialog`, which owns the
+ * words and the pending state.
+ * @instead A product confirms with `ConfirmDialog`, never a hand-built alert dialog. A reversible
+ * local change needs no confirmation; give it Undo in a toast.
+ * @behaviour No backdrop dismissal; Escape cancels. `AlertDialogAction` closes on press; a confirm
+ * that can fail is a plain button so the dialog stays open with the error.
+ * @words Title a statement naming the record, never a question. Body the consequence, once.
+ * @access `role="alertdialog"`, named by the title and described by the consequence. Focus starts
+ * on Cancel, the safe choice.
+ */
 declare function AlertDialog({ ...props }: AlertDialogPrimitive.Root.Props): React.JSX.Element;
 declare function AlertDialogTrigger({ ...props }: AlertDialogPrimitive.Trigger.Props): React.JSX.Element;
 declare function AlertDialogPortal({ ...props }: AlertDialogPrimitive.Portal.Props): React.JSX.Element;

package/dist/components/alert-dialog.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"alert-dialog.d.ts","sourceRoot":"","sources":["../../src/components/alert-dialog.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,EAAE,WAAW,IAAI,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AAIlF,OAAO,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAE7C,iBAAS,WAAW,CAAC,EAAE,GAAG,KAAK,EAAE,EAAE,oBAAoB,CAAC,IAAI,CAAC,KAAK,qBAEjE;AAED,iBAAS,kBAAkB,CAAC,EAAE,GAAG,KAAK,EAAE,EAAE,oBAAoB,CAAC,OAAO,CAAC,KAAK,qBAE3E;AAED,iBAAS,iBAAiB,CAAC,EAAE,GAAG,KAAK,EAAE,EAAE,oBAAoB,CAAC,MAAM,CAAC,KAAK,qBAEzE;AAED,iBAAS,kBAAkB,CAAC,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,oBAAoB,CAAC,QAAQ,CAAC,KAAK,qBAQvF;AAED,iBAAS,kBAAkB,CAAC,EAC1B,SAAS,EACT,IAAgB,EAChB,GAAG,KAAK,EACT,EAAE,oBAAoB,CAAC,KAAK,CAAC,KAAK,GAAG;IACpC,IAAI,CAAC,EAAE,SAAS,GAAG,IAAI,CAAC;CACzB,qBAgBA;AAED,iBAAS,iBAAiB,CAAC,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,KAAK,CAAC,cAAc,CAAC,KAAK,CAAC,qBAW9E;AAED,iBAAS,iBAAiB,CAAC,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,KAAK,CAAC,cAAc,CAAC,KAAK,CAAC,qBAW9E;AAED,iBAAS,gBAAgB,CAAC,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,KAAK,CAAC,cAAc,CAAC,KAAK,CAAC,qBAW7E;AAED,iBAAS,gBAAgB,CAAC,EACxB,SAAS,EACT,GAAG,KAAK,EACT,EAAE,KAAK,CAAC,cAAc,CAAC,OAAO,oBAAoB,CAAC,KAAK,CAAC,qBAWzD;AAED,iBAAS,sBAAsB,CAAC,EAC9B,SAAS,EACT,GAAG,KAAK,EACT,EAAE,KAAK,CAAC,cAAc,CAAC,OAAO,oBAAoB,CAAC,WAAW,CAAC,qBAW/D;AAID,iBAAS,iBAAiB,CAAC,EACzB,SAAS,EACT,OAAmB,EACnB,IAAgB,EAChB,GAAG,KAAK,EACT,EAAE,oBAAoB,CAAC,KAAK,CAAC,KAAK,GACjC,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,OAAO,MAAM,CAAC,EAAE,SAAS,GAAG,MAAM,CAAC,qBAS9D;AAED,iBAAS,iBAAiB,CAAC,EACzB,SAAS,EACT,OAAmB,EACnB,IAAgB,EAChB,GAAG,KAAK,EACT,EAAE,oBAAoB,CAAC,KAAK,CAAC,KAAK,GACjC,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,OAAO,MAAM,CAAC,EAAE,SAAS,GAAG,MAAM,CAAC,qBAS9D;AAED,OAAO,EACL,WAAW,EACX,iBAAiB,EACjB,iBAAiB,EACjB,kBAAkB,EAClB,sBAAsB,EACtB,iBAAiB,EACjB,iBAAiB,EACjB,gBAAgB,EAChB,kBAAkB,EAClB,iBAAiB,EACjB,gBAAgB,EAChB,kBAAkB,GACnB,CAAC"}
+{"version":3,"file":"alert-dialog.d.ts","sourceRoot":"","sources":["../../src/components/alert-dialog.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,EAAE,WAAW,IAAI,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AAIlF,OAAO,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAE7C;;;;;;;;;;;;;GAaG;AACH,iBAAS,WAAW,CAAC,EAAE,GAAG,KAAK,EAAE,EAAE,oBAAoB,CAAC,IAAI,CAAC,KAAK,qBAEjE;AAED,iBAAS,kBAAkB,CAAC,EAAE,GAAG,KAAK,EAAE,EAAE,oBAAoB,CAAC,OAAO,CAAC,KAAK,qBAE3E;AAED,iBAAS,iBAAiB,CAAC,EAAE,GAAG,KAAK,EAAE,EAAE,oBAAoB,CAAC,MAAM,CAAC,KAAK,qBAEzE;AAED,iBAAS,kBAAkB,CAAC,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,oBAAoB,CAAC,QAAQ,CAAC,KAAK,qBAQvF;AAED,iBAAS,kBAAkB,CAAC,EAC1B,SAAS,EACT,IAAgB,EAChB,GAAG,KAAK,EACT,EAAE,oBAAoB,CAAC,KAAK,CAAC,KAAK,GAAG;IACpC,IAAI,CAAC,EAAE,SAAS,GAAG,IAAI,CAAC;CACzB,qBAgBA;AAED,iBAAS,iBAAiB,CAAC,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,KAAK,CAAC,cAAc,CAAC,KAAK,CAAC,qBAW9E;AAED,iBAAS,iBAAiB,CAAC,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,KAAK,CAAC,cAAc,CAAC,KAAK,CAAC,qBAW9E;AAED,iBAAS,gBAAgB,CAAC,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,KAAK,CAAC,cAAc,CAAC,KAAK,CAAC,qBAW7E;AAED,iBAAS,gBAAgB,CAAC,EACxB,SAAS,EACT,GAAG,KAAK,EACT,EAAE,KAAK,CAAC,cAAc,CAAC,OAAO,oBAAoB,CAAC,KAAK,CAAC,qBAWzD;AAED,iBAAS,sBAAsB,CAAC,EAC9B,SAAS,EACT,GAAG,KAAK,EACT,EAAE,KAAK,CAAC,cAAc,CAAC,OAAO,oBAAoB,CAAC,WAAW,CAAC,qBAW/D;AAID,iBAAS,iBAAiB,CAAC,EACzB,SAAS,EACT,OAAmB,EACnB,IAAgB,EAChB,GAAG,KAAK,EACT,EAAE,oBAAoB,CAAC,KAAK,CAAC,KAAK,GACjC,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,OAAO,MAAM,CAAC,EAAE,SAAS,GAAG,MAAM,CAAC,qBAS9D;AAED,iBAAS,iBAAiB,CAAC,EACzB,SAAS,EACT,OAAmB,EACnB,IAAgB,EAChB,GAAG,KAAK,EACT,EAAE,oBAAoB,CAAC,KAAK,CAAC,KAAK,GACjC,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,OAAO,MAAM,CAAC,EAAE,SAAS,GAAG,MAAM,CAAC,qBAS9D;AAED,OAAO,EACL,WAAW,EACX,iBAAiB,EACjB,iBAAiB,EACjB,kBAAkB,EAClB,sBAAsB,EACtB,iBAAiB,EACjB,iBAAiB,EACjB,gBAAgB,EAChB,kBAAkB,EAClB,iBAAiB,EACjB,gBAAgB,EAChB,kBAAkB,GACnB,CAAC"}

package/dist/components/alert-dialog.js

@@ -4,6 +4,20 @@ import { AlertDialog as AlertDialogPrimitive } from "@base-ui/react/alert-dialog
 import { cn } from "../lib/utils.js";
 import { modalOverlayMotion, overlayBackdropMotion } from "../lib/motion.js";
 import { Button } from "./button.js";
+/**
+ * The blocking dialog primitive under `ConfirmDialog`.
+ *
+ * @family Menus
+ * @when Before an action that stops or loses something, through `ConfirmDialog`, which owns the
+ * words and the pending state.
+ * @instead A product confirms with `ConfirmDialog`, never a hand-built alert dialog. A reversible
+ * local change needs no confirmation; give it Undo in a toast.
+ * @behaviour No backdrop dismissal; Escape cancels. `AlertDialogAction` closes on press; a confirm
+ * that can fail is a plain button so the dialog stays open with the error.
+ * @words Title a statement naming the record, never a question. Body the consequence, once.
+ * @access `role="alertdialog"`, named by the title and described by the consequence. Focus starts
+ * on Cancel, the safe choice.
+ */
 function AlertDialog({ ...props }) {
     return _jsx(AlertDialogPrimitive.Root, { "data-slot": "alert-dialog", ...props });
 }

package/dist/components/alert.d.ts

@@ -3,6 +3,20 @@ import { type VariantProps } from "class-variance-authority";
 declare const alertVariants: (props?: ({
     variant?: "default" | "destructive" | "info" | "warning" | null | undefined;
 } & import("class-variance-authority/types").ClassProp) | undefined) => string;
+/**
+ * The note primitive under every banner and notice: an icon, a title, a description and an action.
+ *
+ * @family Feedback
+ * @when Drawing a notice the composition owners do not cover, inside the package. A product's
+ * notice is `NoticeBanner` or `MessageNotice`.
+ * @instead A condition of a page or the account is `NoticeBanner`; a message about one control or
+ * section is `MessageNotice`; a finished action is a toast.
+ * @behaviour A soft ground, deep text, the 1 px line edge, 6 px corners; the icon leads, the action
+ * trails.
+ * @words Title names the condition; the description what it stops; the action the fix as verb and
+ * noun.
+ * @access `role="alert"` by default; a calmer owner passes `status` or `note`. The icon is hidden.
+ */
 declare function Alert({ className, variant, ...props }: React.ComponentProps<"div"> & VariantProps<typeof alertVariants>): React.JSX.Element;
 declare function AlertTitle({ className, ...props }: React.ComponentProps<"div">): React.JSX.Element;
 declare function AlertDescription({ className, ...props }: React.ComponentProps<"div">): React.JSX.Element;

package/dist/components/alert.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"alert.d.ts","sourceRoot":"","sources":["../../src/components/alert.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,EAAO,KAAK,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAIlE,QAAA,MAAM,aAAa;;8EAiBlB,CAAC;AAEF,iBAAS,KAAK,CAAC,EACb,SAAS,EACT,OAAO,EACP,GAAG,KAAK,EACT,EAAE,KAAK,CAAC,cAAc,CAAC,KAAK,CAAC,GAAG,YAAY,CAAC,OAAO,aAAa,CAAC,qBAUlE;AAED,iBAAS,UAAU,CAAC,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,KAAK,CAAC,cAAc,CAAC,KAAK,CAAC,qBAWvE;AAED,iBAAS,gBAAgB,CAAC,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,KAAK,CAAC,cAAc,CAAC,KAAK,CAAC,qBAW7E;AAED,iBAAS,WAAW,CAAC,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,KAAK,CAAC,cAAc,CAAC,KAAK,CAAC,qBAWxE;AAED,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,gBAAgB,EAAE,WAAW,EAAE,CAAC"}
+{"version":3,"file":"alert.d.ts","sourceRoot":"","sources":["../../src/components/alert.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,EAAO,KAAK,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAIlE,QAAA,MAAM,aAAa;;8EAiBlB,CAAC;AAEF;;;;;;;;;;;;;GAaG;AACH,iBAAS,KAAK,CAAC,EACb,SAAS,EACT,OAAO,EACP,GAAG,KAAK,EACT,EAAE,KAAK,CAAC,cAAc,CAAC,KAAK,CAAC,GAAG,YAAY,CAAC,OAAO,aAAa,CAAC,qBAUlE;AAED,iBAAS,UAAU,CAAC,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,KAAK,CAAC,cAAc,CAAC,KAAK,CAAC,qBAWvE;AAED,iBAAS,gBAAgB,CAAC,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,KAAK,CAAC,cAAc,CAAC,KAAK,CAAC,qBAW7E;AAED,iBAAS,WAAW,CAAC,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,KAAK,CAAC,cAAc,CAAC,KAAK,CAAC,qBAWxE;AAED,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,gBAAgB,EAAE,WAAW,EAAE,CAAC"}

package/dist/components/alert.js

@@ -14,6 +14,20 @@ const alertVariants = cva("group/alert relative grid w-full gap-0.5 rounded-sm b
         variant: "default",
     },
 });
+/**
+ * The note primitive under every banner and notice: an icon, a title, a description and an action.
+ *
+ * @family Feedback
+ * @when Drawing a notice the composition owners do not cover, inside the package. A product's
+ * notice is `NoticeBanner` or `MessageNotice`.
+ * @instead A condition of a page or the account is `NoticeBanner`; a message about one control or
+ * section is `MessageNotice`; a finished action is a toast.
+ * @behaviour A soft ground, deep text, the 1 px line edge, 6 px corners; the icon leads, the action
+ * trails.
+ * @words Title names the condition; the description what it stops; the action the fix as verb and
+ * noun.
+ * @access `role="alert"` by default; a calmer owner passes `status` or `note`. The icon is hidden.
+ */
 function Alert({ className, variant, ...props }) {
     return (_jsx("div", { "data-slot": "alert", "data-variant": variant ?? "default", role: "alert", className: cn(alertVariants({ variant }), className), ...props }));
 }

package/dist/components/app-mark.d.ts

@@ -8,7 +8,7 @@ type AppLogo = {
 /** The logo Composio's catalogue gives a toolkit: its `meta.logo`, and the drawing it serves for a dark theme. */
 declare function composioLogo(toolkit: string): AppLogo;
 /** What the tile draws: the logo its catalogue gives, a platform's mark, or neither and the initial. */
-type AppMarkGlyph = {
+export type AppMarkGlyph = {
     /** The logo the app's catalogue gives, such as `composioLogo(toolkit)`. */
     logo?: AppLogo;
     platform?: never;
@@ -29,9 +29,19 @@ type AppMarkProps = Omit<React.ComponentProps<"span">, "children"> & AppMarkGlyp
     label?: string;
 };
 /**
- * An app, a channel or anything else a record connects, in the tile every
- * such mark shares: the catalogue's logo, the platform's mark, or the initial
- * when there is neither. Never a guessed logo.
+ * An app, a channel or anything else a record connects, in the tile every such mark shares.
+ *
+ * @family Status
+ * @when A connected app or channel beside its name: a toolkit in the Library, a messaging channel
+ * on an Agent. 28 px in a row.
+ * @instead A model's maker is `ModelMark`. A Library skill is its `IdentityMark` tile. An Agent is
+ * her orb. A platform alone, with no tile, is `PlatformMark`.
+ * @behaviour Draws the catalogue's logo (`composioLogo(toolkit)`), else the platform's mark, else
+ * the app's initial; never a guessed logo. The logo takes its dark drawing in a dark theme. The
+ * glyph is 62% of the tile.
+ * @words None of its own; the app's name stands beside it.
+ * @access Decorative beside the name. A bare mark takes `label` and becomes `role="img"` with that
+ * name.
  */
 declare function AppMark({ app, logo, platform, size, label, className, style, ...props }: AppMarkProps): React.JSX.Element;
 export { AppMark, composioLogo };

package/dist/components/app-mark.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"app-mark.d.ts","sourceRoot":"","sources":["../../src/components/app-mark.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,KAAK,MAAM,OAAO,CAAC;AAIpC,OAAO,EAAgB,KAAK,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAOlE,qFAAqF;AACrF,KAAK,OAAO,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAE/C,kHAAkH;AAClH,iBAAS,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAG9C;AAYD,wGAAwG;AACxG,KAAK,YAAY,GACb;IACE,2EAA2E;IAC3E,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,QAAQ,CAAC,EAAE,KAAK,CAAC;CAClB,GACD;IACE,IAAI,CAAC,EAAE,KAAK,CAAC;IACb,kEAAkE;IAClE,QAAQ,CAAC,EAAE,YAAY,CAAC;CACzB,CAAC;AAEN,KAAK,YAAY,GAAG,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,MAAM,CAAC,EAAE,UAAU,CAAC,GAChE,YAAY,GAAG;IACb,qFAAqF;IACrF,GAAG,EAAE,MAAM,CAAC;IACZ,8EAA8E;IAC9E,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AAEJ;;;;GAIG;AACH,iBAAS,OAAO,CAAC,EACf,GAAG,EACH,IAAI,EACJ,QAAQ,EACR,IAAoB,EACpB,KAAK,EACL,SAAS,EACT,KAAK,EACL,GAAG,KAAK,EACT,EAAE,YAAY,qBAoDd;AAED,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,CAAC;AACjC,YAAY,EAAE,OAAO,EAAE,YAAY,EAAE,CAAC"}
+{"version":3,"file":"app-mark.d.ts","sourceRoot":"","sources":["../../src/components/app-mark.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,KAAK,MAAM,OAAO,CAAC;AAIpC,OAAO,EAAgB,KAAK,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAOlE,qFAAqF;AACrF,KAAK,OAAO,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAE/C,kHAAkH;AAClH,iBAAS,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAG9C;AAYD,wGAAwG;AACxG,MAAM,MAAM,YAAY,GACpB;IACE,2EAA2E;IAC3E,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,QAAQ,CAAC,EAAE,KAAK,CAAC;CAClB,GACD;IACE,IAAI,CAAC,EAAE,KAAK,CAAC;IACb,kEAAkE;IAClE,QAAQ,CAAC,EAAE,YAAY,CAAC;CACzB,CAAC;AAEN,KAAK,YAAY,GAAG,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,MAAM,CAAC,EAAE,UAAU,CAAC,GAChE,YAAY,GAAG;IACb,qFAAqF;IACrF,GAAG,EAAE,MAAM,CAAC;IACZ,8EAA8E;IAC9E,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AAEJ;;;;;;;;;;;;;;GAcG;AACH,iBAAS,OAAO,CAAC,EACf,GAAG,EACH,IAAI,EACJ,QAAQ,EACR,IAAoB,EACpB,KAAK,EACL,SAAS,EACT,KAAK,EACL,GAAG,KAAK,EACT,EAAE,YAAY,qBAqDd;AAED,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,CAAC;AACjC,YAAY,EAAE,OAAO,EAAE,YAAY,EAAE,CAAC"}

package/dist/components/app-mark.js

@@ -17,9 +17,19 @@ function appInitial(app) {
         ?.toUpperCase() ?? "?");
 }
 /**
- * An app, a channel or anything else a record connects, in the tile every
- * such mark shares: the catalogue's logo, the platform's mark, or the initial
- * when there is neither. Never a guessed logo.
+ * An app, a channel or anything else a record connects, in the tile every such mark shares.
+ *
+ * @family Status
+ * @when A connected app or channel beside its name: a toolkit in the Library, a messaging channel
+ * on an Agent. 28 px in a row.
+ * @instead A model's maker is `ModelMark`. A Library skill is its `IdentityMark` tile. An Agent is
+ * her orb. A platform alone, with no tile, is `PlatformMark`.
+ * @behaviour Draws the catalogue's logo (`composioLogo(toolkit)`), else the platform's mark, else
+ * the app's initial; never a guessed logo. The logo takes its dark drawing in a dark theme. The
+ * glyph is 62% of the tile.
+ * @words None of its own; the app's name stands beside it.
+ * @access Decorative beside the name. A bare mark takes `label` and becomes `role="img"` with that
+ * name.
  */
 function AppMark({ app, logo, platform, size = APP_MARK_SIZE, label, className, style, ...props }) {
     const named = Boolean(label?.trim() || props["aria-label"]?.trim() || props["aria-labelledby"]?.trim());
@@ -29,7 +39,9 @@ function AppMark({ app, logo, platform, size = APP_MARK_SIZE, label, className,
             ? { role: "img", "aria-label": label }
             : {};
     const glyph = Math.round(size * APP_MARK_GLYPH_RATIO);
-    return (_jsx("span", { "data-slot": "app-mark", "data-app": app, "data-mark": logo || platform ? "brand" : "monogram", className: cn("inline-flex shrink-0 items-center justify-center rounded-md border border-border bg-background text-foreground", className), style: { width: size, height: size, ...style }, ...props, ...labelling, children: platform ? (_jsx(PlatformMark, { platform: platform, size: glyph })) : logo ? (_jsx("span", { "aria-hidden": "true", className: "block", "data-slot": "app-mark-logo", style: {
+    return (_jsx("span", { "data-slot": "app-mark", "data-app": app, "data-mark": logo || platform ? "brand" : "monogram", className: cn("inline-flex shrink-0 items-center justify-center rounded-md border border-border bg-background text-foreground", className), style: { width: size, height: size, ...style }, ...props, ...labelling, children: platform ? (_jsx(PlatformMark, { platform: platform, size: glyph })) : logo ? (_jsx("span", { "aria-hidden": "true", className: "block", "data-slot": "app-mark-logo", 
+            // SAFETY: CSSProperties lists only standard properties; React sets each `--` custom property key here through style.setProperty.
+            style: {
                 width: glyph,
                 height: glyph,
                 "--app-mark-logo": `url("${logo.light}")`,

package/dist/components/approval-row.d.ts

@@ -3,11 +3,24 @@ import { Item } from "./item.js";
 /**
  * One thing waiting for a person's yes: a mark for what is asking, the request
  * in one sentence, what happened underneath it, and the single action that
- * clears it. It is a row and not a card, because an approval is one of a list
- * and the list is read top to bottom; put several in an `ItemGroup`.
+ * clears it.
+ *
+ * It is a row and not a card, because an approval is one of a list and the list
+ * is read top to bottom; put several in an `ItemGroup`.
  *
  * The row says what waits and offers the yes. Who may say it, what it changes
  * and what happens after belong to the product that mounts it.
+ *
+ * @family Data
+ * @when Each request in a list of approvals: a mark for what is asking, the request in one
+ * sentence, what happened, and the one action that clears it.
+ * @instead A record's state is a `StatusBadge`. A notice about a condition is `NoticeBanner`. An
+ * Agent's question inside a conversation belongs to the conversation.
+ * @behaviour An outline `Item` at the small size; several sit in an `ItemGroup`. A `failed`
+ * description is announced.
+ * @words The title is the request as a sentence; the action is its yes as verb and noun: *Approve
+ * payment*.
+ * @access A `listitem`; a failed description is `role="alert"`.
  */
 export declare function ApprovalRow({ action, description, failed, media, title, ...props }: Omit<ComponentProps<typeof Item>, "children" | "variant" | "size" | "title"> & {
     /** The mark of what is asking: a channel's mark, a person's avatar, an Agent's orb. */

package/dist/components/approval-row.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"approval-row.d.ts","sourceRoot":"","sources":["../../src/components/approval-row.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAEvD,OAAO,EACL,IAAI,EAML,MAAM,mBAAmB,CAAC;AAE3B;;;;;;;;GAQG;AACH,wBAAgB,WAAW,CAAC,EAC1B,MAAM,EACN,WAAW,EACX,MAAM,EACN,KAAK,EACL,KAAK,EACL,GAAG,KAAK,EACT,EAAE,IAAI,CAAC,cAAc,CAAC,OAAO,IAAI,CAAC,EAAE,UAAU,GAAG,SAAS,GAAG,MAAM,GAAG,OAAO,CAAC,GAAG;IAChF,uFAAuF;IACvF,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,KAAK,EAAE,SAAS,CAAC;IACjB,WAAW,CAAC,EAAE,SAAS,CAAC;IACxB,oEAAoE;IACpE,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,SAAS,CAAC;CACpB,+BAeA"}
+{"version":3,"file":"approval-row.d.ts","sourceRoot":"","sources":["../../src/components/approval-row.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAEvD,OAAO,EACL,IAAI,EAML,MAAM,mBAAmB,CAAC;AAE3B;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,WAAW,CAAC,EAC1B,MAAM,EACN,WAAW,EACX,MAAM,EACN,KAAK,EACL,KAAK,EACL,GAAG,KAAK,EACT,EAAE,IAAI,CAAC,cAAc,CAAC,OAAO,IAAI,CAAC,EAAE,UAAU,GAAG,SAAS,GAAG,MAAM,GAAG,OAAO,CAAC,GAAG;IAChF,uFAAuF;IACvF,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,KAAK,EAAE,SAAS,CAAC;IACjB,WAAW,CAAC,EAAE,SAAS,CAAC;IACxB,oEAAoE;IACpE,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,SAAS,CAAC;CACpB,+BAeA"}