nukejs 0.0.11 → 0.0.13

package/dist/bundle.js

@@ -77,9 +77,38 @@ async function loadModules(ids, log, bust = "") {
   return mods;
 }
 const activeRoots = [];
+let clientErrorPending = false;
+function navigateToClientError(err) {
+  if (clientErrorPending) return;
+  if (window.location.search.includes("__clientError")) return;
+  clientErrorPending = true;
+  const message = err instanceof Error ? err.message : String(err);
+  const stack = err instanceof Error && err.stack ? err.stack : void 0;
+  const params = new URLSearchParams();
+  params.set("__clientError", message);
+  if (stack) params.set("__clientStack", stack);
+  window.dispatchEvent(new CustomEvent("locationchange", {
+    detail: { href: window.location.pathname + "?" + params.toString() }
+  }));
+}
 async function mountNodes(mods, log) {
   const { hydrateRoot, createRoot } = await import("react-dom/client");
   const React = await import("react");
+  class NukeErrorBoundary extends React.default.Component {
+    constructor(props) {
+      super(props);
+      this.state = { caught: false };
+    }
+    static getDerivedStateFromError() {
+      return { caught: true };
+    }
+    componentDidCatch(error) {
+      navigateToClientError(error);
+    }
+    render() {
+      return this.state.caught ? null : this.props.children;
+    }
+  }
   const nodes = document.querySelectorAll("[data-hydrate-id]");
   log.verbose("Found", nodes.length, "hydration point(s)");
   for (const node of nodes) {
@@ -97,7 +126,8 @@ async function mountNodes(mods, log) {
       log.error("Props parse error for", id, e);
     }
     try {
-      const element = React.default.createElement(Comp, await reconstructProps(rawProps, mods));
+      const inner = React.default.createElement(Comp, await reconstructProps(rawProps, mods));
+      const element = React.default.createElement(NukeErrorBoundary, null, inner);
       let root;
       if (node.innerHTML.trim()) {
         root = hydrateRoot(node, element);
@@ -223,8 +253,13 @@ function setupNavigation(log) {
       const fetchUrl = hmr ? href + (href.includes("?") ? "&" : "?") + "__hmr=1" : href;
       const response = await fetch(fetchUrl, { headers: { Accept: "text/html" } });
       if (!response.ok) {
-        log.error("Navigation fetch failed:", response.status);
-        return;
+        const ct = response.headers.get("content-type") ?? "";
+        if (!ct.includes("text/html")) {
+          log.error("Navigation fetch failed:", response.status, "\u2014 falling back to full reload");
+          window.location.href = href;
+          return;
+        }
+        log.info("Navigation returned", response.status, "\u2014 rendering error page in-place");
       }
       const parser = new DOMParser();
       const doc = parser.parseFromString(await response.text(), "text/html");
@@ -251,6 +286,8 @@ function setupNavigation(log) {
     } catch (err) {
       log.error("Navigation error, falling back to full reload:", err);
       window.location.href = href;
+    } finally {
+      clientErrorPending = false;
     }
   });
 }
@@ -258,6 +295,13 @@ async function initRuntime(data) {
   const log = makeLogger(data.debug ?? "silent");
   log.info("\u{1F680} Partial hydration:", data.hydrateIds.length, "root component(s)");
   setupNavigation(log);
+  window.onerror = (_msg, _src, _line, _col, err) => {
+    navigateToClientError(err ?? _msg);
+    return true;
+  };
+  window.onunhandledrejection = (e) => {
+    navigateToClientError(e.reason);
+  };
   const mods = await loadModules(data.allIds, log);
   await mountNodes(mods, log);
   log.info("\u{1F389} Done!");
@@ -267,4 +311,3 @@ export {
   initRuntime,
   setupLocationChangeMonitor
 };
-//# sourceMappingURL=bundle.js.map

package/dist/bundler.js

@@ -97,4 +97,3 @@ export {
   serveNukeBundle,
   serveReactBundle
 };
-//# sourceMappingURL=bundler.js.map

package/dist/component-analyzer.js

@@ -123,4 +123,3 @@ export {
   getComponentCache,
   invalidateComponentCache
 };
-//# sourceMappingURL=component-analyzer.js.map

package/dist/config.js

@@ -27,4 +27,3 @@ async function loadConfig() {
 export {
   loadConfig
 };
-//# sourceMappingURL=config.js.map

package/dist/hmr-bundle.js

@@ -28,6 +28,16 @@ function hmr() {
         }
         return;
       }
+      if (msg.type === "layout-reload") {
+        const base = msg.base === "/" ? "" : msg.base;
+        const pathname = window.location.pathname;
+        const isUnder = pathname === (base || "/") || pathname.startsWith(base + "/");
+        if (isUnder) {
+          log.info("[HMR] Layout changed:", msg.base);
+          navigate(pathname + window.location.search);
+        }
+        return;
+      }
       if (msg.type === "replace") {
         log.info("[HMR] Component changed:", msg.component);
         navigate(window.location.pathname + window.location.search);
@@ -86,4 +96,3 @@ hmr();
 export {
   hmr as default
 };
-//# sourceMappingURL=hmr-bundle.js.map

package/dist/hmr.js

@@ -24,7 +24,14 @@ function pageFileToUrl(filename) {
 function buildPayload(filename) {
   const normalized = filename.replace(/\\/g, "/");
   if (normalized.startsWith("pages/")) {
+    const stem = path.basename(normalized, path.extname(normalized));
+    if (stem === "_404" || stem === "_500") {
+      return { type: "replace", component: stem };
+    }
     const url = pageFileToUrl(normalized);
+    if (stem === "layout") {
+      return { type: "layout-reload", base: url };
+    }
     return { type: "reload", url };
   }
   const ext = path.extname(filename).toLowerCase();
@@ -59,4 +66,3 @@ export {
   hmrClients,
   watchDir
 };
-//# sourceMappingURL=hmr.js.map

package/dist/html-store.js

@@ -39,4 +39,3 @@ export {
   resolveTitle,
   runWithHtmlStore
 };
-//# sourceMappingURL=html-store.js.map

package/dist/http-server.js

@@ -170,4 +170,3 @@ export {
   parseBody,
   parseQuery
 };
-//# sourceMappingURL=http-server.js.map

package/dist/index.d.ts

@@ -1,5 +1,6 @@
 export { useHtml } from './use-html';
-export type { HtmlOptions, TitleValue, HtmlAttrs, BodyAttrs, MetaTag, LinkTag, ScriptTag, StyleTag, } from './use-html';
+export type { HtmlOptions } from './use-html';
+export type { TitleValue, HtmlAttrs, BodyAttrs, MetaTag, LinkTag, ScriptTag, StyleTag, } from './html-store';
 export { default as useRouter } from './use-router';
 export { useRequest } from './use-request';
 export type { RequestContext } from './use-request';

package/dist/index.js

@@ -22,4 +22,3 @@ export {
   useRequest,
   default2 as useRouter
 };
-//# sourceMappingURL=index.js.map

package/dist/logger.js

@@ -50,4 +50,3 @@ export {
   log,
   setDebugLevel
 };
-//# sourceMappingURL=logger.js.map

package/dist/metadata.js

@@ -40,4 +40,3 @@ export {
   renderScriptTag,
   renderStyleTag
 };
-//# sourceMappingURL=metadata.js.map

package/dist/middleware-loader.js

@@ -47,4 +47,3 @@ export {
   loadMiddleware,
   runMiddleware
 };
-//# sourceMappingURL=middleware-loader.js.map

package/dist/middleware.example.js

@@ -55,4 +55,3 @@ function isRateLimited(ip) {
 export {
   middleware as default
 };
-//# sourceMappingURL=middleware.example.js.map

package/dist/middleware.js

@@ -69,4 +69,3 @@ async function middleware(req, res) {
 export {
   middleware as default
 };
-//# sourceMappingURL=middleware.js.map

package/dist/renderer.js

@@ -96,14 +96,9 @@ async function renderFunctionComponent(type, props, ctx) {
       return `<div style="color:red">Error rendering client component: ${escapeHtml(String(err))}</div>`;
     }
   }
-  try {
-    const result = type(props);
-    const resolved = result?.then ? await result : result;
-    return renderElementToHtml(resolved, ctx);
-  } catch (err) {
-    log.error("Error rendering component:", err);
-    return `<div style="color:red">Error rendering component: ${escapeHtml(String(err))}</div>`;
-  }
+  const result = type(props);
+  const resolved = result?.then ? await result : result;
+  return renderElementToHtml(resolved, ctx);
 }
 function serializePropsForHydration(props, registry) {
   if (!props || typeof props !== "object") return props;
@@ -153,4 +148,3 @@ function serializeReactElement(element, registry) {
 export {
   renderElementToHtml
 };
-//# sourceMappingURL=renderer.js.map

package/dist/request-store.js

@@ -44,4 +44,3 @@ export {
   runWithRequestStore,
   sanitiseHeaders
 };
-//# sourceMappingURL=request-store.js.map

package/dist/router.js

@@ -116,4 +116,3 @@ export {
   matchDynamicRoute,
   matchRoute
 };
-//# sourceMappingURL=router.js.map

package/dist/ssr.js

@@ -1,4 +1,5 @@
 import path from "path";
+import fs from "fs";
 import { createElement } from "react";
 import { pathToFileURL } from "url";
 import { tsImport } from "tsx/esm/api";
@@ -90,18 +91,8 @@ function renderManagedBodyScripts(store) {
   if (bodyScripts.length === 0) return [];
   return ["  <!--n-body-scripts-->", ...bodyScripts.map(renderScriptTag), "  <!--/n-body-scripts-->"];
 }
-async function serverSideRender(url, res, pagesDir, isDev = false, req) {
-  const skipClientSSR = url.includes("__hmr=1");
+async function renderFile(filePath, params, url, pagesDir, isDev, res, req, statusCode, skipClientSSR) {
   const cleanUrl = url.split("?")[0];
-  const routeMatch = matchRoute(cleanUrl, pagesDir);
-  if (!routeMatch) {
-    log.verbose(`No route found for: ${url}`);
-    res.statusCode = 404;
-    res.end("Page not found");
-    return;
-  }
-  const { filePath, params, routePattern } = routeMatch;
-  log.verbose(`SSR ${cleanUrl} -> ${path.relative(process.cwd(), filePath)}`);
   const searchParams = new URL(url, "http://localhost").searchParams;
   const queryParams = {};
   searchParams.forEach((_, k) => {
@@ -129,10 +120,6 @@ async function serverSideRender(url, res, pagesDir, isDev = false, req) {
   for (const layoutPath of layoutPaths)
     for (const [id, p] of findClientComponentsInTree(layoutPath, pagesDir))
       registry.set(id, p);
-  log.verbose(
-    `Page ${routePattern}: found ${registry.size} client component(s)`,
-    `[${[...registry.keys()].join(", ")}]`
-  );
   const ctx = { registry, hydrated: /* @__PURE__ */ new Set(), skipClientSSR };
   let appHtml = "";
   const store = await runWithRequestStore(
@@ -196,10 +183,80 @@ ${openTag("body", store.bodyAttrs)}
   ${isDev ? '<script type="module" src="/__hmr.js"></script>' : ""}
 ${bodyScriptsHtml}</body>
 </html>`;
+  res.statusCode = statusCode;
   res.setHeader("Content-Type", "text/html");
   res.end(html);
 }
+function serializeError(err) {
+  if (err instanceof Error) {
+    const props = {
+      errorMessage: err.message
+    };
+    if (process.env.NODE_ENV !== "production" && err.stack)
+      props.errorStack = err.stack;
+    const status = err.status ?? err.statusCode;
+    if (status != null)
+      props.errorStatus = String(status);
+    return props;
+  }
+  return { errorMessage: String(err) };
+}
+async function tryRenderErrorPage(statusCode, pagesDir, res, isDev, req, error) {
+  const errorFile = path.join(pagesDir, `_${statusCode}.tsx`);
+  if (!fs.existsSync(errorFile)) return false;
+  const errorProps = error != null ? serializeError(error) : {};
+  try {
+    await renderFile(errorFile, errorProps, "/", pagesDir, isDev, res, req, statusCode, false);
+    return true;
+  } catch (err) {
+    log.error(`Error rendering _${statusCode}.tsx:`, err);
+    return false;
+  }
+}
+async function serverSideRender(url, res, pagesDir, isDev = false, req) {
+  const skipClientSSR = url.includes("__hmr=1");
+  const cleanUrl = url.split("?")[0];
+  const searchParams = new URL(url, "http://localhost").searchParams;
+  if (searchParams.has("__clientError")) {
+    const errorProps = {
+      errorMessage: searchParams.get("__clientError") ?? "Client error"
+    };
+    const stack = searchParams.get("__clientStack");
+    if (stack) errorProps.errorStack = stack;
+    const errorFile = path.join(pagesDir, "_500.tsx");
+    if (fs.existsSync(errorFile)) {
+      try {
+        await renderFile(errorFile, errorProps, url, pagesDir, isDev, res, req, 500, false);
+      } catch (err) {
+        log.error("Error rendering _500.tsx for client error:", err);
+        res.statusCode = 500;
+        res.end("Internal Server Error");
+      }
+    } else {
+      res.statusCode = 500;
+      res.end("Internal Server Error");
+    }
+    return;
+  }
+  const routeMatch = matchRoute(cleanUrl, pagesDir);
+  if (!routeMatch) {
+    log.verbose(`No route found for: ${url}`);
+    if (await tryRenderErrorPage(404, pagesDir, res, isDev, req)) return;
+    res.statusCode = 404;
+    res.end("Page not found");
+    return;
+  }
+  const { filePath, params, routePattern } = routeMatch;
+  log.verbose(`SSR ${cleanUrl} -> ${path.relative(process.cwd(), filePath)}`);
+  try {
+    await renderFile(filePath, params, url, pagesDir, isDev, res, req, 200, skipClientSSR);
+  } catch (err) {
+    log.error("SSR render error:", err);
+    if (await tryRenderErrorPage(500, pagesDir, res, isDev, req, err)) return;
+    res.statusCode = 500;
+    res.end("Internal Server Error");
+  }
+}
 export {
   serverSideRender
 };
-//# sourceMappingURL=ssr.js.map

package/dist/use-html.js

@@ -126,4 +126,3 @@ function domAttr(key) {
 export {
   useHtml
 };
-//# sourceMappingURL=use-html.js.map

package/dist/use-request.js

@@ -46,4 +46,3 @@ function useRequest() {
 export {
   useRequest
 };
-//# sourceMappingURL=use-request.js.map

package/dist/use-router.js

@@ -25,4 +25,3 @@ function useRouter() {
 export {
   useRouter as default
 };
-//# sourceMappingURL=use-router.js.map

package/dist/utils.js

@@ -59,4 +59,3 @@ export {
   escapeHtml,
   getMimeType
 };
-//# sourceMappingURL=utils.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nukejs",
-  "version": "0.0.11",
+  "version": "0.0.13",
   "description": "A minimal, opinionated full-stack React framework on Node.js that server-renders everything and hydrates only interactive parts.",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",

package/dist/Link.js.map

@@ -1,7 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../src/Link.tsx"],
-  "sourcesContent": ["\"use client\";\r\nimport useRouter from \"./use-router\";\r\n\r\ninterface LinkProps {\r\n  href: string;\r\n  children: React.ReactNode;\r\n  className?: string;\r\n}\r\n\r\n/**\r\n * Client-side navigation link.\r\n * Intercepts clicks and delegates to useRouter().push() so the SPA router\r\n * handles the transition without a full page reload.\r\n */\r\nconst Link = ({ href, children, className }: LinkProps) => {\r\n  const { push } = useRouter();\r\n\r\n  const handleClick = (e: React.MouseEvent<HTMLAnchorElement>) => {\r\n    e.preventDefault();\r\n    push(href);\r\n  };\r\n\r\n  return (\r\n    <a href={href} onClick={handleClick} className={className}>\r\n      {children}\r\n    </a>\r\n  );\r\n};\r\n\r\nexport default Link;"],
-  "mappings": ";AAuBI;AAtBJ,OAAO,eAAe;AAatB,MAAM,OAAO,CAAC,EAAE,MAAM,UAAU,UAAU,MAAiB;AACzD,QAAM,EAAE,KAAK,IAAI,UAAU;AAE3B,QAAM,cAAc,CAAC,MAA2C;AAC9D,MAAE,eAAe;AACjB,SAAK,IAAI;AAAA,EACX;AAEA,SACE,oBAAC,OAAE,MAAY,SAAS,aAAa,WAClC,UACH;AAEJ;AAEA,IAAO,eAAQ;",
-  "names": []
-}

package/dist/app.d.ts

@@ -1,19 +0,0 @@
-/**
- * app.ts — NukeJS Dev Server Entry Point
- *
- * This is the runtime that powers `nuke dev`. It:
- *   1. Loads your nuke.config.ts (or uses sensible defaults)
- *   2. Discovers API route prefixes from your server directory
- *   3. Starts an HTTP server that handles:
- *        app/public/**          — static files (highest priority, via middleware)
- *        /__hmr_ping            — heartbeat for HMR reconnect polling
- *        /__react.js            — bundled React + ReactDOM (resolved via importmap)
- *        /__n.js                — NukeJS client runtime bundle
- *        /__client-component/*  — on-demand "use client" component bundles
- *        server/**              — API route handlers from serverDir
- *        /**                    — SSR pages from app/pages (lowest priority)
- *   4. Watches for file changes and broadcasts HMR events to connected browsers
- *
- * In production (ENVIRONMENT=production), HMR and all file watching are skipped.
- */
-export {};

package/dist/app.js.map

@@ -1,7 +0,0 @@
-{
-  "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 *        app/public/**          \u2014 static files (highest priority, via middleware)\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 *        server/**              \u2014 API route handlers from serverDir\r\n *        /**                    \u2014 SSR pages from app/pages (lowest priority)\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, isDev });\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    // \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    // Framework files are checked before server routes so a user route can\r\n    // never accidentally shadow /__n.js, /__react.js, etc.\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 Server routes \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\r\n    // API routes from serverDir \u2014 checked after framework files, before pages.\r\n    if (matchApiPrefix(url, apiPrefixes))\r\n      return await handleApiRoute(url, req, res);\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    // Nothing above matched \u2014 render a page from app/pages.\r\n    return await serverSideRender(url, res, PAGES_DIR, isDev, req);\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/build-common.d.ts

@@ -1,178 +0,0 @@
-/**
- * build-common.ts — Shared Build Logic
- *
- * Used by both build-node.ts and build-vercel.ts.
- *
- * Exports:
- *   — types            : AnalyzedRoute, ServerPage, BuiltPage,
- *                        PageAdapterOptions, PageBundleOptions
- *   — utility helpers  : walkFiles, analyzeFile, isServerComponent,
- *                        findPageLayouts, extractDefaultExportName
- *   — collection       : collectServerPages, collectGlobalClientRegistry,
- *                        buildPerPageRegistry
- *   — template codegen : makeApiAdapterSource, makePageAdapterSource
- *   — bundle ops       : bundleApiHandler, bundlePageHandler,
- *                        bundleClientComponents, buildPages,
- *                        buildCombinedBundle, copyPublicFiles
- */
-export interface AnalyzedRoute {
-    /** Regex string matching the URL path, e.g. '^/users/([^/]+)$' */
-    srcRegex: string;
-    /** Names of captured groups in srcRegex order */
-    paramNames: string[];
-    /**
-     * Subset of paramNames that are catch-all ([...slug] or [[...path]]).
-     * Their runtime values are string[] not string.
-     */
-    catchAllNames: string[];
-    /** Function namespace path, e.g. '/api/users' or '/page/about' */
-    funcPath: string;
-    specificity: number;
-}
-export interface ServerPage extends AnalyzedRoute {
-    absPath: string;
-}
-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, catch-all param names, a function path, and a
- * specificity score.
- *
- * Supported patterns per segment:
- *   [[...name]]  optional catch-all  → regex (.*)      → string[]
- *   [...name]    required catch-all  → regex (.+)      → string[]
- *   [[name]]     optional single     → regex ([^/]*)?  → string
- *   [name]       required single     → regex ([^/]+)   → string
- *   literal      static              → escaped literal
- *
- * @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.
- *
- * Handles three formats so that components compiled by esbuild are recognised
- * alongside hand-written source files:
- *   1. Source:   `export default function Foo` / `export default Foo`
- *   2. esbuild:  `var Foo_default = Foo`  (compiled arrow-function component)
- *   3. Re-export: `export { Foo as default }`
- */
-export declare function extractDefaultExportName(filePath: string): string | null;
-/**
- * Returns all server-component pages inside `pagesDir`, sorted most-specific
- * first so 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.
- */
-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.
- */
-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[]`.
- */
-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.
- */
-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>;
-    /**
-     * All dynamic route param names for this page (e.g. ['id', 'slug']).
-     * Used to distinguish route segments from real query-string params at runtime.
-     */
-    routeParamNames: string[];
-    /** Subset of routeParamNames whose values are string[] (catch-all segments) */
-    catchAllNames: 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 for server + client components.
- *   • Client components are identified via the pre-computed CLIENT_COMPONENTS
- *     map — no fs.readFileSync at runtime.
- *   • Emits the full HTML document including the __n_data blob and bootstrap.
- */
-export declare function makePageAdapterSource(opts: PageAdapterOptions): string;
-/**
- * Bundles an API route handler into a single self-contained ESM string.
- * node_modules are kept external — they exist at runtime on both Node and
- * Vercel (Vercel bundles them separately via the pages dispatcher).
- */
-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>;
-    routeParamNames: string[];
-    catchAllNames: string[];
-}
-/**
- * Bundles a server-component page into a single self-contained ESM string.
- * All npm packages are kept external — the Node production server has
- * node_modules available at runtime.
- */
-export declare function bundlePageHandler(opts: PageBundleOptions): Promise<string>;
-/**
- * Bundles every client component in `globalRegistry` to
- * `<staticDir>/__client-component/<id>.js` and pre-renders each to HTML.
- */
-export declare function bundleClientComponents(globalRegistry: Map<string, string>, pagesDir: string, staticDir: string): Promise<Map<string, string>>;
-/**
- * Builds the combined browser bundle (__n.js) that contains the full React
- * runtime + NukeJS client runtime in a single file.
- */
-export declare function buildCombinedBundle(staticDir: string): Promise<void>;
-/**
- * Recursively copies every file from `publicDir` into `destDir`, preserving
- * the directory structure.  Skips silently when `publicDir` does not exist.
- */
-export declare function copyPublicFiles(publicDir: string, destDir: string): void;