@nadicodeai/ui 12.1.96 → 12.1.97

package/dist/components/diff-count.d.ts

@@ -2,6 +2,17 @@ interface DiffCountProps extends React.ComponentProps<"span"> {
     added: number;
     removed: number;
 }
+/**
+ * Lines added and removed, as +n and −n.
+ *
+ * @family Data
+ * @when Beside a file or a change: how many lines it adds and removes.
+ * @instead The lines themselves are `FileDiff`. A change in a figure is `TrendBadge`.
+ * @behaviour Renders nothing when both are zero. The numbers roll to a new value; still under
+ * reduced motion.
+ * @words Signed counts with a true minus: *+12 −3*.
+ * @access Read as text.
+ */
 declare function DiffCount({ added, removed, className, ...props }: DiffCountProps): import("react").JSX.Element | null;
 export { DiffCount };
 //# sourceMappingURL=diff-count.d.ts.map

package/dist/components/diff-count.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"diff-count.d.ts","sourceRoot":"","sources":["../../src/components/diff-count.tsx"],"names":[],"mappings":"AA0BA,UAAU,cAAe,SAAQ,KAAK,CAAC,cAAc,CAAC,MAAM,CAAC;IAC3D,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,iBAAS,SAAS,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,cAAc,sCAoBzE;AAED,OAAO,EAAE,SAAS,EAAE,CAAC"}
+{"version":3,"file":"diff-count.d.ts","sourceRoot":"","sources":["../../src/components/diff-count.tsx"],"names":[],"mappings":"AA0BA,UAAU,cAAe,SAAQ,KAAK,CAAC,cAAc,CAAC,MAAM,CAAC;IAC3D,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;;;;GAUG;AACH,iBAAS,SAAS,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,cAAc,sCAoBzE;AAED,OAAO,EAAE,SAAS,EAAE,CAAC"}

package/dist/components/diff-count.js

@@ -18,6 +18,17 @@ function AnimatedInt({ value }) {
     }
     return _jsx(motion.span, { children: text });
 }
+/**
+ * Lines added and removed, as +n and −n.
+ *
+ * @family Data
+ * @when Beside a file or a change: how many lines it adds and removes.
+ * @instead The lines themselves are `FileDiff`. A change in a figure is `TrendBadge`.
+ * @behaviour Renders nothing when both are zero. The numbers roll to a new value; still under
+ * reduced motion.
+ * @words Signed counts with a true minus: *+12 −3*.
+ * @access Read as text.
+ */
 function DiffCount({ added, removed, className, ...props }) {
     if (!added && !removed)
         return null;

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

@@ -7,6 +7,18 @@ interface DisclosureRowProps {
     open: boolean;
     trailing?: ReactNode;
 }
+/**
+ * A row whose label opens what it holds, with an action and a trailing value beside it.
+ *
+ * @family Data
+ * @when A line in a dense list that opens to show its detail: a tool call, a group of steps.
+ * @instead Supporting detail on a page is `Disclosure`. A long block cut short is
+ * `ExpandableBlock`.
+ * @behaviour The chevron shows on hover or focus and while open. Without `onToggle` the row is
+ * static and draws no chevron.
+ * @words The label names what is inside; the trailing value is a short figure.
+ * @access The label is a `button` with `aria-expanded` when it toggles.
+ */
 declare function DisclosureRow({ action, children, className, onToggle, open, trailing, }: DisclosureRowProps): import("react").JSX.Element;
 export { DisclosureRow };
 //# sourceMappingURL=disclosure-row.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"disclosure-row.d.ts","sourceRoot":"","sources":["../../src/components/disclosure-row.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAKvC,UAAU,kBAAkB;IAC1B,MAAM,CAAC,EAAE,SAAS,CAAC;IACnB,QAAQ,EAAE,SAAS,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAC;IACtB,IAAI,EAAE,OAAO,CAAC;IACd,QAAQ,CAAC,EAAE,SAAS,CAAC;CACtB;AAED,iBAAS,aAAa,CAAC,EACrB,MAAM,EACN,QAAQ,EACR,SAAS,EACT,QAAQ,EACR,IAAI,EACJ,QAAQ,GACT,EAAE,kBAAkB,+BA+CpB;AAED,OAAO,EAAE,aAAa,EAAE,CAAC"}
+{"version":3,"file":"disclosure-row.d.ts","sourceRoot":"","sources":["../../src/components/disclosure-row.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAKvC,UAAU,kBAAkB;IAC1B,MAAM,CAAC,EAAE,SAAS,CAAC;IACnB,QAAQ,EAAE,SAAS,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAC;IACtB,IAAI,EAAE,OAAO,CAAC;IACd,QAAQ,CAAC,EAAE,SAAS,CAAC;CACtB;AAED;;;;;;;;;;;GAWG;AACH,iBAAS,aAAa,CAAC,EACrB,MAAM,EACN,QAAQ,EACR,SAAS,EACT,QAAQ,EACR,IAAI,EACJ,QAAQ,GACT,EAAE,kBAAkB,+BA+CpB;AAED,OAAO,EAAE,aAAa,EAAE,CAAC"}

package/dist/components/disclosure-row.js

@@ -1,6 +1,18 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { ChevronRightIcon } from "lucide-react";
 import { cn } from "../lib/utils.js";
+/**
+ * A row whose label opens what it holds, with an action and a trailing value beside it.
+ *
+ * @family Data
+ * @when A line in a dense list that opens to show its detail: a tool call, a group of steps.
+ * @instead Supporting detail on a page is `Disclosure`. A long block cut short is
+ * `ExpandableBlock`.
+ * @behaviour The chevron shows on hover or focus and while open. Without `onToggle` the row is
+ * static and draws no chevron.
+ * @words The label names what is inside; the trailing value is a short figure.
+ * @access The label is a `button` with `aria-expanded` when it toggles.
+ */
 function DisclosureRow({ action, children, className, onToggle, open, trailing, }) {
     return (_jsxs("div", { className: cn("group/disclosure-row relative flex w-full max-w-full min-w-0 text-muted-foreground", className), "data-slot": "disclosure-row", children: [_jsxs("button", { "aria-expanded": onToggle ? open : undefined, className: cn("nc-transition-paint flex min-w-0 max-w-fit items-start gap-1.5 text-left", onToggle ? "hover:text-foreground focus-visible:text-foreground" : "cursor-default"), disabled: !onToggle, onClick: onToggle, type: "button", children: [_jsx("span", { className: "flex min-w-0 flex-col gap-0.5", children: children }), onToggle ? (_jsx("span", { className: cn("nc-transition-opacity flex shrink-0 items-center justify-center", open
                             ? "opacity-80"

package/dist/components/disclosure.d.ts

@@ -6,11 +6,21 @@ interface DisclosureProps {
     label: ReactNode;
 }
 /**
- * Supporting detail a person opens on demand, such as other download formats
- * or a checksum. It is the native `<details>` element, so it opens without
- * JavaScript, renders on the server, and is announced as a disclosure; the
- * closed label names what is inside, because a closed disclosure must still say
- * what it holds (DESIGN.md "Page compositions").
+ * Supporting detail a person opens on demand, such as other download formats or
+ * a checksum.
+ *
+ * It is the native `<details>` element, so it opens without JavaScript, renders
+ * on the server, and is announced as a disclosure; the closed label names what
+ * is inside, because a closed disclosure must still say what it holds
+ * (DESIGN.md "Page compositions").
+ *
+ * @family Other
+ * @when Supporting detail a person opens on demand, such as other download formats or a checksum.
+ * @instead Named sections are `Accordion`. A long block cut short is `ExpandableBlock`. A warning
+ * is never hidden in one.
+ * @behaviour Opens without JavaScript and renders on the server; the chevron turns when open.
+ * @words The closed label names what is inside: *Other formats*, *Checksum*.
+ * @access A native `details` and `summary`, announced as a disclosure.
  */
 declare function Disclosure({ children, className, defaultOpen, label }: DisclosureProps): import("react").JSX.Element;
 export { Disclosure };

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

@@ -1 +1 @@
-{"version":3,"file":"disclosure.d.ts","sourceRoot":"","sources":["../../src/components/disclosure.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAKvC,UAAU,eAAe;IACvB,QAAQ,EAAE,SAAS,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,KAAK,EAAE,SAAS,CAAC;CAClB;AAED;;;;;;GAMG;AACH,iBAAS,UAAU,CAAC,EAAE,QAAQ,EAAE,SAAS,EAAE,WAAW,EAAE,KAAK,EAAE,EAAE,eAAe,+BAsB/E;AAED,OAAO,EAAE,UAAU,EAAE,CAAC"}
+{"version":3,"file":"disclosure.d.ts","sourceRoot":"","sources":["../../src/components/disclosure.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAKvC,UAAU,eAAe;IACvB,QAAQ,EAAE,SAAS,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,KAAK,EAAE,SAAS,CAAC;CAClB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,iBAAS,UAAU,CAAC,EAAE,QAAQ,EAAE,SAAS,EAAE,WAAW,EAAE,KAAK,EAAE,EAAE,eAAe,+BAsB/E;AAED,OAAO,EAAE,UAAU,EAAE,CAAC"}

package/dist/components/disclosure.js

@@ -2,11 +2,21 @@ import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { ChevronRightIcon } from "lucide-react";
 import { cn } from "../lib/utils.js";
 /**
- * Supporting detail a person opens on demand, such as other download formats
- * or a checksum. It is the native `<details>` element, so it opens without
- * JavaScript, renders on the server, and is announced as a disclosure; the
- * closed label names what is inside, because a closed disclosure must still say
- * what it holds (DESIGN.md "Page compositions").
+ * Supporting detail a person opens on demand, such as other download formats or
+ * a checksum.
+ *
+ * It is the native `<details>` element, so it opens without JavaScript, renders
+ * on the server, and is announced as a disclosure; the closed label names what
+ * is inside, because a closed disclosure must still say what it holds
+ * (DESIGN.md "Page compositions").
+ *
+ * @family Other
+ * @when Supporting detail a person opens on demand, such as other download formats or a checksum.
+ * @instead Named sections are `Accordion`. A long block cut short is `ExpandableBlock`. A warning
+ * is never hidden in one.
+ * @behaviour Opens without JavaScript and renders on the server; the chevron turns when open.
+ * @words The closed label names what is inside: *Other formats*, *Checksum*.
+ * @access A native `details` and `summary`, announced as a disclosure.
  */
 function Disclosure({ children, className, defaultOpen, label }) {
     return (_jsxs("details", { className: cn("group/disclosure", className), "data-slot": "disclosure", open: defaultOpen, children: [_jsxs("summary", { className: "nc-transition-paint flex min-h-6 w-fit cursor-pointer list-none items-center gap-1 text-sm font-medium text-muted-foreground underline-offset-4 hover:text-foreground hover:underline [&::-webkit-details-marker]:hidden", "data-slot": "disclosure-trigger", children: [_jsx(ChevronRightIcon, { "aria-hidden": "true", className: "nc-transition-transform size-4 shrink-0 group-open/disclosure:rotate-90" }), label] }), _jsx("div", { className: "flex flex-col gap-nadicode-sm pt-nadicode-xs", "data-slot": "disclosure-content", children: children })] }));

package/dist/components/drawer.d.ts

@@ -1,5 +1,18 @@
 import * as React from "react";
 import { Drawer as DrawerPrimitive } from "@base-ui/react/drawer";
+/**
+ * The low-level swipe drawer primitive.
+ *
+ * @family Menus
+ * @when A surface that slides from an edge and follows a swipe. No screen calls it today; screens
+ * use `FormDrawer`.
+ * @instead A catalogue or a setup in steps is `FormDrawer`. Context beside a record is `Sheet`. A
+ * few fields are `FormDialog`.
+ * @behaviour Opens from its swipe direction and follows the finger; nested drawers stack. The
+ * header and footer stay while the body scrolls, each drawing the one hairline that separates it.
+ * @words Title is what it does to which record: *Connect Telegram*.
+ * @access A modal dialog named by its title with a named close; focus returns to the trigger.
+ */
 declare function Drawer({ modal, showSwipeHandle, snapPoints, swipeDirection, ...props }: DrawerPrimitive.Root.Props & {
     showSwipeHandle?: boolean;
 }): React.JSX.Element;

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

@@ -1 +1 @@
-{"version":3,"file":"drawer.d.ts","sourceRoot":"","sources":["../../src/components/drawer.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,EAAE,MAAM,IAAI,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAuBlE,iBAAS,MAAM,CAAC,EACd,KAAY,EACZ,eAAuB,EACvB,UAAU,EACV,cAAuB,EACvB,GAAG,KAAK,EACT,EAAE,eAAe,CAAC,IAAI,CAAC,KAAK,GAAG;IAC9B,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B,qBAkBA;AAED,iBAAS,aAAa,CAAC,EAAE,GAAG,KAAK,EAAE,EAAE,eAAe,CAAC,OAAO,CAAC,KAAK,qBAEjE;AAED,iBAAS,YAAY,CAAC,EAAE,GAAG,KAAK,EAAE,EAAE,eAAe,CAAC,MAAM,CAAC,KAAK,qBAE/D;AAED,iBAAS,WAAW,CAAC,EAAE,GAAG,KAAK,EAAE,EAAE,eAAe,CAAC,KAAK,CAAC,KAAK,qBAE7D;AAED,iBAAS,aAAa,CAAC,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,eAAe,CAAC,QAAQ,CAAC,KAAK,qBAW7E;AAED,iBAAS,iBAAiB,CAAC,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,KAAK,CAAC,cAAc,CAAC,KAAK,CAAC,qBAY9E;AAED,iBAAS,aAAa,CAAC,EAAE,SAAS,EAAE,QAAQ,EAAE,GAAG,KAAK,EAAE,EAAE,eAAe,CAAC,KAAK,CAAC,KAAK,qBA0DpF;AAED;;;;GAIG;AACH,iBAAS,YAAY,CAAC,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,KAAK,CAAC,cAAc,CAAC,KAAK,CAAC,qBAWzE;AAED;;;GAGG;AACH,iBAAS,UAAU,CAAC,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,KAAK,CAAC,cAAc,CAAC,KAAK,CAAC,qBAWvE;AAED,iBAAS,YAAY,CAAC,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,KAAK,CAAC,cAAc,CAAC,KAAK,CAAC,qBAWzE;AAED,iBAAS,WAAW,CAAC,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,eAAe,CAAC,KAAK,CAAC,KAAK,qBAQxE;AAED,iBAAS,iBAAiB,CAAC,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,eAAe,CAAC,WAAW,CAAC,KAAK,qBAQpF;AAED,OAAO,EACL,MAAM,EACN,YAAY,EACZ,aAAa,EACb,iBAAiB,EACjB,aAAa,EACb,WAAW,EACX,aAAa,EACb,YAAY,EACZ,UAAU,EACV,YAAY,EACZ,WAAW,EACX,iBAAiB,GAClB,CAAC"}
+{"version":3,"file":"drawer.d.ts","sourceRoot":"","sources":["../../src/components/drawer.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,EAAE,MAAM,IAAI,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAuBlE;;;;;;;;;;;;GAYG;AACH,iBAAS,MAAM,CAAC,EACd,KAAY,EACZ,eAAuB,EACvB,UAAU,EACV,cAAuB,EACvB,GAAG,KAAK,EACT,EAAE,eAAe,CAAC,IAAI,CAAC,KAAK,GAAG;IAC9B,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B,qBAkBA;AAED,iBAAS,aAAa,CAAC,EAAE,GAAG,KAAK,EAAE,EAAE,eAAe,CAAC,OAAO,CAAC,KAAK,qBAEjE;AAED,iBAAS,YAAY,CAAC,EAAE,GAAG,KAAK,EAAE,EAAE,eAAe,CAAC,MAAM,CAAC,KAAK,qBAE/D;AAED,iBAAS,WAAW,CAAC,EAAE,GAAG,KAAK,EAAE,EAAE,eAAe,CAAC,KAAK,CAAC,KAAK,qBAE7D;AAED,iBAAS,aAAa,CAAC,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,eAAe,CAAC,QAAQ,CAAC,KAAK,qBAW7E;AAED,iBAAS,iBAAiB,CAAC,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,KAAK,CAAC,cAAc,CAAC,KAAK,CAAC,qBAY9E;AAED,iBAAS,aAAa,CAAC,EAAE,SAAS,EAAE,QAAQ,EAAE,GAAG,KAAK,EAAE,EAAE,eAAe,CAAC,KAAK,CAAC,KAAK,qBA0DpF;AAED;;;;GAIG;AACH,iBAAS,YAAY,CAAC,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,KAAK,CAAC,cAAc,CAAC,KAAK,CAAC,qBAWzE;AAED;;;GAGG;AACH,iBAAS,UAAU,CAAC,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,KAAK,CAAC,cAAc,CAAC,KAAK,CAAC,qBAWvE;AAED,iBAAS,YAAY,CAAC,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,KAAK,CAAC,cAAc,CAAC,KAAK,CAAC,qBAWzE;AAED,iBAAS,WAAW,CAAC,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,eAAe,CAAC,KAAK,CAAC,KAAK,qBAQxE;AAED,iBAAS,iBAAiB,CAAC,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,eAAe,CAAC,WAAW,CAAC,KAAK,qBAQpF;AAED,OAAO,EACL,MAAM,EACN,YAAY,EACZ,aAAa,EACb,iBAAiB,EACjB,aAAa,EACb,WAAW,EACX,aAAa,EACb,YAAY,EACZ,UAAU,EACV,YAAY,EACZ,WAAW,EACX,iBAAiB,GAClB,CAAC"}

package/dist/components/drawer.js

@@ -11,6 +11,19 @@ function useDrawer() {
     }
     return context;
 }
+/**
+ * The low-level swipe drawer primitive.
+ *
+ * @family Menus
+ * @when A surface that slides from an edge and follows a swipe. No screen calls it today; screens
+ * use `FormDrawer`.
+ * @instead A catalogue or a setup in steps is `FormDrawer`. Context beside a record is `Sheet`. A
+ * few fields are `FormDialog`.
+ * @behaviour Opens from its swipe direction and follows the finger; nested drawers stack. The
+ * header and footer stay while the body scrolls, each drawing the one hairline that separates it.
+ * @words Title is what it does to which record: *Connect Telegram*.
+ * @access A modal dialog named by its title with a named close; focus returns to the trigger.
+ */
 function Drawer({ modal = true, showSwipeHandle = false, snapPoints, swipeDirection = "down", ...props }) {
     const hasSnapPoints = snapPoints != null && snapPoints.length > 0;
     const contextValue = React.useMemo(() => ({ hasSnapPoints, modal, showSwipeHandle, swipeDirection }), [hasSnapPoints, modal, showSwipeHandle, swipeDirection]);

package/dist/components/dropdown-menu.d.ts

@@ -1,5 +1,15 @@
 import * as React from "react";
 import { Menu as MenuPrimitive } from "@base-ui/react/menu";
+/**
+ * A menu that floats from a visible trigger, built from its parts: the surface, labelled groups, commands, choices and dividers.
+ *
+ * @family Menus
+ * @when A menu no composition draws: a column chooser, a sort, a product's own choices in a submenu.
+ * @instead A record's or a page's commands are `ActionMenu` or `PageActions`' menu, from data. The account's rows are `AccountMenu`. A value to choose in a form is `Select`; finding across everything is `CommandDialog`.
+ * @behaviour Solid floating surface, 12 px corners, 4 px inset, at least 224 px. Rows 36 px (44 on touch), 12 px padding, accent fill on hover and focus. Opens on click; typeahead, arrows, Escape returns focus to the trigger. A `DropdownMenuCommand` leads with its icon; one that cannot run stays, greyed, with its reason under it.
+ * @words Commands are verb and noun in sentence case, "Remove mailbox", never a bare "Delete". About ten at most. Italian runs a third longer; rows wrap, never truncate.
+ * @access `role="menu"`, items `menuitem`, the trigger `aria-expanded` while open. A command's icon is hidden; the value it acts on and its reason are its description.
+ */
 declare function DropdownMenu({ ...props }: MenuPrimitive.Root.Props): React.JSX.Element;
 declare function DropdownMenuPortal({ ...props }: MenuPrimitive.Portal.Props): React.JSX.Element;
 declare function DropdownMenuTrigger({ ...props }: MenuPrimitive.Trigger.Props): React.JSX.Element;
@@ -16,13 +26,15 @@ declare function DropdownMenuItem({ className, iconOnly, inset, variant, ...prop
     variant?: "default" | "destructive";
 }): React.JSX.Element;
 /**
- * A command in a record's or a page's menu: its label first, a decorative icon
- * at the trailing edge. A command that cannot run now is `disabled` and stays
- * in place, greyed, with its `reason` under the label (DESIGN.md "Menus and
- * commands").
+ * A command in a record's, a page's or the account's menu: its decorative icon
+ * first, then its label, then the value it acts on in mono when it has one. A
+ * command that cannot run now is `disabled` and stays in place, greyed, with
+ * its `reason` under the label.
  */
-declare function DropdownMenuCommand({ icon, children, className, reason, ...props }: Omit<React.ComponentProps<typeof DropdownMenuItem>, "iconOnly"> & {
+declare function DropdownMenuCommand({ icon, children, className, detail, reason, "aria-label": accessibleName, ...props }: Omit<React.ComponentProps<typeof DropdownMenuItem>, "iconOnly"> & {
     icon: React.ReactElement;
+    /** The value the command acts on, read after its name: the address Copy address copies. */
+    detail?: string | undefined;
     /** Why the command cannot run now, read after its name. */
     reason?: React.ReactNode;
 }): React.JSX.Element;

package/dist/components/dropdown-menu.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dropdown-menu.d.ts","sourceRoot":"","sources":["../../src/components/dropdown-menu.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,EAAE,IAAI,IAAI,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAO5D,iBAAS,YAAY,CAAC,EAAE,GAAG,KAAK,EAAE,EAAE,aAAa,CAAC,IAAI,CAAC,KAAK,qBAE3D;AAED,iBAAS,kBAAkB,CAAC,EAAE,GAAG,KAAK,EAAE,EAAE,aAAa,CAAC,MAAM,CAAC,KAAK,qBAEnE;AAED,iBAAS,mBAAmB,CAAC,EAAE,GAAG,KAAK,EAAE,EAAE,aAAa,CAAC,OAAO,CAAC,KAAK,qBAErE;AAED,iBAAS,mBAAmB,CAAC,EAC3B,KAAe,EACf,WAAe,EACf,OAAuB,EACvB,IAAe,EACf,UAAc,EACd,SAAS,EACT,GAAG,KAAK,EACT,EAAE,aAAa,CAAC,KAAK,CAAC,KAAK,GAC1B,IAAI,CAAC,aAAa,CAAC,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,aAAa,GAAG,MAAM,GAAG,YAAY,CAAC,GAAG;IACtF,OAAO,CAAC,EAAE,SAAS,GAAG,aAAa,CAAC;CACrC,qBAoBF;AAED,iBAAS,iBAAiB,CAAC,EAAE,GAAG,KAAK,EAAE,EAAE,aAAa,CAAC,KAAK,CAAC,KAAK,qBAEjE;AAED,iBAAS,iBAAiB,CAAC,EACzB,SAAS,EACT,KAAK,EACL,GAAG,KAAK,EACT,EAAE,aAAa,CAAC,UAAU,CAAC,KAAK,GAAG;IAClC,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB,qBAYA;AAED,iBAAS,gBAAgB,CAAC,EACxB,SAAS,EACT,QAAgB,EAChB,KAAK,EACL,OAAmB,EACnB,GAAG,KAAK,EACT,EAAE,aAAa,CAAC,IAAI,CAAC,KAAK,GAAG;IAC5B,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,OAAO,CAAC,EAAE,SAAS,GAAG,aAAa,CAAC;CACrC,qBAgBA;AAED;;;;;GAKG;AACH,iBAAS,mBAAmB,CAAC,EAC3B,IAAI,EACJ,QAAQ,EACR,SAAS,EACT,MAAM,EACN,GAAG,KAAK,EACT,EAAE,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,OAAO,gBAAgB,CAAC,EAAE,UAAU,CAAC,GAAG;IACnE,IAAI,EAAE,KAAK,CAAC,YAAY,CAAC;IACzB,2DAA2D;IAC3D,MAAM,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;CAC1B,qBA6BA;AAED,iBAAS,eAAe,CAAC,EAAE,GAAG,KAAK,EAAE,EAAE,aAAa,CAAC,WAAW,CAAC,KAAK,qBAErE;AAED,iBAAS,sBAAsB,CAAC,EAC9B,SAAS,EACT,KAAK,EACL,QAAQ,EACR,GAAG,KAAK,EACT,EAAE,aAAa,CAAC,cAAc,CAAC,KAAK,GAAG;IACtC,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB,qBAeA;AAED,iBAAS,sBAAsB,CAAC,EAC9B,KAAe,EACf,WAAgB,EAChB,IAAc,EACd,UAAc,EACd,SAAS,EACT,GAAG,KAAK,EACT,EAAE,KAAK,CAAC,cAAc,CAAC,OAAO,mBAAmB,CAAC,qBAYlD;AAED,iBAAS,wBAAwB,CAAC,EAChC,SAAS,EACT,QAAQ,EACR,OAAO,EACP,KAAK,EACL,GAAG,KAAK,EACT,EAAE,aAAa,CAAC,YAAY,CAAC,KAAK,GAAG;IACpC,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB,qBAuBA;AAED,iBAAS,sBAAsB,CAAC,EAAE,GAAG,KAAK,EAAE,EAAE,aAAa,CAAC,UAAU,CAAC,KAAK,qBAE3E;AAED,iBAAS,qBAAqB,CAAC,EAC7B,SAAS,EACT,QAAgB,EAChB,QAAQ,EACR,KAAK,EACL,GAAG,KAAK,EACT,EAAE,aAAa,CAAC,SAAS,CAAC,KAAK,GAAG;IACjC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB,qBA2BA;AAED,iBAAS,qBAAqB,CAAC,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,aAAa,CAAC,SAAS,CAAC,KAAK,qBAQpF;AAED,iBAAS,oBAAoB,CAAC,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,KAAK,CAAC,cAAc,CAAC,MAAM,CAAC,qBAWlF;AAED,OAAO,EACL,YAAY,EACZ,kBAAkB,EAClB,mBAAmB,EACnB,mBAAmB,EACnB,iBAAiB,EACjB,iBAAiB,EACjB,gBAAgB,EAChB,mBAAmB,EACnB,wBAAwB,EACxB,sBAAsB,EACtB,qBAAqB,EACrB,qBAAqB,EACrB,oBAAoB,EACpB,eAAe,EACf,sBAAsB,EACtB,sBAAsB,GACvB,CAAC"}
+{"version":3,"file":"dropdown-menu.d.ts","sourceRoot":"","sources":["../../src/components/dropdown-menu.tsx"],"names":[],"mappings":"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"}

package/dist/components/dropdown-menu.js

@@ -5,6 +5,16 @@ import { cn } from "../lib/utils.js";
 import { anchoredOverlayMotion } from "../lib/motion.js";
 import { menuSurface } from "../internal/menu-surface.js";
 import { ChevronRightIcon, CheckIcon } from "lucide-react";
+/**
+ * A menu that floats from a visible trigger, built from its parts: the surface, labelled groups, commands, choices and dividers.
+ *
+ * @family Menus
+ * @when A menu no composition draws: a column chooser, a sort, a product's own choices in a submenu.
+ * @instead A record's or a page's commands are `ActionMenu` or `PageActions`' menu, from data. The account's rows are `AccountMenu`. A value to choose in a form is `Select`; finding across everything is `CommandDialog`.
+ * @behaviour Solid floating surface, 12 px corners, 4 px inset, at least 224 px. Rows 36 px (44 on touch), 12 px padding, accent fill on hover and focus. Opens on click; typeahead, arrows, Escape returns focus to the trigger. A `DropdownMenuCommand` leads with its icon; one that cannot run stays, greyed, with its reason under it.
+ * @words Commands are verb and noun in sentence case, "Remove mailbox", never a bare "Delete". About ten at most. Italian runs a third longer; rows wrap, never truncate.
+ * @access `role="menu"`, items `menuitem`, the trigger `aria-expanded` while open. A command's icon is hidden; the value it acts on and its reason are its description.
+ */
 function DropdownMenu({ ...props }) {
     return _jsx(MenuPrimitive.Root, { "data-slot": "dropdown-menu", ...props });
 }
@@ -21,21 +31,24 @@ function DropdownMenuGroup({ ...props }) {
     return _jsx(MenuPrimitive.Group, { "data-slot": "dropdown-menu-group", ...props });
 }
 function DropdownMenuLabel({ className, inset, ...props }) {
-    return (_jsx(MenuPrimitive.GroupLabel, { "data-slot": "dropdown-menu-label", "data-inset": inset, className: cn("px-1.5 py-1 text-xs font-medium text-muted-foreground data-inset:pl-7", className), ...props }));
+    return (_jsx(MenuPrimitive.GroupLabel, { "data-slot": "dropdown-menu-label", "data-inset": inset, className: cn("px-1.5 py-1 text-xs font-medium text-muted-foreground group-data-[density=comfortable]/menu:px-3 group-data-[density=comfortable]/menu:pt-1.5 data-inset:pl-7", className), ...props }));
 }
 function DropdownMenuItem({ className, iconOnly = false, inset, variant = "default", ...props }) {
     return (_jsx(MenuPrimitive.Item, { "data-slot": "dropdown-menu-item", "data-icon-only": iconOnly || undefined, "data-inset": inset, "data-variant": variant, className: cn("group/dropdown-menu-item relative flex min-h-touch-target cursor-default items-center gap-1.5 rounded-sm px-1.5 py-1 group-data-[density=comfortable]/menu:px-3 group-data-[density=comfortable]/menu:py-2 text-sm outline-hidden select-none focus:bg-accent focus:text-accent-foreground not-data-[variant=destructive]:focus:**:text-accent-foreground data-inset:pl-7 data-[variant=destructive]:text-destructive-soft-foreground data-[variant=destructive]:focus:bg-destructive-soft data-[variant=destructive]:focus:text-destructive-soft-foreground data-disabled:pointer-events-none data-disabled:opacity-50 [@media(hover:hover)_and_(pointer:fine)]:min-h-0 [&_svg]:pointer-events-none [&_svg]:shrink-0 [&_svg:not([class*='size-'])]:size-4 data-[variant=destructive]:*:[svg]:text-destructive-soft-foreground", iconOnly &&
             "size-8 min-w-touch-target shrink-0 justify-center rounded-sm p-0 group-data-[density=comfortable]/menu:p-0 [@media(hover:hover)_and_(pointer:fine)]:min-w-0", className), ...props }));
 }
 /**
- * A command in a record's or a page's menu: its label first, a decorative icon
- * at the trailing edge. A command that cannot run now is `disabled` and stays
- * in place, greyed, with its `reason` under the label (DESIGN.md "Menus and
- * commands").
+ * A command in a record's, a page's or the account's menu: its decorative icon
+ * first, then its label, then the value it acts on in mono when it has one. A
+ * command that cannot run now is `disabled` and stays in place, greyed, with
+ * its `reason` under the label.
  */
-function DropdownMenuCommand({ icon, children, className, reason, ...props }) {
+function DropdownMenuCommand({ icon, children, className, detail, reason, "aria-label": accessibleName, ...props }) {
     const id = React.useId();
-    return (_jsxs(DropdownMenuItem, { "aria-labelledby": reason ? `${id}-label` : undefined, "aria-describedby": reason ? `${id}-reason` : undefined, ...props, className: cn(className, "h-auto w-full min-w-0 justify-start gap-3 text-left font-normal whitespace-normal"), children: [_jsxs("span", { className: "grid min-w-0 flex-1 gap-0.5 break-words", children: [_jsx("span", { id: `${id}-label`, children: children }), reason ? (_jsx("span", { className: "text-xs text-muted-foreground", "data-slot": "dropdown-menu-reason", id: `${id}-reason`, children: reason })) : null] }), _jsx("span", { "aria-hidden": "true", className: "flex shrink-0 items-center justify-center", children: icon })] }));
+    const describedBy = [detail ? `${id}-detail` : null, reason ? `${id}-reason` : null]
+        .filter(Boolean)
+        .join(" ");
+    return (_jsxs(DropdownMenuItem, { "aria-label": accessibleName, "aria-labelledby": describedBy && !accessibleName ? `${id}-label` : undefined, "aria-describedby": describedBy || undefined, ...props, className: cn(className, "h-auto w-full min-w-0 items-start justify-start gap-2.5 text-left font-normal whitespace-normal"), children: [_jsx("span", { "aria-hidden": "true", className: "flex h-5 shrink-0 items-center justify-center text-muted-foreground group-data-[variant=destructive]/dropdown-menu-item:text-current", children: icon }), _jsxs("span", { className: "grid min-w-0 flex-1 gap-0.5 break-words", children: [_jsx("span", { id: `${id}-label`, children: children }), detail ? (_jsx("span", { className: "font-label-mono text-label-mono text-muted-foreground", "data-slot": "dropdown-menu-detail", id: `${id}-detail`, children: detail })) : null, reason ? (_jsx("span", { className: "text-xs text-muted-foreground", "data-slot": "dropdown-menu-reason", id: `${id}-reason`, children: reason })) : null] })] }));
 }
 function DropdownMenuSub({ ...props }) {
     return _jsx(MenuPrimitive.SubmenuRoot, { "data-slot": "dropdown-menu-sub", ...props });

package/dist/components/empty-art.d.ts

@@ -1,5 +1,5 @@
 /** The pictures of `@nadicodeai/design-system/assets/empty`, the only ones a first use shows. */
-export declare const EMPTY_ART_NAMES: readonly ["agents", "apps", "billing", "customers", "installations", "library", "mcp", "messages", "partners", "passwords", "plugins", "skills", "tasks"];
+export declare const EMPTY_ART_NAMES: readonly ["agents", "apps", "artifacts", "billing", "customers", "installations", "keys", "library", "mail", "mcp", "members", "messages", "partners", "passwords", "plans", "plugins", "skills", "tasks", "teams"];
 export type EmptyArtName = (typeof EMPTY_ART_NAMES)[number];
 declare const approved: unique symbol;
 /** A picture's address that came from the approved set through `approveEmptyArt`. */

package/dist/components/empty-art.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"empty-art.d.ts","sourceRoot":"","sources":["../../src/components/empty-art.ts"],"names":[],"mappings":"AAIA,iGAAiG;AACjG,eAAO,MAAM,eAAe,2JAclB,CAAC;AAEX,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,eAAe,CAAC,CAAC,MAAM,CAAC,CAAC;AAE5D,OAAO,CAAC,MAAM,QAAQ,EAAE,OAAO,MAAM,CAAC;AAEtC,qFAAqF;AACrF,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG;IAAE,QAAQ,CAAC,CAAC,QAAQ,CAAC,EAAE,IAAI,CAAA;CAAE,CAAC;AAE9D;;;GAGG;AACH,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,MAAM,CAAC,YAAY,EAAE,MAAM,GAAG;IAAE,GAAG,EAAE,MAAM,CAAA;CAAE,CAAC,GACvD,MAAM,CAAC,YAAY,EAAE,QAAQ,CAAC,CAShC"}
+{"version":3,"file":"empty-art.d.ts","sourceRoot":"","sources":["../../src/components/empty-art.ts"],"names":[],"mappings":"AAIA,iGAAiG;AACjG,eAAO,MAAM,eAAe,qNAoBlB,CAAC;AAEX,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,eAAe,CAAC,CAAC,MAAM,CAAC,CAAC;AAE5D,OAAO,CAAC,MAAM,QAAQ,EAAE,OAAO,MAAM,CAAC;AAEtC,qFAAqF;AACrF,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG;IAAE,QAAQ,CAAC,CAAC,QAAQ,CAAC,EAAE,IAAI,CAAA;CAAE,CAAC;AAE9D;;;GAGG;AACH,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,MAAM,CAAC,YAAY,EAAE,MAAM,GAAG;IAAE,GAAG,EAAE,MAAM,CAAA;CAAE,CAAC,GACvD,MAAM,CAAC,YAAY,EAAE,QAAQ,CAAC,CAShC"}

package/dist/components/empty-art.js

@@ -5,17 +5,23 @@
 export const EMPTY_ART_NAMES = [
     "agents",
     "apps",
+    "artifacts",
     "billing",
     "customers",
     "installations",
+    "keys",
     "library",
+    "mail",
     "mcp",
+    "members",
     "messages",
     "partners",
     "passwords",
+    "plans",
     "plugins",
     "skills",
     "tasks",
+    "teams",
 ];
 /**
  * The product's one map of the approved pictures, built from the design

package/dist/components/empty-state.d.ts

@@ -2,31 +2,45 @@ import type { EmptyArt } from "./empty-art.js";
 import { type PageCommand } from "./page-actions.js";
 import { type ResolvedMessage } from "./product-message.js";
 export type EmptyStateProps = {
+    /** The frame follows the container: page and region take a resting card with its own edge; card takes none. */
     scope?: "page" | "region" | "card";
-} & (({
+    /** The first use's title level; 3 inside a titled section. */
+    headingLevel?: 2 | 3;
+} & ({
     kind: "firstUse";
     title: string;
     description: string;
-    action?: PageCommand;
-} & ({
-    presentation?: "illustrated";
     picture: EmptyArt;
+    /** The action that fills it, only when this viewer can add. */
+    action?: PageCommand;
+    /** `outline` while the page's title row shows a primary of its own: one default button per surface. */
+    actionVariant?: "default" | "outline";
 } | {
-    presentation: "plain";
-    picture?: never;
-})) | {
     kind: "nothingYet";
     message: string;
-    presentation?: "plain" | "illustrated";
 } | {
     kind: "noResults";
     message: string;
     clear: PageCommand;
-    presentation?: "plain" | "illustrated";
 } | {
     kind: "failed";
     message: ResolvedMessage;
-    presentation?: "plain" | "illustrated";
 });
+/** One kind of absence, as a composition takes it: the composition sets its frame. */
+export type EmptyStateKind<K extends EmptyStateProps["kind"]> = Omit<Extract<EmptyStateProps, {
+    kind: K;
+}>, "scope" | "headingLevel">;
+/**
+ * What a place with nothing in it says: a first use shows its section's
+ * picture, a title, one line and the action that fills it; an empty list, a
+ * search that found nothing and a read that failed stay quiet.
+ *
+ * @family Feedback
+ * @when A collection, a section or a page has nothing to show: it never had a record (`firstUse`), it is empty right now and fills by itself (`nothingYet`), the search or a filter found nothing (`noResults`), or its read failed (`failed`).
+ * @instead A list's rows still loading are its skeleton rows, never an empty state. A failure of one record's own action is that record's row message. A failure that blocks the whole page, or a notice about the account, is a `NoticeBanner`.
+ * @behaviour The frame follows the container: a page or a region stands on a resting card with its own edge, inside a card it takes none, and a collection always passes `card`. A first use's picture comes from the one approved set and arrives once, from faint and soft to sharp, after it loads, with no animation under reduced motion; nothing else moves. Only `firstUse` has a picture or a title; only `failed` has a mark, the warning, with its message as an alert and its actions, Retry among them, as outline buttons.
+ * @words A first use's title names what is missing ("No mailboxes yet") and its line says what will live there and how it fills, in one sentence. A quiet line is one sentence. Clear says what it clears: "Clear search", "Clear filters". A failure is the catalogue's message, never a string of the component's own.
+ * @access A first use's title is a heading, level 2 or, inside a titled section, 3. The picture is decorative. A failure is announced as an alert.
+ */
 export declare function EmptyState(props: EmptyStateProps): import("react").JSX.Element;
 //# sourceMappingURL=empty-state.d.ts.map

package/dist/components/empty-state.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"empty-state.d.ts","sourceRoot":"","sources":["../../src/components/empty-state.tsx"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,KAAK,WAAW,EAAqB,MAAM,gBAAgB,CAAC;AACrE,OAAO,EAAmB,KAAK,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAE1E,MAAM,MAAM,eAAe,GAAG;IAAE,KAAK,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,MAAM,CAAA;CAAE,GAAG,CACnE,CAAC;IACC,IAAI,EAAE,UAAU,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB,GAAG,CACA;IAAE,YAAY,CAAC,EAAE,aAAa,CAAC;IAAC,OAAO,EAAE,QAAQ,CAAA;CAAE,GACnD;IAAE,YAAY,EAAE,OAAO,CAAC;IAAC,OAAO,CAAC,EAAE,KAAK,CAAA;CAAE,CAC7C,CAAC,GACF;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,YAAY,CAAC,EAAE,OAAO,GAAG,aAAa,CAAA;CAAE,GAC/E;IACE,IAAI,EAAE,WAAW,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,WAAW,CAAC;IACnB,YAAY,CAAC,EAAE,OAAO,GAAG,aAAa,CAAC;CACxC,GACD;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,OAAO,EAAE,eAAe,CAAC;IAAC,YAAY,CAAC,EAAE,OAAO,GAAG,aAAa,CAAA;CAAE,CACvF,CAAC;AAEF,wBAAgB,UAAU,CAAC,KAAK,EAAE,eAAe,+BA6ChD"}
+{"version":3,"file":"empty-state.d.ts","sourceRoot":"","sources":["../../src/components/empty-state.tsx"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,KAAK,WAAW,EAAqB,MAAM,gBAAgB,CAAC;AACrE,OAAO,EAAmB,KAAK,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAE1E,MAAM,MAAM,eAAe,GAAG;IAC5B,+GAA+G;IAC/G,KAAK,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,MAAM,CAAC;IACnC,8DAA8D;IAC9D,YAAY,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC;CACtB,GAAG,CACA;IACE,IAAI,EAAE,UAAU,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,QAAQ,CAAC;IAClB,+DAA+D;IAC/D,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,uGAAuG;IACvG,aAAa,CAAC,EAAE,SAAS,GAAG,SAAS,CAAC;CACvC,GACD;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GACvC;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,WAAW,CAAA;CAAE,GAC1D;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,OAAO,EAAE,eAAe,CAAA;CAAE,CAC/C,CAAC;AAEF,sFAAsF;AACtF,MAAM,MAAM,cAAc,CAAC,CAAC,SAAS,eAAe,CAAC,MAAM,CAAC,IAAI,IAAI,CAClE,OAAO,CAAC,eAAe,EAAE;IAAE,IAAI,EAAE,CAAC,CAAA;CAAE,CAAC,EACrC,OAAO,GAAG,cAAc,CACzB,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,eAAe,+BA0DhD"}

package/dist/components/empty-state.js

@@ -4,9 +4,31 @@ import { AlertTriangleIcon } from "lucide-react";
 import { Empty, EmptyContent, EmptyDescription, EmptyHeader, EmptyMedia, EmptyPicture, EmptyTitle, } from "../internal/empty.js";
 import { PageCommandButton } from "./page-actions.js";
 import { bodyBeyondTitle } from "./product-message.js";
+/**
+ * What a place with nothing in it says: a first use shows its section's
+ * picture, a title, one line and the action that fills it; an empty list, a
+ * search that found nothing and a read that failed stay quiet.
+ *
+ * @family Feedback
+ * @when A collection, a section or a page has nothing to show: it never had a record (`firstUse`), it is empty right now and fills by itself (`nothingYet`), the search or a filter found nothing (`noResults`), or its read failed (`failed`).
+ * @instead A list's rows still loading are its skeleton rows, never an empty state. A failure of one record's own action is that record's row message. A failure that blocks the whole page, or a notice about the account, is a `NoticeBanner`.
+ * @behaviour The frame follows the container: a page or a region stands on a resting card with its own edge, inside a card it takes none, and a collection always passes `card`. A first use's picture comes from the one approved set and arrives once, from faint and soft to sharp, after it loads, with no animation under reduced motion; nothing else moves. Only `firstUse` has a picture or a title; only `failed` has a mark, the warning, with its message as an alert and its actions, Retry among them, as outline buttons.
+ * @words A first use's title names what is missing ("No mailboxes yet") and its line says what will live there and how it fills, in one sentence. A quiet line is one sentence. Clear says what it clears: "Clear search", "Clear filters". A failure is the catalogue's message, never a string of the component's own.
+ * @access A first use's title is a heading, level 2 or, inside a titled section, 3. The picture is decorative. A failure is announced as an alert.
+ */
 export function EmptyState(props) {
     const scope = props.scope ?? "region";
-    return (_jsxs(Empty, { "data-empty-state": props.kind, scope: scope, presentation: props.presentation, children: [_jsxs(EmptyHeader, { children: [props.kind === "firstUse" && props.presentation !== "plain" ? (_jsx(EmptyPicture, { size: scope === "page" ? "page" : "card", src: props.picture })) : null, props.kind === "failed" ? (_jsx(EmptyMedia, { variant: "icon", children: _jsx(AlertTriangleIcon, { "aria-hidden": "true" }) })) : null, props.kind === "firstUse" ? (_jsxs("div", { className: "grid gap-1", children: [_jsx(EmptyTitle, { children: _jsx("h2", { children: props.title }) }), _jsx(EmptyDescription, { children: props.description })] })) : props.kind === "failed" ? (_jsx(FailedRead, { message: props.message })) : (_jsx(EmptyDescription, { children: props.message }))] }), props.kind === "firstUse" && props.action ? (_jsx(EmptyContent, { "data-empty-state-action": true, children: _jsx(PageCommandButton, { command: props.action, variant: "default" }) })) : null, props.kind === "noResults" ? (_jsx(EmptyContent, { "data-empty-state-action": true, children: _jsx(PageCommandButton, { command: props.clear, variant: "outline" }) })) : null, props.kind === "failed" && props.message.actions.length > 0 ? (_jsx(EmptyContent, { "data-empty-state-action": true, children: props.message.actions.map((action) => (_jsx(PageCommandButton, { command: action, variant: "outline" }, action.label))) })) : null] }));
+    switch (props.kind) {
+        case "firstUse": {
+            const Heading = props.headingLevel === 3 ? "h3" : "h2";
+            return (_jsxs(Empty, { "data-empty-state": props.kind, scope: scope, children: [_jsxs(EmptyHeader, { children: [_jsx(EmptyPicture, { size: scope === "page" ? "page" : "card", src: props.picture }), _jsxs("div", { className: "grid justify-items-center gap-1", children: [_jsx(EmptyTitle, { children: _jsx(Heading, { children: props.title }) }), _jsx(EmptyDescription, { children: props.description })] })] }), props.action ? (_jsx(EmptyContent, { className: "mt-5", "data-empty-state-action": true, children: _jsx(PageCommandButton, { command: props.action, variant: props.actionVariant ?? "default" }) })) : null] }));
+        }
+        case "nothingYet":
+        case "noResults":
+            return (_jsxs(Empty, { className: "gap-3", "data-empty-state": props.kind, scope: scope, children: [_jsx(EmptyDescription, { className: "max-w-[40ch]", children: props.message }), props.kind === "noResults" ? (_jsx(EmptyContent, { "data-empty-state-action": true, children: _jsx(PageCommandButton, { command: props.clear, variant: "outline" }) })) : null] }));
+        case "failed":
+            return (_jsxs(Empty, { "data-empty-state": props.kind, scope: scope, children: [_jsxs(EmptyHeader, { children: [_jsx(EmptyMedia, { variant: "warning", children: _jsx(AlertTriangleIcon, { "aria-hidden": "true" }) }), _jsx(FailedRead, { message: props.message })] }), props.message.actions.length > 0 ? (_jsx(EmptyContent, { className: "mt-5", "data-empty-state-action": true, children: props.message.actions.map((action) => (_jsx(PageCommandButton, { command: action, variant: "outline" }, action.label))) })) : null] }));
+    }
 }
 function FailedRead({ message }) {
     const body = bodyBeyondTitle(message);

package/dist/components/entry-scene.d.ts

@@ -1,19 +1,4 @@
 import type { ComponentProps, ReactNode } from "react";
-/**
- * Nadia's entry screen, contained.
- *
- * The installer and the desktop paint the same screen: the approved picture of
- * the surface behind, the nadicode wordmark still at the upper left, Nadia's
- * ribbon and her words centred as one group. In the products it fills the
- * window; here it is a box of the window's own shape, so the screen can stand
- * on a page beside other things.
- *
- * Nothing here holds state or decides anything. Which view is open, what the
- * words are and when the screen ends belong to whoever mounts it.
- *
- * The screen is black in every theme, so it scopes `dark` and reads the dark
- * ladder directly rather than branching on the host's mode.
- */
 export type EntryStageMark = "done" | "current" | "pending";
 export type EntrySceneProps = {
     /**
@@ -43,6 +28,18 @@ export type EntrySceneProps = {
     /** The message, the actions, the progress line and the stage list. */
     children?: ReactNode;
 };
+/**
+ * Nadia's entry screen, contained: the approved picture of the surface behind,
+ * the wordmark at the upper left, Nadia's ribbon and her words centred as one
+ * group. The screen is black in every theme.
+ *
+ * @family Compositions
+ * @when Nadia's installer and the desktop's sign-in, start, update and failure screens, which paint the same screen; a page that shows that screen beside other things.
+ * @instead The Portal's entry pages are its funnel frame with the shared entry header; Alveare Server's entry is the HiveScene; a wait inside the product is a WaitingLine.
+ * @behaviour It holds no state and decides nothing: which view is open, the words and when the screen ends belong to whoever mounts it. It fills a box of the window's own shape (`aspectRatio`), so the picture's figure stands on the window's floor (`pictureFeet`). A failure quiets the picture and never removes it. Its children stand in order: the message, the actions, the progress line, the stage list.
+ * @words The heading names the surface and is never seen. Instructions and status are one plain sentence that changes only when the real stage changes ("Loading your tools").
+ * @access One level-1 heading for the screen, read but not shown; a message that reports work in progress is a status.
+ */
 export declare function EntryScene({ aspectRatio, minHeight, picture, pictureFeet, wordmark, title, presence, view, className, children, }: EntrySceneProps): import("react").JSX.Element;
 /**
  * What the screen is doing, said plainly. `lines` reserves the room a longer
@@ -70,15 +67,31 @@ export declare function EntryAction({ variant, pressed, className, children, ...
     pressed?: boolean;
 }): import("react").JSX.Element;
 /**
- * Measured work: a 2 px line with the count written under it. It is
- * decorative, because Nadia's own hidden progress bar already carries the
- * value and her ribbon above already says the work is hers.
+ * Measured work on an entry screen: a 2 px line with the product's written
+ * count under it.
+ *
+ * @family Feedback
+ * @when Work on an entry screen whose progress is measured: downloading an update, the stages of starting Nadia.
+ * @instead Work whose length is unknown is a WaitingLine; the named stages themselves are the EntryStageList; measured work inside the product is a Progress with its count.
+ * @behaviour The line keeps the measured fraction, clamped between empty and full; the count under it is the product's own words. It never prints a percentage.
+ * @words The count says what is measured, in tabular figures: "Step 2 of 3", "12 of 40 MB". Never an invented percentage.
+ * @access The count is a status, so assistive technology hears it change; the line is hidden.
  */
-export declare function EntryProgress({ fraction, className }: {
+export declare function EntryProgress({ fraction, count, className, }: {
     fraction: number;
+    count: string;
     className?: string;
 }): import("react").JSX.Element;
-/** The stages of a long install, each done, current or still to come. */
+/**
+ * The stages a system runs on an entry screen, each done, current or still to come.
+ *
+ * @family Feedback
+ * @when The real stages of a long setup on an entry screen: installing Nadia, Alveare Server's "Get this computer ready".
+ * @instead Steps the person does are NumberedSteps; the steps of an Agent's run are a RunTimeline.
+ * @behaviour One mark per stage: done, current, still to come. Followed by the EntryProgress count. Nothing moves but the stage that changes.
+ * @words Each stage is what the system does, in the imperative: "Start the chat service".
+ * @access An ordered list; the current stage carries `aria-current="step"`; the marks are hidden.
+ */
 export declare function EntryStageList({ stages, className, }: {
     stages: ReadonlyArray<{
         id: string;

package/dist/components/entry-scene.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"entry-scene.d.ts","sourceRoot":"","sources":["../../src/components/entry-scene.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAiB,SAAS,EAAE,MAAM,OAAO,CAAC;AAItE;;;;;;;;;;;;;;GAcG;AAEH,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,SAAS,GAAG,SAAS,CAAC;AAE5D,MAAM,MAAM,eAAe,GAAG;IAC5B;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,0EAA0E;IAC1E,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,yEAAyE;IACzE,OAAO,CAAC,EAAE,SAAS,CAAC;IACpB;;;;OAIG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,sDAAsD;IACtD,QAAQ,CAAC,EAAE,SAAS,CAAC;IACrB,yEAAyE;IACzE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,+CAA+C;IAC/C,QAAQ,CAAC,EAAE,SAAS,CAAC;IACrB,6EAA6E;IAC7E,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,sEAAsE;IACtE,QAAQ,CAAC,EAAE,SAAS,CAAC;CACtB,CAAC;AAEF,wBAAgB,UAAU,CAAC,EACzB,WAA0B,EAC1B,SAAS,EACT,OAAO,EACP,WAAiB,EACjB,QAAQ,EACR,KAAK,EACL,QAAQ,EACR,IAAI,EACJ,SAAS,EACT,QAAQ,GACT,EAAE,eAAe,+BAuBjB;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,EAC3B,KAAK,EACL,IAAY,EACZ,SAAS,EACT,QAAQ,GACT,EAAE;IACD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,oDAAoD;IACpD,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,SAAS,CAAC;CACrB,+BAWA;AAED,wBAAgB,YAAY,CAAC,EAAE,SAAS,EAAE,QAAQ,EAAE,EAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,SAAS,CAAA;CAAE,+BAEhG;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,EAC1B,OAAmB,EACnB,OAAO,EACP,SAAS,EACT,QAAQ,EACR,GAAG,KAAK,EACT,EAAE,cAAc,CAAC,QAAQ,CAAC,GAAG;IAC5B,OAAO,CAAC,EAAE,SAAS,GAAG,WAAW,CAAC;IAClC,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB,+BAYA;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,EAAE,QAAQ,EAAE,SAAS,EAAE,EAAE;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,+BAW9F;AAED,yEAAyE;AACzE,wBAAgB,cAAc,CAAC,EAC7B,MAAM,EACN,SAAS,GACV,EAAE;IACD,MAAM,EAAE,aAAa,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,cAAc,CAAA;KAAE,CAAC,CAAC;IAC3E,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,+BAeA"}
+{"version":3,"file":"entry-scene.d.ts","sourceRoot":"","sources":["../../src/components/entry-scene.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAiB,SAAS,EAAE,MAAM,OAAO,CAAC;AAItE,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,SAAS,GAAG,SAAS,CAAC;AAE5D,MAAM,MAAM,eAAe,GAAG;IAC5B;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,0EAA0E;IAC1E,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,yEAAyE;IACzE,OAAO,CAAC,EAAE,SAAS,CAAC;IACpB;;;;OAIG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,sDAAsD;IACtD,QAAQ,CAAC,EAAE,SAAS,CAAC;IACrB,yEAAyE;IACzE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,+CAA+C;IAC/C,QAAQ,CAAC,EAAE,SAAS,CAAC;IACrB,6EAA6E;IAC7E,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,sEAAsE;IACtE,QAAQ,CAAC,EAAE,SAAS,CAAC;CACtB,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,wBAAgB,UAAU,CAAC,EACzB,WAA0B,EAC1B,SAAS,EACT,OAAO,EACP,WAAiB,EACjB,QAAQ,EACR,KAAK,EACL,QAAQ,EACR,IAAI,EACJ,SAAS,EACT,QAAQ,GACT,EAAE,eAAe,+BAuBjB;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,EAC3B,KAAK,EACL,IAAY,EACZ,SAAS,EACT,QAAQ,GACT,EAAE;IACD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,oDAAoD;IACpD,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,SAAS,CAAC;CACrB,+BAWA;AAED,wBAAgB,YAAY,CAAC,EAAE,SAAS,EAAE,QAAQ,EAAE,EAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,SAAS,CAAA;CAAE,+BAEhG;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,EAC1B,OAAmB,EACnB,OAAO,EACP,SAAS,EACT,QAAQ,EACR,GAAG,KAAK,EACT,EAAE,cAAc,CAAC,QAAQ,CAAC,GAAG;IAC5B,OAAO,CAAC,EAAE,SAAS,GAAG,WAAW,CAAC;IAClC,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB,+BAYA;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,aAAa,CAAC,EAC5B,QAAQ,EACR,KAAK,EACL,SAAS,GACV,EAAE;IACD,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,+BAaA;AAED;;;;;;;;;GASG;AACH,wBAAgB,cAAc,CAAC,EAC7B,MAAM,EACN,SAAS,GACV,EAAE;IACD,MAAM,EAAE,aAAa,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,cAAc,CAAA;KAAE,CAAC,CAAC;IAC3E,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,+BAeA"}