@crossbind/example-lib-prebuilt-matrix 2.0.0-beta.50

package/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/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/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Buğra Sarı and crossbind contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/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/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/crossbind-example-lib-prebuilt-matrix.xcframework/Info.plist

@@ -0,0 +1,47 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+	<key>AvailableLibraries</key>
+	<array>
+		<dict>
+			<key>BinaryPath</key>
+			<string>libcrossbind-example-lib-prebuilt-matrix.a</string>
+			<key>HeadersPath</key>
+			<string>Headers</string>
+			<key>LibraryIdentifier</key>
+			<string>ios-arm64</string>
+			<key>LibraryPath</key>
+			<string>libcrossbind-example-lib-prebuilt-matrix.a</string>
+			<key>SupportedArchitectures</key>
+			<array>
+				<string>arm64</string>
+			</array>
+			<key>SupportedPlatform</key>
+			<string>ios</string>
+		</dict>
+		<dict>
+			<key>BinaryPath</key>
+			<string>libcrossbind-example-lib-prebuilt-matrix.a</string>
+			<key>HeadersPath</key>
+			<string>Headers</string>
+			<key>LibraryIdentifier</key>
+			<string>ios-arm64-simulator</string>
+			<key>LibraryPath</key>
+			<string>libcrossbind-example-lib-prebuilt-matrix.a</string>
+			<key>SupportedArchitectures</key>
+			<array>
+				<string>arm64</string>
+			</array>
+			<key>SupportedPlatform</key>
+			<string>ios</string>
+			<key>SupportedPlatformVariant</key>
+			<string>simulator</string>
+		</dict>
+	</array>
+	<key>CFBundlePackageType</key>
+	<string>XFWK</string>
+	<key>XCFrameworkFormatVersion</key>
+	<string>1.0</string>
+</dict>
+</plist>

package/crossbind-example-lib-prebuilt-matrix.xcframework/ios-arm64/Headers/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/crossbind-example-lib-prebuilt-matrix.xcframework/ios-arm64-simulator/Headers/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/crossbind.config.js

@@ -0,0 +1,14 @@
+export default {
+    general: {
+        name: 'crossbind-example-lib-prebuilt-matrix',
+    },
+    types: true,
+    export: {
+        type: 'cmake',
+    },
+    paths: {
+        config: import.meta.url,
+        base: '../..', /* Delete this line for create-crossbind */
+        output: 'dist',
+    },
+};