@tenphi/tasty 0.0.0-snapshot.056b911

package/dist/ssr/format-rules.js

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

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

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

package/dist/ssr/hydrate.d.ts

@@ -0,0 +1,22 @@
+import { SSRCacheState } from "./collector.js";
+
+//#region src/ssr/hydrate.d.ts
+declare global {
+  interface Window {
+    __TASTY_SSR_CACHE__?: SSRCacheState;
+  }
+}
+/**
+ * Pre-populate the client-side style cache from the server's SSR state.
+ *
+ * Call this before ReactDOM.hydrateRoot() or ensure it runs before
+ * any tasty() component renders on the client.
+ *
+ * When called without arguments, reads state from:
+ * 1. `window.__TASTY_SSR_CACHE__` (streaming — populated by inline scripts)
+ * 2. `<script data-tasty-cache>` (non-streaming — JSON payload)
+ */
+declare function hydrateTastyCache(state?: SSRCacheState): void;
+//#endregion
+export { hydrateTastyCache };
+//# sourceMappingURL=hydrate.d.ts.map

package/dist/ssr/hydrate.js

@@ -0,0 +1,49 @@
+import { getGlobalInjector } from "../config.js";
+//#region src/ssr/hydrate.ts
+/**
+* Client-side cache hydration for SSR.
+*
+* Pre-populates the client injector's cacheKeyToClassName map from the
+* server's serialized state. This ensures that useStyles() returns
+* cache hits during hydration, skipping the entire rendering pipeline.
+*/
+/**
+* Pre-populate the client-side style cache from the server's SSR state.
+*
+* Call this before ReactDOM.hydrateRoot() or ensure it runs before
+* any tasty() component renders on the client.
+*
+* When called without arguments, reads state from:
+* 1. `window.__TASTY_SSR_CACHE__` (streaming — populated by inline scripts)
+* 2. `<script data-tasty-cache>` (non-streaming — JSON payload)
+*/
+function hydrateTastyCache(state) {
+	if (typeof document === "undefined") return;
+	if (!state) {
+		state = (typeof window !== "undefined" ? window.__TASTY_SSR_CACHE__ : null) ?? void 0;
+		if (!state) {
+			const script = document.querySelector("script[data-tasty-cache]");
+			if (script) try {
+				state = JSON.parse(script.textContent);
+			} catch {
+				return;
+			}
+		}
+	}
+	if (!state) return;
+	const registry = getGlobalInjector()._sheetManager.getRegistry(document);
+	registry.classCounter = Math.max(registry.classCounter, state.classCounter);
+	for (const [cacheKey, className] of Object.entries(state.entries)) {
+		registry.cacheKeyToClassName.set(cacheKey, className);
+		registry.rules.set(className, {
+			className,
+			ruleIndex: -2,
+			sheetIndex: -2
+		});
+		registry.refCounts.set(className, 0);
+	}
+}
+//#endregion
+export { hydrateTastyCache };
+
+//# sourceMappingURL=hydrate.js.map

package/dist/ssr/hydrate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hydrate.js","names":[],"sources":["../../src/ssr/hydrate.ts"],"sourcesContent":["/**\n * Client-side cache hydration for SSR.\n *\n * Pre-populates the client injector's cacheKeyToClassName map from the\n * server's serialized state. This ensures that useStyles() returns\n * cache hits during hydration, skipping the entire rendering pipeline.\n */\n\nimport { getGlobalInjector } from '../config';\nimport type { SSRCacheState } from './collector';\n\ndeclare global {\n  interface Window {\n    __TASTY_SSR_CACHE__?: SSRCacheState;\n  }\n}\n\n/**\n * Pre-populate the client-side style cache from the server's SSR state.\n *\n * Call this before ReactDOM.hydrateRoot() or ensure it runs before\n * any tasty() component renders on the client.\n *\n * When called without arguments, reads state from:\n * 1. `window.__TASTY_SSR_CACHE__` (streaming — populated by inline scripts)\n * 2. `<script data-tasty-cache>` (non-streaming — JSON payload)\n */\nexport function hydrateTastyCache(state?: SSRCacheState): void {\n  if (typeof document === 'undefined') return;\n\n  if (!state) {\n    state =\n      (typeof window !== 'undefined' ? window.__TASTY_SSR_CACHE__ : null) ??\n      undefined;\n    if (!state) {\n      const script = document.querySelector('script[data-tasty-cache]');\n      if (script) {\n        try {\n          state = JSON.parse(script.textContent!) as SSRCacheState;\n        } catch {\n          return;\n        }\n      }\n    }\n  }\n\n  if (!state) return;\n\n  const injector = getGlobalInjector();\n  const registry = injector._sheetManager.getRegistry(document);\n\n  registry.classCounter = Math.max(registry.classCounter, state.classCounter);\n\n  for (const [cacheKey, className] of Object.entries(state.entries)) {\n    registry.cacheKeyToClassName.set(cacheKey, className);\n    registry.rules.set(className, {\n      className,\n      ruleIndex: -2,\n      sheetIndex: -2,\n    });\n    registry.refCounts.set(className, 0);\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;AA2BA,SAAgB,kBAAkB,OAA6B;AAC7D,KAAI,OAAO,aAAa,YAAa;AAErC,KAAI,CAAC,OAAO;AACV,WACG,OAAO,WAAW,cAAc,OAAO,sBAAsB,SAC9D,KAAA;AACF,MAAI,CAAC,OAAO;GACV,MAAM,SAAS,SAAS,cAAc,2BAA2B;AACjE,OAAI,OACF,KAAI;AACF,YAAQ,KAAK,MAAM,OAAO,YAAa;WACjC;AACN;;;;AAMR,KAAI,CAAC,MAAO;CAGZ,MAAM,WADW,mBAAmB,CACV,cAAc,YAAY,SAAS;AAE7D,UAAS,eAAe,KAAK,IAAI,SAAS,cAAc,MAAM,aAAa;AAE3E,MAAK,MAAM,CAAC,UAAU,cAAc,OAAO,QAAQ,MAAM,QAAQ,EAAE;AACjE,WAAS,oBAAoB,IAAI,UAAU,UAAU;AACrD,WAAS,MAAM,IAAI,WAAW;GAC5B;GACA,WAAW;GACX,YAAY;GACb,CAAC;AACF,WAAS,UAAU,IAAI,WAAW,EAAE"}

package/dist/ssr/index.d.ts

@@ -0,0 +1,4 @@
+import { SSRCacheState, ServerStyleCollector } from "./collector.js";
+import { getSSRCollector, runWithCollector } from "./async-storage.js";
+import { hydrateTastyCache } from "./hydrate.js";
+export { type SSRCacheState, ServerStyleCollector, getSSRCollector, hydrateTastyCache, runWithCollector };

package/dist/ssr/index.js

@@ -0,0 +1,10 @@
+import { registerSSRCollectorGetterGlobal } from "./ssr-collector-ref.js";
+import { ServerStyleCollector } from "./collector.js";
+import { getSSRCollector, runWithCollector } from "./async-storage.js";
+import { hydrateTastyCache } from "./hydrate.js";
+//#region src/ssr/index.ts
+registerSSRCollectorGetterGlobal(getSSRCollector);
+//#endregion
+export { ServerStyleCollector, getSSRCollector, hydrateTastyCache, runWithCollector };
+
+//# sourceMappingURL=index.js.map

package/dist/ssr/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../../src/ssr/index.ts"],"sourcesContent":["/**\n * SSR entry point for @tenphi/tasty.\n *\n * Provides the core SSR infrastructure: ServerStyleCollector,\n * AsyncLocalStorage integration, and cache hydration.\n *\n * Import from '@tenphi/tasty/ssr'.\n */\n\n// Core collector\nexport { ServerStyleCollector } from './collector';\nexport type { SSRCacheState } from './collector';\n\n// AsyncLocalStorage integration for Astro / generic frameworks\nexport { runWithCollector, getSSRCollector } from './async-storage';\n\n// Client-side cache hydration\nexport { hydrateTastyCache } from './hydrate';\n\n// Register the ALS getter so hooks can find the collector\n// without importing 'node:async_hooks' in the browser bundle.\n// Uses globalThis so the getter is visible across separate module graphs.\nimport { getSSRCollector } from './async-storage';\nimport { registerSSRCollectorGetterGlobal } from './ssr-collector-ref';\n\nregisterSSRCollectorGetterGlobal(getSSRCollector);\n"],"mappings":";;;;;AAyBA,iCAAiC,gBAAgB"}

package/dist/ssr/next.d.ts

@@ -0,0 +1,45 @@
+import { ServerStyleCollector } from "./collector.js";
+import * as _$react from "react";
+import { ReactNode } from "react";
+
+//#region src/ssr/next.d.ts
+interface TastyRegistryProps {
+  children: ReactNode;
+  /**
+   * Whether to embed the cache state script for client hydration.
+   * Set to false to skip cache transfer (useful when cache size
+   * exceeds the hydration benefit). Default: true.
+   */
+  transferCache?: boolean;
+}
+/**
+ * Next.js App Router registry for Tasty SSR.
+ *
+ * Wraps the component tree with a ServerStyleCollector and flushes
+ * collected CSS into the HTML stream via useServerInsertedHTML.
+ *
+ * @example
+ * ```tsx
+ * // app/tasty-registry.tsx
+ * 'use client';
+ * import { TastyRegistry } from '@tenphi/tasty/ssr/next';
+ * export default function TastyStyleRegistry({ children }) {
+ *   return <TastyRegistry>{children}</TastyRegistry>;
+ * }
+ *
+ * // app/layout.tsx
+ * import TastyStyleRegistry from './tasty-registry';
+ * export default function RootLayout({ children }) {
+ *   return <html><body>
+ *     <TastyStyleRegistry>{children}</TastyStyleRegistry>
+ *   </body></html>;
+ * }
+ * ```
+ */
+declare function TastyRegistry({
+  children,
+  transferCache
+}: TastyRegistryProps): _$react.FunctionComponentElement<_$react.ProviderProps<ServerStyleCollector | null>>;
+//#endregion
+export { TastyRegistry, TastyRegistryProps };
+//# sourceMappingURL=next.d.ts.map

package/dist/ssr/next.js

@@ -0,0 +1,75 @@
+"use client";
+import { getConfig } from "../config.js";
+import { registerSSRCollectorGetter } from "./ssr-collector-ref.js";
+import { TastySSRContext } from "./context.js";
+import { ServerStyleCollector } from "./collector.js";
+import { hydrateTastyCache } from "./hydrate.js";
+import { Fragment, createElement, useState } from "react";
+import { useServerInsertedHTML } from "next/navigation";
+//#region src/ssr/next.ts
+/**
+* Next.js integration for Tasty SSR.
+*
+* Provides TastyRegistry for App Router (streaming via useServerInsertedHTML)
+* and createTastySSRDocument for Pages Router (non-streaming).
+*
+* Import from '@tenphi/tasty/ssr/next'.
+*/
+if (typeof window !== "undefined" && window.__TASTY_SSR_CACHE__) hydrateTastyCache(window.__TASTY_SSR_CACHE__);
+/**
+* Next.js App Router registry for Tasty SSR.
+*
+* Wraps the component tree with a ServerStyleCollector and flushes
+* collected CSS into the HTML stream via useServerInsertedHTML.
+*
+* @example
+* ```tsx
+* // app/tasty-registry.tsx
+* 'use client';
+* import { TastyRegistry } from '@tenphi/tasty/ssr/next';
+* export default function TastyStyleRegistry({ children }) {
+*   return <TastyRegistry>{children}</TastyRegistry>;
+* }
+*
+* // app/layout.tsx
+* import TastyStyleRegistry from './tasty-registry';
+* export default function RootLayout({ children }) {
+*   return <html><body>
+*     <TastyStyleRegistry>{children}</TastyStyleRegistry>
+*   </body></html>;
+* }
+* ```
+*/
+function TastyRegistry({ children, transferCache = true }) {
+	const isClient = typeof window !== "undefined";
+	const [collector] = useState(() => {
+		if (isClient) return null;
+		const instance = new ServerStyleCollector();
+		registerSSRCollectorGetter(() => instance);
+		return instance;
+	});
+	const nonce = getConfig().nonce;
+	useServerInsertedHTML(() => {
+		if (!collector) return null;
+		const css = collector.flushCSS();
+		const cacheState = collector.getCacheState();
+		if (!css) return null;
+		const styleEl = createElement("style", {
+			key: "tasty-ssr-styles",
+			"data-tasty-ssr": "",
+			nonce,
+			dangerouslySetInnerHTML: { __html: css }
+		});
+		if (!transferCache) return styleEl;
+		return createElement(Fragment, null, styleEl, createElement("script", {
+			key: "tasty-ssr-cache",
+			nonce,
+			dangerouslySetInnerHTML: { __html: `(window.__TASTY_SSR_CACHE__=window.__TASTY_SSR_CACHE__||{entries:{},classCounter:0});Object.assign(window.__TASTY_SSR_CACHE__.entries,${JSON.stringify(cacheState.entries)});window.__TASTY_SSR_CACHE__.classCounter=${cacheState.classCounter};` }
+		}));
+	});
+	return createElement(TastySSRContext.Provider, { value: collector }, children);
+}
+//#endregion
+export { TastyRegistry };
+
+//# sourceMappingURL=next.js.map

package/dist/ssr/next.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"next.js","names":[],"sources":["../../src/ssr/next.ts"],"sourcesContent":["/**\n * Next.js integration for Tasty SSR.\n *\n * Provides TastyRegistry for App Router (streaming via useServerInsertedHTML)\n * and createTastySSRDocument for Pages Router (non-streaming).\n *\n * Import from '@tenphi/tasty/ssr/next'.\n */\n\n'use client';\n\n/// <reference path=\"./next-navigation.d.ts\" />\n\nimport { createElement, Fragment, useState, type ReactNode } from 'react';\nimport { useServerInsertedHTML } from 'next/navigation';\n\nimport { getConfig } from '../config';\nimport { ServerStyleCollector } from './collector';\nimport { TastySSRContext } from './context';\nimport { hydrateTastyCache } from './hydrate';\nimport { registerSSRCollectorGetter } from './ssr-collector-ref';\n\n// Auto-hydrate on module load (client only).\n// When this module is imported by the TastyRegistry client component,\n// the streaming cache scripts have already populated __TASTY_SSR_CACHE__.\nif (typeof window !== 'undefined' && window.__TASTY_SSR_CACHE__) {\n  hydrateTastyCache(window.__TASTY_SSR_CACHE__);\n}\n\nexport interface TastyRegistryProps {\n  children: ReactNode;\n  /**\n   * Whether to embed the cache state script for client hydration.\n   * Set to false to skip cache transfer (useful when cache size\n   * exceeds the hydration benefit). Default: true.\n   */\n  transferCache?: boolean;\n}\n\n/**\n * Next.js App Router registry for Tasty SSR.\n *\n * Wraps the component tree with a ServerStyleCollector and flushes\n * collected CSS into the HTML stream via useServerInsertedHTML.\n *\n * @example\n * ```tsx\n * // app/tasty-registry.tsx\n * 'use client';\n * import { TastyRegistry } from '@tenphi/tasty/ssr/next';\n * export default function TastyStyleRegistry({ children }) {\n *   return <TastyRegistry>{children}</TastyRegistry>;\n * }\n *\n * // app/layout.tsx\n * import TastyStyleRegistry from './tasty-registry';\n * export default function RootLayout({ children }) {\n *   return <html><body>\n *     <TastyStyleRegistry>{children}</TastyStyleRegistry>\n *   </body></html>;\n * }\n * ```\n */\nexport function TastyRegistry({\n  children,\n  transferCache = true,\n}: TastyRegistryProps) {\n  const isClient = typeof window !== 'undefined';\n\n  const [collector] = useState(() => {\n    if (isClient) return null;\n\n    const instance = new ServerStyleCollector();\n\n    registerSSRCollectorGetter(() => instance);\n\n    return instance;\n  });\n  const nonce = getConfig().nonce;\n\n  useServerInsertedHTML(() => {\n    if (!collector) return null;\n\n    const css = collector.flushCSS();\n    const cacheState = collector.getCacheState();\n\n    if (!css) return null;\n\n    const styleEl = createElement('style', {\n      key: 'tasty-ssr-styles',\n      'data-tasty-ssr': '',\n      nonce,\n      dangerouslySetInnerHTML: { __html: css },\n    });\n\n    if (!transferCache) return styleEl;\n\n    const scriptEl = createElement('script', {\n      key: 'tasty-ssr-cache',\n      nonce,\n      dangerouslySetInnerHTML: {\n        __html:\n          `(window.__TASTY_SSR_CACHE__=window.__TASTY_SSR_CACHE__||{entries:{},classCounter:0});` +\n          `Object.assign(window.__TASTY_SSR_CACHE__.entries,${JSON.stringify(cacheState.entries)});` +\n          `window.__TASTY_SSR_CACHE__.classCounter=${cacheState.classCounter};`,\n      },\n    });\n\n    return createElement(Fragment, null, styleEl, scriptEl);\n  });\n\n  return createElement(\n    TastySSRContext.Provider,\n    { value: collector },\n    children,\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;;;AAyBA,IAAI,OAAO,WAAW,eAAe,OAAO,oBAC1C,mBAAkB,OAAO,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;AAqC/C,SAAgB,cAAc,EAC5B,UACA,gBAAgB,QACK;CACrB,MAAM,WAAW,OAAO,WAAW;CAEnC,MAAM,CAAC,aAAa,eAAe;AACjC,MAAI,SAAU,QAAO;EAErB,MAAM,WAAW,IAAI,sBAAsB;AAE3C,mCAAiC,SAAS;AAE1C,SAAO;GACP;CACF,MAAM,QAAQ,WAAW,CAAC;AAE1B,6BAA4B;AAC1B,MAAI,CAAC,UAAW,QAAO;EAEvB,MAAM,MAAM,UAAU,UAAU;EAChC,MAAM,aAAa,UAAU,eAAe;AAE5C,MAAI,CAAC,IAAK,QAAO;EAEjB,MAAM,UAAU,cAAc,SAAS;GACrC,KAAK;GACL,kBAAkB;GAClB;GACA,yBAAyB,EAAE,QAAQ,KAAK;GACzC,CAAC;AAEF,MAAI,CAAC,cAAe,QAAO;AAa3B,SAAO,cAAc,UAAU,MAAM,SAXpB,cAAc,UAAU;GACvC,KAAK;GACL;GACA,yBAAyB,EACvB,QACE,yIACoD,KAAK,UAAU,WAAW,QAAQ,CAAC,4CAC5C,WAAW,aAAa,IACtE;GACF,CAAC,CAEqD;GACvD;AAEF,QAAO,cACL,gBAAgB,UAChB,EAAE,OAAO,WAAW,EACpB,SACD"}

package/dist/ssr/ssr-collector-ref.js

@@ -0,0 +1,29 @@
+//#region src/ssr/ssr-collector-ref.ts
+const GETTER_KEY = "__tasty_ssr_collector_getter__";
+let _getSSRCollector = null;
+/**
+* Register the collector getter in the current module graph only.
+* Used by Next.js TastyRegistry.
+*/
+function registerSSRCollectorGetter(fn) {
+	_getSSRCollector = fn;
+}
+/**
+* Register the collector getter on globalThis so it is visible across
+* separate module graphs (e.g. Astro middleware ↔ page components).
+*/
+function registerSSRCollectorGetterGlobal(fn) {
+	globalThis[GETTER_KEY] = fn;
+}
+/**
+* Retrieve the SSR collector: module-level first, globalThis fallback.
+*/
+function getRegisteredSSRCollector() {
+	if (_getSSRCollector) return _getSSRCollector();
+	const getter = globalThis[GETTER_KEY];
+	return getter ? getter() : null;
+}
+//#endregion
+export { getRegisteredSSRCollector, registerSSRCollectorGetter, registerSSRCollectorGetterGlobal };
+
+//# sourceMappingURL=ssr-collector-ref.js.map

package/dist/ssr/ssr-collector-ref.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ssr-collector-ref.js","names":[],"sources":["../../src/ssr/ssr-collector-ref.ts"],"sourcesContent":["/**\n * Global reference to the SSR collector getter function.\n *\n * This indirection avoids importing 'node:async_hooks' in the browser bundle.\n * The SSR entry point sets this ref when loaded on the server. The useStyles\n * hook calls it if set; on the client it stays null and is never called.\n *\n * Uses a module-level variable as the primary mechanism. In Next.js App\n * Router the RSC and SSR module graphs load separate copies of this module,\n * so the getter registered by TastyRegistry (SSR layer) is invisible to\n * server components (RSC layer) — which correctly fall through to inline\n * RSC styles.\n *\n * A globalThis fallback (`registerSSRCollectorGetterGlobal`) is provided\n * for frameworks like Astro where middleware and page components live in\n * different module graphs and must share the getter across them.\n */\n\nimport type { ServerStyleCollector } from './collector';\n\ntype SSRCollectorGetter = () => ServerStyleCollector | null;\n\nconst GETTER_KEY = '__tasty_ssr_collector_getter__';\n\nlet _getSSRCollector: SSRCollectorGetter | null = null;\n\n/**\n * Register the collector getter in the current module graph only.\n * Used by Next.js TastyRegistry.\n */\nexport function registerSSRCollectorGetter(fn: SSRCollectorGetter): void {\n  _getSSRCollector = fn;\n}\n\n/**\n * Register the collector getter on globalThis so it is visible across\n * separate module graphs (e.g. Astro middleware ↔ page components).\n */\nexport function registerSSRCollectorGetterGlobal(fn: SSRCollectorGetter): void {\n  (globalThis as Record<string, unknown>)[GETTER_KEY] = fn;\n}\n\n/**\n * Retrieve the SSR collector: module-level first, globalThis fallback.\n */\nexport function getRegisteredSSRCollector(): ServerStyleCollector | null {\n  if (_getSSRCollector) return _getSSRCollector();\n  const getter = (globalThis as Record<string, unknown>)[GETTER_KEY] as\n    | SSRCollectorGetter\n    | undefined;\n  return getter ? getter() : null;\n}\n"],"mappings":";AAsBA,MAAM,aAAa;AAEnB,IAAI,mBAA8C;;;;;AAMlD,SAAgB,2BAA2B,IAA8B;AACvE,oBAAmB;;;;;;AAOrB,SAAgB,iCAAiC,IAA8B;AAC5E,YAAuC,cAAc;;;;;AAMxD,SAAgB,4BAAyD;AACvE,KAAI,iBAAkB,QAAO,kBAAkB;CAC/C,MAAM,SAAU,WAAuC;AAGvD,QAAO,SAAS,QAAQ,GAAG"}

package/dist/states/index.d.ts

@@ -0,0 +1,49 @@
+import { Styles } from "../styles/types.js";
+
+//#region src/states/index.d.ts
+/**
+ * Parsed advanced state information
+ */
+interface ParsedAdvancedState {
+  type: 'media' | 'container' | 'root' | 'parent' | 'own' | 'starting' | 'predefined' | 'modifier';
+  condition: string;
+  containerName?: string;
+  raw: string;
+  mediaType?: string;
+}
+/**
+ * Context for state parsing operations
+ */
+interface StateParserContext {
+  localPredefinedStates: Record<string, string>;
+  globalPredefinedStates: Record<string, string>;
+  isSubElement?: boolean;
+}
+/**
+ * At-rule context for CSS generation
+ */
+interface AtRuleContext {
+  media?: string[];
+  container?: {
+    name?: string;
+    condition: string;
+  }[];
+  startingStyle?: boolean;
+  rootStates?: string[];
+  negatedRootStates?: string[];
+}
+/**
+ * Configure global predefined states
+ */
+declare function setGlobalPredefinedStates(states: Record<string, string>): void;
+/**
+ * Get global predefined states
+ */
+declare function getGlobalPredefinedStates(): Record<string, string>;
+/**
+ * Create a state parser context from styles
+ */
+declare function createStateParserContext(styles?: Styles, isSubElement?: boolean): StateParserContext;
+//#endregion
+export { AtRuleContext, ParsedAdvancedState, StateParserContext, createStateParserContext, getGlobalPredefinedStates, setGlobalPredefinedStates };
+//# sourceMappingURL=index.d.ts.map

package/dist/states/index.js

@@ -0,0 +1,170 @@
+import { isDevEnv } from "../utils/is-dev-env.js";
+import { hasStylesGenerated } from "../config.js";
+//#region src/states/index.ts
+/**
+* Advanced State Mapping - Predefined States Management
+*
+* This module handles global and local predefined states for the Tasty styling system.
+* See ADVANCED_STATE_MAPPING.md for full specification.
+*/
+const BUILTIN_STATES = new Set([
+	"@starting",
+	"@keyframes",
+	"@properties",
+	"@fontFace",
+	"@counterStyle",
+	"@supports",
+	"@inherit"
+]);
+let globalPredefinedStates = {};
+const emittedWarnings = /* @__PURE__ */ new Set();
+const devMode = isDevEnv();
+/**
+* Emit a warning only once
+*/
+function warnOnce(key, message) {
+	if (devMode && !emittedWarnings.has(key)) {
+		emittedWarnings.add(key);
+		console.warn(message);
+	}
+}
+/**
+* Configure global predefined states
+*/
+function setGlobalPredefinedStates(states) {
+	if (hasStylesGenerated()) {
+		const newStateNames = Object.keys(states).join(", ");
+		warnOnce(`dynamic-states:${newStateNames}`, `[Tasty] Cannot update predefined states after styles have been generated.\nThe new definition(s) for ${newStateNames} will be ignored.`);
+		return;
+	}
+	for (const [name, value] of Object.entries(states)) {
+		if (!/^@[A-Za-z][A-Za-z0-9-]*$/.test(name)) {
+			warnOnce(`invalid-state-name:${name}`, `[Tasty] Invalid predefined state name '${name}'. Must start with '@' followed by a letter.`);
+			continue;
+		}
+		if (BUILTIN_STATES.has(name)) {
+			warnOnce(`reserved-state:${name}`, `[Tasty] Cannot define predefined state '${name}'. This name is reserved for built-in functionality.`);
+			continue;
+		}
+		if (name === "@media" || name === "@root" || name === "@parent" || name === "@own" || name.startsWith("@(")) {
+			warnOnce(`reserved-prefix:${name}`, `[Tasty] Cannot define predefined state '${name}'. This prefix is reserved for built-in functionality.`);
+			continue;
+		}
+		const crossRefs = extractPredefinedStateRefs(value);
+		if (crossRefs.length > 0) {
+			warnOnce(`cross-ref:${name}`, `[Tasty] Predefined state '${name}' references another predefined state '${crossRefs[0]}'.\nPredefined states cannot reference each other. Use the full definition instead.`);
+			continue;
+		}
+		if (globalPredefinedStates[name] && globalPredefinedStates[name] !== value) warnOnce(`duplicate-state:${name}`, `[Tasty] Duplicate predefined state '${name}' in configure(). The last definition will be used.`);
+		globalPredefinedStates[name] = value;
+	}
+}
+/**
+* Get global predefined states
+*/
+function getGlobalPredefinedStates() {
+	return globalPredefinedStates;
+}
+/**
+* Regex to match predefined state references in a string
+* Matches @name that is NOT followed by ( or : and is a complete word
+* Uses word boundary and negative lookahead
+*/
+const PREDEFINED_STATE_PATTERN = /@([A-Za-z][A-Za-z0-9-]*)(?![A-Za-z0-9-:(])/g;
+/**
+* Extract predefined state references from a string
+*/
+function extractPredefinedStateRefs(value) {
+	const matches = value.matchAll(PREDEFINED_STATE_PATTERN);
+	const refs = [];
+	for (const match of matches) {
+		const stateName = "@" + match[1];
+		if (!BUILTIN_STATES.has(stateName) && !refs.includes(stateName)) refs.push(stateName);
+	}
+	return refs;
+}
+const _localStatesCache = /* @__PURE__ */ new WeakMap();
+/**
+* Extract local predefined states from a styles object
+* Local predefined states are top-level keys starting with @ that have string values
+* and are valid predefined state names (not built-in like @media, @root, etc.)
+*
+* Results are cached by object identity via WeakMap since the same styles object
+* is passed to this function multiple times per pipeline run (once per chunk
+* in renderStylesForChunk and generateChunkCacheKey).
+*/
+function extractLocalPredefinedStates(styles) {
+	if (!styles || typeof styles !== "object") return {};
+	const cached = _localStatesCache.get(styles);
+	if (cached !== void 0) return cached;
+	const localStates = {};
+	for (const [key, value] of Object.entries(styles)) if (key.startsWith("@") && typeof value === "string") {
+		if (!/^@[A-Za-z][A-Za-z0-9-]*$/.test(key)) continue;
+		if (BUILTIN_STATES.has(key)) continue;
+		if (key === "@media" || key === "@root" || key === "@parent" || key === "@own" || key.startsWith("@(")) continue;
+		const crossRefs = extractPredefinedStateRefs(value);
+		if (crossRefs.length > 0) {
+			warnOnce(`local-cross-ref:${key}`, `[Tasty] Predefined state '${key}' references another predefined state '${crossRefs[0]}'.\nPredefined states cannot reference each other. Use the full definition instead.`);
+			continue;
+		}
+		localStates[key] = value;
+	}
+	_localStatesCache.set(styles, localStates);
+	return localStates;
+}
+/**
+* Create a state parser context from styles
+*/
+function createStateParserContext(styles, isSubElement) {
+	return {
+		localPredefinedStates: styles ? extractLocalPredefinedStates(styles) : {},
+		globalPredefinedStates: getGlobalPredefinedStates(),
+		isSubElement
+	};
+}
+/**
+* Resolve a predefined state reference to its value
+* Returns the resolved value or null if not found
+*/
+function resolvePredefinedState(stateKey, ctx) {
+	if (ctx.localPredefinedStates[stateKey]) return ctx.localPredefinedStates[stateKey];
+	if (ctx.globalPredefinedStates[stateKey]) return ctx.globalPredefinedStates[stateKey];
+	warnOnce(`undefined-state:${stateKey}`, `[Tasty] Undefined predefined state '${stateKey}'.\nDefine it in configure({ states: { '${stateKey}': '...' } }) or in the component's styles.`);
+	return null;
+}
+/**
+* Expand dimension shorthands in a condition string
+* w -> width, h -> height, is -> inline-size, bs -> block-size
+*/
+function expandDimensionShorthands(condition) {
+	let result = condition;
+	result = result.replace(/\bw\b/g, "width");
+	result = result.replace(/\bh\b/g, "height");
+	result = result.replace(/\bis\b/g, "inline-size");
+	result = result.replace(/\bbs\b/g, "block-size");
+	return result;
+}
+/**
+* Convert tasty units in a string (e.g., 40x -> calc(var(--gap) * 40))
+*/
+function expandTastyUnits(value) {
+	return value.replace(/(\d+(?:\.\d+)?)\s*x\b/g, (_, num) => {
+		return `calc(var(--gap) * ${num})`;
+	});
+}
+/**
+* Find the index of the first comma at parentheses depth 0.
+* Returns -1 if no top-level comma is found.
+* This prevents splitting on commas inside function calls like scroll-state(a, b).
+*/
+function findTopLevelComma(s) {
+	let depth = 0;
+	for (let i = 0; i < s.length; i++) if (s[i] === "(") depth++;
+	else if (s[i] === ")") depth--;
+	else if (s[i] === "," && depth === 0) return i;
+	return -1;
+}
+//#endregion
+export { createStateParserContext, expandDimensionShorthands, expandTastyUnits, extractLocalPredefinedStates, extractPredefinedStateRefs, findTopLevelComma, getGlobalPredefinedStates, resolvePredefinedState, setGlobalPredefinedStates };
+
+//# sourceMappingURL=index.js.map

package/dist/states/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../../src/states/index.ts"],"sourcesContent":["/**\n * Advanced State Mapping - Predefined States Management\n *\n * This module handles global and local predefined states for the Tasty styling system.\n * See ADVANCED_STATE_MAPPING.md for full specification.\n */\n\nimport { hasStylesGenerated } from '../config';\nimport type { Styles } from '../styles/types';\nimport { isDevEnv } from '../utils/is-dev-env';\n\n/**\n * Parsed advanced state information\n */\nexport interface ParsedAdvancedState {\n  type:\n    | 'media'\n    | 'container'\n    | 'root'\n    | 'parent'\n    | 'own'\n    | 'starting'\n    | 'predefined'\n    | 'modifier';\n  condition: string; // e.g., 'width <= 920px' or 'hovered'\n  containerName?: string; // for container queries\n  raw: string; // original state key\n  mediaType?: string; // for @media:screen, @media:print, etc.\n}\n\n/**\n * Context for state parsing operations\n */\nexport interface StateParserContext {\n  localPredefinedStates: Record<string, string>;\n  globalPredefinedStates: Record<string, string>;\n  isSubElement?: boolean; // true when processing sub-element styles (for @own() validation)\n}\n\n/**\n * At-rule context for CSS generation\n */\nexport interface AtRuleContext {\n  media?: string[]; // @media conditions to wrap rule in (merged with 'and')\n  container?: { name?: string; condition: string }[]; // @container conditions (nested)\n  startingStyle?: boolean;\n  rootStates?: string[]; // :root state selectors (e.g., '[data-theme=\"dark\"]')\n  negatedRootStates?: string[]; // Negated :root state selectors for non-overlapping rules (e.g., ':not([data-theme=\"dark\"])')\n}\n\n// Built-in state names that cannot be overridden\nconst BUILTIN_STATES = new Set([\n  '@starting',\n  '@keyframes',\n  '@properties',\n  '@fontFace',\n  '@counterStyle',\n  '@supports',\n  // @inherit is a value (not a key), but reserved here to prevent\n  // users from accidentally defining a state named '@inherit'.\n  '@inherit',\n]);\n\n// Reserved prefixes that are built-in\nconst RESERVED_PREFIXES = [\n  '@media',\n  '@root',\n  '@parent',\n  '@own',\n  '@(',\n  '@starting',\n  '@keyframes',\n  '@properties',\n  '@supports',\n  '@inherit',\n];\n\n// Global predefined states storage\nlet globalPredefinedStates: Record<string, string> = {};\n\n// Warnings tracking to avoid duplicates\nconst emittedWarnings = new Set<string>();\n\nconst devMode = isDevEnv();\n\n/**\n * Emit a warning only once\n */\nfunction warnOnce(key: string, message: string): void {\n  if (devMode && !emittedWarnings.has(key)) {\n    emittedWarnings.add(key);\n    console.warn(message);\n  }\n}\n\n/**\n * Configure global predefined states\n */\nexport function setGlobalPredefinedStates(\n  states: Record<string, string>,\n): void {\n  if (hasStylesGenerated()) {\n    const newStateNames = Object.keys(states).join(', ');\n    warnOnce(\n      `dynamic-states:${newStateNames}`,\n      `[Tasty] Cannot update predefined states after styles have been generated.\\n` +\n        `The new definition(s) for ${newStateNames} will be ignored.`,\n    );\n    return;\n  }\n\n  // Validate state names\n  for (const [name, value] of Object.entries(states)) {\n    // Check for valid name format\n    if (!/^@[A-Za-z][A-Za-z0-9-]*$/.test(name)) {\n      warnOnce(\n        `invalid-state-name:${name}`,\n        `[Tasty] Invalid predefined state name '${name}'. Must start with '@' followed by a letter.`,\n      );\n      continue;\n    }\n\n    // Check for reserved names\n    if (BUILTIN_STATES.has(name)) {\n      warnOnce(\n        `reserved-state:${name}`,\n        `[Tasty] Cannot define predefined state '${name}'. This name is reserved for built-in functionality.`,\n      );\n      continue;\n    }\n\n    // Check for reserved prefixes (but only exact matches, not user-defined states like @mobile)\n    // Reserved prefixes are: @media, @root, @parent, @own, @(\n    // A user state like @mobile should NOT be blocked\n    const isReservedPrefix =\n      name === '@media' ||\n      name === '@root' ||\n      name === '@parent' ||\n      name === '@own' ||\n      name.startsWith('@(');\n\n    if (isReservedPrefix) {\n      warnOnce(\n        `reserved-prefix:${name}`,\n        `[Tasty] Cannot define predefined state '${name}'. This prefix is reserved for built-in functionality.`,\n      );\n      continue;\n    }\n\n    // Check for cross-references\n    const crossRefs = extractPredefinedStateRefs(value);\n    if (crossRefs.length > 0) {\n      warnOnce(\n        `cross-ref:${name}`,\n        `[Tasty] Predefined state '${name}' references another predefined state '${crossRefs[0]}'.\\n` +\n          `Predefined states cannot reference each other. Use the full definition instead.`,\n      );\n      continue;\n    }\n\n    // Check for duplicates\n    if (\n      globalPredefinedStates[name] &&\n      globalPredefinedStates[name] !== value\n    ) {\n      warnOnce(\n        `duplicate-state:${name}`,\n        `[Tasty] Duplicate predefined state '${name}' in configure(). The last definition will be used.`,\n      );\n    }\n\n    globalPredefinedStates[name] = value;\n  }\n}\n\n/**\n * Get global predefined states\n */\nexport function getGlobalPredefinedStates(): Record<string, string> {\n  return globalPredefinedStates;\n}\n\n/**\n * Clear global predefined states (for testing only)\n */\nexport function clearGlobalPredefinedStates(): void {\n  globalPredefinedStates = {};\n  emittedWarnings.clear();\n}\n\n/**\n * Regex to match predefined state references in a string\n * Matches @name that is NOT followed by ( or : and is a complete word\n * Uses word boundary and negative lookahead\n */\nconst PREDEFINED_STATE_PATTERN = /@([A-Za-z][A-Za-z0-9-]*)(?![A-Za-z0-9-:(])/g;\n\n/**\n * Extract predefined state references from a string\n */\nexport function extractPredefinedStateRefs(value: string): string[] {\n  const matches = value.matchAll(PREDEFINED_STATE_PATTERN);\n  const refs: string[] = [];\n\n  for (const match of matches) {\n    const stateName = '@' + match[1];\n    // Skip built-in states (@starting) and duplicates\n    // Note: @media, @root, @own are always followed by '(' so the regex\n    // negative lookahead (?![A-Za-z0-9-:(]) already excludes them\n    if (!BUILTIN_STATES.has(stateName) && !refs.includes(stateName)) {\n      refs.push(stateName);\n    }\n  }\n\n  return refs;\n}\n\n/**\n * Check if a state key is a predefined state reference\n */\nexport function isPredefinedStateRef(stateKey: string): boolean {\n  if (!stateKey.startsWith('@')) return false;\n  if (BUILTIN_STATES.has(stateKey)) return false;\n\n  // Check if it's NOT a built-in prefix\n  for (const prefix of RESERVED_PREFIXES) {\n    if (stateKey === prefix || stateKey.startsWith(prefix)) {\n      // Check if it's exactly @media, @root, @parent, @own, or starts with @( or @media(\n      if (\n        stateKey === '@media' ||\n        stateKey.startsWith('@media(') ||\n        stateKey.startsWith('@media:')\n      ) {\n        return false;\n      }\n      if (stateKey === '@root' || stateKey.startsWith('@root(')) return false;\n      if (stateKey === '@parent' || stateKey.startsWith('@parent('))\n        return false;\n      if (stateKey === '@own' || stateKey.startsWith('@own(')) return false;\n      if (stateKey.startsWith('@(')) return false;\n    }\n  }\n\n  // Must match the predefined state pattern\n  return /^@[A-Za-z][A-Za-z0-9-]*$/.test(stateKey);\n}\n\nconst _localStatesCache = new WeakMap<object, Record<string, string>>();\n\n/**\n * Extract local predefined states from a styles object\n * Local predefined states are top-level keys starting with @ that have string values\n * and are valid predefined state names (not built-in like @media, @root, etc.)\n *\n * Results are cached by object identity via WeakMap since the same styles object\n * is passed to this function multiple times per pipeline run (once per chunk\n * in renderStylesForChunk and generateChunkCacheKey).\n */\nexport function extractLocalPredefinedStates(\n  styles: Styles,\n): Record<string, string> {\n  if (!styles || typeof styles !== 'object') {\n    return {};\n  }\n\n  const cached = _localStatesCache.get(styles as object);\n  if (cached !== undefined) return cached;\n\n  const localStates: Record<string, string> = {};\n\n  for (const [key, value] of Object.entries(styles)) {\n    // Check if it's a predefined state definition (starts with @, has string value)\n    if (key.startsWith('@') && typeof value === 'string') {\n      // Validate name format - must be @[letter][letters/numbers/dashes]*\n      if (!/^@[A-Za-z][A-Za-z0-9-]*$/.test(key)) {\n        continue; // Skip invalid names silently (might be something else)\n      }\n\n      // Skip built-in states\n      if (BUILTIN_STATES.has(key)) {\n        continue;\n      }\n\n      // Skip reserved prefixes\n      if (\n        key === '@media' ||\n        key === '@root' ||\n        key === '@parent' ||\n        key === '@own' ||\n        key.startsWith('@(')\n      ) {\n        continue;\n      }\n\n      // Check for cross-references (predefined states cannot reference each other)\n      const crossRefs = extractPredefinedStateRefs(value);\n      if (crossRefs.length > 0) {\n        warnOnce(\n          `local-cross-ref:${key}`,\n          `[Tasty] Predefined state '${key}' references another predefined state '${crossRefs[0]}'.\\n` +\n            `Predefined states cannot reference each other. Use the full definition instead.`,\n        );\n        continue;\n      }\n\n      localStates[key] = value;\n    }\n  }\n\n  _localStatesCache.set(styles as object, localStates);\n\n  return localStates;\n}\n\n/**\n * Create a state parser context from styles\n */\nexport function createStateParserContext(\n  styles?: Styles,\n  isSubElement?: boolean,\n): StateParserContext {\n  const localStates = styles ? extractLocalPredefinedStates(styles) : {};\n\n  return {\n    localPredefinedStates: localStates,\n    globalPredefinedStates: getGlobalPredefinedStates(),\n    isSubElement,\n  };\n}\n\n/**\n * Resolve a predefined state reference to its value\n * Returns the resolved value or null if not found\n */\nexport function resolvePredefinedState(\n  stateKey: string,\n  ctx: StateParserContext,\n): string | null {\n  // Check local first (higher priority)\n  if (ctx.localPredefinedStates[stateKey]) {\n    return ctx.localPredefinedStates[stateKey];\n  }\n\n  // Then check global\n  if (ctx.globalPredefinedStates[stateKey]) {\n    return ctx.globalPredefinedStates[stateKey];\n  }\n\n  // Not found - emit warning\n  warnOnce(\n    `undefined-state:${stateKey}`,\n    `[Tasty] Undefined predefined state '${stateKey}'.\\n` +\n      `Define it in configure({ states: { '${stateKey}': '...' } }) or in the component's styles.`,\n  );\n\n  return null;\n}\n\n/**\n * Normalize state key by trimming whitespace and removing trailing/leading operators\n */\nexport function normalizeStateKey(stateKey: string): {\n  key: string;\n  warnings: string[];\n} {\n  const warnings: string[] = [];\n  let key = stateKey;\n\n  // Check for whitespace-only\n  if (key.trim() === '') {\n    if (key !== '') {\n      warnings.push(\n        `[Tasty] Whitespace-only state key normalized to default state ''.`,\n      );\n    }\n    return { key: '', warnings };\n  }\n\n  // Trim whitespace\n  key = key.trim();\n\n  // Remove trailing operators\n  const trailingOpMatch = key.match(/\\s*[&|^]\\s*$/);\n  if (trailingOpMatch) {\n    const originalKey = key;\n    key = key.slice(0, -trailingOpMatch[0].length).trim();\n    warnings.push(\n      `[Tasty] State key '${originalKey}' has trailing operator. Normalized to '${key}'.`,\n    );\n  }\n\n  // Remove leading operators (except !)\n  const leadingOpMatch = key.match(/^\\s*[&|^]\\s*/);\n  if (leadingOpMatch) {\n    const originalKey = key;\n    key = key.slice(leadingOpMatch[0].length).trim();\n    warnings.push(\n      `[Tasty] State key '${originalKey}' has leading operator. Normalized to '${key}'.`,\n    );\n  }\n\n  return { key, warnings };\n}\n\n/**\n * Expand dimension shorthands in a condition string\n * w -> width, h -> height, is -> inline-size, bs -> block-size\n */\nexport function expandDimensionShorthands(condition: string): string {\n  // Replace dimension shorthands (only when they appear as standalone words)\n  let result = condition;\n\n  // w -> width (but not part of other words)\n  result = result.replace(/\\bw\\b/g, 'width');\n\n  // h -> height\n  result = result.replace(/\\bh\\b/g, 'height');\n\n  // is -> inline-size\n  result = result.replace(/\\bis\\b/g, 'inline-size');\n\n  // bs -> block-size\n  result = result.replace(/\\bbs\\b/g, 'block-size');\n\n  return result;\n}\n\n/**\n * Convert tasty units in a string (e.g., 40x -> calc(var(--gap) * 40))\n */\nexport function expandTastyUnits(value: string): string {\n  // Match number followed by 'x' unit (tasty gap unit)\n  return value.replace(/(\\d+(?:\\.\\d+)?)\\s*x\\b/g, (_, num) => {\n    return `calc(var(--gap) * ${num})`;\n  });\n}\n\n/**\n * Parse an advanced state key and return its type and components\n */\nexport function parseAdvancedState(\n  stateKey: string,\n  ctx: StateParserContext,\n): ParsedAdvancedState {\n  const raw = stateKey;\n\n  // Check for @starting (exact match)\n  if (stateKey === '@starting') {\n    return {\n      type: 'starting',\n      condition: '',\n      raw,\n    };\n  }\n\n  // Check for @media:type (e.g., @media:print)\n  if (stateKey.startsWith('@media:')) {\n    const mediaType = stateKey.slice(7); // Remove '@media:'\n    if (!['all', 'screen', 'print', 'speech'].includes(mediaType)) {\n      warnOnce(\n        `unknown-media-type:${mediaType}`,\n        `[Tasty] Unknown media type '${mediaType}'. Valid types: all, screen, print, speech.`,\n      );\n    }\n    return {\n      type: 'media',\n      condition: '',\n      mediaType,\n      raw,\n    };\n  }\n\n  // Check for @media(...) - media query with condition\n  if (stateKey.startsWith('@media(')) {\n    const endParen = findMatchingParen(stateKey, 6);\n    if (endParen === -1) {\n      warnOnce(\n        `unclosed-media:${stateKey}`,\n        `[Tasty] Unclosed media query '${stateKey}'. Missing closing parenthesis.`,\n      );\n      return { type: 'modifier', condition: stateKey, raw };\n    }\n\n    let condition = stateKey.slice(7, endParen);\n\n    // Check for empty condition\n    if (!condition.trim()) {\n      warnOnce(\n        `empty-media:${stateKey}`,\n        `[Tasty] Empty media query condition '${stateKey}'.`,\n      );\n      return { type: 'modifier', condition: stateKey, raw };\n    }\n\n    // Expand shorthands and units\n    condition = expandDimensionShorthands(condition);\n    condition = expandTastyUnits(condition);\n\n    return {\n      type: 'media',\n      condition,\n      raw,\n    };\n  }\n\n  // Check for @root(...) - root state\n  if (stateKey.startsWith('@root(')) {\n    const endParen = findMatchingParen(stateKey, 5);\n    if (endParen === -1) {\n      warnOnce(\n        `unclosed-root:${stateKey}`,\n        `[Tasty] Unclosed root state '${stateKey}'. Missing closing parenthesis.`,\n      );\n      return { type: 'modifier', condition: stateKey, raw };\n    }\n\n    const condition = stateKey.slice(6, endParen);\n\n    if (!condition.trim()) {\n      warnOnce(\n        `empty-root:${stateKey}`,\n        `[Tasty] Empty root state condition '${stateKey}'.`,\n      );\n      return { type: 'modifier', condition: stateKey, raw };\n    }\n\n    return {\n      type: 'root',\n      condition,\n      raw,\n    };\n  }\n\n  // Check for @parent(...) - parent element state\n  if (stateKey.startsWith('@parent(')) {\n    const endParen = findMatchingParen(stateKey, 7);\n    if (endParen === -1) {\n      warnOnce(\n        `unclosed-parent:${stateKey}`,\n        `[Tasty] Unclosed parent state '${stateKey}'. Missing closing parenthesis.`,\n      );\n      return { type: 'modifier', condition: stateKey, raw };\n    }\n\n    const condition = stateKey.slice(8, endParen);\n\n    if (!condition.trim()) {\n      warnOnce(\n        `empty-parent:${stateKey}`,\n        `[Tasty] Empty parent state condition '${stateKey}'.`,\n      );\n      return { type: 'modifier', condition: stateKey, raw };\n    }\n\n    return {\n      type: 'parent',\n      condition,\n      raw,\n    };\n  }\n\n  // Check for @own(...) - sub-element own state\n  if (stateKey.startsWith('@own(')) {\n    const endParen = findMatchingParen(stateKey, 4);\n    if (endParen === -1) {\n      warnOnce(\n        `unclosed-own:${stateKey}`,\n        `[Tasty] Unclosed own state '${stateKey}'. Missing closing parenthesis.`,\n      );\n      return { type: 'modifier', condition: stateKey, raw };\n    }\n\n    const condition = stateKey.slice(5, endParen);\n\n    if (!condition.trim()) {\n      warnOnce(\n        `empty-own:${stateKey}`,\n        `[Tasty] Empty own state condition '${stateKey}'.`,\n      );\n      return { type: 'modifier', condition: stateKey, raw };\n    }\n\n    // Check if used outside sub-element context\n    if (!ctx.isSubElement) {\n      warnOnce(\n        `own-outside-subelement:${stateKey}`,\n        `[Tasty] @own(${condition}) used outside sub-element context.\\n` +\n          `@own() is equivalent to '${condition}' at the root level. ` +\n          `Did you mean to use it inside a sub-element?`,\n      );\n      // Treat as regular modifier\n      return {\n        type: 'modifier',\n        condition,\n        raw,\n      };\n    }\n\n    return {\n      type: 'own',\n      condition,\n      raw,\n    };\n  }\n\n  // Check for @(...) - container query (unnamed or named)\n  if (stateKey.startsWith('@(')) {\n    const endParen = findMatchingParen(stateKey, 1);\n    if (endParen === -1) {\n      warnOnce(\n        `unclosed-container:${stateKey}`,\n        `[Tasty] Unclosed container query '${stateKey}'. Missing closing parenthesis.`,\n      );\n      return { type: 'modifier', condition: stateKey, raw };\n    }\n\n    const content = stateKey.slice(2, endParen);\n\n    if (!content.trim()) {\n      warnOnce(\n        `empty-container:${stateKey}`,\n        `[Tasty] Empty container query '${stateKey}'.`,\n      );\n      return { type: 'modifier', condition: stateKey, raw };\n    }\n\n    // Check if named container (first token is name, followed by comma)\n    // Use parentheses-aware comma search so inner commas (e.g., scroll-state(a, b)) are skipped\n    const commaIndex = findTopLevelComma(content);\n    let containerName: string | undefined;\n    let condition: string;\n\n    if (commaIndex !== -1) {\n      // Named container: @(layout, w < 600px)\n      containerName = content.slice(0, commaIndex).trim();\n      condition = content.slice(commaIndex + 1).trim();\n    } else {\n      // Unnamed container: @(w < 600px)\n      condition = content.trim();\n    }\n\n    // Check for style query shorthand (starts with $)\n    if (condition.startsWith('$')) {\n      // Style query: @(layout, $compact) or @(layout, $variant=compact)\n      const styleCondition = parseStyleQuery(condition);\n      if (!styleCondition) {\n        warnOnce(\n          `invalid-style-query:${stateKey}`,\n          `[Tasty] Invalid style query '${condition}' in container query.`,\n        );\n        return { type: 'modifier', condition: stateKey, raw };\n      }\n      condition = styleCondition;\n    } else if (/^[a-zA-Z][\\w-]*\\s*\\(/.test(condition)) {\n      // Function-like syntax: scroll-state(...), style(...), etc.\n      // Pass through verbatim — no dimension expansion needed\n    } else {\n      // Dimension query - expand shorthands and units\n      condition = expandDimensionShorthands(condition);\n      condition = expandTastyUnits(condition);\n    }\n\n    return {\n      type: 'container',\n      condition,\n      containerName,\n      raw,\n    };\n  }\n\n  // Check for predefined state reference\n  if (isPredefinedStateRef(stateKey)) {\n    const resolved = resolvePredefinedState(stateKey, ctx);\n    if (resolved) {\n      // Recursively parse the resolved value to extract the actual state type\n      // (e.g., @mobile -> @media(w < 768px) should become a media state)\n      const parsedResolved = parseAdvancedState(resolved, ctx);\n      return {\n        ...parsedResolved,\n        raw, // Keep original raw for traceability\n      };\n    }\n    // If not resolved, treat as modifier (will likely produce invalid CSS)\n    return {\n      type: 'modifier',\n      condition: stateKey,\n      raw,\n    };\n  }\n\n  // Regular modifier (boolean mod, pseudo-class, class, attribute)\n  return {\n    type: 'modifier',\n    condition: stateKey,\n    raw,\n  };\n}\n\n/**\n * Parse a style query condition (e.g., $compact, $variant=compact, $variant=\"very compact\")\n */\nfunction parseStyleQuery(condition: string): string | null {\n  // Remove $ prefix\n  const query = condition.slice(1);\n\n  // Check for comparison operators (not supported)\n  if (/[<>]/.test(query)) {\n    warnOnce(\n      `style-query-comparison:${condition}`,\n      `[Tasty] Style queries only support equality. '${condition}' is invalid. Use '${condition.split(/[<>]/)[0]}=...' instead.`,\n    );\n    return null;\n  }\n\n  // Check for equality\n  const eqIndex = query.indexOf('=');\n  if (eqIndex === -1) {\n    // Just existence check: style(--compact)\n    return `style(--${query})`;\n  }\n\n  const propName = query.slice(0, eqIndex).trim();\n  let value = query.slice(eqIndex + 1).trim();\n\n  // Handle quoted values\n  if (\n    (value.startsWith('\"') && value.endsWith('\"')) ||\n    (value.startsWith(\"'\") && value.endsWith(\"'\"))\n  ) {\n    // Keep quotes for CSS\n  } else {\n    // Add quotes if needed\n    value = `\"${value}\"`;\n  }\n\n  // Expand tasty units in value\n  value = expandTastyUnits(value);\n\n  return `style(--${propName}: ${value})`;\n}\n\n/**\n * Find the index of the first comma at parentheses depth 0.\n * Returns -1 if no top-level comma is found.\n * This prevents splitting on commas inside function calls like scroll-state(a, b).\n */\nexport function findTopLevelComma(s: string): number {\n  let depth = 0;\n\n  for (let i = 0; i < s.length; i++) {\n    if (s[i] === '(') depth++;\n    else if (s[i] === ')') depth--;\n    else if (s[i] === ',' && depth === 0) return i;\n  }\n\n  return -1;\n}\n\nfunction findMatchingParen(str: string, startIndex: number): number {\n  let depth = 1;\n  let i = startIndex + 1;\n\n  while (i < str.length && depth > 0) {\n    if (str[i] === '(') depth++;\n    else if (str[i] === ')') depth--;\n    i++;\n  }\n\n  return depth === 0 ? i - 1 : -1;\n}\n\n/**\n * Check if a state key is an advanced state (starts with @)\n */\nexport function isAdvancedState(stateKey: string): boolean {\n  return stateKey.startsWith('@') || stateKey.startsWith('!@');\n}\n\n/**\n * Detect the type of advanced state from a raw state key\n */\nexport function detectAdvancedStateType(\n  stateKey: string,\n): ParsedAdvancedState['type'] {\n  // Handle negation prefix\n  const key = stateKey.startsWith('!') ? stateKey.slice(1) : stateKey;\n\n  if (key === '@starting') return 'starting';\n  if (key.startsWith('@media')) return 'media';\n  if (key.startsWith('@root(')) return 'root';\n  if (key.startsWith('@parent(')) return 'parent';\n  if (key.startsWith('@own(')) return 'own';\n  if (key.startsWith('@(')) return 'container';\n  if (isPredefinedStateRef(key)) return 'predefined';\n  return 'modifier';\n}\n"],"mappings":"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"}