@webtypen/webframez-react 0.0.3 → 0.0.4

package/README.md

@@ -228,10 +228,10 @@ Recommended scripts:
     "build:server": "webframez-react build:server",
     "build:client": "webframez-react build:client",
     "build": "npm run build:server && npm run build:client",
-    "start": "node --conditions react-server start-server.cjs",
+    "start": "NODE_OPTIONS='--conditions react-server -r @webtypen/webframez-react/register' node start-server.cjs",
     "watch:server": "webframez-react watch:server",
     "watch:client": "webframez-react watch:client",
-    "serve:watch": "node --watch --conditions react-server start-server.cjs",
+    "serve:watch": "NODE_OPTIONS='--conditions react-server -r @webtypen/webframez-react/register' node --watch start-server.cjs",
     "watch": "sh -c 'npm run watch:server & npm run watch:client & npm run serve:watch & wait'",
     "dev": "sh -c 'npm run watch:server & npm run watch:client & npm run serve:watch & wait'"
   }
@@ -242,6 +242,29 @@ Notes:
 - `build` compiles the server output (`pages`, `server.ts`) and the browser client bundle (`client.tsx` + RSC manifests).
 - `start` runs the built app in React Server mode.
 - `watch` / `dev` keep TypeScript and webpack in watch mode and restart Node automatically when server output changes.
+- `@webtypen/webframez-react/register` activates the React Server module register, so `"use client"` modules are treated correctly in Node and in the package's SSR worker.
+
+If you run an existing `webframez-core` app directly with `ts-node` or `node`, use the same preload:
+
+```json
+{
+  "scripts": {
+    "start": "NODE_OPTIONS='--conditions react-server -r @webtypen/webframez-react/register' ts-node ./app.ts",
+    "watch:app": "nodemon --exec \"NODE_OPTIONS='--conditions react-server -r @webtypen/webframez-react/register' ts-node ./app.ts\""
+  }
+}
+```
+
+Or via the shipped wrapper command:
+
+```json
+{
+  "scripts": {
+    "start": "TS_NODE_FILES=true webframez-react exec -- ts-node ./app.ts",
+    "watch:app": "nodemon --exec \"TS_NODE_FILES=true webframez-react exec -- ts-node ./app.ts\""
+  }
+}
+```
 
 ## CLI Config and Custom Entry Paths
 

package/bin/webframez-react.mjs

@@ -27,6 +27,7 @@ function printHelp() {
       "  webframez-react watch:client",
       "  webframez-react build:server:webpack",
       "  webframez-react watch:server:webpack",
+      "  webframez-react exec -- <command> [args...]",
       "",
       "Config fallback order:",
       "  1) project root override file",
@@ -115,6 +116,11 @@ function resolveBinary(name) {
   return name;
 }
 
+function buildReactServerNodeOptions() {
+  const existing = process.env.NODE_OPTIONS ? `${process.env.NODE_OPTIONS} ` : "";
+  return `${existing}--conditions react-server -r @webtypen/webframez-react/register`.trim();
+}
+
 async function loadProjectConfig() {
   const configFiles = [
     "webframez-react.config.mjs",
@@ -259,6 +265,21 @@ async function main() {
     return;
   }
 
+  if (command === "exec") {
+    if (passthroughArgsClean.length === 0) {
+      console.error("[webframez-react] Missing command for exec.");
+      printHelp();
+      process.exit(1);
+    }
+
+    const [binaryName, ...binaryArgs] = passthroughArgsClean;
+    const code = await run(binaryName, binaryArgs, {
+      NODE_OPTIONS: buildReactServerNodeOptions(),
+    });
+    process.exit(code);
+    return;
+  }
+
   if (command === "build:client" || command === "watch:client") {
     const config = resolveConfig("webpack.client.cjs", "webpack.client.cjs");
     console.log(`[webframez-react] webpack config (${config.source}): ${config.path}`);

package/dist/http.cjs

@@ -499,14 +499,26 @@ function stripBasePath(pathname, basePath) {
 }
 function runNodeCommand(args) {
   return new Promise((resolve, reject) => {
-    (0, import_node_child_process.execFile)(process.execPath, args, { timeout: 1e4, maxBuffer: 1024 * 1024 * 5 }, (error, stdout, stderr) => {
-      if (error) {
-        const out = stderr && stderr.trim() !== "" ? stderr : stdout;
-        reject(new Error(out || error.message));
-        return;
+    const execArgs = [
+      "--conditions",
+      "react-server",
+      "-r",
+      "@webtypen/webframez-react/register",
+      ...args
+    ];
+    (0, import_node_child_process.execFile)(
+      process.execPath,
+      execArgs,
+      { timeout: 1e4, maxBuffer: 1024 * 1024 * 5 },
+      (error, stdout, stderr) => {
+        if (error) {
+          const out = stderr && stderr.trim() !== "" ? stderr : stdout;
+          reject(new Error(out || error.message));
+          return;
+        }
+        resolve({ stdout, stderr });
       }
-      resolve({ stdout, stderr });
-    });
+    );
   });
 }
 async function renderInitialHtmlInWorker(options) {
@@ -530,7 +542,7 @@ Module._resolveFilename = function(request, parent, isMain, options) {
   }
   return originalResolveFilename.call(this, request, parent, isMain, options);
 };
-const { createFileRouter } = require("webframez-react/router");
+const { createFileRouter } = require("@webtypen/webframez-react/router");
 const reactDomPkg = require.resolve("react-dom/package.json", {
   paths: [process.cwd(), input.pagesDir]
 });

package/dist/http.js

@@ -474,14 +474,26 @@ function stripBasePath(pathname, basePath) {
 }
 function runNodeCommand(args) {
   return new Promise((resolve, reject) => {
-    execFile(process.execPath, args, { timeout: 1e4, maxBuffer: 1024 * 1024 * 5 }, (error, stdout, stderr) => {
-      if (error) {
-        const out = stderr && stderr.trim() !== "" ? stderr : stdout;
-        reject(new Error(out || error.message));
-        return;
+    const execArgs = [
+      "--conditions",
+      "react-server",
+      "-r",
+      "@webtypen/webframez-react/register",
+      ...args
+    ];
+    execFile(
+      process.execPath,
+      execArgs,
+      { timeout: 1e4, maxBuffer: 1024 * 1024 * 5 },
+      (error, stdout, stderr) => {
+        if (error) {
+          const out = stderr && stderr.trim() !== "" ? stderr : stdout;
+          reject(new Error(out || error.message));
+          return;
+        }
+        resolve({ stdout, stderr });
       }
-      resolve({ stdout, stderr });
-    });
+    );
   });
 }
 async function renderInitialHtmlInWorker(options) {
@@ -505,7 +517,7 @@ Module._resolveFilename = function(request, parent, isMain, options) {
   }
   return originalResolveFilename.call(this, request, parent, isMain, options);
 };
-const { createFileRouter } = require("webframez-react/router");
+const { createFileRouter } = require("@webtypen/webframez-react/router");
 const reactDomPkg = require.resolve("react-dom/package.json", {
   paths: [process.cwd(), input.pagesDir]
 });

package/dist/index.cjs

@@ -536,14 +536,26 @@ function stripBasePath(pathname, basePath) {
 }
 function runNodeCommand(args) {
   return new Promise((resolve, reject) => {
-    (0, import_node_child_process.execFile)(process.execPath, args, { timeout: 1e4, maxBuffer: 1024 * 1024 * 5 }, (error, stdout, stderr) => {
-      if (error) {
-        const out = stderr && stderr.trim() !== "" ? stderr : stdout;
-        reject(new Error(out || error.message));
-        return;
+    const execArgs = [
+      "--conditions",
+      "react-server",
+      "-r",
+      "@webtypen/webframez-react/register",
+      ...args
+    ];
+    (0, import_node_child_process.execFile)(
+      process.execPath,
+      execArgs,
+      { timeout: 1e4, maxBuffer: 1024 * 1024 * 5 },
+      (error, stdout, stderr) => {
+        if (error) {
+          const out = stderr && stderr.trim() !== "" ? stderr : stdout;
+          reject(new Error(out || error.message));
+          return;
+        }
+        resolve({ stdout, stderr });
       }
-      resolve({ stdout, stderr });
-    });
+    );
   });
 }
 async function renderInitialHtmlInWorker(options) {
@@ -567,7 +579,7 @@ Module._resolveFilename = function(request, parent, isMain, options) {
   }
   return originalResolveFilename.call(this, request, parent, isMain, options);
 };
-const { createFileRouter } = require("webframez-react/router");
+const { createFileRouter } = require("@webtypen/webframez-react/router");
 const reactDomPkg = require.resolve("react-dom/package.json", {
   paths: [process.cwd(), input.pagesDir]
 });

package/dist/index.js

@@ -500,14 +500,26 @@ function stripBasePath(pathname, basePath) {
 }
 function runNodeCommand(args) {
   return new Promise((resolve, reject) => {
-    execFile(process.execPath, args, { timeout: 1e4, maxBuffer: 1024 * 1024 * 5 }, (error, stdout, stderr) => {
-      if (error) {
-        const out = stderr && stderr.trim() !== "" ? stderr : stdout;
-        reject(new Error(out || error.message));
-        return;
+    const execArgs = [
+      "--conditions",
+      "react-server",
+      "-r",
+      "@webtypen/webframez-react/register",
+      ...args
+    ];
+    execFile(
+      process.execPath,
+      execArgs,
+      { timeout: 1e4, maxBuffer: 1024 * 1024 * 5 },
+      (error, stdout, stderr) => {
+        if (error) {
+          const out = stderr && stderr.trim() !== "" ? stderr : stdout;
+          reject(new Error(out || error.message));
+          return;
+        }
+        resolve({ stdout, stderr });
       }
-      resolve({ stdout, stderr });
-    });
+    );
   });
 }
 async function renderInitialHtmlInWorker(options) {
@@ -531,7 +543,7 @@ Module._resolveFilename = function(request, parent, isMain, options) {
   }
   return originalResolveFilename.call(this, request, parent, isMain, options);
 };
-const { createFileRouter } = require("webframez-react/router");
+const { createFileRouter } = require("@webtypen/webframez-react/router");
 const reactDomPkg = require.resolve("react-dom/package.json", {
   paths: [process.cwd(), input.pagesDir]
 });

package/dist/webframez-core.cjs

@@ -502,14 +502,26 @@ function stripBasePath(pathname, basePath) {
 }
 function runNodeCommand(args) {
   return new Promise((resolve, reject) => {
-    (0, import_node_child_process.execFile)(process.execPath, args, { timeout: 1e4, maxBuffer: 1024 * 1024 * 5 }, (error, stdout, stderr) => {
-      if (error) {
-        const out = stderr && stderr.trim() !== "" ? stderr : stdout;
-        reject(new Error(out || error.message));
-        return;
+    const execArgs = [
+      "--conditions",
+      "react-server",
+      "-r",
+      "@webtypen/webframez-react/register",
+      ...args
+    ];
+    (0, import_node_child_process.execFile)(
+      process.execPath,
+      execArgs,
+      { timeout: 1e4, maxBuffer: 1024 * 1024 * 5 },
+      (error, stdout, stderr) => {
+        if (error) {
+          const out = stderr && stderr.trim() !== "" ? stderr : stdout;
+          reject(new Error(out || error.message));
+          return;
+        }
+        resolve({ stdout, stderr });
       }
-      resolve({ stdout, stderr });
-    });
+    );
   });
 }
 async function renderInitialHtmlInWorker(options) {
@@ -533,7 +545,7 @@ Module._resolveFilename = function(request, parent, isMain, options) {
   }
   return originalResolveFilename.call(this, request, parent, isMain, options);
 };
-const { createFileRouter } = require("webframez-react/router");
+const { createFileRouter } = require("@webtypen/webframez-react/router");
 const reactDomPkg = require.resolve("react-dom/package.json", {
   paths: [process.cwd(), input.pagesDir]
 });

package/dist/webframez-core.js

@@ -474,14 +474,26 @@ function stripBasePath(pathname, basePath) {
 }
 function runNodeCommand(args) {
   return new Promise((resolve, reject) => {
-    execFile(process.execPath, args, { timeout: 1e4, maxBuffer: 1024 * 1024 * 5 }, (error, stdout, stderr) => {
-      if (error) {
-        const out = stderr && stderr.trim() !== "" ? stderr : stdout;
-        reject(new Error(out || error.message));
-        return;
+    const execArgs = [
+      "--conditions",
+      "react-server",
+      "-r",
+      "@webtypen/webframez-react/register",
+      ...args
+    ];
+    execFile(
+      process.execPath,
+      execArgs,
+      { timeout: 1e4, maxBuffer: 1024 * 1024 * 5 },
+      (error, stdout, stderr) => {
+        if (error) {
+          const out = stderr && stderr.trim() !== "" ? stderr : stdout;
+          reject(new Error(out || error.message));
+          return;
+        }
+        resolve({ stdout, stderr });
       }
-      resolve({ stdout, stderr });
-    });
+    );
   });
 }
 async function renderInitialHtmlInWorker(options) {
@@ -505,7 +517,7 @@ Module._resolveFilename = function(request, parent, isMain, options) {
   }
   return originalResolveFilename.call(this, request, parent, isMain, options);
 };
-const { createFileRouter } = require("webframez-react/router");
+const { createFileRouter } = require("@webtypen/webframez-react/router");
 const reactDomPkg = require.resolve("react-dom/package.json", {
   paths: [process.cwd(), input.pagesDir]
 });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@webtypen/webframez-react",
-  "version": "0.0.3",
+  "version": "0.0.4",
   "description": "TypeScript React RSC addition for @webtypen/webframez-core",
   "homepage": "https://webtypen.de/",
   "author": {
@@ -58,6 +58,7 @@
       "import": "./dist/webframez-core.js",
       "require": "./dist/webframez-core.cjs"
     },
+    "./register": "./register.cjs",
     "./defaults/webpack.client": "./defaults/webpack.client.cjs",
     "./defaults/webpack.server": "./defaults/webpack.server.cjs",
     "./defaults/tsconfig.server": "./defaults/tsconfig.server.json",
@@ -67,7 +68,8 @@
   "files": [
     "dist",
     "defaults",
-    "bin"
+    "bin",
+    "register.cjs"
   ],
   "scripts": {
     "clean": "rm -rf dist",

package/register.cjs

@@ -0,0 +1 @@
+require("react-server-dom-webpack/node-register")();