Convert in-repo demo scripts to .cjs for type:module

The rosocket and web/javascript demos run straight from a clone (no npm
install) and use CommonJS (require/__dirname), which breaks under the
package's "type":"module". Rename them to .cjs and unwrap the now-ESM
default export when requiring index.js:
- demo/rosocket/server.js -> server.cjs (require('../../index.js').default)
- demo/web/javascript/runtime.js -> runtime.cjs (.default unwrap)
- demo/web/javascript/static.js -> static.cjs (builtins/__dirname only)

Update run-command and prose references in the demo READMEs, index.html,
and the web/typescript server.ts comment. The electron and typescript
demos are standalone projects that consume the published dual package via
its exports map (require + import both supported) and need no changes.

Author: minggangw

demo/rosocket/README.md

@@ -11,12 +11,12 @@ library required.
 - Subscribe to and publish on `/chatter` (`std_msgs/msg/String`).
 - Call `/add_two_ints` (`example_interfaces/srv/AddTwoInts`) — the
   service implementation lives in
-  [`example/services/service/service-example.js`](../../example/services/service/service-example.js)
+  [`example/services/service/service-example.cjs`](../../example/services/service/service-example.cjs)
   and is launched in a second terminal.
 
 ## Layout
 
-- `server.js` — `rclnodejs` node + `startRosocket` bridge only.
+- `server.cjs` — `rclnodejs` node + `startRosocket` bridge only.
 - `index.html` — single-file browser client using only built-in
   `WebSocket` and `JSON`.
 
@@ -27,12 +27,12 @@ library required.
 source /opt/ros/$ROS_DISTRO/setup.bash
 
 # 2. Terminal A — start the WebSocket gateway
-node demo/rosocket/server.js
+node demo/rosocket/server.cjs
 # [rosocket-demo] listening on ws://localhost:9000 (bind=0.0.0.0)
 
 # 3. Terminal B — start the AddTwoInts service so the browser has
 #    something to call
-node example/services/service/service-example.js
+node example/services/service/service-example.cjs
 ```
 
 The server binds to `0.0.0.0:9000` so it is reachable from any host

demo/rosocket/server.js demo/rosocket/server.cjsdemo/rosocket/server.js renamed to demo/rosocket/server.cjs

@@ -17,17 +17,17 @@
 //   ws://<host>:9000/service/add_two_ints example_interfaces/srv/AddTwoInts
 //
 // Run inside WSL (where ROS 2 is sourced):
-//   node demo/rosocket/server.js
+//   node demo/rosocket/server.cjs
 //
 // To exercise the service, start the existing AddTwoInts example in a
 // second terminal (it implements `/add_two_ints`):
-//   node example/services/service/service-example.js
+//   node example/services/service/service-example.cjs
 //
 // Then open demo/rosocket/index.html on the Windows host browser. WSL2
 // forwards localhost so `ws://localhost:9000` works as-is. See README.md
 // for fallback instructions.
 
-const rclnodejs = require('../../index.js');
+const rclnodejs = require('../../index.js').default;
 const { startRosocket } = require('../../rosocket');
 
 const PORT = Number(process.env.PORT) || 9000;

demo/web/javascript/README.md

@@ -14,20 +14,20 @@ cd demo/web/javascript
 
 ```bash
 source /opt/ros/<distro>/setup.bash
-node runtime.js
+node runtime.cjs
 # rclnodejs/web : ws://localhost:9000/capability
 #               also http://localhost:9001/capability  (call/publish, curl-able)
 ```
 
-`runtime.js` exposes a tiny `/add_two_ints` service + 1 Hz
+`runtime.cjs` exposes a tiny `/add_two_ints` service + 1 Hz
 `/web_demo_tick` publisher so every panel has live data.
 
 **Shell 2 — static-file server (hosts `index.html` + maps `/sdk/*` to
 the in-repo [`web/`](../../../web/) folder so the page can `import`
 the SDK from a plain URL):**
 
 ```bash
-node static.js
+node static.cjs
 # Static files : http://localhost:8080/
 ```
 
@@ -67,18 +67,18 @@ curl -sS -X POST http://localhost:9001/capability/call/add_two_ints \
 
 Subscribe stays on WebSocket.
 
-## Without the bundled `runtime.js`
+## Without the bundled `runtime.cjs`
 
-`runtime.js` bundles the rclnodejs/web runtime and the demo's sample
+`runtime.cjs` bundles the rclnodejs/web runtime and the demo's sample
 ROS 2 nodes (the `/add_two_ints` service + the `/web_demo_tick`
 publisher) into one process so the demo runs out of the box. In a
 real project you already have those ROS 2 nodes running elsewhere,
-so you only need the runtime. **Replace shell 1's `node runtime.js`
-with the CLI** — shell 2 (`node static.js`) and the browser code are
+so you only need the runtime. **Replace shell 1's `node runtime.cjs`
+with the CLI** — shell 2 (`node static.cjs`) and the browser code are
 unchanged:
 
 ```bash
-# shell 1 (instead of `node runtime.js`); the `-p rclnodejs` tells npx
+# shell 1 (instead of `node runtime.cjs`); the `-p rclnodejs` tells npx
 # the `rclnodejs-web` binary lives inside the `rclnodejs` package:
 npx -p rclnodejs rclnodejs-web web.json
 

demo/web/javascript/index.html

@@ -1,7 +1,7 @@
 <!doctype html>
 <!--
   rclnodejs/web demo. Open via http://localhost:8080/ once both
-  `node runtime.js` (rclnodejs/web runtime) and `node static.js`
+  `node runtime.cjs` (rclnodejs/web runtime) and `node static.cjs`
   (page server) are running — see README.md.
 -->
 <html lang="en">

demo/web/javascript/runtime.js demo/web/javascript/runtime.cjsdemo/web/javascript/runtime.js renamed to demo/web/javascript/runtime.cjs

@@ -7,18 +7,18 @@
 //     http://www.apache.org/licenses/LICENSE-2.0
 //
 // rclnodejs/web demo — runtime side (rclnodejs/web runtime + the demo's
-// ROS 2 nodes; named `runtime.js` to avoid being confused with the
-// page-side `static.js`).
+// ROS 2 nodes; named `runtime.cjs` to avoid being confused with the
+// page-side `static.cjs`).
 //
 //   1. Source ROS 2 (`source /opt/ros/<distro>/setup.bash`)
-//   2. From this folder run `node runtime.js`
-//   3. In another shell run `node static.js` to host
+//   2. From this folder run `node runtime.cjs`
+//   3. In another shell run `node static.cjs` to host
 //      `index.html` on http://localhost:8080/ — same split as the
 //      TypeScript demo's `tsx server.ts` + `vite`.
 
 'use strict';
 
-const rclnodejs = require('../../../index.js');
+const rclnodejs = require('../../../index.js').default;
 // In a downstream project this is the public, supported import:
 //   const { createRuntime, WebSocketTransport, HttpTransport } =
 //     require('rclnodejs/web/server');
@@ -135,7 +135,7 @@ async function main() {
   console.log(formatCapabilities(caps));
   console.log();
   console.log(
-    'Static page: run `node static.js` in another shell, then open http://localhost:8080/'
+    'Static page: run `node static.cjs` in another shell, then open http://localhost:8080/'
   );
 
   // ---- Graceful shutdown ----------------------------------------------

demo/web/javascript/static.js demo/web/javascript/static.cjsdemo/web/javascript/static.js renamed to demo/web/javascript/static.cjs

@@ -6,15 +6,15 @@
 //
 //     http://www.apache.org/licenses/LICENSE-2.0
 //
-// rclnodejs/web demo — static-file server (page side; named `static.js`
-// to avoid being confused with the runtime-side `runtime.js`).
+// rclnodejs/web demo — static-file server (page side; named `static.cjs`
+// to avoid being confused with the runtime-side `runtime.cjs`).
 //
 // Serves index.html on port 8080 and maps `/sdk/*` to the in-repo
 // `web/` folder so the page can `import { connect } from '/sdk/index.js'`
 // without bundling. In a downstream project you'd `npm install rclnodejs`
 // and `import { connect } from 'rclnodejs/web'` instead.
 //
-// Pair with `node runtime.js` (the rclnodejs/web runtime + the demo's
+// Pair with `node runtime.cjs` (the rclnodejs/web runtime + the demo's
 // ROS 2 nodes) in another shell — the same split as the TypeScript
 // demo's `tsx server.ts` + `vite`. Production deployments use nginx,
 // a CDN, or any other static host.

demo/web/typescript/server.ts

@@ -7,11 +7,11 @@
 //     http://www.apache.org/licenses/LICENSE-2.0
 //
 // TypeScript demo server. Run with `npm run server` (which uses tsx) or
-// `npx tsx server.ts`. Behaviour matches demo/web/javascript/runtime.js
+// `npx tsx server.ts`. Behaviour matches demo/web/javascript/runtime.cjs
 // — same runtime + same demo nodes — except this side is written in
 // TypeScript so the typed SDK story is visible end to end. The static
 // page server is Vite (`npm run dev`), parallel to the JS demo's
-// separate `node static.js`.
+// separate `node static.cjs`.
 
 // rclnodejs is a CommonJS module without first-class ESM types; using
 // require keeps the server independent of how a downstream project
@@ -30,7 +30,7 @@ const RUNTIME_PORT = Number(process.env.RUNTIME_PORT || 9000);
 const HTTP_PORT = Number(process.env.HTTP_PORT || 9001);
 
 // Render the registry as a small human-readable table — see the matching
-// helper in demo/web/javascript/runtime.js.
+// helper in demo/web/javascript/runtime.cjs.
 function formatCapabilities(
   caps: Record<'call' | 'publish' | 'subscribe', Record<string, string>>
 ): string {