@nadicodeai/ui 12.1.95 → 12.1.97

package/dist/components/collection-page.js

@@ -1,149 +1,34 @@
 "use client";
 import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
-import { ChevronRight } from "lucide-react";
-import { createContext, useContext } from "react";
-import { ActionMenu } from "./action-menu.js";
-import { Button } from "./button.js";
+import { CollectionFilters } from "./collection-filters.js";
 import { CollectionSearch } from "./collection-search.js";
 import { CollectionSort } from "./collection-sort.js";
 import { CollectionToolbar } from "./collection-toolbar.js";
-import { DataTable, } from "./data-table.js";
-import { DropdownMenuCommand, DropdownMenuSeparator } from "./dropdown-menu.js";
-import { EmptyState } from "./empty-state.js";
-import { PageActions } from "./page-actions.js";
+import { PageActions, PageActionsHostProvider, } from "./page-actions.js";
 import { PageHeader } from "./page-header.js";
-import { RecordIdentity } from "./record-identity.js";
-import { RecordTime, recordDate } from "./record-time.js";
-import { TableValue } from "./table-value.js";
-import { Skeleton } from "./skeleton.js";
-import { StatusBadge } from "./status-badge.js";
-import { TableCard } from "./table-card.js";
-import { RowMessageActions, RowMessageLine } from "../internal/row-message.js";
-const ShownCollection = createContext(undefined);
-function useShownCollection() {
-    return useContext(ShownCollection);
-}
-/*
- * Each cell is one component for the page's whole life: TanStack renders a
- * column's `cell` as a component, so a function made anew on each render would
- * remount every row's cells on every render, closing a row's open menu when
- * the records are read again. The cells read the page's current props instead.
- */
-function NameCell({ row }) {
-    const props = useShownCollection();
-    const shown = props.name(row.original);
-    const state = props.state?.(row.original);
-    return (_jsx(RecordIdentity, { detail: state ? _jsx(RowMessageLine, { state: state }) : shown.detail, mark: shown.mark, name: shown.name, wraps: props.wraps }));
-}
-function FactCell({ column, row }) {
-    const fact = useShownCollection().facts?.find((each) => each.id === column.id);
-    return _jsx(_Fragment, { children: fact?.of(row.original) });
-}
-function StatusCell({ row }) {
-    const shown = useShownCollection().status?.of(row.original);
-    return shown ? _jsx(StatusBadge, { label: shown.label, tone: shown.tone }) : null;
-}
-function TimeCell({ row }) {
-    const time = useShownCollection().time;
-    if (!time)
-        return null;
-    const at = recordDate(time.of(row.original));
-    return (_jsx(TableValue, { missingLabel: time.missing, value: at ? _jsx(RecordTime, { at: at, locale: time.locale, phrase: time.phrase }) : null }));
-}
-function CommandsCell({ row }) {
-    const props = useShownCollection();
-    const state = props.state?.(row.original);
-    const commands = props.commands?.(row.original) ?? [];
-    const way = commands.length > 0 ? (_jsx(Commands, { commands: commands, label: props.commandsLabel?.(row.original) ?? props.label, menu: props.start !== undefined })) : props.open?.href(row.original) && !state ? (_jsx(ChevronRight, { "aria-hidden": "true", className: "size-4 text-muted-foreground" })) : null;
-    if (!props.start && !state)
-        return way;
-    return (_jsxs("div", { className: "flex items-center justify-end gap-2", children: [props.start?.(row.original), state ? _jsx(RowMessageActions, { state: state }) : null, way] }));
-}
-function LoadingRecords({ label }) {
-    return (_jsx("div", { "aria-busy": "true", "aria-label": label, className: "divide-y divide-border", role: "status", children: Array.from({ length: 3 }, (_, index) => (_jsxs("div", { className: "flex h-16 items-center gap-3 px-4", children: [_jsxs("div", { className: "grid gap-1.5", children: [_jsx(Skeleton, { className: "h-4 w-40 max-w-full" }), _jsx(Skeleton, { className: "h-3 w-56 max-w-full" })] }), _jsx(Skeleton, { className: "ml-auto h-4 w-28" })] }, index))) }));
-}
-function Commands({ commands, label, menu, }) {
-    const [only] = commands;
-    if (!only)
-        return null;
-    if (commands.length === 1 && !only.destructive && !menu) {
-        return (_jsx(Button, { "aria-label": only.accessibleName, disabled: only.disabled, onClick: only.onSelect, type: "button", variant: "outline", children: only.label }));
-    }
-    const kept = commands.filter((command) => !command.destructive);
-    const destructive = commands.filter((command) => command.destructive);
-    return (_jsxs(ActionMenu, { label: label, children: [kept.map((command) => (_jsx(DropdownMenuCommand, { "aria-label": command.accessibleName, disabled: command.disabled, icon: command.icon, onClick: command.onSelect, reason: command.reason, children: command.label }, command.label))), kept.length > 0 && destructive.length > 0 ? _jsx(DropdownMenuSeparator, {}) : null, destructive.map((command) => (_jsx(DropdownMenuCommand, { "aria-label": command.accessibleName, disabled: command.disabled, icon: command.icon, onClick: command.onSelect, reason: command.reason, variant: "destructive", children: command.label }, command.label)))] }));
-}
+import { RecordList } from "./record-list.js";
+import { WaitingLine } from "./waiting-line.js";
 /**
- * The Collection composition (DESIGN.md "Page compositions", "Tables and
- * missing values"), whole: the title with the page's actions, the toolbar's
- * search and sort, then one row per record that reads without a header row:
- * its name over what it is, a status only when it is the exception, when it
- * happened in its verb's sentence, and its commands. A failed or refused action
- * and an edit stay inside their own row.
+ * A page whose job is a list of records: its title with the page's actions on
+ * one row, its sibling collections, one toolbar, then one line per record.
+ *
+ * @family Compositions
+ * @when A list of records a person finds one of and acts on: Customers, Agents, Skills, Apps, MCP servers, Mailboxes.
+ * @instead Figures compared across records are a DataTable with headings; a list inside another page's section is a RecordList with its heading.
+ * @behaviour Nothing sits under the title. The title row holds at most one secondary, the primary, then the three dots, which open only for two commands or more. A primary that is also the first use's action waits until there are records; while a different primary stays, the first use's action is an outline button. One toolbar holds the search, which grows, then the filters, then the sort; it shows while there are records or a search or filter is set, and is glass only where the rows scroll under it. While a new search, filter or sort is read, the toolbar is busy and, after a second, shows the one waiting line, while the last rows stay. The rows, their states and their loading are the RecordList's; no match is offered only while a search or filter is set.
+ * @words Every string is the product's. The title names the collection in the plural ("Agents"); the search says what it finds ("Find a skill"); no match says what found nothing and offers to clear it ("Clear search", "Clear filters").
+ * @access The title is the page's h1 when the composition draws it. The toolbar is named by `label` and busy while `pending`; the rows are the RecordList's table, named by `label`.
  */
 export function CollectionPage(props) {
-    const { label, title, actions, search, sort, records } = props;
-    const hasRecords = records !== undefined && records.length > 0;
-    const searching = Boolean(search?.value);
-    const addsFirst = props.empty?.kind === "firstUse" && props.empty.action === actions?.primary;
-    const shownActions = addsFirst && !hasRecords && !searching ? { ...actions, primary: undefined } : actions;
-    const columns = [
-        { id: "name", header: label, meta: props.wraps ? { wraps: true } : undefined, cell: NameCell },
-    ];
-    for (const fact of props.facts ?? []) {
-        columns.push({
-            id: fact.id,
-            header: fact.label,
-            meta: fact.prose ? { prose: true } : { narrow: true },
-            cell: FactCell,
-        });
-    }
-    if (props.status) {
-        columns.push({
-            id: "status",
-            header: props.status.label,
-            meta: { narrow: true },
-            cell: StatusCell,
-        });
-    }
-    if (props.time) {
-        columns.push({ id: "time", header: props.time.label, meta: { narrow: true }, cell: TimeCell });
-    }
-    if (props.commands || props.open || props.state || props.start) {
-        columns.push({
-            id: "commands",
-            header: props.commandsHeader ?? label,
-            meta: { narrow: true },
-            cell: CommandsCell,
-        });
-    }
-    const primaryColumns = columns.map((column) => String(column.id));
-    let body;
-    if (props.failed) {
-        body = _jsx(EmptyState, { ...props.failed });
-    }
-    else if (records === undefined) {
-        body = _jsx(LoadingRecords, { label: props.loadingLabel ?? label });
-    }
-    else if (!hasRecords && searching && props.noMatch) {
-        body = _jsx(EmptyState, { kind: "noResults", ...props.noMatch });
-    }
-    else if (!hasRecords) {
-        body = props.empty ? _jsx(EmptyState, { ...props.empty }) : null;
-    }
-    else {
-        const table = {
-            columns,
-            data: [...records],
-            embedded: true,
-            empty: { kind: "nothingYet", message: label },
-            getRowId: props.getId,
-            primaryColumns,
-            showColumnHeaders: false,
-            rowEditor: props.editor ? { rowId: props.editor.id, render: props.editor.render } : undefined,
-            tableLabel: label,
-        };
-        body = props.open ? (_jsx(DataTable, { ...table, primaryColumnId: "name", renderRowLink: props.open.renderLink, rowHref: props.open.href, rowLabel: props.open.label })) : (_jsx(DataTable, { ...table }));
-    }
-    return (_jsxs("div", { className: "grid min-w-0 gap-4", "data-slot": "collection-page", children: [title ? _jsx(PageHeader, { title: title }) : null, shownActions ? _jsx(PageActions, { ...shownActions }) : null, search && (hasRecords || searching) ? (_jsx(CollectionToolbar, { actions: sort ? _jsx(CollectionSort, { ...sort }) : undefined, label: label, search: _jsx(CollectionSearch, { ...search }), surface: "plain" })) : null, _jsx(TableCard, { children: _jsx(ShownCollection.Provider, { value: props, children: body }) })] }));
+    const { title, actions, tabs, search, filters, sort, toolbarSurface, noMatch, pending, ...list } = props;
+    const hasRecords = list.records !== undefined && list.records.length > 0;
+    const narrowed = Boolean(search?.value) || (filters?.facets.some((facet) => facet.value) ?? false);
+    const { primary, ...withoutPrimary } = actions ?? {};
+    const addsFirst = primary !== undefined && list.empty?.kind === "firstUse" && list.empty.action === primary;
+    const shownActions = addsFirst && !hasRecords && !narrowed ? withoutPrimary : actions;
+    const empty = list.empty?.kind === "firstUse" && list.empty.action && primary !== undefined && !addsFirst
+        ? { ...list.empty, actionVariant: "outline" }
+        : list.empty;
+    const page = (_jsxs("div", { className: "grid min-w-0 gap-4", "data-slot": "collection-page", children: [title ? _jsx(PageHeader, { title: title }) : null, shownActions ? _jsx(PageActions, { ...shownActions }) : null, tabs, (search || filters || sort) && (hasRecords || narrowed) ? (_jsx(CollectionToolbar, { actions: filters || sort ? (_jsxs(_Fragment, { children: [filters ? _jsx(CollectionFilters, { ...filters }) : null, sort ? _jsx(CollectionSort, { ...sort }) : null] })) : undefined, "aria-busy": pending || undefined, label: list.label, search: search ? _jsx(CollectionSearch, { ...search }) : undefined, status: pending ? _jsx(WaitingLine, { className: "w-24", decorative: true }) : null, surface: toolbarSurface ?? "plain" })) : null, _jsx(RecordList, { ...list, empty: empty, noMatch: narrowed ? noMatch : undefined })] }));
+    return title ? _jsx(PageActionsHostProvider, { children: page }) : page;
 }

package/dist/components/collection-search.d.ts

@@ -6,5 +6,19 @@ export type CollectionSearchProps = {
     disabled?: boolean;
 };
 /** The search a collection toolbar fills its row with. */
+/**
+ * The search a collection toolbar fills its row with.
+ *
+ * @family Inputs
+ * @when Finding a record inside one collection, at the start of its toolbar.
+ * @instead Finding anything across the product is `CommandDialog`. Narrowing by a facet is
+ * `CollectionFilters`. A free value in a form is `Input`.
+ * @behaviour Results stay on screen while a search updates. Escape clears only while the box holds
+ * the interaction and has a value; otherwise it closes the overlay as usual.
+ * @words The search's label is what it finds, also shown as its placeholder: *Find a skill*,
+ * *Search the hub*.
+ * @access The input carries `aria-label` from `label` and `type="search"`; the search mark is
+ * decorative.
+ */
 export declare function CollectionSearch({ label, value, onValueChange, disabled }: CollectionSearchProps): import("react").JSX.Element;
 //# sourceMappingURL=collection-search.d.ts.map

package/dist/components/collection-search.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"collection-search.d.ts","sourceRoot":"","sources":["../../src/components/collection-search.tsx"],"names":[],"mappings":"AAMA,MAAM,MAAM,qBAAqB,GAAG;IAClC,2FAA2F;IAC3F,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,aAAa,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACvC,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB,CAAC;AAEF,0DAA0D;AAC1D,wBAAgB,gBAAgB,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,aAAa,EAAE,QAAQ,EAAE,EAAE,qBAAqB,+BAgBhG"}
+{"version":3,"file":"collection-search.d.ts","sourceRoot":"","sources":["../../src/components/collection-search.tsx"],"names":[],"mappings":"AAMA,MAAM,MAAM,qBAAqB,GAAG;IAClC,2FAA2F;IAC3F,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,aAAa,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACvC,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB,CAAC;AAEF,0DAA0D;AAC1D;;;;;;;;;;;;;GAaG;AACH,wBAAgB,gBAAgB,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,aAAa,EAAE,QAAQ,EAAE,EAAE,qBAAqB,+BAgBhG"}

package/dist/components/collection-search.js

@@ -3,6 +3,20 @@ import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { Search } from "lucide-react";
 import { InputGroup, InputGroupAddon, InputGroupInput } from "./input-group.js";
 /** The search a collection toolbar fills its row with. */
+/**
+ * The search a collection toolbar fills its row with.
+ *
+ * @family Inputs
+ * @when Finding a record inside one collection, at the start of its toolbar.
+ * @instead Finding anything across the product is `CommandDialog`. Narrowing by a facet is
+ * `CollectionFilters`. A free value in a form is `Input`.
+ * @behaviour Results stay on screen while a search updates. Escape clears only while the box holds
+ * the interaction and has a value; otherwise it closes the overlay as usual.
+ * @words The search's label is what it finds, also shown as its placeholder: *Find a skill*,
+ * *Search the hub*.
+ * @access The input carries `aria-label` from `label` and `type="search"`; the search mark is
+ * decorative.
+ */
 export function CollectionSearch({ label, value, onValueChange, disabled }) {
     return (_jsxs(InputGroup, { children: [_jsx(InputGroupAddon, { children: _jsx(Search, { "aria-hidden": "true" }) }), _jsx(InputGroupInput, { "aria-label": label, disabled: disabled, onChange: (event) => onValueChange(event.target.value), placeholder: label, type: "search", value: value })] }));
 }

package/dist/components/collection-sort.d.ts

@@ -10,9 +10,19 @@ export type CollectionSortProps = {
     onValueChange: (value: string) => void;
 };
 /**
- * The order a collection's rows are read in, at the toolbar's trailing edge
- * before the collection's actions. The trigger names the order in force; the
- * menu offers the others.
+ * The order a collection's rows are read in, at the toolbar's trailing edge.
+ *
+ * @family Choices
+ * @when A collection whose rows can be read in more than one order: newest, name, cost.
+ * @instead Sorting by a column of a comparison table is `DataTable`'s own header. Narrowing rows is
+ * `CollectionFilters`.
+ * @behaviour An outline button names the order in force; its menu offers the others as radio rows
+ * with the current one checked. Choosing the current order changes nothing. It renders nothing
+ * without options.
+ * @words The label says what the control does (*Sort by*); each option names an order: *Newest
+ * first*, *Name*.
+ * @access The trigger reads the label and the current order: *Sort by: Newest first*. The options
+ * are menu radio items.
  */
 export declare function CollectionSort({ label, value, options, onValueChange }: CollectionSortProps): import("react").JSX.Element | null;
 //# sourceMappingURL=collection-sort.d.ts.map

package/dist/components/collection-sort.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"collection-sort.d.ts","sourceRoot":"","sources":["../../src/components/collection-sort.tsx"],"names":[],"mappings":"AAeA,MAAM,MAAM,oBAAoB,GAAG;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG;IAChC,yEAAyE;IACzE,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,SAAS,oBAAoB,EAAE,CAAC;IACzC,aAAa,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;CACxC,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,aAAa,EAAE,EAAE,mBAAmB,sCAgC3F"}
+{"version":3,"file":"collection-sort.d.ts","sourceRoot":"","sources":["../../src/components/collection-sort.tsx"],"names":[],"mappings":"AAeA,MAAM,MAAM,oBAAoB,GAAG;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG;IAChC,yEAAyE;IACzE,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,SAAS,oBAAoB,EAAE,CAAC;IACzC,aAAa,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;CACxC,CAAC;AAEF;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,cAAc,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,aAAa,EAAE,EAAE,mBAAmB,sCAkC3F"}

package/dist/components/collection-sort.js

@@ -4,15 +4,28 @@ import { ArrowUpDown } from "lucide-react";
 import { Button } from "./button.js";
 import { DropdownMenu, DropdownMenuContent, DropdownMenuGroup, DropdownMenuLabel, DropdownMenuRadioGroup, DropdownMenuRadioItem, DropdownMenuTrigger, } from "./dropdown-menu.js";
 /**
- * The order a collection's rows are read in, at the toolbar's trailing edge
- * before the collection's actions. The trigger names the order in force; the
- * menu offers the others.
+ * The order a collection's rows are read in, at the toolbar's trailing edge.
+ *
+ * @family Choices
+ * @when A collection whose rows can be read in more than one order: newest, name, cost.
+ * @instead Sorting by a column of a comparison table is `DataTable`'s own header. Narrowing rows is
+ * `CollectionFilters`.
+ * @behaviour An outline button names the order in force; its menu offers the others as radio rows
+ * with the current one checked. Choosing the current order changes nothing. It renders nothing
+ * without options.
+ * @words The label says what the control does (*Sort by*); each option names an order: *Newest
+ * first*, *Name*.
+ * @access The trigger reads the label and the current order: *Sort by: Newest first*. The options
+ * are menu radio items.
  */
 export function CollectionSort({ label, value, options, onValueChange }) {
     const current = options.find((option) => option.value === value) ?? options[0];
     if (!current)
         return null;
-    return (_jsxs(DropdownMenu, { children: [_jsxs(DropdownMenuTrigger, { "aria-label": `${label}: ${current.label}`, "data-slot": "collection-sort", render: _jsx(Button, { variant: "outline" }), children: [_jsx(ArrowUpDown, { "data-icon": "inline-start", "aria-hidden": "true" }), current.label] }), _jsx(DropdownMenuContent, { align: "end", children: _jsxs(DropdownMenuGroup, { children: [_jsx(DropdownMenuLabel, { children: label }), _jsx(DropdownMenuRadioGroup, { value: current.value, onValueChange: (next) => {
+    return (_jsxs(DropdownMenu, { children: [_jsxs(DropdownMenuTrigger, { "aria-label": `${label}: ${current.label}`, "data-slot": "collection-sort", render: _jsx(Button, { variant: "outline" }), children: [_jsx(ArrowUpDown, { "data-icon": "inline-start", "aria-hidden": "true" }), current.label] }), _jsx(DropdownMenuContent, { align: "end", children: _jsxs(DropdownMenuGroup, { children: [_jsx(DropdownMenuLabel, { children: label }), _jsx(DropdownMenuRadioGroup, { value: current.value, 
+                            // oxlint-disable-next-line anti-slop/no-unknown-parameters -- Base UI types a radio group's value any; the guard below reads it
+                            onValueChange: (next) => {
+                                // oxlint-disable-next-line anti-slop/no-runtime-typeof -- Base UI's radio group types the chosen value as unknown; this is where it is read.
                                 if (typeof next === "string" && next !== current.value)
                                     onValueChange(next);
                             }, children: options.map((option) => (_jsx(DropdownMenuRadioItem, { value: option.value, children: option.label }, option.value))) })] }) })] }));

package/dist/components/collection-toolbar.d.ts

@@ -12,5 +12,18 @@ export type CollectionToolbarProps = Omit<ComponentPropsWithoutRef<"div">, "chil
      */
     surface?: "glass" | "plain";
 };
+/**
+ * A collection's control bar: its filters, its search and its sort, over its own rows.
+ *
+ * @family Compositions
+ * @when The row above a collection's rows that holds its search, filters, sort and status.
+ * @instead A page action never sits here: it is `PageActions` on the title's row. Finding across
+ * the product is `CommandDialog`.
+ * @behaviour Glass on the floating height, held at the top of the scrolling content while the rows
+ * pass under it; inside a titled `TableCard`, or with `surface="plain"`, the plain row. A search
+ * alone is always the plain row.
+ * @words The label names the collection's tools: *Customer filters*.
+ * @access `role="toolbar"` named by `label`.
+ */
 export declare function CollectionToolbar({ label, controls, search, actions, status, surface, ...props }: CollectionToolbarProps): import("react").JSX.Element;
 //# sourceMappingURL=collection-toolbar.d.ts.map

package/dist/components/collection-toolbar.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"collection-toolbar.d.ts","sourceRoot":"","sources":["../../src/components/collection-toolbar.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,wBAAwB,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAEjE,MAAM,MAAM,sBAAsB,GAAG,IAAI,CACvC,wBAAwB,CAAC,KAAK,CAAC,EAC/B,UAAU,GAAG,WAAW,CACzB,GAAG;IACF,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,SAAS,CAAC;IACrB,MAAM,CAAC,EAAE,SAAS,CAAC;IACnB,OAAO,CAAC,EAAE,SAAS,CAAC;IACpB,MAAM,CAAC,EAAE,SAAS,CAAC;IACnB;;;;OAIG;IACH,OAAO,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC;CAC7B,CAAC;AAeF,wBAAgB,iBAAiB,CAAC,EAChC,KAAK,EACL,QAAQ,EACR,MAAM,EACN,OAAO,EACP,MAAM,EACN,OAAiB,EACjB,GAAG,KAAK,EACT,EAAE,sBAAsB,+BAwCxB"}
+{"version":3,"file":"collection-toolbar.d.ts","sourceRoot":"","sources":["../../src/components/collection-toolbar.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,wBAAwB,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAEjE,MAAM,MAAM,sBAAsB,GAAG,IAAI,CACvC,wBAAwB,CAAC,KAAK,CAAC,EAC/B,UAAU,GAAG,WAAW,CACzB,GAAG;IACF,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,SAAS,CAAC;IACrB,MAAM,CAAC,EAAE,SAAS,CAAC;IACnB,OAAO,CAAC,EAAE,SAAS,CAAC;IACpB,MAAM,CAAC,EAAE,SAAS,CAAC;IACnB;;;;OAIG;IACH,OAAO,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC;CAC7B,CAAC;AAeF;;;;;;;;;;;;GAYG;AACH,wBAAgB,iBAAiB,CAAC,EAChC,KAAK,EACL,QAAQ,EACR,MAAM,EACN,OAAO,EACP,MAAM,EACN,OAAiB,EACjB,GAAG,KAAK,EACT,EAAE,sBAAsB,+BAwCxB"}

package/dist/components/collection-toolbar.js

@@ -10,6 +10,19 @@ import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 const ON_PAGE = "sticky top-3 z-20 mb-3 rounded-lg p-2 nc-glass nc-elevation-floating";
 const PLAIN = "relative mb-3";
 const IN_CARD = "[[data-slot=table-card-toolbar]_&]:relative [[data-slot=table-card-toolbar]_&]:z-auto [[data-slot=table-card-toolbar]_&]:mb-0 [[data-slot=table-card-toolbar]_&]:rounded-none [[data-slot=table-card-toolbar]_&]:p-0 [[data-slot=table-card-toolbar]_&]:pb-4 [[data-slot=table-card-toolbar]_&]:[background:none] [[data-slot=table-card-toolbar]_&]:[backdrop-filter:none] [[data-slot=table-card-toolbar]_&]:[box-shadow:none]";
+/**
+ * A collection's control bar: its filters, its search and its sort, over its own rows.
+ *
+ * @family Compositions
+ * @when The row above a collection's rows that holds its search, filters, sort and status.
+ * @instead A page action never sits here: it is `PageActions` on the title's row. Finding across
+ * the product is `CommandDialog`.
+ * @behaviour Glass on the floating height, held at the top of the scrolling content while the rows
+ * pass under it; inside a titled `TableCard`, or with `surface="plain"`, the plain row. A search
+ * alone is always the plain row.
+ * @words The label names the collection's tools: *Customer filters*.
+ * @access `role="toolbar"` named by `label`.
+ */
 export function CollectionToolbar({ label, controls, search, actions, status, surface = "glass", ...props }) {
     // A search alone is the plain row: a search box never stands in a box of its
     // own (DESIGN.md "Menus and commands").

package/dist/components/combobox.d.ts

@@ -1,5 +1,22 @@
 import * as React from "react";
 import { Combobox as ComboboxPrimitive } from "@base-ui/react/combobox";
+/**
+ * Type to find one value, or several, in a known set.
+ *
+ * @family Choices
+ * @when Typing to find in a known set: assign an Agent, choose a time zone, add several Agents at
+ * once with `multiple`.
+ * @instead A short fixed list is a `Select`. Free text is an `Input`. Narrowing a collection is
+ * `CollectionFilters`.
+ * @behaviour Typing filters the list. Loading and no match are different states; the chosen value
+ * stays while results load. Enter picks the highlighted row and never submits the form around it.
+ * Clear empties the box and keeps focus there. With `multiple`, each choice is a chip with its own
+ * remove; Backspace in an empty box removes the last.
+ * @words The hint is scoped: *Find an Agent*. No match quotes the query: *No Agent matches “Xy”.* A
+ * chip reads as the record's name.
+ * @access A visible label; combobox and listbox roles; each chip's remove is named: *Remove Acme
+ * Quotes*. An Agent's orb in a row is a decorative mark beside her name.
+ */
 declare const Combobox: typeof ComboboxPrimitive.Root;
 declare function ComboboxValue({ ...props }: ComboboxPrimitive.Value.Props): React.JSX.Element;
 declare function ComboboxTrigger({ className, children, ...props }: ComboboxPrimitive.Trigger.Props): React.JSX.Element;

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

@@ -1 +1 @@
-{"version":3,"file":"combobox.d.ts","sourceRoot":"","sources":["../../src/components/combobox.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,EAAE,QAAQ,IAAI,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAaxE,QAAA,MAAM,QAAQ,+BAAyB,CAAC;AAExC,iBAAS,aAAa,CAAC,EAAE,GAAG,KAAK,EAAE,EAAE,iBAAiB,CAAC,KAAK,CAAC,KAAK,qBAEjE;AAED,iBAAS,eAAe,CAAC,EAAE,SAAS,EAAE,QAAQ,EAAE,GAAG,KAAK,EAAE,EAAE,iBAAiB,CAAC,OAAO,CAAC,KAAK,qBAW1F;AAeD,iBAAS,aAAa,CAAC,EACrB,SAAS,EACT,QAAQ,EACR,QAAgB,EAChB,WAAkB,EAClB,SAAiB,EACjB,GAAG,KAAK,EACT,EAAE,iBAAiB,CAAC,KAAK,CAAC,KAAK,GAAG;IACjC,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB,qBAoBA;AAED,iBAAS,eAAe,CAAC,EACvB,SAAS,EACT,IAAe,EACf,UAAc,EACd,KAAe,EACf,WAAe,EACf,MAAM,EACN,GAAG,KAAK,EACT,EAAE,iBAAiB,CAAC,KAAK,CAAC,KAAK,GAC9B,IAAI,CACF,iBAAiB,CAAC,UAAU,CAAC,KAAK,EAClC,MAAM,GAAG,OAAO,GAAG,YAAY,GAAG,aAAa,GAAG,QAAQ,CAC3D,qBAwBF;AAED,iBAAS,YAAY,CAAC,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,iBAAiB,CAAC,IAAI,CAAC,KAAK,qBAW1E;AAED,iBAAS,YAAY,CAAC,EAAE,SAAS,EAAE,QAAQ,EAAE,GAAG,KAAK,EAAE,EAAE,iBAAiB,CAAC,IAAI,CAAC,KAAK,qBAoBpF;AAED,iBAAS,aAAa,CAAC,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,iBAAiB,CAAC,KAAK,CAAC,KAAK,qBAI5E;AAED,iBAAS,aAAa,CAAC,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,iBAAiB,CAAC,UAAU,CAAC,KAAK,qBAQjF;AAED,iBAAS,kBAAkB,CAAC,EAAE,GAAG,KAAK,EAAE,EAAE,iBAAiB,CAAC,UAAU,CAAC,KAAK,qBAE3E;AAED,iBAAS,aAAa,CAAC,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,iBAAiB,CAAC,KAAK,CAAC,KAAK,qBAW5E;AAED,iBAAS,iBAAiB,CAAC,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,iBAAiB,CAAC,SAAS,CAAC,KAAK,qBAQpF;AAED,iBAAS,aAAa,CAAC,EACrB,SAAS,EACT,GAAG,KAAK,EACT,EAAE,KAAK,CAAC,qBAAqB,CAAC,OAAO,iBAAiB,CAAC,KAAK,CAAC,GAAG,iBAAiB,CAAC,KAAK,CAAC,KAAK,qBAW7F;AAED,iBAAS,YAAY,CAAC,EACpB,SAAS,EACT,QAAQ,EACR,UAAiB,EACjB,GAAG,KAAK,EACT,EAAE,iBAAiB,CAAC,IAAI,CAAC,KAAK,GAAG;IAChC,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB,qBAsBA;AAED,iBAAS,kBAAkB,CAAC,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,iBAAiB,CAAC,KAAK,CAAC,KAAK,qBAQjF;AAED,iBAAS,iBAAiB,2CAEzB;AAED,OAAO,EACL,QAAQ,EACR,aAAa,EACb,eAAe,EACf,YAAY,EACZ,YAAY,EACZ,aAAa,EACb,aAAa,EACb,kBAAkB,EAClB,aAAa,EACb,iBAAiB,EACjB,aAAa,EACb,YAAY,EACZ,kBAAkB,EAClB,eAAe,EACf,aAAa,EACb,iBAAiB,GAClB,CAAC"}
+{"version":3,"file":"combobox.d.ts","sourceRoot":"","sources":["../../src/components/combobox.tsx"],"names":[],"mappings":"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"}

package/dist/components/combobox.js

@@ -6,6 +6,23 @@ import { cn } from "../lib/utils.js";
 import { Button } from "./button.js";
 import { InputGroup, InputGroupAddon, InputGroupButton, InputGroupInput, } from "./input-group.js";
 import { ChevronDownIcon, XIcon, CheckIcon } from "lucide-react";
+/**
+ * Type to find one value, or several, in a known set.
+ *
+ * @family Choices
+ * @when Typing to find in a known set: assign an Agent, choose a time zone, add several Agents at
+ * once with `multiple`.
+ * @instead A short fixed list is a `Select`. Free text is an `Input`. Narrowing a collection is
+ * `CollectionFilters`.
+ * @behaviour Typing filters the list. Loading and no match are different states; the chosen value
+ * stays while results load. Enter picks the highlighted row and never submits the form around it.
+ * Clear empties the box and keeps focus there. With `multiple`, each choice is a chip with its own
+ * remove; Backspace in an empty box removes the last.
+ * @words The hint is scoped: *Find an Agent*. No match quotes the query: *No Agent matches “Xy”.* A
+ * chip reads as the record's name.
+ * @access A visible label; combobox and listbox roles; each chip's remove is named: *Remove Acme
+ * Quotes*. An Agent's orb in a row is a decorative mark beside her name.
+ */
 const Combobox = ComboboxPrimitive.Root;
 function ComboboxValue({ ...props }) {
     return _jsx(ComboboxPrimitive.Value, { "data-slot": "combobox-value", ...props });

package/dist/components/command.d.ts

@@ -2,6 +2,22 @@ import * as React from "react";
 import { Command as CommandPrimitive } from "cmdk";
 import { Dialog } from "./dialog.js";
 declare function Command({ className, ...props }: React.ComponentProps<typeof CommandPrimitive>): React.JSX.Element;
+/**
+ * Find anything across the product and go there.
+ *
+ * @family Navigation
+ * @when Finding anything across the product and going there: an Agent, a customer, a page, a
+ * creation command. Opened by ⌘K or the sidebar's Find.
+ * @instead One record's commands are its `ActionMenu`. Search inside one collection is
+ * `CollectionSearch`. Choosing the page's scope is `ScopeSwitcher`.
+ * @behaviour Opens instantly, a third of the way down, on glass at 12 px corners. Arrows move the
+ * highlight, Enter goes, Esc closes and returns focus to the trigger. An empty query shows useful
+ * defaults; no match says so.
+ * @words Groups are plural nouns (*Agents*, *Go to*). Items are names, or verb and noun for a
+ * command (*New Agent*). No match quotes the query.
+ * @access A dialog with a screen-reader title and description; the field is a combobox over a
+ * listbox; the highlighted item is `aria-selected`.
+ */
 declare function CommandDialog({ title, description, children, className, showCloseButton, ...props }: Omit<React.ComponentProps<typeof Dialog>, "children"> & {
     title?: string;
     description?: string;

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

@@ -1 +1 @@
-{"version":3,"file":"command.d.ts","sourceRoot":"","sources":["../../src/components/command.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,EAAE,OAAO,IAAI,gBAAgB,EAAE,MAAM,MAAM,CAAC;AAGnD,OAAO,EACL,MAAM,EAKP,MAAM,qBAAqB,CAAC;AAI7B,iBAAS,OAAO,CAAC,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,KAAK,CAAC,cAAc,CAAC,OAAO,gBAAgB,CAAC,qBAWtF;AAED,iBAAS,aAAa,CAAC,EACrB,KAAyB,EACzB,WAA8C,EAC9C,QAAQ,EACR,SAAS,EACT,eAAuB,EACvB,GAAG,KAAK,EACT,EAAE,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,OAAO,MAAM,CAAC,EAAE,UAAU,CAAC,GAAG;IACzD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;CAC3B,qBAoBA;AAED,iBAAS,YAAY,CAAC,EACpB,SAAS,EACT,GAAG,KAAK,EACT,EAAE,KAAK,CAAC,cAAc,CAAC,OAAO,gBAAgB,CAAC,KAAK,CAAC,qBAkBrD;AAED,iBAAS,WAAW,CAAC,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,KAAK,CAAC,cAAc,CAAC,OAAO,gBAAgB,CAAC,IAAI,CAAC,qBAW/F;AAED,iBAAS,YAAY,CAAC,EACpB,SAAS,EACT,GAAG,KAAK,EACT,EAAE,KAAK,CAAC,cAAc,CAAC,OAAO,gBAAgB,CAAC,KAAK,CAAC,qBAQrD;AAED,iBAAS,YAAY,CAAC,EACpB,SAAS,EACT,GAAG,KAAK,EACT,EAAE,KAAK,CAAC,cAAc,CAAC,OAAO,gBAAgB,CAAC,KAAK,CAAC,qBAWrD;AAED,iBAAS,gBAAgB,CAAC,EACxB,SAAS,EACT,GAAG,KAAK,EACT,EAAE,KAAK,CAAC,cAAc,CAAC,OAAO,gBAAgB,CAAC,SAAS,CAAC,qBAQzD;AAED,iBAAS,WAAW,CAAC,EACnB,SAAS,EACT,QAAQ,EACR,GAAG,KAAK,EACT,EAAE,KAAK,CAAC,cAAc,CAAC,OAAO,gBAAgB,CAAC,IAAI,CAAC,qBAcpD;AAED,iBAAS,eAAe,CAAC,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,KAAK,CAAC,cAAc,CAAC,MAAM,CAAC,qBAW7E;AAED,OAAO,EACL,OAAO,EACP,aAAa,EACb,YAAY,EACZ,WAAW,EACX,YAAY,EACZ,YAAY,EACZ,WAAW,EACX,eAAe,EACf,gBAAgB,GACjB,CAAC"}
+{"version":3,"file":"command.d.ts","sourceRoot":"","sources":["../../src/components/command.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,EAAE,OAAO,IAAI,gBAAgB,EAAE,MAAM,MAAM,CAAC;AAGnD,OAAO,EACL,MAAM,EAKP,MAAM,qBAAqB,CAAC;AAI7B,iBAAS,OAAO,CAAC,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,KAAK,CAAC,cAAc,CAAC,OAAO,gBAAgB,CAAC,qBAWtF;AAED;;;;;;;;;;;;;;;GAeG;AACH,iBAAS,aAAa,CAAC,EACrB,KAAyB,EACzB,WAA8C,EAC9C,QAAQ,EACR,SAAS,EACT,eAAuB,EACvB,GAAG,KAAK,EACT,EAAE,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,OAAO,MAAM,CAAC,EAAE,UAAU,CAAC,GAAG;IACzD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;CAC3B,qBAoBA;AAED,iBAAS,YAAY,CAAC,EACpB,SAAS,EACT,GAAG,KAAK,EACT,EAAE,KAAK,CAAC,cAAc,CAAC,OAAO,gBAAgB,CAAC,KAAK,CAAC,qBAkBrD;AAED,iBAAS,WAAW,CAAC,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,KAAK,CAAC,cAAc,CAAC,OAAO,gBAAgB,CAAC,IAAI,CAAC,qBAW/F;AAED,iBAAS,YAAY,CAAC,EACpB,SAAS,EACT,GAAG,KAAK,EACT,EAAE,KAAK,CAAC,cAAc,CAAC,OAAO,gBAAgB,CAAC,KAAK,CAAC,qBAQrD;AAED,iBAAS,YAAY,CAAC,EACpB,SAAS,EACT,GAAG,KAAK,EACT,EAAE,KAAK,CAAC,cAAc,CAAC,OAAO,gBAAgB,CAAC,KAAK,CAAC,qBAWrD;AAED,iBAAS,gBAAgB,CAAC,EACxB,SAAS,EACT,GAAG,KAAK,EACT,EAAE,KAAK,CAAC,cAAc,CAAC,OAAO,gBAAgB,CAAC,SAAS,CAAC,qBAQzD;AAED,iBAAS,WAAW,CAAC,EACnB,SAAS,EACT,QAAQ,EACR,GAAG,KAAK,EACT,EAAE,KAAK,CAAC,cAAc,CAAC,OAAO,gBAAgB,CAAC,IAAI,CAAC,qBAcpD;AAED,iBAAS,eAAe,CAAC,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,KAAK,CAAC,cAAc,CAAC,MAAM,CAAC,qBAW7E;AAED,OAAO,EACL,OAAO,EACP,aAAa,EACb,YAAY,EACZ,WAAW,EACX,YAAY,EACZ,YAAY,EACZ,WAAW,EACX,eAAe,EACf,gBAAgB,GACjB,CAAC"}

package/dist/components/command.js

@@ -8,6 +8,22 @@ import { SearchIcon, CheckIcon } from "lucide-react";
 function Command({ className, ...props }) {
     return (_jsx(CommandPrimitive, { "data-slot": "command", className: cn("flex size-full flex-col overflow-hidden rounded-lg! nc-glass p-nadicode-xxs text-popover-foreground", className), ...props }));
 }
+/**
+ * Find anything across the product and go there.
+ *
+ * @family Navigation
+ * @when Finding anything across the product and going there: an Agent, a customer, a page, a
+ * creation command. Opened by ⌘K or the sidebar's Find.
+ * @instead One record's commands are its `ActionMenu`. Search inside one collection is
+ * `CollectionSearch`. Choosing the page's scope is `ScopeSwitcher`.
+ * @behaviour Opens instantly, a third of the way down, on glass at 12 px corners. Arrows move the
+ * highlight, Enter goes, Esc closes and returns focus to the trigger. An empty query shows useful
+ * defaults; no match says so.
+ * @words Groups are plural nouns (*Agents*, *Go to*). Items are names, or verb and noun for a
+ * command (*New Agent*). No match quotes the query.
+ * @access A dialog with a screen-reader title and description; the field is a combobox over a
+ * listbox; the highlighted item is `aria-selected`.
+ */
 function CommandDialog({ title = "Command Palette", description = "Search for a command to run...", children, className, showCloseButton = false, ...props }) {
     return (_jsxs(Dialog, { ...props, children: [_jsxs(DialogHeader, { className: "sr-only", children: [_jsx(DialogTitle, { children: title }), _jsx(DialogDescription, { children: description })] }), _jsx(DialogContent, { className: cn("top-1/3 translate-y-0 overflow-hidden rounded-lg! bg-transparent p-0!", className), motion: "instant", showCloseButton: showCloseButton, children: children })] }));
 }

package/dist/components/company-card/renderer.js

@@ -128,11 +128,11 @@ export function createRenderer(canvas, options) {
             shader.set({ params: { tilt: [tiltX, tiltY], pointer: [lightX, lightY], hover } });
             currentFrame.pass(output, shader);
         }, { fps: 60 });
-    })().catch((error) => {
+    })().catch((cause) => {
         if (disposed)
             return;
         dispose();
-        throw error;
+        throw cause;
     });
     return { ready, dispose, sweep: () => requestSweep() };
 }

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

@@ -7,10 +7,22 @@ export type CompanyCardLabels = {
 };
 /**
  * The company's nadicode card: what the person is making while they sign up,
- * and what the website shows being issued. It carries every word it shows as a
- * prop, fills in as the form is typed and turns to the pointer, so the foil in
- * its engraving catches the light. The words are the caller's, so the card is
- * hidden from assistive technology and holds nothing interactive.
+ * and what the website shows being issued.
+ *
+ * It carries every word it shows as a prop, fills in as the form is typed and
+ * turns to the pointer, so the foil in its engraving catches the light. The
+ * words are the caller's, so the card is hidden from assistive technology and
+ * holds nothing interactive.
+ *
+ * @family Other
+ * @when Sign-up, where a person watches their company's card being made, and the website, which
+ * shows one being issued.
+ * @instead A company's facts are `SettingsFactsSection`. A company in a row is its `IdentityMark`.
+ * @behaviour Fills in as the form is typed and turns to the pointer so its foil catches the light;
+ * a company's card takes the cool foil, a Partner's the warm. Still under reduced motion.
+ * @words Every word it shows is a prop from the product's catalogue.
+ * @access Hidden from assistive technology and holds nothing interactive; the form beside it
+ * carries the same words.
  */
 export declare function CompanyCard({ name, domain, edition, issued, labels, logo, sweepInView, }: {
     name: string;

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

@@ -1 +1 @@
-{"version":3,"file":"company-card.d.ts","sourceRoot":"","sources":["../../src/components/company-card.tsx"],"names":[],"mappings":"AASA,MAAM,MAAM,kBAAkB,GAAG,SAAS,GAAG,SAAS,CAAC;AAEvD,MAAM,MAAM,iBAAiB,GAAG;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,eAAe,EAAE,MAAM,CAAC;IACxB,iBAAiB,EAAE,MAAM,CAAC;CAC3B,CAAC;AAqBF;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,EAC1B,IAAI,EACJ,MAAM,EACN,OAAO,EACP,MAAM,EACN,MAAM,EACN,IAAI,EACJ,WAAmB,GACpB,EAAE;IACD,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,kBAAkB,CAAC;IAC5B,MAAM,EAAE,OAAO,CAAC;IAChB,MAAM,EAAE,iBAAiB,CAAC;IAC1B,mFAAmF;IACnF,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;;;OAKG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB,+BAsSA"}
+{"version":3,"file":"company-card.d.ts","sourceRoot":"","sources":["../../src/components/company-card.tsx"],"names":[],"mappings":"AASA,MAAM,MAAM,kBAAkB,GAAG,SAAS,GAAG,SAAS,CAAC;AAEvD,MAAM,MAAM,iBAAiB,GAAG;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,eAAe,EAAE,MAAM,CAAC;IACxB,iBAAiB,EAAE,MAAM,CAAC;CAC3B,CAAC;AAqBF;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,WAAW,CAAC,EAC1B,IAAI,EACJ,MAAM,EACN,OAAO,EACP,MAAM,EACN,MAAM,EACN,IAAI,EACJ,WAAmB,GACpB,EAAE;IACD,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,kBAAkB,CAAC;IAC5B,MAAM,EAAE,OAAO,CAAC;IAChB,MAAM,EAAE,iBAAiB,CAAC;IAC1B,mFAAmF;IACnF,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;;;OAKG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB,+BAsSA"}

package/dist/components/company-card.js

@@ -17,15 +17,27 @@ const FOIL = {
 const STRIPE = 34;
 /** How much of the card must be on screen before it turns, when the caller waits for it. */
 const IN_VIEW = 0.6;
-function reason(error) {
-    return error instanceof Error ? error.message : String(error);
+function reason(cause) {
+    return cause instanceof Error ? cause.message : String(cause);
 }
 /**
  * The company's nadicode card: what the person is making while they sign up,
- * and what the website shows being issued. It carries every word it shows as a
- * prop, fills in as the form is typed and turns to the pointer, so the foil in
- * its engraving catches the light. The words are the caller's, so the card is
- * hidden from assistive technology and holds nothing interactive.
+ * and what the website shows being issued.
+ *
+ * It carries every word it shows as a prop, fills in as the form is typed and
+ * turns to the pointer, so the foil in its engraving catches the light. The
+ * words are the caller's, so the card is hidden from assistive technology and
+ * holds nothing interactive.
+ *
+ * @family Other
+ * @when Sign-up, where a person watches their company's card being made, and the website, which
+ * shows one being issued.
+ * @instead A company's facts are `SettingsFactsSection`. A company in a row is its `IdentityMark`.
+ * @behaviour Fills in as the form is typed and turns to the pointer so its foil catches the light;
+ * a company's card takes the cool foil, a Partner's the warm. Still under reduced motion.
+ * @words Every word it shows is a prop from the product's catalogue.
+ * @access Hidden from assistive technology and holds nothing interactive; the form beside it
+ * carries the same words.
  */
 export function CompanyCard({ name, domain, edition, issued, labels, logo, sweepInView = false, }) {
     // A CSS `url(#…)` reference cannot carry the punctuation React puts in an id.
@@ -80,13 +92,13 @@ export function CompanyCard({ name, domain, edition, issued, labels, logo, sweep
                 sweepRef.current = created.sweep;
                 // The first time the card appears, it turns once in the light.
                 created.sweep();
-            }, (error) => {
-                console.warn(`The card's WebGPU foil could not start; the SVG foil stands in: ${reason(error)}`);
+            }, (cause) => {
+                console.warn(`The card's WebGPU foil could not start; the SVG foil stands in: ${reason(cause)}`);
                 if (!cancelled)
                     setGpuFoil(false);
             });
-        }, (error) => {
-            console.warn(`The card's WebGPU foil could not load; the SVG foil stands in: ${reason(error)}`);
+        }, (cause) => {
+            console.warn(`The card's WebGPU foil could not load; the SVG foil stands in: ${reason(cause)}`);
             setGpuFoil(false);
         });
         return () => {

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

@@ -1,24 +1,34 @@
-import type * as React from "react";
+import { type ReactNode } from "react";
 import { type ResolvedMessage } from "./product-message.js";
-interface ConfirmDialogProps {
+export type ConfirmDialogProps = {
     open: boolean;
     onConfirm: () => void;
     onCancel: () => void;
-    title: React.ReactNode;
-    description?: React.ReactNode;
+    /** Names the record, as a statement: "Remove pec@acme.it". Never a question. */
+    title: string;
+    /** The consequence. */
+    description: ReactNode;
+    /** Repeats the verb and the noun: "Remove mailbox". */
+    confirmLabel: string;
+    confirmPendingLabel?: string;
+    cancelLabel: string;
+    destructive?: boolean;
+    loading?: boolean;
     /**
      * Why the confirmed action did not happen, from the product's catalogue,
      * with the message's own actions, such as signing in, under it.
      */
     error?: ResolvedMessage | null;
-    confirmLabel?: React.ReactNode;
-    /** The confirm button's own word while the action runs. */
-    confirmPendingLabel?: React.ReactNode;
-    cancelLabel?: React.ReactNode;
-    destructive?: boolean;
-    loading?: boolean;
-}
-declare function ConfirmDialog({ open, onConfirm, onCancel, title, description, error, confirmLabel, confirmPendingLabel, cancelLabel, destructive, loading, }: ConfirmDialogProps): React.JSX.Element;
-export { ConfirmDialog };
-export type { ConfirmDialogProps };
+};
+/**
+ * A consequence confirmed before it happens, in a blocking alert dialog.
+ *
+ * @family Compositions
+ * @when An action removes, disconnects or deletes something, or otherwise cannot be taken back: remove a mailbox, delete an Agent.
+ * @instead An action that can be undone runs at once and offers its undo in a toast; a form of a few fields is a `FormDialog`; a choice from a catalogue is a `CatalogDrawer`.
+ * @behaviour The title names the record, the description the consequence; a failed confirm keeps the dialog open with the catalogue's message and its actions under the description. Cancel then the confirm at the footer's trailing edge, the confirm in the error colour when `destructive`. While `loading` both hold, Escape does not close it, and the confirm says its pending word. The backdrop does not dismiss it.
+ * @words The title is a statement naming the record, never a question: "Remove pec@acme.it". The description says what stops and what stays. The confirm repeats the verb and the noun, "Remove mailbox", never just "Delete" or "OK".
+ * @access `role="alertdialog"` named by its title and described by its consequence; focus starts on Cancel, Escape cancels, and focus returns to the opener.
+ */
+export declare function ConfirmDialog({ open, onConfirm, onCancel, title, description, confirmLabel, confirmPendingLabel, cancelLabel, destructive, loading, error, }: ConfirmDialogProps): import("react").JSX.Element;
 //# sourceMappingURL=confirm-dialog.d.ts.map