@cube-dev/ui-kit 0.0.0-canary-51c94b0 → 0.0.0-canary-7d79005

package/dist/icons/ThunderboltIcon.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-51c94b0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-7d79005 | Cube Dev Team */
 import { wrapIcon } from "./wrap-icon.js";
 import { jsx } from "react/jsx-runtime";
 import { IconBolt } from "@tabler/icons-react";

package/dist/icons/TimeIcon.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-51c94b0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-7d79005 | Cube Dev Team */
 import { wrapIcon } from "./wrap-icon.js";
 import { jsx } from "react/jsx-runtime";
 import { IconClockHour4 } from "@tabler/icons-react";

package/dist/icons/TrashIcon.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-51c94b0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-7d79005 | Cube Dev Team */
 import { wrapIcon } from "./wrap-icon.js";
 import { jsx } from "react/jsx-runtime";
 import { IconTrash } from "@tabler/icons-react";

package/dist/icons/UnlockIcon.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-51c94b0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-7d79005 | Cube Dev Team */
 import { wrapIcon } from "./wrap-icon.js";
 import { jsx } from "react/jsx-runtime";
 import { IconLockOpen2 } from "@tabler/icons-react";

package/dist/icons/UpIcon.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-51c94b0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-7d79005 | Cube Dev Team */
 import { wrapIcon } from "./wrap-icon.js";
 import { jsx } from "react/jsx-runtime";
 import { IconChevronUp } from "@tabler/icons-react";

package/dist/icons/UserGroupIcon.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-51c94b0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-7d79005 | Cube Dev Team */
 import { wrapIcon } from "./wrap-icon.js";
 import { jsx, jsxs } from "react/jsx-runtime";
 

package/dist/icons/UserIcon.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-51c94b0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-7d79005 | Cube Dev Team */
 import { wrapIcon } from "./wrap-icon.js";
 import { jsx, jsxs } from "react/jsx-runtime";
 

package/dist/icons/UserLockIcon.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-51c94b0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-7d79005 | Cube Dev Team */
 import { wrapIcon } from "./wrap-icon.js";
 import { jsx } from "react/jsx-runtime";
 

package/dist/icons/ViewIcon.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-51c94b0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-7d79005 | Cube Dev Team */
 import { wrapIcon } from "./wrap-icon.js";
 import { jsx } from "react/jsx-runtime";
 

package/dist/icons/WarningFilledIcon.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-51c94b0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-7d79005 | Cube Dev Team */
 import { wrapIcon } from "./wrap-icon.js";
 import { jsx } from "react/jsx-runtime";
 import { IconAlertTriangleFilled } from "@tabler/icons-react";

package/dist/icons/WarningIcon.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-51c94b0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-7d79005 | Cube Dev Team */
 import { wrapIcon } from "./wrap-icon.js";
 import { jsx } from "react/jsx-runtime";
 import { IconAlertTriangle } from "@tabler/icons-react";

package/dist/icons/wrap-icon.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-51c94b0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-7d79005 | Cube Dev Team */
 import { Icon } from "./Icon.js";
 import { jsx } from "react/jsx-runtime";
 

package/dist/index.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-51c94b0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-7d79005 | Cube Dev Team */
 import { extractStyles } from "./utils/styles.js";
 import { chain } from "./utils/react/chain.js";
 import { forwardRefWithGenerics } from "./utils/react/forwardRefWithGenerics.js";

package/dist/provider.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-51c94b0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-7d79005 | Cube Dev Team */
 import { EventBusProvider } from "./utils/react/useEventBus.js";
 import { defaultNavigationAdapter } from "./providers/navigationAdapter.default.js";
 import { createContext, useContext, useMemo } from "react";

package/dist/providers/TrackingProvider.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-51c94b0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-7d79005 | Cube Dev Team */
 import { createContext, useContext, useMemo } from "react";
 import { Fragment as Fragment$1, jsx } from "react/jsx-runtime";
 

package/dist/providers/navigationAdapter.default.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-51c94b0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-7d79005 | Cube Dev Team */
 //#region src/providers/navigationAdapter.default.ts
 /**
 * Converts a Path object to a string URL

package/dist/tokens/base.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-51c94b0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-7d79005 | Cube Dev Team */
 //#region src/tokens/base.ts
 /**
 * Base design system tokens.

package/dist/tokens/colors.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-51c94b0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-7d79005 | Cube Dev Team */
 import { getPaletteVersion } from "./palette-config.js";
 import { BASE_TOKENS } from "./base.js";
 import { lazyStyles } from "./lazy-styles.js";

package/dist/tokens/index.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-51c94b0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-7d79005 | Cube Dev Team */
 import { DEFAULT_PALETTE_CONFIG, getPaletteConfig, getPaletteConfigInput, getPaletteVersion, invalidatePaletteTokens, resetPaletteConfig, resolvePaletteConfig, setPaletteConfig, subscribePaletteConfig, usePaletteConfig, usePaletteVersion } from "./palette-config.js";
 import { BASE_TOKENS } from "./base.js";
 import { lazyStyles } from "./lazy-styles.js";

package/dist/tokens/layout.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-51c94b0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-7d79005 | Cube Dev Team */
 //#region src/tokens/layout.ts
 /**
 * Layout-related tokens for common UI dimensions.

package/dist/tokens/lazy-styles.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-51c94b0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-7d79005 | Cube Dev Team */
 //#region src/tokens/lazy-styles.ts
 /**
 * Proxy that defers to `factory()` on every property / enumeration access.

package/dist/tokens/palette-config.d.ts

@@ -114,30 +114,42 @@ interface ResolvedPaletteConfig {
     };
   };
 }
-/** The palette as it ships, with no tuning applied. */
+/**
+ * The palette as it ships, with no tuning applied. Frozen — it is the baseline
+ * every resolution falls back to, so a stray write to it would move the defaults
+ * for the whole process.
+ */
 declare const DEFAULT_PALETTE_CONFIG: ResolvedPaletteConfig;
 /**
- * Merge tuning into the current palette config.
+ * Set the palette config.
  *
- * Merges, like `glaze.configure()`: omitted fields keep their current value.
- * The palette is rebuilt lazily on the next token read, and any mounted `<Root>`
- * re-injects the token block — no component re-render is involved, because every
- * color in the kit resolves through a CSS custom property.
+ * **Replaces**, like `useState` — the config you pass *is* the config, resolved
+ * against the shipped defaults. Nothing accumulates, so a field you leave out is a
+ * field you do not have: dropping a customization means dropping it from the
+ * object, and re-applying the same object twice is the same as applying it once.
  *
  * ```ts
- * setPaletteConfig({ hue: 200, themes: { danger: { hue: 12 } } });
+ * setPaletteConfig({ hue: 200, baseHue: 60 });
+ * setPaletteConfig({ hue: 200 }); // baseHue is gone — back to inheriting `hue`
  * ```
  *
- * Omitting a field keeps it; passing `undefined` **clears** it, so it goes back to
- * inheriting (per-theme) or to the shipped default (top level):
+ * To adjust one field of the config already in place — a slider in a settings UI —
+ * pass an updater. It receives the config as written, sparse, so spreading it
+ * preserves which fields are pinned and which still inherit:
  *
  * ```ts
- * setPaletteConfig({ themes: { primary: { saturation: 90 } } }); // pin
- * setPaletteConfig({ themes: { primary: { saturation: undefined } } }); // inherit again
+ * setPaletteConfig((config) => ({ ...config, hue: 200 }));
  * ```
+ *
+ * The palette is rebuilt lazily on the next token read, and any mounted `<Root>`
+ * re-injects the token block — no component re-render is involved, because every
+ * color in the kit resolves through a CSS custom property.
+ */
+declare function setPaletteConfig(config: PaletteConfig | ((previous: PaletteConfig) => PaletteConfig)): void;
+/**
+ * Drop all tuning and restore the palette the kit ships with. Identical to
+ * `setPaletteConfig({})`; it exists to be readable at a call site.
  */
-declare function setPaletteConfig(config: PaletteConfig): void;
-/** Drop all tuning and restore the palette the kit ships with. */
 declare function resetPaletteConfig(): void;
 /**
  * Force every token to re-resolve without changing the palette config.
@@ -159,20 +171,22 @@ declare function getPaletteConfig(): ResolvedPaletteConfig;
  * to offer a way back:
  *
  * ```ts
- * const pinned = getPaletteConfigInput().themes?.primary?.saturation !== undefined;
+ * const pinned = getPaletteConfigInput().baseHue !== undefined;
  *
- * // Re-link it to the brand by clearing the field.
- * setPaletteConfig({ themes: { primary: { saturation: undefined } } });
+ * // Re-link it to the brand by dropping the field.
+ * setPaletteConfig(({ baseHue, ...config }) => config);
  * ```
+ *
+ * It is also the value handed to a {@link setPaletteConfig} updater.
  */
 declare function getPaletteConfigInput(): PaletteConfig;
 /**
- * Resolve a partial against the current config **without applying it**.
+ * Resolve a patch **over** the current config, without applying it.
  *
- * Same merge semantics as {@link setPaletteConfig} — omitted fields keep their
- * current value, unset per-theme fields keep inheriting — but the store is not
- * touched and no listener fires. Used to render a palette the app is not
- * actually using, e.g. for a theme preview.
+ * This one layers, unlike {@link setPaletteConfig}: a preview wants "the theme in
+ * use, but in dark", so the fields it does not mention have to come from the live
+ * config rather than from the defaults. The store is not touched and no listener
+ * fires.
  */
 declare function resolvePaletteConfig(config?: PaletteConfig): ResolvedPaletteConfig;
 /** Subscribe to palette config changes. Returns an unsubscribe function. */
@@ -183,21 +197,26 @@ declare function subscribePaletteConfig(listener: () => void): () => void;
  */
 declare function usePaletteVersion(): number;
 /**
- * Read and tune the palette from React, `useState`-style.
+ * Read and tune the palette from React, `useState`-style — including the part
+ * where the setter *replaces*. A control that changes one field wants the updater
+ * form, or it will drop every other field:
  *
  * ```tsx
  * const [palette, setPalette] = usePaletteConfig();
  *
  * <HueSlider
  *   value={palette.hue}
- *   onChange={(hue) => setPalette({ hue })}
+ *   onChange={(hue) => setPalette((config) => ({ ...config, hue }))}
  * />
  * ```
  *
+ * The first element is the *resolved* config, so `palette.hue` is always a number.
+ * The updater's argument is the sparse one — see {@link getPaletteConfigInput}.
+ *
  * The config is global process state, so every consumer of this hook — and every
  * mounted `<Root>` — sees the same palette.
  */
-declare function usePaletteConfig(): readonly [ResolvedPaletteConfig, (config: PaletteConfig) => void];
+declare function usePaletteConfig(): readonly [ResolvedPaletteConfig, typeof setPaletteConfig];
 //#endregion
 export { DEFAULT_PALETTE_CONFIG, PaletteCodeSeed, PaletteConfig, PaletteThemeName, PaletteThemeSeed, ResolvedPaletteConfig, getPaletteConfig, getPaletteConfigInput, invalidatePaletteTokens, resetPaletteConfig, resolvePaletteConfig, setPaletteConfig, subscribePaletteConfig, usePaletteConfig, usePaletteVersion };
 //# sourceMappingURL=palette-config.d.ts.map

package/dist/tokens/palette-config.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-51c94b0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-7d79005 | Cube Dev Team */
 import { useSyncExternalStore } from "react";
 
 //#region src/tokens/palette-config.ts
@@ -58,12 +58,17 @@ function resolveConfig(input) {
 		}
 	};
 }
-/** The palette as it ships, with no tuning applied. */
-const DEFAULT_PALETTE_CONFIG = resolveConfig({});
 /**
-* The accumulated *input*, not the resolved config. Keeping the sparse form is
-* what makes inheritance live: a later `setPaletteConfig({ saturation })` still
-* cascades into every theme that never set its own.
+* The palette as it ships, with no tuning applied. Frozen — it is the baseline
+* every resolution falls back to, so a stray write to it would move the defaults
+* for the whole process.
+*/
+const DEFAULT_PALETTE_CONFIG = freezeConfig(resolveConfig({}));
+/**
+* The last config *as written*, sparse — not the resolved one. Keeping the sparse
+* form is what makes inheritance live: a `saturation` with no `themes.danger.
+* saturation` beside it means danger genuinely follows the palette, rather than
+* having been frozen at whatever the palette read when it was set.
 */
 let input = {};
 let resolved = DEFAULT_PALETTE_CONFIG;
@@ -77,6 +82,10 @@ function mergeSeed(base, patch) {
 		...patch
 	};
 }
+/**
+* Layer a patch over a base config. Used by {@link resolvePaletteConfig} for
+* previews — *not* by {@link setPaletteConfig}, which replaces.
+*/
 function mergeInput(base, patch) {
 	const next = {
 		...base,
@@ -125,38 +134,78 @@ function pinSignature(config) {
 		].flatMap((name) => [set(config.themes?.[name]?.hue), set(config.themes?.[name]?.saturation)])
 	].join("");
 }
+/**
+* Snapshot a config so the store owns it outright.
+*
+* Two hazards this closes. The caller's object stays theirs, so mutating it after
+* the call cannot desync `input` from `resolved`. And what we hand back from
+* {@link getPaletteConfig} / {@link getPaletteConfigInput} is frozen, so a caller
+* who writes to it gets a clear failure rather than silently corrupting the store
+* — the version would not bump, and every token cache would go on serving values
+* that no longer match the config.
+*/
+function freezeConfig(config) {
+	const themes = config.themes;
+	if (themes) {
+		for (const seed of Object.values(themes)) if (seed) Object.freeze(seed);
+		Object.freeze(themes);
+	}
+	return Object.freeze(config);
+}
+/** {@link freezeConfig} on a copy, for a config we did not create ourselves. */
+function snapshotConfig(config) {
+	const themes = config.themes;
+	return freezeConfig({
+		...config,
+		...themes ? { themes: {
+			...themes.success ? { success: { ...themes.success } } : null,
+			...themes.danger ? { danger: { ...themes.danger } } : null,
+			...themes.warning ? { warning: { ...themes.warning } } : null,
+			...themes.note ? { note: { ...themes.note } } : null,
+			...themes.code ? { code: { ...themes.code } } : null
+		} } : null
+	});
+}
 function commit(nextInput) {
 	const nextResolved = resolveConfig(nextInput);
 	if (isSameConfig(resolved, nextResolved) && pinSignature(input) === pinSignature(nextInput)) return;
-	input = nextInput;
-	resolved = nextResolved;
+	input = snapshotConfig(nextInput);
+	resolved = freezeConfig(nextResolved);
 	version++;
 	listeners.forEach((listener) => listener());
 }
 /**
-* Merge tuning into the current palette config.
+* Set the palette config.
 *
-* Merges, like `glaze.configure()`: omitted fields keep their current value.
-* The palette is rebuilt lazily on the next token read, and any mounted `<Root>`
-* re-injects the token block — no component re-render is involved, because every
-* color in the kit resolves through a CSS custom property.
+* **Replaces**, like `useState` — the config you pass *is* the config, resolved
+* against the shipped defaults. Nothing accumulates, so a field you leave out is a
+* field you do not have: dropping a customization means dropping it from the
+* object, and re-applying the same object twice is the same as applying it once.
 *
 * ```ts
-* setPaletteConfig({ hue: 200, themes: { danger: { hue: 12 } } });
+* setPaletteConfig({ hue: 200, baseHue: 60 });
+* setPaletteConfig({ hue: 200 }); // baseHue is gone — back to inheriting `hue`
 * ```
 *
-* Omitting a field keeps it; passing `undefined` **clears** it, so it goes back to
-* inheriting (per-theme) or to the shipped default (top level):
+* To adjust one field of the config already in place — a slider in a settings UI —
+* pass an updater. It receives the config as written, sparse, so spreading it
+* preserves which fields are pinned and which still inherit:
 *
 * ```ts
-* setPaletteConfig({ themes: { primary: { saturation: 90 } } }); // pin
-* setPaletteConfig({ themes: { primary: { saturation: undefined } } }); // inherit again
+* setPaletteConfig((config) => ({ ...config, hue: 200 }));
 * ```
+*
+* The palette is rebuilt lazily on the next token read, and any mounted `<Root>`
+* re-injects the token block — no component re-render is involved, because every
+* color in the kit resolves through a CSS custom property.
 */
 function setPaletteConfig(config) {
-	commit(mergeInput(input, config));
+	commit(typeof config === "function" ? config(input) : config);
 }
-/** Drop all tuning and restore the palette the kit ships with. */
+/**
+* Drop all tuning and restore the palette the kit ships with. Identical to
+* `setPaletteConfig({})`; it exists to be readable at a call site.
+*/
 function resetPaletteConfig() {
 	commit({});
 }
@@ -185,22 +234,24 @@ function getPaletteConfig() {
 * to offer a way back:
 *
 * ```ts
-* const pinned = getPaletteConfigInput().themes?.primary?.saturation !== undefined;
+* const pinned = getPaletteConfigInput().baseHue !== undefined;
 *
-* // Re-link it to the brand by clearing the field.
-* setPaletteConfig({ themes: { primary: { saturation: undefined } } });
+* // Re-link it to the brand by dropping the field.
+* setPaletteConfig(({ baseHue, ...config }) => config);
 * ```
+*
+* It is also the value handed to a {@link setPaletteConfig} updater.
 */
 function getPaletteConfigInput() {
 	return input;
 }
 /**
-* Resolve a partial against the current config **without applying it**.
+* Resolve a patch **over** the current config, without applying it.
 *
-* Same merge semantics as {@link setPaletteConfig} — omitted fields keep their
-* current value, unset per-theme fields keep inheriting — but the store is not
-* touched and no listener fires. Used to render a palette the app is not
-* actually using, e.g. for a theme preview.
+* This one layers, unlike {@link setPaletteConfig}: a preview wants "the theme in
+* use, but in dark", so the fields it does not mention have to come from the live
+* config rather than from the defaults. The store is not touched and no listener
+* fires.
 */
 function resolvePaletteConfig(config) {
 	if (!config) return resolved;
@@ -229,17 +280,22 @@ function usePaletteVersion() {
 	return useSyncExternalStore(subscribePaletteConfig, getPaletteVersion, getPaletteVersion);
 }
 /**
-* Read and tune the palette from React, `useState`-style.
+* Read and tune the palette from React, `useState`-style — including the part
+* where the setter *replaces*. A control that changes one field wants the updater
+* form, or it will drop every other field:
 *
 * ```tsx
 * const [palette, setPalette] = usePaletteConfig();
 *
 * <HueSlider
 *   value={palette.hue}
-*   onChange={(hue) => setPalette({ hue })}
+*   onChange={(hue) => setPalette((config) => ({ ...config, hue }))}
 * />
 * ```
 *
+* The first element is the *resolved* config, so `palette.hue` is always a number.
+* The updater's argument is the sparse one — see {@link getPaletteConfigInput}.
+*
 * The config is global process state, so every consumer of this hook — and every
 * mounted `<Root>` — sees the same palette.
 */

package/dist/tokens/palette-config.js.map

@@ -1 +1 @@
-{"version":3,"file":"palette-config.js","names":[],"sources":["../../src/tokens/palette-config.ts"],"sourcesContent":["import { useSyncExternalStore } from 'react';\n\n/**\n * Runtime configuration for the Glaze-generated color palette.\n *\n * The palette recipe itself lives in `./palette.ts`; this module owns only the\n * *seeds* it is built from, plus a version counter the token caches watch. It\n * deliberately imports nothing else — not the token modules, not `glaze` — so\n * there is no import cycle and no ordering hazard.\n *\n * Reading is free; writing rebuilds the palette on the next token read. See\n * `Getting Started/Theming` in Storybook for the full contract.\n */\n\n// ============================================================================\n// Default seeds\n// ============================================================================\n\n/** Brand hue. Drives the `default`, `primary`, `purple` and `special` themes. */\nexport const DEFAULT_HUE = 280.3;\nexport const DEFAULT_SUCCESS_HUE = 156.9;\nexport const DEFAULT_DANGER_HUE = 23.1;\nexport const DEFAULT_WARNING_HUE = 84.3;\nexport const DEFAULT_NOTE_HUE = 302.3;\n\n/** Seed saturation. Per-color `saturation` in the recipe is a 0–1 factor of it. */\nexport const DEFAULT_SATURATION = 80;\n\n// ============================================================================\n// Types\n// ============================================================================\n\n/** Hue / saturation seed override for one colored theme. */\nexport interface PaletteThemeSeed {\n  /** Hue in degrees (0–360). */\n  hue?: number;\n  /** Saturation (0–100). Defaults to the palette-level `saturation`. */\n  saturation?: number;\n}\n\n/**\n * The `code-*` syntax family takes a saturation and nothing else.\n *\n * Its hues are absolute literals by design, so syntax colors never rotate with the\n * brand — strings would collide with numbers the moment the brand went green. And\n * unlike every other theme, its saturation does **not** inherit the palette-level\n * one: the code palette is calibrated once and stays there, so re-seeding the app\n * cannot quietly wash out a code block.\n */\nexport interface PaletteCodeSeed {\n  /** Saturation (0–100). Defaults to {@link DEFAULT_SATURATION}, not to `saturation`. */\n  saturation?: number;\n}\n\n/** Names of the themes whose seeds can be overridden individually. */\nexport type PaletteThemeName =\n  | 'success'\n  | 'danger'\n  | 'warning'\n  | 'note'\n  | 'code';\n\n/**\n * Palette tuning. Every field is optional; omitted fields keep their default,\n * and per-theme fields left unset inherit the palette-level value.\n */\nexport interface PaletteConfig {\n  /**\n   * Accent hue in degrees (0–360) — the brand.\n   *\n   * Drives the `accent-*` family on every theme, `primary` / `purple` / `special`,\n   * and the brand-tinted odds and ends (`focus`, the loading faces, the disabled\n   * chip). Also the default for {@link PaletteConfig.baseHue}.\n   */\n  hue?: number;\n  /**\n   * Hue of the **base** zone in degrees (0–360): the neutral chrome — `surface`\n   * and its ladder, the `surface-text*` ramp, `border`, `placeholder`. Defaults to\n   * `hue`, so the chrome carries a faint tint of the brand unless you say otherwise.\n   *\n   * Splitting it lets the chrome sit on a different hue from the accent — a warm\n   * grey UI with a cool blue brand, say. Only the `default` theme is affected: a\n   * colored theme's tinted `surface` deliberately follows *its own* hue, because a\n   * danger banner should read as red.\n   */\n  baseHue?: number;\n  /**\n   * Seed saturation (0–100), and the fallback for every theme that does not set\n   * its own.\n   *\n   * One scale for the whole theme, by design. Every color's own `saturation` is a\n   * 0–1 factor of this seed — `surface` at 0.12, `border` at 0.175, the text ramp\n   * at 0.2, the accent family at ~1.0 — so moving it rescales the palette while\n   * keeping those proportions. Unlike hue, which is configured separately for the\n   * brand and for each status theme, saturation is deliberately not split: the\n   * ratio between a subtle surface tint and a saturated accent is part of the\n   * design.\n   */\n  saturation?: number;\n  /**\n   * Global. Widens the usable chroma range by relaxing the sRGB-safe limit,\n   * producing a softer, more even palette across hues. Glaze treats `pastel` as\n   * instance-level, so it is threaded into every theme.\n   */\n  pastel?: boolean;\n  /**\n   * Global. `'auto'` (the default) keeps the two-tier model: normal colors plus\n   * a separate high-contrast tier driven by `<html data-contrast=\"high\">` /\n   * `prefers-contrast: more`.\n   *\n   * A number (0–100) replaces that switch with a slider — and, because a manual\n   * level already carries the contrast preference, **drops the high-contrast\n   * tier entirely**. `0` reproduces the normal output and `100` the\n   * high-contrast output, bit for bit.\n   */\n  contrastLevel?: number | 'auto';\n  /** Per-theme seed overrides. */\n  themes?: {\n    success?: PaletteThemeSeed;\n    danger?: PaletteThemeSeed;\n    warning?: PaletteThemeSeed;\n    note?: PaletteThemeSeed;\n    code?: PaletteCodeSeed;\n  };\n}\n\n/** {@link PaletteConfig} with every field resolved to a concrete value. */\nexport interface ResolvedPaletteConfig {\n  hue: number;\n  baseHue: number;\n  saturation: number;\n  pastel: boolean;\n  contrastLevel: number | 'auto';\n  themes: {\n    success: { hue: number; saturation: number };\n    danger: { hue: number; saturation: number };\n    warning: { hue: number; saturation: number };\n    note: { hue: number; saturation: number };\n    code: { saturation: number };\n  };\n}\n\n// ============================================================================\n// Resolution\n// ============================================================================\n\nconst DEFAULT_THEME_HUES = {\n  success: DEFAULT_SUCCESS_HUE,\n  danger: DEFAULT_DANGER_HUE,\n  warning: DEFAULT_WARNING_HUE,\n  note: DEFAULT_NOTE_HUE,\n} as const;\n\nfunction resolveConfig(input: PaletteConfig): ResolvedPaletteConfig {\n  const saturation = input.saturation ?? DEFAULT_SATURATION;\n  const themes = input.themes ?? {};\n\n  const hue = input.hue ?? DEFAULT_HUE;\n\n  return {\n    hue,\n    baseHue: input.baseHue ?? hue,\n    saturation,\n    pastel: input.pastel ?? false,\n    contrastLevel: input.contrastLevel ?? 'auto',\n    themes: {\n      success: {\n        hue: themes.success?.hue ?? DEFAULT_THEME_HUES.success,\n        saturation: themes.success?.saturation ?? saturation,\n      },\n      danger: {\n        hue: themes.danger?.hue ?? DEFAULT_THEME_HUES.danger,\n        saturation: themes.danger?.saturation ?? saturation,\n      },\n      warning: {\n        hue: themes.warning?.hue ?? DEFAULT_THEME_HUES.warning,\n        saturation: themes.warning?.saturation ?? saturation,\n      },\n      note: {\n        hue: themes.note?.hue ?? DEFAULT_THEME_HUES.note,\n        saturation: themes.note?.saturation ?? saturation,\n      },\n      // Deliberately NOT `?? saturation`: the code palette is calibrated once and\n      // does not follow the palette-level seed. See `PaletteCodeSeed`.\n      code: { saturation: themes.code?.saturation ?? DEFAULT_SATURATION },\n    },\n  };\n}\n\n/** The palette as it ships, with no tuning applied. */\nexport const DEFAULT_PALETTE_CONFIG: ResolvedPaletteConfig = resolveConfig({});\n\n// ============================================================================\n// Store\n// ============================================================================\n\n/**\n * The accumulated *input*, not the resolved config. Keeping the sparse form is\n * what makes inheritance live: a later `setPaletteConfig({ saturation })` still\n * cascades into every theme that never set its own.\n */\nlet input: PaletteConfig = {};\nlet resolved: ResolvedPaletteConfig = DEFAULT_PALETTE_CONFIG;\nlet version = 0;\n\nconst listeners = new Set<() => void>();\n\nfunction mergeSeed<T extends PaletteThemeSeed | PaletteCodeSeed>(\n  base: T | undefined,\n  patch: T | undefined,\n): T | undefined {\n  if (!base) return patch;\n  if (!patch) return base;\n\n  return { ...base, ...patch };\n}\n\nfunction mergeInput(base: PaletteConfig, patch: PaletteConfig): PaletteConfig {\n  const next: PaletteConfig = { ...base, ...patch };\n\n  if (base.themes || patch.themes) {\n    next.themes = {\n      success: mergeSeed(base.themes?.success, patch.themes?.success),\n      danger: mergeSeed(base.themes?.danger, patch.themes?.danger),\n      warning: mergeSeed(base.themes?.warning, patch.themes?.warning),\n      note: mergeSeed(base.themes?.note, patch.themes?.note),\n      code: mergeSeed(base.themes?.code, patch.themes?.code),\n    };\n  }\n\n  return next;\n}\n\nfunction isSameConfig(a: ResolvedPaletteConfig, b: ResolvedPaletteConfig) {\n  return (\n    a.hue === b.hue &&\n    a.baseHue === b.baseHue &&\n    a.saturation === b.saturation &&\n    a.pastel === b.pastel &&\n    a.contrastLevel === b.contrastLevel &&\n    a.themes.code.saturation === b.themes.code.saturation &&\n    (['success', 'danger', 'warning', 'note'] as const).every(\n      (name) =>\n        a.themes[name].hue === b.themes[name].hue &&\n        a.themes[name].saturation === b.themes[name].saturation,\n    )\n  );\n}\n\n/**\n * Which fields are *explicitly set*, as an order-independent signature.\n *\n * Two configs can resolve to identical values yet differ in which of those values\n * are pinned rather than inherited — pinning `primary.saturation` to the number it\n * already inherited is the obvious case. That difference is invisible to\n * {@link isSameConfig} but visible through {@link getPaletteConfigInput}, so it has\n * to count as a change or a settings UI reading it would never re-render.\n */\nfunction pinSignature(config: PaletteConfig): string {\n  const set = (value: unknown) => (value === undefined ? '0' : '1');\n\n  return [\n    set(config.hue),\n    set(config.baseHue),\n    set(config.saturation),\n    set(config.pastel),\n    set(config.contrastLevel),\n    set(config.themes?.code?.saturation),\n    ...(['success', 'danger', 'warning', 'note'] as const).flatMap((name) => [\n      set(config.themes?.[name]?.hue),\n      set(config.themes?.[name]?.saturation),\n    ]),\n  ].join('');\n}\n\nfunction commit(nextInput: PaletteConfig) {\n  const nextResolved = resolveConfig(nextInput);\n\n  // Bail before bumping the version when nothing observable moved, so re-applying\n  // the same config — an inline `<Root palette={{ … }}>` literal on every\n  // render, a StrictMode double render — costs nothing.\n  if (\n    isSameConfig(resolved, nextResolved) &&\n    pinSignature(input) === pinSignature(nextInput)\n  ) {\n    return;\n  }\n\n  input = nextInput;\n  resolved = nextResolved;\n  version++;\n\n  listeners.forEach((listener) => listener());\n}\n\n/**\n * Merge tuning into the current palette config.\n *\n * Merges, like `glaze.configure()`: omitted fields keep their current value.\n * The palette is rebuilt lazily on the next token read, and any mounted `<Root>`\n * re-injects the token block — no component re-render is involved, because every\n * color in the kit resolves through a CSS custom property.\n *\n * ```ts\n * setPaletteConfig({ hue: 200, themes: { danger: { hue: 12 } } });\n * ```\n *\n * Omitting a field keeps it; passing `undefined` **clears** it, so it goes back to\n * inheriting (per-theme) or to the shipped default (top level):\n *\n * ```ts\n * setPaletteConfig({ themes: { primary: { saturation: 90 } } }); // pin\n * setPaletteConfig({ themes: { primary: { saturation: undefined } } }); // inherit again\n * ```\n */\nexport function setPaletteConfig(config: PaletteConfig): void {\n  commit(mergeInput(input, config));\n}\n\n/** Drop all tuning and restore the palette the kit ships with. */\nexport function resetPaletteConfig(): void {\n  commit({});\n}\n\n/**\n * Force every token to re-resolve without changing the palette config.\n *\n * Only needed if you drive Glaze directly — `glaze.configure({ darkTone })` and\n * the like. Glaze invalidates its own caches, but the kit's token maps are\n * memoized against *this* module's version, so they need telling. Calling it\n * before the first paint is unnecessary; nothing has been resolved yet.\n */\nexport function invalidatePaletteTokens(): void {\n  version++;\n  listeners.forEach((listener) => listener());\n}\n\n/** The current config, with every field resolved to a concrete value. */\nexport function getPaletteConfig(): ResolvedPaletteConfig {\n  return resolved;\n}\n\n/**\n * The config **as set**, sparse — omitted fields are the ones still inheriting.\n *\n * {@link getPaletteConfig} resolves everything to concrete values, which loses the\n * distinction between \"explicitly 80\" and \"80 because it follows the brand\". A\n * settings UI needs that distinction to show an inherited value as inherited, and\n * to offer a way back:\n *\n * ```ts\n * const pinned = getPaletteConfigInput().themes?.primary?.saturation !== undefined;\n *\n * // Re-link it to the brand by clearing the field.\n * setPaletteConfig({ themes: { primary: { saturation: undefined } } });\n * ```\n */\nexport function getPaletteConfigInput(): PaletteConfig {\n  return input;\n}\n\n/**\n * Resolve a partial against the current config **without applying it**.\n *\n * Same merge semantics as {@link setPaletteConfig} — omitted fields keep their\n * current value, unset per-theme fields keep inheriting — but the store is not\n * touched and no listener fires. Used to render a palette the app is not\n * actually using, e.g. for a theme preview.\n */\nexport function resolvePaletteConfig(\n  config?: PaletteConfig,\n): ResolvedPaletteConfig {\n  if (!config) return resolved;\n\n  return resolveConfig(mergeInput(input, config));\n}\n\n/**\n * Increments whenever the resolved config changes. The token caches in\n * `./palette.ts`, `./colors.ts` and `./index.ts` compare against it instead of\n * memoizing forever — the same idiom Glaze uses for its own config version.\n */\nexport function getPaletteVersion(): number {\n  return version;\n}\n\n/** Subscribe to palette config changes. Returns an unsubscribe function. */\nexport function subscribePaletteConfig(listener: () => void): () => void {\n  listeners.add(listener);\n\n  return () => {\n    listeners.delete(listener);\n  };\n}\n\n// ============================================================================\n// React bindings\n// ============================================================================\n\n/**\n * Re-render on palette config changes. Returns the version, not the config, so\n * the snapshot is a primitive and React never warns about an uncached snapshot.\n */\nexport function usePaletteVersion(): number {\n  return useSyncExternalStore(\n    subscribePaletteConfig,\n    getPaletteVersion,\n    getPaletteVersion,\n  );\n}\n\n/**\n * Read and tune the palette from React, `useState`-style.\n *\n * ```tsx\n * const [palette, setPalette] = usePaletteConfig();\n *\n * <HueSlider\n *   value={palette.hue}\n *   onChange={(hue) => setPalette({ hue })}\n * />\n * ```\n *\n * The config is global process state, so every consumer of this hook — and every\n * mounted `<Root>` — sees the same palette.\n */\nexport function usePaletteConfig(): readonly [\n  ResolvedPaletteConfig,\n  (config: PaletteConfig) => void,\n] {\n  usePaletteVersion();\n\n  return [getPaletteConfig(), setPaletteConfig];\n}\n"],"mappings":"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"}
+{"version":3,"file":"palette-config.js","names":[],"sources":["../../src/tokens/palette-config.ts"],"sourcesContent":["import { useSyncExternalStore } from 'react';\n\n/**\n * Runtime configuration for the Glaze-generated color palette.\n *\n * The palette recipe itself lives in `./palette.ts`; this module owns only the\n * *seeds* it is built from, plus a version counter the token caches watch. It\n * deliberately imports nothing else — not the token modules, not `glaze` — so\n * there is no import cycle and no ordering hazard.\n *\n * Reading is free; writing rebuilds the palette on the next token read. See\n * `Getting Started/Theming` in Storybook for the full contract.\n */\n\n// ============================================================================\n// Default seeds\n// ============================================================================\n\n/** Brand hue. Drives the `default`, `primary`, `purple` and `special` themes. */\nexport const DEFAULT_HUE = 280.3;\nexport const DEFAULT_SUCCESS_HUE = 156.9;\nexport const DEFAULT_DANGER_HUE = 23.1;\nexport const DEFAULT_WARNING_HUE = 84.3;\nexport const DEFAULT_NOTE_HUE = 302.3;\n\n/** Seed saturation. Per-color `saturation` in the recipe is a 0–1 factor of it. */\nexport const DEFAULT_SATURATION = 80;\n\n// ============================================================================\n// Types\n// ============================================================================\n\n/** Hue / saturation seed override for one colored theme. */\nexport interface PaletteThemeSeed {\n  /** Hue in degrees (0–360). */\n  hue?: number;\n  /** Saturation (0–100). Defaults to the palette-level `saturation`. */\n  saturation?: number;\n}\n\n/**\n * The `code-*` syntax family takes a saturation and nothing else.\n *\n * Its hues are absolute literals by design, so syntax colors never rotate with the\n * brand — strings would collide with numbers the moment the brand went green. And\n * unlike every other theme, its saturation does **not** inherit the palette-level\n * one: the code palette is calibrated once and stays there, so re-seeding the app\n * cannot quietly wash out a code block.\n */\nexport interface PaletteCodeSeed {\n  /** Saturation (0–100). Defaults to {@link DEFAULT_SATURATION}, not to `saturation`. */\n  saturation?: number;\n}\n\n/** Names of the themes whose seeds can be overridden individually. */\nexport type PaletteThemeName =\n  | 'success'\n  | 'danger'\n  | 'warning'\n  | 'note'\n  | 'code';\n\n/**\n * Palette tuning. Every field is optional; omitted fields keep their default,\n * and per-theme fields left unset inherit the palette-level value.\n */\nexport interface PaletteConfig {\n  /**\n   * Accent hue in degrees (0–360) — the brand.\n   *\n   * Drives the `accent-*` family on every theme, `primary` / `purple` / `special`,\n   * and the brand-tinted odds and ends (`focus`, the loading faces, the disabled\n   * chip). Also the default for {@link PaletteConfig.baseHue}.\n   */\n  hue?: number;\n  /**\n   * Hue of the **base** zone in degrees (0–360): the neutral chrome — `surface`\n   * and its ladder, the `surface-text*` ramp, `border`, `placeholder`. Defaults to\n   * `hue`, so the chrome carries a faint tint of the brand unless you say otherwise.\n   *\n   * Splitting it lets the chrome sit on a different hue from the accent — a warm\n   * grey UI with a cool blue brand, say. Only the `default` theme is affected: a\n   * colored theme's tinted `surface` deliberately follows *its own* hue, because a\n   * danger banner should read as red.\n   */\n  baseHue?: number;\n  /**\n   * Seed saturation (0–100), and the fallback for every theme that does not set\n   * its own.\n   *\n   * One scale for the whole theme, by design. Every color's own `saturation` is a\n   * 0–1 factor of this seed — `surface` at 0.12, `border` at 0.175, the text ramp\n   * at 0.2, the accent family at ~1.0 — so moving it rescales the palette while\n   * keeping those proportions. Unlike hue, which is configured separately for the\n   * brand and for each status theme, saturation is deliberately not split: the\n   * ratio between a subtle surface tint and a saturated accent is part of the\n   * design.\n   */\n  saturation?: number;\n  /**\n   * Global. Widens the usable chroma range by relaxing the sRGB-safe limit,\n   * producing a softer, more even palette across hues. Glaze treats `pastel` as\n   * instance-level, so it is threaded into every theme.\n   */\n  pastel?: boolean;\n  /**\n   * Global. `'auto'` (the default) keeps the two-tier model: normal colors plus\n   * a separate high-contrast tier driven by `<html data-contrast=\"high\">` /\n   * `prefers-contrast: more`.\n   *\n   * A number (0–100) replaces that switch with a slider — and, because a manual\n   * level already carries the contrast preference, **drops the high-contrast\n   * tier entirely**. `0` reproduces the normal output and `100` the\n   * high-contrast output, bit for bit.\n   */\n  contrastLevel?: number | 'auto';\n  /** Per-theme seed overrides. */\n  themes?: {\n    success?: PaletteThemeSeed;\n    danger?: PaletteThemeSeed;\n    warning?: PaletteThemeSeed;\n    note?: PaletteThemeSeed;\n    code?: PaletteCodeSeed;\n  };\n}\n\n/** {@link PaletteConfig} with every field resolved to a concrete value. */\nexport interface ResolvedPaletteConfig {\n  hue: number;\n  baseHue: number;\n  saturation: number;\n  pastel: boolean;\n  contrastLevel: number | 'auto';\n  themes: {\n    success: { hue: number; saturation: number };\n    danger: { hue: number; saturation: number };\n    warning: { hue: number; saturation: number };\n    note: { hue: number; saturation: number };\n    code: { saturation: number };\n  };\n}\n\n// ============================================================================\n// Resolution\n// ============================================================================\n\nconst DEFAULT_THEME_HUES = {\n  success: DEFAULT_SUCCESS_HUE,\n  danger: DEFAULT_DANGER_HUE,\n  warning: DEFAULT_WARNING_HUE,\n  note: DEFAULT_NOTE_HUE,\n} as const;\n\nfunction resolveConfig(input: PaletteConfig): ResolvedPaletteConfig {\n  const saturation = input.saturation ?? DEFAULT_SATURATION;\n  const themes = input.themes ?? {};\n\n  const hue = input.hue ?? DEFAULT_HUE;\n\n  return {\n    hue,\n    baseHue: input.baseHue ?? hue,\n    saturation,\n    pastel: input.pastel ?? false,\n    contrastLevel: input.contrastLevel ?? 'auto',\n    themes: {\n      success: {\n        hue: themes.success?.hue ?? DEFAULT_THEME_HUES.success,\n        saturation: themes.success?.saturation ?? saturation,\n      },\n      danger: {\n        hue: themes.danger?.hue ?? DEFAULT_THEME_HUES.danger,\n        saturation: themes.danger?.saturation ?? saturation,\n      },\n      warning: {\n        hue: themes.warning?.hue ?? DEFAULT_THEME_HUES.warning,\n        saturation: themes.warning?.saturation ?? saturation,\n      },\n      note: {\n        hue: themes.note?.hue ?? DEFAULT_THEME_HUES.note,\n        saturation: themes.note?.saturation ?? saturation,\n      },\n      // Deliberately NOT `?? saturation`: the code palette is calibrated once and\n      // does not follow the palette-level seed. See `PaletteCodeSeed`.\n      code: { saturation: themes.code?.saturation ?? DEFAULT_SATURATION },\n    },\n  };\n}\n\n/**\n * The palette as it ships, with no tuning applied. Frozen — it is the baseline\n * every resolution falls back to, so a stray write to it would move the defaults\n * for the whole process.\n */\nexport const DEFAULT_PALETTE_CONFIG: ResolvedPaletteConfig = freezeConfig(\n  resolveConfig({}),\n);\n\n// ============================================================================\n// Store\n// ============================================================================\n\n/**\n * The last config *as written*, sparse — not the resolved one. Keeping the sparse\n * form is what makes inheritance live: a `saturation` with no `themes.danger.\n * saturation` beside it means danger genuinely follows the palette, rather than\n * having been frozen at whatever the palette read when it was set.\n */\nlet input: PaletteConfig = {};\nlet resolved: ResolvedPaletteConfig = DEFAULT_PALETTE_CONFIG;\nlet version = 0;\n\nconst listeners = new Set<() => void>();\n\nfunction mergeSeed<T extends PaletteThemeSeed | PaletteCodeSeed>(\n  base: T | undefined,\n  patch: T | undefined,\n): T | undefined {\n  if (!base) return patch;\n  // A patch that omits the theme entirely says nothing about it, so the base\n  // survives. Clearing one of its fields is `{ theme: { hue: undefined } }`.\n  if (!patch) return base;\n\n  return { ...base, ...patch };\n}\n\n/**\n * Layer a patch over a base config. Used by {@link resolvePaletteConfig} for\n * previews — *not* by {@link setPaletteConfig}, which replaces.\n */\nfunction mergeInput(base: PaletteConfig, patch: PaletteConfig): PaletteConfig {\n  const next: PaletteConfig = { ...base, ...patch };\n\n  if (base.themes || patch.themes) {\n    next.themes = {\n      success: mergeSeed(base.themes?.success, patch.themes?.success),\n      danger: mergeSeed(base.themes?.danger, patch.themes?.danger),\n      warning: mergeSeed(base.themes?.warning, patch.themes?.warning),\n      note: mergeSeed(base.themes?.note, patch.themes?.note),\n      code: mergeSeed(base.themes?.code, patch.themes?.code),\n    };\n  }\n\n  return next;\n}\n\nfunction isSameConfig(a: ResolvedPaletteConfig, b: ResolvedPaletteConfig) {\n  return (\n    a.hue === b.hue &&\n    a.baseHue === b.baseHue &&\n    a.saturation === b.saturation &&\n    a.pastel === b.pastel &&\n    a.contrastLevel === b.contrastLevel &&\n    a.themes.code.saturation === b.themes.code.saturation &&\n    (['success', 'danger', 'warning', 'note'] as const).every(\n      (name) =>\n        a.themes[name].hue === b.themes[name].hue &&\n        a.themes[name].saturation === b.themes[name].saturation,\n    )\n  );\n}\n\n/**\n * Which fields are *explicitly set*, as an order-independent signature.\n *\n * Two configs can resolve to identical values yet differ in which of those values\n * are pinned rather than inherited — pinning `primary.saturation` to the number it\n * already inherited is the obvious case. That difference is invisible to\n * {@link isSameConfig} but visible through {@link getPaletteConfigInput}, so it has\n * to count as a change or a settings UI reading it would never re-render.\n */\nfunction pinSignature(config: PaletteConfig): string {\n  const set = (value: unknown) => (value === undefined ? '0' : '1');\n\n  return [\n    set(config.hue),\n    set(config.baseHue),\n    set(config.saturation),\n    set(config.pastel),\n    set(config.contrastLevel),\n    set(config.themes?.code?.saturation),\n    ...(['success', 'danger', 'warning', 'note'] as const).flatMap((name) => [\n      set(config.themes?.[name]?.hue),\n      set(config.themes?.[name]?.saturation),\n    ]),\n  ].join('');\n}\n\n/**\n * Snapshot a config so the store owns it outright.\n *\n * Two hazards this closes. The caller's object stays theirs, so mutating it after\n * the call cannot desync `input` from `resolved`. And what we hand back from\n * {@link getPaletteConfig} / {@link getPaletteConfigInput} is frozen, so a caller\n * who writes to it gets a clear failure rather than silently corrupting the store\n * — the version would not bump, and every token cache would go on serving values\n * that no longer match the config.\n */\nfunction freezeConfig<T extends PaletteConfig | ResolvedPaletteConfig>(\n  config: T,\n): T {\n  const themes = config.themes;\n\n  if (themes) {\n    for (const seed of Object.values(themes)) {\n      if (seed) Object.freeze(seed);\n    }\n    Object.freeze(themes);\n  }\n\n  return Object.freeze(config);\n}\n\n/** {@link freezeConfig} on a copy, for a config we did not create ourselves. */\nfunction snapshotConfig(config: PaletteConfig): PaletteConfig {\n  const themes = config.themes;\n\n  return freezeConfig({\n    ...config,\n    ...(themes\n      ? {\n          themes: {\n            ...(themes.success ? { success: { ...themes.success } } : null),\n            ...(themes.danger ? { danger: { ...themes.danger } } : null),\n            ...(themes.warning ? { warning: { ...themes.warning } } : null),\n            ...(themes.note ? { note: { ...themes.note } } : null),\n            ...(themes.code ? { code: { ...themes.code } } : null),\n          },\n        }\n      : null),\n  });\n}\n\nfunction commit(nextInput: PaletteConfig) {\n  const nextResolved = resolveConfig(nextInput);\n\n  // Bail before bumping the version when nothing observable moved, so re-applying\n  // the same config — an inline `<Root palette={{ … }}>` literal on every\n  // render, a StrictMode double render — costs nothing.\n  if (\n    isSameConfig(resolved, nextResolved) &&\n    pinSignature(input) === pinSignature(nextInput)\n  ) {\n    return;\n  }\n\n  input = snapshotConfig(nextInput);\n  resolved = freezeConfig(nextResolved);\n  version++;\n\n  listeners.forEach((listener) => listener());\n}\n\n/**\n * Set the palette config.\n *\n * **Replaces**, like `useState` — the config you pass *is* the config, resolved\n * against the shipped defaults. Nothing accumulates, so a field you leave out is a\n * field you do not have: dropping a customization means dropping it from the\n * object, and re-applying the same object twice is the same as applying it once.\n *\n * ```ts\n * setPaletteConfig({ hue: 200, baseHue: 60 });\n * setPaletteConfig({ hue: 200 }); // baseHue is gone — back to inheriting `hue`\n * ```\n *\n * To adjust one field of the config already in place — a slider in a settings UI —\n * pass an updater. It receives the config as written, sparse, so spreading it\n * preserves which fields are pinned and which still inherit:\n *\n * ```ts\n * setPaletteConfig((config) => ({ ...config, hue: 200 }));\n * ```\n *\n * The palette is rebuilt lazily on the next token read, and any mounted `<Root>`\n * re-injects the token block — no component re-render is involved, because every\n * color in the kit resolves through a CSS custom property.\n */\nexport function setPaletteConfig(\n  config: PaletteConfig | ((previous: PaletteConfig) => PaletteConfig),\n): void {\n  commit(typeof config === 'function' ? config(input) : config);\n}\n\n/**\n * Drop all tuning and restore the palette the kit ships with. Identical to\n * `setPaletteConfig({})`; it exists to be readable at a call site.\n */\nexport function resetPaletteConfig(): void {\n  commit({});\n}\n\n/**\n * Force every token to re-resolve without changing the palette config.\n *\n * Only needed if you drive Glaze directly — `glaze.configure({ darkTone })` and\n * the like. Glaze invalidates its own caches, but the kit's token maps are\n * memoized against *this* module's version, so they need telling. Calling it\n * before the first paint is unnecessary; nothing has been resolved yet.\n */\nexport function invalidatePaletteTokens(): void {\n  version++;\n  listeners.forEach((listener) => listener());\n}\n\n/** The current config, with every field resolved to a concrete value. */\nexport function getPaletteConfig(): ResolvedPaletteConfig {\n  return resolved;\n}\n\n/**\n * The config **as set**, sparse — omitted fields are the ones still inheriting.\n *\n * {@link getPaletteConfig} resolves everything to concrete values, which loses the\n * distinction between \"explicitly 80\" and \"80 because it follows the brand\". A\n * settings UI needs that distinction to show an inherited value as inherited, and\n * to offer a way back:\n *\n * ```ts\n * const pinned = getPaletteConfigInput().baseHue !== undefined;\n *\n * // Re-link it to the brand by dropping the field.\n * setPaletteConfig(({ baseHue, ...config }) => config);\n * ```\n *\n * It is also the value handed to a {@link setPaletteConfig} updater.\n */\nexport function getPaletteConfigInput(): PaletteConfig {\n  return input;\n}\n\n/**\n * Resolve a patch **over** the current config, without applying it.\n *\n * This one layers, unlike {@link setPaletteConfig}: a preview wants \"the theme in\n * use, but in dark\", so the fields it does not mention have to come from the live\n * config rather than from the defaults. The store is not touched and no listener\n * fires.\n */\nexport function resolvePaletteConfig(\n  config?: PaletteConfig,\n): ResolvedPaletteConfig {\n  if (!config) return resolved;\n\n  return resolveConfig(mergeInput(input, config));\n}\n\n/**\n * Increments whenever the resolved config changes. The token caches in\n * `./palette.ts`, `./colors.ts` and `./index.ts` compare against it instead of\n * memoizing forever — the same idiom Glaze uses for its own config version.\n */\nexport function getPaletteVersion(): number {\n  return version;\n}\n\n/** Subscribe to palette config changes. Returns an unsubscribe function. */\nexport function subscribePaletteConfig(listener: () => void): () => void {\n  listeners.add(listener);\n\n  return () => {\n    listeners.delete(listener);\n  };\n}\n\n// ============================================================================\n// React bindings\n// ============================================================================\n\n/**\n * Re-render on palette config changes. Returns the version, not the config, so\n * the snapshot is a primitive and React never warns about an uncached snapshot.\n */\nexport function usePaletteVersion(): number {\n  return useSyncExternalStore(\n    subscribePaletteConfig,\n    getPaletteVersion,\n    getPaletteVersion,\n  );\n}\n\n/**\n * Read and tune the palette from React, `useState`-style — including the part\n * where the setter *replaces*. A control that changes one field wants the updater\n * form, or it will drop every other field:\n *\n * ```tsx\n * const [palette, setPalette] = usePaletteConfig();\n *\n * <HueSlider\n *   value={palette.hue}\n *   onChange={(hue) => setPalette((config) => ({ ...config, hue }))}\n * />\n * ```\n *\n * The first element is the *resolved* config, so `palette.hue` is always a number.\n * The updater's argument is the sparse one — see {@link getPaletteConfigInput}.\n *\n * The config is global process state, so every consumer of this hook — and every\n * mounted `<Root>` — sees the same palette.\n */\nexport function usePaletteConfig(): readonly [\n  ResolvedPaletteConfig,\n  typeof setPaletteConfig,\n] {\n  usePaletteVersion();\n\n  return [getPaletteConfig(), setPaletteConfig];\n}\n"],"mappings":"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"}

package/dist/tokens/palette.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-51c94b0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-7d79005 | Cube Dev Team */
 import { getPaletteConfig, getPaletteVersion, resolvePaletteConfig } from "./palette-config.js";
 import { lazyStyles } from "./lazy-styles.js";
 import { glaze } from "@tenphi/glaze";
@@ -625,7 +625,15 @@ const VARIANT_KEY = {
 	"dark:false": "dark",
 	"dark:true": "darkContrast"
 };
-/** Single-entry memo: all four variants of the last config rendered. */
+/**
+* Single-entry memo: all four variants of the last config rendered.
+*
+* Keyed on the palette version as well as the config, because the config is not
+* the only input — `buildPalette` also reads Glaze's own global config
+* (`darkTone`, `darkDesaturation`, the state map). A host that drives Glaze
+* directly and then calls `invalidatePaletteTokens()` bumps the version without
+* touching the config, and the region previews have to follow the document.
+*/
 let renderKey = null;
 let renderVariants = {};
 /**
@@ -643,7 +651,7 @@ let renderVariants = {};
 function renderPaletteTokens(options = {}) {
 	const { scheme = "light", highContrast = false, ...config } = options;
 	const resolved = resolvePaletteConfig(config);
-	const key = JSON.stringify(resolved);
+	const key = `${getPaletteVersion()}:${JSON.stringify(resolved)}`;
 	if (renderKey !== key) {
 		const previousLevel = glaze.getConfig().contrastLevel;
 		try {
@@ -662,11 +670,12 @@ function renderPaletteTokens(options = {}) {
 				format: "oklch",
 				modes
 			});
-			renderVariants = {};
-			for (const name of Object.keys(themed)) renderVariants[name] = {
+			const variants = {};
+			for (const name of Object.keys(themed)) variants[name] = {
 				...themed[name],
 				...pickCodeTokens(code[name] ?? {})
 			};
+			renderVariants = variants;
 			renderKey = key;
 		} finally {
 			glaze.configure({ contrastLevel: previousLevel });