@tenphi/tasty 0.0.0-snapshot.b6cc3cd → 0.0.0-snapshot.b7bfdb1

package/dist/{collector-Di3C8btw.js.map → collector-DJqx7XO0.js.map}

@@ -1 +1 @@
-{"version":3,"file":"collector-Di3C8btw.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 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   * 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.fontFaceRules.values()) {\n      parts.push(css);\n    }\n\n    for (const css of this.counterStyleRules.values()) {\n      parts.push(css);\n    }\n\n    for (const css of this.functionRules.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.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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"}
+{"version":3,"file":"collector-DJqx7XO0.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 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   * 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.fontFaceRules.values()) {\n      parts.push(css);\n    }\n\n    for (const css of this.counterStyleRules.values()) {\n      parts.push(css);\n    }\n\n    for (const css of this.functionRules.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.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/{config-DH7I0Ggx.d.ts → config-CscQCTAM.d.ts}

@@ -1,4 +1,4 @@
-import { Dt as SheetInfo, Et as RuleInfo, Ot as StyleInjectorConfig, P as StyleHandlerDefinition, St as PropertyDefinition, Tt as RootRegistry, b as Styles, bt as KeyframesResult, dt as FunctionDefinition, gt as InjectResult, h as ConfigTokens, ht as GlobalInjectResult, it as UnitHandler, kt as StyleRule, lt as FontFaceDescriptors, mt as GCOptions, n as StyleResult, nt as StyleDetails, ot as CacheMetrics, pt as GCConfig, st as CounterStyleDescriptors, ut as FontFaceInput, v as RecipeStyles, wt as RawCSSResult, xt as KeyframesSteps, yt as KeyframesInfo } from "./index-LC3O3Jj4.js";
+import { At as StyleRule, Ct as PropertyDefinition, Dt as RuleInfo, Et as RootRegistry, Ot as SheetInfo, P as StyleHandlerDefinition, St as KeyframesSteps, Tt as RawCSSResult, _t as InjectResult, b as Styles, bt as KeyframesInfo, dt as FunctionDefinition, gt as InjectOptions, h as ConfigTokens, ht as GlobalInjectResult, it as UnitHandler, kt as StyleInjectorConfig, lt as FontFaceDescriptors, mt as GCOptions, n as StyleResult, nt as StyleDetails, ot as CacheMetrics, pt as GCConfig, st as CounterStyleDescriptors, ut as FontFaceInput, v as RecipeStyles, xt as KeyframesResult } from "./index-BmogEzTo.js";
 
 //#region src/prop-handlers.d.ts
 /**
@@ -151,13 +151,16 @@ declare class SheetManager {
    */
   private engineSupportsAtProperty;
   /**
-   * Force cleanup of unused styles
-   */
-  forceCleanup(registry: RootRegistry): void;
-  /**
-   * 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.
    */
-  private performBulkCleanup;
+  deleteClasses(registry: RootRegistry, classNames: Iterable<string>): number;
   /**
    * Get total number of rules across all sheets
    */
@@ -237,7 +240,8 @@ declare class StyleInjector {
   private sheetManager;
   private config;
   private globalRuleCounter;
-  private pendingGCHandle;
+  /** Cancels the scheduled sweep, whichever timer scheduled it. */
+  private cancelPendingGC;
   private namePrefix;
   private classRegex;
   private rscClassRegex;
@@ -298,10 +302,7 @@ declare class StyleInjector {
   /**
    * Inject styles from StyleResult objects
    */
-  inject(rules: StyleResult[], options?: {
-    root?: Document | ShadowRoot;
-    cacheKey?: string;
-  }): InjectResult;
+  inject(rules: StyleResult[], options?: InjectOptions): InjectResult;
   /**
    * Inject global styles (rules without a generated tasty class selector)
    * This ensures we don't reserve a tasty class name (t{number}) for global rules,
@@ -325,20 +326,51 @@ declare class StyleInjector {
     root?: Document | ShadowRoot;
   }): string;
   /**
-   * 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` and report what they ended up being
+   * called, without deciding yet which classes own them.
+   *
+   * Names have to be resolved before the rules that animate them are written:
+   * an injected name can differ from the authored one, and a rule written
+   * first cannot be rewritten afterwards — its cache key is already claimed,
+   * so the second write is a hit and the corrected declarations are dropped.
+   *
+   * 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: Record<string, KeyframesSteps>, options?: {
+    root?: Document | ShadowRoot;
+  }): {
+    names: Map<string, string>;
+    keys: Map<string, string>;
+  };
+  /**
+   * 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: string, className: string, options?: {
+    root?: Document | ShadowRoot;
+  }): void;
+  /**
+   * 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: string, options?: {
     root?: Document | ShadowRoot;
   }): InjectResult | null;
   /**
-   * 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.
    */
-  private dispose;
+  private unpin;
   /**
-   * 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?: Document | ShadowRoot): void;
   /**
@@ -453,27 +485,68 @@ declare class StyleInjector {
    */
   private disposeKeyframes;
   /**
-   * 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: string, options?: {
+  touch(_className: string, options?: {
     root?: Document | ShadowRoot;
   }): void;
   /**
-   * 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.
    */
   private scheduleGC;
+  /**
+   * 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.
+   */
+  private collectUnused;
+  /**
+   * Class names this injector holds CSS for that nothing renders and nobody
+   * pinned — exactly what `gc({ force: true })` would delete. Unordered.
+   */
+  getUnusedClasses(options?: {
+    root?: Document | ShadowRoot;
+  }): string[];
   /**
    * 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.
    */
@@ -500,6 +573,22 @@ type ParseFunction = (groups: StyleDetails[]) => string;
 type FunctionsConfig = Record<string, FunctionDefinition | ParseFunction>;
 //#endregion
 //#region src/utils/color-space.d.ts
+/**
+ * Color handling that survives into the emitted CSS.
+ *
+ * Tasty does not rewrite a color into a particular color space: opacity is
+ * applied with CSS relative color syntax, which reads the channels off whatever
+ * the browser resolves a value to, so a color is emitted exactly as authored.
+ * What is left here is how an alpha gets applied, and the one distinction that
+ * matters — replacing a token's alpha versus composing onto an inherited one.
+ */
+/**
+ * The color space a `#name` token's value used to be rewritten into.
+ *
+ * @deprecated Kept for the `colorSpace` config option, which no longer has any
+ * effect. Colors are emitted as authored and opacity is always applied in
+ * `oklch` through relative color syntax.
+ */
 type ColorSpace = 'rgb' | 'hsl' | 'oklch';
 //#endregion
 //#region src/utils/typography.d.ts
@@ -617,7 +706,7 @@ interface TastyPlugin {
    * Design tokens injected as CSS custom properties on `:root`.
    * Values are parsed through the Tasty DSL. Supports state maps.
    * - `$name` → `--name` CSS custom property
-   * - `#name` → `--name-color` and `--name-color-{colorSpace}`
+   * - `#name` → `--name-color`
    */
   tokens?: ConfigTokens;
   /** Predefined tokens replaced during style parsing (`$name` or `#name`) */
@@ -733,14 +822,18 @@ interface TastyConfig {
    */
   functions?: FunctionsConfig;
   /**
-   * Color space used for decomposed color token companion variables.
-   * Controls the CSS function and suffix for alpha composition.
+   * @deprecated No longer has any effect; will be removed in the next major.
+   * Setting it warns in development.
    *
-   * - `'rgb'`   — suffix `-rgb`, e.g. `rgb(var(--name-color-rgb) / .5)`
-   * - `'hsl'`   — suffix `-hsl`, e.g. `hsl(var(--name-color-hsl) / .5)`
-   * - `'oklch'` — suffix `-oklch`, e.g. `oklch(var(--name-color-oklch) / .5)`
+   * A `#name` token's value used to be rewritten into this color space so an
+   * opacity suffix had numeric channels to write an alpha into. Opacity now uses
+   * relative color syntax — `oklch(from var(--name-color) l c h / .5)` — which
+   * has the browser read the channels, so a color is emitted exactly as
+   * authored and there is nothing left for the setting to decide.
    *
-   * @default 'oklch'
+   * To address a token's channels yourself, write relative color syntax against
+   * the token: `oklch(from var(--brand-color) calc(l * 1.2) c h)`. It works on
+   * every `<color>`, including the ones no conversion could evaluate.
    */
   colorSpace?: ColorSpace;
   /**
@@ -1025,7 +1118,7 @@ interface TastyConfig {
    * for responsive/theme-aware tokens.
    *
    * - `$name` keys become `--name` CSS custom properties
-   * - `#name` keys become `--name-color` and `--name-color-{colorSpace}` properties
+   * - `#name` keys become `--name-color` properties
    *
    * Tokens are injected once when the first style is rendered.
    *
@@ -1240,4 +1333,4 @@ declare function getNamePrefix(): string;
 declare function resetConfig(): void;
 //#endregion
 export { ParseFunction as C, PropHandlerDefinition as D, PropHandler as E, PropHandlerProps as O, FunctionsConfig as S, SheetManager as T, TastyPluginFactory as _, getGlobalFontFaces as a, generateTypographyTokens as b, getGlobalRecipes as c, hasGlobalRecipes as d, hasStylesGenerated as f, TastyPlugin as g, resetConfig as h, getGlobalCounterStyles as i, getNamePrefix as l, isTestEnvironment as m, configure as n, getGlobalFunctions as o, isConfigLocked as p, getConfig as r, getGlobalKeyframes as s, TastyConfig as t, hasGlobalKeyframes as u, TypographyPreset as v, StyleInjector as w, ColorSpace as x, TypographyTokenValue as y };
-//# sourceMappingURL=config-DH7I0Ggx.d.ts.map
+//# sourceMappingURL=config-CscQCTAM.d.ts.map