nukejs 0.0.3 → 0.0.5

package/dist/build-vercel.js

@@ -1,13 +1,18 @@
 import fs from "fs";
 import path from "path";
+import crypto from "crypto";
+import { build } from "esbuild";
 import { loadConfig } from "./config.js";
 import {
-  analyzeFile,
   walkFiles,
-  buildPages,
-  bundleApiHandler,
-  buildReactBundle,
-  buildNukeBundle,
+  analyzeFile,
+  collectServerPages,
+  collectGlobalClientRegistry,
+  bundleClientComponents,
+  findPageLayouts,
+  buildPerPageRegistry,
+  makePageAdapterSource,
+  buildCombinedBundle,
   copyPublicFiles
 } from "./build-common.js";
 const OUTPUT_DIR = path.resolve(".vercel/output");
@@ -19,8 +24,8 @@ const config = await loadConfig();
 const SERVER_DIR = path.resolve(config.serverDir);
 const PAGES_DIR = path.resolve("./app/pages");
 const PUBLIC_DIR = path.resolve("./app/public");
-function emitVercelFunction(funcPath, bundleText) {
-  const funcDir = path.join(FUNCTIONS_DIR, funcPath.slice(1) + ".func");
+function emitVercelFunction(name, bundleText) {
+  const funcDir = path.join(FUNCTIONS_DIR, name + ".func");
   fs.mkdirSync(funcDir, { recursive: true });
   fs.writeFileSync(path.join(funcDir, "index.mjs"), bundleText);
   fs.writeFileSync(
@@ -28,26 +33,230 @@ function emitVercelFunction(funcPath, bundleText) {
     JSON.stringify({ runtime: "nodejs20.x", handler: "index.mjs", launcherType: "Nodejs" }, null, 2)
   );
 }
-function makeVercelRoute(srcRegex, paramNames, funcPath) {
-  let dest = funcPath;
-  if (paramNames.length > 0) {
-    dest += "?" + paramNames.map((name, i) => `${name}=$${i + 1}`).join("&");
+function makeApiDispatcherSource(routes) {
+  const imports = routes.map((r, i) => `import * as __api_${i}__ from ${JSON.stringify(r.absPath)};`).join("\n");
+  const routeEntries = routes.map(
+    (r, i) => `  { regex: ${JSON.stringify(r.srcRegex)}, params: ${JSON.stringify(r.paramNames)}, mod: __api_${i}__ },`
+  ).join("\n");
+  return `import type { IncomingMessage, ServerResponse } from 'http';
+${imports}
+
+function enhance(res: ServerResponse) {
+  (res as any).json = function(data: any, status = 200) {
+    this.statusCode = status;
+    this.setHeader('Content-Type', 'application/json');
+    this.end(JSON.stringify(data));
+  };
+  (res as any).status = function(code: number) { this.statusCode = code; return this; };
+  return res;
+}
+
+async function parseBody(req: IncomingMessage): Promise<any> {
+  return new Promise((resolve, reject) => {
+    let body = '';
+    req.on('data', (chunk: any) => { body += chunk.toString(); });
+    req.on('end', () => {
+      try {
+        resolve(
+          body && req.headers['content-type']?.includes('application/json')
+            ? JSON.parse(body)
+            : body,
+        );
+      } catch (e) { reject(e); }
+    });
+    req.on('error', reject);
+  });
+}
+
+const ROUTES = [
+${routeEntries}
+];
+
+export default async function handler(req: IncomingMessage, res: ServerResponse) {
+  const url      = new URL(req.url || '/', 'http://localhost');
+  const pathname = url.pathname;
+
+  for (const route of ROUTES) {
+    const m = pathname.match(new RegExp(route.regex));
+    if (!m) continue;
+
+    const method = (req.method || 'GET').toUpperCase();
+    const apiRes = enhance(res);
+    const apiReq = req as any;
+
+    apiReq.body   = await parseBody(req);
+    apiReq.query  = Object.fromEntries(url.searchParams);
+    apiReq.params = {};
+    route.params.forEach((name: string, i: number) => { apiReq.params[name] = m[i + 1]; });
+
+    const fn = (route.mod as any)[method] ?? (route.mod as any)['default'];
+    if (typeof fn !== 'function') {
+      (apiRes as any).json({ error: \`Method \${method} not allowed\` }, 405);
+      return;
+    }
+    await fn(apiReq, apiRes);
+    return;
   }
-  return { src: srcRegex, dest };
+
+  res.statusCode = 404;
+  res.setHeader('Content-Type', 'application/json');
+  res.end(JSON.stringify({ error: 'Not Found' }));
+}
+`;
+}
+function makePagesDispatcherSource(routes) {
+  const imports = routes.map((r, i) => `import __page_${i}__ from ${JSON.stringify(r.adapterPath)};`).join("\n");
+  const routeEntries = routes.map(
+    (r, i) => `  { regex: ${JSON.stringify(r.srcRegex)}, params: ${JSON.stringify(r.paramNames)}, handler: __page_${i}__ },`
+  ).join("\n");
+  return `import type { IncomingMessage, ServerResponse } from 'http';
+${imports}
+
+const ROUTES: Array<{
+  regex: string;
+  params: string[];
+  handler: (req: IncomingMessage, res: ServerResponse) => Promise<void>;
+}> = [
+${routeEntries}
+];
+
+export default async function handler(req: IncomingMessage, res: ServerResponse) {
+  const url      = new URL(req.url || '/', 'http://localhost');
+  const pathname = url.pathname;
+
+  for (const route of ROUTES) {
+    const m = pathname.match(new RegExp(route.regex));
+    if (!m) continue;
+
+    // Inject dynamic params as query-string values so page handlers can read
+    // them via new URL(req.url).searchParams \u2014 the same way they always have.
+    route.params.forEach((name, i) => url.searchParams.set(name, m[i + 1]));
+    req.url = pathname + (url.search || '');
+
+    return route.handler(req, res);
+  }
+
+  res.statusCode = 404;
+  res.setHeader('Content-Type', 'text/plain; charset=utf-8');
+  res.end('Not Found');
+}
+`;
 }
+const vercelRoutes = [];
 const apiFiles = walkFiles(SERVER_DIR);
 if (apiFiles.length === 0) console.warn(`\u26A0  No server files found in ${SERVER_DIR}`);
 const apiRoutes = apiFiles.map((relPath) => ({ ...analyzeFile(relPath, "api"), absPath: path.join(SERVER_DIR, relPath) })).sort((a, b) => b.specificity - a.specificity);
-const vercelRoutes = [];
-for (const { srcRegex, paramNames, funcPath, absPath } of apiRoutes) {
-  console.log(`  building  ${path.relative(SERVER_DIR, absPath)}  \u2192  ${funcPath}`);
-  emitVercelFunction(funcPath, await bundleApiHandler(absPath));
-  vercelRoutes.push(makeVercelRoute(srcRegex, paramNames, funcPath));
+if (apiRoutes.length > 0) {
+  const dispatcherSource = makeApiDispatcherSource(apiRoutes);
+  const dispatcherPath = path.join(SERVER_DIR, `_api_dispatcher_${crypto.randomBytes(4).toString("hex")}.ts`);
+  fs.writeFileSync(dispatcherPath, dispatcherSource);
+  try {
+    const result = await build({
+      entryPoints: [dispatcherPath],
+      bundle: true,
+      format: "esm",
+      platform: "node",
+      target: "node20",
+      packages: "external",
+      write: false
+    });
+    emitVercelFunction("api", result.outputFiles[0].text);
+    console.log(`  built     API dispatcher \u2192 api.func  (${apiRoutes.length} route(s))`);
+  } finally {
+    fs.unlinkSync(dispatcherPath);
+  }
+  for (const { srcRegex } of apiRoutes) {
+    vercelRoutes.push({ src: srcRegex, dest: "/api" });
+  }
 }
-const builtPages = await buildPages(PAGES_DIR, STATIC_DIR);
-for (const { srcRegex, paramNames, funcPath, bundleText } of builtPages) {
-  emitVercelFunction(funcPath, bundleText);
-  vercelRoutes.push(makeVercelRoute(srcRegex, paramNames, funcPath));
+const serverPages = collectServerPages(PAGES_DIR);
+if (serverPages.length > 0) {
+  const globalClientRegistry = collectGlobalClientRegistry(serverPages, PAGES_DIR);
+  const prerenderedHtml = await bundleClientComponents(globalClientRegistry, PAGES_DIR, STATIC_DIR);
+  const prerenderedHtmlRecord = Object.fromEntries(prerenderedHtml);
+  const tempAdapterPaths = [];
+  for (const page of serverPages) {
+    const { absPath } = page;
+    const adapterDir = path.dirname(absPath);
+    const adapterPath = path.join(adapterDir, `_page_adapter_${crypto.randomBytes(4).toString("hex")}.ts`);
+    const layoutPaths = findPageLayouts(absPath, PAGES_DIR);
+    const { registry, clientComponentNames } = buildPerPageRegistry(absPath, layoutPaths, PAGES_DIR);
+    const layoutImports = layoutPaths.map((lp, i) => {
+      const rel = path.relative(adapterDir, lp).replace(/\\/g, "/");
+      return `import __layout_${i}__ from ${JSON.stringify(rel.startsWith(".") ? rel : "./" + rel)};`;
+    }).join("\n");
+    fs.writeFileSync(
+      adapterPath,
+      makePageAdapterSource({
+        pageImport: JSON.stringify("./" + path.basename(absPath)),
+        layoutImports,
+        clientComponentNames,
+        allClientIds: [...registry.keys()],
+        layoutArrayItems: layoutPaths.map((_, i) => `__layout_${i}__`).join(", "),
+        prerenderedHtml: prerenderedHtmlRecord
+      })
+    );
+    tempAdapterPaths.push(adapterPath);
+    console.log(`  prepared  ${path.relative(PAGES_DIR, absPath)}  \u2192  ${page.funcPath}  [page]`);
+  }
+  const dispatcherRoutes = serverPages.map((page, i) => ({
+    adapterPath: tempAdapterPaths[i],
+    srcRegex: page.srcRegex,
+    paramNames: page.paramNames
+  }));
+  const dispatcherPath = path.join(PAGES_DIR, `_pages_dispatcher_${crypto.randomBytes(4).toString("hex")}.ts`);
+  fs.writeFileSync(dispatcherPath, makePagesDispatcherSource(dispatcherRoutes));
+  try {
+    const result = await build({
+      entryPoints: [dispatcherPath],
+      bundle: true,
+      format: "esm",
+      platform: "node",
+      target: "node20",
+      jsx: "automatic",
+      external: [
+        "node:*",
+        "http",
+        "https",
+        "fs",
+        "path",
+        "url",
+        "crypto",
+        "stream",
+        "buffer",
+        "events",
+        "util",
+        "os",
+        "net",
+        "tls",
+        "child_process",
+        "worker_threads",
+        "cluster",
+        "dgram",
+        "dns",
+        "readline",
+        "zlib",
+        "assert",
+        "module",
+        "perf_hooks",
+        "string_decoder",
+        "timers",
+        "async_hooks",
+        "v8",
+        "vm"
+      ],
+      define: { "process.env.NODE_ENV": '"production"' },
+      write: false
+    });
+    emitVercelFunction("pages", result.outputFiles[0].text);
+    console.log(`  built     Pages dispatcher \u2192 pages.func  (${serverPages.length} page(s))`);
+  } finally {
+    fs.unlinkSync(dispatcherPath);
+    for (const p of tempAdapterPaths) if (fs.existsSync(p)) fs.unlinkSync(p);
+  }
+  for (const { srcRegex } of serverPages) {
+    vercelRoutes.push({ src: srcRegex, dest: "/pages" });
+  }
 }
 fs.writeFileSync(
   path.join(OUTPUT_DIR, "config.json"),
@@ -57,9 +266,9 @@ fs.writeFileSync(
   path.resolve("vercel.json"),
   JSON.stringify({ runtime: "nodejs20.x" }, null, 2)
 );
-await buildReactBundle(STATIC_DIR);
-await buildNukeBundle(STATIC_DIR);
+await buildCombinedBundle(STATIC_DIR);
 copyPublicFiles(PUBLIC_DIR, STATIC_DIR);
+const fnCount = (apiRoutes.length > 0 ? 1 : 0) + (serverPages.length > 0 ? 1 : 0);
 console.log(`
-\u2713 Vercel build complete \u2014 ${vercelRoutes.length} function(s) \u2192 .vercel/output`);
+\u2713 Vercel build complete \u2014 ${fnCount} function(s) \u2192 .vercel/output`);
 //# sourceMappingURL=build-vercel.js.map

package/dist/build-vercel.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../src/build-vercel.ts"],
-  "sourcesContent": ["import fs from 'fs';\r\nimport path from 'path';\r\n\r\nimport { loadConfig } from './config';\r\nimport {\r\n  analyzeFile,\r\n  walkFiles,\r\n  buildPages,\r\n  bundleApiHandler,\r\n  buildReactBundle,\r\n  buildNukeBundle,\r\n  copyPublicFiles,\r\n} from './build-common';\r\n\r\n// \u2500\u2500\u2500 Output directories \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\r\n\r\nconst OUTPUT_DIR    = path.resolve('.vercel/output');\r\nconst FUNCTIONS_DIR = path.join(OUTPUT_DIR, 'functions');\r\nconst STATIC_DIR    = path.join(OUTPUT_DIR, 'static');\r\n\r\nfs.mkdirSync(FUNCTIONS_DIR, { recursive: true });\r\nfs.mkdirSync(STATIC_DIR,    { recursive: true });\r\n\r\n// \u2500\u2500\u2500 Config \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\r\n\r\nconst config     = await loadConfig();\r\nconst SERVER_DIR = path.resolve(config.serverDir);\r\nconst PAGES_DIR  = path.resolve('./app/pages');\r\nconst PUBLIC_DIR = path.resolve('./app/public');\r\n\r\n// \u2500\u2500\u2500 Helpers \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\r\n\r\n/** Writes a bundled handler into a Vercel .func directory. */\r\nfunction emitVercelFunction(funcPath: string, bundleText: string): void {\r\n  const funcDir = path.join(FUNCTIONS_DIR, funcPath.slice(1) + '.func');\r\n  fs.mkdirSync(funcDir, { recursive: true });\r\n  fs.writeFileSync(path.join(funcDir, 'index.mjs'), bundleText);\r\n  fs.writeFileSync(\r\n    path.join(funcDir, '.vc-config.json'),\r\n    JSON.stringify({ runtime: 'nodejs20.x', handler: 'index.mjs', launcherType: 'Nodejs' }, null, 2),\r\n  );\r\n}\r\n\r\ntype VercelRoute = { src: string; dest: string };\r\n\r\nfunction makeVercelRoute(srcRegex: string, paramNames: string[], funcPath: string): VercelRoute {\r\n  let dest = funcPath;\r\n  if (paramNames.length > 0) {\r\n    dest += '?' + paramNames.map((name, i) => `${name}=$${i + 1}`).join('&');\r\n  }\r\n  return { src: srcRegex, dest };\r\n}\r\n\r\n// \u2500\u2500\u2500 API routes \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\r\n\r\nconst apiFiles = walkFiles(SERVER_DIR);\r\nif (apiFiles.length === 0) console.warn(`\u26A0  No server files found in ${SERVER_DIR}`);\r\n\r\nconst apiRoutes = apiFiles\r\n  .map(relPath => ({ ...analyzeFile(relPath, 'api'), absPath: path.join(SERVER_DIR, relPath) }))\r\n  .sort((a, b) => b.specificity - a.specificity);\r\n\r\nconst vercelRoutes: VercelRoute[] = [];\r\n\r\nfor (const { srcRegex, paramNames, funcPath, absPath } of apiRoutes) {\r\n  console.log(`  building  ${path.relative(SERVER_DIR, absPath)}  \u2192  ${funcPath}`);\r\n  emitVercelFunction(funcPath, await bundleApiHandler(absPath));\r\n  vercelRoutes.push(makeVercelRoute(srcRegex, paramNames, funcPath));\r\n}\r\n\r\n// \u2500\u2500\u2500 Page routes \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\r\n\r\nconst builtPages = await buildPages(PAGES_DIR, STATIC_DIR);\r\n\r\nfor (const { srcRegex, paramNames, funcPath, bundleText } of builtPages) {\r\n  emitVercelFunction(funcPath, bundleText);\r\n  vercelRoutes.push(makeVercelRoute(srcRegex, paramNames, funcPath));\r\n}\r\n\r\n// \u2500\u2500\u2500 Vercel config \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\r\n\r\nfs.writeFileSync(\r\n  path.join(OUTPUT_DIR, 'config.json'),\r\n  JSON.stringify({ version: 3, routes: vercelRoutes }, null, 2),\r\n);\r\n\r\nfs.writeFileSync(\r\n  path.resolve('vercel.json'),\r\n  JSON.stringify({ runtime: 'nodejs20.x' }, null, 2),\r\n);\r\n\r\n// \u2500\u2500\u2500 Static assets \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\r\n\r\nawait buildReactBundle(STATIC_DIR);\r\nawait buildNukeBundle(STATIC_DIR);\r\ncopyPublicFiles(PUBLIC_DIR, STATIC_DIR);\r\n\r\nconsole.log(`\\n\u2713 Vercel build complete \u2014 ${vercelRoutes.length} function(s) \u2192 .vercel/output`);"],
-  "mappings": "AAAA,OAAO,QAAQ;AACf,OAAO,UAAU;AAEjB,SAAS,kBAAkB;AAC3B;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAIP,MAAM,aAAgB,KAAK,QAAQ,gBAAgB;AACnD,MAAM,gBAAgB,KAAK,KAAK,YAAY,WAAW;AACvD,MAAM,aAAgB,KAAK,KAAK,YAAY,QAAQ;AAEpD,GAAG,UAAU,eAAe,EAAE,WAAW,KAAK,CAAC;AAC/C,GAAG,UAAU,YAAe,EAAE,WAAW,KAAK,CAAC;AAI/C,MAAM,SAAa,MAAM,WAAW;AACpC,MAAM,aAAa,KAAK,QAAQ,OAAO,SAAS;AAChD,MAAM,YAAa,KAAK,QAAQ,aAAa;AAC7C,MAAM,aAAa,KAAK,QAAQ,cAAc;AAK9C,SAAS,mBAAmB,UAAkB,YAA0B;AACtE,QAAM,UAAU,KAAK,KAAK,eAAe,SAAS,MAAM,CAAC,IAAI,OAAO;AACpE,KAAG,UAAU,SAAS,EAAE,WAAW,KAAK,CAAC;AACzC,KAAG,cAAc,KAAK,KAAK,SAAS,WAAW,GAAG,UAAU;AAC5D,KAAG;AAAA,IACD,KAAK,KAAK,SAAS,iBAAiB;AAAA,IACpC,KAAK,UAAU,EAAE,SAAS,cAAc,SAAS,aAAa,cAAc,SAAS,GAAG,MAAM,CAAC;AAAA,EACjG;AACF;AAIA,SAAS,gBAAgB,UAAkB,YAAsB,UAA+B;AAC9F,MAAI,OAAO;AACX,MAAI,WAAW,SAAS,GAAG;AACzB,YAAQ,MAAM,WAAW,IAAI,CAAC,MAAM,MAAM,GAAG,IAAI,KAAK,IAAI,CAAC,EAAE,EAAE,KAAK,GAAG;AAAA,EACzE;AACA,SAAO,EAAE,KAAK,UAAU,KAAK;AAC/B;AAIA,MAAM,WAAW,UAAU,UAAU;AACrC,IAAI,SAAS,WAAW,EAAG,SAAQ,KAAK,oCAA+B,UAAU,EAAE;AAEnF,MAAM,YAAY,SACf,IAAI,cAAY,EAAE,GAAG,YAAY,SAAS,KAAK,GAAG,SAAS,KAAK,KAAK,YAAY,OAAO,EAAE,EAAE,EAC5F,KAAK,CAAC,GAAG,MAAM,EAAE,cAAc,EAAE,WAAW;AAE/C,MAAM,eAA8B,CAAC;AAErC,WAAW,EAAE,UAAU,YAAY,UAAU,QAAQ,KAAK,WAAW;AACnE,UAAQ,IAAI,eAAe,KAAK,SAAS,YAAY,OAAO,CAAC,aAAQ,QAAQ,EAAE;AAC/E,qBAAmB,UAAU,MAAM,iBAAiB,OAAO,CAAC;AAC5D,eAAa,KAAK,gBAAgB,UAAU,YAAY,QAAQ,CAAC;AACnE;AAIA,MAAM,aAAa,MAAM,WAAW,WAAW,UAAU;AAEzD,WAAW,EAAE,UAAU,YAAY,UAAU,WAAW,KAAK,YAAY;AACvE,qBAAmB,UAAU,UAAU;AACvC,eAAa,KAAK,gBAAgB,UAAU,YAAY,QAAQ,CAAC;AACnE;AAIA,GAAG;AAAA,EACD,KAAK,KAAK,YAAY,aAAa;AAAA,EACnC,KAAK,UAAU,EAAE,SAAS,GAAG,QAAQ,aAAa,GAAG,MAAM,CAAC;AAC9D;AAEA,GAAG;AAAA,EACD,KAAK,QAAQ,aAAa;AAAA,EAC1B,KAAK,UAAU,EAAE,SAAS,aAAa,GAAG,MAAM,CAAC;AACnD;AAIA,MAAM,iBAAiB,UAAU;AACjC,MAAM,gBAAgB,UAAU;AAChC,gBAAgB,YAAY,UAAU;AAEtC,QAAQ,IAAI;AAAA,sCAA+B,aAAa,MAAM,oCAA+B;",
+  "sourcesContent": ["import fs from 'fs';\r\nimport path from 'path';\r\nimport crypto from 'crypto';\r\nimport { build } from 'esbuild';\r\n\r\nimport { loadConfig } from './config';\r\nimport {\r\n  walkFiles,\r\n  analyzeFile,\r\n  collectServerPages,\r\n  collectGlobalClientRegistry,\r\n  bundleClientComponents,\r\n  findPageLayouts,\r\n  buildPerPageRegistry,\r\n  makePageAdapterSource,\r\n  buildCombinedBundle,\r\n  copyPublicFiles,\r\n} from './build-common';\r\n\r\n// \u2500\u2500\u2500 Output directories \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\r\n\r\nconst OUTPUT_DIR = path.resolve('.vercel/output');\r\nconst FUNCTIONS_DIR = path.join(OUTPUT_DIR, 'functions');\r\nconst STATIC_DIR = path.join(OUTPUT_DIR, 'static');\r\n\r\nfs.mkdirSync(FUNCTIONS_DIR, { recursive: true });\r\nfs.mkdirSync(STATIC_DIR, { recursive: true });\r\n\r\n// \u2500\u2500\u2500 Config \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\r\n\r\nconst config = await loadConfig();\r\nconst SERVER_DIR = path.resolve(config.serverDir);\r\nconst PAGES_DIR = path.resolve('./app/pages');\r\nconst PUBLIC_DIR = path.resolve('./app/public');\r\n\r\n// \u2500\u2500\u2500 Helpers \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\r\n\r\ntype VercelRoute = { src: string; dest: string };\r\n\r\n/** Writes a bundled dispatcher into a Vercel .func directory. */\r\nfunction emitVercelFunction(name: string, bundleText: string): void {\r\n  const funcDir = path.join(FUNCTIONS_DIR, name + '.func');\r\n  fs.mkdirSync(funcDir, { recursive: true });\r\n  fs.writeFileSync(path.join(funcDir, 'index.mjs'), bundleText);\r\n  fs.writeFileSync(\r\n    path.join(funcDir, '.vc-config.json'),\r\n    JSON.stringify({ runtime: 'nodejs20.x', handler: 'index.mjs', launcherType: 'Nodejs' }, null, 2),\r\n  );\r\n}\r\n\r\n// \u2500\u2500\u2500 API dispatcher source \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\r\n\r\n/**\r\n * Generates a single dispatcher that imports every API route module directly,\r\n * matches the incoming URL against each route's regex, injects captured params,\r\n * and calls the right HTTP-method export (GET, POST, \u2026) or default export.\r\n *\r\n * enhance / parseBody helpers are included once rather than once per route.\r\n */\r\nfunction makeApiDispatcherSource(\r\n  routes: Array<{ absPath: string; srcRegex: string; paramNames: string[] }>,\r\n): string {\r\n  const imports = routes\r\n    .map((r, i) => `import * as __api_${i}__ from ${JSON.stringify(r.absPath)};`)\r\n    .join('\\n');\r\n\r\n  const routeEntries = routes\r\n    .map((r, i) =>\r\n      `  { regex: ${JSON.stringify(r.srcRegex)}, params: ${JSON.stringify(r.paramNames)}, mod: __api_${i}__ },`,\r\n    )\r\n    .join('\\n');\r\n\r\n  return `\\\r\nimport type { IncomingMessage, ServerResponse } from 'http';\r\n${imports}\r\n\r\nfunction enhance(res: ServerResponse) {\r\n  (res as any).json = function(data: any, status = 200) {\r\n    this.statusCode = status;\r\n    this.setHeader('Content-Type', 'application/json');\r\n    this.end(JSON.stringify(data));\r\n  };\r\n  (res as any).status = function(code: number) { this.statusCode = code; return this; };\r\n  return res;\r\n}\r\n\r\nasync function parseBody(req: IncomingMessage): Promise<any> {\r\n  return new Promise((resolve, reject) => {\r\n    let body = '';\r\n    req.on('data', (chunk: any) => { body += chunk.toString(); });\r\n    req.on('end', () => {\r\n      try {\r\n        resolve(\r\n          body && req.headers['content-type']?.includes('application/json')\r\n            ? JSON.parse(body)\r\n            : body,\r\n        );\r\n      } catch (e) { reject(e); }\r\n    });\r\n    req.on('error', reject);\r\n  });\r\n}\r\n\r\nconst ROUTES = [\r\n${routeEntries}\r\n];\r\n\r\nexport default async function handler(req: IncomingMessage, res: ServerResponse) {\r\n  const url      = new URL(req.url || '/', 'http://localhost');\r\n  const pathname = url.pathname;\r\n\r\n  for (const route of ROUTES) {\r\n    const m = pathname.match(new RegExp(route.regex));\r\n    if (!m) continue;\r\n\r\n    const method = (req.method || 'GET').toUpperCase();\r\n    const apiRes = enhance(res);\r\n    const apiReq = req as any;\r\n\r\n    apiReq.body   = await parseBody(req);\r\n    apiReq.query  = Object.fromEntries(url.searchParams);\r\n    apiReq.params = {};\r\n    route.params.forEach((name: string, i: number) => { apiReq.params[name] = m[i + 1]; });\r\n\r\n    const fn = (route.mod as any)[method] ?? (route.mod as any)['default'];\r\n    if (typeof fn !== 'function') {\r\n      (apiRes as any).json({ error: \\`Method \\${method} not allowed\\` }, 405);\r\n      return;\r\n    }\r\n    await fn(apiReq, apiRes);\r\n    return;\r\n  }\r\n\r\n  res.statusCode = 404;\r\n  res.setHeader('Content-Type', 'application/json');\r\n  res.end(JSON.stringify({ error: 'Not Found' }));\r\n}\r\n`;\r\n}\r\n\r\n// \u2500\u2500\u2500 Pages dispatcher source \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\r\n\r\n/**\r\n * Generates a dispatcher that imports each page's pre-generated adapter by its\r\n * temp file path, matches the incoming URL, injects captured dynamic params as\r\n * query-string values (page handlers read params from req.url searchParams),\r\n * then delegates to the matching handler.\r\n */\r\nfunction makePagesDispatcherSource(\r\n  routes: Array<{ adapterPath: string; srcRegex: string; paramNames: string[] }>,\r\n): string {\r\n  const imports = routes\r\n    .map((r, i) => `import __page_${i}__ from ${JSON.stringify(r.adapterPath)};`)\r\n    .join('\\n');\r\n\r\n  const routeEntries = routes\r\n    .map((r, i) =>\r\n      `  { regex: ${JSON.stringify(r.srcRegex)}, params: ${JSON.stringify(r.paramNames)}, handler: __page_${i}__ },`,\r\n    )\r\n    .join('\\n');\r\n\r\n  return `\\\r\nimport type { IncomingMessage, ServerResponse } from 'http';\r\n${imports}\r\n\r\nconst ROUTES: Array<{\r\n  regex: string;\r\n  params: string[];\r\n  handler: (req: IncomingMessage, res: ServerResponse) => Promise<void>;\r\n}> = [\r\n${routeEntries}\r\n];\r\n\r\nexport default async function handler(req: IncomingMessage, res: ServerResponse) {\r\n  const url      = new URL(req.url || '/', 'http://localhost');\r\n  const pathname = url.pathname;\r\n\r\n  for (const route of ROUTES) {\r\n    const m = pathname.match(new RegExp(route.regex));\r\n    if (!m) continue;\r\n\r\n    // Inject dynamic params as query-string values so page handlers can read\r\n    // them via new URL(req.url).searchParams \u2014 the same way they always have.\r\n    route.params.forEach((name, i) => url.searchParams.set(name, m[i + 1]));\r\n    req.url = pathname + (url.search || '');\r\n\r\n    return route.handler(req, res);\r\n  }\r\n\r\n  res.statusCode = 404;\r\n  res.setHeader('Content-Type', 'text/plain; charset=utf-8');\r\n  res.end('Not Found');\r\n}\r\n`;\r\n}\r\n\r\n// \u2500\u2500\u2500 Build API function \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\r\n\r\nconst vercelRoutes: VercelRoute[] = [];\r\n\r\nconst apiFiles = walkFiles(SERVER_DIR);\r\nif (apiFiles.length === 0) console.warn(`\u26A0  No server files found in ${SERVER_DIR}`);\r\n\r\nconst apiRoutes = apiFiles\r\n  .map(relPath => ({ ...analyzeFile(relPath, 'api'), absPath: path.join(SERVER_DIR, relPath) }))\r\n  .sort((a, b) => b.specificity - a.specificity);\r\n\r\nif (apiRoutes.length > 0) {\r\n  const dispatcherSource = makeApiDispatcherSource(apiRoutes);\r\n  const dispatcherPath = path.join(SERVER_DIR, `_api_dispatcher_${crypto.randomBytes(4).toString('hex')}.ts`);\r\n  fs.writeFileSync(dispatcherPath, dispatcherSource);\r\n\r\n  try {\r\n    const result = await build({\r\n      entryPoints: [dispatcherPath],\r\n      bundle: true,\r\n      format: 'esm',\r\n      platform: 'node',\r\n      target: 'node20',\r\n      packages: 'external',\r\n      write: false,\r\n    });\r\n    emitVercelFunction('api', result.outputFiles[0].text);\r\n    console.log(`  built     API dispatcher \u2192 api.func  (${apiRoutes.length} route(s))`);\r\n  } finally {\r\n    fs.unlinkSync(dispatcherPath);\r\n  }\r\n\r\n  // API routes are listed first \u2014 they win on any URL collision with pages.\r\n  for (const { srcRegex } of apiRoutes) {\r\n    vercelRoutes.push({ src: srcRegex, dest: '/api' });\r\n  }\r\n}\r\n\r\n// \u2500\u2500\u2500 Build Pages function \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\r\n\r\nconst serverPages = collectServerPages(PAGES_DIR);\r\n\r\nif (serverPages.length > 0) {\r\n  // Pass 1 \u2014 bundle all client components to static files.\r\n  const globalClientRegistry = collectGlobalClientRegistry(serverPages, PAGES_DIR);\r\n  const prerenderedHtml = await bundleClientComponents(globalClientRegistry, PAGES_DIR, STATIC_DIR);\r\n  const prerenderedHtmlRecord = Object.fromEntries(prerenderedHtml);\r\n\r\n  // Pass 2 \u2014 write one temp adapter per page next to its source file (so\r\n  //           relative imports inside the component resolve correctly), then\r\n  //           bundle everything in one esbuild pass via the dispatcher.\r\n  const tempAdapterPaths: string[] = [];\r\n\r\n  for (const page of serverPages) {\r\n    const { absPath } = page;\r\n    const adapterDir = path.dirname(absPath);\r\n    const adapterPath = path.join(adapterDir, `_page_adapter_${crypto.randomBytes(4).toString('hex')}.ts`);\r\n\r\n    const layoutPaths = findPageLayouts(absPath, PAGES_DIR);\r\n    const { registry, clientComponentNames } = buildPerPageRegistry(absPath, layoutPaths, PAGES_DIR);\r\n\r\n    const layoutImports = layoutPaths\r\n      .map((lp, i) => {\r\n        const rel = path.relative(adapterDir, lp).replace(/\\\\/g, '/');\r\n        return `import __layout_${i}__ from ${JSON.stringify(rel.startsWith('.') ? rel : './' + rel)};`;\r\n      })\r\n      .join('\\n');\r\n\r\n    fs.writeFileSync(\r\n      adapterPath,\r\n      makePageAdapterSource({\r\n        pageImport: JSON.stringify('./' + path.basename(absPath)),\r\n        layoutImports,\r\n        clientComponentNames,\r\n        allClientIds: [...registry.keys()],\r\n        layoutArrayItems: layoutPaths.map((_, i) => `__layout_${i}__`).join(', '),\r\n        prerenderedHtml: prerenderedHtmlRecord,\r\n      }),\r\n    );\r\n\r\n    tempAdapterPaths.push(adapterPath);\r\n    console.log(`  prepared  ${path.relative(PAGES_DIR, absPath)}  \u2192  ${page.funcPath}  [page]`);\r\n  }\r\n\r\n  // Write the dispatcher and let esbuild bundle all adapters in one pass.\r\n  const dispatcherRoutes = serverPages.map((page, i) => ({\r\n    adapterPath: tempAdapterPaths[i],\r\n    srcRegex: page.srcRegex,\r\n    paramNames: page.paramNames,\r\n  }));\r\n\r\n  const dispatcherPath = path.join(PAGES_DIR, `_pages_dispatcher_${crypto.randomBytes(4).toString('hex')}.ts`);\r\n  fs.writeFileSync(dispatcherPath, makePagesDispatcherSource(dispatcherRoutes));\r\n\r\n  try {\r\n    const result = await build({\r\n      entryPoints: [dispatcherPath],\r\n      bundle: true,\r\n      format: 'esm',\r\n      platform: 'node',\r\n      target: 'node20',\r\n      jsx: 'automatic',\r\n      external: [\r\n        'node:*',\r\n        'http', 'https', 'fs', 'path', 'url', 'crypto', 'stream', 'buffer',\r\n        'events', 'util', 'os', 'net', 'tls', 'child_process', 'worker_threads',\r\n        'cluster', 'dgram', 'dns', 'readline', 'zlib', 'assert', 'module',\r\n        'perf_hooks', 'string_decoder', 'timers', 'async_hooks', 'v8', 'vm',\r\n      ],\r\n      define: { 'process.env.NODE_ENV': '\"production\"' },\r\n      write: false,\r\n    });\r\n    emitVercelFunction('pages', result.outputFiles[0].text);\r\n    console.log(`  built     Pages dispatcher \u2192 pages.func  (${serverPages.length} page(s))`);\r\n  } finally {\r\n    fs.unlinkSync(dispatcherPath);\r\n    for (const p of tempAdapterPaths) if (fs.existsSync(p)) fs.unlinkSync(p);\r\n  }\r\n\r\n  for (const { srcRegex } of serverPages) {\r\n    vercelRoutes.push({ src: srcRegex, dest: '/pages' });\r\n  }\r\n}\r\n\r\n// \u2500\u2500\u2500 Vercel config \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\r\n\r\nfs.writeFileSync(\r\n  path.join(OUTPUT_DIR, 'config.json'),\r\n  JSON.stringify({ version: 3, routes: vercelRoutes }, null, 2),\r\n);\r\n\r\nfs.writeFileSync(\r\n  path.resolve('vercel.json'),\r\n  JSON.stringify({ runtime: 'nodejs20.x' }, null, 2),\r\n);\r\n\r\n// \u2500\u2500\u2500 Static assets \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\r\n\r\nawait buildCombinedBundle(STATIC_DIR);\r\ncopyPublicFiles(PUBLIC_DIR, STATIC_DIR);\r\n\r\nconst fnCount = (apiRoutes.length > 0 ? 1 : 0) + (serverPages.length > 0 ? 1 : 0);\r\nconsole.log(`\\n\u2713 Vercel build complete \u2014 ${fnCount} function(s) \u2192 .vercel/output`);"],
+  "mappings": "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",
   "names": []
 }

package/dist/bundle.d.ts

@@ -23,14 +23,24 @@
  *   - The handler fetches the target URL as HTML, diffs the #app container,
  *     unmounts the old React roots, and re-hydrates the new ones.
  *   - HMR navigations add ?__hmr=1 so the server skips client-SSR (faster).
+ *
+ * Head tag management:
+ *   - The SSR renderer wraps every useHtml()-generated <meta>, <link>, <style>,
+ *     and <script> tag in <!--n-head-->…<!--/n-head--> sentinel comments.
+ *   - On each navigation the client diffs the live sentinel block against the
+ *     incoming one by fingerprint, adding new tags and removing gone ones.
+ *     Tags shared between pages (e.g. a layout stylesheet) are left untouched
+ *     so there is no removal/re-insertion flash.
+ *   - New tags are always inserted before <!--/n-head--> so they stay inside
+ *     the tracked block and remain visible to the diff on subsequent navigations.
  */
 /**
  * Patches history.pushState and history.replaceState to fire a custom
  * 'locationchange' event on window.  Also listens to 'popstate' for
  * back/forward navigation.
  *
- * This must be called after initRuntime sets up the navigation listener so
- * there's no race between the event firing and the listener being registered.
+ * Called after initRuntime sets up the navigation listener so there is no
+ * race between the event firing and the listener being registered.
  */
 export declare function setupLocationChangeMonitor(): void;
 type ClientDebugLevel = 'silent' | 'error' | 'info' | 'verbose';

package/dist/bundle.js

@@ -77,8 +77,8 @@ async function loadModules(ids, log, bust = "") {
   return mods;
 }
 const activeRoots = [];
-async function mountNodes(mods, log, isNavigation) {
-  const { hydrateRoot, createRoot } = await import("react-dom/client");
+async function mountNodes(mods, log) {
+  const { hydrateRoot } = await import("react-dom/client");
   const React = await import("react");
   const nodes = document.querySelectorAll("[data-hydrate-id]");
   log.verbose("Found", nodes.length, "hydration point(s)");
@@ -98,8 +98,7 @@ async function mountNodes(mods, log, isNavigation) {
     }
     try {
       const element = React.default.createElement(Comp, await reconstructProps(rawProps, mods));
-      const root = isNavigation ? createRoot(node) : hydrateRoot(node, element);
-      if (isNavigation) root.render(element);
+      const root = hydrateRoot(node, element);
       activeRoots.push(root);
       log.verbose("\u2713 Mounted:", id);
     } catch (err) {
@@ -107,13 +106,54 @@ async function mountNodes(mods, log, isNavigation) {
     }
   }
 }
+function headBlock(head) {
+  const nodes = [];
+  let closeComment = null;
+  let inside = false;
+  for (const child of Array.from(head.childNodes)) {
+    if (child.nodeType === Node.COMMENT_NODE) {
+      const text = child.data.trim();
+      if (text === "n-head") {
+        inside = true;
+        continue;
+      }
+      if (text === "/n-head") {
+        closeComment = child;
+        inside = false;
+        continue;
+      }
+    }
+    if (inside && child.nodeType === Node.ELEMENT_NODE)
+      nodes.push(child);
+  }
+  return { nodes, closeComment };
+}
+function fingerprint(el) {
+  return el.tagName + "|" + Array.from(el.attributes).sort((a, b) => a.name.localeCompare(b.name)).map((a) => `${a.name}=${a.value}`).join("&");
+}
+function syncHeadTags(doc) {
+  const live = headBlock(document.head);
+  const next = headBlock(doc.head);
+  const liveMap = /* @__PURE__ */ new Map();
+  for (const el of live.nodes) liveMap.set(fingerprint(el), el);
+  const nextMap = /* @__PURE__ */ new Map();
+  for (const el of next.nodes) nextMap.set(fingerprint(el), el);
+  let anchor = live.closeComment;
+  if (!anchor) {
+    document.head.appendChild(document.createComment("n-head"));
+    anchor = document.createComment("/n-head");
+    document.head.appendChild(anchor);
+  }
+  for (const [fp, el] of nextMap)
+    if (!liveMap.has(fp)) document.head.insertBefore(el, anchor);
+  for (const [fp, el] of liveMap)
+    if (!nextMap.has(fp)) el.remove();
+}
 function syncAttrs(live, next) {
-  for (const { name, value } of Array.from(next.attributes)) {
+  for (const { name, value } of Array.from(next.attributes))
     live.setAttribute(name, value);
-  }
-  for (const { name } of Array.from(live.attributes)) {
+  for (const { name } of Array.from(live.attributes))
     if (!next.hasAttribute(name)) live.removeAttribute(name);
-  }
 }
 function setupNavigation(log) {
   window.addEventListener("locationchange", async ({ detail: { href, hmr } }) => {
@@ -129,19 +169,20 @@ function setupNavigation(log) {
       const newApp = doc.getElementById("app");
       const currApp = document.getElementById("app");
       if (!newApp || !currApp) return;
-      activeRoots.splice(0).forEach((r) => r.unmount());
+      syncHeadTags(doc);
+      syncAttrs(document.documentElement, doc.documentElement);
+      syncAttrs(document.body, doc.body);
       currApp.innerHTML = newApp.innerHTML;
+      const newTitle = doc.querySelector("title");
+      if (newTitle) document.title = newTitle.textContent ?? "";
       const newDataEl = doc.getElementById("__n_data");
       const currDataEl = document.getElementById("__n_data");
       if (newDataEl && currDataEl) currDataEl.textContent = newDataEl.textContent;
-      const newTitle = doc.querySelector("title");
-      if (newTitle) document.title = newTitle.textContent ?? "";
-      syncAttrs(document.documentElement, doc.documentElement);
-      syncAttrs(document.body, doc.body);
+      activeRoots.splice(0).forEach((r) => r.unmount());
       const navData = JSON.parse(currDataEl?.textContent ?? "{}");
       log.info("\u{1F504} Route \u2192", href, "\u2014 mounting", navData.hydrateIds?.length ?? 0, "component(s)");
       const mods = await loadModules(navData.allIds ?? [], log, String(Date.now()));
-      await mountNodes(mods, log, true);
+      await mountNodes(mods, log);
       window.scrollTo(0, 0);
       log.info("\u{1F389} Navigation complete:", href);
     } catch (err) {
@@ -155,7 +196,7 @@ async function initRuntime(data) {
   log.info("\u{1F680} Partial hydration:", data.hydrateIds.length, "root component(s)");
   setupNavigation(log);
   const mods = await loadModules(data.allIds, log);
-  await mountNodes(mods, log, false);
+  await mountNodes(mods, log);
   log.info("\u{1F389} Done!");
   setupLocationChangeMonitor();
 }