create-crossbind 2.0.0-beta.50

package/templates/cloud-cloudflare-worker/playwright.dev.config.cjs

@@ -0,0 +1,48 @@
+// @ts-check
+const { defineConfig, devices } = require('@playwright/test');
+
+/**
+ * @see https://playwright.dev/docs/test-configuration
+ */
+module.exports = defineConfig({
+  testDir: './e2e',
+  timeout: 30 * 1000,
+  expect: {
+    timeout: 50000,
+  },
+  fullyParallel: true,
+  forbidOnly: !!process.env.CI,
+  retries: process.env.CI ? 2 : 0,
+  workers: process.env.CI ? 1 : undefined,
+
+  reporter: 'html',
+
+  use: {
+    baseURL: 'http://localhost:8787',
+    trace: 'on-first-retry',
+  },
+
+  projects: [
+    {
+      name: 'chromium',
+      use: { ...devices['Desktop Chrome'] },
+    },
+
+    {
+      name: 'firefox',
+      use: { ...devices['Desktop Firefox'] },
+    },
+
+    {
+      name: 'webkit',
+      use: { ...devices['Desktop Safari'] },
+    },
+  ],
+
+  /* Run your local dev server before starting the tests */
+  webServer: {
+    command: 'pnpm run dev',
+    url: 'http://localhost:8787',
+    reuseExistingServer: !process.env.CI,
+  },
+});

package/templates/cloud-cloudflare-worker/src/native/native.cpp

@@ -0,0 +1,5 @@
+#include "native.h"
+
+std::string Native::sample() {
+    return "Hello World, greetings from c++.";
+}

package/templates/cloud-cloudflare-worker/src/native/native.h

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

package/templates/cloud-cloudflare-worker/wrangler.toml

@@ -0,0 +1,3 @@
+name = "crossbind"
+main = "index.js"
+compatibility_date = "2024-09-08"

package/templates/lib-cmake/CHANGELOG.md

@@ -0,0 +1,20 @@
+# @crossbind/example-lib-cmake
+
+## 2.0.0-beta.50
+
+### Patch Changes
+
+- Aligned on the 2.0.0-beta.50 baseline. No source change; the version exists so every package in
+  the workspace names the same release.
+
+## 1.0.0
+
+### Major Changes
+
+- 🚀 first stable release
+
+## 1.0.0-beta.6
+
+### Patch Changes
+
+- chore: add initial version of CHANGELOGS files

package/templates/lib-cmake/CMakeLists.txt

@@ -0,0 +1,16 @@
+cmake_minimum_required(VERSION 3.28)
+set(CMAKE_CXX_STANDARD 11)
+
+# The consuming crossbind build adds this file with add_subdirectory and links the library by
+# the name it passes in as CROSSBIND_LIB_NAME; PUBLIC includes only propagate to the app when
+# the target carries exactly that name.
+if(NOT DEFINED CROSSBIND_LIB_NAME)
+    set(CROSSBIND_LIB_NAME crossbind-lib-samplebasiccmake-wasm)
+endif()
+project(${CROSSBIND_LIB_NAME})
+
+add_library(${CROSSBIND_LIB_NAME} STATIC ${CMAKE_CURRENT_SOURCE_DIR}/src/native/samplebasiccmake.cpp)
+
+target_include_directories(${CROSSBIND_LIB_NAME} PUBLIC
+    ${CMAKE_CURRENT_SOURCE_DIR}/src/native
+)

package/templates/lib-cmake/README.md

@@ -0,0 +1,51 @@
+# @crossbind/example-lib-cmake
+**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" />
+</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>
+
+## Integration
+Start by installing these package with the following command:
+
+```sh
+npm install @crossbind/example-lib-cmake
+```
+
+To enable the library, modify the crossbind.config.js file as shown below.
+```diff
++import cmakeSample from '@crossbind/example-lib-cmake/crossbind.config.js';
+
+export default {
+    dependencies: [
++        cmakeSample
+    ]
+    paths: {
+        config: import.meta.url,
+    },
+};
+```
+
+## Usage
+Below are the steps to use the library in your C++ or JavaScript code.
+
+### Usage in C++ Code
+```diff
++#include <crossbind-lib-samplebasic-cmake/samplebasiccmake.h>
+
+std::string Native::sample() {
++    return SampleBasicCmake::sample();
+}
+
+```
+
+### Usage in JavaScript Code (web, with plugin)
+```js
+import { initNative, SampleBasicCmake } from '@crossbind/example-lib-cmake/crossbind-lib-samplebasic-cmake/samplebasiccmake.h';
+
+await initNative();
+console.log(SampleBasicCmake.sample());
+```

package/templates/lib-cmake/crossbind.config.js

@@ -0,0 +1,9 @@
+export default {
+    export: {
+        type: 'cmake',
+    },
+    paths: {
+        config: import.meta.url,
+        output: '.',
+    },
+};

package/templates/lib-cmake/package.json

@@ -0,0 +1,16 @@
+{
+  "name": "@crossbind/example-lib-cmake",
+  "version": "2.0.0-beta.50",
+  "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",
+  "license": "MIT",
+  "type": "module",
+  "keywords": [
+    "crossbind-sample",
+    "cmake",
+    "crossbind-sample",
+    "webassembly",
+    "react-native"
+  ]
+}

package/templates/lib-cmake/src/native/crossbind-lib-samplebasic-cmake/samplebasiccmake.h

@@ -0,0 +1,11 @@
+#ifndef _SAMPLE_BASIC_CMAKE_H
+#define _SAMPLE_BASIC_CMAKE_H
+
+#include <string>
+
+class SampleBasicCmake {
+public:
+    static std::string sample();
+};
+
+#endif

package/templates/lib-cmake/src/native/samplebasiccmake.cpp

@@ -0,0 +1,5 @@
+#include "crossbind-lib-samplebasic-cmake/samplebasiccmake.h"
+
+std::string SampleBasicCmake::sample() {
+    return "this message comes from basic cmake sample lib";
+}

package/templates/lib-prebuilt/AGENTS.md

@@ -0,0 +1,78 @@
+# AGENTS.md — @crossbind/example-lib-prebuilt-matrix
+
+> Canonical minimal **C++ library packaging** reference. This is what `docs/playbooks/new-package.md` (Persona 3) and most other samples point at when they need a small `@crossbind/port-*`-shaped consumable.
+
+## What this sample is for
+
+- Smallest possible working example of "I have a tiny C++ project, package it for crossbind so other samples / RN apps / web apps can consume it."
+- Used by `examples/mobile-reactnative-cli`, `examples/backend-nodejs-wasm`, and a few playgrounds as their dependency.
+- Reference for `crossbind.config.js` shape with `export.type: 'cmake'`.
+
+## Layout
+
+```
+examples/lib-prebuilt-matrix/
+├── src/                                  ← C++ source (matrix multiplier)
+├── playground/                           ← optional standalone test
+├── crossbind.config.js                       ← export.type cmake, base + output paths
+├── examples/lib-prebuilt-matrix.podspec   ← iOS package manifest
+├── examples/lib-prebuilt-matrix.xcframework  ← prebuilt iOS slices
+├── dist/                                 ← built artifacts (committed for prebuilt consumption)
+├── package.json
+└── README.md
+```
+
+`dist/prebuilt/<target>/{lib,include}` is **committed** so consumers can `pnpm add @crossbind/example-lib-prebuilt-matrix` and link without rebuilding.
+
+## Why a sample, not a real crossbind-package
+
+Two reasons:
+1. The matrix-multiplier C++ is too small to justify a full `ports/*` family; sample status keeps the surface light.
+2. Demonstrates the inline alternative to packaging: the user's own C++ wrapped in a `crossbind.config.js` and exported as a workspace dep.
+
+If you're looking at how a real prebuilt package is shaped, see `ports/zlib/` instead — that's the canonical for new `ports/*`.
+
+## Build matrix
+
+```bash
+# Everything (default)
+pnpm --filter=@crossbind/example-lib-prebuilt-matrix run build
+
+# Per-platform
+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
+```
+
+`prepublishOnly` runs `crossbind build` so `pnpm publish` always ships fresh artifacts.
+
+## Common pitfalls
+
+- **Treating this as a `ports/` template.** It's a sample first; for real package authoring follow `docs/playbooks/new-package.md` and mirror `ports/zlib/`.
+- **Deleting committed `dist/prebuilt/`.** Consumers (`examples/mobile-reactnative-cli`, etc.) link against these artifacts. Rebuild + recommit if you change the C++.
+- **Forgetting `prepublishOnly`.** Without it, npm could publish a stale `dist/`. The script is the safety net.
+- **Adding a heavy native dep** (e.g. another package). Defeats the "smallest possible" purpose. Keep it tiny.
+- **Wrapping with extra plugins** (Metro, Vite, etc.). The sample is plugin-free; consumers add their own plugins.
+
+## Validation
+
+```bash
+# Build
+pnpm --filter=@crossbind/example-lib-prebuilt-matrix run build
+
+# Verify prebuilt artifacts
+pnpm run check:dist | grep sample-lib-prebuilt-matrix
+
+# Smoke a downstream consumer
+pnpm --filter=@crossbind/example-backend-nodejs-wasm run build
+node examples/backend-nodejs-wasm/src/index.js
+```
+
+## Reference
+
+- Package author playbook (the real flow for `ports/*`): `docs/playbooks/new-package.md`
+- Real-package canonical template: `ports/zlib/`
+- Downstream consumers of this sample:
+  - `examples/mobile-reactnative-cli/`
+  - `examples/mobile-reactnative-expo/`
+  - `examples/backend-nodejs-wasm/`

package/templates/lib-prebuilt/CHANGELOG.md

@@ -0,0 +1,20 @@
+# @crossbind/example-lib-prebuilt-matrix
+
+## 2.0.0-beta.50
+
+### Patch Changes
+
+- Aligned on the 2.0.0-beta.50 baseline. No source change; the version exists so every package in
+  the workspace names the same release.
+
+## 1.0.0
+
+### Major Changes
+
+- 🚀 first stable release
+
+## 1.0.0-beta.32
+
+### Patch Changes
+
+- chore: add initial version of CHANGELOGS files

package/templates/lib-prebuilt/README.md

@@ -0,0 +1,81 @@
+# @crossbind/example-lib-prebuilt-matrix
+**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" />
+</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>
+
+## Integration
+Start by installing these package with the following command:
+
+```sh
+npm install @crossbind/example-lib-prebuilt-matrix
+```
+
+To enable the library, modify the crossbind.config.js file as shown below.
+```diff
++import matrix from '@crossbind/example-lib-prebuilt-matrix/crossbind.config.js';
+
+export default {
+    dependencies: [
++        matrix
+    ]
+    paths: {
+        config: import.meta.url,
+    },
+};
+```
+
+## Usage
+Below are the steps to use the Simple Matrix Multiplier in your C++ or JavaScript code.
+
+### Usage in C++ Code
+```diff
++#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₃";
+}
+
+```
+
+### Usage in JavaScript Code (web, with plugin)
+```js
+import { initNative, Matrix } from '@crossbind/example-lib-prebuilt-matrix/Matrix.h';
+
+await initNative();
+const a = new Matrix(1210000, 1);
+const b = new Matrix(1210000, 2);
+const result = a.multiple(b);
+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';
+
+initNative({ path: 'node_modules/@crossbind/example-lib-prebuilt-matrix/dist' }).then(({ Matrix }) => {
+    const a = new Matrix(1210000, 1);
+    const b = new Matrix(1210000, 2);
+    const result = a.multiple(b);
+    console.log(result.get(0));
+});
+```
+
+### Usage in JavaScript Code (node.js)
+```js
+import 'node_modules/@crossbind/example-lib-prebuilt-matrix/dist/crossbind-example-lib-prebuilt-matrix.node.js';
+
+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));
+});
+```

package/templates/lib-prebuilt/crossbind-example-lib-prebuilt-matrix.podspec

@@ -0,0 +1,21 @@
+require "json"
+package = JSON.parse(File.read(File.join(__dir__, "package.json")))
+
+Pod::Spec.new do |s|
+  s.module_name  = "MatrixMultiplier"
+  s.name         = "crossbind-example-lib-prebuilt-matrix"
+  s.version      = package["version"]
+  s.summary      = package["description"]
+  s.homepage     = package["homepage"]
+  s.license      = package["license"]
+  s.author       = "crossbind Authors"
+  s.source       = { :http => "https://crossbind.dev" }
+
+  s.vendored_frameworks = 'crossbind-example-lib-prebuilt-matrix.xcframework'
+  # arm64-only iOS simulator slice; drop x86_64 on both pod and consumer targets.
+  # pod_target_xcconfig is required so CocoaPods' [CP] Copy XCFrameworks slice selector
+  # (which reads $ARCHS in the pod target's context) matches ios-arm64-simulator instead
+  # of silently warning and skipping the copy, which would leave the .a missing at link time.
+  s.pod_target_xcconfig  = { 'EXCLUDED_ARCHS[sdk=iphonesimulator*]' => 'x86_64' }
+  s.user_target_xcconfig = { 'EXCLUDED_ARCHS[sdk=iphonesimulator*]' => 'x86_64' }
+end

package/templates/lib-prebuilt/crossbind.config.js

@@ -0,0 +1,13 @@
+export default {
+    general: {
+        name: 'crossbind-example-lib-prebuilt-matrix',
+    },
+    types: true,
+    export: {
+        type: 'cmake',
+    },
+    paths: {
+        config: import.meta.url,
+        output: 'dist',
+    },
+};

package/templates/lib-prebuilt/package.json

@@ -0,0 +1,36 @@
+{
+  "name": "@crossbind/example-lib-prebuilt-matrix",
+  "version": "2.0.0-beta.50",
+  "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",
+  "license": "MIT",
+  "type": "module",
+  "scripts": {
+    "build": "crossbind build",
+    "builda": "crossbind build -p wasm -p android",
+    "build:wasm": "crossbind build -p wasm",
+    "build:android": "crossbind build -p android",
+    "build:ios": "crossbind build -p ios",
+    "clear": "rm -rf .crossbind dist *.xcframework",
+    "prepublishOnly": "crossbind build"
+  },
+  "devDependencies": {
+    "crossbind": "^2.0.0-beta.51"
+  },
+  "keywords": [
+    "crossbind-sample",
+    "matrix",
+    "crossbind-sample",
+    "webassembly",
+    "react-native"
+  ],
+  "types": "./dist/types/index.d.ts",
+  "typesVersions": {
+    "*": {
+      "*.h": [
+        "./dist/types/index.d.ts"
+      ]
+    }
+  }
+}

package/templates/lib-prebuilt/playground/Matrix.js

@@ -0,0 +1,19 @@
+class Matrix extends Array {
+    constructor(size, initValue) { super(size); this.fill(initValue); }
+
+    get(i) { return this[i]; }
+
+    multiple(otherMatrix) {
+        const size = Math.sqrt(this.length);
+        const result = new Matrix(this.length, 0);
+
+        for (let i = 0; i < size; i += 1) {
+            for (let j = 0; j < size; j += 1) {
+                for (let k = 0; k < size; k += 1) {
+                    result[i * size + j] += this[i * size + k] * otherMatrix[k * size + j];
+                }
+            }
+        }
+        return result;
+    }
+}

package/templates/lib-prebuilt/playground/index.html

@@ -0,0 +1,74 @@
+<!DOCTYPE html>
+
+<html>
+   <head>
+      <meta charset = "utf-8">
+      <title>C++ Matrix Multiplier</title>
+      <script src="./Matrix.js"></script>
+      <script type="module">
+        import '../dist/crossbind-example-lib-prebuilt-matrix.browser.js';
+        let wasmModule;
+        initNative();
+        const SIZE = Math.pow(1100, 2);
+
+
+        async function init () {
+            wasmModule = await initNative({ path: '../dist' });
+            new wasmModule.Matrix(10, 0);
+            toggleVisible(true);
+        }
+
+        function runCore(type) {
+            const MatrixClass = type === 'wasm' ? wasmModule.Matrix : Matrix;
+            const a = new MatrixClass(SIZE, 1);
+            const b = new MatrixClass(SIZE, 2);
+
+            const startTime = new Date();
+            const result = a.multiple(b);
+
+            writeResult(type, result.get(0), ((new Date()) - startTime) / 1000);
+        }
+        function run(type) {
+            toggleVisible(false);
+            setTimeout(() => runCore(type), 200);
+            setTimeout(() => toggleVisible(true), 200);
+        }
+        function writeResult(type, result, duration) {
+            document.querySelector(`#${type}-result`).innerHTML = result;
+            document.querySelector(`#${type}-duration`).innerHTML = duration;
+        }
+        function toggleVisible(visible) {
+            document.querySelector('#loading').style.display = visible ? "none" : "block";
+            document.querySelector('main').style.display = visible ? "block" : "none";
+        }
+        window.run = run;
+      </script>
+      <style>
+        body {
+            padding: 50px;
+        }
+        table, th, td {
+            border: 1px solid red;
+            border-collapse: collapse;
+        }
+        table {
+            width: 400px;
+            margin-top: 20px;
+        }
+      </style>
+   </head>
+   <body>
+    <div id="loading">Loading ...</div>
+    <main style="display: none;">
+        <div>
+            <button type="button" onclick="run('js')">Calculate using JS</button>
+            <button type="button" onclick="run('wasm')">Calculate using WASM</button>
+        </div>
+        <table>
+            <tr><td>Type</td><td>result[0]</td><td>Duration (s)</td></tr>
+            <tr><td>JS</td><td id="js-result"></td><td id="js-duration"></td></tr>
+            <tr><td>WASM</td><td id="wasm-result"></td><td id="wasm-duration"></td></tr>
+        </table>
+    </main>
+   </body>
+</html>

package/templates/lib-prebuilt/src/native/Matrix.cpp

@@ -0,0 +1,17 @@
+#include "Matrix.h"
+
+int Matrix::get(int i) { return this->at(i); }
+
+std::shared_ptr<Matrix> Matrix::multiple(std::shared_ptr<Matrix> b) {
+    int size = sqrt(this->size());
+    auto result = std::make_shared<Matrix>(this->size(), 0);
+
+    for (int i = 0; i < size; i += 1) {
+        for (int j = 0; j < size; j += 1) {
+            for (int k = 0; k < size; k += 1) {
+                (*result)[i * size + j] += this->at(i * size + k) * (*b)[k * size + j];
+            }
+        }
+    }
+    return result;
+}

package/templates/lib-prebuilt/src/native/Matrix.h

@@ -0,0 +1,12 @@
+#pragma once
+
+#include <vector>
+#include <memory>
+#include <cmath>
+
+class Matrix : public std::vector<int> {
+public:
+    Matrix(int size, int initValue) : std::vector<int>(size, initValue) {}
+    int get(int i);
+    std::shared_ptr<Matrix> multiple(std::shared_ptr<Matrix> b);
+};

package/templates/lib-source/CHANGELOG.md

@@ -0,0 +1,20 @@
+# @crossbind/example-lib-source
+
+## 2.0.0-beta.50
+
+### Patch Changes
+
+- Aligned on the 2.0.0-beta.50 baseline. No source change; the version exists so every package in
+  the workspace names the same release.
+
+## 1.0.0
+
+### Major Changes
+
+- 🚀 first stable release
+
+## 1.0.0-beta.5
+
+### Patch Changes
+
+- chore: add initial version of CHANGELOGS files

package/templates/lib-source/README.md

@@ -0,0 +1,51 @@
+# @crossbind/example-lib-source
+**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" />
+</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>
+
+## Integration
+Start by installing these package with the following command:
+
+```sh
+npm install @crossbind/example-lib-source
+```
+
+To enable the library, modify the crossbind.config.js file as shown below.
+```diff
++import sourceSample from '@crossbind/example-lib-source/crossbind.config.js';
+
+export default {
+    dependencies: [
++        sourceSample
+    ]
+    paths: {
+        config: import.meta.url,
+    },
+};
+```
+
+## Usage
+Below are the steps to use the library in your C++ or JavaScript code.
+
+### Usage in C++ Code
+```diff
++#include <crossbind-lib-samplebasic/samplebasic.h>
+
+std::string Native::sample() {
++    return SampleBasic::sample();
+}
+
+```
+
+### Usage in JavaScript Code (web, with plugin)
+```js
+import { initNative, SampleBasic } from '@crossbind/example-lib-source/crossbind-lib-samplebasic/samplebasic.h';
+
+await initNative();
+console.log(SampleBasic.sample());
+```

package/templates/lib-source/crossbind.config.js

@@ -0,0 +1,8 @@
+export default {
+    export: {
+        type: 'source',
+    },
+    paths: {
+        config: import.meta.url,
+    },
+};