@tenphi/tasty 0.9.0 → 0.10.1

package/dist/ssr/async-storage.js

@@ -0,0 +1,35 @@
+import { AsyncLocalStorage } from "node:async_hooks";
+
+//#region src/ssr/async-storage.ts
+/**
+* AsyncLocalStorage integration for SSR collector discovery.
+*
+* Used by Astro middleware and generic framework integrations where
+* the library cannot wrap the React tree with a context provider.
+* The middleware calls runWithCollector() around the render, and
+* useStyles() calls getSSRCollector() to find it.
+*
+* This module imports from 'node:async_hooks' — it must be excluded
+* from client bundles via the build configuration.
+*/
+const tastySSRStorage = new AsyncLocalStorage();
+/**
+* Run a function with a ServerStyleCollector bound to the current
+* async context. All useStyles() calls within `fn` (and any async
+* continuations) will find this collector via getSSRCollector().
+*/
+function runWithCollector(collector, fn) {
+	return tastySSRStorage.run(collector, fn);
+}
+/**
+* Retrieve the ServerStyleCollector bound to the current async context.
+* Returns null when called outside of runWithCollector() or on the client.
+*/
+function getSSRCollector() {
+	if (typeof tastySSRStorage?.getStore !== "function") return null;
+	return tastySSRStorage.getStore() ?? null;
+}
+
+//#endregion
+export { getSSRCollector, runWithCollector };
+//# sourceMappingURL=async-storage.js.map

package/dist/ssr/async-storage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"async-storage.js","names":[],"sources":["../../src/ssr/async-storage.ts"],"sourcesContent":["/**\n * AsyncLocalStorage integration for SSR collector discovery.\n *\n * Used by Astro middleware and generic framework integrations where\n * the library cannot wrap the React tree with a context provider.\n * The middleware calls runWithCollector() around the render, and\n * useStyles() calls getSSRCollector() to find it.\n *\n * This module imports from 'node:async_hooks' — it must be excluded\n * from client bundles via the build configuration.\n */\n\nimport { AsyncLocalStorage } from 'node:async_hooks';\n\nimport type { ServerStyleCollector } from './collector';\n\nconst tastySSRStorage = new AsyncLocalStorage<ServerStyleCollector>();\n\n/**\n * Run a function with a ServerStyleCollector bound to the current\n * async context. All useStyles() calls within `fn` (and any async\n * continuations) will find this collector via getSSRCollector().\n */\nexport function runWithCollector<T>(\n  collector: ServerStyleCollector,\n  fn: () => T,\n): T {\n  return tastySSRStorage.run(collector, fn);\n}\n\n/**\n * Retrieve the ServerStyleCollector bound to the current async context.\n * Returns null when called outside of runWithCollector() or on the client.\n */\nexport function getSSRCollector(): ServerStyleCollector | null {\n  if (typeof tastySSRStorage?.getStore !== 'function') return null;\n  return tastySSRStorage.getStore() ?? null;\n}\n"],"mappings":";;;;;;;;;;;;;;AAgBA,MAAM,kBAAkB,IAAI,mBAAyC;;;;;;AAOrE,SAAgB,iBACd,WACA,IACG;AACH,QAAO,gBAAgB,IAAI,WAAW,GAAG;;;;;;AAO3C,SAAgB,kBAA+C;AAC7D,KAAI,OAAO,iBAAiB,aAAa,WAAY,QAAO;AAC5D,QAAO,gBAAgB,UAAU,IAAI"}

package/dist/ssr/collect-auto-properties.js

@@ -0,0 +1,40 @@
+import { parsePropertyToken } from "../properties/index.js";
+import { PropertyTypeResolver } from "../properties/property-type-resolver.js";
+import { formatPropertyCSS } from "./format-property.js";
+
+//#region src/ssr/collect-auto-properties.ts
+/**
+* Scan rendered rules for custom property declarations and collect
+* auto-inferred @property rules via the SSR collector.
+*
+* @param rules - Rendered style rules containing CSS declarations
+* @param collector - SSR collector to emit @property CSS into
+* @param styles - Original styles object (used to skip explicit @properties)
+*/
+function collectAutoInferredProperties(rules, collector, styles) {
+	const registered = /* @__PURE__ */ new Set();
+	if (styles) {
+		const localProps = styles["@properties"];
+		if (localProps && typeof localProps === "object") for (const token of Object.keys(localProps)) {
+			const parsed = parsePropertyToken(token);
+			if (parsed.isValid) registered.add(parsed.cssName);
+		}
+	}
+	const resolver = new PropertyTypeResolver();
+	for (const rule of rules) {
+		if (!rule.declarations) continue;
+		resolver.scanDeclarations(rule.declarations, (name) => registered.has(name), (name, syntax, initialValue) => {
+			registered.add(name);
+			const css = formatPropertyCSS(name, {
+				syntax,
+				inherits: true,
+				initialValue
+			});
+			if (css) collector.collectProperty(`__auto:${name}`, css);
+		});
+	}
+}
+
+//#endregion
+export { collectAutoInferredProperties };
+//# sourceMappingURL=collect-auto-properties.js.map

package/dist/ssr/collect-auto-properties.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"collect-auto-properties.js","names":[],"sources":["../../src/ssr/collect-auto-properties.ts"],"sourcesContent":["/**\n * SSR auto-property inference.\n *\n * Scans rendered CSS declarations for custom properties whose types\n * can be inferred from their values (e.g. `--angle: 30deg` → `<angle>`).\n * Mirrors the client-side auto-inference in StyleInjector.inject().\n */\n\nimport type { StyleResult } from '../pipeline';\nimport { parsePropertyToken } from '../properties';\nimport { PropertyTypeResolver } from '../properties/property-type-resolver';\nimport type { Styles } from '../styles/types';\n\nimport type { ServerStyleCollector } from './collector';\nimport { formatPropertyCSS } from './format-property';\n\n/**\n * Scan rendered rules for custom property declarations and collect\n * auto-inferred @property rules via the SSR collector.\n *\n * @param rules - Rendered style rules containing CSS declarations\n * @param collector - SSR collector to emit @property CSS into\n * @param styles - Original styles object (used to skip explicit @properties)\n */\nexport function collectAutoInferredProperties(\n  rules: StyleResult[],\n  collector: ServerStyleCollector,\n  styles?: Styles,\n): void {\n  const registered = new Set<string>();\n\n  if (styles) {\n    const localProps = styles['@properties'];\n    if (localProps && typeof localProps === 'object') {\n      for (const token of Object.keys(localProps as Record<string, unknown>)) {\n        const parsed = parsePropertyToken(token);\n        if (parsed.isValid) {\n          registered.add(parsed.cssName);\n        }\n      }\n    }\n  }\n\n  const resolver = new PropertyTypeResolver();\n\n  for (const rule of rules) {\n    if (!rule.declarations) continue;\n    resolver.scanDeclarations(\n      rule.declarations,\n      (name) => registered.has(name),\n      (name, syntax, initialValue) => {\n        registered.add(name);\n        const css = formatPropertyCSS(name, {\n          syntax,\n          inherits: true,\n          initialValue,\n        });\n        if (css) {\n          collector.collectProperty(`__auto:${name}`, css);\n        }\n      },\n    );\n  }\n}\n"],"mappings":";;;;;;;;;;;;;AAwBA,SAAgB,8BACd,OACA,WACA,QACM;CACN,MAAM,6BAAa,IAAI,KAAa;AAEpC,KAAI,QAAQ;EACV,MAAM,aAAa,OAAO;AAC1B,MAAI,cAAc,OAAO,eAAe,SACtC,MAAK,MAAM,SAAS,OAAO,KAAK,WAAsC,EAAE;GACtE,MAAM,SAAS,mBAAmB,MAAM;AACxC,OAAI,OAAO,QACT,YAAW,IAAI,OAAO,QAAQ;;;CAMtC,MAAM,WAAW,IAAI,sBAAsB;AAE3C,MAAK,MAAM,QAAQ,OAAO;AACxB,MAAI,CAAC,KAAK,aAAc;AACxB,WAAS,iBACP,KAAK,eACJ,SAAS,WAAW,IAAI,KAAK,GAC7B,MAAM,QAAQ,iBAAiB;AAC9B,cAAW,IAAI,KAAK;GACpB,MAAM,MAAM,kBAAkB,MAAM;IAClC;IACA,UAAU;IACV;IACD,CAAC;AACF,OAAI,IACF,WAAU,gBAAgB,UAAU,QAAQ,IAAI;IAGrD"}

package/dist/ssr/collector.d.ts

@@ -0,0 +1,85 @@
+import { StyleResult } from "../pipeline/index.js";
+
+//#region src/ssr/collector.d.ts
+/**
+ * Cache state serialized to the client for hydration.
+ */
+interface SSRCacheState {
+  /** cacheKey → className map, to pre-populate the client registry */
+  entries: Record<string, string>;
+  /** Counter value so client allocations don't collide with server ones */
+  classCounter: number;
+}
+declare class ServerStyleCollector {
+  private chunks;
+  private cacheKeyToClassName;
+  private classCounter;
+  private flushedKeys;
+  private propertyRules;
+  private flushedPropertyKeys;
+  private keyframeRules;
+  private flushedKeyframeKeys;
+  private globalStyles;
+  private flushedGlobalKeys;
+  private rawCSS;
+  private flushedRawKeys;
+  private keyframesCounter;
+  private internalsCollected;
+  /**
+   * Collect internal @property rules and :root token defaults.
+   * Mirrors markStylesGenerated() from the client-side injector.
+   * Called automatically on first chunk collection; idempotent.
+   */
+  collectInternals(): void;
+  /**
+   * Allocate a className for a cache key, server-side.
+   * Mirrors StyleInjector.allocateClassName but without DOM access.
+   */
+  allocateClassName(cacheKey: string): {
+    className: string;
+    isNewAllocation: boolean;
+  };
+  /**
+   * Record CSS rules for a chunk.
+   * Called by useStyles during server render.
+   */
+  collectChunk(cacheKey: string, className: string, rules: StyleResult[]): void;
+  /**
+   * Record a @property rule. Deduplicated by name.
+   */
+  collectProperty(name: string, css: string): void;
+  /**
+   * Record a @keyframes rule. Deduplicated by name.
+   */
+  collectKeyframes(name: string, css: string): void;
+  /**
+   * Allocate a keyframe name for SSR. Uses provided name or generates one.
+   */
+  allocateKeyframeName(providedName?: string): string;
+  /**
+   * Record global styles (from useGlobalStyles). Deduplicated by key.
+   */
+  collectGlobalStyles(key: string, css: string): void;
+  /**
+   * Record raw CSS text (from useRawCSS). Deduplicated by key.
+   */
+  collectRawCSS(key: string, css: string): void;
+  /**
+   * Extract all CSS collected so far as a single string.
+   * Includes @property and @keyframes rules.
+   * Used for non-streaming SSR (renderToString).
+   */
+  getCSS(): string;
+  /**
+   * Flush only newly collected CSS since the last flush.
+   * Used for streaming SSR (renderToPipeableStream + useServerInsertedHTML).
+   */
+  flushCSS(): string;
+  /**
+   * Serialize the cache state for client hydration.
+   */
+  getCacheState(): SSRCacheState;
+}
+//#endregion
+export { SSRCacheState, ServerStyleCollector };
+//# sourceMappingURL=collector.d.ts.map

package/dist/ssr/collector.js

@@ -0,0 +1,173 @@
+import { INTERNAL_PROPERTIES, INTERNAL_TOKENS, getGlobalProperties, hasGlobalProperties } from "../config.js";
+import { formatPropertyCSS } from "./format-property.js";
+import { formatRules } from "./format-rules.js";
+
+//#region src/ssr/collector.ts
+/**
+* ServerStyleCollector — server-safe style collector for SSR.
+*
+* Accumulates CSS rules and cache metadata during server rendering.
+* This is the server-side counterpart to StyleInjector: it allocates
+* sequential class names (t0, t1, …), formats CSS rules into text,
+* and serializes the cache state for client hydration.
+*
+* One instance is created per HTTP request. Concurrent requests
+* each get their own collector (via AsyncLocalStorage or React context).
+*/
+function generateClassName(counter) {
+	return `t${counter}`;
+}
+var ServerStyleCollector = class {
+	chunks = /* @__PURE__ */ new Map();
+	cacheKeyToClassName = /* @__PURE__ */ new Map();
+	classCounter = 0;
+	flushedKeys = /* @__PURE__ */ new Set();
+	propertyRules = /* @__PURE__ */ new Map();
+	flushedPropertyKeys = /* @__PURE__ */ new Set();
+	keyframeRules = /* @__PURE__ */ new Map();
+	flushedKeyframeKeys = /* @__PURE__ */ new Set();
+	globalStyles = /* @__PURE__ */ new Map();
+	flushedGlobalKeys = /* @__PURE__ */ new Set();
+	rawCSS = /* @__PURE__ */ new Map();
+	flushedRawKeys = /* @__PURE__ */ new Set();
+	keyframesCounter = 0;
+	internalsCollected = false;
+	/**
+	* Collect internal @property rules and :root token defaults.
+	* Mirrors markStylesGenerated() from the client-side injector.
+	* Called automatically on first chunk collection; idempotent.
+	*/
+	collectInternals() {
+		if (this.internalsCollected) return;
+		this.internalsCollected = true;
+		for (const [token, definition] of Object.entries(INTERNAL_PROPERTIES)) {
+			const css = formatPropertyCSS(token, definition);
+			if (css) this.collectProperty(`__internal:${token}`, css);
+		}
+		if (hasGlobalProperties()) {
+			const globalProps = getGlobalProperties();
+			if (globalProps) for (const [token, definition] of Object.entries(globalProps)) {
+				const css = formatPropertyCSS(token, definition);
+				if (css) this.collectProperty(`__global:${token}`, css);
+			}
+		}
+		const tokenEntries = Object.entries(INTERNAL_TOKENS);
+		if (tokenEntries.length > 0) {
+			const declarations = tokenEntries.map(([name, value]) => `${name}: ${value}`).join("; ");
+			this.collectProperty("__internal:root-tokens", `:root { ${declarations} }`);
+		}
+	}
+	/**
+	* Allocate a className for a cache key, server-side.
+	* Mirrors StyleInjector.allocateClassName but without DOM access.
+	*/
+	allocateClassName(cacheKey) {
+		const existing = this.cacheKeyToClassName.get(cacheKey);
+		if (existing) return {
+			className: existing,
+			isNewAllocation: false
+		};
+		const className = generateClassName(this.classCounter++);
+		this.cacheKeyToClassName.set(cacheKey, className);
+		return {
+			className,
+			isNewAllocation: true
+		};
+	}
+	/**
+	* Record CSS rules for a chunk.
+	* Called by useStyles during server render.
+	*/
+	collectChunk(cacheKey, className, rules) {
+		if (this.chunks.has(cacheKey)) return;
+		const css = formatRules(rules, className);
+		if (css) this.chunks.set(cacheKey, css);
+	}
+	/**
+	* Record a @property rule. Deduplicated by name.
+	*/
+	collectProperty(name, css) {
+		if (!this.propertyRules.has(name)) this.propertyRules.set(name, css);
+	}
+	/**
+	* Record a @keyframes rule. Deduplicated by name.
+	*/
+	collectKeyframes(name, css) {
+		if (!this.keyframeRules.has(name)) this.keyframeRules.set(name, css);
+	}
+	/**
+	* Allocate a keyframe name for SSR. Uses provided name or generates one.
+	*/
+	allocateKeyframeName(providedName) {
+		return providedName ?? `k${this.keyframesCounter++}`;
+	}
+	/**
+	* Record global styles (from useGlobalStyles). Deduplicated by key.
+	*/
+	collectGlobalStyles(key, css) {
+		if (!this.globalStyles.has(key)) this.globalStyles.set(key, css);
+	}
+	/**
+	* Record raw CSS text (from useRawCSS). Deduplicated by key.
+	*/
+	collectRawCSS(key, css) {
+		if (!this.rawCSS.has(key)) this.rawCSS.set(key, css);
+	}
+	/**
+	* Extract all CSS collected so far as a single string.
+	* Includes @property and @keyframes rules.
+	* Used for non-streaming SSR (renderToString).
+	*/
+	getCSS() {
+		const parts = [];
+		for (const css of this.propertyRules.values()) parts.push(css);
+		for (const css of this.rawCSS.values()) parts.push(css);
+		for (const css of this.globalStyles.values()) parts.push(css);
+		for (const css of this.chunks.values()) parts.push(css);
+		for (const css of this.keyframeRules.values()) parts.push(css);
+		return parts.join("\n");
+	}
+	/**
+	* Flush only newly collected CSS since the last flush.
+	* Used for streaming SSR (renderToPipeableStream + useServerInsertedHTML).
+	*/
+	flushCSS() {
+		const parts = [];
+		for (const [name, css] of this.propertyRules) if (!this.flushedPropertyKeys.has(name)) {
+			parts.push(css);
+			this.flushedPropertyKeys.add(name);
+		}
+		for (const [key, css] of this.rawCSS) if (!this.flushedRawKeys.has(key)) {
+			parts.push(css);
+			this.flushedRawKeys.add(key);
+		}
+		for (const [key, css] of this.globalStyles) if (!this.flushedGlobalKeys.has(key)) {
+			parts.push(css);
+			this.flushedGlobalKeys.add(key);
+		}
+		for (const [key, css] of this.chunks) if (!this.flushedKeys.has(key)) {
+			parts.push(css);
+			this.flushedKeys.add(key);
+		}
+		for (const [name, css] of this.keyframeRules) if (!this.flushedKeyframeKeys.has(name)) {
+			parts.push(css);
+			this.flushedKeyframeKeys.add(name);
+		}
+		return parts.join("\n");
+	}
+	/**
+	* Serialize the cache state for client hydration.
+	*/
+	getCacheState() {
+		const entries = {};
+		for (const [cacheKey, className] of this.cacheKeyToClassName) entries[cacheKey] = className;
+		return {
+			entries,
+			classCounter: this.classCounter
+		};
+	}
+};
+
+//#endregion
+export { ServerStyleCollector };
+//# sourceMappingURL=collector.js.map

package/dist/ssr/collector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"collector.js","names":[],"sources":["../../src/ssr/collector.ts"],"sourcesContent":["/**\n * ServerStyleCollector — server-safe style collector for SSR.\n *\n * Accumulates CSS rules and cache metadata during server rendering.\n * This is the server-side counterpart to StyleInjector: it allocates\n * sequential class names (t0, t1, …), formats CSS rules into text,\n * and serializes the cache state for client hydration.\n *\n * One instance is created per HTTP request. Concurrent requests\n * each get their own collector (via AsyncLocalStorage or React context).\n */\n\nimport {\n  getGlobalProperties,\n  hasGlobalProperties,\n  INTERNAL_PROPERTIES,\n  INTERNAL_TOKENS,\n} from '../config';\nimport type { StyleResult } from '../pipeline';\nimport { formatPropertyCSS } from './format-property';\nimport { formatRules } from './format-rules';\n\n/**\n * Cache state serialized to the client for hydration.\n */\nexport interface SSRCacheState {\n  /** cacheKey → className map, to pre-populate the client registry */\n  entries: Record<string, string>;\n  /** Counter value so client allocations don't collide with server ones */\n  classCounter: number;\n}\n\nfunction generateClassName(counter: number): string {\n  return `t${counter}`;\n}\n\nexport class ServerStyleCollector {\n  private chunks = new Map<string, string>();\n  private cacheKeyToClassName = new Map<string, string>();\n  private classCounter = 0;\n  private flushedKeys = new Set<string>();\n  private propertyRules = new Map<string, string>();\n  private flushedPropertyKeys = new Set<string>();\n  private keyframeRules = new Map<string, string>();\n  private flushedKeyframeKeys = new Set<string>();\n  private globalStyles = new Map<string, string>();\n  private flushedGlobalKeys = new Set<string>();\n  private rawCSS = new Map<string, string>();\n  private flushedRawKeys = new Set<string>();\n  private keyframesCounter = 0;\n  private internalsCollected = false;\n\n  /**\n   * Collect internal @property rules and :root token defaults.\n   * Mirrors markStylesGenerated() from the client-side injector.\n   * Called automatically on first chunk collection; idempotent.\n   */\n  collectInternals(): void {\n    if (this.internalsCollected) return;\n    this.internalsCollected = true;\n\n    for (const [token, definition] of Object.entries(INTERNAL_PROPERTIES)) {\n      const css = formatPropertyCSS(token, definition);\n      if (css) {\n        this.collectProperty(`__internal:${token}`, css);\n      }\n    }\n\n    if (hasGlobalProperties()) {\n      const globalProps = getGlobalProperties();\n      if (globalProps) {\n        for (const [token, definition] of Object.entries(globalProps)) {\n          const css = formatPropertyCSS(token, definition);\n          if (css) {\n            this.collectProperty(`__global:${token}`, css);\n          }\n        }\n      }\n    }\n\n    const tokenEntries = Object.entries(INTERNAL_TOKENS);\n    if (tokenEntries.length > 0) {\n      const declarations = tokenEntries\n        .map(([name, value]) => `${name}: ${value}`)\n        .join('; ');\n      this.collectProperty(\n        '__internal:root-tokens',\n        `:root { ${declarations} }`,\n      );\n    }\n  }\n\n  /**\n   * Allocate a className for a cache key, server-side.\n   * Mirrors StyleInjector.allocateClassName but without DOM access.\n   */\n  allocateClassName(cacheKey: string): {\n    className: string;\n    isNewAllocation: boolean;\n  } {\n    const existing = this.cacheKeyToClassName.get(cacheKey);\n    if (existing) {\n      return { className: existing, isNewAllocation: false };\n    }\n\n    const className = generateClassName(this.classCounter++);\n    this.cacheKeyToClassName.set(cacheKey, className);\n\n    return { className, isNewAllocation: true };\n  }\n\n  /**\n   * Record CSS rules for a chunk.\n   * Called by useStyles during server render.\n   */\n  collectChunk(\n    cacheKey: string,\n    className: string,\n    rules: StyleResult[],\n  ): void {\n    if (this.chunks.has(cacheKey)) return;\n    const css = formatRules(rules, className);\n    if (css) {\n      this.chunks.set(cacheKey, css);\n    }\n  }\n\n  /**\n   * Record a @property rule. Deduplicated by name.\n   */\n  collectProperty(name: string, css: string): void {\n    if (!this.propertyRules.has(name)) {\n      this.propertyRules.set(name, css);\n    }\n  }\n\n  /**\n   * Record a @keyframes rule. Deduplicated by name.\n   */\n  collectKeyframes(name: string, css: string): void {\n    if (!this.keyframeRules.has(name)) {\n      this.keyframeRules.set(name, css);\n    }\n  }\n\n  /**\n   * Allocate a keyframe name for SSR. Uses provided name or generates one.\n   */\n  allocateKeyframeName(providedName?: string): string {\n    return providedName ?? `k${this.keyframesCounter++}`;\n  }\n\n  /**\n   * Record global styles (from useGlobalStyles). Deduplicated by key.\n   */\n  collectGlobalStyles(key: string, css: string): void {\n    if (!this.globalStyles.has(key)) {\n      this.globalStyles.set(key, css);\n    }\n  }\n\n  /**\n   * Record raw CSS text (from useRawCSS). Deduplicated by key.\n   */\n  collectRawCSS(key: string, css: string): void {\n    if (!this.rawCSS.has(key)) {\n      this.rawCSS.set(key, css);\n    }\n  }\n\n  /**\n   * Extract all CSS collected so far as a single string.\n   * Includes @property and @keyframes rules.\n   * Used for non-streaming SSR (renderToString).\n   */\n  getCSS(): string {\n    const parts: string[] = [];\n\n    for (const css of this.propertyRules.values()) {\n      parts.push(css);\n    }\n\n    for (const css of this.rawCSS.values()) {\n      parts.push(css);\n    }\n\n    for (const css of this.globalStyles.values()) {\n      parts.push(css);\n    }\n\n    for (const css of this.chunks.values()) {\n      parts.push(css);\n    }\n\n    for (const css of this.keyframeRules.values()) {\n      parts.push(css);\n    }\n\n    return parts.join('\\n');\n  }\n\n  /**\n   * Flush only newly collected CSS since the last flush.\n   * Used for streaming SSR (renderToPipeableStream + useServerInsertedHTML).\n   */\n  flushCSS(): string {\n    const parts: string[] = [];\n\n    for (const [name, css] of this.propertyRules) {\n      if (!this.flushedPropertyKeys.has(name)) {\n        parts.push(css);\n        this.flushedPropertyKeys.add(name);\n      }\n    }\n\n    for (const [key, css] of this.rawCSS) {\n      if (!this.flushedRawKeys.has(key)) {\n        parts.push(css);\n        this.flushedRawKeys.add(key);\n      }\n    }\n\n    for (const [key, css] of this.globalStyles) {\n      if (!this.flushedGlobalKeys.has(key)) {\n        parts.push(css);\n        this.flushedGlobalKeys.add(key);\n      }\n    }\n\n    for (const [key, css] of this.chunks) {\n      if (!this.flushedKeys.has(key)) {\n        parts.push(css);\n        this.flushedKeys.add(key);\n      }\n    }\n\n    for (const [name, css] of this.keyframeRules) {\n      if (!this.flushedKeyframeKeys.has(name)) {\n        parts.push(css);\n        this.flushedKeyframeKeys.add(name);\n      }\n    }\n\n    return parts.join('\\n');\n  }\n\n  /**\n   * Serialize the cache state for client hydration.\n   */\n  getCacheState(): SSRCacheState {\n    const entries: Record<string, string> = {};\n    for (const [cacheKey, className] of this.cacheKeyToClassName) {\n      entries[cacheKey] = className;\n    }\n    return { entries, classCounter: this.classCounter };\n  }\n}\n"],"mappings":"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"}

package/dist/ssr/context.d.ts

@@ -0,0 +1,8 @@
+import { ServerStyleCollector } from "./collector.js";
+import * as react from "react";
+
+//#region src/ssr/context.d.ts
+declare const TastySSRContext: react.Context<ServerStyleCollector | null>;
+//#endregion
+export { TastySSRContext };
+//# sourceMappingURL=context.d.ts.map

package/dist/ssr/context.js

@@ -0,0 +1,14 @@
+import { createContext } from "react";
+
+//#region src/ssr/context.ts
+/**
+* React context for SSR collector discovery.
+*
+* Used by Next.js TastyRegistry to provide the ServerStyleCollector
+* to useStyles() via React context (the streaming-compatible path).
+*/
+const TastySSRContext = createContext(null);
+
+//#endregion
+export { TastySSRContext };
+//# sourceMappingURL=context.js.map

package/dist/ssr/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","names":[],"sources":["../../src/ssr/context.ts"],"sourcesContent":["/**\n * React context for SSR collector discovery.\n *\n * Used by Next.js TastyRegistry to provide the ServerStyleCollector\n * to useStyles() via React context (the streaming-compatible path).\n */\n\nimport { createContext } from 'react';\n\nimport type { ServerStyleCollector } from './collector';\n\nexport const TastySSRContext = createContext<ServerStyleCollector | null>(null);\n"],"mappings":";;;;;;;;;AAWA,MAAa,kBAAkB,cAA2C,KAAK"}

package/dist/ssr/format-global-rules.js

@@ -0,0 +1,22 @@
+//#region src/ssr/format-global-rules.ts
+/**
+* Format an array of global StyleResult rules into a CSS text string.
+*
+* Rules already have their full selectors applied by renderStyles().
+* Handles rootPrefix prepending and at-rule wrapping.
+*/
+function formatGlobalRules(rules) {
+	if (rules.length === 0) return "";
+	const cssRules = [];
+	for (const rule of rules) {
+		const baseRule = `${rule.rootPrefix ? `${rule.rootPrefix} ${rule.selector}` : rule.selector} { ${rule.declarations} }`;
+		let fullRule = baseRule;
+		if (rule.atRules && rule.atRules.length > 0) fullRule = rule.atRules.reduce((css, atRule) => `${atRule} { ${css} }`, baseRule);
+		cssRules.push(fullRule);
+	}
+	return cssRules.join("\n");
+}
+
+//#endregion
+export { formatGlobalRules };
+//# sourceMappingURL=format-global-rules.js.map

package/dist/ssr/format-global-rules.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"format-global-rules.js","names":[],"sources":["../../src/ssr/format-global-rules.ts"],"sourcesContent":["/**\n * Format global CSS rules for SSR output.\n *\n * Unlike formatRules() which applies className-based specificity doubling,\n * this function formats rules that already have their full selectors\n * (from renderStyles called with a selector string).\n */\n\nimport type { StyleResult } from '../pipeline';\n\n/**\n * Format an array of global StyleResult rules into a CSS text string.\n *\n * Rules already have their full selectors applied by renderStyles().\n * Handles rootPrefix prepending and at-rule wrapping.\n */\nexport function formatGlobalRules(rules: StyleResult[]): string {\n  if (rules.length === 0) return '';\n\n  const cssRules: string[] = [];\n\n  for (const rule of rules) {\n    const selector = rule.rootPrefix\n      ? `${rule.rootPrefix} ${rule.selector}`\n      : rule.selector;\n\n    const baseRule = `${selector} { ${rule.declarations} }`;\n\n    let fullRule = baseRule;\n    if (rule.atRules && rule.atRules.length > 0) {\n      fullRule = rule.atRules.reduce(\n        (css, atRule) => `${atRule} { ${css} }`,\n        baseRule,\n      );\n    }\n\n    cssRules.push(fullRule);\n  }\n\n  return cssRules.join('\\n');\n}\n"],"mappings":";;;;;;;AAgBA,SAAgB,kBAAkB,OAA8B;AAC9D,KAAI,MAAM,WAAW,EAAG,QAAO;CAE/B,MAAM,WAAqB,EAAE;AAE7B,MAAK,MAAM,QAAQ,OAAO;EAKxB,MAAM,WAAW,GAJA,KAAK,aAClB,GAAG,KAAK,WAAW,GAAG,KAAK,aAC3B,KAAK,SAEoB,KAAK,KAAK,aAAa;EAEpD,IAAI,WAAW;AACf,MAAI,KAAK,WAAW,KAAK,QAAQ,SAAS,EACxC,YAAW,KAAK,QAAQ,QACrB,KAAK,WAAW,GAAG,OAAO,KAAK,IAAI,KACpC,SACD;AAGH,WAAS,KAAK,SAAS;;AAGzB,QAAO,SAAS,KAAK,KAAK"}

package/dist/ssr/format-keyframes.js

@@ -0,0 +1,70 @@
+import { createStyle } from "../styles/createStyle.js";
+import { STYLE_HANDLER_MAP } from "../styles/index.js";
+
+//#region src/ssr/format-keyframes.ts
+/**
+* Convert keyframes steps to a CSS string.
+* Replicates SheetManager.stepsToCSS() without the class instance.
+*/
+function stepsToCSS(steps) {
+	const rules = [];
+	for (const [key, value] of Object.entries(steps)) {
+		if (typeof value === "string") {
+			rules.push(`${key} { ${value.trim()} }`);
+			continue;
+		}
+		const styleMap = value || {};
+		const styleNames = Object.keys(styleMap).sort();
+		const handlerQueue = [];
+		const seenHandlers = /* @__PURE__ */ new Set();
+		styleNames.forEach((styleName) => {
+			let handlers = STYLE_HANDLER_MAP[styleName];
+			if (!handlers) handlers = STYLE_HANDLER_MAP[styleName] = [createStyle(styleName)];
+			handlers.forEach((handler) => {
+				if (!seenHandlers.has(handler)) {
+					seenHandlers.add(handler);
+					handlerQueue.push(handler);
+				}
+			});
+		});
+		const declarationPairs = [];
+		handlerQueue.forEach((handler) => {
+			const result = handler(handler.__lookupStyles.reduce((acc, name) => {
+				const v = styleMap[name];
+				if (v !== void 0) acc[name] = v;
+				return acc;
+			}, {}));
+			if (!result) return;
+			(Array.isArray(result) ? result : [result]).forEach((cssMap) => {
+				if (!cssMap || typeof cssMap !== "object") return;
+				const { $: _$, ...props } = cssMap;
+				Object.entries(props).forEach(([prop, val]) => {
+					if (val == null || val === "") return;
+					if (Array.isArray(val)) val.forEach((v) => {
+						if (v != null && v !== "") declarationPairs.push({
+							prop,
+							value: String(v)
+						});
+					});
+					else declarationPairs.push({
+						prop,
+						value: String(val)
+					});
+				});
+			});
+		});
+		const declarations = declarationPairs.map((d) => `${d.prop}: ${d.value}`).join("; ");
+		rules.push(`${key} { ${declarations.trim()} }`);
+	}
+	return rules.join(" ");
+}
+/**
+* Format a @keyframes rule as a CSS string.
+*/
+function formatKeyframesCSS(name, steps) {
+	return `@keyframes ${name} { ${stepsToCSS(steps)} }`;
+}
+
+//#endregion
+export { formatKeyframesCSS };
+//# sourceMappingURL=format-keyframes.js.map

package/dist/ssr/format-keyframes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"format-keyframes.js","names":[],"sources":["../../src/ssr/format-keyframes.ts"],"sourcesContent":["/**\n * Format @keyframes CSS rules for SSR output.\n *\n * Replicates the stepsToCSS logic from SheetManager but as a\n * standalone function that doesn't need DOM access.\n */\n\nimport type { KeyframesSteps } from '../injector/types';\nimport { createStyle, STYLE_HANDLER_MAP } from '../styles';\nimport type { CSSMap, StyleHandler, StyleValueStateMap } from '../utils/styles';\n\n/**\n * Convert keyframes steps to a CSS string.\n * Replicates SheetManager.stepsToCSS() without the class instance.\n */\nfunction stepsToCSS(steps: KeyframesSteps): string {\n  const rules: string[] = [];\n\n  for (const [key, value] of Object.entries(steps)) {\n    if (typeof value === 'string') {\n      rules.push(`${key} { ${value.trim()} }`);\n      continue;\n    }\n\n    const styleMap = (value || {}) as StyleValueStateMap;\n    const styleNames = Object.keys(styleMap).sort();\n    const handlerQueue: StyleHandler[] = [];\n    const seenHandlers = new Set<StyleHandler>();\n\n    styleNames.forEach((styleName) => {\n      let handlers = STYLE_HANDLER_MAP[styleName];\n      if (!handlers) {\n        handlers = STYLE_HANDLER_MAP[styleName] = [createStyle(styleName)];\n      }\n\n      handlers.forEach((handler) => {\n        if (!seenHandlers.has(handler)) {\n          seenHandlers.add(handler);\n          handlerQueue.push(handler);\n        }\n      });\n    });\n\n    const declarationPairs: { prop: string; value: string }[] = [];\n\n    handlerQueue.forEach((handler) => {\n      const lookup = handler.__lookupStyles;\n      const filteredMap = lookup.reduce<StyleValueStateMap>((acc, name) => {\n        const v = styleMap[name];\n        if (v !== undefined) acc[name] = v;\n        return acc;\n      }, {});\n\n      const result = handler(filteredMap);\n      if (!result) return;\n\n      const results = Array.isArray(result) ? result : [result];\n      results.forEach((cssMap) => {\n        if (!cssMap || typeof cssMap !== 'object') return;\n        const { $: _$, ...props } = cssMap as CSSMap;\n\n        Object.entries(props).forEach(([prop, val]) => {\n          if (val == null || val === '') return;\n\n          if (Array.isArray(val)) {\n            val.forEach((v) => {\n              if (v != null && v !== '') {\n                declarationPairs.push({ prop, value: String(v) });\n              }\n            });\n          } else {\n            declarationPairs.push({ prop, value: String(val) });\n          }\n        });\n      });\n    });\n\n    const declarations = declarationPairs\n      .map((d) => `${d.prop}: ${d.value}`)\n      .join('; ');\n\n    rules.push(`${key} { ${declarations.trim()} }`);\n  }\n\n  return rules.join(' ');\n}\n\n/**\n * Format a @keyframes rule as a CSS string.\n */\nexport function formatKeyframesCSS(\n  name: string,\n  steps: KeyframesSteps,\n): string {\n  const cssSteps = stepsToCSS(steps);\n  return `@keyframes ${name} { ${cssSteps} }`;\n}\n"],"mappings":";;;;;;;;AAeA,SAAS,WAAW,OAA+B;CACjD,MAAM,QAAkB,EAAE;AAE1B,MAAK,MAAM,CAAC,KAAK,UAAU,OAAO,QAAQ,MAAM,EAAE;AAChD,MAAI,OAAO,UAAU,UAAU;AAC7B,SAAM,KAAK,GAAG,IAAI,KAAK,MAAM,MAAM,CAAC,IAAI;AACxC;;EAGF,MAAM,WAAY,SAAS,EAAE;EAC7B,MAAM,aAAa,OAAO,KAAK,SAAS,CAAC,MAAM;EAC/C,MAAM,eAA+B,EAAE;EACvC,MAAM,+BAAe,IAAI,KAAmB;AAE5C,aAAW,SAAS,cAAc;GAChC,IAAI,WAAW,kBAAkB;AACjC,OAAI,CAAC,SACH,YAAW,kBAAkB,aAAa,CAAC,YAAY,UAAU,CAAC;AAGpE,YAAS,SAAS,YAAY;AAC5B,QAAI,CAAC,aAAa,IAAI,QAAQ,EAAE;AAC9B,kBAAa,IAAI,QAAQ;AACzB,kBAAa,KAAK,QAAQ;;KAE5B;IACF;EAEF,MAAM,mBAAsD,EAAE;AAE9D,eAAa,SAAS,YAAY;GAQhC,MAAM,SAAS,QAPA,QAAQ,eACI,QAA4B,KAAK,SAAS;IACnE,MAAM,IAAI,SAAS;AACnB,QAAI,MAAM,OAAW,KAAI,QAAQ;AACjC,WAAO;MACN,EAAE,CAAC,CAE6B;AACnC,OAAI,CAAC,OAAQ;AAGb,IADgB,MAAM,QAAQ,OAAO,GAAG,SAAS,CAAC,OAAO,EACjD,SAAS,WAAW;AAC1B,QAAI,CAAC,UAAU,OAAO,WAAW,SAAU;IAC3C,MAAM,EAAE,GAAG,IAAI,GAAG,UAAU;AAE5B,WAAO,QAAQ,MAAM,CAAC,SAAS,CAAC,MAAM,SAAS;AAC7C,SAAI,OAAO,QAAQ,QAAQ,GAAI;AAE/B,SAAI,MAAM,QAAQ,IAAI,CACpB,KAAI,SAAS,MAAM;AACjB,UAAI,KAAK,QAAQ,MAAM,GACrB,kBAAiB,KAAK;OAAE;OAAM,OAAO,OAAO,EAAE;OAAE,CAAC;OAEnD;SAEF,kBAAiB,KAAK;MAAE;MAAM,OAAO,OAAO,IAAI;MAAE,CAAC;MAErD;KACF;IACF;EAEF,MAAM,eAAe,iBAClB,KAAK,MAAM,GAAG,EAAE,KAAK,IAAI,EAAE,QAAQ,CACnC,KAAK,KAAK;AAEb,QAAM,KAAK,GAAG,IAAI,KAAK,aAAa,MAAM,CAAC,IAAI;;AAGjD,QAAO,MAAM,KAAK,IAAI;;;;;AAMxB,SAAgB,mBACd,MACA,OACQ;AAER,QAAO,cAAc,KAAK,KADT,WAAW,MAAM,CACM"}

package/dist/ssr/format-property.js

@@ -0,0 +1,48 @@
+import { colorInitialValueToRgb, getEffectiveDefinition } from "../properties/index.js";
+import { parseStyle } from "../utils/styles.js";
+
+//#region src/ssr/format-property.ts
+/**
+* Format a single @property rule as a CSS string.
+*
+* Returns the full `@property --name { ... }` text, or empty string
+* if the token is invalid. For color properties, also returns
+* the companion `-rgb` property.
+*/
+function formatPropertyCSS(token, definition) {
+	const result = getEffectiveDefinition(token, definition);
+	if (!result.isValid) return "";
+	const rules = [];
+	rules.push(buildPropertyRule(result.cssName, result.definition));
+	if (result.isColor) {
+		const rgbCssName = `${result.cssName}-rgb`;
+		const rgbInitial = colorInitialValueToRgb(result.definition.initialValue);
+		rules.push(buildPropertyRule(rgbCssName, {
+			syntax: "<number>+",
+			inherits: result.definition.inherits,
+			initialValue: rgbInitial
+		}));
+	}
+	return rules.join("\n");
+}
+function buildPropertyRule(cssName, definition) {
+	const parts = [];
+	if (definition.syntax != null) {
+		let syntax = String(definition.syntax).trim();
+		if (!/^['"]/u.test(syntax)) syntax = `"${syntax}"`;
+		parts.push(`syntax: ${syntax};`);
+	}
+	const inherits = definition.inherits ?? true;
+	parts.push(`inherits: ${inherits ? "true" : "false"};`);
+	if (definition.initialValue != null) {
+		let initialValueStr;
+		if (typeof definition.initialValue === "number") initialValueStr = String(definition.initialValue);
+		else initialValueStr = parseStyle(definition.initialValue).output;
+		parts.push(`initial-value: ${initialValueStr};`);
+	}
+	return `@property ${cssName} { ${parts.join(" ").trim()} }`;
+}
+
+//#endregion
+export { formatPropertyCSS };
+//# sourceMappingURL=format-property.js.map

package/dist/ssr/format-property.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"format-property.js","names":[],"sources":["../../src/ssr/format-property.ts"],"sourcesContent":["/**\n * Format @property CSS rules for SSR output.\n *\n * Replicates the CSS construction from StyleInjector.property()\n * but returns a CSS string instead of inserting into the DOM.\n */\n\nimport type { PropertyDefinition } from '../injector/types';\nimport { colorInitialValueToRgb, getEffectiveDefinition } from '../properties';\nimport type { StyleValue } from '../utils/styles';\nimport { parseStyle } from '../utils/styles';\n\n/**\n * Format a single @property rule as a CSS string.\n *\n * Returns the full `@property --name { ... }` text, or empty string\n * if the token is invalid. For color properties, also returns\n * the companion `-rgb` property.\n */\nexport function formatPropertyCSS(\n  token: string,\n  definition: PropertyDefinition,\n): string {\n  const result = getEffectiveDefinition(token, definition);\n  if (!result.isValid) return '';\n\n  const rules: string[] = [];\n\n  rules.push(buildPropertyRule(result.cssName, result.definition));\n\n  if (result.isColor) {\n    const rgbCssName = `${result.cssName}-rgb`;\n    const rgbInitial = colorInitialValueToRgb(result.definition.initialValue);\n    rules.push(\n      buildPropertyRule(rgbCssName, {\n        syntax: '<number>+',\n        inherits: result.definition.inherits,\n        initialValue: rgbInitial,\n      }),\n    );\n  }\n\n  return rules.join('\\n');\n}\n\nfunction buildPropertyRule(\n  cssName: string,\n  definition: PropertyDefinition,\n): string {\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  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      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  return `@property ${cssName} { ${declarations} }`;\n}\n"],"mappings":";;;;;;;;;;;AAmBA,SAAgB,kBACd,OACA,YACQ;CACR,MAAM,SAAS,uBAAuB,OAAO,WAAW;AACxD,KAAI,CAAC,OAAO,QAAS,QAAO;CAE5B,MAAM,QAAkB,EAAE;AAE1B,OAAM,KAAK,kBAAkB,OAAO,SAAS,OAAO,WAAW,CAAC;AAEhE,KAAI,OAAO,SAAS;EAClB,MAAM,aAAa,GAAG,OAAO,QAAQ;EACrC,MAAM,aAAa,uBAAuB,OAAO,WAAW,aAAa;AACzE,QAAM,KACJ,kBAAkB,YAAY;GAC5B,QAAQ;GACR,UAAU,OAAO,WAAW;GAC5B,cAAc;GACf,CAAC,CACH;;AAGH,QAAO,MAAM,KAAK,KAAK;;AAGzB,SAAS,kBACP,SACA,YACQ;CACR,MAAM,QAAkB,EAAE;AAE1B,KAAI,WAAW,UAAU,MAAM;EAC7B,IAAI,SAAS,OAAO,WAAW,OAAO,CAAC,MAAM;AAC7C,MAAI,CAAC,SAAS,KAAK,OAAO,CAAE,UAAS,IAAI,OAAO;AAChD,QAAM,KAAK,WAAW,OAAO,GAAG;;CAGlC,MAAM,WAAW,WAAW,YAAY;AACxC,OAAM,KAAK,aAAa,WAAW,SAAS,QAAQ,GAAG;AAEvD,KAAI,WAAW,gBAAgB,MAAM;EACnC,IAAI;AACJ,MAAI,OAAO,WAAW,iBAAiB,SACrC,mBAAkB,OAAO,WAAW,aAAa;MAEjD,mBAAkB,WAChB,WAAW,aACZ,CAAC;AAEJ,QAAM,KAAK,kBAAkB,gBAAgB,GAAG;;AAIlD,QAAO,aAAa,QAAQ,KADP,MAAM,KAAK,IAAI,CAAC,MAAM,CACG"}

package/dist/ssr/format-rules.js

@@ -0,0 +1,70 @@
+//#region src/ssr/format-rules.ts
+/**
+* Resolve selectors for a rule, applying className-based specificity doubling
+* and rootPrefix handling. Mirrors the logic in StyleInjector.inject().
+*/
+function resolveSelector(rule, className) {
+	let selector = rule.selector;
+	if (rule.needsClassName) {
+		const selectorParts = selector ? selector.split("|||") : [""];
+		const classPrefix = `.${className}.${className}`;
+		selector = selectorParts.map((part) => {
+			const classSelector = part ? `${classPrefix}${part}` : classPrefix;
+			if (rule.rootPrefix) return `${rule.rootPrefix} ${classSelector}`;
+			return classSelector;
+		}).join(", ");
+	}
+	return selector;
+}
+/**
+* Group rules by selector + at-rules and merge their declarations.
+* Mirrors the grouping logic in SheetManager.insertRule().
+*/
+function groupRules(rules) {
+	const groupMap = /* @__PURE__ */ new Map();
+	const order = [];
+	const atKey = (at) => at && at.length ? at.join("|") : "";
+	for (const r of rules) {
+		const key = `${atKey(r.atRules)}||${r.selector}`;
+		const existing = groupMap.get(key);
+		if (existing) existing.declarations = existing.declarations ? `${existing.declarations} ${r.declarations}` : r.declarations;
+		else {
+			groupMap.set(key, {
+				selector: r.selector,
+				atRules: r.atRules,
+				declarations: r.declarations
+			});
+			order.push(key);
+		}
+	}
+	return order.map((key) => groupMap.get(key));
+}
+/**
+* Format an array of StyleResult rules into a CSS text string.
+*
+* Applies className-based specificity doubling (.cls.cls),
+* groups rules by selector + at-rules, and wraps with at-rule blocks.
+*
+* Produces the same CSS text as SheetManager.insertRule() would insert
+* into the DOM, but as a plain string suitable for SSR output.
+*/
+function formatRules(rules, className) {
+	if (rules.length === 0) return "";
+	const grouped = groupRules(rules.map((rule) => ({
+		selector: resolveSelector(rule, className),
+		declarations: rule.declarations,
+		atRules: rule.atRules
+	})));
+	const cssRules = [];
+	for (const rule of grouped) {
+		const baseRule = `${rule.selector} { ${rule.declarations} }`;
+		let fullRule = baseRule;
+		if (rule.atRules && rule.atRules.length > 0) fullRule = rule.atRules.reduce((css, atRule) => `${atRule} { ${css} }`, baseRule);
+		cssRules.push(fullRule);
+	}
+	return cssRules.join("\n");
+}
+
+//#endregion
+export { formatRules };
+//# sourceMappingURL=format-rules.js.map

package/dist/ssr/format-rules.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"format-rules.js","names":[],"sources":["../../src/ssr/format-rules.ts"],"sourcesContent":["/**\n * Shared CSS rule formatting utility.\n *\n * Extracted from SheetManager to allow both the DOM-based injector (client)\n * and the ServerStyleCollector (server) to produce identical CSS text\n * from StyleResult arrays.\n */\n\nimport type { StyleResult } from '../pipeline';\n\n/**\n * Resolve selectors for a rule, applying className-based specificity doubling\n * and rootPrefix handling. Mirrors the logic in StyleInjector.inject().\n */\nfunction resolveSelector(rule: StyleResult, className: string): string {\n  let selector = rule.selector;\n\n  if (rule.needsClassName) {\n    const selectorParts = selector ? selector.split('|||') : [''];\n    const classPrefix = `.${className}.${className}`;\n\n    selector = selectorParts\n      .map((part) => {\n        const classSelector = part ? `${classPrefix}${part}` : classPrefix;\n\n        if (rule.rootPrefix) {\n          return `${rule.rootPrefix} ${classSelector}`;\n        }\n        return classSelector;\n      })\n      .join(', ');\n  }\n\n  return selector;\n}\n\n/**\n * Group rules by selector + at-rules and merge their declarations.\n * Mirrors the grouping logic in SheetManager.insertRule().\n */\nfunction groupRules(\n  rules: { selector: string; declarations: string; atRules?: string[] }[],\n): { selector: string; declarations: string; atRules?: string[] }[] {\n  const groupMap = new Map<\n    string,\n    { selector: string; atRules?: string[]; declarations: string }\n  >();\n  const order: string[] = [];\n\n  const atKey = (at?: string[]) => (at && at.length ? at.join('|') : '');\n\n  for (const r of rules) {\n    const key = `${atKey(r.atRules)}||${r.selector}`;\n    const existing = groupMap.get(key);\n    if (existing) {\n      existing.declarations = existing.declarations\n        ? `${existing.declarations} ${r.declarations}`\n        : r.declarations;\n    } else {\n      groupMap.set(key, {\n        selector: r.selector,\n        atRules: r.atRules,\n        declarations: r.declarations,\n      });\n      order.push(key);\n    }\n  }\n\n  return order.map((key) => groupMap.get(key)!);\n}\n\n/**\n * Format an array of StyleResult rules into a CSS text string.\n *\n * Applies className-based specificity doubling (.cls.cls),\n * groups rules by selector + at-rules, and wraps with at-rule blocks.\n *\n * Produces the same CSS text as SheetManager.insertRule() would insert\n * into the DOM, but as a plain string suitable for SSR output.\n */\nexport function formatRules(rules: StyleResult[], className: string): string {\n  if (rules.length === 0) return '';\n\n  const resolvedRules = rules.map((rule) => ({\n    selector: resolveSelector(rule, className),\n    declarations: rule.declarations,\n    atRules: rule.atRules,\n  }));\n\n  const grouped = groupRules(resolvedRules);\n  const cssRules: string[] = [];\n\n  for (const rule of grouped) {\n    const baseRule = `${rule.selector} { ${rule.declarations} }`;\n\n    let fullRule = baseRule;\n    if (rule.atRules && rule.atRules.length > 0) {\n      fullRule = rule.atRules.reduce(\n        (css, atRule) => `${atRule} { ${css} }`,\n        baseRule,\n      );\n    }\n\n    cssRules.push(fullRule);\n  }\n\n  return cssRules.join('\\n');\n}\n"],"mappings":";;;;;AAcA,SAAS,gBAAgB,MAAmB,WAA2B;CACrE,IAAI,WAAW,KAAK;AAEpB,KAAI,KAAK,gBAAgB;EACvB,MAAM,gBAAgB,WAAW,SAAS,MAAM,MAAM,GAAG,CAAC,GAAG;EAC7D,MAAM,cAAc,IAAI,UAAU,GAAG;AAErC,aAAW,cACR,KAAK,SAAS;GACb,MAAM,gBAAgB,OAAO,GAAG,cAAc,SAAS;AAEvD,OAAI,KAAK,WACP,QAAO,GAAG,KAAK,WAAW,GAAG;AAE/B,UAAO;IACP,CACD,KAAK,KAAK;;AAGf,QAAO;;;;;;AAOT,SAAS,WACP,OACkE;CAClE,MAAM,2BAAW,IAAI,KAGlB;CACH,MAAM,QAAkB,EAAE;CAE1B,MAAM,SAAS,OAAmB,MAAM,GAAG,SAAS,GAAG,KAAK,IAAI,GAAG;AAEnE,MAAK,MAAM,KAAK,OAAO;EACrB,MAAM,MAAM,GAAG,MAAM,EAAE,QAAQ,CAAC,IAAI,EAAE;EACtC,MAAM,WAAW,SAAS,IAAI,IAAI;AAClC,MAAI,SACF,UAAS,eAAe,SAAS,eAC7B,GAAG,SAAS,aAAa,GAAG,EAAE,iBAC9B,EAAE;OACD;AACL,YAAS,IAAI,KAAK;IAChB,UAAU,EAAE;IACZ,SAAS,EAAE;IACX,cAAc,EAAE;IACjB,CAAC;AACF,SAAM,KAAK,IAAI;;;AAInB,QAAO,MAAM,KAAK,QAAQ,SAAS,IAAI,IAAI,CAAE;;;;;;;;;;;AAY/C,SAAgB,YAAY,OAAsB,WAA2B;AAC3E,KAAI,MAAM,WAAW,EAAG,QAAO;CAQ/B,MAAM,UAAU,WANM,MAAM,KAAK,UAAU;EACzC,UAAU,gBAAgB,MAAM,UAAU;EAC1C,cAAc,KAAK;EACnB,SAAS,KAAK;EACf,EAAE,CAEsC;CACzC,MAAM,WAAqB,EAAE;AAE7B,MAAK,MAAM,QAAQ,SAAS;EAC1B,MAAM,WAAW,GAAG,KAAK,SAAS,KAAK,KAAK,aAAa;EAEzD,IAAI,WAAW;AACf,MAAI,KAAK,WAAW,KAAK,QAAQ,SAAS,EACxC,YAAW,KAAK,QAAQ,QACrB,KAAK,WAAW,GAAG,OAAO,KAAK,IAAI,KACpC,SACD;AAGH,WAAS,KAAK,SAAS;;AAGzB,QAAO,SAAS,KAAK,KAAK"}