reroute-js 1.0.0-alpha.36 → 1.0.0-alpha.37

package/README.md

@@ -618,6 +618,8 @@ Files are loaded in order, with later files overriding earlier ones.
 - ❌ `DATABASE_URL` - Server-only
 - ❌ `SECRET_KEY` - Server-only
 
+A route's or layout's `ssr` (`data`, `head`, `lang`, `sitemap`) is server code too: the browser bundle leaves it out, with every import only `ssr` uses, so a loader can import a database client or call `Bun` freely. Declare it as `export const ssr = …` (or `const ssr = …; export { ssr }`); a form the build can't leave out fails it. When the browser navigates, the server sends the page's head and lang, built as for a full page load (layouts, `meta`, content and `ssr.head`), with its data; the browser swaps the page's own head for it.
+
 ### TypeScript Support
 
 For type safety, create a `env.d.ts` file:

package/cli/bin.d.ts

@@ -1,5 +1,5 @@
 /**
- * reroute-js v1.0.0-alpha.36
+ * reroute-js v1.0.0-alpha.37
  *
  * @license MIT
  * @copyright 2026 stewones <hi@stewan.io>

package/cli/bin.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env bun
 // @bun
 /**
- * reroute-js v1.0.0-alpha.36
+ * reroute-js v1.0.0-alpha.37
  *
  * @license MIT
  * @copyright 2026 stewones <hi@stewan.io>
@@ -68,7 +68,7 @@ async function getVersionString() {
 }
 async function getVersion() {
   if (true) {
-    return "1.0.0-alpha.36";
+    return "1.0.0-alpha.37";
   }
   const possiblePaths = [
     path.join(import.meta.dir, "../../../../package.json"),
@@ -86,7 +86,7 @@ async function getVersion() {
 }
 async function getCommit() {
   if (true) {
-    return "dfc0a27";
+    return "6e28dd5";
   }
   return "dev";
 }
@@ -2818,6 +2818,11 @@ function deduplicateMetaByProperty(headContent) {
   }
   return result;
 }
+function markPageHead(head) {
+  return `<!--reroute:head-->${head ? `
+${head}
+` : ""}<!--/reroute:head-->`;
+}
 function deduplicateMetaTags(headContent) {
   try {
     let result = headContent;
@@ -4366,7 +4371,7 @@ async function renderSSRDocument(options) {
   const combinedHead = dedent([
     dedent(head) || "",
     dedent(extraHead),
-    dedent(setup2.metadataResult.perPageHead)
+    markPageHead(dedent(setup2.metadataResult.perPageHead))
   ].filter(Boolean).join(`
 `));
   const i18nLocale = options.i18n?.enabled ? String(options.i18n.locale || "") : "";
@@ -6746,7 +6751,7 @@ async function renderSSRDocumentStream(options) {
     const newAttrs = hasLang ? attrs.replace(/lang\s*=\s*("[^"]*"|'[^']*'|[^\s>]+)/i, `lang="${pageLang}"`) : `${attrs} lang="${pageLang}"`;
     return `<html${newAttrs}>`;
   });
-  const extraHeadBase = setup2.bundlePreload + setup2.preloadExtraHead + setup2.metadataResult.perPageHead;
+  const extraHeadBase = setup2.bundlePreload + setup2.preloadExtraHead + markPageHead(setup2.metadataResult.perPageHead);
   if (/<title[\s\S]*?<\/title>/i.test(extraHeadBase)) {
     headWithLang = headWithLang.replace(/<title[\s\S]*?<\/title>/i, "");
   }
@@ -7167,6 +7172,7 @@ __export(exports_core, {
   localizeHref: () => localizeHref,
   looksLikeLocale: () => looksLikeLocale,
   lookupMessage: () => lookupMessage,
+  markPageHead: () => markPageHead,
   markdownTwinPath: () => markdownTwinPath,
   matchRoutePattern: () => matchRoutePattern,
   matchRoutes: () => matchRoutes,
@@ -8237,6 +8243,87 @@ var init_routes2 = __esm(() => {
   groupSegment = /^\(.+\)$/;
 });
 
+// packages/cli/src/commands/lib/ssr-strip.ts
+function scriptLoader(path3) {
+  if (path3.endsWith(".tsx"))
+    return "tsx";
+  if (path3.endsWith(".jsx"))
+    return "jsx";
+  if (path3.endsWith(".js") || path3.endsWith(".mjs"))
+    return "js";
+  return "ts";
+}
+function exportsSsr(code, loader) {
+  try {
+    return new Bun.Transpiler({ loader }).scan(code).exports.includes("ssr");
+  } catch {
+    return true;
+  }
+}
+function bareImports(code) {
+  return new Set(Array.from(code.matchAll(BARE_IMPORT), (match) => match[2]));
+}
+function exportSsrInline(code) {
+  if (!SSR_DECLARATION.test(code))
+    return code;
+  let moved = false;
+  const listed = code.replace(EXPORT_LIST, (statement, names) => {
+    const list = names.split(",").map((name) => name.trim()).filter(Boolean);
+    if (!list.includes("ssr"))
+      return statement;
+    moved = true;
+    const rest = list.filter((name) => name !== "ssr");
+    return rest.length > 0 ? `export { ${rest.join(", ")} };` : "";
+  });
+  return moved ? listed.replace(SSR_DECLARATION, "$1export const ssr") : code;
+}
+function stripSsr(code, loader, path3, development) {
+  const stripped = new Bun.Transpiler({
+    loader,
+    trimUnusedImports: true,
+    autoImportJSX: true,
+    exports: { eliminate: ["ssr"] },
+    tsconfig: {
+      compilerOptions: {
+        jsx: development ? "react-jsxdev" : "react-jsx",
+        jsxImportSource: "react"
+      }
+    }
+  }).transformSync(exportSsrInline(code));
+  if (exportsSsr(stripped, "js") || SSR_DECLARATION.test(stripped)) {
+    throw new Error(`[reroute] ${path3}: declare the route's ssr as \`export const ssr = …\` so the browser bundle can leave it out`);
+  }
+  const own = bareImports(code);
+  return stripped.replace(BARE_IMPORT, (statement, _quote, specifier) => own.has(specifier) ? statement : "").replace(EMPTY_REEXPORT, "");
+}
+function ssrStripPlugin(options) {
+  const roots = [options.routesDir, options.markdownDir].map((dir) => dir.replace(/[\\/]+$/, ""));
+  const escaped = roots.map((dir) => dir.replace(/[.*+?^${}()|[\]\\]/g, "\\$&"));
+  const filter = new RegExp(`^(?:${escaped.join("|")})[\\\\/].*\\.[cm]?[jt]sx?$`);
+  return {
+    name: "reroute-ssr-strip",
+    setup(build) {
+      build.onLoad({ filter }, async ({ path: path3 }) => {
+        const code = await Bun.file(path3).text();
+        const loader = scriptLoader(path3);
+        if (!exportsSsr(code, loader))
+          return { contents: code, loader };
+        return {
+          contents: stripSsr(code, loader, path3, options.development),
+          loader: "js"
+        };
+      });
+    }
+  };
+}
+var BARE_IMPORT, EMPTY_REEXPORT, SSR_DECLARATION, EXPORT_LIST;
+var init_ssr_strip = __esm(() => {
+  BARE_IMPORT = /^[ \t]*import\s*(["'])([^"'\n]+)\1;?[ \t]*$/gm;
+  EMPTY_REEXPORT = /^[ \t]*export\s*\{\s*\}\s*from\s*(["'])[^"'\n]+\1;?[ \t]*$/gm;
+  SSR_DECLARATION = /^([ \t]*)(?:const|let|var)\s+ssr\b/m;
+  EXPORT_LIST = /^[ \t]*export\s*\{([^}]*)\}[ \t]*;?[ \t]*$/gm;
+});
+
 // packages/cli/src/commands/lib/streaming/analyzer.ts
 import { dirname as dirname4, join as join10 } from "node:path";
 function hasSSRDataExport(source) {
@@ -8787,24 +8874,36 @@ function getImportPath(filePath, streamingMap, routesImportBase) {
   const pathWithoutExt = filePath.replace(/\.(tsx|ts)$/, "");
   return `${routesImportBase}/${pathWithoutExt}`;
 }
+async function routeFilesWithSsr(cwd, routesPath, tree) {
+  const found = new Set;
+  for (const { filePath } of [...tree.routes, ...tree.layouts]) {
+    const source = /\.(md|mdx)$/.test(filePath) ? join14(cwd, ".reroute", "markdown", filePath.replace(/\.(md|mdx)$/, ".tsx")) : join14(routesPath, filePath);
+    const code = await Bun.file(source).text().catch(() => {
+      return;
+    });
+    if (code !== undefined && exportsSsr(code, scriptLoader(source)))
+      found.add(filePath);
+  }
+  return found;
+}
 function lazyRouteFallbackImport(config2) {
   const value = config2.streaming?.defaultSkeleton;
   if (typeof value !== "string" || value.trim().length === 0)
     return;
   return importFromReroute(value);
 }
-function generateTypeScript(tree, streamingMap, client, routesImportBase, fallbackImport) {
+function generateTypeScript(tree, streamingMap, clientSsr, routesImportBase, fallbackImport) {
   const helperImport = fallbackImport ? `import { createLazyRoute } from 'reroute-js/react';
 import LazyRouteFallback from '${fallbackImport}';` : "import { createLazyRoute } from 'reroute-js/react';";
   const fallbackArgs = fallbackImport ? ", LazyRouteFallback" : "";
   const ssrHelper = "const _ssr = (m: any) => m.ssr;";
   const metaHelper = "const _meta = (m: any) => m.meta;";
+  const ssrLine = (name) => clientSsr ? "" : `
+const ${name}SSR = _ssr(${name}Module);`;
   const metaImports = [
-    ...tree.routes.map((r, i) => `import * as Route${i}Module from '${getImportPath(r.filePath, streamingMap, routesImportBase)}';
-const Route${i}SSR = _ssr(Route${i}Module);
+    ...tree.routes.map((r, i) => `import * as Route${i}Module from '${getImportPath(r.filePath, streamingMap, routesImportBase)}';${ssrLine(`Route${i}`)}
 const Route${i}Meta = _meta(Route${i}Module);`),
-    ...tree.layouts.map((l, i) => `import * as Layout${i}Module from '${getImportPath(l.filePath, streamingMap, routesImportBase)}';
-const Layout${i}SSR = _ssr(Layout${i}Module);
+    ...tree.layouts.map((l, i) => `import * as Layout${i}Module from '${getImportPath(l.filePath, streamingMap, routesImportBase)}';${ssrLine(`Layout${i}`)}
 const Layout${i}Meta = _meta(Layout${i}Module);`)
   ].join(`
 `);
@@ -8837,7 +8936,7 @@ const Layout${i}Meta = _meta(Layout${i}Module);`)
     component: Route${i},
     params: ${JSON.stringify(r.params)},
     isDynamic: ${r.isDynamic},
-    ssr: Route${i}SSR,
+    ${clientSsr ? `hasSsr: ${clientSsr.has(r.filePath)}` : `ssr: Route${i}SSR`},
     meta: Route${i}Meta,
   } as const`;
   }).join(`,
@@ -8855,8 +8954,8 @@ const Layout${i}Meta = _meta(Layout${i}Module);`)
     return `  {
     pattern: "${l.pattern}",
     path: "${l.path}",${scope}
-    component: Layout${i},
-    ssr: Layout${i}SSR,
+    component: Layout${i},${clientSsr ? "" : `
+    ssr: Layout${i}SSR,`}
     meta: Layout${i}Meta,
   } as const`;
   }).join(`,
@@ -8874,8 +8973,8 @@ const Layout${i}Meta = _meta(Layout${i}Module);`)
 // @ts-nocheck
 
 ${helperImport}
-
-${ssrHelper}
+${clientSsr ? "" : `
+${ssrHelper}`}
 ${metaHelper}
 
 ${eagerImports}
@@ -8907,7 +9006,7 @@ export interface Route {
   component: any;
   params: string[];
   isDynamic: boolean;
-  ssr?: any;
+  ${clientSsr ? "hasSsr?: boolean;" : "ssr?: any;"}
   meta?: any;
 }
 
@@ -8958,7 +9057,7 @@ function matchPattern(route: Route, pathname: string): Record<string, string> |
   return pathnameIndex === pathnameParts.length ? params : null;
 }
 
-${client ? "" : `// Set globals for compiled binary support (sitemap/RSS/robots discovery)
+${clientSsr ? "" : `// Set globals for compiled binary support (sitemap/RSS/robots discovery)
 (globalThis as any).__REROUTE_ROUTES__ = routes;
 (globalThis as any).__REROUTE_LAYOUTS__ = layouts;
 (globalThis as any).__REROUTE_NOT_FOUND_ROUTES__ = notFoundRoutes;`}
@@ -9505,6 +9604,13 @@ async function buildEntrypointBundle(cwd, args = []) {
     ...getCommonBuildOptions(),
     naming: getNamingConfig({ entry: "index.[hash].[ext]" }),
     ...bundleGraphOptions,
+    plugins: [
+      ssrStripPlugin({
+        routesDir: join14(cwd, paths.routesDir),
+        markdownDir: join14(cwd, ".reroute", "markdown"),
+        development: !isProd
+      })
+    ],
     jsx: {
       runtime: "automatic",
       importSource: "react",
@@ -9689,8 +9795,8 @@ async function generate(cwd, args = [], options = {}) {
       const tree = generateRouteTree(all.map((f) => f.replace(/\\/g, "/")));
       const streamingAnalyses = streamingEnabled ? await buildStreamingWrappersForTree(cwd, routesPath, tree, config2) : new Map;
       const fallbackImport = lazyRouteFallbackImport(config2);
-      const serverRoutes = generateTypeScript(tree, streamingAnalyses, false, routesImportBase, fallbackImport);
-      const clientRoutes = generateTypeScript(tree, streamingAnalyses, true, routesImportBase, fallbackImport);
+      const serverRoutes = generateTypeScript(tree, streamingAnalyses, undefined, routesImportBase, fallbackImport);
+      const clientRoutes = generateTypeScript(tree, streamingAnalyses, await routeFilesWithSsr(cwd, routesPath, tree), routesImportBase, fallbackImport);
       await Bun.write(join14(cwd, OUTPUT_ROUTES), serverRoutes);
       await Bun.write(join14(cwd, OUTPUT_ROUTES_CLIENT), clientRoutes);
     });
@@ -10377,6 +10483,7 @@ var init_gen = __esm(() => {
   init_images();
   init_markdown();
   init_routes2();
+  init_ssr_strip();
   init_analyzer();
   init_suspense();
   init_theme();
@@ -108731,7 +108838,7 @@ async function getVersionString2() {
 }
 async function getVersion2() {
   if (true) {
-    return "1.0.0-alpha.36";
+    return "1.0.0-alpha.37";
   }
   const possiblePaths = [
     path3.join(import.meta.dir, "../../../package.json"),
@@ -108748,10 +108855,10 @@ async function getVersion2() {
 }
 async function getCommit2() {
   if (true) {
-    return "dfc0a27";
+    return "6e28dd5";
   }
   return "dev";
 }
 main();
 
-//# debugId=A24C16CC41DCEA0564756E2164756E21
+//# debugId=E7D58218ED0BCE3D64756E2164756E21