@tenphi/tasty 0.0.0-snapshot.bbd10c7 → 0.0.0-snapshot.bbfcd75

package/dist/ssr/astro.js

@@ -1,64 +1,220 @@
-import { getConfig } from "../config.js";
-import { registerSSRCollectorGetter } from "./ssr-collector-ref.js";
-import { ServerStyleCollector } from "./collector.js";
-import { getSSRCollector, runWithCollector } from "./async-storage.js";
-import { hydrateTastyCache } from "./hydrate.js";
+import { r as registerSSRCollectorGetterGlobal, u as getRuntimeConfigState } from "../chunks/runtime-state-BTDqSYBk.js";
+import { t as ServerStyleCollector } from "../chunks/collector-B0LTHw6Z.js";
+import { n as runWithCollector, t as getSSRCollector } from "../chunks/async-storage-CG5HnUT5.js";
+import { t as findUnsafeCSSResource } from "../chunks/css-resources-BN8apgxt.js";
+import { createHash } from "node:crypto";
+import { join } from "node:path";
+import { mkdir, readFile, readdir, writeFile } from "node:fs/promises";
+import { fileURLToPath } from "node:url";
+//#region src/ssr/astro-extraction.ts
+const METADATA_START = "<template data-tasty-extract>";
+const METADATA_END = "</template>";
+function createExtractionMetadata(artifacts) {
+	return `${METADATA_START}${Buffer.from(JSON.stringify(artifacts), "utf8").toString("base64")}${METADATA_END}`;
+}
+function parseExtractablePage(path, html) {
+	const metadataStart = html.indexOf(METADATA_START);
+	if (metadataStart === -1) return null;
+	const metadataContentStart = metadataStart + 29;
+	const metadataEnd = html.indexOf(METADATA_END, metadataContentStart);
+	if (metadataEnd === -1) return null;
+	const encoded = html.slice(metadataContentStart, metadataEnd);
+	let artifacts;
+	try {
+		artifacts = JSON.parse(Buffer.from(encoded, "base64").toString("utf8"));
+	} catch {
+		return null;
+	}
+	const styleStart = html.lastIndexOf("<style data-tasty-ssr", metadataStart);
+	if (styleStart === -1) return null;
+	const styleOpenEnd = html.indexOf(">", styleStart);
+	const styleEnd = html.indexOf("</style>", styleOpenEnd + 1);
+	if (styleOpenEnd === -1 || styleEnd === -1 || styleEnd + 8 !== metadataStart) return null;
+	return {
+		path,
+		html,
+		artifacts,
+		styleStart,
+		replacementEnd: metadataEnd + 11,
+		styleOpen: html.slice(styleStart, styleOpenEnd + 1)
+	};
+}
+async function findHTMLFiles(dir) {
+	const paths = [];
+	const entries = await readdir(dir, { withFileTypes: true });
+	entries.sort((a, b) => a.name.localeCompare(b.name));
+	for (const entry of entries) {
+		const path = join(dir, entry.name);
+		if (entry.isDirectory()) paths.push(...await findHTMLFiles(path));
+		else if (entry.isFile() && entry.name.endsWith(".html")) paths.push(path);
+	}
+	return paths;
+}
+function crossOriginAssetsPrefix(assetsPrefix, site) {
+	if (!assetsPrefix) return null;
+	const prefix = typeof assetsPrefix === "string" ? assetsPrefix : assetsPrefix.css || assetsPrefix.fallback;
+	if (!/^(?:[a-z][a-z\d+.-]*:|\/\/)/i.test(prefix)) return null;
+	if (!site) return prefix;
+	try {
+		return (prefix.startsWith("//") ? new URL(`${site.protocol}${prefix}`) : new URL(prefix)).origin === site.origin ? null : prefix;
+	} catch {
+		return prefix;
+	}
+}
+function validateExtractedURLs(pages, assetsPrefix, site) {
+	const externalPrefix = crossOriginAssetsPrefix(assetsPrefix, site);
+	for (const page of pages) for (const artifact of page.artifacts) {
+		const unsafe = findUnsafeCSSResource(artifact.css, externalPrefix !== null);
+		if (unsafe) {
+			const reason = unsafe.rootRelative ? `root-relative CSS URL "${unsafe.url}" would resolve against the external assetsPrefix "${externalPrefix}" instead of the page origin` : `page-relative CSS URL "${unsafe.url}" cannot preserve its target`;
+			throw new Error(`[Tasty] Astro CSS extraction cannot preserve ${reason} in ${page.path} (${artifact.kind} artifact ${artifact.id}). Use an absolute URL or a data URL${externalPrefix ? "" : ", or a root-relative URL such as url(/path/to/asset)"}.`);
+		}
+	}
+}
+function selectSharedArtifacts(pages) {
+	if (pages.length < 2) return [];
+	const source = pages[0].artifacts;
+	const otherIds = pages.slice(1).map((page) => new Set(page.artifacts.map(({ id }) => id)));
+	return source.filter(({ id }) => otherIds.every((ids) => ids.has(id)));
+}
+function stylesheetHref(base, assets, filename, assetsPrefix) {
+	const assetsPath = assets.replace(/^\/+|\/+$/g, "");
+	if (assetsPrefix) return `${(typeof assetsPrefix === "string" ? assetsPrefix : assetsPrefix.css || assetsPrefix.fallback).replace(/\/+$/g, "")}/${assetsPath}/${filename}`;
+	return `${base === "/" ? "" : `/${base.replace(/^\/+|\/+$/g, "")}`}/${assetsPath}/${filename}`;
+}
+function stylesheetLink(page, href) {
+	return `<link rel="stylesheet" href="${href}" data-tasty-ssr${page.styleOpen.match(/\snonce="[^"]*"/)?.[0] ?? ""}>`;
+}
+function transformPage(page, hrefs) {
+	const replacement = hrefs.map((href) => stylesheetLink(page, href)).join("");
+	return page.html.slice(0, page.styleStart) + replacement + page.html.slice(page.replacementEnd);
+}
+async function writeStylesheet(assetDir, scope, artifacts) {
+	if (artifacts.length === 0) return null;
+	const css = artifacts.map(({ css }) => css).join("\n");
+	const filename = `tasty.${scope}.${createHash("sha256").update(css).digest("hex").slice(0, 12)}.css`;
+	await writeFile(join(assetDir, filename), css);
+	return filename;
+}
+async function extractAstroCSS(options) {
+	const outputDir = fileURLToPath(options.dir);
+	const paths = await findHTMLFiles(outputDir);
+	const pages = (await Promise.all(paths.map(async (path) => parseExtractablePage(path, await readFile(path, "utf8"))))).filter((page) => page !== null);
+	if (pages.length === 0) return;
+	validateExtractedURLs(pages, options.assetsPrefix, options.site);
+	const shared = selectSharedArtifacts(pages);
+	const assetDir = join(outputDir, options.assets);
+	await mkdir(assetDir, { recursive: true });
+	const sharedFilename = await writeStylesheet(assetDir, "shared", shared);
+	const sharedHref = sharedFilename ? stylesheetHref(options.base, options.assets, sharedFilename, options.assetsPrefix) : null;
+	const sharedIds = new Set(shared.map(({ id }) => id));
+	for (const page of pages) {
+		const pageFilename = await writeStylesheet(assetDir, "page", page.artifacts.filter(({ id }) => !sharedIds.has(id)));
+		const hrefs = sharedHref ? [sharedHref] : [];
+		if (pageFilename) hrefs.push(stylesheetHref(options.base, options.assets, pageFilename, options.assetsPrefix));
+		await writeFile(page.path, transformPage(page, hrefs));
+	}
+}
+//#endregion
 //#region src/ssr/astro.ts
-/**
-* Astro integration for Tasty SSR.
-*
-* Provides tastyMiddleware() for Astro's middleware system.
-* The middleware wraps request handling in a ServerStyleCollector
-* via AsyncLocalStorage, then injects collected CSS into </head>.
-*
-* Import from '@tenphi/tasty/ssr/astro'.
-*/
-registerSSRCollectorGetter(getSSRCollector);
-/**
-* Create an Astro middleware that collects Tasty styles during SSR.
-*
-* All React components rendered during the request (both static
-* and islands) will have their useStyles() calls captured by the
-* collector via AsyncLocalStorage. After rendering, the middleware
-* injects the collected CSS into </head>.
-*
-* @example
-* ```ts
-* // src/middleware.ts
-* import { tastyMiddleware } from '@tenphi/tasty/ssr/astro';
-* export const onRequest = tastyMiddleware();
-* ```
-*/
+registerSSRCollectorGetterGlobal(getSSRCollector);
 function tastyMiddleware(options) {
-	const { transferCache = true } = options ?? {};
-	return async (_context, next) => {
+	const internalOptions = options;
+	return async (context, next) => {
+		const transferCache = options?.transferCache ?? true;
+		const extractionMetadata = internalOptions?.extractionMetadata === true && context.isPrerendered === true;
 		const collector = new ServerStyleCollector();
-		const response = await runWithCollector(collector, () => next());
+		const rendered = await runWithCollector(collector, async () => {
+			const response = await next();
+			const body = response.body;
+			const contentType = response.headers.get("content-type") ?? "";
+			if (!body || !contentType.includes("text/html")) return { response };
+			const reader = body.pipeThrough(new TextDecoderStream()).getReader();
+			const parts = [];
+			for (;;) {
+				const { done, value } = await reader.read();
+				if (done) break;
+				parts.push(value);
+			}
+			return {
+				html: parts.join(""),
+				status: response.status,
+				headers: response.headers
+			};
+		});
+		if ("response" in rendered) return rendered.response;
+		if (!rendered.html) return new Response(null, {
+			status: rendered.status,
+			headers: rendered.headers
+		});
+		let { html } = rendered;
 		const css = collector.getCSS();
-		if (!css) return response;
-		const nonce = getConfig().nonce;
+		if (!css) return new Response(html, {
+			status: rendered.status,
+			headers: rendered.headers
+		});
+		const nonce = getRuntimeConfigState()?.nonce;
 		const nonceAttr = nonce ? ` nonce="${nonce}"` : "";
-		const html = await response.text();
 		const styleTag = `<style data-tasty-ssr${nonceAttr}>${css}</style>`;
+		const metadataTag = extractionMetadata ? createExtractionMetadata(collector.getArtifacts()) : "";
 		let cacheTag = "";
 		if (transferCache) {
-			const cacheState = collector.getCacheState();
-			if (Object.keys(cacheState.entries).length > 0) cacheTag = `<script data-tasty-cache type="application/json"${nonceAttr}>${JSON.stringify(cacheState)}<\/script>`;
+			const classNames = collector.getRenderedClassNames();
+			if (classNames.length > 0) cacheTag = `<script${nonceAttr}>(window.__TASTY__=window.__TASTY__||[]).push(${classNames.map((n) => `"${n}"`).join(",")})<\/script>`;
 		}
-		const modifiedHtml = html.replace("</head>", `${styleTag}${cacheTag}</head>`);
-		return new Response(modifiedHtml, {
-			status: response.status,
-			headers: response.headers
+		const injection = styleTag + metadataTag + cacheTag;
+		const idx = html.indexOf("</head>");
+		if (idx !== -1) html = html.slice(0, idx) + injection + html.slice(idx);
+		else html = injection + html;
+		const headers = new Headers(rendered.headers);
+		headers.delete("content-length");
+		return new Response(html, {
+			status: rendered.status,
+			headers
 		});
 	};
 }
-if (typeof window !== "undefined") {
-	const script = document.querySelector("script[data-tasty-cache]");
-	if (script) try {
-		hydrateTastyCache(JSON.parse(script.textContent));
-	} catch {}
+const MIDDLEWARE_ENTRYPOINT = "@tenphi/tasty/ssr/astro-middleware";
+const MIDDLEWARE_ENTRYPOINT_STATIC = "@tenphi/tasty/ssr/astro-middleware-static";
+const MIDDLEWARE_ENTRYPOINT_EXTRACT = "@tenphi/tasty/ssr/astro-middleware-extract";
+const MIDDLEWARE_ENTRYPOINT_EXTRACT_STATIC = "@tenphi/tasty/ssr/astro-middleware-extract-static";
+function tastyIntegration(options) {
+	const { islands = true } = options ?? {};
+	const cssMode = options?.css?.mode ?? "inline";
+	let base = "/";
+	let assets = "_astro";
+	let assetsPrefix;
+	let site;
+	return {
+		name: "@tenphi/tasty",
+		hooks: {
+			"astro:config:setup": ({ addMiddleware, injectScript }) => {
+				addMiddleware({
+					entrypoint: cssMode === "extract" ? islands ? MIDDLEWARE_ENTRYPOINT_EXTRACT : MIDDLEWARE_ENTRYPOINT_EXTRACT_STATIC : islands ? MIDDLEWARE_ENTRYPOINT : MIDDLEWARE_ENTRYPOINT_STATIC,
+					order: "pre"
+				});
+				if (islands) injectScript("before-hydration", `import "@tenphi/tasty/ssr/astro-client";`);
+			},
+			"astro:config:done": ({ config }) => {
+				base = config.base ?? "/";
+				assets = config.build?.assets ?? "_astro";
+				assetsPrefix = config.build?.assetsPrefix;
+				site = config.site;
+			},
+			"astro:build:done": async ({ dir }) => {
+				if (cssMode !== "extract") return;
+				await extractAstroCSS({
+					dir,
+					base,
+					assets,
+					assetsPrefix,
+					site
+				});
+			}
+		}
+	};
 }
 //#endregion
-export { hydrateTastyCache, tastyMiddleware };
+export { tastyIntegration, tastyMiddleware };
 
 //# sourceMappingURL=astro.js.map

package/dist/ssr/astro.js.map

@@ -1 +1 @@
-{"version":3,"file":"astro.js","names":[],"sources":["../../src/ssr/astro.ts"],"sourcesContent":["/**\n * Astro integration for Tasty SSR.\n *\n * Provides tastyMiddleware() for Astro's middleware system.\n * The middleware wraps request handling in a ServerStyleCollector\n * via AsyncLocalStorage, then injects collected CSS into </head>.\n *\n * Import from '@tenphi/tasty/ssr/astro'.\n */\n\nimport { getConfig } from '../config';\nimport { getSSRCollector, runWithCollector } from './async-storage';\nimport { ServerStyleCollector } from './collector';\nimport { hydrateTastyCache } from './hydrate';\nimport { registerSSRCollectorGetter } from './ssr-collector-ref';\n\n// Wire up ALS-based collector discovery so useStyles can find\n// the collector set by tastyMiddleware's runWithCollector().\nregisterSSRCollectorGetter(getSSRCollector);\n\n// Re-export for convenience\nexport { hydrateTastyCache };\n\nexport interface TastyMiddlewareOptions {\n  /**\n   * Whether to embed the cache state script for client hydration.\n   * Set to false to skip cache transfer. Default: true.\n   */\n  transferCache?: boolean;\n}\n\n/**\n * Create an Astro middleware that collects Tasty styles during SSR.\n *\n * All React components rendered during the request (both static\n * and islands) will have their useStyles() calls captured by the\n * collector via AsyncLocalStorage. After rendering, the middleware\n * injects the collected CSS into </head>.\n *\n * @example\n * ```ts\n * // src/middleware.ts\n * import { tastyMiddleware } from '@tenphi/tasty/ssr/astro';\n * export const onRequest = tastyMiddleware();\n * ```\n */\nexport function tastyMiddleware(options?: TastyMiddlewareOptions) {\n  const { transferCache = true } = options ?? {};\n\n  return async (\n    _context: unknown,\n    next: () => Promise<Response>,\n  ): Promise<Response> => {\n    const collector = new ServerStyleCollector();\n\n    const response = await runWithCollector(collector, () => next());\n\n    const css = collector.getCSS();\n    if (!css) return response;\n\n    const nonce = getConfig().nonce;\n    const nonceAttr = nonce ? ` nonce=\"${nonce}\"` : '';\n    const html = await response.text();\n    const styleTag = `<style data-tasty-ssr${nonceAttr}>${css}</style>`;\n\n    let cacheTag = '';\n    if (transferCache) {\n      const cacheState = collector.getCacheState();\n      const hasHydratableStyles = Object.keys(cacheState.entries).length > 0;\n      if (hasHydratableStyles) {\n        cacheTag = `<script data-tasty-cache type=\"application/json\"${nonceAttr}>${JSON.stringify(cacheState)}</script>`;\n      }\n    }\n\n    const modifiedHtml = html.replace(\n      '</head>',\n      `${styleTag}${cacheTag}</head>`,\n    );\n\n    return new Response(modifiedHtml, {\n      status: response.status,\n      headers: response.headers,\n    });\n  };\n}\n\n// Client-side auto-hydration.\n// When imported in the browser, reads the cache state from the DOM\n// and pre-populates the injector before any island hydrates.\nif (typeof window !== 'undefined') {\n  const script = document.querySelector('script[data-tasty-cache]');\n  if (script) {\n    try {\n      const state = JSON.parse(script.textContent!);\n      hydrateTastyCache(state);\n    } catch {\n      // Ignore malformed cache state\n    }\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;AAkBA,2BAA2B,gBAAgB;;;;;;;;;;;;;;;;AA4B3C,SAAgB,gBAAgB,SAAkC;CAChE,MAAM,EAAE,gBAAgB,SAAS,WAAW,EAAE;AAE9C,QAAO,OACL,UACA,SACsB;EACtB,MAAM,YAAY,IAAI,sBAAsB;EAE5C,MAAM,WAAW,MAAM,iBAAiB,iBAAiB,MAAM,CAAC;EAEhE,MAAM,MAAM,UAAU,QAAQ;AAC9B,MAAI,CAAC,IAAK,QAAO;EAEjB,MAAM,QAAQ,WAAW,CAAC;EAC1B,MAAM,YAAY,QAAQ,WAAW,MAAM,KAAK;EAChD,MAAM,OAAO,MAAM,SAAS,MAAM;EAClC,MAAM,WAAW,wBAAwB,UAAU,GAAG,IAAI;EAE1D,IAAI,WAAW;AACf,MAAI,eAAe;GACjB,MAAM,aAAa,UAAU,eAAe;AAE5C,OAD4B,OAAO,KAAK,WAAW,QAAQ,CAAC,SAAS,EAEnE,YAAW,mDAAmD,UAAU,GAAG,KAAK,UAAU,WAAW,CAAC;;EAI1G,MAAM,eAAe,KAAK,QACxB,WACA,GAAG,WAAW,SAAS,SACxB;AAED,SAAO,IAAI,SAAS,cAAc;GAChC,QAAQ,SAAS;GACjB,SAAS,SAAS;GACnB,CAAC;;;AAON,IAAI,OAAO,WAAW,aAAa;CACjC,MAAM,SAAS,SAAS,cAAc,2BAA2B;AACjE,KAAI,OACF,KAAI;AAEF,oBADc,KAAK,MAAM,OAAO,YAAa,CACrB;SAClB"}
+{"version":3,"file":"astro.js","names":[],"sources":["../../src/ssr/astro-extraction.ts","../../src/ssr/astro.ts"],"sourcesContent":["import { createHash } from 'node:crypto';\nimport { readdir, readFile, writeFile, mkdir } from 'node:fs/promises';\nimport { join } from 'node:path';\nimport { fileURLToPath } from 'node:url';\n\nimport type { ServerStyleArtifact } from './collector';\nimport { findUnsafeCSSResource } from './css-resources';\n\nconst METADATA_START = '<template data-tasty-extract>';\nconst METADATA_END = '</template>';\n\ninterface ExtractablePage {\n  path: string;\n  html: string;\n  artifacts: ServerStyleArtifact[];\n  styleStart: number;\n  replacementEnd: number;\n  styleOpen: string;\n}\n\nexport function createExtractionMetadata(\n  artifacts: ServerStyleArtifact[],\n): string {\n  const encoded = Buffer.from(JSON.stringify(artifacts), 'utf8').toString(\n    'base64',\n  );\n  return `${METADATA_START}${encoded}${METADATA_END}`;\n}\n\nfunction parseExtractablePage(\n  path: string,\n  html: string,\n): ExtractablePage | null {\n  const metadataStart = html.indexOf(METADATA_START);\n  if (metadataStart === -1) return null;\n\n  const metadataContentStart = metadataStart + METADATA_START.length;\n  const metadataEnd = html.indexOf(METADATA_END, metadataContentStart);\n  if (metadataEnd === -1) return null;\n\n  const encoded = html.slice(metadataContentStart, metadataEnd);\n  let artifacts: ServerStyleArtifact[];\n  try {\n    artifacts = JSON.parse(\n      Buffer.from(encoded, 'base64').toString('utf8'),\n    ) as ServerStyleArtifact[];\n  } catch {\n    return null;\n  }\n\n  const styleStart = html.lastIndexOf('<style data-tasty-ssr', metadataStart);\n  if (styleStart === -1) return null;\n  const styleOpenEnd = html.indexOf('>', styleStart);\n  const styleEnd = html.indexOf('</style>', styleOpenEnd + 1);\n  if (\n    styleOpenEnd === -1 ||\n    styleEnd === -1 ||\n    styleEnd + '</style>'.length !== metadataStart\n  ) {\n    return null;\n  }\n\n  return {\n    path,\n    html,\n    artifacts,\n    styleStart,\n    replacementEnd: metadataEnd + METADATA_END.length,\n    styleOpen: html.slice(styleStart, styleOpenEnd + 1),\n  };\n}\n\nasync function findHTMLFiles(dir: string): Promise<string[]> {\n  const paths: string[] = [];\n  const entries = await readdir(dir, { withFileTypes: true });\n  entries.sort((a, b) => a.name.localeCompare(b.name));\n  for (const entry of entries) {\n    const path = join(dir, entry.name);\n    if (entry.isDirectory()) {\n      paths.push(...(await findHTMLFiles(path)));\n    } else if (entry.isFile() && entry.name.endsWith('.html')) {\n      paths.push(path);\n    }\n  }\n  return paths;\n}\n\nfunction crossOriginAssetsPrefix(\n  assetsPrefix?: string | Record<string, string>,\n  site?: URL,\n): string | null {\n  if (!assetsPrefix) return null;\n  const prefix =\n    typeof assetsPrefix === 'string'\n      ? assetsPrefix\n      : assetsPrefix.css || assetsPrefix.fallback;\n  if (!/^(?:[a-z][a-z\\d+.-]*:|\\/\\/)/i.test(prefix)) return null;\n  if (!site) return prefix;\n\n  try {\n    const prefixURL = prefix.startsWith('//')\n      ? new URL(`${site.protocol}${prefix}`)\n      : new URL(prefix);\n    return prefixURL.origin === site.origin ? null : prefix;\n  } catch {\n    return prefix;\n  }\n}\n\nfunction validateExtractedURLs(\n  pages: ExtractablePage[],\n  assetsPrefix?: string | Record<string, string>,\n  site?: URL,\n): void {\n  const externalPrefix = crossOriginAssetsPrefix(assetsPrefix, site);\n  for (const page of pages) {\n    for (const artifact of page.artifacts) {\n      const unsafe = findUnsafeCSSResource(\n        artifact.css,\n        externalPrefix !== null,\n      );\n      if (unsafe) {\n        const reason = unsafe.rootRelative\n          ? `root-relative CSS URL \"${unsafe.url}\" would resolve against the external assetsPrefix \"${externalPrefix}\" instead of the page origin`\n          : `page-relative CSS URL \"${unsafe.url}\" cannot preserve its target`;\n        throw new Error(\n          `[Tasty] Astro CSS extraction cannot preserve ${reason} in ${page.path} (${artifact.kind} artifact ${artifact.id}). Use an absolute URL or a data URL${externalPrefix ? '' : ', or a root-relative URL such as url(/path/to/asset)'}.`,\n        );\n      }\n    }\n  }\n}\n\n/** Find artifacts emitted by every styled page, in the first page's order. */\nfunction selectSharedArtifacts(\n  pages: ExtractablePage[],\n): ServerStyleArtifact[] {\n  if (pages.length < 2) return [];\n\n  const source = pages[0].artifacts;\n  const otherIds = pages\n    .slice(1)\n    .map((page) => new Set(page.artifacts.map(({ id }) => id)));\n\n  return source.filter(({ id }) => otherIds.every((ids) => ids.has(id)));\n}\n\nfunction stylesheetHref(\n  base: string,\n  assets: string,\n  filename: string,\n  assetsPrefix?: string | Record<string, string>,\n): string {\n  const assetsPath = assets.replace(/^\\/+|\\/+$/g, '');\n  if (assetsPrefix) {\n    const prefix =\n      typeof assetsPrefix === 'string'\n        ? assetsPrefix\n        : assetsPrefix.css || assetsPrefix.fallback;\n    return `${prefix.replace(/\\/+$/g, '')}/${assetsPath}/${filename}`;\n  }\n\n  const basePath = base === '/' ? '' : `/${base.replace(/^\\/+|\\/+$/g, '')}`;\n  return `${basePath}/${assetsPath}/${filename}`;\n}\n\nfunction stylesheetLink(page: ExtractablePage, href: string): string {\n  const nonceAttr = page.styleOpen.match(/\\snonce=\"[^\"]*\"/)?.[0] ?? '';\n  return `<link rel=\"stylesheet\" href=\"${href}\" data-tasty-ssr${nonceAttr}>`;\n}\n\nfunction transformPage(page: ExtractablePage, hrefs: string[]): string {\n  const replacement = hrefs.map((href) => stylesheetLink(page, href)).join('');\n\n  return (\n    page.html.slice(0, page.styleStart) +\n    replacement +\n    page.html.slice(page.replacementEnd)\n  );\n}\n\nasync function writeStylesheet(\n  assetDir: string,\n  scope: 'shared' | 'page',\n  artifacts: ServerStyleArtifact[],\n): Promise<string | null> {\n  if (artifacts.length === 0) return null;\n\n  const css = artifacts.map(({ css }) => css).join('\\n');\n  const hash = createHash('sha256').update(css).digest('hex').slice(0, 12);\n  const filename = `tasty.${scope}.${hash}.css`;\n  await writeFile(join(assetDir, filename), css);\n  return filename;\n}\n\nexport async function extractAstroCSS(options: {\n  dir: URL;\n  base: string;\n  assets: string;\n  assetsPrefix?: string | Record<string, string>;\n  site?: URL;\n}): Promise<void> {\n  const outputDir = fileURLToPath(options.dir);\n  const paths = await findHTMLFiles(outputDir);\n  const pages = (\n    await Promise.all(\n      paths.map(async (path) =>\n        parseExtractablePage(path, await readFile(path, 'utf8')),\n      ),\n    )\n  ).filter((page): page is ExtractablePage => page !== null);\n  if (pages.length === 0) return;\n  validateExtractedURLs(pages, options.assetsPrefix, options.site);\n\n  const shared = selectSharedArtifacts(pages);\n  const assetDir = join(outputDir, options.assets);\n  await mkdir(assetDir, { recursive: true });\n  const sharedFilename = await writeStylesheet(assetDir, 'shared', shared);\n  const sharedHref = sharedFilename\n    ? stylesheetHref(\n        options.base,\n        options.assets,\n        sharedFilename,\n        options.assetsPrefix,\n      )\n    : null;\n  const sharedIds = new Set(shared.map(({ id }) => id));\n\n  for (const page of pages) {\n    const remainder = page.artifacts.filter(({ id }) => !sharedIds.has(id));\n    const pageFilename = await writeStylesheet(assetDir, 'page', remainder);\n    const hrefs = sharedHref ? [sharedHref] : [];\n    if (pageFilename) {\n      hrefs.push(\n        stylesheetHref(\n          options.base,\n          options.assets,\n          pageFilename,\n          options.assetsPrefix,\n        ),\n      );\n    }\n    await writeFile(page.path, transformPage(page, hrefs));\n  }\n}\n","/**\n * Astro integration for Tasty SSR.\n *\n * Provides:\n * - tastyIntegration() — Astro Integration API (recommended)\n * - tastyMiddleware()  — manual middleware for advanced composition\n *\n * Import from '@tenphi/tasty/ssr/astro'.\n */\n\nimport { getRuntimeConfigState } from '../config-resources';\nimport { getSSRCollector, runWithCollector } from './async-storage';\nimport { createExtractionMetadata, extractAstroCSS } from './astro-extraction';\nimport { ServerStyleCollector } from './collector';\nimport { registerSSRCollectorGetterGlobal } from './ssr-collector-ref';\n\n// Wire up ALS-based collector discovery so computeStyles() can find\n// the collector set by tastyMiddleware's runWithCollector().\n// Uses globalThis so the getter is visible across Astro's separate\n// module graphs (middleware vs page components).\nregisterSSRCollectorGetterGlobal(getSSRCollector);\n\nexport interface TastyMiddlewareOptions {\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\ninterface InternalTastyMiddlewareOptions extends TastyMiddlewareOptions {\n  extractionMetadata?: boolean;\n}\n\n/**\n * Create an Astro middleware that collects Tasty styles during SSR.\n *\n * All React components rendered during the request will have their\n * computeStyles() calls captured by the collector via AsyncLocalStorage.\n * After rendering, the middleware injects the collected CSS into </head>.\n *\n * @example Manual middleware setup\n * ```ts\n * // src/middleware.ts\n * import { tastyMiddleware } from '@tenphi/tasty/ssr/astro';\n * export const onRequest = tastyMiddleware();\n * ```\n *\n * @example Composing with other middleware\n * ```ts\n * // src/middleware.ts\n * import { sequence } from 'astro:middleware';\n * import { tastyMiddleware } from '@tenphi/tasty/ssr/astro';\n *\n * export const onRequest = sequence(\n *   tastyMiddleware(),\n *   myOtherMiddleware,\n * );\n * ```\n */\nexport function tastyMiddleware(options?: TastyMiddlewareOptions) {\n  const internalOptions = options as InternalTastyMiddlewareOptions | undefined;\n  return async (\n    context: { isPrerendered?: boolean },\n    next: () => Promise<Response>,\n  ): Promise<Response> => {\n    const transferCache = options?.transferCache ?? true;\n    const extractionMetadata =\n      internalOptions?.extractionMetadata === true &&\n      context.isPrerendered === true;\n    const collector = new ServerStyleCollector();\n\n    // Run the entire request — including body stream consumption — inside\n    // the ALS context so that components rendering lazily during stream\n    // reads can still find the collector via getSSRCollector().\n    type Rendered =\n      | { response: Response }\n      | { html: string | null; status: number; headers: Headers };\n\n    const rendered = await runWithCollector<Promise<Rendered>>(\n      collector,\n      async (): Promise<Rendered> => {\n        const response = await next();\n        const body = response.body;\n\n        // Only process HTML responses. Reading a non-HTML body (e.g. an\n        // image, font, or JSON endpoint) as UTF-8 text corrupts binary\n        // payloads: every byte >= 0x80 is decoded to U+FFFD and re-encoded\n        // as EF BF BD. Pass anything that isn't HTML straight through.\n        const contentType = response.headers.get('content-type') ?? '';\n        if (!body || !contentType.includes('text/html')) {\n          return { response };\n        }\n\n        const reader = body.pipeThrough(new TextDecoderStream()).getReader();\n        const parts: string[] = [];\n        for (;;) {\n          const { done, value } = await reader.read();\n          if (done) break;\n          parts.push(value);\n        }\n        return {\n          html: parts.join(''),\n          status: response.status,\n          headers: response.headers,\n        };\n      },\n    );\n\n    // Non-HTML responses are returned untouched to avoid corrupting\n    // binary payloads.\n    if ('response' in rendered) {\n      return rendered.response;\n    }\n\n    if (!rendered.html) {\n      return new Response(null, {\n        status: rendered.status,\n        headers: rendered.headers,\n      });\n    }\n\n    let { html } = rendered;\n\n    const css = collector.getCSS();\n    if (!css) {\n      return new Response(html, {\n        status: rendered.status,\n        headers: rendered.headers,\n      });\n    }\n\n    const nonce = getRuntimeConfigState()?.nonce;\n    const nonceAttr = nonce ? ` nonce=\"${nonce}\"` : '';\n    const styleTag = `<style data-tasty-ssr${nonceAttr}>${css}</style>`;\n    const metadataTag = extractionMetadata\n      ? createExtractionMetadata(collector.getArtifacts())\n      : '';\n\n    let cacheTag = '';\n    if (transferCache) {\n      const classNames = collector.getRenderedClassNames();\n      if (classNames.length > 0) {\n        const classListJSON = classNames.map((n) => `\"${n}\"`).join(',');\n        cacheTag = `<script${nonceAttr}>(window.__TASTY__=window.__TASTY__||[]).push(${classListJSON})</script>`;\n      }\n    }\n\n    const injection = styleTag + metadataTag + cacheTag;\n    const idx = html.indexOf('</head>');\n    if (idx !== -1) {\n      html = html.slice(0, idx) + injection + html.slice(idx);\n    } else {\n      html = injection + html;\n    }\n\n    const headers = new Headers(rendered.headers);\n    headers.delete('content-length');\n\n    return new Response(html, {\n      status: rendered.status,\n      headers,\n    });\n  };\n}\n\n// ============================================================================\n// Astro Integration API\n// ============================================================================\n\n/**\n * Package subpaths of the middleware entrypoints registered by\n * `tastyIntegration()`.\n *\n * These must be bare specifiers rather than\n * `new URL('./astro-middleware.js', import.meta.url)`. The bundler is free to\n * hoist `tastyIntegration` into a shared chunk at a different directory depth\n * than `dist/ssr/`, which makes a relative URL resolve to a file that does not\n * exist and breaks the build for every consumer. A package subpath is resolved\n * by the consumer through our `exports` map, so it never depends on the\n * chunk layout.\n *\n * There are separate entrypoints instead of one parameterised entrypoint because\n * `addMiddleware()` cannot pass options: the integration runs when the Astro\n * config is loaded, while the middleware module is evaluated in the server\n * runtime — a different process for built output — so module-level state set\n * by the integration is not visible to the middleware.\n */\nconst MIDDLEWARE_ENTRYPOINT = '@tenphi/tasty/ssr/astro-middleware';\nconst MIDDLEWARE_ENTRYPOINT_STATIC =\n  '@tenphi/tasty/ssr/astro-middleware-static';\nconst MIDDLEWARE_ENTRYPOINT_EXTRACT =\n  '@tenphi/tasty/ssr/astro-middleware-extract';\nconst MIDDLEWARE_ENTRYPOINT_EXTRACT_STATIC =\n  '@tenphi/tasty/ssr/astro-middleware-extract-static';\n\nexport interface TastyIntegrationCSSOptions {\n  /**\n   * CSS delivery mode. Extraction only applies to prerendered builds.\n   * Extracted CSS preserves resource URLs verbatim, so use absolute URLs or\n   * data URLs. Root-relative URLs are also supported unless `assetsPrefix`\n   * sends CSS to an external origin. The build rejects resource URLs whose\n   * targets would change after extraction.\n   */\n  mode?: 'inline' | 'extract';\n}\n\nexport interface TastyIntegrationOptions {\n  /**\n   * Enable island hydration support.\n   *\n   * When `true` (default): injects a client hydration script via\n   * `injectScript('before-hydration')` and sets `transferCache: true`\n   * on the middleware. Islands skip the style pipeline during hydration.\n   *\n   * When `false`: no client JS is shipped and `transferCache` is set\n   * to `false`. Use this for fully static sites without `client:*`\n   * directives.\n   */\n  islands?: boolean;\n  /** Configure inline or build-wide extracted CSS delivery. */\n  css?: TastyIntegrationCSSOptions;\n}\n\n/**\n * Astro integration that automatically sets up Tasty SSR.\n *\n * Registers middleware for cross-component CSS deduplication and\n * optionally injects a client hydration script for island support.\n *\n * @example Basic setup (with islands)\n * ```ts\n * // astro.config.mjs\n * import { tastyIntegration } from '@tenphi/tasty/ssr/astro';\n *\n * export default defineConfig({\n *   integrations: [tastyIntegration()],\n * });\n * ```\n *\n * @example Static-only (no client JS)\n * ```ts\n * // astro.config.mjs\n * import { tastyIntegration } from '@tenphi/tasty/ssr/astro';\n *\n * export default defineConfig({\n *   integrations: [tastyIntegration({ islands: false })],\n * });\n * ```\n */\nexport function tastyIntegration(options?: TastyIntegrationOptions) {\n  const { islands = true } = options ?? {};\n  const cssMode = options?.css?.mode ?? 'inline';\n  let base = '/';\n  let assets = '_astro';\n  let assetsPrefix: string | Record<string, string> | undefined;\n  let site: URL | undefined;\n\n  return {\n    name: '@tenphi/tasty',\n    hooks: {\n      'astro:config:setup': ({\n        addMiddleware,\n        injectScript,\n      }: {\n        addMiddleware: (middleware: {\n          entrypoint: string | URL;\n          order: 'pre' | 'post';\n        }) => void;\n        injectScript: (\n          stage: 'head-inline' | 'before-hydration' | 'page' | 'page-ssr',\n          content: string,\n        ) => void;\n      }) => {\n        addMiddleware({\n          entrypoint:\n            cssMode === 'extract'\n              ? islands\n                ? MIDDLEWARE_ENTRYPOINT_EXTRACT\n                : MIDDLEWARE_ENTRYPOINT_EXTRACT_STATIC\n              : islands\n                ? MIDDLEWARE_ENTRYPOINT\n                : MIDDLEWARE_ENTRYPOINT_STATIC,\n          order: 'pre',\n        });\n\n        if (islands) {\n          injectScript(\n            'before-hydration',\n            `import \"@tenphi/tasty/ssr/astro-client\";`,\n          );\n        }\n      },\n      'astro:config:done': ({\n        config,\n      }: {\n        config: {\n          base?: string;\n          site?: URL;\n          build?: {\n            assets?: string;\n            assetsPrefix?: string | Record<string, string>;\n          };\n        };\n      }) => {\n        base = config.base ?? '/';\n        assets = config.build?.assets ?? '_astro';\n        assetsPrefix = config.build?.assetsPrefix;\n        site = config.site;\n      },\n      'astro:build:done': async ({ dir }: { dir: URL }) => {\n        if (cssMode !== 'extract') return;\n        await extractAstroCSS({ dir, base, assets, assetsPrefix, site });\n      },\n    },\n  };\n}\n"],"mappings":"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"}

package/dist/ssr/index.d.ts

@@ -1,4 +1,37 @@
-import { SSRCacheState, ServerStyleCollector } from "./collector.js";
-import { hydrateTastyCache } from "./hydrate.js";
-import { getSSRCollector, runWithCollector } from "./async-storage.js";
-export { type SSRCacheState, ServerStyleCollector, getSSRCollector, hydrateTastyCache, runWithCollector };
+import { i as ServerStyleArtifactKind, n as createServerStyleCollector, r as ServerStyleArtifact, t as ServerStyleCollector } from "../collector-hl5KNH7k.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;
+/**
+ * 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;
+//#endregion
+//#region src/ssr/hydrate.d.ts
+/**
+ * Client-side cache hydration for SSR/RSC.
+ *
+ * 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.
+ */
+/**
+ * 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.
+ *
+ * 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;
+//#endregion
+export { type ServerStyleArtifact, type ServerStyleArtifactKind, ServerStyleCollector, createServerStyleCollector, getSSRCollector, hydrateTastyClasses, runWithCollector };
+//# sourceMappingURL=index.d.ts.map

package/dist/ssr/index.js

@@ -1,10 +1,10 @@
-import { registerSSRCollectorGetter } from "./ssr-collector-ref.js";
-import { ServerStyleCollector } from "./collector.js";
-import { getSSRCollector, runWithCollector } from "./async-storage.js";
-import { hydrateTastyCache } from "./hydrate.js";
+import { r as registerSSRCollectorGetterGlobal } from "../chunks/runtime-state-BTDqSYBk.js";
+import { n as createServerStyleCollector, t as ServerStyleCollector } from "../chunks/collector-B0LTHw6Z.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
-registerSSRCollectorGetter(getSSRCollector);
+registerSSRCollectorGetterGlobal(getSSRCollector);
 //#endregion
-export { ServerStyleCollector, getSSRCollector, hydrateTastyCache, runWithCollector };
+export { ServerStyleCollector, createServerStyleCollector, getSSRCollector, hydrateTastyClasses, runWithCollector };
 
 //# sourceMappingURL=index.js.map

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 } 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.\nimport { getSSRCollector } from './async-storage';\nimport { registerSSRCollectorGetter } from './ssr-collector-ref';\n\nregisterSSRCollectorGetter(getSSRCollector);\n"],"mappings":";;;;;AAwBA,2BAA2B,gBAAgB"}
+{"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,66 @@
+import { t as TastyConfig } from "../config-DWL1ZYue.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;
+}
+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.
+ */
+declare function withTastyNext(options: TastyNextOptions): (nextConfig?: NextConfig) => NextConfig;
+//#endregion
+export { TastyNextOptions, withTastyNext };
+//# sourceMappingURL=next-config.d.ts.map

package/dist/ssr/next-config.js

@@ -0,0 +1,124 @@
+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-D_it4XZH.js";
+import { b as renderStyles } from "../chunks/style-engine-C1ECBZxR.js";
+import { n as functionsForExtraction, r as resetZeroConfig, t as configureZero } from "../chunks/build-config-CUQVwdWF.js";
+import { t as findUnsafeCSSResource } from "../chunks/css-resources-BN8apgxt.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) append("global", "__global:tokens", formatGlobalRules(renderStyles(normalized.tokens, ":root")));
+		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 relativePath = relative(resolve(projectDir, "public"), 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":"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"}