pixelize-design-library 2.4.1 → 2.4.2-beta.1

package/dist/esm/Theme/provider/PixelizeThemeProvider.js

@@ -0,0 +1,209 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { createContext, useCallback, useEffect, useLayoutEffect, useMemo, useRef, useState, } from "react";
+import { ChakraProvider, extendTheme } from "@chakra-ui/react";
+import { brandThemes } from "../index.js";
+import ToasterProvider from "../../Components/Toaster/Toaster.js";
+import { getSystemColorMode, readStoredTheme, subscribeToSystemColorMode, writeStoredTheme, } from "./colorModeStorage.js";
+const DEFAULT_BRAND = "lavender";
+const DEFAULT_MODE = "system";
+const DEFAULT_STORAGE_KEY = "pixelize-theme";
+/**
+ * Chakra's default `colorModeManager` reads/writes its OWN `localStorage["chakra-ui-color-mode"]`
+ * key — entirely separate from this app's `storageKey` above — and that stored value wins over
+ * `theme.config.initialColorMode` on every load. `createBrandTheme` sets `initialColorMode: "light"`
+ * on every theme object specifically so Chakra's native dark mode (and every un-migrated built-in
+ * `_dark:` block — Card's "elevated" variant reaches for `gray.700`, which our reversed dark ramp
+ * makes LIGHT) never fires. But a stale `"dark"` value in that key — from Chakra's own toggle ever
+ * having been used on this origin, by this app or a prior version of it — silently overrides that
+ * default and reintroduces exactly the bug `initialColorMode: "light"` was meant to prevent: a
+ * washed-out light Card on an otherwise-correct dark canvas, while everything reading the palette
+ * directly (i.e. everything else) stays right. Forcing this manager to always report `"light"` and
+ * never persist removes Chakra's native color mode from the equation entirely, so no stray
+ * `_dark:` block anywhere (present or future) can ever fire, regardless of what's in storage.
+ */
+const forcedLightColorModeManager = {
+    type: "localStorage",
+    ssr: false,
+    get: () => "light",
+    set: () => { },
+};
+export const ThemeModeContext = createContext(undefined);
+/**
+ * Chakra's own color mode is deliberately NOT synced to `resolvedMode`, and must not be.
+ *
+ * This provider adapts for dark by swapping the palette, so `theme.colors` is already correct for
+ * the active mode. Putting Chakra into dark mode on top of that adapts a second time: its built-in
+ * `_dark` blocks reach for `gray.700`/`gray.800` expecting those rungs to be dark, but our dark
+ * ramp runs dark -> light, so they resolve LIGHT — a white Card/Skeleton/Menu on a dark canvas.
+ * A previous revision synced it to keep `useColorModeValue()` working and shipped exactly that.
+ *
+ * Consequence for consumers: `useColorModeValue(light, dark)` always returns its LIGHT argument.
+ * That is correct here — the palette has already resolved the mode, so the "light" argument is
+ * whatever the active palette says. Read the mode from `useThemeMode()` instead. Existing apps are
+ * unaffected: they are light-only, where that argument was always the one returned anyway.
+ */
+export const PixelizeThemeProvider = ({ children, brand: brandProp = DEFAULT_BRAND, onBrandChange, defaultMode = DEFAULT_MODE, onModeChange, storageKey = DEFAULT_STORAGE_KEY, disablePersistence = false, themeOverrides, }) => {
+    // Seed from storage during the first render: StrictMode re-runs the persist effect, and a
+    // ref guard cannot stop that second pass writing defaults over the stored value.
+    const [mode, setModeState] = useState(() => { var _a; return (_a = (disablePersistence ? undefined : readStoredTheme(storageKey).mode)) !== null && _a !== void 0 ? _a : defaultMode; });
+    const [brand, setBrandState] = useState(() => { var _a; return (_a = (disablePersistence ? undefined : readStoredTheme(storageKey).brand)) !== null && _a !== void 0 ? _a : brandProp; });
+    // Read synchronously: seeding "light" made every `system` user on a dark OS paint a light
+    // frame before the effect corrected it. SSR-safe — returns "light" with no window.
+    const [systemMode, setSystemMode] = useState(getSystemColorMode);
+    useEffect(() => {
+        setSystemMode(getSystemColorMode());
+        return subscribeToSystemColorMode(setSystemMode);
+    }, []);
+    useEffect(() => {
+        if (disablePersistence)
+            return;
+        const stored = readStoredTheme(storageKey);
+        if (stored.mode)
+            setModeState(stored.mode);
+        if (stored.brand)
+            setBrandState(stored.brand);
+    }, [disablePersistence, storageKey]);
+    // `brandProp` only seeds initial state above, so a consumer that re-renders with a new
+    // `brand` prop after mount (e.g. persisting the pick through its own store, like tickets'
+    // Settings page dispatching Redux instead of calling `setBrand`) would otherwise never see
+    // it applied. Sync it here instead so every consumer gets it for free.
+    // Compare the previous prop, never a "first run" flag: StrictMode double-invokes effects while
+    // refs survive, so a flag guard lets pass 2 reset state to the prop and clobber stored values.
+    const prevBrandProp = useRef(brandProp);
+    useEffect(() => {
+        if (prevBrandProp.current === brandProp)
+            return;
+        prevBrandProp.current = brandProp;
+        setBrandState(brandProp);
+    }, [brandProp]);
+    // Same prop-sync for the mode, so an app owning it in its own store no longer needs the
+    // `mode` -> store mirror effect that deadlocks against this one.
+    const prevModeProp = useRef(defaultMode);
+    useEffect(() => {
+        if (prevModeProp.current === defaultMode)
+            return;
+        prevModeProp.current = defaultMode;
+        setModeState(defaultMode);
+    }, [defaultMode]);
+    // Skipping the mount run keeps the defaults from being written over a stored value before
+    // the rehydrate effect above has applied it.
+    const isFirstPersistRun = useRef(true);
+    useEffect(() => {
+        if (isFirstPersistRun.current) {
+            isFirstPersistRun.current = false;
+            return;
+        }
+        if (disablePersistence)
+            return;
+        writeStoredTheme(storageKey, { mode, brand });
+    }, [mode, brand, disablePersistence, storageKey]);
+    const resolvedMode = mode === "system" ? systemMode : mode;
+    /**
+     * Native browser UI (the `<select>` dropdown popup chrome, the `<input type="date">` calendar
+     * picker) is painted by the browser's own UA stylesheet keyed off the CSS `color-scheme`
+     * property, entirely separate from Chakra/React theming — no component style or palette swap
+     * above can reach it. Without this, that chrome always renders light, even on an otherwise dark
+     * page. Scoped to this provider (not a global stylesheet) so `withTheme` consumers — deliberately
+     * light-only, see the module doc's "Key rules" — are untouched.
+     */
+    useLayoutEffect(() => {
+        document.documentElement.style.colorScheme = resolvedMode;
+    }, [resolvedMode]);
+    // Chakra's ColorModeProvider re-writes color-scheme in a passive effect, after the layout
+    // effect above, and forcedLightColorModeManager pins it to "light". Re-assert after it.
+    useEffect(() => {
+        document.documentElement.style.colorScheme = resolvedMode;
+    }, [resolvedMode]);
+    // Held in refs so a caller's inline arrow never re-creates `setMode`/`setBrand`, which would
+    // invalidate the context value on every render of the consuming app. Written in a layout
+    // effect, not during render — a render-phase write is unsafe under StrictMode's double
+    // invocation, and this still lands before any click handler can fire.
+    const onModeChangeRef = useRef(onModeChange);
+    const onBrandChangeRef = useRef(onBrandChange);
+    useLayoutEffect(() => {
+        onModeChangeRef.current = onModeChange;
+        onBrandChangeRef.current = onBrandChange;
+    }, [onModeChange, onBrandChange]);
+    const setMode = useCallback((next) => {
+        var _a;
+        setModeState(next);
+        (_a = onModeChangeRef.current) === null || _a === void 0 ? void 0 : _a.call(onModeChangeRef, next);
+    }, []);
+    const setBrand = useCallback((next) => {
+        var _a;
+        setBrandState(next);
+        (_a = onBrandChangeRef.current) === null || _a === void 0 ? void 0 : _a.call(onBrandChangeRef, next);
+    }, []);
+    // From "system", flip to the opposite of what the OS currently gives, so a click always
+    // visibly changes the UI.
+    const toggle = useCallback(() => setMode(resolvedMode === "dark" ? "light" : "dark"), [resolvedMode, setMode]);
+    const value = useMemo(() => ({ mode, resolvedMode, setMode, toggle, brand, setBrand }), [mode, resolvedMode, setMode, toggle, brand, setBrand]);
+    // `themeOverrides` is caller-supplied, and the idiomatic way to pass it is an inline object
+    // literal — a new identity every render. Keying the memo on identity would re-run `extendTheme`
+    // and hand `ChakraProvider` a new theme on every render of the consuming app, invalidating
+    // emotion's style resolution for everything beneath it. Compare by value instead.
+    const overridesKey = themeOverrides ? JSON.stringify(themeOverrides) : "";
+    const resolvedTheme = useMemo(() => {
+        const base = brandThemes[brand][resolvedMode];
+        return themeOverrides ? extendTheme(base, themeOverrides) : base;
+        // Keyed on the serialized overrides, not their identity. `brand`/`resolvedMode` must stay:
+        // overrides re-layer onto the CURRENT palette (see the prop's doc comment above).
+        // eslint-disable-next-line react-hooks/exhaustive-deps
+    }, [brand, resolvedMode, overridesKey]);
+    /**
+     * The library ships its `var(--color-*)` tokens light-only on `:root` (global.css), so any
+     * consumer that styles with those CSS vars rather than Chakra tokens stays light in dark mode —
+     * invisible text on the dark canvas, white panels. In dark, re-point every used var at the
+     * already-dark-correct resolved palette; in light, clear them so the static `:root` values apply
+     * unchanged (so a light-only app is byte-identical to before). Also mirror the mode to
+     * `data-mode` for consumers that want to hook their own dark CSS.
+     */
+    useLayoutEffect(() => {
+        var _a, _b, _c, _d, _e, _f, _g;
+        const root = document.documentElement;
+        root.dataset.mode = resolvedMode;
+        const colors = resolvedTheme.colors;
+        const sem = (_a = colors.semantic) !== null && _a !== void 0 ? _a : {};
+        const gray = colors.gray;
+        const HUE_SCALES = [
+            "primary", "gray", "red", "orange", "yellow",
+            "green", "teal", "blue", "cyan", "purple", "pink",
+        ];
+        const SEMANTIC_SCALES = ["success", "error", "warning", "info"]; // nested under colors.semantic
+        const RUNGS = [50, 100, 200, 300, 400, 500, 600, 700, 800, 900];
+        // Single-value semantic vars → palette scale+rung. The dark gray ramp runs dark(50) → light(900),
+        // so low rungs read as surfaces and high rungs as text — correct in dark, cleared in light.
+        const SEMANTIC_VARS = {
+            "text-heading": gray === null || gray === void 0 ? void 0 : gray[900], "text-body": gray === null || gray === void 0 ? void 0 : gray[700],
+            "text-subtle": gray === null || gray === void 0 ? void 0 : gray[500], "text-input": gray === null || gray === void 0 ? void 0 : gray[500],
+            "bg-main": gray === null || gray === void 0 ? void 0 : gray[50], "bg-secondary": gray === null || gray === void 0 ? void 0 : gray[100], "bg-tertiary": gray === null || gray === void 0 ? void 0 : gray[100],
+            "bg-quaternary": gray === null || gray === void 0 ? void 0 : gray[200], "bg-light": gray === null || gray === void 0 ? void 0 : gray[50], "bg-medium": gray === null || gray === void 0 ? void 0 : gray[100],
+            "bg-accent": gray === null || gray === void 0 ? void 0 : gray[200], "bg-subtle": gray === null || gray === void 0 ? void 0 : gray[100], "bg-muted": gray === null || gray === void 0 ? void 0 : gray[200],
+            "bg-neutral": gray === null || gray === void 0 ? void 0 : gray[100], "bg-base": gray === null || gray === void 0 ? void 0 : gray[50], "bg-table-header": gray === null || gray === void 0 ? void 0 : gray[100],
+            "border-default": gray === null || gray === void 0 ? void 0 : gray[200], "border-light": gray === null || gray === void 0 ? void 0 : gray[100],
+            "border-dark": gray === null || gray === void 0 ? void 0 : gray[300], "border-input": gray === null || gray === void 0 ? void 0 : gray[300],
+            "border-error": (_b = sem.error) === null || _b === void 0 ? void 0 : _b[500], "border-success": (_c = sem.success) === null || _c === void 0 ? void 0 : _c[500],
+            "border-warning": (_d = sem.warning) === null || _d === void 0 ? void 0 : _d[500], "border-info": (_e = sem.info) === null || _e === void 0 ? void 0 : _e[500],
+        };
+        const set = (name, val) => val && root.style.setProperty(`--color-${name}`, val);
+        const clear = (name) => root.style.removeProperty(`--color-${name}`);
+        const allRampNames = [...HUE_SCALES, ...SEMANTIC_SCALES].flatMap((s) => RUNGS.map((r) => `${s}-${r}`));
+        if (resolvedMode === "dark") {
+            for (const s of HUE_SCALES)
+                for (const r of RUNGS)
+                    set(`${s}-${r}`, (_f = colors[s]) === null || _f === void 0 ? void 0 : _f[r]);
+            for (const s of SEMANTIC_SCALES)
+                for (const r of RUNGS)
+                    set(`${s}-${r}`, (_g = sem[s]) === null || _g === void 0 ? void 0 : _g[r]);
+            for (const [name, val] of Object.entries(SEMANTIC_VARS))
+                set(name, val);
+        }
+        else {
+            for (const name of allRampNames)
+                clear(name);
+            for (const name of Object.keys(SEMANTIC_VARS))
+                clear(name);
+        }
+    }, [resolvedMode, resolvedTheme]);
+    return (_jsx(ThemeModeContext.Provider, { value: value, children: _jsx(ChakraProvider, { theme: resolvedTheme, colorModeManager: forcedLightColorModeManager, children: _jsx(ToasterProvider, { children: children }) }) }));
+};

package/dist/esm/Theme/provider/ThemeSwitcher.js

@@ -0,0 +1,107 @@
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+import { useRef } from "react";
+import { Box, Button, HStack, IconButton, Menu, MenuButton, MenuDivider, MenuItemOption, MenuList, MenuOptionGroup, Text, Tooltip, } from "@chakra-ui/react";
+import { Monitor, Moon, Sun } from "lucide-react";
+import { brandThemes } from "../index.js";
+import { useCustomTheme } from "../useCustomTheme.js";
+import { useThemeMode } from "./useThemeMode.js";
+const MODE_OPTIONS = [
+    { value: "light", label: "Light", Icon: Sun },
+    { value: "system", label: "System", Icon: Monitor },
+    { value: "dark", label: "Dark", Icon: Moon },
+];
+const SIZES = {
+    sm: { control: "sm", icon: 14 },
+    md: { control: "md", icon: 16 },
+    lg: { control: "lg", icon: 18 },
+};
+const toBrandLabel = (brand) => brand.charAt(0).toUpperCase() + brand.slice(1);
+/**
+ * Same swatch each brand's own theme carries at `colors.primary[500]` (the
+ * anchor a filled button reads) — resolved per brand from its OWN palette so
+ * the dot always matches what selecting that brand actually looks like,
+ * regardless of which brand/mode is currently active.
+ */
+const brandSwatchColor = (brand) => {
+    var _a, _b, _c, _d, _e;
+    return (_e = (_d = (_c = (_b = (_a = brandThemes[brand]) === null || _a === void 0 ? void 0 : _a.light) === null || _b === void 0 ? void 0 : _b.colors) === null || _c === void 0 ? void 0 : _c.primary) === null || _d === void 0 ? void 0 : _d[500]) !== null && _e !== void 0 ? _e : "gray.400";
+};
+const BrandSwatch = ({ brand }) => (_jsx(Box, { as: "span", display: "inline-block", w: "0.625rem", h: "0.625rem", borderRadius: "full", bg: brandSwatchColor(brand), border: "1px solid", borderColor: "whiteAlpha.300", flexShrink: 0 }));
+/**
+ * Palette values already differ per color mode (`brandThemes[brand].light|dark`), so tokens
+ * are read straight from the active theme — no `useColorModeValue` pairing needed here.
+ * Fallbacks are Chakra token names, never literal colors, for themes without a brand palette.
+ */
+const useSwitcherColors = () => {
+    var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o, _p, _q, _r, _s, _t, _u, _v, _w, _x, _y, _z, _0;
+    const colors = useCustomTheme().colors;
+    return {
+        trackBg: (_d = (_b = (_a = colors === null || colors === void 0 ? void 0 : colors.backgroundColor) === null || _a === void 0 ? void 0 : _a.secondary) !== null && _b !== void 0 ? _b : (_c = colors === null || colors === void 0 ? void 0 : colors.gray) === null || _c === void 0 ? void 0 : _c[100]) !== null && _d !== void 0 ? _d : "gray.100",
+        activeBg: (_g = (_f = (_e = colors === null || colors === void 0 ? void 0 : colors.backgroundColor) === null || _e === void 0 ? void 0 : _e.main) !== null && _f !== void 0 ? _f : colors === null || colors === void 0 ? void 0 : colors.white) !== null && _g !== void 0 ? _g : "white",
+        activeColor: (_l = (_j = (_h = colors === null || colors === void 0 ? void 0 : colors.primary) === null || _h === void 0 ? void 0 : _h[500]) !== null && _j !== void 0 ? _j : (_k = colors === null || colors === void 0 ? void 0 : colors.text) === null || _k === void 0 ? void 0 : _k[900]) !== null && _l !== void 0 ? _l : "inherit",
+        mutedColor: (_q = (_o = (_m = colors === null || colors === void 0 ? void 0 : colors.text) === null || _m === void 0 ? void 0 : _m[600]) !== null && _o !== void 0 ? _o : (_p = colors === null || colors === void 0 ? void 0 : colors.gray) === null || _p === void 0 ? void 0 : _p[600]) !== null && _q !== void 0 ? _q : "gray.600",
+        hoverBg: (_s = (_r = colors === null || colors === void 0 ? void 0 : colors.gray) === null || _r === void 0 ? void 0 : _r[100]) !== null && _s !== void 0 ? _s : "gray.100",
+        borderColor: (_w = (_u = (_t = colors === null || colors === void 0 ? void 0 : colors.border) === null || _t === void 0 ? void 0 : _t[200]) !== null && _u !== void 0 ? _u : (_v = colors === null || colors === void 0 ? void 0 : colors.gray) === null || _v === void 0 ? void 0 : _v[200]) !== null && _w !== void 0 ? _w : "gray.200",
+        // `--menu-bg` (and its hover/focus/active states) is now fixed centrally in the theme's
+        // Menu component style (Theme/chakra/Menu.styles.ts) — every MenuList gets it from there.
+        // Re-deriving it here too and pushing it back via `sx` on every render caused a redundant
+        // Emotion style recompute per render, which showed up as flicker while hovering/scrolling
+        // this list. Keep menuColor (Menu.styles.ts doesn't set list `color` per this component's
+        // needs) but stop duplicating menuBg.
+        menuColor: (_0 = (_y = (_x = colors === null || colors === void 0 ? void 0 : colors.text) === null || _x === void 0 ? void 0 : _x[900]) !== null && _y !== void 0 ? _y : (_z = colors === null || colors === void 0 ? void 0 : colors.gray) === null || _z === void 0 ? void 0 : _z[900]) !== null && _0 !== void 0 ? _0 : "gray.900",
+    };
+};
+const BrandMenu = ({ size }) => {
+    const { brand, setBrand } = useThemeMode();
+    const { mutedColor, menuColor } = useSwitcherColors();
+    const brands = Object.keys(brandThemes);
+    return (_jsxs(Menu, { children: [_jsx(MenuButton, { as: Button, size: SIZES[size].control, variant: "ghost", color: mutedColor, borderRadius: "full", fontWeight: 500, "aria-label": `Brand theme, current ${toBrandLabel(brand)}`, _focusVisible: { boxShadow: "outline" }, children: _jsxs(HStack, { spacing: 2, children: [_jsx(BrandSwatch, { brand: brand }), _jsx(Text, { as: "span", children: toBrandLabel(brand) })] }) }), _jsx(MenuList, { minW: "9rem", color: menuColor, children: _jsx(MenuOptionGroup, { title: "Brand", type: "radio", value: brand, onChange: (value) => setBrand(value), children: brands.map((option) => (_jsx(MenuItemOption, { value: option, children: _jsxs(HStack, { spacing: 2, children: [_jsx(BrandSwatch, { brand: option }), _jsx(Text, { as: "span", children: toBrandLabel(option) })] }) }, option))) }) })] }));
+};
+const IconVariant = ({ size, label, }) => {
+    const { resolvedMode, toggle } = useThemeMode();
+    const { mutedColor, hoverBg } = useSwitcherColors();
+    const isDark = resolvedMode === "dark";
+    const Icon = isDark ? Moon : Sun;
+    const accessibleLabel = label !== null && label !== void 0 ? label : `Switch to ${isDark ? "light" : "dark"} mode`;
+    return (_jsx(Tooltip, { label: accessibleLabel, openDelay: 400, children: _jsx(IconButton, { "aria-label": accessibleLabel, "aria-pressed": isDark, icon: _jsx(Icon, { size: SIZES[size].icon, "aria-hidden": true }), onClick: toggle, size: SIZES[size].control, variant: "ghost", color: mutedColor, borderRadius: "full", _hover: { bg: hoverBg }, _focusVisible: { boxShadow: "outline" } }) }));
+};
+const SegmentedVariant = ({ size, label, showBrandPicker, }) => {
+    const { mode, setMode } = useThemeMode();
+    const { trackBg, activeBg, activeColor, mutedColor, borderColor } = useSwitcherColors();
+    const optionRefs = useRef([]);
+    // APG radiogroup behavior: arrows move focus and selection together.
+    const handleKeyDown = (event, index) => {
+        var _a;
+        const forward = event.key === "ArrowRight" || event.key === "ArrowDown";
+        const backward = event.key === "ArrowLeft" || event.key === "ArrowUp";
+        if (!forward && !backward)
+            return;
+        event.preventDefault();
+        const next = (index + (forward ? 1 : -1) + MODE_OPTIONS.length) % MODE_OPTIONS.length;
+        setMode(MODE_OPTIONS[next].value);
+        (_a = optionRefs.current[next]) === null || _a === void 0 ? void 0 : _a.focus();
+    };
+    return (_jsxs(HStack, { role: "radiogroup", "aria-label": label !== null && label !== void 0 ? label : "Color mode", display: "inline-flex", spacing: 1, p: "0.25rem", bg: trackBg, border: "0.063rem solid", borderColor: borderColor, borderRadius: "full", children: [MODE_OPTIONS.map(({ value, label: optionLabel, Icon }, index) => {
+                const isSelected = mode === value;
+                return (_jsx(Button, { ref: (node) => {
+                        optionRefs.current[index] = node;
+                    }, role: "radio", "aria-checked": isSelected, "aria-label": optionLabel, onClick: () => setMode(value), onKeyDown: (event) => handleKeyDown(event, index), size: SIZES[size].control, variant: "ghost", borderRadius: "full", bg: isSelected ? activeBg : "transparent", color: isSelected ? activeColor : mutedColor, boxShadow: isSelected ? "sm" : "none", _hover: { color: activeColor }, _focusVisible: { boxShadow: "outline" }, children: _jsx(Icon, { size: SIZES[size].icon, "aria-hidden": true }) }, value));
+            }), showBrandPicker && _jsx(BrandMenu, { size: size })] }));
+};
+const MenuVariant = ({ size, label, showBrandPicker, }) => {
+    var _a;
+    const { mode, brand, setMode, setBrand } = useThemeMode();
+    const { mutedColor, hoverBg, menuColor } = useSwitcherColors();
+    const active = (_a = MODE_OPTIONS.find((option) => option.value === mode)) !== null && _a !== void 0 ? _a : MODE_OPTIONS[0];
+    const brands = Object.keys(brandThemes);
+    return (_jsxs(Menu, { children: [_jsx(MenuButton, { as: IconButton, "aria-label": label !== null && label !== void 0 ? label : `Color mode, current ${active.label}`, icon: _jsx(active.Icon, { size: SIZES[size].icon, "aria-hidden": true }), size: SIZES[size].control, variant: "ghost", color: mutedColor, borderRadius: "full", _hover: { bg: hoverBg }, _focusVisible: { boxShadow: "outline" } }), _jsxs(MenuList, { minW: "10rem", color: menuColor, children: [_jsx(MenuOptionGroup, { title: "Appearance", type: "radio", value: mode, onChange: (value) => setMode(value), children: MODE_OPTIONS.map(({ value, label: optionLabel, Icon }) => (_jsx(MenuItemOption, { value: value, children: _jsxs(HStack, { spacing: 2, children: [_jsx(Icon, { size: SIZES[size].icon, "aria-hidden": true }), _jsx(Text, { as: "span", children: optionLabel })] }) }, value))) }), showBrandPicker && (_jsxs(_Fragment, { children: [_jsx(MenuDivider, {}), _jsx(MenuOptionGroup, { title: "Brand", type: "radio", value: brand, onChange: (value) => setBrand(value), children: brands.map((option) => (_jsx(MenuItemOption, { value: option, children: _jsxs(HStack, { spacing: 2, children: [_jsx(BrandSwatch, { brand: option }), _jsx(Text, { as: "span", children: toBrandLabel(option) })] }) }, option))) })] }))] })] }));
+};
+export const ThemeSwitcher = ({ variant = "icon", showBrandPicker = false, size = "md", "aria-label": ariaLabel, }) => {
+    if (variant === "segmented") {
+        return (_jsx(SegmentedVariant, { size: size, label: ariaLabel, showBrandPicker: showBrandPicker }));
+    }
+    if (variant === "menu") {
+        return (_jsx(MenuVariant, { size: size, label: ariaLabel, showBrandPicker: showBrandPicker }));
+    }
+    return (_jsxs(HStack, { spacing: 1, display: "inline-flex", children: [_jsx(IconVariant, { size: size, label: ariaLabel }), showBrandPicker && _jsx(BrandMenu, { size: size })] }));
+};

package/dist/esm/Theme/provider/colorModeStorage.js

@@ -0,0 +1,99 @@
+const DARK_QUERY = "(prefers-color-scheme: dark)";
+/**
+ * Stored values are untrusted input — a stale or hand-edited entry must never reach
+ * `brandThemes[brand]` and hand Chakra an `undefined` theme.
+ */
+const VALID_MODES = ["light", "dark", "system"];
+const VALID_BRANDS = [
+    "lavender",
+    "meadow",
+    "radiant",
+    "skyline",
+    "slate",
+    "emerald",
+    "rosewood",
+    "storefront",
+    "zinc",
+];
+const noop = () => { };
+/** Safari private mode throws on `localStorage` access rather than returning null. */
+const getStorage = () => {
+    var _a;
+    try {
+        if (typeof window === "undefined")
+            return null;
+        return (_a = window.localStorage) !== null && _a !== void 0 ? _a : null;
+    }
+    catch {
+        return null;
+    }
+};
+export const readStoredTheme = (storageKey) => {
+    const storage = getStorage();
+    if (!storage)
+        return {};
+    try {
+        const raw = storage.getItem(storageKey);
+        if (!raw)
+            return {};
+        const parsed = JSON.parse(raw);
+        if (!parsed || typeof parsed !== "object")
+            return {};
+        const { mode, brand } = parsed;
+        const stored = {};
+        if (mode && VALID_MODES.includes(mode))
+            stored.mode = mode;
+        if (brand && VALID_BRANDS.includes(brand))
+            stored.brand = brand;
+        return stored;
+    }
+    catch {
+        return {};
+    }
+};
+export const writeStoredTheme = (storageKey, value) => {
+    const storage = getStorage();
+    if (!storage)
+        return;
+    try {
+        storage.setItem(storageKey, JSON.stringify(value));
+    }
+    catch {
+        // Quota / private mode. Persistence is best-effort — never break the app over it.
+    }
+};
+export const getSystemColorMode = () => {
+    try {
+        if (typeof window === "undefined" || typeof window.matchMedia !== "function") {
+            return "light";
+        }
+        return window.matchMedia(DARK_QUERY).matches ? "dark" : "light";
+    }
+    catch {
+        return "light";
+    }
+};
+export const subscribeToSystemColorMode = (callback) => {
+    try {
+        if (typeof window === "undefined" || typeof window.matchMedia !== "function") {
+            return noop;
+        }
+        const query = window.matchMedia(DARK_QUERY);
+        const handler = (event) => {
+            callback(event.matches ? "dark" : "light");
+        };
+        if (typeof query.addEventListener === "function") {
+            query.addEventListener("change", handler);
+            return () => query.removeEventListener("change", handler);
+        }
+        // Safari < 14 only has the deprecated listener API.
+        if (typeof query.addListener === "function") {
+            query.addListener(handler);
+            return () => query.removeListener(handler);
+        }
+        return noop;
+    }
+    catch {
+        return noop;
+    }
+};

package/dist/esm/Theme/provider/fontSize.js

@@ -0,0 +1,18 @@
+import { useEffect } from "react";
+export const DEFAULT_FONT_SIZE = "100%";
+export const FONT_SIZE_OPTIONS = [
+    { id: "80%", label: "Small" },
+    { id: "90%", label: "Medium Small" },
+    { id: DEFAULT_FONT_SIZE, label: "Default" },
+    { id: "110%", label: "Medium Large" },
+    { id: "120%", label: "Large" },
+    { id: "130%", label: "Extra Large" },
+];
+// The value lands on html { font-size }, so a junk stored value must not reach it.
+export const isFontSize = (value) => !!value && FONT_SIZE_OPTIONS.some((option) => option.id === value);
+export const resolveFontSize = (value) => isFontSize(value) ? value : DEFAULT_FONT_SIZE;
+export const useFontSizeSync = (fontSize) => {
+    useEffect(() => {
+        document.documentElement.style.fontSize = resolveFontSize(fontSize);
+    }, [fontSize]);
+};

package/dist/esm/Theme/provider/index.js

@@ -0,0 +1,4 @@
+export { PixelizeThemeProvider } from "./PixelizeThemeProvider.js";
+export { useThemeMode } from "./useThemeMode.js";
+export { ThemeSwitcher } from "./ThemeSwitcher.js";
+export { DEFAULT_FONT_SIZE, FONT_SIZE_OPTIONS, isFontSize, resolveFontSize, useFontSizeSync, } from "./fontSize.js";

package/dist/esm/Theme/provider/useThemeMode.js

@@ -0,0 +1,9 @@
+import { useContext } from "react";
+import { ThemeModeContext } from "./PixelizeThemeProvider.js";
+export const useThemeMode = () => {
+    const context = useContext(ThemeModeContext);
+    if (!context) {
+        throw new Error("useThemeMode must be used inside <PixelizeThemeProvider>. Wrap your app (or at least the subtree that calls useThemeMode) in <PixelizeThemeProvider> from pixelize-design-library.");
+    }
+    return context;
+};

package/dist/esm/Theme/testing/testPalette.js

@@ -0,0 +1,19 @@
+import { lightPalettes, darkPalettes } from "../tokens/brands/index.js";
+const isPlainObject = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
+const deepMerge = (base, patch) => {
+    if (!isPlainObject(base) || !isPlainObject(patch))
+        return patch;
+    const out = { ...base };
+    for (const [key, value] of Object.entries(patch))
+        out[key] = deepMerge(base[key], value);
+    return out;
+};
+/** A complete palette for tests. Overrides layer onto a real brand, never replace a group. */
+export const testPalette = (options = {}) => {
+    const { brand = "lavender", mode = "light", overrides = {} } = options;
+    const base = mode === "dark" ? darkPalettes[brand] : lightPalettes[brand];
+    return deepMerge(base, overrides);
+};
+export const testTheme = (options = {}) => ({
+    colors: testPalette(options),
+});

package/dist/esm/Theme/themeProps.js

@@ -0,0 +1 @@
+import "@chakra-ui/react";

package/dist/esm/Theme/tokens/brands/emerald/palette.dark.js

@@ -0,0 +1,8 @@
+import { buildDarkPalette } from "../../builders/buildDarkPalette.js";
+import light from "./palette.light.js";
+/**
+ * Dark palette for the emerald brand, derived from its own light palette so the brand hue
+ * carries through. Override individual tokens here if this brand needs a bespoke dark value.
+ */
+const palette = buildDarkPalette(light);
+export default palette;

package/dist/esm/Theme/tokens/brands/emerald/palette.light.js

@@ -0,0 +1,130 @@
+import lavenderPalette from "../lavender/palette.light.js";
+import { buildPrimaryOpacity, buildPrimaryShadowTint } from "../../builders/buildBrandTokens.js";
+const PRIMARY_500 = "#0f9d8a"; // teal-emerald core (balanced, not too green/blue)
+const primary = {
+    50: "#e6f7f5",
+    100: "#c2ebe6",
+    200: "#8eddd4",
+    300: "#5acfc2",
+    400: "#2fb7a9",
+    500: PRIMARY_500,
+    600: "#0c8575",
+    700: "#096b5e",
+    800: "#065248",
+    900: "#043b35",
+    opacity: buildPrimaryOpacity(PRIMARY_500),
+};
+const palette = {
+    ...lavenderPalette,
+    // Stops retuned so white gradient-button text (onGradient, accentText.ts) clears AA at both
+    // ends — the original pair let white drop to 3.38/2.43 against from/to. Same hue, darker.
+    // Both nudged one step further (4.537/4.515 -> 4.618/4.616): the first pass cleared AA by
+    // <0.02, too thin a margin to trust against rounding/rendering variance.
+    gradient: { from: "#0d8474", to: "#048096" }, // teal → cyan
+    primary,
+    // 🌫️ Neutral gray (slightly cool to match teal)
+    gray: {
+        50: "#f6f8f8",
+        100: "#edf2f2",
+        200: "#dce5e5",
+        300: "#c3d2d2",
+        400: "#9fb3b3",
+        // Retuned to clear AA with a safe >=4.6 margin (not the bare 4.5 cutoff — a value that
+        // clears AA by <0.02 is treated as failing, see Wave D QA follow-up) against every
+        // backgroundColor surface it's actually rendered on (main/secondary/light/subtle —
+        // verified via usage grep). muted/accent/tertiary/etc. have 0-1 live call sites today and
+        // none pair them with gray[500] text; going dark enough to also clear those would push
+        // past gray[600]'s own lightness and break the ramp order.
+        500: "#617474",
+        600: "#5e7070",
+        700: "#475555",
+        800: "#2f3a3a",
+        900: "#1f2626",
+    },
+    // 🌊 Background system (very subtle teal tint)
+    backgroundColor: {
+        main: "#f7fbfb",
+        secondary: "#eef7f6",
+        tertiary: "#e5f1ef",
+        quaternary: "#dcebea",
+        light: "#fcfefe",
+        medium: "#e2efee",
+        accent: "#d5e7e5",
+        subtle: "#f4f9f9",
+        muted: "#cfe2e0",
+        neutral: "#e2efee",
+        base: "#fafdfd",
+        tableHeader: "#eef7f6",
+    },
+    background: {
+        50: "#ffffff",
+        100: "#fbfefe",
+        200: "#eef7f6",
+        300: "#e5f1ef",
+        400: "#dcebea",
+        500: "#d2e4e2",
+        600: "#bdd1cf",
+        700: "#96a9a7",
+        800: "#707f7e",
+        900: "#545f5f",
+    },
+    border: {
+        50: "#fafeff",
+        100: "#edf5f4",
+        200: "#ddebea",
+        300: "#cde1df",
+        400: "#bdd6d4",
+        500: "#accbc9",
+        600: "#99b7b5",
+        700: "#788f8e",
+        800: "#5b6e6d",
+        900: "#455454",
+    },
+    boxborder: {
+        50: "#fafeff",
+        100: "#ecf4f3",
+        200: "#d9e7e5",
+        300: "#c6dad8",
+        400: "#b3cdcb",
+        500: "#a0c0be",
+        600: "#8dadab",
+        700: "#6e8786",
+        800: "#546868",
+        900: "#3f5050",
+    },
+    table: {
+        hover: {
+            50: "#fbfefe",
+            100: "#f0f7f7",
+            200: "#e6f1f1",
+            300: "#dceaea",
+            400: "#d2e3e3",
+            500: "#c8dcdc",
+            600: "#b4c7c7",
+            700: "#909f9f",
+            800: "#6c7777",
+            900: "#525b5b",
+        },
+    },
+    // 🌑 Sidebar (deep teal-black)
+    sidebar: {
+        background: {
+            50: "#eaf4f3",
+            100: "#cfe3e1",
+            200: "#3e6f6a",
+            300: "#5a8c86",
+            400: "#2f5a55",
+            500: "#0e1f1e", // charcoal teal (instead of near-black)
+            600: "#0b1918",
+            700: "#081312",
+            800: "#060e0d",
+            900: "#040908",
+        },
+    },
+    boxShadow: {
+        primary: buildPrimaryShadowTint(PRIMARY_500),
+        error: lavenderPalette.boxShadow.error,
+        default: lavenderPalette.boxShadow.default,
+    },
+};
+export default palette;