@nadicodeai/ui 12.1.95 → 12.1.97

package/dist/components/pending-label.js

@@ -2,11 +2,19 @@ import { jsx as _jsx } from "react/jsx-runtime";
 import { cn } from "../lib/utils.js";
 /**
  * A control's own label while the system works on what it was asked to do.
- * The word changes and nothing moves; the control keeps its place, its icon
- * and its size. The caller owns `disabled` and `aria-busy` on the control
- * itself, because only the caller knows which element the wait belongs to.
  *
- * Work that runs past a second adds one `WaitingLine` beside the control.
+ * @family Feedback
+ * @when Every control that starts work the system does: from the press until the result, whatever
+ * the wait. Under about a second it is the only sign. Every save in a footer goes through it.
+ * @instead Past a second add one `WaitingLine` beside the control. An Agent's work is never this:
+ * it is her orb and a sentence. A queued or paused request is a status.
+ * @behaviour Swaps the word, nothing else: same place, size and icon. The caller sets `disabled`
+ * (50% opacity) and `aria-busy` and blocks a second submit, because only the caller knows which
+ * element the wait belongs to. Failure returns the rest label.
+ * @words The rest label's verb in its -ing form with the same noun: *Remove mailbox* to *Removing
+ * mailbox*. No ellipsis, no *Please wait*.
+ * @access `aria-busy` on the control; its name changes to the pending word and is read once. Focus
+ * stays on it.
  */
 function PendingLabel({ children, className, pending, pendingLabel, ...props }) {
     return (_jsx("span", { ...props, className: cn(className), "data-pending": pending || undefined, "data-slot": "pending-label", children: pending ? pendingLabel : children }));

package/dist/components/picture-label.d.ts

@@ -1,12 +1,20 @@
 import type { ReactNode } from "react";
 /**
- * A failure page's picture with its label
- * ([Failure surfaces](../../../design-system/DESIGN.md#failure-surfaces)): the
- * way a museum labels a work, the title says what the picture is doing, which
- * is the page's joke, and the second line gives its materials and year. From
- * `lg` the label stands beside the picture's base, with an empty column of the
- * same width on the other side so the picture stays on the page's centre line;
- * below that it stands centred under the picture.
+ * A failure page's picture with its label, the way a museum labels a work.
+ *
+ * DESIGN.md: [Failure surfaces](../../../design-system/DESIGN.md#failure-surfaces).
+ *
+ * @family Feedback
+ * @when A page that cannot show what was asked for: an address or record that is not there
+ * (absence), or a request the product stopped (fault). `PictureLabel` is its label.
+ * @instead For one region that failed inside a working page use `EmptyState failed`; the rest of
+ * the page stays. Never turn the whole page into an error because one card failed.
+ * @behaviour Picture 256 px, 320 from sm, 384 from lg. The label moves beside the base at lg with
+ * an empty column of the same width opposite, so the picture keeps the centre line. Still.
+ * @words Never apologise, never name the mechanism. The label's title says what the picture is
+ * doing; the second line gives its materials and year.
+ * @access The picture is decorative; the label is a `figcaption`, read once. The page's heading is
+ * its `h1`; its actions are real links.
  */
 export declare function LabelledPicture({ children, label, className, }: {
     children: ReactNode;

package/dist/components/picture-label.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"picture-label.d.ts","sourceRoot":"","sources":["../../src/components/picture-label.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAIvC;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAAC,EAC9B,QAAQ,EACR,KAAK,EACL,SAAS,GACV,EAAE;IACD,QAAQ,EAAE,SAAS,CAAC;IACpB,4DAA4D;IAC5D,KAAK,EAAE,SAAS,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,+BAeA;AAED,wBAAgB,YAAY,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,+BASlF"}
+{"version":3,"file":"picture-label.d.ts","sourceRoot":"","sources":["../../src/components/picture-label.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAIvC;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,eAAe,CAAC,EAC9B,QAAQ,EACR,KAAK,EACL,SAAS,GACV,EAAE;IACD,QAAQ,EAAE,SAAS,CAAC;IACpB,4DAA4D;IAC5D,KAAK,EAAE,SAAS,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,+BAeA;AAED,wBAAgB,YAAY,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,+BASlF"}

package/dist/components/picture-label.js

@@ -1,13 +1,21 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { cn } from "../lib/utils.js";
 /**
- * A failure page's picture with its label
- * ([Failure surfaces](../../../design-system/DESIGN.md#failure-surfaces)): the
- * way a museum labels a work, the title says what the picture is doing, which
- * is the page's joke, and the second line gives its materials and year. From
- * `lg` the label stands beside the picture's base, with an empty column of the
- * same width on the other side so the picture stays on the page's centre line;
- * below that it stands centred under the picture.
+ * A failure page's picture with its label, the way a museum labels a work.
+ *
+ * DESIGN.md: [Failure surfaces](../../../design-system/DESIGN.md#failure-surfaces).
+ *
+ * @family Feedback
+ * @when A page that cannot show what was asked for: an address or record that is not there
+ * (absence), or a request the product stopped (fault). `PictureLabel` is its label.
+ * @instead For one region that failed inside a working page use `EmptyState failed`; the rest of
+ * the page stays. Never turn the whole page into an error because one card failed.
+ * @behaviour Picture 256 px, 320 from sm, 384 from lg. The label moves beside the base at lg with
+ * an empty column of the same width opposite, so the picture keeps the centre line. Still.
+ * @words Never apologise, never name the mechanism. The label's title says what the picture is
+ * doing; the second line gives its materials and year.
+ * @access The picture is decorative; the label is a `figcaption`, read once. The page's heading is
+ * its `h1`; its actions are real links.
  */
 export function LabelledPicture({ children, label, className, }) {
     return (_jsxs("figure", { className: cn("m-0 grid w-full max-w-4xl justify-items-center gap-4 lg:grid-cols-[minmax(0,1fr)_auto_minmax(0,1fr)] lg:items-end lg:gap-8", className), "data-slot": "labelled-picture", children: [_jsx("div", { className: "lg:col-start-2 lg:row-start-1", children: children }), _jsx("figcaption", { className: "max-w-72 text-center lg:col-start-3 lg:row-start-1 lg:justify-self-start lg:pb-6 lg:text-start", children: label })] }));

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

@@ -27,9 +27,18 @@ type PlatformMarkProps = Omit<IconProps, "children" | "icon" | "ref"> & {
     size?: number;
 };
 /**
- * A platform's genuine mark, drawn at once on the server and in the browser.
- * It always sits beside the name that reads it, so assistive technology skips
- * it.
+ * A platform's genuine mark: an operating system, a messaging channel or a sign-in provider.
+ *
+ * @family Status
+ * @when Naming a platform beside its word: *Continue with Google*, a Telegram channel, the macOS
+ * download.
+ * @instead A connected app in its tile is `AppMark`. A model's maker is `ModelMark`. The company is
+ * `BrandMark`.
+ * @behaviour Drawn at once on the server and in the browser from Iconify's `logos` set, one module
+ * per mark; Alveare by its own. A silhouette takes the text colour; a coloured mark keeps its
+ * paint.
+ * @words None of its own; the platform's name always stands beside it.
+ * @access Always `aria-hidden`: the name beside it is the reading.
  */
 declare function PlatformMark({ platform, size, ...props }: PlatformMarkProps): React.JSX.Element;
 export { PlatformMark, isPlatform };

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

@@ -1 +1 @@
-{"version":3,"file":"platform-mark.d.ts","sourceRoot":"","sources":["../../src/components/platform-mark.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAQ,KAAK,WAAW,EAAE,KAAK,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAWhF,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAkB/B;;;;GAIG;AACH,QAAA,MAAM,SAAS;;;;;;;;;;;;CAYwB,CAAC;AAExC,KAAK,YAAY,GAAG,MAAM,OAAO,SAAS,CAAC;AAE3C,qFAAqF;AACrF,iBAAS,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,IAAI,YAAY,CAEtD;AAOD,KAAK,iBAAiB,GAAG,IAAI,CAAC,SAAS,EAAE,UAAU,GAAG,MAAM,GAAG,KAAK,CAAC,GAAG;IACtE,QAAQ,EAAE,YAAY,CAAC;IACvB,wEAAwE;IACxE,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,CAAC;AAEF;;;;GAIG;AACH,iBAAS,YAAY,CAAC,EAAE,QAAQ,EAAE,IAAS,EAAE,GAAG,KAAK,EAAE,EAAE,iBAAiB,qBAgBzE;AAED,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,CAAC;AACpC,YAAY,EAAE,iBAAiB,EAAE,YAAY,EAAE,CAAC"}
+{"version":3,"file":"platform-mark.d.ts","sourceRoot":"","sources":["../../src/components/platform-mark.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAQ,KAAK,WAAW,EAAE,KAAK,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAWhF,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAkB/B;;;;GAIG;AACH,QAAA,MAAM,SAAS;;;;;;;;;;;;CAYwB,CAAC;AAExC,KAAK,YAAY,GAAG,MAAM,OAAO,SAAS,CAAC;AAE3C,qFAAqF;AACrF,iBAAS,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,IAAI,YAAY,CAEtD;AAOD,KAAK,iBAAiB,GAAG,IAAI,CAAC,SAAS,EAAE,UAAU,GAAG,MAAM,GAAG,KAAK,CAAC,GAAG;IACtE,QAAQ,EAAE,YAAY,CAAC;IACvB,wEAAwE;IACxE,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,CAAC;AAEF;;;;;;;;;;;;;GAaG;AACH,iBAAS,YAAY,CAAC,EAAE,QAAQ,EAAE,IAAS,EAAE,GAAG,KAAK,EAAE,EAAE,iBAAiB,qBAgBzE;AAED,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,CAAC;AACpC,YAAY,EAAE,iBAAiB,EAAE,YAAY,EAAE,CAAC"}

package/dist/components/platform-mark.js

@@ -53,9 +53,18 @@ function silhouette(icon) {
     return !/\b(?:fill|stroke|stop-color)=/.test(icon.body);
 }
 /**
- * A platform's genuine mark, drawn at once on the server and in the browser.
- * It always sits beside the name that reads it, so assistive technology skips
- * it.
+ * A platform's genuine mark: an operating system, a messaging channel or a sign-in provider.
+ *
+ * @family Status
+ * @when Naming a platform beside its word: *Continue with Google*, a Telegram channel, the macOS
+ * download.
+ * @instead A connected app in its tile is `AppMark`. A model's maker is `ModelMark`. The company is
+ * `BrandMark`.
+ * @behaviour Drawn at once on the server and in the browser from Iconify's `logos` set, one module
+ * per mark; Alveare by its own. A silhouette takes the text colour; a coloured mark keeps its
+ * paint.
+ * @words None of its own; the platform's name always stands beside it.
+ * @access Always `aria-hidden`: the name beside it is the reading.
  */
 function PlatformMark({ platform, size = 24, ...props }) {
     const icon = PLATFORMS[platform];

package/dist/components/plugin-slot-boundary.d.ts

@@ -21,6 +21,21 @@ type PluginSlotBoundaryProps = Omit<React.ComponentProps<"section">, "title"> &
     contentLabel?: string;
     contentClassName?: string;
 };
+/**
+ * The frame around content a plugin draws inside a product.
+ *
+ * @family Other
+ * @when Any surface a plugin renders into: it names the plugin, its permissions and its state
+ * around the plugin's own content.
+ * @instead The product's own sections are `SettingsSection` or `ObjectSection`.
+ * @behaviour A title and description, the permissions with their levels, a warning or an error when
+ * given, then the plugin's content in a labelled region and its footer. `disabled` dims the
+ * content.
+ * @words The plugin's title as the plugin names itself; permissions are short nouns with a sentence
+ * each.
+ * @access The permissions are a labelled list and the plugin's content a region labelled
+ * `contentLabel`, so a reader knows where the plugin begins and ends.
+ */
 declare function PluginSlotBoundary({ title, description, status, permissions, warning, error, redactionGuidance, actions, footer, children, contentLabel, className, contentClassName, ...props }: PluginSlotBoundaryProps): React.JSX.Element;
 export { PluginSlotBoundary };
 export type { PluginPermission, PluginPermissionLevel, PluginSlotBoundaryProps, PluginSlotBoundaryStatus, };

package/dist/components/plugin-slot-boundary.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"plugin-slot-boundary.d.ts","sourceRoot":"","sources":["../../src/components/plugin-slot-boundary.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAe/B,KAAK,wBAAwB,GAAG,OAAO,GAAG,SAAS,GAAG,OAAO,GAAG,UAAU,CAAC;AAC3E,KAAK,qBAAqB,GAAG,MAAM,GAAG,QAAQ,GAAG,MAAM,GAAG,QAAQ,CAAC;AAEnE,KAAK,gBAAgB,GAAG;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,KAAK,CAAC,SAAS,CAAC;IACvB,KAAK,CAAC,EAAE,qBAAqB,CAAC;IAC9B,WAAW,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;CAC/B,CAAC;AAEF,KAAK,uBAAuB,GAAG,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC,GAAG;IAC9E,KAAK,EAAE,KAAK,CAAC,SAAS,CAAC;IACvB,WAAW,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC9B,MAAM,CAAC,EAAE,wBAAwB,CAAC;IAClC,WAAW,CAAC,EAAE,gBAAgB,EAAE,CAAC;IACjC,OAAO,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B,KAAK,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IACxB,iBAAiB,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IACpC,OAAO,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B,MAAM,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IACzB,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B,CAAC;AAeF,iBAAS,kBAAkB,CAAC,EAC1B,KAAK,EACL,WAAW,EACX,MAAgB,EAChB,WAAgB,EAChB,OAAO,EACP,KAAK,EACL,iBAA4C,EAC5C,OAAO,EACP,MAAM,EACN,QAAQ,EACR,YAA+B,EAC/B,SAAS,EACT,gBAAgB,EAChB,GAAG,KAAK,EACT,EAAE,uBAAuB,qBAmGzB;AAED,OAAO,EAAE,kBAAkB,EAAE,CAAC;AAC9B,YAAY,EACV,gBAAgB,EAChB,qBAAqB,EACrB,uBAAuB,EACvB,wBAAwB,GACzB,CAAC"}
+{"version":3,"file":"plugin-slot-boundary.d.ts","sourceRoot":"","sources":["../../src/components/plugin-slot-boundary.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAe/B,KAAK,wBAAwB,GAAG,OAAO,GAAG,SAAS,GAAG,OAAO,GAAG,UAAU,CAAC;AAC3E,KAAK,qBAAqB,GAAG,MAAM,GAAG,QAAQ,GAAG,MAAM,GAAG,QAAQ,CAAC;AAEnE,KAAK,gBAAgB,GAAG;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,KAAK,CAAC,SAAS,CAAC;IACvB,KAAK,CAAC,EAAE,qBAAqB,CAAC;IAC9B,WAAW,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;CAC/B,CAAC;AAEF,KAAK,uBAAuB,GAAG,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC,GAAG;IAC9E,KAAK,EAAE,KAAK,CAAC,SAAS,CAAC;IACvB,WAAW,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC9B,MAAM,CAAC,EAAE,wBAAwB,CAAC;IAClC,WAAW,CAAC,EAAE,gBAAgB,EAAE,CAAC;IACjC,OAAO,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B,KAAK,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IACxB,iBAAiB,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IACpC,OAAO,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B,MAAM,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IACzB,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B,CAAC;AAeF;;;;;;;;;;;;;;GAcG;AACH,iBAAS,kBAAkB,CAAC,EAC1B,KAAK,EACL,WAAW,EACX,MAAgB,EAChB,WAAgB,EAChB,OAAO,EACP,KAAK,EACL,iBAA4C,EAC5C,OAAO,EACP,MAAM,EACN,QAAQ,EACR,YAA+B,EAC/B,SAAS,EACT,gBAAgB,EAChB,GAAG,KAAK,EACT,EAAE,uBAAuB,qBAoGzB;AAED,OAAO,EAAE,kBAAkB,EAAE,CAAC;AAC9B,YAAY,EACV,gBAAgB,EAChB,qBAAqB,EACrB,uBAAuB,EACvB,wBAAwB,GACzB,CAAC"}

package/dist/components/plugin-slot-boundary.js

@@ -12,11 +12,28 @@ const permissionBadgeVariants = {
     denied: "destructive",
 };
 const defaultRedactionGuidance = "Plugin content should be synthetic or redacted. Do not render secrets, environment variable values, raw terminal output, or hidden reasoning.";
+/**
+ * The frame around content a plugin draws inside a product.
+ *
+ * @family Other
+ * @when Any surface a plugin renders into: it names the plugin, its permissions and its state
+ * around the plugin's own content.
+ * @instead The product's own sections are `SettingsSection` or `ObjectSection`.
+ * @behaviour A title and description, the permissions with their levels, a warning or an error when
+ * given, then the plugin's content in a labelled region and its footer. `disabled` dims the
+ * content.
+ * @words The plugin's title as the plugin names itself; permissions are short nouns with a sentence
+ * each.
+ * @access The permissions are a labelled list and the plugin's content a region labelled
+ * `contentLabel`, so a reader knows where the plugin begins and ends.
+ */
 function PluginSlotBoundary({ title, description, status = "ready", permissions = [], warning, error, redactionGuidance = defaultRedactionGuidance, actions, footer, children, contentLabel = "Plugin content", className, contentClassName, ...props }) {
     const statusIcon = status === "error" ? (_jsx(ShieldAlertIcon, { "data-icon": true, className: "size-4" })) : status === "warning" ? (_jsx(AlertTriangleIcon, { "data-icon": true, className: "size-4" })) : status === "disabled" ? (_jsx(LockKeyholeIcon, { "data-icon": true, className: "size-4" })) : (_jsx(ShieldCheckIcon, { "data-icon": true, className: "size-4" }));
     return (_jsx("section", { "data-slot": "plugin-slot-boundary", "data-status": status, className: className, ...props, children: _jsxs(Card, { className: "overflow-hidden", children: [_jsxs(CardHeader, { children: [_jsxs("div", { className: "flex flex-wrap items-start justify-between gap-3", children: [_jsxs("div", { className: "grid min-w-0 gap-1", children: [_jsxs(CardTitle, { className: "flex items-center gap-2", children: [statusIcon, _jsx("span", { className: "min-w-0 truncate", children: title })] }), description && _jsx(CardDescription, { children: description })] }), actions && (_jsx("div", { "data-slot": "plugin-slot-boundary-actions", className: "flex shrink-0 items-center gap-2", children: actions }))] }), permissions.length > 0 && (_jsx("div", { "data-slot": "plugin-slot-boundary-permissions", className: "flex flex-wrap items-center gap-2", "aria-label": "Plugin permissions", children: permissions.map((permission) => {
                                 const level = permission.level ?? "review";
-                                return (_jsx(Badge, { "data-slot": "plugin-slot-boundary-permission", "data-level": level, variant: permissionBadgeVariants[level], title: typeof permission.description === "string"
+                                return (_jsx(Badge, { "data-slot": "plugin-slot-boundary-permission", "data-level": level, variant: permissionBadgeVariants[level], title: 
+                                    // oxlint-disable-next-line anti-slop/no-runtime-typeof -- description is a ReactNode; only a string can be a title attribute.
+                                    typeof permission.description === "string"
                                         ? permission.description
                                         : undefined, children: permission.label }, permission.id));
                             }) }))] }), _jsxs(CardContent, { className: "grid gap-4", children: [warning && (_jsxs(Alert, { "data-slot": "plugin-slot-boundary-warning", children: [_jsx(AlertTriangleIcon, { "data-icon": true }), _jsx(AlertTitle, { children: "Review before continuing" }), _jsx(AlertDescription, { children: warning })] })), error && (_jsxs(Alert, { "data-slot": "plugin-slot-boundary-error", variant: "destructive", children: [_jsx(ShieldAlertIcon, { "data-icon": true }), _jsx(AlertTitle, { children: "Plugin content unavailable" }), _jsx(AlertDescription, { children: error })] })), _jsx("div", { "data-slot": "plugin-slot-boundary-content", "aria-label": contentLabel, className: cn("max-h-96 min-w-0 overflow-auto rounded-sm border bg-background p-4 text-sm break-words", status === "disabled" && "pointer-events-none opacity-60", contentClassName), children: children })] }), (redactionGuidance || footer) && (_jsxs(CardFooter, { className: "flex flex-col items-start gap-2 border-t text-sm text-muted-foreground", children: [redactionGuidance && (_jsx("p", { "data-slot": "plugin-slot-boundary-redaction", children: redactionGuidance })), footer && _jsx("div", { "data-slot": "plugin-slot-boundary-footer", children: footer })] }))] }) }));

package/dist/components/popover.d.ts

@@ -1,5 +1,20 @@
 import * as React from "react";
 import { Popover as PopoverPrimitive } from "@base-ui/react/popover";
+/**
+ * A small control set tied to its trigger, on glass.
+ *
+ * @family Menus
+ * @when A small control set tied to its trigger: filters, a scope chooser, a date range, a feedback
+ * form. The page stays live behind it.
+ * @instead For commands use `DropdownMenu`. For a form that adds a record use `FormDialog`. For one
+ * phrase use `Tooltip`; for facts on hover use `HoverCard`.
+ * @behaviour Glass floating surface, 12 px padding and gap. Opens on click, closes on Escape or
+ * outside press, focus returns to the trigger. Applies at once; no Save inside.
+ * @words Title names the control's job (*Filter skills*); an optional one-line description. Options
+ * are nouns.
+ * @access Trigger has a visible name and `aria-expanded`. The popup is a labelled dialog that does
+ * not trap focus; Tab leaves it in order.
+ */
 declare function Popover({ ...props }: PopoverPrimitive.Root.Props): React.JSX.Element;
 declare function PopoverTrigger({ ...props }: PopoverPrimitive.Trigger.Props): React.JSX.Element;
 declare function PopoverContent({ className, align, alignOffset, side, sideOffset, anchor, ...props }: PopoverPrimitive.Popup.Props & Pick<PopoverPrimitive.Positioner.Props, "align" | "alignOffset" | "anchor" | "side" | "sideOffset">): React.JSX.Element;

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

@@ -1 +1 @@
-{"version":3,"file":"popover.d.ts","sourceRoot":"","sources":["../../src/components/popover.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,EAAE,OAAO,IAAI,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAKrE,iBAAS,OAAO,CAAC,EAAE,GAAG,KAAK,EAAE,EAAE,gBAAgB,CAAC,IAAI,CAAC,KAAK,qBAEzD;AAED,iBAAS,cAAc,CAAC,EAAE,GAAG,KAAK,EAAE,EAAE,gBAAgB,CAAC,OAAO,CAAC,KAAK,qBAEnE;AAED,iBAAS,cAAc,CAAC,EACtB,SAAS,EACT,KAAgB,EAChB,WAAe,EACf,IAAe,EACf,UAAc,EACd,MAAM,EACN,GAAG,KAAK,EACT,EAAE,gBAAgB,CAAC,KAAK,CAAC,KAAK,GAC7B,IAAI,CACF,gBAAgB,CAAC,UAAU,CAAC,KAAK,EACjC,OAAO,GAAG,aAAa,GAAG,QAAQ,GAAG,MAAM,GAAG,YAAY,CAC3D,qBAuBF;AAED,iBAAS,aAAa,CAAC,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,KAAK,CAAC,cAAc,CAAC,KAAK,CAAC,qBAQ1E;AAED,iBAAS,YAAY,CAAC,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,gBAAgB,CAAC,KAAK,CAAC,KAAK,qBAQ1E;AAED,iBAAS,kBAAkB,CAAC,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,gBAAgB,CAAC,WAAW,CAAC,KAAK,qBAQtF;AAED,OAAO,EAAE,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAE,aAAa,EAAE,YAAY,EAAE,cAAc,EAAE,CAAC"}
+{"version":3,"file":"popover.d.ts","sourceRoot":"","sources":["../../src/components/popover.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,EAAE,OAAO,IAAI,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAKrE;;;;;;;;;;;;;;GAcG;AACH,iBAAS,OAAO,CAAC,EAAE,GAAG,KAAK,EAAE,EAAE,gBAAgB,CAAC,IAAI,CAAC,KAAK,qBAEzD;AAED,iBAAS,cAAc,CAAC,EAAE,GAAG,KAAK,EAAE,EAAE,gBAAgB,CAAC,OAAO,CAAC,KAAK,qBAEnE;AAED,iBAAS,cAAc,CAAC,EACtB,SAAS,EACT,KAAgB,EAChB,WAAe,EACf,IAAe,EACf,UAAc,EACd,MAAM,EACN,GAAG,KAAK,EACT,EAAE,gBAAgB,CAAC,KAAK,CAAC,KAAK,GAC7B,IAAI,CACF,gBAAgB,CAAC,UAAU,CAAC,KAAK,EACjC,OAAO,GAAG,aAAa,GAAG,QAAQ,GAAG,MAAM,GAAG,YAAY,CAC3D,qBAuBF;AAED,iBAAS,aAAa,CAAC,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,KAAK,CAAC,cAAc,CAAC,KAAK,CAAC,qBAQ1E;AAED,iBAAS,YAAY,CAAC,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,gBAAgB,CAAC,KAAK,CAAC,KAAK,qBAQ1E;AAED,iBAAS,kBAAkB,CAAC,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,gBAAgB,CAAC,WAAW,CAAC,KAAK,qBAQtF;AAED,OAAO,EAAE,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAE,aAAa,EAAE,YAAY,EAAE,cAAc,EAAE,CAAC"}

package/dist/components/popover.js

@@ -2,6 +2,21 @@ import { jsx as _jsx } from "react/jsx-runtime";
 import { Popover as PopoverPrimitive } from "@base-ui/react/popover";
 import { cn } from "../lib/utils.js";
 import { anchoredOverlayMotion } from "../lib/motion.js";
+/**
+ * A small control set tied to its trigger, on glass.
+ *
+ * @family Menus
+ * @when A small control set tied to its trigger: filters, a scope chooser, a date range, a feedback
+ * form. The page stays live behind it.
+ * @instead For commands use `DropdownMenu`. For a form that adds a record use `FormDialog`. For one
+ * phrase use `Tooltip`; for facts on hover use `HoverCard`.
+ * @behaviour Glass floating surface, 12 px padding and gap. Opens on click, closes on Escape or
+ * outside press, focus returns to the trigger. Applies at once; no Save inside.
+ * @words Title names the control's job (*Filter skills*); an optional one-line description. Options
+ * are nouns.
+ * @access Trigger has a visible name and `aria-expanded`. The popup is a labelled dialog that does
+ * not trap focus; Tab leaves it in order.
+ */
 function Popover({ ...props }) {
     return _jsx(PopoverPrimitive.Root, { "data-slot": "popover", ...props });
 }

package/dist/components/portal-sidebar-frame.d.ts

@@ -1,17 +1,5 @@
 import type { ReactNode } from "react";
 import { type AccountIdentity } from "./account-menu.js";
-/**
- * The Portal's navigation frame, without the Portal's routing: the wordmark and
- * the section name over the collapse control, the Find control with its
- * shortcut, the labelled nav bands, the band that leads out of the Portal, and
- * the account at the foot. Its regions are separated by the 1 px guide over the
- * line colour, as the Portal's own shell separates them, so a sidebar region
- * takes no border of its own.
- *
- * The frame carries geometry and brand imagery only. Every word, icon and
- * active marking arrives as a prop, so the Portal can pass its nav model and
- * the website can pass a sample of it.
- */
 export type PortalSidebarItem = {
     id: string;
     label: string;
@@ -25,6 +13,32 @@ export type PortalSidebarBand = {
     label?: string;
     items: PortalSidebarItem[];
 };
+/**
+ * The Portal's navigation frame, without the Portal's routing: the wordmark and
+ * the section name over the collapse control, the Find control with its
+ * shortcut, the labelled nav bands, the band that leads out of the Portal, and
+ * the account at the foot.
+ *
+ * Its regions are separated by the 1 px guide over the line colour, as the
+ * Portal's own shell separates them, so a sidebar region takes no border of its
+ * own.
+ *
+ * The frame carries geometry and brand imagery only. Every word, icon and
+ * active marking arrives as a prop, so the Portal can pass its nav model and
+ * the website can pass a sample of it.
+ *
+ * @family Navigation
+ * @when `PortalSidebarFrame` is the Portal's whole left column, and the website's sample of it.
+ * @instead Nadia's left column belongs to `DesktopAppShell`. Both draw their rows with the same
+ * `SidebarMenuButton` and end with the same `AccountMenu`; neither paints its own selected fill or
+ * its own account block.
+ * @behaviour Wordmark and product name over the collapse control, then Find, the bands, the way out
+ * (Get Nadia) and the account, split by 1 px guides.
+ * @words Find is one word beside ⌘K. Bands are short nouns; items are nouns, one or two words,
+ * sentence case.
+ * @access The column is a labelled `nav`. Find is a button named with its shortcut. The wordmark is
+ * `role="img"` named nadicode.
+ */
 export declare function PortalSidebarFrame({ account, bands, className, findLabel, footerItem, subtitle, toggleLabel, }: {
     account: AccountIdentity;
     bands: PortalSidebarBand[];

package/dist/components/portal-sidebar-frame.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"portal-sidebar-frame.d.ts","sourceRoot":"","sources":["../../src/components/portal-sidebar-frame.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAGvC,OAAO,EAAuB,KAAK,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAkBtF;;;;;;;;;;;GAWG;AAEH,MAAM,MAAM,iBAAiB,GAAG;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,oEAAoE;IACpE,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,sEAAsE;IACtE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,iBAAiB,EAAE,CAAC;CAC5B,CAAC;AAiBF,wBAAgB,kBAAkB,CAAC,EACjC,OAAO,EACP,KAAK,EACL,SAAS,EACT,SAAS,EACT,UAAU,EACV,QAAQ,EACR,WAAW,GACZ,EAAE;IACD,OAAO,EAAE,eAAe,CAAC;IACzB,KAAK,EAAE,iBAAiB,EAAE,CAAC;IAC3B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,8CAA8C;IAC9C,SAAS,EAAE,MAAM,CAAC;IAClB,qFAAqF;IACrF,UAAU,CAAC,EAAE,iBAAiB,CAAC;IAC/B,oEAAoE;IACpE,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;CACrB,+BAwEA"}
+{"version":3,"file":"portal-sidebar-frame.d.ts","sourceRoot":"","sources":["../../src/components/portal-sidebar-frame.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAGvC,OAAO,EAAuB,KAAK,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAkBtF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,oEAAoE;IACpE,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,sEAAsE;IACtE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,iBAAiB,EAAE,CAAC;CAC5B,CAAC;AAiBF;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,kBAAkB,CAAC,EACjC,OAAO,EACP,KAAK,EACL,SAAS,EACT,SAAS,EACT,UAAU,EACV,QAAQ,EACR,WAAW,GACZ,EAAE;IACD,OAAO,EAAE,eAAe,CAAC;IACzB,KAAK,EAAE,iBAAiB,EAAE,CAAC;IAC3B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,8CAA8C;IAC9C,SAAS,EAAE,MAAM,CAAC;IAClB,qFAAqF;IACrF,UAAU,CAAC,EAAE,iBAAiB,CAAC;IAC/B,oEAAoE;IACpE,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;CACrB,+BAwEA"}

package/dist/components/portal-sidebar-frame.js

@@ -9,6 +9,32 @@ import { cn } from "../lib/utils.js";
 function ItemRow({ item, variant }) {
     return (_jsx(SidebarMenuItem, { children: _jsxs(SidebarMenuButton, { isActive: item.current, tooltip: item.label, ...(variant ? { variant } : {}), children: [item.icon, _jsx("span", { className: "truncate", children: item.label })] }) }));
 }
+/**
+ * The Portal's navigation frame, without the Portal's routing: the wordmark and
+ * the section name over the collapse control, the Find control with its
+ * shortcut, the labelled nav bands, the band that leads out of the Portal, and
+ * the account at the foot.
+ *
+ * Its regions are separated by the 1 px guide over the line colour, as the
+ * Portal's own shell separates them, so a sidebar region takes no border of its
+ * own.
+ *
+ * The frame carries geometry and brand imagery only. Every word, icon and
+ * active marking arrives as a prop, so the Portal can pass its nav model and
+ * the website can pass a sample of it.
+ *
+ * @family Navigation
+ * @when `PortalSidebarFrame` is the Portal's whole left column, and the website's sample of it.
+ * @instead Nadia's left column belongs to `DesktopAppShell`. Both draw their rows with the same
+ * `SidebarMenuButton` and end with the same `AccountMenu`; neither paints its own selected fill or
+ * its own account block.
+ * @behaviour Wordmark and product name over the collapse control, then Find, the bands, the way out
+ * (Get Nadia) and the account, split by 1 px guides.
+ * @words Find is one word beside ⌘K. Bands are short nouns; items are nouns, one or two words,
+ * sentence case.
+ * @access The column is a labelled `nav`. Find is a button named with its shortcut. The wordmark is
+ * `role="img"` named nadicode.
+ */
 export function PortalSidebarFrame({ account, bands, className, findLabel, footerItem, subtitle, toggleLabel, }) {
     return (_jsx(Sidebar, { collapsible: "none", className: cn("h-auto shrink-0", className), children: _jsxs("div", { className: "grid min-h-0 flex-1 grid-rows-[auto_minmax(0,1fr)_auto_auto] bg-border *:min-w-0", children: [_jsxs("div", { className: "grid grid-rows-[3.5rem_auto] gap-px bg-border *:bg-sidebar", children: [_jsxs(SidebarHeader, { className: "h-full flex-row items-center justify-between gap-1 px-3 py-0", children: [_jsxs("div", { className: "grid min-w-0 flex-1 gap-0", children: [_jsx(BrandWordmark, { alt: "", className: "h-5 w-28 max-w-full" }), _jsx("span", { className: "truncate text-xs text-muted-foreground", children: subtitle })] }), _jsx(SidebarTrigger, { "aria-label": toggleLabel, className: "shrink-0" })] }), _jsx("div", { className: "p-2", children: _jsx(SidebarMenu, { children: _jsx(SidebarMenuItem, { children: _jsxs(SidebarMenuButton, { variant: "outline", children: [_jsx(Search, { "aria-hidden": "true", className: "text-muted-foreground" }), _jsx("span", { className: "min-w-0 flex-1 truncate text-left text-muted-foreground", children: findLabel }), _jsxs(KbdGroup, { className: "ml-auto", children: [_jsx(Kbd, { children: "\u2318" }), _jsx(Kbd, { children: "K" })] })] }) }) }) })] }), _jsx(SidebarContent, { className: "bg-sidebar", children: bands.map((band) => (_jsxs(SidebarGroup, { children: [band.label ? (_jsx(SidebarGroupLabel, { render: _jsx("h2", {}), children: band.label })) : null, _jsx(SidebarGroupContent, { children: _jsx(SidebarMenu, { children: band.items.map((item) => (_jsx(ItemRow, { item: item }, item.id))) }) })] }, band.id))) }), footerItem ? (_jsx(SidebarGroup, { className: "border-t bg-sidebar", children: _jsx(SidebarGroupContent, { children: _jsx(SidebarMenu, { children: _jsx(ItemRow, { item: footerItem, variant: "outline" }) }) }) })) : null, _jsx(SidebarFooter, { className: "border-t bg-sidebar", children: _jsx(SidebarMenu, { children: _jsx(SidebarMenuItem, { children: _jsxs(SidebarMenuButton, { size: "lg", children: [_jsx(AccountMenuIdentity, { className: "flex-1", identity: account }), _jsx(ChevronsUpDown, { "aria-hidden": "true", className: "ml-auto size-4 text-muted-foreground" })] }) }) }) })] }) }));
 }

package/dist/components/product-message.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"product-message.d.ts","sourceRoot":"","sources":["../../src/components/product-message.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAElD;;;;GAIG;AACH,MAAM,MAAM,aAAa,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,CAAC,CAAC;AAEtE,MAAM,MAAM,cAAc,CAAC,IAAI,SAAS,MAAM,GAAG,MAAM,IAAI;IACzD,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC;IACpB,QAAQ,CAAC,MAAM,CAAC,EAAE,aAAa,CAAC;IAChC,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC9B,CAAC;AAEF,wDAAwD;AACxD,MAAM,MAAM,aAAa,GAAG,WAAW,CAAC;AAExC,OAAO,CAAC,MAAM,MAAM,EAAE,OAAO,MAAM,CAAC;AAEpC,uGAAuG;AACvG,MAAM,MAAM,eAAe,GAAG;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,SAAS,aAAa,EAAE,CAAC;IAC3C,QAAQ,CAAC,CAAC,MAAM,CAAC,EAAE,IAAI,CAAC;CACzB,CAAC;AAEF,wBAAgB,WAAW,CAAC,KAAK,EAAE;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,SAAS,aAAa,EAAE,CAAC;CACpC,GAAG,eAAe,CAElB;AAED,qEAAqE;AACrE,wBAAgB,eAAe,CAAC,OAAO,EAAE,eAAe,GAAG,MAAM,GAAG,IAAI,CAGvE;AAID,4GAA4G;AAC5G,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,eAAe,GAAG,MAAM,CAKjE"}
+{"version":3,"file":"product-message.d.ts","sourceRoot":"","sources":["../../src/components/product-message.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAElD;;;;GAIG;AACH,MAAM,MAAM,aAAa,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,CAAC,CAAC;AAEtE,MAAM,MAAM,cAAc,CAAC,IAAI,SAAS,MAAM,GAAG,MAAM,IAAI;IACzD,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC;IACpB,QAAQ,CAAC,MAAM,CAAC,EAAE,aAAa,CAAC;IAChC,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC9B,CAAC;AAEF,wDAAwD;AACxD,MAAM,MAAM,aAAa,GAAG,WAAW,CAAC;AAExC,OAAO,CAAC,MAAM,MAAM,EAAE,OAAO,MAAM,CAAC;AAEpC,uGAAuG;AACvG,MAAM,MAAM,eAAe,GAAG;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,SAAS,aAAa,EAAE,CAAC;IAC3C,QAAQ,CAAC,CAAC,MAAM,CAAC,EAAE,IAAI,CAAC;CACzB,CAAC;AAEF,wBAAgB,WAAW,CAAC,KAAK,EAAE;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,SAAS,aAAa,EAAE,CAAC;CACpC,GAAG,eAAe,CAGlB;AAED,qEAAqE;AACrE,wBAAgB,eAAe,CAAC,OAAO,EAAE,eAAe,GAAG,MAAM,GAAG,IAAI,CAGvE;AAID,4GAA4G;AAC5G,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,eAAe,GAAG,MAAM,CAKjE"}

package/dist/components/product-message.js

@@ -1,4 +1,5 @@
 export function wordMessage(parts) {
+    // SAFETY: the `worded` brand has no runtime value; this function is the only place that mints it, which is the guarantee ResolvedMessage carries, and the fields are the parts given.
     return { ...parts, actions: parts.actions ?? [] };
 }
 /** The body a surface shows: none when it would repeat the title. */

package/dist/components/progress.d.ts

@@ -1,17 +1,19 @@
 import { Progress as ProgressPrimitive } from "@base-ui/react/progress";
 import { type VariantProps } from "class-variance-authority";
-/**
- * The measured bar. Stock shadcn `progress` plus one variant: a product-owned
- * `tone`, because the meters this replaces (usage against an included
- * allowance) have to say whether a full bar is fine or a problem. Tone is a
- * consumer decision, never derived from the measurement. A value past `max`
- * fills the track and takes the over-cap paint, which is the bar saying the
- * allowance is spent — not a second segment.
- */
 declare const progressIndicatorVariants: (props?: ({
     tone?: "default" | "warning" | "critical" | null | undefined;
 } & import("class-variance-authority/types").ClassProp) | undefined) => string;
 type ProgressTone = NonNullable<VariantProps<typeof progressIndicatorVariants>["tone"]>;
+/**
+ * A known amount against a real maximum, with its label and value.
+ *
+ * @family Data
+ * @when A known amount against a real maximum, with its label and value: included runs used against the plan's allowance.
+ * @instead An unknown wait is the waiting line, never a bar with an invented percentage. A run's consumption in a dense spot is a `UsageMeter`. A single figure is a `KpiCard`.
+ * @behaviour A 4 px track in the `line` colour. The fill moves only when the reading changes, on `open`; still under reduced motion. `tone` is the product's threshold, never derived from the value. Past the maximum the bar fills and turns red, whatever the tone.
+ * @words Print the work and its unit in `ProgressValue`: "620 of 1,000".
+ * @access A `progressbar` named by its `ProgressLabel` or `aria-label`, with its value.
+ */
 declare function Progress({ className, children, value, min, max, tone, indicatorColor, ...props }: ProgressPrimitive.Root.Props & {
     tone?: ProgressTone;
     indicatorColor?: string;

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

@@ -1 +1 @@
-{"version":3,"file":"progress.d.ts","sourceRoot":"","sources":["../../src/components/progress.tsx"],"names":[],"mappings":"AAEA,OAAO,EAAE,QAAQ,IAAI,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AACxE,OAAO,EAAO,KAAK,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAKlE;;;;;;;GAOG;AAEH,QAAA,MAAM,yBAAyB;;8EAc9B,CAAC;AAEF,KAAK,YAAY,GAAG,WAAW,CAAC,YAAY,CAAC,OAAO,yBAAyB,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC;AAiBxF,iBAAS,QAAQ,CAAC,EAChB,SAAS,EACT,QAAQ,EACR,KAAK,EACL,GAAO,EACP,GAAS,EACT,IAAgB,EAChB,cAAc,EACd,GAAG,KAAK,EACT,EAAE,iBAAiB,CAAC,IAAI,CAAC,KAAK,GAAG;IAAE,IAAI,CAAC,EAAE,YAAY,CAAC;IAAC,cAAc,CAAC,EAAE,MAAM,CAAA;CAAE,+BAwBjF;AAED,iBAAS,aAAa,CAAC,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,iBAAiB,CAAC,KAAK,CAAC,KAAK,+BAW5E;AAED,iBAAS,iBAAiB,CAAC,EAAE,SAAS,EAAE,KAAK,EAAE,GAAG,KAAK,EAAE,EAAE,iBAAiB,CAAC,SAAS,CAAC,KAAK,+BAmC3F;AAED,iBAAS,aAAa,CAAC,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,iBAAiB,CAAC,KAAK,CAAC,KAAK,+BAQ5E;AAED,iBAAS,aAAa,CAAC,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,iBAAiB,CAAC,KAAK,CAAC,KAAK,+BAQ5E;AAED,OAAO,EACL,QAAQ,EACR,aAAa,EACb,iBAAiB,EACjB,aAAa,EACb,aAAa,EACb,yBAAyB,GAC1B,CAAC;AACF,YAAY,EAAE,YAAY,EAAE,CAAC"}
+{"version":3,"file":"progress.d.ts","sourceRoot":"","sources":["../../src/components/progress.tsx"],"names":[],"mappings":"AAEA,OAAO,EAAE,QAAQ,IAAI,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AACxE,OAAO,EAAO,KAAK,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAKlE,QAAA,MAAM,yBAAyB;;8EAc9B,CAAC;AAEF,KAAK,YAAY,GAAG,WAAW,CAAC,YAAY,CAAC,OAAO,yBAAyB,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC;AAiBxF;;;;;;;;;GASG;AACH,iBAAS,QAAQ,CAAC,EAChB,SAAS,EACT,QAAQ,EACR,KAAK,EACL,GAAO,EACP,GAAS,EACT,IAAgB,EAChB,cAAc,EACd,GAAG,KAAK,EACT,EAAE,iBAAiB,CAAC,IAAI,CAAC,KAAK,GAAG;IAAE,IAAI,CAAC,EAAE,YAAY,CAAC;IAAC,cAAc,CAAC,EAAE,MAAM,CAAA;CAAE,+BAwBjF;AAED,iBAAS,aAAa,CAAC,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,iBAAiB,CAAC,KAAK,CAAC,KAAK,+BAW5E;AAOD,iBAAS,iBAAiB,CAAC,EAAE,SAAS,EAAE,KAAK,EAAE,GAAG,KAAK,EAAE,EAAE,iBAAiB,CAAC,SAAS,CAAC,KAAK,+BA8B3F;AAED,iBAAS,aAAa,CAAC,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,iBAAiB,CAAC,KAAK,CAAC,KAAK,+BAQ5E;AAED,iBAAS,aAAa,CAAC,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,iBAAiB,CAAC,KAAK,CAAC,KAAK,+BAQ5E;AAED,OAAO,EACL,QAAQ,EACR,aAAa,EACb,iBAAiB,EACjB,aAAa,EACb,aAAa,EACb,yBAAyB,GAC1B,CAAC;AACF,YAAY,EAAE,YAAY,EAAE,CAAC"}

package/dist/components/progress.js

@@ -4,14 +4,6 @@ import { Progress as ProgressPrimitive } from "@base-ui/react/progress";
 import { cva } from "class-variance-authority";
 import { createContext, useContext } from "react";
 import { cn } from "../lib/utils.js";
-/**
- * The measured bar. Stock shadcn `progress` plus one variant: a product-owned
- * `tone`, because the meters this replaces (usage against an included
- * allowance) have to say whether a full bar is fine or a problem. Tone is a
- * consumer decision, never derived from the measurement. A value past `max`
- * fills the track and takes the over-cap paint, which is the bar saying the
- * allowance is spent — not a second segment.
- */
 const progressIndicatorVariants = cva("h-full origin-left scale-x-[var(--progress-scale)] transition-transform duration-[var(--nc-duration-open)] ease-[var(--nc-ease-out-strong)] motion-reduce:transition-none rtl:origin-right", {
     variants: {
         tone: {
@@ -30,25 +22,34 @@ const ProgressStateContext = createContext({
     tone: "default",
     overCap: false,
 });
+/**
+ * A known amount against a real maximum, with its label and value.
+ *
+ * @family Data
+ * @when A known amount against a real maximum, with its label and value: included runs used against the plan's allowance.
+ * @instead An unknown wait is the waiting line, never a bar with an invented percentage. A run's consumption in a dense spot is a `UsageMeter`. A single figure is a `KpiCard`.
+ * @behaviour A 4 px track in the `line` colour. The fill moves only when the reading changes, on `open`; still under reduced motion. `tone` is the product's threshold, never derived from the value. Past the maximum the bar fills and turns red, whatever the tone.
+ * @words Print the work and its unit in `ProgressValue`: "620 of 1,000".
+ * @access A `progressbar` named by its `ProgressLabel` or `aria-label`, with its value.
+ */
 function Progress({ className, children, value, min = 0, max = 100, tone = "default", indicatorColor, ...props }) {
-    const measured = typeof value === "number" && Number.isFinite(value);
+    const measured = value !== null && Number.isFinite(value);
     const scale = measured && max > min ? Math.min(1, Math.max(0, (value - min) / (max - min))) : 0;
     const overCap = measured && value > max;
     return (_jsx(ProgressPrimitive.Root, { value: value, min: min, max: max, "data-slot": "progress", "data-tone": tone, "data-over-cap": overCap || undefined, className: cn("flex flex-wrap gap-3", className), ...props, children: _jsxs(ProgressStateContext.Provider, { value: { scale, tone, overCap, indicatorColor }, children: [children, _jsx(ProgressTrack, { children: _jsx(ProgressIndicator, {}) })] }) }));
 }
 function ProgressTrack({ className, ...props }) {
-    return (_jsx(ProgressPrimitive.Track, { className: cn("relative flex h-1 w-full items-center overflow-x-hidden rounded-full bg-muted", className), "data-slot": "progress-track", ...props }));
+    return (_jsx(ProgressPrimitive.Track, { className: cn("relative flex h-1 w-full items-center overflow-x-hidden rounded-full bg-border", className), "data-slot": "progress-track", ...props }));
 }
 function ProgressIndicator({ className, style, ...props }) {
     const { scale, tone, overCap, indicatorColor } = useContext(ProgressStateContext);
     const indicatorStyle = (state) => {
+        // oxlint-disable-next-line anti-slop/no-runtime-typeof -- Base UI's style prop is a CSSProperties | (state => CSSProperties) union, told apart only by typeof.
         const resolvedStyle = typeof style === "function" ? style(state) : style;
-        return {
-            width: "100%",
-            "--progress-scale": scale,
-            ...(indicatorColor ? { "--progress-indicator-color": indicatorColor } : {}),
-            ...resolvedStyle,
-        };
+        const base = { width: "100%", "--progress-scale": scale };
+        if (indicatorColor)
+            base["--progress-indicator-color"] = indicatorColor;
+        return { ...base, ...resolvedStyle };
     };
     return (_jsx(ProgressPrimitive.Indicator, { "data-slot": "progress-indicator", "data-tone": overCap ? "over-cap" : tone, "data-over-cap": overCap || undefined, className: cn(progressIndicatorVariants({ tone }), indicatorColor && "bg-(--progress-indicator-color)", 
         // After the variant, so the merge keeps this one paint: an allowance

package/dist/components/qr-code.d.ts

@@ -1,7 +1,13 @@
 /**
- * A link drawn as a QR code another device can scan: square dark modules on a
- * white tile in every theme, because readers expect dark on light. `label`
- * names what the code opens; the code itself is the image.
+ * A link drawn as a QR code another device can scan.
+ *
+ * @family Data
+ * @when Opening something on a phone from a screen: a mobile sign-in, a download link.
+ * @instead Two screens compared by eye is `PairingCode`. A link a person clicks is a link.
+ * @behaviour Square dark modules on a white tile in every theme, with the quiet zone a reader
+ * needs.
+ * @words The label names what the code opens: *Open Nadia on your phone*.
+ * @access `role="img"` named by `label`.
  */
 declare function QrCode({ value, label, size, className, }: {
     value: string;

package/dist/components/qr-code.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"qr-code.d.ts","sourceRoot":"","sources":["../../src/components/qr-code.tsx"],"names":[],"mappings":"AAQA;;;;GAIG;AACH,iBAAS,MAAM,CAAC,EACd,KAAK,EACL,KAAK,EACL,IAAI,EACJ,SAAS,GACV,EAAE;IACD,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,iDAAiD;IACjD,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,+BA0BA;AAED,OAAO,EAAE,MAAM,EAAE,CAAC"}
+{"version":3,"file":"qr-code.d.ts","sourceRoot":"","sources":["../../src/components/qr-code.tsx"],"names":[],"mappings":"AAQA;;;;;;;;;;GAUG;AACH,iBAAS,MAAM,CAAC,EACd,KAAK,EACL,KAAK,EACL,IAAI,EACJ,SAAS,GACV,EAAE;IACD,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,iDAAiD;IACjD,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,+BA0BA;AAED,OAAO,EAAE,MAAM,EAAE,CAAC"}

package/dist/components/qr-code.js

@@ -5,9 +5,15 @@ import { cn } from "../lib/utils.js";
 /** The blank border a reader needs around the code, in modules. */
 const QUIET_ZONE = 4;
 /**
- * A link drawn as a QR code another device can scan: square dark modules on a
- * white tile in every theme, because readers expect dark on light. `label`
- * names what the code opens; the code itself is the image.
+ * A link drawn as a QR code another device can scan.
+ *
+ * @family Data
+ * @when Opening something on a phone from a screen: a mobile sign-in, a download link.
+ * @instead Two screens compared by eye is `PairingCode`. A link a person clicks is a link.
+ * @behaviour Square dark modules on a white tile in every theme, with the quiet zone a reader
+ * needs.
+ * @words The label names what the code opens: *Open Nadia on your phone*.
+ * @access `role="img"` named by `label`.
  */
 function QrCode({ value, label, size, className, }) {
     const { box, path } = useMemo(() => {

package/dist/components/radio-group.d.ts

@@ -1,5 +1,20 @@
 import { Radio as RadioPrimitive } from "@base-ui/react/radio";
 import { RadioGroup as RadioGroupPrimitive } from "@base-ui/react/radio-group";
+/**
+ * One option of a few, all shown at once.
+ *
+ * @family Choices
+ * @when One of 2 to 6 options that exclude each other, all shown at once.
+ * @instead Options that each need a sentence are choice tiles. Seven or more is a `Select`; a list
+ * to search is a `Combobox`. Another view of the same thing is `Tabs`.
+ * @behaviour One tab stop for the group; the arrows move and choose. The chosen circle fills with
+ * ink and a white 8 px dot. Preselect the safe option when there is one; leave a consequential
+ * choice empty until the person makes it.
+ * @words Options are parallel phrases in sentence case with no end punctuation: *Only me*,
+ * *Everyone in the company*. The legend names the setting; it does not ask a question.
+ * @access `role="radiogroup"` named by its legend, each radio by its label. A disabled option shows
+ * why in its own help line.
+ */
 declare function RadioGroup({ className, ...props }: RadioGroupPrimitive.Props): import("react").JSX.Element;
 declare function RadioGroupItem({ children, className, ...props }: RadioPrimitive.Root.Props): import("react").JSX.Element;
 export { RadioGroup, RadioGroupItem };

package/dist/components/radio-group.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"radio-group.d.ts","sourceRoot":"","sources":["../../src/components/radio-group.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,IAAI,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC/D,OAAO,EAAE,UAAU,IAAI,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAI/E,iBAAS,UAAU,CAAC,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,mBAAmB,CAAC,KAAK,+BAQrE;AAED,iBAAS,cAAc,CAAC,EAAE,QAAQ,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,cAAc,CAAC,IAAI,CAAC,KAAK,+BAoBnF;AAED,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,CAAC"}
+{"version":3,"file":"radio-group.d.ts","sourceRoot":"","sources":["../../src/components/radio-group.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,IAAI,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC/D,OAAO,EAAE,UAAU,IAAI,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAI/E;;;;;;;;;;;;;;GAcG;AACH,iBAAS,UAAU,CAAC,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,mBAAmB,CAAC,KAAK,+BAQrE;AAED,iBAAS,cAAc,CAAC,EAAE,QAAQ,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,cAAc,CAAC,IAAI,CAAC,KAAK,+BAoBnF;AAED,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,CAAC"}

package/dist/components/radio-group.js

@@ -2,6 +2,21 @@ import { jsx as _jsx } from "react/jsx-runtime";
 import { Radio as RadioPrimitive } from "@base-ui/react/radio";
 import { RadioGroup as RadioGroupPrimitive } from "@base-ui/react/radio-group";
 import { cn } from "../lib/utils.js";
+/**
+ * One option of a few, all shown at once.
+ *
+ * @family Choices
+ * @when One of 2 to 6 options that exclude each other, all shown at once.
+ * @instead Options that each need a sentence are choice tiles. Seven or more is a `Select`; a list
+ * to search is a `Combobox`. Another view of the same thing is `Tabs`.
+ * @behaviour One tab stop for the group; the arrows move and choose. The chosen circle fills with
+ * ink and a white 8 px dot. Preselect the safe option when there is one; leave a consequential
+ * choice empty until the person makes it.
+ * @words Options are parallel phrases in sentence case with no end punctuation: *Only me*,
+ * *Everyone in the company*. The legend names the setting; it does not ask a question.
+ * @access `role="radiogroup"` named by its legend, each radio by its label. A disabled option shows
+ * why in its own help line.
+ */
 function RadioGroup({ className, ...props }) {
     return (_jsx(RadioGroupPrimitive, { "data-slot": "radio-group", className: cn("grid w-full gap-2", className), ...props }));
 }

package/dist/components/reading-column.d.ts

@@ -1,5 +1,16 @@
 import * as React from "react";
 export type ReadingColumnWidth = "full" | "reading" | "configuration";
+/**
+ * The column a page's content stands in: full, reading or configuration width.
+ *
+ * @family Other
+ * @when Setting a page's measure: `reading` for prose and conversations, `configuration` for
+ * settings, `full` for collections.
+ * @instead A settings page's column is `SettingsPage`'s. A card row is `CardRow`.
+ * @behaviour Centred with a maximum width per kind; full takes the content's width.
+ * @words None of its own.
+ * @access A layout container.
+ */
 declare function ReadingColumn({ width, className, ...props }: React.ComponentProps<"div"> & {
     width?: ReadingColumnWidth;
 }): React.JSX.Element;

package/dist/components/reading-column.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"reading-column.d.ts","sourceRoot":"","sources":["../../src/components/reading-column.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAI/B,MAAM,MAAM,kBAAkB,GAAG,MAAM,GAAG,SAAS,GAAG,eAAe,CAAC;AAEtE,iBAAS,aAAa,CAAC,EACrB,KAAiB,EACjB,SAAS,EACT,GAAG,KAAK,EACT,EAAE,KAAK,CAAC,cAAc,CAAC,KAAK,CAAC,GAAG;IAAE,KAAK,CAAC,EAAE,kBAAkB,CAAA;CAAE,qBAc9D;AAED,OAAO,EAAE,aAAa,EAAE,CAAC"}
+{"version":3,"file":"reading-column.d.ts","sourceRoot":"","sources":["../../src/components/reading-column.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAI/B,MAAM,MAAM,kBAAkB,GAAG,MAAM,GAAG,SAAS,GAAG,eAAe,CAAC;AAEtE;;;;;;;;;;GAUG;AACH,iBAAS,aAAa,CAAC,EACrB,KAAiB,EACjB,SAAS,EACT,GAAG,KAAK,EACT,EAAE,KAAK,CAAC,cAAc,CAAC,KAAK,CAAC,GAAG;IAAE,KAAK,CAAC,EAAE,kBAAkB,CAAA;CAAE,qBAc9D;AAED,OAAO,EAAE,aAAa,EAAE,CAAC"}