@tenphi/tasty 0.0.0-snapshot.b1f3c1d → 0.0.0-snapshot.b26c0fb

package/README.md

@@ -6,7 +6,7 @@
 
 <p align="center">
   <strong>Deterministic styling for stateful component systems.</strong><br>
-  A design-system styling engine that compiles component states into mutually exclusive selectors.
+  A design-system styling engine that compiles component states into mutually exclusive selectors, so complex components stay predictable as they evolve.
 </p>
 
 <p align="center">
@@ -23,6 +23,8 @@ It compiles state maps into **mutually exclusive selectors**, so for a given pro
 
 That is the core guarantee: component styling resolves from declared state logic, not from source-order accidents or specificity fights.
 
+The practical payoff shows up later: adding states, variants, and overrides stays inside the state map instead of reopening selector logic by hand.
+
 Tasty fits best when you are building a design system or component library with intersecting states, variants, tokens, sub-elements, responsive rules, and extension semantics that need to stay predictable over time.
 
 On top of that foundation, Tasty gives teams a governed styling model: a CSS-like DSL, tokens, recipes, typed style props, sub-elements, and multiple rendering modes.
@@ -35,6 +37,7 @@ On top of that foundation, Tasty gives teams a governed styling model: a CSS-lik
 ## Why Tasty
 
 - **Deterministic composition, not cascade fights** — Stateful styles resolve from the state map you declared, not from selector competition. See [How It Actually Works](#how-it-actually-works).
+- **Easier to extend over time** — When components gain new states, variants, or overrides, you update declared branches instead of re-deriving selector interactions by hand.
 - **Built for design-system teams** — Best fit for reusable component systems with complex state interactions.
 - **A governed styling model, not just syntax sugar** — Design-system authors define the styling language product teams consume.
 - **DSL that still feels like CSS** — Familiar property names, less selector boilerplate. Start with the [Style DSL](docs/dsl.md), then use [Style Properties](docs/styles.md) as the handler reference.

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

@@ -1 +1 @@
-{"version":3,"file":"async-storage-B7_o6FKt.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 * Uses globalThis to ensure the AsyncLocalStorage instance is shared\n * across module instances — frameworks like Astro may load middleware\n * and page components from separate module graphs.\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 ALS_KEY = '__tasty_ssr_als__';\n\nfunction getSharedStorage(): AsyncLocalStorage<ServerStyleCollector> {\n  const g = globalThis as Record<string, unknown>;\n  if (!g[ALS_KEY]) {\n    g[ALS_KEY] = new AsyncLocalStorage<ServerStyleCollector>();\n  }\n  return g[ALS_KEY] as AsyncLocalStorage<ServerStyleCollector>;\n}\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 getSharedStorage().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  const storage = getSharedStorage();\n  if (typeof storage?.getStore !== 'function') return null;\n  return storage.getStore() ?? null;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;AAoBA,MAAM,UAAU;AAEhB,SAAS,mBAA4D;CACnE,MAAM,IAAI;AACV,KAAI,CAAC,EAAE,SACL,GAAE,WAAW,IAAI,mBAAyC;AAE5D,QAAO,EAAE;;;;;;;AAQX,SAAgB,iBACd,WACA,IACG;AACH,QAAO,kBAAkB,CAAC,IAAI,WAAW,GAAG;;;;;;AAO9C,SAAgB,kBAA+C;CAC7D,MAAM,UAAU,kBAAkB;AAClC,KAAI,OAAO,SAAS,aAAa,WAAY,QAAO;AACpD,QAAO,QAAQ,UAAU,IAAI"}
+{"version":3,"file":"async-storage-B7_o6FKt.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 * Uses globalThis to ensure the AsyncLocalStorage instance is shared\n * across module instances — frameworks like Astro may load middleware\n * and page components from separate module graphs.\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 ALS_KEY = '__tasty_ssr_als__';\n\nfunction getSharedStorage(): AsyncLocalStorage<ServerStyleCollector> {\n  const g = globalThis as Record<string, unknown>;\n  if (!g[ALS_KEY]) {\n    g[ALS_KEY] = new AsyncLocalStorage<ServerStyleCollector>();\n  }\n  return g[ALS_KEY] as AsyncLocalStorage<ServerStyleCollector>;\n}\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 getSharedStorage().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  const storage = getSharedStorage();\n  if (typeof storage?.getStore !== 'function') return null;\n  return storage.getStore() ?? null;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;AAoBA,MAAM,UAAU;AAEhB,SAAS,mBAA4D;CACnE,MAAM,IAAI;CACV,IAAI,CAAC,EAAE,UACL,EAAE,WAAW,IAAI,mBAAyC;CAE5D,OAAO,EAAE;;;;;;;AAQX,SAAgB,iBACd,WACA,IACG;CACH,OAAO,kBAAkB,CAAC,IAAI,WAAW,GAAG;;;;;;AAO9C,SAAgB,kBAA+C;CAC7D,MAAM,UAAU,kBAAkB;CAClC,IAAI,OAAO,SAAS,aAAa,YAAY,OAAO;CACpD,OAAO,QAAQ,UAAU,IAAI"}

package/dist/{collector-C4sagPeG.js → collector-BMEQCkCn.js}

@@ -1,5 +1,5 @@
-import { F as formatFontFaceRule, P as fontFaceContentHash, a as getGlobalCounterStyle, ct as hashString, i as getGlobalConfigTokens, j as formatCounterStyleRule, o as getGlobalFontFace, r as getEffectiveProperties, u as getGlobalStyles, x as renderStyles } from "./config-BovFXQil.js";
-import { n as formatPropertyCSS, t as formatRules } from "./format-rules-BBK7s2il.js";
+import { F as fontFaceContentHash, I as formatFontFaceRule, M as formatCounterStyleRule, S as renderStyles, a as getGlobalCounterStyle, d as getNamePrefix, dt as makeCounterStyleName, ft as makeKeyframeName, gt as hashString, i as getGlobalConfigTokens, mt as validateNamePrefix, o as getGlobalFontFace, r as getEffectiveProperties, u as getGlobalStyles, ut as makeClassName } from "./config-eiremPHv.js";
+import { n as formatPropertyCSS, t as formatRules } from "./format-rules-DcFFQceU.js";
 import { t as formatGlobalRules } from "./format-global-rules-Dbc_1tc3.js";
 //#region src/ssr/collector.ts
 /**
@@ -7,15 +7,13 @@ import { t as formatGlobalRules } from "./format-global-rules-Dbc_1tc3.js";
 *
 * Accumulates CSS rules and cache metadata during server rendering.
 * This is the server-side counterpart to StyleInjector: it allocates
-* hash-based class names (`t${hash}`), formats CSS rules into text,
-* and tracks rendered class names for lightweight client transfer.
+* 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 generateClassName(cacheKey) {
-	return `t${hashString(cacheKey)}`;
-}
 var ServerStyleCollector = class {
 	chunks = /* @__PURE__ */ new Map();
 	cacheKeyToClassName = /* @__PURE__ */ new Map();
@@ -35,6 +33,21 @@ var ServerStyleCollector = class {
 	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.
@@ -94,7 +107,7 @@ var ServerStyleCollector = class {
 			className: existing,
 			isNewAllocation: false
 		};
-		const className = generateClassName(cacheKey);
+		const className = this.generateClassName(cacheKey);
 		this.cacheKeyToClassName.set(cacheKey, className);
 		return {
 			className,
@@ -126,7 +139,7 @@ var ServerStyleCollector = class {
 	* Allocate a keyframe name for SSR. Uses provided name or generates one.
 	*/
 	allocateKeyframeName(providedName) {
-		return providedName ?? `k${this.keyframesCounter++}`;
+		return providedName ?? makeKeyframeName(this.namePrefix, String(this.keyframesCounter++));
 	}
 	/**
 	* Record a @font-face rule. Deduplicated by key (content hash).
@@ -144,7 +157,7 @@ var ServerStyleCollector = class {
 	* Allocate a counter-style name for SSR. Uses provided name or generates one.
 	*/
 	allocateCounterStyleName(providedName) {
-		return providedName ?? `cs${this.counterStyleCounter++}`;
+		return providedName ?? makeCounterStyleName(this.namePrefix, String(this.counterStyleCounter++));
 	}
 	/**
 	* Record global styles (from useGlobalStyles). Deduplicated by key.
@@ -227,4 +240,4 @@ var ServerStyleCollector = class {
 //#endregion
 export { ServerStyleCollector as t };
 
-//# sourceMappingURL=collector-C4sagPeG.js.map
+//# sourceMappingURL=collector-BMEQCkCn.js.map

package/dist/collector-BMEQCkCn.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"collector-BMEQCkCn.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  getGlobalCounterStyle,\n  getGlobalFontFace,\n  getGlobalConfigTokens,\n  getNamePrefix,\n} from '../config';\nimport { formatCounterStyleRule } from '../counter-style';\nimport { fontFaceContentHash, formatFontFaceRule } from '../font-face';\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 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 = getGlobalFontFace();\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 = getGlobalCounterStyle();\n    if (globalCS) {\n      for (const [name, descriptors] of Object.entries(globalCS)) {\n        const css = formatCounterStyleRule(name, descriptors);\n        this.collectCounterStyle(name, css);\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.\n   */\n  collectCounterStyle(name: string, css: string): void {\n    if (!this.counterStyleRules.has(name)) {\n      this.counterStyleRules.set(name, css);\n    }\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  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.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.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.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"],"mappings":"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"}

package/dist/{collector-LuU1vZ68.d.ts → collector-osfWTeRd.d.ts}

@@ -1,4 +1,4 @@
-import { n as StyleResult } from "./index-dUtwpOux.js";
+import { n as StyleResult } from "./index-tcHuMPFt.js";
 
 //#region src/ssr/collector.d.ts
 declare class ServerStyleCollector {
@@ -20,6 +20,16 @@ declare class ServerStyleCollector {
   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.
@@ -95,4 +105,4 @@ declare class ServerStyleCollector {
 }
 //#endregion
 export { ServerStyleCollector as t };
-//# sourceMappingURL=collector-LuU1vZ68.d.ts.map
+//# sourceMappingURL=collector-osfWTeRd.d.ts.map

package/dist/{config-vuCRkBWX.d.ts → config-BoZDUHW5.d.ts}

@@ -1,4 +1,4 @@
-import { Ct as RawCSSResult, Dt as StyleInjectorConfig, Et as SheetInfo, M as StyleHandlerDefinition, Ot as StyleRule, St as PropertyDefinition, Tt as RuleInfo, b as Styles, bt as KeyframesResult, ct as CacheMetrics, dt as FontFaceDescriptors, ft as FontFaceInput, gt as InjectResult, h as ConfigTokens, ht as GlobalInjectResult, it as StyleDetails, lt as CounterStyleDescriptors, mt as GCOptions, n as StyleResult, ot as UnitHandler, pt as GCConfig, v as RecipeStyles, wt as RootRegistry, xt as KeyframesSteps, yt as KeyframesInfo } from "./index-dUtwpOux.js";
+import { Ct as RawCSSResult, Dt as StyleInjectorConfig, Et as SheetInfo, M as StyleHandlerDefinition, Ot as StyleRule, St as PropertyDefinition, Tt as RuleInfo, b as Styles, bt as KeyframesResult, ct as CacheMetrics, dt as FontFaceDescriptors, ft as FontFaceInput, gt as InjectResult, h as ConfigTokens, ht as GlobalInjectResult, it as StyleDetails, lt as CounterStyleDescriptors, mt as GCOptions, n as StyleResult, ot as UnitHandler, pt as GCConfig, v as RecipeStyles, wt as RootRegistry, xt as KeyframesSteps, yt as KeyframesInfo } from "./index-tcHuMPFt.js";
 
 //#region src/injector/sheet-manager.d.ts
 declare class SheetManager {
@@ -73,6 +73,23 @@ declare class SheetManager {
    * Find an available rule index in the sheet
    */
   findAvailableRuleIndex(sheet: SheetInfo): number;
+  /**
+   * Probe whether the underlying CSS engine supports `@property` at-rules.
+   * Result is cached per registry on `registry.atPropertySupported`.
+   *
+   * The probe inserts and immediately deletes a minimal known-valid rule
+   * (`@property --__tasty_probe__ { syntax: "*"; inherits: true; }`).
+   * Engines that lack `@property` support (jsdom, happy-dom) reject any
+   * `@property` rule including this one, so a probe failure is a reliable
+   * signal that further `@property` rejections are environmental noise and
+   * not user-authored bugs.
+   *
+   * The probe is intentionally a separate operation from the user's failing
+   * insertion: we don't want to leak `--__tasty_probe__` into the sheet, so
+   * on success we delete the probe rule immediately, leaving `ruleCount`
+   * and `cssRules.length` unchanged.
+   */
+  private engineSupportsAtProperty;
   /**
    * Force cleanup of unused styles
    */
@@ -161,9 +178,18 @@ declare class StyleInjector {
   private config;
   private globalRuleCounter;
   private pendingGCHandle;
+  private namePrefix;
+  private classRegex;
+  private rscClassRegex;
   /** @internal — exposed for debug utilities only */
   get _sheetManager(): SheetManager;
   constructor(config?: StyleInjectorConfig);
+  /**
+   * Generate a deterministic class name from a cache key using content hash.
+   * The same cache key always produces the same class name across environments
+   * with the same `namePrefix`.
+   */
+  private generateClassName;
   /**
    * Check if `className` was hydrated from server-rendered styles and,
    * if so, wire the cacheKey mapping. Returns true on hit.
@@ -268,6 +294,11 @@ declare class StyleInjector {
   property(name: string, options?: PropertyDefinition & {
     root?: Document | ShadowRoot;
   }): void;
+  /**
+   * Build and insert a single `@property` rule into the given registry.
+   * No-op if the property was already injected.
+   */
+  private insertPropertyRule;
   /**
    * Check whether a given @property name was already injected by this injector.
    *
@@ -314,7 +345,6 @@ declare class StyleInjector {
    * Dispose keyframes
    */
   private disposeKeyframes;
-  private static readonly TASTY_CLASS_RE;
   /**
    * Record a render-time usage hit for one or more classNames.
    * Handles space-separated multi-chunk classNames.
@@ -551,6 +581,28 @@ interface TastyConfig {
    * ```
    */
   gc?: GCConfig;
+  /**
+   * Prefix prepended to every generated identifier (class names,
+   * keyframe names, counter-style names). The hash is appended verbatim,
+   * so include any separator inside the prefix itself (e.g. `'myapp-'`).
+   *
+   * Discriminator letters are inserted between the prefix and the hash
+   * for non-class names so the three kinds stay visually distinct:
+   * - class:         `${namePrefix}${hash}`        — e.g. `t1a2b3`
+   * - keyframe:      `${namePrefix}k${hash}`       — e.g. `tk1a2b3`
+   * - counter-style: `${namePrefix}c${hash}`       — e.g. `tc1a2b3`
+   *
+   * The runtime, SSR, and RSC paths must agree on this value or
+   * hydration will mismatch. The zero-runtime build path defaults to
+   * `'ts'` (overridable via the same option) so its classes can't
+   * collide with runtime classes when both are loaded on the same page.
+   *
+   * Must match `^[a-zA-Z][a-zA-Z0-9_-]{0,31}$`. Locked once styles
+   * have been generated.
+   *
+   * @default 't'
+   */
+  namePrefix?: string;
   /**
    * Plugins that extend tasty with custom functions, units, or states.
    * Plugins are processed in order, with later plugins overriding earlier ones.
@@ -874,11 +926,20 @@ declare function configure(config?: Partial<TastyConfig>): void;
  * If not configured, returns default configuration.
  */
 declare function getConfig(): TastyConfig;
+/**
+ * Get the configured prefix used for every generated identifier
+ * (class names, keyframe names, counter-style names).
+ *
+ * Falls back to the default prefix (`'t'`) when `configure()` has not
+ * been called yet — this matches the auto-configuration behavior used
+ * by the rest of the system.
+ */
+declare function getNamePrefix(): string;
 /**
  * Reset configuration (for testing only).
  * Clears the global injector and allows reconfiguration.
  */
 declare function resetConfig(): void;
 //#endregion
-export { TypographyTokenValue as _, getGlobalFontFace as a, StyleInjector as b, hasGlobalKeyframes as c, isConfigLocked as d, isTestEnvironment as f, TypographyPreset as g, TastyPluginFactory as h, getGlobalCounterStyle as i, hasGlobalRecipes as l, TastyPlugin as m, configure as n, getGlobalKeyframes as o, resetConfig as p, getConfig as r, getGlobalRecipes as s, TastyConfig as t, hasStylesGenerated as u, generateTypographyTokens as v, SheetManager as x, ColorSpace as y };
-//# sourceMappingURL=config-vuCRkBWX.d.ts.map
+export { SheetManager as S, TypographyPreset as _, getGlobalFontFace as a, ColorSpace as b, getNamePrefix as c, hasStylesGenerated as d, isConfigLocked as f, TastyPluginFactory as g, TastyPlugin as h, getGlobalCounterStyle as i, hasGlobalKeyframes as l, resetConfig as m, configure as n, getGlobalKeyframes as o, isTestEnvironment as p, getConfig as r, getGlobalRecipes as s, TastyConfig as t, hasGlobalRecipes as u, TypographyTokenValue as v, StyleInjector as x, generateTypographyTokens as y };
+//# sourceMappingURL=config-BoZDUHW5.d.ts.map