@tenphi/tasty 0.13.1 → 0.14.0

package/README.md

@@ -25,11 +25,11 @@ That guarantee unlocks a concise, CSS-like DSL where design tokens, custom units
 
 - **Deterministic at any scale** — Exclusive selector generation eliminates the entire class of cascade/specificity bugs. Every state combination resolves to exactly one CSS rule per property. Refactor freely. See [How It Actually Works](#how-it-actually-works).
 - **AI-friendly by design** — Style definitions are declarative, self-contained, and structurally consistent. AI tools can read, understand, and refactor even advanced state bindings as confidently as a human — because there's no hidden cascade logic or implicit ordering to second-guess.
-- **DSL that feels like CSS** — Property names you already know (`padding`, `color`, `display`) with syntax sugar that removes boilerplate. Learn the DSL in minutes, not days. See [Style Properties](docs/styles.md).
+- **DSL that feels like CSS** — Property names you already know (`padding`, `color`, `display`) with syntax sugar that removes boilerplate. Learn the DSL in minutes, not days. Start with the [Style DSL](docs/dsl.md), then use [Style Properties](docs/styles.md) as the handler reference.
 - **CSS properties as normal component props** — `styleProps` lets you expose selected styles as typed React props. Use `<Button placeSelf="end">` or `<Space flow="row" gap="2x">` without extra wrappers, utility classes, or `styles` overrides. The same props also accept state maps, so responsive values work with the same API. See [CSS properties as props](#css-properties-as-props).
-- **Design-system native** — Color tokens (`#primary`), spacing units (`2x`), typography presets (`h1`, `t2`), border radius (`1r`), and recipes are first-class primitives, not afterthoughts. See [Configuration](docs/configuration.md).
+- **Design-system native** — Color tokens (`#primary`), spacing units (`2x`), typography presets (`h1`, `t2`), border radius (`1r`), and recipes are first-class primitives, not afterthoughts. Built-in units and standard color values work out of the box, and [Configuration](docs/configuration.md) lets teams define shared conventions on top.
 - **Near-complete modern CSS coverage** — Media queries, container queries, `@supports`, `:has()`, `@starting-style`, `@property`, `@keyframes`, etc. Some features that don't fit Tasty's component model (such as `@layer` and `!important`) are intentionally omitted, but real-world use cases are covered almost completely.
-- **Runtime, zero-runtime, or SSR — your call** — Use `tasty()` for dynamic React components with runtime injection, `tastyStatic()` with the Babel plugin for zero-runtime CSS extraction, or enable SSR with zero-cost client hydration for Next.js, Astro, or any React framework (experimental). Same DSL, same tokens, same output.
+- **Runtime, zero-runtime, or SSR — your call** — Use `tasty()` for dynamic React components with runtime injection, `tastyStatic()` with the Babel plugin for zero-runtime CSS extraction, or enable SSR with zero-cost client hydration for Next.js, Astro, or any React framework. Same DSL, same tokens, same output.
 - **Only generate what is used** — In runtime mode, Tasty injects CSS on demand for mounted components/variants, so your app avoids shipping style rules for UI states that are never rendered.
 - **Runtime performance that holds at scale** — The runtime path is tested against enterprise-scale applications and tuned with multi-level caching, chunk-level style reuse, style garbage collection, and a dedicated injector.
 - **Composable and extensible by design** — Extend any component's styles with proper merge semantics, and evolve built-in behavior through configuration and plugins.
@@ -41,6 +41,35 @@ That guarantee unlocks a concise, CSS-like DSL where design tokens, custom units
 pnpm add @tenphi/tasty
 ```
 
+Requirements:
+
+- Node.js 20+
+- React 18+ (peer dependency for the React entry points)
+- `pnpm`, `npm`, or `yarn`
+
+Other package managers:
+
+```bash
+npm add @tenphi/tasty
+yarn add @tenphi/tasty
+```
+
+## Start Here
+
+- **[Getting Started](docs/getting-started.md)** — the canonical onboarding path: install, first component, optional shared `configure()`, ESLint, editor tooling, and rendering mode selection
+- **[Docs Hub](docs/README.md)** — choose docs by role and task: runtime, zero-runtime, SSR, design-system authoring, internals, and debugging
+- **[Methodology](docs/methodology.md)** — the recommended component model and public API conventions for design-system code
+
+## Choose a Rendering Mode
+
+| Mode | Entry point | Best for | Trade-off |
+|------|-------------|----------|-----------|
+| **Runtime** | `@tenphi/tasty` | Interactive apps and design systems | Full feature set; CSS is generated on demand at runtime |
+| **Zero-runtime** | `@tenphi/tasty/static` | Static sites, SSG, landing pages | Requires the Babel plugin; no component-level `styleProps` or runtime-only APIs |
+| **SSR** | `@tenphi/tasty/ssr/*` | Next.js, Astro, and other streaming React SSR setups | Uses runtime `tasty()` with server-collected CSS and hydration cache transfer |
+
+All three share the same DSL, tokens, units, and state mappings. See [Getting Started](docs/getting-started.md#choosing-a-rendering-mode), [Zero Runtime](docs/tasty-static.md), and [Server-Side Rendering](docs/ssr.md).
+
 ## Quick Start
 
 ### Create a styled component
@@ -55,8 +84,9 @@ const Card = tasty({
     flow: 'column',
     padding: '4x',
     gap: '2x',
-    fill: '#surface',
-    border: '#border bottom',
+    fill: 'okhsl(98% 0.02 255)',
+    color: 'okhsl(28% 0.03 255)',
+    border: 'okhsl(88% 0.02 255)',
     radius: '1r',
   },
 });
@@ -65,7 +95,9 @@ const Card = tasty({
 <Card>Hello World</Card>
 ```
 
-Every value maps to CSS you'd recognize — but with tokens and units that keep your design system consistent by default.
+Every value maps to CSS you'd recognize. This example is intentionally config-free: built-in units work immediately, and standard color values such as `rgb(...)`, `hsl(...)`, named colors, and `okhsl(...)` are all valid without setup. `okhsl(...)` is the recommended choice when you want a design-system-friendly color authoring path from day one.
+
+Use `configure()` when you want to define shared tokens, state aliases, recipes, or other conventions for your app or design system. For a fuller onboarding path, follow [Getting Started](docs/getting-started.md).
 
 ### Add state-driven styles
 
@@ -112,7 +144,7 @@ const DangerButton = tasty(Button, {
 
 Child styles merge with parent styles intelligently — state maps can extend or replace parent states per-property.
 
-### Configure once, use everywhere
+### Optional: configure shared conventions
 
 ```tsx
 import { configure } from '@tenphi/tasty';
@@ -129,7 +161,7 @@ configure({
 });
 ```
 
-Predefined states turn complex selector logic into single tokens. Use `@mobile` instead of writing media query expressions in every component.
+Use `configure()` once when your app or design system needs shared aliases, tokens, recipes, or parser extensions. Predefined states turn complex selector logic into single tokens, so teams can write `@mobile` instead of repeating media query expressions in every component.
 
 ### CSS properties as props
 
@@ -188,6 +220,8 @@ Layout components can expose flow props. Buttons can expose positioning props. E
 
 This is the core idea that makes everything else possible.
 
+For the end-to-end architecture — parsing state keys, building exclusive conditions, merging by output, and materializing selectors and at-rules — see **[Style rendering pipeline](docs/PIPELINE.md)**.
+
 Traditional CSS has two structural problems.
 
 First, the **cascade** resolves conflicts by specificity and source order: when multiple selectors match, the one with the highest specificity wins, or — if specificity is equal — the last one in source order wins. That makes styles inherently fragile. Reordering imports, adding a media query, or composing components from different libraries can silently break styling.
@@ -278,10 +312,12 @@ Every rule is guarded by the negation of higher-priority rules. No two rules can
 
 By absorbing selector complexity, Tasty makes advanced CSS patterns practical again — nested container queries, multi-condition `@supports` gates, and combined root-state/media branches. You stay in pure CSS instead of relying on JavaScript workarounds, so the browser can optimize layout, painting, and transitions natively. Tasty doesn't limit CSS; it unlocks its full potential by removing the complexity that held teams back.
 
-[Try it in the Tasty Playground →](https://cube-ui-kit.vercel.app/?path=/story/getting-started-tasty-playground--playground)
+[Try it in the Cube UI Kit Storybook playground →](https://cube-ui-kit.vercel.app/?path=/story/getting-started-tasty-playground--playground)
 
 ## Capabilities
 
+This section is a quick product tour. For the canonical guides and references, start from the [Docs Hub](docs/README.md).
+
 ### Design Tokens and Custom Units
 
 Tokens are first-class. Colors use `#name` syntax. Spacing, radius, and border width use multiplier units tied to CSS custom properties:
@@ -317,7 +353,7 @@ Every style property accepts a state mapping object. Keys can be combined with b
 | Class selector (supported) | `.is-active` | `.is-active` |
 | Media query | `@media(w < 768px)` | `@media (width < 768px)` |
 | Container query | `@(panel, w >= 300px)` | `@container panel (width >= 300px)` |
-| Root state | `@root(theme=dark)` | `:root[data-theme="dark"]` |
+| Root state | `@root(schema=dark)` | `:root[data-schema="dark"]` |
 | Parent state | `@parent(theme=danger)` | `:is([data-theme="danger"] *)` |
 | Feature query | `@supports(display: grid)` | `@supports (display: grid)` |
 | Entry animation | `@starting` | `@starting-style` |
@@ -478,7 +514,7 @@ module.exports = {
     ['@tenphi/tasty/babel-plugin', {
       output: 'public/tasty.css',
       config: {
-        states: { '@dark': '@root(theme=dark)' },
+        states: { '@dark': '@root(schema=dark)' },
       },
     }],
   ],
@@ -501,21 +537,9 @@ module.exports = {
 
 Both share the same DSL, tokens, units, state mappings, and recipes.
 
-### Runtime Performance
-
-If you choose the runtime approach, performance is usually a non-issue in practice:
-
-- CSS is generated and injected only when styles are actually used.
-- Multi-level caching avoids repeated parsing and style recomputation.
-- Styles are split into reusable chunks and applied as multiple class names, so matching chunks can be reused across components instead of re-injected.
-- Style normalization guarantees equivalent style input resolves to the same chunks, improving deduplication hit rates.
-- A style garbage collector removes unused styles/chunks over time.
-- A dedicated style injector minimizes DOM/style-tag overhead.
-- This approach is validated in enterprise-scale apps where runtime styling overhead is not noticeable in normal UI flows.
-
-### Server-Side Rendering (Experimental)
+### Server-Side Rendering
 
-SSR with zero-cost client hydration. Existing `tasty()` components work unchanged — SSR is opt-in and requires no per-component modifications. Supports Next.js (App Router with streaming), Astro (middleware + islands), and any React-based framework via the core API. Requires React 19+.
+SSR with zero-cost client hydration. Existing `tasty()` components work unchanged — SSR is opt-in and requires no per-component modifications. Supports Next.js (App Router with streaming), Astro (middleware + islands), and any React-based framework via the core API. Requires React 18+.
 
 **Next.js setup:**
 
@@ -553,7 +577,7 @@ export default function RootLayout({
 }
 ```
 
-See the [full SSR guide](docs/ssr.md) for Astro integration, streaming SSR, generic framework usage, and the complete API reference.
+See the [full SSR guide](docs/ssr.md) for Astro integration, streaming SSR, generic framework usage, troubleshooting, and the current requirements.
 
 ## Entry Points
 
@@ -569,13 +593,73 @@ See the [full SSR guide](docs/ssr.md) for Astro integration, streaming SSR, gene
 | `@tenphi/tasty/ssr/next` | Next.js App Router SSR integration | Node |
 | `@tenphi/tasty/ssr/astro` | Astro middleware + auto-hydration | Node / Browser |
 
+## Browser Requirements
+
+Tasty's exclusive selector system relies on modern CSS pseudo-class syntax:
+
+- **`:is()`** — available across all major browsers since January 2021 ([MDN Baseline](https://developer.mozilla.org/en-US/docs/Web/CSS/:is)).
+- **Level-4 `:not()` with selector lists** — Chrome/Edge 88+, Firefox 84+, Safari 9+, Opera 75+.
+- **Not supported:** IE 11.
+
+## Performance
+
+### Bundle Size
+
+All sizes measured with [size-limit](https://github.com/ai/size-limit) — minified and brotli-compressed, including all dependencies.
+
+| Entry point | Size |
+|-------------|------|
+| `@tenphi/tasty` (runtime + SSR) | ~44 kB |
+| `@tenphi/tasty/core` (runtime, no SSR) | ~41 kB |
+| `@tenphi/tasty/static` (zero-runtime) | ~1.5 kB |
+
+Run `pnpm size` for exact up-to-date numbers.
+
+### Runtime Benchmarks
+
+If you choose the runtime approach, performance is usually a non-issue in practice. The numbers below show single-call throughput for the core pipeline stages, measured with `vitest bench` on an Apple M1 Max (Node 22).
+
+| Operation | ops/sec | Latency (mean) |
+|-----------|--------:|---------------:|
+| `renderStyles` — 5 flat properties (cold) | ~72,000 | ~14 us |
+| `renderStyles` — state map with media/hover/modifier (cold) | ~22,000 | ~46 us |
+| `renderStyles` — same styles (cached) | ~7,200,000 | ~0.14 us |
+| `parseStateKey` — simple key like `:hover` (cold) | ~1,200,000 | ~0.9 us |
+| `parseStateKey` — complex OR/AND/NOT key (cold) | ~190,000 | ~5 us |
+| `parseStateKey` — any key (cached) | ~3,300,000–8,900,000 | ~0.1–0.3 us |
+| `parseStyle` — value tokens like `2x 4x` (cold) | ~345,000 | ~3 us |
+| `parseStyle` — color tokens (cold) | ~525,000 | ~1.9 us |
+| `parseStyle` — any value (cached) | ~15,500,000 | ~0.06 us |
+
+"Cold" benchmarks use unique inputs to bypass all caches. Cached benchmarks reuse a single input and measure the LRU hot path.
+
+Run `pnpm bench` to reproduce.
+
+#### What This Means in Practice
+
+- **Cached path dominates production.** After a component's first render, subsequent renders with stable styles skip the pipeline entirely (React `useMemo` + LRU cache hits at every level). All cached operations are sub-microsecond — effectively free.
+- **Cold path is fast enough.** The heaviest cold operation — a complex state map with media queries, hover, and modifiers — takes ~46 us. Even a page with 100 unique styled components adds only ~5 ms of total style computation on first render, negligible next to React reconciliation and DOM work.
+- **Cache multipliers are 30x–100x.** This confirms the multi-level LRU architecture (parser, state-key, simplify, condition, pipeline) is delivering real value.
+- **Comparable to lighter systems.** Emotion's `css()` is typically 5–20 us for simple styles; Tasty's cold `renderStyles` at ~14 us for 5 properties is in the same range despite doing significantly more work (state maps, design tokens, sub-elements, chunking).
+- **On slower devices.** The benchmarks above are from an M1 Max (Geekbench 6 SC ~2,400). A mid-range consumer laptop (~1,800 SC) is roughly 1.3x slower; a mid-range phone (~1,200 SC) is roughly 2x slower; a budget phone (~700 SC) is roughly 3–4x slower. Even at 4x, the heaviest cold operation stays under 200 us and 100 unique components under 20 ms — still well within a single frame budget. The cached path remains sub-microsecond on all devices.
+
+### How It Stays Fast
+
+- CSS is generated and injected only when styles are actually used.
+- Multi-level caching avoids repeated parsing and style recomputation.
+- Styles are split into reusable chunks and applied as multiple class names, so matching chunks can be reused across components instead of re-injected.
+- Style normalization guarantees equivalent style input resolves to the same chunks, improving deduplication hit rates.
+- A style garbage collector removes unused styles/chunks over time.
+- A dedicated style injector minimizes DOM/style-tag overhead.
+- This approach is validated in enterprise-scale apps where runtime styling overhead is not noticeable in normal UI flows.
+
 ## Ecosystem
 
 Tasty is the core of a production-ready styling platform. These companion tools complete the picture:
 
 ### [ESLint Plugin](https://github.com/tenphi/eslint-plugin-tasty)
 
-`@tenphi/eslint-plugin-tasty` — 27 lint rules that validate style property names, value syntax, token existence, state keys, and enforce best practices. Catch typos and invalid styles at lint time, not at runtime.
+`@tenphi/eslint-plugin-tasty` — 27 total lint rules for style property names, value syntax, token existence, state keys, and best practices. The `recommended` preset enables 18 of them as a practical default. Catch typos and invalid styles at lint time, not at runtime.
 
 ```bash
 pnpm add -D @tenphi/eslint-plugin-tasty
@@ -630,9 +714,13 @@ Open-source React UI kit built on Tasty + React Aria. 100+ production components
 
 ## Documentation
 
+Start from the docs hub if you want the shortest path to the right guide for your role or rendering mode.
+
+- **[Docs Hub](docs/README.md)** — audience-based navigation across onboarding, design-system authoring, runtime, zero-runtime, SSR, debugging, and internals
+
 ### Start here
 
-- **[Getting Started](docs/getting-started.md)** — Installation, first component, configuration, ESLint plugin setup, editor tooling, and rendering mode decision tree
+- **[Getting Started](docs/getting-started.md)** — Installation, first component, optional shared configuration, ESLint plugin setup, editor tooling, and rendering mode decision tree
 - **[Methodology](docs/methodology.md)** — The recommended patterns for structuring Tasty components: root + sub-elements, styleProps, tokens, styles vs style, wrapping and extension
 
 ### Guides
@@ -654,6 +742,7 @@ Open-source React UI kit built on Tasty + React Aria. 100+ production components
 
 ### Internals
 
+- **[Style rendering pipeline](docs/PIPELINE.md)** — How `Styles` become mutually exclusive CSS rules: parse → exclusives → combinations → handlers → merge → materialize (`src/pipeline/`)
 - **[Style Injector](docs/injector.md)** — Internal CSS injection engine: `inject()`, `injectGlobal()`, `injectRawCSS()`, `keyframes()`, deduplication, reference counting, cleanup, SSR support, and Shadow DOM
 - **[Debug Utilities](docs/debug.md)** — Runtime CSS inspection via `tastyDebug`: CSS extraction, element inspection, cache metrics, chunk breakdown, and performance monitoring
 

package/dist/config.d.ts

@@ -3,6 +3,7 @@ import { StyleDetails, UnitHandler } from "./parser/types.js";
 import { StyleHandlerDefinition } from "./utils/styles.js";
 import { ConfigTokens, RecipeStyles } from "./styles/types.js";
 import { StyleInjector } from "./injector/injector.js";
+import { ColorSpace } from "./utils/color-space.js";
 import { TastyPlugin } from "./plugins/types.js";
 
 //#region src/config.d.ts
@@ -58,6 +59,17 @@ interface TastyConfig {
    * @example { myFunc: (groups) => groups.map(g => g.output).join(' ') }
    */
   funcs?: Record<string, (groups: StyleDetails[]) => string>;
+  /**
+   * Color space used for decomposed color token companion variables.
+   * Controls the CSS function and suffix for alpha composition.
+   *
+   * - `'rgb'`   — suffix `-rgb`, e.g. `rgb(var(--name-color-rgb) / .5)`
+   * - `'hsl'`   — suffix `-hsl`, e.g. `hsl(var(--name-color-hsl) / .5)`
+   * - `'oklch'` — suffix `-oklch`, e.g. `oklch(var(--name-color-oklch) / .5)`
+   *
+   * @default 'oklch'
+   */
+  colorSpace?: ColorSpace;
   /**
    * Automatically infer and register CSS @property declarations
    * from custom property values found in styles, keyframes, and global config.
@@ -157,7 +169,7 @@ interface TastyConfig {
    * for responsive/theme-aware tokens.
    *
    * - `$name` keys become `--name` CSS custom properties
-   * - `#name` keys become `--name-color` and `--name-color-rgb` properties
+   * - `#name` keys become `--name-color` and `--name-color-{colorSpace}` properties
    *
    * Tokens are injected once when the first style is rendered.
    *

package/dist/config.js

@@ -1,3 +1,4 @@
+import { resetColorSpace, setColorSpace } from "./utils/color-space.js";
 import { isDevEnv } from "./utils/is-dev-env.js";
 import { CUSTOM_UNITS, getGlobalFuncs, getGlobalParser, normalizeColorTokenValue, resetGlobalPredefinedTokens, setGlobalPredefinedTokens } from "./utils/styles.js";
 import { normalizeHandlerDefinition, registerHandler, resetHandlers } from "./styles/predefined.js";
@@ -375,6 +376,8 @@ function configure(config = {}) {
 		const tokenKeys = new Set(Object.keys(mergedConfigTokens));
 		for (const key of Object.keys(mergedReplaceTokens)) if (tokenKeys.has(key)) warnOnce(`token-conflict-${key}`, `[Tasty] Token "${key}" is defined in both \`tokens\` and \`replaceTokens\`. \`replaceTokens\` performs parse-time substitution, so the \`tokens\` CSS custom property will be injected but never used by Tasty styles. Remove it from one of the two.`);
 	}
+	setColorSpace(config.colorSpace ?? "oklch");
+	getGlobalParser().clearCache();
 	if (Object.keys(mergedStates).length > 0) setGlobalPredefinedStates(mergedStates);
 	const parser = getGlobalParser();
 	if (config.parserCacheSize !== void 0) parser.updateOptions({ cacheSize: config.parserCacheSize });
@@ -409,7 +412,7 @@ function configure(config = {}) {
 	}
 	if (Object.keys(mergedConfigTokens).length > 0) setGlobalConfigTokens(mergedConfigTokens);
 	if (Object.keys(mergedRecipes).length > 0) setGlobalRecipes(mergedRecipes);
-	const { states: _states, parserCacheSize: _parserCacheSize, units: _units, funcs: _funcs, plugins: _plugins, keyframes: _keyframes, properties: _properties, handlers: _handlers, tokens: _tokens, replaceTokens: _replaceTokens, recipes: _recipes, ...injectorConfig } = config;
+	const { states: _states, parserCacheSize: _parserCacheSize, units: _units, funcs: _funcs, plugins: _plugins, keyframes: _keyframes, properties: _properties, handlers: _handlers, tokens: _tokens, replaceTokens: _replaceTokens, recipes: _recipes, colorSpace: _colorSpace, ...injectorConfig } = config;
 	const fullConfig = {
 		...createDefaultConfig(),
 		...currentConfig,
@@ -450,6 +453,7 @@ function resetConfig() {
 	globalConfigTokens = null;
 	resetGlobalPredefinedTokens();
 	resetHandlers();
+	resetColorSpace();
 	clearPipelineCache();
 	emittedWarnings.clear();
 	const storage = typeof window !== "undefined" ? window : globalThis;

package/dist/config.js.map

@@ -1 +1 @@
-{"version":3,"file":"config.js","names":[],"sources":["../src/config.ts"],"sourcesContent":["/**\n * Tasty Configuration Module\n *\n * Centralizes all tasty configuration, including:\n * - Style injector settings (nonce, cleanup thresholds, etc.)\n * - Global predefined states for advanced state mapping\n * - stylesGenerated flag that locks configuration after first style generation\n *\n * Configuration must be done BEFORE any styles are generated.\n * After the first `inject()` call, configuration is locked and attempts to\n * reconfigure will emit a warning and be ignored.\n */\n\nimport { StyleInjector } from './injector/injector';\nimport { clearPipelineCache, isSelector, renderStyles } from './pipeline';\nimport { setGlobalPredefinedStates } from './states';\nimport {\n  normalizeHandlerDefinition,\n  registerHandler,\n  resetHandlers,\n} from './styles/predefined';\nimport { isDevEnv } from './utils/is-dev-env';\nimport {\n  CUSTOM_UNITS,\n  getGlobalFuncs,\n  getGlobalParser,\n  normalizeColorTokenValue,\n  resetGlobalPredefinedTokens,\n  setGlobalPredefinedTokens,\n} from './utils/styles';\n\nimport type { KeyframesSteps, PropertyDefinition } from './injector/types';\nimport type { StyleDetails, UnitHandler } from './parser/types';\nimport type { StyleResult } from './pipeline';\nimport type { TastyPlugin } from './plugins/types';\nimport type { RecipeStyles, ConfigTokens } from './styles/types';\nimport type { StyleHandlerDefinition } from './utils/styles';\n\n/**\n * Configuration options for the Tasty style system\n */\nexport interface TastyConfig {\n  /** CSP nonce for style elements */\n  nonce?: string;\n  /** Maximum rules per stylesheet (default: 8192) */\n  maxRulesPerSheet?: number;\n  /** Threshold for bulk cleanup of unused styles (default: 500) */\n  unusedStylesThreshold?: number;\n  /** Delay before bulk cleanup in ms, ignored if idleCleanup is true (default: 5000) */\n  bulkCleanupDelay?: number;\n  /** Use requestIdleCallback for cleanup when available (default: true) */\n  idleCleanup?: boolean;\n  /** Force text injection mode, auto-detected in test environments (default: auto) */\n  forceTextInjection?: boolean;\n  /** Enable development mode features: performance metrics and debug info (default: auto) */\n  devMode?: boolean;\n  /**\n   * Ratio of unused styles to delete per bulk cleanup run (0..1).\n   * Defaults to 0.5 (oldest half) to reduce risk of removing styles\n   * that may be restored shortly after being marked unused.\n   */\n  bulkCleanupBatchRatio?: number;\n  /**\n   * Minimum age (in ms) a style must remain unused before eligible for deletion.\n   * Helps avoid races during rapid mount/unmount cycles. Default: 10000ms.\n   */\n  unusedStylesMinAgeMs?: number;\n  /**\n   * Global predefined states for advanced state mapping.\n   * These are state aliases that can be used in any component.\n   * Example: { '@mobile': '@media(w < 920px)', '@dark': '@root(theme=dark)' }\n   */\n  states?: Record<string, string>;\n  /**\n   * Parser LRU cache size (default: 1000).\n   * Larger values improve performance for apps with many unique style values.\n   */\n  parserCacheSize?: number;\n  /**\n   * Custom units for the style parser (merged with built-in units).\n   * Units transform numeric values like `2x` → `calc(2 * var(--gap))`.\n   * @example { em: 'em', vw: 'vw', custom: (n) => `${n * 10}px` }\n   */\n  units?: Record<string, string | UnitHandler>;\n  /**\n   * Custom functions for the style parser (merged with existing).\n   * Functions process parsed style groups and return CSS values.\n   * @example { myFunc: (groups) => groups.map(g => g.output).join(' ') }\n   */\n  funcs?: Record<string, (groups: StyleDetails[]) => string>;\n  /**\n   * Automatically infer and register CSS @property declarations\n   * from custom property values found in styles, keyframes, and global config.\n   * Covers all types: \\<color\\>, \\<number\\>, \\<length\\>, \\<angle\\>, \\<percentage\\>, \\<time\\>.\n   * When false, only explicitly declared @properties are registered.\n   * @default true\n   */\n  autoPropertyTypes?: boolean;\n  /**\n   * Plugins that extend tasty with custom functions, units, or states.\n   * Plugins are processed in order, with later plugins overriding earlier ones.\n   * @example\n   * ```ts\n   * import { okhslPlugin } from '@tenphi/tasty';\n   *\n   * configure({\n   *   plugins: [okhslPlugin()],\n   * });\n   * ```\n   */\n  plugins?: TastyPlugin[];\n  /**\n   * Global keyframes definitions that can be referenced by animation names in styles.\n   * Keys are animation names, values are keyframes step definitions.\n   * Keyframes are only injected when actually used in styles.\n   * @example\n   * ```ts\n   * configure({\n   *   keyframes: {\n   *     fadeIn: { from: { opacity: 0 }, to: { opacity: 1 } },\n   *     pulse: { '0%, 100%': { transform: 'scale(1)' }, '50%': { transform: 'scale(1.05)' } },\n   *   },\n   * });\n   * ```\n   */\n  keyframes?: Record<string, KeyframesSteps>;\n  /**\n   * Global CSS @property definitions for custom properties.\n   * Keys use tasty token syntax ($name for properties, #name for colors).\n   * Properties are only injected when the component using them is rendered.\n   *\n   * For color tokens (#name), `syntax: '<color>'` is auto-set and\n   * `initialValue` defaults to `'transparent'` if not specified.\n   *\n   * @example\n   * ```ts\n   * configure({\n   *   properties: {\n   *     '$rotation': { syntax: '<angle>', initialValue: '0deg' },\n   *     '$scale': { syntax: '<number>', inherits: false, initialValue: 1 },\n   *     '#accent': { initialValue: 'purple' }, // syntax: '<color>' auto-set\n   *   },\n   * });\n   *\n   * // Now use in styles - properties are registered when component renders:\n   * const Spinner = tasty({\n   *   styles: {\n   *     transform: 'rotate($rotation)',\n   *     transition: '$$rotation 0.3s', // outputs: --rotation 0.3s\n   *   },\n   * });\n   * ```\n   */\n  properties?: Record<string, PropertyDefinition>;\n  /**\n   * Custom style handlers that transform style properties into CSS declarations.\n   * Handlers replace built-in handlers for the same style name.\n   * @example\n   * ```ts\n   * import { styleHandlers } from '@tenphi/tasty';\n   *\n   * configure({\n   *   handlers: {\n   *     // Override fill with custom behavior\n   *     fill: ({ fill }) => {\n   *       if (fill?.startsWith('gradient:')) {\n   *         return { background: fill.slice(9) };\n   *       }\n   *       return styleHandlers.fill({ fill });\n   *     },\n   *     // Add new custom style\n   *     elevation: ({ elevation }) => {\n   *       const level = parseInt(elevation) || 1;\n   *       return {\n   *         'box-shadow': `0 ${level * 2}px ${level * 4}px rgba(0,0,0,0.1)`,\n   *         'z-index': String(level * 100),\n   *       };\n   *     },\n   *   },\n   * });\n   * ```\n   */\n  handlers?: Record<string, StyleHandlerDefinition>;\n  /**\n   * Design tokens injected as CSS custom properties on `:root`.\n   * Values are parsed through the Tasty DSL. Supports state maps\n   * for responsive/theme-aware tokens.\n   *\n   * - `$name` keys become `--name` CSS custom properties\n   * - `#name` keys become `--name-color` and `--name-color-rgb` properties\n   *\n   * Tokens are injected once when the first style is rendered.\n   *\n   * @example\n   * ```ts\n   * configure({\n   *   tokens: {\n   *     '$gap': '4px',\n   *     '#primary': {\n   *       '': '#purple',\n   *       '@dark': '#light-purple',\n   *     },\n   *   },\n   * });\n   * ```\n   */\n  tokens?: ConfigTokens;\n  /**\n   * Predefined tokens that are replaced during style parsing (parse-time substitution).\n   * Use `$name` for custom properties and `#name` for color tokens.\n   * Values are substituted inline before CSS generation, unlike `tokens` which\n   * inject CSS custom properties on `:root`.\n   *\n   * For color tokens (#name), boolean `true` is converted to `transparent`.\n   *\n   * @example\n   * ```ts\n   * configure({\n   *   replaceTokens: {\n   *     $spacing: '2x',\n   *     '#accent': '#purple',\n   *     '#overlay': true, // → transparent\n   *   },\n   * });\n   *\n   * // Now use in styles - tokens are replaced at parse time:\n   * const Card = tasty({\n   *   styles: {\n   *     padding: '$spacing',  // → calc(2 * var(--gap))\n   *     fill: '#accent',      // → var(--purple-color)\n   *   },\n   * });\n   * ```\n   */\n  replaceTokens?: Record<`$${string}`, string | number | boolean> &\n    Record<`#${string}`, string | number | boolean>;\n  /**\n   * Predefined style recipes -- named style bundles that can be applied via `recipe` style property.\n   * Recipe values are flat tasty styles (no sub-element keys). They may contain base styles,\n   * tokens (`$name`/`#name` definitions), local states, `@keyframes`, and `@properties`.\n   *\n   * Components reference recipes via: `recipe: 'name1 name2'` in their styles.\n   * Use `/` to separate base recipes from post recipes: `recipe: 'base1 base2 / post1'`.\n   * Use `none` to skip base recipes: `recipe: 'none / post1'`.\n   * Resolution order: `base_recipes → component styles → post_recipes`.\n   *\n   * Recipes cannot reference other recipes.\n   *\n   * @example\n   * ```ts\n   * configure({\n   *   recipes: {\n   *     card: { padding: '4x', fill: '#surface', radius: '1r', border: true },\n   *     elevated: { shadow: '2x 2x 4x #shadow' },\n   *   },\n   * });\n   *\n   * // Usage in styles:\n   * const Card = tasty({\n   *   styles: {\n   *     recipe: 'card elevated',\n   *     color: '#text', // Overrides recipe values\n   *   },\n   * });\n   * ```\n   */\n  recipes?: Record<string, RecipeStyles>;\n}\n\n// Warnings tracking to avoid duplicates\nconst emittedWarnings = new Set<string>();\n\nconst devMode = isDevEnv();\n\n/**\n * Emit a warning only once\n */\nfunction warnOnce(key: string, message: string): void {\n  if (devMode && !emittedWarnings.has(key)) {\n    emittedWarnings.add(key);\n    console.warn(message);\n  }\n}\n\n// ============================================================================\n// Configuration State\n// ============================================================================\n\n// Track whether styles have been generated (locks configuration)\nlet stylesGenerated = false;\n\n// Current configuration (null until first configure() or auto-configured on first use)\nlet currentConfig: TastyConfig | null = null;\n\n// Global keyframes storage (null = no keyframes configured, empty object checked via hasGlobalKeyframes)\nlet globalKeyframes: Record<string, KeyframesSteps> | null = null;\n\n// Global properties storage (null = no properties configured)\nlet globalProperties: Record<string, PropertyDefinition> | null = null;\n\n// Global recipes storage (null = no recipes configured)\nlet globalRecipes: Record<string, RecipeStyles> | null = null;\n\n// Global token styles storage (injected as :root CSS custom properties)\nlet globalConfigTokens: ConfigTokens | null = null;\n\n/**\n * Internal properties required by tasty core features.\n * These are always injected when styles are first generated.\n * Keys use tasty token syntax (#name for colors, $name for other properties).\n *\n * For properties with CSS @property-compatible types (length, time, number, color),\n * an `initialValue` is provided so the property works even without a project-level token.\n */\nexport const INTERNAL_PROPERTIES: Record<string, PropertyDefinition> = {\n  // Used by dual-fill feature to enable CSS transitions on the second fill color\n  '#tasty-second-fill': {\n    inherits: false,\n    initialValue: 'transparent',\n  },\n  // Current color context variable (set by the color style handler).\n  '#current': {\n    inherits: true,\n    initialValue: 'transparent',\n  },\n  // White and black are fundamental colors that need explicit initial values.\n  '#white': {\n    inherits: true,\n    initialValue: 'rgb(255 255 255)',\n  },\n  '#black': {\n    inherits: true,\n    initialValue: 'rgb(0 0 0)',\n  },\n\n  // ---- Core design tokens used by style handlers ----\n  // These provide sensible defaults so tasty works standalone without a design system.\n  // Consuming projects (e.g. uikit) override these by defining tokens on :root.\n\n  $gap: {\n    syntax: '<length>',\n    inherits: true,\n    initialValue: '4px',\n  },\n  $radius: {\n    syntax: '<length>',\n    inherits: true,\n    initialValue: '6px',\n  },\n  '$border-width': {\n    syntax: '<length>',\n    inherits: true,\n    initialValue: '1px',\n  },\n  '$outline-width': {\n    syntax: '<length>',\n    inherits: true,\n    initialValue: '3px',\n  },\n  $transition: {\n    syntax: '<time>',\n    inherits: true,\n    initialValue: '80ms',\n  },\n  // Used by radius.ts for `radius=\"leaf\"` modifier\n  '$sharp-radius': {\n    syntax: '<length>',\n    inherits: true,\n    initialValue: '0px',\n  },\n  // Used by preset.ts for `preset=\"... strong\"`\n  '$bold-font-weight': {\n    syntax: '<number>',\n    inherits: true,\n    initialValue: '700',\n  },\n};\n\n/**\n * Internal token defaults that cannot be expressed as CSS @property initial values\n * (e.g. font stacks, keyword colors). These are injected as :root CSS variables.\n * Consuming projects override them by setting their own tokens on :root.\n *\n * Keys are raw CSS custom property names (--name).\n */\nexport const INTERNAL_TOKENS: Record<string, string> = {\n  '--font':\n    'system-ui, -apple-system, \"Segoe UI\", Roboto, Helvetica, Arial, \"Apple Color Emoji\", \"Segoe UI Emoji\", sans-serif',\n  '--monospace-font':\n    'ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, \"Liberation Mono\", \"Courier New\", monospace',\n  // Default border color to the element's current text color\n  '--border-color': 'currentColor',\n};\n\n// Global injector instance key\nconst GLOBAL_INJECTOR_KEY = '__TASTY_GLOBAL_INJECTOR__';\n\ninterface TastyGlobalStorage {\n  [GLOBAL_INJECTOR_KEY]?: StyleInjector;\n}\n\ndeclare global {\n  interface Window {\n    [GLOBAL_INJECTOR_KEY]?: StyleInjector;\n  }\n\n  var __TASTY_GLOBAL_INJECTOR__: StyleInjector | undefined;\n}\n\n/**\n * Detect if we're running in a test environment\n */\nexport function isTestEnvironment(): boolean {\n  // Check Node.js environment\n  if (typeof process !== 'undefined' && process.env?.NODE_ENV === 'test') {\n    return true;\n  }\n\n  // Check for test runner globals (safely)\n  if (typeof global !== 'undefined') {\n    const g = global as unknown as Record<string, unknown>;\n    if (g.vi || g.jest || g.expect || g.describe || g.it) {\n      return true;\n    }\n  }\n\n  // Check for jsdom environment (common in tests)\n  if (\n    typeof window !== 'undefined' &&\n    window.navigator?.userAgent?.includes('jsdom')\n  ) {\n    return true;\n  }\n\n  // Check for other test runners\n  if (typeof globalThis !== 'undefined') {\n    const gt = globalThis as unknown as Record<string, unknown>;\n    if (gt.vitest || gt.mocha) {\n      return true;\n    }\n  }\n\n  return false;\n}\n\n/**\n * Create default configuration with optional test environment detection\n */\nfunction createDefaultConfig(isTest?: boolean): TastyConfig {\n  return {\n    maxRulesPerSheet: 8192,\n    unusedStylesThreshold: 500,\n    bulkCleanupDelay: 5000,\n    idleCleanup: true,\n    forceTextInjection: isTest ?? false,\n    devMode: isDevEnv(),\n    bulkCleanupBatchRatio: 0.5,\n    unusedStylesMinAgeMs: 10000,\n  };\n}\n\n// ============================================================================\n// stylesGenerated Flag Management\n// ============================================================================\n\n/**\n * Mark that styles have been generated (called by injector on first inject)\n * This locks the configuration - no further changes allowed.\n * Also injects internal and global properties.\n */\nexport function markStylesGenerated(): void {\n  if (stylesGenerated) return; // Already marked, skip\n\n  stylesGenerated = true;\n\n  const injector = getGlobalInjector();\n\n  // Inject internal properties required by tasty core features\n  for (const [token, definition] of Object.entries(INTERNAL_PROPERTIES)) {\n    injector.property(token, definition);\n  }\n\n  // Inject internal token defaults as :root CSS variables.\n  // Use injectGlobal (not injectRawCSS) so the rule goes through the same\n  // injection path as all other tasty styles (consistent in both DOM and text/test mode).\n  const internalTokenEntries = Object.entries(INTERNAL_TOKENS);\n  if (internalTokenEntries.length > 0) {\n    const declarations = internalTokenEntries\n      .map(([name, value]) => `${name}: ${value}`)\n      .join('; ');\n    injector.injectGlobal([{ selector: ':root', declarations }]);\n  }\n\n  // Inject global properties if any were configured\n  // Properties are permanent and only need to be injected once\n  if (globalProperties && Object.keys(globalProperties).length > 0) {\n    for (const [token, definition] of Object.entries(globalProperties)) {\n      injector.property(token, definition);\n    }\n  }\n\n  // Inject configured tokens as :root CSS custom properties\n  if (globalConfigTokens && Object.keys(globalConfigTokens).length > 0) {\n    const tokenRules = renderStyles(\n      globalConfigTokens,\n      ':root',\n    ) as StyleResult[];\n    if (tokenRules.length > 0) {\n      injector.injectGlobal(tokenRules);\n    }\n  }\n}\n\n/**\n * Check if styles have been generated (configuration is locked)\n */\nexport function hasStylesGenerated(): boolean {\n  return stylesGenerated;\n}\n\n/**\n * Reset styles generated flag (for testing only)\n */\nexport function resetStylesGenerated(): void {\n  stylesGenerated = false;\n  emittedWarnings.clear();\n}\n\n// ============================================================================\n// Global Keyframes Management\n// ============================================================================\n\nlet _hasGlobalKeyframes = false;\n\n/**\n * Check if any global keyframes are configured.\n * Uses a pre-computed flag to avoid Object.keys() allocation on every call.\n */\nexport function hasGlobalKeyframes(): boolean {\n  return _hasGlobalKeyframes;\n}\n\n/**\n * Get global keyframes configuration.\n * Returns null if no keyframes configured (fast path for zero-overhead).\n */\nexport function getGlobalKeyframes(): Record<string, KeyframesSteps> | null {\n  return globalKeyframes;\n}\n\n/**\n * Set global keyframes (called from configure).\n * Internal use only.\n */\nfunction setGlobalKeyframes(keyframes: Record<string, KeyframesSteps>): void {\n  if (stylesGenerated) {\n    warnOnce(\n      'keyframes-after-styles',\n      `[Tasty] Cannot update keyframes after styles have been generated.\\n` +\n        `The new keyframes will be ignored.`,\n    );\n    return;\n  }\n  globalKeyframes = keyframes;\n  _hasGlobalKeyframes = Object.keys(keyframes).length > 0;\n}\n\n// ============================================================================\n// Global Properties Management\n// ============================================================================\n\n/**\n * Check if any global properties are configured.\n * Fast path: returns false if no properties were ever set.\n */\nexport function hasGlobalProperties(): boolean {\n  return globalProperties !== null && Object.keys(globalProperties).length > 0;\n}\n\n/**\n * Get global properties configuration.\n * Returns null if no properties configured (fast path for zero-overhead).\n */\nexport function getGlobalProperties(): Record<\n  string,\n  PropertyDefinition\n> | null {\n  return globalProperties;\n}\n\n/**\n * Set global properties (called from configure).\n * Internal use only.\n */\nfunction setGlobalProperties(\n  properties: Record<string, PropertyDefinition>,\n): void {\n  if (stylesGenerated) {\n    warnOnce(\n      'properties-after-styles',\n      `[Tasty] Cannot update properties after styles have been generated.\\n` +\n        `The new properties will be ignored.`,\n    );\n    return;\n  }\n  globalProperties = properties;\n}\n\n// ============================================================================\n// Global Recipes Management\n// ============================================================================\n\n/**\n * Check if any global recipes are configured.\n * Fast path: returns false if no recipes were ever set.\n */\nexport function hasGlobalRecipes(): boolean {\n  return globalRecipes !== null && Object.keys(globalRecipes).length > 0;\n}\n\n/**\n * Get global recipes configuration.\n * Returns null if no recipes configured (fast path for zero-overhead).\n */\nexport function getGlobalRecipes(): Record<string, RecipeStyles> | null {\n  return globalRecipes;\n}\n\n/**\n * Set global recipes (called from configure).\n * Internal use only.\n */\nfunction setGlobalRecipes(recipes: Record<string, RecipeStyles>): void {\n  if (stylesGenerated) {\n    warnOnce(\n      'recipes-after-styles',\n      `[Tasty] Cannot update recipes after styles have been generated.\\n` +\n        `The new recipes will be ignored.`,\n    );\n    return;\n  }\n\n  // Dev-mode validation\n  if (devMode) {\n    for (const [name, recipeStyles] of Object.entries(recipes)) {\n      if (name === 'none') {\n        warnOnce(\n          'recipe-reserved-none',\n          `[Tasty] Recipe name \"none\" is reserved. ` +\n            `It is used as a keyword meaning \"no base recipes\" ` +\n            `(e.g. recipe: 'none / post-recipe'). ` +\n            `Choose a different name for your recipe.`,\n        );\n      }\n\n      for (const key of Object.keys(recipeStyles)) {\n        if (isSelector(key)) {\n          warnOnce(\n            `recipe-selector-${name}-${key}`,\n            `[Tasty] Recipe \"${name}\" contains sub-element key \"${key}\". ` +\n              `Recipes must be flat styles without sub-element keys. ` +\n              `Remove the sub-element key from the recipe definition.`,\n          );\n        }\n        if (key === 'recipe') {\n          warnOnce(\n            `recipe-recursive-${name}`,\n            `[Tasty] Recipe \"${name}\" contains a \"recipe\" key. ` +\n              `Recipes cannot reference other recipes. ` +\n              `Use space-separated names for composition: recipe: 'base elevated'.`,\n          );\n        }\n      }\n    }\n  }\n\n  globalRecipes = recipes;\n}\n\n// ============================================================================\n// Global Token Styles Management\n// ============================================================================\n\n/**\n * Get global token styles for :root injection.\n * Returns null if no tokens configured.\n */\nexport function getGlobalConfigTokens(): ConfigTokens | null {\n  return globalConfigTokens;\n}\n\n/**\n * Set global token styles (called from configure).\n * Internal use only.\n */\nfunction setGlobalConfigTokens(styles: ConfigTokens): void {\n  if (stylesGenerated) {\n    warnOnce(\n      'tokens-after-styles',\n      `[Tasty] Cannot update tokens after styles have been generated.\\n` +\n        `The new tokens will be ignored.`,\n    );\n    return;\n  }\n  globalConfigTokens = globalConfigTokens\n    ? { ...globalConfigTokens, ...styles }\n    : styles;\n}\n\n/**\n * Check if configuration is locked (styles have been generated)\n */\nexport function isConfigLocked(): boolean {\n  return stylesGenerated;\n}\n\n// ============================================================================\n// Configuration API\n// ============================================================================\n\n/**\n * Configure the Tasty style system.\n *\n * Must be called BEFORE any styles are generated (before first render that uses tasty).\n * After styles are generated, configuration is locked and calls to configure() will\n * emit a warning and be ignored.\n *\n * @example\n * ```ts\n * import { configure } from '@tenphi/tasty';\n *\n * // Configure before app renders\n * configure({\n *   nonce: 'abc123',\n *   states: {\n *     '@mobile': '@media(w < 768px)',\n *     '@dark': '@root(theme=dark)',\n *   },\n * });\n * ```\n */\nexport function configure(config: Partial<TastyConfig> = {}): void {\n  if (stylesGenerated) {\n    warnOnce(\n      'configure-after-styles',\n      `[Tasty] Cannot call configure() after styles have been generated.\\n` +\n        `Configuration must be done before the first render. The configuration will be ignored.`,\n    );\n    return;\n  }\n\n  // Collect merged values from plugins first, then override with direct config\n  let mergedStates: Record<string, string> = {};\n  let mergedUnits: Record<string, string | UnitHandler> = {};\n  let mergedFuncs: Record<string, (groups: StyleDetails[]) => string> = {};\n  let mergedHandlers: Record<string, StyleHandlerDefinition> = {};\n  let mergedReplaceTokens: Record<string, string | number | boolean> = {};\n  let mergedConfigTokens: ConfigTokens = {} as ConfigTokens;\n  let mergedRecipes: Record<string, RecipeStyles> = {};\n\n  // Process plugins in order\n  if (config.plugins) {\n    for (const plugin of config.plugins) {\n      if (plugin.states) {\n        mergedStates = { ...mergedStates, ...plugin.states };\n      }\n      if (plugin.units) {\n        mergedUnits = { ...mergedUnits, ...plugin.units };\n      }\n      if (plugin.funcs) {\n        mergedFuncs = { ...mergedFuncs, ...plugin.funcs };\n      }\n      if (plugin.handlers) {\n        mergedHandlers = { ...mergedHandlers, ...plugin.handlers };\n      }\n      if (plugin.replaceTokens) {\n        mergedReplaceTokens = {\n          ...mergedReplaceTokens,\n          ...plugin.replaceTokens,\n        };\n      }\n      if (plugin.tokens) {\n        mergedConfigTokens = { ...mergedConfigTokens, ...plugin.tokens };\n      }\n      if (plugin.recipes) {\n        mergedRecipes = { ...mergedRecipes, ...plugin.recipes };\n      }\n    }\n  }\n\n  // Direct config overrides plugins\n  if (config.states) {\n    mergedStates = { ...mergedStates, ...config.states };\n  }\n  if (config.units) {\n    mergedUnits = { ...mergedUnits, ...config.units };\n  }\n  if (config.funcs) {\n    mergedFuncs = { ...mergedFuncs, ...config.funcs };\n  }\n  if (config.handlers) {\n    mergedHandlers = { ...mergedHandlers, ...config.handlers };\n  }\n  if (config.replaceTokens) {\n    mergedReplaceTokens = { ...mergedReplaceTokens, ...config.replaceTokens };\n  }\n  if (config.tokens) {\n    mergedConfigTokens = { ...mergedConfigTokens, ...config.tokens };\n  }\n  if (config.recipes) {\n    mergedRecipes = { ...mergedRecipes, ...config.recipes };\n  }\n\n  // Warn on tokens/replaceTokens key conflicts\n  if (devMode) {\n    const tokenKeys = new Set(Object.keys(mergedConfigTokens));\n    for (const key of Object.keys(mergedReplaceTokens)) {\n      if (tokenKeys.has(key)) {\n        warnOnce(\n          `token-conflict-${key}`,\n          `[Tasty] Token \"${key}\" is defined in both \\`tokens\\` and \\`replaceTokens\\`. ` +\n            `\\`replaceTokens\\` performs parse-time substitution, so the \\`tokens\\` ` +\n            `CSS custom property will be injected but never used by Tasty styles. ` +\n            `Remove it from one of the two.`,\n        );\n      }\n    }\n  }\n\n  // Handle predefined states\n  if (Object.keys(mergedStates).length > 0) {\n    setGlobalPredefinedStates(mergedStates);\n  }\n\n  // Handle parser configuration (merge semantics - extend, not replace)\n  const parser = getGlobalParser();\n\n  if (config.parserCacheSize !== undefined) {\n    parser.updateOptions({ cacheSize: config.parserCacheSize });\n  }\n\n  if (Object.keys(mergedUnits).length > 0) {\n    // Merge with existing units\n    const currentUnits = parser.getUnits() ?? CUSTOM_UNITS;\n    parser.setUnits({ ...currentUnits, ...mergedUnits });\n  }\n\n  if (Object.keys(mergedFuncs).length > 0) {\n    // Merge with existing funcs\n    const currentFuncs = getGlobalFuncs();\n    const finalFuncs = { ...currentFuncs, ...mergedFuncs };\n    parser.setFuncs(finalFuncs);\n    // Also update the global registry so customFunc() continues to work\n    Object.assign(currentFuncs, mergedFuncs);\n  }\n\n  // Handle keyframes\n  if (config.keyframes) {\n    setGlobalKeyframes(config.keyframes);\n  }\n\n  // Handle properties\n  if (config.properties) {\n    setGlobalProperties(config.properties);\n  }\n\n  // Handle custom handlers\n  if (Object.keys(mergedHandlers).length > 0) {\n    for (const [name, definition] of Object.entries(mergedHandlers)) {\n      const handler = normalizeHandlerDefinition(name, definition);\n      registerHandler(handler);\n    }\n  }\n\n  // Handle replaceTokens (parse-time substitution)\n  if (Object.keys(mergedReplaceTokens).length > 0) {\n    const processedTokens: Record<string, string> = {};\n    for (const [key, value] of Object.entries(mergedReplaceTokens)) {\n      if (key.startsWith('#')) {\n        const normalized = normalizeColorTokenValue(value);\n        if (normalized === null) continue;\n        processedTokens[key] = String(normalized);\n      } else if (value === false) {\n        continue;\n      } else {\n        processedTokens[key] = String(value);\n      }\n    }\n    setGlobalPredefinedTokens(processedTokens);\n  }\n\n  // Handle tokens (CSS custom properties on :root)\n  if (Object.keys(mergedConfigTokens).length > 0) {\n    setGlobalConfigTokens(mergedConfigTokens);\n  }\n\n  // Handle recipes\n  if (Object.keys(mergedRecipes).length > 0) {\n    setGlobalRecipes(mergedRecipes);\n  }\n\n  const {\n    states: _states,\n    parserCacheSize: _parserCacheSize,\n    units: _units,\n    funcs: _funcs,\n    plugins: _plugins,\n    keyframes: _keyframes,\n    properties: _properties,\n    handlers: _handlers,\n    tokens: _tokens,\n    replaceTokens: _replaceTokens,\n    recipes: _recipes,\n    ...injectorConfig\n  } = config;\n\n  const fullConfig: TastyConfig = {\n    ...createDefaultConfig(),\n    ...currentConfig,\n    ...injectorConfig,\n  };\n\n  // Store the config\n  currentConfig = fullConfig;\n\n  // Create/replace the global injector\n  const storage: TastyGlobalStorage =\n    typeof window !== 'undefined' ? window : globalThis;\n  storage[GLOBAL_INJECTOR_KEY] = new StyleInjector(fullConfig);\n}\n\n/**\n * Get the current configuration.\n * If not configured, returns default configuration.\n */\nexport function getConfig(): TastyConfig {\n  if (!currentConfig) {\n    currentConfig = createDefaultConfig(isTestEnvironment());\n  }\n  return currentConfig;\n}\n\n/**\n * Get the global injector instance.\n * Auto-configures with defaults if not already configured.\n */\nexport function getGlobalInjector(): StyleInjector {\n  const storage: TastyGlobalStorage =\n    typeof window !== 'undefined' ? window : globalThis;\n\n  if (!storage[GLOBAL_INJECTOR_KEY]) {\n    configure();\n  }\n\n  return storage[GLOBAL_INJECTOR_KEY]!;\n}\n\n/**\n * Reset configuration (for testing only).\n * Clears the global injector and allows reconfiguration.\n */\nexport function resetConfig(): void {\n  stylesGenerated = false;\n  currentConfig = null;\n  globalKeyframes = null;\n  _hasGlobalKeyframes = false;\n  globalProperties = null;\n  globalRecipes = null;\n  globalConfigTokens = null;\n  resetGlobalPredefinedTokens();\n  resetHandlers();\n  clearPipelineCache();\n  emittedWarnings.clear();\n\n  const storage: TastyGlobalStorage =\n    typeof window !== 'undefined' ? window : globalThis;\n  delete storage[GLOBAL_INJECTOR_KEY];\n}\n\n// Re-export TastyConfig as StyleInjectorConfig for backward compatibility\nexport type { TastyConfig as StyleInjectorConfig };\n"],"mappings":"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"}
+{"version":3,"file":"config.js","names":[],"sources":["../src/config.ts"],"sourcesContent":["/**\n * Tasty Configuration Module\n *\n * Centralizes all tasty configuration, including:\n * - Style injector settings (nonce, cleanup thresholds, etc.)\n * - Global predefined states for advanced state mapping\n * - stylesGenerated flag that locks configuration after first style generation\n *\n * Configuration must be done BEFORE any styles are generated.\n * After the first `inject()` call, configuration is locked and attempts to\n * reconfigure will emit a warning and be ignored.\n */\n\nimport { StyleInjector } from './injector/injector';\nimport { clearPipelineCache, isSelector, renderStyles } from './pipeline';\nimport { setGlobalPredefinedStates } from './states';\nimport {\n  normalizeHandlerDefinition,\n  registerHandler,\n  resetHandlers,\n} from './styles/predefined';\nimport { resetColorSpace, setColorSpace } from './utils/color-space';\nimport { isDevEnv } from './utils/is-dev-env';\nimport {\n  CUSTOM_UNITS,\n  getGlobalFuncs,\n  getGlobalParser,\n  normalizeColorTokenValue,\n  resetGlobalPredefinedTokens,\n  setGlobalPredefinedTokens,\n} from './utils/styles';\n\nimport type { ColorSpace } from './utils/color-space';\n\nimport type { KeyframesSteps, PropertyDefinition } from './injector/types';\nimport type { StyleDetails, UnitHandler } from './parser/types';\nimport type { StyleResult } from './pipeline';\nimport type { TastyPlugin } from './plugins/types';\nimport type { RecipeStyles, ConfigTokens } from './styles/types';\nimport type { StyleHandlerDefinition } from './utils/styles';\n\n/**\n * Configuration options for the Tasty style system\n */\nexport interface TastyConfig {\n  /** CSP nonce for style elements */\n  nonce?: string;\n  /** Maximum rules per stylesheet (default: 8192) */\n  maxRulesPerSheet?: number;\n  /** Threshold for bulk cleanup of unused styles (default: 500) */\n  unusedStylesThreshold?: number;\n  /** Delay before bulk cleanup in ms, ignored if idleCleanup is true (default: 5000) */\n  bulkCleanupDelay?: number;\n  /** Use requestIdleCallback for cleanup when available (default: true) */\n  idleCleanup?: boolean;\n  /** Force text injection mode, auto-detected in test environments (default: auto) */\n  forceTextInjection?: boolean;\n  /** Enable development mode features: performance metrics and debug info (default: auto) */\n  devMode?: boolean;\n  /**\n   * Ratio of unused styles to delete per bulk cleanup run (0..1).\n   * Defaults to 0.5 (oldest half) to reduce risk of removing styles\n   * that may be restored shortly after being marked unused.\n   */\n  bulkCleanupBatchRatio?: number;\n  /**\n   * Minimum age (in ms) a style must remain unused before eligible for deletion.\n   * Helps avoid races during rapid mount/unmount cycles. Default: 10000ms.\n   */\n  unusedStylesMinAgeMs?: number;\n  /**\n   * Global predefined states for advanced state mapping.\n   * These are state aliases that can be used in any component.\n   * Example: { '@mobile': '@media(w < 920px)', '@dark': '@root(theme=dark)' }\n   */\n  states?: Record<string, string>;\n  /**\n   * Parser LRU cache size (default: 1000).\n   * Larger values improve performance for apps with many unique style values.\n   */\n  parserCacheSize?: number;\n  /**\n   * Custom units for the style parser (merged with built-in units).\n   * Units transform numeric values like `2x` → `calc(2 * var(--gap))`.\n   * @example { em: 'em', vw: 'vw', custom: (n) => `${n * 10}px` }\n   */\n  units?: Record<string, string | UnitHandler>;\n  /**\n   * Custom functions for the style parser (merged with existing).\n   * Functions process parsed style groups and return CSS values.\n   * @example { myFunc: (groups) => groups.map(g => g.output).join(' ') }\n   */\n  funcs?: Record<string, (groups: StyleDetails[]) => string>;\n  /**\n   * Color space used for decomposed color token companion variables.\n   * Controls the CSS function and suffix for alpha composition.\n   *\n   * - `'rgb'`   — suffix `-rgb`, e.g. `rgb(var(--name-color-rgb) / .5)`\n   * - `'hsl'`   — suffix `-hsl`, e.g. `hsl(var(--name-color-hsl) / .5)`\n   * - `'oklch'` — suffix `-oklch`, e.g. `oklch(var(--name-color-oklch) / .5)`\n   *\n   * @default 'oklch'\n   */\n  colorSpace?: ColorSpace;\n  /**\n   * Automatically infer and register CSS @property declarations\n   * from custom property values found in styles, keyframes, and global config.\n   * Covers all types: \\<color\\>, \\<number\\>, \\<length\\>, \\<angle\\>, \\<percentage\\>, \\<time\\>.\n   * When false, only explicitly declared @properties are registered.\n   * @default true\n   */\n  autoPropertyTypes?: boolean;\n  /**\n   * Plugins that extend tasty with custom functions, units, or states.\n   * Plugins are processed in order, with later plugins overriding earlier ones.\n   * @example\n   * ```ts\n   * import { okhslPlugin } from '@tenphi/tasty';\n   *\n   * configure({\n   *   plugins: [okhslPlugin()],\n   * });\n   * ```\n   */\n  plugins?: TastyPlugin[];\n  /**\n   * Global keyframes definitions that can be referenced by animation names in styles.\n   * Keys are animation names, values are keyframes step definitions.\n   * Keyframes are only injected when actually used in styles.\n   * @example\n   * ```ts\n   * configure({\n   *   keyframes: {\n   *     fadeIn: { from: { opacity: 0 }, to: { opacity: 1 } },\n   *     pulse: { '0%, 100%': { transform: 'scale(1)' }, '50%': { transform: 'scale(1.05)' } },\n   *   },\n   * });\n   * ```\n   */\n  keyframes?: Record<string, KeyframesSteps>;\n  /**\n   * Global CSS @property definitions for custom properties.\n   * Keys use tasty token syntax ($name for properties, #name for colors).\n   * Properties are only injected when the component using them is rendered.\n   *\n   * For color tokens (#name), `syntax: '<color>'` is auto-set and\n   * `initialValue` defaults to `'transparent'` if not specified.\n   *\n   * @example\n   * ```ts\n   * configure({\n   *   properties: {\n   *     '$rotation': { syntax: '<angle>', initialValue: '0deg' },\n   *     '$scale': { syntax: '<number>', inherits: false, initialValue: 1 },\n   *     '#accent': { initialValue: 'purple' }, // syntax: '<color>' auto-set\n   *   },\n   * });\n   *\n   * // Now use in styles - properties are registered when component renders:\n   * const Spinner = tasty({\n   *   styles: {\n   *     transform: 'rotate($rotation)',\n   *     transition: '$$rotation 0.3s', // outputs: --rotation 0.3s\n   *   },\n   * });\n   * ```\n   */\n  properties?: Record<string, PropertyDefinition>;\n  /**\n   * Custom style handlers that transform style properties into CSS declarations.\n   * Handlers replace built-in handlers for the same style name.\n   * @example\n   * ```ts\n   * import { styleHandlers } from '@tenphi/tasty';\n   *\n   * configure({\n   *   handlers: {\n   *     // Override fill with custom behavior\n   *     fill: ({ fill }) => {\n   *       if (fill?.startsWith('gradient:')) {\n   *         return { background: fill.slice(9) };\n   *       }\n   *       return styleHandlers.fill({ fill });\n   *     },\n   *     // Add new custom style\n   *     elevation: ({ elevation }) => {\n   *       const level = parseInt(elevation) || 1;\n   *       return {\n   *         'box-shadow': `0 ${level * 2}px ${level * 4}px rgba(0,0,0,0.1)`,\n   *         'z-index': String(level * 100),\n   *       };\n   *     },\n   *   },\n   * });\n   * ```\n   */\n  handlers?: Record<string, StyleHandlerDefinition>;\n  /**\n   * Design tokens injected as CSS custom properties on `:root`.\n   * Values are parsed through the Tasty DSL. Supports state maps\n   * for responsive/theme-aware tokens.\n   *\n   * - `$name` keys become `--name` CSS custom properties\n   * - `#name` keys become `--name-color` and `--name-color-{colorSpace}` properties\n   *\n   * Tokens are injected once when the first style is rendered.\n   *\n   * @example\n   * ```ts\n   * configure({\n   *   tokens: {\n   *     '$gap': '4px',\n   *     '#primary': {\n   *       '': '#purple',\n   *       '@dark': '#light-purple',\n   *     },\n   *   },\n   * });\n   * ```\n   */\n  tokens?: ConfigTokens;\n  /**\n   * Predefined tokens that are replaced during style parsing (parse-time substitution).\n   * Use `$name` for custom properties and `#name` for color tokens.\n   * Values are substituted inline before CSS generation, unlike `tokens` which\n   * inject CSS custom properties on `:root`.\n   *\n   * For color tokens (#name), boolean `true` is converted to `transparent`.\n   *\n   * @example\n   * ```ts\n   * configure({\n   *   replaceTokens: {\n   *     $spacing: '2x',\n   *     '#accent': '#purple',\n   *     '#overlay': true, // → transparent\n   *   },\n   * });\n   *\n   * // Now use in styles - tokens are replaced at parse time:\n   * const Card = tasty({\n   *   styles: {\n   *     padding: '$spacing',  // → calc(2 * var(--gap))\n   *     fill: '#accent',      // → var(--purple-color)\n   *   },\n   * });\n   * ```\n   */\n  replaceTokens?: Record<`$${string}`, string | number | boolean> &\n    Record<`#${string}`, string | number | boolean>;\n  /**\n   * Predefined style recipes -- named style bundles that can be applied via `recipe` style property.\n   * Recipe values are flat tasty styles (no sub-element keys). They may contain base styles,\n   * tokens (`$name`/`#name` definitions), local states, `@keyframes`, and `@properties`.\n   *\n   * Components reference recipes via: `recipe: 'name1 name2'` in their styles.\n   * Use `/` to separate base recipes from post recipes: `recipe: 'base1 base2 / post1'`.\n   * Use `none` to skip base recipes: `recipe: 'none / post1'`.\n   * Resolution order: `base_recipes → component styles → post_recipes`.\n   *\n   * Recipes cannot reference other recipes.\n   *\n   * @example\n   * ```ts\n   * configure({\n   *   recipes: {\n   *     card: { padding: '4x', fill: '#surface', radius: '1r', border: true },\n   *     elevated: { shadow: '2x 2x 4x #shadow' },\n   *   },\n   * });\n   *\n   * // Usage in styles:\n   * const Card = tasty({\n   *   styles: {\n   *     recipe: 'card elevated',\n   *     color: '#text', // Overrides recipe values\n   *   },\n   * });\n   * ```\n   */\n  recipes?: Record<string, RecipeStyles>;\n}\n\n// Warnings tracking to avoid duplicates\nconst emittedWarnings = new Set<string>();\n\nconst devMode = isDevEnv();\n\n/**\n * Emit a warning only once\n */\nfunction warnOnce(key: string, message: string): void {\n  if (devMode && !emittedWarnings.has(key)) {\n    emittedWarnings.add(key);\n    console.warn(message);\n  }\n}\n\n// ============================================================================\n// Configuration State\n// ============================================================================\n\n// Track whether styles have been generated (locks configuration)\nlet stylesGenerated = false;\n\n// Current configuration (null until first configure() or auto-configured on first use)\nlet currentConfig: TastyConfig | null = null;\n\n// Global keyframes storage (null = no keyframes configured, empty object checked via hasGlobalKeyframes)\nlet globalKeyframes: Record<string, KeyframesSteps> | null = null;\n\n// Global properties storage (null = no properties configured)\nlet globalProperties: Record<string, PropertyDefinition> | null = null;\n\n// Global recipes storage (null = no recipes configured)\nlet globalRecipes: Record<string, RecipeStyles> | null = null;\n\n// Global token styles storage (injected as :root CSS custom properties)\nlet globalConfigTokens: ConfigTokens | null = null;\n\n/**\n * Internal properties required by tasty core features.\n * These are always injected when styles are first generated.\n * Keys use tasty token syntax (#name for colors, $name for other properties).\n *\n * For properties with CSS @property-compatible types (length, time, number, color),\n * an `initialValue` is provided so the property works even without a project-level token.\n */\nexport const INTERNAL_PROPERTIES: Record<string, PropertyDefinition> = {\n  // Used by dual-fill feature to enable CSS transitions on the second fill color\n  '#tasty-second-fill': {\n    inherits: false,\n    initialValue: 'transparent',\n  },\n  // Current color context variable (set by the color style handler).\n  '#current': {\n    inherits: true,\n    initialValue: 'transparent',\n  },\n  // White and black are fundamental colors that need explicit initial values.\n  '#white': {\n    inherits: true,\n    initialValue: 'rgb(255 255 255)',\n  },\n  '#black': {\n    inherits: true,\n    initialValue: 'rgb(0 0 0)',\n  },\n\n  // ---- Core design tokens used by style handlers ----\n  // These provide sensible defaults so tasty works standalone without a design system.\n  // Consuming projects (e.g. uikit) override these by defining tokens on :root.\n\n  $gap: {\n    syntax: '<length>',\n    inherits: true,\n    initialValue: '4px',\n  },\n  $radius: {\n    syntax: '<length>',\n    inherits: true,\n    initialValue: '6px',\n  },\n  '$border-width': {\n    syntax: '<length>',\n    inherits: true,\n    initialValue: '1px',\n  },\n  '$outline-width': {\n    syntax: '<length>',\n    inherits: true,\n    initialValue: '3px',\n  },\n  $transition: {\n    syntax: '<time>',\n    inherits: true,\n    initialValue: '80ms',\n  },\n  // Used by radius.ts for `radius=\"leaf\"` modifier\n  '$sharp-radius': {\n    syntax: '<length>',\n    inherits: true,\n    initialValue: '0px',\n  },\n  // Used by preset.ts for `preset=\"... strong\"`\n  '$bold-font-weight': {\n    syntax: '<number>',\n    inherits: true,\n    initialValue: '700',\n  },\n};\n\n/**\n * Internal token defaults that cannot be expressed as CSS @property initial values\n * (e.g. font stacks, keyword colors). These are injected as :root CSS variables.\n * Consuming projects override them by setting their own tokens on :root.\n *\n * Keys are raw CSS custom property names (--name).\n */\nexport const INTERNAL_TOKENS: Record<string, string> = {\n  '--font':\n    'system-ui, -apple-system, \"Segoe UI\", Roboto, Helvetica, Arial, \"Apple Color Emoji\", \"Segoe UI Emoji\", sans-serif',\n  '--monospace-font':\n    'ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, \"Liberation Mono\", \"Courier New\", monospace',\n  // Default border color to the element's current text color\n  '--border-color': 'currentColor',\n};\n\n// Global injector instance key\nconst GLOBAL_INJECTOR_KEY = '__TASTY_GLOBAL_INJECTOR__';\n\ninterface TastyGlobalStorage {\n  [GLOBAL_INJECTOR_KEY]?: StyleInjector;\n}\n\ndeclare global {\n  interface Window {\n    [GLOBAL_INJECTOR_KEY]?: StyleInjector;\n  }\n\n  var __TASTY_GLOBAL_INJECTOR__: StyleInjector | undefined;\n}\n\n/**\n * Detect if we're running in a test environment\n */\nexport function isTestEnvironment(): boolean {\n  // Check Node.js environment\n  if (typeof process !== 'undefined' && process.env?.NODE_ENV === 'test') {\n    return true;\n  }\n\n  // Check for test runner globals (safely)\n  if (typeof global !== 'undefined') {\n    const g = global as unknown as Record<string, unknown>;\n    if (g.vi || g.jest || g.expect || g.describe || g.it) {\n      return true;\n    }\n  }\n\n  // Check for jsdom environment (common in tests)\n  if (\n    typeof window !== 'undefined' &&\n    window.navigator?.userAgent?.includes('jsdom')\n  ) {\n    return true;\n  }\n\n  // Check for other test runners\n  if (typeof globalThis !== 'undefined') {\n    const gt = globalThis as unknown as Record<string, unknown>;\n    if (gt.vitest || gt.mocha) {\n      return true;\n    }\n  }\n\n  return false;\n}\n\n/**\n * Create default configuration with optional test environment detection\n */\nfunction createDefaultConfig(isTest?: boolean): TastyConfig {\n  return {\n    maxRulesPerSheet: 8192,\n    unusedStylesThreshold: 500,\n    bulkCleanupDelay: 5000,\n    idleCleanup: true,\n    forceTextInjection: isTest ?? false,\n    devMode: isDevEnv(),\n    bulkCleanupBatchRatio: 0.5,\n    unusedStylesMinAgeMs: 10000,\n  };\n}\n\n// ============================================================================\n// stylesGenerated Flag Management\n// ============================================================================\n\n/**\n * Mark that styles have been generated (called by injector on first inject)\n * This locks the configuration - no further changes allowed.\n * Also injects internal and global properties.\n */\nexport function markStylesGenerated(): void {\n  if (stylesGenerated) return; // Already marked, skip\n\n  stylesGenerated = true;\n\n  const injector = getGlobalInjector();\n\n  // Inject internal properties required by tasty core features\n  for (const [token, definition] of Object.entries(INTERNAL_PROPERTIES)) {\n    injector.property(token, definition);\n  }\n\n  // Inject internal token defaults as :root CSS variables.\n  // Use injectGlobal (not injectRawCSS) so the rule goes through the same\n  // injection path as all other tasty styles (consistent in both DOM and text/test mode).\n  const internalTokenEntries = Object.entries(INTERNAL_TOKENS);\n  if (internalTokenEntries.length > 0) {\n    const declarations = internalTokenEntries\n      .map(([name, value]) => `${name}: ${value}`)\n      .join('; ');\n    injector.injectGlobal([{ selector: ':root', declarations }]);\n  }\n\n  // Inject global properties if any were configured\n  // Properties are permanent and only need to be injected once\n  if (globalProperties && Object.keys(globalProperties).length > 0) {\n    for (const [token, definition] of Object.entries(globalProperties)) {\n      injector.property(token, definition);\n    }\n  }\n\n  // Inject configured tokens as :root CSS custom properties\n  if (globalConfigTokens && Object.keys(globalConfigTokens).length > 0) {\n    const tokenRules = renderStyles(\n      globalConfigTokens,\n      ':root',\n    ) as StyleResult[];\n    if (tokenRules.length > 0) {\n      injector.injectGlobal(tokenRules);\n    }\n  }\n}\n\n/**\n * Check if styles have been generated (configuration is locked)\n */\nexport function hasStylesGenerated(): boolean {\n  return stylesGenerated;\n}\n\n/**\n * Reset styles generated flag (for testing only)\n */\nexport function resetStylesGenerated(): void {\n  stylesGenerated = false;\n  emittedWarnings.clear();\n}\n\n// ============================================================================\n// Global Keyframes Management\n// ============================================================================\n\nlet _hasGlobalKeyframes = false;\n\n/**\n * Check if any global keyframes are configured.\n * Uses a pre-computed flag to avoid Object.keys() allocation on every call.\n */\nexport function hasGlobalKeyframes(): boolean {\n  return _hasGlobalKeyframes;\n}\n\n/**\n * Get global keyframes configuration.\n * Returns null if no keyframes configured (fast path for zero-overhead).\n */\nexport function getGlobalKeyframes(): Record<string, KeyframesSteps> | null {\n  return globalKeyframes;\n}\n\n/**\n * Set global keyframes (called from configure).\n * Internal use only.\n */\nfunction setGlobalKeyframes(keyframes: Record<string, KeyframesSteps>): void {\n  if (stylesGenerated) {\n    warnOnce(\n      'keyframes-after-styles',\n      `[Tasty] Cannot update keyframes after styles have been generated.\\n` +\n        `The new keyframes will be ignored.`,\n    );\n    return;\n  }\n  globalKeyframes = keyframes;\n  _hasGlobalKeyframes = Object.keys(keyframes).length > 0;\n}\n\n// ============================================================================\n// Global Properties Management\n// ============================================================================\n\n/**\n * Check if any global properties are configured.\n * Fast path: returns false if no properties were ever set.\n */\nexport function hasGlobalProperties(): boolean {\n  return globalProperties !== null && Object.keys(globalProperties).length > 0;\n}\n\n/**\n * Get global properties configuration.\n * Returns null if no properties configured (fast path for zero-overhead).\n */\nexport function getGlobalProperties(): Record<\n  string,\n  PropertyDefinition\n> | null {\n  return globalProperties;\n}\n\n/**\n * Set global properties (called from configure).\n * Internal use only.\n */\nfunction setGlobalProperties(\n  properties: Record<string, PropertyDefinition>,\n): void {\n  if (stylesGenerated) {\n    warnOnce(\n      'properties-after-styles',\n      `[Tasty] Cannot update properties after styles have been generated.\\n` +\n        `The new properties will be ignored.`,\n    );\n    return;\n  }\n  globalProperties = properties;\n}\n\n// ============================================================================\n// Global Recipes Management\n// ============================================================================\n\n/**\n * Check if any global recipes are configured.\n * Fast path: returns false if no recipes were ever set.\n */\nexport function hasGlobalRecipes(): boolean {\n  return globalRecipes !== null && Object.keys(globalRecipes).length > 0;\n}\n\n/**\n * Get global recipes configuration.\n * Returns null if no recipes configured (fast path for zero-overhead).\n */\nexport function getGlobalRecipes(): Record<string, RecipeStyles> | null {\n  return globalRecipes;\n}\n\n/**\n * Set global recipes (called from configure).\n * Internal use only.\n */\nfunction setGlobalRecipes(recipes: Record<string, RecipeStyles>): void {\n  if (stylesGenerated) {\n    warnOnce(\n      'recipes-after-styles',\n      `[Tasty] Cannot update recipes after styles have been generated.\\n` +\n        `The new recipes will be ignored.`,\n    );\n    return;\n  }\n\n  // Dev-mode validation\n  if (devMode) {\n    for (const [name, recipeStyles] of Object.entries(recipes)) {\n      if (name === 'none') {\n        warnOnce(\n          'recipe-reserved-none',\n          `[Tasty] Recipe name \"none\" is reserved. ` +\n            `It is used as a keyword meaning \"no base recipes\" ` +\n            `(e.g. recipe: 'none / post-recipe'). ` +\n            `Choose a different name for your recipe.`,\n        );\n      }\n\n      for (const key of Object.keys(recipeStyles)) {\n        if (isSelector(key)) {\n          warnOnce(\n            `recipe-selector-${name}-${key}`,\n            `[Tasty] Recipe \"${name}\" contains sub-element key \"${key}\". ` +\n              `Recipes must be flat styles without sub-element keys. ` +\n              `Remove the sub-element key from the recipe definition.`,\n          );\n        }\n        if (key === 'recipe') {\n          warnOnce(\n            `recipe-recursive-${name}`,\n            `[Tasty] Recipe \"${name}\" contains a \"recipe\" key. ` +\n              `Recipes cannot reference other recipes. ` +\n              `Use space-separated names for composition: recipe: 'base elevated'.`,\n          );\n        }\n      }\n    }\n  }\n\n  globalRecipes = recipes;\n}\n\n// ============================================================================\n// Global Token Styles Management\n// ============================================================================\n\n/**\n * Get global token styles for :root injection.\n * Returns null if no tokens configured.\n */\nexport function getGlobalConfigTokens(): ConfigTokens | null {\n  return globalConfigTokens;\n}\n\n/**\n * Set global token styles (called from configure).\n * Internal use only.\n */\nfunction setGlobalConfigTokens(styles: ConfigTokens): void {\n  if (stylesGenerated) {\n    warnOnce(\n      'tokens-after-styles',\n      `[Tasty] Cannot update tokens after styles have been generated.\\n` +\n        `The new tokens will be ignored.`,\n    );\n    return;\n  }\n  globalConfigTokens = globalConfigTokens\n    ? { ...globalConfigTokens, ...styles }\n    : styles;\n}\n\n/**\n * Check if configuration is locked (styles have been generated)\n */\nexport function isConfigLocked(): boolean {\n  return stylesGenerated;\n}\n\n// ============================================================================\n// Configuration API\n// ============================================================================\n\n/**\n * Configure the Tasty style system.\n *\n * Must be called BEFORE any styles are generated (before first render that uses tasty).\n * After styles are generated, configuration is locked and calls to configure() will\n * emit a warning and be ignored.\n *\n * @example\n * ```ts\n * import { configure } from '@tenphi/tasty';\n *\n * // Configure before app renders\n * configure({\n *   nonce: 'abc123',\n *   states: {\n *     '@mobile': '@media(w < 768px)',\n *     '@dark': '@root(theme=dark)',\n *   },\n * });\n * ```\n */\nexport function configure(config: Partial<TastyConfig> = {}): void {\n  if (stylesGenerated) {\n    warnOnce(\n      'configure-after-styles',\n      `[Tasty] Cannot call configure() after styles have been generated.\\n` +\n        `Configuration must be done before the first render. The configuration will be ignored.`,\n    );\n    return;\n  }\n\n  // Collect merged values from plugins first, then override with direct config\n  let mergedStates: Record<string, string> = {};\n  let mergedUnits: Record<string, string | UnitHandler> = {};\n  let mergedFuncs: Record<string, (groups: StyleDetails[]) => string> = {};\n  let mergedHandlers: Record<string, StyleHandlerDefinition> = {};\n  let mergedReplaceTokens: Record<string, string | number | boolean> = {};\n  let mergedConfigTokens: ConfigTokens = {} as ConfigTokens;\n  let mergedRecipes: Record<string, RecipeStyles> = {};\n\n  // Process plugins in order\n  if (config.plugins) {\n    for (const plugin of config.plugins) {\n      if (plugin.states) {\n        mergedStates = { ...mergedStates, ...plugin.states };\n      }\n      if (plugin.units) {\n        mergedUnits = { ...mergedUnits, ...plugin.units };\n      }\n      if (plugin.funcs) {\n        mergedFuncs = { ...mergedFuncs, ...plugin.funcs };\n      }\n      if (plugin.handlers) {\n        mergedHandlers = { ...mergedHandlers, ...plugin.handlers };\n      }\n      if (plugin.replaceTokens) {\n        mergedReplaceTokens = {\n          ...mergedReplaceTokens,\n          ...plugin.replaceTokens,\n        };\n      }\n      if (plugin.tokens) {\n        mergedConfigTokens = { ...mergedConfigTokens, ...plugin.tokens };\n      }\n      if (plugin.recipes) {\n        mergedRecipes = { ...mergedRecipes, ...plugin.recipes };\n      }\n    }\n  }\n\n  // Direct config overrides plugins\n  if (config.states) {\n    mergedStates = { ...mergedStates, ...config.states };\n  }\n  if (config.units) {\n    mergedUnits = { ...mergedUnits, ...config.units };\n  }\n  if (config.funcs) {\n    mergedFuncs = { ...mergedFuncs, ...config.funcs };\n  }\n  if (config.handlers) {\n    mergedHandlers = { ...mergedHandlers, ...config.handlers };\n  }\n  if (config.replaceTokens) {\n    mergedReplaceTokens = { ...mergedReplaceTokens, ...config.replaceTokens };\n  }\n  if (config.tokens) {\n    mergedConfigTokens = { ...mergedConfigTokens, ...config.tokens };\n  }\n  if (config.recipes) {\n    mergedRecipes = { ...mergedRecipes, ...config.recipes };\n  }\n\n  // Warn on tokens/replaceTokens key conflicts\n  if (devMode) {\n    const tokenKeys = new Set(Object.keys(mergedConfigTokens));\n    for (const key of Object.keys(mergedReplaceTokens)) {\n      if (tokenKeys.has(key)) {\n        warnOnce(\n          `token-conflict-${key}`,\n          `[Tasty] Token \"${key}\" is defined in both \\`tokens\\` and \\`replaceTokens\\`. ` +\n            `\\`replaceTokens\\` performs parse-time substitution, so the \\`tokens\\` ` +\n            `CSS custom property will be injected but never used by Tasty styles. ` +\n            `Remove it from one of the two.`,\n        );\n      }\n    }\n  }\n\n  // Handle color space (must be set before any token processing)\n  setColorSpace(config.colorSpace ?? 'oklch');\n  // Color space affects parser output (e.g. #name.5 → oklch(...) vs rgb(...))\n  getGlobalParser().clearCache();\n\n  // Handle predefined states\n  if (Object.keys(mergedStates).length > 0) {\n    setGlobalPredefinedStates(mergedStates);\n  }\n\n  // Handle parser configuration (merge semantics - extend, not replace)\n  const parser = getGlobalParser();\n\n  if (config.parserCacheSize !== undefined) {\n    parser.updateOptions({ cacheSize: config.parserCacheSize });\n  }\n\n  if (Object.keys(mergedUnits).length > 0) {\n    // Merge with existing units\n    const currentUnits = parser.getUnits() ?? CUSTOM_UNITS;\n    parser.setUnits({ ...currentUnits, ...mergedUnits });\n  }\n\n  if (Object.keys(mergedFuncs).length > 0) {\n    // Merge with existing funcs\n    const currentFuncs = getGlobalFuncs();\n    const finalFuncs = { ...currentFuncs, ...mergedFuncs };\n    parser.setFuncs(finalFuncs);\n    // Also update the global registry so customFunc() continues to work\n    Object.assign(currentFuncs, mergedFuncs);\n  }\n\n  // Handle keyframes\n  if (config.keyframes) {\n    setGlobalKeyframes(config.keyframes);\n  }\n\n  // Handle properties\n  if (config.properties) {\n    setGlobalProperties(config.properties);\n  }\n\n  // Handle custom handlers\n  if (Object.keys(mergedHandlers).length > 0) {\n    for (const [name, definition] of Object.entries(mergedHandlers)) {\n      const handler = normalizeHandlerDefinition(name, definition);\n      registerHandler(handler);\n    }\n  }\n\n  // Handle replaceTokens (parse-time substitution)\n  if (Object.keys(mergedReplaceTokens).length > 0) {\n    const processedTokens: Record<string, string> = {};\n    for (const [key, value] of Object.entries(mergedReplaceTokens)) {\n      if (key.startsWith('#')) {\n        const normalized = normalizeColorTokenValue(value);\n        if (normalized === null) continue;\n        processedTokens[key] = String(normalized);\n      } else if (value === false) {\n        continue;\n      } else {\n        processedTokens[key] = String(value);\n      }\n    }\n    setGlobalPredefinedTokens(processedTokens);\n  }\n\n  // Handle tokens (CSS custom properties on :root)\n  if (Object.keys(mergedConfigTokens).length > 0) {\n    setGlobalConfigTokens(mergedConfigTokens);\n  }\n\n  // Handle recipes\n  if (Object.keys(mergedRecipes).length > 0) {\n    setGlobalRecipes(mergedRecipes);\n  }\n\n  const {\n    states: _states,\n    parserCacheSize: _parserCacheSize,\n    units: _units,\n    funcs: _funcs,\n    plugins: _plugins,\n    keyframes: _keyframes,\n    properties: _properties,\n    handlers: _handlers,\n    tokens: _tokens,\n    replaceTokens: _replaceTokens,\n    recipes: _recipes,\n    colorSpace: _colorSpace,\n    ...injectorConfig\n  } = config;\n\n  const fullConfig: TastyConfig = {\n    ...createDefaultConfig(),\n    ...currentConfig,\n    ...injectorConfig,\n  };\n\n  // Store the config\n  currentConfig = fullConfig;\n\n  // Create/replace the global injector\n  const storage: TastyGlobalStorage =\n    typeof window !== 'undefined' ? window : globalThis;\n  storage[GLOBAL_INJECTOR_KEY] = new StyleInjector(fullConfig);\n}\n\n/**\n * Get the current configuration.\n * If not configured, returns default configuration.\n */\nexport function getConfig(): TastyConfig {\n  if (!currentConfig) {\n    currentConfig = createDefaultConfig(isTestEnvironment());\n  }\n  return currentConfig;\n}\n\n/**\n * Get the global injector instance.\n * Auto-configures with defaults if not already configured.\n */\nexport function getGlobalInjector(): StyleInjector {\n  const storage: TastyGlobalStorage =\n    typeof window !== 'undefined' ? window : globalThis;\n\n  if (!storage[GLOBAL_INJECTOR_KEY]) {\n    configure();\n  }\n\n  return storage[GLOBAL_INJECTOR_KEY]!;\n}\n\n/**\n * Reset configuration (for testing only).\n * Clears the global injector and allows reconfiguration.\n */\nexport function resetConfig(): void {\n  stylesGenerated = false;\n  currentConfig = null;\n  globalKeyframes = null;\n  _hasGlobalKeyframes = false;\n  globalProperties = null;\n  globalRecipes = null;\n  globalConfigTokens = null;\n  resetGlobalPredefinedTokens();\n  resetHandlers();\n  resetColorSpace();\n  clearPipelineCache();\n  emittedWarnings.clear();\n\n  const storage: TastyGlobalStorage =\n    typeof window !== 'undefined' ? window : globalThis;\n  delete storage[GLOBAL_INJECTOR_KEY];\n}\n\n// Re-export TastyConfig as StyleInjectorConfig for backward compatibility\nexport type { TastyConfig as StyleInjectorConfig };\n"],"mappings":"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"}

package/dist/core/index.d.ts

@@ -2,7 +2,8 @@ import { CacheMetrics, DisposeFunction, InjectResult, KeyframesCacheEntry, Keyfr
 import { CSSProperties } from "../utils/css-types.js";
 import { Bucket, ParserOptions, ProcessedStyle, StyleDetails, StyleDetailsPart, UnitHandler } from "../parser/types.js";
 import { StyleParser } from "../parser/parser.js";
-import { CSSMap, CUSTOM_UNITS, DIRECTIONS, ParsedColor, RawStyleHandler, StyleHandler, StyleHandlerDefinition, StyleHandlerResult, StyleMap, StylePropValue, StyleValue, StyleValueStateMap, customFunc, filterMods, getGlobalFuncs, getGlobalParser, getGlobalPredefinedTokens, getRgbValuesFromRgbaString, hexToRgb, normalizeColorTokenValue, parseColor, parseStyle, resetGlobalPredefinedTokens, setGlobalPredefinedTokens, strToRgb, stringifyStyles } from "../utils/styles.js";
+import { getNamedColorHex, getRgbValuesFromRgbaString, hexToRgb, hslToRgbValues, strToRgb } from "../utils/color-math.js";
+import { CSSMap, CUSTOM_UNITS, DIRECTIONS, ParsedColor, RawStyleHandler, StyleHandler, StyleHandlerDefinition, StyleHandlerResult, StyleMap, StylePropValue, StyleValue, StyleValueStateMap, customFunc, filterMods, getGlobalFuncs, getGlobalParser, getGlobalPredefinedTokens, normalizeColorTokenValue, parseColor, parseStyle, resetGlobalPredefinedTokens, setGlobalPredefinedTokens, stringifyStyles } from "../utils/styles.js";
 import { ConfigTokenValue, ConfigTokens, NoType, NotSelector, RecipeStyles, Selector, Styles, StylesInterface, StylesWithoutSelectors, SuffixForSelector, TastyNamedColors, TastyPresetNames } from "../styles/types.js";
 import { ConditionNode } from "../pipeline/conditions.js";
 import { AtRuleContext, ParsedAdvancedState, StateParserContext, createStateParserContext, getGlobalPredefinedStates, setGlobalPredefinedStates } from "../states/index.js";
@@ -10,6 +11,7 @@ import { ParseStateKeyOptions, parseStateKey } from "../pipeline/parseStateKey.j
 import { RenderResult, StyleResult, isSelector, renderStyles } from "../pipeline/index.js";
 import { SheetManager } from "../injector/sheet-manager.js";
 import { StyleInjector } from "../injector/injector.js";
+import { ColorSpace } from "../utils/color-space.js";
 import { TastyPlugin, TastyPluginFactory } from "../plugins/types.js";
 import { TastyConfig, configure, getConfig, getGlobalKeyframes, getGlobalRecipes, hasGlobalKeyframes, hasGlobalRecipes, hasStylesGenerated, isConfigLocked, isTestEnvironment, resetConfig } from "../config.js";
 import { okhslFunc, okhslPlugin } from "../plugins/okhsl-plugin.js";
@@ -26,7 +28,7 @@ import { dotize } from "../utils/dotize.js";
 import { mergeStyles } from "../utils/merge-styles.js";
 import { resolveRecipes } from "../utils/resolve-recipes.js";
 import { deprecationWarning, warn } from "../utils/warnings.js";
-import { hslToRgbValues, processTokens, stringifyTokens } from "../utils/process-tokens.js";
+import { processTokens, stringifyTokens } from "../utils/process-tokens.js";
 import { TypographyPreset, generateTypographyTokens } from "../utils/typography.js";
 import { tastyDebug } from "../debug.js";
-export { type AtRuleContext, BASE_STYLES, BLOCK_INNER_STYLES, BLOCK_OUTER_STYLES, BLOCK_STYLES, type BaseStyleProps, type BlockInnerStyleProps, type BlockOuterStyleProps, type BlockStyleProps, Bucket, CHUNK_NAMES, COLOR_STYLES, CONTAINER_STYLES, CSSMap, type CSSProperties, CUSTOM_UNITS, CacheMetrics, type ChunkInfo, type ChunkName, type ColorStyleProps, type ConditionNode, type ConfigTokenValue, type ConfigTokens, type ContainerStyleProps, DIMENSION_STYLES, DIRECTIONS, type DimensionStyleProps, DisposeFunction, FLOW_STYLES, type FlowStyleProps, type GlobalStyledProps, INNER_STYLES, InjectResult, type InnerStyleProps, KeyframesCacheEntry, KeyframesInfo, KeyframesResult, KeyframesSteps, type ModValue, type Mods, type NoType, type NotSelector, OUTER_STYLES, type OuterStyleProps, POSITION_STYLES, type ParseStateKeyOptions, type ParsedAdvancedState, ParsedColor, type ParserOptions, type PositionStyleProps, type ProcessedStyle, PropertyDefinition, PropertyOptions, type Props, RawCSSResult, RawStyleHandler, type RecipeStyles, type RenderResult, RootRegistry, RuleInfo, STYLE_TO_CHUNK, type Selector, SheetInfo, SheetManager, type ShortGridStyles, type StateParserContext, type StyleDetails, type StyleDetailsPart, StyleHandler, StyleHandlerDefinition, StyleHandlerResult, StyleInjector, StyleInjectorConfig, StyleMap, StyleParser, StylePropValue, type StyleResult, StyleRule, StyleValue, StyleValueStateMap, type Styles, type StylesInterface, type StylesWithoutSelectors, type SuffixForSelector, TEXT_STYLES, type TagName, type TastyConfig, type TastyExtensionConfig, type TastyNamedColors, type TastyPlugin, type TastyPluginFactory, type TastyPresetNames, type TastyThemeNames, type TextStyleProps, type TokenValue, type Tokens, TypographyPreset, type UnitHandler, allocateClassName, categorizeStyleKeys, cleanup, color, configure, createInjector, createStateParserContext, customFunc, deprecationWarning, destroy, dotize, filterBaseProps, filterMods, generateTypographyTokens, getConfig, getCssText, getCssTextForNode, getGlobalFuncs, getGlobalKeyframes, getGlobalParser, getGlobalPredefinedStates, getGlobalPredefinedTokens, getGlobalRecipes, getIsTestEnvironment, getRawCSSText, getRgbValuesFromRgbaString, hasGlobalKeyframes, hasGlobalRecipes, hasStylesGenerated, hexToRgb, hslToRgbValues, inject, injectGlobal, injectRawCSS, injector, isConfigLocked, isPropertyDefined, isSelector, isTestEnvironment, keyframes, mergeStyles, _modAttrs as modAttrs, normalizeColorTokenValue, okhslFunc, okhslPlugin, parseColor, parseStateKey, parseStyle, processTokens, property, renderStyles, resetConfig, resetGlobalPredefinedTokens, resolveRecipes, setGlobalPredefinedStates, setGlobalPredefinedTokens, strToRgb, stringifyStyles, stringifyTokens, styleHandlers, tastyDebug, trackRef, warn };
+export { type AtRuleContext, BASE_STYLES, BLOCK_INNER_STYLES, BLOCK_OUTER_STYLES, BLOCK_STYLES, type BaseStyleProps, type BlockInnerStyleProps, type BlockOuterStyleProps, type BlockStyleProps, Bucket, CHUNK_NAMES, COLOR_STYLES, CONTAINER_STYLES, CSSMap, type CSSProperties, CUSTOM_UNITS, CacheMetrics, type ChunkInfo, type ChunkName, type ColorSpace, type ColorStyleProps, type ConditionNode, type ConfigTokenValue, type ConfigTokens, type ContainerStyleProps, DIMENSION_STYLES, DIRECTIONS, type DimensionStyleProps, DisposeFunction, FLOW_STYLES, type FlowStyleProps, type GlobalStyledProps, INNER_STYLES, InjectResult, type InnerStyleProps, KeyframesCacheEntry, KeyframesInfo, KeyframesResult, KeyframesSteps, type ModValue, type Mods, type NoType, type NotSelector, OUTER_STYLES, type OuterStyleProps, POSITION_STYLES, type ParseStateKeyOptions, type ParsedAdvancedState, ParsedColor, type ParserOptions, type PositionStyleProps, type ProcessedStyle, PropertyDefinition, PropertyOptions, type Props, RawCSSResult, RawStyleHandler, type RecipeStyles, type RenderResult, RootRegistry, RuleInfo, STYLE_TO_CHUNK, type Selector, SheetInfo, SheetManager, type ShortGridStyles, type StateParserContext, type StyleDetails, type StyleDetailsPart, StyleHandler, StyleHandlerDefinition, StyleHandlerResult, StyleInjector, StyleInjectorConfig, StyleMap, StyleParser, StylePropValue, type StyleResult, StyleRule, StyleValue, StyleValueStateMap, type Styles, type StylesInterface, type StylesWithoutSelectors, type SuffixForSelector, TEXT_STYLES, type TagName, type TastyConfig, type TastyExtensionConfig, type TastyNamedColors, type TastyPlugin, type TastyPluginFactory, type TastyPresetNames, type TastyThemeNames, type TextStyleProps, type TokenValue, type Tokens, TypographyPreset, type UnitHandler, allocateClassName, categorizeStyleKeys, cleanup, color, configure, createInjector, createStateParserContext, customFunc, deprecationWarning, destroy, dotize, filterBaseProps, filterMods, generateTypographyTokens, getConfig, getCssText, getCssTextForNode, getGlobalFuncs, getGlobalKeyframes, getGlobalParser, getGlobalPredefinedStates, getGlobalPredefinedTokens, getGlobalRecipes, getIsTestEnvironment, getNamedColorHex, getRawCSSText, getRgbValuesFromRgbaString, hasGlobalKeyframes, hasGlobalRecipes, hasStylesGenerated, hexToRgb, hslToRgbValues, inject, injectGlobal, injectRawCSS, injector, isConfigLocked, isPropertyDefined, isSelector, isTestEnvironment, keyframes, mergeStyles, _modAttrs as modAttrs, normalizeColorTokenValue, okhslFunc, okhslPlugin, parseColor, parseStateKey, parseStyle, processTokens, property, renderStyles, resetConfig, resetGlobalPredefinedTokens, resolveRecipes, setGlobalPredefinedStates, setGlobalPredefinedTokens, strToRgb, stringifyStyles, stringifyTokens, styleHandlers, tastyDebug, trackRef, warn };

package/dist/core/index.js

@@ -1,8 +1,8 @@
+import { getNamedColorHex, getRgbValuesFromRgbaString, hexToRgb, hslToRgbValues, strToRgb } from "../utils/color-math.js";
 import { Bucket } from "../parser/types.js";
 import { StyleParser } from "../parser/parser.js";
 import { okhslFunc, okhslPlugin } from "../plugins/okhsl-plugin.js";
-import { hslToRgbValues, processTokens, stringifyTokens } from "../utils/process-tokens.js";
-import { CUSTOM_UNITS, DIRECTIONS, customFunc, filterMods, getGlobalFuncs, getGlobalParser, getGlobalPredefinedTokens, getRgbValuesFromRgbaString, hexToRgb, normalizeColorTokenValue, parseColor, parseStyle, resetGlobalPredefinedTokens, setGlobalPredefinedTokens, strToRgb, stringifyStyles } from "../utils/styles.js";
+import { CUSTOM_UNITS, DIRECTIONS, customFunc, filterMods, getGlobalFuncs, getGlobalParser, getGlobalPredefinedTokens, normalizeColorTokenValue, parseColor, parseStyle, resetGlobalPredefinedTokens, setGlobalPredefinedTokens, stringifyStyles } from "../utils/styles.js";
 import { deprecationWarning, warn } from "../utils/warnings.js";
 import { styleHandlers } from "../styles/predefined.js";
 import { SheetManager } from "../injector/sheet-manager.js";
@@ -20,7 +20,8 @@ import { _modAttrs } from "../utils/mod-attrs.js";
 import { dotize } from "../utils/dotize.js";
 import { mergeStyles } from "../utils/merge-styles.js";
 import { resolveRecipes } from "../utils/resolve-recipes.js";
+import { processTokens, stringifyTokens } from "../utils/process-tokens.js";
 import { generateTypographyTokens } from "../utils/typography.js";
 import { tastyDebug } from "../debug.js";
 
-export { BASE_STYLES, BLOCK_INNER_STYLES, BLOCK_OUTER_STYLES, BLOCK_STYLES, Bucket, CHUNK_NAMES, COLOR_STYLES, CONTAINER_STYLES, CUSTOM_UNITS, DIMENSION_STYLES, DIRECTIONS, FLOW_STYLES, INNER_STYLES, OUTER_STYLES, POSITION_STYLES, STYLE_TO_CHUNK, SheetManager, StyleInjector, StyleParser, TEXT_STYLES, allocateClassName, categorizeStyleKeys, cleanup, color, configure, createInjector, createStateParserContext, customFunc, deprecationWarning, destroy, dotize, filterBaseProps, filterMods, generateTypographyTokens, getConfig, getCssText, getCssTextForNode, getGlobalFuncs, getGlobalKeyframes, getGlobalParser, getGlobalPredefinedStates, getGlobalPredefinedTokens, getGlobalRecipes, getIsTestEnvironment, getRawCSSText, getRgbValuesFromRgbaString, hasGlobalKeyframes, hasGlobalRecipes, hasStylesGenerated, hexToRgb, hslToRgbValues, inject, injectGlobal, injectRawCSS, injector, isConfigLocked, isPropertyDefined, isSelector, isTestEnvironment, keyframes, mergeStyles, _modAttrs as modAttrs, normalizeColorTokenValue, okhslFunc, okhslPlugin, parseColor, parseStateKey, parseStyle, processTokens, property, renderStyles, resetConfig, resetGlobalPredefinedTokens, resolveRecipes, setGlobalPredefinedStates, setGlobalPredefinedTokens, strToRgb, stringifyStyles, stringifyTokens, styleHandlers, tastyDebug, trackRef, warn };
+export { BASE_STYLES, BLOCK_INNER_STYLES, BLOCK_OUTER_STYLES, BLOCK_STYLES, Bucket, CHUNK_NAMES, COLOR_STYLES, CONTAINER_STYLES, CUSTOM_UNITS, DIMENSION_STYLES, DIRECTIONS, FLOW_STYLES, INNER_STYLES, OUTER_STYLES, POSITION_STYLES, STYLE_TO_CHUNK, SheetManager, StyleInjector, StyleParser, TEXT_STYLES, allocateClassName, categorizeStyleKeys, cleanup, color, configure, createInjector, createStateParserContext, customFunc, deprecationWarning, destroy, dotize, filterBaseProps, filterMods, generateTypographyTokens, getConfig, getCssText, getCssTextForNode, getGlobalFuncs, getGlobalKeyframes, getGlobalParser, getGlobalPredefinedStates, getGlobalPredefinedTokens, getGlobalRecipes, getIsTestEnvironment, getNamedColorHex, getRawCSSText, getRgbValuesFromRgbaString, hasGlobalKeyframes, hasGlobalRecipes, hasStylesGenerated, hexToRgb, hslToRgbValues, inject, injectGlobal, injectRawCSS, injector, isConfigLocked, isPropertyDefined, isSelector, isTestEnvironment, keyframes, mergeStyles, _modAttrs as modAttrs, normalizeColorTokenValue, okhslFunc, okhslPlugin, parseColor, parseStateKey, parseStyle, processTokens, property, renderStyles, resetConfig, resetGlobalPredefinedTokens, resolveRecipes, setGlobalPredefinedStates, setGlobalPredefinedTokens, strToRgb, stringifyStyles, stringifyTokens, styleHandlers, tastyDebug, trackRef, warn };