create-crossbind 2.0.0-beta.62 → 2.0.0-beta.64

package/templates/desktop-electron/src/main.js

@@ -0,0 +1,29 @@
+const path = require('node:path');
+const { app, BrowserWindow, ipcMain } = require('electron');
+const initNative = require('../dist/crossbind-example-desktop-electron.native.cjs');
+
+// The addon runs in the main process, the one with Node.js; the window asks it over IPC.
+ipcMain.handle('native:sample', async () => {
+    const { Native } = await initNative();
+    return Native.sample();
+});
+
+function createWindow() {
+    const window = new BrowserWindow({
+        width: 640,
+        height: 360,
+        webPreferences: { preload: path.join(__dirname, 'preload.js') },
+    });
+    window.loadFile(path.join(__dirname, 'index.html'));
+}
+
+app.whenReady().then(() => {
+    createWindow();
+    app.on('activate', () => {
+        if (BrowserWindow.getAllWindows().length === 0) createWindow();
+    });
+});
+
+app.on('window-all-closed', () => {
+    if (process.platform !== 'darwin') app.quit();
+});

package/templates/desktop-electron/src/native/native.cpp

@@ -0,0 +1,9 @@
+#include "native.h"
+#include <Matrix.h>
+
+std::string Native::sample() {
+  auto firstMatrix = std::make_shared<Matrix>(9, 1);
+  auto secondMatrix = std::make_shared<Matrix>(9, 2);
+  auto resultStr = std::to_string(firstMatrix->multiple(secondMatrix)->get(0));
+  return "J₃ * (2*J₃) = " + resultStr + "*J₃";
+}

package/templates/desktop-electron/src/native/native.h

@@ -0,0 +1,12 @@
+#ifndef _NATIVE_H
+#define _NATIVE_H
+
+#include <string>
+#include <memory>
+
+class Native {
+public:
+    static std::string sample();
+};
+
+#endif

package/templates/desktop-electron/src/preload.js

@@ -0,0 +1,5 @@
+const { contextBridge, ipcRenderer } = require('electron');
+
+contextBridge.exposeInMainWorld('native', {
+    sample: () => ipcRenderer.invoke('native:sample'),
+});

package/templates/desktop-electron/src/renderer.js

@@ -0,0 +1,5 @@
+const message = document.querySelector('#cppMessage');
+
+window.native.sample()
+    .then((result) => { message.textContent = result; })
+    .catch((error) => { message.textContent = error.message; });

package/templates/lib-cmake/README.md

@@ -2,7 +2,7 @@
 **crossbind sample library: simple cmake library**  
 
 <a href="https://www.npmjs.com/package/@crossbind/example-lib-cmake">
-    <img alt="NPM version" src="https://img.shields.io/npm/v/@crossbind/example-lib-cmake?style=for-the-badge" />
+    <img alt="NPM version" src="https://img.shields.io/npm/v/@crossbind/example-lib-cmake/beta?style=for-the-badge" />
 </a>
 <a href="https://github.com/crossbind/crossbind/blob/main/LICENSE">
     <img alt="License" src="https://img.shields.io/github/license/crossbind/crossbind?style=for-the-badge" />
@@ -12,7 +12,7 @@
 Start by installing these package with the following command:
 
 ```sh
-npm install @crossbind/example-lib-cmake
+npm install @crossbind/example-lib-cmake@beta
 ```
 
 To enable the library, modify the crossbind.config.js file as shown below.

package/templates/lib-cmake/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@crossbind/example-lib-cmake",
-  "version": "2.0.0-beta.62",
+  "version": "2.0.0-beta.64",
   "description": "crossbind sample library: simple cmake library",
   "homepage": "https://github.com/crossbind/crossbind/tree/main/examples/lib-cmake#readme",
   "repository": "https://github.com/crossbind/crossbind.git",

package/templates/lib-prebuilt/AGENTS.md

@@ -41,8 +41,11 @@ pnpm --filter=@crossbind/example-lib-prebuilt-matrix run build
 pnpm --filter=@crossbind/example-lib-prebuilt-matrix run build:wasm
 pnpm --filter=@crossbind/example-lib-prebuilt-matrix run build:android
 pnpm --filter=@crossbind/example-lib-prebuilt-matrix run build:ios          # macOS only
+pnpm --filter=@crossbind/example-lib-prebuilt-matrix run build:desktop      # darwin on macOS; linux, linuxmusl, win32 in Docker
 ```
 
+The desktop archives are what `examples/backend-nodejs-native`, `examples/desktop-electron` and `examples/native-executable` link. `build:desktop` also builds the package's own Node-API addons, which `node/napi` loads (`examples/backend-nodejs-standalone`); `node/wasm` and `edge/wasm` load its WebAssembly builds. The release train builds the archives on the runners of their platforms and the addons on its node runners.
+
 `prepublishOnly` runs `crossbind build` so `pnpm publish` always ships fresh artifacts.
 
 ## Common pitfalls

package/templates/lib-prebuilt/README.md

@@ -2,7 +2,7 @@
 **Simple matrix multiplier**  
 
 <a href="https://www.npmjs.com/package/@crossbind/example-lib-prebuilt-matrix">
-    <img alt="NPM version" src="https://img.shields.io/npm/v/@crossbind/example-lib-prebuilt-matrix?style=for-the-badge" />
+    <img alt="NPM version" src="https://img.shields.io/npm/v/@crossbind/example-lib-prebuilt-matrix/beta?style=for-the-badge" />
 </a>
 <a href="https://github.com/crossbind/crossbind/blob/main/LICENSE">
     <img alt="License" src="https://img.shields.io/github/license/crossbind/crossbind?style=for-the-badge" />
@@ -12,7 +12,7 @@
 Start by installing these package with the following command:
 
 ```sh
-npm install @crossbind/example-lib-prebuilt-matrix
+npm install @crossbind/example-lib-prebuilt-matrix@beta
 ```
 
 To enable the library, modify the crossbind.config.js file as shown below.
@@ -58,7 +58,7 @@ console.log(result.get(0));
 
 ### Usage in JavaScript Code (web, without plugin)
 ```js
-import 'node_modules/@crossbind/example-lib-prebuilt-matrix/dist/crossbind-example-lib-prebuilt-matrix.browser.js';
+import 'node_modules/@crossbind/example-lib-prebuilt-matrix/dist/crossbind-example-lib-prebuilt-matrix-wasm-wasm32-st-release.browser.js';
 
 initNative({ path: 'node_modules/@crossbind/example-lib-prebuilt-matrix/dist' }).then(({ Matrix }) => {
     const a = new Matrix(1210000, 1);
@@ -68,14 +68,26 @@ initNative({ path: 'node_modules/@crossbind/example-lib-prebuilt-matrix/dist' })
 });
 ```
 
-### Usage in JavaScript Code (node.js)
+### Usage in JavaScript Code (Node.js)
+The package ships prebuilt Node-API addons for macOS, Linux (glibc and musl) and Windows, and a WebAssembly build for Node.js. Each entry exports `Matrix` once `initNative()` resolves; `require()` of an entry needs Node.js 22.12 or later.
 ```js
-import 'node_modules/@crossbind/example-lib-prebuilt-matrix/dist/crossbind-example-lib-prebuilt-matrix.node.js';
+import { initNative, Matrix } from '@crossbind/example-lib-prebuilt-matrix/node/napi'; // or '/node/wasm'
 
-initNative().then(({ Matrix }) => {
-    const a = new Matrix(1210000, 1);
-    const b = new Matrix(1210000, 2);
-    const result = a.multiple(b);
-    console.log(result.get(0));
-});
+await initNative();
+const a = new Matrix(1210000, 1);
+const b = new Matrix(1210000, 2);
+console.log(a.multiple(b).get(0));
+```
+
+### Usage in JavaScript Code (Cloudflare Workers)
+Wrangler bundles the WebAssembly module the entry imports.
+```js
+import { initNative, Matrix } from '@crossbind/example-lib-prebuilt-matrix/edge/wasm';
+
+export default {
+    async fetch() {
+        await initNative();
+        return new Response(String(new Matrix(4, 2).get(0)));
+    },
+};
 ```

package/templates/lib-prebuilt/edge/wasm

@@ -0,0 +1 @@
+export * from '../dist/edge/wasm.mjs';

package/templates/lib-prebuilt/edge/wasm.d.ts

@@ -0,0 +1 @@
+export * from '../dist/edge/wasm.mjs';

package/templates/lib-prebuilt/node/napi

@@ -0,0 +1 @@
+export * from '../dist/node/napi.mjs';

package/templates/lib-prebuilt/node/napi.d.ts

@@ -0,0 +1 @@
+export * from '../dist/node/napi.mjs';

package/templates/lib-prebuilt/node/wasm

@@ -0,0 +1 @@
+export * from '../dist/node/wasm.mjs';

package/templates/lib-prebuilt/node/wasm.d.ts

@@ -0,0 +1 @@
+export * from '../dist/node/wasm.mjs';

package/templates/lib-prebuilt/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@crossbind/example-lib-prebuilt-matrix",
-  "version": "2.0.0-beta.62",
+  "version": "2.0.0-beta.64",
   "description": "crossbind sample prebuilt library: matrix multiplier",
   "homepage": "https://github.com/crossbind/crossbind/tree/main/examples/lib-prebuilt-matrix#readme",
   "repository": "https://github.com/crossbind/crossbind.git",
@@ -13,22 +13,34 @@
     "build:android": "crossbind build -p android",
     "build:ios": "crossbind build -p ios",
     "build:darwin": "crossbind build -p darwin",
+    "build:desktop": "crossbind build -p darwin,linux,linuxmusl,win32 -e node",
     "clear": "rm -rf .crossbind dist *.xcframework",
     "prepublishOnly": "crossbind build"
   },
   "devDependencies": {
-    "crossbind": "^2.0.0-beta.62"
+    "crossbind": "^2.0.0-beta.64"
   },
   "keywords": [
     "crossbind-sample",
     "matrix",
     "crossbind-sample",
     "webassembly",
-    "react-native"
+    "react-native",
+    "node",
+    "node-api"
   ],
   "types": "./dist/types/index.d.ts",
   "typesVersions": {
     "*": {
+      "node/napi": [
+        "./node/napi.d.ts"
+      ],
+      "node/wasm": [
+        "./node/wasm.d.ts"
+      ],
+      "edge/wasm": [
+        "./edge/wasm.d.ts"
+      ],
       "*.h": [
         "./dist/types/index.d.ts"
       ]

package/templates/lib-source/README.md

@@ -2,7 +2,7 @@
 **crossbind sample library: simple source library**  
 
 <a href="https://www.npmjs.com/package/@crossbind/example-lib-source">
-    <img alt="NPM version" src="https://img.shields.io/npm/v/@crossbind/example-lib-source?style=for-the-badge" />
+    <img alt="NPM version" src="https://img.shields.io/npm/v/@crossbind/example-lib-source/beta?style=for-the-badge" />
 </a>
 <a href="https://github.com/crossbind/crossbind/blob/main/LICENSE">
     <img alt="License" src="https://img.shields.io/github/license/crossbind/crossbind?style=for-the-badge" />
@@ -12,7 +12,7 @@
 Start by installing these package with the following command:
 
 ```sh
-npm install @crossbind/example-lib-source
+npm install @crossbind/example-lib-source@beta
 ```
 
 To enable the library, modify the crossbind.config.js file as shown below.

package/templates/lib-source/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@crossbind/example-lib-source",
-  "version": "2.0.0-beta.62",
+  "version": "2.0.0-beta.64",
   "description": "crossbind sample library: simple source library",
   "homepage": "https://github.com/crossbind/crossbind/tree/main/examples/lib-source#readme",
   "repository": "https://github.com/crossbind/crossbind.git",

package/templates/mobile-reactnative-cli/README.md

@@ -1,9 +1,6 @@
 # @crossbind/example-mobile-reactnative-cli
 **crossbind React Native sample**  
 
-<a href="https://www.npmjs.com/package/@crossbind/example-mobile-reactnative-cli">
-    <img alt="NPM version" src="https://img.shields.io/npm/v/@crossbind/example-mobile-reactnative-cli?style=for-the-badge" />
-</a>
 <a href="https://github.com/crossbind/crossbind/blob/main/LICENSE">
     <img alt="License" src="https://img.shields.io/github/license/crossbind/crossbind?style=for-the-badge" />
 </a>

package/templates/mobile-reactnative-cli/__mocks__/native-header.js

@@ -0,0 +1,5 @@
+// A test renders the app without its native module: the header's exports as the app uses them.
+module.exports = {
+  initNative: () => Promise.resolve(),
+  Native: { sample: () => 'hello' },
+};

package/templates/mobile-reactnative-cli/__tests__/App.test.tsx

@@ -4,7 +4,7 @@
 
 import React from 'react';
 import ReactTestRenderer from 'react-test-renderer';
-import App from '../App';
+import App from '../src/App';
 
 test('renders correctly', async () => {
   await ReactTestRenderer.act(() => {

package/templates/mobile-reactnative-cli/ci/crossbind-snapshot/cache.json

@@ -1,7 +1,7 @@
 {
     "hashes": {
-        "/Users/runner/work/crossbind/crossbind/examples/mobile-reactnative-cli/src/native/native.h": "swig-macros-1\nd105082c6e8c8652ea461e161c501e824b6b625f7b819490102c5c0699744249\nconstants:Native",
-        "/Users/runner/work/crossbind/crossbind/examples/mobile-reactnative-cli/.crossbind/build/interface/native.i": "swig-constants-1\nd2951a720fdd54191e27157df067c64d7d7839b41c14494d63aef4f3a4eae3a2\nd105082c6e8c8652ea461e161c501e824b6b625f7b819490102c5c0699744249"
+        "/Users/runner/work/crossbind/crossbind/examples/mobile-reactnative-cli/src/native/native.h": "swig-macros-4\nd105082c6e8c8652ea461e161c501e824b6b625f7b819490102c5c0699744249\nconstants:Native\nnamed:Native",
+        "/Users/runner/work/crossbind/crossbind/examples/mobile-reactnative-cli/.crossbind/build/interface/native.i": "swig-extras-2\nd2951a720fdd54191e27157df067c64d7d7839b41c14494d63aef4f3a4eae3a2\nd105082c6e8c8652ea461e161c501e824b6b625f7b819490102c5c0699744249\nnamed:Native"
     },
     "interfaces": {
         "/Users/runner/work/crossbind/crossbind/examples/mobile-reactnative-cli/src/native/native.h": "/Users/runner/work/crossbind/crossbind/examples/mobile-reactnative-cli/.crossbind/build/interface/native.i"
@@ -9,4 +9,4 @@
     "bridges": {
         "/Users/runner/work/crossbind/crossbind/examples/mobile-reactnative-cli/.crossbind/build/interface/native.i": "/Users/runner/work/crossbind/crossbind/examples/mobile-reactnative-cli/.crossbind/build/bridge/native.i.cpp"
     }
-}
+}

package/templates/mobile-reactnative-cli/jest.config.js

@@ -1,3 +1,6 @@
 module.exports = {
   preset: '@react-native/jest-preset',
+  // pnpm keeps packages under node_modules/.pnpm, which the preset's pattern does not look past.
+  transformIgnorePatterns: ['node_modules/(?!(\\.pnpm|(jest-)?react-native|@react-native(-community)?)/)'],
+  moduleNameMapper: { '\\.h$': '<rootDir>/__mocks__/native-header.js' },
 };

package/templates/mobile-reactnative-cli/package.json

@@ -20,14 +20,14 @@
     "e2e:android": "pnpm run run:android && pnpm run maestro:android"
   },
   "dependencies": {
-    "@crossbind/core-embind-jsi": "^2.0.0-beta.62",
-    "@crossbind/plugin-react-native": "^2.0.0-beta.62",
-    "@crossbind/plugin-react-native-ios-helper": "^2.0.0-beta.62",
-    "@crossbind/example-lib-prebuilt-matrix": "^2.0.0-beta.62",
+    "@crossbind/core-embind-jsi": "^2.0.0-beta.64",
+    "@crossbind/plugin-react-native": "^2.0.0-beta.64",
+    "@crossbind/plugin-react-native-ios-helper": "^2.0.0-beta.64",
+    "@crossbind/example-lib-prebuilt-matrix": "^2.0.0-beta.64",
     "react": "19.3.0",
     "react-native": "0.87.1",
     "react-native-safe-area-context": "^5.8.0",
-    "hermes-compiler": "*"
+    "hermes-compiler": "250829098.0.17"
   },
   "devDependencies": {
     "@babel/core": "^7.29.7",
@@ -48,10 +48,10 @@
     "@types/react-test-renderer": "^19.3.0",
     "eslint": "^8.19.0",
     "jest": "^29.6.3",
-    "prettier": "3.9.8",
+    "prettier": "3.9.10",
     "react-test-renderer": "19.3.0",
-    "typescript": "^5.8.3",
-    "@crossbind/plugin-metro": "^2.0.0-beta.62"
+    "typescript": "^6.0.3",
+    "@crossbind/plugin-metro": "^2.0.0-beta.64"
   },
   "engines": {
     "node": ">=24"

package/templates/mobile-reactnative-expo/README.md

@@ -1,9 +1,6 @@
 # @crossbind/example-mobile-reactnative-expo
 **crossbind Expo sample**  
 
-<a href="https://www.npmjs.com/package/@crossbind/example-mobile-reactnative-expo">
-    <img alt="NPM version" src="https://img.shields.io/npm/v/@crossbind/example-mobile-reactnative-expo?style=for-the-badge" />
-</a>
 <a href="https://github.com/crossbind/crossbind/blob/main/LICENSE">
     <img alt="License" src="https://img.shields.io/github/license/crossbind/crossbind?style=for-the-badge" />
 </a>
@@ -32,3 +29,15 @@
    ```bash
     npm run android
    ```
+
+4. Start the web app (the C++ runs as WebAssembly)
+
+   ```bash
+    npm run web
+   ```
+
+5. Export the web app to `dist`
+
+   ```bash
+    npm run export:web
+   ```