@adminiumjs/ui 0.1.0-rc.1

package/dist/components/toast/Toast.js

@@ -0,0 +1,63 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { AlertTriangle, CheckCircle2, Info, Loader2, X, XCircle } from 'lucide-react';
+import { cn } from '../../lib/cn.js';
+import { IconTile } from '../icon-tile/index.js';
+const variantTone = {
+    success: 'pos',
+    error: 'danger',
+    warning: 'warn',
+    info: 'info',
+    loading: 'accent',
+};
+const toneBarBg = {
+    neutral: 'bg-fg-subtle',
+    accent: 'bg-accent',
+    pos: 'bg-pos',
+    warn: 'bg-warn',
+    danger: 'bg-danger',
+    info: 'bg-info',
+};
+/**
+ * Default auto-dismiss durations in ms (03-component-library.md §7.2).
+ * The imperative queue manager that actually fires dismissal is wave 2 —
+ * here the duration only drives the visual `nb-toastbar` countdown.
+ */
+export const TOAST_DEFAULT_DURATIONS = {
+    success: 2600,
+    info: 3400,
+    warning: 4200,
+    error: 5200,
+    loading: null,
+};
+/**
+ * Toast — single toast primitive: icon tile · title · description · optional
+ * action · close · bottom timer bar (`nb-toastbar` scaleX). Slide-in via
+ * `nb-toastin`, RTL-mirrored to `nb-toastin-rtl`
+ * (research/design-system.md §3 Tier 3). Queue semantics (max 4,
+ * auto-dismiss, `toast.*` imperative API) are wave 2 — this is the
+ * controlled primitive.
+ */
+export function Toast({ variant = 'info', title, description, action, onDismiss, dismissLabel, duration, className, ...props }) {
+    const tone = variantTone[variant];
+    const effectiveDuration = duration === undefined ? TOAST_DEFAULT_DURATIONS[variant] : duration;
+    const icons = {
+        success: _jsx(CheckCircle2, {}),
+        error: _jsx(XCircle, {}),
+        warning: _jsx(AlertTriangle, {}),
+        info: _jsx(Info, {}),
+        loading: _jsx(Loader2, { className: "animate-[nb-spin_.8s_linear_infinite]" }),
+    };
+    return (_jsxs("div", { role: variant === 'error' ? 'alert' : 'status', "data-variant": variant, className: cn('pointer-events-auto relative flex w-[360px] max-w-full items-start gap-3 overflow-hidden', 'rounded-lg border border-border bg-surface p-3.5 pb-4 shadow-menu', 'animate-[nb-toastin_.24s_cubic-bezier(.2,.7,.3,1)] rtl:animate-[nb-toastin-rtl_.24s_cubic-bezier(.2,.7,.3,1)]', className), ...props, children: [_jsx(IconTile, { size: "sm", tone: tone, icon: icons[variant] }), _jsxs("div", { className: "min-w-0 flex-1", children: [_jsx("div", { className: "text-[13px] font-bold leading-snug text-fg", children: title }), description === undefined || description === null ? null : (_jsx("div", { className: "mt-0.5 text-body-sm text-fg-muted", children: description })), action === undefined ? null : (_jsx("button", { type: "button", onClick: action.onAction, className: cn('mt-1.5 text-[12.5px] font-bold text-accent hover:underline', 'focus-visible:outline-2 focus-visible:outline-offset-2 focus-visible:outline-accent'), children: action.label }))] }), onDismiss === undefined ? null : (_jsx("button", { type: "button", "aria-label": dismissLabel, onClick: onDismiss, className: cn('nb-ib -me-1 -mt-1 inline-flex size-7 shrink-0 items-center justify-center rounded-md text-fg-muted', 'focus-visible:outline-2 focus-visible:outline-offset-2 focus-visible:outline-accent'), children: _jsx(X, { className: "size-3.5", "aria-hidden": "true" }) })), effectiveDuration === null ? null : (_jsx("div", { "aria-hidden": "true", className: "absolute inset-x-0 bottom-0 h-[3px] bg-surface-3", children: _jsx("div", { "data-testid": "toast-timer-bar", className: cn('h-full w-full [transform-origin:0%_50%] rtl:[transform-origin:100%_50%]', 'animate-[nb-toastbar_var(--adm-duration,4200ms)_linear_forwards]', toneBarBg[tone]), style: { '--adm-duration': `${effectiveDuration}ms` } }) }))] }));
+}
+/**
+ * ToastStack — fixed container at bottom / inline-end (RTL-mirrored via the
+ * logical `end-4`) rendering a controlled list of toasts. Max-4 clamping,
+ * FIFO overflow and auto-dismiss timers are the wave-2 queue manager's job;
+ * callers own the array here.
+ */
+export function ToastStack({ toasts, onDismissToast, dismissLabel, label, className, ...props }) {
+    return (_jsx("div", { role: "region", "aria-label": label, className: cn('pointer-events-none fixed bottom-4 end-4 z-[100] flex w-[360px] max-w-[calc(100vw-32px)] flex-col gap-2.5', className), ...props, children: toasts.map((toast) => (_jsx(Toast, { variant: toast.variant ?? 'info', title: toast.title, description: toast.description, action: toast.action, duration: toast.duration, dismissLabel: dismissLabel, onDismiss: () => onDismissToast(toast.id) }, toast.id))) }));
+}
+/** Alias — some docs refer to the stack container as the toast viewport. */
+export const ToastViewport = ToastStack;
+//# sourceMappingURL=Toast.js.map

package/dist/components/toast/Toast.js.map

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

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

@@ -0,0 +1,5 @@
+export { TOAST_DEFAULT_DURATIONS, Toast, ToastStack, ToastViewport } from './Toast.js';
+export type { ToastActionSpec, ToastItem, ToastProps, ToastStackProps, ToastVariant } from './Toast.js';
+export { MAX_VISIBLE_TOASTS, TOAST_ACTION_DURATION, TOAST_HOVER_PAUSE_CLASS, useToastQueue, } from './useToastQueue.js';
+export type { PushToastOptions, ToastPromiseMessages, ToastStackBindings, UpdateToastPatch, UseToastQueueReturn, } from './useToastQueue.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/toast/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,KAAK,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AACvF,YAAY,EAAE,eAAe,EAAE,SAAS,EAAE,UAAU,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AACxG,OAAO,EACL,kBAAkB,EAClB,qBAAqB,EACrB,uBAAuB,EACvB,aAAa,GACd,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EACV,gBAAgB,EAChB,oBAAoB,EACpB,kBAAkB,EAClB,gBAAgB,EAChB,mBAAmB,GACpB,MAAM,oBAAoB,CAAC"}

package/dist/components/toast/index.js

@@ -0,0 +1,3 @@
+export { TOAST_DEFAULT_DURATIONS, Toast, ToastStack, ToastViewport } from './Toast.js';
+export { MAX_VISIBLE_TOASTS, TOAST_ACTION_DURATION, TOAST_HOVER_PAUSE_CLASS, useToastQueue, } from './useToastQueue.js';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/components/toast/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,KAAK,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEvF,OAAO,EACL,kBAAkB,EAClB,qBAAqB,EACrB,uBAAuB,EACvB,aAAa,GACd,MAAM,oBAAoB,CAAC"}

package/dist/components/toast/useToastQueue.d.ts

@@ -0,0 +1,73 @@
+import type { ReactNode } from 'react';
+import type { ToastActionSpec, ToastItem, ToastVariant } from './Toast.js';
+/** Max simultaneously visible toasts (workplan/03-component-library.md §7.2). */
+export declare const MAX_VISIBLE_TOASTS = 4;
+/** Auto-dismiss duration for toasts carrying an action (Undo/Download). */
+export declare const TOAST_ACTION_DURATION = 5200;
+/**
+ * Pauses every timer bar's CSS countdown while the stack is hovered, keeping
+ * the visual bar in sync with the paused JS timers. Passed to `ToastStack`
+ * through `stackProps.className`.
+ */
+export declare const TOAST_HOVER_PAUSE_CLASS = "[&:hover_[data-testid=toast-timer-bar]]:[animation-play-state:paused]";
+export interface PushToastOptions {
+    variant?: ToastVariant | undefined;
+    title: ReactNode;
+    description?: ReactNode;
+    /** Action button (Undo/Download). Dismisses the toast after firing unless `keepOnAction`. */
+    action?: ToastActionSpec | undefined;
+    /**
+     * Auto-dismiss in ms; `null` keeps the toast until dismissed. Defaults per
+     * variant (success 2600 / info 3400 / warning 4200 / error 5200 / loading ∞;
+     * 5200 whenever an action is present).
+     */
+    duration?: number | null | undefined;
+    /** Keep the toast open after its action fires (default dismisses it). */
+    keepOnAction?: boolean | undefined;
+    /** Reuse a caller-supplied id (e.g. to update the same toast later). */
+    id?: string | undefined;
+}
+export type UpdateToastPatch = Partial<Omit<PushToastOptions, 'id'>>;
+export interface ToastPromiseMessages<T> {
+    loading: ReactNode;
+    success: ReactNode | ((value: T) => ReactNode);
+    error: ReactNode | ((reason: unknown) => ReactNode);
+}
+export interface ToastStackBindings {
+    toasts: ToastItem[];
+    onDismissToast: (id: string) => void;
+    onMouseEnter: () => void;
+    onMouseLeave: () => void;
+    className: string;
+}
+export interface UseToastQueueReturn {
+    /** Visible toasts, newest first — feed straight into `ToastStack`. */
+    toasts: ToastItem[];
+    /** Enqueue a toast; returns its id. Overflow beyond 4 queues FIFO. */
+    push: (options: PushToastOptions) => string;
+    /** Dismiss one toast by id, or every toast (and the queue) with no args. */
+    dismiss: (id?: string) => void;
+    /** Patch a toast in place (loading→done: pass variant/title; timer restarts). */
+    update: (id: string, patch: UpdateToastPatch) => void;
+    /** Loading toast that resolves to success/error with the promise. */
+    promise: <T>(promise: Promise<T>, messages: ToastPromiseMessages<T>) => Promise<T>;
+    /** Pause all auto-dismiss timers (wired to stack hover). */
+    pauseAll: () => void;
+    /** Resume timers with their remaining time. */
+    resumeAll: () => void;
+    /**
+     * Spread onto `ToastStack` (add the i18n `dismissLabel` yourself):
+     * `<ToastStack {...queue.stackProps} dismissLabel={t('common.dismiss')} />`
+     */
+    stackProps: ToastStackBindings;
+}
+/**
+ * useToastQueue — imperative toast queue manager
+ * (workplan/03-component-library.md §7.2): max 4 visible newest-first,
+ * overflow queues FIFO and enters as older toasts dismiss, per-variant
+ * auto-dismiss, pause-on-hover (JS timers + CSS timer bar), undo-action
+ * toasts and promise toasts (loading → success/error). Mount one queue per
+ * app next to a single `ToastStack`.
+ */
+export declare function useToastQueue(): UseToastQueueReturn;
+//# sourceMappingURL=useToastQueue.d.ts.map

package/dist/components/toast/useToastQueue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useToastQueue.d.ts","sourceRoot":"","sources":["../../../src/components/toast/useToastQueue.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAGvC,OAAO,KAAK,EAAE,eAAe,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE3E,iFAAiF;AACjF,eAAO,MAAM,kBAAkB,IAAI,CAAC;AAEpC,2EAA2E;AAC3E,eAAO,MAAM,qBAAqB,OAAO,CAAC;AAE1C;;;;GAIG;AACH,eAAO,MAAM,uBAAuB,0EACqC,CAAC;AAE1E,MAAM,WAAW,gBAAgB;IAC/B,OAAO,CAAC,EAAE,YAAY,GAAG,SAAS,CAAC;IACnC,KAAK,EAAE,SAAS,CAAC;IACjB,WAAW,CAAC,EAAE,SAAS,CAAC;IACxB,6FAA6F;IAC7F,MAAM,CAAC,EAAE,eAAe,GAAG,SAAS,CAAC;IACrC;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IACrC,yEAAyE;IACzE,YAAY,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACnC,wEAAwE;IACxE,EAAE,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACzB;AAED,MAAM,MAAM,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,gBAAgB,EAAE,IAAI,CAAC,CAAC,CAAC;AAErE,MAAM,WAAW,oBAAoB,CAAC,CAAC;IACrC,OAAO,EAAE,SAAS,CAAC;IACnB,OAAO,EAAE,SAAS,GAAG,CAAC,CAAC,KAAK,EAAE,CAAC,KAAK,SAAS,CAAC,CAAC;IAC/C,KAAK,EAAE,SAAS,GAAG,CAAC,CAAC,MAAM,EAAE,OAAO,KAAK,SAAS,CAAC,CAAC;CACrD;AAED,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,SAAS,EAAE,CAAC;IACpB,cAAc,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IACrC,YAAY,EAAE,MAAM,IAAI,CAAC;IACzB,YAAY,EAAE,MAAM,IAAI,CAAC;IACzB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,mBAAmB;IAClC,sEAAsE;IACtE,MAAM,EAAE,SAAS,EAAE,CAAC;IACpB,sEAAsE;IACtE,IAAI,EAAE,CAAC,OAAO,EAAE,gBAAgB,KAAK,MAAM,CAAC;IAC5C,4EAA4E;IAC5E,OAAO,EAAE,CAAC,EAAE,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IAC/B,iFAAiF;IACjF,MAAM,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,gBAAgB,KAAK,IAAI,CAAC;IACtD,qEAAqE;IACrE,OAAO,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,oBAAoB,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC;IACnF,4DAA4D;IAC5D,QAAQ,EAAE,MAAM,IAAI,CAAC;IACrB,+CAA+C;IAC/C,SAAS,EAAE,MAAM,IAAI,CAAC;IACtB;;;OAGG;IACH,UAAU,EAAE,kBAAkB,CAAC;CAChC;AAoBD;;;;;;;GAOG;AACH,wBAAgB,aAAa,IAAI,mBAAmB,CAmMnD"}

package/dist/components/toast/useToastQueue.js

@@ -0,0 +1,191 @@
+import { useCallback, useEffect, useMemo, useRef, useState } from 'react';
+import { TOAST_DEFAULT_DURATIONS } from './Toast.js';
+/** Max simultaneously visible toasts (workplan/03-component-library.md §7.2). */
+export const MAX_VISIBLE_TOASTS = 4;
+/** Auto-dismiss duration for toasts carrying an action (Undo/Download). */
+export const TOAST_ACTION_DURATION = 5200;
+/**
+ * Pauses every timer bar's CSS countdown while the stack is hovered, keeping
+ * the visual bar in sync with the paused JS timers. Passed to `ToastStack`
+ * through `stackProps.className`.
+ */
+export const TOAST_HOVER_PAUSE_CLASS = '[&:hover_[data-testid=toast-timer-bar]]:[animation-play-state:paused]';
+let toastSeq = 0;
+function resolveDuration(options) {
+    if (options.duration !== undefined)
+        return options.duration;
+    if (options.action !== undefined)
+        return TOAST_ACTION_DURATION;
+    return TOAST_DEFAULT_DURATIONS[options.variant ?? 'info'];
+}
+/**
+ * useToastQueue — imperative toast queue manager
+ * (workplan/03-component-library.md §7.2): max 4 visible newest-first,
+ * overflow queues FIFO and enters as older toasts dismiss, per-variant
+ * auto-dismiss, pause-on-hover (JS timers + CSS timer bar), undo-action
+ * toasts and promise toasts (loading → success/error). Mount one queue per
+ * app next to a single `ToastStack`.
+ */
+export function useToastQueue() {
+    const [toasts, setToasts] = useState([]);
+    const visibleRef = useRef([]);
+    const queueRef = useRef([]);
+    const timersRef = useRef(new Map());
+    const pausedRef = useRef(false);
+    const flush = useCallback(() => {
+        setToasts([...visibleRef.current]);
+    }, []);
+    const clearTimer = useCallback((id) => {
+        const record = timersRef.current.get(id);
+        if (record?.handle != null)
+            clearTimeout(record.handle);
+        timersRef.current.delete(id);
+    }, []);
+    // dismiss and startTimer are mutually recursive (timer fire → dismiss →
+    // promote queued toast → start its timer); indirection via ref.
+    const dismissRef = useRef(() => { });
+    const startTimer = useCallback((id, duration) => {
+        if (duration === null)
+            return;
+        const record = { handle: null, remaining: duration, startedAt: Date.now() };
+        if (!pausedRef.current) {
+            record.handle = setTimeout(() => dismissRef.current(id), duration);
+        }
+        timersRef.current.set(id, record);
+    }, []);
+    const dismiss = useCallback((id) => {
+        if (id === undefined) {
+            for (const toast of visibleRef.current)
+                clearTimer(toast.id);
+            visibleRef.current = [];
+            queueRef.current = [];
+            flush();
+            return;
+        }
+        const index = visibleRef.current.findIndex((t) => t.id === id);
+        if (index === -1) {
+            queueRef.current = queueRef.current.filter((t) => t.id !== id);
+            return;
+        }
+        clearTimer(id);
+        visibleRef.current = visibleRef.current.filter((t) => t.id !== id);
+        // Promote queued toasts FIFO into the freed slots (as the newest rows).
+        while (queueRef.current.length > 0 && visibleRef.current.length < MAX_VISIBLE_TOASTS) {
+            const next = queueRef.current.shift();
+            visibleRef.current = [next, ...visibleRef.current];
+            startTimer(next.id, next.duration ?? null);
+        }
+        flush();
+    }, [clearTimer, flush, startTimer]);
+    dismissRef.current = dismiss;
+    const toItem = useCallback((id, options) => {
+        const duration = resolveDuration(options);
+        const action = options.action === undefined
+            ? undefined
+            : options.keepOnAction
+                ? options.action
+                : {
+                    label: options.action.label,
+                    onAction: () => {
+                        options.action?.onAction();
+                        dismissRef.current(id);
+                    },
+                };
+        return {
+            id,
+            variant: options.variant,
+            title: options.title,
+            description: options.description,
+            action,
+            duration,
+        };
+    }, []);
+    const push = useCallback((options) => {
+        const id = options.id ?? `toast_${++toastSeq}`;
+        const item = toItem(id, options);
+        if (visibleRef.current.length >= MAX_VISIBLE_TOASTS) {
+            queueRef.current = [...queueRef.current, item];
+        }
+        else {
+            visibleRef.current = [item, ...visibleRef.current];
+            startTimer(id, item.duration ?? null);
+            flush();
+        }
+        return id;
+    }, [flush, startTimer, toItem]);
+    const update = useCallback((id, patch) => {
+        const apply = (current) => toItem(id, {
+            variant: 'variant' in patch ? patch.variant : current.variant,
+            title: 'title' in patch ? patch.title : current.title,
+            description: 'description' in patch ? patch.description : current.description,
+            action: 'action' in patch ? patch.action : current.action,
+            ...('duration' in patch ? { duration: patch.duration } : {}),
+            ...(patch.keepOnAction !== undefined ? { keepOnAction: patch.keepOnAction } : {}),
+        });
+        const index = visibleRef.current.findIndex((t) => t.id === id);
+        if (index !== -1) {
+            const next = apply(visibleRef.current[index]);
+            visibleRef.current = visibleRef.current.map((t) => (t.id === id ? next : t));
+            clearTimer(id);
+            startTimer(id, next.duration ?? null);
+            flush();
+            return;
+        }
+        queueRef.current = queueRef.current.map((t) => (t.id === id ? apply(t) : t));
+    }, [clearTimer, flush, startTimer, toItem]);
+    const promise = useCallback((input, messages) => {
+        const id = push({ variant: 'loading', title: messages.loading, duration: null });
+        input.then((value) => {
+            update(id, {
+                variant: 'success',
+                title: typeof messages.success === 'function' ? messages.success(value) : messages.success,
+                duration: TOAST_DEFAULT_DURATIONS.success,
+            });
+        }, (reason) => {
+            update(id, {
+                variant: 'error',
+                title: typeof messages.error === 'function' ? messages.error(reason) : messages.error,
+                duration: TOAST_DEFAULT_DURATIONS.error,
+            });
+        });
+        return input;
+    }, [push, update]);
+    const pauseAll = useCallback(() => {
+        if (pausedRef.current)
+            return;
+        pausedRef.current = true;
+        const now = Date.now();
+        for (const record of timersRef.current.values()) {
+            if (record.handle !== null) {
+                clearTimeout(record.handle);
+                record.handle = null;
+                record.remaining = Math.max(0, record.remaining - (now - record.startedAt));
+            }
+        }
+    }, []);
+    const resumeAll = useCallback(() => {
+        if (!pausedRef.current)
+            return;
+        pausedRef.current = false;
+        for (const [id, record] of timersRef.current.entries()) {
+            record.startedAt = Date.now();
+            record.handle = setTimeout(() => dismissRef.current(id), record.remaining);
+        }
+    }, []);
+    useEffect(() => () => {
+        for (const record of timersRef.current.values()) {
+            if (record.handle !== null)
+                clearTimeout(record.handle);
+        }
+        timersRef.current.clear();
+    }, []);
+    const stackProps = useMemo(() => ({
+        toasts,
+        onDismissToast: dismiss,
+        onMouseEnter: pauseAll,
+        onMouseLeave: resumeAll,
+        className: TOAST_HOVER_PAUSE_CLASS,
+    }), [toasts, dismiss, pauseAll, resumeAll]);
+    return { toasts, push, dismiss, update, promise, pauseAll, resumeAll, stackProps };
+}
+//# sourceMappingURL=useToastQueue.js.map

package/dist/components/toast/useToastQueue.js.map

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

package/dist/components/toggle-matrix/ToggleMatrix.d.ts

@@ -0,0 +1,58 @@
+import type * as React from 'react';
+/**
+ * Cell state vocabulary. `locked` means granted-and-immutable (the Roles
+ * comp's hard-locked Owner column): the cell renders a lock glyph with
+ * neutral tone styling, stays in the keyboard-navigation order for
+ * discoverability, exposes `aria-disabled` and never fires `onToggle`.
+ */
+export type ToggleMatrixCellState = 'on' | 'off' | 'locked';
+export interface ToggleMatrixColumn {
+    id: string;
+    /** Column header text (also used in per-cell accessible names). */
+    label: string;
+    /**
+     * Hard-locks the whole column: a lock glyph joins the header and every
+     * cell renders `locked` regardless of `getCellState`.
+     */
+    locked?: boolean | undefined;
+}
+export interface ToggleMatrixRow {
+    id: string;
+    /** Row header text (also used in per-cell accessible names). */
+    label: string;
+}
+export interface ToggleMatrixGroup {
+    id: string;
+    /** Uppercase eyebrow group label; omit for an unlabeled group. */
+    label?: string | undefined;
+    /** Leading Lucide icon for the group label (decorative). */
+    icon?: React.ReactNode;
+    rows: readonly ToggleMatrixRow[];
+}
+export interface ToggleMatrixProps extends Omit<React.ComponentPropsWithRef<'div'>, 'style' | 'onToggle'> {
+    columns: readonly ToggleMatrixColumn[];
+    /** Row entities, grouped; pass one label-less group for a flat matrix. */
+    groups: readonly ToggleMatrixGroup[];
+    /** Accessible name for the grid (required — i18n). */
+    label: string;
+    /** First-column heading over the row headers (e.g. "Permission"). */
+    rowHeader: React.ReactNode;
+    /** Resolves the state of one cell. */
+    getCellState: (rowId: string, columnId: string) => ToggleMatrixCellState;
+    /** Fires for editable cells with the *requested* next value. */
+    onToggle?: ((rowId: string, columnId: string, next: boolean) => void) | undefined;
+    /** Dirty predicate — dirty cells show the accent diff dot. */
+    isDirty?: ((rowId: string, columnId: string) => boolean) | undefined;
+    /** Disables every editable cell (read-only view / save in flight). */
+    disabled?: boolean | undefined;
+}
+/**
+ * ToggleMatrix — generic row-entities × column-capabilities grid with
+ * tri-state cells per designs/Roles Permissions.dc.html. Column and row
+ * headers are sticky (logical `start`, so RTL mirrors), group labels render
+ * as uppercase `Eyebrow` rows, and the cells form a roving-tabindex ARIA
+ * grid: arrow keys move cell focus (direction-aware), Home/End jump within
+ * the row, Space/Enter toggles the focused cell.
+ */
+export declare function ToggleMatrix({ columns, groups, label, rowHeader, getCellState, onToggle, isDirty, disabled, className, ...props }: ToggleMatrixProps): React.JSX.Element;
+//# sourceMappingURL=ToggleMatrix.d.ts.map

package/dist/components/toggle-matrix/ToggleMatrix.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ToggleMatrix.d.ts","sourceRoot":"","sources":["../../../src/components/toggle-matrix/ToggleMatrix.tsx"],"names":[],"mappings":"AAGA,OAAO,KAAK,KAAK,KAAK,MAAM,OAAO,CAAC;AAKpC;;;;;GAKG;AACH,MAAM,MAAM,qBAAqB,GAAG,IAAI,GAAG,KAAK,GAAG,QAAQ,CAAC;AAE5D,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,mEAAmE;IACnE,KAAK,EAAE,MAAM,CAAC;IACd;;;OAGG;IACH,MAAM,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CAC9B;AAED,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,gEAAgE;IAChE,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,kEAAkE;IAClE,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,4DAA4D;IAC5D,IAAI,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IACvB,IAAI,EAAE,SAAS,eAAe,EAAE,CAAC;CAClC;AAED,MAAM,WAAW,iBACf,SAAQ,IAAI,CAAC,KAAK,CAAC,qBAAqB,CAAC,KAAK,CAAC,EAAE,OAAO,GAAG,UAAU,CAAC;IACtE,OAAO,EAAE,SAAS,kBAAkB,EAAE,CAAC;IACvC,0EAA0E;IAC1E,MAAM,EAAE,SAAS,iBAAiB,EAAE,CAAC;IACrC,sDAAsD;IACtD,KAAK,EAAE,MAAM,CAAC;IACd,qEAAqE;IACrE,SAAS,EAAE,KAAK,CAAC,SAAS,CAAC;IAC3B,sCAAsC;IACtC,YAAY,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,KAAK,qBAAqB,CAAC;IACzE,gEAAgE;IAChE,QAAQ,CAAC,EAAE,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,KAAK,IAAI,CAAC,GAAG,SAAS,CAAC;IAClF,8DAA8D;IAC9D,OAAO,CAAC,EAAE,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,GAAG,SAAS,CAAC;IACrE,sEAAsE;IACtE,QAAQ,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CAChC;AAID;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,EAC3B,OAAO,EACP,MAAM,EACN,KAAK,EACL,SAAS,EACT,YAAY,EACZ,QAAQ,EACR,OAAO,EACP,QAAgB,EAChB,SAAS,EACT,GAAG,KAAK,EACT,EAAE,iBAAiB,qBA8LnB"}

package/dist/components/toggle-matrix/ToggleMatrix.js

@@ -0,0 +1,95 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useDirection } from '@radix-ui/react-direction';
+import { Check, Lock, Minus } from 'lucide-react';
+import { useRef, useState } from 'react';
+import { cn } from '../../lib/cn.js';
+import { Eyebrow } from '../label/index.js';
+const cellKey = (rowId, columnId) => `${rowId}\x00${columnId}`;
+/**
+ * ToggleMatrix — generic row-entities × column-capabilities grid with
+ * tri-state cells per designs/Roles Permissions.dc.html. Column and row
+ * headers are sticky (logical `start`, so RTL mirrors), group labels render
+ * as uppercase `Eyebrow` rows, and the cells form a roving-tabindex ARIA
+ * grid: arrow keys move cell focus (direction-aware), Home/End jump within
+ * the row, Space/Enter toggles the focused cell.
+ */
+export function ToggleMatrix({ columns, groups, label, rowHeader, getCellState, onToggle, isDirty, disabled = false, className, ...props }) {
+    const direction = useDirection();
+    const flatRows = groups.flatMap((group) => group.rows);
+    const [focus, setFocus] = useState({ row: 0, col: 0 });
+    const cellRefs = useRef(new Map());
+    const focusCell = (rowIndex, colIndex) => {
+        const row = flatRows[rowIndex];
+        const column = columns[colIndex];
+        if (row === undefined || column === undefined)
+            return;
+        setFocus({ row: rowIndex, col: colIndex });
+        cellRefs.current.get(cellKey(row.id, column.id))?.focus();
+    };
+    const handleKeyDown = (event) => {
+        if (!(event.target instanceof HTMLElement) || event.target.dataset['part'] !== 'matrix-cell') {
+            return;
+        }
+        const forward = direction === 'rtl' ? 'ArrowLeft' : 'ArrowRight';
+        const backward = direction === 'rtl' ? 'ArrowRight' : 'ArrowLeft';
+        const { row, col } = focus;
+        switch (event.key) {
+            case forward:
+                focusCell(row, col + 1);
+                break;
+            case backward:
+                focusCell(row, col - 1);
+                break;
+            case 'ArrowDown':
+                focusCell(row + 1, col);
+                break;
+            case 'ArrowUp':
+                focusCell(row - 1, col);
+                break;
+            case 'Home':
+                focusCell(row, 0);
+                break;
+            case 'End':
+                focusCell(row, columns.length - 1);
+                break;
+            default:
+                return;
+        }
+        event.preventDefault();
+    };
+    // Clamp the roving position if rows/columns shrank between renders.
+    const focusRow = Math.min(focus.row, Math.max(flatRows.length - 1, 0));
+    const focusCol = Math.min(focus.col, Math.max(columns.length - 1, 0));
+    let flatRowIndex = -1;
+    return (_jsxs("div", { role: "grid", "aria-label": label, "data-part": "toggle-matrix", onKeyDown: handleKeyDown, 
+        // Column count feeds the grid template via the '--*' escape hatch.
+        style: { '--adm-matrix-cols': String(columns.length) }, className: cn('grid overflow-auto rounded-lg border border-border bg-surface shadow-card', '[grid-template-columns:minmax(200px,1.5fr)_repeat(var(--adm-matrix-cols),minmax(84px,110px))]', className), ...props, children: [_jsxs("div", { role: "row", className: "contents", children: [_jsx("div", { role: "columnheader", className: "sticky start-0 top-0 z-30 border-b border-border bg-surface-2 px-5 py-3.5 text-start text-[12px] font-extrabold text-fg", children: rowHeader }), columns.map((column) => (_jsxs("div", { role: "columnheader", "data-part": "matrix-column-header", className: "sticky top-0 z-20 flex items-center justify-center gap-1 border-b border-border bg-surface-2 px-2 py-3.5 text-center text-[12px] font-extrabold text-fg", children: [column.label, column.locked ? (_jsx(Lock, { "aria-hidden": "true", className: "size-3 shrink-0 text-fg-subtle" })) : null] }, column.id)))] }), groups.map((group, groupIndex) => (_jsxs("div", { className: "contents", children: [group.label === undefined ? null : (_jsx("div", { role: "row", className: "contents", children: _jsx("div", { role: "gridcell", "aria-colspan": columns.length + 1, "data-part": "matrix-group-label", className: cn('col-span-full bg-surface pb-1.5 pt-3 ps-5 pe-4', groupIndex > 0 && 'border-t border-border'), children: _jsxs("span", { className: "sticky start-5 inline-flex items-center gap-1.5 [&_svg]:size-3.5 [&_svg]:text-fg-subtle", children: [group.icon, _jsx(Eyebrow, { children: group.label })] }) }) })), group.rows.map((row) => {
+                        flatRowIndex += 1;
+                        const rowIndex = flatRowIndex;
+                        return (_jsxs("div", { role: "row", className: "contents", children: [_jsx("div", { role: "rowheader", className: "sticky start-0 z-10 border-t border-border bg-surface py-2 ps-5 pe-4 text-start text-body-sm font-semibold text-fg", children: row.label }), columns.map((column, colIndex) => {
+                                    const state = column.locked
+                                        ? 'locked'
+                                        : getCellState(row.id, column.id);
+                                    const locked = state === 'locked';
+                                    const on = state === 'on';
+                                    const dirty = !locked && isDirty !== undefined && isDirty(row.id, column.id);
+                                    const roving = rowIndex === focusRow && colIndex === focusCol;
+                                    return (_jsx("div", { role: "gridcell", className: "flex items-center justify-center border-t border-border py-1", children: _jsxs("button", { type: "button", "data-part": "matrix-cell", "data-state": state, "data-dirty": dirty || undefined, "aria-label": `${row.label} — ${column.label}`, "aria-pressed": locked ? true : on, "aria-disabled": locked || disabled || undefined, tabIndex: roving ? 0 : -1, ref: (element) => {
+                                                const key = cellKey(row.id, column.id);
+                                                if (element === null)
+                                                    cellRefs.current.delete(key);
+                                                else
+                                                    cellRefs.current.set(key, element);
+                                            }, onFocus: () => setFocus({ row: rowIndex, col: colIndex }), onClick: () => {
+                                                if (locked || disabled)
+                                                    return;
+                                                onToggle?.(row.id, column.id, !on);
+                                            }, className: cn('relative inline-flex size-8 items-center justify-center rounded-md transition-[background-color,color] duration-100 [&_svg]:size-[15px]', 'focus-visible:outline-2 focus-visible:outline-offset-2 focus-visible:outline-accent', locked
+                                                ? 'cursor-not-allowed bg-surface-3 text-fg-subtle opacity-85'
+                                                : on
+                                                    ? 'bg-accent-soft text-accent hover:bg-surface-3 active:scale-90'
+                                                    : 'text-fg-subtle hover:bg-surface-3 active:scale-90', !locked && disabled && 'cursor-default opacity-60 active:scale-100'), children: [locked ? (_jsx(Lock, { "aria-hidden": "true" })) : on ? (_jsx(Check, { "aria-hidden": "true" })) : (_jsx(Minus, { "aria-hidden": "true" })), dirty ? (_jsx("span", { "data-part": "matrix-dirty-dot", "aria-hidden": "true", className: "absolute end-0.5 top-0.5 size-1.5 rounded-full bg-accent" })) : null] }) }, column.id));
+                                })] }, row.id));
+                    })] }, group.id)))] }));
+}
+//# sourceMappingURL=ToggleMatrix.js.map

package/dist/components/toggle-matrix/ToggleMatrix.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ToggleMatrix.js","sourceRoot":"","sources":["../../../src/components/toggle-matrix/ToggleMatrix.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AACzD,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAGzC,OAAO,EAAE,EAAE,EAAE,MAAM,iBAAiB,CAAC;AACrC,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAuD5C,MAAM,OAAO,GAAG,CAAC,KAAa,EAAE,QAAgB,EAAU,EAAE,CAAC,GAAG,KAAK,OAAO,QAAQ,EAAE,CAAC;AAEvF;;;;;;;GAOG;AACH,MAAM,UAAU,YAAY,CAAC,EAC3B,OAAO,EACP,MAAM,EACN,KAAK,EACL,SAAS,EACT,YAAY,EACZ,QAAQ,EACR,OAAO,EACP,QAAQ,GAAG,KAAK,EAChB,SAAS,EACT,GAAG,KAAK,EACU;IAClB,MAAM,SAAS,GAAG,YAAY,EAAE,CAAC;IACjC,MAAM,QAAQ,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACvD,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAA+B,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC;IACrF,MAAM,QAAQ,GAAG,MAAM,CAAC,IAAI,GAAG,EAA6B,CAAC,CAAC;IAE9D,MAAM,SAAS,GAAG,CAAC,QAAgB,EAAE,QAAgB,EAAE,EAAE;QACvD,MAAM,GAAG,GAAG,QAAQ,CAAC,QAAQ,CAAC,CAAC;QAC/B,MAAM,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;QACjC,IAAI,GAAG,KAAK,SAAS,IAAI,MAAM,KAAK,SAAS;YAAE,OAAO;QACtD,QAAQ,CAAC,EAAE,GAAG,EAAE,QAAQ,EAAE,GAAG,EAAE,QAAQ,EAAE,CAAC,CAAC;QAC3C,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,EAAE,MAAM,CAAC,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC;IAC5D,CAAC,CAAC;IAEF,MAAM,aAAa,GAAG,CAAC,KAA0C,EAAE,EAAE;QACnE,IAAI,CAAC,CAAC,KAAK,CAAC,MAAM,YAAY,WAAW,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,aAAa,EAAE,CAAC;YAC7F,OAAO;QACT,CAAC;QACD,MAAM,OAAO,GAAG,SAAS,KAAK,KAAK,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,YAAY,CAAC;QACjE,MAAM,QAAQ,GAAG,SAAS,KAAK,KAAK,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,WAAW,CAAC;QAClE,MAAM,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,KAAK,CAAC;QAC3B,QAAQ,KAAK,CAAC,GAAG,EAAE,CAAC;YAClB,KAAK,OAAO;gBACV,SAAS,CAAC,GAAG,EAAE,GAAG,GAAG,CAAC,CAAC,CAAC;gBACxB,MAAM;YACR,KAAK,QAAQ;gBACX,SAAS,CAAC,GAAG,EAAE,GAAG,GAAG,CAAC,CAAC,CAAC;gBACxB,MAAM;YACR,KAAK,WAAW;gBACd,SAAS,CAAC,GAAG,GAAG,CAAC,EAAE,GAAG,CAAC,CAAC;gBACxB,MAAM;YACR,KAAK,SAAS;gBACZ,SAAS,CAAC,GAAG,GAAG,CAAC,EAAE,GAAG,CAAC,CAAC;gBACxB,MAAM;YACR,KAAK,MAAM;gBACT,SAAS,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;gBAClB,MAAM;YACR,KAAK,KAAK;gBACR,SAAS,CAAC,GAAG,EAAE,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;gBACnC,MAAM;YACR;gBACE,OAAO;QACX,CAAC;QACD,KAAK,CAAC,cAAc,EAAE,CAAC;IACzB,CAAC,CAAC;IAEF,oEAAoE;IACpE,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IACvE,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IAEtE,IAAI,YAAY,GAAG,CAAC,CAAC,CAAC;IAEtB,OAAO,CACL,eACE,IAAI,EAAC,MAAM,gBACC,KAAK,eACP,eAAe,EACzB,SAAS,EAAE,aAAa;QACxB,mEAAmE;QACnE,KAAK,EAAE,EAAE,mBAAmB,EAAE,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,EACtD,SAAS,EAAE,EAAE,CACX,2EAA2E,EAC3E,+FAA+F,EAC/F,SAAS,CACV,KACG,KAAK,aAET,eAAK,IAAI,EAAC,KAAK,EAAC,SAAS,EAAC,UAAU,aAClC,cACE,IAAI,EAAC,cAAc,EACnB,SAAS,EAAC,yHAAyH,YAElI,SAAS,GACN,EACL,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CACvB,eAEE,IAAI,EAAC,cAAc,eACT,sBAAsB,EAChC,SAAS,EAAC,yJAAyJ,aAElK,MAAM,CAAC,KAAK,EACZ,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CACf,KAAC,IAAI,mBAAa,MAAM,EAAC,SAAS,EAAC,gCAAgC,GAAG,CACvE,CAAC,CAAC,CAAC,IAAI,KARH,MAAM,CAAC,EAAE,CASV,CACP,CAAC,IACE,EAEL,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,UAAU,EAAE,EAAE,CAAC,CACjC,eAAoB,SAAS,EAAC,UAAU,aACrC,KAAK,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAClC,cAAK,IAAI,EAAC,KAAK,EAAC,SAAS,EAAC,UAAU,YAClC,cACE,IAAI,EAAC,UAAU,kBACD,OAAO,CAAC,MAAM,GAAG,CAAC,eACtB,oBAAoB,EAC9B,SAAS,EAAE,EAAE,CACX,gDAAgD,EAChD,UAAU,GAAG,CAAC,IAAI,wBAAwB,CAC3C,YAED,gBAAM,SAAS,EAAC,yFAAyF,aACtG,KAAK,CAAC,IAAI,EACX,KAAC,OAAO,cAAE,KAAK,CAAC,KAAK,GAAW,IAC3B,GACH,GACF,CACP,EACA,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE;wBACtB,YAAY,IAAI,CAAC,CAAC;wBAClB,MAAM,QAAQ,GAAG,YAAY,CAAC;wBAC9B,OAAO,CACL,eAAkB,IAAI,EAAC,KAAK,EAAC,SAAS,EAAC,UAAU,aAC/C,cACE,IAAI,EAAC,WAAW,EAChB,SAAS,EAAC,oHAAoH,YAE7H,GAAG,CAAC,KAAK,GACN,EACL,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,QAAQ,EAAE,EAAE;oCAChC,MAAM,KAAK,GAA0B,MAAM,CAAC,MAAM;wCAChD,CAAC,CAAC,QAAQ;wCACV,CAAC,CAAC,YAAY,CAAC,GAAG,CAAC,EAAE,EAAE,MAAM,CAAC,EAAE,CAAC,CAAC;oCACpC,MAAM,MAAM,GAAG,KAAK,KAAK,QAAQ,CAAC;oCAClC,MAAM,EAAE,GAAG,KAAK,KAAK,IAAI,CAAC;oCAC1B,MAAM,KAAK,GAAG,CAAC,MAAM,IAAI,OAAO,KAAK,SAAS,IAAI,OAAO,CAAC,GAAG,CAAC,EAAE,EAAE,MAAM,CAAC,EAAE,CAAC,CAAC;oCAC7E,MAAM,MAAM,GAAG,QAAQ,KAAK,QAAQ,IAAI,QAAQ,KAAK,QAAQ,CAAC;oCAC9D,OAAO,CACL,cAEE,IAAI,EAAC,UAAU,EACf,SAAS,EAAC,8DAA8D,YAExE,kBACE,IAAI,EAAC,QAAQ,eACH,aAAa,gBACX,KAAK,gBACL,KAAK,IAAI,SAAS,gBAClB,GAAG,GAAG,CAAC,KAAK,MAAM,MAAM,CAAC,KAAK,EAAE,kBAE9B,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,mBACjB,MAAM,IAAI,QAAQ,IAAI,SAAS,EAC9C,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EACzB,GAAG,EAAE,CAAC,OAAO,EAAE,EAAE;gDACf,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,EAAE,EAAE,MAAM,CAAC,EAAE,CAAC,CAAC;gDACvC,IAAI,OAAO,KAAK,IAAI;oDAAE,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;;oDAC9C,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;4CAC1C,CAAC,EACD,OAAO,EAAE,GAAG,EAAE,CAAC,QAAQ,CAAC,EAAE,GAAG,EAAE,QAAQ,EAAE,GAAG,EAAE,QAAQ,EAAE,CAAC,EACzD,OAAO,EAAE,GAAG,EAAE;gDACZ,IAAI,MAAM,IAAI,QAAQ;oDAAE,OAAO;gDAC/B,QAAQ,EAAE,CAAC,GAAG,CAAC,EAAE,EAAE,MAAM,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC;4CACrC,CAAC,EACD,SAAS,EAAE,EAAE,CACX,yIAAyI,EACzI,qFAAqF,EACrF,MAAM;gDACJ,CAAC,CAAC,2DAA2D;gDAC7D,CAAC,CAAC,EAAE;oDACF,CAAC,CAAC,+DAA+D;oDACjE,CAAC,CAAC,mDAAmD,EACzD,CAAC,MAAM,IAAI,QAAQ,IAAI,4CAA4C,CACpE,aAEA,MAAM,CAAC,CAAC,CAAC,CACR,KAAC,IAAI,mBAAa,MAAM,GAAG,CAC5B,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CACP,KAAC,KAAK,mBAAa,MAAM,GAAG,CAC7B,CAAC,CAAC,CAAC,CACF,KAAC,KAAK,mBAAa,MAAM,GAAG,CAC7B,EACA,KAAK,CAAC,CAAC,CAAC,CACP,4BACY,kBAAkB,iBAChB,MAAM,EAClB,SAAS,EAAC,0DAA0D,GACpE,CACH,CAAC,CAAC,CAAC,IAAI,IACD,IAjDJ,MAAM,CAAC,EAAE,CAkDV,CACP,CAAC;gCACJ,CAAC,CAAC,KArEM,GAAG,CAAC,EAAE,CAsEV,CACP,CAAC;oBACJ,CAAC,CAAC,KA/FM,KAAK,CAAC,EAAE,CAgGZ,CACP,CAAC,IACE,CACP,CAAC;AACJ,CAAC"}

package/dist/components/toggle-matrix/index.d.ts

@@ -0,0 +1,3 @@
+export { ToggleMatrix } from './ToggleMatrix.js';
+export type { ToggleMatrixCellState, ToggleMatrixColumn, ToggleMatrixGroup, ToggleMatrixProps, ToggleMatrixRow, } from './ToggleMatrix.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/components/toggle-matrix/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/toggle-matrix/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,YAAY,EACV,qBAAqB,EACrB,kBAAkB,EAClB,iBAAiB,EACjB,iBAAiB,EACjB,eAAe,GAChB,MAAM,mBAAmB,CAAC"}

package/dist/components/toggle-matrix/index.js

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

package/dist/components/toggle-matrix/index.js.map

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

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

@@ -0,0 +1,33 @@
+import * as TooltipPrimitive from '@radix-ui/react-tooltip';
+import type { ComponentPropsWithoutRef, ReactNode } from 'react';
+/**
+ * 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 declare const TooltipProvider: import("react").FC<TooltipPrimitive.TooltipProviderProps>;
+type ContentPassthrough = Pick<ComponentPropsWithoutRef<typeof TooltipPrimitive.Content>, 'side' | 'align' | 'sideOffset'>;
+export interface TooltipProps extends ContentPassthrough {
+    /** Tooltip text (dark surface: `--fg` bg + `--bg` text, 12px, radius 8). */
+    content: ReactNode;
+    /** The trigger element; rendered `asChild`, so it must accept a ref. */
+    children: ReactNode;
+    /** Hover open delay in ms (design default 300). */
+    delayDuration?: number | undefined;
+    /** Controlled open state. */
+    open?: boolean | undefined;
+    /** Uncontrolled initial open state. */
+    defaultOpen?: boolean | undefined;
+    onOpenChange?: ((open: boolean) => void) | undefined;
+    /** Extra classes for the tooltip bubble. */
+    className?: string | undefined;
+}
+/**
+ * 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 declare function Tooltip({ content, children, side, align, sideOffset, delayDuration, open, defaultOpen, onOpenChange, className, }: TooltipProps): import("react").JSX.Element;
+export {};
+//# sourceMappingURL=Tooltip.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Tooltip.d.ts","sourceRoot":"","sources":["../../../src/components/tooltip/Tooltip.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,gBAAgB,MAAM,yBAAyB,CAAC;AAC5D,OAAO,KAAK,EAAE,wBAAwB,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAIjE;;;;GAIG;AACH,eAAO,MAAM,eAAe,2DAA4B,CAAC;AAEzD,KAAK,kBAAkB,GAAG,IAAI,CAC5B,wBAAwB,CAAC,OAAO,gBAAgB,CAAC,OAAO,CAAC,EACzD,MAAM,GAAG,OAAO,GAAG,YAAY,CAChC,CAAC;AAEF,MAAM,WAAW,YAAa,SAAQ,kBAAkB;IACtD,4EAA4E;IAC5E,OAAO,EAAE,SAAS,CAAC;IACnB,wEAAwE;IACxE,QAAQ,EAAE,SAAS,CAAC;IACpB,mDAAmD;IACnD,aAAa,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACnC,6BAA6B;IAC7B,IAAI,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC3B,uCAAuC;IACvC,WAAW,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAClC,YAAY,CAAC,EAAE,CAAC,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAC,GAAG,SAAS,CAAC;IACrD,4CAA4C;IAC5C,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAChC;AAED;;;;;GAKG;AACH,wBAAgB,OAAO,CAAC,EACtB,OAAO,EACP,QAAQ,EACR,IAAY,EACZ,KAAgB,EAChB,UAAc,EACd,aAAmB,EACnB,IAAI,EACJ,WAAW,EACX,YAAY,EACZ,SAAS,GACV,EAAE,YAAY,+BA2Bd"}