nukejs 0.0.1 → 0.0.3

package/dist/app.js

@@ -0,0 +1,124 @@
+import http from "http";
+import path from "path";
+import { existsSync, watch } from "fs";
+import { ansi, c, log, setDebugLevel, getDebugLevel } from "./logger.js";
+import { loadConfig } from "./config.js";
+import { discoverApiPrefixes, matchApiPrefix, createApiHandler } from "./http-server.js";
+import { loadMiddleware, runMiddleware } from "./middleware-loader.js";
+import { serveReactBundle, serveNukeBundle, serveClientComponentBundle } from "./bundler.js";
+import { serverSideRender } from "./ssr.js";
+import { watchDir, broadcastRestart } from "./hmr.js";
+const isDev = process.env.ENVIRONMENT !== "production";
+if (isDev) {
+  const React = await import("react");
+  global.React = React;
+}
+const config = await loadConfig();
+setDebugLevel(config.debug ?? false);
+const PAGES_DIR = path.resolve("./app/pages");
+const SERVER_DIR = path.resolve(config.serverDir);
+const PORT = config.port;
+log.info("Configuration loaded:");
+log.info(`  - Pages directory: ${PAGES_DIR}`);
+log.info(`  - Server directory: ${SERVER_DIR}`);
+log.info(`  - Port: ${PORT}`);
+log.info(`  - Debug level: ${String(getDebugLevel())}`);
+log.info(`  - Dev mode: ${String(isDev)}`);
+if (isDev) watchDir(path.resolve("./app"), "App");
+const apiPrefixes = discoverApiPrefixes(SERVER_DIR);
+const handleApiRoute = createApiHandler({ apiPrefixes, port: PORT });
+if (isDev && existsSync(SERVER_DIR)) {
+  watch(SERVER_DIR, { recursive: true }, (_event, filename) => {
+    if (!filename) return;
+    const ext = path.extname(filename);
+    if (ext !== ".ts" && ext !== ".tsx") return;
+    const fresh = discoverApiPrefixes(SERVER_DIR);
+    apiPrefixes.splice(0, apiPrefixes.length, ...fresh);
+    log.info("[Server] Routes updated (" + fresh.length + " prefix" + (fresh.length === 1 ? "" : "es") + ")");
+  });
+}
+log.info(`API prefixes discovered: ${apiPrefixes.length === 0 ? "none" : ""}`);
+apiPrefixes.forEach((p) => {
+  log.info(`  - ${p.prefix || "/"} -> ${path.relative(process.cwd(), p.directory)}`);
+});
+if (isDev) {
+  const RESTART_EXIT_CODE = 75;
+  const restartFiles = [
+    path.resolve("./middleware.ts"),
+    path.resolve("./nuke.config.ts")
+  ];
+  for (const filePath of restartFiles) {
+    if (!existsSync(filePath)) continue;
+    watch(filePath, async () => {
+      log.info(`[Server] ${path.basename(filePath)} changed \u2014 restarting...`);
+      await broadcastRestart();
+      process.exit(RESTART_EXIT_CODE);
+    });
+  }
+}
+await loadMiddleware();
+const server = http.createServer(async (req, res) => {
+  try {
+    const middlewareHandled = await runMiddleware(req, res);
+    if (middlewareHandled) return;
+    const url = req.url || "/";
+    if (matchApiPrefix(url, apiPrefixes))
+      return await handleApiRoute(url, req, res);
+    if (url === "/__hmr_ping") {
+      res.setHeader("Content-Type", "text/plain");
+      res.end("ok");
+      return;
+    }
+    if (url === "/__react.js")
+      return await serveReactBundle(res);
+    if (url === "/__n.js")
+      return await serveNukeBundle(res);
+    if (url.startsWith("/__client-component/"))
+      return await serveClientComponentBundle(
+        url.slice(20).split("?")[0].replace(".js", ""),
+        res
+      );
+    return await serverSideRender(url, res, PAGES_DIR, isDev);
+  } catch (error) {
+    log.error("Server error:", error);
+    res.statusCode = 500;
+    res.end("Internal server error");
+  }
+});
+function tryListen(port) {
+  return new Promise((resolve, reject) => {
+    server.once("error", (err) => {
+      if (err.code === "EADDRINUSE") resolve(tryListen(port + 1));
+      else reject(err);
+    });
+    server.listen(port, () => resolve(port));
+  });
+}
+function printStartupBanner(port, isDev2) {
+  const url = `http://localhost:${port}`;
+  const level = getDebugLevel();
+  const debugStr = String(level);
+  const innerWidth = 42;
+  const line = "\u2500".repeat(innerWidth);
+  const pad = (text, width) => {
+    const visibleLen = text.replace(/\x1b\[[0-9;]*m/g, "").length;
+    return text + " ".repeat(Math.max(0, width - visibleLen));
+  };
+  const row = (content, w = 2) => `${ansi.gray}\u2502${ansi.reset} ${pad(content, innerWidth - w)} ${ansi.gray}\u2502${ansi.reset}`;
+  const label = (key, val) => row(`${c("gray", key)}  ${val}`);
+  console.log("");
+  console.log(`${ansi.gray}\u250C${line}\u2510${ansi.reset}`);
+  console.log(row(`  ${c("red", "\u2622\uFE0F        nukejs ", true)}`, 1));
+  console.log(`${ansi.gray}\u251C${line}\u2524${ansi.reset}`);
+  console.log(label("  Local  ", c("cyan", url, true)));
+  console.log(`${ansi.gray}\u251C${line}\u2524${ansi.reset}`);
+  console.log(label("  Pages  ", c("white", path.relative(process.cwd(), PAGES_DIR))));
+  console.log(label("  Server ", c("white", path.relative(process.cwd(), SERVER_DIR))));
+  console.log(label("  Dev    ", isDev2 ? c("green", "yes") : c("gray", "no")));
+  console.log(label("  Debug  ", level === false ? c("gray", "off") : level === true ? c("green", "verbose") : c("yellow", debugStr)));
+  console.log(`${ansi.gray}\u2514${line}\u2518${ansi.reset}`);
+  console.log("");
+}
+const actualPort = await tryListen(PORT);
+printStartupBanner(actualPort, isDev);
+//# sourceMappingURL=app.js.map

package/dist/app.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../src/app.ts"],
+  "sourcesContent": ["/**\r\n * app.ts \u2014 NukeJS Dev Server Entry Point\r\n *\r\n * This is the runtime that powers `nuke dev`. It:\r\n *   1. Loads your nuke.config.ts (or uses sensible defaults)\r\n *   2. Discovers API route prefixes from your server directory\r\n *   3. Starts an HTTP server that handles:\r\n *        /__hmr_ping            \u2014 heartbeat for HMR reconnect polling\r\n *        /__react.js            \u2014 bundled React + ReactDOM (resolved via importmap)\r\n *        /__n.js                \u2014 NukeJS client runtime bundle\r\n *        /__client-component/*  \u2014 on-demand \"use client\" component bundles\r\n *        /api/**                \u2014 API route handlers from serverDir\r\n *        /**                    \u2014 SSR pages from app/pages\r\n *   4. Watches for file changes and broadcasts HMR events to connected browsers\r\n *\r\n * In production (ENVIRONMENT=production), HMR and all file watching are skipped.\r\n */\r\n\r\nimport http from 'http';\r\nimport path from 'path';\r\nimport { existsSync, watch } from 'fs';\r\n\r\nimport { ansi, c, log, setDebugLevel, getDebugLevel } from './logger';\r\nimport { loadConfig } from './config';\r\nimport { discoverApiPrefixes, matchApiPrefix, createApiHandler } from './http-server';\r\nimport { loadMiddleware, runMiddleware } from './middleware-loader';\r\nimport { serveReactBundle, serveNukeBundle, serveClientComponentBundle } from './bundler';\r\nimport { serverSideRender } from './ssr';\r\nimport { watchDir, broadcastRestart } from './hmr';\r\n\r\n// \u2500\u2500\u2500 Environment \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\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 isDev = process.env.ENVIRONMENT !== 'production';\r\n\r\n// React must live on globalThis so dynamically-imported page modules can share\r\n// the same React instance without each bundling their own copy.\r\nif (isDev) {\r\n  const React = await import('react');\r\n  (global as any).React = React;\r\n}\r\n\r\n// \u2500\u2500\u2500 Config & paths \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\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\nsetDebugLevel(config.debug ?? false);\r\n\r\nconst PAGES_DIR = path.resolve('./app/pages');\r\nconst SERVER_DIR = path.resolve(config.serverDir);\r\nconst PORT       = config.port;\r\n\r\nlog.info('Configuration loaded:');\r\nlog.info(`  - Pages directory: ${PAGES_DIR}`);\r\nlog.info(`  - Server directory: ${SERVER_DIR}`);\r\nlog.info(`  - Port: ${PORT}`);\r\nlog.info(`  - Debug level: ${String(getDebugLevel())}`);\r\nlog.info(`  - Dev mode: ${String(isDev)}`);\r\n\r\n// \u2500\u2500\u2500 API route discovery \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\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// Start watching the app directory for HMR.\r\nif (isDev) watchDir(path.resolve('./app'), 'App');\r\n\r\n// apiPrefixes is a live, mutable array. In dev, we splice it in-place whenever\r\n// the server directory changes so handlers always see the latest routes without\r\n// a full restart.\r\nconst apiPrefixes    = discoverApiPrefixes(SERVER_DIR);\r\nconst handleApiRoute = createApiHandler({ apiPrefixes, port: PORT });\r\n\r\nif (isDev && existsSync(SERVER_DIR)) {\r\n  watch(SERVER_DIR, { recursive: true }, (_event, filename) => {\r\n    if (!filename) return;\r\n\r\n    // Only react to TypeScript source changes, not compiled output or assets.\r\n    const ext = path.extname(filename);\r\n    if (ext !== '.ts' && ext !== '.tsx') return;\r\n\r\n    const fresh = discoverApiPrefixes(SERVER_DIR);\r\n    apiPrefixes.splice(0, apiPrefixes.length, ...fresh);\r\n    log.info('[Server] Routes updated (' + fresh.length + ' prefix' + (fresh.length === 1 ? '' : 'es') + ')');\r\n  });\r\n}\r\n\r\nlog.info(`API prefixes discovered: ${apiPrefixes.length === 0 ? 'none' : ''}`);\r\napiPrefixes.forEach(p => {\r\n  log.info(`  - ${p.prefix || '/'} -> ${path.relative(process.cwd(), p.directory)}`);\r\n});\r\n\r\n// \u2500\u2500\u2500 Full-restart file watchers \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\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// Some changes can't be hot-patched: middleware exports change the request\r\n// pipeline, and nuke.config.ts may change the port or serverDir.  On change we\r\n// broadcast a 'restart' SSE event so browsers reconnect automatically, then\r\n// exit with code 75 \u2014 the CLI watches for this to respawn the process.\r\nif (isDev) {\r\n  const RESTART_EXIT_CODE = 75;\r\n  const restartFiles = [\r\n    path.resolve('./middleware.ts'),\r\n    path.resolve('./nuke.config.ts'),\r\n  ];\r\n\r\n  for (const filePath of restartFiles) {\r\n    if (!existsSync(filePath)) continue;\r\n    watch(filePath, async () => {\r\n      log.info(`[Server] ${path.basename(filePath)} changed \u2014 restarting...`);\r\n      await broadcastRestart();\r\n      process.exit(RESTART_EXIT_CODE);\r\n    });\r\n  }\r\n}\r\n\r\n// \u2500\u2500\u2500 Middleware \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\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// Loads built-in middleware (HMR SSE/JS endpoints) and the user-supplied\r\n// middleware.ts from the project root (if it exists).\r\nawait loadMiddleware();\r\n\r\n// \u2500\u2500\u2500 Request handler \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\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 server = http.createServer(async (req, res) => {\r\n  try {\r\n    // Middleware runs first.  If it calls res.end() the request is fully\r\n    // handled and we bail out immediately.\r\n    const middlewareHandled = await runMiddleware(req, res);\r\n    if (middlewareHandled) return;\r\n\r\n    const url = req.url || '/';\r\n\r\n    // API routes \u2014 prefixes discovered from serverDir take priority over pages.\r\n    if (matchApiPrefix(url, apiPrefixes))\r\n      return await handleApiRoute(url, req, res);\r\n\r\n    // \u2500\u2500 Internal NukeJS 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\r\n\r\n    // Heartbeat polled by the HMR client to know when the server is back up.\r\n    if (url === '/__hmr_ping') {\r\n      res.setHeader('Content-Type', 'text/plain');\r\n      res.end('ok');\r\n      return;\r\n    }\r\n\r\n    // Unified React bundle (react + react-dom/client + react/jsx-runtime).\r\n    // Resolved by the importmap injected into every SSR page, so client\r\n    // components never bundle React themselves.\r\n    if (url === '/__react.js')\r\n      return await serveReactBundle(res);\r\n\r\n    // NukeJS browser runtime: initRuntime, SPA navigation, partial hydration.\r\n    if (url === '/__n.js')\r\n      return await serveNukeBundle(res);\r\n\r\n    // On-demand bundles for individual \"use client\" components.\r\n    // Strip the prefix, the .js extension, and any query string (cache buster).\r\n    if (url.startsWith('/__client-component/'))\r\n      return await serveClientComponentBundle(\r\n        url.slice(20).split('?')[0].replace('.js', ''),\r\n        res,\r\n      );\r\n\r\n    // \u2500\u2500 Page SSR \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\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    // No API prefix matched \u2014 render a page from app/pages.\r\n    return await serverSideRender(url, res, PAGES_DIR, isDev);\r\n\r\n  } catch (error) {\r\n    log.error('Server error:', error);\r\n    res.statusCode = 500;\r\n    res.end('Internal server error');\r\n  }\r\n});\r\n\r\n// \u2500\u2500\u2500 Port binding \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\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 * Tries to listen on `port`.  If the port is already in use (EADDRINUSE),\r\n * increments and tries the next port until one is free.\r\n *\r\n * Returns the port that was actually bound.\r\n */\r\nfunction tryListen(port: number): Promise<number> {\r\n  return new Promise((resolve, reject) => {\r\n    server.once('error', (err: NodeJS.ErrnoException) => {\r\n      if (err.code === 'EADDRINUSE') resolve(tryListen(port + 1));\r\n      else reject(err);\r\n    });\r\n    server.listen(port, () => resolve(port));\r\n  });\r\n}\r\n\r\n// \u2500\u2500\u2500 Startup banner \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\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 * Renders the \u2622\uFE0F NukeJS startup box to stdout.\r\n * Uses box-drawing characters and ANSI colour codes for a clean terminal UI.\r\n */\r\nfunction printStartupBanner(port: number, isDev: boolean): void {\r\n  const url        = `http://localhost:${port}`;\r\n  const level      = getDebugLevel();\r\n  const debugStr   = String(level);\r\n  const innerWidth = 42;\r\n  const line       = '\u2500'.repeat(innerWidth);\r\n\r\n  /** Right-pads `text` to `width` columns, ignoring invisible ANSI sequences. */\r\n  const pad = (text: string, width: number) => {\r\n    const visibleLen = text.replace(/\\x1b\\[[0-9;]*m/g, '').length;\r\n    return text + ' '.repeat(Math.max(0, width - visibleLen));\r\n  };\r\n\r\n  const row   = (content: string, w = 2) =>\r\n    `${ansi.gray}\u2502${ansi.reset} ${pad(content, innerWidth - w)} ${ansi.gray}\u2502${ansi.reset}`;\r\n  const label = (key: string, val: string) =>\r\n    row(`${c('gray', key)}  ${val}`);\r\n\r\n  console.log('');\r\n  console.log(`${ansi.gray}\u250C${line}\u2510${ansi.reset}`);\r\n  console.log(row(`  ${c('red', '\u2622\uFE0F        nukejs ', true)}`, 1));\r\n  console.log(`${ansi.gray}\u251C${line}\u2524${ansi.reset}`);\r\n  console.log(label('  Local  ', c('cyan', url, true)));\r\n  console.log(`${ansi.gray}\u251C${line}\u2524${ansi.reset}`);\r\n  console.log(label('  Pages  ', c('white', path.relative(process.cwd(), PAGES_DIR))));\r\n  console.log(label('  Server ', c('white', path.relative(process.cwd(), SERVER_DIR))));\r\n  console.log(label('  Dev    ', isDev ? c('green', 'yes') : c('gray', 'no')));\r\n  console.log(label('  Debug  ', level === false\r\n    ? c('gray', 'off')\r\n    : level === true\r\n      ? c('green', 'verbose')\r\n      : c('yellow', debugStr)));\r\n  console.log(`${ansi.gray}\u2514${line}\u2518${ansi.reset}`);\r\n  console.log('');\r\n}\r\n\r\nconst actualPort = await tryListen(PORT);\r\nprintStartupBanner(actualPort, isDev);"],
+  "mappings": "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",
+  "names": ["isDev"]
+}

package/dist/as-is/Link.d.ts

@@ -0,0 +1,6 @@
+declare const Link: ({ href, children, className }: {
+    href: string;
+    children: React.ReactNode;
+    className?: string;
+}) => import("react/jsx-runtime").JSX.Element;
+export default Link;

package/dist/as-is/Link.tsx

@@ -0,0 +1,20 @@
+"use client"
+
+const Link = ({ href, children, className }: {
+    href: string;
+    children: React.ReactNode;
+    className?: string;
+}) => {
+    const handleClick = (e: React.MouseEvent<HTMLAnchorElement>) => {
+        e.preventDefault();
+        window.history.pushState({}, '', href);
+    };
+
+    return (
+        <a href={href} onClick={handleClick} className={className}>
+            {children}
+        </a>
+    );
+};
+
+export default Link;

package/dist/as-is/useRouter.d.ts

@@ -0,0 +1,7 @@
+type Router = {
+    path: string;
+    push: (url: string) => void;
+    replace: (url: string) => void;
+};
+export default function useRouter(): Router;
+export {};

package/dist/as-is/useRouter.ts

@@ -0,0 +1,33 @@
+import { useCallback, useEffect, useState } from "react";
+
+type Router = {
+    path: string;
+    push: (url: string) => void;
+    replace: (url: string) => void;
+};
+
+export default function useRouter(): Router {
+    try {
+        const [path, setPath] = useState(() => window.location.pathname);
+
+        useEffect(() => {
+            const handleLocationChange = () => setPath(window.location.pathname);
+            window.addEventListener("locationchange", handleLocationChange);
+            return () => window.removeEventListener("locationchange", handleLocationChange);
+        }, []);
+
+        const push = useCallback((url: string) => {
+            window.history.pushState({}, "", url);
+            setPath(url);
+        }, []);
+
+        const replace = useCallback((url: string) => {
+            window.history.replaceState({}, "", url);
+            setPath(url);
+        }, []);
+
+        return { path, push, replace };
+    } catch {
+        return { push: () => {}, replace: () => {}, path: "" };
+    }
+}

package/dist/build-common.d.ts

@@ -0,0 +1,192 @@
+/**
+ * build-common.ts
+ *
+ * Shared build logic used by both build-vercel.ts and build-node.ts.
+ *
+ * Exports:
+ *   — utility helpers   : walkFiles, analyzeFile, isServerComponent,
+ *                         findPageLayouts, extractDefaultExportName
+ *   — collection        : collectServerPages, collectGlobalClientRegistry
+ *   — template codegen  : makeApiAdapterSource, makePageAdapterSource
+ *   — bundle operations : bundleApiHandler, bundlePageHandler,
+ *                         bundleClientComponents, buildReactBundle, buildNukeBundle
+ */
+export interface AnalyzedRoute {
+    srcRegex: string;
+    paramNames: string[];
+    /** Path used as function namespace, e.g. '/api/users' or '/page/about'. */
+    funcPath: string;
+    specificity: number;
+}
+export interface ServerPage extends AnalyzedRoute {
+    absPath: string;
+}
+/** A server page together with its fully bundled ESM text, ready to emit. */
+export interface BuiltPage extends ServerPage {
+    bundleText: string;
+}
+export declare function walkFiles(dir: string, base?: string): string[];
+/**
+ * Parses dynamic-route segments from a relative file path and returns a regex,
+ * captured param names, a function path, and a specificity score.
+ *
+ * @param relPath  Relative path from the dir root (e.g. 'users/[id].tsx').
+ * @param prefix   Namespace for funcPath ('api' | 'page').
+ */
+export declare function analyzeFile(relPath: string, prefix?: string): AnalyzedRoute;
+/**
+ * Returns true when a file does NOT begin with a "use client" directive —
+ * i.e. it is a server component.
+ */
+export declare function isServerComponent(filePath: string): boolean;
+/**
+ * Walks from the pages root to the directory containing `routeFilePath` and
+ * returns every layout.tsx found, in outermost-first order.
+ */
+export declare function findPageLayouts(routeFilePath: string, pagesDir: string): string[];
+/**
+ * Extracts the identifier used as the default export from a component file.
+ * Returns null when no default export is found.
+ */
+export declare function extractDefaultExportName(filePath: string): string | null;
+/**
+ * Returns all server-component pages inside `pagesDir`, sorted by specificity
+ * (most-specific first so more-precise routes shadow catch-alls in routers).
+ * layout.tsx files and "use client" files are excluded.
+ */
+export declare function collectServerPages(pagesDir: string): ServerPage[];
+/**
+ * Walks every server page and its layout chain to collect all client component
+ * IDs reachable anywhere in the app.  Deduplication is automatic because the
+ * Map key is the stable content-hash ID produced by component-analyzer.ts.
+ */
+export declare function collectGlobalClientRegistry(serverPages: ServerPage[], pagesDir: string): Map<string, string>;
+/**
+ * Builds the per-page client component registry (page + its layout chain) and
+ * returns both the id→path map and the name→id map needed by bundlePageHandler.
+ *
+ * Extracted here to eliminate the identical loop duplicated across
+ * build-node.ts and build-vercel.ts.
+ */
+export declare function buildPerPageRegistry(absPath: string, layoutPaths: string[], pagesDir: string): {
+    registry: Map<string, string>;
+    clientComponentNames: Record<string, string>;
+};
+/**
+ * Runs both passes of the page build:
+ *
+ *   Pass 1 — bundles all client components to `staticDir/__client-component/`
+ *             and collects pre-rendered HTML for each.
+ *   Pass 2 — bundles every server-component page into a self-contained ESM
+ *             handler and returns the results as `BuiltPage[]`.
+ *
+ * Callers (build-node, build-vercel) only need to write the bundled text to
+ * their respective output destinations — the format-specific logic stays local.
+ *
+ * Returns an empty array when there are no server pages.
+ */
+export declare function buildPages(pagesDir: string, staticDir: string): Promise<BuiltPage[]>;
+/**
+ * Returns the TypeScript source for a thin HTTP adapter that wraps an API
+ * route module and exposes a single `handler(req, res)` default export.
+ *
+ * @param handlerFilename  Basename of the handler file relative to the adapter
+ *                         (e.g. 'users.ts').  Must be in the same directory.
+ */
+export declare function makeApiAdapterSource(handlerFilename: string): string;
+export interface PageAdapterOptions {
+    /** e.g. './home.tsx' — relative import for the page default export */
+    pageImport: string;
+    /** Newline-joined import statements for layout components */
+    layoutImports: string;
+    /** function-name → cc_id map, computed at build time */
+    clientComponentNames: Record<string, string>;
+    /** All client component IDs reachable from this page */
+    allClientIds: string[];
+    /** Comma-separated list of __layout_N__ identifiers */
+    layoutArrayItems: string;
+    /** Pre-rendered HTML per client component ID, computed at build time */
+    prerenderedHtml: Record<string, string>;
+}
+/**
+ * Returns the TypeScript source for a fully self-contained page handler.
+ *
+ * The adapter:
+ *   • Inlines the html-store so useHtml() works without external deps.
+ *   • Contains an async recursive renderer that handles server + client
+ *     components without react-dom/server.
+ *   • Client components are identified via the pre-computed CLIENT_COMPONENTS
+ *     map (no fs.readFileSync at runtime).
+ *   • Emits the same full HTML document structure as ssr.ts including the
+ *     __n_data blob, importmap, and initRuntime bootstrap.
+ */
+export declare function makePageAdapterSource(opts: PageAdapterOptions): string;
+/**
+ * Bundles an API route handler into a single self-contained ESM string.
+ *
+ * Writes a temporary adapter next to `absPath`, bundles them together with
+ * esbuild (node_modules kept external), then removes the temp file.
+ *
+ * @returns The bundled ESM text ready to write to disk.
+ */
+export declare function bundleApiHandler(absPath: string): Promise<string>;
+export interface PageBundleOptions {
+    absPath: string;
+    pagesDir: string;
+    clientComponentNames: Record<string, string>;
+    allClientIds: string[];
+    layoutPaths: string[];
+    prerenderedHtml: Record<string, string>;
+}
+/**
+ * Bundles a server-component page into a single self-contained ESM string.
+ *
+ * Writes a temporary adapter next to `absPath` (so relative imports inside
+ * the component resolve from the correct base directory), bundles it with
+ * esbuild (React and all npm deps inlined, only Node built-ins stay external),
+ * then removes the temp file.
+ *
+ * @returns The bundled ESM text ready to write to disk.
+ */
+export declare function bundlePageHandler(opts: PageBundleOptions): Promise<string>;
+/**
+ * Bundles every client component in `globalRegistry` to
+ * `<staticDir>/__client-component/<id>.js`.
+ *
+ * Mirrors bundleClientComponent() in bundler.ts:
+ *   • browser ESM, JSX automatic
+ *   • react / react-dom/client / react/jsx-runtime kept external so the
+ *     importmap can resolve them to the already-loaded /__react.js bundle.
+ */
+export declare function bundleClientComponents(globalRegistry: Map<string, string>, pagesDir: string, staticDir: string): Promise<Map<string, string>>;
+/**
+ * Builds the full React + ReactDOM browser bundle to `<staticDir>/__react.js`.
+ * Exports every public hook and helper so client component bundles can import
+ * them via the importmap without bundling React a second time.
+ */
+export declare function buildReactBundle(staticDir: string): Promise<void>;
+/**
+ * Builds the nukejs client runtime to `<staticDir>/__n.js`.
+ * React and react-dom/client are kept external (resolved via importmap).
+ */
+export declare function buildNukeBundle(staticDir: string): Promise<void>;
+/**
+ * Recursively copies every file from `app/public/` into `destDir`,
+ * preserving the directory structure.
+ *
+ * Called by both build-vercel.ts (dest = .vercel/output/static/) and
+ * build-node.ts (dest = dist/static/) so that:
+ *
+ *   app/public/favicon.ico        → <destDir>/favicon.ico
+ *   app/public/images/logo.png    → <destDir>/images/logo.png
+ *
+ * On Vercel, the Build Output API v3 serves everything in .vercel/output/static/
+ * directly — no route entry needed, same as __react.js and __n.js.
+ *
+ * On Node, the serverEntry template serves files from dist/static/ with the
+ * same MIME-type logic as the dev middleware.
+ *
+ * Skips silently when the public directory does not exist so projects without
+ * one don't need any special configuration.
+ */
+export declare function copyPublicFiles(publicDir: string, destDir: string): void;