@tenphi/tasty 0.0.0-snapshot.1d29633 → 0.0.0-snapshot.1f1c00a

package/dist/ssr/index.d.ts

@@ -1,29 +1,28 @@
-import { n as createServerStyleCollector, t as ServerStyleCollector } from "../collector-BFuqdF2F.js";
-
+import { i as ServerStyleArtifactKind, n as createServerStyleCollector, r as ServerStyleArtifact, t as ServerStyleCollector } from "../collector-w4mBj5gd.js";
 //#region src/ssr/async-storage.d.ts
 /**
  * Run a function with a ServerStyleCollector bound to the current
  * async context. All useStyles() calls within `fn` (and any async
  * continuations) will find this collector via getSSRCollector().
  */
-declare function runWithCollector<T>(collector: ServerStyleCollector, fn: () => T): T;
+export declare function runWithCollector<T>(collector: ServerStyleCollector, fn: () => T): T;
 /**
  * Retrieve the ServerStyleCollector bound to the current async context.
  * Returns null when called outside of runWithCollector() or on the client.
  */
-declare function getSSRCollector(): ServerStyleCollector | null;
+export declare function getSSRCollector(): ServerStyleCollector | null;
 //#endregion
 //#region src/ssr/hydrate.d.ts
 /**
  * Client-side cache hydration for SSR/RSC.
  *
- * Pre-populates the client injector's rules map with class names
- * rendered on the server. With hash-based naming, the client derives
- * the same class name from the same cache key, so only the class name
- * list needs to cross the wire — no cache keys or counters.
+ * Registers class names rendered on the server with the client injector. If
+ * the runtime is not initialized yet, registration is deferred until its first
+ * use. With hash-based naming, only the class name list needs to cross the
+ * wire — no cache keys or counters.
  */
 /**
- * Pre-populate the client-side style registry from the server's class name list.
+ * Hydrate the client-side style registry from the server's class name list.
  *
  * Call this before ReactDOM.hydrateRoot() or ensure it runs before
  * any tasty() component renders on the client.
@@ -31,7 +30,7 @@ declare function getSSRCollector(): ServerStyleCollector | null;
  * When called without arguments, reads the class list from `window.__TASTY__`
  * (populated by inline scripts emitted during SSR/RSC streaming).
  */
-declare function hydrateTastyClasses(classes?: string[]): void;
+export declare function hydrateTastyClasses(classes?: string[]): void;
 //#endregion
-export { ServerStyleCollector, createServerStyleCollector, getSSRCollector, hydrateTastyClasses, runWithCollector };
+export { type ServerStyleArtifact, type ServerStyleArtifactKind, ServerStyleCollector, createServerStyleCollector };
 //# sourceMappingURL=index.d.ts.map

package/dist/ssr/index.js

@@ -1,7 +1,7 @@
-import { a as registerSSRCollectorGetterGlobal } from "../format-rules-Cs4e3M9m.js";
-import { n as createServerStyleCollector, t as ServerStyleCollector } from "../collector-BMT05AmU.js";
-import { n as runWithCollector, t as getSSRCollector } from "../async-storage-DKK-wTD4.js";
-import { t as hydrateTastyClasses } from "../hydrate-aaUSNJZJ.js";
+import { r as registerSSRCollectorGetterGlobal } from "../chunks/runtime-state-BxaLhVdP.js";
+import { n as createServerStyleCollector, t as ServerStyleCollector } from "../chunks/collector-D2ARGT2L.js";
+import { n as runWithCollector, t as getSSRCollector } from "../chunks/async-storage-CG5HnUT5.js";
+import { t as hydrateTastyClasses } from "../chunks/hydration-TRcz5vnk.js";
 //#region src/ssr/index.ts
 registerSSRCollectorGetterGlobal(getSSRCollector);
 //#endregion

package/dist/ssr/index.js.map

@@ -1 +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, createServerStyleCollector } from './collector';\n\n// AsyncLocalStorage integration for Astro / generic frameworks\nexport { runWithCollector, getSSRCollector } from './async-storage';\n\n// Client-side cache hydration\nexport { hydrateTastyClasses } 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":";;;;;AAwBA,iCAAiC,eAAe"}
+{"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, createServerStyleCollector } from './collector';\nexport type { ServerStyleArtifact, ServerStyleArtifactKind } from './collector';\n\n// AsyncLocalStorage integration for Astro / generic frameworks\nexport { runWithCollector, getSSRCollector } from './async-storage';\n\n// Client-side cache hydration\nexport { hydrateTastyClasses } 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,eAAe"}

package/dist/ssr/next-config.d.ts

@@ -0,0 +1,64 @@
+import { t as TastyConfig } from "../config-CZWCzBr6.js";
+//#region src/ssr/next-config.d.ts
+interface NextConfig {
+  basePath?: string;
+  env?: Record<string, string | undefined>;
+  headers?: () => Promise<NextHeader[]>;
+  output?: string;
+  [key: string]: unknown;
+}
+interface NextHeader {
+  source: string;
+  headers: {
+    key: string;
+    value: string;
+  }[];
+  [key: string]: unknown;
+}
+export interface TastyNextOptions {
+  /**
+   * Next.js project directory. Useful when the build command runs from a
+   * monorepo root rather than the app directory.
+   *
+   * @default process.cwd()
+   */
+  rootDir?: string;
+  /**
+   * Tasty configuration used to generate the shared stylesheet.
+   * `config` takes precedence when both config sources are provided.
+   */
+  config?: TastyConfig;
+  /**
+   * Project-relative path to a TypeScript/JavaScript module whose default
+   * export is a Tasty configuration object.
+   *
+   * @example './app/tasty.config.ts'
+   */
+  configFile?: string;
+  /**
+   * Filesystem directory for generated stylesheets. When it is inside the
+   * project's `public` directory, its public URL is inferred automatically.
+   *
+   * @default 'public/_tasty'
+   */
+  outputDir?: string;
+  /**
+   * Root-relative URL path corresponding to `outputDir`. This is required
+   * when `outputDir` is outside the project's `public` directory.
+   * The Next.js `basePath` is prepended automatically.
+   *
+   * @default inferred from outputDir
+   * @example '/assets/tasty'
+   */
+  publicPath?: string;
+  /** Whether to generate and register the shared stylesheet. @default true */
+  enabled?: boolean;
+}
+/**
+ * Add a cacheable, content-hashed stylesheet for Tasty configuration globals.
+ * Route-dependent component and hook styles continue to stream through
+ * `TastyRegistry` so App Router navigation and Suspense remain correct.
+ */
+export declare function withTastyNext(options: TastyNextOptions): (nextConfig?: NextConfig) => NextConfig;
+//#endregion
+//# sourceMappingURL=next-config.d.ts.map

package/dist/ssr/next-config.js

@@ -0,0 +1,128 @@
+import { L as DEFAULT_PROPERTIES, U as parseFunctionName, V as formatFunctionRule, a as formatPropertyCSS, b as formatFontFaceRule, h as formatCounterStyleRule, n as formatGlobalRules, t as createServerStyleArtifact, v as fontFaceContentHash } from "../chunks/css-definitions-DotDkIXt.js";
+import { b as renderStyles } from "../chunks/style-engine-BBbBuSkT.js";
+import { n as functionsForExtraction, r as resetZeroConfig, t as configureZero } from "../chunks/build-config-CL4eRu2z.js";
+import { t as findUnsafeCSSResource } from "../chunks/css-resources-P7IBUUZs.js";
+import { createHash } from "node:crypto";
+import { mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { createRequire } from "node:module";
+import { isAbsolute, join, relative, resolve, sep } from "node:path";
+//#region src/ssr/next-config.ts
+const ENV_KEY = "TASTY_NEXT_SHARED_CSS_HREF";
+const packageRequire = createRequire(import.meta.url);
+function loadConfig(projectDir, options) {
+	if (options.config) return options.config;
+	if (!options.configFile) throw new Error("[Tasty] withTastyNext() requires either `config` or `configFile`.");
+	const configPath = resolve(projectDir, options.configFile);
+	let jitiPath;
+	try {
+		jitiPath = packageRequire.resolve("jiti");
+	} catch (error) {
+		if (error instanceof Error && "code" in error && error.code === "MODULE_NOT_FOUND") throw new Error("[Tasty] `configFile` requires the optional `jiti` package. Install `jiti` or pass the imported config through `config` instead.", { cause: error });
+		throw error;
+	}
+	const { createJiti } = packageRequire(jitiPath);
+	const loaded = createJiti(projectDir, { moduleCache: false })(configPath);
+	return loaded && typeof loaded === "object" && "default" in loaded ? loaded.default : loaded;
+}
+function collectSharedCSS(config) {
+	resetZeroConfig();
+	try {
+		const resolved = configureZero(config);
+		const { normalized } = resolved;
+		const artifacts = [];
+		const append = (kind, key, css) => {
+			if (!css) return;
+			artifacts.push(createServerStyleArtifact(kind, key, css, artifacts.length));
+		};
+		for (const [token, definition] of Object.entries({
+			...DEFAULT_PROPERTIES,
+			...normalized.properties
+		})) append("property", `__prop:${token}`, formatPropertyCSS(token, definition));
+		for (const [family, input] of Object.entries(normalized.fontFaces)) {
+			const descriptors = Array.isArray(input) ? input : [input];
+			for (const descriptor of descriptors) append("font-face", fontFaceContentHash(family, descriptor), formatFontFaceRule(family, descriptor));
+		}
+		for (const [name, descriptors] of Object.entries(normalized.counterStyles)) append("counter-style", name, formatCounterStyleRule(name, descriptors));
+		for (const [name, definition] of Object.entries(functionsForExtraction(resolved) ?? {})) append("function", parseFunctionName(name), formatFunctionRule(name, definition));
+		if (Object.keys(normalized.tokens).length > 0) {
+			const rules = renderStyles(normalized.tokens, ":root");
+			append("global", "__global:tokens", formatGlobalRules(rules));
+		}
+		for (const [selector, styles] of Object.entries(normalized.globalStyles)) {
+			if (Object.keys(styles).length === 0) continue;
+			const rules = renderStyles(styles, selector);
+			append("global", `__global:styles:${selector}`, formatGlobalRules(rules));
+		}
+		for (const artifact of artifacts) {
+			const unsafe = findUnsafeCSSResource(artifact.css, false);
+			if (unsafe) throw new Error(`[Tasty] Next.js shared CSS extraction cannot preserve page-relative CSS URL "${unsafe.url}" in ${artifact.kind} artifact ${artifact.id}. Use an absolute URL, a data URL, or a root-relative URL such as url(/path/to/asset).`);
+		}
+		return artifacts.map(({ css }) => css).join("\n");
+	} finally {
+		resetZeroConfig();
+	}
+}
+function inferPublicPath(projectDir, outputDir) {
+	const publicDir = resolve(projectDir, "public");
+	const relativePath = relative(publicDir, outputDir);
+	if (relativePath === ".." || relativePath.startsWith(`..${sep}`) || isAbsolute(relativePath)) throw new Error("[Tasty] `publicPath` is required when `outputDir` is outside the Next.js public directory.");
+	return `/${relativePath.split(sep).filter(Boolean).join("/")}`;
+}
+function normalizeURLPath(path, option) {
+	if (!path.startsWith("/") || path.startsWith("//") || path.includes("?") || path.includes("#") || path.includes("\\")) throw new Error(`[Tasty] \`${option}\` must be a root-relative URL path.`);
+	let end = path.length;
+	while (end > 0 && path[end - 1] === "/") end--;
+	return path.slice(0, end);
+}
+function writeSharedCSS(outputDir, css) {
+	mkdirSync(outputDir, { recursive: true });
+	const filename = `tasty.shared.${createHash("sha256").update(css).digest("hex").slice(0, 12)}.css`;
+	const outputPath = join(outputDir, filename);
+	let existing;
+	try {
+		existing = readFileSync(outputPath, "utf8");
+	} catch {}
+	if (existing !== css) writeFileSync(outputPath, css);
+	return filename;
+}
+function withTastyNext(options) {
+	return (nextConfig = {}) => {
+		if (options.enabled === false) return nextConfig;
+		const projectDir = resolve(process.cwd(), options.rootDir ?? ".");
+		const outputDir = resolve(projectDir, options.outputDir ?? "public/_tasty");
+		const publicPath = normalizeURLPath(options.publicPath ?? inferPublicPath(projectDir, outputDir), "publicPath");
+		const basePath = normalizeURLPath(nextConfig.basePath || "/", "basePath");
+		const css = collectSharedCSS(loadConfig(projectDir, options));
+		if (!css) return nextConfig;
+		const filename = writeSharedCSS(outputDir, css);
+		const href = `${basePath}${publicPath}/${filename}`;
+		const headerSource = `${publicPath}/${filename}`;
+		const existingEnv = nextConfig.env ?? {};
+		const existingHeaders = nextConfig.headers;
+		if (existingEnv[ENV_KEY] && existingEnv[ENV_KEY] !== href) throw new Error(`[Tasty] Next.js env key ${ENV_KEY} is reserved by withTastyNext().`);
+		const generatedConfig = {
+			...nextConfig,
+			env: {
+				...existingEnv,
+				[ENV_KEY]: href
+			}
+		};
+		if (nextConfig.output === "export") return generatedConfig;
+		return {
+			...generatedConfig,
+			async headers() {
+				return [...existingHeaders ? await existingHeaders() : [], {
+					source: headerSource,
+					headers: [{
+						key: "Cache-Control",
+						value: "public, max-age=31536000, immutable"
+					}]
+				}];
+			}
+		};
+	};
+}
+//#endregion
+export { withTastyNext };
+
+//# sourceMappingURL=next-config.js.map

package/dist/ssr/next-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"next-config.js","names":[],"sources":["../../src/ssr/next-config.ts"],"sourcesContent":["/**\n * Next.js configuration wrapper for extracting Tasty's configured global CSS.\n *\n * Import this Node-only module from `next.config.ts`. The client-safe registry\n * remains available from `@tenphi/tasty/ssr/next`.\n */\n\nimport { createHash } from 'node:crypto';\nimport { mkdirSync, readFileSync, writeFileSync } from 'node:fs';\nimport { createRequire } from 'node:module';\nimport { isAbsolute, join, relative, resolve, sep } from 'node:path';\nimport type { createJiti as createJitiType } from 'jiti';\n\nimport type { TastyConfig } 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 { DEFAULT_PROPERTIES } from '../properties/defaults';\nimport {\n  configureZero,\n  functionsForExtraction,\n  resetZeroConfig,\n} from '../zero/config';\nimport { createServerStyleArtifact } from './artifacts';\nimport type { ServerStyleArtifact, ServerStyleArtifactKind } from './artifacts';\nimport { findUnsafeCSSResource } from './css-resources';\nimport { formatGlobalRules } from './format-global-rules';\nimport { formatPropertyCSS } from './format-property';\n\nconst ENV_KEY = 'TASTY_NEXT_SHARED_CSS_HREF';\nconst packageRequire = createRequire(import.meta.url);\n\ninterface NextConfig {\n  basePath?: string;\n  env?: Record<string, string | undefined>;\n  headers?: () => Promise<NextHeader[]>;\n  output?: string;\n  [key: string]: unknown;\n}\n\ninterface NextHeader {\n  source: string;\n  headers: { key: string; value: string }[];\n  [key: string]: unknown;\n}\n\nexport interface TastyNextOptions {\n  /**\n   * Next.js project directory. Useful when the build command runs from a\n   * monorepo root rather than the app directory.\n   *\n   * @default process.cwd()\n   */\n  rootDir?: string;\n\n  /**\n   * Tasty configuration used to generate the shared stylesheet.\n   * `config` takes precedence when both config sources are provided.\n   */\n  config?: TastyConfig;\n\n  /**\n   * Project-relative path to a TypeScript/JavaScript module whose default\n   * export is a Tasty configuration object.\n   *\n   * @example './app/tasty.config.ts'\n   */\n  configFile?: string;\n\n  /**\n   * Filesystem directory for generated stylesheets. When it is inside the\n   * project's `public` directory, its public URL is inferred automatically.\n   *\n   * @default 'public/_tasty'\n   */\n  outputDir?: string;\n\n  /**\n   * Root-relative URL path corresponding to `outputDir`. This is required\n   * when `outputDir` is outside the project's `public` directory.\n   * The Next.js `basePath` is prepended automatically.\n   *\n   * @default inferred from outputDir\n   * @example '/assets/tasty'\n   */\n  publicPath?: string;\n\n  /** Whether to generate and register the shared stylesheet. @default true */\n  enabled?: boolean;\n}\n\nfunction loadConfig(\n  projectDir: string,\n  options: TastyNextOptions,\n): TastyConfig {\n  if (options.config) return options.config;\n  if (!options.configFile) {\n    throw new Error(\n      '[Tasty] withTastyNext() requires either `config` or `configFile`.',\n    );\n  }\n\n  const configPath = resolve(projectDir, options.configFile);\n  let jitiPath: string;\n  try {\n    jitiPath = packageRequire.resolve('jiti');\n  } catch (error) {\n    if (\n      error instanceof Error &&\n      'code' in error &&\n      error.code === 'MODULE_NOT_FOUND'\n    ) {\n      throw new Error(\n        '[Tasty] `configFile` requires the optional `jiti` package. Install `jiti` or pass the imported config through `config` instead.',\n        { cause: error },\n      );\n    }\n    throw error;\n  }\n  const { createJiti } = packageRequire(jitiPath) as {\n    createJiti: typeof createJitiType;\n  };\n  const jiti = createJiti(projectDir, { moduleCache: false });\n  const loaded = jiti(configPath) as TastyConfig | { default: TastyConfig };\n\n  return loaded && typeof loaded === 'object' && 'default' in loaded\n    ? loaded.default\n    : loaded;\n}\n\nfunction collectSharedCSS(config: TastyConfig): string {\n  resetZeroConfig();\n  try {\n    const resolved = configureZero(config);\n    const { normalized } = resolved;\n    const artifacts: ServerStyleArtifact[] = [];\n    const append = (\n      kind: ServerStyleArtifactKind,\n      key: string,\n      css: string,\n    ) => {\n      if (!css) return;\n\n      artifacts.push(\n        createServerStyleArtifact(kind, key, css, artifacts.length),\n      );\n    };\n\n    for (const [token, definition] of Object.entries({\n      ...DEFAULT_PROPERTIES,\n      ...normalized.properties,\n    })) {\n      append(\n        'property',\n        `__prop:${token}`,\n        formatPropertyCSS(token, definition),\n      );\n    }\n\n    for (const [family, input] of Object.entries(normalized.fontFaces)) {\n      const descriptors = Array.isArray(input) ? input : [input];\n      for (const descriptor of descriptors) {\n        append(\n          'font-face',\n          fontFaceContentHash(family, descriptor),\n          formatFontFaceRule(family, descriptor),\n        );\n      }\n    }\n\n    for (const [name, descriptors] of Object.entries(\n      normalized.counterStyles,\n    )) {\n      append('counter-style', name, formatCounterStyleRule(name, descriptors));\n    }\n\n    for (const [name, definition] of Object.entries(\n      functionsForExtraction(resolved) ?? {},\n    )) {\n      append(\n        'function',\n        parseFunctionName(name),\n        formatFunctionRule(name, definition),\n      );\n    }\n\n    if (Object.keys(normalized.tokens).length > 0) {\n      const rules = renderStyles(normalized.tokens, ':root') as StyleResult[];\n      append('global', '__global:tokens', formatGlobalRules(rules));\n    }\n\n    for (const [selector, styles] of Object.entries(normalized.globalStyles)) {\n      if (Object.keys(styles).length === 0) continue;\n      const rules = renderStyles(styles, selector) as StyleResult[];\n      append('global', `__global:styles:${selector}`, formatGlobalRules(rules));\n    }\n\n    for (const artifact of artifacts) {\n      const unsafe = findUnsafeCSSResource(artifact.css, false);\n      if (unsafe) {\n        throw new Error(\n          `[Tasty] Next.js shared CSS extraction cannot preserve page-relative CSS URL \"${unsafe.url}\" in ${artifact.kind} artifact ${artifact.id}. Use an absolute URL, a data URL, or a root-relative URL such as url(/path/to/asset).`,\n        );\n      }\n    }\n\n    return artifacts.map(({ css }) => css).join('\\n');\n  } finally {\n    resetZeroConfig();\n  }\n}\n\nfunction inferPublicPath(projectDir: string, outputDir: string): string {\n  const publicDir = resolve(projectDir, 'public');\n  const relativePath = relative(publicDir, outputDir);\n  if (\n    relativePath === '..' ||\n    relativePath.startsWith(`..${sep}`) ||\n    isAbsolute(relativePath)\n  ) {\n    throw new Error(\n      '[Tasty] `publicPath` is required when `outputDir` is outside the Next.js public directory.',\n    );\n  }\n\n  return `/${relativePath.split(sep).filter(Boolean).join('/')}`;\n}\n\nfunction normalizeURLPath(path: string, option: string): string {\n  if (\n    !path.startsWith('/') ||\n    path.startsWith('//') ||\n    path.includes('?') ||\n    path.includes('#') ||\n    path.includes('\\\\')\n  ) {\n    throw new Error(`[Tasty] \\`${option}\\` must be a root-relative URL path.`);\n  }\n\n  let end = path.length;\n  while (end > 0 && path[end - 1] === '/') end--;\n  return path.slice(0, end);\n}\n\nfunction writeSharedCSS(outputDir: string, css: string): string {\n  mkdirSync(outputDir, { recursive: true });\n  const hash = createHash('sha256').update(css).digest('hex').slice(0, 12);\n  const filename = `tasty.shared.${hash}.css`;\n\n  const outputPath = join(outputDir, filename);\n  let existing: string | undefined;\n  try {\n    existing = readFileSync(outputPath, 'utf8');\n  } catch {\n    // The file does not exist yet (or is unreadable); write it below.\n  }\n  if (existing !== css) writeFileSync(outputPath, css);\n\n  return filename;\n}\n\n/**\n * Add a cacheable, content-hashed stylesheet for Tasty configuration globals.\n * Route-dependent component and hook styles continue to stream through\n * `TastyRegistry` so App Router navigation and Suspense remain correct.\n */\nexport function withTastyNext(options: TastyNextOptions) {\n  return (nextConfig: NextConfig = {}): NextConfig => {\n    if (options.enabled === false) return nextConfig;\n\n    const projectDir = resolve(process.cwd(), options.rootDir ?? '.');\n    const outputDir = resolve(projectDir, options.outputDir ?? 'public/_tasty');\n    const publicPath = normalizeURLPath(\n      options.publicPath ?? inferPublicPath(projectDir, outputDir),\n      'publicPath',\n    );\n    const basePath = normalizeURLPath(nextConfig.basePath || '/', 'basePath');\n    const css = collectSharedCSS(loadConfig(projectDir, options));\n\n    if (!css) return nextConfig;\n\n    const filename = writeSharedCSS(outputDir, css);\n    const href = `${basePath}${publicPath}/${filename}`;\n    const headerSource = `${publicPath}/${filename}`;\n    const existingEnv = nextConfig.env ?? {};\n    const existingHeaders = nextConfig.headers;\n    if (existingEnv[ENV_KEY] && existingEnv[ENV_KEY] !== href) {\n      throw new Error(\n        `[Tasty] Next.js env key ${ENV_KEY} is reserved by withTastyNext().`,\n      );\n    }\n\n    const generatedConfig: NextConfig = {\n      ...nextConfig,\n      env: {\n        ...existingEnv,\n        [ENV_KEY]: href,\n      },\n    };\n\n    // `headers()` is not emitted by Next's static export. Avoid introducing an\n    // unsupported-config warning; the content hash still makes the asset safe\n    // for the static host to cache immutably.\n    if (nextConfig.output === 'export') return generatedConfig;\n\n    return {\n      ...generatedConfig,\n      async headers() {\n        const headers = existingHeaders ? await existingHeaders() : [];\n        return [\n          ...headers,\n          {\n            source: headerSource,\n            headers: [\n              {\n                key: 'Cache-Control',\n                value: 'public, max-age=31536000, immutable',\n              },\n            ],\n          },\n        ];\n      },\n    };\n  };\n}\n"],"mappings":";;;;;;;;;AA+BA,MAAM,UAAU;AAChB,MAAM,iBAAiB,cAAc,YAAY,GAAG;AA6DpD,SAAS,WACP,YACA,SACa;CACb,IAAI,QAAQ,QAAQ,OAAO,QAAQ;CACnC,IAAI,CAAC,QAAQ,YACX,MAAM,IAAI,MACR,mEACF;CAGF,MAAM,aAAa,QAAQ,YAAY,QAAQ,UAAU;CACzD,IAAI;CACJ,IAAI;EACF,WAAW,eAAe,QAAQ,MAAM;CAC1C,SAAS,OAAO;EACd,IACE,iBAAiB,SACjB,UAAU,SACV,MAAM,SAAS,oBAEf,MAAM,IAAI,MACR,mIACA,EAAE,OAAO,MAAM,CACjB;EAEF,MAAM;CACR;CACA,MAAM,EAAE,eAAe,eAAe,QAAQ;CAI9C,MAAM,SADO,WAAW,YAAY,EAAE,aAAa,MAAM,CACvC,CAAC,CAAC,UAAU;CAE9B,OAAO,UAAU,OAAO,WAAW,YAAY,aAAa,SACxD,OAAO,UACP;AACN;AAEA,SAAS,iBAAiB,QAA6B;CACrD,gBAAgB;CAChB,IAAI;EACF,MAAM,WAAW,cAAc,MAAM;EACrC,MAAM,EAAE,eAAe;EACvB,MAAM,YAAmC,CAAC;EAC1C,MAAM,UACJ,MACA,KACA,QACG;GACH,IAAI,CAAC,KAAK;GAEV,UAAU,KACR,0BAA0B,MAAM,KAAK,KAAK,UAAU,MAAM,CAC5D;EACF;EAEA,KAAK,MAAM,CAAC,OAAO,eAAe,OAAO,QAAQ;GAC/C,GAAG;GACH,GAAG,WAAW;EAChB,CAAC,GACC,OACE,YACA,UAAU,SACV,kBAAkB,OAAO,UAAU,CACrC;EAGF,KAAK,MAAM,CAAC,QAAQ,UAAU,OAAO,QAAQ,WAAW,SAAS,GAAG;GAClE,MAAM,cAAc,MAAM,QAAQ,KAAK,IAAI,QAAQ,CAAC,KAAK;GACzD,KAAK,MAAM,cAAc,aACvB,OACE,aACA,oBAAoB,QAAQ,UAAU,GACtC,mBAAmB,QAAQ,UAAU,CACvC;EAEJ;EAEA,KAAK,MAAM,CAAC,MAAM,gBAAgB,OAAO,QACvC,WAAW,aACb,GACE,OAAO,iBAAiB,MAAM,uBAAuB,MAAM,WAAW,CAAC;EAGzE,KAAK,MAAM,CAAC,MAAM,eAAe,OAAO,QACtC,uBAAuB,QAAQ,KAAK,CAAC,CACvC,GACE,OACE,YACA,kBAAkB,IAAI,GACtB,mBAAmB,MAAM,UAAU,CACrC;EAGF,IAAI,OAAO,KAAK,WAAW,MAAM,CAAC,CAAC,SAAS,GAAG;GAC7C,MAAM,QAAQ,aAAa,WAAW,QAAQ,OAAO;GACrD,OAAO,UAAU,mBAAmB,kBAAkB,KAAK,CAAC;EAC9D;EAEA,KAAK,MAAM,CAAC,UAAU,WAAW,OAAO,QAAQ,WAAW,YAAY,GAAG;GACxE,IAAI,OAAO,KAAK,MAAM,CAAC,CAAC,WAAW,GAAG;GACtC,MAAM,QAAQ,aAAa,QAAQ,QAAQ;GAC3C,OAAO,UAAU,mBAAmB,YAAY,kBAAkB,KAAK,CAAC;EAC1E;EAEA,KAAK,MAAM,YAAY,WAAW;GAChC,MAAM,SAAS,sBAAsB,SAAS,KAAK,KAAK;GACxD,IAAI,QACF,MAAM,IAAI,MACR,gFAAgF,OAAO,IAAI,OAAO,SAAS,KAAK,YAAY,SAAS,GAAG,uFAC1I;EAEJ;EAEA,OAAO,UAAU,KAAK,EAAE,UAAU,GAAG,CAAC,CAAC,KAAK,IAAI;CAClD,UAAU;EACR,gBAAgB;CAClB;AACF;AAEA,SAAS,gBAAgB,YAAoB,WAA2B;CACtE,MAAM,YAAY,QAAQ,YAAY,QAAQ;CAC9C,MAAM,eAAe,SAAS,WAAW,SAAS;CAClD,IACE,iBAAiB,QACjB,aAAa,WAAW,KAAK,KAAK,KAClC,WAAW,YAAY,GAEvB,MAAM,IAAI,MACR,4FACF;CAGF,OAAO,IAAI,aAAa,MAAM,GAAG,CAAC,CAAC,OAAO,OAAO,CAAC,CAAC,KAAK,GAAG;AAC7D;AAEA,SAAS,iBAAiB,MAAc,QAAwB;CAC9D,IACE,CAAC,KAAK,WAAW,GAAG,KACpB,KAAK,WAAW,IAAI,KACpB,KAAK,SAAS,GAAG,KACjB,KAAK,SAAS,GAAG,KACjB,KAAK,SAAS,IAAI,GAElB,MAAM,IAAI,MAAM,aAAa,OAAO,qCAAqC;CAG3E,IAAI,MAAM,KAAK;CACf,OAAO,MAAM,KAAK,KAAK,MAAM,OAAO,KAAK;CACzC,OAAO,KAAK,MAAM,GAAG,GAAG;AAC1B;AAEA,SAAS,eAAe,WAAmB,KAAqB;CAC9D,UAAU,WAAW,EAAE,WAAW,KAAK,CAAC;CAExC,MAAM,WAAW,gBADJ,WAAW,QAAQ,CAAC,CAAC,OAAO,GAAG,CAAC,CAAC,OAAO,KAAK,CAAC,CAAC,MAAM,GAAG,EACjC,EAAE;CAEtC,MAAM,aAAa,KAAK,WAAW,QAAQ;CAC3C,IAAI;CACJ,IAAI;EACF,WAAW,aAAa,YAAY,MAAM;CAC5C,QAAQ,CAER;CACA,IAAI,aAAa,KAAK,cAAc,YAAY,GAAG;CAEnD,OAAO;AACT;AAOA,SAAgB,cAAc,SAA2B;CACvD,QAAQ,aAAyB,CAAC,MAAkB;EAClD,IAAI,QAAQ,YAAY,OAAO,OAAO;EAEtC,MAAM,aAAa,QAAQ,QAAQ,IAAI,GAAG,QAAQ,WAAW,GAAG;EAChE,MAAM,YAAY,QAAQ,YAAY,QAAQ,aAAa,eAAe;EAC1E,MAAM,aAAa,iBACjB,QAAQ,cAAc,gBAAgB,YAAY,SAAS,GAC3D,YACF;EACA,MAAM,WAAW,iBAAiB,WAAW,YAAY,KAAK,UAAU;EACxE,MAAM,MAAM,iBAAiB,WAAW,YAAY,OAAO,CAAC;EAE5D,IAAI,CAAC,KAAK,OAAO;EAEjB,MAAM,WAAW,eAAe,WAAW,GAAG;EAC9C,MAAM,OAAO,GAAG,WAAW,WAAW,GAAG;EACzC,MAAM,eAAe,GAAG,WAAW,GAAG;EACtC,MAAM,cAAc,WAAW,OAAO,CAAC;EACvC,MAAM,kBAAkB,WAAW;EACnC,IAAI,YAAY,YAAY,YAAY,aAAa,MACnD,MAAM,IAAI,MACR,2BAA2B,QAAQ,iCACrC;EAGF,MAAM,kBAA8B;GAClC,GAAG;GACH,KAAK;IACH,GAAG;KACF,UAAU;GACb;EACF;EAKA,IAAI,WAAW,WAAW,UAAU,OAAO;EAE3C,OAAO;GACL,GAAG;GACH,MAAM,UAAU;IAEd,OAAO,CACL,GAFc,kBAAkB,MAAM,gBAAgB,IAAI,CAAC,GAG3D;KACE,QAAQ;KACR,SAAS,CACP;MACE,KAAK;MACL,OAAO;KACT,CACF;IACF,CACF;GACF;EACF;CACF;AACF"}

package/dist/ssr/next.d.ts

@@ -1,8 +1,7 @@
-import { t as ServerStyleCollector } from "../collector-BFuqdF2F.js";
+import { t as ServerStyleCollector } from "../collector-w4mBj5gd.js";
 import { ReactNode } from "react";
-
 //#region src/ssr/next.d.ts
-interface TastyRegistryProps {
+export interface TastyRegistryProps {
   children: ReactNode;
   /**
    * Whether to embed the class-list script for client hydration.
@@ -11,6 +10,12 @@ interface TastyRegistryProps {
    * in server-rendered `<style>` tags. Default: true.
    */
   transferCache?: boolean;
+  /**
+   * URL of a stylesheet containing Tasty's configured global CSS.
+   * `withTastyNext()` sets this automatically. Pass false to disable it for
+   * this registry, or a URL to use a manually generated stylesheet.
+   */
+  sharedStylesheet?: string | false;
 }
 /**
  * Next.js App Router registry for Tasty SSR.
@@ -36,10 +41,6 @@ interface TastyRegistryProps {
  * }
  * ```
  */
-declare function TastyRegistry({
-  children,
-  transferCache
-}: TastyRegistryProps): import("react").FunctionComponentElement<import("react").ProviderProps<ServerStyleCollector | null>>;
+export declare function TastyRegistry({ children, transferCache, sharedStylesheet }: TastyRegistryProps): import("react").FunctionComponentElement<import("react").ProviderProps<ServerStyleCollector | null>>;
 //#endregion
-export { TastyRegistry, TastyRegistryProps };
 //# sourceMappingURL=next.d.ts.map

package/dist/ssr/next.js

@@ -1,70 +1,56 @@
 "use client";
-import { n as getConfig } from "../config-DF93rL3u.js";
-import { i as registerSSRCollectorGetter } from "../format-rules-Cs4e3M9m.js";
-import { t as getTastySSRContext } from "../context-CA8YKeMn.js";
-import { t as ServerStyleCollector } from "../collector-BMT05AmU.js";
-import { t as hydrateTastyClasses } from "../hydrate-aaUSNJZJ.js";
+import { n as registerSSRCollectorGetter, u as getRuntimeConfigState } from "../chunks/runtime-state-BxaLhVdP.js";
+import { u as getTastySSRContext } from "../chunks/react-runtime-BpxlOTbO.js";
+import { t as ServerStyleCollector } from "../chunks/collector-D2ARGT2L.js";
+import { t as hydrateTastyClasses } from "../chunks/hydration-TRcz5vnk.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).
-*
-* Import from '@tenphi/tasty/ssr/next'.
-*/
 if (typeof window !== "undefined") hydrateTastyClasses();
-/**
-* 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 }) {
+function TastyRegistry({ children, transferCache = true, sharedStylesheet = process.env.TASTY_NEXT_SHARED_CSS_HREF }) {
 	const isClient = typeof window !== "undefined";
 	const [collector] = useState(() => {
 		if (isClient) return null;
 		const instance = new ServerStyleCollector();
 		registerSSRCollectorGetter(() => instance);
+		if (sharedStylesheet) {
+			instance.collectInternals();
+			instance.flushCSS();
+		}
 		return instance;
 	});
-	const nonce = getConfig().nonce;
+	const [streamState] = useState(() => ({ sharedStylesheetFlushed: false }));
+	const nonce = getRuntimeConfigState()?.nonce;
 	useServerInsertedHTML(() => {
 		if (!collector) return null;
 		const css = collector.flushCSS();
 		const classNames = collector.getRenderedClassNames();
-		if (!css) return null;
+		let linkEl = null;
+		if (sharedStylesheet && !streamState.sharedStylesheetFlushed) {
+			streamState.sharedStylesheetFlushed = true;
+			linkEl = createElement("link", {
+				key: "tasty-shared-styles",
+				rel: "stylesheet",
+				href: sharedStylesheet,
+				"data-tasty-ssr": "",
+				nonce
+			});
+		}
+		if (!css) return linkEl;
 		const styleEl = createElement("style", {
 			key: "tasty-ssr-styles",
 			"data-tasty-ssr": "",
 			nonce,
 			dangerouslySetInnerHTML: { __html: css }
 		});
-		if (!transferCache || classNames.length === 0) return styleEl;
-		return createElement(Fragment, null, styleEl, createElement("script", {
+		if (!transferCache || classNames.length === 0) return linkEl ? createElement(Fragment, null, linkEl, styleEl) : styleEl;
+		const classListJSON = classNames.map((n) => `"${n}"`).join(",");
+		const scriptEl = createElement("script", {
 			key: "tasty-ssr-cache",
 			nonce,
-			dangerouslySetInnerHTML: { __html: `(window.__TASTY__=window.__TASTY__||[]).push(${classNames.map((n) => `"${n}"`).join(",")})` }
-		}));
+			dangerouslySetInnerHTML: { __html: `(window.__TASTY__=window.__TASTY__||[]).push(${classListJSON})` }
+		});
+		return createElement(Fragment, null, linkEl, styleEl, scriptEl);
 	});
 	return createElement(getTastySSRContext().Provider, { value: collector }, children);
 }

package/dist/ssr/next.js.map

@@ -1 +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 *\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 { getTastySSRContext } from './context';\nimport { hydrateTastyClasses } from './hydrate';\nimport { registerSSRCollectorGetter } from './ssr-collector-ref';\n\n// Auto-hydrate on module load (client only).\n// Reads the class name list from `window.__TASTY__` populated by streaming scripts.\nif (typeof window !== 'undefined') {\n  hydrateTastyClasses();\n}\n\nexport interface TastyRegistryProps {\n  children: ReactNode;\n  /**\n   * Whether to embed the class-list script for client hydration.\n   * Set to false to skip class transfer (e.g. for CSP restrictions).\n   * Without it, client components may re-inject CSS that already exists\n   * in server-rendered `<style>` tags. 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 classNames = collector.getRenderedClassNames();\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 || classNames.length === 0) return styleEl;\n\n    const classListJSON = classNames.map((n) => `\"${n}\"`).join(',');\n\n    const scriptEl = createElement('script', {\n      key: 'tasty-ssr-cache',\n      nonce,\n      dangerouslySetInnerHTML: {\n        __html: `(window.__TASTY__=window.__TASTY__||[]).push(${classListJSON})`,\n      },\n    });\n\n    return createElement(Fragment, null, styleEl, scriptEl);\n  });\n\n  return createElement(\n    getTastySSRContext().Provider,\n    { value: collector },\n    children,\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;;AAuBA,IAAI,OAAO,WAAW,aACpB,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;AAsCtB,SAAgB,cAAc,EAC5B,UACA,gBAAgB,QACK;CACrB,MAAM,WAAW,OAAO,WAAW;CAEnC,MAAM,CAAC,aAAa,eAAe;EACjC,IAAI,UAAU,OAAO;EAErB,MAAM,WAAW,IAAI,qBAAqB;EAE1C,iCAAiC,QAAQ;EAEzC,OAAO;CACT,CAAC;CACD,MAAM,QAAQ,UAAU,CAAC,CAAC;CAE1B,4BAA4B;EAC1B,IAAI,CAAC,WAAW,OAAO;EAEvB,MAAM,MAAM,UAAU,SAAS;EAC/B,MAAM,aAAa,UAAU,sBAAsB;EAEnD,IAAI,CAAC,KAAK,OAAO;EAEjB,MAAM,UAAU,cAAc,SAAS;GACrC,KAAK;GACL,kBAAkB;GAClB;GACA,yBAAyB,EAAE,QAAQ,IAAI;EACzC,CAAC;EAED,IAAI,CAAC,iBAAiB,WAAW,WAAW,GAAG,OAAO;EAYtD,OAAO,cAAc,UAAU,MAAM,SARpB,cAAc,UAAU;GACvC,KAAK;GACL;GACA,yBAAyB,EACvB,QAAQ,gDANU,WAAW,KAAK,MAAM,IAAI,EAAE,EAAE,CAAC,CAAC,KAAK,GAMa,EAAE,GACxE;EACF,CAEqD,CAAC;CACxD,CAAC;CAED,OAAO,cACL,mBAAmB,CAAC,CAAC,UACrB,EAAE,OAAO,UAAU,GACnB,QACF;AACF"}
+{"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 *\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 { getRuntimeConfigState } from '../config-resources';\nimport { ServerStyleCollector } from './collector';\nimport { getTastySSRContext } from './context';\nimport { hydrateTastyClasses } from './hydrate';\nimport { registerSSRCollectorGetter } from './ssr-collector-ref';\n\n// Auto-hydrate on module load (client only).\n// Reads the class name list from `window.__TASTY__` populated by streaming scripts.\nif (typeof window !== 'undefined') {\n  hydrateTastyClasses();\n}\n\nexport interface TastyRegistryProps {\n  children: ReactNode;\n  /**\n   * Whether to embed the class-list script for client hydration.\n   * Set to false to skip class transfer (e.g. for CSP restrictions).\n   * Without it, client components may re-inject CSS that already exists\n   * in server-rendered `<style>` tags. Default: true.\n   */\n  transferCache?: boolean;\n  /**\n   * URL of a stylesheet containing Tasty's configured global CSS.\n   * `withTastyNext()` sets this automatically. Pass false to disable it for\n   * this registry, or a URL to use a manually generated stylesheet.\n   */\n  sharedStylesheet?: string | false;\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  sharedStylesheet = process.env.TASTY_NEXT_SHARED_CSS_HREF,\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    // The generated stylesheet already contains configured global artifacts.\n    // Mark that first batch as flushed so only request-specific styles stream.\n    if (sharedStylesheet) {\n      instance.collectInternals();\n      instance.flushCSS();\n    }\n\n    return instance;\n  });\n  const [streamState] = useState(() => ({ sharedStylesheetFlushed: false }));\n  const nonce = getRuntimeConfigState()?.nonce;\n\n  useServerInsertedHTML(() => {\n    if (!collector) return null;\n\n    const css = collector.flushCSS();\n    const classNames = collector.getRenderedClassNames();\n\n    let linkEl = null;\n    if (sharedStylesheet && !streamState.sharedStylesheetFlushed) {\n      streamState.sharedStylesheetFlushed = true;\n      linkEl = createElement('link', {\n        key: 'tasty-shared-styles',\n        rel: 'stylesheet',\n        href: sharedStylesheet,\n        'data-tasty-ssr': '',\n        nonce,\n      });\n    }\n\n    if (!css) return linkEl;\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 || classNames.length === 0) {\n      return linkEl ? createElement(Fragment, null, linkEl, styleEl) : styleEl;\n    }\n\n    const classListJSON = classNames.map((n) => `\"${n}\"`).join(',');\n\n    const scriptEl = createElement('script', {\n      key: 'tasty-ssr-cache',\n      nonce,\n      dangerouslySetInnerHTML: {\n        __html: `(window.__TASTY__=window.__TASTY__||[]).push(${classListJSON})`,\n      },\n    });\n\n    return createElement(Fragment, null, linkEl, styleEl, scriptEl);\n  });\n\n  return createElement(\n    getTastySSRContext().Provider,\n    { value: collector },\n    children,\n  );\n}\n"],"mappings":";;;;;;;;AAuBA,IAAI,OAAO,WAAW,aACpB,oBAAoB;AA4CtB,SAAgB,cAAc,EAC5B,UACA,gBAAgB,MAChB,mBAAmB,QAAQ,IAAI,8BACV;CACrB,MAAM,WAAW,OAAO,WAAW;CAEnC,MAAM,CAAC,aAAa,eAAe;EACjC,IAAI,UAAU,OAAO;EAErB,MAAM,WAAW,IAAI,qBAAqB;EAE1C,iCAAiC,QAAQ;EAIzC,IAAI,kBAAkB;GACpB,SAAS,iBAAiB;GAC1B,SAAS,SAAS;EACpB;EAEA,OAAO;CACT,CAAC;CACD,MAAM,CAAC,eAAe,gBAAgB,EAAE,yBAAyB,MAAM,EAAE;CACzE,MAAM,QAAQ,sBAAsB,CAAC,EAAE;CAEvC,4BAA4B;EAC1B,IAAI,CAAC,WAAW,OAAO;EAEvB,MAAM,MAAM,UAAU,SAAS;EAC/B,MAAM,aAAa,UAAU,sBAAsB;EAEnD,IAAI,SAAS;EACb,IAAI,oBAAoB,CAAC,YAAY,yBAAyB;GAC5D,YAAY,0BAA0B;GACtC,SAAS,cAAc,QAAQ;IAC7B,KAAK;IACL,KAAK;IACL,MAAM;IACN,kBAAkB;IAClB;GACF,CAAC;EACH;EAEA,IAAI,CAAC,KAAK,OAAO;EAEjB,MAAM,UAAU,cAAc,SAAS;GACrC,KAAK;GACL,kBAAkB;GAClB;GACA,yBAAyB,EAAE,QAAQ,IAAI;EACzC,CAAC;EAED,IAAI,CAAC,iBAAiB,WAAW,WAAW,GAC1C,OAAO,SAAS,cAAc,UAAU,MAAM,QAAQ,OAAO,IAAI;EAGnE,MAAM,gBAAgB,WAAW,KAAK,MAAM,IAAI,EAAE,EAAE,CAAC,CAAC,KAAK,GAAG;EAE9D,MAAM,WAAW,cAAc,UAAU;GACvC,KAAK;GACL;GACA,yBAAyB,EACvB,QAAQ,gDAAgD,cAAc,GACxE;EACF,CAAC;EAED,OAAO,cAAc,UAAU,MAAM,QAAQ,SAAS,QAAQ;CAChE,CAAC;CAED,OAAO,cACL,mBAAmB,CAAC,CAAC,UACrB,EAAE,OAAO,UAAU,GACnB,QACF;AACF"}

package/dist/static/index.d.ts

@@ -1,6 +1,5 @@
-import { b as Styles } from "../index-LC3O3Jj4.js";
-import { t as mergeStyles } from "../merge-styles-Cx_6ySBv.js";
-
+import { Y as Styles } from "../types-JEY8PVYP.js";
+import { t as mergeStyles } from "../merge-styles-VXwJ0Frr.js";
 //#region src/static/types.d.ts
 /**
  * Static style definition returned by tastyStatic().
@@ -40,11 +39,11 @@ interface StaticStyle {
  * Create a StaticStyle object.
  * Used internally by the Babel plugin to generate output.
  */
-declare function createStaticStyle(className: string, styles: Styles): StaticStyle;
+export declare function createStaticStyle(className: string, styles: Styles): StaticStyle;
 /**
  * Type guard to check if a value is a StaticStyle object.
  */
-declare function isStaticStyle(value: unknown): value is StaticStyle;
+export declare function isStaticStyle(value: unknown): value is StaticStyle;
 //#endregion
 //#region src/static/tastyStatic.d.ts
 /**
@@ -62,7 +61,7 @@ declare function isStaticStyle(value: unknown): value is StaticStyle;
  * <div className={button} />  // Works via toString()
  * ```
  */
-declare function tastyStatic(styles: Styles): StaticStyle;
+export declare function tastyStatic(styles: Styles): StaticStyle;
 /**
  * Extend an existing StaticStyle with additional styles.
  * Uses mergeStyles() internally for proper nested selector handling.
@@ -74,7 +73,7 @@ declare function tastyStatic(styles: Styles): StaticStyle;
  * // After build: { className: 'ts8c4d2e', styles: {...merged...}, toString() }
  * ```
  */
-declare function tastyStatic(base: StaticStyle, styles: Styles): StaticStyle;
+export declare function tastyStatic(base: StaticStyle, styles: Styles): StaticStyle;
 /**
  * Generate styles for a specific CSS selector.
  * The call is completely removed after build transformation.
@@ -85,7 +84,7 @@ declare function tastyStatic(base: StaticStyle, styles: Styles): StaticStyle;
  * // After build: (removed)
  * ```
  */
-declare function tastyStatic(selector: string, styles: Styles): void;
+export declare function tastyStatic(selector: string, styles: Styles): void;
 //#endregion
-export { type StaticStyle, type Styles, createStaticStyle, isStaticStyle, mergeStyles, tastyStatic };
+export { type StaticStyle, type Styles, mergeStyles };
 //# sourceMappingURL=index.d.ts.map

package/dist/static/index.js

@@ -1,9 +1,5 @@
-import { t as mergeStyles } from "../merge-styles-CkAcnd0Z.js";
+import { t as mergeStyles } from "../chunks/shared-utils-y-HjvPN4.js";
 //#region src/static/types.ts
-/**
-* Create a StaticStyle object.
-* Used internally by the Babel plugin to generate output.
-*/
 function createStaticStyle(className, styles) {
 	return {
 		className,
@@ -13,35 +9,21 @@ function createStaticStyle(className, styles) {
 		}
 	};
 }
-/**
-* Type guard to check if a value is a StaticStyle object.
-*/
 function isStaticStyle(value) {
 	return typeof value === "object" && value !== null && "className" in value && "styles" in value && "toString" in value && typeof value.className === "string" && typeof value.styles === "object";
 }
 //#endregion
 //#region src/static/tastyStatic.ts
-/**
-* Build-time only function for zero-runtime static site generation.
-*
-* This function is transformed by the Babel plugin:
-* - `tastyStatic(styles)` → StaticStyle object with className
-* - `tastyStatic(base, styles)` → StaticStyle object with merged styles
-* - `tastyStatic(selector, styles)` → removed entirely
-*
-* At runtime (during development/build), this function returns a placeholder.
-* In production, all calls are replaced/removed by the build plugin.
-*/
 function tastyStatic(stylesOrBaseOrSelector, styles) {
 	if (typeof stylesOrBaseOrSelector === "string") {
-		console.warn(`[Tasty] tastyStatic('${stylesOrBaseOrSelector}', styles) was called at runtime. This indicates the Babel plugin is not configured. Add @tenphi/tasty/babel-plugin to your Babel config.`);
+		if (process.env.NODE_ENV !== "production") console.warn(`[Tasty] tastyStatic('${stylesOrBaseOrSelector}', styles) was called at runtime. This indicates the Babel plugin is not configured. Add @tenphi/tasty/babel-plugin to your Babel config.`);
 		return;
 	}
 	if (isStaticStyle(stylesOrBaseOrSelector)) {
-		console.warn("[Tasty] tastyStatic(base, styles) was called at runtime. This indicates the Babel plugin is not configured. Add @tenphi/tasty/babel-plugin to your Babel config.");
+		if (process.env.NODE_ENV !== "production") console.warn("[Tasty] tastyStatic(base, styles) was called at runtime. This indicates the Babel plugin is not configured. Add @tenphi/tasty/babel-plugin to your Babel config.");
 		return createStaticStyle("__TASTY_STATIC_NOT_TRANSFORMED__", mergeStyles(stylesOrBaseOrSelector.styles, styles || {}));
 	}
-	console.warn("[Tasty] tastyStatic(styles) was called at runtime. This indicates the Babel plugin is not configured. Add @tenphi/tasty/babel-plugin to your Babel config.");
+	if (process.env.NODE_ENV !== "production") console.warn("[Tasty] tastyStatic(styles) was called at runtime. This indicates the Babel plugin is not configured. Add @tenphi/tasty/babel-plugin to your Babel config.");
 	return createStaticStyle("__TASTY_STATIC_NOT_TRANSFORMED__", stylesOrBaseOrSelector);
 }
 //#endregion

package/dist/static/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../../src/static/types.ts","../../src/static/tastyStatic.ts"],"sourcesContent":["import type { Styles } from '../styles/types';\n\n/**\n * Static style definition returned by tastyStatic().\n *\n * Supports both explicit className access and implicit string coercion via toString().\n *\n * @example\n * ```typescript\n * const button = tastyStatic({ fill: '#blue' });\n *\n * // Both work in JSX:\n * <div className={button} />           // Uses toString()\n * <div className={button.className} /> // Explicit\n *\n * // Extension:\n * const primary = tastyStatic(button, { fill: '#purple' });\n * ```\n */\nexport interface StaticStyle {\n  /**\n   * Generated className(s) for use in JSX.\n   * May contain multiple space-separated class names due to chunking.\n   */\n  className: string;\n\n  /**\n   * The original (or merged) styles object.\n   * Available for extension via tastyStatic(base, overrides).\n   */\n  styles: Styles;\n\n  /**\n   * Returns className for implicit string coercion.\n   * Enables `<div className={button} />` syntax.\n   */\n  toString(): string;\n}\n\n/**\n * Create a StaticStyle object.\n * Used internally by the Babel plugin to generate output.\n */\nexport function createStaticStyle(\n  className: string,\n  styles: Styles,\n): StaticStyle {\n  return {\n    className,\n    styles,\n    toString() {\n      return this.className;\n    },\n  };\n}\n\n/**\n * Type guard to check if a value is a StaticStyle object.\n */\nexport function isStaticStyle(value: unknown): value is StaticStyle {\n  return (\n    typeof value === 'object' &&\n    value !== null &&\n    'className' in value &&\n    'styles' in value &&\n    'toString' in value &&\n    typeof (value as StaticStyle).className === 'string' &&\n    typeof (value as StaticStyle).styles === 'object'\n  );\n}\n","import type { Styles } from '../styles/types';\nimport { mergeStyles } from '../utils/merge-styles';\n\nimport type { StaticStyle } from './types';\nimport { createStaticStyle, isStaticStyle } from './types';\n\n/**\n * Generate styles and return a StaticStyle object.\n * The object has `className`, `styles`, and `toString()`.\n *\n * @example\n * ```typescript\n * const button = tastyStatic({\n *   fill: '#blue',\n *   padding: '2x',\n * });\n * // After build: { className: 'ts3f2a1b', styles: {...}, toString() }\n *\n * <div className={button} />  // Works via toString()\n * ```\n */\nexport function tastyStatic(styles: Styles): StaticStyle;\n\n/**\n * Extend an existing StaticStyle with additional styles.\n * Uses mergeStyles() internally for proper nested selector handling.\n *\n * @example\n * ```typescript\n * const button = tastyStatic({ fill: '#blue' });\n * const primary = tastyStatic(button, { fill: '#purple' });\n * // After build: { className: 'ts8c4d2e', styles: {...merged...}, toString() }\n * ```\n */\nexport function tastyStatic(base: StaticStyle, styles: Styles): StaticStyle;\n\n/**\n * Generate styles for a specific CSS selector.\n * The call is completely removed after build transformation.\n *\n * @example\n * ```typescript\n * tastyStatic('.heading', { preset: 'h1', color: '#primary' });\n * // After build: (removed)\n * ```\n */\nexport function tastyStatic(selector: string, styles: Styles): void;\n\n/**\n * Build-time only function for zero-runtime static site generation.\n *\n * This function is transformed by the Babel plugin:\n * - `tastyStatic(styles)` → StaticStyle object with className\n * - `tastyStatic(base, styles)` → StaticStyle object with merged styles\n * - `tastyStatic(selector, styles)` → removed entirely\n *\n * At runtime (during development/build), this function returns a placeholder.\n * In production, all calls are replaced/removed by the build plugin.\n */\nexport function tastyStatic(\n  stylesOrBaseOrSelector: Styles | StaticStyle | string,\n  styles?: Styles,\n): StaticStyle | void {\n  // This code only executes if the Babel plugin hasn't processed the file yet.\n  // In a properly configured build, this function is never called at runtime.\n\n  if (typeof stylesOrBaseOrSelector === 'string') {\n    // Selector mode: tastyStatic(selector, styles)\n    // The plugin will remove this call entirely\n    if (process.env.NODE_ENV !== 'production') {\n      console.warn(\n        `[Tasty] tastyStatic('${stylesOrBaseOrSelector}', styles) was called at runtime. ` +\n          'This indicates the Babel plugin is not configured. ' +\n          'Add @tenphi/tasty/babel-plugin to your Babel config.',\n      );\n    }\n    return; // void\n  }\n\n  if (isStaticStyle(stylesOrBaseOrSelector)) {\n    // Extension mode: tastyStatic(base, styles)\n    if (process.env.NODE_ENV !== 'production') {\n      console.warn(\n        '[Tasty] tastyStatic(base, styles) was called at runtime. ' +\n          'This indicates the Babel plugin is not configured. ' +\n          'Add @tenphi/tasty/babel-plugin to your Babel config.',\n      );\n    }\n    // Merge styles for dev mode preview (won't have real classNames)\n    const mergedStyles = mergeStyles(\n      stylesOrBaseOrSelector.styles,\n      styles || {},\n    );\n    return createStaticStyle('__TASTY_STATIC_NOT_TRANSFORMED__', mergedStyles);\n  }\n\n  // Styles mode: tastyStatic(styles)\n  if (process.env.NODE_ENV !== 'production') {\n    console.warn(\n      '[Tasty] tastyStatic(styles) was called at runtime. ' +\n        'This indicates the Babel plugin is not configured. ' +\n        'Add @tenphi/tasty/babel-plugin to your Babel config.',\n    );\n  }\n\n  // Return placeholder - styles won't be applied without the plugin\n  return createStaticStyle(\n    '__TASTY_STATIC_NOT_TRANSFORMED__',\n    stylesOrBaseOrSelector,\n  );\n}\n"],"mappings":";;;;;;AA2CA,SAAgB,kBACd,WACA,QACa;CACb,OAAO;EACL;EACA;EACA,WAAW;GACT,OAAO,KAAK;EACd;CACF;AACF;;;;AAKA,SAAgB,cAAc,OAAsC;CAClE,OACE,OAAO,UAAU,YACjB,UAAU,QACV,eAAe,SACf,YAAY,SACZ,cAAc,SACd,OAAQ,MAAsB,cAAc,YAC5C,OAAQ,MAAsB,WAAW;AAE7C;;;;;;;;;;;;;;ACVA,SAAgB,YACd,wBACA,QACoB;CAIpB,IAAI,OAAO,2BAA2B,UAAU;EAI5C,QAAQ,KACN,wBAAwB,uBAAuB,0IAGjD;EAEF;CACF;CAEA,IAAI,cAAc,sBAAsB,GAAG;EAGvC,QAAQ,KACN,kKAGF;EAOF,OAAO,kBAAkB,oCAJJ,YACnB,uBAAuB,QACvB,UAAU,CAAC,CAE2D,CAAC;CAC3E;CAIE,QAAQ,KACN,4JAGF;CAIF,OAAO,kBACL,oCACA,sBACF;AACF"}
+{"version":3,"file":"index.js","names":[],"sources":["../../src/static/types.ts","../../src/static/tastyStatic.ts"],"sourcesContent":["import type { Styles } from '../styles/types';\n\n/**\n * Static style definition returned by tastyStatic().\n *\n * Supports both explicit className access and implicit string coercion via toString().\n *\n * @example\n * ```typescript\n * const button = tastyStatic({ fill: '#blue' });\n *\n * // Both work in JSX:\n * <div className={button} />           // Uses toString()\n * <div className={button.className} /> // Explicit\n *\n * // Extension:\n * const primary = tastyStatic(button, { fill: '#purple' });\n * ```\n */\nexport interface StaticStyle {\n  /**\n   * Generated className(s) for use in JSX.\n   * May contain multiple space-separated class names due to chunking.\n   */\n  className: string;\n\n  /**\n   * The original (or merged) styles object.\n   * Available for extension via tastyStatic(base, overrides).\n   */\n  styles: Styles;\n\n  /**\n   * Returns className for implicit string coercion.\n   * Enables `<div className={button} />` syntax.\n   */\n  toString(): string;\n}\n\n/**\n * Create a StaticStyle object.\n * Used internally by the Babel plugin to generate output.\n */\nexport function createStaticStyle(\n  className: string,\n  styles: Styles,\n): StaticStyle {\n  return {\n    className,\n    styles,\n    toString() {\n      return this.className;\n    },\n  };\n}\n\n/**\n * Type guard to check if a value is a StaticStyle object.\n */\nexport function isStaticStyle(value: unknown): value is StaticStyle {\n  return (\n    typeof value === 'object' &&\n    value !== null &&\n    'className' in value &&\n    'styles' in value &&\n    'toString' in value &&\n    typeof (value as StaticStyle).className === 'string' &&\n    typeof (value as StaticStyle).styles === 'object'\n  );\n}\n","import type { Styles } from '../styles/types';\nimport { mergeStyles } from '../utils/merge-styles';\n\nimport type { StaticStyle } from './types';\nimport { createStaticStyle, isStaticStyle } from './types';\n\n/**\n * Generate styles and return a StaticStyle object.\n * The object has `className`, `styles`, and `toString()`.\n *\n * @example\n * ```typescript\n * const button = tastyStatic({\n *   fill: '#blue',\n *   padding: '2x',\n * });\n * // After build: { className: 'ts3f2a1b', styles: {...}, toString() }\n *\n * <div className={button} />  // Works via toString()\n * ```\n */\nexport function tastyStatic(styles: Styles): StaticStyle;\n\n/**\n * Extend an existing StaticStyle with additional styles.\n * Uses mergeStyles() internally for proper nested selector handling.\n *\n * @example\n * ```typescript\n * const button = tastyStatic({ fill: '#blue' });\n * const primary = tastyStatic(button, { fill: '#purple' });\n * // After build: { className: 'ts8c4d2e', styles: {...merged...}, toString() }\n * ```\n */\nexport function tastyStatic(base: StaticStyle, styles: Styles): StaticStyle;\n\n/**\n * Generate styles for a specific CSS selector.\n * The call is completely removed after build transformation.\n *\n * @example\n * ```typescript\n * tastyStatic('.heading', { preset: 'h1', color: '#primary' });\n * // After build: (removed)\n * ```\n */\nexport function tastyStatic(selector: string, styles: Styles): void;\n\n/**\n * Build-time only function for zero-runtime static site generation.\n *\n * This function is transformed by the Babel plugin:\n * - `tastyStatic(styles)` → StaticStyle object with className\n * - `tastyStatic(base, styles)` → StaticStyle object with merged styles\n * - `tastyStatic(selector, styles)` → removed entirely\n *\n * At runtime (during development/build), this function returns a placeholder.\n * In production, all calls are replaced/removed by the build plugin.\n */\nexport function tastyStatic(\n  stylesOrBaseOrSelector: Styles | StaticStyle | string,\n  styles?: Styles,\n): StaticStyle | void {\n  // This code only executes if the Babel plugin hasn't processed the file yet.\n  // In a properly configured build, this function is never called at runtime.\n\n  if (typeof stylesOrBaseOrSelector === 'string') {\n    // Selector mode: tastyStatic(selector, styles)\n    // The plugin will remove this call entirely\n    if (process.env.NODE_ENV !== 'production') {\n      console.warn(\n        `[Tasty] tastyStatic('${stylesOrBaseOrSelector}', styles) was called at runtime. ` +\n          'This indicates the Babel plugin is not configured. ' +\n          'Add @tenphi/tasty/babel-plugin to your Babel config.',\n      );\n    }\n    return; // void\n  }\n\n  if (isStaticStyle(stylesOrBaseOrSelector)) {\n    // Extension mode: tastyStatic(base, styles)\n    if (process.env.NODE_ENV !== 'production') {\n      console.warn(\n        '[Tasty] tastyStatic(base, styles) was called at runtime. ' +\n          'This indicates the Babel plugin is not configured. ' +\n          'Add @tenphi/tasty/babel-plugin to your Babel config.',\n      );\n    }\n    // Merge styles for dev mode preview (won't have real classNames)\n    const mergedStyles = mergeStyles(\n      stylesOrBaseOrSelector.styles,\n      styles || {},\n    );\n    return createStaticStyle('__TASTY_STATIC_NOT_TRANSFORMED__', mergedStyles);\n  }\n\n  // Styles mode: tastyStatic(styles)\n  if (process.env.NODE_ENV !== 'production') {\n    console.warn(\n      '[Tasty] tastyStatic(styles) was called at runtime. ' +\n        'This indicates the Babel plugin is not configured. ' +\n        'Add @tenphi/tasty/babel-plugin to your Babel config.',\n    );\n  }\n\n  // Return placeholder - styles won't be applied without the plugin\n  return createStaticStyle(\n    '__TASTY_STATIC_NOT_TRANSFORMED__',\n    stylesOrBaseOrSelector,\n  );\n}\n"],"mappings":";;AA2CA,SAAgB,kBACd,WACA,QACa;CACb,OAAO;EACL;EACA;EACA,WAAW;GACT,OAAO,KAAK;EACd;CACF;AACF;AAKA,SAAgB,cAAc,OAAsC;CAClE,OACE,OAAO,UAAU,YACjB,UAAU,QACV,eAAe,SACf,YAAY,SACZ,cAAc,SACd,OAAQ,MAAsB,cAAc,YAC5C,OAAQ,MAAsB,WAAW;AAE7C;;;ACVA,SAAgB,YACd,wBACA,QACoB;CAIpB,IAAI,OAAO,2BAA2B,UAAU;EAG9C,IAAA,QAAA,IAAA,aAA6B,cAC3B,QAAQ,KACN,wBAAwB,uBAAuB,0IAGjD;EAEF;CACF;CAEA,IAAI,cAAc,sBAAsB,GAAG;EAEzC,IAAA,QAAA,IAAA,aAA6B,cAC3B,QAAQ,KACN,kKAGF;EAOF,OAAO,kBAAkB,oCAJJ,YACnB,uBAAuB,QACvB,UAAU,CAAC,CAEgD,CAAY;CAC3E;CAGA,IAAA,QAAA,IAAA,aAA6B,cAC3B,QAAQ,KACN,4JAGF;CAIF,OAAO,kBACL,oCACA,sBACF;AACF"}

package/dist/static/inject.d.ts

@@ -1,5 +1,4 @@
 //#region src/static/inject.d.ts
-declare function injectCSS(id: string, css: string): void;
+export declare function injectCSS(id: string, css: string): void;
 //#endregion
-export { injectCSS };
 //# sourceMappingURL=inject.d.ts.map