@adminiumjs/ui 0.1.0-rc.1

package/dist/lib/tones.d.ts

@@ -0,0 +1,40 @@
+/**
+ * lib/tones.ts — the canonical home of the semantic tone vocabulary and the
+ * status→tone registry (workplan/03-component-library.md §3.3, §7.6).
+ *
+ * The SINGLE source of truth: components/icon-tile, components/badge and
+ * components/status-pill re-export from here (their wave-1 local copies are
+ * gone), so there is exactly one `Tone` union, one class map per recipe, and
+ * one status→tone registry instance. New code must import from this module.
+ */
+/** Semantic tone vocabulary shared across the library. */
+export type Tone = 'neutral' | 'accent' | 'pos' | 'warn' | 'danger' | 'info';
+/** Every tone, in canonical display order (stories, matrices). */
+export declare const TONES: readonly Tone[];
+/** Tone → soft background + strong tone foreground utility pairs. */
+export declare const toneSoftClasses: Record<Tone, string>;
+/** Tone → solid background + on-tone foreground utility pairs. */
+export declare const toneSolidClasses: Record<Tone, string>;
+/**
+ * Tone → `color-mix` border utilities used by Alert/Banner callouts
+ * (tone-soft bg + 30%-mixed tone border, research/design-system.md §3 Tier 3).
+ */
+export declare const toneMixBorderClasses: Record<Tone, string>;
+/**
+ * Sticky translucent bar recipe (workplan/03-component-library.md §7.5) —
+ * used by `Topbar`, `WizardLayout` footer and sticky table headers. Exported
+ * from here so the color-mix recipe lives in exactly one place.
+ */
+export declare const glassBar = "sticky top-0 z-40 border-b border-border bg-[color-mix(in_srgb,var(--surface)_82%,transparent)] backdrop-blur-[8px]";
+/**
+ * Default status→tone registry (workplan/03-component-library.md §7.6).
+ * Extended at runtime via `registerStatusTones` (widgets/manifests register
+ * domain statuses); tints always derive from the tone — never hardcoded per
+ * feature (the "Ticket Queue hardcoded priority tint" defect fix).
+ */
+export declare const DEFAULT_STATUS_TONES: Readonly<Record<string, Tone>>;
+/** Idempotent merge of domain statuses into the status→tone registry. */
+export declare function registerStatusTones(map: Record<string, Tone>): void;
+/** Resolve the semantic tone for a status key (case-insensitive). */
+export declare function statusTone(status: string, fallback?: Tone): Tone;
+//# sourceMappingURL=tones.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tones.d.ts","sourceRoot":"","sources":["../../src/lib/tones.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,0DAA0D;AAC1D,MAAM,MAAM,IAAI,GAAG,SAAS,GAAG,QAAQ,GAAG,KAAK,GAAG,MAAM,GAAG,QAAQ,GAAG,MAAM,CAAC;AAE7E,kEAAkE;AAClE,eAAO,MAAM,KAAK,EAAE,SAAS,IAAI,EAA2D,CAAC;AAE7F,qEAAqE;AACrE,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,IAAI,EAAE,MAAM,CAOhD,CAAC;AAEF,kEAAkE;AAClE,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,IAAI,EAAE,MAAM,CAOjD,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,oBAAoB,EAAE,MAAM,CAAC,IAAI,EAAE,MAAM,CAOrD,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,QAAQ,wHACkG,CAAC;AAExH;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,CAyB9D,CAAC;AAIH,yEAAyE;AACzE,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,GAAG,IAAI,CAInE;AAED,qEAAqE;AACrE,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,GAAE,IAAgB,GAAG,IAAI,CAE3E"}

package/dist/lib/tones.js

@@ -0,0 +1,91 @@
+/**
+ * lib/tones.ts — the canonical home of the semantic tone vocabulary and the
+ * status→tone registry (workplan/03-component-library.md §3.3, §7.6).
+ *
+ * The SINGLE source of truth: components/icon-tile, components/badge and
+ * components/status-pill re-export from here (their wave-1 local copies are
+ * gone), so there is exactly one `Tone` union, one class map per recipe, and
+ * one status→tone registry instance. New code must import from this module.
+ */
+/** Every tone, in canonical display order (stories, matrices). */
+export const TONES = ['neutral', 'accent', 'pos', 'warn', 'danger', 'info'];
+/** Tone → soft background + strong tone foreground utility pairs. */
+export const toneSoftClasses = {
+    neutral: 'bg-surface-3 text-fg-muted',
+    accent: 'bg-accent-soft text-accent',
+    pos: 'bg-pos-soft text-pos',
+    warn: 'bg-warn-soft text-warn',
+    danger: 'bg-danger-soft text-danger',
+    info: 'bg-info-soft text-info',
+};
+/** Tone → solid background + on-tone foreground utility pairs. */
+export const toneSolidClasses = {
+    neutral: 'bg-surface-3 text-fg',
+    accent: 'bg-accent text-accent-fg',
+    pos: 'bg-pos text-white',
+    warn: 'bg-warn text-white',
+    danger: 'bg-danger text-white',
+    info: 'bg-info text-white',
+};
+/**
+ * Tone → `color-mix` border utilities used by Alert/Banner callouts
+ * (tone-soft bg + 30%-mixed tone border, research/design-system.md §3 Tier 3).
+ */
+export const toneMixBorderClasses = {
+    neutral: 'border-border',
+    accent: 'border-[color-mix(in_srgb,var(--accent)_30%,transparent)]',
+    pos: 'border-[color-mix(in_srgb,var(--pos)_30%,transparent)]',
+    warn: 'border-[color-mix(in_srgb,var(--warn)_30%,transparent)]',
+    danger: 'border-[color-mix(in_srgb,var(--danger)_30%,transparent)]',
+    info: 'border-[color-mix(in_srgb,var(--info)_30%,transparent)]',
+};
+/**
+ * Sticky translucent bar recipe (workplan/03-component-library.md §7.5) —
+ * used by `Topbar`, `WizardLayout` footer and sticky table headers. Exported
+ * from here so the color-mix recipe lives in exactly one place.
+ */
+export const glassBar = 'sticky top-0 z-40 border-b border-border bg-[color-mix(in_srgb,var(--surface)_82%,transparent)] backdrop-blur-[8px]';
+/**
+ * Default status→tone registry (workplan/03-component-library.md §7.6).
+ * Extended at runtime via `registerStatusTones` (widgets/manifests register
+ * domain statuses); tints always derive from the tone — never hardcoded per
+ * feature (the "Ticket Queue hardcoded priority tint" defect fix).
+ */
+export const DEFAULT_STATUS_TONES = Object.freeze({
+    paid: 'pos',
+    active: 'pos',
+    connected: 'pos',
+    completed: 'pos',
+    published: 'pos',
+    healthy: 'pos',
+    pending: 'warn',
+    trialing: 'warn',
+    queued: 'warn',
+    degraded: 'warn',
+    past_due: 'warn',
+    failed: 'danger',
+    error: 'danger',
+    suspended: 'danger',
+    overdue: 'danger',
+    canceled: 'danger',
+    refunded: 'info',
+    running: 'info',
+    syncing: 'info',
+    scheduled: 'info',
+    draft: 'neutral',
+    archived: 'neutral',
+    inactive: 'neutral',
+    disabled: 'neutral',
+});
+const registry = new Map(Object.entries(DEFAULT_STATUS_TONES));
+/** Idempotent merge of domain statuses into the status→tone registry. */
+export function registerStatusTones(map) {
+    for (const [status, tone] of Object.entries(map)) {
+        registry.set(status.toLowerCase(), tone);
+    }
+}
+/** Resolve the semantic tone for a status key (case-insensitive). */
+export function statusTone(status, fallback = 'neutral') {
+    return registry.get(status.toLowerCase()) ?? fallback;
+}
+//# sourceMappingURL=tones.js.map

package/dist/lib/tones.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tones.js","sourceRoot":"","sources":["../../src/lib/tones.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAKH,kEAAkE;AAClE,MAAM,CAAC,MAAM,KAAK,GAAoB,CAAC,SAAS,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC;AAE7F,qEAAqE;AACrE,MAAM,CAAC,MAAM,eAAe,GAAyB;IACnD,OAAO,EAAE,4BAA4B;IACrC,MAAM,EAAE,4BAA4B;IACpC,GAAG,EAAE,sBAAsB;IAC3B,IAAI,EAAE,wBAAwB;IAC9B,MAAM,EAAE,4BAA4B;IACpC,IAAI,EAAE,wBAAwB;CAC/B,CAAC;AAEF,kEAAkE;AAClE,MAAM,CAAC,MAAM,gBAAgB,GAAyB;IACpD,OAAO,EAAE,sBAAsB;IAC/B,MAAM,EAAE,0BAA0B;IAClC,GAAG,EAAE,mBAAmB;IACxB,IAAI,EAAE,oBAAoB;IAC1B,MAAM,EAAE,sBAAsB;IAC9B,IAAI,EAAE,oBAAoB;CAC3B,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAyB;IACxD,OAAO,EAAE,eAAe;IACxB,MAAM,EAAE,2DAA2D;IACnE,GAAG,EAAE,wDAAwD;IAC7D,IAAI,EAAE,yDAAyD;IAC/D,MAAM,EAAE,2DAA2D;IACnE,IAAI,EAAE,yDAAyD;CAChE,CAAC;AAEF;;;;GAIG;AACH,MAAM,CAAC,MAAM,QAAQ,GACnB,qHAAqH,CAAC;AAExH;;;;;GAKG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAmC,MAAM,CAAC,MAAM,CAAC;IAChF,IAAI,EAAE,KAAK;IACX,MAAM,EAAE,KAAK;IACb,SAAS,EAAE,KAAK;IAChB,SAAS,EAAE,KAAK;IAChB,SAAS,EAAE,KAAK;IAChB,OAAO,EAAE,KAAK;IACd,OAAO,EAAE,MAAM;IACf,QAAQ,EAAE,MAAM;IAChB,MAAM,EAAE,MAAM;IACd,QAAQ,EAAE,MAAM;IAChB,QAAQ,EAAE,MAAM;IAChB,MAAM,EAAE,QAAQ;IAChB,KAAK,EAAE,QAAQ;IACf,SAAS,EAAE,QAAQ;IACnB,OAAO,EAAE,QAAQ;IACjB,QAAQ,EAAE,QAAQ;IAClB,QAAQ,EAAE,MAAM;IAChB,OAAO,EAAE,MAAM;IACf,OAAO,EAAE,MAAM;IACf,SAAS,EAAE,MAAM;IACjB,KAAK,EAAE,SAAS;IAChB,QAAQ,EAAE,SAAS;IACnB,QAAQ,EAAE,SAAS;IACnB,QAAQ,EAAE,SAAS;CACpB,CAAC,CAAC;AAEH,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAe,MAAM,CAAC,OAAO,CAAC,oBAAoB,CAAC,CAAC,CAAC;AAE7E,yEAAyE;AACzE,MAAM,UAAU,mBAAmB,CAAC,GAAyB;IAC3D,KAAK,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QACjD,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,WAAW,EAAE,EAAE,IAAI,CAAC,CAAC;IAC3C,CAAC;AACH,CAAC;AAED,qEAAqE;AACrE,MAAM,UAAU,UAAU,CAAC,MAAc,EAAE,WAAiB,SAAS;IACnE,OAAO,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC,IAAI,QAAQ,CAAC;AACxD,CAAC"}

package/dist/theme/ThemeProvider.d.ts

@@ -0,0 +1,15 @@
+import type { ReactNode } from 'react';
+import { type ThemePrefs } from './types.js';
+/** Called after each `setPref` with the axis, the new value, and the next full prefs. */
+export type ThemePrefChangeHandler = <K extends keyof ThemePrefs>(key: K, value: ThemePrefs[K], prefs: ThemePrefs) => void;
+export interface ThemeProviderProps {
+    /** Global super-admin defaults from `adminium_settings` (M8; absent pre-M8/pre-auth). */
+    globalDefaults?: Partial<ThemePrefs>;
+    /** Per-user overrides from `adminium_user_prefs` (M8; absent pre-auth). */
+    userPrefs?: Partial<ThemePrefs>;
+    /** Persistence hook for `setPref` (M8 wires `PATCH /api/v1/me/prefs` here). */
+    onPrefChange?: ThemePrefChangeHandler;
+    children: ReactNode;
+}
+export declare function ThemeProvider(props: ThemeProviderProps): ReactNode;
+//# sourceMappingURL=ThemeProvider.d.ts.map

package/dist/theme/ThemeProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ThemeProvider.d.ts","sourceRoot":"","sources":["../../src/theme/ThemeProvider.tsx"],"names":[],"mappings":"AAkCA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAmBvC,OAAO,EAOL,KAAK,UAAU,EAChB,MAAM,YAAY,CAAC;AAIpB,yFAAyF;AACzF,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,SAAS,MAAM,UAAU,EAC9D,GAAG,EAAE,CAAC,EACN,KAAK,EAAE,UAAU,CAAC,CAAC,CAAC,EACpB,KAAK,EAAE,UAAU,KACd,IAAI,CAAC;AAEV,MAAM,WAAW,kBAAkB;IACjC,yFAAyF;IACzF,cAAc,CAAC,EAAE,OAAO,CAAC,UAAU,CAAC,CAAC;IACrC,2EAA2E;IAC3E,SAAS,CAAC,EAAE,OAAO,CAAC,UAAU,CAAC,CAAC;IAChC,+EAA+E;IAC/E,YAAY,CAAC,EAAE,sBAAsB,CAAC;IACtC,QAAQ,EAAE,SAAS,CAAC;CACrB;AA2DD,wBAAgB,aAAa,CAAC,KAAK,EAAE,kBAAkB,GAAG,SAAS,CAkHlE"}

package/dist/theme/ThemeProvider.js

@@ -0,0 +1,186 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+/**
+ * ThemeProvider — runtime for the four theming axes (theme/accent/density/locale→dir),
+ * per workplan/02-design-system.md §4 and 03-component-library.md §3.6.
+ *
+ * Responsibilities:
+ * 1. Resolve effective prefs per-axis (§4.2): baseline ← localStorage pre-paint
+ *    cache ← `globalDefaults` (adminium_settings) ← `userPrefs`
+ *    (adminium_user_prefs) ← in-session `setPref` calls. localStorage is a
+ *    cache, not a preference source: it only fills axes the server props do
+ *    not supply (pre-auth surfaces), and server-resolved values always win.
+ *    The `setPref` layer (`sessionPrefs`) is optimistic and transient: an entry
+ *    is reconciled away once the server-resolved props catch up to it (same
+ *    value), and can be dropped explicitly via `clearSessionPref` when the
+ *    caller resets an axis server-side (M8 reset-to-default) — otherwise a
+ *    stale optimistic value would keep masking the refetched default until a
+ *    reload. Entries whose value still differs from the props are treated as
+ *    in flight and keep winning (§4 behavior 4).
+ * 2. Stamp `THEME_ATTRIBUTES` on `document.documentElement` (`data-theme` with
+ *    the RESOLVED light/dark, `data-accent`, `data-density`, `dir`, `lang`).
+ *    This is the only place theming attributes are set after pre-hydration.
+ * 3. Track `matchMedia('(prefers-color-scheme: dark)')` live while the
+ *    effective theme pref is `system`; detach when it becomes explicit.
+ * 4. Write the cache back to localStorage under `STORAGE_KEYS` on every
+ *    resolution change. The theme key stores the PREF (so `system` round-trips
+ *    and the pre-hydration script re-resolves it against the OS at next boot —
+ *    the script explicitly handles a cached "system"); `dir` stores the
+ *    derived value the script needs pre-React.
+ * 5. Notify `subscribeTheme` listeners after the DOM attributes are committed.
+ *
+ * Persistence to `adminium_user_prefs` (M8) is the caller's job via
+ * `onPrefChange`; the provider itself never talks to the server.
+ */
+import { DirectionProvider } from '@radix-ui/react-direction';
+import { useCallback, useEffect, useLayoutEffect, useMemo, useRef, useState } from 'react';
+import { ACCENTS, DENSITIES, STORAGE_KEYS, THEMES, THEME_ATTRIBUTES, } from '@adminium/tokens';
+import { ThemeContext, } from './context.js';
+import { emitTheme } from './subscribe.js';
+import { BASELINE_PREFS, LOCALES, dirForLocale, langForLocale, } from './types.js';
+const DARK_QUERY = '(prefers-color-scheme: dark)';
+/** Read the localStorage pre-paint cache, ignoring unknown/invalid values. */
+function readStorageCache() {
+    const cache = {};
+    if (typeof window === 'undefined')
+        return cache;
+    try {
+        const theme = window.localStorage.getItem(STORAGE_KEYS.theme);
+        if (theme !== null && THEMES.includes(theme)) {
+            cache.theme = theme;
+        }
+        const accent = window.localStorage.getItem(STORAGE_KEYS.accent);
+        if (accent !== null && accent in ACCENTS)
+            cache.accent = accent;
+        const density = window.localStorage.getItem(STORAGE_KEYS.density);
+        if (density !== null && DENSITIES.includes(density)) {
+            cache.density = density;
+        }
+        const locale = window.localStorage.getItem(STORAGE_KEYS.locale);
+        if (locale !== null && LOCALES.includes(locale)) {
+            cache.locale = locale;
+        }
+    }
+    catch {
+        // Private mode / storage disabled: baseline render.
+    }
+    return cache;
+}
+function systemPrefersDark() {
+    if (typeof window === 'undefined' || typeof window.matchMedia !== 'function')
+        return false;
+    return window.matchMedia(DARK_QUERY).matches;
+}
+/** Value-equality over the four axes (props identity churns when the parent
+ * re-derives `userPrefs`, so the reconcile trigger must compare by value). */
+function samePrefs(a, b) {
+    return a.theme === b.theme && a.accent === b.accent && a.density === b.density && a.locale === b.locale;
+}
+/**
+ * Drop optimistic session entries the freshly-resolved props now confirm (the
+ * axis resolves to the same value with or without the override). Those entries
+ * have served their purpose; keeping them would mask a *later* authoritative
+ * change to the axis. Entries whose value still differs are left untouched —
+ * they are in flight and must keep winning. Returns the same reference when
+ * nothing changed so the caller can skip a state update.
+ */
+function reconcileSessionPrefs(session, propsResolved) {
+    const confirmed = Object.keys(session).filter((key) => propsResolved[key] === session[key]);
+    if (confirmed.length === 0)
+        return session;
+    const next = { ...session };
+    for (const key of confirmed)
+        delete next[key];
+    return next;
+}
+export function ThemeProvider(props) {
+    const { globalDefaults, userPrefs, onPrefChange, children } = props;
+    // Read once per mount — the cache is a boot-time fallback, not a live source.
+    const [storageCache] = useState(readStorageCache);
+    // Axes changed via setPref during this session (optimistic layer, wins over props).
+    const [sessionPrefs, setSessionPrefs] = useState({});
+    const [prefersDark, setPrefersDark] = useState(systemPrefersDark);
+    // Everything resolvable from the server props (+ pre-paint cache), WITHOUT the
+    // optimistic session layer. `sessionPrefs` rides on top of this (§4.2).
+    const propsResolved = useMemo(() => ({
+        ...BASELINE_PREFS,
+        ...storageCache,
+        ...globalDefaults,
+        ...userPrefs,
+    }), [storageCache, globalDefaults, userPrefs]);
+    // When a fresh server resolution arrives (by value — the parent re-derives
+    // `userPrefs` into a new object each render), reconcile the optimistic layer:
+    // adjusting state during render (per the React docs' "storing information from
+    // previous renders" pattern) drops confirmed entries before commit, so it
+    // never re-stamps <html> or re-emits with an intermediate value.
+    const [prevPropsResolved, setPrevPropsResolved] = useState(propsResolved);
+    if (!samePrefs(propsResolved, prevPropsResolved)) {
+        setPrevPropsResolved(propsResolved);
+        setSessionPrefs((prev) => reconcileSessionPrefs(prev, propsResolved));
+    }
+    const prefs = useMemo(() => ({ ...propsResolved, ...sessionPrefs }), [propsResolved, sessionPrefs]);
+    // Live system-theme tracking, attached only while the pref is `system` (§4 behavior 2).
+    useEffect(() => {
+        if (prefs.theme !== 'system')
+            return;
+        if (typeof window === 'undefined' || typeof window.matchMedia !== 'function')
+            return;
+        const mql = window.matchMedia(DARK_QUERY);
+        setPrefersDark(mql.matches);
+        const onChange = (event) => {
+            setPrefersDark(event.matches);
+        };
+        mql.addEventListener('change', onChange);
+        return () => {
+            mql.removeEventListener('change', onChange);
+        };
+    }, [prefs.theme]);
+    const resolved = useMemo(() => ({
+        theme: prefs.theme === 'system' ? (prefersDark ? 'dark' : 'light') : prefs.theme,
+        accent: prefs.accent,
+        density: prefs.density,
+        locale: prefs.locale,
+        dir: dirForLocale(prefs.locale),
+    }), [prefs, prefersDark]);
+    // Stamp <html>, write the cache back, then notify listeners (§4 behaviors 1/3/5).
+    useLayoutEffect(() => {
+        const el = document.documentElement;
+        el.setAttribute(THEME_ATTRIBUTES.theme, resolved.theme);
+        el.setAttribute(THEME_ATTRIBUTES.accent, resolved.accent);
+        el.setAttribute(THEME_ATTRIBUTES.density, resolved.density);
+        el.setAttribute(THEME_ATTRIBUTES.dir, resolved.dir);
+        el.setAttribute(THEME_ATTRIBUTES.lang, langForLocale(resolved.locale));
+        try {
+            window.localStorage.setItem(STORAGE_KEYS.theme, prefs.theme);
+            window.localStorage.setItem(STORAGE_KEYS.accent, resolved.accent);
+            window.localStorage.setItem(STORAGE_KEYS.density, resolved.density);
+            window.localStorage.setItem(STORAGE_KEYS.locale, resolved.locale);
+            window.localStorage.setItem(STORAGE_KEYS.dir, resolved.dir);
+        }
+        catch {
+            // Private mode / storage disabled: skip the pre-paint cache.
+        }
+        emitTheme(resolved);
+    }, [resolved, prefs.theme]);
+    const prefsRef = useRef(prefs);
+    prefsRef.current = prefs;
+    const onPrefChangeRef = useRef(onPrefChange);
+    onPrefChangeRef.current = onPrefChange;
+    const setPref = useCallback((key, value) => {
+        setSessionPrefs((prev) => ({ ...prev, [key]: value }));
+        onPrefChangeRef.current?.(key, value, { ...prefsRef.current, [key]: value });
+    }, []);
+    // Drop the optimistic entry so resolution falls back to the props (the caller
+    // owns the server-side clear). Not a `setPref`, so no `onPrefChange` fires.
+    const clearSessionPref = useCallback((key) => {
+        setSessionPrefs((prev) => {
+            if (!(key in prev))
+                return prev;
+            const next = { ...prev };
+            delete next[key];
+            return next;
+        });
+    }, []);
+    const contextValue = useMemo(() => ({ prefs, resolved, setPref, clearSessionPref }), [prefs, resolved, setPref, clearSessionPref]);
+    return (_jsx(ThemeContext.Provider, { value: contextValue, children: _jsx(DirectionProvider, { dir: resolved.dir, children: children }) }));
+}
+//# sourceMappingURL=ThemeProvider.js.map

package/dist/theme/ThemeProvider.js.map

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

package/dist/theme/context.d.ts

@@ -0,0 +1,21 @@
+import type { ResolvedTheme, ThemePrefs } from './types.js';
+/** `setPref` updates one axis optimistically (02-design-system.md §4 behavior 4). */
+export type SetThemePref = <K extends keyof ThemePrefs>(key: K, value: ThemePrefs[K]) => void;
+/**
+ * Drop the optimistic session override for one axis so the resolved value falls
+ * back through to the server-resolved props (§4.2). The Preferences page calls
+ * this on "Reset to workspace default" — clearing an axis server-side does not
+ * change the in-session `setPref` layer, which would otherwise keep masking the
+ * refetched default until a reload.
+ */
+export type ClearSessionPref = (key: keyof ThemePrefs) => void;
+export interface ThemeContextValue {
+    /** Effective preferences after the resolution order (§4.2); `theme` may be `system`. */
+    prefs: ThemePrefs;
+    /** Resolved values as stamped on `<html>`. */
+    resolved: ResolvedTheme;
+    setPref: SetThemePref;
+    clearSessionPref: ClearSessionPref;
+}
+export declare const ThemeContext: import("react").Context<ThemeContextValue | null>;
+//# sourceMappingURL=context.d.ts.map

package/dist/theme/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/theme/context.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE5D,qFAAqF;AACrF,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,SAAS,MAAM,UAAU,EAAE,GAAG,EAAE,CAAC,EAAE,KAAK,EAAE,UAAU,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC;AAE9F;;;;;;GAMG;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,GAAG,EAAE,MAAM,UAAU,KAAK,IAAI,CAAC;AAE/D,MAAM,WAAW,iBAAiB;IAChC,wFAAwF;IACxF,KAAK,EAAE,UAAU,CAAC;IAClB,8CAA8C;IAC9C,QAAQ,EAAE,aAAa,CAAC;IACxB,OAAO,EAAE,YAAY,CAAC;IACtB,gBAAgB,EAAE,gBAAgB,CAAC;CACpC;AAED,eAAO,MAAM,YAAY,mDAAgD,CAAC"}

package/dist/theme/context.js

@@ -0,0 +1,7 @@
+/**
+ * React context shared by ThemeProvider and the useTheme/useThemePrefs hooks.
+ * Internal module — consumers use the hooks, never the raw context.
+ */
+import { createContext } from 'react';
+export const ThemeContext = createContext(null);
+//# sourceMappingURL=context.js.map

package/dist/theme/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../src/theme/context.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAyBtC,MAAM,CAAC,MAAM,YAAY,GAAG,aAAa,CAA2B,IAAI,CAAC,CAAC"}

package/dist/theme/index.d.ts

@@ -0,0 +1,9 @@
+export { ThemeProvider } from './ThemeProvider.js';
+export type { ThemeProviderProps, ThemePrefChangeHandler } from './ThemeProvider.js';
+export { useTheme, useThemePrefs } from './useTheme.js';
+export { subscribeTheme } from './subscribe.js';
+export type { ThemeListener } from './subscribe.js';
+export type { SetThemePref } from './context.js';
+export { BASELINE_PREFS, LOCALES, dirForLocale, langForLocale } from './types.js';
+export type { Locale, ResolvedTheme, ThemePrefs } from './types.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/theme/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,YAAY,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AACrF,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AACxD,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAChD,YAAY,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AACpD,YAAY,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,EAAE,cAAc,EAAE,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAClF,YAAY,EAAE,MAAM,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC"}

package/dist/theme/index.js

@@ -0,0 +1,5 @@
+export { ThemeProvider } from './ThemeProvider.js';
+export { useTheme, useThemePrefs } from './useTheme.js';
+export { subscribeTheme } from './subscribe.js';
+export { BASELINE_PREFS, LOCALES, dirForLocale, langForLocale } from './types.js';
+//# sourceMappingURL=index.js.map

package/dist/theme/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/theme/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAEnD,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AACxD,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAGhD,OAAO,EAAE,cAAc,EAAE,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC"}

package/dist/theme/subscribe.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Non-React theme subscription (workplan/02-design-system.md §4.1) — for
+ * Leaflet tile swaps, chart re-tints, Electron `nativeTheme` mirroring.
+ * ThemeProvider emits AFTER the DOM attributes are committed (§4 behavior 5).
+ */
+import type { ResolvedTheme } from './types.js';
+export type ThemeListener = (theme: ResolvedTheme) => void;
+/** Subscribe to resolved-theme changes; returns an unsubscribe function. */
+export declare function subscribeTheme(listener: ThemeListener): () => void;
+/** @internal Called by ThemeProvider after stamping `<html>`. Not part of the public API. */
+export declare function emitTheme(theme: ResolvedTheme): void;
+//# sourceMappingURL=subscribe.d.ts.map

package/dist/theme/subscribe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subscribe.d.ts","sourceRoot":"","sources":["../../src/theme/subscribe.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD,MAAM,MAAM,aAAa,GAAG,CAAC,KAAK,EAAE,aAAa,KAAK,IAAI,CAAC;AAI3D,4EAA4E;AAC5E,wBAAgB,cAAc,CAAC,QAAQ,EAAE,aAAa,GAAG,MAAM,IAAI,CAKlE;AAED,6FAA6F;AAC7F,wBAAgB,SAAS,CAAC,KAAK,EAAE,aAAa,GAAG,IAAI,CAEpD"}

package/dist/theme/subscribe.js

@@ -0,0 +1,14 @@
+const listeners = new Set();
+/** Subscribe to resolved-theme changes; returns an unsubscribe function. */
+export function subscribeTheme(listener) {
+    listeners.add(listener);
+    return () => {
+        listeners.delete(listener);
+    };
+}
+/** @internal Called by ThemeProvider after stamping `<html>`. Not part of the public API. */
+export function emitTheme(theme) {
+    for (const listener of [...listeners])
+        listener(theme);
+}
+//# sourceMappingURL=subscribe.js.map

package/dist/theme/subscribe.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"subscribe.js","sourceRoot":"","sources":["../../src/theme/subscribe.ts"],"names":[],"mappings":"AASA,MAAM,SAAS,GAAG,IAAI,GAAG,EAAiB,CAAC;AAE3C,4EAA4E;AAC5E,MAAM,UAAU,cAAc,CAAC,QAAuB;IACpD,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IACxB,OAAO,GAAG,EAAE;QACV,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IAC7B,CAAC,CAAC;AACJ,CAAC;AAED,6FAA6F;AAC7F,MAAM,UAAU,SAAS,CAAC,KAAoB;IAC5C,KAAK,MAAM,QAAQ,IAAI,CAAC,GAAG,SAAS,CAAC;QAAE,QAAQ,CAAC,KAAK,CAAC,CAAC;AACzD,CAAC"}

package/dist/theme/types.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Theming axis types for ThemeProvider (workplan/02-design-system.md §4.1).
+ * Axis value unions come from `@adminium/tokens` so the DOM attributes,
+ * Storybook toolbar and provider can never drift apart; the locale union and
+ * the pref/resolved shapes live here because they are UI-runtime concerns.
+ */
+import type { Accent, Density, Dir, ResolvedTheme as ResolvedThemeMode, ThemePref } from '@adminium/tokens';
+/** The 8 BRIEF locales (02-design-system.md §4.1). */
+export declare const LOCALES: readonly ["en_US", "de_DE", "ar_EG", "zh_CN", "zh_TW", "cs_CZ", "da_DK", "fr_FR"];
+export type Locale = (typeof LOCALES)[number];
+/** User-facing preferences: `theme` may be `system`; `dir` is derived, not a pref. */
+export interface ThemePrefs {
+    theme: ThemePref;
+    accent: Accent;
+    density: Density;
+    locale: Locale;
+}
+/** Fully resolved theme as stamped on `<html>`: `system` resolved, `dir` derived. */
+export interface ResolvedTheme {
+    theme: ResolvedThemeMode;
+    accent: Accent;
+    density: Density;
+    locale: Locale;
+    dir: Dir;
+}
+/** Baseline of the resolution order (BRIEF §7 via `@adminium/tokens`). */
+export declare const BASELINE_PREFS: ThemePrefs;
+/** `rtl` iff the locale is `ar_EG` (02-design-system.md §4.1). */
+export declare function dirForLocale(locale: Locale): Dir;
+/** BCP-47 form of a locale for the `lang` attribute (`ar_EG` → `ar-EG`). */
+export declare function langForLocale(locale: Locale): string;
+//# sourceMappingURL=types.d.ts.map

package/dist/theme/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/theme/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EACV,MAAM,EACN,OAAO,EACP,GAAG,EACH,aAAa,IAAI,iBAAiB,EAClC,SAAS,EACV,MAAM,kBAAkB,CAAC;AAG1B,sDAAsD;AACtD,eAAO,MAAM,OAAO,mFASV,CAAC;AACX,MAAM,MAAM,MAAM,GAAG,CAAC,OAAO,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC;AAE9C,sFAAsF;AACtF,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,SAAS,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,qFAAqF;AACrF,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,iBAAiB,CAAC;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,GAAG,CAAC;CACV;AAED,0EAA0E;AAC1E,eAAO,MAAM,cAAc,EAAE,UAAiC,CAAC;AAE/D,kEAAkE;AAClE,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,GAAG,CAEhD;AAED,4EAA4E;AAC5E,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAEpD"}

package/dist/theme/types.js

@@ -0,0 +1,23 @@
+import { DEFAULT_PREFS } from '@adminium/tokens';
+/** The 8 BRIEF locales (02-design-system.md §4.1). */
+export const LOCALES = [
+    'en_US',
+    'de_DE',
+    'ar_EG',
+    'zh_CN',
+    'zh_TW',
+    'cs_CZ',
+    'da_DK',
+    'fr_FR',
+];
+/** Baseline of the resolution order (BRIEF §7 via `@adminium/tokens`). */
+export const BASELINE_PREFS = { ...DEFAULT_PREFS };
+/** `rtl` iff the locale is `ar_EG` (02-design-system.md §4.1). */
+export function dirForLocale(locale) {
+    return locale === 'ar_EG' ? 'rtl' : 'ltr';
+}
+/** BCP-47 form of a locale for the `lang` attribute (`ar_EG` → `ar-EG`). */
+export function langForLocale(locale) {
+    return locale.replace('_', '-');
+}
+//# sourceMappingURL=types.js.map

package/dist/theme/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/theme/types.ts"],"names":[],"mappings":"AAaA,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEjD,sDAAsD;AACtD,MAAM,CAAC,MAAM,OAAO,GAAG;IACrB,OAAO;IACP,OAAO;IACP,OAAO;IACP,OAAO;IACP,OAAO;IACP,OAAO;IACP,OAAO;IACP,OAAO;CACC,CAAC;AAoBX,0EAA0E;AAC1E,MAAM,CAAC,MAAM,cAAc,GAAe,EAAE,GAAG,aAAa,EAAE,CAAC;AAE/D,kEAAkE;AAClE,MAAM,UAAU,YAAY,CAAC,MAAc;IACzC,OAAO,MAAM,KAAK,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC;AAC5C,CAAC;AAED,4EAA4E;AAC5E,MAAM,UAAU,aAAa,CAAC,MAAc;IAC1C,OAAO,MAAM,CAAC,OAAO,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;AAClC,CAAC"}

package/dist/theme/useTheme.d.ts

@@ -0,0 +1,14 @@
+import { type ClearSessionPref, type SetThemePref } from './context.js';
+import type { ResolvedTheme, ThemePrefs } from './types.js';
+/** The resolved theme as stamped on `<html>` (`system` already resolved, `dir` derived). */
+export declare function useTheme(): ResolvedTheme;
+/**
+ * The effective preferences (theme may be `system`), the optimistic setter, and
+ * `clearSessionPref` for dropping a session override on reset-to-default.
+ */
+export declare function useThemePrefs(): {
+    prefs: ThemePrefs;
+    setPref: SetThemePref;
+    clearSessionPref: ClearSessionPref;
+};
+//# sourceMappingURL=useTheme.d.ts.map

package/dist/theme/useTheme.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useTheme.d.ts","sourceRoot":"","sources":["../../src/theme/useTheme.ts"],"names":[],"mappings":"AAOA,OAAO,EAAgB,KAAK,gBAAgB,EAAE,KAAK,YAAY,EAAE,MAAM,cAAc,CAAC;AACtF,OAAO,KAAK,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAU5D,4FAA4F;AAC5F,wBAAgB,QAAQ,IAAI,aAAa,CAExC;AAED;;;GAGG;AACH,wBAAgB,aAAa,IAAI;IAC/B,KAAK,EAAE,UAAU,CAAC;IAClB,OAAO,EAAE,YAAY,CAAC;IACtB,gBAAgB,EAAE,gBAAgB,CAAC;CACpC,CAGA"}

package/dist/theme/useTheme.js

@@ -0,0 +1,27 @@
+/**
+ * Theme hooks (workplan/02-design-system.md §4.1).
+ * `useTheme` → resolved values for rendering; `useThemePrefs` → raw prefs +
+ * `setPref` for the appearance settings UI.
+ */
+import { useContext } from 'react';
+import { ThemeContext } from './context.js';
+function useRequiredThemeContext(hook) {
+    const context = useContext(ThemeContext);
+    if (context === null) {
+        throw new Error(`${hook} must be used inside <ThemeProvider>`);
+    }
+    return context;
+}
+/** The resolved theme as stamped on `<html>` (`system` already resolved, `dir` derived). */
+export function useTheme() {
+    return useRequiredThemeContext('useTheme()').resolved;
+}
+/**
+ * The effective preferences (theme may be `system`), the optimistic setter, and
+ * `clearSessionPref` for dropping a session override on reset-to-default.
+ */
+export function useThemePrefs() {
+    const { prefs, setPref, clearSessionPref } = useRequiredThemeContext('useThemePrefs()');
+    return { prefs, setPref, clearSessionPref };
+}
+//# sourceMappingURL=useTheme.js.map

package/dist/theme/useTheme.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useTheme.js","sourceRoot":"","sources":["../../src/theme/useTheme.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,UAAU,EAAE,MAAM,OAAO,CAAC;AAEnC,OAAO,EAAE,YAAY,EAA4C,MAAM,cAAc,CAAC;AAGtF,SAAS,uBAAuB,CAAC,IAAY;IAC3C,MAAM,OAAO,GAAG,UAAU,CAAC,YAAY,CAAC,CAAC;IACzC,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;QACrB,MAAM,IAAI,KAAK,CAAC,GAAG,IAAI,sCAAsC,CAAC,CAAC;IACjE,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,4FAA4F;AAC5F,MAAM,UAAU,QAAQ;IACtB,OAAO,uBAAuB,CAAC,YAAY,CAAC,CAAC,QAAQ,CAAC;AACxD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,aAAa;IAK3B,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,gBAAgB,EAAE,GAAG,uBAAuB,CAAC,iBAAiB,CAAC,CAAC;IACxF,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,gBAAgB,EAAE,CAAC;AAC9C,CAAC"}

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "@adminiumjs/ui",
+  "version": "0.1.0-rc.1",
+  "license": "AGPL-3.0-only",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/MoSofi/Adminium.git",
+    "directory": "packages/ui"
+  },
+  "homepage": "https://adminium.dev",
+  "bugs": "https://github.com/MoSofi/Adminium/issues",
+  "type": "module",
+  "description": "Component library (Tiers 1-3), Radix-based, CVA variants, ThemeProvider",
+  "sideEffects": [
+    "**/*.css"
+  ],
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "dependencies": {
+    "@adminium/tokens": "npm:@adminiumjs/tokens@0.1.0-rc.1",
+    "@radix-ui/react-checkbox": "^1.3.3",
+    "@radix-ui/react-dialog": "^1.1.15",
+    "@radix-ui/react-direction": "^1.1.1",
+    "@radix-ui/react-dropdown-menu": "^2.1.16",
+    "@radix-ui/react-popover": "^1.1.15",
+    "@radix-ui/react-radio-group": "^1.3.8",
+    "@radix-ui/react-slider": "^1.3.6",
+    "@radix-ui/react-slot": "^1.2.3",
+    "@radix-ui/react-switch": "^1.2.6",
+    "@radix-ui/react-tabs": "^1.1.13",
+    "@radix-ui/react-tooltip": "^1.2.8",
+    "class-variance-authority": "^0.7.1",
+    "clsx": "^2.1.1",
+    "lucide-react": "^0.525.0",
+    "react": "^19.1.0",
+    "react-dom": "^19.1.0",
+    "tailwind-merge": "^3.3.1"
+  },
+  "files": [
+    "dist"
+  ]
+}