@adminiumjs/ui 0.1.0-rc.1

package/dist/components/tooltip/Tooltip.js

@@ -0,0 +1,19 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import * as TooltipPrimitive from '@radix-ui/react-tooltip';
+import { cn } from '../../lib/cn.js';
+/**
+ * Re-export of the Radix provider: mount once per app to share the skip-delay
+ * timer between tooltips. `Tooltip` also works standalone (it nests its own
+ * provider), so this is an optimization, not a requirement.
+ */
+export const TooltipProvider = TooltipPrimitive.Provider;
+/**
+ * Tooltip — Radix tooltip on the inverted dark surface (`--fg` background,
+ * `--bg` text), radius 8, 12px text, 300ms delay
+ * (research/design-system.md §3 Tier 3). Opens on hover and on keyboard
+ * focus; Esc dismisses (Radix built-ins).
+ */
+export function Tooltip({ content, children, side = 'top', align = 'center', sideOffset = 6, delayDuration = 300, open, defaultOpen, onOpenChange, className, }) {
+    return (_jsx(TooltipPrimitive.Provider, { delayDuration: delayDuration, children: _jsxs(TooltipPrimitive.Root, { ...(open === undefined ? {} : { open }), ...(defaultOpen === undefined ? {} : { defaultOpen }), ...(onOpenChange === undefined ? {} : { onOpenChange }), children: [_jsx(TooltipPrimitive.Trigger, { asChild: true, children: children }), _jsx(TooltipPrimitive.Portal, { children: _jsxs(TooltipPrimitive.Content, { side: side, align: align, sideOffset: sideOffset, className: cn('z-50 max-w-[280px] rounded-[8px] bg-fg px-2.5 py-1.5 text-[12px] font-medium leading-snug text-bg shadow-menu', 'animate-[nb-pop_.15s_cubic-bezier(.2,.7,.3,1)]', className), children: [content, _jsx(TooltipPrimitive.Arrow, { width: 10, height: 5, className: "fill-fg" })] }) })] }) }));
+}
+//# sourceMappingURL=Tooltip.js.map

package/dist/components/tooltip/Tooltip.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Tooltip.js","sourceRoot":"","sources":["../../../src/components/tooltip/Tooltip.tsx"],"names":[],"mappings":";AAAA,OAAO,KAAK,gBAAgB,MAAM,yBAAyB,CAAC;AAG5D,OAAO,EAAE,EAAE,EAAE,MAAM,iBAAiB,CAAC;AAErC;;;;GAIG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,gBAAgB,CAAC,QAAQ,CAAC;AAuBzD;;;;;GAKG;AACH,MAAM,UAAU,OAAO,CAAC,EACtB,OAAO,EACP,QAAQ,EACR,IAAI,GAAG,KAAK,EACZ,KAAK,GAAG,QAAQ,EAChB,UAAU,GAAG,CAAC,EACd,aAAa,GAAG,GAAG,EACnB,IAAI,EACJ,WAAW,EACX,YAAY,EACZ,SAAS,GACI;IACb,OAAO,CACL,KAAC,gBAAgB,CAAC,QAAQ,IAAC,aAAa,EAAE,aAAa,YACrD,MAAC,gBAAgB,CAAC,IAAI,OAChB,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,KACpC,CAAC,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC,KAClD,CAAC,YAAY,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,CAAC,aAExD,KAAC,gBAAgB,CAAC,OAAO,IAAC,OAAO,kBAAE,QAAQ,GAA4B,EACvE,KAAC,gBAAgB,CAAC,MAAM,cACtB,MAAC,gBAAgB,CAAC,OAAO,IACvB,IAAI,EAAE,IAAI,EACV,KAAK,EAAE,KAAK,EACZ,UAAU,EAAE,UAAU,EACtB,SAAS,EAAE,EAAE,CACX,+GAA+G,EAC/G,gDAAgD,EAChD,SAAS,CACV,aAEA,OAAO,EACR,KAAC,gBAAgB,CAAC,KAAK,IAAC,KAAK,EAAE,EAAE,EAAE,MAAM,EAAE,CAAC,EAAE,SAAS,EAAC,SAAS,GAAG,IAC3C,GACH,IACJ,GACE,CAC7B,CAAC;AACJ,CAAC"}

package/dist/components/tooltip/index.d.ts

@@ -0,0 +1,3 @@
+export { Tooltip, TooltipProvider } from './Tooltip.js';
+export type { TooltipProps } from './Tooltip.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/components/tooltip/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/tooltip/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AACxD,YAAY,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC"}

package/dist/components/tooltip/index.js

@@ -0,0 +1,2 @@
+export { Tooltip, TooltipProvider } from './Tooltip.js';
+//# sourceMappingURL=index.js.map

package/dist/components/tooltip/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/components/tooltip/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC"}

package/dist/components/two-phase-modal/TwoPhaseModal.d.ts

@@ -0,0 +1,45 @@
+import type { ReactNode } from 'react';
+import { type ModalProps } from '../modal/Modal.js';
+import { type SuccessStateProps } from '../success-state/SuccessState.js';
+export type ModalPhase = 'form' | 'success';
+export interface ModalFlow<T> {
+    /** Current phase. */
+    phase: ModalPhase;
+    /** Harvested form payload, set by `toSuccess` (null during the form phase). */
+    payload: T | null;
+    /** Swap to the success phase, harvesting the submitted inputs. */
+    toSuccess: (payload: T) => void;
+    /** Return to a fresh form phase (called automatically after close). */
+    reset: () => void;
+}
+/**
+ * useModalFlow — state machine for the canonical two-phase (form → success)
+ * modal (workplan/03-component-library.md §7.1, research/ia-mapping.md §5.3).
+ */
+export declare function useModalFlow<T>(): ModalFlow<T>;
+/** Modal exit animation length — `flow.reset()` is deferred past it (§7.1). */
+export declare const MODAL_EXIT_MS = 240;
+export interface TwoPhaseModalProps<T> extends Omit<ModalProps, 'children'> {
+    /** The flow from `useModalFlow<T>()`; drives which phase renders. */
+    flow: ModalFlow<T>;
+    /** Phase-1 form content (ModalHeader/ModalBody/ModalFooter composition). */
+    children: ReactNode;
+    /** Success heading; receives the harvested payload. */
+    successTitle: ReactNode | ((payload: T) => ReactNode);
+    /** Success copy — echo harvested inputs ("We emailed {payload.email}"). */
+    successBody?: ReactNode | ((payload: T) => ReactNode) | undefined;
+    /** Done button label (required — i18n). */
+    doneLabel: string;
+    /** Extra props forwarded to the phase-2 `SuccessState`. */
+    successProps?: Partial<Omit<SuccessStateProps, 'title' | 'body' | 'doneLabel' | 'onDone'>> | undefined;
+}
+/**
+ * TwoPhaseModal — the canonical form → success modal: the same Radix Dialog
+ * instance swaps its body to a `SuccessState` on `flow.toSuccess(payload)`,
+ * preserving focus; harvested inputs echo into the success copy; Done and
+ * Esc/backdrop close, and `flow.reset()` runs after the exit animation so the
+ * success phase never flashes back to the form while closing
+ * (workplan/03-component-library.md §7.1).
+ */
+export declare function TwoPhaseModal<T>({ flow, children, successTitle, successBody, doneLabel, successProps, onOpenChange, ...modalProps }: TwoPhaseModalProps<T>): import("react").JSX.Element;
+//# sourceMappingURL=TwoPhaseModal.d.ts.map

package/dist/components/two-phase-modal/TwoPhaseModal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TwoPhaseModal.d.ts","sourceRoot":"","sources":["../../../src/components/two-phase-modal/TwoPhaseModal.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAEvC,OAAO,EAAS,KAAK,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC3D,OAAO,EAAgB,KAAK,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AAExF,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,SAAS,CAAC;AAE5C,MAAM,WAAW,SAAS,CAAC,CAAC;IAC1B,qBAAqB;IACrB,KAAK,EAAE,UAAU,CAAC;IAClB,+EAA+E;IAC/E,OAAO,EAAE,CAAC,GAAG,IAAI,CAAC;IAClB,kEAAkE;IAClE,SAAS,EAAE,CAAC,OAAO,EAAE,CAAC,KAAK,IAAI,CAAC;IAChC,uEAAuE;IACvE,KAAK,EAAE,MAAM,IAAI,CAAC;CACnB;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,CAAC,KAAK,SAAS,CAAC,CAAC,CAAC,CAY9C;AAED,+EAA+E;AAC/E,eAAO,MAAM,aAAa,MAAM,CAAC;AAEjC,MAAM,WAAW,kBAAkB,CAAC,CAAC,CAAE,SAAQ,IAAI,CAAC,UAAU,EAAE,UAAU,CAAC;IACzE,qEAAqE;IACrE,IAAI,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC;IACnB,4EAA4E;IAC5E,QAAQ,EAAE,SAAS,CAAC;IACpB,uDAAuD;IACvD,YAAY,EAAE,SAAS,GAAG,CAAC,CAAC,OAAO,EAAE,CAAC,KAAK,SAAS,CAAC,CAAC;IACtD,2EAA2E;IAC3E,WAAW,CAAC,EAAE,SAAS,GAAG,CAAC,CAAC,OAAO,EAAE,CAAC,KAAK,SAAS,CAAC,GAAG,SAAS,CAAC;IAClE,2CAA2C;IAC3C,SAAS,EAAE,MAAM,CAAC;IAClB,2DAA2D;IAC3D,YAAY,CAAC,EAAE,OAAO,CAAC,IAAI,CAAC,iBAAiB,EAAE,OAAO,GAAG,MAAM,GAAG,WAAW,GAAG,QAAQ,CAAC,CAAC,GAAG,SAAS,CAAC;CACxG;AAMD;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAAE,EAC/B,IAAI,EACJ,QAAQ,EACR,YAAY,EACZ,WAAW,EACX,SAAS,EACT,YAAY,EACZ,YAAY,EACZ,GAAG,UAAU,EACd,EAAE,kBAAkB,CAAC,CAAC,CAAC,+BA6BvB"}

package/dist/components/two-phase-modal/TwoPhaseModal.js

@@ -0,0 +1,50 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { useCallback, useRef, useState } from 'react';
+import { Modal } from '../modal/Modal.js';
+import { SuccessState } from '../success-state/SuccessState.js';
+/**
+ * useModalFlow — state machine for the canonical two-phase (form → success)
+ * modal (workplan/03-component-library.md §7.1, research/ia-mapping.md §5.3).
+ */
+export function useModalFlow() {
+    const [state, setState] = useState({
+        phase: 'form',
+        payload: null,
+    });
+    const toSuccess = useCallback((payload) => {
+        setState({ phase: 'success', payload });
+    }, []);
+    const reset = useCallback(() => {
+        setState({ phase: 'form', payload: null });
+    }, []);
+    return { phase: state.phase, payload: state.payload, toSuccess, reset };
+}
+/** Modal exit animation length — `flow.reset()` is deferred past it (§7.1). */
+export const MODAL_EXIT_MS = 240;
+function resolve(value, payload) {
+    return typeof value === 'function' ? value(payload) : value;
+}
+/**
+ * TwoPhaseModal — the canonical form → success modal: the same Radix Dialog
+ * instance swaps its body to a `SuccessState` on `flow.toSuccess(payload)`,
+ * preserving focus; harvested inputs echo into the success copy; Done and
+ * Esc/backdrop close, and `flow.reset()` runs after the exit animation so the
+ * success phase never flashes back to the form while closing
+ * (workplan/03-component-library.md §7.1).
+ */
+export function TwoPhaseModal({ flow, children, successTitle, successBody, doneLabel, successProps, onOpenChange, ...modalProps }) {
+    const resetTimer = useRef(null);
+    const handleOpenChange = (open) => {
+        onOpenChange?.(open);
+        if (!open) {
+            if (resetTimer.current !== null)
+                clearTimeout(resetTimer.current);
+            resetTimer.current = setTimeout(() => {
+                flow.reset();
+                resetTimer.current = null;
+            }, MODAL_EXIT_MS);
+        }
+    };
+    return (_jsx(Modal, { ...modalProps, onOpenChange: handleOpenChange, children: flow.phase === 'form' || flow.payload === null ? (children) : (_jsx(SuccessState, { ...successProps, title: resolve(successTitle, flow.payload), body: successBody === undefined ? undefined : resolve(successBody, flow.payload), doneLabel: doneLabel, onDone: () => handleOpenChange(false) })) }));
+}
+//# sourceMappingURL=TwoPhaseModal.js.map

package/dist/components/two-phase-modal/TwoPhaseModal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TwoPhaseModal.js","sourceRoot":"","sources":["../../../src/components/two-phase-modal/TwoPhaseModal.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAGtD,OAAO,EAAE,KAAK,EAAmB,MAAM,mBAAmB,CAAC;AAC3D,OAAO,EAAE,YAAY,EAA0B,MAAM,kCAAkC,CAAC;AAexF;;;GAGG;AACH,MAAM,UAAU,YAAY;IAC1B,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAA2C;QAC3E,KAAK,EAAE,MAAM;QACb,OAAO,EAAE,IAAI;KACd,CAAC,CAAC;IACH,MAAM,SAAS,GAAG,WAAW,CAAC,CAAC,OAAU,EAAE,EAAE;QAC3C,QAAQ,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,CAAC;IAC1C,CAAC,EAAE,EAAE,CAAC,CAAC;IACP,MAAM,KAAK,GAAG,WAAW,CAAC,GAAG,EAAE;QAC7B,QAAQ,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;IAC7C,CAAC,EAAE,EAAE,CAAC,CAAC;IACP,OAAO,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC;AAC1E,CAAC;AAED,+EAA+E;AAC/E,MAAM,CAAC,MAAM,aAAa,GAAG,GAAG,CAAC;AAiBjC,SAAS,OAAO,CAAI,KAA8C,EAAE,OAAU;IAC5E,OAAO,OAAO,KAAK,KAAK,UAAU,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;AAC9D,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,aAAa,CAAI,EAC/B,IAAI,EACJ,QAAQ,EACR,YAAY,EACZ,WAAW,EACX,SAAS,EACT,YAAY,EACZ,YAAY,EACZ,GAAG,UAAU,EACS;IACtB,MAAM,UAAU,GAAG,MAAM,CAAuC,IAAI,CAAC,CAAC;IAEtE,MAAM,gBAAgB,GAAG,CAAC,IAAa,EAAE,EAAE;QACzC,YAAY,EAAE,CAAC,IAAI,CAAC,CAAC;QACrB,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,IAAI,UAAU,CAAC,OAAO,KAAK,IAAI;gBAAE,YAAY,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;YAClE,UAAU,CAAC,OAAO,GAAG,UAAU,CAAC,GAAG,EAAE;gBACnC,IAAI,CAAC,KAAK,EAAE,CAAC;gBACb,UAAU,CAAC,OAAO,GAAG,IAAI,CAAC;YAC5B,CAAC,EAAE,aAAa,CAAC,CAAC;QACpB,CAAC;IACH,CAAC,CAAC;IAEF,OAAO,CACL,KAAC,KAAK,OAAK,UAAU,EAAE,YAAY,EAAE,gBAAgB,YAClD,IAAI,CAAC,KAAK,KAAK,MAAM,IAAI,IAAI,CAAC,OAAO,KAAK,IAAI,CAAC,CAAC,CAAC,CAChD,QAAQ,CACT,CAAC,CAAC,CAAC,CACF,KAAC,YAAY,OACP,YAAY,EAChB,KAAK,EAAE,OAAO,CAAC,YAAY,EAAE,IAAI,CAAC,OAAO,CAAC,EAC1C,IAAI,EAAE,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,WAAW,EAAE,IAAI,CAAC,OAAO,CAAC,EAChF,SAAS,EAAE,SAAS,EACpB,MAAM,EAAE,GAAG,EAAE,CAAC,gBAAgB,CAAC,KAAK,CAAC,GACrC,CACH,GACK,CACT,CAAC;AACJ,CAAC"}

package/dist/components/two-phase-modal/index.d.ts

@@ -0,0 +1,3 @@
+export { MODAL_EXIT_MS, TwoPhaseModal, useModalFlow } from './TwoPhaseModal.js';
+export type { ModalFlow, ModalPhase, TwoPhaseModalProps } from './TwoPhaseModal.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/components/two-phase-modal/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/two-phase-modal/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAChF,YAAY,EAAE,SAAS,EAAE,UAAU,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/components/two-phase-modal/index.js

@@ -0,0 +1,2 @@
+export { MODAL_EXIT_MS, TwoPhaseModal, useModalFlow } from './TwoPhaseModal.js';
+//# sourceMappingURL=index.js.map

package/dist/components/two-phase-modal/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/components/two-phase-modal/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/hooks/index.d.ts

@@ -0,0 +1,3 @@
+export { UNDO_WINDOW_MS, useUndoableAction } from './useUndoableAction.js';
+export type { UndoableRun, UndoableState, UseUndoableActionOptions, UseUndoableActionReturn, } from './useUndoableAction.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/hooks/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/hooks/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3E,YAAY,EACV,WAAW,EACX,aAAa,EACb,wBAAwB,EACxB,uBAAuB,GACxB,MAAM,wBAAwB,CAAC"}

package/dist/hooks/index.js

@@ -0,0 +1,2 @@
+export { UNDO_WINDOW_MS, useUndoableAction } from './useUndoableAction.js';
+//# sourceMappingURL=index.js.map

package/dist/hooks/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/hooks/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/hooks/useUndoableAction.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Duration of the undo window, matching the undo-toast auto-dismiss
+ * (workplan/03-component-library.md §7.2 — action/Undo 5200ms).
+ */
+export declare const UNDO_WINDOW_MS = 5200;
+export type UndoableState = 'idle' | 'pending' | 'committed' | 'undone';
+export interface UseUndoableActionOptions<T> {
+    /**
+     * Apply the mutation optimistically. The return value is the undo context
+     * (e.g. the deleted rows) handed back to `undo`/`commit`.
+     */
+    perform: () => T | Promise<T>;
+    /** Revert the optimistic mutation. */
+    undo: (context: T) => void | Promise<void>;
+    /**
+     * Finalize the mutation once the undo window elapses without an undo
+     * (e.g. hard-delete server-side). Optional — omit when `perform` already
+     * persisted the change.
+     */
+    commit?: ((context: T) => void | Promise<void>) | undefined;
+    /** Undo window in ms before auto-commit. Default `UNDO_WINDOW_MS` (5200). */
+    timeoutMs?: number | undefined;
+    /** Observe state transitions (e.g. to dismiss the paired undo toast). */
+    onStateChange?: ((state: UndoableState) => void) | undefined;
+}
+export interface UndoableRun<T> {
+    /** The context returned by `perform`. */
+    context: T;
+    /** Revert now (idempotent — the first of undo/commit wins). */
+    undo: () => Promise<void>;
+    /** Finalize now instead of waiting for the window (idempotent). */
+    commit: () => Promise<void>;
+}
+export interface UseUndoableActionReturn<T> {
+    /** Perform the action optimistically and open the undo window. */
+    run: () => Promise<UndoableRun<T>>;
+    /** Undo the latest pending run (no-op when nothing is pending). */
+    undo: () => Promise<void>;
+    /** Commit the latest pending run early (no-op when nothing is pending). */
+    commit: () => Promise<void>;
+    /** Lifecycle of the latest run. */
+    state: UndoableState;
+}
+/**
+ * useUndoableAction — the perform-with-undo primitive behind destructive
+ * mutations (workplan/03-component-library.md §7.2 Undo pattern): `run()`
+ * applies the mutation optimistically, then either `undo()` reverts it within
+ * the window or `commit()` finalizes it (called automatically when the window
+ * elapses, and on unmount while pending).
+ *
+ * Pairs with `useToastQueue`:
+ * ```tsx
+ * const queue = useToastQueue();
+ * const deletion = useUndoableAction({ perform, undo });
+ * const onDelete = async () => {
+ *   const run = await deletion.run();
+ *   queue.push({ title: '12 records deleted', action: { label: 'Undo', onAction: run.undo } });
+ * };
+ * ```
+ */
+export declare function useUndoableAction<T>(options: UseUndoableActionOptions<T>): UseUndoableActionReturn<T>;
+//# sourceMappingURL=useUndoableAction.d.ts.map

package/dist/hooks/useUndoableAction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useUndoableAction.d.ts","sourceRoot":"","sources":["../../src/hooks/useUndoableAction.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,eAAO,MAAM,cAAc,OAAO,CAAC;AAEnC,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,SAAS,GAAG,WAAW,GAAG,QAAQ,CAAC;AAExE,MAAM,WAAW,wBAAwB,CAAC,CAAC;IACzC;;;OAGG;IACH,OAAO,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IAC9B,sCAAsC;IACtC,IAAI,EAAE,CAAC,OAAO,EAAE,CAAC,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3C;;;;OAIG;IACH,MAAM,CAAC,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,GAAG,SAAS,CAAC;IAC5D,6EAA6E;IAC7E,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,yEAAyE;IACzE,aAAa,CAAC,EAAE,CAAC,CAAC,KAAK,EAAE,aAAa,KAAK,IAAI,CAAC,GAAG,SAAS,CAAC;CAC9D;AAED,MAAM,WAAW,WAAW,CAAC,CAAC;IAC5B,yCAAyC;IACzC,OAAO,EAAE,CAAC,CAAC;IACX,+DAA+D;IAC/D,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1B,mEAAmE;IACnE,MAAM,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC7B;AAED,MAAM,WAAW,uBAAuB,CAAC,CAAC;IACxC,kEAAkE;IAClE,GAAG,EAAE,MAAM,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC;IACnC,mEAAmE;IACnE,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1B,2EAA2E;IAC3E,MAAM,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5B,mCAAmC;IACnC,KAAK,EAAE,aAAa,CAAC;CACtB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,OAAO,EAAE,wBAAwB,CAAC,CAAC,CAAC,GAAG,uBAAuB,CAAC,CAAC,CAAC,CAsErG"}

package/dist/hooks/useUndoableAction.js

@@ -0,0 +1,85 @@
+import { useCallback, useEffect, useRef, useState } from 'react';
+/**
+ * Duration of the undo window, matching the undo-toast auto-dismiss
+ * (workplan/03-component-library.md §7.2 — action/Undo 5200ms).
+ */
+export const UNDO_WINDOW_MS = 5200;
+/**
+ * useUndoableAction — the perform-with-undo primitive behind destructive
+ * mutations (workplan/03-component-library.md §7.2 Undo pattern): `run()`
+ * applies the mutation optimistically, then either `undo()` reverts it within
+ * the window or `commit()` finalizes it (called automatically when the window
+ * elapses, and on unmount while pending).
+ *
+ * Pairs with `useToastQueue`:
+ * ```tsx
+ * const queue = useToastQueue();
+ * const deletion = useUndoableAction({ perform, undo });
+ * const onDelete = async () => {
+ *   const run = await deletion.run();
+ *   queue.push({ title: '12 records deleted', action: { label: 'Undo', onAction: run.undo } });
+ * };
+ * ```
+ */
+export function useUndoableAction(options) {
+    const [state, setState] = useState('idle');
+    const optionsRef = useRef(options);
+    optionsRef.current = options;
+    const pendingRef = useRef(null);
+    const timerRef = useRef(null);
+    const clearTimer = () => {
+        if (timerRef.current !== null) {
+            clearTimeout(timerRef.current);
+            timerRef.current = null;
+        }
+    };
+    const transition = useCallback((next) => {
+        setState(next);
+        optionsRef.current.onStateChange?.(next);
+    }, []);
+    const run = useCallback(async () => {
+        // A new run supersedes a still-pending one: finalize the old first.
+        if (pendingRef.current !== null)
+            await pendingRef.current.commit();
+        const context = await optionsRef.current.perform();
+        let settled = false;
+        const settle = async (kind) => {
+            if (settled)
+                return;
+            settled = true;
+            clearTimer();
+            if (pendingRef.current === handle)
+                pendingRef.current = null;
+            if (kind === 'undone')
+                await optionsRef.current.undo(context);
+            else
+                await optionsRef.current.commit?.(context);
+            transition(kind);
+        };
+        const handle = {
+            context,
+            undo: () => settle('undone'),
+            commit: () => settle('committed'),
+        };
+        pendingRef.current = handle;
+        transition('pending');
+        timerRef.current = setTimeout(() => {
+            void handle.commit();
+        }, optionsRef.current.timeoutMs ?? UNDO_WINDOW_MS);
+        return handle;
+    }, [transition]);
+    const undo = useCallback(async () => {
+        await pendingRef.current?.undo();
+    }, []);
+    const commit = useCallback(async () => {
+        await pendingRef.current?.commit();
+    }, []);
+    // Finalize a pending run on unmount — the optimistic mutation already
+    // happened, so dropping the commit would leave it half-applied.
+    useEffect(() => () => {
+        clearTimer();
+        void pendingRef.current?.commit();
+    }, []);
+    return { run, undo, commit, state };
+}
+//# sourceMappingURL=useUndoableAction.js.map

package/dist/hooks/useUndoableAction.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,69 @@
+export * from './lib/index.js';
+export * from './theme/index.js';
+export * from './components/alert/index.js';
+export * from './components/auth-layout/index.js';
+export * from './components/auth-screens/index.js';
+export * from './components/autosave-indicator/index.js';
+export * from './components/avatar/index.js';
+export * from './components/avatar-stack/index.js';
+export * from './components/badge/index.js';
+export * from './components/banner/index.js';
+export * from './components/breadcrumbs/index.js';
+export * from './components/bulk-action-bar/index.js';
+export * from './components/button/index.js';
+export * from './components/card/index.js';
+export * from './components/checkbox/index.js';
+export * from './components/chip-input/index.js';
+export * from './components/choice-chips/index.js';
+export * from './components/combobox/index.js';
+export * from './components/command-palette/index.js';
+export * from './components/confirm-modal/index.js';
+export * from './components/count-badge/index.js';
+export * from './components/date-input/index.js';
+export * from './components/delta-pill/index.js';
+export * from './components/divider/index.js';
+export * from './components/drawer/index.js';
+export * from './components/dropdown-menu/index.js';
+export * from './components/empty-state/index.js';
+export * from './components/filter-chip/index.js';
+export * from './components/form-field/index.js';
+export * from './components/icon/index.js';
+export * from './components/icon-button/index.js';
+export * from './components/icon-tile/index.js';
+export * from './components/input/index.js';
+export * from './components/input-group/index.js';
+export * from './components/kbd/index.js';
+export * from './components/key-value-list/index.js';
+export * from './components/label/index.js';
+export * from './components/modal/index.js';
+export * from './components/mono-text/index.js';
+export * from './components/number-stepper/index.js';
+export * from './components/otp-input/index.js';
+export * from './components/pagination/index.js';
+export * from './components/password-strength/index.js';
+export * from './components/permission-matrix/index.js';
+export * from './components/popover/index.js';
+export * from './components/progress-bar/index.js';
+export * from './components/radio/index.js';
+export * from './components/radio-card/index.js';
+export * from './components/runtime-chip/index.js';
+export * from './components/search-input/index.js';
+export * from './components/secret-input/index.js';
+export * from './components/segmented-control/index.js';
+export * from './components/select/index.js';
+export * from './components/skeleton/index.js';
+export * from './components/slider/index.js';
+export * from './components/snackbar/index.js';
+export * from './components/spinner/index.js';
+export * from './components/status-pill/index.js';
+export * from './components/stepper/index.js';
+export * from './components/success-state/index.js';
+export * from './components/switch/index.js';
+export * from './components/tabs/index.js';
+export * from './components/tag/index.js';
+export * from './components/textarea/index.js';
+export * from './components/toast/index.js';
+export * from './components/toggle-matrix/index.js';
+export * from './components/tooltip/index.js';
+export * from './components/two-phase-modal/index.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,kBAAkB,CAAC;AACjC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,mCAAmC,CAAC;AAClD,cAAc,oCAAoC,CAAC;AACnD,cAAc,0CAA0C,CAAC;AACzD,cAAc,8BAA8B,CAAC;AAC7C,cAAc,oCAAoC,CAAC;AACnD,cAAc,6BAA6B,CAAC;AAC5C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,mCAAmC,CAAC;AAClD,cAAc,uCAAuC,CAAC;AACtD,cAAc,8BAA8B,CAAC;AAC7C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,kCAAkC,CAAC;AACjD,cAAc,oCAAoC,CAAC;AACnD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,uCAAuC,CAAC;AACtD,cAAc,qCAAqC,CAAC;AACpD,cAAc,mCAAmC,CAAC;AAClD,cAAc,kCAAkC,CAAC;AACjD,cAAc,kCAAkC,CAAC;AACjD,cAAc,+BAA+B,CAAC;AAC9C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,qCAAqC,CAAC;AACpD,cAAc,mCAAmC,CAAC;AAClD,cAAc,mCAAmC,CAAC;AAClD,cAAc,kCAAkC,CAAC;AACjD,cAAc,4BAA4B,CAAC;AAC3C,cAAc,mCAAmC,CAAC;AAClD,cAAc,iCAAiC,CAAC;AAChD,cAAc,6BAA6B,CAAC;AAC5C,cAAc,mCAAmC,CAAC;AAClD,cAAc,2BAA2B,CAAC;AAC1C,cAAc,sCAAsC,CAAC;AACrD,cAAc,6BAA6B,CAAC;AAC5C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,iCAAiC,CAAC;AAChD,cAAc,sCAAsC,CAAC;AACrD,cAAc,iCAAiC,CAAC;AAChD,cAAc,kCAAkC,CAAC;AACjD,cAAc,yCAAyC,CAAC;AACxD,cAAc,yCAAyC,CAAC;AACxD,cAAc,+BAA+B,CAAC;AAC9C,cAAc,oCAAoC,CAAC;AACnD,cAAc,6BAA6B,CAAC;AAC5C,cAAc,kCAAkC,CAAC;AACjD,cAAc,oCAAoC,CAAC;AACnD,cAAc,oCAAoC,CAAC;AACnD,cAAc,oCAAoC,CAAC;AACnD,cAAc,yCAAyC,CAAC;AACxD,cAAc,8BAA8B,CAAC;AAC7C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,mCAAmC,CAAC;AAClD,cAAc,+BAA+B,CAAC;AAC9C,cAAc,qCAAqC,CAAC;AACpD,cAAc,8BAA8B,CAAC;AAC7C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,qCAAqC,CAAC;AACpD,cAAc,+BAA+B,CAAC;AAC9C,cAAc,uCAAuC,CAAC"}

package/dist/index.js

@@ -0,0 +1,72 @@
+// GENERATED — pnpm gen:barrel
+// Do not edit by hand: scripts/gen-barrel.mjs rewrites this file on every build.
+// Add exports via a local index.ts in your component directory instead.
+export * from './lib/index.js';
+export * from './theme/index.js';
+export * from './components/alert/index.js';
+export * from './components/auth-layout/index.js';
+export * from './components/auth-screens/index.js';
+export * from './components/autosave-indicator/index.js';
+export * from './components/avatar/index.js';
+export * from './components/avatar-stack/index.js';
+export * from './components/badge/index.js';
+export * from './components/banner/index.js';
+export * from './components/breadcrumbs/index.js';
+export * from './components/bulk-action-bar/index.js';
+export * from './components/button/index.js';
+export * from './components/card/index.js';
+export * from './components/checkbox/index.js';
+export * from './components/chip-input/index.js';
+export * from './components/choice-chips/index.js';
+export * from './components/combobox/index.js';
+export * from './components/command-palette/index.js';
+export * from './components/confirm-modal/index.js';
+export * from './components/count-badge/index.js';
+export * from './components/date-input/index.js';
+export * from './components/delta-pill/index.js';
+export * from './components/divider/index.js';
+export * from './components/drawer/index.js';
+export * from './components/dropdown-menu/index.js';
+export * from './components/empty-state/index.js';
+export * from './components/filter-chip/index.js';
+export * from './components/form-field/index.js';
+export * from './components/icon/index.js';
+export * from './components/icon-button/index.js';
+export * from './components/icon-tile/index.js';
+export * from './components/input/index.js';
+export * from './components/input-group/index.js';
+export * from './components/kbd/index.js';
+export * from './components/key-value-list/index.js';
+export * from './components/label/index.js';
+export * from './components/modal/index.js';
+export * from './components/mono-text/index.js';
+export * from './components/number-stepper/index.js';
+export * from './components/otp-input/index.js';
+export * from './components/pagination/index.js';
+export * from './components/password-strength/index.js';
+export * from './components/permission-matrix/index.js';
+export * from './components/popover/index.js';
+export * from './components/progress-bar/index.js';
+export * from './components/radio/index.js';
+export * from './components/radio-card/index.js';
+export * from './components/runtime-chip/index.js';
+export * from './components/search-input/index.js';
+export * from './components/secret-input/index.js';
+export * from './components/segmented-control/index.js';
+export * from './components/select/index.js';
+export * from './components/skeleton/index.js';
+export * from './components/slider/index.js';
+export * from './components/snackbar/index.js';
+export * from './components/spinner/index.js';
+export * from './components/status-pill/index.js';
+export * from './components/stepper/index.js';
+export * from './components/success-state/index.js';
+export * from './components/switch/index.js';
+export * from './components/tabs/index.js';
+export * from './components/tag/index.js';
+export * from './components/textarea/index.js';
+export * from './components/toast/index.js';
+export * from './components/toggle-matrix/index.js';
+export * from './components/tooltip/index.js';
+export * from './components/two-phase-modal/index.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,8BAA8B;AAC9B,iFAAiF;AACjF,wEAAwE;AACxE,cAAc,gBAAgB,CAAC;AAC/B,cAAc,kBAAkB,CAAC;AACjC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,mCAAmC,CAAC;AAClD,cAAc,oCAAoC,CAAC;AACnD,cAAc,0CAA0C,CAAC;AACzD,cAAc,8BAA8B,CAAC;AAC7C,cAAc,oCAAoC,CAAC;AACnD,cAAc,6BAA6B,CAAC;AAC5C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,mCAAmC,CAAC;AAClD,cAAc,uCAAuC,CAAC;AACtD,cAAc,8BAA8B,CAAC;AAC7C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,kCAAkC,CAAC;AACjD,cAAc,oCAAoC,CAAC;AACnD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,uCAAuC,CAAC;AACtD,cAAc,qCAAqC,CAAC;AACpD,cAAc,mCAAmC,CAAC;AAClD,cAAc,kCAAkC,CAAC;AACjD,cAAc,kCAAkC,CAAC;AACjD,cAAc,+BAA+B,CAAC;AAC9C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,qCAAqC,CAAC;AACpD,cAAc,mCAAmC,CAAC;AAClD,cAAc,mCAAmC,CAAC;AAClD,cAAc,kCAAkC,CAAC;AACjD,cAAc,4BAA4B,CAAC;AAC3C,cAAc,mCAAmC,CAAC;AAClD,cAAc,iCAAiC,CAAC;AAChD,cAAc,6BAA6B,CAAC;AAC5C,cAAc,mCAAmC,CAAC;AAClD,cAAc,2BAA2B,CAAC;AAC1C,cAAc,sCAAsC,CAAC;AACrD,cAAc,6BAA6B,CAAC;AAC5C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,iCAAiC,CAAC;AAChD,cAAc,sCAAsC,CAAC;AACrD,cAAc,iCAAiC,CAAC;AAChD,cAAc,kCAAkC,CAAC;AACjD,cAAc,yCAAyC,CAAC;AACxD,cAAc,yCAAyC,CAAC;AACxD,cAAc,+BAA+B,CAAC;AAC9C,cAAc,oCAAoC,CAAC;AACnD,cAAc,6BAA6B,CAAC;AAC5C,cAAc,kCAAkC,CAAC;AACjD,cAAc,oCAAoC,CAAC;AACnD,cAAc,oCAAoC,CAAC;AACnD,cAAc,oCAAoC,CAAC;AACnD,cAAc,yCAAyC,CAAC;AACxD,cAAc,8BAA8B,CAAC;AAC7C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,mCAAmC,CAAC;AAClD,cAAc,+BAA+B,CAAC;AAC9C,cAAc,qCAAqC,CAAC;AACpD,cAAc,8BAA8B,CAAC;AAC7C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,qCAAqC,CAAC;AACpD,cAAc,+BAA+B,CAAC;AAC9C,cAAc,uCAAuC,CAAC"}

package/dist/lib/cn.d.ts

@@ -0,0 +1,33 @@
+/**
+ * `cn()` — the single class-composition utility for `@adminium/ui`
+ * (workplan/03-component-library.md §2, §3.1).
+ *
+ * clsx handles conditional/array inputs; tailwind-merge resolves conflicting
+ * Tailwind utilities so the consumer `className` (always passed last by
+ * components) wins over CVA-produced classes.
+ */
+import { type ClassValue } from 'clsx';
+import type { CSSProperties } from 'react';
+export type { ClassValue } from 'clsx';
+/** Compose class names; later Tailwind utilities override earlier conflicts. */
+export declare function cn(...inputs: ClassValue[]): string;
+/**
+ * A map of CSS custom properties (`--*` keys only) to their values.
+ * `null`/`undefined` entries are dropped, numbers are stringified.
+ */
+export type CssVarMap = Record<`--${string}`, string | number | null | undefined>;
+/**
+ * `cssVars()` — typed builder for CSS-custom-property bags
+ * (workplan/03-component-library.md §3.4).
+ *
+ * The JSX `style` prop is banned (`adminium/no-style-prop`); its single
+ * sanctioned escape hatch is an INLINE object literal whose every key is a
+ * string-literal custom property, e.g. `style={{ '--progress': pct }}` — the
+ * lint rule cannot see inside a call expression, so `style={cssVars(...)}`
+ * is still reported. Use this helper for the non-JSX surfaces of the same
+ * mechanism: imperative writes (`Object.assign(el.style, cssVars({...}))`),
+ * chart geometry passed to third-party APIs, and for typing the objects that
+ * component props accept before they are inlined at the JSX call site.
+ */
+export declare function cssVars(vars: CssVarMap): CSSProperties;
+//# sourceMappingURL=cn.d.ts.map

package/dist/lib/cn.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cn.d.ts","sourceRoot":"","sources":["../../src/lib/cn.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAQ,KAAK,UAAU,EAAE,MAAM,MAAM,CAAC;AAE7C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAE3C,YAAY,EAAE,UAAU,EAAE,MAAM,MAAM,CAAC;AA2BvC,gFAAgF;AAChF,wBAAgB,EAAE,CAAC,GAAG,MAAM,EAAE,UAAU,EAAE,GAAG,MAAM,CAElD;AAED;;;GAGG;AACH,MAAM,MAAM,SAAS,GAAG,MAAM,CAAC,KAAK,MAAM,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC,CAAC;AAElF;;;;;;;;;;;;GAYG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,SAAS,GAAG,aAAa,CAMtD"}

package/dist/lib/cn.js

@@ -0,0 +1,59 @@
+/**
+ * `cn()` — the single class-composition utility for `@adminium/ui`
+ * (workplan/03-component-library.md §2, §3.1).
+ *
+ * clsx handles conditional/array inputs; tailwind-merge resolves conflicting
+ * Tailwind utilities so the consumer `className` (always passed last by
+ * components) wins over CVA-produced classes.
+ */
+import { clsx } from 'clsx';
+import { extendTailwindMerge } from 'tailwind-merge';
+/**
+ * tailwind-merge must be taught the @adminium/tokens custom utilities, or it
+ * mis-buckets them: without this, `text-micro` (type scale) and `text-fg-subtle`
+ * (color) both land in the ambiguous `text-*` group and one silently wins.
+ * Keep these lists in sync with packages/tokens/src/tailwind.css `@theme`.
+ */
+const TOKEN_FONT_SIZES = ['display', 'title', 'section', 'modal', 'body', 'body-sm', 'caption', 'micro'];
+const TOKEN_COLORS = [
+    'bg', 'surface', 'surface-2', 'surface-3', 'border', 'border-strong',
+    'fg', 'fg-muted', 'fg-subtle',
+    'accent', 'accent-fg', 'accent-soft', 'accent-hover', 'accent-border',
+    'pos', 'pos-soft', 'warn', 'warn-soft', 'danger', 'danger-soft', 'info', 'info-soft',
+    ...Array.from({ length: 8 }, (_, i) => `viz-${i + 1}`),
+];
+const twMerge = extendTailwindMerge({
+    extend: {
+        theme: { color: TOKEN_COLORS },
+        classGroups: {
+            'font-size': [{ text: TOKEN_FONT_SIZES }],
+            shadow: [{ shadow: ['card', 'menu', 'modal', 'glow'] }],
+        },
+    },
+});
+/** Compose class names; later Tailwind utilities override earlier conflicts. */
+export function cn(...inputs) {
+    return twMerge(clsx(inputs));
+}
+/**
+ * `cssVars()` — typed builder for CSS-custom-property bags
+ * (workplan/03-component-library.md §3.4).
+ *
+ * The JSX `style` prop is banned (`adminium/no-style-prop`); its single
+ * sanctioned escape hatch is an INLINE object literal whose every key is a
+ * string-literal custom property, e.g. `style={{ '--progress': pct }}` — the
+ * lint rule cannot see inside a call expression, so `style={cssVars(...)}`
+ * is still reported. Use this helper for the non-JSX surfaces of the same
+ * mechanism: imperative writes (`Object.assign(el.style, cssVars({...}))`),
+ * chart geometry passed to third-party APIs, and for typing the objects that
+ * component props accept before they are inlined at the JSX call site.
+ */
+export function cssVars(vars) {
+    const out = {};
+    for (const [key, value] of Object.entries(vars)) {
+        if (value !== null && value !== undefined)
+            out[key] = String(value);
+    }
+    return out;
+}
+//# sourceMappingURL=cn.js.map

package/dist/lib/cn.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cn.js","sourceRoot":"","sources":["../../src/lib/cn.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,IAAI,EAAmB,MAAM,MAAM,CAAC;AAC7C,OAAO,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAKrD;;;;;GAKG;AACH,MAAM,gBAAgB,GAAG,CAAC,SAAS,EAAE,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC;AACzG,MAAM,YAAY,GAAG;IACnB,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,WAAW,EAAE,QAAQ,EAAE,eAAe;IACpE,IAAI,EAAE,UAAU,EAAE,WAAW;IAC7B,QAAQ,EAAE,WAAW,EAAE,aAAa,EAAE,cAAc,EAAE,eAAe;IACrE,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,WAAW,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,EAAE,WAAW;IACpF,GAAG,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;CACvD,CAAC;AAEF,MAAM,OAAO,GAAG,mBAAmB,CAAC;IAClC,MAAM,EAAE;QACN,KAAK,EAAE,EAAE,KAAK,EAAE,YAAY,EAAE;QAC9B,WAAW,EAAE;YACX,WAAW,EAAE,CAAC,EAAE,IAAI,EAAE,gBAAgB,EAAE,CAAC;YACzC,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,CAAC;SACxD;KACF;CACF,CAAC,CAAC;AAEH,gFAAgF;AAChF,MAAM,UAAU,EAAE,CAAC,GAAG,MAAoB;IACxC,OAAO,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;AAC/B,CAAC;AAQD;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,OAAO,CAAC,IAAe;IACrC,MAAM,GAAG,GAA2B,EAAE,CAAC;IACvC,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;QAChD,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS;YAAE,GAAG,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IACtE,CAAC;IACD,OAAO,GAAoB,CAAC;AAC9B,CAAC"}

package/dist/lib/index.d.ts

@@ -0,0 +1,3 @@
+export { cn, cssVars } from './cn.js';
+export type { ClassValue, CssVarMap } from './cn.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/lib/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/lib/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AACtC,YAAY,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC"}

package/dist/lib/index.js

@@ -0,0 +1,2 @@
+export { cn, cssVars } from './cn.js';
+//# sourceMappingURL=index.js.map

package/dist/lib/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/lib/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC"}