@cube-dev/ui-kit 0.113.1 → 0.115.0

package/dist/tasty/config.js

@@ -0,0 +1,401 @@
+/** @license MIT | @cube-dev/ui-kit v0.115.0 | Cube Dev Team */
+import { CUSTOM_UNITS, getGlobalFuncs, getGlobalParser, normalizeColorTokenValue, resetGlobalPredefinedTokens, setGlobalPredefinedTokens } from "./utils/styles.js";
+import { isDevEnv } from "./utils/is-dev-env.js";
+import { normalizeHandlerDefinition, registerHandler, resetHandlers } from "./styles/predefined.js";
+import { StyleInjector } from "./injector/injector.js";
+import { setGlobalPredefinedStates } from "./states/index.js";
+import { clearPipelineCache, isSelector } from "./pipeline/index.js";
+
+//#region src/tasty/config.ts
+/**
+* Tasty Configuration Module
+*
+* Centralizes all tasty configuration, including:
+* - Style injector settings (nonce, cleanup thresholds, etc.)
+* - Global predefined states for advanced state mapping
+* - stylesGenerated flag that locks configuration after first style generation
+*
+* Configuration must be done BEFORE any styles are generated.
+* After the first `inject()` call, configuration is locked and attempts to
+* reconfigure will emit a warning and be ignored.
+*/
+const emittedWarnings = /* @__PURE__ */ new Set();
+const devMode = isDevEnv();
+/**
+* Emit a warning only once
+*/
+function warnOnce(key, message) {
+	if (devMode && !emittedWarnings.has(key)) {
+		emittedWarnings.add(key);
+		console.warn(message);
+	}
+}
+let stylesGenerated = false;
+let currentConfig = null;
+let globalKeyframes = null;
+let globalProperties = null;
+let globalRecipes = null;
+/**
+* Internal properties required by tasty core features.
+* These are always injected when styles are first generated.
+* Keys use tasty token syntax (#name for colors, $name for other properties).
+*
+* For properties with CSS @property-compatible types (length, time, number, color),
+* an `initialValue` is provided so the property works even without a project-level token.
+*/
+const INTERNAL_PROPERTIES = {
+	"#tasty-second-fill": {
+		inherits: false,
+		initialValue: "transparent"
+	},
+	"#current": {
+		inherits: true,
+		initialValue: "transparent"
+	},
+	"#white": {
+		inherits: true,
+		initialValue: "rgb(255 255 255)"
+	},
+	"#black": {
+		inherits: true,
+		initialValue: "rgb(0 0 0)"
+	},
+	$gap: {
+		syntax: "<length>",
+		inherits: true,
+		initialValue: "4px"
+	},
+	$radius: {
+		syntax: "<length>",
+		inherits: true,
+		initialValue: "6px"
+	},
+	"$border-width": {
+		syntax: "<length>",
+		inherits: true,
+		initialValue: "1px"
+	},
+	"$outline-width": {
+		syntax: "<length>",
+		inherits: true,
+		initialValue: "3px"
+	},
+	$transition: {
+		syntax: "<time>",
+		inherits: true,
+		initialValue: "80ms"
+	},
+	"$sharp-radius": {
+		syntax: "<length>",
+		inherits: true,
+		initialValue: "0px"
+	},
+	"$bold-font-weight": {
+		syntax: "<number>",
+		inherits: true,
+		initialValue: "700"
+	}
+};
+/**
+* Internal token defaults that cannot be expressed as CSS @property initial values
+* (e.g. font stacks, keyword colors). These are injected as :root CSS variables.
+* Consuming projects override them by setting their own tokens on :root.
+*
+* Keys are raw CSS custom property names (--name).
+*/
+const INTERNAL_TOKENS = {
+	"--font": "system-ui, -apple-system, \"Segoe UI\", Roboto, Helvetica, Arial, \"Apple Color Emoji\", \"Segoe UI Emoji\", sans-serif",
+	"--monospace-font": "ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, \"Liberation Mono\", \"Courier New\", monospace",
+	"--border-color": "currentColor"
+};
+const GLOBAL_INJECTOR_KEY = "__TASTY_GLOBAL_INJECTOR__";
+/**
+* Detect if we're running in a test environment
+*/
+function isTestEnvironment() {
+	if (typeof global !== "undefined") {
+		const g = global;
+		if (g.vi || g.jest || g.expect || g.describe || g.it) return true;
+	}
+	if (typeof window !== "undefined" && window.navigator?.userAgent?.includes("jsdom")) return true;
+	if (typeof globalThis !== "undefined") {
+		const gt = globalThis;
+		if (gt.vitest || gt.mocha) return true;
+	}
+	return false;
+}
+/**
+* Create default configuration with optional test environment detection
+*/
+function createDefaultConfig(isTest) {
+	return {
+		maxRulesPerSheet: 8192,
+		unusedStylesThreshold: 500,
+		bulkCleanupDelay: 5e3,
+		idleCleanup: true,
+		forceTextInjection: isTest ?? false,
+		devMode: isDevEnv(),
+		bulkCleanupBatchRatio: .5,
+		unusedStylesMinAgeMs: 1e4
+	};
+}
+/**
+* Mark that styles have been generated (called by injector on first inject)
+* This locks the configuration - no further changes allowed.
+* Also injects internal and global properties.
+*/
+function markStylesGenerated() {
+	if (stylesGenerated) return;
+	stylesGenerated = true;
+	const injector = getGlobalInjector();
+	for (const [token, definition] of Object.entries(INTERNAL_PROPERTIES)) injector.property(token, definition);
+	const internalTokenEntries = Object.entries(INTERNAL_TOKENS);
+	if (internalTokenEntries.length > 0) {
+		const declarations = internalTokenEntries.map(([name, value]) => `${name}: ${value}`).join("; ");
+		injector.injectGlobal([{
+			selector: ":root",
+			declarations
+		}]);
+	}
+	if (globalProperties && Object.keys(globalProperties).length > 0) for (const [token, definition] of Object.entries(globalProperties)) injector.property(token, definition);
+}
+/**
+* Check if styles have been generated (configuration is locked)
+*/
+function hasStylesGenerated() {
+	return stylesGenerated;
+}
+/**
+* Check if any global keyframes are configured.
+* Fast path: returns false if no keyframes were ever set.
+*/
+function hasGlobalKeyframes() {
+	return globalKeyframes !== null && Object.keys(globalKeyframes).length > 0;
+}
+/**
+* Get global keyframes configuration.
+* Returns null if no keyframes configured (fast path for zero-overhead).
+*/
+function getGlobalKeyframes() {
+	return globalKeyframes;
+}
+/**
+* Set global keyframes (called from configure).
+* Internal use only.
+*/
+function setGlobalKeyframes(keyframes) {
+	if (stylesGenerated) {
+		warnOnce("keyframes-after-styles", "[Tasty] Cannot update keyframes after styles have been generated.\nThe new keyframes will be ignored.");
+		return;
+	}
+	globalKeyframes = keyframes;
+}
+/**
+* Set global properties (called from configure).
+* Internal use only.
+*/
+function setGlobalProperties(properties) {
+	if (stylesGenerated) {
+		warnOnce("properties-after-styles", "[Tasty] Cannot update properties after styles have been generated.\nThe new properties will be ignored.");
+		return;
+	}
+	globalProperties = properties;
+}
+/**
+* Check if any global recipes are configured.
+* Fast path: returns false if no recipes were ever set.
+*/
+function hasGlobalRecipes() {
+	return globalRecipes !== null && Object.keys(globalRecipes).length > 0;
+}
+/**
+* Get global recipes configuration.
+* Returns null if no recipes configured (fast path for zero-overhead).
+*/
+function getGlobalRecipes() {
+	return globalRecipes;
+}
+/**
+* Set global recipes (called from configure).
+* Internal use only.
+*/
+function setGlobalRecipes(recipes) {
+	if (stylesGenerated) {
+		warnOnce("recipes-after-styles", "[Tasty] Cannot update recipes after styles have been generated.\nThe new recipes will be ignored.");
+		return;
+	}
+	if (devMode) for (const [name, recipeStyles] of Object.entries(recipes)) for (const key of Object.keys(recipeStyles)) {
+		if (isSelector(key)) warnOnce(`recipe-selector-${name}-${key}`, `[Tasty] Recipe "${name}" contains sub-element key "${key}". Recipes must be flat styles without sub-element keys. Remove the sub-element key from the recipe definition.`);
+		if (key === "recipe") warnOnce(`recipe-recursive-${name}`, `[Tasty] Recipe "${name}" contains a "recipe" key. Recipes cannot reference other recipes. Use space-separated names for composition: recipe: 'base elevated'.`);
+	}
+	globalRecipes = recipes;
+}
+/**
+* Check if configuration is locked (styles have been generated)
+*/
+function isConfigLocked() {
+	return stylesGenerated;
+}
+/**
+* Configure the Tasty style system.
+*
+* Must be called BEFORE any styles are generated (before first render that uses tasty).
+* After styles are generated, configuration is locked and calls to configure() will
+* emit a warning and be ignored.
+*
+* @example
+* ```ts
+* import { configure } from '@cube-dev/ui-kit';
+*
+* // Configure before app renders
+* configure({
+*   nonce: 'abc123',
+*   states: {
+*     '@mobile': '@media(w < 768px)',
+*     '@dark': '@root(theme=dark)',
+*   },
+* });
+* ```
+*/
+function configure(config = {}) {
+	if (stylesGenerated) {
+		warnOnce("configure-after-styles", "[Tasty] Cannot call configure() after styles have been generated.\nConfiguration must be done before the first render. The configuration will be ignored.");
+		return;
+	}
+	let mergedStates = {};
+	let mergedUnits = {};
+	let mergedFuncs = {};
+	let mergedHandlers = {};
+	let mergedTokens = {};
+	let mergedRecipes = {};
+	if (config.plugins) for (const plugin of config.plugins) {
+		if (plugin.states) mergedStates = {
+			...mergedStates,
+			...plugin.states
+		};
+		if (plugin.units) mergedUnits = {
+			...mergedUnits,
+			...plugin.units
+		};
+		if (plugin.funcs) mergedFuncs = {
+			...mergedFuncs,
+			...plugin.funcs
+		};
+		if (plugin.handlers) mergedHandlers = {
+			...mergedHandlers,
+			...plugin.handlers
+		};
+		if (plugin.tokens) mergedTokens = {
+			...mergedTokens,
+			...plugin.tokens
+		};
+		if (plugin.recipes) mergedRecipes = {
+			...mergedRecipes,
+			...plugin.recipes
+		};
+	}
+	if (config.states) mergedStates = {
+		...mergedStates,
+		...config.states
+	};
+	if (config.units) mergedUnits = {
+		...mergedUnits,
+		...config.units
+	};
+	if (config.funcs) mergedFuncs = {
+		...mergedFuncs,
+		...config.funcs
+	};
+	if (config.handlers) mergedHandlers = {
+		...mergedHandlers,
+		...config.handlers
+	};
+	if (config.tokens) mergedTokens = {
+		...mergedTokens,
+		...config.tokens
+	};
+	if (config.recipes) mergedRecipes = {
+		...mergedRecipes,
+		...config.recipes
+	};
+	if (Object.keys(mergedStates).length > 0) setGlobalPredefinedStates(mergedStates);
+	const parser = getGlobalParser();
+	if (config.parserCacheSize !== void 0) parser.updateOptions({ cacheSize: config.parserCacheSize });
+	if (Object.keys(mergedUnits).length > 0) {
+		const currentUnits = parser.getUnits() ?? CUSTOM_UNITS;
+		parser.setUnits({
+			...currentUnits,
+			...mergedUnits
+		});
+	}
+	if (Object.keys(mergedFuncs).length > 0) {
+		const currentFuncs = getGlobalFuncs();
+		const finalFuncs = {
+			...currentFuncs,
+			...mergedFuncs
+		};
+		parser.setFuncs(finalFuncs);
+		Object.assign(currentFuncs, mergedFuncs);
+	}
+	if (config.keyframes) setGlobalKeyframes(config.keyframes);
+	if (config.properties) setGlobalProperties(config.properties);
+	if (Object.keys(mergedHandlers).length > 0) for (const [name, definition] of Object.entries(mergedHandlers)) registerHandler(normalizeHandlerDefinition(name, definition));
+	if (Object.keys(mergedTokens).length > 0) {
+		const processedTokens = {};
+		for (const [key, value] of Object.entries(mergedTokens)) if (key.startsWith("#")) {
+			const normalized = normalizeColorTokenValue(value);
+			if (normalized === null) continue;
+			processedTokens[key] = String(normalized);
+		} else if (value === false) continue;
+		else processedTokens[key] = String(value);
+		setGlobalPredefinedTokens(processedTokens);
+	}
+	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, recipes: _recipes, ...injectorConfig } = config;
+	const fullConfig = {
+		...createDefaultConfig(),
+		...currentConfig,
+		...injectorConfig
+	};
+	currentConfig = fullConfig;
+	const storage = typeof window !== "undefined" ? window : globalThis;
+	storage[GLOBAL_INJECTOR_KEY] = new StyleInjector(fullConfig);
+}
+/**
+* Get the current configuration.
+* If not configured, returns default configuration.
+*/
+function getConfig() {
+	if (!currentConfig) currentConfig = createDefaultConfig(isTestEnvironment());
+	return currentConfig;
+}
+/**
+* Get the global injector instance.
+* Auto-configures with defaults if not already configured.
+*/
+function getGlobalInjector() {
+	const storage = typeof window !== "undefined" ? window : globalThis;
+	if (!storage[GLOBAL_INJECTOR_KEY]) configure();
+	return storage[GLOBAL_INJECTOR_KEY];
+}
+/**
+* Reset configuration (for testing only).
+* Clears the global injector and allows reconfiguration.
+*/
+function resetConfig() {
+	stylesGenerated = false;
+	currentConfig = null;
+	globalKeyframes = null;
+	globalProperties = null;
+	globalRecipes = null;
+	resetGlobalPredefinedTokens();
+	resetHandlers();
+	clearPipelineCache();
+	emittedWarnings.clear();
+	const storage = typeof window !== "undefined" ? window : globalThis;
+	delete storage[GLOBAL_INJECTOR_KEY];
+}
+
+//#endregion
+export { configure, getConfig, getGlobalInjector, getGlobalKeyframes, getGlobalRecipes, hasGlobalKeyframes, hasGlobalRecipes, hasStylesGenerated, isConfigLocked, isTestEnvironment, markStylesGenerated, resetConfig };
+//# sourceMappingURL=config.js.map

package/dist/tasty/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","names":[],"sources":["../../src/tasty/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 } 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 { TastyPlugin } from './plugins/types';\nimport type { RecipeStyles } 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   * 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 '@cube-dev/ui-kit/tasty/plugins';\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 '@cube-dev/ui-kit';\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   * Predefined tokens that are replaced during style parsing.\n   * Token values are processed through the parser (like component tokens).\n   * Use `$name` for custom properties and `#name` for color tokens.\n   *\n   * For color tokens (#name), boolean `true` is converted to `transparent`.\n   *\n   * @example\n   * ```ts\n   * configure({\n   *   tokens: {\n   *     $spacing: '2x',\n   *     '$card-padding': '4x',\n   *     '#accent': '#purple',\n   *     '#surface': '#white',\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: '$card-padding',  // → calc(4 * var(--gap))\n   *     fill: '#surface',          // → var(--white-color)\n   *   },\n   * });\n   * ```\n   */\n  tokens?: {\n    [key: `$${string}`]: string | number | boolean;\n  } & {\n    [key: `#${string}`]: string | number | boolean;\n  };\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   * 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/**\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  // Companion --current-color-rgb is auto-created.\n  '#current': {\n    inherits: true,\n    initialValue: 'transparent',\n  },\n  // White and black are fundamental colors that need explicit initial values.\n  // Companion -rgb properties are auto-created from the color 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\ndeclare global {\n  interface Window {\n    [GLOBAL_INJECTOR_KEY]?: import('./injector/injector').StyleInjector;\n  }\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 any;\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 any;\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\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\n/**\n * Check if any global keyframes are configured.\n * Fast path: returns false if no keyframes were ever set.\n */\nexport function hasGlobalKeyframes(): boolean {\n  return globalKeyframes !== null && Object.keys(globalKeyframes).length > 0;\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}\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      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 * 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 '@cube-dev/ui-kit';\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 mergedTokens: Record<string, string | number | boolean> = {};\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.tokens) {\n        mergedTokens = { ...mergedTokens, ...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.tokens) {\n    mergedTokens = { ...mergedTokens, ...config.tokens };\n  }\n  if (config.recipes) {\n    mergedRecipes = { ...mergedRecipes, ...config.recipes };\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 predefined tokens\n  // Note: Tokens are processed by the classifier, not here.\n  // We just store the raw values; the classifier will process them when encountered.\n  if (Object.keys(mergedTokens).length > 0) {\n    // Store tokens (keys are normalized to lowercase by setGlobalPredefinedTokens)\n    const processedTokens: Record<string, string> = {};\n    for (const [key, value] of Object.entries(mergedTokens)) {\n      if (key.startsWith('#')) {\n        // Color token - use shared helper for boolean handling\n        const normalized = normalizeColorTokenValue(value);\n        if (normalized === null) continue; // Skip false values\n        processedTokens[key] = String(normalized);\n      } else if (value === false) {\n        // Skip false values for non-color tokens\n        continue;\n      } else {\n        processedTokens[key] = String(value);\n      }\n    }\n    setGlobalPredefinedTokens(processedTokens);\n  }\n\n  // Handle recipes\n  if (Object.keys(mergedRecipes).length > 0) {\n    setGlobalRecipes(mergedRecipes);\n  }\n\n  // Create config without states, parser options, plugins, keyframes, properties, handlers, tokens, and recipes (handled separately)\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    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 = typeof window !== 'undefined' ? window : (globalThis as any);\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(): import('./injector/injector').StyleInjector {\n  const storage = typeof window !== 'undefined' ? window : (globalThis as any);\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  globalProperties = null;\n  globalRecipes = null;\n  resetGlobalPredefinedTokens();\n  resetHandlers();\n  clearPipelineCache();\n  emittedWarnings.clear();\n\n  const storage = typeof window !== 'undefined' ? window : (globalThis as any);\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/tasty/debug.d.ts

@@ -0,0 +1,200 @@
+
+//#region src/tasty/debug.d.ts
+/**
+ * Debug utilities for inspecting tasty-generated CSS at runtime
+ */
+type CSSTarget = 'all' | 'global' | 'active' | 'unused' | 'page' | string | string[] | Element;
+interface CssOptions {
+  root?: Document | ShadowRoot;
+  prettify?: boolean;
+  log?: boolean;
+}
+interface ChunkInfo {
+  className: string;
+  chunkName: string | null;
+}
+interface InspectResult {
+  element?: Element | null;
+  classes: string[];
+  chunks: ChunkInfo[];
+  css: string;
+  size: number;
+  rules: number;
+}
+interface CacheMetrics {
+  hits: number;
+  misses: number;
+  bulkCleanups: number;
+  totalInsertions: number;
+  totalUnused: number;
+  stylesCleanedUp: number;
+  cleanupHistory: Array<{
+    timestamp: number;
+    classesDeleted: number;
+    cssSize: number;
+    rulesDeleted: number;
+  }>;
+  startTime: number;
+  unusedHits?: number;
+}
+interface CacheStatus {
+  classes: {
+    active: string[];
+    unused: string[];
+    all: string[];
+  };
+  metrics: CacheMetrics | null;
+}
+interface Definitions {
+  properties: string[];
+  keyframes: Array<{
+    name: string;
+    refCount: number;
+  }>;
+}
+interface SummaryOptions {
+  root?: Document | ShadowRoot;
+  log?: boolean;
+  includePageCSS?: false | true | 'all';
+}
+interface Summary {
+  activeClasses: string[];
+  unusedClasses: string[];
+  totalStyledClasses: string[];
+  activeCSSSize: number;
+  unusedCSSSize: number;
+  globalCSSSize: number;
+  rawCSSSize: number;
+  keyframesCSSSize: number;
+  propertyCSSSize: number;
+  totalCSSSize: number;
+  activeCSS: string;
+  unusedCSS: string;
+  globalCSS: string;
+  rawCSS: string;
+  keyframesCSS: string;
+  propertyCSS: string;
+  allCSS: string;
+  globalRuleCount: number;
+  rawRuleCount: number;
+  keyframesRuleCount: number;
+  propertyRuleCount: number;
+  page?: {
+    css?: string;
+    cssSize: number;
+    ruleCount: number;
+    stylesheetCount: number;
+    skippedStylesheets: number;
+  };
+  metrics: CacheMetrics | null;
+  definedProperties: string[];
+  definedKeyframes: Array<{
+    name: string;
+    refCount: number;
+  }>;
+  propertyCount: number;
+  keyframeCount: number;
+  cleanupSummary: {
+    enabled: boolean;
+    totalCleanups: number;
+    totalClassesDeleted: number;
+    totalCssDeleted: number;
+    totalRulesDeleted: number;
+    averageClassesPerCleanup: number;
+    averageCssPerCleanup: number;
+    averageRulesPerCleanup: number;
+    lastCleanup?: {
+      timestamp: number;
+      date: string;
+      classesDeleted: number;
+      cssSize: number;
+      rulesDeleted: number;
+    };
+  };
+  chunkBreakdown: {
+    byChunk: Record<string, {
+      classes: string[];
+      cssSize: number;
+      ruleCount: number;
+    }>;
+    totalChunkTypes: number;
+  };
+}
+/**
+ * Concise tastyDebug API for inspecting styles at runtime
+ */
+declare const tastyDebug: {
+  css(target: CSSTarget, opts?: CssOptions): string;
+  inspect(target: string | Element, opts?: {
+    root?: Document | ShadowRoot;
+  }): InspectResult;
+  cache(opts?: {
+    root?: Document | ShadowRoot;
+    includeHistory?: boolean;
+  }): CacheStatus;
+  cleanup(opts?: {
+    root?: Document | ShadowRoot;
+  }): void;
+  metrics(opts?: {
+    root?: Document | ShadowRoot;
+  }): CacheMetrics | null;
+  resetMetrics(opts?: {
+    root?: Document | ShadowRoot;
+  }): void;
+  /**
+   * Get breakdown of styles by chunk type.
+   *
+   * With style chunking enabled, styles are split into logical chunks
+   * (appearance, font, dimension, container, etc.) for better caching
+   * and CSS reuse.
+   *
+   * @param opts - Options including root document/shadow root
+   * @returns Breakdown by chunk type with class counts and CSS sizes
+   */
+  chunks(opts?: {
+    root?: Document | ShadowRoot;
+    log?: boolean;
+  }): {
+    byChunk: Record<string, {
+      classes: string[];
+      cssSize: number;
+      ruleCount: number;
+    }>;
+    totalChunkTypes: number;
+    totalClasses: number;
+  };
+  getGlobalTypeCSS(type: "global" | "raw" | "keyframes" | "property", opts?: {
+    root?: Document | ShadowRoot;
+  }): {
+    css: string;
+    ruleCount: number;
+    size: number;
+  };
+  defs(opts?: {
+    root?: Document | ShadowRoot;
+  }): Definitions;
+  summary(opts?: SummaryOptions): Summary;
+  pageCSS(opts?: {
+    root?: Document | ShadowRoot;
+    prettify?: boolean;
+    log?: boolean;
+    includeCrossOrigin?: boolean;
+  }): string;
+  pageStats(opts?: {
+    root?: Document | ShadowRoot;
+    includeCrossOrigin?: boolean;
+  }): {
+    cssSize: number;
+    ruleCount: number;
+    stylesheetCount: number;
+    skippedStylesheets: number;
+  };
+  install(): void;
+  log(target: CSSTarget, opts?: CssOptions & {
+    title?: string;
+  }): void;
+  help(): void;
+};
+//#endregion
+export { tastyDebug };
+//# sourceMappingURL=debug.d.ts.map