@crossbind/plugin-rollup 2.0.0-beta.50

package/AGENTS.md

@@ -0,0 +1,57 @@
+# AGENTS.md — @crossbind/plugin-rollup
+
+> Standalone Rollup plugin **and** the inner kernel of `@crossbind/plugin-vite`. Bundler-agnostic logic lives here; bundler-specific glue (Vite dev server, etc.) lives one level up.
+
+## What lives here
+
+- `index.js` — single file, exports `rollupCrossbindPlugin(options, bridges)` factory. The `bridges` array is shared by the Vite outer plugin so both can append to one accumulating list per project.
+
+## Hooks the plugin implements
+
+| Rollup hook | What it does |
+|-------------|--------------|
+| `resolveId('crossbind')` | Mark the crossbind loader as `external: true` so consumers fetch it at runtime, not bundle it |
+| `transform(code, '.h')` | Run SWIG bridge generation; emit JS bridge code for the header |
+| `buildStart` | Iterate `state.config.paths.native` array; `addWatchFile` every entry. Watch mode now sees `.cpp`/`.h` edits |
+| `generateBundle` | Run `createLib + createXCFramework + buildWasm` with `force = isSourceNewer(...)`; emit `crossbind.js`, `crossbind.wasm`, `crossbind.data.txt` as bundle assets |
+
+## Invariants
+
+- **`paths.native` is an array.** The outer Vite plugin assumed this years ago; this plugin must too. `existsSync(array)` returns false silently — always iterate entries before testing each one.
+- **`force = isSourceNewer(buildTargetRelease)`** in `generateBundle`. Skips rebuild when artifacts are newer than every native source; bypasses cache when not.
+- **`bridges` accumulates across `transform` calls.** Don't reset; downstream `generateBundle` reads the union.
+
+## Common pitfalls
+
+- **Forgetting to call `addWatchFile` per native dir.** Watch mode silently skips edits → users think `pnpm rollup -w` is broken.
+- **Returning `external: true` for `crossbind` in some configs and `false` in others.** Inconsistency makes Vite's HMR vs prod build behave differently.
+- **Emitting `crossbind.js`/`crossbind.wasm` to a custom path.** Consumers (including Vite) expect `crossbind.js`, `crossbind.wasm`, `crossbind.data.txt` at the bundle root. Don't rename without updating the loader.
+- **Re-running `buildWasm` without `force` semantics.** Cache-shortcut bugs land here; always go through `isSourceNewer`.
+- **Calling `state.config.paths.cli/...` directly with hardcoded sub-paths.** Use the public `crossbind` exports (`createLib`, `buildWasm`, `getCrossbindScript`, …); they survive asset reorgs.
+
+## Validation
+
+Touching this plugin propagates to:
+
+- `plugins/vite` (wraps it) — all Vite samples must keep working.
+- Anyone using rollup standalone (rare).
+
+Strict gate:
+
+```bash
+pnpm run ci:linux:build && pnpm run e2e:dev && pnpm run e2e:prod
+```
+
+Targeted Vite smoke (since this plugin's biggest consumer is `plugin-vite`):
+
+```bash
+pnpm --filter=@crossbind/example-web-vue-vite run build
+pnpm --filter=@crossbind/e2e-web-vite-multithread run build
+```
+
+## Reference
+
+- Outer Vite wrapper: `plugins/vite/`
+- Standalone integration recipe: `docs/playbooks/integration/rollup.md`
+- Vite integration recipe: `docs/playbooks/integration/vite.md`
+- Force-rebuild trigger: `core/crossbind/src/actions/isSourceNewer.js`

package/CHANGELOG.md

@@ -0,0 +1,35 @@
+# @crossbind/plugin-rollup
+
+## 2.0.0-beta.50
+
+### Patch Changes
+
+- A cargo dependency no longer has to be built by hand before the app. The dependency step this
+  plugin already awaits builds one whose target is missing, and refuses to link one it could not
+  build — on wasm that case used to pass silently and leave a module that died at init.
+
+## 1.0.2
+
+### Patch Changes
+
+- Updated dependencies
+  - crossbind@1.0.4
+
+## 1.0.0
+
+### Major Changes
+
+- 🚀 first stable release
+
+### Patch Changes
+
+- Updated dependencies
+  - crossbind@1.0.0
+
+## 1.0.0-beta.9
+
+### Patch Changes
+
+- chore: add initial version of CHANGELOGS files
+- Updated dependencies
+  - crossbind@1.0.0-beta.33

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,35 @@
+# @crossbind/plugin-rollup
+**crossbind Rollup plugin**  
+A tool for seamless C++ integration with the Rollup bundler.
+
+<a href="https://www.npmjs.com/package/@crossbind/plugin-rollup">
+    <img alt="NPM version" src="https://img.shields.io/npm/v/@crossbind/plugin-rollup?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>
+<a href="https://crossbind.dev/docs/guide/integrate-into-existing-project/rollup">
+    <img alt="Docs - React Native" src="https://img.shields.io/badge/Docs_-_Rollup-20B2AA?style=for-the-badge" />
+</a>
+
+## Integration
+To integrate crossbind into your project using Rollup as a bundler, you can utilize the @crossbind/plugin-rollup plugin. Start by installing these package with the following command:
+
+```sh
+npm install @crossbind/plugin-rollup --save-dev
+```
+
+To enable the plugin, modify the `vite.config.js` file as shown below.
+
+```diff
+import { defineConfig } from 'vite'
+import vue from '@vitejs/plugin-vue'
++ import rollupCrossbindPlugin from '@crossbind/plugin-rollup'
+
+// https://vitejs.dev/config/
+export default defineConfig({
+  plugins: [
++   rollupCrossbindPlugin(),
+  ]
+});
+```

package/index.js

@@ -0,0 +1,121 @@
+
+
+import {
+    state, createLib, createBridgeFile, buildWasm, getCrossbindScript, getRustJsScript, buildDependencies,
+    getDependFilePath, getTargetParams, getFilteredBuildTargets, isSourceNewer,
+} from 'crossbind';
+
+import fs from 'node:fs';
+import p from 'node:path';
+
+const targetParams = getTargetParams({ platform: ['wasm'], arch: ['wasm32'], runtime: ['st'], runtimeEnv: ['browser'] }, true);
+let buildTargetRelease = getFilteredBuildTargets(targetParams, { buildType: 'release' })?.[0];
+let buildTargetDebug = getFilteredBuildTargets(targetParams, { buildType: 'debug' })?.[0];
+
+if (!buildTargetRelease && !buildTargetDebug) {
+    throw new Error('No build targets found');
+}
+
+if (!buildTargetRelease) {
+    buildTargetRelease = buildTargetDebug;
+}
+
+const rollupCrossbindPlugin = (options, bridges = []) => {
+    const headerRegex = new RegExp(`\\.(${state.config.ext.header.join('|')})$`);
+    const moduleRegex = new RegExp(`\\.(${state.config.ext.module.join('|')})$`);
+
+    return {
+        name: 'rollup-plugin-crossbind',
+        resolveId(source) {
+            if (source === '/crossbind.js') {
+                return { id: source, external: true };
+            }
+            const dependFilePath = getDependFilePath(source, buildTargetRelease);
+            if (dependFilePath) {
+                return dependFilePath;
+            }
+
+            return null;
+        },
+        async transform(code, path) {
+            // Rust surfaces need no bridge file here: the native bridge is the package's
+            // generated companion crate (or the app-local synthesized crate); this only emits
+            // the JS proxy module - the same shape as the .h flow.
+            if (path.endsWith('.rs')) {
+                return getRustJsScript(buildTargetRelease, path);
+            }
+            if (!headerRegex.test(path) && !moduleRegex.test(path)) {
+                return null;
+            }
+
+            const bridgeFile = createBridgeFile(path);
+            bridges.push(bridgeFile);
+
+            return getCrossbindScript(buildTargetRelease, bridgeFile);
+        },
+        buildStart() {
+            const watch = (dirs) => {
+                dirs.forEach((dir) => {
+                    const filesToWatch = fs.readdirSync(dir);
+
+                    for (const file of filesToWatch) {
+                        const fullPath = p.join(dir, file);
+                        const stats = fs.statSync(fullPath);
+
+                        if (stats.isFile()) {
+                            this.addWatchFile(fullPath);
+                        } else if (stats.isDirectory()) {
+                            watch([fullPath]);
+                        }
+                    }
+                });
+            };
+
+            state.config.paths.native.forEach((dir) => {
+                if (fs.existsSync(dir)) {
+                    watch([dir]);
+                }
+            });
+        },
+        async generateBundle() {
+            await buildDependencies({ targetParams: { ...targetParams, buildType: [buildTargetRelease.buildType] } });
+            const force = isSourceNewer(buildTargetRelease);
+            const sourceBuilt = createLib(buildTargetRelease, 'Source', { force, buildSource: true });
+            // Bridge cache is keyed on the nativeGlob fingerprint: adding or
+            // removing a .h import rebuilds the bridge lib even when no source
+            // file changed, and a rebuilt lib must force the final link too.
+            const bridgeBuilt = createLib(buildTargetRelease, 'Bridge', { force, buildSource: false, nativeGlob: [`${state.config.paths.cli}/assets/cpp-runtime/commonBridges.cpp`, ...bridges] });
+            await buildWasm(buildTargetRelease, { force: force || Boolean(sourceBuilt) || Boolean(bridgeBuilt) });
+
+            this.emitFile({
+                type: 'asset',
+                source: fs.readFileSync(`${state.config.paths.build}/${buildTargetRelease.jsName}`),
+                fileName: 'crossbind.js',
+            });
+
+            this.emitFile({
+                type: 'asset',
+                source: fs.readFileSync(`${state.config.paths.build}/${buildTargetRelease.wasmName}`),
+                fileName: 'crossbind.wasm',
+            });
+            const dataFilePath = `${state.config.paths.build}/${buildTargetRelease.dataTxtName}`;
+            if (fs.existsSync(dataFilePath)) {
+                this.emitFile({
+                    type: 'asset',
+                    source: fs.readFileSync(dataFilePath),
+                    fileName: 'crossbind.data.txt',
+                });
+            }
+            /* const workerFilePath = `${state.config.paths.build}/${state.config.general.name}.js`;
+            if (fs.existsSync(workerFilePath)) {
+                this.emitFile({
+                    type: 'asset',
+                    source: fs.readFileSync(workerFilePath),
+                    fileName: `cpp.worker.js`,
+                });
+            } */
+        },
+    };
+};
+
+export default rollupCrossbindPlugin;

package/package.json

@@ -0,0 +1,26 @@
+{
+  "name": "@crossbind/plugin-rollup",
+  "version": "2.0.0-beta.50",
+  "description": "crossbind Rollup plugin: A tool for seamless C++ integration with the Rollup bundler.",
+  "homepage": "https://github.com/crossbind/crossbind/tree/main/plugins/rollup#readme",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/crossbind/crossbind.git"
+  },
+  "license": "MIT",
+  "type": "module",
+  "main": "index.js",
+  "dependencies": {
+    "crossbind": "^2.0.0-beta.50",
+    "@crossbind/core-embind-rust": "^2.0.0-beta.50"
+  },
+  "peerDependencies": {
+    "rollup": ">=4.62.4"
+  },
+  "keywords": [
+    "crossbind-plugin",
+    "rollup",
+    "bind",
+    "c++"
+  ]
+}