@hideyukimori/nene2-ui 0.2.0

package/dist/lib/spacing.js

@@ -0,0 +1,85 @@
+/**
+ * Resolve a responsive prop against one of the tables below.
+ * Returns a class string; an undefined value contributes nothing.
+ */
+export function resolve(value, table) {
+    if (value === undefined)
+        return '';
+    if (typeof value !== 'object')
+        return table[String(value)]?.base ?? '';
+    return ['base', 'sm', 'md', 'lg']
+        .map((bp) => {
+        const v = value[bp];
+        return v === undefined ? '' : (table[String(v)]?.[bp] ?? '');
+    })
+        .filter(Boolean)
+        .join(' ');
+}
+/** `gap` on a flex or grid container. */
+export const GAP = {
+    none: { base: 'gap-0', sm: 'sm:gap-0', md: 'md:gap-0', lg: 'lg:gap-0' },
+    '3xs': { base: 'gap-x-3xs', sm: 'sm:gap-x-3xs', md: 'md:gap-x-3xs', lg: 'lg:gap-x-3xs' },
+    '2xs': { base: 'gap-x-2xs', sm: 'sm:gap-x-2xs', md: 'md:gap-x-2xs', lg: 'lg:gap-x-2xs' },
+    xs: { base: 'gap-x-xs', sm: 'sm:gap-x-xs', md: 'md:gap-x-xs', lg: 'lg:gap-x-xs' },
+    sm: { base: 'gap-x-sm', sm: 'sm:gap-x-sm', md: 'md:gap-x-sm', lg: 'lg:gap-x-sm' },
+    md: { base: 'gap-x-md', sm: 'sm:gap-x-md', md: 'md:gap-x-md', lg: 'lg:gap-x-md' },
+    lg: { base: 'gap-x-lg', sm: 'sm:gap-x-lg', md: 'md:gap-x-lg', lg: 'lg:gap-x-lg' },
+    xl: { base: 'gap-x-xl', sm: 'sm:gap-x-xl', md: 'md:gap-x-xl', lg: 'lg:gap-x-xl' },
+    '2xl': { base: 'gap-x-2xl', sm: 'sm:gap-x-2xl', md: 'md:gap-x-2xl', lg: 'lg:gap-x-2xl' },
+};
+/** Padding on all four sides. */
+export const PAD = {
+    none: { base: 'p-0', sm: 'sm:p-0', md: 'md:p-0', lg: 'lg:p-0' },
+    '3xs': { base: 'p-x-3xs', sm: 'sm:p-x-3xs', md: 'md:p-x-3xs', lg: 'lg:p-x-3xs' },
+    '2xs': { base: 'p-x-2xs', sm: 'sm:p-x-2xs', md: 'md:p-x-2xs', lg: 'lg:p-x-2xs' },
+    xs: { base: 'p-x-xs', sm: 'sm:p-x-xs', md: 'md:p-x-xs', lg: 'lg:p-x-xs' },
+    sm: { base: 'p-x-sm', sm: 'sm:p-x-sm', md: 'md:p-x-sm', lg: 'lg:p-x-sm' },
+    md: { base: 'p-x-md', sm: 'sm:p-x-md', md: 'md:p-x-md', lg: 'lg:p-x-md' },
+    lg: { base: 'p-x-lg', sm: 'sm:p-x-lg', md: 'md:p-x-lg', lg: 'lg:p-x-lg' },
+    xl: { base: 'p-x-xl', sm: 'sm:p-x-xl', md: 'md:p-x-xl', lg: 'lg:p-x-xl' },
+    '2xl': { base: 'p-x-2xl', sm: 'sm:p-x-2xl', md: 'md:p-x-2xl', lg: 'lg:p-x-2xl' },
+};
+/** Inline (left/right) padding. */
+export const PAD_X = {
+    none: { base: 'px-0', sm: 'sm:px-0', md: 'md:px-0', lg: 'lg:px-0' },
+    '3xs': { base: 'px-x-3xs', sm: 'sm:px-x-3xs', md: 'md:px-x-3xs', lg: 'lg:px-x-3xs' },
+    '2xs': { base: 'px-x-2xs', sm: 'sm:px-x-2xs', md: 'md:px-x-2xs', lg: 'lg:px-x-2xs' },
+    xs: { base: 'px-x-xs', sm: 'sm:px-x-xs', md: 'md:px-x-xs', lg: 'lg:px-x-xs' },
+    sm: { base: 'px-x-sm', sm: 'sm:px-x-sm', md: 'md:px-x-sm', lg: 'lg:px-x-sm' },
+    md: { base: 'px-x-md', sm: 'sm:px-x-md', md: 'md:px-x-md', lg: 'lg:px-x-md' },
+    lg: { base: 'px-x-lg', sm: 'sm:px-x-lg', md: 'md:px-x-lg', lg: 'lg:px-x-lg' },
+    xl: { base: 'px-x-xl', sm: 'sm:px-x-xl', md: 'md:px-x-xl', lg: 'lg:px-x-xl' },
+    '2xl': { base: 'px-x-2xl', sm: 'sm:px-x-2xl', md: 'md:px-x-2xl', lg: 'lg:px-x-2xl' },
+};
+/** Block (top/bottom) padding. */
+export const PAD_Y = {
+    none: { base: 'py-0', sm: 'sm:py-0', md: 'md:py-0', lg: 'lg:py-0' },
+    '3xs': { base: 'py-x-3xs', sm: 'sm:py-x-3xs', md: 'md:py-x-3xs', lg: 'lg:py-x-3xs' },
+    '2xs': { base: 'py-x-2xs', sm: 'sm:py-x-2xs', md: 'md:py-x-2xs', lg: 'lg:py-x-2xs' },
+    xs: { base: 'py-x-xs', sm: 'sm:py-x-xs', md: 'md:py-x-xs', lg: 'lg:py-x-xs' },
+    sm: { base: 'py-x-sm', sm: 'sm:py-x-sm', md: 'md:py-x-sm', lg: 'lg:py-x-sm' },
+    md: { base: 'py-x-md', sm: 'sm:py-x-md', md: 'md:py-x-md', lg: 'lg:py-x-md' },
+    lg: { base: 'py-x-lg', sm: 'sm:py-x-lg', md: 'md:py-x-lg', lg: 'lg:py-x-lg' },
+    xl: { base: 'py-x-xl', sm: 'sm:py-x-xl', md: 'md:py-x-xl', lg: 'lg:py-x-xl' },
+    '2xl': { base: 'py-x-2xl', sm: 'sm:py-x-2xl', md: 'md:py-x-2xl', lg: 'lg:py-x-2xl' },
+};
+/**
+ * Grid column counts. 1–12 rather than only the six the fleet currently uses
+ * (1, 2, 3, 4, 5, 7), because a column count is a structural fact about a layout,
+ * not a design value — capping it would only push callers back to `grid-cols-*`.
+ */
+export const COLS = {
+    1: { base: 'grid-cols-1', sm: 'sm:grid-cols-1', md: 'md:grid-cols-1', lg: 'lg:grid-cols-1' },
+    2: { base: 'grid-cols-2', sm: 'sm:grid-cols-2', md: 'md:grid-cols-2', lg: 'lg:grid-cols-2' },
+    3: { base: 'grid-cols-3', sm: 'sm:grid-cols-3', md: 'md:grid-cols-3', lg: 'lg:grid-cols-3' },
+    4: { base: 'grid-cols-4', sm: 'sm:grid-cols-4', md: 'md:grid-cols-4', lg: 'lg:grid-cols-4' },
+    5: { base: 'grid-cols-5', sm: 'sm:grid-cols-5', md: 'md:grid-cols-5', lg: 'lg:grid-cols-5' },
+    6: { base: 'grid-cols-6', sm: 'sm:grid-cols-6', md: 'md:grid-cols-6', lg: 'lg:grid-cols-6' },
+    7: { base: 'grid-cols-7', sm: 'sm:grid-cols-7', md: 'md:grid-cols-7', lg: 'lg:grid-cols-7' },
+    8: { base: 'grid-cols-8', sm: 'sm:grid-cols-8', md: 'md:grid-cols-8', lg: 'lg:grid-cols-8' },
+    9: { base: 'grid-cols-9', sm: 'sm:grid-cols-9', md: 'md:grid-cols-9', lg: 'lg:grid-cols-9' },
+    10: { base: 'grid-cols-10', sm: 'sm:grid-cols-10', md: 'md:grid-cols-10', lg: 'lg:grid-cols-10' },
+    11: { base: 'grid-cols-11', sm: 'sm:grid-cols-11', md: 'md:grid-cols-11', lg: 'lg:grid-cols-11' },
+    12: { base: 'grid-cols-12', sm: 'sm:grid-cols-12', md: 'md:grid-cols-12', lg: 'lg:grid-cols-12' },
+};
+//# sourceMappingURL=spacing.js.map

package/dist/lib/spacing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spacing.js","sourceRoot":"","sources":["../../src/lib/spacing.ts"],"names":[],"mappings":"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"}

package/dist/lib/states.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Interaction states shared by every control in the kit (#300).
+ *
+ * 🔴 Why this exists at all: v0.1 shipped `Button`, `Input` and `Select` with **no disabled
+ * and no focus styling whatsoever**. The screens that used them wrote `disabled:opacity-50`
+ * and `focus:ring-1` themselves — 39 times across the fleet. That was never a deviation to
+ * be linted away; it was products patching a hole the kit had left open. Ban those classes
+ * before filling the hole and you ship a button that is disabled but does not look it.
+ *
+ * 🔴 `focus-visible`, not `focus`. `:focus` also fires on a mouse click, leaving a ring
+ * behind after every press — which is exactly why the fleet's screens ended up carrying
+ * both `focus:` (11 uses) and `focus-visible:` (5). The kit picks one, and picks the one
+ * that only shows the ring to keyboard users.
+ *
+ * 🔴 `outline`, not `ring`. Tailwind's `ring-*` is a box-shadow, so a parent with
+ * `overflow-hidden` clips it away entirely. This kit's own `Card` does not clip — but the
+ * products' existing containers do: `overflow-hidden` appears 12 times in nene-records and
+ * twice each in nene-vault and nene-deal, which are the first two ships to be migrated
+ * (measured 2026-08-23). `outline` is not clipped and carries its own offset.
+ *
+ * 🔴 The ring is `text-primary`, not `accent`. An accent ring is *the same colour as a
+ * primary button* — contrast 1.00:1 against its own fill, and 1.11:1 against a danger
+ * button (computed from the theme's oklch values, 2026-08-23). The offset keeps the ring
+ * off the fill, so what it actually sits against is the page, and both colours clear 3:1
+ * there; but a ring that disappears the moment the offset does is one layout change away
+ * from being invisible. `text-primary` measures 15.55:1 against `surface`, 16.00:1 against
+ * `surface-raised`, and still 3.30:1 / 2.97:1 against the accent and danger fills.
+ *
+ * No single colour clears 3:1 against *both* fills — accent and danger are both mid
+ * luminance — which is why nene-deal moved to a two-tone box-shadow ring (#183, after a
+ * 1.38:1 indicator went unnoticed because a contrast checker cannot see it). Here the
+ * offset provides the second tone: fill, page-coloured gap, dark ring, page.
+ *
+ * 🔴 `outline-offset` is therefore load-bearing, not decoration. Do not set it to 0.
+ */
+/** Keyboard focus indicator. Colour comes from the theme, never from a caller. */
+export declare const FOCUS_CLASS = "focus-visible:outline-2 focus-visible:outline-offset-2 focus-visible:outline-text-primary";
+/**
+ * Disabled appearance. The opacity is a theme token (`--opacity-x-disabled`) because a
+ * literal here would be a design value living outside themes/default.css.
+ */
+export declare const DISABLED_CLASS = "disabled:opacity-x-disabled disabled:cursor-not-allowed";
+/** Controls that can be focused and disabled — every interactive primitive in the kit. */
+export declare const CONTROL_CLASS = "focus-visible:outline-2 focus-visible:outline-offset-2 focus-visible:outline-text-primary disabled:opacity-x-disabled disabled:cursor-not-allowed";

package/dist/lib/states.js

@@ -0,0 +1,45 @@
+/**
+ * Interaction states shared by every control in the kit (#300).
+ *
+ * 🔴 Why this exists at all: v0.1 shipped `Button`, `Input` and `Select` with **no disabled
+ * and no focus styling whatsoever**. The screens that used them wrote `disabled:opacity-50`
+ * and `focus:ring-1` themselves — 39 times across the fleet. That was never a deviation to
+ * be linted away; it was products patching a hole the kit had left open. Ban those classes
+ * before filling the hole and you ship a button that is disabled but does not look it.
+ *
+ * 🔴 `focus-visible`, not `focus`. `:focus` also fires on a mouse click, leaving a ring
+ * behind after every press — which is exactly why the fleet's screens ended up carrying
+ * both `focus:` (11 uses) and `focus-visible:` (5). The kit picks one, and picks the one
+ * that only shows the ring to keyboard users.
+ *
+ * 🔴 `outline`, not `ring`. Tailwind's `ring-*` is a box-shadow, so a parent with
+ * `overflow-hidden` clips it away entirely. This kit's own `Card` does not clip — but the
+ * products' existing containers do: `overflow-hidden` appears 12 times in nene-records and
+ * twice each in nene-vault and nene-deal, which are the first two ships to be migrated
+ * (measured 2026-08-23). `outline` is not clipped and carries its own offset.
+ *
+ * 🔴 The ring is `text-primary`, not `accent`. An accent ring is *the same colour as a
+ * primary button* — contrast 1.00:1 against its own fill, and 1.11:1 against a danger
+ * button (computed from the theme's oklch values, 2026-08-23). The offset keeps the ring
+ * off the fill, so what it actually sits against is the page, and both colours clear 3:1
+ * there; but a ring that disappears the moment the offset does is one layout change away
+ * from being invisible. `text-primary` measures 15.55:1 against `surface`, 16.00:1 against
+ * `surface-raised`, and still 3.30:1 / 2.97:1 against the accent and danger fills.
+ *
+ * No single colour clears 3:1 against *both* fills — accent and danger are both mid
+ * luminance — which is why nene-deal moved to a two-tone box-shadow ring (#183, after a
+ * 1.38:1 indicator went unnoticed because a contrast checker cannot see it). Here the
+ * offset provides the second tone: fill, page-coloured gap, dark ring, page.
+ *
+ * 🔴 `outline-offset` is therefore load-bearing, not decoration. Do not set it to 0.
+ */
+/** Keyboard focus indicator. Colour comes from the theme, never from a caller. */
+export const FOCUS_CLASS = 'focus-visible:outline-2 focus-visible:outline-offset-2 focus-visible:outline-text-primary';
+/**
+ * Disabled appearance. The opacity is a theme token (`--opacity-x-disabled`) because a
+ * literal here would be a design value living outside themes/default.css.
+ */
+export const DISABLED_CLASS = 'disabled:opacity-x-disabled disabled:cursor-not-allowed';
+/** Controls that can be focused and disabled — every interactive primitive in the kit. */
+export const CONTROL_CLASS = `${FOCUS_CLASS} ${DISABLED_CLASS}`;
+//# sourceMappingURL=states.js.map

package/dist/lib/states.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"states.js","sourceRoot":"","sources":["../../src/lib/states.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AAEH,kFAAkF;AAClF,MAAM,CAAC,MAAM,WAAW,GACtB,2FAA2F,CAAC;AAE9F;;;GAGG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,yDAAyD,CAAC;AAExF,0FAA0F;AAC1F,MAAM,CAAC,MAAM,aAAa,GAAG,GAAG,WAAW,IAAI,cAAc,EAAE,CAAC"}

package/dist/overlay/ConfirmDialog.d.ts

@@ -0,0 +1,24 @@
+export interface ConfirmDialogProps {
+    open: boolean;
+    /** Localized title. */
+    title: string;
+    /** Localized body. */
+    message: string;
+    /** Localized label for the affirmative control. */
+    confirmLabel: string;
+    /** Localized label for the dismissive control. */
+    cancelLabel: string;
+    onConfirm: () => void;
+    onCancel: () => void;
+    /** `danger` for destructive confirmations. Chooses a variant, never a colour. */
+    tone?: 'default' | 'danger';
+}
+/**
+ * "Are you sure?" — the same dialog five ships wrote separately.
+ *
+ * 🔴 Cancel comes first in the DOM. It is the safe choice, so it is the one that should be
+ * reached first by keyboard and the one focus lands on when the dialog opens. A destructive
+ * confirmation whose dangerous button is the default is a footgun, and it is exactly the
+ * kind of detail that differs between five independent implementations.
+ */
+export declare function ConfirmDialog({ open, title, message, confirmLabel, cancelLabel, onConfirm, onCancel, tone, }: ConfirmDialogProps): import("react").JSX.Element;

package/dist/overlay/ConfirmDialog.js

@@ -0,0 +1,17 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Button } from '../primitives/Button.js';
+import { Stack } from '../layout/Stack.js';
+import { Text } from '../primitives/Text.js';
+import { Modal } from './Modal.js';
+/**
+ * "Are you sure?" — the same dialog five ships wrote separately.
+ *
+ * 🔴 Cancel comes first in the DOM. It is the safe choice, so it is the one that should be
+ * reached first by keyboard and the one focus lands on when the dialog opens. A destructive
+ * confirmation whose dangerous button is the default is a footgun, and it is exactly the
+ * kind of detail that differs between five independent implementations.
+ */
+export function ConfirmDialog({ open, title, message, confirmLabel, cancelLabel, onConfirm, onCancel, tone = 'default', }) {
+    return (_jsx(Modal, { open: open, onClose: onCancel, title: title, children: _jsxs(Stack, { gap: "xs", children: [_jsx(Text, { children: message }), _jsxs(Stack, { direction: "horizontal", gap: "2xs", justify: "end", children: [_jsx(Button, { variant: "secondary", onClick: onCancel, children: cancelLabel }), _jsx(Button, { variant: tone === 'danger' ? 'danger' : 'primary', onClick: onConfirm, children: confirmLabel })] })] }) }));
+}
+//# sourceMappingURL=ConfirmDialog.js.map

package/dist/overlay/ConfirmDialog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConfirmDialog.js","sourceRoot":"","sources":["../../src/overlay/ConfirmDialog.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAC;AACjD,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAC3C,OAAO,EAAE,IAAI,EAAE,MAAM,uBAAuB,CAAC;AAC7C,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAkBnC;;;;;;;GAOG;AACH,MAAM,UAAU,aAAa,CAAC,EAC5B,IAAI,EACJ,KAAK,EACL,OAAO,EACP,YAAY,EACZ,WAAW,EACX,SAAS,EACT,QAAQ,EACR,IAAI,GAAG,SAAS,GACG;IACnB,OAAO,CACL,KAAC,KAAK,IAAC,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,KAAK,YAChD,MAAC,KAAK,IAAC,GAAG,EAAC,IAAI,aACb,KAAC,IAAI,cAAE,OAAO,GAAQ,EACtB,MAAC,KAAK,IAAC,SAAS,EAAC,YAAY,EAAC,GAAG,EAAC,KAAK,EAAC,OAAO,EAAC,KAAK,aACnD,KAAC,MAAM,IAAC,OAAO,EAAC,WAAW,EAAC,OAAO,EAAE,QAAQ,YAC1C,WAAW,GACL,EACT,KAAC,MAAM,IAAC,OAAO,EAAE,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,EAAE,OAAO,EAAE,SAAS,YAC1E,YAAY,GACN,IACH,IACF,GACF,CACT,CAAC;AACJ,CAAC"}

package/dist/overlay/Modal.d.ts

@@ -0,0 +1,24 @@
+import { type ReactNode } from 'react';
+export interface ModalProps {
+    open: boolean;
+    /** Called for every dismissal the browser owns: Esc, the close control, the backdrop. */
+    onClose: () => void;
+    /** Localized title. Also names the dialog for assistive tech. */
+    title: string;
+    children: ReactNode;
+}
+/**
+ * A modal dialog built on the native `<dialog>` element.
+ *
+ * 🔴 Why native. Focus trapping, Esc-to-dismiss, the backdrop, and rendering above every
+ * stacking context are all things the browser already does correctly. Eight ships wrote
+ * their own modal, which means the fleet currently maintains eight focus traps — the single
+ * hardest piece of interaction code to get right, reimplemented per product.
+ *
+ * 🔴 `showModal()` is called imperatively rather than through the `open` attribute, because
+ * only `showModal()` puts the dialog in the top layer and traps focus; setting `open`
+ * renders it inline and non-modal. jsdom 25.0.1 does not implement `showModal` at all
+ * (measured 2026-08-23), and neither do browsers older than the feature, so the fallback
+ * sets `open` — degraded but visible, rather than a dialog that never appears.
+ */
+export declare function Modal({ open, onClose, title, children }: ModalProps): import("react").JSX.Element;

package/dist/overlay/Modal.js

@@ -0,0 +1,47 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { useEffect, useRef } from 'react';
+import { cx } from '../lib/cx.js';
+/**
+ * A modal dialog built on the native `<dialog>` element.
+ *
+ * 🔴 Why native. Focus trapping, Esc-to-dismiss, the backdrop, and rendering above every
+ * stacking context are all things the browser already does correctly. Eight ships wrote
+ * their own modal, which means the fleet currently maintains eight focus traps — the single
+ * hardest piece of interaction code to get right, reimplemented per product.
+ *
+ * 🔴 `showModal()` is called imperatively rather than through the `open` attribute, because
+ * only `showModal()` puts the dialog in the top layer and traps focus; setting `open`
+ * renders it inline and non-modal. jsdom 25.0.1 does not implement `showModal` at all
+ * (measured 2026-08-23), and neither do browsers older than the feature, so the fallback
+ * sets `open` — degraded but visible, rather than a dialog that never appears.
+ */
+export function Modal({ open, onClose, title, children }) {
+    const ref = useRef(null);
+    useEffect(() => {
+        const el = ref.current;
+        if (el === null)
+            return;
+        if (open) {
+            if (typeof el.showModal === 'function') {
+                if (!el.open)
+                    el.showModal();
+            }
+            else {
+                el.setAttribute('open', '');
+            }
+            return;
+        }
+        if (typeof el.close === 'function') {
+            if (el.open)
+                el.close();
+        }
+        else {
+            el.removeAttribute('open');
+        }
+    }, [open]);
+    return (_jsx("dialog", { ref: ref, "aria-label": title, 
+        // The browser fires `close` for Esc as well as for close(); routing both through the
+        // caller keeps `open` from drifting out of sync with what is on screen.
+        onClose: onClose, onCancel: onClose, className: cx('bg-surface-raised text-text-primary border border-border rounded-x-md', 'p-x-sm font-sans backdrop:bg-text-primary/50'), children: children }));
+}
+//# sourceMappingURL=Modal.js.map

package/dist/overlay/Modal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Modal.js","sourceRoot":"","sources":["../../src/overlay/Modal.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,EAAkB,MAAM,OAAO,CAAC;AAC1D,OAAO,EAAE,EAAE,EAAE,MAAM,cAAc,CAAC;AAWlC;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,KAAK,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAc;IAClE,MAAM,GAAG,GAAG,MAAM,CAAoB,IAAI,CAAC,CAAC;IAE5C,SAAS,CAAC,GAAG,EAAE;QACb,MAAM,EAAE,GAAG,GAAG,CAAC,OAAO,CAAC;QACvB,IAAI,EAAE,KAAK,IAAI;YAAE,OAAO;QAExB,IAAI,IAAI,EAAE,CAAC;YACT,IAAI,OAAO,EAAE,CAAC,SAAS,KAAK,UAAU,EAAE,CAAC;gBACvC,IAAI,CAAC,EAAE,CAAC,IAAI;oBAAE,EAAE,CAAC,SAAS,EAAE,CAAC;YAC/B,CAAC;iBAAM,CAAC;gBACN,EAAE,CAAC,YAAY,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;YAC9B,CAAC;YACD,OAAO;QACT,CAAC;QAED,IAAI,OAAO,EAAE,CAAC,KAAK,KAAK,UAAU,EAAE,CAAC;YACnC,IAAI,EAAE,CAAC,IAAI;gBAAE,EAAE,CAAC,KAAK,EAAE,CAAC;QAC1B,CAAC;aAAM,CAAC;YACN,EAAE,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC;QAC7B,CAAC;IACH,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC;IAEX,OAAO,CACL,iBACE,GAAG,EAAE,GAAG,gBACI,KAAK;QACjB,qFAAqF;QACrF,wEAAwE;QACxE,OAAO,EAAE,OAAO,EAChB,QAAQ,EAAE,OAAO,EACjB,SAAS,EAAE,EAAE,CACX,uEAAuE,EACvE,8CAA8C,CAC/C,YAEA,QAAQ,GACF,CACV,CAAC;AACJ,CAAC"}

package/dist/primitives/Button.d.ts

@@ -0,0 +1,6 @@
+import type { ButtonHTMLAttributes, ReactNode } from 'react';
+export interface ButtonProps extends ButtonHTMLAttributes<HTMLButtonElement> {
+    variant?: 'primary' | 'secondary' | 'danger';
+    children: ReactNode;
+}
+export declare function Button({ variant, children, type, className, ...rest }: ButtonProps): import("react").JSX.Element;

package/dist/primitives/Button.js

@@ -0,0 +1,13 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { cx } from '../lib/cx.js';
+import { CONTROL_CLASS } from '../lib/states.js';
+const VARIANT_CLASS = {
+    primary: 'bg-accent text-on-accent',
+    secondary: 'bg-surface-raised text-text-primary border border-border',
+    danger: 'bg-danger text-on-accent',
+};
+const BASE_CLASS = `rounded-x-md px-x-inline-md py-x-stack-sm font-sans font-medium ${CONTROL_CLASS}`;
+export function Button({ variant = 'primary', children, type = 'button', className, ...rest }) {
+    return (_jsx("button", { type: type, className: cx(BASE_CLASS, VARIANT_CLASS[variant], className), ...rest, children: children }));
+}
+//# sourceMappingURL=Button.js.map

package/dist/primitives/Button.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Button.js","sourceRoot":"","sources":["../../src/primitives/Button.tsx"],"names":[],"mappings":";AACA,OAAO,EAAE,EAAE,EAAE,MAAM,cAAc,CAAC;AAClC,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAOjD,MAAM,aAAa,GAAwD;IACzE,OAAO,EAAE,0BAA0B;IACnC,SAAS,EAAE,0DAA0D;IACrE,MAAM,EAAE,0BAA0B;CACnC,CAAC;AAEF,MAAM,UAAU,GAAG,mEAAmE,aAAa,EAAE,CAAC;AAEtG,MAAM,UAAU,MAAM,CAAC,EACrB,OAAO,GAAG,SAAS,EACnB,QAAQ,EACR,IAAI,GAAG,QAAQ,EACf,SAAS,EACT,GAAG,IAAI,EACK;IACZ,OAAO,CACL,iBAAQ,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE,CAAC,UAAU,EAAE,aAAa,CAAC,OAAO,CAAC,EAAE,SAAS,CAAC,KAAM,IAAI,YACvF,QAAQ,GACF,CACV,CAAC;AACJ,CAAC"}

package/dist/primitives/Checkbox.d.ts

@@ -0,0 +1,14 @@
+import { type InputHTMLAttributes, type ReactNode } from 'react';
+export interface CheckboxProps extends Omit<InputHTMLAttributes<HTMLInputElement>, 'type'> {
+    /** Localized label. Rendered inside the control's own `<label>`. */
+    label: ReactNode;
+}
+/**
+ * A checkbox and its label, as one part.
+ *
+ * 🔴 The label is not optional and not a sibling. The recurring shape in the fleet is an
+ * `<input>` next to a `<label>` whose `htmlFor` is missing or stale — which loses nothing
+ * visible, and loses the ability to click the text to toggle the box, plus the name the
+ * control is announced by. Making the label a prop means it cannot be forgotten.
+ */
+export declare const Checkbox: import("react").ForwardRefExoticComponent<CheckboxProps & import("react").RefAttributes<HTMLInputElement>>;

package/dist/primitives/Checkbox.js

@@ -0,0 +1,19 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { forwardRef } from 'react';
+import { cx } from '../lib/cx.js';
+import { CONTROL_CLASS } from '../lib/states.js';
+import { useFieldWiring } from '../forms/field-context.js';
+const BOX_CLASS = `rounded-x-md border border-border accent-accent ${CONTROL_CLASS}`;
+/**
+ * A checkbox and its label, as one part.
+ *
+ * 🔴 The label is not optional and not a sibling. The recurring shape in the fleet is an
+ * `<input>` next to a `<label>` whose `htmlFor` is missing or stale — which loses nothing
+ * visible, and loses the ability to click the text to toggle the box, plus the name the
+ * control is announced by. Making the label a prop means it cannot be forgotten.
+ */
+export const Checkbox = forwardRef(function Checkbox({ label, className, id, 'aria-invalid': ariaInvalid, 'aria-describedby': ariaDescribedBy, 'aria-required': ariaRequired, ...rest }, ref) {
+    const wiring = useFieldWiring({ id, ariaInvalid, ariaDescribedBy, ariaRequired });
+    return (_jsxs("label", { className: "inline-flex items-center gap-x-2xs font-sans text-text-primary", children: [_jsx("input", { ref: ref, type: "checkbox", className: cx(BOX_CLASS, className), ...wiring, ...rest }), label] }));
+});
+//# sourceMappingURL=Checkbox.js.map

package/dist/primitives/Checkbox.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Checkbox.js","sourceRoot":"","sources":["../../src/primitives/Checkbox.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,UAAU,EAA4C,MAAM,OAAO,CAAC;AAC7E,OAAO,EAAE,EAAE,EAAE,MAAM,cAAc,CAAC;AAClC,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAO3D,MAAM,SAAS,GAAG,mDAAmD,aAAa,EAAE,CAAC;AAErF;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG,UAAU,CAAkC,SAAS,QAAQ,CACnF,EACE,KAAK,EACL,SAAS,EACT,EAAE,EACF,cAAc,EAAE,WAAW,EAC3B,kBAAkB,EAAE,eAAe,EACnC,eAAe,EAAE,YAAY,EAC7B,GAAG,IAAI,EACR,EACD,GAAG;IAEH,MAAM,MAAM,GAAG,cAAc,CAAC,EAAE,EAAE,EAAE,WAAW,EAAE,eAAe,EAAE,YAAY,EAAE,CAAC,CAAC;IAElF,OAAO,CACL,iBAAO,SAAS,EAAC,gEAAgE,aAC/E,gBAAO,GAAG,EAAE,GAAG,EAAE,IAAI,EAAC,UAAU,EAAC,SAAS,EAAE,EAAE,CAAC,SAAS,EAAE,SAAS,CAAC,KAAM,MAAM,KAAM,IAAI,GAAI,EAC7F,KAAK,IACA,CACT,CAAC;AACJ,CAAC,CAAC,CAAC"}

package/dist/primitives/Icon.d.ts

@@ -0,0 +1,38 @@
+import type { ReactNode, SVGProps } from 'react';
+type IconSize = 'sm' | 'md' | 'lg';
+interface IconBase extends Omit<SVGProps<SVGSVGElement>, 'children' | 'aria-label'> {
+    /** The `<path>`, `<circle>`… of a 24×24 icon. The kit ships no artwork. */
+    children: ReactNode;
+    size?: IconSize;
+}
+interface MeaningfulIcon extends IconBase {
+    /** Localized name. Present when the icon carries meaning of its own. */
+    label: string;
+    decorative?: never;
+}
+interface DecorativeIcon extends IconBase {
+    /** The icon repeats something already in text, so it is hidden from assistive tech. */
+    decorative: true;
+    label?: never;
+}
+export type IconProps = MeaningfulIcon | DecorativeIcon;
+/**
+ * The semantics around an icon — not the icon.
+ *
+ * 🔴 The kit ships no artwork and takes on no icon library, because the fleet has none:
+ * across all ten products the dependency count for lucide / heroicons / feather / phosphor
+ * / tabler is zero, and every icon is an inline `<svg>` (222 of them, measured 2026-08-23).
+ * Choosing a set would mean adding a dependency to seventeen ships to solve a problem they
+ * do not have.
+ *
+ * 🔴 What is not consistent is the meaning. Of those 222, **101 declare neither
+ * `aria-hidden` nor `role="img"`** — they do not say whether they are decoration or
+ * content, so assistive technology is left to guess, and the page looks entirely correct
+ * either way. Three carry `role="img"`; none carries a `<title>`.
+ *
+ * So `label` and `decorative` are mutually exclusive and one of them is required, enforced
+ * by the type. An icon that can be rendered without saying which it is would reproduce the
+ * 101 exactly.
+ */
+export declare function Icon({ children, size, className, ...rest }: IconProps): import("react").JSX.Element;
+export {};

package/dist/primitives/Icon.js

@@ -0,0 +1,38 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { cx } from '../lib/cx.js';
+const SIZE_CLASS = {
+    sm: 'h-4 w-4',
+    md: 'h-5 w-5',
+    lg: 'h-6 w-6',
+};
+/**
+ * The semantics around an icon — not the icon.
+ *
+ * 🔴 The kit ships no artwork and takes on no icon library, because the fleet has none:
+ * across all ten products the dependency count for lucide / heroicons / feather / phosphor
+ * / tabler is zero, and every icon is an inline `<svg>` (222 of them, measured 2026-08-23).
+ * Choosing a set would mean adding a dependency to seventeen ships to solve a problem they
+ * do not have.
+ *
+ * 🔴 What is not consistent is the meaning. Of those 222, **101 declare neither
+ * `aria-hidden` nor `role="img"`** — they do not say whether they are decoration or
+ * content, so assistive technology is left to guess, and the page looks entirely correct
+ * either way. Three carry `role="img"`; none carries a `<title>`.
+ *
+ * So `label` and `decorative` are mutually exclusive and one of them is required, enforced
+ * by the type. An icon that can be rendered without saying which it is would reproduce the
+ * 101 exactly.
+ */
+export function Icon({ children, size = 'md', className, ...rest }) {
+    const { label, ...svgProps } = rest;
+    delete svgProps.decorative;
+    // 🔴 Falls back to decoration, not to `role="img"`. A JS caller or a stale build can reach
+    // here with neither prop, and a nameless `role="img"` is worse than silence: assistive
+    // technology announces "image" and stops. An empty string counts as missing too — that is
+    // what an unresolved translation key looks like at runtime.
+    const decorative = label === undefined || label === '';
+    return (_jsx("svg", { viewBox: "0 0 24 24", fill: "none", stroke: "currentColor", strokeWidth: 1.5, className: cx(SIZE_CLASS[size], 'shrink-0', className), ...(decorative
+            ? { 'aria-hidden': true, focusable: false }
+            : { role: 'img', 'aria-label': label }), ...svgProps, children: children }));
+}
+//# sourceMappingURL=Icon.js.map

package/dist/primitives/Icon.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Icon.js","sourceRoot":"","sources":["../../src/primitives/Icon.tsx"],"names":[],"mappings":";AACA,OAAO,EAAE,EAAE,EAAE,MAAM,cAAc,CAAC;AAwBlC,MAAM,UAAU,GAA6B;IAC3C,EAAE,EAAE,SAAS;IACb,EAAE,EAAE,SAAS;IACb,EAAE,EAAE,SAAS;CACd,CAAC;AAEF;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,IAAI,CAAC,EAAE,QAAQ,EAAE,IAAI,GAAG,IAAI,EAAE,SAAS,EAAE,GAAG,IAAI,EAAa;IAC3E,MAAM,EAAE,KAAK,EAAE,GAAG,QAAQ,EAAE,GAAG,IAEJ,CAAC;IAC5B,OAAQ,QAAqC,CAAC,UAAU,CAAC;IAEzD,2FAA2F;IAC3F,uFAAuF;IACvF,0FAA0F;IAC1F,4DAA4D;IAC5D,MAAM,UAAU,GAAG,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,EAAE,CAAC;IAEvD,OAAO,CACL,cACE,OAAO,EAAC,WAAW,EACnB,IAAI,EAAC,MAAM,EACX,MAAM,EAAC,cAAc,EACrB,WAAW,EAAE,GAAG,EAChB,SAAS,EAAE,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,UAAU,EAAE,SAAS,CAAC,KAClD,CAAC,UAAU;YACb,CAAC,CAAC,EAAE,aAAa,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE;YAC3C,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,YAAY,EAAE,KAAK,EAAE,CAAC,KACrC,QAAQ,YAEX,QAAQ,GACL,CACP,CAAC;AACJ,CAAC"}

package/dist/primitives/Input.d.ts

@@ -0,0 +1,7 @@
+import { type InputHTMLAttributes } from 'react';
+export type InputProps = InputHTMLAttributes<HTMLInputElement>;
+/**
+ * Text input primitive. forwardRef so it works directly with react-hook-form `register`.
+ * Visual values come from theme tokens only.
+ */
+export declare const Input: import("react").ForwardRefExoticComponent<InputProps & import("react").RefAttributes<HTMLInputElement>>;

package/dist/primitives/Input.js

@@ -0,0 +1,15 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { forwardRef } from 'react';
+import { cx } from '../lib/cx.js';
+import { CONTROL_CLASS } from '../lib/states.js';
+import { useFieldWiring } from '../forms/field-context.js';
+const BASE_CLASS = `w-full rounded-x-md border border-border bg-surface-raised px-x-inline-sm py-x-stack-sm font-sans text-text-primary placeholder:text-text-muted ${CONTROL_CLASS}`;
+/**
+ * Text input primitive. forwardRef so it works directly with react-hook-form `register`.
+ * Visual values come from theme tokens only.
+ */
+export const Input = forwardRef(function Input({ className, id, 'aria-invalid': ariaInvalid, 'aria-describedby': ariaDescribedBy, 'aria-required': ariaRequired, ...rest }, ref) {
+    const wiring = useFieldWiring({ id, ariaInvalid, ariaDescribedBy, ariaRequired });
+    return _jsx("input", { ref: ref, className: cx(BASE_CLASS, className), ...wiring, ...rest });
+});
+//# sourceMappingURL=Input.js.map

package/dist/primitives/Input.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Input.js","sourceRoot":"","sources":["../../src/primitives/Input.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,UAAU,EAA4B,MAAM,OAAO,CAAC;AAC7D,OAAO,EAAE,EAAE,EAAE,MAAM,cAAc,CAAC;AAClC,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAI3D,MAAM,UAAU,GAAG,mJAAmJ,aAAa,EAAE,CAAC;AAEtL;;;GAGG;AACH,MAAM,CAAC,MAAM,KAAK,GAAG,UAAU,CAA+B,SAAS,KAAK,CAC1E,EACE,SAAS,EACT,EAAE,EACF,cAAc,EAAE,WAAW,EAC3B,kBAAkB,EAAE,eAAe,EACnC,eAAe,EAAE,YAAY,EAC7B,GAAG,IAAI,EACR,EACD,GAAG;IAEH,MAAM,MAAM,GAAG,cAAc,CAAC,EAAE,EAAE,EAAE,WAAW,EAAE,eAAe,EAAE,YAAY,EAAE,CAAC,CAAC;IAElF,OAAO,gBAAO,GAAG,EAAE,GAAG,EAAE,SAAS,EAAE,EAAE,CAAC,UAAU,EAAE,SAAS,CAAC,KAAM,MAAM,KAAM,IAAI,GAAI,CAAC;AACzF,CAAC,CAAC,CAAC"}

package/dist/primitives/Radio.d.ts

@@ -0,0 +1,19 @@
+import { type InputHTMLAttributes, type ReactNode } from 'react';
+export interface RadioProps extends Omit<InputHTMLAttributes<HTMLInputElement>, 'type'> {
+    /** Localized label. Rendered inside the control's own `<label>`. */
+    label: ReactNode;
+    /** Radios only mean anything in a group; `name` is what makes them one. */
+    name: string;
+}
+/**
+ * One option in a radio group, with its label.
+ *
+ * 🔴 `name` is required, unlike on a bare `<input type="radio">`. A radio without a name is
+ * its own group of one: it can be checked but never unchecked, and arrow keys do not move
+ * between the options. Nothing about the rendered page shows this, so it survives review.
+ *
+ * 🔴 This does not take the `FormField` wiring. A group of radios shares one label and one
+ * error, so the id and `aria-describedby` belong on a `<fieldset>` around the group, not on
+ * each option — putting them here would give every option the same id.
+ */
+export declare const Radio: import("react").ForwardRefExoticComponent<RadioProps & import("react").RefAttributes<HTMLInputElement>>;

package/dist/primitives/Radio.js

@@ -0,0 +1,20 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { forwardRef } from 'react';
+import { cx } from '../lib/cx.js';
+import { CONTROL_CLASS } from '../lib/states.js';
+const DOT_CLASS = `border border-border accent-accent ${CONTROL_CLASS}`;
+/**
+ * One option in a radio group, with its label.
+ *
+ * 🔴 `name` is required, unlike on a bare `<input type="radio">`. A radio without a name is
+ * its own group of one: it can be checked but never unchecked, and arrow keys do not move
+ * between the options. Nothing about the rendered page shows this, so it survives review.
+ *
+ * 🔴 This does not take the `FormField` wiring. A group of radios shares one label and one
+ * error, so the id and `aria-describedby` belong on a `<fieldset>` around the group, not on
+ * each option — putting them here would give every option the same id.
+ */
+export const Radio = forwardRef(function Radio({ label, name, className, ...rest }, ref) {
+    return (_jsxs("label", { className: "inline-flex items-center gap-x-2xs font-sans text-text-primary", children: [_jsx("input", { ref: ref, type: "radio", name: name, className: cx(DOT_CLASS, className), ...rest }), label] }));
+});
+//# sourceMappingURL=Radio.js.map

package/dist/primitives/Radio.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Radio.js","sourceRoot":"","sources":["../../src/primitives/Radio.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,UAAU,EAA4C,MAAM,OAAO,CAAC;AAC7E,OAAO,EAAE,EAAE,EAAE,MAAM,cAAc,CAAC;AAClC,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AASjD,MAAM,SAAS,GAAG,sCAAsC,aAAa,EAAE,CAAC;AAExE;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,KAAK,GAAG,UAAU,CAA+B,SAAS,KAAK,CAC1E,EAAE,KAAK,EAAE,IAAI,EAAE,SAAS,EAAE,GAAG,IAAI,EAAE,EACnC,GAAG;IAEH,OAAO,CACL,iBAAO,SAAS,EAAC,gEAAgE,aAC/E,gBAAO,GAAG,EAAE,GAAG,EAAE,IAAI,EAAC,OAAO,EAAC,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE,CAAC,SAAS,EAAE,SAAS,CAAC,KAAM,IAAI,GAAI,EAC1F,KAAK,IACA,CACT,CAAC;AACJ,CAAC,CAAC,CAAC"}

package/dist/primitives/Select.d.ts

@@ -0,0 +1,9 @@
+import { type ReactNode, type SelectHTMLAttributes } from 'react';
+export interface SelectProps extends SelectHTMLAttributes<HTMLSelectElement> {
+    children: ReactNode;
+}
+/**
+ * Select primitive. forwardRef so it works directly with react-hook-form `register`.
+ * Visual values come from theme tokens only.
+ */
+export declare const Select: import("react").ForwardRefExoticComponent<SelectProps & import("react").RefAttributes<HTMLSelectElement>>;

package/dist/primitives/Select.js

@@ -0,0 +1,15 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { forwardRef } from 'react';
+import { cx } from '../lib/cx.js';
+import { CONTROL_CLASS } from '../lib/states.js';
+import { useFieldWiring } from '../forms/field-context.js';
+const BASE_CLASS = `w-full rounded-x-md border border-border bg-surface-raised px-x-inline-sm py-x-stack-sm font-sans text-text-primary ${CONTROL_CLASS}`;
+/**
+ * Select primitive. forwardRef so it works directly with react-hook-form `register`.
+ * Visual values come from theme tokens only.
+ */
+export const Select = forwardRef(function Select({ children, className, id, 'aria-invalid': ariaInvalid, 'aria-describedby': ariaDescribedBy, 'aria-required': ariaRequired, ...rest }, ref) {
+    const wiring = useFieldWiring({ id, ariaInvalid, ariaDescribedBy, ariaRequired });
+    return (_jsx("select", { ref: ref, className: cx(BASE_CLASS, className), ...wiring, ...rest, children: children }));
+});
+//# sourceMappingURL=Select.js.map

package/dist/primitives/Select.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Select.js","sourceRoot":"","sources":["../../src/primitives/Select.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,UAAU,EAA6C,MAAM,OAAO,CAAC;AAC9E,OAAO,EAAE,EAAE,EAAE,MAAM,cAAc,CAAC;AAClC,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAM3D,MAAM,UAAU,GAAG,uHAAuH,aAAa,EAAE,CAAC;AAE1J;;;GAGG;AACH,MAAM,CAAC,MAAM,MAAM,GAAG,UAAU,CAAiC,SAAS,MAAM,CAC9E,EACE,QAAQ,EACR,SAAS,EACT,EAAE,EACF,cAAc,EAAE,WAAW,EAC3B,kBAAkB,EAAE,eAAe,EACnC,eAAe,EAAE,YAAY,EAC7B,GAAG,IAAI,EACR,EACD,GAAG;IAEH,MAAM,MAAM,GAAG,cAAc,CAAC,EAAE,EAAE,EAAE,WAAW,EAAE,eAAe,EAAE,YAAY,EAAE,CAAC,CAAC;IAElF,OAAO,CACL,iBAAQ,GAAG,EAAE,GAAG,EAAE,SAAS,EAAE,EAAE,CAAC,UAAU,EAAE,SAAS,CAAC,KAAM,MAAM,KAAM,IAAI,YACzE,QAAQ,GACF,CACV,CAAC;AACJ,CAAC,CAAC,CAAC"}

package/dist/primitives/Spinner.d.ts

@@ -0,0 +1,5 @@
+export interface SpinnerProps {
+    /** Localized loading text. The kit never ships strings — see README. */
+    label: string;
+}
+export declare function Spinner({ label }: SpinnerProps): import("react").JSX.Element;

package/dist/primitives/Spinner.js

@@ -0,0 +1,5 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+export function Spinner({ label }) {
+    return (_jsx("output", { className: "font-sans text-text-muted", "aria-live": "polite", children: label }));
+}
+//# sourceMappingURL=Spinner.js.map

package/dist/primitives/Spinner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Spinner.js","sourceRoot":"","sources":["../../src/primitives/Spinner.tsx"],"names":[],"mappings":";AAKA,MAAM,UAAU,OAAO,CAAC,EAAE,KAAK,EAAgB;IAC7C,OAAO,CACL,iBAAQ,SAAS,EAAC,2BAA2B,eAAW,QAAQ,YAC7D,KAAK,GACC,CACV,CAAC;AACJ,CAAC"}