@crossbind/example-lib-prebuilt-matrix 2.0.0-beta.62 → 2.0.0-beta.63

package/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/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.
@@ -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)));
+    },
+};
 ```