@cube-dev/ui-kit 0.152.0 → 0.154.0

package/dist/tokens/colors.js

@@ -1,6 +1,9 @@
-/** @license MIT | @cube-dev/ui-kit v0.152.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.154.0 | Cube Dev Team */
+import { getPaletteVersion } from "./palette-config.js";
+import { BASE_TOKENS } from "./base.js";
 import { lazyStyles } from "./lazy-styles.js";
-import { getPaletteTokens } from "./palette.js";
+import { getPaletteTokens, renderPaletteTokens } from "./palette.js";
+import { SHADOW_TOKENS } from "./shadows.js";
 
 //#region src/tokens/colors.ts
 /**
@@ -91,22 +94,87 @@ const LEGACY_ALIASES = {
 /**
 * Combined color token map: Glaze-generated palette + legacy aliases.
 *
-* Deferred until first access so host apps can `glaze.configure(...)` after
-* importing the kit. Prefer {@link getColorTokens} in new code.
+* Memoized against the palette config version, so a runtime `setPaletteConfig()`
+* invalidates it while repeated reads stay free. Prefer {@link getColorTokens}
+* in new code.
 *
 * `#white` and `#black` are intentionally omitted — they are built-in
 * tasty named colors and resolve automatically.
 */
 let colorTokensCache = null;
+let cachedVersion = -1;
 function getColorTokens() {
-	if (!colorTokensCache) colorTokensCache = {
-		...getPaletteTokens(),
-		...LEGACY_ALIASES
-	};
+	const version = getPaletteVersion();
+	if (!colorTokensCache || cachedVersion !== version) {
+		colorTokensCache = {
+			...getPaletteTokens(),
+			...LEGACY_ALIASES
+		};
+		cachedVersion = version;
+	}
 	return colorTokensCache;
 }
 const COLOR_TOKENS = lazyStyles(getColorTokens);
+/**
+* Tokens that live outside the palette but whose *values* reference a palette
+* color, so a region preview has to re-declare them. Kept by reference, exactly
+* as `<Root>` declares them — see {@link renderColorTokens}.
+*
+* Sourced from `./shadows` and the scrollbar block of `./base`; if either grows a
+* new colour-referencing token, add it here too.
+*/
+const COLOR_DEPENDENT_TOKENS = {
+	...SHADOW_TOKENS,
+	"#scrollbar-thumb": BASE_TOKENS["#scrollbar-thumb"],
+	"#scrollbar-outline": BASE_TOKENS["#scrollbar-outline"],
+	"#scrollbar-bg": BASE_TOKENS["#scrollbar-bg"],
+	"#scrollbar-corner": BASE_TOKENS["#scrollbar-corner"]
+};
+/**
+* Render every UI Kit color for one config and one scheme, as flat literal
+* values ready to apply to a **region** via a tasty `tokens` prop.
+*
+* ```tsx
+* const preview = useMemo(
+*   () => renderColorTokens({ hue: 210, scheme: 'dark' }),
+*   [],
+* );
+*
+* <Block tokens={preview} fill="#surface" color="#surface-text">
+*   …renders in the previewed theme, inside a light page…
+* </Block>
+* ```
+*
+* Config fields merge over the *current* palette config, so
+* `renderColorTokens({ scheme: 'dark' })` previews the active theme in dark
+* without restating it. Nothing is applied globally — the live palette is
+* untouched.
+*
+* The legacy aliases are included **by reference** (`'#dark': '#surface-text'`),
+* not resolved: tasty re-declares them on the region, so each `var()` resolves
+* against that region's own overridden value. Resolving them here would instead
+* freeze them to the outer theme's colors.
+*
+* The shadow tokens and the scrollbar colors come along for the same reason: their
+* values embed a palette color (`$card-shadow` → `#shadow-md`, `#scrollbar-thumb`
+* → `#text.5`). They are declared on `<Root>`, so CSS has already substituted the
+* outer theme's colors into them by the time a region inherits — re-declaring them
+* here is what lets them re-resolve.
+*
+* Not included: typography, spacing, sizes and layout. Nothing in their values
+* references a color, so a region inherits them from `<Root>` unchanged.
+*
+* The result is memoized for the last config rendered, but callers driving this
+* from state should still `useMemo` — a rebuild resolves the whole palette.
+*/
+function renderColorTokens(options) {
+	return {
+		...renderPaletteTokens(options),
+		...LEGACY_ALIASES,
+		...COLOR_DEPENDENT_TOKENS
+	};
+}
 
 //#endregion
-export { COLOR_TOKENS, getColorTokens };
+export { COLOR_TOKENS, getColorTokens, renderColorTokens };
 //# sourceMappingURL=colors.js.map

package/dist/tokens/colors.js.map

@@ -1 +1 @@
-{"version":3,"file":"colors.js","names":[],"sources":["../../src/tokens/colors.ts"],"sourcesContent":["import { lazyStyles } from './lazy-styles';\nimport { getPaletteTokens } from './palette';\n\nimport type { Styles } from '@tenphi/tasty';\n\n/**\n * Color tokens with `#` prefix for tasty color definitions.\n *\n * The base values come from the Glaze-generated palette (`palette.ts`):\n * `#surface`, `#surface-text*`, `#border`, `#focus`, `#disabled`, `#pink`,\n * `#shadow-*`, `#overlay`, the unprefixed `#accent-*` family, and the per-theme\n * `#primary-*` / `#purple-*` / `#success-*` / `#danger-*` / `#warning-*` /\n * `#note-*` families.\n *\n * Each Glaze token is a state map (`{ '': '...', '@dark': '...', '@hc': '...' }`),\n * giving us light, dark, and high-contrast variants for free. The `@dark` /\n * `@hc` predefined states are wired up globally in `src/components/Root.tsx`.\n *\n * The aliases below preserve backward compatibility with every legacy\n * `#name` used across components, stories, and tests. Each alias resolves\n * to a current Glaze token via tasty's `#token` reference syntax.\n */\n\nconst LEGACY_ALIASES: Styles = {\n  // ---- Neutral text scale (legacy `#dark*`) ----\n  '#text': '#surface-text-soft',\n  '#dark': '#surface-text',\n  '#dark-01': '#surface-text',\n  '#dark-02': '#surface-text-soft',\n  '#dark-03': '#surface-text-soft-2',\n  '#dark-04': '#placeholder',\n  '#dark-05': '#border',\n\n  // Fixed-mode counterpart to `#dark`. Resolves to the same L≈12 surface\n  // but uses Glaze `mode: 'fixed'` so it does NOT invert in dark schemes.\n  // Use this whenever the design intentionally pins a dark color regardless\n  // of scheme. Points at `#special-surface` (`mode: 'fixed'`, L=12),\n  // emitted by the standalone `specialTheme` in `palette.ts` — the canonical\n  // source of fixed-mode color tokens for `special`-variant components.\n  '#fixed-dark': '#special-surface',\n\n  // Fixed-mode counterpart to `#primary-text`. `#primary-text` is anchored\n  // to `surface` with `mode: 'auto'`, so it flips to a *light* purple in\n  // dark schemes (correct on body content, which also inverts). When the\n  // local fill is a fixed color instead (an always-white pill, etc.), the\n  // adaptive text loses contrast (light purple on white) in dark mode.\n  // Points at `#special-accent-text` (`mode: 'fixed'`, cr 6–8.5 vs fixed\n  // white) — a dark purple readable on a white surface that stays put\n  // across schemes.\n  '#fixed-primary-text': '#special-accent-text',\n\n  // ---- Misc neutral ----\n  '#minor': '#surface-text-soft.65',\n  '#shadow': '#shadow-md',\n  '#light': '#surface-3',\n  '#dark-bg': '#surface-2',\n  '#clear': 'transparent',\n\n  // Pink: independent hue, scheme-static (no Glaze adaptation). Kept as a raw\n  // literal rather than folded into a theme — nothing in the palette emits this\n  // hue as a standalone token, and it is a documented public alias (see\n  // `Usage.docs.mdx`, `tasty.config.ts`, and the `pink` key in\n  // `tasty-augment.d.ts`), so dropping it would silently break consumer styles\n  // while the types still advertised it.\n  '#pink': 'okhsl(5 100% 67%)',\n\n  // ---- Disabled state aliases ----\n  // `#disabled-surface` and `#disabled-surface-text` are emitted directly by\n  // the Glaze palette (`palette.ts`) as scheme-symmetric, contrast-driven\n  // tokens — no alias needed here. `#disabled` stays as a brand-tinted\n  // backwards-compat anchor for the per-theme `#<theme>-disabled` aliases below.\n\n  // ---- Primary / Purple legacy ----\n  '#primary': '#primary-accent-surface',\n  '#primary-text': '#primary-accent-text',\n  '#primary-text-soft': '#primary-accent-text-soft',\n  '#primary-bg': '#primary-surface',\n  '#primary-icon': '#primary-accent-icon',\n  '#primary-hover': '#primary-accent-surface-hover',\n  '#primary-desaturated': '#primary-accent-surface-2',\n  '#primary-disabled': '#disabled',\n\n  '#purple': '#purple-accent-surface',\n  '#purple-text': '#purple-accent-text',\n  '#purple-text-soft': '#purple-accent-text-soft',\n  '#purple-bg': '#purple-surface',\n  '#purple-icon': '#purple-accent-icon',\n  '#purple-hover': '#purple-accent-surface-hover',\n  '#purple-disabled': '#disabled',\n\n  // Purple scale (gradient/accent shades) — mapped to the accent-surface ramp.\n  '#purple-01': '#purple-accent-surface',\n  '#purple-02': '#purple-accent-surface-2',\n  '#purple-03': '#purple-accent-surface-3',\n  '#purple-04': '#purple-surface',\n\n  // ---- Danger ----\n  '#danger': '#danger-accent-surface',\n  '#danger-text': '#danger-accent-text',\n  '#danger-text-soft': '#danger-accent-text-soft',\n  '#danger-bg': '#danger-surface',\n  '#danger-icon': '#danger-accent-icon',\n  '#danger-hover': '#danger-accent-surface-hover',\n  '#danger-desaturated': '#danger-accent-surface-2',\n  '#danger-disabled': '#disabled',\n\n  // ---- Success ----\n  '#success': '#success-accent-surface',\n  '#success-text': '#success-accent-text',\n  '#success-text-soft': '#success-accent-text-soft',\n  '#success-bg': '#success-surface',\n  '#success-icon': '#success-accent-icon',\n  '#success-hover': '#success-accent-surface-hover',\n  '#success-desaturated': '#success-accent-surface-2',\n  '#success-disabled': '#disabled',\n\n  // ---- Warning ----\n  '#warning': '#warning-accent-surface',\n  '#warning-text': '#warning-accent-text',\n  '#warning-text-soft': '#warning-accent-text-soft',\n  '#warning-bg': '#warning-surface',\n  '#warning-icon': '#warning-accent-icon',\n  '#warning-hover': '#warning-accent-surface-hover',\n  '#warning-desaturated': '#warning-accent-surface-2',\n  '#warning-disabled': '#disabled',\n\n  // ---- Note ----\n  '#note': '#note-accent-surface',\n  '#note-text': '#note-accent-text',\n  '#note-text-soft': '#note-accent-text-soft',\n  '#note-bg': '#note-surface',\n  '#note-icon': '#note-accent-icon',\n  '#note-hover': '#note-accent-surface-hover',\n  '#note-desaturated': '#note-accent-surface-2',\n  '#note-disabled': '#disabled',\n};\n\n/**\n * Combined color token map: Glaze-generated palette + legacy aliases.\n *\n * Deferred until first access so host apps can `glaze.configure(...)` after\n * importing the kit. Prefer {@link getColorTokens} in new code.\n *\n * `#white` and `#black` are intentionally omitted — they are built-in\n * tasty named colors and resolve automatically.\n */\nlet colorTokensCache: Styles | null = null;\n\nexport function getColorTokens(): Styles {\n  if (!colorTokensCache) {\n    colorTokensCache = {\n      ...getPaletteTokens(),\n      ...LEGACY_ALIASES,\n    };\n  }\n  return colorTokensCache;\n}\n\nexport const COLOR_TOKENS: Styles = lazyStyles(getColorTokens);\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;AAuBA,MAAM,iBAAyB;CAE7B,SAAS;CACT,SAAS;CACT,YAAY;CACZ,YAAY;CACZ,YAAY;CACZ,YAAY;CACZ,YAAY;CAQZ,eAAe;CAUf,uBAAuB;CAGvB,UAAU;CACV,WAAW;CACX,UAAU;CACV,YAAY;CACZ,UAAU;CAQV,SAAS;CAST,YAAY;CACZ,iBAAiB;CACjB,sBAAsB;CACtB,eAAe;CACf,iBAAiB;CACjB,kBAAkB;CAClB,wBAAwB;CACxB,qBAAqB;CAErB,WAAW;CACX,gBAAgB;CAChB,qBAAqB;CACrB,cAAc;CACd,gBAAgB;CAChB,iBAAiB;CACjB,oBAAoB;CAGpB,cAAc;CACd,cAAc;CACd,cAAc;CACd,cAAc;CAGd,WAAW;CACX,gBAAgB;CAChB,qBAAqB;CACrB,cAAc;CACd,gBAAgB;CAChB,iBAAiB;CACjB,uBAAuB;CACvB,oBAAoB;CAGpB,YAAY;CACZ,iBAAiB;CACjB,sBAAsB;CACtB,eAAe;CACf,iBAAiB;CACjB,kBAAkB;CAClB,wBAAwB;CACxB,qBAAqB;CAGrB,YAAY;CACZ,iBAAiB;CACjB,sBAAsB;CACtB,eAAe;CACf,iBAAiB;CACjB,kBAAkB;CAClB,wBAAwB;CACxB,qBAAqB;CAGrB,SAAS;CACT,cAAc;CACd,mBAAmB;CACnB,YAAY;CACZ,cAAc;CACd,eAAe;CACf,qBAAqB;CACrB,kBAAkB;CACnB;;;;;;;;;;AAWD,IAAI,mBAAkC;AAEtC,SAAgB,iBAAyB;AACvC,KAAI,CAAC,iBACH,oBAAmB;EACjB,GAAG,kBAAkB;EACrB,GAAG;EACJ;AAEH,QAAO;;AAGT,MAAa,eAAuB,WAAW,eAAe"}
+{"version":3,"file":"colors.js","names":[],"sources":["../../src/tokens/colors.ts"],"sourcesContent":["import { BASE_TOKENS } from './base';\nimport { lazyStyles } from './lazy-styles';\nimport { getPaletteTokens, renderPaletteTokens } from './palette';\nimport { getPaletteVersion } from './palette-config';\nimport { SHADOW_TOKENS } from './shadows';\n\nimport type { Styles, Tokens } from '@tenphi/tasty';\nimport type { RenderPaletteOptions } from './palette';\n\n/**\n * Color tokens with `#` prefix for tasty color definitions.\n *\n * The base values come from the Glaze-generated palette (`palette.ts`):\n * `#surface`, `#surface-text*`, `#border`, `#focus`, `#disabled`, `#pink`,\n * `#shadow-*`, `#overlay`, the unprefixed `#accent-*` family, and the per-theme\n * `#primary-*` / `#purple-*` / `#success-*` / `#danger-*` / `#warning-*` /\n * `#note-*` families.\n *\n * Each Glaze token is a state map (`{ '': '...', '@dark': '...', '@hc': '...' }`),\n * giving us light, dark, and high-contrast variants for free. The `@dark` /\n * `@hc` predefined states are wired up globally in `src/components/Root.tsx`.\n *\n * The aliases below preserve backward compatibility with every legacy\n * `#name` used across components, stories, and tests. Each alias resolves\n * to a current Glaze token via tasty's `#token` reference syntax.\n */\n\nconst LEGACY_ALIASES: Styles = {\n  // ---- Neutral text scale (legacy `#dark*`) ----\n  '#text': '#surface-text-soft',\n  '#dark': '#surface-text',\n  '#dark-01': '#surface-text',\n  '#dark-02': '#surface-text-soft',\n  '#dark-03': '#surface-text-soft-2',\n  '#dark-04': '#placeholder',\n  '#dark-05': '#border',\n\n  // Fixed-mode counterpart to `#dark`. Resolves to the same L≈12 surface\n  // but uses Glaze `mode: 'fixed'` so it does NOT invert in dark schemes.\n  // Use this whenever the design intentionally pins a dark color regardless\n  // of scheme. Points at `#special-surface` (`mode: 'fixed'`, L=12),\n  // emitted by the standalone `specialTheme` in `palette.ts` — the canonical\n  // source of fixed-mode color tokens for `special`-variant components.\n  '#fixed-dark': '#special-surface',\n\n  // Fixed-mode counterpart to `#primary-text`. `#primary-text` is anchored\n  // to `surface` with `mode: 'auto'`, so it flips to a *light* purple in\n  // dark schemes (correct on body content, which also inverts). When the\n  // local fill is a fixed color instead (an always-white pill, etc.), the\n  // adaptive text loses contrast (light purple on white) in dark mode.\n  // Points at `#special-accent-text` (`mode: 'fixed'`, cr 6–8.5 vs fixed\n  // white) — a dark purple readable on a white surface that stays put\n  // across schemes.\n  '#fixed-primary-text': '#special-accent-text',\n\n  // ---- Misc neutral ----\n  '#minor': '#surface-text-soft.65',\n  '#shadow': '#shadow-md',\n  '#light': '#surface-3',\n  '#dark-bg': '#surface-2',\n  '#clear': 'transparent',\n\n  // Pink: independent hue, scheme-static (no Glaze adaptation). Kept as a raw\n  // literal rather than folded into a theme — nothing in the palette emits this\n  // hue as a standalone token, and it is a documented public alias (see\n  // `Usage.docs.mdx`, `tasty.config.ts`, and the `pink` key in\n  // `tasty-augment.d.ts`), so dropping it would silently break consumer styles\n  // while the types still advertised it.\n  '#pink': 'okhsl(5 100% 67%)',\n\n  // ---- Disabled state aliases ----\n  // `#disabled-surface` and `#disabled-surface-text` are emitted directly by\n  // the Glaze palette (`palette.ts`) as scheme-symmetric, contrast-driven\n  // tokens — no alias needed here. `#disabled` stays as a brand-tinted\n  // backwards-compat anchor for the per-theme `#<theme>-disabled` aliases below.\n\n  // ---- Primary / Purple legacy ----\n  '#primary': '#primary-accent-surface',\n  '#primary-text': '#primary-accent-text',\n  '#primary-text-soft': '#primary-accent-text-soft',\n  '#primary-bg': '#primary-surface',\n  '#primary-icon': '#primary-accent-icon',\n  '#primary-hover': '#primary-accent-surface-hover',\n  '#primary-desaturated': '#primary-accent-surface-2',\n  '#primary-disabled': '#disabled',\n\n  '#purple': '#purple-accent-surface',\n  '#purple-text': '#purple-accent-text',\n  '#purple-text-soft': '#purple-accent-text-soft',\n  '#purple-bg': '#purple-surface',\n  '#purple-icon': '#purple-accent-icon',\n  '#purple-hover': '#purple-accent-surface-hover',\n  '#purple-disabled': '#disabled',\n\n  // Purple scale (gradient/accent shades) — mapped to the accent-surface ramp.\n  '#purple-01': '#purple-accent-surface',\n  '#purple-02': '#purple-accent-surface-2',\n  '#purple-03': '#purple-accent-surface-3',\n  '#purple-04': '#purple-surface',\n\n  // ---- Danger ----\n  '#danger': '#danger-accent-surface',\n  '#danger-text': '#danger-accent-text',\n  '#danger-text-soft': '#danger-accent-text-soft',\n  '#danger-bg': '#danger-surface',\n  '#danger-icon': '#danger-accent-icon',\n  '#danger-hover': '#danger-accent-surface-hover',\n  '#danger-desaturated': '#danger-accent-surface-2',\n  '#danger-disabled': '#disabled',\n\n  // ---- Success ----\n  '#success': '#success-accent-surface',\n  '#success-text': '#success-accent-text',\n  '#success-text-soft': '#success-accent-text-soft',\n  '#success-bg': '#success-surface',\n  '#success-icon': '#success-accent-icon',\n  '#success-hover': '#success-accent-surface-hover',\n  '#success-desaturated': '#success-accent-surface-2',\n  '#success-disabled': '#disabled',\n\n  // ---- Warning ----\n  '#warning': '#warning-accent-surface',\n  '#warning-text': '#warning-accent-text',\n  '#warning-text-soft': '#warning-accent-text-soft',\n  '#warning-bg': '#warning-surface',\n  '#warning-icon': '#warning-accent-icon',\n  '#warning-hover': '#warning-accent-surface-hover',\n  '#warning-desaturated': '#warning-accent-surface-2',\n  '#warning-disabled': '#disabled',\n\n  // ---- Note ----\n  '#note': '#note-accent-surface',\n  '#note-text': '#note-accent-text',\n  '#note-text-soft': '#note-accent-text-soft',\n  '#note-bg': '#note-surface',\n  '#note-icon': '#note-accent-icon',\n  '#note-hover': '#note-accent-surface-hover',\n  '#note-desaturated': '#note-accent-surface-2',\n  '#note-disabled': '#disabled',\n};\n\n/**\n * Combined color token map: Glaze-generated palette + legacy aliases.\n *\n * Memoized against the palette config version, so a runtime `setPaletteConfig()`\n * invalidates it while repeated reads stay free. Prefer {@link getColorTokens}\n * in new code.\n *\n * `#white` and `#black` are intentionally omitted — they are built-in\n * tasty named colors and resolve automatically.\n */\nlet colorTokensCache: Styles | null = null;\nlet cachedVersion = -1;\n\nexport function getColorTokens(): Styles {\n  const version = getPaletteVersion();\n\n  if (!colorTokensCache || cachedVersion !== version) {\n    colorTokensCache = {\n      ...getPaletteTokens(),\n      ...LEGACY_ALIASES,\n    };\n    cachedVersion = version;\n  }\n  return colorTokensCache;\n}\n\nexport const COLOR_TOKENS: Styles = lazyStyles(getColorTokens);\n\n/**\n * Tokens that live outside the palette but whose *values* reference a palette\n * color, so a region preview has to re-declare them. Kept by reference, exactly\n * as `<Root>` declares them — see {@link renderColorTokens}.\n *\n * Sourced from `./shadows` and the scrollbar block of `./base`; if either grows a\n * new colour-referencing token, add it here too.\n */\nconst COLOR_DEPENDENT_TOKENS: Styles = {\n  ...SHADOW_TOKENS,\n  '#scrollbar-thumb': BASE_TOKENS['#scrollbar-thumb'],\n  '#scrollbar-outline': BASE_TOKENS['#scrollbar-outline'],\n  '#scrollbar-bg': BASE_TOKENS['#scrollbar-bg'],\n  '#scrollbar-corner': BASE_TOKENS['#scrollbar-corner'],\n};\n\n/**\n * Render every UI Kit color for one config and one scheme, as flat literal\n * values ready to apply to a **region** via a tasty `tokens` prop.\n *\n * ```tsx\n * const preview = useMemo(\n *   () => renderColorTokens({ hue: 210, scheme: 'dark' }),\n *   [],\n * );\n *\n * <Block tokens={preview} fill=\"#surface\" color=\"#surface-text\">\n *   …renders in the previewed theme, inside a light page…\n * </Block>\n * ```\n *\n * Config fields merge over the *current* palette config, so\n * `renderColorTokens({ scheme: 'dark' })` previews the active theme in dark\n * without restating it. Nothing is applied globally — the live palette is\n * untouched.\n *\n * The legacy aliases are included **by reference** (`'#dark': '#surface-text'`),\n * not resolved: tasty re-declares them on the region, so each `var()` resolves\n * against that region's own overridden value. Resolving them here would instead\n * freeze them to the outer theme's colors.\n *\n * The shadow tokens and the scrollbar colors come along for the same reason: their\n * values embed a palette color (`$card-shadow` → `#shadow-md`, `#scrollbar-thumb`\n * → `#text.5`). They are declared on `<Root>`, so CSS has already substituted the\n * outer theme's colors into them by the time a region inherits — re-declaring them\n * here is what lets them re-resolve.\n *\n * Not included: typography, spacing, sizes and layout. Nothing in their values\n * references a color, so a region inherits them from `<Root>` unchanged.\n *\n * The result is memoized for the last config rendered, but callers driving this\n * from state should still `useMemo` — a rebuild resolves the whole palette.\n */\nexport function renderColorTokens(options?: RenderPaletteOptions): Tokens {\n  return {\n    ...renderPaletteTokens(options),\n    ...(LEGACY_ALIASES as Tokens),\n    ...(COLOR_DEPENDENT_TOKENS as Tokens),\n  };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;AA2BA,MAAM,iBAAyB;CAE7B,SAAS;CACT,SAAS;CACT,YAAY;CACZ,YAAY;CACZ,YAAY;CACZ,YAAY;CACZ,YAAY;CAQZ,eAAe;CAUf,uBAAuB;CAGvB,UAAU;CACV,WAAW;CACX,UAAU;CACV,YAAY;CACZ,UAAU;CAQV,SAAS;CAST,YAAY;CACZ,iBAAiB;CACjB,sBAAsB;CACtB,eAAe;CACf,iBAAiB;CACjB,kBAAkB;CAClB,wBAAwB;CACxB,qBAAqB;CAErB,WAAW;CACX,gBAAgB;CAChB,qBAAqB;CACrB,cAAc;CACd,gBAAgB;CAChB,iBAAiB;CACjB,oBAAoB;CAGpB,cAAc;CACd,cAAc;CACd,cAAc;CACd,cAAc;CAGd,WAAW;CACX,gBAAgB;CAChB,qBAAqB;CACrB,cAAc;CACd,gBAAgB;CAChB,iBAAiB;CACjB,uBAAuB;CACvB,oBAAoB;CAGpB,YAAY;CACZ,iBAAiB;CACjB,sBAAsB;CACtB,eAAe;CACf,iBAAiB;CACjB,kBAAkB;CAClB,wBAAwB;CACxB,qBAAqB;CAGrB,YAAY;CACZ,iBAAiB;CACjB,sBAAsB;CACtB,eAAe;CACf,iBAAiB;CACjB,kBAAkB;CAClB,wBAAwB;CACxB,qBAAqB;CAGrB,SAAS;CACT,cAAc;CACd,mBAAmB;CACnB,YAAY;CACZ,cAAc;CACd,eAAe;CACf,qBAAqB;CACrB,kBAAkB;CACnB;;;;;;;;;;;AAYD,IAAI,mBAAkC;AACtC,IAAI,gBAAgB;AAEpB,SAAgB,iBAAyB;CACvC,MAAM,UAAU,mBAAmB;AAEnC,KAAI,CAAC,oBAAoB,kBAAkB,SAAS;AAClD,qBAAmB;GACjB,GAAG,kBAAkB;GACrB,GAAG;GACJ;AACD,kBAAgB;;AAElB,QAAO;;AAGT,MAAa,eAAuB,WAAW,eAAe;;;;;;;;;AAU9D,MAAM,yBAAiC;CACrC,GAAG;CACH,oBAAoB,YAAY;CAChC,sBAAsB,YAAY;CAClC,iBAAiB,YAAY;CAC7B,qBAAqB,YAAY;CAClC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAuCD,SAAgB,kBAAkB,SAAwC;AACxE,QAAO;EACL,GAAG,oBAAoB,QAAQ;EAC/B,GAAI;EACJ,GAAI;EACL"}

package/dist/tokens/index.d.ts

@@ -1,7 +1,8 @@
 
+import { DEFAULT_PALETTE_CONFIG, PaletteCodeSeed, PaletteConfig, PaletteThemeName, PaletteThemeSeed, ResolvedPaletteConfig, getPaletteConfig, getPaletteConfigInput, invalidatePaletteTokens, resetPaletteConfig, resolvePaletteConfig, setPaletteConfig, subscribePaletteConfig, usePaletteConfig, usePaletteVersion } from "./palette-config.js";
 import { SIZES, SIZE_NAME_TO_KEY, SIZE_TOKENS, SizeKey, SizeName } from "./sizes.js";
-import { COLOR_TOKENS, getColorTokens } from "./colors.js";
-import { PALETTE_TOKENS, getPaletteTokens } from "./palette.js";
+import { PALETTE_TOKENS, RenderPaletteOptions, getCodeTheme, getPalette, getPaletteTokens, renderPaletteTokens } from "./palette.js";
+import { COLOR_TOKENS, getColorTokens, renderColorTokens } from "./colors.js";
 import { SPACE_TOKENS } from "./spacing.js";
 import { SHADOW_TOKENS } from "./shadows.js";
 import { LAYOUT_TOKENS } from "./layout.js";

package/dist/tokens/index.js

@@ -1,10 +1,11 @@
-/** @license MIT | @cube-dev/ui-kit v0.152.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.154.0 | 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";
-import { PALETTE_TOKENS, getPaletteTokens } from "./palette.js";
-import { COLOR_TOKENS, getColorTokens } from "./colors.js";
-import { LAYOUT_TOKENS } from "./layout.js";
+import { PALETTE_TOKENS, getCodeTheme, getPalette, getPaletteTokens, renderPaletteTokens } from "./palette.js";
 import { SHADOW_TOKENS } from "./shadows.js";
+import { COLOR_TOKENS, getColorTokens, renderColorTokens } from "./colors.js";
+import { LAYOUT_TOKENS } from "./layout.js";
 import { SIZES, SIZE_NAME_TO_KEY, SIZE_TOKENS } from "./sizes.js";
 import { SPACE_TOKENS } from "./spacing.js";
 import { TYPOGRAPHY_PRESETS } from "./typography.js";
@@ -30,9 +31,10 @@ import { generateTypographyTokens } from "@tenphi/tasty";
 * All design tokens combined into a single Styles object.
 * Keys use $ prefix for CSS custom properties.
 *
-* Color tokens resolve against the live glaze config on first call (see
-* {@link getColorTokens}). Prefer this over the lazy {@link TOKENS} proxy
-* when applying styles from React (`GlobalStyles`).
+* Color tokens resolve against the current palette config (see
+* {@link getColorTokens}), and this map is memoized against that config's
+* version so `setPaletteConfig()` invalidates it. Prefer this over the lazy
+* {@link TOKENS} proxy when applying styles from React (`GlobalStyles`).
 *
 * Includes:
 * - Base tokens ($gap, $radius, etc.)
@@ -44,16 +46,21 @@ import { generateTypographyTokens } from "@tenphi/tasty";
 * - Color tokens ($purple-color, $purple-color-rgb, etc.)
 */
 let tokensCache = null;
+let cachedVersion = -1;
 function getTokens() {
-	if (!tokensCache) tokensCache = {
-		...BASE_TOKENS,
-		...SPACE_TOKENS,
-		...SIZE_TOKENS,
-		...SHADOW_TOKENS,
-		...LAYOUT_TOKENS,
-		...generateTypographyTokens(TYPOGRAPHY_PRESETS),
-		...getColorTokens()
-	};
+	const version = getPaletteVersion();
+	if (!tokensCache || cachedVersion !== version) {
+		tokensCache = {
+			...BASE_TOKENS,
+			...SPACE_TOKENS,
+			...SIZE_TOKENS,
+			...SHADOW_TOKENS,
+			...LAYOUT_TOKENS,
+			...generateTypographyTokens(TYPOGRAPHY_PRESETS),
+			...getColorTokens()
+		};
+		cachedVersion = version;
+	}
 	return tokensCache;
 }
 /** Lazy proxy of {@link getTokens}. Prefer `getTokens()` in new code. */

package/dist/tokens/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../../src/tokens/index.ts"],"sourcesContent":["/**\n * Design tokens for the Cube UI Kit.\n *\n * This module exports all design tokens used throughout the design system.\n * All token keys use $ prefix for CSS custom properties.\n *\n * Categories:\n * - Colors: Base color palette with -color and -color-rgb variants\n * - Typography: Font presets for headings, text, paragraphs, etc.\n * - Sizes: Component size values (XS, SM, MD, LG, XL)\n * - Spacing: Space tokens using gap multipliers\n * - Shadows: Shadow definitions for elevation\n * - Layout: Common layout dimensions\n * - Base: Core design system values\n */\n\nimport { generateTypographyTokens } from '@tenphi/tasty';\n\nimport { BASE_TOKENS } from './base';\nimport { getColorTokens } from './colors';\nimport { LAYOUT_TOKENS } from './layout';\nimport { lazyStyles } from './lazy-styles';\nimport { SHADOW_TOKENS } from './shadows';\nimport { SIZE_TOKENS } from './sizes';\nimport { SPACE_TOKENS } from './spacing';\nimport { TYPOGRAPHY_PRESETS } from './typography';\n\nimport type { Styles } from '@tenphi/tasty';\nimport type { SizeKey, SizeName } from './sizes';\n\n/**\n * All design tokens combined into a single Styles object.\n * Keys use $ prefix for CSS custom properties.\n *\n * Color tokens resolve against the live glaze config on first call (see\n * {@link getColorTokens}). Prefer this over the lazy {@link TOKENS} proxy\n * when applying styles from React (`GlobalStyles`).\n *\n * Includes:\n * - Base tokens ($gap, $radius, etc.)\n * - Space tokens ($space-xs, $space-sm, etc.)\n * - Size tokens ($size-xs, $size-sm, etc.)\n * - Shadow tokens ($shadow, $item-shadow, etc.)\n * - Layout tokens ($max-content-width, $topbar-height, etc.)\n * - Typography tokens ($h1-font-size, $t3-line-height, etc.)\n * - Color tokens ($purple-color, $purple-color-rgb, etc.)\n */\nlet tokensCache: Styles | null = null;\n\nexport function getTokens(): Styles {\n  if (!tokensCache) {\n    tokensCache = {\n      ...BASE_TOKENS,\n      ...SPACE_TOKENS,\n      ...SIZE_TOKENS,\n      ...SHADOW_TOKENS,\n      ...LAYOUT_TOKENS,\n      ...generateTypographyTokens(TYPOGRAPHY_PRESETS),\n      ...getColorTokens(),\n    };\n  }\n  return tokensCache;\n}\n\n/** Lazy proxy of {@link getTokens}. Prefer `getTokens()` in new code. */\nexport const TOKENS: Styles = lazyStyles(getTokens);\n\n// Re-export category modules for direct access\nexport { COLOR_TOKENS, getColorTokens } from './colors';\nexport { getPaletteTokens, PALETTE_TOKENS } from './palette';\nexport { SIZES, SIZE_NAME_TO_KEY, SIZE_TOKENS } from './sizes';\nexport type { SizeKey, SizeName } from './sizes';\nexport { SPACE_TOKENS } from './spacing';\nexport { SHADOW_TOKENS } from './shadows';\nexport { LAYOUT_TOKENS } from './layout';\nexport { BASE_TOKENS } from './base';\nexport { TYPOGRAPHY_PRESETS } from './typography';\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA+CA,IAAI,cAA6B;AAEjC,SAAgB,YAAoB;AAClC,KAAI,CAAC,YACH,eAAc;EACZ,GAAG;EACH,GAAG;EACH,GAAG;EACH,GAAG;EACH,GAAG;EACH,GAAG,yBAAyB,mBAAmB;EAC/C,GAAG,gBAAgB;EACpB;AAEH,QAAO;;;AAIT,MAAa,SAAiB,WAAW,UAAU"}
+{"version":3,"file":"index.js","names":[],"sources":["../../src/tokens/index.ts"],"sourcesContent":["/**\n * Design tokens for the Cube UI Kit.\n *\n * This module exports all design tokens used throughout the design system.\n * All token keys use $ prefix for CSS custom properties.\n *\n * Categories:\n * - Colors: Base color palette with -color and -color-rgb variants\n * - Typography: Font presets for headings, text, paragraphs, etc.\n * - Sizes: Component size values (XS, SM, MD, LG, XL)\n * - Spacing: Space tokens using gap multipliers\n * - Shadows: Shadow definitions for elevation\n * - Layout: Common layout dimensions\n * - Base: Core design system values\n */\n\nimport { generateTypographyTokens } from '@tenphi/tasty';\n\nimport { BASE_TOKENS } from './base';\nimport { getColorTokens } from './colors';\nimport { LAYOUT_TOKENS } from './layout';\nimport { lazyStyles } from './lazy-styles';\nimport { getPaletteVersion } from './palette-config';\nimport { SHADOW_TOKENS } from './shadows';\nimport { SIZE_TOKENS } from './sizes';\nimport { SPACE_TOKENS } from './spacing';\nimport { TYPOGRAPHY_PRESETS } from './typography';\n\nimport type { Styles } from '@tenphi/tasty';\nimport type { SizeKey, SizeName } from './sizes';\n\n/**\n * All design tokens combined into a single Styles object.\n * Keys use $ prefix for CSS custom properties.\n *\n * Color tokens resolve against the current palette config (see\n * {@link getColorTokens}), and this map is memoized against that config's\n * version so `setPaletteConfig()` invalidates it. Prefer this over the lazy\n * {@link TOKENS} proxy when applying styles from React (`GlobalStyles`).\n *\n * Includes:\n * - Base tokens ($gap, $radius, etc.)\n * - Space tokens ($space-xs, $space-sm, etc.)\n * - Size tokens ($size-xs, $size-sm, etc.)\n * - Shadow tokens ($shadow, $item-shadow, etc.)\n * - Layout tokens ($max-content-width, $topbar-height, etc.)\n * - Typography tokens ($h1-font-size, $t3-line-height, etc.)\n * - Color tokens ($purple-color, $purple-color-rgb, etc.)\n */\nlet tokensCache: Styles | null = null;\nlet cachedVersion = -1;\n\nexport function getTokens(): Styles {\n  const version = getPaletteVersion();\n\n  if (!tokensCache || cachedVersion !== version) {\n    tokensCache = {\n      ...BASE_TOKENS,\n      ...SPACE_TOKENS,\n      ...SIZE_TOKENS,\n      ...SHADOW_TOKENS,\n      ...LAYOUT_TOKENS,\n      ...generateTypographyTokens(TYPOGRAPHY_PRESETS),\n      ...getColorTokens(),\n    };\n    cachedVersion = version;\n  }\n  return tokensCache;\n}\n\n/** Lazy proxy of {@link getTokens}. Prefer `getTokens()` in new code. */\nexport const TOKENS: Styles = lazyStyles(getTokens);\n\n// Re-export category modules for direct access\nexport { COLOR_TOKENS, getColorTokens, renderColorTokens } from './colors';\nexport {\n  getCodeTheme,\n  getPalette,\n  getPaletteTokens,\n  PALETTE_TOKENS,\n  renderPaletteTokens,\n} from './palette';\nexport type { RenderPaletteOptions } from './palette';\nexport {\n  DEFAULT_PALETTE_CONFIG,\n  getPaletteConfig,\n  getPaletteConfigInput,\n  invalidatePaletteTokens,\n  resetPaletteConfig,\n  resolvePaletteConfig,\n  setPaletteConfig,\n  subscribePaletteConfig,\n  usePaletteConfig,\n  usePaletteVersion,\n} from './palette-config';\nexport type {\n  PaletteCodeSeed,\n  PaletteConfig,\n  PaletteThemeName,\n  PaletteThemeSeed,\n  ResolvedPaletteConfig,\n} from './palette-config';\nexport { SIZES, SIZE_NAME_TO_KEY, SIZE_TOKENS } from './sizes';\nexport type { SizeKey, SizeName } from './sizes';\nexport { SPACE_TOKENS } from './spacing';\nexport { SHADOW_TOKENS } from './shadows';\nexport { LAYOUT_TOKENS } from './layout';\nexport { BASE_TOKENS } from './base';\nexport { TYPOGRAPHY_PRESETS } from './typography';\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAiDA,IAAI,cAA6B;AACjC,IAAI,gBAAgB;AAEpB,SAAgB,YAAoB;CAClC,MAAM,UAAU,mBAAmB;AAEnC,KAAI,CAAC,eAAe,kBAAkB,SAAS;AAC7C,gBAAc;GACZ,GAAG;GACH,GAAG;GACH,GAAG;GACH,GAAG;GACH,GAAG;GACH,GAAG,yBAAyB,mBAAmB;GAC/C,GAAG,gBAAgB;GACpB;AACD,kBAAgB;;AAElB,QAAO;;;AAIT,MAAa,SAAiB,WAAW,UAAU"}

package/dist/tokens/layout.js

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

package/dist/tokens/lazy-styles.js

@@ -1,13 +1,17 @@
-/** @license MIT | @cube-dev/ui-kit v0.152.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.154.0 | Cube Dev Team */
 //#region src/tokens/lazy-styles.ts
 /**
-* Proxy that materializes a `Styles` map on first property / enumeration
-* access. Used so token exports stay import-safe while resolution can wait
-* until after a host app calls `glaze.configure(...)`.
+* Proxy that defers to `factory()` on every property / enumeration access.
+* Used so token exports stay import-safe while resolution waits until after a
+* host app calls `setPaletteConfig(...)` / `glaze.configure(...)`.
+*
+* The proxy holds no cache of its own — that is deliberate. Every factory here
+* memoizes against the palette config version, so delegating on each access is
+* what keeps these exports live when the palette is re-seeded at runtime. A
+* factory passed in must memoize.
 */
 function lazyStyles(factory) {
-	let cache;
-	const resolve = () => cache ??= factory();
+	const resolve = () => factory();
 	return new Proxy({}, {
 		get(_target, prop) {
 			if (prop === Symbol.toStringTag) return "Object";

package/dist/tokens/lazy-styles.js.map

@@ -1 +1 @@
-{"version":3,"file":"lazy-styles.js","names":[],"sources":["../../src/tokens/lazy-styles.ts"],"sourcesContent":["import type { Styles } from '@tenphi/tasty';\n\n/**\n * Proxy that materializes a `Styles` map on first property / enumeration\n * access. Used so token exports stay import-safe while resolution can wait\n * until after a host app calls `glaze.configure(...)`.\n */\nexport function lazyStyles(factory: () => Styles): Styles {\n  let cache: Styles | undefined;\n  const resolve = () => (cache ??= factory());\n  return new Proxy({} as Styles, {\n    get(_target, prop) {\n      if (prop === Symbol.toStringTag) return 'Object';\n      return Reflect.get(resolve(), prop);\n    },\n    ownKeys() {\n      return Reflect.ownKeys(resolve());\n    },\n    getOwnPropertyDescriptor(_target, prop) {\n      return Object.getOwnPropertyDescriptor(resolve(), prop);\n    },\n    has(_target, prop) {\n      return Reflect.has(resolve(), prop);\n    },\n    getPrototypeOf() {\n      return Object.prototype;\n    },\n  });\n}\n"],"mappings":";;;;;;;AAOA,SAAgB,WAAW,SAA+B;CACxD,IAAI;CACJ,MAAM,gBAAiB,UAAU,SAAS;AAC1C,QAAO,IAAI,MAAM,EAAE,EAAY;EAC7B,IAAI,SAAS,MAAM;AACjB,OAAI,SAAS,OAAO,YAAa,QAAO;AACxC,UAAO,QAAQ,IAAI,SAAS,EAAE,KAAK;;EAErC,UAAU;AACR,UAAO,QAAQ,QAAQ,SAAS,CAAC;;EAEnC,yBAAyB,SAAS,MAAM;AACtC,UAAO,OAAO,yBAAyB,SAAS,EAAE,KAAK;;EAEzD,IAAI,SAAS,MAAM;AACjB,UAAO,QAAQ,IAAI,SAAS,EAAE,KAAK;;EAErC,iBAAiB;AACf,UAAO,OAAO;;EAEjB,CAAC"}
+{"version":3,"file":"lazy-styles.js","names":[],"sources":["../../src/tokens/lazy-styles.ts"],"sourcesContent":["import type { Styles } from '@tenphi/tasty';\n\n/**\n * Proxy that defers to `factory()` on every property / enumeration access.\n * Used so token exports stay import-safe while resolution waits until after a\n * host app calls `setPaletteConfig(...)` / `glaze.configure(...)`.\n *\n * The proxy holds no cache of its own — that is deliberate. Every factory here\n * memoizes against the palette config version, so delegating on each access is\n * what keeps these exports live when the palette is re-seeded at runtime. A\n * factory passed in must memoize.\n */\nexport function lazyStyles(factory: () => Styles): Styles {\n  const resolve = () => factory();\n  return new Proxy({} as Styles, {\n    get(_target, prop) {\n      if (prop === Symbol.toStringTag) return 'Object';\n      return Reflect.get(resolve(), prop);\n    },\n    ownKeys() {\n      return Reflect.ownKeys(resolve());\n    },\n    getOwnPropertyDescriptor(_target, prop) {\n      return Object.getOwnPropertyDescriptor(resolve(), prop);\n    },\n    has(_target, prop) {\n      return Reflect.has(resolve(), prop);\n    },\n    getPrototypeOf() {\n      return Object.prototype;\n    },\n  });\n}\n"],"mappings":";;;;;;;;;;;;AAYA,SAAgB,WAAW,SAA+B;CACxD,MAAM,gBAAgB,SAAS;AAC/B,QAAO,IAAI,MAAM,EAAE,EAAY;EAC7B,IAAI,SAAS,MAAM;AACjB,OAAI,SAAS,OAAO,YAAa,QAAO;AACxC,UAAO,QAAQ,IAAI,SAAS,EAAE,KAAK;;EAErC,UAAU;AACR,UAAO,QAAQ,QAAQ,SAAS,CAAC;;EAEnC,yBAAyB,SAAS,MAAM;AACtC,UAAO,OAAO,yBAAyB,SAAS,EAAE,KAAK;;EAEzD,IAAI,SAAS,MAAM;AACjB,UAAO,QAAQ,IAAI,SAAS,EAAE,KAAK;;EAErC,iBAAiB;AACf,UAAO,OAAO;;EAEjB,CAAC"}

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

@@ -0,0 +1,222 @@
+
+//#region src/tokens/palette-config.d.ts
+/** Hue / saturation seed override for one colored theme. */
+interface PaletteThemeSeed {
+  /** Hue in degrees (0–360). */
+  hue?: number;
+  /** Saturation (0–100). Defaults to the palette-level `saturation`. */
+  saturation?: number;
+}
+/**
+ * The `code-*` syntax family takes a saturation and nothing else.
+ *
+ * Its hues are absolute literals by design, so syntax colors never rotate with the
+ * brand — strings would collide with numbers the moment the brand went green. And
+ * unlike every other theme, its saturation does **not** inherit the palette-level
+ * one: the code palette is calibrated once and stays there, so re-seeding the app
+ * cannot quietly wash out a code block.
+ */
+interface PaletteCodeSeed {
+  /** Saturation (0–100). Defaults to {@link DEFAULT_SATURATION}, not to `saturation`. */
+  saturation?: number;
+}
+/** Names of the themes whose seeds can be overridden individually. */
+type PaletteThemeName = 'success' | 'danger' | 'warning' | 'note' | 'code';
+/**
+ * Palette tuning. Every field is optional; omitted fields keep their default,
+ * and per-theme fields left unset inherit the palette-level value.
+ */
+interface PaletteConfig {
+  /**
+   * Accent hue in degrees (0–360) — the brand.
+   *
+   * Drives the `accent-*` family on every theme, `primary` / `purple` / `special`,
+   * and the brand-tinted odds and ends (`focus`, the loading faces, the disabled
+   * chip). Also the default for {@link PaletteConfig.baseHue}.
+   */
+  hue?: number;
+  /**
+   * Hue of the **base** zone in degrees (0–360): the neutral chrome — `surface`
+   * and its ladder, the `surface-text*` ramp, `border`, `placeholder`. Defaults to
+   * `hue`, so the chrome carries a faint tint of the brand unless you say otherwise.
+   *
+   * Splitting it lets the chrome sit on a different hue from the accent — a warm
+   * grey UI with a cool blue brand, say. Only the `default` theme is affected: a
+   * colored theme's tinted `surface` deliberately follows *its own* hue, because a
+   * danger banner should read as red.
+   */
+  baseHue?: number;
+  /**
+   * Seed saturation (0–100), and the fallback for every theme that does not set
+   * its own.
+   *
+   * One scale for the whole theme, by design. Every color's own `saturation` is a
+   * 0–1 factor of this seed — `surface` at 0.12, `border` at 0.175, the text ramp
+   * at 0.2, the accent family at ~1.0 — so moving it rescales the palette while
+   * keeping those proportions. Unlike hue, which is configured separately for the
+   * brand and for each status theme, saturation is deliberately not split: the
+   * ratio between a subtle surface tint and a saturated accent is part of the
+   * design.
+   */
+  saturation?: number;
+  /**
+   * Global. Widens the usable chroma range by relaxing the sRGB-safe limit,
+   * producing a softer, more even palette across hues. Glaze treats `pastel` as
+   * instance-level, so it is threaded into every theme.
+   */
+  pastel?: boolean;
+  /**
+   * Global. `'auto'` (the default) keeps the two-tier model: normal colors plus
+   * a separate high-contrast tier driven by `<html data-contrast="high">` /
+   * `prefers-contrast: more`.
+   *
+   * A number (0–100) replaces that switch with a slider — and, because a manual
+   * level already carries the contrast preference, **drops the high-contrast
+   * tier entirely**. `0` reproduces the normal output and `100` the
+   * high-contrast output, bit for bit.
+   */
+  contrastLevel?: number | 'auto';
+  /** Per-theme seed overrides. */
+  themes?: {
+    success?: PaletteThemeSeed;
+    danger?: PaletteThemeSeed;
+    warning?: PaletteThemeSeed;
+    note?: PaletteThemeSeed;
+    code?: PaletteCodeSeed;
+  };
+}
+/** {@link PaletteConfig} with every field resolved to a concrete value. */
+interface ResolvedPaletteConfig {
+  hue: number;
+  baseHue: number;
+  saturation: number;
+  pastel: boolean;
+  contrastLevel: number | 'auto';
+  themes: {
+    success: {
+      hue: number;
+      saturation: number;
+    };
+    danger: {
+      hue: number;
+      saturation: number;
+    };
+    warning: {
+      hue: number;
+      saturation: number;
+    };
+    note: {
+      hue: number;
+      saturation: number;
+    };
+    code: {
+      saturation: number;
+    };
+  };
+}
+/**
+ * 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;
+/**
+ * Set the palette config.
+ *
+ * **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, baseHue: 60 });
+ * setPaletteConfig({ hue: 200 }); // baseHue is gone — back to inheriting `hue`
+ * ```
+ *
+ * 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((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 resetPaletteConfig(): void;
+/**
+ * Force every token to re-resolve without changing the palette config.
+ *
+ * Only needed if you drive Glaze directly — `glaze.configure({ darkTone })` and
+ * the like. Glaze invalidates its own caches, but the kit's token maps are
+ * memoized against *this* module's version, so they need telling. Calling it
+ * before the first paint is unnecessary; nothing has been resolved yet.
+ */
+declare function invalidatePaletteTokens(): void;
+/** The current config, with every field resolved to a concrete value. */
+declare function getPaletteConfig(): ResolvedPaletteConfig;
+/**
+ * The config **as set**, sparse — omitted fields are the ones still inheriting.
+ *
+ * {@link getPaletteConfig} resolves everything to concrete values, which loses the
+ * distinction between "explicitly 80" and "80 because it follows the brand". A
+ * settings UI needs that distinction to show an inherited value as inherited, and
+ * to offer a way back:
+ *
+ * ```ts
+ * const pinned = getPaletteConfigInput().baseHue !== 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 patch **over** the current config, without applying it.
+ *
+ * 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. */
+declare function subscribePaletteConfig(listener: () => void): () => void;
+/**
+ * Re-render on palette config changes. Returns the version, not the config, so
+ * the snapshot is a primitive and React never warns about an uncached snapshot.
+ */
+declare function usePaletteVersion(): number;
+/**
+ * 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((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, 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