@tenphi/tasty 0.0.0-snapshot.db103fd → 0.0.0-snapshot.dc62ea3

package/dist/collector-B3OsM252.js

@@ -0,0 +1,327 @@
+import { L as renderStyles, Mt as formatFunctionRule, Pt as parseFunctionName, X as fontFaceContentHash, Z as formatFontFaceRule, _t as hashString, a as getGlobalCounterStyles, d as getGlobalStyles, f as getNamePrefix, ft as makeClassName, gt as validateNamePrefix, i as getGlobalConfigTokens, mt as makeKeyframeName, o as getGlobalFontFaces, pt as makeCounterStyleName, q as formatCounterStyleRule, r as getEffectiveProperties, s as getGlobalFunctions } from "./config-B3gPdCqd.js";
+import { n as formatPropertyCSS, t as formatRules } from "./format-rules-XRw9u7d4.js";
+import { t as formatGlobalRules } from "./format-global-rules-DklyaXv-.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
+* hash-based class names using the configured `namePrefix` (defaults
+* to `'t'`), formats CSS rules into text, and tracks rendered class
+* names for lightweight client transfer.
+*
+* One instance is created per HTTP request. Concurrent requests
+* each get their own collector (via AsyncLocalStorage or React context).
+*/
+function artifactId(kind, key, css) {
+	const content = `${kind}\0${key}\0${css}`;
+	return `${kind}:${hashString(content)}:${content.length.toString(36)}`;
+}
+var ServerStyleCollector = class {
+	chunks = /* @__PURE__ */ new Map();
+	cacheKeyToClassName = /* @__PURE__ */ new Map();
+	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();
+	fontFaceRules = /* @__PURE__ */ new Map();
+	flushedFontFaceKeys = /* @__PURE__ */ new Set();
+	counterStyleRules = /* @__PURE__ */ new Map();
+	flushedCounterStyleKeys = /* @__PURE__ */ new Set();
+	functionRules = /* @__PURE__ */ new Map();
+	flushedFunctionKeys = /* @__PURE__ */ new Set();
+	keyframesCounter = 0;
+	counterStyleCounter = 0;
+	internalsCollected = false;
+	namePrefix;
+	/**
+	* @param namePrefix - Optional override for the configured prefix.
+	*   Defaults to the value from `configure({ namePrefix })` (or `'t'`).
+	*   Pass an explicit prefix when constructing a collector outside the
+	*   normal configure() lifecycle (e.g. in tests). Validated eagerly
+	*   so misconfiguration fails before any CSS is collected.
+	*/
+	constructor(namePrefix) {
+		if (namePrefix !== void 0) validateNamePrefix(namePrefix);
+		this.namePrefix = namePrefix ?? getNamePrefix();
+	}
+	generateClassName(cacheKey) {
+		return makeClassName(this.namePrefix, hashString(cacheKey));
+	}
+	/**
+	* Collect internal @property rules and :root token defaults.
+	* Mirrors markStylesGenerated() from the client-side injector.
+	* Called automatically on first chunk collection; idempotent.
+	*
+	* Internals are always emitted here — the RSC path deliberately
+	* defers to SSR so that tokens appear exactly once per page in
+	* <style data-tasty-ssr> (avoiding duplication of large token sets).
+	*/
+	collectInternals() {
+		if (this.internalsCollected) return;
+		this.internalsCollected = true;
+		for (const [token, definition] of Object.entries(getEffectiveProperties())) {
+			const css = formatPropertyCSS(token, definition);
+			if (css) this.collectProperty(`__prop:${token}`, css);
+		}
+		const tokenStyles = getGlobalConfigTokens();
+		if (tokenStyles && Object.keys(tokenStyles).length > 0) {
+			const tokenRules = renderStyles(tokenStyles, ":root");
+			if (tokenRules.length > 0) {
+				const css = formatGlobalRules(tokenRules);
+				if (css) this.collectGlobalStyles("__global:tokens", css);
+			}
+		}
+		const globalFF = getGlobalFontFaces();
+		if (globalFF) for (const [family, input] of Object.entries(globalFF)) {
+			const descriptors = Array.isArray(input) ? input : [input];
+			for (const desc of descriptors) {
+				const hash = fontFaceContentHash(family, desc);
+				const css = formatFontFaceRule(family, desc);
+				this.collectFontFace(hash, css);
+			}
+		}
+		const globalCS = getGlobalCounterStyles();
+		if (globalCS) for (const [name, descriptors] of Object.entries(globalCS)) {
+			const css = formatCounterStyleRule(name, descriptors);
+			this.collectCounterStyle(name, css, { weak: true });
+		}
+		const globalFn = getGlobalFunctions();
+		if (globalFn) for (const [name, definition] of Object.entries(globalFn)) {
+			const css = formatFunctionRule(name, definition);
+			this.collectFunction(parseFunctionName(name), css, { weak: true });
+		}
+		const globalStyles = getGlobalStyles();
+		if (globalStyles) {
+			for (const [selector, styles] of Object.entries(globalStyles)) if (Object.keys(styles).length > 0) {
+				const rules = renderStyles(styles, selector);
+				if (rules.length > 0) {
+					const css = formatGlobalRules(rules);
+					if (css) this.collectGlobalStyles(`__global:styles:${selector}`, css);
+				}
+			}
+		}
+	}
+	/**
+	* 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 = this.generateClassName(cacheKey);
+		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 ?? makeKeyframeName(this.namePrefix, String(this.keyframesCounter++));
+	}
+	/**
+	* Record a @font-face rule. Deduplicated by key (content hash).
+	*/
+	collectFontFace(key, css) {
+		if (!this.fontFaceRules.has(key)) this.fontFaceRules.set(key, css);
+	}
+	/**
+	* Record a @counter-style rule. Deduplicated by name and overrides an
+	* existing rule by default. Pass `weak: true` for global `configure()`
+	* definitions, which never clobber an existing rule.
+	*/
+	collectCounterStyle(name, css, options) {
+		const existing = this.counterStyleRules.get(name);
+		if (existing === void 0) {
+			this.counterStyleRules.set(name, css);
+			return;
+		}
+		if (options?.weak || existing === css) return;
+		this.counterStyleRules.set(name, css);
+		this.flushedCounterStyleKeys.delete(name);
+	}
+	/**
+	* Record a @function rule. Deduplicated by CSS function name and overrides an
+	* existing rule by default. Pass `weak: true` for global `configure()`
+	* definitions, which never clobber an existing rule.
+	*/
+	collectFunction(name, css, options) {
+		const existing = this.functionRules.get(name);
+		if (existing === void 0) {
+			this.functionRules.set(name, css);
+			return;
+		}
+		if (options?.weak || existing === css) return;
+		this.functionRules.set(name, css);
+		this.flushedFunctionKeys.delete(name);
+	}
+	/**
+	* Allocate a counter-style name for SSR. Uses provided name or generates one.
+	*/
+	allocateCounterStyleName(providedName) {
+		return providedName ?? makeCounterStyleName(this.namePrefix, String(this.counterStyleCounter++));
+	}
+	/**
+	* Record global styles (from useGlobalStyles). Deduplicated by key.
+	*
+	* Pass `replace` for slot-keyed entries (an explicit `id`), where the last
+	* write must win to match the client's update-tracking behavior.
+	*/
+	collectGlobalStyles(key, css, replace) {
+		if (replace || !this.globalStyles.has(key)) this.globalStyles.set(key, css);
+	}
+	/**
+	* Record raw CSS text (from useRawCSS). Deduplicated by key.
+	*
+	* Pass `replace` for slot-keyed entries (an explicit `id`), where the last
+	* write must win to match the client's update-tracking behavior.
+	*/
+	collectRawCSS(key, css, replace) {
+		if (replace || !this.rawCSS.has(key)) this.rawCSS.set(key, css);
+	}
+	/**
+	* Return the collected CSS as structured, ordered artifacts.
+	*
+	* Artifact boundaries are part of the collector output so build tools never
+	* need to split or parse CSS text. IDs include the logical collection key
+	* and content, making them stable across equivalent page renders while a CSS
+	* change always produces a different ID.
+	*/
+	getArtifacts() {
+		const artifacts = [];
+		const append = (kind, entries) => {
+			for (const [key, css] of entries) artifacts.push({
+				id: artifactId(kind, key, css),
+				kind,
+				css,
+				order: artifacts.length
+			});
+		};
+		append("property", this.propertyRules);
+		append("font-face", this.fontFaceRules);
+		append("counter-style", this.counterStyleRules);
+		append("function", this.functionRules);
+		append("raw", this.rawCSS);
+		append("global", this.globalStyles);
+		append("chunk", this.chunks);
+		append("keyframes", this.keyframeRules);
+		return artifacts;
+	}
+	/**
+	* Extract all CSS collected so far as a single string.
+	* Includes @property and @keyframes rules.
+	* Used for non-streaming SSR (renderToString).
+	*/
+	getCSS() {
+		return this.getArtifacts().map(({ css }) => css).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.fontFaceRules) if (!this.flushedFontFaceKeys.has(key)) {
+			parts.push(css);
+			this.flushedFontFaceKeys.add(key);
+		}
+		for (const [key, css] of this.counterStyleRules) if (!this.flushedCounterStyleKeys.has(key)) {
+			parts.push(css);
+			this.flushedCounterStyleKeys.add(key);
+		}
+		for (const [key, css] of this.functionRules) if (!this.flushedFunctionKeys.has(key)) {
+			parts.push(css);
+			this.flushedFunctionKeys.add(key);
+		}
+		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");
+	}
+	flushedClassNames = /* @__PURE__ */ new Set();
+	/**
+	* Return class names rendered since the last call (for streaming).
+	* Used to emit lightweight class-list scripts for client hydration.
+	*/
+	getRenderedClassNames() {
+		const names = [];
+		for (const className of this.cacheKeyToClassName.values()) if (!this.flushedClassNames.has(className)) {
+			this.flushedClassNames.add(className);
+			names.push(className);
+		}
+		return names;
+	}
+};
+/**
+* Factory for creating a {@link ServerStyleCollector} instance.
+*
+* Canonical functional entry point; the `ServerStyleCollector` class remains
+* exported for advanced/internal use.
+*
+* @param namePrefix - Optional override for the configured class-name prefix.
+*   Defaults to the value from `configure({ namePrefix })` (or `'t'`).
+*
+* @example
+* ```ts
+* import { createServerStyleCollector } from '@tenphi/tasty/ssr';
+*
+* const collector = createServerStyleCollector();
+* ```
+*/
+function createServerStyleCollector(namePrefix) {
+	return new ServerStyleCollector(namePrefix);
+}
+//#endregion
+export { createServerStyleCollector as n, ServerStyleCollector as t };
+
+//# sourceMappingURL=collector-B3OsM252.js.map

package/dist/collector-B3OsM252.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"collector-B3OsM252.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 * hash-based class names using the configured `namePrefix` (defaults\n * to `'t'`), formats CSS rules into text, and tracks rendered class\n * names for lightweight client transfer.\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  getEffectiveProperties,\n  getGlobalStyles,\n  getGlobalCounterStyles,\n  getGlobalFontFaces,\n  getGlobalFunctions,\n  getGlobalConfigTokens,\n  getNamePrefix,\n} from '../config';\nimport { formatCounterStyleRule } from '../counter-style';\nimport { fontFaceContentHash, formatFontFaceRule } from '../font-face';\nimport { formatFunctionRule, parseFunctionName } from '../functions';\nimport { renderStyles } from '../pipeline';\nimport type { StyleResult } from '../pipeline';\nimport { hashString } from '../utils/hash';\nimport {\n  makeClassName,\n  makeCounterStyleName,\n  makeKeyframeName,\n  validateNamePrefix,\n} from '../utils/name-prefix';\nimport { formatPropertyCSS } from './format-property';\nimport { formatGlobalRules } from './format-global-rules';\nimport { formatRules } from './format-rules';\n\nexport type ServerStyleArtifactKind =\n  | 'property'\n  | 'font-face'\n  | 'counter-style'\n  | 'function'\n  | 'raw'\n  | 'global'\n  | 'chunk'\n  | 'keyframes';\n\nexport interface ServerStyleArtifact {\n  /** Stable identifier derived from the artifact kind, logical key, and CSS. */\n  id: string;\n  kind: ServerStyleArtifactKind;\n  css: string;\n  /** Zero-based position in the collector's final cascade order. */\n  order: number;\n}\n\nfunction artifactId(kind: ServerStyleArtifactKind, key: string, css: string) {\n  const content = `${kind}\\0${key}\\0${css}`;\n  return `${kind}:${hashString(content)}:${content.length.toString(36)}`;\n}\n\nexport class ServerStyleCollector {\n  private chunks = new Map<string, string>();\n  private cacheKeyToClassName = new Map<string, string>();\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 fontFaceRules = new Map<string, string>();\n  private flushedFontFaceKeys = new Set<string>();\n  private counterStyleRules = new Map<string, string>();\n  private flushedCounterStyleKeys = new Set<string>();\n  private functionRules = new Map<string, string>();\n  private flushedFunctionKeys = new Set<string>();\n  private keyframesCounter = 0;\n  private counterStyleCounter = 0;\n  private internalsCollected = false;\n  private namePrefix: string;\n\n  /**\n   * @param namePrefix - Optional override for the configured prefix.\n   *   Defaults to the value from `configure({ namePrefix })` (or `'t'`).\n   *   Pass an explicit prefix when constructing a collector outside the\n   *   normal configure() lifecycle (e.g. in tests). Validated eagerly\n   *   so misconfiguration fails before any CSS is collected.\n   */\n  constructor(namePrefix?: string) {\n    if (namePrefix !== undefined) {\n      validateNamePrefix(namePrefix);\n    }\n    this.namePrefix = namePrefix ?? getNamePrefix();\n  }\n\n  private generateClassName(cacheKey: string): string {\n    return makeClassName(this.namePrefix, hashString(cacheKey));\n  }\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   * Internals are always emitted here — the RSC path deliberately\n   * defers to SSR so that tokens appear exactly once per page in\n   * <style data-tasty-ssr> (avoiding duplication of large token sets).\n   */\n  collectInternals(): void {\n    if (this.internalsCollected) return;\n    this.internalsCollected = true;\n\n    for (const [token, definition] of Object.entries(\n      getEffectiveProperties(),\n    )) {\n      const css = formatPropertyCSS(token, definition);\n      if (css) {\n        this.collectProperty(`__prop:${token}`, css);\n      }\n    }\n\n    const tokenStyles = getGlobalConfigTokens();\n    if (tokenStyles && Object.keys(tokenStyles).length > 0) {\n      const tokenRules = renderStyles(tokenStyles, ':root') as StyleResult[];\n      if (tokenRules.length > 0) {\n        const css = formatGlobalRules(tokenRules);\n        if (css) {\n          this.collectGlobalStyles('__global:tokens', css);\n        }\n      }\n    }\n\n    const globalFF = getGlobalFontFaces();\n    if (globalFF) {\n      for (const [family, input] of Object.entries(globalFF)) {\n        const descriptors = Array.isArray(input) ? input : [input];\n        for (const desc of descriptors) {\n          const hash = fontFaceContentHash(family, desc);\n          const css = formatFontFaceRule(family, desc);\n          this.collectFontFace(hash, css);\n        }\n      }\n    }\n\n    const globalCS = getGlobalCounterStyles();\n    if (globalCS) {\n      for (const [name, descriptors] of Object.entries(globalCS)) {\n        const css = formatCounterStyleRule(name, descriptors);\n        this.collectCounterStyle(name, css, { weak: true });\n      }\n    }\n\n    const globalFn = getGlobalFunctions();\n    if (globalFn) {\n      for (const [name, definition] of Object.entries(globalFn)) {\n        const css = formatFunctionRule(name, definition);\n        this.collectFunction(parseFunctionName(name), css, { weak: true });\n      }\n    }\n\n    const globalStyles = getGlobalStyles();\n    if (globalStyles) {\n      for (const [selector, styles] of Object.entries(globalStyles)) {\n        if (Object.keys(styles).length > 0) {\n          const rules = renderStyles(styles, selector) as StyleResult[];\n          if (rules.length > 0) {\n            const css = formatGlobalRules(rules);\n            if (css) {\n              this.collectGlobalStyles(`__global:styles:${selector}`, css);\n            }\n          }\n        }\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 = this.generateClassName(cacheKey);\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 (\n      providedName ??\n      makeKeyframeName(this.namePrefix, String(this.keyframesCounter++))\n    );\n  }\n\n  /**\n   * Record a @font-face rule. Deduplicated by key (content hash).\n   */\n  collectFontFace(key: string, css: string): void {\n    if (!this.fontFaceRules.has(key)) {\n      this.fontFaceRules.set(key, css);\n    }\n  }\n\n  /**\n   * Record a @counter-style rule. Deduplicated by name and overrides an\n   * existing rule by default. Pass `weak: true` for global `configure()`\n   * definitions, which never clobber an existing rule.\n   */\n  collectCounterStyle(\n    name: string,\n    css: string,\n    options?: { weak?: boolean },\n  ): void {\n    const existing = this.counterStyleRules.get(name);\n    if (existing === undefined) {\n      this.counterStyleRules.set(name, css);\n      return;\n    }\n    if (options?.weak || existing === css) return;\n    this.counterStyleRules.set(name, css);\n    // If a rule with this name was already flushed (streaming), allow the\n    // overriding rule to be flushed again so it wins by source order.\n    this.flushedCounterStyleKeys.delete(name);\n  }\n\n  /**\n   * Record a @function rule. Deduplicated by CSS function name and overrides an\n   * existing rule by default. Pass `weak: true` for global `configure()`\n   * definitions, which never clobber an existing rule.\n   */\n  collectFunction(\n    name: string,\n    css: string,\n    options?: { weak?: boolean },\n  ): void {\n    const existing = this.functionRules.get(name);\n    if (existing === undefined) {\n      this.functionRules.set(name, css);\n      return;\n    }\n    if (options?.weak || existing === css) return;\n    this.functionRules.set(name, css);\n    // If a rule with this name was already flushed (streaming), allow the\n    // overriding rule to be flushed again so it wins by source order.\n    this.flushedFunctionKeys.delete(name);\n  }\n\n  /**\n   * Allocate a counter-style name for SSR. Uses provided name or generates one.\n   */\n  allocateCounterStyleName(providedName?: string): string {\n    return (\n      providedName ??\n      makeCounterStyleName(this.namePrefix, String(this.counterStyleCounter++))\n    );\n  }\n\n  /**\n   * Record global styles (from useGlobalStyles). Deduplicated by key.\n   *\n   * Pass `replace` for slot-keyed entries (an explicit `id`), where the last\n   * write must win to match the client's update-tracking behavior.\n   */\n  collectGlobalStyles(key: string, css: string, replace?: boolean): void {\n    if (replace || !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   * Pass `replace` for slot-keyed entries (an explicit `id`), where the last\n   * write must win to match the client's update-tracking behavior.\n   */\n  collectRawCSS(key: string, css: string, replace?: boolean): void {\n    if (replace || !this.rawCSS.has(key)) {\n      this.rawCSS.set(key, css);\n    }\n  }\n\n  /**\n   * Return the collected CSS as structured, ordered artifacts.\n   *\n   * Artifact boundaries are part of the collector output so build tools never\n   * need to split or parse CSS text. IDs include the logical collection key\n   * and content, making them stable across equivalent page renders while a CSS\n   * change always produces a different ID.\n   */\n  getArtifacts(): ServerStyleArtifact[] {\n    const artifacts: ServerStyleArtifact[] = [];\n\n    const append = (\n      kind: ServerStyleArtifactKind,\n      entries: Iterable<[string, string]>,\n    ) => {\n      for (const [key, css] of entries) {\n        artifacts.push({\n          id: artifactId(kind, key, css),\n          kind,\n          css,\n          order: artifacts.length,\n        });\n      }\n    };\n\n    append('property', this.propertyRules);\n    append('font-face', this.fontFaceRules);\n    append('counter-style', this.counterStyleRules);\n    append('function', this.functionRules);\n    append('raw', this.rawCSS);\n    append('global', this.globalStyles);\n    append('chunk', this.chunks);\n    append('keyframes', this.keyframeRules);\n\n    return artifacts;\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    return this.getArtifacts()\n      .map(({ css }) => css)\n      .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.fontFaceRules) {\n      if (!this.flushedFontFaceKeys.has(key)) {\n        parts.push(css);\n        this.flushedFontFaceKeys.add(key);\n      }\n    }\n\n    for (const [key, css] of this.counterStyleRules) {\n      if (!this.flushedCounterStyleKeys.has(key)) {\n        parts.push(css);\n        this.flushedCounterStyleKeys.add(key);\n      }\n    }\n\n    for (const [key, css] of this.functionRules) {\n      if (!this.flushedFunctionKeys.has(key)) {\n        parts.push(css);\n        this.flushedFunctionKeys.add(key);\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  private flushedClassNames = new Set<string>();\n\n  /**\n   * Return class names rendered since the last call (for streaming).\n   * Used to emit lightweight class-list scripts for client hydration.\n   */\n  getRenderedClassNames(): string[] {\n    const names: string[] = [];\n    for (const className of this.cacheKeyToClassName.values()) {\n      if (!this.flushedClassNames.has(className)) {\n        this.flushedClassNames.add(className);\n        names.push(className);\n      }\n    }\n    return names;\n  }\n}\n\n/**\n * Factory for creating a {@link ServerStyleCollector} instance.\n *\n * Canonical functional entry point; the `ServerStyleCollector` class remains\n * exported for advanced/internal use.\n *\n * @param namePrefix - Optional override for the configured class-name prefix.\n *   Defaults to the value from `configure({ namePrefix })` (or `'t'`).\n *\n * @example\n * ```ts\n * import { createServerStyleCollector } from '@tenphi/tasty/ssr';\n *\n * const collector = createServerStyleCollector();\n * ```\n */\nexport function createServerStyleCollector(\n  namePrefix?: string,\n): ServerStyleCollector {\n  return new ServerStyleCollector(namePrefix);\n}\n"],"mappings":"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"}

package/dist/collector-BTVXj2hS.d.ts

@@ -0,0 +1,163 @@
+import { n as StyleResult } from "./index-BmogEzTo.js";
+
+//#region src/ssr/collector.d.ts
+type ServerStyleArtifactKind = 'property' | 'font-face' | 'counter-style' | 'function' | 'raw' | 'global' | 'chunk' | 'keyframes';
+interface ServerStyleArtifact {
+  /** Stable identifier derived from the artifact kind, logical key, and CSS. */
+  id: string;
+  kind: ServerStyleArtifactKind;
+  css: string;
+  /** Zero-based position in the collector's final cascade order. */
+  order: number;
+}
+declare class ServerStyleCollector {
+  private chunks;
+  private cacheKeyToClassName;
+  private flushedKeys;
+  private propertyRules;
+  private flushedPropertyKeys;
+  private keyframeRules;
+  private flushedKeyframeKeys;
+  private globalStyles;
+  private flushedGlobalKeys;
+  private rawCSS;
+  private flushedRawKeys;
+  private fontFaceRules;
+  private flushedFontFaceKeys;
+  private counterStyleRules;
+  private flushedCounterStyleKeys;
+  private functionRules;
+  private flushedFunctionKeys;
+  private keyframesCounter;
+  private counterStyleCounter;
+  private internalsCollected;
+  private namePrefix;
+  /**
+   * @param namePrefix - Optional override for the configured prefix.
+   *   Defaults to the value from `configure({ namePrefix })` (or `'t'`).
+   *   Pass an explicit prefix when constructing a collector outside the
+   *   normal configure() lifecycle (e.g. in tests). Validated eagerly
+   *   so misconfiguration fails before any CSS is collected.
+   */
+  constructor(namePrefix?: string);
+  private generateClassName;
+  /**
+   * Collect internal @property rules and :root token defaults.
+   * Mirrors markStylesGenerated() from the client-side injector.
+   * Called automatically on first chunk collection; idempotent.
+   *
+   * Internals are always emitted here — the RSC path deliberately
+   * defers to SSR so that tokens appear exactly once per page in
+   * <style data-tasty-ssr> (avoiding duplication of large token sets).
+   */
+  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 a @font-face rule. Deduplicated by key (content hash).
+   */
+  collectFontFace(key: string, css: string): void;
+  /**
+   * Record a @counter-style rule. Deduplicated by name and overrides an
+   * existing rule by default. Pass `weak: true` for global `configure()`
+   * definitions, which never clobber an existing rule.
+   */
+  collectCounterStyle(name: string, css: string, options?: {
+    weak?: boolean;
+  }): void;
+  /**
+   * Record a @function rule. Deduplicated by CSS function name and overrides an
+   * existing rule by default. Pass `weak: true` for global `configure()`
+   * definitions, which never clobber an existing rule.
+   */
+  collectFunction(name: string, css: string, options?: {
+    weak?: boolean;
+  }): void;
+  /**
+   * Allocate a counter-style name for SSR. Uses provided name or generates one.
+   */
+  allocateCounterStyleName(providedName?: string): string;
+  /**
+   * Record global styles (from useGlobalStyles). Deduplicated by key.
+   *
+   * Pass `replace` for slot-keyed entries (an explicit `id`), where the last
+   * write must win to match the client's update-tracking behavior.
+   */
+  collectGlobalStyles(key: string, css: string, replace?: boolean): void;
+  /**
+   * Record raw CSS text (from useRawCSS). Deduplicated by key.
+   *
+   * Pass `replace` for slot-keyed entries (an explicit `id`), where the last
+   * write must win to match the client's update-tracking behavior.
+   */
+  collectRawCSS(key: string, css: string, replace?: boolean): void;
+  /**
+   * Return the collected CSS as structured, ordered artifacts.
+   *
+   * Artifact boundaries are part of the collector output so build tools never
+   * need to split or parse CSS text. IDs include the logical collection key
+   * and content, making them stable across equivalent page renders while a CSS
+   * change always produces a different ID.
+   */
+  getArtifacts(): ServerStyleArtifact[];
+  /**
+   * 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;
+  private flushedClassNames;
+  /**
+   * Return class names rendered since the last call (for streaming).
+   * Used to emit lightweight class-list scripts for client hydration.
+   */
+  getRenderedClassNames(): string[];
+}
+/**
+ * Factory for creating a {@link ServerStyleCollector} instance.
+ *
+ * Canonical functional entry point; the `ServerStyleCollector` class remains
+ * exported for advanced/internal use.
+ *
+ * @param namePrefix - Optional override for the configured class-name prefix.
+ *   Defaults to the value from `configure({ namePrefix })` (or `'t'`).
+ *
+ * @example
+ * ```ts
+ * import { createServerStyleCollector } from '@tenphi/tasty/ssr';
+ *
+ * const collector = createServerStyleCollector();
+ * ```
+ */
+declare function createServerStyleCollector(namePrefix?: string): ServerStyleCollector;
+//#endregion
+export { createServerStyleCollector as i, ServerStyleArtifactKind as n, ServerStyleCollector as r, ServerStyleArtifact as t };
+//# sourceMappingURL=collector-BTVXj2hS.d.ts.map