@tenphi/tasty 0.1.0

package/dist/config.mjs

@@ -0,0 +1,231 @@
+import { CUSTOM_UNITS, getGlobalFuncs, getGlobalParser, normalizeColorTokenValue, setGlobalPredefinedTokens } from "./utils/styles.mjs";
+import { isDevEnv } from "./utils/is-dev-env.mjs";
+import { normalizeHandlerDefinition, registerHandler } from "./styles/predefined.mjs";
+import { StyleInjector } from "./injector/injector.mjs";
+import { setGlobalPredefinedStates } from "./states/index.mjs";
+import { isSelector } from "./pipeline/index.mjs";
+
+//#region src/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;
+const GLOBAL_INJECTOR_KEY = "__TASTY_GLOBAL_INJECTOR__";
+/**
+* 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
+	};
+}
+/**
+* Check if styles have been generated (configuration is locked)
+*/
+function hasStylesGenerated() {
+	return stylesGenerated;
+}
+/**
+* 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;
+}
+/**
+* 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;
+}
+/**
+* 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 '@tenphi/tasty';
+*
+* // 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);
+}
+
+//#endregion
+export { configure, getGlobalRecipes, hasStylesGenerated };
+//# sourceMappingURL=config.mjs.map

package/dist/config.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.mjs","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 } 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 '@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   * 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?: Record<`$${string}`, string | number | boolean> & 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   * 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\ninterface TastyGlobalStorage {\n  [GLOBAL_INJECTOR_KEY]?: StyleInjector;\n}\n\ndeclare global {\n  interface Window {\n    [GLOBAL_INJECTOR_KEY]?: StyleInjector;\n  }\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\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 '@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 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   \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\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  globalProperties = null;\n  globalRecipes = 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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"}

package/dist/css-writer.d.mts

@@ -0,0 +1,45 @@
+//#region src/zero/css-writer.d.ts
+interface CSSWriterOptions {
+  /** Enable source comments in output (e.g., "from: Button.tsx") */
+  devMode?: boolean;
+}
+declare class CSSWriter {
+  private cssBlocks;
+  private outputPath;
+  private devMode;
+  constructor(outputPath: string, options?: CSSWriterOptions);
+  /**
+   * Add CSS block with deduplication key
+   * @param key - Unique key for deduplication
+   * @param css - CSS content
+   * @param source - Optional source file path (used in devMode)
+   */
+  add(key: string, css: string, source?: string): void;
+  /**
+   * Check if a key already exists
+   */
+  has(key: string): boolean;
+  /**
+   * Get the number of CSS blocks
+   */
+  get size(): number;
+  /**
+   * Write all collected CSS to the output file
+   */
+  write(): void;
+  /**
+   * Get all CSS as string (for testing or in-memory use)
+   */
+  getCSS(): string;
+  /**
+   * Clear all collected CSS
+   */
+  clear(): void;
+  /**
+   * Get the output path
+   */
+  getOutputPath(): string;
+}
+//#endregion
+export { CSSWriter };
+//# sourceMappingURL=css-writer.d.mts.map

package/dist/css-writer.mjs

@@ -0,0 +1,74 @@
+import * as fs from "fs";
+import * as path from "path";
+
+//#region src/zero/css-writer.ts
+var CSSWriter = class {
+	cssBlocks = /* @__PURE__ */ new Map();
+	outputPath;
+	devMode;
+	constructor(outputPath, options = {}) {
+		this.outputPath = outputPath;
+		this.devMode = options.devMode ?? false;
+	}
+	/**
+	* Add CSS block with deduplication key
+	* @param key - Unique key for deduplication
+	* @param css - CSS content
+	* @param source - Optional source file path (used in devMode)
+	*/
+	add(key, css, source) {
+		this.cssBlocks.set(key, {
+			css,
+			source
+		});
+	}
+	/**
+	* Check if a key already exists
+	*/
+	has(key) {
+		return this.cssBlocks.has(key);
+	}
+	/**
+	* Get the number of CSS blocks
+	*/
+	get size() {
+		return this.cssBlocks.size;
+	}
+	/**
+	* Write all collected CSS to the output file
+	*/
+	write() {
+		const outputDir = path.dirname(this.outputPath);
+		if (!fs.existsSync(outputDir)) fs.mkdirSync(outputDir, { recursive: true });
+		const cssBlocks = [];
+		for (const block of this.cssBlocks.values()) if (this.devMode && block.source) cssBlocks.push(`/* from: ${block.source} */\n${block.css}`);
+		else cssBlocks.push(block.css);
+		const css = cssBlocks.join("\n\n");
+		fs.writeFileSync(this.outputPath, `/* Generated by @tenphi/tasty/zero - DO NOT EDIT */\n\n` + css);
+	}
+	/**
+	* Get all CSS as string (for testing or in-memory use)
+	*/
+	getCSS() {
+		const cssBlocks = [];
+		for (const block of this.cssBlocks.values()) if (this.devMode && block.source) cssBlocks.push(`/* from: ${block.source} */\n${block.css}`);
+		else cssBlocks.push(block.css);
+		return cssBlocks.join("\n\n");
+	}
+	/**
+	* Clear all collected CSS
+	*/
+	clear() {
+		this.cssBlocks.clear();
+	}
+	/**
+	* Get the output path
+	*/
+	getOutputPath() {
+		return this.outputPath;
+	}
+};
+
+//#endregion
+export { CSSWriter };
+//# sourceMappingURL=css-writer.mjs.map

package/dist/css-writer.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"css-writer.mjs","names":[],"sources":["../src/zero/css-writer.ts"],"sourcesContent":["import * as fs from 'fs';\nimport * as path from 'path';\n\nexport interface CSSWriterOptions {\n  /** Enable source comments in output (e.g., \"from: Button.tsx\") */\n  devMode?: boolean;\n}\n\ninterface CSSBlock {\n  css: string;\n  source?: string;\n}\n\nexport class CSSWriter {\n  private cssBlocks = new Map<string, CSSBlock>();\n  private outputPath: string;\n  private devMode: boolean;\n\n  constructor(outputPath: string, options: CSSWriterOptions = {}) {\n    this.outputPath = outputPath;\n    this.devMode = options.devMode ?? false;\n  }\n\n  /**\n   * Add CSS block with deduplication key\n   * @param key - Unique key for deduplication\n   * @param css - CSS content\n   * @param source - Optional source file path (used in devMode)\n   */\n  add(key: string, css: string, source?: string): void {\n    this.cssBlocks.set(key, { css, source });\n  }\n\n  /**\n   * Check if a key already exists\n   */\n  has(key: string): boolean {\n    return this.cssBlocks.has(key);\n  }\n\n  /**\n   * Get the number of CSS blocks\n   */\n  get size(): number {\n    return this.cssBlocks.size;\n  }\n\n  /**\n   * Write all collected CSS to the output file\n   */\n  write(): void {\n    const outputDir = path.dirname(this.outputPath);\n\n    // Ensure directory exists\n    if (!fs.existsSync(outputDir)) {\n      fs.mkdirSync(outputDir, { recursive: true });\n    }\n\n    // Combine all CSS blocks with optional source comments\n    const cssBlocks: string[] = [];\n    for (const block of this.cssBlocks.values()) {\n      if (this.devMode && block.source) {\n        cssBlocks.push(`/* from: ${block.source} */\\n${block.css}`);\n      } else {\n        cssBlocks.push(block.css);\n      }\n    }\n    const css = cssBlocks.join('\\n\\n');\n\n    // Add header comment\n    const header = `/* Generated by @tenphi/tasty/zero - DO NOT EDIT */\\n\\n`;\n\n    fs.writeFileSync(this.outputPath, header + css);\n  }\n\n  /**\n   * Get all CSS as string (for testing or in-memory use)\n   */\n  getCSS(): string {\n    const cssBlocks: string[] = [];\n    for (const block of this.cssBlocks.values()) {\n      if (this.devMode && block.source) {\n        cssBlocks.push(`/* from: ${block.source} */\\n${block.css}`);\n      } else {\n        cssBlocks.push(block.css);\n      }\n    }\n    return cssBlocks.join('\\n\\n');\n  }\n\n  /**\n   * Clear all collected CSS\n   */\n  clear(): void {\n    this.cssBlocks.clear();\n  }\n\n  /**\n   * Get the output path\n   */\n  getOutputPath(): string {\n    return this.outputPath;\n  }\n}\n"],"mappings":";;;;AAaA,IAAa,YAAb,MAAuB;CACrB,AAAQ,4BAAY,IAAI,KAAuB;CAC/C,AAAQ;CACR,AAAQ;CAER,YAAY,YAAoB,UAA4B,EAAE,EAAE;AAC9D,OAAK,aAAa;AAClB,OAAK,UAAU,QAAQ,WAAW;;;;;;;;CASpC,IAAI,KAAa,KAAa,QAAuB;AACnD,OAAK,UAAU,IAAI,KAAK;GAAE;GAAK;GAAQ,CAAC;;;;;CAM1C,IAAI,KAAsB;AACxB,SAAO,KAAK,UAAU,IAAI,IAAI;;;;;CAMhC,IAAI,OAAe;AACjB,SAAO,KAAK,UAAU;;;;;CAMxB,QAAc;EACZ,MAAM,YAAY,KAAK,QAAQ,KAAK,WAAW;AAG/C,MAAI,CAAC,GAAG,WAAW,UAAU,CAC3B,IAAG,UAAU,WAAW,EAAE,WAAW,MAAM,CAAC;EAI9C,MAAM,YAAsB,EAAE;AAC9B,OAAK,MAAM,SAAS,KAAK,UAAU,QAAQ,CACzC,KAAI,KAAK,WAAW,MAAM,OACxB,WAAU,KAAK,YAAY,MAAM,OAAO,OAAO,MAAM,MAAM;MAE3D,WAAU,KAAK,MAAM,IAAI;EAG7B,MAAM,MAAM,UAAU,KAAK,OAAO;AAKlC,KAAG,cAAc,KAAK,YAFP,4DAE4B,IAAI;;;;;CAMjD,SAAiB;EACf,MAAM,YAAsB,EAAE;AAC9B,OAAK,MAAM,SAAS,KAAK,UAAU,QAAQ,CACzC,KAAI,KAAK,WAAW,MAAM,OACxB,WAAU,KAAK,YAAY,MAAM,OAAO,OAAO,MAAM,MAAM;MAE3D,WAAU,KAAK,MAAM,IAAI;AAG7B,SAAO,UAAU,KAAK,OAAO;;;;;CAM/B,QAAc;AACZ,OAAK,UAAU,OAAO;;;;;CAMxB,gBAAwB;AACtB,SAAO,KAAK"}

package/dist/debug.d.ts

@@ -0,0 +1,204 @@
+//#region src/debug.d.ts
+/**
+ * Debug utilities for inspecting tasty-generated CSS at runtime
+ */
+declare global {
+  interface Window {
+    tastyDebug?: typeof tastyDebug;
+  }
+}
+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: {
+    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: {
+    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: {
+    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