@cpp.js/plugin-webpack 2.0.0-beta.13 → 2.0.0-beta.21

package/AGENTS.md

@@ -0,0 +1,89 @@
+# AGENTS.md — @cpp.js/plugin-webpack
+
+> Webpack **and Rspack** integration plugin. Same package serves both — Rspack reuses the Webpack plugin contract.
+
+## What lives here
+
+- `index.js` — exports `class CppjsWebpackPlugin`. Single class, no separate kernel.
+- Sibling package `@cpp.js/plugin-webpack-loader` ships the loader for `.h` files; `getRule()` references it by name.
+
+## Class API surface
+
+```
+new CppjsWebpackPlugin()
+  ↓
+  .apply(compiler)                   ← webpack standard plugin hook
+  .getRule()                         ← module.rules entry for .h
+  .getDevServerConfig()              ← devServer block w/ COOP+COEP + middleware
+  .getLoaderOptions()                ← escape hatch: cpp.js state passed to other rules
+  .setDevServerMiddleware(...)        ← internal, called by getDevServerConfig
+```
+
+User config consumes all four; see `docs/playbooks/integration/webpack-rspack.md` for the canonical wiring.
+
+## Hooks the plugin registers
+
+| webpack hook | What it does |
+|--------------|--------------|
+| `compiler.hooks.done` | After every compilation: re-run `createLib + createXCFramework + buildWasm` (mtime-aware via `isSourceNewer`) |
+| `compiler.hooks.afterCompile` | Adds `state.config.paths.native` to `compilation.contextDependencies` so webpack watch picks up `.cpp`/`.h` edits |
+
+## DevServer middleware
+
+`getDevServerConfig()` returns:
+
+```js
+{
+  watchFiles: state.config.paths.native,
+  hot: true,
+  liveReload: true,
+  headers: {
+    'Cross-Origin-Opener-Policy': 'same-origin',
+    'Cross-Origin-Embedder-Policy': 'require-corp',
+  },
+  setupMiddlewares: (middlewares, devServer) => { ... }
+}
+```
+
+The middleware adds `/cpp.js` and `/cpp.wasm` routes that pipe the freshly built artifacts. Both routes also re-emit COOP/COEP per-response (belt-and-suspenders for caching layers that strip top-level headers).
+
+## Rspack compatibility
+
+Rspack copies webpack's plugin / loader shape. The plugin works without modification. The Rspack-specific wrinkle: `getRule()` returns a plain object that Rspack's TypeScript-strict config types may complain about — cast to `RspackOptions['module']['rules'][number]` if needed.
+
+## Common pitfalls
+
+- **Forgetting `getRule()` while passing the plugin instance.** The `.h` loader rule and the plugin instance are independent registrations; both are required.
+- **Wrapping the plugin's `getDevServerConfig()` and dropping `headers`.** Always spread: `{ ...cppDev, ...custom, headers: { ...cppDev.headers, ...custom.headers } }`.
+- **Trying to inject `getRule()` into `plugins:` array** instead of `module.rules:`. They are distinct.
+- **Babel/SWC running on `.h` first.** Loader chain order matters; `getRule()` test is `/\.h$/` so other rules with broader tests can swallow it. Make sure no rule for `/\.[jt]sx?$/` accidentally matches `.h` (none do by default).
+- **Adding `console.log` for debugging.** Route through `cpp.js` exports — `state.config` carries the logger if you need it. Plugin output should be quiet by default.
+
+## Validation
+
+Strict gate:
+
+```bash
+pnpm run ci:linux:build && pnpm run e2e:dev && pnpm run e2e:prod
+```
+
+Smoke samples:
+
+```bash
+pnpm --filter=@cpp.js/sample-web-react-rspack run build
+pnpm --filter=@cpp.js/playground-web-rspack run build
+```
+
+If you touch the dev-server middleware, also test:
+
+```bash
+pnpm --filter=@cpp.js/sample-web-react-rspack exec rspack serve
+# verify in browser: COOP/COEP headers present, /cpp.wasm 200
+```
+
+## Reference
+
+- Loader package: `cppjs-plugins/cppjs-plugin-webpack-loader/`
+- Integration recipe: `docs/playbooks/integration/webpack-rspack.md`
+- Next.js variant (no devServer): `docs/playbooks/integration/nextjs.md`
+- Canonical samples: `cppjs-sample-web-react-rspack`, `cppjs-playground-web-rspack`

package/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2025 Buğra Sarı
+Copyright (c) 2026 Buğra Sarı
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

package/index.js

@@ -1,6 +1,8 @@
 
 import fs from 'node:fs';
-import { state, createLib, buildWasm, createBridgeFile, getData, getCppJsScript, getTargetParams, getFilteredBuildTargets } from 'cpp.js';
+import {
+    state, createLib, buildWasm, createBridgeFile, getData, getCppJsScript, getTargetParams, getFilteredBuildTargets, isSourceNewer,
+} from 'cpp.js';
 
 const targetParams = getTargetParams({ platform: ['wasm'], arch: ['wasm32'], runtime: ['st'], runtimeEnv: ['browser'] }, true);
 let buildTargetRelease = getFilteredBuildTargets(targetParams, { buildType: 'release' })?.[0];
@@ -38,9 +40,10 @@ export default class CppjsWebpackPlugin {
     async onDone({ compilation }) {
         const isDev = compilation.options.mode === 'development';
         const buildTarget = isDev ? buildTargetDebug : buildTargetRelease;
-        createLib(buildTarget, 'Source', { buildSource: true });
-        createLib(buildTarget, 'Bridge', { buildSource: false, nativeGlob: [`${state.config.paths.cli}/assets/commonBridges.cpp`, ...this.bridges] });
-        await buildWasm(buildTarget);
+        const force = isSourceNewer(buildTarget);
+        createLib(buildTarget, 'Source', { force, buildSource: true });
+        createLib(buildTarget, 'Bridge', { force, buildSource: false, nativeGlob: [`${state.config.paths.cli}/assets/cpp-runtime/commonBridges.cpp`, ...this.bridges] });
+        await buildWasm(buildTarget, { force });
         if (!isDev) {
             const output = state.config.paths.output === state.config.paths.build ? compilation.options.output.path : state.config.paths.output;
             fs.copyFileSync(`${state.config.paths.build}/${buildTarget.jsName}`, `${output}/cpp.js`);
@@ -88,6 +91,8 @@ export default class CppjsWebpackPlugin {
             middleware: (req, res) => {
                 const filePath = `${state.config.paths.build}/${buildTargetDebug.jsName}`;
                 res.setHeader('Content-Type', 'application/javascript');
+                res.setHeader('Cross-Origin-Opener-Policy', 'same-origin');
+                res.setHeader('Cross-Origin-Embedder-Policy', 'require-corp');
                 fs.createReadStream(filePath).pipe(res);
             },
         });
@@ -98,6 +103,8 @@ export default class CppjsWebpackPlugin {
             middleware: (req, res) => {
                 const filePath = `${state.config.paths.build}/${buildTargetDebug.wasmName}`;
                 res.setHeader('Content-Type', 'application/wasm');
+                res.setHeader('Cross-Origin-Opener-Policy', 'same-origin');
+                res.setHeader('Cross-Origin-Embedder-Policy', 'require-corp');
                 fs.createReadStream(filePath).pipe(res);
             },
         });
@@ -110,6 +117,10 @@ export default class CppjsWebpackPlugin {
             watchFiles: state.config.paths.native,
             hot: true,
             liveReload: true,
+            headers: {
+                'Cross-Origin-Opener-Policy': 'same-origin',
+                'Cross-Origin-Embedder-Policy': 'require-corp',
+            },
             setupMiddlewares: (middlewares, devServer) => {
                 return this.setDevServerMiddleware(middlewares, devServer);
             },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cpp.js/plugin-webpack",
-  "version": "2.0.0-beta.13",
+  "version": "2.0.0-beta.21",
   "description": "Cpp.js Webpack plugin: A tool for seamless C++ integration with the Webpack bundler.",
   "homepage": "https://github.com/bugra9/cpp.js/tree/main/packages/cppjs-plugin-rollup#readme",
   "repository": "https://github.com/bugra9/cpp.js.git",
@@ -8,7 +8,7 @@
   "type": "module",
   "main": "index.js",
   "dependencies": {
-    "cpp.js": "^2.0.0-beta.13"
+    "cpp.js": "^2.0.0-beta.21"
   },
   "keywords": [
     "cpp.js-plugin",