dinou 6.1.1 → 7.0.0

package/dinou/cloudflare/build.mjs

@@ -0,0 +1,1121 @@
+// dinou/cloudflare/build.mjs
+// Dual-Bundle Build script for packaging Dinou v7 for Cloudflare Workers.
+// Pass A: RSC Engine (conditions: ["workerd", "worker", "react-server"])
+// Pass B: Native Streaming HTML SSR Engine (conditions: ["workerd", "worker", "browser"])
+// Pass C: Main Worker Orchestrator (worker.js)
+
+import fs from "node:fs";
+import path from "node:path";
+import esbuild from "esbuild";
+import { createRequire } from "node:module";
+import { fileURLToPath, pathToFileURL } from "node:url";
+
+const require = createRequire(import.meta.url);
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+const { generateRouteModulesCode, generateRouteTypes } = require("../core/route-generator.js");
+const parseExports = require("../core/parse-exports.js");
+const { useClientRegex, useServerRegex } = require("../constants.js");
+const {
+  isSupportedClientModule,
+  scanProjectDependenciesForClientComponents,
+} = require("../core/scan-dependency-components.js");
+
+const projectRoot = process.cwd();
+const cloudflareDir = path.resolve(projectRoot, ".dinou/cloudflare");
+fs.mkdirSync(cloudflareDir, { recursive: true });
+
+try {
+  generateRouteTypes(projectRoot);
+} catch (e) {}
+
+// Locate dinou root: ejected in project or in package directory
+const dinouDir = fs.existsSync(path.resolve(projectRoot, "dinou"))
+  ? path.resolve(projectRoot, "dinou")
+  : path.resolve(__dirname, "..");
+const dinouDirSlash = dinouDir.replace(/\\/g, "/");
+
+const candidateDinouRoots = [
+  dinouDir,
+  path.resolve(projectRoot, "dinou"),
+  path.resolve(projectRoot, "node_modules/dinou/dinou"),
+  path.resolve(projectRoot, "node_modules/dinou"),
+  path.resolve(__dirname, ".."),
+];
+
+const candidateLinkPaths = new Set();
+const candidateRedirectPaths = new Set();
+const candidateSlotPaths = new Set();
+
+for (const r of candidateDinouRoots) {
+  candidateLinkPaths.add(path.resolve(r, "core/link.jsx"));
+  candidateRedirectPaths.add(path.resolve(r, "core/client-redirect.jsx"));
+  candidateSlotPaths.add(path.resolve(r, "core/slot.js"));
+}
+
+function copyRecursive(src, dest) {
+  if (!fs.existsSync(src)) return 0;
+  let count = 0;
+  const entries = fs.readdirSync(src, { withFileTypes: true });
+  for (const entry of entries) {
+    const srcPath = path.join(src, entry.name);
+    const destPath = path.join(dest, entry.name);
+    if (entry.isDirectory()) {
+      fs.mkdirSync(destPath, { recursive: true });
+      count += copyRecursive(srcPath, destPath);
+    } else {
+      fs.mkdirSync(path.dirname(destPath), { recursive: true });
+      fs.copyFileSync(srcPath, destPath);
+      count++;
+    }
+  }
+  return count;
+}
+
+const isWebpackBuild = process.env.DINOU_BUILD_TOOL === "webpack";
+const bundlerName = isWebpackBuild ? "webpack" : (process.env.DINOU_BUILD_TOOL || "esbuild");
+
+const dist2Dir = path.resolve(projectRoot, ".dinou/dist2");
+const dist3Dir = path.resolve(projectRoot, ".dinou/dist3");
+console.log(`\n🦖 Dinou v7 (Cloudflare Workers • ${bundlerName})`);
+if (fs.existsSync(dist2Dir)) {
+  const copiedCount = copyRecursive(dist2Dir, dist3Dir);
+  console.log(`  📄 Synchronized ${copiedCount} pre-rendered static route(s) to .dinou/dist3`);
+}
+console.log("  ⚡ Generating route modules & manifests...");
+const routeModulesCode = generateRouteModulesCode(projectRoot, "../..");
+const routeModulesPath = path.join(cloudflareDir, "route-modules.js");
+fs.writeFileSync(routeModulesPath, routeModulesCode, "utf8");
+
+function findManifest(filename, fallbackFolder) {
+  const candidates = isWebpackBuild
+    ? [
+        path.resolve(projectRoot, ".dinou/dist3", filename),
+        path.resolve(projectRoot, ".dinou/public", filename),
+        path.resolve(projectRoot, ".dinou", fallbackFolder, filename),
+      ]
+    : [
+        path.resolve(projectRoot, ".dinou", fallbackFolder, filename),
+        path.resolve(projectRoot, ".dinou/dist3", filename),
+        path.resolve(projectRoot, ".dinou/public", filename),
+      ];
+  for (const c of candidates) {
+    if (fs.existsSync(c)) return c;
+  }
+  return null;
+}
+
+const clientManifestPath = findManifest("react-client-manifest.json", "react_client_manifest");
+const sfManifestPath = findManifest("server-functions-manifest.json", "server_functions_manifest");
+
+let parsedClientManifest = {};
+if (clientManifestPath && fs.existsSync(clientManifestPath)) {
+  try {
+    parsedClientManifest = JSON.parse(fs.readFileSync(clientManifestPath, "utf8"));
+  } catch (e) {}
+}
+
+let parsedServerFunctionsManifest = {};
+if (sfManifestPath && fs.existsSync(sfManifestPath)) {
+  try {
+    parsedServerFunctionsManifest = JSON.parse(fs.readFileSync(sfManifestPath, "utf8"));
+  } catch (e) {}
+}
+
+// ====================================================================
+// Discovery of Client Components for SSR Engine & RSC Manifest
+// ====================================================================
+if (process.env.DINOU_DEBUG) {
+  console.log("🔍 [Dinou Cloudflare] Discovering client components for SSR Engine...");
+}
+const srcDir = path.resolve(projectRoot, "src");
+
+
+function findClientComponents() {
+  const clientFiles = new Set();
+  function walk(dir) {
+    if (!fs.existsSync(dir)) return;
+    const entries = fs.readdirSync(dir, { withFileTypes: true });
+    for (const entry of entries) {
+      const full = path.join(dir, entry.name);
+      if (entry.isDirectory()) {
+        walk(full);
+      } else if (/\.[jt]sx?$/.test(entry.name)) {
+        try {
+          const content = fs.readFileSync(full, "utf8");
+          if (useClientRegex.test(content.trim()) && isSupportedClientModule(full, content)) {
+            clientFiles.add(path.resolve(full));
+          }
+        } catch (e) {}
+      }
+    }
+  }
+  walk(srcDir);
+
+  const coreCandidates = [
+    ...Array.from(candidateLinkPaths),
+    ...Array.from(candidateRedirectPaths),
+  ];
+  for (const f of coreCandidates) {
+    if (fs.existsSync(f)) {
+      clientFiles.add(path.resolve(f));
+    }
+  }
+
+  // Also scan external dependencies from package.json for "use client" components (e.g. react-enhanced-suspense)
+  scanProjectDependenciesForClientComponents(projectRoot, clientFiles, useClientRegex);
+
+  for (const k of Object.keys(parsedClientManifest)) {
+    const fileUrl = k.split("#")[0];
+    if (fileUrl.startsWith("file:///")) {
+      try {
+        const filePath = fileURLToPath(fileUrl);
+        const baseName = path.basename(filePath);
+        if (baseName === "client.jsx" || baseName === "client-webpack.jsx") {
+          continue;
+        }
+        if (fs.existsSync(filePath) && isSupportedClientModule(filePath)) {
+          clientFiles.add(path.resolve(filePath));
+        }
+      } catch (e) {}
+    }
+  }
+
+  return Array.from(clientFiles);
+}
+
+const clientComponents = findClientComponents();
+if (process.env.DINOU_DEBUG) {
+  console.log(`   Found ${clientComponents.length} client component(s) for Native SSR.`);
+}
+
+let manifestInlines = "";
+const normalizedManifest = { ...parsedClientManifest };
+for (const [k, v] of Object.entries(parsedClientManifest)) {
+  if (k.startsWith("file:///c:/")) {
+    normalizedManifest["file:///C:/" + k.slice(11)] = v;
+  } else if (k.startsWith("file:///C:/")) {
+    normalizedManifest["file:///c:/" + k.slice(11)] = v;
+  }
+}
+
+function generateAllUrlVariants(absPath) {
+  const norm = absPath.replace(/\\/g, "/");
+  const fileUrl = pathToFileURL(absPath).href;
+  const urls = new Set([fileUrl]);
+  urls.add(fileUrl.replace(/file:\/\/\/([a-zA-Z]):/, (m, d) => 'file:///' + d.toLowerCase() + ':'));
+  urls.add(fileUrl.replace(/file:\/\/\/([a-zA-Z]):/, (m, d) => 'file:///' + d.toUpperCase() + ':'));
+  urls.add("file:///" + norm);
+  urls.add("file://" + norm);
+  return Array.from(urls);
+}
+
+
+let linkChunkId = null;
+let redirectChunkId = null;
+let slotChunkId = null;
+let linkEntry = null;
+let redirectEntry = null;
+let slotEntry = null;
+
+for (const [k, v] of Object.entries(parsedClientManifest)) {
+  if (k.includes("/core/link.jsx") || k.includes("dinouLink")) {
+    if (v && v.id) {
+      linkChunkId = v.id;
+      linkEntry = v;
+    }
+  }
+  if (k.includes("/core/client-redirect.jsx") || k.includes("dinouClientRedirect")) {
+    if (v && v.id) {
+      redirectChunkId = v.id;
+      redirectEntry = v;
+    }
+  }
+  if (k.includes("/core/slot.") || k.includes("dinouSlot")) {
+    if (v && v.id) {
+      slotChunkId = v.id;
+      slotEntry = v;
+    }
+  }
+}
+
+if (linkChunkId) {
+  const linkChunks = isWebpackBuild
+    ? (linkEntry?.chunks || [linkChunkId])
+    : "Link";
+  const linkDefaultChunks = isWebpackBuild
+    ? (linkEntry?.chunks || [linkChunkId])
+    : "default";
+
+  for (const lp of candidateLinkPaths) {
+    for (const url of generateAllUrlVariants(lp)) {
+      normalizedManifest[`${url}#Link`] = { id: linkChunkId, chunks: linkChunks, name: "Link" };
+      normalizedManifest[`${url}#default`] = { id: linkChunkId, chunks: linkDefaultChunks, name: "default" };
+      normalizedManifest[url] = { id: linkChunkId, chunks: linkDefaultChunks, name: "default" };
+    }
+  }
+}
+
+if (redirectChunkId) {
+  const redirectChunks = isWebpackBuild
+    ? (redirectEntry?.chunks || [redirectChunkId])
+    : "ClientRedirect";
+  const redirectDefaultChunks = isWebpackBuild
+    ? (redirectEntry?.chunks || [redirectChunkId])
+    : "default";
+
+  for (const rp of candidateRedirectPaths) {
+    for (const url of generateAllUrlVariants(rp)) {
+      normalizedManifest[`${url}#ClientRedirect`] = { id: redirectChunkId, chunks: redirectChunks, name: "ClientRedirect" };
+      normalizedManifest[`${url}#default`] = { id: redirectChunkId, chunks: redirectDefaultChunks, name: "default" };
+      normalizedManifest[url] = { id: redirectChunkId, chunks: redirectDefaultChunks, name: "default" };
+    }
+  }
+}
+
+if (slotChunkId) {
+  const slotChunks = isWebpackBuild
+    ? (slotEntry?.chunks || [slotChunkId])
+    : "DinouPageSlot";
+  const slotBoundaryChunks = isWebpackBuild
+    ? (slotEntry?.chunks || [slotChunkId])
+    : "DinouCacheSlotBoundary";
+  const slotDefaultChunks = isWebpackBuild
+    ? (slotEntry?.chunks || [slotChunkId])
+    : "default";
+
+  for (const sp of candidateSlotPaths) {
+    for (const url of generateAllUrlVariants(sp)) {
+      normalizedManifest[`${url}#DinouPageSlot`] = { id: slotChunkId, chunks: slotChunks, name: "DinouPageSlot" };
+      normalizedManifest[`${url}#DinouCacheSlotBoundary`] = { id: slotChunkId, chunks: slotBoundaryChunks, name: "DinouCacheSlotBoundary" };
+      normalizedManifest[`${url}#default`] = { id: slotChunkId, chunks: slotDefaultChunks, name: "default" };
+      normalizedManifest[url] = { id: slotChunkId, chunks: slotDefaultChunks, name: "default" };
+    }
+  }
+}
+
+for (const comp of clientComponents) {
+  const fileUrl = pathToFileURL(comp).href;
+  const fileUrlLower = fileUrl.replace(/file:\/\/\/([a-zA-Z]):/, (m, d) => 'file:///' + d.toLowerCase() + ':');
+  const fileUrlUpper = fileUrl.replace(/file:\/\/\/([a-zA-Z]):/, (m, d) => 'file:///' + d.toUpperCase() + ':');
+  const compResolved = path.resolve(comp);
+  const isCoreLink = candidateLinkPaths.has(compResolved);
+  const isCoreRedirect = candidateRedirectPaths.has(compResolved);
+  const isCoreSlot = candidateSlotPaths.has(compResolved);
+
+  if (!normalizedManifest[fileUrlLower]) {
+    if (isCoreLink && linkChunkId) {
+      normalizedManifest[fileUrlLower] = {
+        id: linkChunkId,
+        chunks: isWebpackBuild ? (linkEntry?.chunks || [linkChunkId]) : "default",
+        name: "default",
+      };
+    } else if (isCoreRedirect && redirectChunkId) {
+      normalizedManifest[fileUrlLower] = {
+        id: redirectChunkId,
+        chunks: isWebpackBuild ? (redirectEntry?.chunks || [redirectChunkId]) : "default",
+        name: "default",
+      };
+    } else if (isCoreSlot && slotChunkId) {
+      normalizedManifest[fileUrlLower] = {
+        id: slotChunkId,
+        chunks: isWebpackBuild ? (slotEntry?.chunks || [slotChunkId]) : "default",
+        name: "default",
+      };
+    } else {
+      normalizedManifest[fileUrlLower] = { id: fileUrlLower, chunks: [], name: "*" };
+    }
+  }
+  if (!normalizedManifest[fileUrlUpper]) {
+    if (isCoreLink && linkChunkId) {
+      normalizedManifest[fileUrlUpper] = {
+        id: linkChunkId,
+        chunks: isWebpackBuild ? (linkEntry?.chunks || [linkChunkId]) : "default",
+        name: "default",
+      };
+    } else if (isCoreRedirect && redirectChunkId) {
+      normalizedManifest[fileUrlUpper] = {
+        id: redirectChunkId,
+        chunks: isWebpackBuild ? (redirectEntry?.chunks || [redirectChunkId]) : "default",
+        name: "default",
+      };
+    } else if (isCoreSlot && slotChunkId) {
+      normalizedManifest[fileUrlUpper] = {
+        id: slotChunkId,
+        chunks: isWebpackBuild ? (slotEntry?.chunks || [slotChunkId]) : "default",
+        name: "default",
+      };
+    } else {
+      normalizedManifest[fileUrlUpper] = { id: fileUrlLower, chunks: [], name: "*" };
+    }
+  }
+}
+
+manifestInlines += `\nglobalThis.__DINOU_CLIENT_MANIFEST__ = ${JSON.stringify(normalizedManifest)};\n`;
+
+if (sfManifestPath && fs.existsSync(sfManifestPath)) {
+  const content = fs.readFileSync(sfManifestPath, "utf8");
+  manifestInlines += `\nglobalThis.__DINOU_SERVER_FUNCTIONS_MANIFEST__ = ${content};\n`;
+} else {
+  manifestInlines += `\nglobalThis.__DINOU_SERVER_FUNCTIONS_MANIFEST__ = {};\n`;
+}
+
+const assetManifestPath = findManifest("manifest.json", "dist3");
+if (assetManifestPath && fs.existsSync(assetManifestPath)) {
+  const content = fs.readFileSync(assetManifestPath, "utf8");
+  manifestInlines += `\nglobalThis.__DINOU_ASSET_MANIFEST__ = ${content};\n`;
+} else {
+  manifestInlines += `\nglobalThis.__DINOU_ASSET_MANIFEST__ = {};\n`;
+}
+
+let importMapHtml = "";
+if (!isWebpackBuild && Object.keys(parsedClientManifest).length > 0) {
+  const imports = {};
+  const moduleBasePath = pathToFileURL(projectRoot).href + "/";
+
+  for (const [key, val] of Object.entries(parsedClientManifest)) {
+    let specifier = key;
+    if (specifier.startsWith(moduleBasePath)) {
+      specifier = specifier.slice(moduleBasePath.length);
+    }
+    const hashIdx = specifier.indexOf("#");
+    if (hashIdx !== -1) {
+      specifier = specifier.slice(0, hashIdx);
+    }
+    imports[specifier] = val.id;
+
+    const srcIdx = key.indexOf("/src/");
+    if (srcIdx !== -1) {
+      const srcRel = "src/" + key.slice(srcIdx + 5).split("#")[0];
+      imports[srcRel] = val.id;
+      imports["/" + srcRel] = val.id;
+      imports["./" + srcRel] = val.id;
+    }
+    const dinouIdx = key.lastIndexOf("/dinou/");
+    if (dinouIdx !== -1) {
+      const dinouRel = "dinou/" + key.slice(dinouIdx + 7).split("#")[0];
+      imports[dinouRel] = val.id;
+      imports["/" + dinouRel] = val.id;
+      imports["./" + dinouRel] = val.id;
+    }
+  }
+
+  if (linkChunkId) {
+    imports["dinou/core/link.jsx"] = linkChunkId;
+    imports["dinou/core/link"] = linkChunkId;
+    imports["/dinou/core/link.jsx"] = linkChunkId;
+    imports["./dinou/core/link.jsx"] = linkChunkId;
+    for (const lp of candidateLinkPaths) {
+      for (const u of generateAllUrlVariants(lp)) {
+        imports[u] = linkChunkId;
+      }
+    }
+  }
+  if (redirectChunkId) {
+    imports["dinou/core/client-redirect.jsx"] = redirectChunkId;
+    imports["dinou/core/client-redirect"] = redirectChunkId;
+    imports["/dinou/core/client-redirect.jsx"] = redirectChunkId;
+    imports["./dinou/core/client-redirect.jsx"] = redirectChunkId;
+    for (const rp of candidateRedirectPaths) {
+      for (const u of generateAllUrlVariants(rp)) {
+        imports[u] = redirectChunkId;
+      }
+    }
+  }
+
+  importMapHtml = `<script type="importmap">{"imports":${JSON.stringify(imports)}}</script>`;
+}
+
+manifestInlines += `\nglobalThis.__DINOU_IMPORT_MAP_HTML__ = ${JSON.stringify(importMapHtml)};\n`;
+
+const discoveredLayouts = [];
+function findLayoutRoutes(dir, rel = "") {
+  if (!fs.existsSync(dir)) return;
+  const entries = fs.readdirSync(dir, { withFileTypes: true });
+  for (const entry of entries) {
+    if (entry.isDirectory()) {
+      findLayoutRoutes(path.join(dir, entry.name), rel ? `${rel}/${entry.name}` : entry.name);
+    } else if (/^layout\.[jt]sx?$/.test(entry.name)) {
+      discoveredLayouts.push(rel);
+    }
+  }
+}
+findLayoutRoutes(srcDir);
+manifestInlines += `\nglobalThis.__DINOU_LAYOUTS__ = ${JSON.stringify(discoveredLayouts)};\n`;
+
+if (process.env.DINOU_DEBUG) {
+
+  console.log("⚡ [Dinou Cloudflare] Building in-memory VFS for Edge routing...");
+}
+const vfsSnapshot = {};
+function walkVfs(dir) {
+  if (!fs.existsSync(dir)) return;
+  const entries = fs.readdirSync(dir, { withFileTypes: true });
+  const children = [];
+  for (const entry of entries) {
+    const isDir = entry.isDirectory();
+    children.push({ name: entry.name, isDirectory: isDir });
+    const fullPath = path.join(dir, entry.name);
+    const relFromSrc = path.relative(srcDir, fullPath).replace(/\\/g, "/");
+    const edgePath = "/src/" + relFromSrc;
+    const slashPath = fullPath.replace(/\\/g, "/");
+    if (isDir) {
+      walkVfs(fullPath);
+    } else {
+      vfsSnapshot[edgePath] = { type: "file" };
+      vfsSnapshot[slashPath] = { type: "file" };
+      if (slashPath.length > 2 && slashPath[1] === ":") {
+        vfsSnapshot[slashPath.slice(2)] = { type: "file" };
+      }
+      vfsSnapshot["src/" + relFromSrc] = { type: "file" };
+    }
+  }
+  const dirRel = path.relative(srcDir, dir).replace(/\\/g, "/");
+  const edgeDir = dirRel ? "/src/" + dirRel : "/src";
+  const dirSlash = dir.replace(/\\/g, "/");
+  vfsSnapshot[edgeDir] = { type: "directory", children };
+  vfsSnapshot[dirSlash] = { type: "directory", children };
+  if (dirSlash.length > 2 && dirSlash[1] === ":") {
+    vfsSnapshot[dirSlash.slice(2)] = { type: "directory", children };
+  }
+  vfsSnapshot[dirRel ? "src/" + dirRel : "src"] = { type: "directory", children };
+}
+walkVfs(srcDir);
+
+const envSetupContent = `// Auto-generated environment setup
+if (typeof globalThis.__webpack_require__ === 'undefined') {
+  globalThis.__webpack_require__ = function(id) {
+    if (globalThis.__webpack_modules__ && globalThis.__webpack_modules__[id]) {
+      return globalThis.__webpack_modules__[id];
+    }
+    return {};
+  };
+}
+if (typeof globalThis.__webpack_require__.u === 'undefined') {
+  globalThis.__webpack_require__.u = function(chunkId) { return '' + chunkId + '.js'; };
+}
+if (typeof globalThis.__webpack_chunk_load__ === 'undefined') {
+  globalThis.__webpack_chunk_load__ = () => Promise.resolve();
+}
+${manifestInlines}
+globalThis.__DINOU_VFS__ = ${JSON.stringify(vfsSnapshot)};
+`;
+const envSetupPath = path.join(cloudflareDir, "env-setup.js");
+fs.writeFileSync(envSetupPath, envSetupContent, "utf8");
+
+// Generate ssr-client-manifest.js
+let ssrManifestCode = `// Auto-generated client modules registry for Native Edge SSR\n`;
+clientComponents.forEach((compPath, index) => {
+  const normPath = compPath.replace(/\\/g, "/");
+  ssrManifestCode += `import * as mod_${index} from ${JSON.stringify(normPath)};\n`;
+});
+
+const serverFunctionFiles = Object.keys(parsedServerFunctionsManifest);
+serverFunctionFiles.forEach((relPath, index) => {
+  const absPath = path.resolve(projectRoot, relPath).replace(/\\/g, "/");
+  ssrManifestCode += `import * as sf_${index} from ${JSON.stringify(absPath)};\n`;
+});
+
+ssrManifestCode += `\nexport const clientModules = {\n`;
+const emittedClientModules = new Set();
+function addClientModule(key, valueExpr) {
+  if (!emittedClientModules.has(key)) {
+    emittedClientModules.add(key);
+    ssrManifestCode += `  ${JSON.stringify(key)}: ${valueExpr},\n`;
+  }
+}
+
+clientComponents.forEach((compPath, index) => {
+  const fileUrl = pathToFileURL(compPath).href;
+  const altFileUrl = fileUrl.replace(/file:\/\/\/([a-zA-Z]):/, (m, d) => 'file:///' + (d === d.toLowerCase() ? d.toUpperCase() : d.toLowerCase()) + ':');
+  addClientModule(fileUrl, `mod_${index}`);
+  if (altFileUrl !== fileUrl) {
+    addClientModule(altFileUrl, `mod_${index}`);
+  }
+});
+
+for (const [k, v] of Object.entries(parsedClientManifest)) {
+  const fileUrl = k.split("#")[0];
+  if (fileUrl.startsWith("file:///")) {
+    try {
+      const filePath = fileURLToPath(fileUrl);
+      if (fs.existsSync(filePath) && !isSupportedClientModule(filePath)) continue;
+    } catch (e) {}
+  }
+  const compIndex = clientComponents.findIndex(
+    (c) => pathToFileURL(c).href === fileUrl || pathToFileURL(c).href.toLowerCase() === fileUrl.toLowerCase()
+  );
+  if (compIndex !== -1) {
+    if (v && v.id) addClientModule(v.id, `mod_${compIndex}`);
+    addClientModule(fileUrl, `mod_${compIndex}`);
+  }
+}
+
+if (linkChunkId) {
+  const linkCompIndex = clientComponents.findIndex((c) => candidateLinkPaths.has(path.resolve(c)));
+  if (linkCompIndex !== -1) {
+    addClientModule(linkChunkId, `mod_${linkCompIndex}`);
+    for (const lp of candidateLinkPaths) {
+      for (const u of generateAllUrlVariants(lp)) {
+        addClientModule(u, `mod_${linkCompIndex}`);
+      }
+    }
+  }
+}
+if (redirectChunkId) {
+  const redirectCompIndex = clientComponents.findIndex((c) => candidateRedirectPaths.has(path.resolve(c)));
+  if (redirectCompIndex !== -1) {
+    addClientModule(redirectChunkId, `mod_${redirectCompIndex}`);
+    for (const rp of candidateRedirectPaths) {
+      for (const u of generateAllUrlVariants(rp)) {
+        addClientModule(u, `mod_${redirectCompIndex}`);
+      }
+    }
+  }
+}
+
+serverFunctionFiles.forEach((relPath, index) => {
+  const normRel = relPath.replace(/\\/g, "/");
+  const relFileUrl = "file:///" + normRel;
+  const absPath = path.resolve(projectRoot, relPath);
+  const fullFileUrl = pathToFileURL(absPath).href;
+  const altFullFileUrl = fullFileUrl.replace(/file:\/\/\/([a-zA-Z]):/, (m, d) => 'file:///' + (d === d.toLowerCase() ? d.toUpperCase() : d.toLowerCase()) + ':');
+
+  addClientModule(relFileUrl, `sf_${index}`);
+  addClientModule(fullFileUrl, `sf_${index}`);
+  if (altFullFileUrl !== fullFileUrl) {
+    addClientModule(altFullFileUrl, `sf_${index}`);
+  }
+});
+ssrManifestCode += `};\n\n`;
+
+ssrManifestCode += `export const ssrConsumerManifest = {\n  moduleMap: {\n`;
+const emittedModuleMap = new Set();
+function addModuleMap(key, valueObjStr) {
+  if (!emittedModuleMap.has(key)) {
+    emittedModuleMap.add(key);
+    ssrManifestCode += `    ${JSON.stringify(key)}: ${valueObjStr},\n`;
+  }
+}
+
+clientComponents.forEach((compPath) => {
+  const fileUrl = pathToFileURL(compPath).href;
+  const altFileUrl = fileUrl.replace(/file:\/\/\/([a-zA-Z]):/, (m, d) => 'file:///' + (d === d.toLowerCase() ? d.toUpperCase() : d.toLowerCase()) + ':');
+  addModuleMap(fileUrl, `{ "*": { id: ${JSON.stringify(fileUrl)}, chunks: [], name: "*" } }`);
+  if (altFileUrl !== fileUrl) {
+    addModuleMap(altFileUrl, `{ "*": { id: ${JSON.stringify(fileUrl)}, chunks: [], name: "*" } }`);
+  }
+});
+
+for (const [k, v] of Object.entries(parsedClientManifest)) {
+  const fileUrl = k.split("#")[0];
+  if (fileUrl.startsWith("file:///")) {
+    try {
+      const filePath = fileURLToPath(fileUrl);
+      if (fs.existsSync(filePath) && !isSupportedClientModule(filePath)) continue;
+    } catch (e) {}
+  }
+  if (v && v.id) {
+    addModuleMap(v.id, `{ "*": { id: ${JSON.stringify(fileUrl)}, chunks: [], name: "*" } }`);
+  }
+}
+
+if (linkChunkId) {
+  const linkCompIndex = clientComponents.findIndex((c) => candidateLinkPaths.has(path.resolve(c)));
+  if (linkCompIndex !== -1) {
+    const fileUrl = pathToFileURL(clientComponents[linkCompIndex]).href;
+    addModuleMap(linkChunkId, `{ "*": { id: ${JSON.stringify(fileUrl)}, chunks: [], name: "*" } }`);
+    for (const lp of candidateLinkPaths) {
+      for (const u of generateAllUrlVariants(lp)) {
+        addModuleMap(u, `{ "*": { id: ${JSON.stringify(fileUrl)}, chunks: [], name: "*" } }`);
+      }
+    }
+  }
+}
+if (redirectChunkId) {
+  const redirectCompIndex = clientComponents.findIndex((c) => candidateRedirectPaths.has(path.resolve(c)));
+  if (redirectCompIndex !== -1) {
+    const fileUrl = pathToFileURL(clientComponents[redirectCompIndex]).href;
+    addModuleMap(redirectChunkId, `{ "*": { id: ${JSON.stringify(fileUrl)}, chunks: [], name: "*" } }`);
+    for (const rp of candidateRedirectPaths) {
+      for (const u of generateAllUrlVariants(rp)) {
+        addModuleMap(u, `{ "*": { id: ${JSON.stringify(fileUrl)}, chunks: [], name: "*" } }`);
+      }
+    }
+  }
+}
+ssrManifestCode += `  },\n  serverModuleMap: {\n`;
+
+const emittedServerModuleMap = new Set();
+function addServerModuleMap(key, valueObjStr) {
+  if (!emittedServerModuleMap.has(key)) {
+    emittedServerModuleMap.add(key);
+    ssrManifestCode += `    ${JSON.stringify(key)}: ${valueObjStr},\n`;
+  }
+}
+
+serverFunctionFiles.forEach((relPath) => {
+  const normRel = relPath.replace(/\\/g, "/");
+  const relFileUrl = "file:///" + normRel;
+  const absPath = path.resolve(projectRoot, relPath);
+  const fullFileUrl = pathToFileURL(absPath).href;
+  const altFullFileUrl = fullFileUrl.replace(/file:\/\/\/([a-zA-Z]):/, (m, d) => 'file:///' + (d === d.toLowerCase() ? d.toUpperCase() : d.toLowerCase()) + ':');
+
+  addServerModuleMap(relFileUrl, `{ id: ${JSON.stringify(relFileUrl)}, chunks: [], name: "*" }`);
+  addServerModuleMap(fullFileUrl, `{ id: ${JSON.stringify(relFileUrl)}, chunks: [], name: "*" }`);
+  if (altFullFileUrl !== fullFileUrl) {
+    addServerModuleMap(altFullFileUrl, `{ id: ${JSON.stringify(relFileUrl)}, chunks: [], name: "*" }`);
+  }
+
+  const fns = parsedServerFunctionsManifest[relPath] || [];
+  for (const fn of fns) {
+    addServerModuleMap(relFileUrl + "#" + fn, `{ id: ${JSON.stringify(relFileUrl)}, chunks: [], name: ${JSON.stringify(fn)} }`);
+    addServerModuleMap(fullFileUrl + "#" + fn, `{ id: ${JSON.stringify(relFileUrl)}, chunks: [], name: ${JSON.stringify(fn)} }`);
+    if (altFullFileUrl !== fullFileUrl) {
+      addServerModuleMap(altFullFileUrl + "#" + fn, `{ id: ${JSON.stringify(relFileUrl)}, chunks: [], name: ${JSON.stringify(fn)} }`);
+    }
+  }
+});
+
+ssrManifestCode += `  },\n  moduleLoading: null,\n};\n`;
+
+const ssrClientManifestPath = path.join(cloudflareDir, "ssr-client-manifest.js");
+fs.writeFileSync(ssrClientManifestPath, ssrManifestCode, "utf8");
+
+// ====================================================================
+// Entry Files Generation
+// ====================================================================
+// 1. RSC Engine Entry
+const rscEntryContent = `// Auto-generated RSC Engine entry for Cloudflare Workers
+import "./env-setup.js";
+import "./route-modules.js";
+export { handleRequest } from "${dinouDirSlash}/core/handler.js";
+`;
+const rscEntryPath = path.join(cloudflareDir, "rsc-entry.js");
+fs.writeFileSync(rscEntryPath, rscEntryContent, "utf8");
+
+// 2. SSR Engine Entry
+const ssrEntryContent = `// Auto-generated SSR Engine entry for Cloudflare Workers
+import { renderRscStreamToHtmlStream } from "${dinouDirSlash}/core/edge-ssr.js";
+import { clientModules, ssrConsumerManifest } from "./ssr-client-manifest.js";
+
+const lowerMap = new Map();
+globalThis.__webpack_require__ = (id) => {
+  if (clientModules[id]) return clientModules[id];
+  if (typeof id === "string") {
+    if (lowerMap.size === 0) {
+      for (const k of Object.keys(clientModules)) lowerMap.set(k.toLowerCase(), clientModules[k]);
+    }
+    const lowerVal = lowerMap.get(id.toLowerCase());
+    if (lowerVal) return lowerVal;
+  }
+  console.error("[SSR Engine] Module not found in __webpack_require__:", id);
+  return {};
+};
+globalThis.__webpack_require__.u = (chunkId) => "" + chunkId + ".js";
+globalThis.__webpack_chunk_load__ = () => Promise.resolve();
+
+export async function renderHtml(rscStream, options = {}) {
+  return renderRscStreamToHtmlStream(rscStream, ssrConsumerManifest, options);
+}
+`;
+const ssrEntryPath = path.join(cloudflareDir, "ssr-entry.js");
+fs.writeFileSync(ssrEntryPath, ssrEntryContent, "utf8");
+
+// 3. Worker Orchestrator Entry
+const workerEntryContent = `// Auto-generated main worker entry for Cloudflare Workers (Dual-Bundle)
+import { handleRequest } from "./rsc-engine.js";
+import { renderHtml } from "./ssr-engine.js";
+import {
+  getStorageAdapter,
+  setStorageAdapter,
+  CloudflareKVStorage,
+  MemoryStorage,
+} from "${dinouDirSlash}/core/storage-adapter.js";
+
+if (typeof globalThis !== "undefined") {
+  globalThis.__DINOU_RUNTIME__ = "edge";
+}
+
+let storageInitialized = false;
+
+export default {
+  async fetch(request, env, ctx) {
+    const url = new URL(request.url);
+    if (url.pathname.startsWith("/cdn-cgi/")) {
+      return new Response(null, { status: 404 });
+    }
+
+    if (!storageInitialized) {
+      if (env && env.DINOU_CACHE) {
+        setStorageAdapter(new CloudflareKVStorage(env.DINOU_CACHE));
+      } else {
+        setStorageAdapter(new MemoryStorage());
+      }
+      storageInitialized = true;
+    }
+
+    const isRSCPayload = url.pathname.includes("____rsc_");
+    const isServerFunction =
+      url.pathname.includes("____server_function____") ||
+      request.headers.get("x-server-function-call") === "1";
+
+    const staticExtRegex = /\\.(js|mjs|cjs|css|png|jpg|jpeg|gif|svg|ico|webp|avif|woff|woff2|ttf|eot|otf|wasm|map|txt|webmanifest)$/i;
+    const isStaticAsset =
+      staticExtRegex.test(url.pathname) ||
+      url.pathname.startsWith("/assets/") ||
+      url.pathname.startsWith("/_dinou/");
+
+    if (!isRSCPayload && !isServerFunction && isStaticAsset && env && env.ASSETS && (request.method === "GET" || request.method === "HEAD")) {
+      try {
+        const assetRes = await env.ASSETS.fetch(request.clone ? request.clone() : request);
+        if (assetRes && assetRes.status < 400) {
+          return assetRes;
+        }
+      } catch (e) {}
+    }
+
+    return handleRequest(request, {
+      env,
+      ctx,
+      runtime: "edge",
+      renderHtmlStream: renderHtml,
+    });
+  },
+};
+`;
+const workerEntryPath = path.join(cloudflareDir, "worker-entry.js");
+fs.writeFileSync(workerEntryPath, workerEntryContent, "utf8");
+
+// ====================================================================
+// Build Configuration
+// ====================================================================
+const supportedNodeModules = [
+  "assert", "assert/strict",
+  "async_hooks",
+  "buffer",
+  "crypto",
+  "diagnostics_channel",
+  "events",
+  "module",
+  "path", "path/posix", "path/win32",
+  "process",
+  "stream", "stream/consumers", "stream/promises", "stream/web",
+  "string_decoder",
+  "timers", "timers/promises",
+  "url",
+  "util", "util/types",
+  "zlib",
+];
+
+const externalList = [
+  "cloudflare:*",
+  ...supportedNodeModules,
+  ...supportedNodeModules.map((b) => "node:" + b),
+];
+
+const shimsDir = path.resolve(__dirname, "shims");
+
+const commonAlias = {
+  "@": path.resolve(projectRoot, "src"),
+  "dinou/config": path.resolve(dinouDir, "core/config.js"),
+  dinou: dinouDir,
+  fs: path.resolve(shimsDir, "fs.js"),
+  "node:fs": path.resolve(shimsDir, "fs.js"),
+  "fs/promises": path.resolve(shimsDir, "fs.js"),
+  "node:fs/promises": path.resolve(shimsDir, "fs.js"),
+  child_process: path.resolve(shimsDir, "child_process.js"),
+  "node:child_process": path.resolve(shimsDir, "child_process.js"),
+  http: path.resolve(shimsDir, "empty.js"),
+  "node:http": path.resolve(shimsDir, "empty.js"),
+  https: path.resolve(shimsDir, "empty.js"),
+  "node:https": path.resolve(shimsDir, "empty.js"),
+  net: path.resolve(shimsDir, "empty.js"),
+  "node:net": path.resolve(shimsDir, "empty.js"),
+  tls: path.resolve(shimsDir, "empty.js"),
+  "node:tls": path.resolve(shimsDir, "empty.js"),
+  os: path.resolve(shimsDir, "os.js"),
+  "node:os": path.resolve(shimsDir, "os.js"),
+  cluster: path.resolve(shimsDir, "empty.js"),
+  "node:cluster": path.resolve(shimsDir, "empty.js"),
+  dgram: path.resolve(shimsDir, "empty.js"),
+  "node:dgram": path.resolve(shimsDir, "empty.js"),
+  dns: path.resolve(shimsDir, "empty.js"),
+  "node:dns": path.resolve(shimsDir, "empty.js"),
+};
+
+const commonLoader = {
+  ".js": "jsx",
+  ".jsx": "jsx",
+  ".ts": "ts",
+  ".tsx": "tsx",
+  ".json": "json",
+  ".css": "empty",
+  ".svg": "dataurl",
+  ".png": "dataurl",
+  ".jpg": "dataurl",
+  ".jpeg": "dataurl",
+  ".webp": "dataurl",
+  ".ico": "dataurl",
+};
+
+const banner = {
+  js: `import { createRequire as ___createRequire } from 'node:module';
+import { AsyncLocalStorage as ___AsyncLocalStorage } from 'node:async_hooks';
+const require = ___createRequire(import.meta.url || 'file:///worker.js');
+const __dirname = '';
+const __filename = '';
+globalThis.__dinou_require__ = require;
+if (typeof globalThis.AsyncLocalStorage === 'undefined' && typeof ___AsyncLocalStorage !== 'undefined') {
+  globalThis.AsyncLocalStorage = ___AsyncLocalStorage;
+}
+if (typeof globalThis.__webpack_require__ === 'undefined') {
+  globalThis.__webpack_require__ = function(id) {
+    if (globalThis.__webpack_modules__ && globalThis.__webpack_modules__[id]) {
+      return globalThis.__webpack_modules__[id];
+    }
+    return {};
+  };
+}
+if (typeof globalThis.__webpack_require__.u === 'undefined') {
+  globalThis.__webpack_require__.u = function(chunkId) { return '' + chunkId + '.js'; };
+}
+if (typeof globalThis.__webpack_chunk_load__ === 'undefined') {
+  globalThis.__webpack_chunk_load__ = () => Promise.resolve();
+}
+var __webpack_require__ = function(id) {
+  return globalThis.__webpack_require__ ? globalThis.__webpack_require__(id) : {};
+};
+__webpack_require__.u = function(chunkId) {
+  return (globalThis.__webpack_require__ && globalThis.__webpack_require__.u)
+    ? globalThis.__webpack_require__.u(chunkId)
+    : '' + chunkId + '.js';
+};
+var __webpack_chunk_load__ = function(chunkId) {
+  return globalThis.__webpack_chunk_load__ ? globalThis.__webpack_chunk_load__(chunkId) : Promise.resolve();
+};
+`,
+};
+
+// Plugins for RSC Engine
+const clientReferencesPlugin = {
+  name: "dinou-client-references",
+  setup(build) {
+    build.onLoad({ filter: /\.[jt]sx?$/ }, async (args) => {
+      if (args.path.includes("node_modules")) {
+        if (
+          args.path.includes("react-server-dom") ||
+          args.path.includes("@roggc/react-server-dom-esm") ||
+          args.path.includes("node_modules/react/") ||
+          args.path.includes("node_modules\\react\\") ||
+          args.path.includes("node_modules/react-dom/") ||
+          args.path.includes("node_modules\\react-dom\\")
+        ) {
+          return null;
+        }
+      }
+      const normalizedPath = args.path.replace(/\\/g, "/");
+      if (normalizedPath.includes("dinou/core/navigation")) return null;
+
+      let code;
+      try {
+        code = fs.readFileSync(args.path, "utf8");
+      } catch (e) {
+        return null;
+      }
+
+      if (!isSupportedClientModule(args.path, code)) return null;
+      if (!useClientRegex.test(code.trim())) return null;
+
+      const exports = parseExports(code);
+      const absPath = path.resolve(args.path);
+      const fileUrl = pathToFileURL(absPath).href;
+
+      let proxyCode = `import { createClientModuleProxy } from "react-server-dom-webpack/server.edge";\n`;
+      proxyCode += `const proxy = createClientModuleProxy(${JSON.stringify(fileUrl)});\n`;
+
+      for (const name of exports) {
+        if (name === "default") {
+          proxyCode += `export default proxy.default;\n`;
+        } else {
+          proxyCode += `export const ${name} = proxy[${JSON.stringify(name)}];\n`;
+        }
+      }
+
+      if (!exports.includes("default")) {
+        proxyCode += `export default proxy.default;\n`;
+      }
+
+      return {
+        contents: proxyCode,
+        loader: "js",
+      };
+    });
+  },
+};
+
+const serverReferencesPlugin = {
+  name: "dinou-server-references",
+  setup(build) {
+    build.onLoad({ filter: /\.[jt]sx?$/ }, async (args) => {
+      if (args.path.includes("node_modules")) return null;
+
+      let code;
+      try {
+        code = fs.readFileSync(args.path, "utf8");
+      } catch (e) {
+        return null;
+      }
+
+      if (!useServerRegex.test(code.trim())) return null;
+
+      const exports = parseExports(code);
+      const absPath = path.resolve(args.path);
+      const relPath = path.relative(projectRoot, absPath).replace(/\\/g, "/");
+      const relativeFileUrl = "file:///" + relPath;
+
+      let transformed = code + "\n\n";
+      transformed += `import { registerServerReference } from "react-server-dom-webpack/server.edge";\n`;
+
+      for (const name of exports) {
+        if (name !== "default") {
+          transformed += `registerServerReference(${name}, ${JSON.stringify(relativeFileUrl)}, ${JSON.stringify(name)});\n`;
+        }
+      }
+
+      const ext = path.extname(args.path);
+      const loader = ext === ".ts" ? "ts" : ext === ".tsx" ? "tsx" : ext === ".jsx" ? "jsx" : "js";
+
+      return {
+        contents: transformed,
+        loader,
+      };
+    });
+  },
+};
+
+// Plugin for SSR Engine (Register server functions with client.edge)
+const serverReferencesPluginSsr = {
+  name: "dinou-server-references-ssr",
+  setup(build) {
+    build.onLoad({ filter: /\.[jt]sx?$/ }, async (args) => {
+      if (args.path.includes("node_modules")) return null;
+
+      let code;
+      try {
+        code = fs.readFileSync(args.path, "utf8");
+      } catch (e) {
+        return null;
+      }
+
+      if (!useServerRegex.test(code.trim())) return null;
+
+      const exports = parseExports(code);
+      const absPath = path.resolve(args.path);
+      const relPath = path.relative(projectRoot, absPath).replace(/\\/g, "/");
+      const relativeFileUrl = "file:///" + relPath;
+
+      let transformed = code + "\n\n";
+      transformed += `import { registerServerReference } from "react-server-dom-webpack/client.edge";\n`;
+
+      for (const name of exports) {
+        if (name !== "default") {
+          transformed += `registerServerReference(${name}, ${JSON.stringify(relativeFileUrl + "#" + name)});\n`;
+          transformed += `registerServerReference(${name}, ${JSON.stringify(pathToFileURL(absPath).href + "#" + name)});\n`;
+        }
+      }
+
+      const ext = path.extname(args.path);
+      const loader = ext === ".ts" ? "ts" : ext === ".tsx" ? "tsx" : ext === ".jsx" ? "jsx" : "js";
+
+      return {
+        contents: transformed,
+        loader,
+      };
+    });
+  },
+};
+
+const rscOutfile = path.join(cloudflareDir, "rsc-engine.js");
+const ssrOutfile = path.join(cloudflareDir, "ssr-engine.js");
+const finalOutfile = path.join(cloudflareDir, "worker.js");
+
+try {
+  // Pass A: RSC Engine
+  console.log("  ⚡ Bundling Pass A (RSC workerd) & Pass B (SSR workerd)...");
+  await esbuild.build({
+    entryPoints: [rscEntryPath],
+    outfile: rscOutfile,
+    bundle: true,
+    format: "esm",
+    target: "es2022",
+    platform: "neutral",
+    mainFields: ["module", "main"],
+    conditions: ["workerd", "worker", "react-server"],
+    external: externalList,
+    plugins: [clientReferencesPlugin, serverReferencesPlugin],
+    alias: commonAlias,
+    loader: commonLoader,
+    jsx: "automatic",
+    define: {
+      "process.env.NODE_ENV": '"production"',
+      "process.env.DINOU_RUNTIME": '"edge"',
+      "process.env.DINOU_BUILD_TOOL": JSON.stringify(isWebpackBuild ? "webpack" : (process.env.DINOU_BUILD_TOOL || "esbuild")),
+    },
+    logLevel: "warning",
+  });
+
+  // Pass B: SSR Engine
+  await esbuild.build({
+    entryPoints: [ssrEntryPath],
+    outfile: ssrOutfile,
+    bundle: true,
+    format: "esm",
+    target: "es2022",
+    platform: "neutral",
+    mainFields: ["module", "main"],
+    conditions: ["workerd", "worker", "browser"],
+    external: externalList,
+    plugins: [serverReferencesPluginSsr],
+    alias: commonAlias,
+    loader: commonLoader,
+    jsx: "automatic",
+    define: {
+      "process.env.NODE_ENV": '"production"',
+      "process.env.DINOU_RUNTIME": '"edge"',
+      "process.env.DINOU_BUILD_TOOL": JSON.stringify(isWebpackBuild ? "webpack" : (process.env.DINOU_BUILD_TOOL || "esbuild")),
+    },
+    logLevel: "warning",
+  });
+
+  // Pass C: Final Worker Orchestrator
+  console.log("  🚀 Bundling Pass C: Cloudflare Worker Orchestrator (.dinou/cloudflare/worker.js)...");
+  await esbuild.build({
+    entryPoints: [workerEntryPath],
+    outfile: finalOutfile,
+    bundle: true,
+    format: "esm",
+    target: "es2022",
+    platform: "neutral",
+    mainFields: ["module", "main"],
+    conditions: ["workerd", "worker", "browser"],
+    external: externalList,
+    banner,
+    alias: commonAlias,
+    loader: commonLoader,
+    define: {
+      "process.env.NODE_ENV": '"production"',
+      "process.env.DINOU_RUNTIME": '"edge"',
+      "process.env.DINOU_BUILD_TOOL": JSON.stringify(isWebpackBuild ? "webpack" : (process.env.DINOU_BUILD_TOOL || "esbuild")),
+    },
+    logLevel: "warning",
+  });
+
+  const relOutfile = path.relative(projectRoot, finalOutfile).replace(/\\/g, "/");
+  console.log(`\n✓ Cloudflare Workers build complete!`);
+  console.log(`  Output: ${relOutfile}`);
+  console.log("  👉 Preview locally:  npx wrangler dev");
+  console.log("  👉 Deploy to edge:    npx wrangler deploy\n");
+} catch (err) {
+  console.error("❌ [Dinou Cloudflare] Worker bundling failed:", err);
+  process.exit(1);
+}