nukejs 0.0.29 → 0.0.30

package/dist/index.d.ts

@@ -9,6 +9,8 @@ export type { RequestContext } from './use-request';
 export { normaliseHeaders, sanitiseHeaders, getRequestStore } from './request-store';
 export { cache } from './cache-store';
 export { default as Link } from './Link';
+export { renderComponent } from './render-component';
+export type { RenderComponentOptions } from './render-component';
 export { setupLocationChangeMonitor, initRuntime } from './bundle';
 export type { RuntimeData } from './bundle';
 export { escapeHtml } from './utils';

package/dist/index.js

@@ -5,6 +5,7 @@ import { useRequest } from "./use-request.js";
 import { normaliseHeaders, sanitiseHeaders, getRequestStore } from "./request-store.js";
 import { cache } from "./cache-store.js";
 import { default as default3 } from "./Link.js";
+import { renderComponent } from "./render-component.js";
 import { setupLocationChangeMonitor, initRuntime } from "./bundle.js";
 import { escapeHtml } from "./utils.js";
 import { ansi, c, log, setDebugLevel, getDebugLevel } from "./logger.js";
@@ -21,6 +22,7 @@ export {
   initRuntime,
   log,
   normaliseHeaders,
+  renderComponent,
   sanitiseHeaders,
   setDebugLevel,
   setupLocationChangeMonitor,

package/dist/render-component.js

@@ -0,0 +1,32 @@
+import { createElement } from "react";
+import { pathToFileURL } from "url";
+import { tsImport } from "tsx/esm/api";
+import path from "path";
+import { renderDocument } from "./ssr.js";
+async function renderComponent(filePath, props = {}, options = {}) {
+  const layoutPaths = options.layoutPaths ?? [];
+  const { default: Component } = await tsImport(pathToFileURL(filePath).href, { parentURL: import.meta.url });
+  let element = createElement(Component, props);
+  for (let i = layoutPaths.length - 1; i >= 0; i--) {
+    const { default: Layout } = await tsImport(pathToFileURL(layoutPaths[i]).href, { parentURL: import.meta.url });
+    element = createElement(Layout, { children: element });
+  }
+  return renderDocument({
+    registryEntryFiles: [filePath, ...layoutPaths],
+    pagesDir: options.pagesDir ?? path.resolve("./app/pages"),
+    element,
+    url: options.url ?? "/",
+    params: options.params,
+    query: options.query,
+    headers: options.headers,
+    isDev: options.isDev ?? process.env.ENVIRONMENT !== "production",
+    // Always false here: the whole point is a real server-rendered
+    // document for crawlers, not just a hydration target. skipClientSSR
+    // exists in renderDocument only for ssr.ts's dev-mode HMR fast path.
+    skipClientSSR: false,
+    defaultTitle: options.title ?? "NukeJS"
+  });
+}
+export {
+  renderComponent
+};

package/dist/ssr.js

@@ -92,34 +92,25 @@ function renderManagedBodyScripts(store) {
   if (bodyScripts.length === 0) return [];
   return ["  <!--n-body-scripts-->", ...bodyScripts.map(renderScriptTag), "  <!--/n-body-scripts-->"];
 }
-async function renderFile(filePath, params, url, pagesDir, isDev, res, req, statusCode, skipClientSSR) {
+async function renderDocument(options) {
+  const {
+    registryEntryFiles,
+    pagesDir,
+    element,
+    url,
+    params = {},
+    query = {},
+    headers = {},
+    isDev = false,
+    skipClientSSR = false,
+    defaultTitle = "NukeJS"
+  } = options;
   const cleanUrl = url.split("?")[0];
-  const searchParams = new URL(url, "http://localhost").searchParams;
-  const queryParams = {};
-  searchParams.forEach((_, k) => {
-    if (!(k in params)) {
-      const all = searchParams.getAll(k);
-      queryParams[k] = all.length > 1 ? all : all[0];
-    }
-  });
-  const mergedParams = { ...queryParams, ...params };
-  const rawHeaders = req?.headers ?? {};
-  const normHeaders = normaliseHeaders(rawHeaders);
-  const safeHeaders = sanitiseHeaders(rawHeaders);
-  const layoutPaths = findLayoutsForRoute(filePath, pagesDir);
-  const { default: PageComponent } = await tsImport(
-    pathToFileURL(filePath).href,
-    { parentURL: import.meta.url }
-  );
-  const wrappedElement = await wrapWithLayouts(
-    createElement(PageComponent, mergedParams),
-    layoutPaths
-  );
+  const normHeaders = normaliseHeaders(headers);
+  const safeHeaders = sanitiseHeaders(headers);
   const registry = /* @__PURE__ */ new Map();
-  for (const [id, p] of findClientComponentsInTree(filePath, pagesDir))
-    registry.set(id, p);
-  for (const layoutPath of layoutPaths)
-    for (const [id, p] of findClientComponentsInTree(layoutPath, pagesDir))
+  for (const entryFile of registryEntryFiles)
+    for (const [id, p] of findClientComponentsInTree(entryFile, pagesDir))
       registry.set(id, p);
   const ctx = { registry, hydrated: /* @__PURE__ */ new Set(), skipClientSSR };
   let appHtml = "";
@@ -128,14 +119,14 @@ async function renderFile(filePath, params, url, pagesDir, isDev, res, req, stat
       url,
       pathname: cleanUrl,
       params,
-      query: queryParams,
+      query,
       headers: normHeaders
     },
     () => runWithCacheStore(() => runWithHtmlStore(async () => {
-      appHtml = await renderElementToHtml(wrappedElement, ctx);
+      appHtml = await renderElementToHtml(element, ctx);
     }))
   );
-  const pageTitle = resolveTitle(store.titleOps, "NukeJS");
+  const pageTitle = resolveTitle(store.titleOps, defaultTitle);
   const headLines = [
     '  <meta charset="utf-8" />',
     '  <meta name="viewport" content="width=device-width, initial-scale=1" />',
@@ -147,13 +138,13 @@ async function renderFile(filePath, params, url, pagesDir, isDev, res, req, stat
     allIds: [...registry.keys()],
     url,
     params,
-    query: queryParams,
+    query,
     headers: safeHeaders,
     debug: toClientDebugLevel(getDebugLevel())
   }).replace(/</g, "\\u003c").replace(/>/g, "\\u003e").replace(/&/g, "\\u0026");
   const bodyScriptLines = renderManagedBodyScripts(store);
   const bodyScriptsHtml = bodyScriptLines.length > 0 ? "\n" + bodyScriptLines.join("\n") + "\n" : "";
-  const html = `<!DOCTYPE html>
+  return `<!DOCTYPE html>
 ${openTag("html", store.htmlAttrs)}
 <head>
 ${headLines.join("\n")}
@@ -184,6 +175,38 @@ ${openTag("body", store.bodyAttrs)}
   ${isDev ? '<script type="module" src="/__hmr.js"></script>' : ""}
 ${bodyScriptsHtml}</body>
 </html>`;
+}
+async function renderFile(filePath, params, url, pagesDir, isDev, res, req, statusCode, skipClientSSR) {
+  const searchParams = new URL(url, "http://localhost").searchParams;
+  const queryParams = {};
+  searchParams.forEach((_, k) => {
+    if (!(k in params)) {
+      const all = searchParams.getAll(k);
+      queryParams[k] = all.length > 1 ? all : all[0];
+    }
+  });
+  const mergedParams = { ...queryParams, ...params };
+  const layoutPaths = findLayoutsForRoute(filePath, pagesDir);
+  const { default: PageComponent } = await tsImport(
+    pathToFileURL(filePath).href,
+    { parentURL: import.meta.url }
+  );
+  const wrappedElement = await wrapWithLayouts(
+    createElement(PageComponent, mergedParams),
+    layoutPaths
+  );
+  const html = await renderDocument({
+    registryEntryFiles: [filePath, ...layoutPaths],
+    pagesDir,
+    element: wrappedElement,
+    url,
+    params,
+    query: queryParams,
+    headers: req?.headers ?? {},
+    isDev,
+    skipClientSSR,
+    defaultTitle: "NukeJS"
+  });
   res.statusCode = statusCode;
   res.setHeader("Content-Type", "text/html");
   res.end(html);
@@ -259,5 +282,6 @@ async function serverSideRender(url, res, pagesDir, isDev = false, req) {
   }
 }
 export {
+  renderDocument,
   serverSideRender
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nukejs",
-  "version": "0.0.29",
+  "version": "0.0.30",
   "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",