@adminiumjs/ui 0.2.9 → 0.3.0-rc.0

package/dist/components/month-calendar/MonthCalendar.d.ts

@@ -0,0 +1,46 @@
+export interface MonthCalendarProps {
+    /** The month on screen, as `YYYY-MM`. Controlled: the arrows report, never set. */
+    month: string;
+    onMonth: (month: string) => void;
+    /** The chosen day, `YYYY-MM-DD`, or null. */
+    value: string | null;
+    onChange: (day: string) => void;
+    /** Days nothing can be put on — struck through and inert (comp 634–652). */
+    unavailable?: readonly string[] | undefined;
+    /** Nothing before this day may be chosen; `YYYY-MM-DD`. */
+    min?: string | undefined;
+    locale?: string | undefined;
+    /** Accessible names — this package ships no copy. */
+    labels: {
+        previous: string;
+        next: string;
+        month: (month: string) => string;
+    };
+    className?: string | undefined;
+}
+/**
+ * MonthCalendar — the month grid (comp
+ * 322–334, 634–652).
+ *
+ * ─── A real calendar, in the reader's own week ─────────────────────────────
+ *
+ * The comp's grid is a fixed 7 × 5 with a hardcoded offset, and it puts
+ * 1 September 2026 on a Wednesday — it is a Tuesday. It also gives the month
+ * arrows no handlers. Both are drawing conveniences in a mock-up and both are
+ * defects in a product, so this computes the month from the calendar, starts
+ * the week where the reader's locale starts it, and moves.
+ *
+ * ─── Unavailable is INERT, not just decorated ──────────────────────────────
+ *
+ * A struck-through day that still accepts a click is a screen that takes a
+ * booking it has already said it cannot take. `disabled` carries that to the
+ * keyboard and to a screen reader as well as to the eye.
+ *
+ * ─── Height is fixed by the grid, not by the month ─────────────────────────
+ *
+ * `monthGrid` pads to whole weeks, so February and August are the same height
+ * and the legend under the calendar does not jump a line when the month
+ * changes.
+ */
+export declare function MonthCalendar({ month, onMonth, value, onChange, unavailable, min, locale, labels, className, }: MonthCalendarProps): import("react").JSX.Element;
+//# sourceMappingURL=MonthCalendar.d.ts.map

package/dist/components/month-calendar/MonthCalendar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MonthCalendar.d.ts","sourceRoot":"","sources":["../../../src/components/month-calendar/MonthCalendar.tsx"],"names":[],"mappings":"AAQA,MAAM,WAAW,kBAAkB;IACjC,mFAAmF;IACnF,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACjC,6CAA6C;IAC7C,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,QAAQ,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IAChC,4EAA4E;IAC5E,WAAW,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,CAAC;IAC5C,2DAA2D;IAC3D,GAAG,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACzB,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,qDAAqD;IACrD,MAAM,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,CAAA;KAAE,CAAC;IAC7E,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAChC;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,aAAa,CAAC,EAC5B,KAAK,EACL,OAAO,EACP,KAAK,EACL,QAAQ,EACR,WAAW,EACX,GAAG,EACH,MAAM,EACN,MAAM,EACN,SAAS,GACV,EAAE,kBAAkB,+BAgFpB"}

package/dist/components/month-calendar/MonthCalendar.js

@@ -0,0 +1,55 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+// SPDX-License-Identifier: AGPL-3.0-only
+import { useMemo } from 'react';
+import { ChevronLeft, ChevronRight } from 'lucide-react';
+import { cn } from '../../lib/cn.js';
+import { dayKey, monthGrid, weekdayInitials } from '../../lib/week.js';
+import { IconButton } from '../icon-button/IconButton.js';
+/**
+ * MonthCalendar — the month grid (comp
+ * 322–334, 634–652).
+ *
+ * ─── A real calendar, in the reader's own week ─────────────────────────────
+ *
+ * The comp's grid is a fixed 7 × 5 with a hardcoded offset, and it puts
+ * 1 September 2026 on a Wednesday — it is a Tuesday. It also gives the month
+ * arrows no handlers. Both are drawing conveniences in a mock-up and both are
+ * defects in a product, so this computes the month from the calendar, starts
+ * the week where the reader's locale starts it, and moves.
+ *
+ * ─── Unavailable is INERT, not just decorated ──────────────────────────────
+ *
+ * A struck-through day that still accepts a click is a screen that takes a
+ * booking it has already said it cannot take. `disabled` carries that to the
+ * keyboard and to a screen reader as well as to the eye.
+ *
+ * ─── Height is fixed by the grid, not by the month ─────────────────────────
+ *
+ * `monthGrid` pads to whole weeks, so February and August are the same height
+ * and the legend under the calendar does not jump a line when the month
+ * changes.
+ */
+export function MonthCalendar({ month, onMonth, value, onChange, unavailable, min, locale, labels, className, }) {
+    const [year, monthIndex] = useMemo(() => {
+        const [y, m] = month.split('-');
+        return [Number(y), Number(m) - 1];
+    }, [month]);
+    const cells = useMemo(() => monthGrid(year, monthIndex, locale), [year, monthIndex, locale]);
+    const initials = useMemo(() => weekdayInitials(locale), [locale]);
+    const blocked = useMemo(() => new Set(unavailable ?? []), [unavailable]);
+    const title = useMemo(() => new Intl.DateTimeFormat(locale, { month: 'long', year: 'numeric' }).format(new Date(year, monthIndex, 1)), [year, monthIndex, locale]);
+    const shift = (by) => {
+        const next = new Date(year, monthIndex + by, 1);
+        onMonth(`${String(next.getFullYear()).padStart(4, '0')}-${String(next.getMonth() + 1).padStart(2, '0')}`);
+    };
+    return (_jsxs("div", { className: cn('min-w-0', className), "data-testid": "month-calendar", children: [_jsxs("div", { className: "mb-3.5 flex items-center justify-between", children: [_jsx("span", { className: "text-[13.5px] font-extrabold text-fg", children: title }), _jsxs("div", { className: "flex gap-1.5", children: [_jsx(IconButton, { variant: "bordered", size: "sm", label: labels.previous, onClick: () => shift(-1), children: _jsx(ChevronLeft, { className: "size-3.5" }) }), _jsx(IconButton, { variant: "bordered", size: "sm", label: labels.next, onClick: () => shift(1), children: _jsx(ChevronRight, { className: "size-3.5" }) })] })] }), _jsx("div", { className: "mb-1.5 grid grid-cols-7 gap-1", "aria-hidden": "true", children: initials.map((initial, index) => (_jsx("span", { className: "text-center text-[10.5px] font-bold text-fg-subtle", children: initial }, index))) }), _jsx("div", { className: "grid grid-cols-7 gap-1", role: "group", "aria-label": labels.month(title), children: cells.map((day, index) => {
+                    if (day === null)
+                        return _jsx("span", { className: "h-[34px]" }, index);
+                    const key = dayKey(day);
+                    const taken = blocked.has(key);
+                    const past = min !== undefined && key < min;
+                    const chosen = key === value;
+                    return (_jsx("button", { type: "button", disabled: taken || past, "aria-pressed": chosen, "aria-label": new Intl.DateTimeFormat(locale, { dateStyle: 'full' }).format(day), "data-testid": `calendar-day-${key}`, onClick: () => onChange(key), className: cn('h-[34px] rounded-[9px] border border-transparent font-mono text-[12.5px] font-semibold', 'focus-visible:outline-2 focus-visible:outline-offset-1 focus-visible:outline-accent', chosen && 'bg-accent font-extrabold text-accent-fg', !chosen && taken && 'bg-surface-3 text-fg-subtle line-through', !chosen && past && 'text-fg-subtle', !chosen && !taken && !past && 'text-fg hover:bg-surface-2'), children: day.getDate() }, key));
+                }) })] }));
+}
+//# sourceMappingURL=MonthCalendar.js.map

package/dist/components/month-calendar/MonthCalendar.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MonthCalendar.js","sourceRoot":"","sources":["../../../src/components/month-calendar/MonthCalendar.tsx"],"names":[],"mappings":"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"}

package/dist/components/month-calendar/index.d.ts

@@ -0,0 +1,2 @@
+export { MonthCalendar, type MonthCalendarProps } from './MonthCalendar.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/components/month-calendar/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/month-calendar/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,KAAK,kBAAkB,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/components/month-calendar/index.js

@@ -0,0 +1,3 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+export { MonthCalendar } from './MonthCalendar.js';
+//# sourceMappingURL=index.js.map

package/dist/components/month-calendar/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/components/month-calendar/index.ts"],"names":[],"mappings":"AAAA,yCAAyC;AACzC,OAAO,EAAE,aAAa,EAA2B,MAAM,oBAAoB,CAAC"}

package/dist/components/number-stepper/NumberStepper.d.ts

@@ -16,14 +16,28 @@ export interface NumberStepperProps extends Omit<React.ComponentPropsWithRef<'in
     decrementLabel: string;
     /** Danger border + focus ring + `aria-invalid`. */
     error?: boolean | undefined;
+    /**
+     * `field` (default) is the chevron column inside the input's chrome — the
+     * shape every existing caller renders. `buttons` is the design comp's own:
+     * a −, a big mono value and a ＋,
+     * each a 34px bordered square, with the unit beside them.
+     *
+     * Two layouts rather than two components because it is one control with one
+     * contract: the same value, the same bounds, the same step, the same
+     * `spinbutton` semantics. What differs is how much room the number is given,
+     * and that is a caller's decision.
+     */
+    layout?: 'field' | 'buttons' | undefined;
+    /** The word after the number in the `buttons` layout: "guests", "seats". */
+    unit?: string | undefined;
     /** Extra classes for the inner `<input>` (className styles the wrapper). */
     inputClassName?: string | undefined;
 }
 /**
  * NumberStepper — mono `input[type=number]` (native `spinbutton`: typed
  * input, ↑↓ arrow keys) plus a chevron up/down column honoring
- * min/max/step (research/design-system.md §3 Tier 2). The chevron buttons
+ * min/max/step (research/design-system.md Tier 2). The chevron buttons
  * are `tabIndex={-1}` — keyboard users step with the arrow keys.
  */
-export declare function NumberStepper({ className, inputClassName, value, defaultValue, onValueChange, min, max, step, incrementLabel, decrementLabel, error, disabled, ref, ...inputProps }: NumberStepperProps): React.JSX.Element;
+export declare function NumberStepper({ className, inputClassName, value, defaultValue, onValueChange, min, max, step, incrementLabel, decrementLabel, error, layout, unit, disabled, ref, ...inputProps }: NumberStepperProps): React.JSX.Element;
 //# sourceMappingURL=NumberStepper.d.ts.map

package/dist/components/number-stepper/NumberStepper.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"NumberStepper.d.ts","sourceRoot":"","sources":["../../../src/components/number-stepper/NumberStepper.tsx"],"names":[],"mappings":"AAGA,OAAO,KAAK,KAAK,KAAK,MAAM,OAAO,CAAC;AAIpC,MAAM,WAAW,kBACf,SAAQ,IAAI,CACV,KAAK,CAAC,qBAAqB,CAAC,OAAO,CAAC,EACpC,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,cAAc,GAAG,UAAU,GAAG,KAAK,GAAG,KAAK,GAAG,MAAM,CAC3F;IACD,iDAAiD;IACjD,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IAClC,kCAAkC;IAClC,YAAY,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAClC,+EAA+E;IAC/E,aAAa,CAAC,EAAE,CAAC,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,CAAC,GAAG,SAAS,CAAC;IAC7D,GAAG,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACzB,GAAG,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACzB,iBAAiB;IACjB,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,iDAAiD;IACjD,cAAc,EAAE,MAAM,CAAC;IACvB,mDAAmD;IACnD,cAAc,EAAE,MAAM,CAAC;IACvB,mDAAmD;IACnD,KAAK,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC5B,4EAA4E;IAC5E,cAAc,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACrC;AASD;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,EAC5B,SAAS,EACT,cAAc,EACd,KAAK,EACL,YAAY,EACZ,aAAa,EACb,GAAG,EACH,GAAG,EACH,IAAQ,EACR,cAAc,EACd,cAAc,EACd,KAAa,EACb,QAAQ,EACR,GAAG,EACH,GAAG,UAAU,EACd,EAAE,kBAAkB,qBAuFpB"}
+{"version":3,"file":"NumberStepper.d.ts","sourceRoot":"","sources":["../../../src/components/number-stepper/NumberStepper.tsx"],"names":[],"mappings":"AAGA,OAAO,KAAK,KAAK,KAAK,MAAM,OAAO,CAAC;AAIpC,MAAM,WAAW,kBACf,SAAQ,IAAI,CACV,KAAK,CAAC,qBAAqB,CAAC,OAAO,CAAC,EACpC,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,cAAc,GAAG,UAAU,GAAG,KAAK,GAAG,KAAK,GAAG,MAAM,CAC3F;IACD,iDAAiD;IACjD,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IAClC,kCAAkC;IAClC,YAAY,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAClC,+EAA+E;IAC/E,aAAa,CAAC,EAAE,CAAC,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,CAAC,GAAG,SAAS,CAAC;IAC7D,GAAG,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACzB,GAAG,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACzB,iBAAiB;IACjB,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,iDAAiD;IACjD,cAAc,EAAE,MAAM,CAAC;IACvB,mDAAmD;IACnD,cAAc,EAAE,MAAM,CAAC;IACvB,mDAAmD;IACnD,KAAK,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC5B;;;;;;;;;;OAUG;IACH,MAAM,CAAC,EAAE,OAAO,GAAG,SAAS,GAAG,SAAS,CAAC;IACzC,4EAA4E;IAC5E,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,4EAA4E;IAC5E,cAAc,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACrC;AASD;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,EAC5B,SAAS,EACT,cAAc,EACd,KAAK,EACL,YAAY,EACZ,aAAa,EACb,GAAG,EACH,GAAG,EACH,IAAQ,EACR,cAAc,EACd,cAAc,EACd,KAAa,EACb,MAAgB,EAChB,IAAI,EACJ,QAAQ,EACR,GAAG,EACH,GAAG,UAAU,EACd,EAAE,kBAAkB,qBAyJpB"}

package/dist/components/number-stepper/NumberStepper.js

@@ -1,6 +1,6 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 // SPDX-License-Identifier: AGPL-3.0-only
-import { ChevronDown, ChevronUp } from 'lucide-react';
+import { ChevronDown, ChevronUp, Minus, Plus } from 'lucide-react';
 import { useRef, useState } from 'react';
 import { cn } from '../../lib/cn.js';
 function clamp(next, min, max) {
@@ -14,10 +14,10 @@ function clamp(next, min, max) {
 /**
  * NumberStepper — mono `input[type=number]` (native `spinbutton`: typed
  * input, ↑↓ arrow keys) plus a chevron up/down column honoring
- * min/max/step (research/design-system.md §3 Tier 2). The chevron buttons
+ * min/max/step (research/design-system.md Tier 2). The chevron buttons
  * are `tabIndex={-1}` — keyboard users step with the arrow keys.
  */
-export function NumberStepper({ className, inputClassName, value, defaultValue, onValueChange, min, max, step = 1, incrementLabel, decrementLabel, error = false, disabled, ref, ...inputProps }) {
+export function NumberStepper({ className, inputClassName, value, defaultValue, onValueChange, min, max, step = 1, incrementLabel, decrementLabel, error = false, layout = 'field', unit, disabled, ref, ...inputProps }) {
     const innerRef = useRef(null);
     const [internal, setInternal] = useState(defaultValue ?? null);
     const isControlled = value !== undefined;
@@ -41,8 +41,27 @@ export function NumberStepper({ className, inputClassName, value, defaultValue,
     };
     const atMin = current !== null && min !== undefined && current <= min;
     const atMax = current !== null && max !== undefined && current >= max;
+    const bigButtonClasses = 'flex size-[34px] shrink-0 items-center justify-center rounded-md border border-border-strong bg-surface text-fg-muted ' +
+        'transition-colors hover:bg-surface-2 disabled:pointer-events-none disabled:opacity-40 ' +
+        'focus-visible:outline-2 focus-visible:outline-offset-2 focus-visible:outline-accent';
     const stepperButtonClasses = 'flex h-1/2 w-6 items-center justify-center text-fg-subtle transition-colors hover:bg-surface-3 hover:text-fg ' +
         'disabled:pointer-events-none disabled:opacity-40 focus-visible:outline-2 focus-visible:-outline-offset-2 focus-visible:outline-accent';
+    if (layout === 'buttons') {
+        /*
+         * The value is a `spinbutton` in its own right — NOT a number input made to
+         * look like text. Arrow keys, Home/End and a typed value all have to keep
+         * working: the comp draws two buttons and a number, and a person who
+         * reaches it by keyboard still expects to type into it.
+         */
+        return (_jsxs("div", { className: cn('flex items-center gap-2.5', disabled === true && 'opacity-40', className), children: [_jsx("button", { type: "button", "aria-label": decrementLabel, disabled: disabled === true || atMin, onClick: () => stepBy(-1), className: bigButtonClasses, children: _jsx(Minus, { "aria-hidden": "true", className: "size-[15px]" }) }), _jsx("input", { ref: setRef, type: "number", inputMode: "numeric", value: current ?? '', onChange: (event) => {
+                        const parsed = event.target.value === '' ? null : event.target.valueAsNumber;
+                        commit(parsed === null || Number.isNaN(parsed) ? null : parsed);
+                    }, ...(min !== undefined ? { min } : {}), ...(max !== undefined ? { max } : {}), step: step, disabled: disabled, ...(error ? { 'aria-invalid': true } : {}), className: cn('min-w-[3ch] bg-transparent text-center font-mono text-[15px] font-extrabold tabular-nums text-fg', 'focus:outline-none focus-visible:outline-2 focus-visible:outline-offset-2 focus-visible:outline-accent', '[appearance:textfield] [&::-webkit-inner-spin-button]:appearance-none [&::-webkit-outer-spin-button]:appearance-none', 'w-[var(--adm-stepper-width)]', inputClassName), 
+                    // The field grows with the number it holds, so the width is a value
+                    // rather than a class — through a custom property, the one shape the
+                    // tokens-only rule allows.
+                    style: { '--adm-stepper-width': `${String(Math.max(String(current ?? '').length, 2))}ch` }, ...inputProps }), _jsx("button", { type: "button", "aria-label": incrementLabel, disabled: disabled === true || atMax, onClick: () => stepBy(1), className: bigButtonClasses, children: _jsx(Plus, { "aria-hidden": "true", className: "size-[15px]" }) }), unit === undefined ? null : (_jsx("span", { className: "ms-0.5 text-caption text-fg-subtle", children: unit }))] }));
+    }
     return (_jsxs("div", { "data-invalid": error ? '' : undefined, className: cn('flex h-[34px] w-full min-w-0 items-stretch overflow-hidden rounded-md border border-border-strong bg-surface-2', 'transition-[border-color,box-shadow] duration-150', 'focus-within:border-accent focus-within:ring-[3px] focus-within:ring-accent-soft', 'has-[input:disabled]:pointer-events-none has-[input:disabled]:opacity-40', 'data-[invalid]:border-danger data-[invalid]:focus-within:ring-danger-soft', className), children: [_jsx("input", { ref: setRef, type: "number", inputMode: "decimal", value: current ?? '', onChange: (event) => {
                     const parsed = event.target.value === '' ? null : event.target.valueAsNumber;
                     commit(parsed === null || Number.isNaN(parsed) ? null : parsed);

package/dist/components/number-stepper/NumberStepper.js.map

@@ -1 +1 @@
-{"version":3,"file":"NumberStepper.js","sourceRoot":"","sources":["../../../src/components/number-stepper/NumberStepper.tsx"],"names":[],"mappings":"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"}
+{"version":3,"file":"NumberStepper.js","sourceRoot":"","sources":["../../../src/components/number-stepper/NumberStepper.tsx"],"names":[],"mappings":"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"}

package/dist/components/pagination/Pagination.d.ts

@@ -20,7 +20,7 @@ export declare function paginationRange(page: number, pageCount: number, sibling
 /**
  * Pagination — 32px square page buttons (active = accent fill), mono numbers,
  * RTL-mirrored chevrons, ellipsis windowing
- * (research/design-system.md §3 Tier 3).
+ * (research/design-system.md Tier 3).
  */
 export declare function Pagination({ page, pageCount, onPageChange, siblingCount, label, previousLabel, nextLabel, pageLabel, className, ...props }: PaginationProps): import("react").JSX.Element;
 //# sourceMappingURL=Pagination.d.ts.map

package/dist/components/pagination/Pagination.js

@@ -26,7 +26,7 @@ const squareClasses = 'inline-flex size-8 shrink-0 items-center justify-center r
 /**
  * Pagination — 32px square page buttons (active = accent fill), mono numbers,
  * RTL-mirrored chevrons, ellipsis windowing
- * (research/design-system.md §3 Tier 3).
+ * (research/design-system.md Tier 3).
  */
 export function Pagination({ page, pageCount, onPageChange, siblingCount = 1, label, previousLabel, nextLabel, pageLabel, className, ...props }) {
     const range = paginationRange(page, pageCount, siblingCount);

package/dist/components/password-strength/PasswordStrength.d.ts

@@ -22,7 +22,7 @@ export interface PasswordStrengthProps extends ComponentPropsWithRef<'div'> {
 }
 /**
  * PasswordStrength — segmented 4-bar meter + tone-colored label, injectable
- * scoring (research/design-system.md §3 Tier 3, Auth screens). Announces via
+ * scoring (research/design-system.md Tier 3, Auth screens). Announces via
  * `role="meter"`; the label updates in an `aria-live` region.
  */
 export declare function PasswordStrength({ value, score, labels, label, className, ...props }: PasswordStrengthProps): import("react").JSX.Element;

package/dist/components/password-strength/PasswordStrength.js

@@ -33,7 +33,7 @@ const labelTone = {
 };
 /**
  * PasswordStrength — segmented 4-bar meter + tone-colored label, injectable
- * scoring (research/design-system.md §3 Tier 3, Auth screens). Announces via
+ * scoring (research/design-system.md Tier 3, Auth screens). Announces via
  * `role="meter"`; the label updates in an `aria-live` region.
  */
 export function PasswordStrength({ value, score = defaultPasswordScore, labels, label, className, ...props }) {

package/dist/components/permission-matrix/PermissionMatrix.d.ts

@@ -1,8 +1,8 @@
 import type * as React from 'react';
 /**
- * The RBAC grant-string grammar (apps/server/src/rbac/permissions.ts,
- * 08-server-api.md §5.1), mirrored as template-literal types so permission
- * keys are checked at the call site:
+ * The RBAC grant-string grammar (apps/server/src/rbac/permissions.ts),
+ * mirrored as template-literal types so permission keys are checked at the
+ * call site:
  *
  * ```
  * system:<area>:<verb>                    // closed set, e.g. system:roles:manage

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

@@ -11,7 +11,7 @@ export declare const PopoverClose: React.ForwardRefExoticComponent<PopoverPrimit
 export type PopoverContentProps = Omit<React.ComponentPropsWithRef<typeof PopoverPrimitive.Content>, 'style'>;
 /**
  * Popover — anchored panel on `--surface`, radius 14 (`rounded-lg`),
- * `--shadow-menu`, `nb-pop` entrance (research/design-system.md §3 Tier 3).
+ * `--shadow-menu`, `nb-pop` entrance (research/design-system.md Tier 3).
  * Focus is moved into the panel and trapped by Radix; Esc/outside-click
  * dismiss and return focus to the trigger.
  */

package/dist/components/popover/Popover.js

@@ -13,7 +13,7 @@ export const PopoverAnchor = PopoverPrimitive.Anchor;
 export const PopoverClose = PopoverPrimitive.Close;
 /**
  * Popover — anchored panel on `--surface`, radius 14 (`rounded-lg`),
- * `--shadow-menu`, `nb-pop` entrance (research/design-system.md §3 Tier 3).
+ * `--shadow-menu`, `nb-pop` entrance (research/design-system.md Tier 3).
  * Focus is moved into the panel and trapped by Radix; Esc/outside-click
  * dismiss and return focus to the trigger.
  */

package/dist/components/progress-bar/ProgressBar.d.ts

@@ -3,7 +3,7 @@ import type * as React from 'react';
 import type { Tone } from '../badge/Badge.js';
 /**
  * Pill progress track (surface-3) — 4/6/10px heights
- * (research/design-system.md §3 Tier 1).
+ * (research/design-system.md Tier 1).
  */
 export declare const progressBarVariants: (props?: ({
     size?: "sm" | "md" | "lg" | null | undefined;

package/dist/components/progress-bar/ProgressBar.js

@@ -4,7 +4,7 @@ import { cva } from 'class-variance-authority';
 import { cn } from '../../lib/cn.js';
 /**
  * Pill progress track (surface-3) — 4/6/10px heights
- * (research/design-system.md §3 Tier 1).
+ * (research/design-system.md Tier 1).
  */
 export const progressBarVariants = cva('w-full overflow-hidden rounded-full bg-surface-3', {
     variants: {
@@ -30,7 +30,7 @@ export function ProgressBar({ className, size, value, max = 100, tone = 'accent'
     const pct = (clamped / upper) * 100;
     return (_jsx("div", { role: "progressbar", "aria-valuemin": 0, "aria-valuemax": upper, "aria-valuenow": clamped, "aria-label": label, "data-tone": tone, className: cn(progressBarVariants({ size }), className), ...props, children: _jsx("div", { className: cn('h-full w-[var(--adm-progress)] rounded-full', FILL_TONE_CLASSES[tone], animated &&
                 'origin-[0%_50%] animate-[nb-grow_0.85s_cubic-bezier(.2,.7,.3,1)] [--nb-grow-x:0] [--nb-grow-y:1] rtl:origin-[100%_50%]'), 
-            // Sanctioned escape hatch: CSS custom properties only (02-design-system.md §8).
+            // Sanctioned escape hatch: CSS custom properties only.
             style: { '--adm-progress': `${pct}%` } }) }));
 }
 //# sourceMappingURL=ProgressBar.js.map

package/dist/components/progress-bar/ProgressBar.js.map

@@ -1 +1 @@
-{"version":3,"file":"ProgressBar.js","sourceRoot":"","sources":["../../../src/components/progress-bar/ProgressBar.tsx"],"names":[],"mappings":";AAAA,yCAAyC;AACzC,OAAO,EAAE,GAAG,EAAE,MAAM,0BAA0B,CAAC;AAI/C,OAAO,EAAE,EAAE,EAAE,MAAM,iBAAiB,CAAC;AAGrC;;;GAGG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,GAAG,CAAC,kDAAkD,EAAE;IACzF,QAAQ,EAAE;QACR,IAAI,EAAE;YACJ,EAAE,EAAE,KAAK;YACT,EAAE,EAAE,OAAO;YACX,EAAE,EAAE,OAAO;SACZ;KACF;IACD,eAAe,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE;CAChC,CAAC,CAAC;AAEH,MAAM,iBAAiB,GAAyB;IAC9C,OAAO,EAAE,cAAc;IACvB,MAAM,EAAE,WAAW;IACnB,GAAG,EAAE,QAAQ;IACb,IAAI,EAAE,SAAS;IACf,MAAM,EAAE,WAAW;IACnB,IAAI,EAAE,SAAS;CAChB,CAAC;AAiBF,MAAM,UAAU,WAAW,CAAC,EAC1B,SAAS,EACT,IAAI,EACJ,KAAK,EACL,GAAG,GAAG,GAAG,EACT,IAAI,GAAG,QAAQ,EACf,QAAQ,GAAG,IAAI,EACf,KAAK,EACL,GAAG,KAAK,EACS;IACjB,MAAM,KAAK,GAAG,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC;IAClC,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;IACpD,MAAM,GAAG,GAAG,CAAC,OAAO,GAAG,KAAK,CAAC,GAAG,GAAG,CAAC;IAEpC,OAAO,CACL,cACE,IAAI,EAAC,aAAa,mBACH,CAAC,mBACD,KAAK,mBACL,OAAO,gBACV,KAAK,eACN,IAAI,EACf,SAAS,EAAE,EAAE,CAAC,mBAAmB,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,SAAS,CAAC,KACnD,KAAK,YAET,cACE,SAAS,EAAE,EAAE,CACX,6CAA6C,EAC7C,iBAAiB,CAAC,IAAI,CAAC,EACvB,QAAQ;gBACN,wHAAwH,CAC3H;YACD,gFAAgF;YAChF,KAAK,EAAE,EAAE,gBAAgB,EAAE,GAAG,GAAG,GAAG,EAAE,GACtC,GACE,CACP,CAAC;AACJ,CAAC"}
+{"version":3,"file":"ProgressBar.js","sourceRoot":"","sources":["../../../src/components/progress-bar/ProgressBar.tsx"],"names":[],"mappings":";AAAA,yCAAyC;AACzC,OAAO,EAAE,GAAG,EAAE,MAAM,0BAA0B,CAAC;AAI/C,OAAO,EAAE,EAAE,EAAE,MAAM,iBAAiB,CAAC;AAGrC;;;GAGG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,GAAG,CAAC,kDAAkD,EAAE;IACzF,QAAQ,EAAE;QACR,IAAI,EAAE;YACJ,EAAE,EAAE,KAAK;YACT,EAAE,EAAE,OAAO;YACX,EAAE,EAAE,OAAO;SACZ;KACF;IACD,eAAe,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE;CAChC,CAAC,CAAC;AAEH,MAAM,iBAAiB,GAAyB;IAC9C,OAAO,EAAE,cAAc;IACvB,MAAM,EAAE,WAAW;IACnB,GAAG,EAAE,QAAQ;IACb,IAAI,EAAE,SAAS;IACf,MAAM,EAAE,WAAW;IACnB,IAAI,EAAE,SAAS;CAChB,CAAC;AAiBF,MAAM,UAAU,WAAW,CAAC,EAC1B,SAAS,EACT,IAAI,EACJ,KAAK,EACL,GAAG,GAAG,GAAG,EACT,IAAI,GAAG,QAAQ,EACf,QAAQ,GAAG,IAAI,EACf,KAAK,EACL,GAAG,KAAK,EACS;IACjB,MAAM,KAAK,GAAG,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC;IAClC,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;IACpD,MAAM,GAAG,GAAG,CAAC,OAAO,GAAG,KAAK,CAAC,GAAG,GAAG,CAAC;IAEpC,OAAO,CACL,cACE,IAAI,EAAC,aAAa,mBACH,CAAC,mBACD,KAAK,mBACL,OAAO,gBACV,KAAK,eACN,IAAI,EACf,SAAS,EAAE,EAAE,CAAC,mBAAmB,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,SAAS,CAAC,KACnD,KAAK,YAET,cACE,SAAS,EAAE,EAAE,CACX,6CAA6C,EAC7C,iBAAiB,CAAC,IAAI,CAAC,EACvB,QAAQ;gBACN,wHAAwH,CAC3H;YACD,uDAAuD;YACvD,KAAK,EAAE,EAAE,gBAAgB,EAAE,GAAG,GAAG,GAAG,EAAE,GACtC,GACE,CACP,CAAC;AACJ,CAAC"}

package/dist/components/radio/Radio.d.ts

@@ -18,8 +18,8 @@ export interface RadioProps extends Omit<React.ComponentPropsWithRef<typeof Radi
 }
 /**
  * Radio — dot radio, 18px circle on `--surface-2`; checked = accent border +
- * accent dot (research/design-system.md §3 Tier 2). Card-styled selection
- * lives in `RadioCard`.
+ * accent dot (research/design-system.md Tier 2). Card-styled selection lives
+ * in `RadioCard`.
  */
 export declare function Radio({ label, description, className, id, ...props }: RadioProps): React.JSX.Element;
 //# sourceMappingURL=Radio.d.ts.map

package/dist/components/radio/Radio.js

@@ -13,8 +13,8 @@ export function RadioGroup({ className, ...props }) {
 }
 /**
  * Radio — dot radio, 18px circle on `--surface-2`; checked = accent border +
- * accent dot (research/design-system.md §3 Tier 2). Card-styled selection
- * lives in `RadioCard`.
+ * accent dot (research/design-system.md Tier 2). Card-styled selection lives
+ * in `RadioCard`.
  */
 export function Radio({ label, description, className, id, ...props }) {
     const generatedId = useId();

package/dist/components/radio-card/RadioCard.d.ts

@@ -9,6 +9,17 @@ export interface RadioCardProps extends Omit<React.ComponentPropsWithRef<typeof
     icon?: React.ReactNode | undefined;
     /** Trailing slot on the title row — e.g. a mono price or a `Badge`. */
     trailing?: React.ReactNode | undefined;
+    /**
+     * The BIG line under the title, as the design comp draws it: 20px
+     * mono, tight tracking — a delivery window, a size, a duration.
+     *
+     * `valueLine`, not `value`: a radio item's `value` is what it SUBMITS, and
+     * this is what it shows. Distinct from `description`, which is the sentence
+     * under it — a card that offers a choice usually has one number worth reading
+     * from across the room and one line of prose, and folding them together made
+     * the number prose.
+     */
+    valueLine?: React.ReactNode | undefined;
     /** Hide the top-end check indicator shown when selected. */
     hideIndicator?: boolean | undefined;
     /**
@@ -16,19 +27,18 @@ export interface RadioCardProps extends Omit<React.ComponentPropsWithRef<typeof
      *
      * `row` (default) is the one every existing caller renders: a bare leading
      * glyph beside a 13px title. `tile` and `stack` are the two the onboarding
-     * comps draw (`designs/Onboarding.dc.html`, 45-onboarding.md §3) — a 40px
-     * accent-filling icon tile, leading with a description or centred above a
-     * label — and they are here rather than hand-rolled in the wizard because
-     * the Radix item underneath is what makes arrow keys and `aria-checked`
-     * work, and it is not exported.
+     * comps draw — a 40px accent-filling icon tile, leading with a description
+     * or centred above a label — and they are here rather than hand-rolled in
+     * the wizard because the Radix item underneath is what makes arrow keys
+     * and `aria-checked` work, and it is not exported.
      */
     layout?: 'row' | 'tile' | 'stack' | undefined;
 }
 /**
  * RadioCard — selectable card variant of the radio item
- * (research/design-system.md §3 Tier 2): full-card click target, selected =
+ * (research/design-system.md Tier 2): full-card click target, selected =
  * accent border + accent-soft bg + check indicator. Must be rendered inside
- * a `RadioGroup` (../radio); arrow keys move and select between cards.
+ * a `RadioGroup` (./radio); arrow keys move and select between cards.
  */
-export declare function RadioCard({ layout, title, description, icon, trailing, hideIndicator, className, ...props }: RadioCardProps): React.JSX.Element;
+export declare function RadioCard({ layout, title, description, valueLine, icon, trailing, hideIndicator, className, ...props }: RadioCardProps): React.JSX.Element;
 //# sourceMappingURL=RadioCard.d.ts.map

package/dist/components/radio-card/RadioCard.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"RadioCard.d.ts","sourceRoot":"","sources":["../../../src/components/radio-card/RadioCard.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,mBAAmB,MAAM,6BAA6B,CAAC;AAEnE,OAAO,KAAK,KAAK,KAAK,MAAM,OAAO,CAAC;AAIpC,MAAM,WAAW,cACf,SAAQ,IAAI,CAAC,KAAK,CAAC,qBAAqB,CAAC,OAAO,mBAAmB,CAAC,IAAI,CAAC,EAAE,OAAO,GAAG,SAAS,GAAG,UAAU,GAAG,OAAO,CAAC;IACtH,2EAA2E;IAC3E,KAAK,EAAE,KAAK,CAAC,SAAS,CAAC;IACvB,uCAAuC;IACvC,WAAW,CAAC,EAAE,KAAK,CAAC,SAAS,GAAG,SAAS,CAAC;IAC1C,6DAA6D;IAC7D,IAAI,CAAC,EAAE,KAAK,CAAC,SAAS,GAAG,SAAS,CAAC;IACnC,uEAAuE;IACvE,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,GAAG,SAAS,CAAC;IACvC,4DAA4D;IAC5D,aAAa,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACpC;;;;;;;;;;OAUG;IACH,MAAM,CAAC,EAAE,KAAK,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC;CAC/C;AA4BD;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,EACxB,MAAc,EACd,KAAK,EACL,WAAW,EACX,IAAI,EACJ,QAAQ,EACR,aAAqB,EACrB,SAAS,EACT,GAAG,KAAK,EACT,EAAE,cAAc,qBAsDhB"}
+{"version":3,"file":"RadioCard.d.ts","sourceRoot":"","sources":["../../../src/components/radio-card/RadioCard.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,mBAAmB,MAAM,6BAA6B,CAAC;AAEnE,OAAO,KAAK,KAAK,KAAK,MAAM,OAAO,CAAC;AAIpC,MAAM,WAAW,cACf,SAAQ,IAAI,CAAC,KAAK,CAAC,qBAAqB,CAAC,OAAO,mBAAmB,CAAC,IAAI,CAAC,EAAE,OAAO,GAAG,SAAS,GAAG,UAAU,GAAG,OAAO,CAAC;IACtH,2EAA2E;IAC3E,KAAK,EAAE,KAAK,CAAC,SAAS,CAAC;IACvB,uCAAuC;IACvC,WAAW,CAAC,EAAE,KAAK,CAAC,SAAS,GAAG,SAAS,CAAC;IAC1C,6DAA6D;IAC7D,IAAI,CAAC,EAAE,KAAK,CAAC,SAAS,GAAG,SAAS,CAAC;IACnC,uEAAuE;IACvE,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,GAAG,SAAS,CAAC;IACvC;;;;;;;;;OASG;IACH,SAAS,CAAC,EAAE,KAAK,CAAC,SAAS,GAAG,SAAS,CAAC;IACxC,4DAA4D;IAC5D,aAAa,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACpC;;;;;;;;;OASG;IACH,MAAM,CAAC,EAAE,KAAK,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC;CAC/C;AA4BD;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,EACxB,MAAc,EACd,KAAK,EACL,WAAW,EACX,SAAS,EACT,IAAI,EACJ,QAAQ,EACR,aAAqB,EACrB,SAAS,EACT,GAAG,KAAK,EACT,EAAE,cAAc,qBA2DhB"}

package/dist/components/radio-card/RadioCard.js

@@ -28,12 +28,12 @@ const LAYOUT = {
 };
 /**
  * RadioCard — selectable card variant of the radio item
- * (research/design-system.md §3 Tier 2): full-card click target, selected =
+ * (research/design-system.md Tier 2): full-card click target, selected =
  * accent border + accent-soft bg + check indicator. Must be rendered inside
- * a `RadioGroup` (../radio); arrow keys move and select between cards.
+ * a `RadioGroup` (./radio); arrow keys move and select between cards.
  */
-export function RadioCard({ layout = 'row', title, description, icon, trailing, hideIndicator = false, className, ...props }) {
-    return (_jsxs(RadioGroupPrimitive.Item, { className: cn('group relative flex w-full cursor-pointer border border-border-strong bg-surface text-start ', LAYOUT[layout].card, layout === 'stack' ? '' : 'text-start ', 'transition-[border-color,background-color,box-shadow] duration-150 hover:border-fg-subtle ', 'focus-visible:outline-2 focus-visible:outline-offset-2 focus-visible:outline-accent ', 'disabled:pointer-events-none disabled:opacity-40 ', 'data-[state=checked]:border-accent data-[state=checked]:bg-accent-soft', className), ...props, children: [icon ? (_jsx("span", { "aria-hidden": "true", className: cn('flex shrink-0 text-fg-muted group-data-[state=checked]:text-accent', LAYOUT[layout].icon), children: icon })) : null, _jsxs("span", { className: cn('flex min-w-0 flex-col gap-0.5', layout === 'stack' ? 'items-center' : 'flex-1'), children: [_jsxs("span", { className: "flex items-center gap-2", children: [_jsx("span", { className: LAYOUT[layout].title, children: title }), trailing ? _jsx("span", { className: "ms-auto flex shrink-0 items-center", children: trailing }) : null] }), description === undefined || description === null ? null : (_jsx("span", { className: LAYOUT[layout].description, children: description }))] }), hideIndicator ? null : (_jsx(RadioGroupPrimitive.Indicator, { "aria-hidden": "true", className: cn('absolute end-2.5 top-2.5 flex size-[18px] items-center justify-center rounded-full bg-accent text-accent-fg', 
+export function RadioCard({ layout = 'row', title, description, valueLine, icon, trailing, hideIndicator = false, className, ...props }) {
+    return (_jsxs(RadioGroupPrimitive.Item, { className: cn('group relative flex w-full cursor-pointer border border-border-strong bg-surface text-start ', LAYOUT[layout].card, layout === 'stack' ? '' : 'text-start ', 'transition-[border-color,background-color,box-shadow] duration-150 hover:border-fg-subtle ', 'focus-visible:outline-2 focus-visible:outline-offset-2 focus-visible:outline-accent ', 'disabled:pointer-events-none disabled:opacity-40 ', 'data-[state=checked]:border-accent data-[state=checked]:bg-accent-soft', className), ...props, children: [icon ? (_jsx("span", { "aria-hidden": "true", className: cn('flex shrink-0 text-fg-muted group-data-[state=checked]:text-accent', LAYOUT[layout].icon), children: icon })) : null, _jsxs("span", { className: cn('flex min-w-0 flex-col gap-0.5', layout === 'stack' ? 'items-center' : 'flex-1'), children: [_jsxs("span", { className: "flex items-center gap-2", children: [_jsx("span", { className: LAYOUT[layout].title, children: title }), trailing ? _jsx("span", { className: "ms-auto flex shrink-0 items-center", children: trailing }) : null] }), valueLine === undefined || valueLine === null ? null : (_jsx("span", { className: "font-mono text-[20px] font-extrabold tracking-[-0.02em] text-fg", children: valueLine })), description === undefined || description === null ? null : (_jsx("span", { className: LAYOUT[layout].description, children: description }))] }), hideIndicator ? null : (_jsx(RadioGroupPrimitive.Indicator, { "aria-hidden": "true", className: cn('absolute end-2.5 top-2.5 flex size-[18px] items-center justify-center rounded-full bg-accent text-accent-fg', 
                 // keep the check clear of the trailing slot when both are present
                 trailing ? 'top-auto bottom-2.5' : ''), children: _jsx(Check, { strokeWidth: 3, className: "size-3" }) }))] }));
 }

package/dist/components/radio-card/RadioCard.js.map

@@ -1 +1 @@
-{"version":3,"file":"RadioCard.js","sourceRoot":"","sources":["../../../src/components/radio-card/RadioCard.tsx"],"names":[],"mappings":";AAAA,yCAAyC;AACzC,OAAO,KAAK,mBAAmB,MAAM,6BAA6B,CAAC;AACnE,OAAO,EAAE,KAAK,EAAE,MAAM,cAAc,CAAC;AAGrC,OAAO,EAAE,EAAE,EAAE,MAAM,iBAAiB,CAAC;AA4BrC,+EAA+E;AAC/E,MAAM,MAAM,GAAG;IACb,GAAG,EAAE;QACH,IAAI,EAAE,oCAAoC;QAC1C,IAAI,EAAE,kCAAkC;QACxC,KAAK,EAAE,mCAAmC;QAC1C,WAAW,EAAE,uCAAuC;KACrD;IACD,IAAI,EAAE;QACJ,IAAI,EAAE,2CAA2C;QACjD,IAAI,EACF,kEAAkE;YAClE,oGAAoG;QACtG,KAAK,EAAE,iCAAiC;QACxC,WAAW,EAAE,iDAAiD;KAC/D;IACD,KAAK,EAAE;QACL,IAAI,EAAE,qEAAqE;QAC3E,IAAI,EACF,kEAAkE;YAClE,+FAA+F;QACjG,KAAK,EAAE,+BAA+B;QACtC,WAAW,EAAE,iDAAiD;KAC/D;CACO,CAAC;AAEX;;;;;GAKG;AACH,MAAM,UAAU,SAAS,CAAC,EACxB,MAAM,GAAG,KAAK,EACd,KAAK,EACL,WAAW,EACX,IAAI,EACJ,QAAQ,EACR,aAAa,GAAG,KAAK,EACrB,SAAS,EACT,GAAG,KAAK,EACO;IACf,OAAO,CACL,MAAC,mBAAmB,CAAC,IAAI,IACvB,SAAS,EAAE,EAAE,CACX,8FAA8F,EAC9F,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,EACnB,MAAM,KAAK,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,aAAa,EACvC,4FAA4F,EAC5F,sFAAsF,EACtF,mDAAmD,EACnD,wEAAwE,EACxE,SAAS,CACV,KACG,KAAK,aAER,IAAI,CAAC,CAAC,CAAC,CACN,8BACc,MAAM,EAClB,SAAS,EAAE,EAAE,CACX,oEAAoE,EACpE,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CACpB,YAEA,IAAI,GACA,CACR,CAAC,CAAC,CAAC,IAAI,EACR,gBACE,SAAS,EAAE,EAAE,CACX,+BAA+B,EAC/B,MAAM,KAAK,OAAO,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,QAAQ,CAC/C,aAED,gBAAM,SAAS,EAAC,yBAAyB,aACvC,eAAM,SAAS,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,KAAK,YAAG,KAAK,GAAQ,EACpD,QAAQ,CAAC,CAAC,CAAC,eAAM,SAAS,EAAC,oCAAoC,YAAE,QAAQ,GAAQ,CAAC,CAAC,CAAC,IAAI,IACpF,EACN,WAAW,KAAK,SAAS,IAAI,WAAW,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAC1D,eAAM,SAAS,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,WAAW,YAAG,WAAW,GAAQ,CAClE,IACI,EACN,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CACtB,KAAC,mBAAmB,CAAC,SAAS,mBAChB,MAAM,EAClB,SAAS,EAAE,EAAE,CACX,6GAA6G;gBAC7G,kEAAkE;gBAClE,QAAQ,CAAC,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,EAAE,CACtC,YAED,KAAC,KAAK,IAAC,WAAW,EAAE,CAAC,EAAE,SAAS,EAAC,QAAQ,GAAG,GACd,CACjC,IACwB,CAC5B,CAAC;AACJ,CAAC"}
+{"version":3,"file":"RadioCard.js","sourceRoot":"","sources":["../../../src/components/radio-card/RadioCard.tsx"],"names":[],"mappings":";AAAA,yCAAyC;AACzC,OAAO,KAAK,mBAAmB,MAAM,6BAA6B,CAAC;AACnE,OAAO,EAAE,KAAK,EAAE,MAAM,cAAc,CAAC;AAGrC,OAAO,EAAE,EAAE,EAAE,MAAM,iBAAiB,CAAC;AAsCrC,+EAA+E;AAC/E,MAAM,MAAM,GAAG;IACb,GAAG,EAAE;QACH,IAAI,EAAE,oCAAoC;QAC1C,IAAI,EAAE,kCAAkC;QACxC,KAAK,EAAE,mCAAmC;QAC1C,WAAW,EAAE,uCAAuC;KACrD;IACD,IAAI,EAAE;QACJ,IAAI,EAAE,2CAA2C;QACjD,IAAI,EACF,kEAAkE;YAClE,oGAAoG;QACtG,KAAK,EAAE,iCAAiC;QACxC,WAAW,EAAE,iDAAiD;KAC/D;IACD,KAAK,EAAE;QACL,IAAI,EAAE,qEAAqE;QAC3E,IAAI,EACF,kEAAkE;YAClE,+FAA+F;QACjG,KAAK,EAAE,+BAA+B;QACtC,WAAW,EAAE,iDAAiD;KAC/D;CACO,CAAC;AAEX;;;;;GAKG;AACH,MAAM,UAAU,SAAS,CAAC,EACxB,MAAM,GAAG,KAAK,EACd,KAAK,EACL,WAAW,EACX,SAAS,EACT,IAAI,EACJ,QAAQ,EACR,aAAa,GAAG,KAAK,EACrB,SAAS,EACT,GAAG,KAAK,EACO;IACf,OAAO,CACL,MAAC,mBAAmB,CAAC,IAAI,IACvB,SAAS,EAAE,EAAE,CACX,8FAA8F,EAC9F,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,EACnB,MAAM,KAAK,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,aAAa,EACvC,4FAA4F,EAC5F,sFAAsF,EACtF,mDAAmD,EACnD,wEAAwE,EACxE,SAAS,CACV,KACG,KAAK,aAER,IAAI,CAAC,CAAC,CAAC,CACN,8BACc,MAAM,EAClB,SAAS,EAAE,EAAE,CACX,oEAAoE,EACpE,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CACpB,YAEA,IAAI,GACA,CACR,CAAC,CAAC,CAAC,IAAI,EACR,gBACE,SAAS,EAAE,EAAE,CACX,+BAA+B,EAC/B,MAAM,KAAK,OAAO,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,QAAQ,CAC/C,aAED,gBAAM,SAAS,EAAC,yBAAyB,aACvC,eAAM,SAAS,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,KAAK,YAAG,KAAK,GAAQ,EACpD,QAAQ,CAAC,CAAC,CAAC,eAAM,SAAS,EAAC,oCAAoC,YAAE,QAAQ,GAAQ,CAAC,CAAC,CAAC,IAAI,IACpF,EACN,SAAS,KAAK,SAAS,IAAI,SAAS,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CACtD,eAAM,SAAS,EAAC,iEAAiE,YAC9E,SAAS,GACL,CACR,EACA,WAAW,KAAK,SAAS,IAAI,WAAW,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAC1D,eAAM,SAAS,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,WAAW,YAAG,WAAW,GAAQ,CAClE,IACI,EACN,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CACtB,KAAC,mBAAmB,CAAC,SAAS,mBAChB,MAAM,EAClB,SAAS,EAAE,EAAE,CACX,6GAA6G;gBAC7G,kEAAkE;gBAClE,QAAQ,CAAC,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,EAAE,CACtC,YAED,KAAC,KAAK,IAAC,WAAW,EAAE,CAAC,EAAE,SAAS,EAAC,QAAQ,GAAG,GACd,CACjC,IACwB,CAC5B,CAAC;AACJ,CAAC"}

package/dist/components/runtime-chip/RuntimeChip.d.ts

@@ -1,6 +1,6 @@
 /**
- * The four states of the desktop runtime chip (11-electron.md §8.1), verbatim
- * from that table's rows:
+ * The four states of the desktop runtime chip, verbatim from that table's
+ * rows:
  *
  *   | State                                    | Chip                        | Tone        |
  *   | Local DBs only, no sharing               | `Local` (hard-drive icon)   | muted       |
@@ -25,9 +25,9 @@ export interface RuntimeChipProps {
      */
     label: string;
     /**
-     * §8.1: "accent-soft; click → LAN panel". Supplying this renders a real
-     * `<button>` — not a `<span>` with a click handler — so the chip is reachable
-     * by keyboard and announced as actionable. Omit it and the chip is inert
+     * "accent-soft; click → LAN panel". Supplying this renders a real `<button>`
+     * — not a `<span>` with a click handler — so the chip is reachable by
+     * keyboard and announced as actionable. Omit it and the chip is inert
      * presentation, which is the honest rendering of the three states that have
      * nowhere to go.
      */
@@ -43,12 +43,12 @@ export interface RuntimeChipProps {
 }
 /**
  * The desktop runtime chip: what this Adminium is, and whether its data is
- * where you think it is (11-electron.md §8.1). Sits in the topbar next to the
- * environment area, desktop only.
+ * where you think it is. Sits in the topbar next to the environment area,
+ * desktop only.
  *
  * Fed by `GET /api/v1/system/info` + a connection-health poll — never by the
- * preload bridge (§8.1 is explicit, and §4 explains why: the server is the
- * authority for feature gating, the bridge only for native affordances).
+ * preload bridge (is explicit, explains why: the server is the authority for
+ * feature gating, the bridge only for native affordances).
  */
 export declare function RuntimeChip({ state, label, onClick, description, className }: RuntimeChipProps): import("react").JSX.Element;
 //# sourceMappingURL=RuntimeChip.d.ts.map

package/dist/components/runtime-chip/RuntimeChip.js

@@ -4,10 +4,10 @@ import { Database, HardDrive, Unplug, Wifi } from 'lucide-react';
 import { cn } from '../../lib/cn.js';
 import { badgeVariants } from '../badge/Badge.js';
 /**
- * §8.1's tone column, mapped onto the shared `Tone` vocabulary (03 §3.3):
- * "muted" is `neutral` (surface-3 + fg-muted), "accent-soft" is `accent`
- * (accent-soft + accent), "warn" is `warn`. No new tints — the whole point of
- * the vocabulary is that a chip cannot invent a colour.
+ * The tone column, mapped onto the shared `Tone` vocabulary: "muted" is
+ * `neutral` (surface-3 + fg-muted), "accent-soft" is `accent` (accent-soft +
+ * accent), "warn" is `warn`. No new tints — the whole point of the vocabulary
+ * is that a chip cannot invent a colour.
  *
  * ICONS: `hard-drive` for `local` is specified. The rest follow
  * `System States.dc.html`, whose "Database unreachable" state is a
@@ -24,12 +24,12 @@ const STATE_STYLES = Object.freeze({
 });
 /**
  * The desktop runtime chip: what this Adminium is, and whether its data is
- * where you think it is (11-electron.md §8.1). Sits in the topbar next to the
- * environment area, desktop only.
+ * where you think it is. Sits in the topbar next to the environment area,
+ * desktop only.
  *
  * Fed by `GET /api/v1/system/info` + a connection-health poll — never by the
- * preload bridge (§8.1 is explicit, and §4 explains why: the server is the
- * authority for feature gating, the bridge only for native affordances).
+ * preload bridge (is explicit, explains why: the server is the authority for
+ * feature gating, the bridge only for native affordances).
  */
 export function RuntimeChip({ state, label, onClick, description, className }) {
     const { icon: Icon, tone } = STATE_STYLES[state];

package/dist/components/search-input/SearchInput.d.ts

@@ -20,7 +20,7 @@ export type SearchInputProps = SearchInputBaseProps & ({
 /**
  * SearchInput — Search icon + borderless input inside a bordered `--surface-2`
  * pill, optional `Kbd` "⌘K" chip and clear button
- * (research/design-system.md §3 Tier 2).
+ * (research/design-system.md Tier 2).
  */
 export declare function SearchInput({ className, inputClassName, kbd, onClear, clearLabel, ref, onChange, ...inputProps }: SearchInputProps): React.JSX.Element;
 export {};

package/dist/components/search-input/SearchInput.js

@@ -7,7 +7,7 @@ import { Kbd } from '../kbd/index.js';
 /**
  * SearchInput — Search icon + borderless input inside a bordered `--surface-2`
  * pill, optional `Kbd` "⌘K" chip and clear button
- * (research/design-system.md §3 Tier 2).
+ * (research/design-system.md Tier 2).
  */
 export function SearchInput({ className, inputClassName, kbd, onClear, clearLabel, ref, onChange, ...inputProps }) {
     const innerRef = useRef(null);

package/dist/components/secret-input/SecretInput.d.ts

@@ -21,7 +21,7 @@ export interface SecretInputProps extends Omit<React.ComponentPropsWithRef<'inpu
  * SecretInput — masked mono value (API keys, tokens) with an eye reveal
  * toggle and a copy button that flips to a check + announces `copiedLabel`
  * through a polite `aria-live` region for 1.4s
- * (research/design-system.md §3 Tier 2).
+ * (research/design-system.md Tier 2).
  */
 export declare function SecretInput({ className, inputClassName, revealLabel, hideLabel, copyLabel, copiedLabel, error, onCopy, ref, ...inputProps }: SecretInputProps): React.JSX.Element;
 //# sourceMappingURL=SecretInput.d.ts.map

package/dist/components/secret-input/SecretInput.js

@@ -11,7 +11,7 @@ export const SECRET_COPIED_MS = 1400;
  * SecretInput — masked mono value (API keys, tokens) with an eye reveal
  * toggle and a copy button that flips to a check + announces `copiedLabel`
  * through a polite `aria-live` region for 1.4s
- * (research/design-system.md §3 Tier 2).
+ * (research/design-system.md Tier 2).
  */
 export function SecretInput({ className, inputClassName, revealLabel, hideLabel, copyLabel, copiedLabel, error = false, onCopy, ref, ...inputProps }) {
     const innerRef = useRef(null);