@cube-dev/ui-kit 0.0.0-canary-855d62e → 0.0.0-canary-29fafcf

package/dist/tasty/config.js

@@ -1,343 +0,0 @@
-/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-855d62e | 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).
-*/
-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)"
-	}
-};
-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);
-	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 comma-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

@@ -1 +0,0 @@
-{"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   * Recipes are resolved before the style pipeline by merging in order:\n   * `recipe_1 → recipe_2 → ... → component styles`.\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 */\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\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 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 comma-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

@@ -1,200 +0,0 @@
-
-//#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