@crossbind/plugin-webpack 2.0.0-beta.63 → 2.0.0-beta.64

package/README.md

@@ -13,19 +13,18 @@ A tool for seamless C++ integration with the Webpack bundler.
 </a>
 
 ## Integration
-To integrate crossbind into your project using Webpack as a bundler, you can utilize the @crossbind/plugin-webpack plugin. Start by installing these package with the following command:
+Install the plugin and its loader:
 
 ```sh
 npm install @crossbind/plugin-webpack@beta @crossbind/plugin-webpack-loader@beta --save-dev
 ```
 
 **Webpack**  
-To enable the plugin, modify the `webpack.config.js` file as shown below.
+Register the plugin, its loader rule and its dev server settings in `webpack.config.js`:
 
 ```diff
-+ const CrossbindWebpackPlugin = require('@crossbind/plugin-webpack');
++ const CrossbindWebpackPlugin = require('@crossbind/plugin-webpack').default;
 + const crossbindWebpackPlugin = new CrossbindWebpackPlugin();
-+ const compiler = crossbindWebpackPlugin.getCompiler();
 
 module.exports = {
   //...
@@ -34,112 +33,32 @@ module.exports = {
   ],
   module: {
     rules: [
-+     {
-+       test: /\.h$/,
-+       loader: '@crossbind/plugin-webpack-loader',
-+       options: { compiler },
-+     }
++     crossbindWebpackPlugin.getRule(),
     ],
   },
++ devServer: crossbindWebpackPlugin.getDevServerConfig(),
 };
 ```
 
 **Rspack**  
-To enable the plugin, modify the `rspack.config.mjs` file as shown below.
+The same plugin works in `rspack.config.mjs`:
 
 ```diff
 + import CrossbindWebpackPlugin from '@crossbind/plugin-webpack';
 
 + const crossbindWebpackPlugin = new CrossbindWebpackPlugin();
-+ const compiler = crossbindWebpackPlugin.getCompiler();
 
 export default defineConfig({
-	module: {
-		rules: [
-+            {
-+                test: /\.h$/,
-+                loader: '@crossbind/plugin-webpack-loader',
-+                options: { compiler },
-+            }
-		]
-	},
-	plugins: [
-+         crossbindWebpackPlugin,
-	].filter(Boolean),
-+     devServer: {
-+         watchFiles: compiler.config.paths.native,
-+         setupMiddlewares: (middlewares, devServer) => {
-+             if (!devServer) {
-+                 throw new Error('@rspack/dev-server is not defined');
-+             }
-+ 
-+             middlewares.unshift({
-+                 name: '/crossbind.js',
-+                 path: '/crossbind.js',
-+                 middleware: (req, res) => {
-+                     res.sendFile(`${compiler.config.paths.temp}/${compiler.config.general.name}.browser.js`);
-+                 },
-+             });
-+             middlewares.unshift({
-+                 name: '/crossbind.wasm',
-+                 path: '/crossbind.wasm',
-+                 middleware: (req, res) => {
-+                     res.send(fs.readFileSync(`${compiler.config.paths.temp}/${compiler.config.general.name}.wasm`));
-+                 },
-+             });
-+ 
-+             return middlewares;
-+         },
-+     },
+  module: {
+    rules: [
++     crossbindWebpackPlugin.getRule(),
+    ],
+  },
+  plugins: [
++   crossbindWebpackPlugin,
+  ],
++ devServer: crossbindWebpackPlugin.getDevServerConfig(),
 });
 ```
 
-**Craco**  
-To enable the plugin, create the `craco.config.js` file as shown below.
-
-```js
-const fs = require('fs');
-
-module.exports = async function () {
-    const { default: CrossbindWebpackPlugin } = await import('@crossbind/plugin-webpack');
-    const crossbindWebpackPlugin = new CrossbindWebpackPlugin();
-    const compiler = crossbindWebpackPlugin.getCompiler();
-
-    return {
-        webpack: {
-            plugins: {
-                add: [crossbindWebpackPlugin],
-            },
-            configure: (config) => {
-                config.module.rules[1].oneOf = [
-                    {
-                        test: /\.h$/,
-                        loader: '@crossbind/plugin-webpack-loader',
-                        options: { compiler },
-                    },
-                    ...config.module.rules[1].oneOf,
-                ];
-                return config;
-            },
-        },
-        devServer: (devServerConfig) => {
-            devServerConfig.watchFiles = compiler.config.paths.native;
-            devServerConfig.onBeforeSetupMiddleware = (devServer) => {
-                if (!devServer) {
-                  throw new Error('webpack-dev-server is not defined');
-                }
-
-                devServer.app.get('/crossbind.js', function (req, res) {
-                  res.sendFile(`${compiler.config.paths.temp}/${compiler.config.general.name}.browser.js`);
-                });
-
-                devServer.app.get('/crossbind.wasm', function (req, res) {
-                    res.send(fs.readFileSync(`${compiler.config.paths.temp}/${compiler.config.general.name}.wasm`));
-                });
-            };
-
-            return devServerConfig;
-        },
-    };
-};
-```
+`getRule()` sends header and Rust imports to the loader, and `getDevServerConfig()` serves the build with the COOP/COEP headers a multithreaded build needs. To keep a `devServer` of your own, spread `getDevServerConfig()` into it.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@crossbind/plugin-webpack",
-  "version": "2.0.0-beta.63",
+  "version": "2.0.0-beta.64",
   "description": "crossbind Webpack plugin: A tool for seamless C++ integration with the Webpack bundler.",
   "homepage": "https://github.com/crossbind/crossbind/tree/main/plugins/webpack#readme",
   "repository": {
@@ -11,8 +11,8 @@
   "type": "module",
   "main": "index.js",
   "dependencies": {
-    "crossbind": "^2.0.0-beta.63",
-    "@crossbind/core-embind-rust": "^2.0.0-beta.63"
+    "crossbind": "^2.0.0-beta.64",
+    "@crossbind/core-embind-rust": "^2.0.0-beta.64"
   },
   "peerDependencies": {
     "webpack": ">=5.0.0"