@tenphi/tasty 3.4.0 → 3.5.0

package/dist/{config-B5kHzuNz.js → config-B3gPdCqd.js}

@@ -3186,7 +3186,14 @@ function resetStyleBatch() {
 * Automatically infers CSS @property types from custom property values.
 * Supports deferred resolution for var() reference chains of arbitrary depth.
 */
-const CUSTOM_PROP_DECL = /^\s*(--[a-z0-9_-]+)\s*:\s*(.+?)\s*$/i;
+/**
+* One `--name: value` declaration, with the surrounding whitespace dropped.
+*
+* The value is anchored on `\S` at both ends so no two quantifiers can claim
+* the same character. A lazy `(.+?)\s*$` is quadratic on a value of nothing
+* but spaces — every split point gets tried (CodeQL `js/polynomial-redos`).
+*/
+const CUSTOM_PROP_DECL = /^\s*(--[a-z0-9_-]+)\s*:\s*(\S|\S.*\S)\s*$/i;
 const SINGLE_VAR_REF = /^var\((--[a-z0-9_-]+)\)$/i;
 var PropertyTypeResolver = class {
 	/** propName → the prop it depends on */
@@ -5040,7 +5047,7 @@ var SheetManager = class {
 			} : void 0;
 			registry = {
 				sheets: [],
-				refCounts: /* @__PURE__ */ new Map(),
+				pinCounts: /* @__PURE__ */ new Map(),
 				rules: /* @__PURE__ */ new Map(),
 				cacheKeyToClassName: /* @__PURE__ */ new Map(),
 				ruleTextSet: /* @__PURE__ */ new Set(),
@@ -5054,10 +5061,9 @@ var SheetManager = class {
 				injectedFunctions: /* @__PURE__ */ new Map(),
 				globalRules: /* @__PURE__ */ new Map(),
 				propertyTypeResolver: new PropertyTypeResolver(),
-				usageMap: /* @__PURE__ */ new Map(),
+				unusedSince: /* @__PURE__ */ new Map(),
+				localKeyframes: /* @__PURE__ */ new Map(),
 				touchCount: 0,
-				touchTick: -1,
-				touchedTick: /* @__PURE__ */ new Set(),
 				serverClassSyncIndex: 0,
 				rscStylesScanned: false,
 				injectionMode: this.detectInjectionMode(root)
@@ -5439,25 +5445,26 @@ var SheetManager = class {
 		return registry.atPropertySupported;
 	}
 	/**
-	* Force cleanup of unused styles
-	*/
-	forceCleanup(registry) {
-		this.performBulkCleanup(registry);
-	}
-	/**
-	* Perform bulk cleanup of all unused styles (refCount = 0).
+	* Delete the given classes: their rules leave the sheets and every registry
+	* entry pointing at them is dropped.
+	*
+	* Deciding *what* is unused belongs to `StyleInjector.gc()`, which owns the
+	* DOM scan and the capacity policy. This only re-checks that each class is
+	* still safe to delete, and reports how many were.
+	*
+	* @returns Number of classes actually deleted.
 	*/
-	performBulkCleanup(registry) {
+	deleteClasses(registry, classNames) {
 		const cleanupStartTime = Date.now();
-		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 selected = unusedClassNames.map((className) => {
+		const selected = Array.from(classNames).map((className) => {
 			const ruleInfo = registry.rules.get(className);
 			return ruleInfo ? {
 				className,
 				ruleInfo
 			} : null;
 		}).filter((entry) => entry != null);
+		if (selected.length === 0) return 0;
+		const deleted = /* @__PURE__ */ new Set();
 		let cleanedUpCount = 0;
 		let totalCssSize = 0;
 		let totalRulesDeleted = 0;
@@ -5478,7 +5485,7 @@ var SheetManager = class {
 		for (const [_sheetIndex, rulesInSheet] of rulesBySheet) {
 			rulesInSheet.sort((a, b) => b.ruleInfo.ruleIndex - a.ruleInfo.ruleIndex);
 			for (const { className, ruleInfo } of rulesInSheet) {
-				if ((registry.refCounts.get(className) || 0) > 0) continue;
+				if ((registry.pinCounts.get(className) ?? 0) > 0) continue;
 				if (registry.rules.get(className) !== ruleInfo) continue;
 				const sheetInfo = registry.sheets[ruleInfo.sheetIndex];
 				if (!sheetInfo || !sheetInfo.sheet && !sheetInfo.constructableSheet) continue;
@@ -5490,13 +5497,22 @@ var SheetManager = class {
 				if (startIdx < 0 || endIdx > maxRuleIndex || startIdx > endIdx) continue;
 				this.deleteRule(registry, ruleInfo);
 				registry.rules.delete(className);
-				registry.refCounts.delete(className);
-				const keysToDelete = [];
-				for (const [key, mappedClassName] of registry.cacheKeyToClassName.entries()) if (mappedClassName === className) keysToDelete.push(key);
-				for (const key of keysToDelete) registry.cacheKeyToClassName.delete(key);
+				registry.pinCounts.delete(className);
+				registry.unusedSince.delete(className);
+				for (const [key, entry] of registry.localKeyframes) {
+					if (!entry.owners.delete(className)) continue;
+					if (entry.owners.size === 0) {
+						entry.dispose();
+						registry.localKeyframes.delete(key);
+					}
+				}
+				deleted.add(className);
 				cleanedUpCount++;
 			}
 		}
+		if (deleted.size > 0) {
+			for (const [key, mappedClassName] of registry.cacheKeyToClassName) if (deleted.has(mappedClassName)) registry.cacheKeyToClassName.delete(key);
+		}
 		if (registry.metrics) {
 			registry.metrics.bulkCleanups++;
 			registry.metrics.stylesCleanedUp += cleanedUpCount;
@@ -5507,6 +5523,7 @@ var SheetManager = class {
 				rulesDeleted: totalRulesDeleted
 			});
 		}
+		return cleanedUpCount;
 	}
 	/**
 	* Get total number of rules across all sheets
@@ -5515,25 +5532,31 @@ var SheetManager = class {
 		return registry.sheets.reduce((total, sheet) => total + sheet.ruleCount - sheet.holes.length, 0);
 	}
 	/**
-	* Get CSS text from all sheets (for SSR)
+	* The CSS of one managed sheet, or `null` when it holds none this can read —
+	* an empty style element, or a sheet the engine refuses to hand over.
 	*/
-	getCSSText(registry) {
-		const cssChunks = [];
-		for (const sheetInfo of registry.sheets) try {
-			if (sheetInfo.constructableSheet) {
-				const rules = Array.from(sheetInfo.constructableSheet.cssRules);
-				cssChunks.push(rules.map((rule) => rule.cssText).join("\n"));
-			} else if (sheetInfo.sheet) {
+	readSheetCSS(sheetInfo) {
+		try {
+			if (sheetInfo.constructableSheet) return Array.from(sheetInfo.constructableSheet.cssRules).map((rule) => rule.cssText).join("\n");
+			if (sheetInfo.sheet) {
 				const styleElement = sheetInfo.sheet;
-				if (styleElement.textContent) cssChunks.push(styleElement.textContent);
-				else if (styleElement.sheet) {
-					const rules = Array.from(styleElement.sheet.cssRules);
-					cssChunks.push(rules.map((rule) => rule.cssText).join("\n"));
-				}
+				if (styleElement.textContent) return styleElement.textContent;
+				if (styleElement.sheet) return Array.from(styleElement.sheet.cssRules).map((rule) => rule.cssText).join("\n");
 			}
 		} catch (error) {
 			console.warn("[Tasty] Failed to read CSS from sheet:", error);
 		}
+		return null;
+	}
+	/**
+	* Get CSS text from all sheets (for SSR)
+	*/
+	getCSSText(registry) {
+		const cssChunks = [];
+		for (const sheetInfo of registry.sheets) {
+			const css = this.readSheetCSS(sheetInfo);
+			if (css !== null) cssChunks.push(css);
+		}
 		return cssChunks.join("\n");
 	}
 	/**
@@ -5541,10 +5564,9 @@ var SheetManager = class {
 	*/
 	getMetrics(registry) {
 		if (!registry.metrics) return null;
-		const unusedRulesCount = Array.from(registry.refCounts.values()).filter((count) => count === 0).length;
 		return {
 			...registry.metrics,
-			unusedHits: unusedRulesCount
+			unusedHits: 0
 		};
 	}
 	/**
@@ -5846,6 +5868,49 @@ var SheetManager = class {
 	/**
 	* Get the raw CSS content
 	*/
+	/**
+	* The CSS this injector owns in `root`, one entry per sheet, in the order the
+	* engine applies them.
+	*
+	* `getCSSText()` walks the managed sheets only, and raw CSS has its own —
+	* which sits before, after, or *between* them depending on how it got there:
+	* prepended to `adoptedStyleSheets`, or wherever in `<head>` the first raw
+	* injection happened to land, with every managed sheet opened afterwards
+	* following it. Reporting a fixed order would describe the opposite winner
+	* from the live page whenever two rules of equal specificity meet, so the raw
+	* sheet is spliced in at the position the DOM actually gives it.
+	*/
+	getOwnedCSSInOrder(registry, root) {
+		const raw = this.getRawCSSText(root);
+		const rawElement = this.isAdoptedMode(root) ? null : this.rawStyleElements.get(root);
+		let rawIndex = raw && !rawElement ? 0 : -1;
+		const chunks = [];
+		for (const sheetInfo of registry.sheets) {
+			const css = this.readSheetCSS(sheetInfo);
+			if (css === null) continue;
+			if (rawIndex < 0 && rawElement && sheetInfo.sheet && rawElement.compareDocumentPosition(sheetInfo.sheet) & Node.DOCUMENT_POSITION_FOLLOWING) rawIndex = chunks.length;
+			chunks.push(css);
+		}
+		if (!raw) return chunks;
+		chunks.splice(rawIndex < 0 ? chunks.length : rawIndex, 0, raw);
+		return chunks;
+	}
+	/**
+	* Top-level rules in the raw sheet.
+	*
+	* Read from the sheet the engine parsed, not from the text: a raw block is
+	* one string but any number of rules, and one rule — `@keyframes`, `@media` —
+	* can contain any number of blocks, so counting braces answers neither
+	* question.
+	*/
+	getRawRuleCount(root) {
+		const sheet = this.isAdoptedMode(root) ? this.rawConstructableSheets.get(root) : this.rawStyleElements.get(root)?.sheet;
+		try {
+			return sheet?.cssRules.length ?? 0;
+		} catch {
+			return 0;
+		}
+	}
 	getRawCSSText(root) {
 		if (this.isAdoptedMode(root)) {
 			const blocksMap = this.rawCSSBlocks.get(root);
@@ -5968,6 +6033,13 @@ function formatCounterStyleRule(name, descriptors) {
 //#endregion
 //#region src/injector/injector.ts
 /**
+* How long a class is left alone after it was last known to be wanted.
+* Long enough that a render cannot plausibly still be waiting to commit one.
+*/
+const DEFAULT_GC_GRACE = 1e4;
+/** Dispose handle handed back for injections that took no pin. */
+const noop = () => {};
+/**
 * Placeholder `KeyframesInfo` for a cache entry reserved by a batched write and
 * not yet backed by a real rule. Only ever read through `entry.pending`, which
 * is checked before the info is used.
@@ -6024,13 +6096,14 @@ function registerHydratedClass(registry, className) {
 		ruleIndex: -2,
 		sheetIndex: -2
 	});
-	registry.refCounts.set(className, 0);
+	registry.pinCounts.set(className, 0);
 }
 var StyleInjector = class {
 	sheetManager;
 	config;
 	globalRuleCounter = 0;
-	pendingGCHandle = null;
+	/** Cancels the scheduled sweep, whichever timer scheduled it. */
+	cancelPendingGC = null;
 	namePrefix;
 	classRegex;
 	rscClassRegex;
@@ -6159,6 +6232,7 @@ var StyleInjector = class {
 	inject(rules, options) {
 		const root = options?.root || document;
 		const registry = this.sheetManager.getRegistry(root);
+		const pin = options?.pin ?? true;
 		if (rules.length === 0) return {
 			className: "",
 			dispose: () => {}
@@ -6169,30 +6243,34 @@ var StyleInjector = class {
 			className = registry.cacheKeyToClassName.get(cacheKey);
 			const existingRuleInfo = registry.rules.get(className);
 			if (existingRuleInfo.ruleIndex === -3) {
-				registry.refCounts.set(className, (registry.refCounts.get(className) || 0) + 1);
+				registry.unusedSince.delete(className);
+				if (pin) registry.pinCounts.set(className, (registry.pinCounts.get(className) || 0) + 1);
 				if (registry.metrics) registry.metrics.hits++;
 				return {
 					className,
-					dispose: () => this.dispose(className, registry)
+					dispose: pin ? () => this.unpin(className, registry) : noop
 				};
 			}
 			if (!(existingRuleInfo.ruleIndex === -1 && existingRuleInfo.sheetIndex === -1)) {
-				const currentRefCount = registry.refCounts.get(className) || 0;
-				registry.refCounts.set(className, currentRefCount + 1);
+				registry.unusedSince.delete(className);
+				if (pin) {
+					const pins = registry.pinCounts.get(className) || 0;
+					registry.pinCounts.set(className, pins + 1);
+				}
 				if (registry.metrics) registry.metrics.hits++;
 				return {
 					className,
-					dispose: () => this.dispose(className, registry)
+					dispose: pin ? () => this.unpin(className, registry) : noop
 				};
 			}
 		} else if (cacheKey) {
 			className = this.generateClassName(cacheKey);
 			if (this.tryHydratedHit(registry, cacheKey, className)) {
-				registry.refCounts.set(className, (registry.refCounts.get(className) || 0) + 1);
+				if (pin) registry.pinCounts.set(className, (registry.pinCounts.get(className) || 0) + 1);
 				if (registry.metrics) registry.metrics.hits++;
 				return {
 					className,
-					dispose: () => this.dispose(className, registry)
+					dispose: pin ? () => this.unpin(className, registry) : noop
 				};
 			}
 		} else {
@@ -6253,7 +6331,8 @@ var StyleInjector = class {
 				sheetIndex: -3
 			});
 			if (cacheKey) registry.cacheKeyToClassName.set(cacheKey, className);
-			registry.refCounts.set(className, 1);
+			if (pin) registry.pinCounts.set(className, 1);
+			registry.unusedSince.set(className, Date.now());
 			const queued = enqueueStyleWrite(() => {
 				if (applySheetWrite()) return;
 				registry.rules.set(className, {
@@ -6264,26 +6343,27 @@ var StyleInjector = class {
 			});
 			return {
 				className,
-				dispose: () => {
-					if (!queued.done && registry.refCounts.get(className) === 1 && registry.rules.get(className)?.ruleIndex === -3) {
+				dispose: pin ? () => {
+					if (!queued.done && registry.pinCounts.get(className) === 1 && registry.rules.get(className)?.ruleIndex === -3) {
 						queued.cancelled = true;
 						registry.rules.delete(className);
 						if (cacheKey) registry.cacheKeyToClassName.delete(cacheKey);
-						registry.refCounts.set(className, 0);
+						registry.pinCounts.set(className, 0);
 						return;
 					}
-					this.dispose(className, registry);
-				}
+					this.unpin(className, registry);
+				} : noop
 			};
 		}
 		if (!applySheetWrite()) return {
 			className,
 			dispose: () => {}
 		};
-		registry.refCounts.set(className, 1);
+		if (pin) registry.pinCounts.set(className, 1);
+		registry.unusedSince.set(className, Date.now());
 		return {
 			className,
-			dispose: () => this.dispose(className, registry)
+			dispose: pin ? () => this.unpin(className, registry) : noop
 		};
 	}
 	/**
@@ -6363,41 +6443,86 @@ var StyleInjector = class {
 		return this.sheetManager.getRawCSSText(root);
 	}
 	/**
-	* Increment refCount for an already-injected cacheKey and return a dispose.
-	* Used by useStyles on cache hits (hydration or runtime reuse) where
-	* the pipeline was skipped but refCount tracking is still needed.
-	* Returns null if the cacheKey is not found.
+	* Take a reference on local `@keyframes`, under the deterministic names the
+	* caller resolved.
+	*
+	* One reference per distinct set of steps, shared by every class that ends up
+	* animating it, so a repeat render takes nothing further. Ownership is
+	* assigned by `ownKeyframes()` once the rules exist to be inspected.
+	*/
+	holdKeyframes(steps, names, options) {
+		const root = options?.root || document;
+		const registry = this.sheetManager.getRegistry(root);
+		const keys = /* @__PURE__ */ new Map();
+		for (const [authored, definition] of Object.entries(steps)) {
+			const resolved = names.get(authored) ?? authored;
+			let entry = registry.localKeyframes.get(resolved);
+			if (!entry) {
+				const injected = this.keyframes(definition, {
+					name: resolved,
+					root,
+					distinctByName: true
+				});
+				entry = {
+					name: injected.toString(),
+					dispose: injected.dispose,
+					owners: /* @__PURE__ */ new Set()
+				};
+				registry.localKeyframes.set(resolved, entry);
+			}
+			keys.set(authored, resolved);
+		}
+		return keys;
+	}
+	/**
+	* Record that `className` animates these keyframes, so the reference is
+	* released when the last such class is collected.
+	*
+	* Only classes whose rules actually reference the animation should be here:
+	* a class that merely rendered alongside one would otherwise keep the
+	* keyframes alive for as long as it lives.
+	*/
+	ownKeyframes(key, className, options) {
+		this.sheetManager.getRegistry(options?.root || document).localKeyframes.get(key)?.owners.add(className);
+	}
+	/**
+	* Pin an already-injected cacheKey and return the handle that releases it.
+	* For callers that skipped the pipeline on a cache hit but still need the
+	* class held. Returns null if the cacheKey is not found.
 	*/
 	trackRef(cacheKey, options) {
 		const root = options?.root || document;
 		const registry = this.sheetManager.getRegistry(root);
 		if (!registry.cacheKeyToClassName.has(cacheKey)) return null;
 		const className = registry.cacheKeyToClassName.get(cacheKey);
-		const currentRefCount = registry.refCounts.get(className) || 0;
-		registry.refCounts.set(className, currentRefCount + 1);
+		const pins = registry.pinCounts.get(className) || 0;
+		registry.pinCounts.set(className, pins + 1);
 		if (registry.metrics) registry.metrics.hits++;
 		return {
 			className,
-			dispose: () => this.dispose(className, registry)
+			dispose: () => this.unpin(className, registry)
 		};
 	}
 	/**
-	* Dispose of a className (decrements refCount only).
+	* Release one pin on a className. At zero pins the class is not deleted — it
+	* stays cached and collectible, and `gc()` decides when it actually goes.
 	*/
-	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 && registry.metrics) registry.metrics.totalUnused++;
+	unpin(className, registry) {
+		const pins = registry.pinCounts.get(className);
+		if (pins == null || pins <= 0) return;
+		const remaining = pins - 1;
+		registry.pinCounts.set(className, remaining);
+		if (remaining === 0 && registry.metrics) registry.metrics.totalUnused++;
 	}
 	/**
-	* Force bulk cleanup of unused styles
+	* Remove every style that is neither in the DOM nor referenced by an
+	* outstanding `inject()` handle, ignoring the GC capacity threshold.
 	*/
 	cleanup(root) {
-		flushStyles();
-		const registry = this.sheetManager.getRegistry(root || document);
-		this.sheetManager.forceCleanup(registry);
+		this.gc({
+			root,
+			force: true
+		});
 	}
 	/**
 	* Get CSS text from all sheets (for SSR)
@@ -6440,7 +6565,9 @@ var StyleInjector = class {
 		flushStyles();
 		const root = options?.root || document;
 		const registry = this.sheetManager.getRegistry(root);
-		return this.sheetManager.getMetrics(registry);
+		const metrics = this.sheetManager.getMetrics(registry);
+		if (metrics && typeof document !== "undefined") metrics.unusedHits = this.collectUnused(registry, root).length;
+		return metrics;
 	}
 	/**
 	* Reset cache performance metrics
@@ -6614,13 +6741,14 @@ var StyleInjector = class {
 	keyframes(steps, nameOrOptions) {
 		const isStringName = typeof nameOrOptions === "string";
 		const providedName = isStringName ? nameOrOptions : nameOrOptions?.name;
+		const distinctByName = isStringName ? false : nameOrOptions?.distinctByName ?? false;
 		const root = isStringName ? document : nameOrOptions?.root || document;
 		const registry = this.sheetManager.getRegistry(root);
 		if (Object.keys(steps).length === 0) return {
 			toString: () => "",
 			dispose: () => {}
 		};
-		const contentHash = JSON.stringify(steps);
+		const contentHash = distinctByName && providedName ? `${providedName}\u0000${JSON.stringify(steps)}` : JSON.stringify(steps);
 		const existing = registry.keyframesCache.get(contentHash);
 		if (existing) {
 			existing.refCount++;
@@ -6712,108 +6840,132 @@ var StyleInjector = class {
 		}
 	}
 	/**
-	* Record a render-time usage hit for one or more classNames.
-	* Handles space-separated multi-chunk classNames.
-	* When the global touch counter reaches `touchInterval`, schedules a GC
-	* via `requestIdleCallback`.
-	* No-op on the server.
+	* Count a render, and schedule a collection pass every `touchInterval` of
+	* them. Nothing else: what a class is worth keeping is decided by the sweep's
+	* own DOM scan, so rendering does not track usage at all.
+	*
+	* @deprecated The class name is ignored — pass anything, or stop calling it.
+	* Collection no longer records per-class usage, and scheduling does not need
+	* to know which class was rendered. A class handed back by `inject()` is
+	* marked wanted there, which is what reuse actually goes through.
 	*/
-	touch(className, options) {
+	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();
-		if (registry.touchTick !== now) {
-			registry.touchTick = now;
-			registry.touchedTick.clear();
-		} else if (registry.touchedTick.has(className)) return;
-		registry.touchedTick.add(className);
-		const parts = className.indexOf(" ") === -1 ? [className] : className.split(" ");
-		for (const cls of parts) {
-			if (!this.classRegex.test(cls)) continue;
-			if (!registry.rules.has(cls)) continue;
-			const entry = registry.usageMap.get(cls);
-			if (entry) entry.lastTouchedAt = now;
-			else registry.usageMap.set(cls, { lastTouchedAt: now });
-			registry.touchCount++;
-		}
-		const touchInterval = this.config.gc.touchInterval ?? 1e3;
-		if (registry.touchCount >= touchInterval) {
+		const registry = this.sheetManager.getRegistry(options?.root || document);
+		if (++registry.touchCount >= (this.config.gc.touchInterval ?? 1e3)) {
 			registry.touchCount = 0;
 			this.scheduleGC();
 		}
 	}
 	/**
-	* Schedule a GC via `requestIdleCallback` (or synchronously as fallback).
-	* Runs GC on all active roots. Avoids double-scheduling via `pendingGCHandle`.
+	* Schedule a GC in idle time. Runs GC on all active roots, and avoids
+	* double-scheduling.
+	*
+	* Idle only. Without `requestIdleCallback` nothing is collected
+	* automatically: running the sweep inline here would put it inside the render
+	* that touched the class, and collection is never urgent enough for that.
 	*/
 	scheduleGC() {
-		if (this.pendingGCHandle != null) return;
+		if (this.cancelPendingGC) return;
 		const runGC = () => {
-			this.pendingGCHandle = null;
+			this.cancelPendingGC = null;
 			this.sheetManager.pruneDisconnectedRoots();
 			for (const root of this.sheetManager.getActiveRoots()) this.gc({ root });
 		};
-		if (typeof requestIdleCallback !== "undefined") this.pendingGCHandle = requestIdleCallback(() => runGC());
-		else runGC();
+		if (typeof requestIdleCallback !== "undefined") {
+			const handle = requestIdleCallback(() => runGC());
+			this.cancelPendingGC = () => cancelIdleCallback(handle);
+		}
+	}
+	/**
+	* The one definition of "unused": this injector owns the class's rules, no
+	* element in `root` carries it, and nobody pinned it.
+	*
+	* `gc()` evicts from this set, `getMetrics()` counts it, and `tastyDebug`
+	* reports it — all through here, so the three can never disagree about what
+	* "unused" means. Entries carry their last `touch()` so callers can drop the
+	* oldest first; a class that was never touched sorts as oldest.
+	*/
+	/**
+	* Everything the injector holds falls into one of five bands, and only the
+	* last of them is ever deleted:
+	*
+	* 1. rendered — some element carries the class right now
+	* 2. not ours — queued for a batched write, pre-allocated, or server-rendered
+	* 3. hot — nothing carries it, but that was noticed less than `grace` ago
+	* 4. cached — cold, but within `capacity` when ordered by when it went cold
+	* 5. the rest
+	*
+	* This returns bands 4 and 5 together, most recently cold first; `gc()` draws
+	* the capacity line through them. Band 3 is what makes collection safe
+	* without a commit signal: a render can resolve a class and commit it a
+	* little later, and during that gap nothing on the page carries it.
+	*/
+	collectUnused(registry, root) {
+		const now = Date.now();
+		const grace = this.config.gc?.grace ?? DEFAULT_GC_GRACE;
+		const liveClasses = /* @__PURE__ */ new Set();
+		for (const el of root.querySelectorAll("[class]")) for (const token of el.classList) if (this.classRegex.test(token)) liveClasses.add(token);
+		const unused = [];
+		for (const [className, ruleInfo] of registry.rules) {
+			if (ruleInfo.sheetIndex < 0) continue;
+			if (liveClasses.has(className)) {
+				registry.unusedSince.delete(className);
+				continue;
+			}
+			if ((registry.pinCounts.get(className) ?? 0) > 0) continue;
+			let since = registry.unusedSince.get(className);
+			if (since === void 0) {
+				since = now;
+				registry.unusedSince.set(className, now);
+			}
+			if (now - since < grace) continue;
+			unused.push(className);
+		}
+		unused.sort((a, b) => (registry.unusedSince.get(b) ?? 0) - (registry.unusedSince.get(a) ?? 0));
+		return unused;
+	}
+	/**
+	* Class names this injector holds CSS for that nothing renders and nobody
+	* pinned — exactly what `gc({ force: true })` would delete. Unordered.
+	*/
+	getUnusedClasses(options) {
+		flushStyles();
+		if (typeof document === "undefined") return [];
+		const root = options?.root || document;
+		const registry = this.sheetManager.getRegistry(root);
+		return this.collectUnused(registry, root);
 	}
 	/**
 	* Synchronous garbage collection.
 	*
-	* 1. Quick upper-bound check: skip if unused count can't exceed capacity.
-	* 2. Scans the DOM for live tasty classNames (safety guard).
-	* 3. With `force: true`: deletes all unused entries inline.
-	*    Without `force`: collects unused, sorts oldest-first, evicts over capacity.
+	* 1. Quick upper-bound check: skip if the registry is smaller than capacity.
+	* 2. Scans the DOM for live tasty classNames — the DOM, not a ref count, is
+	*    what says a class rendered by a component is still in use.
+	* 3. With `force: true`: deletes every unused class.
+	*    Without `force`: keeps the `capacity` most recently touched and deletes
+	*    the rest, oldest first.
 	*
 	* @returns Number of styles evicted.
 	*/
 	gc(options) {
 		flushStyles();
 		if (typeof document === "undefined") return 0;
-		if (this.pendingGCHandle != null) {
-			if (typeof cancelIdleCallback !== "undefined") cancelIdleCallback(this.pendingGCHandle);
-			this.pendingGCHandle = null;
-		}
+		this.cancelPendingGC?.();
+		this.cancelPendingGC = null;
 		const root = options?.root || document;
-		const force = options?.force ?? false;
+		const force = options?.force;
 		const registry = this.sheetManager.getRegistry(root);
 		const capacity = this.config.gc?.capacity ?? 1e3;
-		if (!force) {
-			let activeCount = 0;
-			for (const refCount of registry.refCounts.values()) if (refCount > 0) activeCount++;
-			if (registry.usageMap.size - activeCount <= capacity) return 0;
-		}
-		const liveClasses = /* @__PURE__ */ new Set();
-		for (const el of root.querySelectorAll("[class]")) for (const token of el.classList) if (this.classRegex.test(token)) liveClasses.add(token);
-		let swept = 0;
-		if (force) for (const [className] of registry.usageMap) {
-			if (liveClasses.has(className)) continue;
-			if ((registry.refCounts.get(className) ?? 0) > 0) continue;
-			registry.usageMap.delete(className);
-			swept++;
-		}
-		else {
-			const unused = [];
-			for (const [className, usage] of registry.usageMap) {
-				if (liveClasses.has(className)) continue;
-				if ((registry.refCounts.get(className) ?? 0) > 0) continue;
-				unused.push({
-					className,
-					lastTouchedAt: usage.lastTouchedAt
-				});
-			}
-			if (unused.length > capacity) {
-				unused.sort((a, b) => a.lastTouchedAt - b.lastTouchedAt);
-				const toEvict = unused.length - capacity;
-				for (let i = 0; i < toEvict; i++) {
-					registry.usageMap.delete(unused[i].className);
-					swept++;
-				}
-			}
-		}
-		if (swept > 0) this.sheetManager.forceCleanup(registry);
-		return swept;
+		if (!force && registry.rules.size <= capacity) return 0;
+		const unused = this.collectUnused(registry, root);
+		let doomed;
+		if (force) doomed = unused;
+		else if (unused.length > capacity) doomed = unused.slice(capacity);
+		else return 0;
+		if (doomed.length === 0) return 0;
+		return this.sheetManager.deleteClasses(registry, doomed);
 	}
 	/**
 	* Destroy all resources for a root
@@ -6822,9 +6974,9 @@ var StyleInjector = class {
 		flushStyles();
 		const targetRoot = root || document;
 		this.sheetManager.cleanup(targetRoot);
-		if (this.pendingGCHandle != null && !this.sheetManager.hasActiveRoots()) {
-			if (typeof cancelIdleCallback !== "undefined") cancelIdleCallback(this.pendingGCHandle);
-			this.pendingGCHandle = null;
+		if (this.cancelPendingGC && !this.sheetManager.hasActiveRoots()) {
+			this.cancelPendingGC();
+			this.cancelPendingGC = null;
 		}
 	}
 };
@@ -11697,7 +11849,7 @@ function createDefaultConfig(isTest) {
 function markStylesGenerated() {
 	if (stylesGenerated) return;
 	stylesGenerated = true;
-	if (typeof document !== "undefined" && document.querySelector("style[data-tasty-ssr]")) {
+	if (typeof document !== "undefined" && document.querySelector("[data-tasty-ssr]")) {
 		warnOnce("ssr-globals-skip", "[Tasty] SSR styles detected — skipping client-side global CSS injection to avoid duplicates.");
 		return;
 	}
@@ -12266,4 +12418,4 @@ function resetConfig() {
 //#endregion
 export { SheetManager as $, StyleParser as $t, FLOW_STYLES as A, STYLE_TO_CHUNK as At, createStateParserContext as B, getGlobalParseFunctions as Bt, BASE_STYLES as C, APPEARANCE_CHUNK_STYLES as Ct, COLOR_STYLES as D, FONT_CHUNK_STYLES as Dt, BLOCK_STYLES as E, DISPLAY_CHUNK_STYLES as Et, hasPipelineCacheEntry as F, registerFunctionPolyfill as Ft, StyleInjector as G, parseStyle as Gt, extractPredefinedStateRefs as H, getGlobalPredefinedTokens as Ht, isSelector as I, registerLocalFunctionPolyfills as It, hasLocalCounterStyle as J, okhstPlugin as Jt, extractLocalCounterStyle as K, stringifyStyles as Kt, renderStyles as L, CUSTOM_UNITS as Lt, OUTER_STYLES as M, formatFunctionRule as Mt, POSITION_STYLES as N, hasLocalFunctions as Nt, CONTAINER_STYLES as O, LAYOUT_CHUNK_STYLES as Ot, TEXT_STYLES as P, parseFunctionName as Pt, hasLocalFontFace as Q, isDevEnv as Qt, parseStateKey as R, DIRECTIONS as Rt, baseStylePropsRegistry as S, propHandlerRegistry as St, BLOCK_OUTER_STYLES as T, DIMENSION_CHUNK_STYLES as Tt, getGlobalPredefinedStates as U, normalizeColorTokenValue as Ut, extractLocalPredefinedStates as V, getGlobalParser as Vt, setGlobalPredefinedStates as W, parseColor as Wt, fontFaceContentHash as X, okhslPlugin as Xt, extractLocalFontFace as Y, okhslFunction as Yt, formatFontFaceRule as Z, createColorFunc as Zt, isFunctionsPolyfillEnabled as _, hashString as _t, getGlobalCounterStyles as a, hslToRgbValues as an, closeBatchWindow as at, resetConfig as b, hasLocalProperties as bt, getGlobalInjector as c, openBatchWindow as ct, getGlobalStyles as d, DEFAULT_ZERO_NAME_PREFIX as dt, Lru as en, STYLE_HANDLER_MAP as et, getNamePrefix as f, makeClassName as ft, isConfigLocked as g, validateNamePrefix as gt, hasStylesGenerated as h, tastyClassRegex as ht, getGlobalConfigTokens as i, hexToRgb as in, PropertyTypeResolver as it, INNER_STYLES as j, extractLocalFunctions as jt, DIMENSION_STYLES as k, POSITION_CHUNK_STYLES as kt, getGlobalKeyframes as l, resetStyleBatch as lt, hasGlobalRecipes as m, makeKeyframeName as mt, getConfig as n, getNamedColorHex as nn, styleHandlers as nt, getGlobalFontFaces as o, strToRgb as on, flushStyles as ot, hasGlobalKeyframes as p, makeCounterStyleName as pt, formatCounterStyleRule as q, okhstFunction as qt, getEffectiveProperties as r, getRgbValuesFromRgbaString as rn, createStyle as rt, getGlobalFunctions as s, normalizeDslName as sn, hasPendingStyleWrites as st, configure as t, overrideColorAlpha as tn, defineHandler as tt, getGlobalRecipes as u, DEFAULT_NAME_PREFIX as ut, isTestEnvironment as v, extractLocalProperties as vt, BLOCK_INNER_STYLES as w, CHUNK_NAMES as wt, generateTypographyTokens as x, parsePropertyToken as xt, markStylesGenerated as y, getEffectiveDefinition as yt, camelToKebab as z, filterMods as zt };
 
-//# sourceMappingURL=config-B5kHzuNz.js.map
+//# sourceMappingURL=config-B3gPdCqd.js.map