blumenjs 0.2.1 → 0.2.3

package/dist/cli/commands/export.js

@@ -0,0 +1,241 @@
+// cli/commands/export.ts
+import { execSync, spawn } from "child_process";
+import * as fs2 from "fs";
+import * as path2 from "path";
+import * as http from "http";
+
+// cli/utils.ts
+import * as fs from "fs";
+import * as path from "path";
+import { fileURLToPath } from "url";
+var c = {
+  reset: "\x1B[0m",
+  bold: "\x1B[1m",
+  dim: "\x1B[2m",
+  red: "\x1B[31m",
+  green: "\x1B[32m",
+  yellow: "\x1B[33m",
+  blue: "\x1B[34m",
+  magenta: "\x1B[35m",
+  cyan: "\x1B[36m",
+  white: "\x1B[37m",
+  gray: "\x1B[90m"
+};
+var log = {
+  info: (msg) => console.log(`  ${c.magenta}\u25CF${c.reset}  ${msg}`),
+  success: (msg) => console.log(`  ${c.green}\u2713${c.reset}  ${msg}`),
+  error: (msg) => console.error(`  ${c.red}\u2717${c.reset}  ${msg}`),
+  warn: (msg) => console.log(`  ${c.yellow}\u26A0${c.reset}  ${msg}`),
+  step: (msg) => console.log(`  ${c.dim}\u2192${c.reset}  ${msg}`),
+  blank: () => console.log("")
+};
+function getVersion() {
+  try {
+    const thisFile = fileURLToPath(import.meta.url);
+    let dir = path.dirname(thisFile);
+    for (let i = 0; i < 5; i++) {
+      const pkgFile = path.join(dir, "package.json");
+      if (fs.existsSync(pkgFile)) {
+        const pkg = JSON.parse(fs.readFileSync(pkgFile, "utf-8"));
+        if (pkg.name === "blumenjs" || pkg.name === "go-react-ssr") {
+          return pkg.version;
+        }
+      }
+      dir = path.dirname(dir);
+    }
+    return "0.0.0";
+  } catch {
+    return "0.0.0";
+  }
+}
+function banner() {
+  const version = getVersion();
+  console.log("");
+  console.log(
+    `  ${c.magenta}${c.bold}\u{1F338} Blumen${c.reset} ${c.dim}v${version}${c.reset}`
+  );
+  console.log(
+    `  ${c.dim}The React framework powered by Go${c.reset}`
+  );
+  console.log("");
+}
+function divider() {
+  console.log(`  ${c.dim}${"\u2500".repeat(48)}${c.reset}`);
+}
+
+// cli/commands/export.ts
+async function renderPage(route, ssrUrl) {
+  const body = JSON.stringify({
+    path: route,
+    query: {},
+    params: {}
+  });
+  return new Promise((resolve2, reject) => {
+    const req = http.request(ssrUrl, {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json",
+        "Content-Length": Buffer.byteLength(body)
+      }
+    }, (res) => {
+      let data = "";
+      res.on("data", (chunk) => data += chunk);
+      res.on("end", () => {
+        try {
+          const json = JSON.parse(data);
+          if (json.html) {
+            resolve2(json.html);
+          } else {
+            reject(new Error("SSR response missing html field"));
+          }
+        } catch {
+          reject(new Error(`Invalid SSR response: ${data.slice(0, 100)}`));
+        }
+      });
+    });
+    req.on("error", (err) => reject(new Error(`SSR server unreachable: ${err.message}`)));
+    req.setTimeout(15e3, () => {
+      req.destroy();
+      reject(new Error("SSR timeout"));
+    });
+    req.write(body);
+    req.end();
+  });
+}
+function discoverRoutes() {
+  const pagesDir = path2.resolve("app/pages");
+  const routes = [];
+  function scan(dir, prefix) {
+    if (!fs2.existsSync(dir))
+      return;
+    const entries = fs2.readdirSync(dir, { withFileTypes: true });
+    for (const entry of entries) {
+      if (entry.name.startsWith("_") || entry.name.startsWith("."))
+        continue;
+      if (entry.isDirectory()) {
+        scan(path2.join(dir, entry.name), `${prefix}/${entry.name.toLowerCase()}`);
+      } else if (entry.name.endsWith(".tsx") && !entry.name.startsWith("NotFound")) {
+        const name = entry.name.replace(".tsx", "");
+        if (name.toLowerCase() === "home") {
+          routes.push("/");
+        } else if (name === "index") {
+          routes.push(prefix || "/");
+        } else if (!name.includes("[")) {
+          routes.push(`${prefix}/${name.toLowerCase()}`);
+        }
+      }
+    }
+  }
+  scan(pagesDir, "");
+  return routes;
+}
+async function waitForServer(url, maxWaitMs = 15e3) {
+  const start = Date.now();
+  while (Date.now() - start < maxWaitMs) {
+    try {
+      await new Promise((resolve2, reject) => {
+        const req = http.get(url, () => resolve2());
+        req.on("error", reject);
+        req.setTimeout(1e3, () => {
+          req.destroy();
+          reject(new Error("timeout"));
+        });
+      });
+      return true;
+    } catch {
+      await new Promise((r) => setTimeout(r, 500));
+    }
+  }
+  return false;
+}
+async function exportSite(args = []) {
+  banner();
+  let outDir = "dist/export";
+  for (let i = 0; i < args.length; i++) {
+    if (args[i] === "--out" && args[i + 1]) {
+      outDir = args[++i];
+    }
+  }
+  log.info("Exporting static site...");
+  log.blank();
+  log.info("Step 1/4: Building production bundle...");
+  try {
+    execSync("npx tsx cli/blumen.ts build", { stdio: "inherit", cwd: process.cwd() });
+  } catch {
+    log.error("Build failed. Fix errors and try again.");
+    process.exit(1);
+  }
+  log.blank();
+  log.info("Step 2/4: Starting SSR server for pre-rendering...");
+  const ssrProcess = spawn("node", ["dist/ssr-server.js"], {
+    cwd: process.cwd(),
+    env: { ...process.env, NODE_ENV: "production", PORT: "4001" },
+    stdio: "pipe"
+  });
+  const ssrUrl = "http://localhost:4001/render";
+  const serverReady = await waitForServer("http://localhost:4001/health", 15e3);
+  if (!serverReady) {
+    log.warn("SSR server health check failed, attempting rendering anyway...");
+  }
+  log.blank();
+  log.info("Step 3/4: Pre-rendering pages...");
+  const routes = discoverRoutes();
+  const outputDir = path2.resolve(outDir);
+  fs2.mkdirSync(outputDir, { recursive: true });
+  let success = 0;
+  let failed = 0;
+  for (const route of routes) {
+    try {
+      const html = await renderPage(route, ssrUrl);
+      const filePath = route === "/" ? path2.join(outputDir, "index.html") : path2.join(outputDir, route.slice(1), "index.html");
+      fs2.mkdirSync(path2.dirname(filePath), { recursive: true });
+      fs2.writeFileSync(filePath, html, "utf-8");
+      console.log(`  ${c.green}\u2713${c.reset} ${route} \u2192 ${path2.relative(process.cwd(), filePath)}`);
+      success++;
+    } catch (err) {
+      console.log(`  ${c.red}\u2717${c.reset} ${route}: ${err.message}`);
+      failed++;
+    }
+  }
+  ssrProcess.kill("SIGTERM");
+  log.blank();
+  log.info("Step 4/4: Copying static assets...");
+  const staticDir = path2.resolve("static");
+  if (fs2.existsSync(staticDir)) {
+    copyDir(staticDir, path2.join(outputDir, "static"));
+    log.success("Static assets copied.");
+  }
+  const distJs = path2.resolve("dist/client");
+  if (fs2.existsSync(distJs)) {
+    copyDir(distJs, path2.join(outputDir, "static/js"));
+  }
+  log.blank();
+  divider();
+  log.blank();
+  log.success(`Static export complete! \u2728`);
+  log.info(`${success} page(s) exported${failed > 0 ? `, ${failed} failed` : ""}`);
+  log.info(`Output: ${c.bold}${outDir}/${c.reset}`);
+  log.blank();
+  log.info(`Deploy anywhere:`);
+  log.info(`  ${c.dim}GitHub Pages:${c.reset} push ${outDir}/ to gh-pages branch`);
+  log.info(`  ${c.dim}Netlify:${c.reset}      set publish directory to ${outDir}/`);
+  log.info(`  ${c.dim}S3:${c.reset}           aws s3 sync ${outDir}/ s3://my-bucket`);
+  log.info(`  ${c.dim}Local:${c.reset}        npx serve ${outDir}/`);
+  log.blank();
+}
+function copyDir(src, dest) {
+  fs2.mkdirSync(dest, { recursive: true });
+  const entries = fs2.readdirSync(src, { withFileTypes: true });
+  for (const entry of entries) {
+    const srcPath = path2.join(src, entry.name);
+    const destPath = path2.join(dest, entry.name);
+    if (entry.isDirectory()) {
+      copyDir(srcPath, destPath);
+    } else {
+      fs2.copyFileSync(srcPath, destPath);
+    }
+  }
+}
+export {
+  exportSite
+};

package/dist/cli/commands/migrate.js

@@ -0,0 +1,267 @@
+// cli/commands/migrate.ts
+import * as fs2 from "fs";
+import * as path2 from "path";
+
+// cli/utils.ts
+import * as fs from "fs";
+import * as path from "path";
+import { fileURLToPath } from "url";
+var c = {
+  reset: "\x1B[0m",
+  bold: "\x1B[1m",
+  dim: "\x1B[2m",
+  red: "\x1B[31m",
+  green: "\x1B[32m",
+  yellow: "\x1B[33m",
+  blue: "\x1B[34m",
+  magenta: "\x1B[35m",
+  cyan: "\x1B[36m",
+  white: "\x1B[37m",
+  gray: "\x1B[90m"
+};
+var log = {
+  info: (msg) => console.log(`  ${c.magenta}\u25CF${c.reset}  ${msg}`),
+  success: (msg) => console.log(`  ${c.green}\u2713${c.reset}  ${msg}`),
+  error: (msg) => console.error(`  ${c.red}\u2717${c.reset}  ${msg}`),
+  warn: (msg) => console.log(`  ${c.yellow}\u26A0${c.reset}  ${msg}`),
+  step: (msg) => console.log(`  ${c.dim}\u2192${c.reset}  ${msg}`),
+  blank: () => console.log("")
+};
+function getVersion() {
+  try {
+    const thisFile = fileURLToPath(import.meta.url);
+    let dir = path.dirname(thisFile);
+    for (let i = 0; i < 5; i++) {
+      const pkgFile = path.join(dir, "package.json");
+      if (fs.existsSync(pkgFile)) {
+        const pkg = JSON.parse(fs.readFileSync(pkgFile, "utf-8"));
+        if (pkg.name === "blumenjs" || pkg.name === "go-react-ssr") {
+          return pkg.version;
+        }
+      }
+      dir = path.dirname(dir);
+    }
+    return "0.0.0";
+  } catch {
+    return "0.0.0";
+  }
+}
+function banner() {
+  const version = getVersion();
+  console.log("");
+  console.log(
+    `  ${c.magenta}${c.bold}\u{1F338} Blumen${c.reset} ${c.dim}v${version}${c.reset}`
+  );
+  console.log(
+    `  ${c.dim}The React framework powered by Go${c.reset}`
+  );
+  console.log("");
+}
+function divider() {
+  console.log(`  ${c.dim}${"\u2500".repeat(48)}${c.reset}`);
+}
+
+// cli/commands/migrate.ts
+function isNextJsProject(dir) {
+  return fs2.existsSync(path2.join(dir, "next.config.js")) || fs2.existsSync(path2.join(dir, "next.config.mjs")) || fs2.existsSync(path2.join(dir, "next.config.ts")) || fs2.existsSync(path2.join(dir, "pages")) || fs2.existsSync(path2.join(dir, "src/pages"));
+}
+function findPagesDir(dir) {
+  if (fs2.existsSync(path2.join(dir, "pages")))
+    return path2.join(dir, "pages");
+  if (fs2.existsSync(path2.join(dir, "src/pages")))
+    return path2.join(dir, "src/pages");
+  if (fs2.existsSync(path2.join(dir, "app")))
+    return path2.join(dir, "app");
+  return null;
+}
+function getAllTsxFiles(dir) {
+  const results = [];
+  if (!fs2.existsSync(dir))
+    return results;
+  const entries = fs2.readdirSync(dir, { withFileTypes: true });
+  for (const entry of entries) {
+    const fullPath = path2.join(dir, entry.name);
+    if (entry.isDirectory()) {
+      results.push(...getAllTsxFiles(fullPath));
+    } else if (/\.(tsx?|jsx?)$/.test(entry.name)) {
+      results.push(fullPath);
+    }
+  }
+  return results;
+}
+function rewriteImports(content, depth) {
+  const prefix = "../".repeat(depth) || "./";
+  const sharedPrefix = `${prefix}../shared`;
+  content = content.replace(
+    /import\s+(?:Link|{[^}]*})\s+from\s+['"]next\/link['"]/g,
+    `import { Link } from "${sharedPrefix}/Link"`
+  );
+  content = content.replace(
+    /import\s+(?:Head|{[^}]*})\s+from\s+['"]next\/head['"]/g,
+    `import { BlumenHead } from "${sharedPrefix}/BlumenHead"`
+  );
+  content = content.replace(
+    /import\s+(?:Image|{[^}]*})\s+from\s+['"]next\/image['"]/g,
+    `// TODO: Replace next/image with standard <img> or BlumenImage
+// import Image from "next/image"`
+  );
+  content = content.replace(
+    /import\s+(?:{[^}]*})\s+from\s+['"]next\/router['"]/g,
+    `import { useRouter } from "${sharedPrefix}/RouterContext"`
+  );
+  return content;
+}
+function rewriteDataFetching(content) {
+  const changes = [];
+  if (content.includes("getServerSideProps")) {
+    content = content.replace(/getServerSideProps/g, "getServerProps");
+    changes.push("getServerSideProps \u2192 getServerProps");
+  }
+  if (content.includes("getStaticProps") && !content.includes("force-static")) {
+    content += `
+
+// Mark this page for static generation
+export const dynamic = 'force-static';
+`;
+    changes.push("Added export const dynamic = 'force-static'");
+  }
+  content = content.replace(/GetServerSidePropsContext/g, "BlumenContext");
+  if (content.includes("BlumenContext") && !content.includes("import")) {
+    changes.push("GetServerSidePropsContext \u2192 BlumenContext");
+  }
+  return { content, changes };
+}
+async function migrate(args = []) {
+  banner();
+  const dryRun = args.includes("--dry-run");
+  const sourceDir = args.find((a) => !a.startsWith("--")) || ".";
+  const absDir = path2.resolve(sourceDir);
+  log.info(`Analyzing ${c.bold}${absDir}${c.reset} for Next.js project...`);
+  log.blank();
+  if (!isNextJsProject(absDir)) {
+    log.error("No Next.js project detected.");
+    log.info("Expected: next.config.js/mjs/ts or pages/ directory");
+    process.exit(1);
+  }
+  log.success("Next.js project detected!");
+  log.blank();
+  const result = {
+    moved: [],
+    rewritten: [],
+    warnings: [],
+    errors: []
+  };
+  const pagesDir = findPagesDir(absDir);
+  if (!pagesDir) {
+    log.error("Could not find pages/ or src/pages/ directory");
+    process.exit(1);
+  }
+  const isAppRouter = pagesDir.endsWith("/app");
+  if (isAppRouter) {
+    result.warnings.push("Next.js App Router detected. Migration from App Router requires manual review.");
+  }
+  log.info(`Pages directory: ${c.bold}${path2.relative(absDir, pagesDir)}/${c.reset}`);
+  log.blank();
+  divider();
+  log.blank();
+  console.log(`  ${c.bold}${c.cyan}\u25B8 Step 1: Analyzing files${c.reset}`);
+  log.blank();
+  const files = getAllTsxFiles(pagesDir);
+  console.log(`  Found ${files.length} source file(s)`);
+  log.blank();
+  console.log(`  ${c.bold}${c.cyan}\u25B8 Step 2: Rewriting imports${c.reset}`);
+  log.blank();
+  for (const file of files) {
+    const relPath = path2.relative(pagesDir, file);
+    const depth = relPath.split("/").length;
+    let content = fs2.readFileSync(file, "utf-8");
+    let modified = false;
+    const fileChanges = [];
+    const newContent = rewriteImports(content, depth);
+    if (newContent !== content) {
+      content = newContent;
+      modified = true;
+      fileChanges.push("Import rewrites");
+    }
+    const { content: dfContent, changes } = rewriteDataFetching(content);
+    if (changes.length > 0) {
+      content = dfContent;
+      modified = true;
+      fileChanges.push(...changes);
+    }
+    if (modified) {
+      if (!dryRun) {
+        fs2.writeFileSync(file, content, "utf-8");
+      }
+      console.log(`  ${c.green}\u2713${c.reset} ${relPath}: ${fileChanges.join(", ")}`);
+      result.rewritten.push(relPath);
+    }
+  }
+  if (result.rewritten.length === 0) {
+    console.log(`  ${c.dim}No import rewrites needed${c.reset}`);
+  }
+  log.blank();
+  console.log(`  ${c.bold}${c.cyan}\u25B8 Step 3: File structure mapping${c.reset}`);
+  log.blank();
+  const mappings = [
+    ["pages/_app.tsx", "\u2192", "app/shared/_app.tsx"],
+    ["pages/_document.tsx", "\u2192", "app/shared/_document.tsx"],
+    ["pages/index.tsx", "\u2192", "app/pages/Home.tsx"],
+    ["pages/[slug].tsx", "\u2192", "app/pages/[slug].tsx"],
+    ["pages/api/", "\u2192", "app/api/ (Blumen API routes)"],
+    ["public/", "\u2192", "static/"],
+    ["styles/", "\u2192", "app/shared/styles/"]
+  ];
+  for (const [from, arrow, to] of mappings) {
+    console.log(`  ${c.dim}${from}${c.reset} ${arrow} ${c.bold}${to}${c.reset}`);
+  }
+  log.blank();
+  divider();
+  log.blank();
+  console.log(`  ${c.bold}Migration Summary${c.reset}`);
+  log.blank();
+  const summaryTable = [
+    ["Files analyzed", `${files.length}`],
+    ["Imports rewritten", `${result.rewritten.length}`],
+    ["Warnings", `${result.warnings.length}`],
+    ["Mode", dryRun ? "Dry run (no changes)" : "Applied"]
+  ];
+  for (const [label, value] of summaryTable) {
+    console.log(`  ${c.dim}${label}:${c.reset} ${value}`);
+  }
+  log.blank();
+  if (result.warnings.length > 0) {
+    console.log(`  ${c.yellow}${c.bold}Warnings:${c.reset}`);
+    for (const w of result.warnings) {
+      console.log(`  ${c.yellow}\u26A0${c.reset}  ${w}`);
+    }
+    log.blank();
+  }
+  console.log(`  ${c.bold}Next Steps${c.reset}`);
+  log.blank();
+  console.log(`  1. Move your page files to ${c.bold}app/pages/${c.reset}`);
+  console.log(`  2. Move ${c.bold}_app.tsx${c.reset} to ${c.bold}app/shared/_app.tsx${c.reset}`);
+  console.log(`  3. Move ${c.bold}public/${c.reset} to ${c.bold}static/${c.reset}`);
+  console.log(`  4. Replace ${c.bold}next/image${c.reset} usage with standard ${c.bold}<img>${c.reset} or ${c.bold}<BlumenImage>${c.reset}`);
+  console.log(`  5. Run ${c.bold}blumen dev${c.reset} to test`);
+  log.blank();
+  console.log(`  ${c.bold}API Comparison${c.reset}`);
+  log.blank();
+  const comparison = [
+    ["next/link", "Link from shared/Link", "\u2713 Auto-converted"],
+    ["next/head", "BlumenHead", "\u2713 Auto-converted"],
+    ["next/router", "useRouter from RouterContext", "\u2713 Auto-converted"],
+    ["getServerSideProps", "getServerProps", "\u2713 Auto-converted"],
+    ["getStaticProps", "getStaticProps", "\u2713 Same API + force-static"],
+    ["next/image", "<img> or <BlumenImage>", "\u26A0 Manual review"],
+    ["API Routes (pages/api)", "app/api/ handlers", "\u26A0 Manual migration"],
+    ["Middleware", "Go middleware", "\u26A0 Manual migration"]
+  ];
+  for (const [next, blumen, status] of comparison) {
+    console.log(`  ${c.dim}${next.padEnd(25)}${c.reset}\u2192 ${blumen.padEnd(30)} ${status}`);
+  }
+  log.blank();
+}
+export {
+  migrate
+};

package/dist/cli/commands/test.js

@@ -0,0 +1,118 @@
+// cli/commands/test.ts
+import { execSync } from "child_process";
+
+// cli/utils.ts
+import * as fs from "fs";
+import * as path from "path";
+import { fileURLToPath } from "url";
+var c = {
+  reset: "\x1B[0m",
+  bold: "\x1B[1m",
+  dim: "\x1B[2m",
+  red: "\x1B[31m",
+  green: "\x1B[32m",
+  yellow: "\x1B[33m",
+  blue: "\x1B[34m",
+  magenta: "\x1B[35m",
+  cyan: "\x1B[36m",
+  white: "\x1B[37m",
+  gray: "\x1B[90m"
+};
+var log = {
+  info: (msg) => console.log(`  ${c.magenta}\u25CF${c.reset}  ${msg}`),
+  success: (msg) => console.log(`  ${c.green}\u2713${c.reset}  ${msg}`),
+  error: (msg) => console.error(`  ${c.red}\u2717${c.reset}  ${msg}`),
+  warn: (msg) => console.log(`  ${c.yellow}\u26A0${c.reset}  ${msg}`),
+  step: (msg) => console.log(`  ${c.dim}\u2192${c.reset}  ${msg}`),
+  blank: () => console.log("")
+};
+function getVersion() {
+  try {
+    const thisFile = fileURLToPath(import.meta.url);
+    let dir = path.dirname(thisFile);
+    for (let i = 0; i < 5; i++) {
+      const pkgFile = path.join(dir, "package.json");
+      if (fs.existsSync(pkgFile)) {
+        const pkg = JSON.parse(fs.readFileSync(pkgFile, "utf-8"));
+        if (pkg.name === "blumenjs" || pkg.name === "go-react-ssr") {
+          return pkg.version;
+        }
+      }
+      dir = path.dirname(dir);
+    }
+    return "0.0.0";
+  } catch {
+    return "0.0.0";
+  }
+}
+function banner() {
+  const version = getVersion();
+  console.log("");
+  console.log(
+    `  ${c.magenta}${c.bold}\u{1F338} Blumen${c.reset} ${c.dim}v${version}${c.reset}`
+  );
+  console.log(
+    `  ${c.dim}The React framework powered by Go${c.reset}`
+  );
+  console.log("");
+}
+function divider() {
+  console.log(`  ${c.dim}${"\u2500".repeat(48)}${c.reset}`);
+}
+
+// cli/commands/test.ts
+async function test(args = []) {
+  banner();
+  const watch = args.includes("--watch");
+  const coverage = args.includes("--coverage");
+  const ui = args.includes("--ui");
+  const pattern = args.filter((a) => !a.startsWith("--")).join(" ");
+  let cmd = "npx vitest run";
+  if (watch) {
+    cmd = "npx vitest";
+    log.info("Starting test watcher...");
+  } else if (ui) {
+    cmd = "npx vitest --ui";
+    log.info("Opening Vitest UI...");
+  } else if (coverage) {
+    cmd = "npx vitest run --coverage";
+    log.info("Running tests with coverage...");
+  } else {
+    log.info("Running tests...");
+  }
+  if (pattern) {
+    cmd += ` ${pattern}`;
+  }
+  log.blank();
+  divider();
+  log.blank();
+  try {
+    execSync(cmd, {
+      stdio: "inherit",
+      cwd: process.cwd(),
+      env: {
+        ...process.env,
+        NODE_ENV: "test"
+      }
+    });
+    log.blank();
+    divider();
+    log.blank();
+    log.success("All tests passed! \u2728");
+    log.blank();
+  } catch (err) {
+    log.blank();
+    divider();
+    log.blank();
+    if (err.status) {
+      log.error(`Tests failed with exit code ${err.status}`);
+      process.exit(err.status);
+    } else {
+      log.error("Test runner encountered an error");
+      process.exit(1);
+    }
+  }
+}
+export {
+  test
+};

package/dist/templates/app/client/entry.tsx

@@ -3,9 +3,13 @@ import { hydrateRoot } from "react-dom/client";
 import NotFoundPage from "../pages/NotFound";
 
 // Auto-generated route map (run `npm run routes` to regenerate)
-import { routes, App } from "./generated-routes";
+import { routes, App, routeChunkMap } from "./generated-routes";
 import { RouterProvider } from "../shared/RouterContext";
 
+// Expose chunk map globally for the prefetch system
+// (prefetchCache.ts reads this to know which JS chunk to preload on hover)
+(window as any).__BLUMEN_CHUNK_MAP__ = routeChunkMap;
+
 function init() {
 	const container = document.getElementById("root");
 	if (!container) {

package/dist/templates/app/shared/DefaultDocument.tsx

@@ -19,12 +19,19 @@ function sanitizeForHydration(data: any): string {
 }
 // HMR: In development, load the client bundle from Webpack Dev Server
 // so the HMR runtime + React Fast Refresh are active.
+// With code splitting, WDS serves multiple chunks instead of one bundle.js.
 const isDev = process.env.NODE_ENV === "development";
-const BUNDLE_SRC = isDev
-    ? "http://localhost:3100/static/js/bundle.js"
-    : "/static/js/bundle.js";
+const WDS_BASE = "http://localhost:3100/static/js";
 
-export function DefaultDocument({ children, initialProps, metadata }: any) {
+// Dev mode core scripts — loaded in dependency order
+const DEV_SCRIPTS = [
+    `${WDS_BASE}/runtime.js`,
+    `${WDS_BASE}/vendor.js`,
+    `${WDS_BASE}/framework.js`,
+    `${WDS_BASE}/main.js`,
+];
+
+export function DefaultDocument({ children, initialProps, metadata, scripts }: any) {
     const css = `
         * { margin: 0; padding: 0; box-sizing: border-box; }
         body { font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, Oxygen, Ubuntu, Cantarell, sans-serif; line-height: 1.6; color: #e2e8f0; background: #1a1025; }
@@ -114,7 +121,14 @@ export function DefaultDocument({ children, initialProps, metadata }: any) {
                         __html: sanitizeForHydration(initialProps)
                     }}
                 />
-                <script src={BUNDLE_SRC} defer></script>
+                {isDev
+                    ? DEV_SCRIPTS.map((src, i) => (
+                          <script key={i} src={src} defer></script>
+                      ))
+                    : (scripts || ['/static/js/main.js']).map((src: string, i: number) => (
+                          <script key={i} src={src} defer></script>
+                      ))
+                }
             </body>
         </html>
     );