@nadicodeai/ui 12.1.96 → 12.1.98

package/dist/components/slider.d.ts

@@ -1,4 +1,18 @@
 import { Slider as SliderPrimitive } from "@base-ui/react/slider";
+/**
+ * A bounded number chosen by a thumb's position on a track.
+ *
+ * @family Inputs
+ * @when A bounded number where the position matters more than the digit: a limit, a share.
+ * @instead An exact number is `Input`; pair the two when precision counts. A few named levels are
+ * radios.
+ * @behaviour A 4 px track, the filled part in ink, a 12 px thumb edged in the input grey. Hover,
+ * drag and focus outline the thumb. Arrows step, Page Up and Down jump, Home and End reach the
+ * bounds. The thumb's touch target is 44 px.
+ * @words The label names the quantity; the current value and its unit are always written beside it
+ * (*€ 400*). The help states the bounds and the step.
+ * @access `role="slider"` with a name, min, max and `aria-valuetext` carrying the unit.
+ */
 declare function Slider({ className, defaultValue, value, min, max, ...props }: SliderPrimitive.Root.Props): import("react").JSX.Element;
 export { Slider };
 //# sourceMappingURL=slider.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"slider.d.ts","sourceRoot":"","sources":["../../src/components/slider.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,IAAI,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAIlE,iBAAS,MAAM,CAAC,EACd,SAAS,EACT,YAAY,EACZ,KAAK,EACL,GAAO,EACP,GAAS,EACT,GAAG,KAAK,EACT,EAAE,eAAe,CAAC,IAAI,CAAC,KAAK,+BAsC5B;AAED,OAAO,EAAE,MAAM,EAAE,CAAC"}
+{"version":3,"file":"slider.d.ts","sourceRoot":"","sources":["../../src/components/slider.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,IAAI,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAIlE;;;;;;;;;;;;;GAaG;AACH,iBAAS,MAAM,CAAC,EACd,SAAS,EACT,YAAY,EACZ,KAAK,EACL,GAAO,EACP,GAAS,EACT,GAAG,KAAK,EACT,EAAE,eAAe,CAAC,IAAI,CAAC,KAAK,+BAsC5B;AAED,OAAO,EAAE,MAAM,EAAE,CAAC"}

package/dist/components/slider.js

@@ -1,6 +1,20 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { Slider as SliderPrimitive } from "@base-ui/react/slider";
 import { cn } from "../lib/utils.js";
+/**
+ * A bounded number chosen by a thumb's position on a track.
+ *
+ * @family Inputs
+ * @when A bounded number where the position matters more than the digit: a limit, a share.
+ * @instead An exact number is `Input`; pair the two when precision counts. A few named levels are
+ * radios.
+ * @behaviour A 4 px track, the filled part in ink, a 12 px thumb edged in the input grey. Hover,
+ * drag and focus outline the thumb. Arrows step, Page Up and Down jump, Home and End reach the
+ * bounds. The thumb's touch target is 44 px.
+ * @words The label names the quantity; the current value and its unit are always written beside it
+ * (*€ 400*). The help states the bounds and the step.
+ * @access `role="slider"` with a name, min, max and `aria-valuetext` carrying the unit.
+ */
 function Slider({ className, defaultValue, value, min = 0, max = 100, ...props }) {
     const _values = Array.isArray(value)
         ? value

package/dist/components/sonner.d.ts

@@ -1,4 +1,22 @@
 import { type ToasterProps } from "sonner";
+/**
+ * The one place toasts appear, mounted once per product.
+ *
+ * @family Feedback
+ * @when One acknowledgement of an action the person took, when the result is not already visible
+ * where they are looking; and the Undo of a reversible removal. Mount it once; raise toasts through
+ * `toast`.
+ * @instead For a failure that must stay, use `MessageNotice` by the control. For unsaved work,
+ * failed payment or lost access never a toast alone. For a condition use a banner.
+ * @behaviour Tone `success`, `info`, `warning`, `error`; mark in the deep step. The first action
+ * with a handler becomes its one button. Undo only where a safe rollback exists. A toast that stays
+ * up shows the waiting line, not a spinner.
+ * @words Completion is noun, past participle: *Mailbox removed*, *Agent created*, paired one to one
+ * with its button *Remove mailbox*. No *successfully*, no exclamation.
+ * @access Announced by the toaster's live region. Never the only route to recovery: the record's
+ * own row keeps its controls. Undo is reachable by keyboard (Alt+T moves focus to the toasts) while
+ * it shows.
+ */
 declare const Toaster: ({ ...props }: ToasterProps) => import("react").JSX.Element;
 export { Toaster };
 //# sourceMappingURL=sonner.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"sonner.d.ts","sourceRoot":"","sources":["../../src/components/sonner.tsx"],"names":[],"mappings":"AAGA,OAAO,EAAqB,KAAK,YAAY,EAAE,MAAM,QAAQ,CAAC;AAM9D,QAAA,MAAM,OAAO,GAAI,cAAc,YAAY,gCAiC1C,CAAC;AAEF,OAAO,EAAE,OAAO,EAAE,CAAC"}
+{"version":3,"file":"sonner.d.ts","sourceRoot":"","sources":["../../src/components/sonner.tsx"],"names":[],"mappings":"AAGA,OAAO,EAAqB,KAAK,YAAY,EAAE,MAAM,QAAQ,CAAC;AAM9D;;;;;;;;;;;;;;;;;GAiBG;AACH,QAAA,MAAM,OAAO,GAAI,cAAc,YAAY,gCAiC1C,CAAC;AAEF,OAAO,EAAE,OAAO,EAAE,CAAC"}

package/dist/components/sonner.js

@@ -5,6 +5,24 @@ import { Toaster as Sonner } from "sonner";
 import { CircleCheckIcon, InfoIcon, TriangleAlertIcon, OctagonXIcon } from "lucide-react";
 import { WaitingLine } from "./waiting-line.js";
 import { isThemeMode } from "../lib/theme-mode.js";
+/**
+ * The one place toasts appear, mounted once per product.
+ *
+ * @family Feedback
+ * @when One acknowledgement of an action the person took, when the result is not already visible
+ * where they are looking; and the Undo of a reversible removal. Mount it once; raise toasts through
+ * `toast`.
+ * @instead For a failure that must stay, use `MessageNotice` by the control. For unsaved work,
+ * failed payment or lost access never a toast alone. For a condition use a banner.
+ * @behaviour Tone `success`, `info`, `warning`, `error`; mark in the deep step. The first action
+ * with a handler becomes its one button. Undo only where a safe rollback exists. A toast that stays
+ * up shows the waiting line, not a spinner.
+ * @words Completion is noun, past participle: *Mailbox removed*, *Agent created*, paired one to one
+ * with its button *Remove mailbox*. No *successfully*, no exclamation.
+ * @access Announced by the toaster's live region. Never the only route to recovery: the record's
+ * own row keeps its controls. Undo is reachable by keyboard (Alt+T moves focus to the toasts) while
+ * it shows.
+ */
 const Toaster = ({ ...props }) => {
     const { theme = "system" } = useTheme();
     return (_jsx(Sonner, { theme: isThemeMode(theme) ? theme : "system", className: "toaster group", icons: {

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

@@ -7,8 +7,19 @@ type StatusBadgeProps = Omit<ComponentProps<"span">, "children"> & {
     since?: string;
 };
 /**
- * A status is a mark and a word in one of five tones. The caller
- * owns which tone a state takes and the wording; this owns how the tone looks.
+ * A record's state: a mark and a word in one of five tones.
+ *
+ * @family Status
+ * @when A record's state, when it sets the row apart: failed, waiting on a person, a step in
+ * motion, paused, connected. Gray is every terminal state that needs no action.
+ * @instead For a category (an installation, a partner) use `Tag`. For a control reporting its own
+ * action use `ActionStatus`. For a mark beside a word that already names the state, `StatusDot`.
+ * @behaviour Still: a status never moves and is never a button. Each app keeps one value-to-tone
+ * map in one module; nothing else picks a status colour. A healthy record shows no badge.
+ * @words A state, not a verb: *Failed*, *Waiting for you*. Sentence case, one to three words, no
+ * trailing ellipsis. Italian runs a third longer: *In attesa di te*.
+ * @access The word is the name; the mark is `aria-hidden` and repeats the tone as a shape, so
+ * colour never carries the state alone. Not focusable.
  */
 declare function StatusBadge({ tone, label, since, className, ...props }: StatusBadgeProps): import("react").JSX.Element;
 export { StatusBadge, type StatusBadgeProps, type StatusBadgeTone };

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

@@ -1 +1 @@
-{"version":3,"file":"status-badge.d.ts","sourceRoot":"","sources":["../../src/components/status-badge.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,OAAO,CAAC;AAM5C,KAAK,eAAe,GAAG,SAAS,GAAG,SAAS,GAAG,QAAQ,GAAG,MAAM,GAAG,SAAS,CAAC;AAsB7E,KAAK,gBAAgB,GAAG,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,EAAE,UAAU,CAAC,GAAG;IACjE,IAAI,EAAE,eAAe,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,2EAA2E;IAC3E,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF;;;GAGG;AACH,iBAAS,WAAW,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,gBAAgB,+BAkBjF;AAED,OAAO,EAAE,WAAW,EAAE,KAAK,gBAAgB,EAAE,KAAK,eAAe,EAAE,CAAC"}
+{"version":3,"file":"status-badge.d.ts","sourceRoot":"","sources":["../../src/components/status-badge.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,OAAO,CAAC;AAM5C,KAAK,eAAe,GAAG,SAAS,GAAG,SAAS,GAAG,QAAQ,GAAG,MAAM,GAAG,SAAS,CAAC;AAoB7E,KAAK,gBAAgB,GAAG,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,EAAE,UAAU,CAAC,GAAG;IACjE,IAAI,EAAE,eAAe,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,2EAA2E;IAC3E,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF;;;;;;;;;;;;;;GAcG;AACH,iBAAS,WAAW,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,gBAAgB,+BAmBjF;AAED,OAAO,EAAE,WAAW,EAAE,KAAK,gBAAgB,EAAE,KAAK,eAAe,EAAE,CAAC"}

package/dist/components/status-badge.js

@@ -2,12 +2,12 @@ import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { CircleCheck, CircleDot, CirclePause, CircleX, Clock } from "lucide-react";
 import { Badge } from "./badge.js";
 import { cn } from "../lib/utils.js";
-const VARIANT_BY_TONE = {
-    success: "green",
-    warning: "amber",
-    danger: "red",
-    info: "blue",
-    neutral: "gray",
+const FILL_BY_TONE = {
+    success: { name: "green", classes: "bg-success-soft text-success-soft-foreground" },
+    warning: { name: "amber", classes: "bg-warning-soft text-warning-soft-foreground" },
+    danger: { name: "red", classes: "bg-destructive-soft text-destructive-soft-foreground" },
+    info: { name: "blue", classes: "bg-info-soft text-info-soft-foreground" },
+    neutral: { name: "gray", classes: "bg-accent text-muted-foreground" },
 };
 // One mark per tone, always the same one: the tone said again as a shape, so a
 // status reads without colour. The info dot is filled and still.
@@ -19,11 +19,23 @@ const MARK_BY_TONE = {
     neutral: CirclePause,
 };
 /**
- * A status is a mark and a word in one of five tones. The caller
- * owns which tone a state takes and the wording; this owns how the tone looks.
+ * A record's state: a mark and a word in one of five tones.
+ *
+ * @family Status
+ * @when A record's state, when it sets the row apart: failed, waiting on a person, a step in
+ * motion, paused, connected. Gray is every terminal state that needs no action.
+ * @instead For a category (an installation, a partner) use `Tag`. For a control reporting its own
+ * action use `ActionStatus`. For a mark beside a word that already names the state, `StatusDot`.
+ * @behaviour Still: a status never moves and is never a button. Each app keeps one value-to-tone
+ * map in one module; nothing else picks a status colour. A healthy record shows no badge.
+ * @words A state, not a verb: *Failed*, *Waiting for you*. Sentence case, one to three words, no
+ * trailing ellipsis. Italian runs a third longer: *In attesa di te*.
+ * @access The word is the name; the mark is `aria-hidden` and repeats the tone as a shape, so
+ * colour never carries the state alone. Not focusable.
  */
 function StatusBadge({ tone, label, since, className, ...props }) {
     const Mark = MARK_BY_TONE[tone];
-    return (_jsxs(Badge, { variant: VARIANT_BY_TONE[tone], className: cn("has-data-[icon=inline-start]:pl-2", className), ...props, children: [_jsx(Mark, { "aria-hidden": "true", "data-icon": "inline-start" }), label, since ? (_jsx("span", { className: "tabular-nums", "data-slot": "status-badge-since", children: since })) : null] }));
+    const fill = FILL_BY_TONE[tone];
+    return (_jsxs(Badge, { className: cn(fill.classes, "has-data-[icon=inline-start]:pl-2", className), "data-variant": fill.name, ...props, children: [_jsx(Mark, { "aria-hidden": "true", "data-icon": "inline-start" }), label, since ? (_jsx("span", { className: "tabular-nums", "data-slot": "status-badge-since", children: since })) : null] }));
 }
 export { StatusBadge };

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

@@ -3,6 +3,18 @@ type StatusTone = "good" | "muted" | "warn" | "bad";
 interface StatusDotProps extends ComponentProps<"span"> {
     tone: StatusTone;
 }
+/**
+ * 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.
+ */
 declare function StatusDot({ className, tone, ...props }: StatusDotProps): import("react").JSX.Element;
 export { StatusDot };
 export type { StatusTone };

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

@@ -1 +1 @@
-{"version":3,"file":"status-dot.d.ts","sourceRoot":"","sources":["../../src/components/status-dot.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,OAAO,CAAC;AAG5C,KAAK,UAAU,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,GAAG,KAAK,CAAC;AAQpD,UAAU,cAAe,SAAQ,cAAc,CAAC,MAAM,CAAC;IACrD,IAAI,EAAE,UAAU,CAAC;CAClB;AACD,iBAAS,SAAS,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,GAAG,KAAK,EAAE,EAAE,cAAc,+BAU/D;AACD,OAAO,EAAE,SAAS,EAAE,CAAC;AACrB,YAAY,EAAE,UAAU,EAAE,CAAC"}
+{"version":3,"file":"status-dot.d.ts","sourceRoot":"","sources":["../../src/components/status-dot.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,OAAO,CAAC;AAG5C,KAAK,UAAU,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,GAAG,KAAK,CAAC;AAQpD,UAAU,cAAe,SAAQ,cAAc,CAAC,MAAM,CAAC;IACrD,IAAI,EAAE,UAAU,CAAC;CAClB;AACD;;;;;;;;;;;GAWG;AACH,iBAAS,SAAS,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,GAAG,KAAK,EAAE,EAAE,cAAc,+BAU/D;AACD,OAAO,EAAE,SAAS,EAAE,CAAC;AACrB,YAAY,EAAE,UAAU,EAAE,CAAC"}

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"}