@nadicodeai/ui 12.1.95 → 12.1.97

package/dist/components/status-dot.js

@@ -6,6 +6,18 @@ const TONE_BG_CLASS = {
     warn: "bg-warning",
     bad: "bg-destructive",
 };
+/**
+ * A small still dot beside a word that already names the state.
+ *
+ * @family Status
+ * @when A small mark in dense chrome, beside a word that already names the state: a channel, a
+ * machine in a list.
+ * @instead A status that stands alone is a `StatusBadge`. Something in motion is the waiting line
+ * or an Agent's orb; the dot has no info tone.
+ * @behaviour Still; never pulses. Tones are `good`, `muted`, `warn`, `bad`, at full strength.
+ * @words None of its own. The word beside it says the state.
+ * @access Always `aria-hidden`. If the word is missing, the state is missing.
+ */
 function StatusDot({ className, tone, ...props }) {
     return (_jsx("span", { "aria-hidden": "true", className: cn("inline-block size-1.5 rounded-full", TONE_BG_CLASS[tone], className), "data-slot": "status-dot", "data-tone": tone, ...props }));
 }

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

@@ -5,6 +5,20 @@ interface StatusRowProps extends Omit<React.ComponentProps<"div">, "onClick" | "
     trailing?: ReactNode;
     trailingVisible?: boolean;
 }
+/**
+ * One line of a status panel: a mark, what it is, and controls that show on hover.
+ *
+ * @family Data
+ * @when Lines inside a side panel that report what is running or connected, grouped under a
+ * collapsible `StatusSection`.
+ * @instead A collection's row is `RecordList`'s. A row with a sentence and actions is `Item`.
+ * @behaviour When `onActivate` is given the whole row is one button that takes the accent hover;
+ * the trailing controls show on hover or focus unless `trailingVisible`. A `StatusSection` starts
+ * collapsed.
+ * @words The row names the thing; the section's label is a plural noun.
+ * @access An activatable row is `role="button"`, reached by Tab and run by Enter or Space. The
+ * section's toggle exposes `aria-expanded`.
+ */
 declare function StatusRow({ children, className, leading, onActivate, trailing, trailingVisible, ...props }: StatusRowProps): import("react").JSX.Element;
 interface StatusSectionProps {
     accessory?: ReactNode;

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

@@ -1 +1 @@
-{"version":3,"file":"status-row.d.ts","sourceRoot":"","sources":["../../src/components/status-row.tsx"],"names":[],"mappings":"AAEA,OAAO,EAAY,KAAK,aAAa,EAAE,KAAK,UAAU,EAAE,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAKtF,UAAU,cAAe,SAAQ,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,KAAK,CAAC,EAAE,SAAS,GAAG,WAAW,CAAC;IACzF,OAAO,CAAC,EAAE,SAAS,CAAC;IACpB,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,aAAa,GAAG,UAAU,KAAK,IAAI,CAAC;IACzD,QAAQ,CAAC,EAAE,SAAS,CAAC;IACrB,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED,iBAAS,SAAS,CAAC,EACjB,QAAQ,EACR,SAAS,EACT,OAAO,EACP,UAAU,EACV,QAAQ,EACR,eAAuB,EACvB,GAAG,KAAK,EACT,EAAE,cAAc,+BAyChB;AAED,UAAU,kBAAkB;IAC1B,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,QAAQ,EAAE,SAAS,CAAC;IACpB,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,KAAK,EAAE,SAAS,CAAC;CAClB;AAED,iBAAS,aAAa,CAAC,EACrB,SAAS,EACT,QAAQ,EACR,gBAAuB,EACvB,IAAI,EACJ,KAAK,GACN,EAAE,kBAAkB,+BAwBpB;AAED,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,CAAC"}
+{"version":3,"file":"status-row.d.ts","sourceRoot":"","sources":["../../src/components/status-row.tsx"],"names":[],"mappings":"AAEA,OAAO,EAAY,KAAK,aAAa,EAAE,KAAK,UAAU,EAAE,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAKtF,UAAU,cAAe,SAAQ,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,KAAK,CAAC,EAAE,SAAS,GAAG,WAAW,CAAC;IACzF,OAAO,CAAC,EAAE,SAAS,CAAC;IACpB,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,aAAa,GAAG,UAAU,KAAK,IAAI,CAAC;IACzD,QAAQ,CAAC,EAAE,SAAS,CAAC;IACrB,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED;;;;;;;;;;;;;GAaG;AACH,iBAAS,SAAS,CAAC,EACjB,QAAQ,EACR,SAAS,EACT,OAAO,EACP,UAAU,EACV,QAAQ,EACR,eAAuB,EACvB,GAAG,KAAK,EACT,EAAE,cAAc,+BAyChB;AAED,UAAU,kBAAkB;IAC1B,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,QAAQ,EAAE,SAAS,CAAC;IACpB,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,KAAK,EAAE,SAAS,CAAC;CAClB;AAED,iBAAS,aAAa,CAAC,EACrB,SAAS,EACT,QAAQ,EACR,gBAAuB,EACvB,IAAI,EACJ,KAAK,GACN,EAAE,kBAAkB,+BAwBpB;AAED,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,CAAC"}

package/dist/components/status-row.js

@@ -3,6 +3,20 @@ import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { useState } from "react";
 import { ChevronRightIcon } from "lucide-react";
 import { cn } from "../lib/utils.js";
+/**
+ * One line of a status panel: a mark, what it is, and controls that show on hover.
+ *
+ * @family Data
+ * @when Lines inside a side panel that report what is running or connected, grouped under a
+ * collapsible `StatusSection`.
+ * @instead A collection's row is `RecordList`'s. A row with a sentence and actions is `Item`.
+ * @behaviour When `onActivate` is given the whole row is one button that takes the accent hover;
+ * the trailing controls show on hover or focus unless `trailingVisible`. A `StatusSection` starts
+ * collapsed.
+ * @words The row names the thing; the section's label is a plural noun.
+ * @access An activatable row is `role="button"`, reached by Tab and run by Enter or Space. The
+ * section's toggle exposes `aria-expanded`.
+ */
 function StatusRow({ children, className, leading, onActivate, trailing, trailingVisible = false, ...props }) {
     return (_jsxs("div", { className: cn("group/status-row flex min-h-6 items-center gap-2 rounded-sm px-1.5 py-1", onActivate && "cursor-pointer hover:bg-accent", className), "data-slot": "status-row", onClick: onActivate, onKeyDown: onActivate
             ? (event) => {

package/dist/components/switch.d.ts

@@ -1,4 +1,19 @@
 import { Switch as SwitchPrimitive } from "@base-ui/react/switch";
+/**
+ * A setting that is on or off.
+ *
+ * @family Choices
+ * @when A setting that is either on or off, inside a settings section that saves.
+ * @instead Choosing or agreeing to something is a `Checkbox`. A tool button that stays pressed is a
+ * `Toggle`. Choosing between named values is a `RadioGroup`.
+ * @behaviour Off is the input grey, on is ink; the thumb travels 16 px. Space flips it. On a
+ * settings page the change waits for the section's Save, which lights up; only Theme and Language
+ * in the account menu apply at once. A failed save leaves the switch showing the true state.
+ * @words The label names what on means: *Approvals*, with help saying when. Never *Enable
+ * approvals*, and no On/Off text beside the switch.
+ * @access `role="switch"` with `aria-checked`. The name is the visible label and stays the same in
+ * both states. `sm` only inside a dense row.
+ */
 declare function Switch({ className, size, ...props }: SwitchPrimitive.Root.Props & {
     size?: "sm" | "default";
 }): import("react").JSX.Element;

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

@@ -1 +1 @@
-{"version":3,"file":"switch.d.ts","sourceRoot":"","sources":["../../src/components/switch.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,IAAI,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAIlE,iBAAS,MAAM,CAAC,EACd,SAAS,EACT,IAAgB,EAChB,GAAG,KAAK,EACT,EAAE,eAAe,CAAC,IAAI,CAAC,KAAK,GAAG;IAC9B,IAAI,CAAC,EAAE,IAAI,GAAG,SAAS,CAAC;CACzB,+BAiBA;AAED,OAAO,EAAE,MAAM,EAAE,CAAC"}
+{"version":3,"file":"switch.d.ts","sourceRoot":"","sources":["../../src/components/switch.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,IAAI,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAIlE;;;;;;;;;;;;;;GAcG;AACH,iBAAS,MAAM,CAAC,EACd,SAAS,EACT,IAAgB,EAChB,GAAG,KAAK,EACT,EAAE,eAAe,CAAC,IAAI,CAAC,KAAK,GAAG;IAC9B,IAAI,CAAC,EAAE,IAAI,GAAG,SAAS,CAAC;CACzB,+BAiBA;AAED,OAAO,EAAE,MAAM,EAAE,CAAC"}

package/dist/components/switch.js

@@ -1,6 +1,21 @@
 import { jsx as _jsx } from "react/jsx-runtime";
 import { Switch as SwitchPrimitive } from "@base-ui/react/switch";
 import { cn } from "../lib/utils.js";
+/**
+ * A setting that is on or off.
+ *
+ * @family Choices
+ * @when A setting that is either on or off, inside a settings section that saves.
+ * @instead Choosing or agreeing to something is a `Checkbox`. A tool button that stays pressed is a
+ * `Toggle`. Choosing between named values is a `RadioGroup`.
+ * @behaviour Off is the input grey, on is ink; the thumb travels 16 px. Space flips it. On a
+ * settings page the change waits for the section's Save, which lights up; only Theme and Language
+ * in the account menu apply at once. A failed save leaves the switch showing the true state.
+ * @words The label names what on means: *Approvals*, with help saying when. Never *Enable
+ * approvals*, and no On/Off text beside the switch.
+ * @access `role="switch"` with `aria-checked`. The name is the visible label and stays the same in
+ * both states. `sm` only inside a dense row.
+ */
 function Switch({ className, size = "default", ...props }) {
     return (_jsx(SwitchPrimitive.Root, { "data-slot": "switch", "data-size": size, className: cn("nc-transition-paint peer group/switch relative inline-flex shrink-0 items-center rounded-full border border-transparent p-px after:absolute after:top-1/2 after:left-1/2 after:size-touch-target after:-translate-x-1/2 after:-translate-y-1/2 aria-invalid:border-destructive data-[size=default]:h-5 data-[size=default]:w-9 data-[size=sm]:h-4 data-[size=sm]:w-7 data-checked:bg-primary data-unchecked:bg-input data-disabled:cursor-not-allowed data-disabled:opacity-50 [@media(hover:hover)_and_(pointer:fine)]:after:hidden", className), ...props, children: _jsx(SwitchPrimitive.Thumb, { "data-slot": "switch-thumb", className: "nc-transition-transform pointer-events-none block rounded-full bg-background ring-0 group-data-[size=default]/switch:size-4 group-data-[size=sm]/switch:size-3 group-data-[size=default]/switch:data-checked:translate-x-full group-data-[size=sm]/switch:data-checked:translate-x-full group-data-[size=default]/switch:data-unchecked:translate-x-0 group-data-[size=sm]/switch:data-unchecked:translate-x-0" }) }));
 }

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

@@ -2,9 +2,22 @@ import * as React from "react";
 import { type CardSurface } from "./card.js";
 /**
  * The frame a collection's table sits in: a heading, the collection's own
- * toolbar under it, the table, a labelled total, and the recessed footer
- * strip. The Portal's DataTable and Nadia's record sections draw this one
- * frame, so a registry card ends the same way in both products.
+ * toolbar under it, the table, a labelled total, and the recessed footer strip.
+ *
+ * The Portal's DataTable and Nadia's record sections draw this one frame, so a
+ * registry card ends the same way in both products.
+ *
+ * @family Data
+ * @when A table of records in a card: its heading, its own toolbar, the table, a labelled total and
+ * the recessed footer strip.
+ * @instead An entity collection that is the page's whole job is `CollectionPage`. A chart is
+ * `ChartCard`. One object's facts are `SettingsFactsSection`.
+ * @behaviour The heading, the toolbar and a separator come first when given; the summary row is a
+ * labelled total under the table; the footer strip holds the hint on the left and the count or
+ * paging on the right.
+ * @words The title names the collection. The footer is a count or the paging; the summary is a
+ * labelled total. Never a help sentence in the footer.
+ * @access A `section` whose title is an `h2`; the summary is a `dl`.
  */
 declare function TableCard({ title, description, actions, toolbar, summary, footer, footerHint, children, className, surface, ...props }: Omit<React.ComponentProps<"section">, "title"> & {
     title?: React.ReactNode;

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

@@ -1 +1 @@
-{"version":3,"file":"table-card.d.ts","sourceRoot":"","sources":["../../src/components/table-card.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAI/B,OAAO,EAA4D,KAAK,WAAW,EAAE,MAAM,QAAQ,CAAC;AAGpG;;;;;GAKG;AACH,iBAAS,SAAS,CAAC,EACjB,KAAK,EACL,WAAW,EACX,OAAO,EACP,OAAO,EACP,OAAO,EACP,MAAM,EACN,UAAU,EACV,QAAQ,EACR,SAAS,EACT,OAAmB,EACnB,GAAG,KAAK,EACT,EAAE,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC,GAAG;IAClD,KAAK,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IACxB,WAAW,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC9B,OAAO,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B,2FAA2F;IAC3F,OAAO,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B,wCAAwC;IACxC,OAAO,CAAC,EAAE;QAAE,KAAK,EAAE,KAAK,CAAC,SAAS,CAAC;QAAC,KAAK,EAAE,KAAK,CAAC,SAAS,CAAA;KAAE,CAAC;IAC7D,MAAM,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IACzB,UAAU,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC7B,OAAO,CAAC,EAAE,WAAW,CAAC;CACvB,qBA8CA;AAED,OAAO,EAAE,SAAS,EAAE,CAAC"}
+{"version":3,"file":"table-card.d.ts","sourceRoot":"","sources":["../../src/components/table-card.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAI/B,OAAO,EAA4D,KAAK,WAAW,EAAE,MAAM,QAAQ,CAAC;AAGpG;;;;;;;;;;;;;;;;;;GAkBG;AACH,iBAAS,SAAS,CAAC,EACjB,KAAK,EACL,WAAW,EACX,OAAO,EACP,OAAO,EACP,OAAO,EACP,MAAM,EACN,UAAU,EACV,QAAQ,EACR,SAAS,EACT,OAAmB,EACnB,GAAG,KAAK,EACT,EAAE,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC,GAAG;IAClD,KAAK,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IACxB,WAAW,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC9B,OAAO,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B,2FAA2F;IAC3F,OAAO,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B,wCAAwC;IACxC,OAAO,CAAC,EAAE;QAAE,KAAK,EAAE,KAAK,CAAC,SAAS,CAAC;QAAC,KAAK,EAAE,KAAK,CAAC,SAAS,CAAA;KAAE,CAAC;IAC7D,MAAM,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IACzB,UAAU,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC7B,OAAO,CAAC,EAAE,WAAW,CAAC;CACvB,qBA8CA;AAED,OAAO,EAAE,SAAS,EAAE,CAAC"}

package/dist/components/table-card.js

@@ -5,9 +5,22 @@ import { Card, CardAction, CardDescription, CardHeader, CardTitle } from "./card
 import { Separator } from "./separator.js";
 /**
  * The frame a collection's table sits in: a heading, the collection's own
- * toolbar under it, the table, a labelled total, and the recessed footer
- * strip. The Portal's DataTable and Nadia's record sections draw this one
- * frame, so a registry card ends the same way in both products.
+ * toolbar under it, the table, a labelled total, and the recessed footer strip.
+ *
+ * The Portal's DataTable and Nadia's record sections draw this one frame, so a
+ * registry card ends the same way in both products.
+ *
+ * @family Data
+ * @when A table of records in a card: its heading, its own toolbar, the table, a labelled total and
+ * the recessed footer strip.
+ * @instead An entity collection that is the page's whole job is `CollectionPage`. A chart is
+ * `ChartCard`. One object's facts are `SettingsFactsSection`.
+ * @behaviour The heading, the toolbar and a separator come first when given; the summary row is a
+ * labelled total under the table; the footer strip holds the hint on the left and the count or
+ * paging on the right.
+ * @words The title names the collection. The footer is a count or the paging; the summary is a
+ * labelled total. Never a help sentence in the footer.
+ * @access A `section` whose title is an `h2`; the summary is a `dl`.
  */
 function TableCard({ title, description, actions, toolbar, summary, footer, footerHint, children, className, surface = "resting", ...props }) {
     const heading = title || description || actions;

package/dist/components/table-value.d.ts

@@ -1,7 +1,29 @@
 import type { ReactElement } from "react";
+type TableReading = string | number | ReactElement;
 export type TableValueProps = {
-    value: string | number | ReactElement | null | undefined;
+    state?: "read";
+    value: TableReading | null | undefined;
+    /** What a missing value means, read to a screen reader behind the dash: "Not reported". */
     missingLabel: string;
+    /** The word set after a reading that is out of date, such as "Stale"; absent while it is current. */
+    staleLabel?: string;
+} | {
+    state: "failed";
+    /** The catalogue's words for a read that failed: "Couldn't read". */
+    failedLabel: string;
+} | {
+    state: "loading";
 };
-export declare function TableValue({ value, missingLabel }: TableValueProps): string | number | import("react").JSX.Element;
+/**
+ * One cell's value in a table, in each state a reading can be in.
+ *
+ * @family Data
+ * @when Every cell of a `DataTable` whose reading can be missing, zero, out of date, unreadable or still loading.
+ * @instead A whole table that failed to read is `EmptyState kind="failed"`; a figure on its own is a `KpiCard`.
+ * @behaviour Five states that never collapse into a dash: unknown (a muted dash), zero (the figure "0"), stale (the reading, then the stale word), failed (the warning mark and its words) and loading (a still 64 × 12 placeholder). A real value, `0` included, is shown as it is.
+ * @words `missingLabel` says what the absence means ("Not reported", never "N/A" or "None"); `staleLabel` is one word ("Stale"); `failedLabel` says the read failed ("Couldn't read").
+ * @access The dash is hidden and `missingLabel` is read in its place; the warning mark is hidden beside its words; the placeholder is decorative, and the table is `aria-busy` while it loads.
+ */
+export declare function TableValue(props: TableValueProps): string | number | import("react").JSX.Element;
+export {};
 //# sourceMappingURL=table-value.d.ts.map

package/dist/components/table-value.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"table-value.d.ts","sourceRoot":"","sources":["../../src/components/table-value.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,OAAO,CAAC;AAE1C,MAAM,MAAM,eAAe,GAAG;IAC5B,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,YAAY,GAAG,IAAI,GAAG,SAAS,CAAC;IACzD,YAAY,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,wBAAgB,UAAU,CAAC,EAAE,KAAK,EAAE,YAAY,EAAE,EAAE,eAAe,iDASlE"}
+{"version":3,"file":"table-value.d.ts","sourceRoot":"","sources":["../../src/components/table-value.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,OAAO,CAAC;AAK1C,KAAK,YAAY,GAAG,MAAM,GAAG,MAAM,GAAG,YAAY,CAAC;AAEnD,MAAM,MAAM,eAAe,GACvB;IACE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,YAAY,GAAG,IAAI,GAAG,SAAS,CAAC;IACvC,2FAA2F;IAC3F,YAAY,EAAE,MAAM,CAAC;IACrB,qGAAqG;IACrG,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,GACD;IACE,KAAK,EAAE,QAAQ,CAAC;IAChB,qEAAqE;IACrE,WAAW,EAAE,MAAM,CAAC;CACrB,GACD;IAAE,KAAK,EAAE,SAAS,CAAA;CAAE,CAAC;AAEzB;;;;;;;;;GASG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,eAAe,iDAoChD"}

package/dist/components/table-value.js

@@ -1,6 +1,28 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-export function TableValue({ value, missingLabel }) {
-    if (value !== null && value !== undefined && value !== "")
+import { CircleAlert } from "lucide-react";
+import { Skeleton } from "./skeleton.js";
+/**
+ * One cell's value in a table, in each state a reading can be in.
+ *
+ * @family Data
+ * @when Every cell of a `DataTable` whose reading can be missing, zero, out of date, unreadable or still loading.
+ * @instead A whole table that failed to read is `EmptyState kind="failed"`; a figure on its own is a `KpiCard`.
+ * @behaviour Five states that never collapse into a dash: unknown (a muted dash), zero (the figure "0"), stale (the reading, then the stale word), failed (the warning mark and its words) and loading (a still 64 × 12 placeholder). A real value, `0` included, is shown as it is.
+ * @words `missingLabel` says what the absence means ("Not reported", never "N/A" or "None"); `staleLabel` is one word ("Stale"); `failedLabel` says the read failed ("Couldn't read").
+ * @access The dash is hidden and `missingLabel` is read in its place; the warning mark is hidden beside its words; the placeholder is decorative, and the table is `aria-busy` while it loads.
+ */
+export function TableValue(props) {
+    if (props.state === "loading") {
+        return _jsx(Skeleton, { className: "h-3 w-16" });
+    }
+    if (props.state === "failed") {
+        return (_jsxs("span", { "data-slot": "table-failed-value", className: "inline-flex items-center gap-1 text-caption text-warning-soft-foreground", children: [_jsx(CircleAlert, { "aria-hidden": "true", className: "size-3 shrink-0", strokeWidth: 1.25 }), props.failedLabel] }));
+    }
+    const { value, missingLabel, staleLabel } = props;
+    if (value === null || value === undefined || value === "") {
+        return (_jsxs("span", { "data-slot": "table-missing-value", className: "text-muted-foreground", children: [_jsx("span", { "aria-hidden": "true", children: "\u2014" }), _jsx("span", { className: "sr-only", children: missingLabel })] }));
+    }
+    if (staleLabel === undefined)
         return value;
-    return (_jsxs("span", { "data-slot": "table-missing-value", className: "text-muted-foreground", children: [_jsx("span", { "aria-hidden": "true", children: "\u2014" }), _jsx("span", { className: "sr-only", children: missingLabel })] }));
+    return (_jsxs("span", { "data-slot": "table-stale-value", className: "inline-flex items-baseline gap-1.5", children: [value, _jsx("span", { className: "text-caption text-muted-foreground", children: staleLabel })] }));
 }

package/dist/components/table.d.ts

@@ -1,5 +1,21 @@
 import * as React from "react";
 import { tableCompactLayouts, type TableCompactLayout } from "./table-layouts.js";
+/**
+ * The native table primitive every comparison table is drawn with.
+ *
+ * @family Data
+ * @when A fixed table a composition draws itself: a summary inside a card, a list of plan limits. A
+ * table of records is `DataTable`, which draws this one.
+ * @instead Records with sorting, paging and an empty state are `DataTable`. A descriptive list is
+ * `ItemGroup`. One object's facts are `ObjectFacts`.
+ * @behaviour Headings visible; numbers trail in tabular figures. Row hover takes `accent`; headers
+ * and footers never highlight. `TableDetailRow` and `tableCompactLayouts` move facts into a detail
+ * row on a narrow card instead of scrolling sideways.
+ * @words Headings are nouns with their unit: *Cost (€)*, *Tokens*. Italian headings run a third
+ * longer and never wrap.
+ * @access A native `table` with a caption or `aria-label`; `th scope="col"`. A missing value is
+ * `TableValue`'s hidden dash, never blank.
+ */
 declare function Table({ className, compactDetails, density, variant, interactive, ...props }: React.ComponentProps<"table"> & {
     compactDetails?: TableCompactLayout;
     density?: "default" | "comfortable";

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

@@ -1 +1 @@
-{"version":3,"file":"table.d.ts","sourceRoot":"","sources":["../../src/components/table.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAI/B,OAAO,EAAE,mBAAmB,EAAE,KAAK,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAE1F,iBAAS,KAAK,CAAC,EACb,SAAS,EACT,cAAc,EACd,OAAmB,EACnB,OAAmB,EACnB,WAAmB,EACnB,GAAG,KAAK,EACT,EAAE,KAAK,CAAC,cAAc,CAAC,OAAO,CAAC,GAAG;IACjC,cAAc,CAAC,EAAE,kBAAkB,CAAC;IACpC,OAAO,CAAC,EAAE,SAAS,GAAG,aAAa,CAAC;IACpC,OAAO,CAAC,EAAE,SAAS,GAAG,SAAS,GAAG,UAAU,CAAC;IAC7C,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB,qBAyBA;AAED,iBAAS,WAAW,CAAC,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,KAAK,CAAC,cAAc,CAAC,OAAO,CAAC,qBAQ1E;AAED,iBAAS,SAAS,CAAC,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,KAAK,CAAC,cAAc,CAAC,OAAO,CAAC,qBAWxE;AAED,iBAAS,gBAAgB,CAAC,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,KAAK,CAAC,cAAc,CAAC,OAAO,CAAC,qBAW/E;AAED,iBAAS,WAAW,CAAC,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,KAAK,CAAC,cAAc,CAAC,OAAO,CAAC,qBAW1E;AAED,iBAAS,QAAQ,CAAC,EAChB,SAAS,EACT,YAAY,EACZ,GAAG,KAAK,EACT,EAAE,KAAK,CAAC,cAAc,CAAC,IAAI,CAAC,GAAG;IAC9B,6GAA6G;IAC7G,YAAY,CAAC,EAAE,kBAAkB,CAAC;CACnC,qBAYA;AAED,iBAAS,SAAS,CAAC,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,KAAK,CAAC,cAAc,CAAC,IAAI,CAAC,qBAWrE;AAED,iBAAS,SAAS,CAAC,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,KAAK,CAAC,cAAc,CAAC,IAAI,CAAC,qBAWrE;AAED,iBAAS,cAAc,CAAC,EACtB,OAAO,EACP,KAAK,EACL,MAAmB,GACpB,EAAE;IACD,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,kBAAkB,CAAC;IAC5B,KAAK,EAAE,SAAS;QACd,EAAE,EAAE,MAAM,CAAC;QACX,KAAK,EAAE,KAAK,CAAC,SAAS,CAAC;QACvB,KAAK,EAAE,KAAK,CAAC,SAAS,CAAC;QACvB,OAAO,CAAC,EAAE,OAAO,CAAC;KACnB,EAAE,CAAC;CACL,qBA8BA;AAED,iBAAS,YAAY,CAAC,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,KAAK,CAAC,cAAc,CAAC,SAAS,CAAC,qBAQ7E;AAED,OAAO,EACL,KAAK,EACL,WAAW,EACX,SAAS,EACT,gBAAgB,EAChB,WAAW,EACX,SAAS,EACT,QAAQ,EACR,SAAS,EACT,YAAY,EACZ,cAAc,EACd,mBAAmB,EACnB,KAAK,kBAAkB,GACxB,CAAC"}
+{"version":3,"file":"table.d.ts","sourceRoot":"","sources":["../../src/components/table.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAI/B,OAAO,EAAE,mBAAmB,EAAE,KAAK,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAE1F;;;;;;;;;;;;;;;GAeG;AACH,iBAAS,KAAK,CAAC,EACb,SAAS,EACT,cAAc,EACd,OAAmB,EACnB,OAAmB,EACnB,WAAmB,EACnB,GAAG,KAAK,EACT,EAAE,KAAK,CAAC,cAAc,CAAC,OAAO,CAAC,GAAG;IACjC,cAAc,CAAC,EAAE,kBAAkB,CAAC;IACpC,OAAO,CAAC,EAAE,SAAS,GAAG,aAAa,CAAC;IACpC,OAAO,CAAC,EAAE,SAAS,GAAG,SAAS,GAAG,UAAU,CAAC;IAC7C,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB,qBA0BA;AAED,iBAAS,WAAW,CAAC,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,KAAK,CAAC,cAAc,CAAC,OAAO,CAAC,qBAQ1E;AAED,iBAAS,SAAS,CAAC,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,KAAK,CAAC,cAAc,CAAC,OAAO,CAAC,qBAWxE;AAED,iBAAS,gBAAgB,CAAC,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,KAAK,CAAC,cAAc,CAAC,OAAO,CAAC,qBAW/E;AAED,iBAAS,WAAW,CAAC,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,KAAK,CAAC,cAAc,CAAC,OAAO,CAAC,qBAW1E;AAED,iBAAS,QAAQ,CAAC,EAChB,SAAS,EACT,YAAY,EACZ,GAAG,KAAK,EACT,EAAE,KAAK,CAAC,cAAc,CAAC,IAAI,CAAC,GAAG;IAC9B,6GAA6G;IAC7G,YAAY,CAAC,EAAE,kBAAkB,CAAC;CACnC,qBAYA;AAED,iBAAS,SAAS,CAAC,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,KAAK,CAAC,cAAc,CAAC,IAAI,CAAC,qBAWrE;AAED,iBAAS,SAAS,CAAC,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,KAAK,CAAC,cAAc,CAAC,IAAI,CAAC,qBAWrE;AAED,iBAAS,cAAc,CAAC,EACtB,OAAO,EACP,KAAK,EACL,MAAmB,GACpB,EAAE;IACD,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,kBAAkB,CAAC;IAC5B,KAAK,EAAE,SAAS;QACd,EAAE,EAAE,MAAM,CAAC;QACX,KAAK,EAAE,KAAK,CAAC,SAAS,CAAC;QACvB,KAAK,EAAE,KAAK,CAAC,SAAS,CAAC;QACvB,OAAO,CAAC,EAAE,OAAO,CAAC;KACnB,EAAE,CAAC;CACL,qBA8BA;AAED,iBAAS,YAAY,CAAC,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,KAAK,CAAC,cAAc,CAAC,SAAS,CAAC,qBAQ7E;AAED,OAAO,EACL,KAAK,EACL,WAAW,EACX,SAAS,EACT,gBAAgB,EAChB,WAAW,EACX,SAAS,EACT,QAAQ,EACR,SAAS,EACT,YAAY,EACZ,cAAc,EACd,mBAAmB,EACnB,KAAK,kBAAkB,GACxB,CAAC"}

package/dist/components/table.js

@@ -2,8 +2,24 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { cn } from "../lib/utils.js";
 import { tableCompactLayouts } from "./table-layouts.js";
+/**
+ * The native table primitive every comparison table is drawn with.
+ *
+ * @family Data
+ * @when A fixed table a composition draws itself: a summary inside a card, a list of plan limits. A
+ * table of records is `DataTable`, which draws this one.
+ * @instead Records with sorting, paging and an empty state are `DataTable`. A descriptive list is
+ * `ItemGroup`. One object's facts are `ObjectFacts`.
+ * @behaviour Headings visible; numbers trail in tabular figures. Row hover takes `accent`; headers
+ * and footers never highlight. `TableDetailRow` and `tableCompactLayouts` move facts into a detail
+ * row on a narrow card instead of scrolling sideways.
+ * @words Headings are nouns with their unit: *Cost (€)*, *Tokens*. Italian headings run a third
+ * longer and never wrap.
+ * @access A native `table` with a caption or `aria-label`; `th scope="col"`. A missing value is
+ * `TableValue`'s hidden dash, never blank.
+ */
 function Table({ className, compactDetails, density = "default", variant = "default", interactive = false, ...props }) {
-    return (_jsx("div", { "data-slot": "table-container", className: cn("relative w-full overflow-x-auto", compactDetails && "@container/table", variant === "bordered" && "rounded-sm border border-border"), children: _jsx("table", { "data-slot": "table", "data-density": density, "data-variant": variant, "data-interactive": interactive, className: cn("group/table w-full caption-bottom text-sm", variant === "striped" && "bg-card", className, compactDetails && tableCompactLayouts[compactDetails].table), ...props }) }));
+    return (_jsx("div", { "data-slot": "table-container", className: cn("relative w-full overflow-x-auto", compactDetails && "@container/table", variant === "bordered" && "rounded-sm border border-border"), children: _jsx("table", { "data-slot": "table", "data-compact-details": compactDetails, "data-density": density, "data-variant": variant, "data-interactive": interactive, className: cn("group/table w-full caption-bottom text-sm", variant === "striped" && "bg-card", className, compactDetails && tableCompactLayouts[compactDetails].table), ...props }) }));
 }
 function TableHeader({ className, ...props }) {
     return (_jsx("thead", { "data-slot": "table-header", className: cn("bg-recessed [&_tr]:h-9 [&_tr]:border-b", className), ...props }));

package/dist/components/tabs.d.ts

@@ -2,6 +2,19 @@ import * as React from "react";
 import { Tabs as TabsPrimitive } from "@base-ui/react/tabs";
 import { useRender } from "@base-ui/react/use-render";
 import { type VariantProps } from "class-variance-authority";
+/**
+ * Panels of one surface that switch in place.
+ *
+ * @family Navigation
+ * @when Sibling views of one object that switch in place inside one surface.
+ * @instead Views with their own URL are `TabsNav`. A choice that changes a value is a `RadioGroup`
+ * or `ToggleGroup`. A stable destination belongs in the `Sidebar`. A tab never opens a new scope.
+ * @behaviour One treatment among siblings, chosen through `variant`, never a page border. Arrow
+ * keys move, one tab stop. The underline fades on `confirm`, 180 ms.
+ * @words Nouns, one or two words: *Overview*, *Installations*. Italian (*Installazioni*) scrolls,
+ * never wraps or truncates.
+ * @access `tablist`, `tab`, `tabpanel` with `aria-selected`.
+ */
 declare function Tabs({ className, orientation, ...props }: TabsPrimitive.Root.Props): React.JSX.Element;
 declare const tabsListVariants: (props?: ({
     variant?: "line" | "default" | null | undefined;
@@ -9,6 +22,20 @@ declare const tabsListVariants: (props?: ({
 declare function TabsList({ className, variant, ...props }: TabsPrimitive.List.Props & VariantProps<typeof tabsListVariants>): React.JSX.Element;
 declare function TabsTrigger({ className, ...props }: TabsPrimitive.Tab.Props): React.JSX.Element;
 declare function TabsContent({ className, ...props }: TabsPrimitive.Panel.Props): React.JSX.Element;
+/**
+ * Sibling views of one object, each with its own URL, under the top bar.
+ *
+ * @family Navigation
+ * @when Sibling views of one object under the top bar, when each view has its own URL (an object's
+ * sections), with `TabsLink` for each.
+ * @instead Panels that switch in place are `Tabs`. A stable destination belongs in the `Sidebar`.
+ * An object's ancestry is the `Breadcrumb`.
+ * @behaviour Overflow scrolls sideways and brings the current link into view. The current link
+ * takes the underline.
+ * @words Nouns, one or two words: *Overview*, *Installations*. Italian scrolls, never wraps or
+ * truncates.
+ * @access A labelled `nav` of links with `aria-current="page"` on the current one.
+ */
 declare function TabsNav({ className, children, variant, ...props }: React.ComponentProps<"nav"> & VariantProps<typeof tabsListVariants>): React.JSX.Element;
 declare function TabsLink({ current, className, render, ...props }: useRender.ComponentProps<"a"> & {
     current?: boolean;

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

@@ -1 +1 @@
-{"version":3,"file":"tabs.d.ts","sourceRoot":"","sources":["../../src/components/tabs.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,EAAE,IAAI,IAAI,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAE5D,OAAO,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AACtD,OAAO,EAAO,KAAK,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAIlE,iBAAS,IAAI,CAAC,EAAE,SAAS,EAAE,WAA0B,EAAE,GAAG,KAAK,EAAE,EAAE,aAAa,CAAC,IAAI,CAAC,KAAK,qBAU1F;AAED,QAAA,MAAM,gBAAgB;;8EAarB,CAAC;AAEF,iBAAS,QAAQ,CAAC,EAChB,SAAS,EACT,OAAmB,EACnB,GAAG,KAAK,EACT,EAAE,aAAa,CAAC,IAAI,CAAC,KAAK,GAAG,YAAY,CAAC,OAAO,gBAAgB,CAAC,qBASlE;AAKD,iBAAS,WAAW,CAAC,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,aAAa,CAAC,GAAG,CAAC,KAAK,qBAepE;AAED,iBAAS,WAAW,CAAC,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,aAAa,CAAC,KAAK,CAAC,KAAK,qBAQtE;AAED,iBAAS,OAAO,CAAC,EACf,SAAS,EACT,QAAQ,EACR,OAAmB,EACnB,GAAG,KAAK,EACT,EAAE,KAAK,CAAC,cAAc,CAAC,KAAK,CAAC,GAAG,YAAY,CAAC,OAAO,gBAAgB,CAAC,qBA2BrE;AAED,iBAAS,QAAQ,CAAC,EAChB,OAAe,EACf,SAAS,EACT,MAAM,EACN,GAAG,KAAK,EACT,EAAE,SAAS,CAAC,cAAc,CAAC,GAAG,CAAC,GAAG;IAAE,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,qBAoBvD;AAED,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,WAAW,EAAE,OAAO,EAAE,QAAQ,EAAE,gBAAgB,EAAE,CAAC"}
+{"version":3,"file":"tabs.d.ts","sourceRoot":"","sources":["../../src/components/tabs.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,EAAE,IAAI,IAAI,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAE5D,OAAO,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AACtD,OAAO,EAAO,KAAK,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAIlE;;;;;;;;;;;;GAYG;AACH,iBAAS,IAAI,CAAC,EAAE,SAAS,EAAE,WAA0B,EAAE,GAAG,KAAK,EAAE,EAAE,aAAa,CAAC,IAAI,CAAC,KAAK,qBAU1F;AAED,QAAA,MAAM,gBAAgB;;8EAarB,CAAC;AAEF,iBAAS,QAAQ,CAAC,EAChB,SAAS,EACT,OAAmB,EACnB,GAAG,KAAK,EACT,EAAE,aAAa,CAAC,IAAI,CAAC,KAAK,GAAG,YAAY,CAAC,OAAO,gBAAgB,CAAC,qBASlE;AAKD,iBAAS,WAAW,CAAC,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,aAAa,CAAC,GAAG,CAAC,KAAK,qBAepE;AAED,iBAAS,WAAW,CAAC,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,aAAa,CAAC,KAAK,CAAC,KAAK,qBAQtE;AAED;;;;;;;;;;;;;GAaG;AACH,iBAAS,OAAO,CAAC,EACf,SAAS,EACT,QAAQ,EACR,OAAmB,EACnB,GAAG,KAAK,EACT,EAAE,KAAK,CAAC,cAAc,CAAC,KAAK,CAAC,GAAG,YAAY,CAAC,OAAO,gBAAgB,CAAC,qBA2BrE;AAED,iBAAS,QAAQ,CAAC,EAChB,OAAe,EACf,SAAS,EACT,MAAM,EACN,GAAG,KAAK,EACT,EAAE,SAAS,CAAC,cAAc,CAAC,GAAG,CAAC,GAAG;IAAE,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,qBAoBvD;AAED,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,WAAW,EAAE,OAAO,EAAE,QAAQ,EAAE,gBAAgB,EAAE,CAAC"}

package/dist/components/tabs.js

@@ -6,6 +6,19 @@ import { mergeProps } from "@base-ui/react/merge-props";
 import { useRender } from "@base-ui/react/use-render";
 import { cva } from "class-variance-authority";
 import { cn } from "../lib/utils.js";
+/**
+ * Panels of one surface that switch in place.
+ *
+ * @family Navigation
+ * @when Sibling views of one object that switch in place inside one surface.
+ * @instead Views with their own URL are `TabsNav`. A choice that changes a value is a `RadioGroup`
+ * or `ToggleGroup`. A stable destination belongs in the `Sidebar`. A tab never opens a new scope.
+ * @behaviour One treatment among siblings, chosen through `variant`, never a page border. Arrow
+ * keys move, one tab stop. The underline fades on `confirm`, 180 ms.
+ * @words Nouns, one or two words: *Overview*, *Installations*. Italian (*Installazioni*) scrolls,
+ * never wraps or truncates.
+ * @access `tablist`, `tab`, `tabpanel` with `aria-selected`.
+ */
 function Tabs({ className, orientation = "horizontal", ...props }) {
     return (_jsx(TabsPrimitive.Root, { "data-slot": "tabs", "data-orientation": orientation, orientation: orientation, className: cn("group/tabs flex min-w-0 gap-4 data-horizontal:flex-col", className), ...props }));
 }
@@ -30,6 +43,20 @@ function TabsTrigger({ className, ...props }) {
 function TabsContent({ className, ...props }) {
     return (_jsx(TabsPrimitive.Panel, { "data-slot": "tabs-content", className: cn("min-w-0 flex-1 text-sm outline-none", className), ...props }));
 }
+/**
+ * Sibling views of one object, each with its own URL, under the top bar.
+ *
+ * @family Navigation
+ * @when Sibling views of one object under the top bar, when each view has its own URL (an object's
+ * sections), with `TabsLink` for each.
+ * @instead Panels that switch in place are `Tabs`. A stable destination belongs in the `Sidebar`.
+ * An object's ancestry is the `Breadcrumb`.
+ * @behaviour Overflow scrolls sideways and brings the current link into view. The current link
+ * takes the underline.
+ * @words Nouns, one or two words: *Overview*, *Installations*. Italian scrolls, never wraps or
+ * truncates.
+ * @access A labelled `nav` of links with `aria-current="page"` on the current one.
+ */
 function TabsNav({ className, children, variant = "default", ...props }) {
     const navigation = React.useRef(null);
     const current = React.useRef(null);

package/dist/components/tag.d.ts

@@ -11,8 +11,18 @@ type TagProps = Omit<ComponentProps<"span">, "children"> & {
     note?: ReactNode;
 };
 /**
- * One categorical fact in a row, as a pill. A tag never carries
- * a status: that is a StatusBadge.
+ * One categorical fact in a row, as a pill.
+ *
+ * @family Status
+ * @when One categorical fact in a row: the installation, the partner, the company a record belongs
+ * to. A 24 px pill with its 12 px mark.
+ * @instead For a state use `StatusBadge`; a tag never carries one. For a removable filter use
+ * `CollectionFilters`. For a way to the thing, a link.
+ * @behaviour Static, truncates inside its width. The same category keeps the same tone across a
+ * surface and after sorting. Dashed and muted when it states an absence.
+ * @words The thing's own name. A quiet tag names the absence in two or three words (*Direct
+ * customer*); the note says whose (*Your account*).
+ * @access Text; the mark is decorative. Never focusable unless wrapped by a real link.
  */
 declare function Tag({ children, className, mark, note, quiet, tone, ...props }: TagProps): import("react").JSX.Element;
 export { Tag, type TagProps, type TagTone };

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

@@ -1 +1 @@
-{"version":3,"file":"tag.d.ts","sourceRoot":"","sources":["../../src/components/tag.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAIvD,KAAK,OAAO,GAAG,SAAS,GAAG,MAAM,GAAG,MAAM,GAAG,QAAQ,GAAG,MAAM,CAAC;AAU/D,KAAK,QAAQ,GAAG,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,EAAE,UAAU,CAAC,GAAG;IACzD,QAAQ,EAAE,SAAS,CAAC;IACpB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,uCAAuC;IACvC,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,qEAAqE;IACrE,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,wEAAwE;IACxE,IAAI,CAAC,EAAE,SAAS,CAAC;CAClB,CAAC;AAEF;;;GAGG;AACH,iBAAS,GAAG,CAAC,EACX,QAAQ,EACR,SAAS,EACT,IAAI,EACJ,IAAI,EACJ,KAAa,EACb,IAAgB,EAChB,GAAG,KAAK,EACT,EAAE,QAAQ,+BA4BV;AAED,OAAO,EAAE,GAAG,EAAE,KAAK,QAAQ,EAAE,KAAK,OAAO,EAAE,CAAC"}
+{"version":3,"file":"tag.d.ts","sourceRoot":"","sources":["../../src/components/tag.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAIvD,KAAK,OAAO,GAAG,SAAS,GAAG,MAAM,GAAG,MAAM,GAAG,QAAQ,GAAG,MAAM,CAAC;AAU/D,KAAK,QAAQ,GAAG,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,EAAE,UAAU,CAAC,GAAG;IACzD,QAAQ,EAAE,SAAS,CAAC;IACpB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,uCAAuC;IACvC,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,qEAAqE;IACrE,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,wEAAwE;IACxE,IAAI,CAAC,EAAE,SAAS,CAAC;CAClB,CAAC;AAEF;;;;;;;;;;;;;GAaG;AACH,iBAAS,GAAG,CAAC,EACX,QAAQ,EACR,SAAS,EACT,IAAI,EACJ,IAAI,EACJ,KAAa,EACb,IAAgB,EAChB,GAAG,KAAK,EACT,EAAE,QAAQ,+BA4BV;AAED,OAAO,EAAE,GAAG,EAAE,KAAK,QAAQ,EAAE,KAAK,OAAO,EAAE,CAAC"}

package/dist/components/tag.js

@@ -8,8 +8,18 @@ const TONE_CLASS = {
     pink: "border-transparent bg-category-pink text-category-pink-foreground",
 };
 /**
- * One categorical fact in a row, as a pill. A tag never carries
- * a status: that is a StatusBadge.
+ * One categorical fact in a row, as a pill.
+ *
+ * @family Status
+ * @when One categorical fact in a row: the installation, the partner, the company a record belongs
+ * to. A 24 px pill with its 12 px mark.
+ * @instead For a state use `StatusBadge`; a tag never carries one. For a removable filter use
+ * `CollectionFilters`. For a way to the thing, a link.
+ * @behaviour Static, truncates inside its width. The same category keeps the same tone across a
+ * surface and after sorting. Dashed and muted when it states an absence.
+ * @words The thing's own name. A quiet tag names the absence in two or three words (*Direct
+ * customer*); the note says whose (*Your account*).
+ * @access Text; the mark is decorative. Never focusable unless wrapped by a real link.
  */
 function Tag({ children, className, mark, note, quiet = false, tone = "neutral", ...props }) {
     return (_jsxs("span", { className: cn("inline-flex h-6 max-w-full min-w-0 shrink-0 items-center gap-1.5 rounded-full border ps-2 pe-2.5 text-xs whitespace-nowrap", quiet ? "border-dashed border-border text-muted-foreground" : TONE_CLASS[tone], className), "data-quiet": quiet ? "" : undefined, "data-slot": "tag", ...props, children: [mark ? (_jsx("span", { className: "flex size-3 shrink-0 items-center justify-center [&>svg]:size-3", "data-slot": "tag-mark", children: mark })) : null, _jsx("span", { className: "truncate", children: children }), note ? (_jsx("span", { className: "shrink-0 text-muted-foreground", "data-slot": "tag-note", children: note })) : null] }));

package/dist/components/text-link.d.ts

@@ -1,4 +1,21 @@
 import { type VariantProps } from "class-variance-authority";
+/**
+ * The classes of a link that reads as text: `inline` inside a sentence, `plain` on its own, `quiet`
+ * for a muted way out.
+ *
+ * @family Navigation
+ * @when A link inside a sentence (`inline`, blue and underlined), a link that stands alone as text
+ * (`plain`), or a muted secondary way to somewhere such as a footer's *Learn more* (`quiet`).
+ * @instead A command is a `Button`; a destination drawn as a button is a link with
+ * `buttonVariants`. Going to a record from its row is the record's name in `RecordIdentity`.
+ * @behaviour Classes only: the caller renders the real anchor or router link. `inline` thickens its
+ * underline on hover; `plain` and `quiet` underline on hover. Paint changes ride the shared paint
+ * transition.
+ * @words The link's text names where it goes: *Open Billing*, *Read the privacy notice*; never
+ * *Click here* or a bare URL.
+ * @access A real `a` with an `href`. A link that leaves the product says so in its text or carries
+ * the arrow with a name. Focus is the base layer's 2 px outline.
+ */
 declare const textLinkVariants: (props?: ({
     kind?: "plain" | "inline" | "quiet" | null | undefined;
 } & import("class-variance-authority/types").ClassProp) | undefined) => string;

package/dist/components/text-link.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"text-link.d.ts","sourceRoot":"","sources":["../../src/components/text-link.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAO,KAAK,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAElE,QAAA,MAAM,gBAAgB;;8EAYpB,CAAC;AAEH,KAAK,YAAY,GAAG,WAAW,CAAC,YAAY,CAAC,OAAO,gBAAgB,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC;AAE/E,OAAO,EAAE,gBAAgB,EAAE,KAAK,YAAY,EAAE,CAAC"}
+{"version":3,"file":"text-link.d.ts","sourceRoot":"","sources":["../../src/components/text-link.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAO,KAAK,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAElE;;;;;;;;;;;;;;;;GAgBG;AACH,QAAA,MAAM,gBAAgB;;8EAYpB,CAAC;AAEH,KAAK,YAAY,GAAG,WAAW,CAAC,YAAY,CAAC,OAAO,gBAAgB,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC;AAE/E,OAAO,EAAE,gBAAgB,EAAE,KAAK,YAAY,EAAE,CAAC"}

package/dist/components/text-link.js

@@ -1,4 +1,21 @@
 import { cva } from "class-variance-authority";
+/**
+ * The classes of a link that reads as text: `inline` inside a sentence, `plain` on its own, `quiet`
+ * for a muted way out.
+ *
+ * @family Navigation
+ * @when A link inside a sentence (`inline`, blue and underlined), a link that stands alone as text
+ * (`plain`), or a muted secondary way to somewhere such as a footer's *Learn more* (`quiet`).
+ * @instead A command is a `Button`; a destination drawn as a button is a link with
+ * `buttonVariants`. Going to a record from its row is the record's name in `RecordIdentity`.
+ * @behaviour Classes only: the caller renders the real anchor or router link. `inline` thickens its
+ * underline on hover; `plain` and `quiet` underline on hover. Paint changes ride the shared paint
+ * transition.
+ * @words The link's text names where it goes: *Open Billing*, *Read the privacy notice*; never
+ * *Click here* or a bare URL.
+ * @access A real `a` with an `href`. A link that leaves the product says so in its text or carries
+ * the arrow with a name. Focus is the base layer's 2 px outline.
+ */
 const textLinkVariants = cva("nc-transition-paint rounded-sm underline-offset-4", {
     variants: {
         kind: {

package/dist/components/textarea.d.ts

@@ -1,4 +1,18 @@
 import * as React from "react";
+/**
+ * Several lines of free text that grow with their content.
+ *
+ * @family Inputs
+ * @when Several lines of free text: an Agent's instructions, a description, notes.
+ * @instead One line is `Input`. Code or a value to copy is `CodeBlock`, read-only.
+ * @behaviour At least 64 px, then it grows with its content (`field-sizing: content`). The same
+ * edge, focus, invalid and disabled as `Input`. Whitespace is kept exactly; nothing trims it. A
+ * character count shows only when a real limit exists.
+ * @words The label names the content (*Instructions*); the help says who reads it and when. The
+ * placeholder is a short example, not a paragraph.
+ * @access A visible label tied by `id`; help and error through `aria-describedby`. In a dialog, the
+ * footer's Save stays reachable while the box grows.
+ */
 declare function Textarea({ className, ...props }: React.ComponentProps<"textarea">): React.JSX.Element;
 export { Textarea };
 //# sourceMappingURL=textarea.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"textarea.d.ts","sourceRoot":"","sources":["../../src/components/textarea.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAI/B,iBAAS,QAAQ,CAAC,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,KAAK,CAAC,cAAc,CAAC,UAAU,CAAC,qBAW1E;AAED,OAAO,EAAE,QAAQ,EAAE,CAAC"}
+{"version":3,"file":"textarea.d.ts","sourceRoot":"","sources":["../../src/components/textarea.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAI/B;;;;;;;;;;;;;GAaG;AACH,iBAAS,QAAQ,CAAC,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,KAAK,CAAC,cAAc,CAAC,UAAU,CAAC,qBAW1E;AAED,OAAO,EAAE,QAAQ,EAAE,CAAC"}

package/dist/components/textarea.js

@@ -1,5 +1,19 @@
 import { jsx as _jsx } from "react/jsx-runtime";
 import { cn } from "../lib/utils.js";
+/**
+ * Several lines of free text that grow with their content.
+ *
+ * @family Inputs
+ * @when Several lines of free text: an Agent's instructions, a description, notes.
+ * @instead One line is `Input`. Code or a value to copy is `CodeBlock`, read-only.
+ * @behaviour At least 64 px, then it grows with its content (`field-sizing: content`). The same
+ * edge, focus, invalid and disabled as `Input`. Whitespace is kept exactly; nothing trims it. A
+ * character count shows only when a real limit exists.
+ * @words The label names the content (*Instructions*); the help says who reads it and when. The
+ * placeholder is a short example, not a paragraph.
+ * @access A visible label tied by `id`; help and error through `aria-describedby`. In a dialog, the
+ * footer's Save stays reachable while the box grows.
+ */
 function Textarea({ className, ...props }) {
     return (_jsx("textarea", { "data-slot": "textarea", className: cn("flex field-sizing-content min-h-16 w-full rounded-sm border border-input bg-background px-control-padding-inline py-2 text-base transition-colors placeholder:text-placeholder disabled:cursor-not-allowed disabled:bg-input/50 disabled:opacity-50 aria-invalid:border-destructive md:text-sm", className), ...props }));
 }

package/dist/components/theme-mode-switcher.d.ts

@@ -19,8 +19,29 @@ export type ThemeModeSwitcherProps = Omit<React.ComponentProps<typeof RadioGroup
     renderItem?: (option: ThemeModeOption) => React.ReactNode;
     value: ThemeMode;
 };
+/**
+ * The three appearances side by side, each with its glyph and its name.
+ *
+ * @family Choices
+ * @when An Appearance setting on a settings page, where the choice has room to show its names.
+ * @instead Inside a menu, the same choice is ThemeModeMenu; a choice that is not the appearance is a RadioGroup or a ToggleGroup.
+ * @behaviour Exclusive: one mode is selected, and choosing one applies it at once with no Save. The order is System, Light, Dark everywhere.
+ * @words The setting's name, then each mode's name from the product's catalogue: "System", "Light", "Dark".
+ * @access A radio group named by `aria-label`; each mode is a radio with its name, moved through with the arrow keys.
+ */
 declare function ThemeModeSwitcher({ "aria-label": ariaLabel, className, compact, disabled, itemClassName, labels, onValueChange, renderItem, value, ...props }: ThemeModeSwitcherProps): React.JSX.Element;
 export { ThemeModeSwitcher };
+/**
+ * The appearance as one row of a menu: its name and the current mode's glyph
+ * leading, the three modes as compact choices at its end.
+ *
+ * @family Menus
+ * @when The account menu's Theme row, in the Portal and in Nadia.
+ * @instead On a settings page the choice is ThemeModeSwitcher, with its names shown.
+ * @behaviour Choosing a mode applies it at once and keeps the menu open, so the result shows without reopening it. The order is System, Light, Dark.
+ * @words The row's name ("Theme") and each mode's name, read as the choice's accessible name and tooltip.
+ * @access A radio group inside the menu, named by the row's label; each mode is a menu radio item with its name.
+ */
 export declare function ThemeModeMenu({ label, labels, value, onValueChange, disabled, }: {
     label: string;
     labels: ThemeModeOptionLabels;

package/dist/components/theme-mode-switcher.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"theme-mode-switcher.d.ts","sourceRoot":"","sources":["../../src/components/theme-mode-switcher.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAI/B,OAAO,EAAE,UAAU,EAAkB,MAAM,0BAA0B,CAAC;AAEtE,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,KAAK,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAG3E,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,CAAC;AACnC,YAAY,EAAE,SAAS,EAAE,CAAC;AAE1B,MAAM,MAAM,qBAAqB,GAAG,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;AAE9D,MAAM,MAAM,eAAe,GAAG;IAC5B,IAAI,EAAE,KAAK,CAAC,aAAa,CAAC,KAAK,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC,CAAC;IACzD,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,SAAS,CAAC;IAChB,QAAQ,EAAE,OAAO,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,sBAAsB,GAAG,IAAI,CACvC,KAAK,CAAC,cAAc,CAAC,OAAO,UAAU,CAAC,EACvC,UAAU,GAAG,cAAc,GAAG,eAAe,GAAG,OAAO,CACxD,GAAG;IACF,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,qBAAqB,CAAC;IAC9B,aAAa,EAAE,CAAC,KAAK,EAAE,SAAS,KAAK,IAAI,CAAC;IAC1C,UAAU,CAAC,EAAE,CAAC,MAAM,EAAE,eAAe,KAAK,KAAK,CAAC,SAAS,CAAC;IAC1D,KAAK,EAAE,SAAS,CAAC;CAClB,CAAC;AAQF,iBAAS,iBAAiB,CAAC,EACzB,YAAY,EAAE,SAAS,EACvB,SAAS,EACT,OAAe,EACf,QAAQ,EACR,aAAa,EACb,MAAM,EACN,aAAa,EACb,UAAU,EACV,KAAK,EACL,GAAG,KAAK,EACT,EAAE,sBAAsB,qBA6CxB;AAED,OAAO,EAAE,iBAAiB,EAAE,CAAC;AAE7B,wBAAgB,aAAa,CAAC,EAC5B,KAAK,EACL,MAAM,EACN,KAAK,EACL,aAAa,EACb,QAAQ,GACT,EAAE;IACD,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,qBAAqB,CAAC;IAC9B,KAAK,EAAE,SAAS,CAAC;IACjB,aAAa,EAAE,CAAC,KAAK,EAAE,SAAS,KAAK,IAAI,CAAC;IAC1C,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB,qBAkBA"}
+{"version":3,"file":"theme-mode-switcher.d.ts","sourceRoot":"","sources":["../../src/components/theme-mode-switcher.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAI/B,OAAO,EAAE,UAAU,EAAkB,MAAM,0BAA0B,CAAC;AAEtE,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,KAAK,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAG3E,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,CAAC;AACnC,YAAY,EAAE,SAAS,EAAE,CAAC;AAE1B,MAAM,MAAM,qBAAqB,GAAG,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;AAE9D,MAAM,MAAM,eAAe,GAAG;IAC5B,IAAI,EAAE,KAAK,CAAC,aAAa,CAAC,KAAK,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC,CAAC;IACzD,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,SAAS,CAAC;IAChB,QAAQ,EAAE,OAAO,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,sBAAsB,GAAG,IAAI,CACvC,KAAK,CAAC,cAAc,CAAC,OAAO,UAAU,CAAC,EACvC,UAAU,GAAG,cAAc,GAAG,eAAe,GAAG,OAAO,CACxD,GAAG;IACF,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,qBAAqB,CAAC;IAC9B,aAAa,EAAE,CAAC,KAAK,EAAE,SAAS,KAAK,IAAI,CAAC;IAC1C,UAAU,CAAC,EAAE,CAAC,MAAM,EAAE,eAAe,KAAK,KAAK,CAAC,SAAS,CAAC;IAC1D,KAAK,EAAE,SAAS,CAAC;CAClB,CAAC;AAQF;;;;;;;;;GASG;AACH,iBAAS,iBAAiB,CAAC,EACzB,YAAY,EAAE,SAAS,EACvB,SAAS,EACT,OAAe,EACf,QAAQ,EACR,aAAa,EACb,MAAM,EACN,aAAa,EACb,UAAU,EACV,KAAK,EACL,GAAG,KAAK,EACT,EAAE,sBAAsB,qBA6CxB;AAED,OAAO,EAAE,iBAAiB,EAAE,CAAC;AAE7B;;;;;;;;;;GAUG;AACH,wBAAgB,aAAa,CAAC,EAC5B,KAAK,EACL,MAAM,EACN,KAAK,EACL,aAAa,EACb,QAAQ,GACT,EAAE;IACD,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,qBAAqB,CAAC;IAC9B,KAAK,EAAE,SAAS,CAAC;IACjB,aAAa,EAAE,CAAC,KAAK,EAAE,SAAS,KAAK,IAAI,CAAC;IAC1C,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB,qBAoBA"}