@tenphi/tasty 1.2.0 → 1.4.0

package/dist/injector/injector.js

@@ -11,11 +11,13 @@ import { formatCounterStyleDeclarations } from "../counter-style/index.js";
 function generateClassName(counter) {
 	return `t${counter}`;
 }
-var StyleInjector = class {
+var StyleInjector = class StyleInjector {
 	sheetManager;
 	config;
-	cleanupScheduled = false;
 	globalRuleCounter = 0;
+	lastGCTime = 0;
+	backgroundSweepTimeout = null;
+	pendingGCHandle = null;
 	/** @internal — exposed for debug utilities only */
 	get _sheetManager() {
 		return this.sheetManager;
@@ -23,6 +25,21 @@ var StyleInjector = class {
 	constructor(config = {}) {
 		this.config = config;
 		this.sheetManager = new SheetManager(config);
+		if (config.gc?.auto && typeof document !== "undefined") {
+			const interval = config.gc.autoInterval ?? 3e5;
+			const scheduleNext = () => {
+				this.backgroundSweepTimeout = setTimeout(() => {
+					const doSweep = () => {
+						this.sheetManager.pruneDisconnectedRoots();
+						for (const root of this.sheetManager.getActiveRoots()) this.gc({ root });
+						scheduleNext();
+					};
+					if (typeof requestIdleCallback !== "undefined") requestIdleCallback(() => doSweep());
+					else doSweep();
+				}, interval);
+			};
+			scheduleNext();
+		}
 	}
 	/**
 	* Allocate a className for a cacheKey without injecting styles yet.
@@ -198,17 +215,14 @@ var StyleInjector = class {
 		};
 	}
 	/**
-	* Dispose of a className
+	* Dispose of a className (decrements refCount only).
 	*/
 	dispose(className, registry) {
 		const currentRefCount = registry.refCounts.get(className);
 		if (currentRefCount == null || currentRefCount <= 0) return;
 		const newRefCount = currentRefCount - 1;
 		registry.refCounts.set(className, newRefCount);
-		if (newRefCount === 0) {
-			if (registry.metrics) registry.metrics.totalUnused++;
-			this.sheetManager.checkCleanupNeeded(registry);
-		}
+		if (newRefCount === 0 && registry.metrics) registry.metrics.totalUnused++;
 	}
 	/**
 	* Force bulk cleanup of unused styles
@@ -450,12 +464,121 @@ var StyleInjector = class {
 			}
 		}
 	}
+	static TOUCH_THROTTLE_MS = 5e3;
+	static TASTY_CLASS_RE = /^t\d+$/;
+	/**
+	* Record a render-time usage hit for one or more classNames.
+	* Handles space-separated multi-chunk classNames.
+	* No-op on the server.
+	*/
+	touch(className, options) {
+		if (typeof document === "undefined") return;
+		if (!this.config.gc) return;
+		const root = options?.root || document;
+		const registry = this.sheetManager.getRegistry(root);
+		const now = Date.now();
+		const parts = className.indexOf(" ") === -1 ? [className] : className.split(" ");
+		for (const cls of parts) {
+			if (!StyleInjector.TASTY_CLASS_RE.test(cls)) continue;
+			if (!registry.rules.has(cls)) continue;
+			const entry = registry.usageMap.get(cls);
+			if (entry) {
+				entry.hitCount++;
+				if (now - entry.lastUsedAt > StyleInjector.TOUCH_THROTTLE_MS) entry.lastUsedAt = now;
+			} else registry.usageMap.set(cls, {
+				hitCount: 1,
+				lastUsedAt: now
+			});
+		}
+	}
+	/**
+	* Synchronous garbage collection.
+	*
+	* 1. Scans the DOM for live tasty classNames (safety guard).
+	* 2. Scores each non-live className via popularity-weighted TTL.
+	* 3. Marks evictable styles with refCount = 0 and deletes them.
+	* 4. Optionally enforces a hard `cacheCapacity` cap.
+	*
+	* @returns Number of styles evicted.
+	*/
+	gc(options) {
+		if (typeof document === "undefined") return 0;
+		if (this.pendingGCHandle != null) {
+			if (typeof cancelIdleCallback !== "undefined") cancelIdleCallback(this.pendingGCHandle);
+			this.pendingGCHandle = null;
+		}
+		const root = options?.root || document;
+		const registry = this.sheetManager.getRegistry(root);
+		const baseMaxAge = options?.baseMaxAge ?? this.config.gc?.baseMaxAge ?? 6e4;
+		const cacheCapacity = options?.cacheCapacity ?? this.config.gc?.cacheCapacity;
+		const now = Date.now();
+		const liveClasses = /* @__PURE__ */ new Set();
+		for (const el of root.querySelectorAll("[class]")) for (const token of el.classList) if (StyleInjector.TASTY_CLASS_RE.test(token)) liveClasses.add(token);
+		let swept = 0;
+		for (const [className, usage] of registry.usageMap) {
+			if (liveClasses.has(className)) continue;
+			if ((registry.refCounts.get(className) ?? 0) > 0) continue;
+			if (now - usage.lastUsedAt > baseMaxAge * Math.log2(usage.hitCount + 1)) {
+				registry.usageMap.delete(className);
+				swept++;
+			}
+		}
+		if (cacheCapacity && registry.usageMap.size > cacheCapacity) {
+			const scored = [];
+			for (const [className, usage] of registry.usageMap) {
+				if (liveClasses.has(className)) continue;
+				if ((registry.refCounts.get(className) ?? 0) > 0) continue;
+				const age = now - usage.lastUsedAt;
+				scored.push({
+					className,
+					score: usage.hitCount * Math.exp(-age / baseMaxAge)
+				});
+			}
+			if (scored.length > 0) {
+				scored.sort((a, b) => a.score - b.score);
+				const toEvict = registry.usageMap.size - cacheCapacity;
+				for (let i = 0; i < Math.min(toEvict, scored.length); i++) {
+					const { className } = scored[i];
+					registry.usageMap.delete(className);
+					swept++;
+				}
+			}
+		}
+		if (swept > 0) this.sheetManager.forceCleanup(registry);
+		this.lastGCTime = Date.now();
+		return swept;
+	}
+	/**
+	* Event-driven GC with cooldown.
+	* Skips if called within `cooldown` ms of the last run.
+	* Schedules the actual GC via `requestIdleCallback` when available.
+	*/
+	maybeGC(options) {
+		if (typeof document === "undefined") return;
+		const cooldown = this.config.gc?.cooldown ?? 3e4;
+		const now = Date.now();
+		if (now - this.lastGCTime < cooldown) return;
+		this.lastGCTime = now;
+		if (typeof requestIdleCallback !== "undefined") this.pendingGCHandle = requestIdleCallback(() => {
+			this.pendingGCHandle = null;
+			this.gc(options);
+		});
+		else this.gc(options);
+	}
 	/**
 	* Destroy all resources for a root
 	*/
 	destroy(root) {
 		const targetRoot = root || document;
 		this.sheetManager.cleanup(targetRoot);
+		if (this.backgroundSweepTimeout && !this.sheetManager.hasActiveRoots()) {
+			clearTimeout(this.backgroundSweepTimeout);
+			this.backgroundSweepTimeout = null;
+			if (this.pendingGCHandle != null) {
+				if (typeof cancelIdleCallback !== "undefined") cancelIdleCallback(this.pendingGCHandle);
+				this.pendingGCHandle = null;
+			}
+		}
 	}
 };
 //#endregion

package/dist/injector/injector.js.map

@@ -1 +1 @@
-{"version":3,"file":"injector.js","names":[],"sources":["../../src/injector/injector.ts"],"sourcesContent":["/**\n * Style injector that works with structured style objects\n * Eliminates CSS string parsing for better performance\n */\n\nimport type { StyleResult } from '../pipeline';\nimport {\n  getEffectiveDefinition,\n  normalizePropertyDefinition,\n} from '../properties';\nimport { isDevEnv } from '../utils/is-dev-env';\nimport type { StyleValue } from '../utils/styles';\nimport { parseStyle } from '../utils/styles';\n\nimport { SheetManager } from './sheet-manager';\nimport { fontFaceContentHash, formatFontFaceDeclarations } from '../font-face';\nimport { formatCounterStyleDeclarations } from '../counter-style';\nimport type {\n  CacheMetrics,\n  CounterStyleDescriptors,\n  FontFaceDescriptors,\n  GlobalInjectResult,\n  InjectResult,\n  KeyframesResult,\n  KeyframesSteps,\n  PropertyDefinition,\n  RawCSSResult,\n  RootRegistry,\n  StyleInjectorConfig,\n  StyleRule,\n} from './types';\n\n/**\n * Generate sequential class name with format t{number}\n */\nfunction generateClassName(counter: number): string {\n  return `t${counter}`;\n}\n\nexport class StyleInjector {\n  private sheetManager: SheetManager;\n  private config: StyleInjectorConfig;\n  private cleanupScheduled = false;\n  private globalRuleCounter = 0;\n\n  /** @internal — exposed for debug utilities only */\n  get _sheetManager(): SheetManager {\n    return this.sheetManager;\n  }\n\n  constructor(config: StyleInjectorConfig = {}) {\n    this.config = config;\n    this.sheetManager = new SheetManager(config);\n  }\n\n  /**\n   * Allocate a className for a cacheKey without injecting styles yet.\n   * This allows separating className allocation (render phase) from style injection (insertion phase).\n   */\n  allocateClassName(\n    cacheKey: string,\n    options?: { root?: Document | ShadowRoot },\n  ): { className: string; isNewAllocation: boolean } {\n    const root = options?.root || document;\n    const registry = this.sheetManager.getRegistry(root);\n\n    // Check if we can reuse existing className for this cache key\n    if (registry.cacheKeyToClassName.has(cacheKey)) {\n      const className = registry.cacheKeyToClassName.get(cacheKey)!;\n      return {\n        className,\n        isNewAllocation: false,\n      };\n    }\n\n    // Generate new className and reserve it\n    const className = generateClassName(registry.classCounter++);\n\n    // Create placeholder RuleInfo to reserve the className\n    const placeholderRuleInfo = {\n      className,\n      ruleIndex: -1, // Placeholder - will be set during actual injection\n      sheetIndex: -1, // Placeholder - will be set during actual injection\n    };\n\n    // Store RuleInfo only once by className, and map cacheKey separately\n    registry.rules.set(className, placeholderRuleInfo);\n    registry.cacheKeyToClassName.set(cacheKey, className);\n\n    return {\n      className,\n      isNewAllocation: true,\n    };\n  }\n\n  /**\n   * Inject styles from StyleResult objects\n   */\n  inject(\n    rules: StyleResult[],\n    options?: { root?: Document | ShadowRoot; cacheKey?: string },\n  ): InjectResult {\n    const root = options?.root || document;\n    const registry = this.sheetManager.getRegistry(root);\n\n    if (rules.length === 0) {\n      return {\n        className: '',\n        dispose: () => {\n          /* noop */\n        },\n      };\n    }\n\n    // Rules are now in StyleRule format directly\n\n    // Check if we can reuse based on cache key\n    const cacheKey = options?.cacheKey;\n    let className: string;\n    let isPreAllocated = false;\n\n    if (cacheKey && registry.cacheKeyToClassName.has(cacheKey)) {\n      // Reuse existing class for this cache key\n      className = registry.cacheKeyToClassName.get(cacheKey)!;\n      const existingRuleInfo = registry.rules.get(className)!;\n\n      // Check if this is a placeholder (pre-allocated but not yet injected)\n      isPreAllocated =\n        existingRuleInfo.ruleIndex === -1 && existingRuleInfo.sheetIndex === -1;\n\n      if (!isPreAllocated) {\n        // Already injected - just increment refCount\n        const currentRefCount = registry.refCounts.get(className) || 0;\n        registry.refCounts.set(className, currentRefCount + 1);\n\n        // Update metrics\n        if (registry.metrics) {\n          registry.metrics.hits++;\n        }\n\n        return {\n          className,\n          dispose: () => this.dispose(className, registry),\n        };\n      }\n    } else {\n      // Generate new className\n      className = generateClassName(registry.classCounter++);\n    }\n\n    // Process rules: handle needsClassName flag and apply specificity\n    const rulesToInsert = rules.map((rule) => {\n      let newSelector = rule.selector;\n\n      // If rule needs className prepended\n      if (rule.needsClassName) {\n        // Handle multiple selectors (separated by ||| for OR conditions)\n        const selectorParts = newSelector ? newSelector.split('|||') : [''];\n\n        const classPrefix = `.${className}.${className}`;\n\n        newSelector = selectorParts\n          .map((part) => {\n            const classSelector = part ? `${classPrefix}${part}` : classPrefix;\n\n            // If there's a root prefix, add it before the class selector\n            if (rule.rootPrefix) {\n              return `${rule.rootPrefix} ${classSelector}`;\n            }\n            return classSelector;\n          })\n          .join(', ');\n      }\n\n      return {\n        ...rule,\n        selector: newSelector,\n        needsClassName: undefined, // Remove the flag after processing\n        rootPrefix: undefined, // Remove rootPrefix after processing\n      };\n    });\n\n    // Auto-register @property for custom properties with inferable types.\n    // Colors are detected by --*-color name pattern, numeric types by value.\n    if (this.config.autoPropertyTypes !== false) {\n      const resolver = registry.propertyTypeResolver;\n      const defined = registry.injectedProperties;\n      for (const rule of rulesToInsert) {\n        if (!rule.declarations) continue;\n        resolver.scanDeclarations(\n          rule.declarations,\n          (name) => defined.has(name),\n          (name, syntax, initialValue) => {\n            this.property(name, {\n              syntax,\n              inherits: true,\n              initialValue,\n              root,\n            });\n          },\n        );\n      }\n    }\n\n    // Insert rules using existing sheet manager\n    const ruleInfo = this.sheetManager.insertRule(\n      registry,\n      rulesToInsert,\n      className,\n      root,\n    );\n\n    if (!ruleInfo) {\n      // Update metrics\n      if (registry.metrics) {\n        registry.metrics.misses++;\n      }\n\n      return {\n        className,\n        dispose: () => {\n          /* noop */\n        },\n      };\n    }\n\n    // Store in registry\n    registry.refCounts.set(className, 1);\n\n    if (isPreAllocated) {\n      // Update the existing placeholder entry with real rule info\n      registry.rules.set(className, ruleInfo);\n      // cacheKey mapping already exists from allocation\n    } else {\n      // Store new entries\n      registry.rules.set(className, ruleInfo);\n      if (cacheKey) {\n        registry.cacheKeyToClassName.set(cacheKey, className);\n      }\n    }\n\n    // Update metrics\n    if (registry.metrics) {\n      registry.metrics.totalInsertions++;\n      registry.metrics.misses++;\n    }\n\n    return {\n      className,\n      dispose: () => this.dispose(className, registry),\n    };\n  }\n\n  /**\n   * Inject global styles (rules without a generated tasty class selector)\n   * This ensures we don't reserve a tasty class name (t{number}) for global rules,\n   * which could otherwise collide with element-level styles and break lookups.\n   */\n  injectGlobal(\n    rules: StyleResult[],\n    options?: { root?: Document | ShadowRoot },\n  ): GlobalInjectResult {\n    const root = options?.root || document;\n    const registry = this.sheetManager.getRegistry(root);\n\n    if (!rules || rules.length === 0) {\n      return {\n        dispose: () => {\n          /* noop */\n        },\n      };\n    }\n\n    // Auto-register @property for custom properties in global rules\n    if (this.config.autoPropertyTypes !== false) {\n      const resolver = registry.propertyTypeResolver;\n      const defined = registry.injectedProperties;\n      for (const rule of rules) {\n        if (!rule.declarations) continue;\n        resolver.scanDeclarations(\n          rule.declarations,\n          (name) => defined.has(name),\n          (name, syntax, initialValue) => {\n            this.property(name, {\n              syntax,\n              inherits: true,\n              initialValue,\n              root,\n            });\n          },\n        );\n      }\n    }\n\n    // Use a non-tasty identifier to avoid any collisions with .t{number} classes\n    const key = `global:${this.globalRuleCounter++}`;\n\n    const info = this.sheetManager.insertGlobalRule(\n      registry,\n      rules as unknown as StyleRule[],\n      key,\n      root,\n    );\n\n    if (registry.metrics) {\n      registry.metrics.totalInsertions++;\n    }\n\n    return {\n      dispose: () => {\n        if (info) this.sheetManager.deleteGlobalRule(registry, key);\n      },\n    };\n  }\n\n  /**\n   * Inject raw CSS text directly without parsing\n   * This is a low-overhead alternative to createGlobalStyle for raw CSS\n   * The CSS is inserted into a separate style element to avoid conflicts with tasty's chunking\n   */\n  injectRawCSS(\n    css: string,\n    options?: { root?: Document | ShadowRoot },\n  ): RawCSSResult {\n    const root = options?.root || document;\n    return this.sheetManager.injectRawCSS(css, root);\n  }\n\n  /**\n   * Get raw CSS text for SSR\n   */\n  getRawCSSText(options?: { root?: Document | ShadowRoot }): string {\n    const root = options?.root || document;\n    return this.sheetManager.getRawCSSText(root);\n  }\n\n  /**\n   * Increment refCount for an already-injected cacheKey and return a dispose.\n   * Used by useStyles on cache hits (hydration or runtime reuse) where\n   * the pipeline was skipped but refCount tracking is still needed.\n   * Returns null if the cacheKey is not found.\n   */\n  trackRef(\n    cacheKey: string,\n    options?: { root?: Document | ShadowRoot },\n  ): InjectResult | null {\n    const root = options?.root || document;\n    const registry = this.sheetManager.getRegistry(root);\n\n    if (!registry.cacheKeyToClassName.has(cacheKey)) return null;\n\n    const className = registry.cacheKeyToClassName.get(cacheKey)!;\n    const currentRefCount = registry.refCounts.get(className) || 0;\n    registry.refCounts.set(className, currentRefCount + 1);\n\n    if (registry.metrics) {\n      registry.metrics.hits++;\n    }\n\n    return {\n      className,\n      dispose: () => this.dispose(className, registry),\n    };\n  }\n\n  /**\n   * Dispose of a className\n   */\n  private dispose(className: string, registry: RootRegistry): void {\n    const currentRefCount = registry.refCounts.get(className);\n    // Guard against stale double-dispose or mismatched lifecycle\n    if (currentRefCount == null || currentRefCount <= 0) {\n      return;\n    }\n\n    const newRefCount = currentRefCount - 1;\n    registry.refCounts.set(className, newRefCount);\n\n    if (newRefCount === 0) {\n      // Update metrics\n      if (registry.metrics) {\n        registry.metrics.totalUnused++;\n      }\n\n      // Check if cleanup should be scheduled\n      this.sheetManager.checkCleanupNeeded(registry);\n    }\n  }\n\n  /**\n   * Force bulk cleanup of unused styles\n   */\n  cleanup(root?: Document | ShadowRoot): void {\n    const registry = this.sheetManager.getRegistry(root || document);\n    // Clean up ALL unused rules regardless of batch ratio\n    this.sheetManager.forceCleanup(registry);\n  }\n\n  /**\n   * Get CSS text from all sheets (for SSR)\n   */\n  getCssText(options?: { root?: Document | ShadowRoot }): string {\n    const root = options?.root || document;\n    const registry = this.sheetManager.getRegistry(root);\n    return this.sheetManager.getCssText(registry);\n  }\n\n  /**\n   * Get CSS only for the provided tasty classNames (e.g., [\"t0\",\"t3\"])\n   */\n  getCssTextForClasses(\n    classNames: Iterable<string>,\n    options?: { root?: Document | ShadowRoot },\n  ): string {\n    const root = options?.root || document;\n    const registry = this.sheetManager.getRegistry(root);\n\n    const cssChunks: string[] = [];\n    for (const cls of classNames) {\n      const info = registry.rules.get(cls);\n      if (info) {\n        // Always prefer reading from the live stylesheet, since indices can change\n        const sheet = registry.sheets[info.sheetIndex];\n        const styleSheet = sheet?.sheet?.sheet;\n        if (styleSheet) {\n          const start = Math.max(0, info.ruleIndex);\n          const end = Math.min(\n            styleSheet.cssRules.length - 1,\n            (info.endRuleIndex as number) ?? info.ruleIndex,\n          );\n          // Additional validation: ensure indices are valid and in correct order\n          if (\n            start >= 0 &&\n            end >= start &&\n            start < styleSheet.cssRules.length\n          ) {\n            for (let i = start; i <= end; i++) {\n              const rule = styleSheet.cssRules[i] as CSSRule | undefined;\n              if (rule) cssChunks.push(rule.cssText);\n            }\n          }\n        } else if (info.cssText && info.cssText.length) {\n          // Fallback in environments without CSSOM access\n          cssChunks.push(...info.cssText);\n        }\n      }\n    }\n    return cssChunks.join('\\n');\n  }\n\n  /**\n   * Get cache performance metrics\n   */\n  getMetrics(options?: { root?: Document | ShadowRoot }): CacheMetrics | null {\n    const root = options?.root || document;\n    const registry = this.sheetManager.getRegistry(root);\n    return this.sheetManager.getMetrics(registry);\n  }\n\n  /**\n   * Reset cache performance metrics\n   */\n  resetMetrics(options?: { root?: Document | ShadowRoot }): void {\n    const root = options?.root || document;\n    const registry = this.sheetManager.getRegistry(root);\n    this.sheetManager.resetMetrics(registry);\n  }\n\n  /**\n   * Define a CSS @property custom property.\n   *\n   * Accepts tasty token syntax for the property name:\n   * - `$name` → defines `--name`\n   * - `#name` → defines `--name-color` (auto-sets syntax: '<color>', defaults initialValue: 'transparent')\n   * - `--name` → defines `--name` (legacy format)\n   *\n   * Example:\n   * @property --rotation { syntax: \"<angle>\"; inherits: false; initial-value: 45deg; }\n   *\n   * Note: No caching or dispose — this defines a global property.\n   *\n   * If the same property is registered with different options, a warning is emitted\n   * but the original definition is preserved (CSS @property cannot be redefined).\n   */\n  property(\n    name: string,\n    options?: PropertyDefinition & {\n      root?: Document | ShadowRoot;\n    },\n  ): void {\n    const root = options?.root || document;\n    const registry = this.sheetManager.getRegistry(root);\n\n    // Parse the token and get effective definition\n    // This handles $name, #name, --name formats and auto-sets syntax for colors\n    const userDefinition: PropertyDefinition = {\n      syntax: options?.syntax,\n      inherits: options?.inherits,\n      initialValue: options?.initialValue,\n    };\n\n    const effectiveResult = getEffectiveDefinition(name, userDefinition);\n\n    if (!effectiveResult.isValid) {\n      if (isDevEnv()) {\n        console.warn(\n          `[Tasty] property(): ${effectiveResult.error}. Got: \"${name}\"`,\n        );\n      }\n      return;\n    }\n\n    const cssName = effectiveResult.cssName;\n    const definition = effectiveResult.definition;\n\n    // Normalize the definition for comparison\n    const normalizedDef = normalizePropertyDefinition(definition);\n\n    // Check if already defined\n    const existingDef = registry.injectedProperties.get(cssName);\n    if (existingDef !== undefined) {\n      return;\n    }\n\n    const parts: string[] = [];\n\n    if (definition.syntax != null) {\n      let syntax = String(definition.syntax).trim();\n      if (!/^['\"]/u.test(syntax)) syntax = `\"${syntax}\"`;\n      parts.push(`syntax: ${syntax};`);\n    }\n\n    // inherits is required by the CSS @property spec - default to true\n    const inherits = definition.inherits ?? true;\n    parts.push(`inherits: ${inherits ? 'true' : 'false'};`);\n\n    if (definition.initialValue != null) {\n      let initialValueStr: string;\n      if (typeof definition.initialValue === 'number') {\n        initialValueStr = String(definition.initialValue);\n      } else {\n        // Process via tasty parser to resolve custom units/functions\n        initialValueStr = parseStyle(\n          definition.initialValue as StyleValue,\n        ).output;\n      }\n      parts.push(`initial-value: ${initialValueStr};`);\n    }\n\n    const declarations = parts.join(' ').trim();\n\n    const rule: StyleRule = {\n      selector: `@property ${cssName}`,\n      declarations,\n    } as StyleRule;\n\n    // Insert as a global rule; only mark injected when insertion succeeds\n    const info = this.sheetManager.insertGlobalRule(\n      registry,\n      [rule],\n      `property:${name}`,\n      root,\n    );\n\n    if (!info) {\n      return;\n    }\n\n    // Track that this property was injected with its normalized definition\n    registry.injectedProperties.set(cssName, normalizedDef);\n  }\n\n  /**\n   * Check whether a given @property name was already injected by this injector.\n   *\n   * Accepts tasty token syntax:\n   * - `$name` → checks `--name`\n   * - `#name` → checks `--name-color`\n   * - `--name` → checks `--name` (legacy format)\n   */\n  isPropertyDefined(\n    name: string,\n    options?: { root?: Document | ShadowRoot },\n  ): boolean {\n    const root = options?.root || document;\n    const registry = this.sheetManager.getRegistry(root);\n\n    // Parse the token to get the CSS property name\n    const effectiveResult = getEffectiveDefinition(name, {});\n    if (!effectiveResult.isValid) {\n      return false;\n    }\n\n    return registry.injectedProperties.has(effectiveResult.cssName);\n  }\n\n  /**\n   * Inject a CSS @font-face rule.\n   *\n   * Permanent and global — no dispose or ref-counting.\n   * Deduplicates by content hash (family + descriptors).\n   */\n  fontFace(\n    family: string,\n    descriptors: FontFaceDescriptors,\n    options?: { root?: Document | ShadowRoot },\n  ): void {\n    const root = options?.root || document;\n    const registry = this.sheetManager.getRegistry(root);\n\n    const hash = fontFaceContentHash(family, descriptors);\n\n    if (registry.injectedFontFaces.has(hash)) {\n      return;\n    }\n\n    const rule: StyleRule = {\n      selector: '@font-face',\n      declarations: formatFontFaceDeclarations(family, descriptors),\n    } as StyleRule;\n\n    const info = this.sheetManager.insertGlobalRule(\n      registry,\n      [rule],\n      `fontface:${hash}`,\n      root,\n    );\n\n    if (info) {\n      registry.injectedFontFaces.add(hash);\n    }\n  }\n\n  /**\n   * Inject a CSS @counter-style rule.\n   *\n   * Permanent and global — no dispose or ref-counting.\n   * Deduplicates by name (first definition wins).\n   */\n  counterStyle(\n    name: string,\n    descriptors: CounterStyleDescriptors,\n    options?: { root?: Document | ShadowRoot },\n  ): void {\n    const root = options?.root || document;\n    const registry = this.sheetManager.getRegistry(root);\n\n    if (registry.injectedCounterStyles.has(name)) {\n      return;\n    }\n\n    const rule: StyleRule = {\n      selector: `@counter-style ${name}`,\n      declarations: formatCounterStyleDeclarations(descriptors),\n    } as StyleRule;\n\n    const info = this.sheetManager.insertGlobalRule(\n      registry,\n      [rule],\n      `counterstyle:${name}`,\n      root,\n    );\n\n    if (info) {\n      registry.injectedCounterStyles.add(name);\n    }\n  }\n\n  /**\n   * Inject keyframes and return object with toString() and dispose()\n   *\n   * Keyframes are cached by content (steps). If the same content is injected\n   * multiple times with different provided names, the first injected name is reused.\n   *\n   * If the same name is provided with different content (collision), a unique\n   * name is generated to avoid overwriting the existing keyframes.\n   */\n  keyframes(\n    steps: KeyframesSteps,\n    nameOrOptions?: string | { root?: Document | ShadowRoot; name?: string },\n  ): KeyframesResult {\n    // Parse parameters\n    const isStringName = typeof nameOrOptions === 'string';\n    const providedName = isStringName ? nameOrOptions : nameOrOptions?.name;\n    const root = isStringName ? document : nameOrOptions?.root || document;\n    const registry = this.sheetManager.getRegistry(root);\n\n    if (Object.keys(steps).length === 0) {\n      return {\n        toString: () => '',\n        dispose: () => {\n          /* noop */\n        },\n      };\n    }\n\n    // Generate content-based cache key (independent of provided name)\n    const contentHash = JSON.stringify(steps);\n\n    // Check if this exact content is already cached\n    const existing = registry.keyframesCache.get(contentHash);\n    if (existing) {\n      existing.refCount++;\n      return {\n        toString: () => existing.name,\n        dispose: () => this.disposeKeyframes(contentHash, registry),\n      };\n    }\n\n    // Determine the actual name to use\n    let actualName: string;\n\n    if (providedName) {\n      // Check if this name is already used with different content\n      const existingContentForName =\n        registry.keyframesNameToContent.get(providedName);\n\n      if (existingContentForName && existingContentForName !== contentHash) {\n        // Name collision: same name, different content\n        // Generate a unique name to avoid overwriting\n        actualName = `${providedName}-k${registry.keyframesCounter++}`;\n      } else {\n        // Name is available or used with same content\n        actualName = providedName;\n        // Track this name -> content mapping\n        registry.keyframesNameToContent.set(providedName, contentHash);\n      }\n    } else {\n      // No name provided, generate one\n      actualName = `k${registry.keyframesCounter++}`;\n    }\n\n    // Insert keyframes\n    const result = this.sheetManager.insertKeyframes(\n      registry,\n      steps,\n      actualName,\n      root,\n    );\n    if (!result) {\n      return {\n        toString: () => '',\n        dispose: () => {\n          /* noop */\n        },\n      };\n    }\n\n    const { info, declarations } = result;\n\n    // Auto-register @property for custom properties found in keyframe declarations\n    if (this.config.autoPropertyTypes !== false && declarations) {\n      const resolver = registry.propertyTypeResolver;\n      resolver.scanDeclarations(\n        declarations,\n        (name) => registry.injectedProperties.has(name),\n        (name, syntax, initialValue) => {\n          this.property(name, {\n            syntax,\n            inherits: true,\n            initialValue,\n            root,\n          });\n        },\n      );\n    }\n\n    // Cache the result by content hash\n    registry.keyframesCache.set(contentHash, {\n      name: actualName,\n      refCount: 1,\n      info,\n    });\n\n    // Update metrics\n    if (registry.metrics) {\n      registry.metrics.totalInsertions++;\n      registry.metrics.misses++;\n    }\n\n    return {\n      toString: () => actualName,\n      dispose: () => this.disposeKeyframes(contentHash, registry),\n    };\n  }\n\n  /**\n   * Dispose keyframes\n   */\n  private disposeKeyframes(contentHash: string, registry: RootRegistry): void {\n    const entry = registry.keyframesCache.get(contentHash);\n    if (!entry) return;\n\n    entry.refCount--;\n    if (entry.refCount <= 0) {\n      // Dispose immediately - keyframes are global and safe to clean up right away\n      this.sheetManager.deleteKeyframes(registry, entry.info);\n      registry.keyframesCache.delete(contentHash);\n\n      // Clean up name-to-content mapping if this name was tracked\n      // Find and remove the mapping for this content hash\n      for (const [name, hash] of registry.keyframesNameToContent.entries()) {\n        if (hash === contentHash) {\n          registry.keyframesNameToContent.delete(name);\n          break;\n        }\n      }\n\n      // Update metrics\n      if (registry.metrics) {\n        registry.metrics.totalUnused++;\n        registry.metrics.stylesCleanedUp++;\n      }\n    }\n  }\n\n  /**\n   * Destroy all resources for a root\n   */\n  destroy(root?: Document | ShadowRoot): void {\n    const targetRoot = root || document;\n    this.sheetManager.cleanup(targetRoot);\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"injector.js","names":[],"sources":["../../src/injector/injector.ts"],"sourcesContent":["/**\n * Style injector that works with structured style objects\n * Eliminates CSS string parsing for better performance\n */\n\nimport type { StyleResult } from '../pipeline';\nimport {\n  getEffectiveDefinition,\n  normalizePropertyDefinition,\n} from '../properties';\nimport { isDevEnv } from '../utils/is-dev-env';\nimport type { StyleValue } from '../utils/styles';\nimport { parseStyle } from '../utils/styles';\n\nimport { SheetManager } from './sheet-manager';\nimport { fontFaceContentHash, formatFontFaceDeclarations } from '../font-face';\nimport { formatCounterStyleDeclarations } from '../counter-style';\nimport type {\n  CacheMetrics,\n  CounterStyleDescriptors,\n  FontFaceDescriptors,\n  GCOptions,\n  GlobalInjectResult,\n  InjectResult,\n  KeyframesResult,\n  KeyframesSteps,\n  PropertyDefinition,\n  RawCSSResult,\n  RootRegistry,\n  StyleInjectorConfig,\n  StyleRule,\n} from './types';\n\n/**\n * Generate sequential class name with format t{number}\n */\nfunction generateClassName(counter: number): string {\n  return `t${counter}`;\n}\n\nexport class StyleInjector {\n  private sheetManager: SheetManager;\n  private config: StyleInjectorConfig;\n  private globalRuleCounter = 0;\n  private lastGCTime = 0;\n  private backgroundSweepTimeout: ReturnType<typeof setTimeout> | null = null;\n  private pendingGCHandle: ReturnType<typeof requestIdleCallback> | null = null;\n\n  /** @internal — exposed for debug utilities only */\n  get _sheetManager(): SheetManager {\n    return this.sheetManager;\n  }\n\n  constructor(config: StyleInjectorConfig = {}) {\n    this.config = config;\n    this.sheetManager = new SheetManager(config);\n\n    if (config.gc?.auto && typeof document !== 'undefined') {\n      const interval = config.gc.autoInterval ?? 300_000;\n      const scheduleNext = () => {\n        this.backgroundSweepTimeout = setTimeout(() => {\n          const doSweep = () => {\n            this.sheetManager.pruneDisconnectedRoots();\n            for (const root of this.sheetManager.getActiveRoots()) {\n              this.gc({ root });\n            }\n            scheduleNext();\n          };\n          if (typeof requestIdleCallback !== 'undefined') {\n            requestIdleCallback(() => doSweep());\n          } else {\n            doSweep();\n          }\n        }, interval);\n      };\n      scheduleNext();\n    }\n  }\n\n  /**\n   * Allocate a className for a cacheKey without injecting styles yet.\n   * This allows separating className allocation (render phase) from style injection (insertion phase).\n   */\n  allocateClassName(\n    cacheKey: string,\n    options?: { root?: Document | ShadowRoot },\n  ): { className: string; isNewAllocation: boolean } {\n    const root = options?.root || document;\n    const registry = this.sheetManager.getRegistry(root);\n\n    // Check if we can reuse existing className for this cache key\n    if (registry.cacheKeyToClassName.has(cacheKey)) {\n      const className = registry.cacheKeyToClassName.get(cacheKey)!;\n      return {\n        className,\n        isNewAllocation: false,\n      };\n    }\n\n    // Generate new className and reserve it\n    const className = generateClassName(registry.classCounter++);\n\n    // Create placeholder RuleInfo to reserve the className\n    const placeholderRuleInfo = {\n      className,\n      ruleIndex: -1, // Placeholder - will be set during actual injection\n      sheetIndex: -1, // Placeholder - will be set during actual injection\n    };\n\n    // Store RuleInfo only once by className, and map cacheKey separately\n    registry.rules.set(className, placeholderRuleInfo);\n    registry.cacheKeyToClassName.set(cacheKey, className);\n\n    return {\n      className,\n      isNewAllocation: true,\n    };\n  }\n\n  /**\n   * Inject styles from StyleResult objects\n   */\n  inject(\n    rules: StyleResult[],\n    options?: { root?: Document | ShadowRoot; cacheKey?: string },\n  ): InjectResult {\n    const root = options?.root || document;\n    const registry = this.sheetManager.getRegistry(root);\n\n    if (rules.length === 0) {\n      return {\n        className: '',\n        dispose: () => {\n          /* noop */\n        },\n      };\n    }\n\n    // Rules are now in StyleRule format directly\n\n    // Check if we can reuse based on cache key\n    const cacheKey = options?.cacheKey;\n    let className: string;\n    let isPreAllocated = false;\n\n    if (cacheKey && registry.cacheKeyToClassName.has(cacheKey)) {\n      // Reuse existing class for this cache key\n      className = registry.cacheKeyToClassName.get(cacheKey)!;\n      const existingRuleInfo = registry.rules.get(className)!;\n\n      // Check if this is a placeholder (pre-allocated but not yet injected)\n      isPreAllocated =\n        existingRuleInfo.ruleIndex === -1 && existingRuleInfo.sheetIndex === -1;\n\n      if (!isPreAllocated) {\n        // Already injected - just increment refCount\n        const currentRefCount = registry.refCounts.get(className) || 0;\n        registry.refCounts.set(className, currentRefCount + 1);\n\n        // Update metrics\n        if (registry.metrics) {\n          registry.metrics.hits++;\n        }\n\n        return {\n          className,\n          dispose: () => this.dispose(className, registry),\n        };\n      }\n    } else {\n      // Generate new className\n      className = generateClassName(registry.classCounter++);\n    }\n\n    // Process rules: handle needsClassName flag and apply specificity\n    const rulesToInsert = rules.map((rule) => {\n      let newSelector = rule.selector;\n\n      // If rule needs className prepended\n      if (rule.needsClassName) {\n        // Handle multiple selectors (separated by ||| for OR conditions)\n        const selectorParts = newSelector ? newSelector.split('|||') : [''];\n\n        const classPrefix = `.${className}.${className}`;\n\n        newSelector = selectorParts\n          .map((part) => {\n            const classSelector = part ? `${classPrefix}${part}` : classPrefix;\n\n            // If there's a root prefix, add it before the class selector\n            if (rule.rootPrefix) {\n              return `${rule.rootPrefix} ${classSelector}`;\n            }\n            return classSelector;\n          })\n          .join(', ');\n      }\n\n      return {\n        ...rule,\n        selector: newSelector,\n        needsClassName: undefined, // Remove the flag after processing\n        rootPrefix: undefined, // Remove rootPrefix after processing\n      };\n    });\n\n    // Auto-register @property for custom properties with inferable types.\n    // Colors are detected by --*-color name pattern, numeric types by value.\n    if (this.config.autoPropertyTypes !== false) {\n      const resolver = registry.propertyTypeResolver;\n      const defined = registry.injectedProperties;\n      for (const rule of rulesToInsert) {\n        if (!rule.declarations) continue;\n        resolver.scanDeclarations(\n          rule.declarations,\n          (name) => defined.has(name),\n          (name, syntax, initialValue) => {\n            this.property(name, {\n              syntax,\n              inherits: true,\n              initialValue,\n              root,\n            });\n          },\n        );\n      }\n    }\n\n    // Insert rules using existing sheet manager\n    const ruleInfo = this.sheetManager.insertRule(\n      registry,\n      rulesToInsert,\n      className,\n      root,\n    );\n\n    if (!ruleInfo) {\n      // Update metrics\n      if (registry.metrics) {\n        registry.metrics.misses++;\n      }\n\n      return {\n        className,\n        dispose: () => {\n          /* noop */\n        },\n      };\n    }\n\n    // Store in registry\n    registry.refCounts.set(className, 1);\n\n    if (isPreAllocated) {\n      // Update the existing placeholder entry with real rule info\n      registry.rules.set(className, ruleInfo);\n      // cacheKey mapping already exists from allocation\n    } else {\n      // Store new entries\n      registry.rules.set(className, ruleInfo);\n      if (cacheKey) {\n        registry.cacheKeyToClassName.set(cacheKey, className);\n      }\n    }\n\n    // Update metrics\n    if (registry.metrics) {\n      registry.metrics.totalInsertions++;\n      registry.metrics.misses++;\n    }\n\n    return {\n      className,\n      dispose: () => this.dispose(className, registry),\n    };\n  }\n\n  /**\n   * Inject global styles (rules without a generated tasty class selector)\n   * This ensures we don't reserve a tasty class name (t{number}) for global rules,\n   * which could otherwise collide with element-level styles and break lookups.\n   */\n  injectGlobal(\n    rules: StyleResult[],\n    options?: { root?: Document | ShadowRoot },\n  ): GlobalInjectResult {\n    const root = options?.root || document;\n    const registry = this.sheetManager.getRegistry(root);\n\n    if (!rules || rules.length === 0) {\n      return {\n        dispose: () => {\n          /* noop */\n        },\n      };\n    }\n\n    // Auto-register @property for custom properties in global rules\n    if (this.config.autoPropertyTypes !== false) {\n      const resolver = registry.propertyTypeResolver;\n      const defined = registry.injectedProperties;\n      for (const rule of rules) {\n        if (!rule.declarations) continue;\n        resolver.scanDeclarations(\n          rule.declarations,\n          (name) => defined.has(name),\n          (name, syntax, initialValue) => {\n            this.property(name, {\n              syntax,\n              inherits: true,\n              initialValue,\n              root,\n            });\n          },\n        );\n      }\n    }\n\n    // Use a non-tasty identifier to avoid any collisions with .t{number} classes\n    const key = `global:${this.globalRuleCounter++}`;\n\n    const info = this.sheetManager.insertGlobalRule(\n      registry,\n      rules as unknown as StyleRule[],\n      key,\n      root,\n    );\n\n    if (registry.metrics) {\n      registry.metrics.totalInsertions++;\n    }\n\n    return {\n      dispose: () => {\n        if (info) this.sheetManager.deleteGlobalRule(registry, key);\n      },\n    };\n  }\n\n  /**\n   * Inject raw CSS text directly without parsing\n   * This is a low-overhead alternative to createGlobalStyle for raw CSS\n   * The CSS is inserted into a separate style element to avoid conflicts with tasty's chunking\n   */\n  injectRawCSS(\n    css: string,\n    options?: { root?: Document | ShadowRoot },\n  ): RawCSSResult {\n    const root = options?.root || document;\n    return this.sheetManager.injectRawCSS(css, root);\n  }\n\n  /**\n   * Get raw CSS text for SSR\n   */\n  getRawCSSText(options?: { root?: Document | ShadowRoot }): string {\n    const root = options?.root || document;\n    return this.sheetManager.getRawCSSText(root);\n  }\n\n  /**\n   * Increment refCount for an already-injected cacheKey and return a dispose.\n   * Used by useStyles on cache hits (hydration or runtime reuse) where\n   * the pipeline was skipped but refCount tracking is still needed.\n   * Returns null if the cacheKey is not found.\n   */\n  trackRef(\n    cacheKey: string,\n    options?: { root?: Document | ShadowRoot },\n  ): InjectResult | null {\n    const root = options?.root || document;\n    const registry = this.sheetManager.getRegistry(root);\n\n    if (!registry.cacheKeyToClassName.has(cacheKey)) return null;\n\n    const className = registry.cacheKeyToClassName.get(cacheKey)!;\n    const currentRefCount = registry.refCounts.get(className) || 0;\n    registry.refCounts.set(className, currentRefCount + 1);\n\n    if (registry.metrics) {\n      registry.metrics.hits++;\n    }\n\n    return {\n      className,\n      dispose: () => this.dispose(className, registry),\n    };\n  }\n\n  /**\n   * Dispose of a className (decrements refCount only).\n   */\n  private dispose(className: string, registry: RootRegistry): void {\n    const currentRefCount = registry.refCounts.get(className);\n    if (currentRefCount == null || currentRefCount <= 0) {\n      return;\n    }\n\n    const newRefCount = currentRefCount - 1;\n    registry.refCounts.set(className, newRefCount);\n\n    if (newRefCount === 0 && registry.metrics) {\n      registry.metrics.totalUnused++;\n    }\n  }\n\n  /**\n   * Force bulk cleanup of unused styles\n   */\n  cleanup(root?: Document | ShadowRoot): void {\n    const registry = this.sheetManager.getRegistry(root || document);\n    // Clean up ALL unused rules regardless of batch ratio\n    this.sheetManager.forceCleanup(registry);\n  }\n\n  /**\n   * Get CSS text from all sheets (for SSR)\n   */\n  getCssText(options?: { root?: Document | ShadowRoot }): string {\n    const root = options?.root || document;\n    const registry = this.sheetManager.getRegistry(root);\n    return this.sheetManager.getCssText(registry);\n  }\n\n  /**\n   * Get CSS only for the provided tasty classNames (e.g., [\"t0\",\"t3\"])\n   */\n  getCssTextForClasses(\n    classNames: Iterable<string>,\n    options?: { root?: Document | ShadowRoot },\n  ): string {\n    const root = options?.root || document;\n    const registry = this.sheetManager.getRegistry(root);\n\n    const cssChunks: string[] = [];\n    for (const cls of classNames) {\n      const info = registry.rules.get(cls);\n      if (info) {\n        // Always prefer reading from the live stylesheet, since indices can change\n        const sheet = registry.sheets[info.sheetIndex];\n        const styleSheet = sheet?.sheet?.sheet;\n        if (styleSheet) {\n          const start = Math.max(0, info.ruleIndex);\n          const end = Math.min(\n            styleSheet.cssRules.length - 1,\n            (info.endRuleIndex as number) ?? info.ruleIndex,\n          );\n          // Additional validation: ensure indices are valid and in correct order\n          if (\n            start >= 0 &&\n            end >= start &&\n            start < styleSheet.cssRules.length\n          ) {\n            for (let i = start; i <= end; i++) {\n              const rule = styleSheet.cssRules[i] as CSSRule | undefined;\n              if (rule) cssChunks.push(rule.cssText);\n            }\n          }\n        } else if (info.cssText && info.cssText.length) {\n          // Fallback in environments without CSSOM access\n          cssChunks.push(...info.cssText);\n        }\n      }\n    }\n    return cssChunks.join('\\n');\n  }\n\n  /**\n   * Get cache performance metrics\n   */\n  getMetrics(options?: { root?: Document | ShadowRoot }): CacheMetrics | null {\n    const root = options?.root || document;\n    const registry = this.sheetManager.getRegistry(root);\n    return this.sheetManager.getMetrics(registry);\n  }\n\n  /**\n   * Reset cache performance metrics\n   */\n  resetMetrics(options?: { root?: Document | ShadowRoot }): void {\n    const root = options?.root || document;\n    const registry = this.sheetManager.getRegistry(root);\n    this.sheetManager.resetMetrics(registry);\n  }\n\n  /**\n   * Define a CSS @property custom property.\n   *\n   * Accepts tasty token syntax for the property name:\n   * - `$name` → defines `--name`\n   * - `#name` → defines `--name-color` (auto-sets syntax: '<color>', defaults initialValue: 'transparent')\n   * - `--name` → defines `--name` (legacy format)\n   *\n   * Example:\n   * @property --rotation { syntax: \"<angle>\"; inherits: false; initial-value: 45deg; }\n   *\n   * Note: No caching or dispose — this defines a global property.\n   *\n   * If the same property is registered with different options, a warning is emitted\n   * but the original definition is preserved (CSS @property cannot be redefined).\n   */\n  property(\n    name: string,\n    options?: PropertyDefinition & {\n      root?: Document | ShadowRoot;\n    },\n  ): void {\n    const root = options?.root || document;\n    const registry = this.sheetManager.getRegistry(root);\n\n    // Parse the token and get effective definition\n    // This handles $name, #name, --name formats and auto-sets syntax for colors\n    const userDefinition: PropertyDefinition = {\n      syntax: options?.syntax,\n      inherits: options?.inherits,\n      initialValue: options?.initialValue,\n    };\n\n    const effectiveResult = getEffectiveDefinition(name, userDefinition);\n\n    if (!effectiveResult.isValid) {\n      if (isDevEnv()) {\n        console.warn(\n          `[Tasty] property(): ${effectiveResult.error}. Got: \"${name}\"`,\n        );\n      }\n      return;\n    }\n\n    const cssName = effectiveResult.cssName;\n    const definition = effectiveResult.definition;\n\n    // Normalize the definition for comparison\n    const normalizedDef = normalizePropertyDefinition(definition);\n\n    // Check if already defined\n    const existingDef = registry.injectedProperties.get(cssName);\n    if (existingDef !== undefined) {\n      return;\n    }\n\n    const parts: string[] = [];\n\n    if (definition.syntax != null) {\n      let syntax = String(definition.syntax).trim();\n      if (!/^['\"]/u.test(syntax)) syntax = `\"${syntax}\"`;\n      parts.push(`syntax: ${syntax};`);\n    }\n\n    // inherits is required by the CSS @property spec - default to true\n    const inherits = definition.inherits ?? true;\n    parts.push(`inherits: ${inherits ? 'true' : 'false'};`);\n\n    if (definition.initialValue != null) {\n      let initialValueStr: string;\n      if (typeof definition.initialValue === 'number') {\n        initialValueStr = String(definition.initialValue);\n      } else {\n        // Process via tasty parser to resolve custom units/functions\n        initialValueStr = parseStyle(\n          definition.initialValue as StyleValue,\n        ).output;\n      }\n      parts.push(`initial-value: ${initialValueStr};`);\n    }\n\n    const declarations = parts.join(' ').trim();\n\n    const rule: StyleRule = {\n      selector: `@property ${cssName}`,\n      declarations,\n    } as StyleRule;\n\n    // Insert as a global rule; only mark injected when insertion succeeds\n    const info = this.sheetManager.insertGlobalRule(\n      registry,\n      [rule],\n      `property:${name}`,\n      root,\n    );\n\n    if (!info) {\n      return;\n    }\n\n    // Track that this property was injected with its normalized definition\n    registry.injectedProperties.set(cssName, normalizedDef);\n  }\n\n  /**\n   * Check whether a given @property name was already injected by this injector.\n   *\n   * Accepts tasty token syntax:\n   * - `$name` → checks `--name`\n   * - `#name` → checks `--name-color`\n   * - `--name` → checks `--name` (legacy format)\n   */\n  isPropertyDefined(\n    name: string,\n    options?: { root?: Document | ShadowRoot },\n  ): boolean {\n    const root = options?.root || document;\n    const registry = this.sheetManager.getRegistry(root);\n\n    // Parse the token to get the CSS property name\n    const effectiveResult = getEffectiveDefinition(name, {});\n    if (!effectiveResult.isValid) {\n      return false;\n    }\n\n    return registry.injectedProperties.has(effectiveResult.cssName);\n  }\n\n  /**\n   * Inject a CSS @font-face rule.\n   *\n   * Permanent and global — no dispose or ref-counting.\n   * Deduplicates by content hash (family + descriptors).\n   */\n  fontFace(\n    family: string,\n    descriptors: FontFaceDescriptors,\n    options?: { root?: Document | ShadowRoot },\n  ): void {\n    const root = options?.root || document;\n    const registry = this.sheetManager.getRegistry(root);\n\n    const hash = fontFaceContentHash(family, descriptors);\n\n    if (registry.injectedFontFaces.has(hash)) {\n      return;\n    }\n\n    const rule: StyleRule = {\n      selector: '@font-face',\n      declarations: formatFontFaceDeclarations(family, descriptors),\n    } as StyleRule;\n\n    const info = this.sheetManager.insertGlobalRule(\n      registry,\n      [rule],\n      `fontface:${hash}`,\n      root,\n    );\n\n    if (info) {\n      registry.injectedFontFaces.add(hash);\n    }\n  }\n\n  /**\n   * Inject a CSS @counter-style rule.\n   *\n   * Permanent and global — no dispose or ref-counting.\n   * Deduplicates by name (first definition wins).\n   */\n  counterStyle(\n    name: string,\n    descriptors: CounterStyleDescriptors,\n    options?: { root?: Document | ShadowRoot },\n  ): void {\n    const root = options?.root || document;\n    const registry = this.sheetManager.getRegistry(root);\n\n    if (registry.injectedCounterStyles.has(name)) {\n      return;\n    }\n\n    const rule: StyleRule = {\n      selector: `@counter-style ${name}`,\n      declarations: formatCounterStyleDeclarations(descriptors),\n    } as StyleRule;\n\n    const info = this.sheetManager.insertGlobalRule(\n      registry,\n      [rule],\n      `counterstyle:${name}`,\n      root,\n    );\n\n    if (info) {\n      registry.injectedCounterStyles.add(name);\n    }\n  }\n\n  /**\n   * Inject keyframes and return object with toString() and dispose()\n   *\n   * Keyframes are cached by content (steps). If the same content is injected\n   * multiple times with different provided names, the first injected name is reused.\n   *\n   * If the same name is provided with different content (collision), a unique\n   * name is generated to avoid overwriting the existing keyframes.\n   */\n  keyframes(\n    steps: KeyframesSteps,\n    nameOrOptions?: string | { root?: Document | ShadowRoot; name?: string },\n  ): KeyframesResult {\n    // Parse parameters\n    const isStringName = typeof nameOrOptions === 'string';\n    const providedName = isStringName ? nameOrOptions : nameOrOptions?.name;\n    const root = isStringName ? document : nameOrOptions?.root || document;\n    const registry = this.sheetManager.getRegistry(root);\n\n    if (Object.keys(steps).length === 0) {\n      return {\n        toString: () => '',\n        dispose: () => {\n          /* noop */\n        },\n      };\n    }\n\n    // Generate content-based cache key (independent of provided name)\n    const contentHash = JSON.stringify(steps);\n\n    // Check if this exact content is already cached\n    const existing = registry.keyframesCache.get(contentHash);\n    if (existing) {\n      existing.refCount++;\n      return {\n        toString: () => existing.name,\n        dispose: () => this.disposeKeyframes(contentHash, registry),\n      };\n    }\n\n    // Determine the actual name to use\n    let actualName: string;\n\n    if (providedName) {\n      // Check if this name is already used with different content\n      const existingContentForName =\n        registry.keyframesNameToContent.get(providedName);\n\n      if (existingContentForName && existingContentForName !== contentHash) {\n        // Name collision: same name, different content\n        // Generate a unique name to avoid overwriting\n        actualName = `${providedName}-k${registry.keyframesCounter++}`;\n      } else {\n        // Name is available or used with same content\n        actualName = providedName;\n        // Track this name -> content mapping\n        registry.keyframesNameToContent.set(providedName, contentHash);\n      }\n    } else {\n      // No name provided, generate one\n      actualName = `k${registry.keyframesCounter++}`;\n    }\n\n    // Insert keyframes\n    const result = this.sheetManager.insertKeyframes(\n      registry,\n      steps,\n      actualName,\n      root,\n    );\n    if (!result) {\n      return {\n        toString: () => '',\n        dispose: () => {\n          /* noop */\n        },\n      };\n    }\n\n    const { info, declarations } = result;\n\n    // Auto-register @property for custom properties found in keyframe declarations\n    if (this.config.autoPropertyTypes !== false && declarations) {\n      const resolver = registry.propertyTypeResolver;\n      resolver.scanDeclarations(\n        declarations,\n        (name) => registry.injectedProperties.has(name),\n        (name, syntax, initialValue) => {\n          this.property(name, {\n            syntax,\n            inherits: true,\n            initialValue,\n            root,\n          });\n        },\n      );\n    }\n\n    // Cache the result by content hash\n    registry.keyframesCache.set(contentHash, {\n      name: actualName,\n      refCount: 1,\n      info,\n    });\n\n    // Update metrics\n    if (registry.metrics) {\n      registry.metrics.totalInsertions++;\n      registry.metrics.misses++;\n    }\n\n    return {\n      toString: () => actualName,\n      dispose: () => this.disposeKeyframes(contentHash, registry),\n    };\n  }\n\n  /**\n   * Dispose keyframes\n   */\n  private disposeKeyframes(contentHash: string, registry: RootRegistry): void {\n    const entry = registry.keyframesCache.get(contentHash);\n    if (!entry) return;\n\n    entry.refCount--;\n    if (entry.refCount <= 0) {\n      // Dispose immediately - keyframes are global and safe to clean up right away\n      this.sheetManager.deleteKeyframes(registry, entry.info);\n      registry.keyframesCache.delete(contentHash);\n\n      // Clean up name-to-content mapping if this name was tracked\n      // Find and remove the mapping for this content hash\n      for (const [name, hash] of registry.keyframesNameToContent.entries()) {\n        if (hash === contentHash) {\n          registry.keyframesNameToContent.delete(name);\n          break;\n        }\n      }\n\n      // Update metrics\n      if (registry.metrics) {\n        registry.metrics.totalUnused++;\n        registry.metrics.stylesCleanedUp++;\n      }\n    }\n  }\n\n  // =========================================================================\n  // GC: popularity-aware garbage collection with DOM safety guard\n  // =========================================================================\n\n  private static readonly TOUCH_THROTTLE_MS = 5_000;\n  private static readonly TASTY_CLASS_RE = /^t\\d+$/;\n\n  /**\n   * Record a render-time usage hit for one or more classNames.\n   * Handles space-separated multi-chunk classNames.\n   * No-op on the server.\n   */\n  touch(className: string, options?: { root?: Document | ShadowRoot }): void {\n    if (typeof document === 'undefined') return;\n    if (!this.config.gc) return;\n\n    const root = options?.root || document;\n    const registry = this.sheetManager.getRegistry(root);\n    const now = Date.now();\n\n    const parts =\n      className.indexOf(' ') === -1 ? [className] : className.split(' ');\n\n    for (const cls of parts) {\n      if (!StyleInjector.TASTY_CLASS_RE.test(cls)) continue;\n      if (!registry.rules.has(cls)) continue;\n\n      const entry = registry.usageMap.get(cls);\n      if (entry) {\n        entry.hitCount++;\n        if (now - entry.lastUsedAt > StyleInjector.TOUCH_THROTTLE_MS) {\n          entry.lastUsedAt = now;\n        }\n      } else {\n        registry.usageMap.set(cls, { hitCount: 1, lastUsedAt: now });\n      }\n    }\n  }\n\n  /**\n   * Synchronous garbage collection.\n   *\n   * 1. Scans the DOM for live tasty classNames (safety guard).\n   * 2. Scores each non-live className via popularity-weighted TTL.\n   * 3. Marks evictable styles with refCount = 0 and deletes them.\n   * 4. Optionally enforces a hard `cacheCapacity` cap.\n   *\n   * @returns Number of styles evicted.\n   */\n  gc(options?: GCOptions): number {\n    if (typeof document === 'undefined') return 0;\n\n    // Cancel any pending idle-scheduled GC to prevent double runs\n    if (this.pendingGCHandle != null) {\n      if (typeof cancelIdleCallback !== 'undefined') {\n        cancelIdleCallback(this.pendingGCHandle);\n      }\n      this.pendingGCHandle = null;\n    }\n\n    const root = options?.root || document;\n    const registry = this.sheetManager.getRegistry(root);\n    const baseMaxAge =\n      options?.baseMaxAge ?? this.config.gc?.baseMaxAge ?? 60_000;\n    const cacheCapacity =\n      options?.cacheCapacity ?? this.config.gc?.cacheCapacity;\n    const now = Date.now();\n\n    // Phase 0: scan DOM for live classes (classList handles SVG elements too)\n    const liveClasses = new Set<string>();\n    for (const el of root.querySelectorAll('[class]')) {\n      for (const token of el.classList) {\n        if (StyleInjector.TASTY_CLASS_RE.test(token)) {\n          liveClasses.add(token);\n        }\n      }\n    }\n\n    let swept = 0;\n\n    // Phase 1: score-based eviction (skip live and actively-referenced classes)\n    for (const [className, usage] of registry.usageMap) {\n      if (liveClasses.has(className)) continue;\n      if ((registry.refCounts.get(className) ?? 0) > 0) continue;\n\n      const age = now - usage.lastUsedAt;\n      const effectiveTTL = baseMaxAge * Math.log2(usage.hitCount + 1);\n\n      if (age > effectiveTTL) {\n        registry.usageMap.delete(className);\n        swept++;\n      }\n    }\n\n    // Phase 2: capacity cap (evict lowest-scored non-live, non-referenced styles)\n    if (cacheCapacity && registry.usageMap.size > cacheCapacity) {\n      const scored: { className: string; score: number }[] = [];\n      for (const [className, usage] of registry.usageMap) {\n        if (liveClasses.has(className)) continue;\n        if ((registry.refCounts.get(className) ?? 0) > 0) continue;\n        const age = now - usage.lastUsedAt;\n        scored.push({\n          className,\n          score: usage.hitCount * Math.exp(-age / baseMaxAge),\n        });\n      }\n\n      if (scored.length > 0) {\n        scored.sort((a, b) => a.score - b.score);\n\n        const toEvict = registry.usageMap.size - cacheCapacity;\n        for (let i = 0; i < Math.min(toEvict, scored.length); i++) {\n          const { className } = scored[i];\n          registry.usageMap.delete(className);\n          swept++;\n        }\n      }\n    }\n\n    if (swept > 0) {\n      this.sheetManager.forceCleanup(registry);\n    }\n\n    this.lastGCTime = Date.now();\n\n    return swept;\n  }\n\n  /**\n   * Event-driven GC with cooldown.\n   * Skips if called within `cooldown` ms of the last run.\n   * Schedules the actual GC via `requestIdleCallback` when available.\n   */\n  maybeGC(options?: GCOptions): void {\n    if (typeof document === 'undefined') return;\n\n    const cooldown = this.config.gc?.cooldown ?? 30_000;\n    const now = Date.now();\n\n    if (now - this.lastGCTime < cooldown) return;\n\n    // Set before scheduling to prevent multiple idle callbacks from stacking\n    // when maybeGC is called rapidly (e.g. on every route change).\n    this.lastGCTime = now;\n\n    if (typeof requestIdleCallback !== 'undefined') {\n      this.pendingGCHandle = requestIdleCallback(() => {\n        this.pendingGCHandle = null;\n        this.gc(options);\n      });\n    } else {\n      this.gc(options);\n    }\n  }\n\n  /**\n   * Destroy all resources for a root\n   */\n  destroy(root?: Document | ShadowRoot): void {\n    const targetRoot = root || document;\n    this.sheetManager.cleanup(targetRoot);\n\n    // Clear sweep timer and pending GC only when no active roots remain\n    if (this.backgroundSweepTimeout && !this.sheetManager.hasActiveRoots()) {\n      clearTimeout(this.backgroundSweepTimeout);\n      this.backgroundSweepTimeout = null;\n\n      if (this.pendingGCHandle != null) {\n        if (typeof cancelIdleCallback !== 'undefined') {\n          cancelIdleCallback(this.pendingGCHandle);\n        }\n        this.pendingGCHandle = null;\n      }\n    }\n  }\n}\n"],"mappings":"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"}

package/dist/injector/sheet-manager.d.ts

@@ -3,6 +3,8 @@ import { CacheMetrics, KeyframesInfo, KeyframesSteps, RawCSSResult, RootRegistry
 //#region src/injector/sheet-manager.d.ts
 declare class SheetManager {
   private rootRegistries;
+  /** Strong set of active roots so background GC can iterate them all */
+  private activeRoots;
   private config;
   /** Dedicated style elements for raw CSS per root */
   private rawStyleElements;
@@ -15,6 +17,12 @@ declare class SheetManager {
    * Get or create registry for a root (Document or ShadowRoot)
    */
   getRegistry(root: Document | ShadowRoot): RootRegistry;
+  /** Return all roots with active registries (for background GC sweep). */
+  getActiveRoots(): Iterable<Document | ShadowRoot>;
+  /** Check whether any roots have active registries. */
+  hasActiveRoots(): boolean;
+  /** Remove registries for ShadowRoots whose host has been detached from the DOM. */
+  pruneDisconnectedRoots(): void;
   /**
    * Create a new stylesheet for the registry
    */
@@ -51,16 +59,12 @@ declare class SheetManager {
    * Find an available rule index in the sheet
    */
   findAvailableRuleIndex(sheet: SheetInfo): number;
-  /**
-   * Schedule bulk cleanup of all unused styles (non-stacking)
-   */
-  private scheduleBulkCleanup;
   /**
    * Force cleanup of unused styles
    */
   forceCleanup(registry: RootRegistry): void;
   /**
-   * Perform bulk cleanup of all unused styles
+   * Perform bulk cleanup of all unused styles (refCount = 0).
    */
   private performBulkCleanup;
   /**
@@ -100,14 +104,6 @@ declare class SheetManager {
    * Delete keyframes rule
    */
   deleteKeyframes(registry: RootRegistry, info: KeyframesInfo): void;
-  /**
-   * Schedule async cleanup check (non-stacking)
-   */
-  checkCleanupNeeded(registry: RootRegistry): void;
-  /**
-   * Perform the actual cleanup check (called asynchronously)
-   */
-  private performCleanupCheck;
   /**
    * Clean up resources for a root
    */

package/dist/injector/sheet-manager.js

@@ -4,6 +4,8 @@ import { STYLE_HANDLER_MAP } from "../styles/index.js";
 //#region src/injector/sheet-manager.ts
 var SheetManager = class {
 	rootRegistries = /* @__PURE__ */ new WeakMap();
+	/** Strong set of active roots so background GC can iterate them all */
+	activeRoots = /* @__PURE__ */ new Set();
 	config;
 	/** Dedicated style elements for raw CSS per root */
 	rawStyleElements = /* @__PURE__ */ new WeakMap();
@@ -36,8 +38,6 @@ var SheetManager = class {
 				rules: /* @__PURE__ */ new Map(),
 				cacheKeyToClassName: /* @__PURE__ */ new Map(),
 				ruleTextSet: /* @__PURE__ */ new Set(),
-				bulkCleanupTimeout: null,
-				cleanupCheckTimeout: null,
 				metrics,
 				classCounter: 0,
 				keyframesCache: /* @__PURE__ */ new Map(),
@@ -47,12 +47,28 @@ var SheetManager = class {
 				injectedFontFaces: /* @__PURE__ */ new Set(),
 				injectedCounterStyles: /* @__PURE__ */ new Set(),
 				globalRules: /* @__PURE__ */ new Map(),
-				propertyTypeResolver: new PropertyTypeResolver()
+				propertyTypeResolver: new PropertyTypeResolver(),
+				usageMap: /* @__PURE__ */ new Map()
 			};
 			this.rootRegistries.set(root, registry);
+			this.activeRoots.add(root);
 		}
 		return registry;
 	}
+	/** Return all roots with active registries (for background GC sweep). */
+	getActiveRoots() {
+		return this.activeRoots;
+	}
+	/** Check whether any roots have active registries. */
+	hasActiveRoots() {
+		return this.activeRoots.size > 0;
+	}
+	/** Remove registries for ShadowRoots whose host has been detached from the DOM. */
+	pruneDisconnectedRoots() {
+		const toPrune = [];
+		for (const root of this.activeRoots) if (root !== document && !root.host?.isConnected) toPrune.push(root);
+		for (const root of toPrune) this.cleanup(root);
+	}
 	/**
 	* Create a new stylesheet for the registry
 	*/
@@ -347,50 +363,25 @@ var SheetManager = class {
 		return sheet.ruleCount;
 	}
 	/**
-	* Schedule bulk cleanup of all unused styles (non-stacking)
-	*/
-	scheduleBulkCleanup(registry) {
-		if (registry.bulkCleanupTimeout) {
-			if (this.config.idleCleanup && typeof cancelIdleCallback !== "undefined") cancelIdleCallback(registry.bulkCleanupTimeout);
-			else clearTimeout(registry.bulkCleanupTimeout);
-			registry.bulkCleanupTimeout = null;
-		}
-		const performCleanup = () => {
-			this.performBulkCleanup(registry);
-			registry.bulkCleanupTimeout = null;
-		};
-		if (this.config.idleCleanup && typeof requestIdleCallback !== "undefined") registry.bulkCleanupTimeout = requestIdleCallback(performCleanup);
-		else {
-			const delay = this.config.bulkCleanupDelay || 5e3;
-			registry.bulkCleanupTimeout = setTimeout(performCleanup, delay);
-		}
-	}
-	/**
 	* Force cleanup of unused styles
 	*/
 	forceCleanup(registry) {
-		this.performBulkCleanup(registry, true);
+		this.performBulkCleanup(registry);
 	}
 	/**
-	* Perform bulk cleanup of all unused styles
+	* Perform bulk cleanup of all unused styles (refCount = 0).
 	*/
-	performBulkCleanup(registry, cleanupAll = false) {
+	performBulkCleanup(registry) {
 		const cleanupStartTime = Date.now();
-		const unusedClassNames = Array.from(registry.refCounts.entries()).filter(([, refCount]) => refCount === 0).map(([className]) => className);
+		const unusedClassNames = Array.from(registry.refCounts.entries()).filter(([className, refCount]) => refCount === 0 && !registry.usageMap.has(className)).map(([className]) => className);
 		if (unusedClassNames.length === 0) return;
-		const candidates = unusedClassNames.map((className) => {
-			return {
+		const selected = unusedClassNames.map((className) => {
+			const ruleInfo = registry.rules.get(className);
+			return ruleInfo ? {
 				className,
-				ruleInfo: registry.rules.get(className)
-			};
-		});
-		if (candidates.length === 0) return;
-		let selected = candidates;
-		if (!cleanupAll) {
-			const ratio = this.config.bulkCleanupBatchRatio ?? .5;
-			const limit = Math.max(1, Math.floor(candidates.length * Math.min(1, Math.max(0, ratio))));
-			selected = candidates.slice(0, limit);
-		}
+				ruleInfo
+			} : null;
+		}).filter((entry) => entry != null);
 		let cleanedUpCount = 0;
 		let totalCssSize = 0;
 		let totalRulesDeleted = 0;
@@ -610,39 +601,11 @@ var SheetManager = class {
 		}
 	}
 	/**
-	* Schedule async cleanup check (non-stacking)
-	*/
-	checkCleanupNeeded(registry) {
-		if (registry.cleanupCheckTimeout) {
-			clearTimeout(registry.cleanupCheckTimeout);
-			registry.cleanupCheckTimeout = null;
-		}
-		registry.cleanupCheckTimeout = setTimeout(() => {
-			this.performCleanupCheck(registry);
-			registry.cleanupCheckTimeout = null;
-		}, 0);
-	}
-	/**
-	* Perform the actual cleanup check (called asynchronously)
-	*/
-	performCleanupCheck(registry) {
-		if (Array.from(registry.refCounts.values()).filter((count) => count === 0).length >= (this.config.unusedStylesThreshold || 500)) this.scheduleBulkCleanup(registry);
-	}
-	/**
 	* Clean up resources for a root
 	*/
 	cleanup(root) {
 		const registry = this.rootRegistries.get(root);
 		if (!registry) return;
-		if (registry.bulkCleanupTimeout) {
-			if (this.config.idleCleanup && typeof cancelIdleCallback !== "undefined") cancelIdleCallback(registry.bulkCleanupTimeout);
-			else clearTimeout(registry.bulkCleanupTimeout);
-			registry.bulkCleanupTimeout = null;
-		}
-		if (registry.cleanupCheckTimeout) {
-			clearTimeout(registry.cleanupCheckTimeout);
-			registry.cleanupCheckTimeout = null;
-		}
 		for (const sheet of registry.sheets) try {
 			const styleElement = sheet.sheet;
 			if (styleElement.parentNode) styleElement.parentNode.removeChild(styleElement);
@@ -650,6 +613,7 @@ var SheetManager = class {
 			console.warn("Failed to cleanup sheet:", error);
 		}
 		this.rootRegistries.delete(root);
+		this.activeRoots.delete(root);
 		const rawStyleElement = this.rawStyleElements.get(root);
 		if (rawStyleElement?.parentNode) rawStyleElement.parentNode.removeChild(rawStyleElement);
 		this.rawStyleElements.delete(root);