@pyreon/server 0.12.0 → 0.12.2

package/lib/analysis/index.js.html

@@ -5386,7 +5386,7 @@ var drawChart = (function (exports) {
   </script>
   <script>
     /*<!--*/
-    const data = {"version":2,"tree":{"name":"root","children":[{"name":"index.js","children":[{"name":"home/runner/work/pyreon/pyreon/packages/core/head/lib/ssr.js","uid":"8b63d05d-1"},{"name":"src","children":[{"uid":"8b63d05d-3","name":"html.ts"},{"uid":"8b63d05d-5","name":"handler.ts"},{"uid":"8b63d05d-7","name":"island.ts"},{"uid":"8b63d05d-9","name":"ssg.ts"},{"uid":"8b63d05d-11","name":"index.ts"}]}]}],"isRoot":true},"nodeParts":{"8b63d05d-1":{"renderedLength":2713,"gzipLength":1078,"brotliLength":0,"metaUid":"8b63d05d-0"},"8b63d05d-3":{"renderedLength":2797,"gzipLength":1166,"brotliLength":0,"metaUid":"8b63d05d-2"},"8b63d05d-5":{"renderedLength":2930,"gzipLength":1274,"brotliLength":0,"metaUid":"8b63d05d-4"},"8b63d05d-7":{"renderedLength":1444,"gzipLength":673,"brotliLength":0,"metaUid":"8b63d05d-6"},"8b63d05d-9":{"renderedLength":2806,"gzipLength":1214,"brotliLength":0,"metaUid":"8b63d05d-8"},"8b63d05d-11":{"renderedLength":0,"gzipLength":0,"brotliLength":0,"metaUid":"8b63d05d-10"}},"nodeMetas":{"8b63d05d-0":{"id":"/home/runner/work/pyreon/pyreon/packages/core/head/lib/ssr.js","moduleParts":{"index.js":"8b63d05d-1"},"imported":[{"uid":"8b63d05d-12"},{"uid":"8b63d05d-14"}],"importedBy":[{"uid":"8b63d05d-4"}]},"8b63d05d-2":{"id":"/src/html.ts","moduleParts":{"index.js":"8b63d05d-3"},"imported":[],"importedBy":[{"uid":"8b63d05d-10"},{"uid":"8b63d05d-4"}]},"8b63d05d-4":{"id":"/src/handler.ts","moduleParts":{"index.js":"8b63d05d-5"},"imported":[{"uid":"8b63d05d-12"},{"uid":"8b63d05d-0"},{"uid":"8b63d05d-13"},{"uid":"8b63d05d-14"},{"uid":"8b63d05d-2"}],"importedBy":[{"uid":"8b63d05d-10"}]},"8b63d05d-6":{"id":"/src/island.ts","moduleParts":{"index.js":"8b63d05d-7"},"imported":[{"uid":"8b63d05d-12"}],"importedBy":[{"uid":"8b63d05d-10"}]},"8b63d05d-8":{"id":"/src/ssg.ts","moduleParts":{"index.js":"8b63d05d-9"},"imported":[{"uid":"8b63d05d-15"},{"uid":"8b63d05d-16"}],"importedBy":[{"uid":"8b63d05d-10"}]},"8b63d05d-10":{"id":"/src/index.ts","moduleParts":{"index.js":"8b63d05d-11"},"imported":[{"uid":"8b63d05d-4"},{"uid":"8b63d05d-2"},{"uid":"8b63d05d-6"},{"uid":"8b63d05d-8"}],"importedBy":[],"isEntry":true},"8b63d05d-12":{"id":"@pyreon/core","moduleParts":{},"imported":[],"importedBy":[{"uid":"8b63d05d-4"},{"uid":"8b63d05d-6"},{"uid":"8b63d05d-0"}]},"8b63d05d-13":{"id":"@pyreon/router","moduleParts":{},"imported":[],"importedBy":[{"uid":"8b63d05d-4"}]},"8b63d05d-14":{"id":"@pyreon/runtime-server","moduleParts":{},"imported":[],"importedBy":[{"uid":"8b63d05d-4"},{"uid":"8b63d05d-0"}]},"8b63d05d-15":{"id":"node:fs/promises","moduleParts":{},"imported":[],"importedBy":[{"uid":"8b63d05d-8"}]},"8b63d05d-16":{"id":"node:path","moduleParts":{},"imported":[],"importedBy":[{"uid":"8b63d05d-8"}]}},"env":{"rollup":"4.23.0"},"options":{"gzip":true,"brotli":false,"sourcemap":false}};
+    const data = {"version":2,"tree":{"name":"root","children":[{"name":"index.js","children":[{"name":"home/runner/work/pyreon/pyreon/packages/core/head/lib/ssr.js","uid":"dc208be0-1"},{"name":"src","children":[{"uid":"dc208be0-3","name":"html.ts"},{"uid":"dc208be0-5","name":"middleware.ts"},{"uid":"dc208be0-7","name":"handler.ts"},{"uid":"dc208be0-9","name":"island.ts"},{"uid":"dc208be0-11","name":"ssg.ts"},{"uid":"dc208be0-13","name":"index.ts"}]}]}],"isRoot":true},"nodeParts":{"dc208be0-1":{"renderedLength":2713,"gzipLength":1078,"brotliLength":0,"metaUid":"dc208be0-0"},"dc208be0-3":{"renderedLength":2797,"gzipLength":1166,"brotliLength":0,"metaUid":"dc208be0-2"},"dc208be0-5":{"renderedLength":1738,"gzipLength":835,"brotliLength":0,"metaUid":"dc208be0-4"},"dc208be0-7":{"renderedLength":3104,"gzipLength":1337,"brotliLength":0,"metaUid":"dc208be0-6"},"dc208be0-9":{"renderedLength":1444,"gzipLength":673,"brotliLength":0,"metaUid":"dc208be0-8"},"dc208be0-11":{"renderedLength":2806,"gzipLength":1214,"brotliLength":0,"metaUid":"dc208be0-10"},"dc208be0-13":{"renderedLength":0,"gzipLength":0,"brotliLength":0,"metaUid":"dc208be0-12"}},"nodeMetas":{"dc208be0-0":{"id":"/home/runner/work/pyreon/pyreon/packages/core/head/lib/ssr.js","moduleParts":{"index.js":"dc208be0-1"},"imported":[{"uid":"dc208be0-14"},{"uid":"dc208be0-16"}],"importedBy":[{"uid":"dc208be0-6"}]},"dc208be0-2":{"id":"/src/html.ts","moduleParts":{"index.js":"dc208be0-3"},"imported":[],"importedBy":[{"uid":"dc208be0-12"},{"uid":"dc208be0-6"}]},"dc208be0-4":{"id":"/src/middleware.ts","moduleParts":{"index.js":"dc208be0-5"},"imported":[{"uid":"dc208be0-14"}],"importedBy":[{"uid":"dc208be0-12"},{"uid":"dc208be0-6"}]},"dc208be0-6":{"id":"/src/handler.ts","moduleParts":{"index.js":"dc208be0-7"},"imported":[{"uid":"dc208be0-14"},{"uid":"dc208be0-0"},{"uid":"dc208be0-15"},{"uid":"dc208be0-16"},{"uid":"dc208be0-2"},{"uid":"dc208be0-4"}],"importedBy":[{"uid":"dc208be0-12"}]},"dc208be0-8":{"id":"/src/island.ts","moduleParts":{"index.js":"dc208be0-9"},"imported":[{"uid":"dc208be0-14"}],"importedBy":[{"uid":"dc208be0-12"}]},"dc208be0-10":{"id":"/src/ssg.ts","moduleParts":{"index.js":"dc208be0-11"},"imported":[{"uid":"dc208be0-17"},{"uid":"dc208be0-18"}],"importedBy":[{"uid":"dc208be0-12"}]},"dc208be0-12":{"id":"/src/index.ts","moduleParts":{"index.js":"dc208be0-13"},"imported":[{"uid":"dc208be0-6"},{"uid":"dc208be0-2"},{"uid":"dc208be0-8"},{"uid":"dc208be0-4"},{"uid":"dc208be0-10"}],"importedBy":[],"isEntry":true},"dc208be0-14":{"id":"@pyreon/core","moduleParts":{},"imported":[],"importedBy":[{"uid":"dc208be0-6"},{"uid":"dc208be0-8"},{"uid":"dc208be0-4"},{"uid":"dc208be0-0"}]},"dc208be0-15":{"id":"@pyreon/router","moduleParts":{},"imported":[],"importedBy":[{"uid":"dc208be0-6"}]},"dc208be0-16":{"id":"@pyreon/runtime-server","moduleParts":{},"imported":[],"importedBy":[{"uid":"dc208be0-6"},{"uid":"dc208be0-0"}]},"dc208be0-17":{"id":"node:fs/promises","moduleParts":{},"imported":[],"importedBy":[{"uid":"dc208be0-10"}]},"dc208be0-18":{"id":"node:path","moduleParts":{},"imported":[],"importedBy":[{"uid":"dc208be0-10"}]}},"env":{"rollup":"4.23.0"},"options":{"gzip":true,"brotli":false,"sourcemap":false}};
 
     const run = () => {
       const width = window.innerWidth;

package/lib/index.js

@@ -1,4 +1,4 @@
-import { createContext, h, pushContext } from "@pyreon/core";
+import { createContext, h, provide, pushContext, useContext } from "@pyreon/core";
 import { renderToStream, renderToString, runWithRequestContext } from "@pyreon/runtime-server";
 import { RouterProvider, createRouter, prefetchLoaderData, serializeLoaderData } from "@pyreon/router";
 import { mkdir, writeFile } from "node:fs/promises";
@@ -175,11 +175,71 @@ function buildScriptsFast(clientEntryTag, loaderData) {
 	return clientEntryTag;
 }
 
+//#endregion
+//#region src/middleware.ts
+/**
+* SSR middleware — simple request processing pipeline.
+*
+* Middleware runs before rendering. Return a Response to short-circuit
+* (e.g. for redirects, auth checks, or static file serving).
+* Return void / undefined to continue to the next middleware or rendering.
+*
+* @example
+* const authMiddleware: Middleware = async (ctx) => {
+*   const token = ctx.req.headers.get("Authorization")
+*   if (!token) return new Response("Unauthorized", { status: 401 })
+*   ctx.locals.user = await verifyToken(token)
+* }
+*
+* const handler = createHandler({
+*   App,
+*   routes,
+*   middleware: [authMiddleware],
+* })
+*/
+/**
+* Context for per-request locals — populated by the SSR handler from
+* middleware `ctx.locals`. Components access it via `useRequestLocals()`.
+*
+* This bridges the middleware → component gap: middleware sets `ctx.locals`,
+* the handler provides it into the Pyreon context system, and components
+* read it without coupling to the middleware layer.
+*/
+const RequestLocalsCtx = createContext({});
+/**
+* Read per-request locals inside a component (SSR only).
+*
+* Returns the `ctx.locals` object populated by middleware.
+* On the client, returns an empty object.
+*
+* @example
+* ```tsx
+* import { useRequestLocals } from "@pyreon/server"
+*
+* function MyComponent() {
+*   const locals = useRequestLocals()
+*   const nonce = locals.cspNonce as string ?? ''
+*   return <script nonce={nonce}>...<\/script>
+* }
+* ```
+*/
+function useRequestLocals() {
+	return useContext(RequestLocalsCtx);
+}
+/**
+* Provide request locals into the component tree.
+* Called by the SSR handler — not for direct use.
+* @internal
+*/
+function provideRequestLocals(locals) {
+	provide(RequestLocalsCtx, locals);
+}
+
 //#endregion
 //#region src/handler.ts
 const __DEV__ = typeof process !== "undefined" && process.env.NODE_ENV !== "production";
 function createHandler(options) {
-	const { App, routes, template = DEFAULT_TEMPLATE, clientEntry = "/src/entry-client.ts", middleware = [], mode = "string" } = options;
+	const { App, routes, template = DEFAULT_TEMPLATE, clientEntry = "/src/entry-client.ts", middleware = [], mode = "string", collectStyles } = options;
 	const compiled = compileTemplate(template);
 	const clientEntryTag = buildClientEntryTag(clientEntry);
 	return async function handler(req) {
@@ -203,14 +263,17 @@ function createHandler(options) {
 		});
 		return runWithRequestContext(async () => {
 			try {
+				provideRequestLocals(ctx.locals);
 				await prefetchLoaderData(router, path);
 				const app = h(RouterProvider, { router }, h(App, null));
 				if (mode === "stream") return renderStreamResponse(app, router, compiled, clientEntryTag, ctx.headers);
 				const { html: appHtml, head } = await renderWithHead(app);
+				const styleTag = collectStyles ? collectStyles() : "";
+				const scripts = buildScriptsFast(clientEntryTag, serializeLoaderData(router));
 				const fullHtml = processCompiledTemplate(compiled, {
-					head,
+					head: styleTag ? `${styleTag}\n${head}` : head,
 					app: appHtml,
-					scripts: buildScriptsFast(clientEntryTag, serializeLoaderData(router))
+					scripts
 				});
 				return new Response(fullHtml, {
 					status: 200,
@@ -423,5 +486,5 @@ function resolveOutputPath(outDir, path) {
 }
 
 //#endregion
-export { DEFAULT_TEMPLATE, buildScripts, compileTemplate, createHandler, island, prerender, processCompiledTemplate, processTemplate };
+export { DEFAULT_TEMPLATE, buildScripts, compileTemplate, createHandler, island, prerender, processCompiledTemplate, processTemplate, useRequestLocals };
 //# sourceMappingURL=index.js.map

package/lib/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../../head/lib/ssr.js","../src/html.ts","../src/handler.ts","../src/island.ts","../src/ssg.ts"],"sourcesContent":["import { createContext, h, pushContext } from \"@pyreon/core\";\nimport { renderToString } from \"@pyreon/runtime-server\";\n\n//#region src/context.ts\nfunction createHeadContext() {\n\tconst map = /* @__PURE__ */ new Map();\n\tlet dirty = true;\n\tlet cachedTags = [];\n\tlet cachedTitleTemplate;\n\tlet cachedHtmlAttrs = {};\n\tlet cachedBodyAttrs = {};\n\tfunction rebuild() {\n\t\tif (!dirty) return;\n\t\tdirty = false;\n\t\tconst keyed = /* @__PURE__ */ new Map();\n\t\tconst unkeyed = [];\n\t\tlet titleTemplate;\n\t\tconst htmlAttrs = {};\n\t\tconst bodyAttrs = {};\n\t\tfor (const entry of map.values()) {\n\t\t\tfor (const tag of entry.tags) if (tag.key) keyed.set(tag.key, tag);\n\t\t\telse unkeyed.push(tag);\n\t\t\tif (entry.titleTemplate !== void 0) titleTemplate = entry.titleTemplate;\n\t\t\tif (entry.htmlAttrs) Object.assign(htmlAttrs, entry.htmlAttrs);\n\t\t\tif (entry.bodyAttrs) Object.assign(bodyAttrs, entry.bodyAttrs);\n\t\t}\n\t\tcachedTags = [...keyed.values(), ...unkeyed];\n\t\tcachedTitleTemplate = titleTemplate;\n\t\tcachedHtmlAttrs = htmlAttrs;\n\t\tcachedBodyAttrs = bodyAttrs;\n\t}\n\treturn {\n\t\tadd(id, entry) {\n\t\t\tmap.set(id, entry);\n\t\t\tdirty = true;\n\t\t},\n\t\tremove(id) {\n\t\t\tmap.delete(id);\n\t\t\tdirty = true;\n\t\t},\n\t\tresolve() {\n\t\t\trebuild();\n\t\t\treturn cachedTags;\n\t\t},\n\t\tresolveTitleTemplate() {\n\t\t\trebuild();\n\t\t\treturn cachedTitleTemplate;\n\t\t},\n\t\tresolveHtmlAttrs() {\n\t\t\trebuild();\n\t\t\treturn cachedHtmlAttrs;\n\t\t},\n\t\tresolveBodyAttrs() {\n\t\t\trebuild();\n\t\t\treturn cachedBodyAttrs;\n\t\t}\n\t};\n}\nconst HeadContext = createContext(null);\n\n//#endregion\n//#region src/ssr.ts\nconst VOID_TAGS = new Set([\n\t\"meta\",\n\t\"link\",\n\t\"base\"\n]);\nasync function renderWithHead(app) {\n\tconst ctx = createHeadContext();\n\tfunction HeadInjector() {\n\t\tpushContext(new Map([[HeadContext.id, ctx]]));\n\t\treturn app;\n\t}\n\tconst html = await renderToString(h(HeadInjector, null));\n\tconst titleTemplate = ctx.resolveTitleTemplate();\n\treturn {\n\t\thtml,\n\t\thead: ctx.resolve().map((tag) => serializeTag(tag, titleTemplate)).join(\"\\n  \"),\n\t\thtmlAttrs: ctx.resolveHtmlAttrs(),\n\t\tbodyAttrs: ctx.resolveBodyAttrs()\n\t};\n}\nfunction serializeTag(tag, titleTemplate) {\n\tif (tag.tag === \"title\") {\n\t\tconst raw = tag.children || \"\";\n\t\treturn `<title>${esc(titleTemplate ? typeof titleTemplate === \"function\" ? titleTemplate(raw) : titleTemplate.replace(/%s/g, raw) : raw)}</title>`;\n\t}\n\tconst props = tag.props;\n\tconst attrs = props ? Object.entries(props).map(([k, v]) => `${k}=\"${esc(v)}\"`).join(\" \") : \"\";\n\tconst open = attrs ? `<${tag.tag} ${attrs}` : `<${tag.tag}`;\n\tif (VOID_TAGS.has(tag.tag)) return `${open} />`;\n\treturn `${open}>${(tag.children || \"\").replace(/<\\/(script|style|noscript)/gi, \"<\\\\/$1\").replace(/<!--/g, \"<\\\\!--\")}</${tag.tag}>`;\n}\nconst ESC_RE = /[&<>\"]/g;\nconst ESC_MAP = {\n\t\"&\": \"&amp;\",\n\t\"<\": \"&lt;\",\n\t\">\": \"&gt;\",\n\t\"\\\"\": \"&quot;\"\n};\nfunction esc(s) {\n\treturn ESC_RE.test(s) ? s.replace(ESC_RE, (ch) => ESC_MAP[ch]) : s;\n}\n\n//#endregion\nexport { renderWithHead };\n//# sourceMappingURL=ssr.js.map","/**\n * HTML template processing for SSR/SSG.\n *\n * Templates use comment placeholders:\n *   <!--pyreon-head-->     — replaced with <head> tags (title, meta, link, etc.)\n *   <!--pyreon-app-->      — replaced with rendered application HTML\n *   <!--pyreon-scripts-->  — replaced with client entry script + inline loader data\n */\n\nexport const DEFAULT_TEMPLATE = `<!DOCTYPE html>\n<html lang=\"en\">\n<head>\n  <meta charset=\"UTF-8\">\n  <meta name=\"viewport\" content=\"width=device-width, initial-scale=1.0\">\n  <!--pyreon-head-->\n</head>\n<body>\n  <div id=\"app\"><!--pyreon-app--></div>\n  <!--pyreon-scripts-->\n</body>\n</html>`\n\nexport interface TemplateData {\n  head: string\n  app: string\n  scripts: string\n}\n\n/**\n * Pre-compiled template — splits the template string once so that\n * each request only concatenates 6 parts instead of scanning 3x with `.replace()`.\n */\nexport interface CompiledTemplate {\n  /** [before-head, between-head-app, between-app-scripts, after-scripts] */\n  parts: [string, string, string, string]\n}\n\nexport function compileTemplate(template: string): CompiledTemplate {\n  if (!template.includes('<!--pyreon-app-->')) {\n    throw new Error('[pyreon/server] Template must contain <!--pyreon-app--> placeholder')\n  }\n  const [beforeHead, afterHead] = splitOnce(template, '<!--pyreon-head-->')\n  const [betweenHeadApp, afterApp] = splitOnce(afterHead, '<!--pyreon-app-->')\n  const [betweenAppScripts, afterScripts] = splitOnce(afterApp, '<!--pyreon-scripts-->')\n  return { parts: [beforeHead, betweenHeadApp, betweenAppScripts, afterScripts] }\n}\n\nfunction splitOnce(str: string, delimiter: string): [string, string] {\n  const idx = str.indexOf(delimiter)\n  if (idx === -1) return [str, '']\n  return [str.slice(0, idx), str.slice(idx + delimiter.length)]\n}\n\nexport function processTemplate(template: string, data: TemplateData): string {\n  return template\n    .replace('<!--pyreon-head-->', data.head)\n    .replace('<!--pyreon-app-->', data.app)\n    .replace('<!--pyreon-scripts-->', data.scripts)\n}\n\n/** Fast path using a pre-compiled template */\nexport function processCompiledTemplate(compiled: CompiledTemplate, data: TemplateData): string {\n  const [p0, p1, p2, p3] = compiled.parts\n  return p0 + data.head + p1 + data.app + p2 + data.scripts + p3\n}\n\n/**\n * Build the script tags for client hydration.\n *\n * Emits:\n *   1. Inline script with serialized loader data (if any)\n *   2. Module script tag pointing to the client entry\n */\nexport function buildScripts(\n  clientEntry: string,\n  loaderData: Record<string, unknown> | null,\n): string {\n  const parts: string[] = []\n\n  if (loaderData && Object.keys(loaderData).length > 0) {\n    // Escape </script> inside JSON to prevent premature tag close\n    const json = JSON.stringify(loaderData).replace(/<\\//g, '<\\\\/')\n    parts.push(`<script>window.__PYREON_LOADER_DATA__=${json}</script>`)\n  }\n\n  parts.push(`<script type=\"module\" src=\"${clientEntry}\"></script>`)\n\n  return parts.join('\\n  ')\n}\n\n/** Pre-build the static client entry script tag (invariant across requests) */\nexport function buildClientEntryTag(clientEntry: string): string {\n  return `<script type=\"module\" src=\"${clientEntry}\"></script>`\n}\n\n/** Fast path: build scripts with a pre-built client entry tag */\nexport function buildScriptsFast(\n  clientEntryTag: string,\n  loaderData: Record<string, unknown> | null,\n): string {\n  if (loaderData && Object.keys(loaderData).length > 0) {\n    const json = JSON.stringify(loaderData).replace(/<\\//g, '<\\\\/')\n    return `<script>window.__PYREON_LOADER_DATA__=${json}</script>\\n  ${clientEntryTag}`\n  }\n  return clientEntryTag\n}\n","/**\n * SSR request handler.\n *\n * Creates a Web-standard `(Request) => Promise<Response>` handler that:\n *   1. Runs middleware (auth, redirects, headers, etc.)\n *   2. Creates a per-request router with the matched URL\n *   3. Prefetches loader data for matched routes\n *   4. Renders the app to HTML with head tag collection\n *   5. Injects everything into an HTML template\n *   6. Returns a Response\n *\n * Compatible with Bun.serve, Deno.serve, Cloudflare Workers,\n * Express (via adapter), and any Web-standard server.\n *\n * @example\n * import { createHandler } from \"@pyreon/server\"\n *\n * const handler = createHandler({\n *   App,\n *   routes,\n *   template: await Bun.file(\"index.html\").text(),\n * })\n *\n * Bun.serve({ fetch: handler })\n */\n\nimport type { ComponentFn } from '@pyreon/core'\nimport { h } from '@pyreon/core'\nimport { renderWithHead } from '@pyreon/head/ssr'\nimport {\n  createRouter,\n  prefetchLoaderData,\n  type RouteRecord,\n  RouterProvider,\n  serializeLoaderData,\n} from '@pyreon/router'\nimport { renderToStream, runWithRequestContext } from '@pyreon/runtime-server'\nimport {\n  buildClientEntryTag,\n  buildScriptsFast,\n  type CompiledTemplate,\n  compileTemplate,\n  DEFAULT_TEMPLATE,\n  processCompiledTemplate,\n} from './html'\nimport type { Middleware, MiddlewareContext } from './middleware'\n\nconst __DEV__ = typeof process !== 'undefined' && process.env.NODE_ENV !== 'production'\n\nexport interface HandlerOptions {\n  /** Root application component */\n  App: ComponentFn\n  /** Route definitions */\n  routes: RouteRecord[]\n  /**\n   * HTML template with placeholders:\n   *   <!--pyreon-head-->     — head tags (title, meta, link, etc.)\n   *   <!--pyreon-app-->      — rendered app HTML\n   *   <!--pyreon-scripts-->  — client entry + loader data\n   *\n   * Defaults to a minimal HTML5 template.\n   */\n  template?: string\n  /** Path to the client entry module (default: \"/src/entry-client.ts\") */\n  clientEntry?: string\n  /** Middleware chain — runs before rendering */\n  middleware?: Middleware[]\n  /**\n   * Rendering mode:\n   *   \"string\" (default) — full renderToString, complete HTML in one response\n   *   \"stream\" — progressive streaming via renderToStream (Suspense out-of-order)\n   */\n  mode?: 'string' | 'stream'\n}\n\nexport function createHandler(options: HandlerOptions): (req: Request) => Promise<Response> {\n  const {\n    App,\n    routes,\n    template = DEFAULT_TEMPLATE,\n    clientEntry = '/src/entry-client.ts',\n    middleware = [],\n    mode = 'string',\n  } = options\n\n  // Pre-compile once at handler creation — avoids 3x string scan per request\n  const compiled = compileTemplate(template)\n  const clientEntryTag = buildClientEntryTag(clientEntry)\n\n  return async function handler(req: Request): Promise<Response> {\n    const url = new URL(req.url)\n    const path = url.pathname + url.search\n\n    // ── Middleware pipeline ────────────────────────────────────────────────────\n    const ctx: MiddlewareContext = {\n      req,\n      url,\n      path,\n      headers: new Headers({ 'Content-Type': 'text/html; charset=utf-8' }),\n      locals: {},\n    }\n\n    for (const mw of middleware) {\n      const result = await mw(ctx)\n      if (result instanceof Response) return result\n    }\n\n    // ── Per-request router ────────────────────────────────────────────────────\n    const router = createRouter({ routes, mode: 'history', url: path })\n\n    return runWithRequestContext(async () => {\n      try {\n        // Pre-run loaders so data is available during render\n        await prefetchLoaderData(router as never, path)\n\n        // Build the VNode tree\n        const app = h(RouterProvider, { router }, h(App, null))\n\n        if (mode === 'stream') {\n          return renderStreamResponse(app, router, compiled, clientEntryTag, ctx.headers)\n        }\n\n        // ── String mode (default) ─────────────────────────────────────────────\n        const { html: appHtml, head } = await renderWithHead(app)\n        const loaderData = serializeLoaderData(router as never)\n        const scripts = buildScriptsFast(clientEntryTag, loaderData)\n        const fullHtml = processCompiledTemplate(compiled, { head, app: appHtml, scripts })\n\n        return new Response(fullHtml, { status: 200, headers: ctx.headers })\n      } catch (err) {\n        if (__DEV__) {\n          console.error('[Pyreon Server] SSR render failed:', err)\n        }\n        return new Response('Internal Server Error', {\n          status: 500,\n          headers: { 'Content-Type': 'text/plain' },\n        })\n      }\n    })\n  }\n}\n\n/**\n * Streaming mode: shell is emitted immediately, app content streams progressively.\n *\n * Head tags from the initial synchronous render are included in the shell.\n * Suspense boundaries resolve out-of-order via inline <template> + swap scripts.\n */\nasync function renderStreamResponse(\n  app: ReturnType<typeof h>,\n  router: ReturnType<typeof createRouter>,\n  compiled: CompiledTemplate,\n  clientEntryTag: string,\n  extraHeaders: Headers,\n): Promise<Response> {\n  const loaderData = serializeLoaderData(router as never)\n  const scripts = buildScriptsFast(clientEntryTag, loaderData)\n\n  // Use pre-split parts: [before-head, between-head-app, between-app-scripts, after-scripts]\n  const [p0, p1, p2, p3] = compiled.parts\n  const shellHead = p0 + p1\n  const shellTail = p2 + scripts + p3\n\n  const appStream = renderToStream(app)\n  const reader = appStream.getReader()\n\n  const stream = new ReadableStream<Uint8Array>({\n    async start(controller) {\n      const encoder = new TextEncoder()\n      const push = (s: string) => controller.enqueue(encoder.encode(s))\n\n      try {\n        push(shellHead)\n\n        // Stream app content\n        let done = false\n        while (!done) {\n          const result = await reader.read()\n          done = result.done\n          if (result.value) push(result.value)\n        }\n\n        push(shellTail)\n      } catch (err) {\n        if (__DEV__) {\n          console.error('[Pyreon Server] Stream render failed:', err)\n        }\n        // Emit an inline error indicator — status code is already sent (200)\n        push(`<script>console.error(\"[pyreon/server] Stream render failed\")</script>`)\n        push(shellTail)\n      } finally {\n        controller.close()\n      }\n    },\n  })\n\n  return new Response(stream, {\n    status: 200,\n    headers: extraHeaders,\n  })\n}\n","/**\n * Island architecture — partial hydration for content-heavy sites.\n *\n * Islands are interactive components embedded in otherwise-static HTML.\n * Only island components ship JavaScript to the client — the rest of the\n * page stays as zero-JS server-rendered HTML.\n *\n * ## Server side\n *\n * `island()` wraps an async component import and returns a ComponentFn.\n * During SSR, it renders the component output inside a `<pyreon-island>` element\n * with serialized props, so the client knows what to hydrate.\n *\n * ```tsx\n * import { island } from \"@pyreon/server\"\n *\n * const Counter = island(() => import(\"./Counter\"), { name: \"Counter\" })\n * const Search  = island(() => import(\"./Search\"),  { name: \"Search\" })\n *\n * function Page() {\n *   return <div>\n *     <h1>Static heading (no JS)</h1>\n *     <Counter initial={5} />   // hydrated on client\n *     <p>Static paragraph</p>\n *     <Search />                // hydrated on client\n *   </div>\n * }\n * ```\n *\n * ## Client side\n *\n * Use `hydrateIslands()` from `@pyreon/server/client` to hydrate all islands\n * on the page. Only the island components' JavaScript is loaded.\n *\n * ```ts\n * // entry-client.ts (island mode)\n * import { hydrateIslands } from \"@pyreon/server/client\"\n *\n * hydrateIslands({\n *   Counter: () => import(\"./Counter\"),\n *   Search:  () => import(\"./Search\"),\n * })\n * ```\n *\n * ## Hydration strategies\n *\n * Control when an island hydrates via the `hydrate` option:\n *   - \"load\" (default) — hydrate immediately on page load\n *   - \"idle\"           — hydrate when the browser is idle (requestIdleCallback)\n *   - \"visible\"        — hydrate when the island scrolls into the viewport\n *   - \"media(query)\"   — hydrate when a media query matches\n *   - \"never\"          — never hydrate (render-only, no client JS)\n */\n\nimport type { ComponentFn, Props, VNode } from '@pyreon/core'\nimport { h } from '@pyreon/core'\n\n// ─── Types ───────────────────────────────────────────────────────────────────\n\nexport type HydrationStrategy = 'load' | 'idle' | 'visible' | 'never' | `media(${string})`\n\nexport interface IslandOptions {\n  /** Unique name — must match the key in the client-side hydrateIslands() registry */\n  name: string\n  /** When to hydrate on the client (default: \"load\") */\n  hydrate?: HydrationStrategy\n}\n\nexport interface IslandMeta {\n  readonly __island: true\n  readonly name: string\n  readonly hydrate: HydrationStrategy\n}\n\n// ─── Server-side island factory ──────────────────────────────────────────────\n\n/**\n * Create an island component.\n *\n * Returns an async ComponentFn that:\n *   1. Resolves the dynamic import\n *   2. Renders the component to VNodes\n *   3. Wraps the output in `<pyreon-island>` with serialized props + hydration strategy\n */\nexport function island<P extends Props = Props>(\n  loader: () => Promise<{ default: ComponentFn<P> } | ComponentFn<P>>,\n  options: IslandOptions,\n): ComponentFn<P> & IslandMeta {\n  const { name, hydrate = 'load' } = options\n\n  const IslandWrapper = async function IslandWrapper(props: P): Promise<VNode | null> {\n    const mod = await loader()\n    const Comp = typeof mod === 'function' ? mod : mod.default\n    const serializedProps = serializeIslandProps(props)\n\n    return h(\n      'pyreon-island',\n      {\n        'data-component': name,\n        'data-props': serializedProps,\n        'data-hydrate': hydrate,\n      },\n      h(Comp, props),\n    )\n  }\n\n  // Attach metadata so the Vite plugin can detect islands for code-splitting\n  const wrapper = IslandWrapper as unknown as ComponentFn<P> & IslandMeta\n  Object.defineProperties(wrapper, {\n    __island: { value: true, enumerable: true },\n    name: { value: name, enumerable: true, writable: false, configurable: true },\n    hydrate: { value: hydrate, enumerable: true },\n  })\n\n  return wrapper\n}\n\n// ─── Helpers ─────────────────────────────────────────────────────────────────\n\n/**\n * Serialize component props to a JSON string for embedding in HTML attributes.\n * Strips non-serializable values (functions, symbols, children).\n */\nfunction serializeIslandProps(props: Record<string, unknown>): string {\n  const clean: Record<string, unknown> = {}\n  for (const [key, value] of Object.entries(props)) {\n    // Skip non-serializable or internal props\n    if (key === 'children') continue\n    if (typeof value === 'function') continue\n    if (typeof value === 'symbol') continue\n    if (value === undefined) continue\n    clean[key] = value\n  }\n  // The SSR renderer's renderProp() already applies escapeHtml() to attribute\n  // values, so the JSON is safe to embed in HTML attributes without double-escaping.\n  return JSON.stringify(clean)\n}\n","/**\n * Static Site Generation — pre-render routes to HTML files at build time.\n *\n * @example\n * // ssg.ts (run with: bun run ssg.ts)\n * import { createHandler } from \"@pyreon/server\"\n * import { prerender } from \"@pyreon/server\"\n * import { App } from \"./src/App\"\n * import { routes } from \"./src/routes\"\n *\n * const handler = createHandler({ App, routes })\n *\n * await prerender({\n *   handler,\n *   paths: [\"/\", \"/about\", \"/blog\", \"/blog/hello-world\"],\n *   outDir: \"dist\",\n * })\n *\n * @example\n * // Dynamic paths from a CMS or filesystem\n * await prerender({\n *   handler,\n *   paths: async () => {\n *     const posts = await fetchAllPosts()\n *     return [\"/\", \"/about\", ...posts.map(p => `/blog/${p.slug}`)]\n *   },\n *   outDir: \"dist\",\n * })\n */\n\nimport { mkdir, writeFile } from 'node:fs/promises'\nimport { dirname, join, resolve } from 'node:path'\n\nexport interface PrerenderOptions {\n  /** SSR handler created by createHandler() */\n  handler: (req: Request) => Promise<Response>\n  /** Routes to pre-render — array of URL paths or async function that returns them */\n  paths: string[] | (() => string[] | Promise<string[]>)\n  /** Output directory for the generated HTML files */\n  outDir: string\n  /** Origin for constructing full URLs (default: \"http://localhost\") */\n  origin?: string\n  /**\n   * Called after each page is rendered — use for logging or progress tracking.\n   * Return false to skip writing this page.\n   */\n  onPage?: (path: string, html: string) => void | boolean | Promise<void | boolean>\n}\n\nexport interface PrerenderResult {\n  /** Number of pages generated */\n  pages: number\n  /** Paths that failed to render */\n  errors: { path: string; error: unknown }[]\n  /** Total elapsed time in milliseconds */\n  elapsed: number\n}\n\n/**\n * Pre-render a list of routes to static HTML files.\n *\n * For each path:\n *   1. Constructs a Request for the path\n *   2. Calls the SSR handler to render to HTML\n *   3. Writes the HTML to `outDir/<path>/index.html`\n *\n * The root path \"/\" becomes `outDir/index.html`.\n * Paths like \"/about\" become `outDir/about/index.html`.\n */\nexport async function prerender(options: PrerenderOptions): Promise<PrerenderResult> {\n  const { handler, outDir, origin = 'http://localhost', onPage } = options\n\n  const start = Date.now()\n\n  // Resolve paths (may be async)\n  const paths = typeof options.paths === 'function' ? await options.paths() : options.paths\n\n  let pages = 0\n  const errors: PrerenderResult['errors'] = []\n\n  async function renderPage(path: string): Promise<void> {\n    const url = new URL(path, origin)\n    const req = new Request(url.href)\n    const res = await Promise.race([\n      handler(req),\n      new Promise<never>((_, reject) =>\n        setTimeout(() => reject(new Error(`Prerender timeout for \"${path}\" (30s)`)), 30_000),\n      ),\n    ])\n\n    if (!res.ok) {\n      errors.push({ path, error: new Error(`HTTP ${res.status}`) })\n      return\n    }\n\n    const html = await res.text()\n\n    if (onPage) {\n      const result = await onPage(path, html)\n      if (result === false) return\n    }\n\n    const filePath = resolveOutputPath(outDir, path)\n\n    const resolvedOut = resolve(outDir)\n    if (!resolve(filePath).startsWith(resolvedOut)) {\n      errors.push({ path, error: new Error(`Path traversal detected: \"${path}\"`) })\n      return\n    }\n\n    await mkdir(dirname(filePath), { recursive: true })\n    await writeFile(filePath, html, 'utf-8')\n    pages++\n  }\n\n  // Process paths concurrently (batch of 10 to avoid overwhelming)\n  const BATCH_SIZE = 10\n  for (let i = 0; i < paths.length; i += BATCH_SIZE) {\n    const batch = paths.slice(i, i + BATCH_SIZE)\n    await Promise.all(\n      batch.map(async (path) => {\n        try {\n          await renderPage(path)\n        } catch (error) {\n          errors.push({ path, error })\n        }\n      }),\n    )\n  }\n\n  return {\n    pages,\n    errors,\n    elapsed: Date.now() - start,\n  }\n}\n\nfunction resolveOutputPath(outDir: string, path: string): string {\n  if (path === '/') return join(outDir, 'index.html')\n  if (path.endsWith('.html')) return join(outDir, path)\n  return join(outDir, path, 'index.html')\n}\n"],"mappings":"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"}
+{"version":3,"file":"index.js","names":[],"sources":["../../head/lib/ssr.js","../src/html.ts","../src/middleware.ts","../src/handler.ts","../src/island.ts","../src/ssg.ts"],"sourcesContent":["import { createContext, h, pushContext } from \"@pyreon/core\";\nimport { renderToString } from \"@pyreon/runtime-server\";\n\n//#region src/context.ts\nfunction createHeadContext() {\n\tconst map = /* @__PURE__ */ new Map();\n\tlet dirty = true;\n\tlet cachedTags = [];\n\tlet cachedTitleTemplate;\n\tlet cachedHtmlAttrs = {};\n\tlet cachedBodyAttrs = {};\n\tfunction rebuild() {\n\t\tif (!dirty) return;\n\t\tdirty = false;\n\t\tconst keyed = /* @__PURE__ */ new Map();\n\t\tconst unkeyed = [];\n\t\tlet titleTemplate;\n\t\tconst htmlAttrs = {};\n\t\tconst bodyAttrs = {};\n\t\tfor (const entry of map.values()) {\n\t\t\tfor (const tag of entry.tags) if (tag.key) keyed.set(tag.key, tag);\n\t\t\telse unkeyed.push(tag);\n\t\t\tif (entry.titleTemplate !== void 0) titleTemplate = entry.titleTemplate;\n\t\t\tif (entry.htmlAttrs) Object.assign(htmlAttrs, entry.htmlAttrs);\n\t\t\tif (entry.bodyAttrs) Object.assign(bodyAttrs, entry.bodyAttrs);\n\t\t}\n\t\tcachedTags = [...keyed.values(), ...unkeyed];\n\t\tcachedTitleTemplate = titleTemplate;\n\t\tcachedHtmlAttrs = htmlAttrs;\n\t\tcachedBodyAttrs = bodyAttrs;\n\t}\n\treturn {\n\t\tadd(id, entry) {\n\t\t\tmap.set(id, entry);\n\t\t\tdirty = true;\n\t\t},\n\t\tremove(id) {\n\t\t\tmap.delete(id);\n\t\t\tdirty = true;\n\t\t},\n\t\tresolve() {\n\t\t\trebuild();\n\t\t\treturn cachedTags;\n\t\t},\n\t\tresolveTitleTemplate() {\n\t\t\trebuild();\n\t\t\treturn cachedTitleTemplate;\n\t\t},\n\t\tresolveHtmlAttrs() {\n\t\t\trebuild();\n\t\t\treturn cachedHtmlAttrs;\n\t\t},\n\t\tresolveBodyAttrs() {\n\t\t\trebuild();\n\t\t\treturn cachedBodyAttrs;\n\t\t}\n\t};\n}\nconst HeadContext = createContext(null);\n\n//#endregion\n//#region src/ssr.ts\nconst VOID_TAGS = new Set([\n\t\"meta\",\n\t\"link\",\n\t\"base\"\n]);\nasync function renderWithHead(app) {\n\tconst ctx = createHeadContext();\n\tfunction HeadInjector() {\n\t\tpushContext(new Map([[HeadContext.id, ctx]]));\n\t\treturn app;\n\t}\n\tconst html = await renderToString(h(HeadInjector, null));\n\tconst titleTemplate = ctx.resolveTitleTemplate();\n\treturn {\n\t\thtml,\n\t\thead: ctx.resolve().map((tag) => serializeTag(tag, titleTemplate)).join(\"\\n  \"),\n\t\thtmlAttrs: ctx.resolveHtmlAttrs(),\n\t\tbodyAttrs: ctx.resolveBodyAttrs()\n\t};\n}\nfunction serializeTag(tag, titleTemplate) {\n\tif (tag.tag === \"title\") {\n\t\tconst raw = tag.children || \"\";\n\t\treturn `<title>${esc(titleTemplate ? typeof titleTemplate === \"function\" ? titleTemplate(raw) : titleTemplate.replace(/%s/g, raw) : raw)}</title>`;\n\t}\n\tconst props = tag.props;\n\tconst attrs = props ? Object.entries(props).map(([k, v]) => `${k}=\"${esc(v)}\"`).join(\" \") : \"\";\n\tconst open = attrs ? `<${tag.tag} ${attrs}` : `<${tag.tag}`;\n\tif (VOID_TAGS.has(tag.tag)) return `${open} />`;\n\treturn `${open}>${(tag.children || \"\").replace(/<\\/(script|style|noscript)/gi, \"<\\\\/$1\").replace(/<!--/g, \"<\\\\!--\")}</${tag.tag}>`;\n}\nconst ESC_RE = /[&<>\"]/g;\nconst ESC_MAP = {\n\t\"&\": \"&amp;\",\n\t\"<\": \"&lt;\",\n\t\">\": \"&gt;\",\n\t\"\\\"\": \"&quot;\"\n};\nfunction esc(s) {\n\treturn ESC_RE.test(s) ? s.replace(ESC_RE, (ch) => ESC_MAP[ch]) : s;\n}\n\n//#endregion\nexport { renderWithHead };\n//# sourceMappingURL=ssr.js.map","/**\n * HTML template processing for SSR/SSG.\n *\n * Templates use comment placeholders:\n *   <!--pyreon-head-->     — replaced with <head> tags (title, meta, link, etc.)\n *   <!--pyreon-app-->      — replaced with rendered application HTML\n *   <!--pyreon-scripts-->  — replaced with client entry script + inline loader data\n */\n\nexport const DEFAULT_TEMPLATE = `<!DOCTYPE html>\n<html lang=\"en\">\n<head>\n  <meta charset=\"UTF-8\">\n  <meta name=\"viewport\" content=\"width=device-width, initial-scale=1.0\">\n  <!--pyreon-head-->\n</head>\n<body>\n  <div id=\"app\"><!--pyreon-app--></div>\n  <!--pyreon-scripts-->\n</body>\n</html>`\n\nexport interface TemplateData {\n  head: string\n  app: string\n  scripts: string\n}\n\n/**\n * Pre-compiled template — splits the template string once so that\n * each request only concatenates 6 parts instead of scanning 3x with `.replace()`.\n */\nexport interface CompiledTemplate {\n  /** [before-head, between-head-app, between-app-scripts, after-scripts] */\n  parts: [string, string, string, string]\n}\n\nexport function compileTemplate(template: string): CompiledTemplate {\n  if (!template.includes('<!--pyreon-app-->')) {\n    throw new Error('[pyreon/server] Template must contain <!--pyreon-app--> placeholder')\n  }\n  const [beforeHead, afterHead] = splitOnce(template, '<!--pyreon-head-->')\n  const [betweenHeadApp, afterApp] = splitOnce(afterHead, '<!--pyreon-app-->')\n  const [betweenAppScripts, afterScripts] = splitOnce(afterApp, '<!--pyreon-scripts-->')\n  return { parts: [beforeHead, betweenHeadApp, betweenAppScripts, afterScripts] }\n}\n\nfunction splitOnce(str: string, delimiter: string): [string, string] {\n  const idx = str.indexOf(delimiter)\n  if (idx === -1) return [str, '']\n  return [str.slice(0, idx), str.slice(idx + delimiter.length)]\n}\n\nexport function processTemplate(template: string, data: TemplateData): string {\n  return template\n    .replace('<!--pyreon-head-->', data.head)\n    .replace('<!--pyreon-app-->', data.app)\n    .replace('<!--pyreon-scripts-->', data.scripts)\n}\n\n/** Fast path using a pre-compiled template */\nexport function processCompiledTemplate(compiled: CompiledTemplate, data: TemplateData): string {\n  const [p0, p1, p2, p3] = compiled.parts\n  return p0 + data.head + p1 + data.app + p2 + data.scripts + p3\n}\n\n/**\n * Build the script tags for client hydration.\n *\n * Emits:\n *   1. Inline script with serialized loader data (if any)\n *   2. Module script tag pointing to the client entry\n */\nexport function buildScripts(\n  clientEntry: string,\n  loaderData: Record<string, unknown> | null,\n): string {\n  const parts: string[] = []\n\n  if (loaderData && Object.keys(loaderData).length > 0) {\n    // Escape </script> inside JSON to prevent premature tag close\n    const json = JSON.stringify(loaderData).replace(/<\\//g, '<\\\\/')\n    parts.push(`<script>window.__PYREON_LOADER_DATA__=${json}</script>`)\n  }\n\n  parts.push(`<script type=\"module\" src=\"${clientEntry}\"></script>`)\n\n  return parts.join('\\n  ')\n}\n\n/** Pre-build the static client entry script tag (invariant across requests) */\nexport function buildClientEntryTag(clientEntry: string): string {\n  return `<script type=\"module\" src=\"${clientEntry}\"></script>`\n}\n\n/** Fast path: build scripts with a pre-built client entry tag */\nexport function buildScriptsFast(\n  clientEntryTag: string,\n  loaderData: Record<string, unknown> | null,\n): string {\n  if (loaderData && Object.keys(loaderData).length > 0) {\n    const json = JSON.stringify(loaderData).replace(/<\\//g, '<\\\\/')\n    return `<script>window.__PYREON_LOADER_DATA__=${json}</script>\\n  ${clientEntryTag}`\n  }\n  return clientEntryTag\n}\n","/**\n * SSR middleware — simple request processing pipeline.\n *\n * Middleware runs before rendering. Return a Response to short-circuit\n * (e.g. for redirects, auth checks, or static file serving).\n * Return void / undefined to continue to the next middleware or rendering.\n *\n * @example\n * const authMiddleware: Middleware = async (ctx) => {\n *   const token = ctx.req.headers.get(\"Authorization\")\n *   if (!token) return new Response(\"Unauthorized\", { status: 401 })\n *   ctx.locals.user = await verifyToken(token)\n * }\n *\n * const handler = createHandler({\n *   App,\n *   routes,\n *   middleware: [authMiddleware],\n * })\n */\n\nimport { createContext, useContext, provide } from '@pyreon/core'\n\nexport interface MiddlewareContext {\n  /** The incoming request */\n  req: Request\n  /** Parsed URL */\n  url: URL\n  /** Pathname + search (passed to router) */\n  path: string\n  /** Response headers — middleware can set custom headers */\n  headers: Headers\n  /** Arbitrary per-request data shared between middleware and components */\n  locals: Record<string, unknown>\n}\n\n/**\n * Middleware function. Return a Response to short-circuit, or void to continue.\n */\nexport type Middleware = (ctx: MiddlewareContext) => Response | void | Promise<Response | void>\n\n/**\n * Context for per-request locals — populated by the SSR handler from\n * middleware `ctx.locals`. Components access it via `useRequestLocals()`.\n *\n * This bridges the middleware → component gap: middleware sets `ctx.locals`,\n * the handler provides it into the Pyreon context system, and components\n * read it without coupling to the middleware layer.\n */\nexport const RequestLocalsCtx = createContext<Record<string, unknown>>({})\n\n/**\n * Read per-request locals inside a component (SSR only).\n *\n * Returns the `ctx.locals` object populated by middleware.\n * On the client, returns an empty object.\n *\n * @example\n * ```tsx\n * import { useRequestLocals } from \"@pyreon/server\"\n *\n * function MyComponent() {\n *   const locals = useRequestLocals()\n *   const nonce = locals.cspNonce as string ?? ''\n *   return <script nonce={nonce}>...</script>\n * }\n * ```\n */\nexport function useRequestLocals(): Record<string, unknown> {\n  return useContext(RequestLocalsCtx)\n}\n\n/**\n * Provide request locals into the component tree.\n * Called by the SSR handler — not for direct use.\n * @internal\n */\nexport function provideRequestLocals(locals: Record<string, unknown>): void {\n  provide(RequestLocalsCtx, locals)\n}\n","/**\n * SSR request handler.\n *\n * Creates a Web-standard `(Request) => Promise<Response>` handler that:\n *   1. Runs middleware (auth, redirects, headers, etc.)\n *   2. Creates a per-request router with the matched URL\n *   3. Prefetches loader data for matched routes\n *   4. Renders the app to HTML with head tag collection\n *   5. Injects everything into an HTML template\n *   6. Returns a Response\n *\n * Compatible with Bun.serve, Deno.serve, Cloudflare Workers,\n * Express (via adapter), and any Web-standard server.\n *\n * @example\n * import { createHandler } from \"@pyreon/server\"\n *\n * const handler = createHandler({\n *   App,\n *   routes,\n *   template: await Bun.file(\"index.html\").text(),\n * })\n *\n * Bun.serve({ fetch: handler })\n */\n\nimport type { ComponentFn } from '@pyreon/core'\nimport { h } from '@pyreon/core'\nimport { renderWithHead } from '@pyreon/head/ssr'\nimport {\n  createRouter,\n  prefetchLoaderData,\n  type RouteRecord,\n  RouterProvider,\n  serializeLoaderData,\n} from '@pyreon/router'\nimport { renderToStream, runWithRequestContext } from '@pyreon/runtime-server'\nimport {\n  buildClientEntryTag,\n  buildScriptsFast,\n  type CompiledTemplate,\n  compileTemplate,\n  DEFAULT_TEMPLATE,\n  processCompiledTemplate,\n} from './html'\nimport type { Middleware, MiddlewareContext } from './middleware'\nimport { provideRequestLocals } from './middleware'\n\nconst __DEV__ = typeof process !== 'undefined' && process.env.NODE_ENV !== 'production'\n\nexport interface HandlerOptions {\n  /** Root application component */\n  App: ComponentFn\n  /** Route definitions */\n  routes: RouteRecord[]\n  /**\n   * HTML template with placeholders:\n   *   <!--pyreon-head-->     — head tags (title, meta, link, etc.)\n   *   <!--pyreon-app-->      — rendered app HTML\n   *   <!--pyreon-scripts-->  — client entry + loader data\n   *\n   * Defaults to a minimal HTML5 template.\n   */\n  template?: string\n  /** Path to the client entry module (default: \"/src/entry-client.ts\") */\n  clientEntry?: string\n  /** Middleware chain — runs before rendering */\n  middleware?: Middleware[]\n  /**\n   * Rendering mode:\n   *   \"string\" (default) — full renderToString, complete HTML in one response\n   *   \"stream\" — progressive streaming via renderToStream (Suspense out-of-order)\n   */\n  mode?: 'string' | 'stream'\n  /**\n   * Collect CSS styles after rendering. Called after renderToString/renderWithHead.\n   * Return a `<style>` tag string to inject into `<head>`.\n   * Used by @pyreon/styler's sheet.getStyleTag() to prevent FOUC in SSG.\n   *\n   * @example\n   * import { sheet } from '@pyreon/styler'\n   * createHandler({\n   *   collectStyles: () => {\n   *     const tag = sheet.getStyleTag()\n   *     sheet.reset()\n   *     return tag\n   *   },\n   * })\n   */\n  collectStyles?: () => string\n}\n\nexport function createHandler(options: HandlerOptions): (req: Request) => Promise<Response> {\n  const {\n    App,\n    routes,\n    template = DEFAULT_TEMPLATE,\n    clientEntry = '/src/entry-client.ts',\n    middleware = [],\n    mode = 'string',\n    collectStyles,\n  } = options\n\n  // Pre-compile once at handler creation — avoids 3x string scan per request\n  const compiled = compileTemplate(template)\n  const clientEntryTag = buildClientEntryTag(clientEntry)\n\n  return async function handler(req: Request): Promise<Response> {\n    const url = new URL(req.url)\n    const path = url.pathname + url.search\n\n    // ── Middleware pipeline ────────────────────────────────────────────────────\n    const ctx: MiddlewareContext = {\n      req,\n      url,\n      path,\n      headers: new Headers({ 'Content-Type': 'text/html; charset=utf-8' }),\n      locals: {},\n    }\n\n    for (const mw of middleware) {\n      const result = await mw(ctx)\n      if (result instanceof Response) return result\n    }\n\n    // ── Per-request router ────────────────────────────────────────────────────\n    const router = createRouter({ routes, mode: 'history', url: path })\n\n    return runWithRequestContext(async () => {\n      try {\n        // Bridge middleware locals → Pyreon context system so components\n        // can access per-request data (CSP nonce, auth user, etc.)\n        provideRequestLocals(ctx.locals)\n\n        // Pre-run loaders so data is available during render\n        await prefetchLoaderData(router as never, path)\n\n        // Build the VNode tree\n        const app = h(RouterProvider, { router }, h(App, null))\n\n        if (mode === 'stream') {\n          return renderStreamResponse(app, router, compiled, clientEntryTag, ctx.headers)\n        }\n\n        // ── String mode (default) ─────────────────────────────────────────────\n        const { html: appHtml, head } = await renderWithHead(app)\n\n        // Collect CSS-in-JS styles if a collector was provided.\n        // The consumer passes collectStyles (e.g. sheet.getStyleTag from @pyreon/styler)\n        // to inject scoped CSS into <head> and prevent FOUC in SSG pages.\n        const styleTag = collectStyles ? collectStyles() : ''\n\n        const loaderData = serializeLoaderData(router as never)\n        const scripts = buildScriptsFast(clientEntryTag, loaderData)\n        const headWithStyles = styleTag ? `${styleTag}\\n${head}` : head\n        const fullHtml = processCompiledTemplate(compiled, { head: headWithStyles, app: appHtml, scripts })\n\n        return new Response(fullHtml, { status: 200, headers: ctx.headers })\n      } catch (err) {\n        if (__DEV__) {\n          console.error('[Pyreon Server] SSR render failed:', err)\n        }\n        return new Response('Internal Server Error', {\n          status: 500,\n          headers: { 'Content-Type': 'text/plain' },\n        })\n      }\n    })\n  }\n}\n\n/**\n * Streaming mode: shell is emitted immediately, app content streams progressively.\n *\n * Head tags from the initial synchronous render are included in the shell.\n * Suspense boundaries resolve out-of-order via inline <template> + swap scripts.\n */\nasync function renderStreamResponse(\n  app: ReturnType<typeof h>,\n  router: ReturnType<typeof createRouter>,\n  compiled: CompiledTemplate,\n  clientEntryTag: string,\n  extraHeaders: Headers,\n): Promise<Response> {\n  const loaderData = serializeLoaderData(router as never)\n  const scripts = buildScriptsFast(clientEntryTag, loaderData)\n\n  // Use pre-split parts: [before-head, between-head-app, between-app-scripts, after-scripts]\n  const [p0, p1, p2, p3] = compiled.parts\n  const shellHead = p0 + p1\n  const shellTail = p2 + scripts + p3\n\n  const appStream = renderToStream(app)\n  const reader = appStream.getReader()\n\n  const stream = new ReadableStream<Uint8Array>({\n    async start(controller) {\n      const encoder = new TextEncoder()\n      const push = (s: string) => controller.enqueue(encoder.encode(s))\n\n      try {\n        push(shellHead)\n\n        // Stream app content\n        let done = false\n        while (!done) {\n          const result = await reader.read()\n          done = result.done\n          if (result.value) push(result.value)\n        }\n\n        push(shellTail)\n      } catch (err) {\n        if (__DEV__) {\n          console.error('[Pyreon Server] Stream render failed:', err)\n        }\n        // Emit an inline error indicator — status code is already sent (200)\n        push(`<script>console.error(\"[pyreon/server] Stream render failed\")</script>`)\n        push(shellTail)\n      } finally {\n        controller.close()\n      }\n    },\n  })\n\n  return new Response(stream, {\n    status: 200,\n    headers: extraHeaders,\n  })\n}\n","/**\n * Island architecture — partial hydration for content-heavy sites.\n *\n * Islands are interactive components embedded in otherwise-static HTML.\n * Only island components ship JavaScript to the client — the rest of the\n * page stays as zero-JS server-rendered HTML.\n *\n * ## Server side\n *\n * `island()` wraps an async component import and returns a ComponentFn.\n * During SSR, it renders the component output inside a `<pyreon-island>` element\n * with serialized props, so the client knows what to hydrate.\n *\n * ```tsx\n * import { island } from \"@pyreon/server\"\n *\n * const Counter = island(() => import(\"./Counter\"), { name: \"Counter\" })\n * const Search  = island(() => import(\"./Search\"),  { name: \"Search\" })\n *\n * function Page() {\n *   return <div>\n *     <h1>Static heading (no JS)</h1>\n *     <Counter initial={5} />   // hydrated on client\n *     <p>Static paragraph</p>\n *     <Search />                // hydrated on client\n *   </div>\n * }\n * ```\n *\n * ## Client side\n *\n * Use `hydrateIslands()` from `@pyreon/server/client` to hydrate all islands\n * on the page. Only the island components' JavaScript is loaded.\n *\n * ```ts\n * // entry-client.ts (island mode)\n * import { hydrateIslands } from \"@pyreon/server/client\"\n *\n * hydrateIslands({\n *   Counter: () => import(\"./Counter\"),\n *   Search:  () => import(\"./Search\"),\n * })\n * ```\n *\n * ## Hydration strategies\n *\n * Control when an island hydrates via the `hydrate` option:\n *   - \"load\" (default) — hydrate immediately on page load\n *   - \"idle\"           — hydrate when the browser is idle (requestIdleCallback)\n *   - \"visible\"        — hydrate when the island scrolls into the viewport\n *   - \"media(query)\"   — hydrate when a media query matches\n *   - \"never\"          — never hydrate (render-only, no client JS)\n */\n\nimport type { ComponentFn, Props, VNode } from '@pyreon/core'\nimport { h } from '@pyreon/core'\n\n// ─── Types ───────────────────────────────────────────────────────────────────\n\nexport type HydrationStrategy = 'load' | 'idle' | 'visible' | 'never' | `media(${string})`\n\nexport interface IslandOptions {\n  /** Unique name — must match the key in the client-side hydrateIslands() registry */\n  name: string\n  /** When to hydrate on the client (default: \"load\") */\n  hydrate?: HydrationStrategy\n}\n\nexport interface IslandMeta {\n  readonly __island: true\n  readonly name: string\n  readonly hydrate: HydrationStrategy\n}\n\n// ─── Server-side island factory ──────────────────────────────────────────────\n\n/**\n * Create an island component.\n *\n * Returns an async ComponentFn that:\n *   1. Resolves the dynamic import\n *   2. Renders the component to VNodes\n *   3. Wraps the output in `<pyreon-island>` with serialized props + hydration strategy\n */\nexport function island<P extends Props = Props>(\n  loader: () => Promise<{ default: ComponentFn<P> } | ComponentFn<P>>,\n  options: IslandOptions,\n): ComponentFn<P> & IslandMeta {\n  const { name, hydrate = 'load' } = options\n\n  const IslandWrapper = async function IslandWrapper(props: P): Promise<VNode | null> {\n    const mod = await loader()\n    const Comp = typeof mod === 'function' ? mod : mod.default\n    const serializedProps = serializeIslandProps(props)\n\n    return h(\n      'pyreon-island',\n      {\n        'data-component': name,\n        'data-props': serializedProps,\n        'data-hydrate': hydrate,\n      },\n      h(Comp, props),\n    )\n  }\n\n  // Attach metadata so the Vite plugin can detect islands for code-splitting\n  const wrapper = IslandWrapper as unknown as ComponentFn<P> & IslandMeta\n  Object.defineProperties(wrapper, {\n    __island: { value: true, enumerable: true },\n    name: { value: name, enumerable: true, writable: false, configurable: true },\n    hydrate: { value: hydrate, enumerable: true },\n  })\n\n  return wrapper\n}\n\n// ─── Helpers ─────────────────────────────────────────────────────────────────\n\n/**\n * Serialize component props to a JSON string for embedding in HTML attributes.\n * Strips non-serializable values (functions, symbols, children).\n */\nfunction serializeIslandProps(props: Record<string, unknown>): string {\n  const clean: Record<string, unknown> = {}\n  for (const [key, value] of Object.entries(props)) {\n    // Skip non-serializable or internal props\n    if (key === 'children') continue\n    if (typeof value === 'function') continue\n    if (typeof value === 'symbol') continue\n    if (value === undefined) continue\n    clean[key] = value\n  }\n  // The SSR renderer's renderProp() already applies escapeHtml() to attribute\n  // values, so the JSON is safe to embed in HTML attributes without double-escaping.\n  return JSON.stringify(clean)\n}\n","/**\n * Static Site Generation — pre-render routes to HTML files at build time.\n *\n * @example\n * // ssg.ts (run with: bun run ssg.ts)\n * import { createHandler } from \"@pyreon/server\"\n * import { prerender } from \"@pyreon/server\"\n * import { App } from \"./src/App\"\n * import { routes } from \"./src/routes\"\n *\n * const handler = createHandler({ App, routes })\n *\n * await prerender({\n *   handler,\n *   paths: [\"/\", \"/about\", \"/blog\", \"/blog/hello-world\"],\n *   outDir: \"dist\",\n * })\n *\n * @example\n * // Dynamic paths from a CMS or filesystem\n * await prerender({\n *   handler,\n *   paths: async () => {\n *     const posts = await fetchAllPosts()\n *     return [\"/\", \"/about\", ...posts.map(p => `/blog/${p.slug}`)]\n *   },\n *   outDir: \"dist\",\n * })\n */\n\nimport { mkdir, writeFile } from 'node:fs/promises'\nimport { dirname, join, resolve } from 'node:path'\n\nexport interface PrerenderOptions {\n  /** SSR handler created by createHandler() */\n  handler: (req: Request) => Promise<Response>\n  /** Routes to pre-render — array of URL paths or async function that returns them */\n  paths: string[] | (() => string[] | Promise<string[]>)\n  /** Output directory for the generated HTML files */\n  outDir: string\n  /** Origin for constructing full URLs (default: \"http://localhost\") */\n  origin?: string\n  /**\n   * Called after each page is rendered — use for logging or progress tracking.\n   * Return false to skip writing this page.\n   */\n  onPage?: (path: string, html: string) => void | boolean | Promise<void | boolean>\n}\n\nexport interface PrerenderResult {\n  /** Number of pages generated */\n  pages: number\n  /** Paths that failed to render */\n  errors: { path: string; error: unknown }[]\n  /** Total elapsed time in milliseconds */\n  elapsed: number\n}\n\n/**\n * Pre-render a list of routes to static HTML files.\n *\n * For each path:\n *   1. Constructs a Request for the path\n *   2. Calls the SSR handler to render to HTML\n *   3. Writes the HTML to `outDir/<path>/index.html`\n *\n * The root path \"/\" becomes `outDir/index.html`.\n * Paths like \"/about\" become `outDir/about/index.html`.\n */\nexport async function prerender(options: PrerenderOptions): Promise<PrerenderResult> {\n  const { handler, outDir, origin = 'http://localhost', onPage } = options\n\n  const start = Date.now()\n\n  // Resolve paths (may be async)\n  const paths = typeof options.paths === 'function' ? await options.paths() : options.paths\n\n  let pages = 0\n  const errors: PrerenderResult['errors'] = []\n\n  async function renderPage(path: string): Promise<void> {\n    const url = new URL(path, origin)\n    const req = new Request(url.href)\n    const res = await Promise.race([\n      handler(req),\n      new Promise<never>((_, reject) =>\n        setTimeout(() => reject(new Error(`Prerender timeout for \"${path}\" (30s)`)), 30_000),\n      ),\n    ])\n\n    if (!res.ok) {\n      errors.push({ path, error: new Error(`HTTP ${res.status}`) })\n      return\n    }\n\n    const html = await res.text()\n\n    if (onPage) {\n      const result = await onPage(path, html)\n      if (result === false) return\n    }\n\n    const filePath = resolveOutputPath(outDir, path)\n\n    const resolvedOut = resolve(outDir)\n    if (!resolve(filePath).startsWith(resolvedOut)) {\n      errors.push({ path, error: new Error(`Path traversal detected: \"${path}\"`) })\n      return\n    }\n\n    await mkdir(dirname(filePath), { recursive: true })\n    await writeFile(filePath, html, 'utf-8')\n    pages++\n  }\n\n  // Process paths concurrently (batch of 10 to avoid overwhelming)\n  const BATCH_SIZE = 10\n  for (let i = 0; i < paths.length; i += BATCH_SIZE) {\n    const batch = paths.slice(i, i + BATCH_SIZE)\n    await Promise.all(\n      batch.map(async (path) => {\n        try {\n          await renderPage(path)\n        } catch (error) {\n          errors.push({ path, error })\n        }\n      }),\n    )\n  }\n\n  return {\n    pages,\n    errors,\n    elapsed: Date.now() - start,\n  }\n}\n\nfunction resolveOutputPath(outDir: string, path: string): string {\n  if (path === '/') return join(outDir, 'index.html')\n  if (path.endsWith('.html')) return join(outDir, path)\n  return join(outDir, path, 'index.html')\n}\n"],"mappings":"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"}

package/lib/types/index.d.ts

@@ -38,6 +38,24 @@ interface MiddlewareContext {
  * Middleware function. Return a Response to short-circuit, or void to continue.
  */
 type Middleware = (ctx: MiddlewareContext) => Response | void | Promise<Response | void>;
+/**
+ * Read per-request locals inside a component (SSR only).
+ *
+ * Returns the `ctx.locals` object populated by middleware.
+ * On the client, returns an empty object.
+ *
+ * @example
+ * ```tsx
+ * import { useRequestLocals } from "@pyreon/server"
+ *
+ * function MyComponent() {
+ *   const locals = useRequestLocals()
+ *   const nonce = locals.cspNonce as string ?? ''
+ *   return <script nonce={nonce}>...</script>
+ * }
+ * ```
+ */
+declare function useRequestLocals(): Record<string, unknown>;
 //#endregion
 //#region src/handler.d.ts
 interface HandlerOptions {
@@ -64,6 +82,22 @@ interface HandlerOptions {
    *   "stream" — progressive streaming via renderToStream (Suspense out-of-order)
    */
   mode?: 'string' | 'stream';
+  /**
+   * Collect CSS styles after rendering. Called after renderToString/renderWithHead.
+   * Return a `<style>` tag string to inject into `<head>`.
+   * Used by @pyreon/styler's sheet.getStyleTag() to prevent FOUC in SSG.
+   *
+   * @example
+   * import { sheet } from '@pyreon/styler'
+   * createHandler({
+   *   collectStyles: () => {
+   *     const tag = sheet.getStyleTag()
+   *     sheet.reset()
+   *     return tag
+   *   },
+   * })
+   */
+  collectStyles?: () => string;
 }
 declare function createHandler(options: HandlerOptions): (req: Request) => Promise<Response>;
 //#endregion
@@ -197,5 +231,5 @@ interface PrerenderResult {
  */
 declare function prerender(options: PrerenderOptions): Promise<PrerenderResult>;
 //#endregion
-export { type CompiledTemplate, DEFAULT_TEMPLATE, type HandlerOptions, type HydrationStrategy, type IslandMeta, type IslandOptions, type Middleware, type MiddlewareContext, type PrerenderOptions, type PrerenderResult, type TemplateData, buildScripts, compileTemplate, createHandler, island, prerender, processCompiledTemplate, processTemplate };
+export { type CompiledTemplate, DEFAULT_TEMPLATE, type HandlerOptions, type HydrationStrategy, type IslandMeta, type IslandOptions, type Middleware, type MiddlewareContext, type PrerenderOptions, type PrerenderResult, type TemplateData, buildScripts, compileTemplate, createHandler, island, prerender, processCompiledTemplate, processTemplate, useRequestLocals };
 //# sourceMappingURL=index2.d.ts.map

package/lib/types/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index2.d.ts","names":[],"sources":["../../../src/middleware.ts","../../../src/handler.ts","../../../src/html.ts","../../../src/island.ts","../../../src/ssg.ts"],"mappings":";;;;;;;;AAqBA;;;;;;;;;;;;;;;;UAAiB,iBAAA;EAUP;EARR,GAAA,EAAK,OAAA;EAQS;EANd,GAAA,EAAK,GAAA;EAYe;EAVpB,IAAA;EAU6B;EAR7B,OAAA,EAAS,OAAA;EAQoE;EAN7E,MAAA,EAAQ,MAAA;AAAA;;;;KAME,UAAA,IAAc,GAAA,EAAK,iBAAA,KAAsB,QAAA,UAAkB,OAAA,CAAQ,QAAA;;;UCY9D,cAAA;EDZ8D;ECc7E,GAAA,EAAK,WAAA;EDduE;ECgB5E,MAAA,EAAQ,WAAA;EDhBqB;;;;;;;;ECyB7B,QAAA;;EAEA,WAAA;EAf6B;EAiB7B,UAAA,GAAa,UAAA;EAfR;;;;;EAqBL,IAAA;AAAA;AAAA,iBAGc,aAAA,CAAc,OAAA,EAAS,cAAA,IAAkB,GAAA,EAAK,OAAA,KAAY,OAAA,CAAQ,QAAA;;;;;;;ADtDlF;;;;cEZa,gBAAA;AAAA,UAaI,YAAA;EACf,IAAA;EACA,GAAA;EACA,OAAA;AAAA;;;;;UAOe,gBAAA;EFHN;EEKT,KAAA;AAAA;AAAA,iBAGc,eAAA,CAAgB,QAAA,WAAmB,gBAAA;AAAA,iBAgBnC,eAAA,CAAgB,QAAA,UAAkB,IAAA,EAAM,YAAA;AFhBxD;AAAA,iBEwBgB,uBAAA,CAAwB,QAAA,EAAU,gBAAA,EAAkB,IAAA,EAAM,YAAA;;;;;;;;iBAY1D,YAAA,CACd,WAAA,UACA,UAAA,EAAY,MAAA;;;KChBF,iBAAA;AAAA,UAEK,aAAA;EFGf;EEDA,IAAA;EFGa;EEDb,OAAA,GAAU,iBAAA;AAAA;AAAA,UAGK,UAAA;EAAA,SACN,QAAA;EAAA,SACA,IAAA;EAAA,SACA,OAAA,EAAS,iBAAA;AAAA;;;;;;;;;iBAaJ,MAAA,WAAiB,KAAA,GAAQ,KAAA,CAAA,CACvC,MAAA,QAAc,OAAA;EAAU,OAAA,EAAS,WAAA,CAAY,CAAA;AAAA,IAAO,WAAA,CAAY,CAAA,IAChE,OAAA,EAAS,aAAA,GACR,WAAA,CAAY,CAAA,IAAK,UAAA;;;;;;;AHlEpB;;;;;;;;;;;;;;;;;;;;AAgBA;;;;;UIJiB,gBAAA;EJIsD;EIFrE,OAAA,GAAU,GAAA,EAAK,OAAA,KAAY,OAAA,CAAQ,QAAA;EJEyC;EIA5E,KAAA,+BAAoC,OAAA;EJAZ;EIExB,MAAA;EJFqE;EIIrE,MAAA;EJJqF;;;;EISrF,MAAA,IAAU,IAAA,UAAc,IAAA,8BAAkC,OAAA;AAAA;AAAA,UAG3C,eAAA;;EAEf,KAAA;EHEQ;EGAR,MAAA;IAAU,IAAA;IAAc,KAAA;EAAA;EHFnB;EGIL,OAAA;AAAA;;;;;;;;AHoBF;;;;iBGNsB,SAAA,CAAU,OAAA,EAAS,gBAAA,GAAmB,OAAA,CAAQ,eAAA"}
+{"version":3,"file":"index2.d.ts","names":[],"sources":["../../../src/middleware.ts","../../../src/handler.ts","../../../src/html.ts","../../../src/island.ts","../../../src/ssg.ts"],"mappings":";;;;;;;;AAuBA;;;;;;;;;;;;;;;;UAAiB,iBAAA;EAUP;EARR,GAAA,EAAK,OAAA;EAQS;EANd,GAAA,EAAK,GAAA;EAYe;EAVpB,IAAA;EAU6B;EAR7B,OAAA,EAAS,OAAA;EAQoE;EAN7E,MAAA,EAAQ,MAAA;AAAA;;;;KAME,UAAA,IAAc,GAAA,EAAK,iBAAA,KAAsB,QAAA,UAAkB,OAAA,CAAQ,QAAA;;;;ACW/E;;;;;;;;;;;;;;iBDkBgB,gBAAA,CAAA,GAAoB,MAAA;;;UClBnB,cAAA;EDX8D;ECa7E,GAAA,EAAK,WAAA;EDbuE;ECe5E,MAAA,EAAQ,WAAA;EDfqB;;;;;;;AA6B/B;ECLE,QAAA;;EAEA,WAAA;EDGwC;ECDxC,UAAA,GAAa,UAAA;;;AAjBf;;;EAuBE,IAAA;EAnBQ;;;;;;;;;;;;;;;EAmCR,aAAA;AAAA;AAAA,iBAGc,aAAA,CAAc,OAAA,EAAS,cAAA,IAAkB,GAAA,EAAK,OAAA,KAAY,OAAA,CAAQ,QAAA;;;;;;;ADrElF;;;;cEda,gBAAA;AAAA,UAaI,YAAA;EACf,IAAA;EACA,GAAA;EACA,OAAA;AAAA;;;;;UAOe,gBAAA;EFDN;EEGT,KAAA;AAAA;AAAA,iBAGc,eAAA,CAAgB,QAAA,WAAmB,gBAAA;AAAA,iBAgBnC,eAAA,CAAgB,QAAA,UAAkB,IAAA,EAAM,YAAA;AFdxD;AAAA,iBEsBgB,uBAAA,CAAwB,QAAA,EAAU,gBAAA,EAAkB,IAAA,EAAM,YAAA;;;;;;;;iBAY1D,YAAA,CACd,WAAA,UACA,UAAA,EAAY,MAAA;;;KChBF,iBAAA;AAAA,UAEK,aAAA;EFTf;EEWA,IAAA;EFTA;EEWA,OAAA,GAAU,iBAAA;AAAA;AAAA,UAGK,UAAA;EAAA,SACN,QAAA;EAAA,SACA,IAAA;EAAA,SACA,OAAA,EAAS,iBAAA;AAAA;;;AFqBpB;;;;;;iBERgB,MAAA,WAAiB,KAAA,GAAQ,KAAA,CAAA,CACvC,MAAA,QAAc,OAAA;EAAU,OAAA,EAAS,WAAA,CAAY,CAAA;AAAA,IAAO,WAAA,CAAY,CAAA,IAChE,OAAA,EAAS,aAAA,GACR,WAAA,CAAY,CAAA,IAAK,UAAA;;;;;;;AHhEpB;;;;;;;;;;;;;;;;;;;;AAgBA;;;;;UINiB,gBAAA;EJMsD;EIJrE,OAAA,GAAU,GAAA,EAAK,OAAA,KAAY,OAAA,CAAQ,QAAA;EJIyC;EIF5E,KAAA,+BAAoC,OAAA;EJEZ;EIAxB,MAAA;EJAqE;EIErE,MAAA;EJFqF;;AA6BvF;;EItBE,MAAA,IAAU,IAAA,UAAc,IAAA,8BAAkC,OAAA;AAAA;AAAA,UAG3C,eAAA;;EAEf,KAAA;;EAEA,MAAA;IAAU,IAAA;IAAc,KAAA;EAAA;EHChB;EGCR,OAAA;AAAA;;;;;;;;;;;;iBAcoB,SAAA,CAAU,OAAA,EAAS,gBAAA,GAAmB,OAAA,CAAQ,eAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pyreon/server",
-  "version": "0.12.0",
+  "version": "0.12.2",
   "description": "SSR handler, SSG prerender, and island architecture for Pyreon",
   "homepage": "https://github.com/pyreon/pyreon/tree/main/packages/server#readme",
   "bugs": {
@@ -47,11 +47,11 @@
     "prepublishOnly": "bun run build"
   },
   "dependencies": {
-    "@pyreon/core": "^0.12.0",
-    "@pyreon/head": "^0.12.0",
-    "@pyreon/reactivity": "^0.12.0",
-    "@pyreon/router": "^0.12.0",
-    "@pyreon/runtime-dom": "^0.12.0",
-    "@pyreon/runtime-server": "^0.12.0"
+    "@pyreon/core": "^0.12.2",
+    "@pyreon/head": "^0.12.2",
+    "@pyreon/reactivity": "^0.12.2",
+    "@pyreon/router": "^0.12.2",
+    "@pyreon/runtime-dom": "^0.12.2",
+    "@pyreon/runtime-server": "^0.12.2"
   }
 }

package/src/handler.ts

@@ -44,6 +44,7 @@ import {
   processCompiledTemplate,
 } from './html'
 import type { Middleware, MiddlewareContext } from './middleware'
+import { provideRequestLocals } from './middleware'
 
 const __DEV__ = typeof process !== 'undefined' && process.env.NODE_ENV !== 'production'
 
@@ -71,6 +72,22 @@ export interface HandlerOptions {
    *   "stream" — progressive streaming via renderToStream (Suspense out-of-order)
    */
   mode?: 'string' | 'stream'
+  /**
+   * Collect CSS styles after rendering. Called after renderToString/renderWithHead.
+   * Return a `<style>` tag string to inject into `<head>`.
+   * Used by @pyreon/styler's sheet.getStyleTag() to prevent FOUC in SSG.
+   *
+   * @example
+   * import { sheet } from '@pyreon/styler'
+   * createHandler({
+   *   collectStyles: () => {
+   *     const tag = sheet.getStyleTag()
+   *     sheet.reset()
+   *     return tag
+   *   },
+   * })
+   */
+  collectStyles?: () => string
 }
 
 export function createHandler(options: HandlerOptions): (req: Request) => Promise<Response> {
@@ -81,6 +98,7 @@ export function createHandler(options: HandlerOptions): (req: Request) => Promis
     clientEntry = '/src/entry-client.ts',
     middleware = [],
     mode = 'string',
+    collectStyles,
   } = options
 
   // Pre-compile once at handler creation — avoids 3x string scan per request
@@ -110,6 +128,10 @@ export function createHandler(options: HandlerOptions): (req: Request) => Promis
 
     return runWithRequestContext(async () => {
       try {
+        // Bridge middleware locals → Pyreon context system so components
+        // can access per-request data (CSP nonce, auth user, etc.)
+        provideRequestLocals(ctx.locals)
+
         // Pre-run loaders so data is available during render
         await prefetchLoaderData(router as never, path)
 
@@ -122,9 +144,16 @@ export function createHandler(options: HandlerOptions): (req: Request) => Promis
 
         // ── String mode (default) ─────────────────────────────────────────────
         const { html: appHtml, head } = await renderWithHead(app)
+
+        // Collect CSS-in-JS styles if a collector was provided.
+        // The consumer passes collectStyles (e.g. sheet.getStyleTag from @pyreon/styler)
+        // to inject scoped CSS into <head> and prevent FOUC in SSG pages.
+        const styleTag = collectStyles ? collectStyles() : ''
+
         const loaderData = serializeLoaderData(router as never)
         const scripts = buildScriptsFast(clientEntryTag, loaderData)
-        const fullHtml = processCompiledTemplate(compiled, { head, app: appHtml, scripts })
+        const headWithStyles = styleTag ? `${styleTag}\n${head}` : head
+        const fullHtml = processCompiledTemplate(compiled, { head: headWithStyles, app: appHtml, scripts })
 
         return new Response(fullHtml, { status: 200, headers: ctx.headers })
       } catch (err) {

package/src/index.ts

@@ -70,6 +70,7 @@ export { island } from './island'
 
 // Middleware
 export type { Middleware, MiddlewareContext } from './middleware'
+export { useRequestLocals } from './middleware'
 export type { PrerenderOptions, PrerenderResult } from './ssg'
 // SSG
 export { prerender } from './ssg'

package/src/middleware.ts

@@ -19,6 +19,8 @@
  * })
  */
 
+import { createContext, useContext, provide } from '@pyreon/core'
+
 export interface MiddlewareContext {
   /** The incoming request */
   req: Request
@@ -36,3 +38,43 @@ export interface MiddlewareContext {
  * Middleware function. Return a Response to short-circuit, or void to continue.
  */
 export type Middleware = (ctx: MiddlewareContext) => Response | void | Promise<Response | void>
+
+/**
+ * Context for per-request locals — populated by the SSR handler from
+ * middleware `ctx.locals`. Components access it via `useRequestLocals()`.
+ *
+ * This bridges the middleware → component gap: middleware sets `ctx.locals`,
+ * the handler provides it into the Pyreon context system, and components
+ * read it without coupling to the middleware layer.
+ */
+export const RequestLocalsCtx = createContext<Record<string, unknown>>({})
+
+/**
+ * Read per-request locals inside a component (SSR only).
+ *
+ * Returns the `ctx.locals` object populated by middleware.
+ * On the client, returns an empty object.
+ *
+ * @example
+ * ```tsx
+ * import { useRequestLocals } from "@pyreon/server"
+ *
+ * function MyComponent() {
+ *   const locals = useRequestLocals()
+ *   const nonce = locals.cspNonce as string ?? ''
+ *   return <script nonce={nonce}>...</script>
+ * }
+ * ```
+ */
+export function useRequestLocals(): Record<string, unknown> {
+  return useContext(RequestLocalsCtx)
+}
+
+/**
+ * Provide request locals into the component tree.
+ * Called by the SSR handler — not for direct use.
+ * @internal
+ */
+export function provideRequestLocals(locals: Record<string, unknown>): void {
+  provide(RequestLocalsCtx, locals)
+}