@tenphi/tasty 3.0.0 → 3.0.2

package/dist/ssr/astro-middleware.d.ts

@@ -1,13 +1,15 @@
 //#region src/ssr/astro-middleware.d.ts
 /**
- * Astro middleware entrypoint for tastyIntegration().
+ * Astro middleware entrypoint for `tastyIntegration()`.
  *
- * Referenced by the integration via addMiddleware(). Not intended
- * as a public package export — use tastyMiddleware() directly if
- * you need manual middleware composition.
+ * Registered via `addMiddleware()` as `@tenphi/tasty/ssr/astro-middleware`.
+ * Exposed as a package subpath only so Astro can resolve it — use
+ * `tastyMiddleware()` directly if you need manual middleware composition.
  *
- * The transferCache setting is controlled by setMiddlewareTransferCache(),
- * called by tastyIntegration() before middleware is loaded.
+ * This is the islands variant: the rendered class list is transferred to the
+ * client so hydrating islands skip the style pipeline. See
+ * `./astro-middleware-static` for the variant used by
+ * `tastyIntegration({ islands: false })`.
  */
 declare const onRequest: (_context: unknown, next: () => Promise<Response>) => Promise<Response>;
 //#endregion

package/dist/ssr/astro-middleware.js

@@ -1,18 +1,18 @@
-import { n as tastyMiddleware, r as getMiddlewareTransferCache } from "../astro-B53trJyX.js";
+import { tastyMiddleware } from "./astro.js";
 //#region src/ssr/astro-middleware.ts
 /**
-* Astro middleware entrypoint for tastyIntegration().
+* Astro middleware entrypoint for `tastyIntegration()`.
 *
-* Referenced by the integration via addMiddleware(). Not intended
-* as a public package export — use tastyMiddleware() directly if
-* you need manual middleware composition.
+* Registered via `addMiddleware()` as `@tenphi/tasty/ssr/astro-middleware`.
+* Exposed as a package subpath only so Astro can resolve it — use
+* `tastyMiddleware()` directly if you need manual middleware composition.
 *
-* The transferCache setting is controlled by setMiddlewareTransferCache(),
-* called by tastyIntegration() before middleware is loaded.
+* This is the islands variant: the rendered class list is transferred to the
+* client so hydrating islands skip the style pipeline. See
+* `./astro-middleware-static` for the variant used by
+* `tastyIntegration({ islands: false })`.
 */
-const onRequest = tastyMiddleware({ get transferCache() {
-	return getMiddlewareTransferCache();
-} });
+const onRequest = tastyMiddleware({ transferCache: true });
 //#endregion
 export { onRequest };
 

package/dist/ssr/astro-middleware.js.map

@@ -1 +1 @@
-{"version":3,"file":"astro-middleware.js","names":[],"sources":["../../src/ssr/astro-middleware.ts"],"sourcesContent":["/**\n * Astro middleware entrypoint for tastyIntegration().\n *\n * Referenced by the integration via addMiddleware(). Not intended\n * as a public package export — use tastyMiddleware() directly if\n * you need manual middleware composition.\n *\n * The transferCache setting is controlled by setMiddlewareTransferCache(),\n * called by tastyIntegration() before middleware is loaded.\n */\n\nimport { getMiddlewareTransferCache } from './astro-transfer-cache';\nimport { tastyMiddleware } from './astro';\n\nexport const onRequest = tastyMiddleware({\n  get transferCache() {\n    return getMiddlewareTransferCache();\n  },\n});\n"],"mappings":";;;;;;;;;;;;AAcA,MAAa,YAAY,gBAAgB,EACvC,IAAI,gBAAgB;CAClB,OAAO,2BAA2B;AACpC,EACF,CAAC"}
+{"version":3,"file":"astro-middleware.js","names":[],"sources":["../../src/ssr/astro-middleware.ts"],"sourcesContent":["/**\n * Astro middleware entrypoint for `tastyIntegration()`.\n *\n * Registered via `addMiddleware()` as `@tenphi/tasty/ssr/astro-middleware`.\n * Exposed as a package subpath only so Astro can resolve it — use\n * `tastyMiddleware()` directly if you need manual middleware composition.\n *\n * This is the islands variant: the rendered class list is transferred to the\n * client so hydrating islands skip the style pipeline. See\n * `./astro-middleware-static` for the variant used by\n * `tastyIntegration({ islands: false })`.\n */\n\nimport { tastyMiddleware } from './astro';\n\nexport const onRequest = tastyMiddleware({ transferCache: true });\n"],"mappings":";;;;;;;;;;;;;;AAeA,MAAa,YAAY,gBAAgB,EAAE,eAAe,KAAK,CAAC"}

package/dist/ssr/astro.js

@@ -1,2 +1,157 @@
-import { n as tastyMiddleware, t as tastyIntegration } from "../astro-B53trJyX.js";
+import { n as getConfig } from "../config-DOCuTykY.js";
+import { a as registerSSRCollectorGetterGlobal } from "../format-rules-Cb0YIjyS.js";
+import { t as ServerStyleCollector } from "../collector-BpkjNQDo.js";
+import { n as runWithCollector, t as getSSRCollector } from "../async-storage-DKK-wTD4.js";
+//#region src/ssr/astro.ts
+/**
+* Astro integration for Tasty SSR.
+*
+* Provides:
+* - tastyIntegration() — Astro Integration API (recommended)
+* - tastyMiddleware()  — manual middleware for advanced composition
+*
+* Import from '@tenphi/tasty/ssr/astro'.
+*/
+registerSSRCollectorGetterGlobal(getSSRCollector);
+/**
+* Create an Astro middleware that collects Tasty styles during SSR.
+*
+* All React components rendered during the request will have their
+* computeStyles() calls captured by the collector via AsyncLocalStorage.
+* After rendering, the middleware injects the collected CSS into </head>.
+*
+* @example Manual middleware setup
+* ```ts
+* // src/middleware.ts
+* import { tastyMiddleware } from '@tenphi/tasty/ssr/astro';
+* export const onRequest = tastyMiddleware();
+* ```
+*
+* @example Composing with other middleware
+* ```ts
+* // src/middleware.ts
+* import { sequence } from 'astro:middleware';
+* import { tastyMiddleware } from '@tenphi/tasty/ssr/astro';
+*
+* export const onRequest = sequence(
+*   tastyMiddleware(),
+*   myOtherMiddleware,
+* );
+* ```
+*/
+function tastyMiddleware(options) {
+	return async (_context, next) => {
+		const transferCache = options?.transferCache ?? true;
+		const collector = new ServerStyleCollector();
+		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 new Response(html, {
+			status: rendered.status,
+			headers: rendered.headers
+		});
+		const nonce = getConfig().nonce;
+		const nonceAttr = nonce ? ` nonce="${nonce}"` : "";
+		const styleTag = `<style data-tasty-ssr${nonceAttr}>${css}</style>`;
+		let cacheTag = "";
+		if (transferCache) {
+			const classNames = collector.getRenderedClassNames();
+			if (classNames.length > 0) cacheTag = `<script${nonceAttr}>(window.__TASTY__=window.__TASTY__||[]).push(${classNames.map((n) => `"${n}"`).join(",")})<\/script>`;
+		}
+		const injection = styleTag + 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
+		});
+	};
+}
+/**
+* Package subpaths of the middleware entrypoints registered by
+* `tastyIntegration()`.
+*
+* These must be bare specifiers rather than
+* `new URL('./astro-middleware.js', import.meta.url)`. The bundler is free to
+* hoist `tastyIntegration` into a shared chunk at a different directory depth
+* than `dist/ssr/`, which makes a relative URL resolve to a file that does not
+* exist and breaks the build for every consumer. A package subpath is resolved
+* by the consumer through our `exports` map, so it never depends on the
+* chunk layout.
+*
+* There are two entrypoints instead of one parameterised entrypoint because
+* `addMiddleware()` cannot pass options: the integration runs when the Astro
+* config is loaded, while the middleware module is evaluated in the server
+* runtime — a different process for built output — so module-level state set
+* by the integration is not visible to the middleware.
+*/
+const MIDDLEWARE_ENTRYPOINT = "@tenphi/tasty/ssr/astro-middleware";
+const MIDDLEWARE_ENTRYPOINT_STATIC = "@tenphi/tasty/ssr/astro-middleware-static";
+/**
+* Astro integration that automatically sets up Tasty SSR.
+*
+* Registers middleware for cross-component CSS deduplication and
+* optionally injects a client hydration script for island support.
+*
+* @example Basic setup (with islands)
+* ```ts
+* // astro.config.mjs
+* import { tastyIntegration } from '@tenphi/tasty/ssr/astro';
+*
+* export default defineConfig({
+*   integrations: [tastyIntegration()],
+* });
+* ```
+*
+* @example Static-only (no client JS)
+* ```ts
+* // astro.config.mjs
+* import { tastyIntegration } from '@tenphi/tasty/ssr/astro';
+*
+* export default defineConfig({
+*   integrations: [tastyIntegration({ islands: false })],
+* });
+* ```
+*/
+function tastyIntegration(options) {
+	const { islands = true } = options ?? {};
+	return {
+		name: "@tenphi/tasty",
+		hooks: { "astro:config:setup": ({ addMiddleware, injectScript }) => {
+			addMiddleware({
+				entrypoint: islands ? MIDDLEWARE_ENTRYPOINT : MIDDLEWARE_ENTRYPOINT_STATIC,
+				order: "pre"
+			});
+			if (islands) injectScript("before-hydration", `import "@tenphi/tasty/ssr/astro-client";`);
+		} }
+	};
+}
+//#endregion
 export { tastyIntegration, tastyMiddleware };
+
+//# sourceMappingURL=astro.js.map

package/dist/ssr/astro.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"astro.js","names":[],"sources":["../../src/ssr/astro.ts"],"sourcesContent":["/**\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 { getConfig } from '../config';\nimport { getSSRCollector, runWithCollector } from './async-storage';\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\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  return async (\n    _context: unknown,\n    next: () => Promise<Response>,\n  ): Promise<Response> => {\n    const transferCache = options?.transferCache ?? 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 = getConfig().nonce;\n    const nonceAttr = nonce ? ` nonce=\"${nonce}\"` : '';\n    const styleTag = `<style data-tasty-ssr${nonceAttr}>${css}</style>`;\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 + 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 two 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';\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}\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  name: string;\n  hooks: Record<string, (...args: never[]) => void>;\n} {\n  const { islands = true } = options ?? {};\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: 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    },\n  };\n}\n"],"mappings":";;;;;;;;;;;;;;AAmBA,iCAAiC,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;AAsChD,SAAgB,gBAAgB,SAAkC;CAChE,OAAO,OACL,UACA,SACsB;EACtB,MAAM,gBAAgB,SAAS,iBAAiB;EAChD,MAAM,YAAY,IAAI,qBAAqB;EAS3C,MAAM,WAAW,MAAM,iBACrB,WACA,YAA+B;GAC7B,MAAM,WAAW,MAAM,KAAK;GAC5B,MAAM,OAAO,SAAS;GAMtB,MAAM,cAAc,SAAS,QAAQ,IAAI,cAAc,KAAK;GAC5D,IAAI,CAAC,QAAQ,CAAC,YAAY,SAAS,WAAW,GAC5C,OAAO,EAAE,SAAS;GAGpB,MAAM,SAAS,KAAK,YAAY,IAAI,kBAAkB,CAAC,CAAC,CAAC,UAAU;GACnE,MAAM,QAAkB,CAAC;GACzB,SAAS;IACP,MAAM,EAAE,MAAM,UAAU,MAAM,OAAO,KAAK;IAC1C,IAAI,MAAM;IACV,MAAM,KAAK,KAAK;GAClB;GACA,OAAO;IACL,MAAM,MAAM,KAAK,EAAE;IACnB,QAAQ,SAAS;IACjB,SAAS,SAAS;GACpB;EACF,CACF;EAIA,IAAI,cAAc,UAChB,OAAO,SAAS;EAGlB,IAAI,CAAC,SAAS,MACZ,OAAO,IAAI,SAAS,MAAM;GACxB,QAAQ,SAAS;GACjB,SAAS,SAAS;EACpB,CAAC;EAGH,IAAI,EAAE,SAAS;EAEf,MAAM,MAAM,UAAU,OAAO;EAC7B,IAAI,CAAC,KACH,OAAO,IAAI,SAAS,MAAM;GACxB,QAAQ,SAAS;GACjB,SAAS,SAAS;EACpB,CAAC;EAGH,MAAM,QAAQ,UAAU,CAAC,CAAC;EAC1B,MAAM,YAAY,QAAQ,WAAW,MAAM,KAAK;EAChD,MAAM,WAAW,wBAAwB,UAAU,GAAG,IAAI;EAE1D,IAAI,WAAW;EACf,IAAI,eAAe;GACjB,MAAM,aAAa,UAAU,sBAAsB;GACnD,IAAI,WAAW,SAAS,GAEtB,WAAW,UAAU,UAAU,gDADT,WAAW,KAAK,MAAM,IAAI,EAAE,EAAE,CAAC,CAAC,KAAK,GACgC,EAAE;EAEjG;EAEA,MAAM,YAAY,WAAW;EAC7B,MAAM,MAAM,KAAK,QAAQ,SAAS;EAClC,IAAI,QAAQ,IACV,OAAO,KAAK,MAAM,GAAG,GAAG,IAAI,YAAY,KAAK,MAAM,GAAG;OAEtD,OAAO,YAAY;EAGrB,MAAM,UAAU,IAAI,QAAQ,SAAS,OAAO;EAC5C,QAAQ,OAAO,gBAAgB;EAE/B,OAAO,IAAI,SAAS,MAAM;GACxB,QAAQ,SAAS;GACjB;EACF,CAAC;CACH;AACF;;;;;;;;;;;;;;;;;;;AAwBA,MAAM,wBAAwB;AAC9B,MAAM,+BACJ;;;;;;;;;;;;;;;;;;;;;;;;;;;AA2CF,SAAgB,iBAAiB,SAG/B;CACA,MAAM,EAAE,UAAU,SAAS,WAAW,CAAC;CAEvC,OAAO;EACL,MAAM;EACN,OAAO,EACL,uBAAuB,EACrB,eACA,mBAUI;GACJ,cAAc;IACZ,YAAY,UACR,wBACA;IACJ,OAAO;GACT,CAAC;GAED,IAAI,SACF,aACE,oBACA,0CACF;EAEJ,EACF;CACF;AACF"}

package/dist/ssr/index.d.ts

@@ -1,4 +1,4 @@
-import { n as createServerStyleCollector, t as ServerStyleCollector } from "../collector-BPzZezAG.js";
+import { n as createServerStyleCollector, t as ServerStyleCollector } from "../collector-D8o4Wdq-.js";
 
 //#region src/ssr/async-storage.d.ts
 /**

package/dist/ssr/index.js

@@ -1,7 +1,7 @@
-import { a as registerSSRCollectorGetterGlobal } from "../format-rules-BbKDjsfO.js";
-import { n as createServerStyleCollector, t as ServerStyleCollector } from "../collector-D14DcZx9.js";
+import { a as registerSSRCollectorGetterGlobal } from "../format-rules-Cb0YIjyS.js";
+import { n as createServerStyleCollector, t as ServerStyleCollector } from "../collector-BpkjNQDo.js";
 import { n as runWithCollector, t as getSSRCollector } from "../async-storage-DKK-wTD4.js";
-import { t as hydrateTastyClasses } from "../hydrate-CwALW3J9.js";
+import { t as hydrateTastyClasses } from "../hydrate-xnaB3SDm.js";
 //#region src/ssr/index.ts
 registerSSRCollectorGetterGlobal(getSSRCollector);
 //#endregion

package/dist/ssr/next.d.ts

@@ -1,4 +1,4 @@
-import { t as ServerStyleCollector } from "../collector-BPzZezAG.js";
+import { t as ServerStyleCollector } from "../collector-D8o4Wdq-.js";
 import { ReactNode } from "react";
 
 //#region src/ssr/next.d.ts

package/dist/ssr/next.js

@@ -1,9 +1,9 @@
 "use client";
-import { n as getConfig } from "../config-CCcE_tqx.js";
-import { i as registerSSRCollectorGetter } from "../format-rules-BbKDjsfO.js";
+import { n as getConfig } from "../config-DOCuTykY.js";
+import { i as registerSSRCollectorGetter } from "../format-rules-Cb0YIjyS.js";
 import { t as getTastySSRContext } from "../context-CA8YKeMn.js";
-import { t as ServerStyleCollector } from "../collector-D14DcZx9.js";
-import { t as hydrateTastyClasses } from "../hydrate-CwALW3J9.js";
+import { t as ServerStyleCollector } from "../collector-BpkjNQDo.js";
+import { t as hydrateTastyClasses } from "../hydrate-xnaB3SDm.js";
 import { Fragment, createElement, useState } from "react";
 import { useServerInsertedHTML } from "next/navigation";
 //#region src/ssr/next.ts

package/dist/static/index.d.ts

@@ -1,5 +1,5 @@
-import { b as Styles } from "../index-l_NdJSUS.js";
-import { t as mergeStyles } from "../merge-styles-NEvqayL_.js";
+import { b as Styles } from "../index-KUYya3x7.js";
+import { t as mergeStyles } from "../merge-styles-DLm4wdnb.js";
 
 //#region src/static/types.d.ts
 /**

package/dist/static/index.js

@@ -1,4 +1,4 @@
-import { t as mergeStyles } from "../merge-styles--1zOSFlS.js";
+import { t as mergeStyles } from "../merge-styles-B0lMso5W.js";
 //#region src/static/types.ts
 /**
 * Create a StaticStyle object.

package/dist/zero/babel.d.ts

@@ -1,2 +1,2 @@
-import { n as _default, r as TastyZeroConfig, t as TastyZeroBabelOptions } from "../babel-HlEpSZrj.js";
+import { n as _default, r as TastyZeroConfig, t as TastyZeroBabelOptions } from "../babel-R2qT7yLN.js";
 export { TastyZeroBabelOptions, type TastyZeroConfig, _default as default };

package/dist/zero/babel.js

@@ -1,7 +1,7 @@
-import { b as resetConfig, d as getGlobalStyles, i as getGlobalConfigTokens, s as getGlobalFunctions, t as configure } from "../config-CCcE_tqx.js";
-import { t as mergeStyles } from "../merge-styles--1zOSFlS.js";
-import { t as resolveRecipes } from "../resolve-recipes-Caix5NnH.js";
-import { a as extractFunctionsFromStyles, c as extractStylesForSelector, i as extractFontFaceFromStyles, l as extractStylesWithChunks, o as extractKeyframesFromStyles, r as extractCounterStyleFromStyles, s as extractPropertiesFromStyles, t as CSSWriter, u as setExtractorNamePrefix } from "../css-writer-B5DBoxhf.js";
+import { b as resetConfig, d as getGlobalStyles, i as getGlobalConfigTokens, s as getGlobalFunctions, t as configure } from "../config-DOCuTykY.js";
+import { t as mergeStyles } from "../merge-styles-B0lMso5W.js";
+import { t as resolveRecipes } from "../resolve-recipes-C9nAuwgR.js";
+import { a as extractFunctionsFromStyles, c as extractStylesForSelector, i as extractFontFaceFromStyles, l as extractStylesWithChunks, o as extractKeyframesFromStyles, r as extractCounterStyleFromStyles, s as extractPropertiesFromStyles, t as CSSWriter, u as setExtractorNamePrefix } from "../css-writer-BHjTF0YN.js";
 import * as fs from "fs";
 import * as path from "path";
 import { declare } from "@babel/helper-plugin-utils";

package/dist/zero/index.d.ts

@@ -1,4 +1,4 @@
-import { b as Styles } from "../index-l_NdJSUS.js";
+import { b as Styles } from "../index-KUYya3x7.js";
 
 //#region src/zero/extractor.d.ts
 interface ExtractedChunk {

package/dist/zero/index.js

@@ -1,2 +1,2 @@
-import { c as extractStylesForSelector, l as extractStylesWithChunks, n as createCSSWriter, t as CSSWriter } from "../css-writer-B5DBoxhf.js";
+import { c as extractStylesForSelector, l as extractStylesWithChunks, n as createCSSWriter, t as CSSWriter } from "../css-writer-BHjTF0YN.js";
 export { CSSWriter, createCSSWriter, extractStylesForSelector, extractStylesWithChunks };

package/dist/zero/next.d.ts

@@ -1,4 +1,4 @@
-import { r as TastyZeroConfig } from "../babel-HlEpSZrj.js";
+import { r as TastyZeroConfig } from "../babel-R2qT7yLN.js";
 
 //#region src/zero/next.d.ts
 interface WebpackConfigContext {

package/docs/ai-agents.md

@@ -70,6 +70,9 @@ The last row goes the other way — longhands over the shorthand — because `fl
 - ❌ `#f5f5f5`, `rgb(0 0 0)`, `oklch(…)`, `okhsl(…)`, `red` → ✅ `#surface` (add the token to the config if it doesn't exist).
 - ❌ `var(--gap)` → ✅ `$gap` · ❌ `$accent-color` → ✅ `#accent` · ❌ `transparent` → ✅ `#clear` · ❌ `currentColor` → ✅ `#current`.
 - A `$name` must be declared as a `'$name': value` key in the same styles object, or in the config.
+- Names are case-sensitive and start lowercase — `$myVar` → `--myVar`; a leading capital folds (`$Foo` → `--foo`). Prefer kebab-case.
+- A `$name` reference is untyped: it fills the first free slot in a shorthand (`border: '1bw $my-style'` → the line style). Write colors as `#name`; `$name-color` is a fallback for pointing at a raw CSS custom property that holds a color.
+- `preset` and `transition` take token *names*, not values, so a `$name` cannot stand in for one (it warns in dev and is ignored).
 
 ### Units
 

package/docs/configuration.md

@@ -164,6 +164,7 @@ configure({
 
 - `$name` keys become `--name` CSS custom properties
 - `#name` keys become `--name-color` and `--name-color-{colorSpace}` properties (suffix depends on `colorSpace`, default `oklch`)
+- Names keep their case, since CSS custom properties are case-sensitive: `$myVar` is `--myVar` and is referenced as `$myVar`. A leading capital is not supported and folds — `$Foo` and `#Purple` become `--foo` and `--purple-color` — so start names lowercase. Kebab-case (`$my-var`) remains the convention.
 
 Tokens are automatically emitted in all rendering modes: runtime (client), SSR, and zero-runtime (Babel plugin).
 

package/docs/ssr.md

@@ -354,6 +354,7 @@ const stream = await runWithCollector(collector, () =>
 | `@tenphi/tasty/ssr/next` | Next.js App Router: `TastyRegistry` component |
 | `@tenphi/tasty/ssr/astro` | Astro: `tastyIntegration`, `tastyMiddleware` |
 | `@tenphi/tasty/ssr/astro-client` | Astro: client-side cache hydration (auto-injected by integration, or import manually) |
+| `@tenphi/tasty/ssr/astro-middleware`<br>`@tenphi/tasty/ssr/astro-middleware-static` | Astro: the middleware entrypoints `tastyIntegration()` registers via `addMiddleware()`. Exported so Astro can resolve them by specifier; you should not import them. For manual setups use `tastyMiddleware()`. |
 
 ### `ServerStyleCollector`
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tenphi/tasty",
-  "version": "3.0.0",
+  "version": "3.0.2",
   "description": "A design-system-integrated styling system and DSL for concise, state-aware UI styling",
   "type": "module",
   "main": "./dist/index.js",
@@ -62,6 +62,16 @@
       "import": "./dist/ssr/astro-client.js",
       "default": "./dist/ssr/astro-client.js"
     },
+    "./ssr/astro-middleware": {
+      "types": "./dist/ssr/astro-middleware.d.ts",
+      "import": "./dist/ssr/astro-middleware.js",
+      "default": "./dist/ssr/astro-middleware.js"
+    },
+    "./ssr/astro-middleware-static": {
+      "types": "./dist/ssr/astro-middleware-static.d.ts",
+      "import": "./dist/ssr/astro-middleware-static.js",
+      "default": "./dist/ssr/astro-middleware-static.js"
+    },
     "./tasty.config": "./tasty.config.ts"
   },
   "files": [
@@ -73,7 +83,9 @@
     "./dist/ssr/index.js",
     "./dist/ssr/next.js",
     "./dist/ssr/astro.js",
-    "./dist/ssr/astro-client.js"
+    "./dist/ssr/astro-client.js",
+    "./dist/ssr/astro-middleware.js",
+    "./dist/ssr/astro-middleware-static.js"
   ],
   "engines": {
     "node": ">=20"
@@ -146,39 +158,39 @@
     "@types/babel__helper-plugin-utils": "^7.10.3",
     "@types/node": "^25.3.2",
     "@types/react": "^19.0.0",
+    "@vitest/browser-playwright": "^4.1.10",
     "eslint": "^10.0.0",
     "eslint-config-prettier": "^10.1.8",
-    "happy-dom": "^20.9.0",
     "jiti": "^2.6.1",
-    "jsdom": "^29.0.2",
     "knip": "^5.61.3",
     "next": "^16.0.0",
+    "playwright": "^1.62.1",
     "prettier": "^3.8.1",
     "react": "^19.0.0",
     "size-limit": "^12.0.0",
     "tsdown": "^0.22.0",
     "typescript": "^6.0.2",
     "typescript-eslint": "^8.56.0",
-    "vitest": "^4.0.18"
+    "vitest": "^4.1.10"
   },
   "size-limit": [
     {
       "name": "main (import *)",
       "path": "dist/index.js",
       "import": "*",
-      "limit": "57 kB"
+      "limit": "57.5 kB"
     },
     {
       "name": "core (import *)",
       "path": "dist/core/index.js",
       "import": "*",
-      "limit": "54 kB"
+      "limit": "54.5 kB"
     },
     {
       "name": "static",
       "path": "dist/static/index.js",
       "import": "*",
-      "limit": "18.5 kB"
+      "limit": "18.75 kB"
     },
     {
       "name": "zero",
@@ -189,7 +201,7 @@
         "path",
         "crypto"
       ],
-      "limit": "33 kB"
+      "limit": "33.25 kB"
     },
     {
       "name": "babel-plugin",
@@ -200,12 +212,15 @@
         "path",
         "crypto"
       ],
-      "limit": "50.5 kB"
+      "limit": "50.75 kB"
     }
   ],
   "scripts": {
     "build": "tsdown",
     "test": "vitest run",
+    "test:node": "vitest run --project node",
+    "test:browser": "vitest run --project browser",
+    "test:setup": "playwright install chromium",
     "test:watch": "vitest",
     "test:coverage": "vitest run --coverage",
     "typecheck": "tsc --noEmit",
@@ -214,7 +229,8 @@
     "format": "prettier --write \"src/**/*.{ts,tsx}\"",
     "format:check": "prettier --check \"src/**/*.{ts,tsx}\"",
     "size": "size-limit",
-    "bench": "vitest bench",
+    "bench": "vitest bench --project node",
+    "bench:browser": "vitest bench --project browser",
     "changeset": "changeset",
     "version": "changeset version",
     "release": "changeset publish",

package/dist/astro-B53trJyX.js

@@ -1,156 +0,0 @@
-import { n as getConfig } from "./config-CCcE_tqx.js";
-import { a as registerSSRCollectorGetterGlobal } from "./format-rules-BbKDjsfO.js";
-import { t as ServerStyleCollector } from "./collector-D14DcZx9.js";
-import { n as runWithCollector, t as getSSRCollector } from "./async-storage-DKK-wTD4.js";
-//#region src/ssr/astro-transfer-cache.ts
-/**
-* Internal module-level state for the Astro middleware transfer-cache flag.
-*
-* Set by `tastyIntegration` and read by `astro-middleware.ts`. Kept in a
-* separate non-exported module so it does not appear on the public API
-* surface of `@tenphi/tasty/ssr/astro`.
-*/
-let _middlewareTransferCache = true;
-/** @internal */
-function setMiddlewareTransferCache(value) {
-	_middlewareTransferCache = value;
-}
-/** @internal */
-function getMiddlewareTransferCache() {
-	return _middlewareTransferCache;
-}
-//#endregion
-//#region src/ssr/astro.ts
-/**
-* Astro integration for Tasty SSR.
-*
-* Provides:
-* - tastyIntegration() — Astro Integration API (recommended)
-* - tastyMiddleware()  — manual middleware for advanced composition
-*
-* Import from '@tenphi/tasty/ssr/astro'.
-*/
-registerSSRCollectorGetterGlobal(getSSRCollector);
-/**
-* Create an Astro middleware that collects Tasty styles during SSR.
-*
-* All React components rendered during the request will have their
-* computeStyles() calls captured by the collector via AsyncLocalStorage.
-* After rendering, the middleware injects the collected CSS into </head>.
-*
-* @example Manual middleware setup
-* ```ts
-* // src/middleware.ts
-* import { tastyMiddleware } from '@tenphi/tasty/ssr/astro';
-* export const onRequest = tastyMiddleware();
-* ```
-*
-* @example Composing with other middleware
-* ```ts
-* // src/middleware.ts
-* import { sequence } from 'astro:middleware';
-* import { tastyMiddleware } from '@tenphi/tasty/ssr/astro';
-*
-* export const onRequest = sequence(
-*   tastyMiddleware(),
-*   myOtherMiddleware,
-* );
-* ```
-*/
-function tastyMiddleware(options) {
-	return async (_context, next) => {
-		const transferCache = options?.transferCache ?? true;
-		const collector = new ServerStyleCollector();
-		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 new Response(html, {
-			status: rendered.status,
-			headers: rendered.headers
-		});
-		const nonce = getConfig().nonce;
-		const nonceAttr = nonce ? ` nonce="${nonce}"` : "";
-		const styleTag = `<style data-tasty-ssr${nonceAttr}>${css}</style>`;
-		let cacheTag = "";
-		if (transferCache) {
-			const classNames = collector.getRenderedClassNames();
-			if (classNames.length > 0) cacheTag = `<script${nonceAttr}>(window.__TASTY__=window.__TASTY__||[]).push(${classNames.map((n) => `"${n}"`).join(",")})<\/script>`;
-		}
-		const injection = styleTag + 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
-		});
-	};
-}
-/**
-* Astro integration that automatically sets up Tasty SSR.
-*
-* Registers middleware for cross-component CSS deduplication and
-* optionally injects a client hydration script for island support.
-*
-* @example Basic setup (with islands)
-* ```ts
-* // astro.config.mjs
-* import { tastyIntegration } from '@tenphi/tasty/ssr/astro';
-*
-* export default defineConfig({
-*   integrations: [tastyIntegration()],
-* });
-* ```
-*
-* @example Static-only (no client JS)
-* ```ts
-* // astro.config.mjs
-* import { tastyIntegration } from '@tenphi/tasty/ssr/astro';
-*
-* export default defineConfig({
-*   integrations: [tastyIntegration({ islands: false })],
-* });
-* ```
-*/
-function tastyIntegration(options) {
-	const { islands = true } = options ?? {};
-	setMiddlewareTransferCache(islands);
-	return {
-		name: "@tenphi/tasty",
-		hooks: { "astro:config:setup": ({ addMiddleware, injectScript }) => {
-			addMiddleware({
-				entrypoint: new URL("./astro-middleware.js", import.meta.url),
-				order: "pre"
-			});
-			if (islands) injectScript("before-hydration", `import "@tenphi/tasty/ssr/astro-client";`);
-		} }
-	};
-}
-//#endregion
-export { tastyMiddleware as n, getMiddlewareTransferCache as r, tastyIntegration as t };
-
-//# sourceMappingURL=astro-B53trJyX.js.map