@rsbuild/plugin-node-polyfill 1.0.4 → 1.2.0

package/README.md

@@ -7,6 +7,7 @@ An Rsbuild plugin to automatically inject polyfills for [Node.js builtin modules
    <img src="https://img.shields.io/npm/v/@rsbuild/plugin-node-polyfill?style=flat-square&colorA=564341&colorB=EDED91" alt="npm version" />
   </a>
   <img src="https://img.shields.io/badge/License-MIT-blue.svg?style=flat-square&colorA=564341&colorB=EDED91" alt="license" />
+  <a href="https://npmcharts.com/compare/@rsbuild/plugin-node-polyfill?minimal=true"><img src="https://img.shields.io/npm/dm/@rsbuild/plugin-node-polyfill.svg?style=flat-square&colorA=564341&colorB=EDED91" alt="downloads" /></a>
 </p>
 
 ## When to use
@@ -27,11 +28,11 @@ Add plugin to your `rsbuild.config.ts`:
 
 ```ts
 // rsbuild.config.ts
-import { pluginNodePolyfill } from "@rsbuild/plugin-node-polyfill";
+import { pluginNodePolyfill } from '@rsbuild/plugin-node-polyfill'
 
 export default {
   plugins: [pluginNodePolyfill()],
-};
+}
 ```
 
 ## Node Polyfills
@@ -46,7 +47,7 @@ When you use the above global variables in your code, the corresponding polyfill
 For instance, the following code would inject the `Buffer` polyfill:
 
 ```ts
-const bufferData = Buffer.from("abc");
+const bufferData = Buffer.from('abc')
 ```
 
 You can disable this behavior through the `globals` option of the plugin:
@@ -57,7 +58,7 @@ pluginNodePolyfill({
     Buffer: false,
     process: false,
   },
-});
+})
 ```
 
 ### Modules
@@ -94,9 +95,9 @@ pluginNodePolyfill({
 When the above module is referenced in code via import / require syntax, the corresponding polyfill will be injected.
 
 ```ts
-import { Buffer } from "buffer";
+import { Buffer } from 'buffer'
 
-const bufferData = Buffer.from("abc");
+const bufferData = Buffer.from('abc')
 ```
 
 ### Fallbacks
@@ -115,9 +116,9 @@ const bufferData = Buffer.from("abc");
 Currently there is no polyfill for the above modules on the browser side, so when you import the above modules, it will automatically fallback to an empty object.
 
 ```ts
-import fs from "fs";
+import fs from 'fs'
 
-console.log(fs); // -> {}
+console.log(fs) // -> {}
 ```
 
 ## Options
@@ -130,9 +131,9 @@ Used to specify whether to inject polyfills for global variables.
 
 ```ts
 type Globals = {
-  process?: boolean;
-  Buffer?: boolean;
-};
+  process?: boolean
+  Buffer?: boolean
+}
 ```
 
 - **Default:**
@@ -141,7 +142,7 @@ type Globals = {
 const defaultGlobals = {
   Buffer: true,
   process: true,
-};
+}
 ```
 
 ### protocolImports
@@ -156,9 +157,55 @@ For example, if you disable `protocolImports`, modules such as `node:path`, `nod
 ```ts
 pluginNodePolyfill({
   protocolImports: false,
-});
+})
 ```
 
+### include
+
+Specify an array of modules for which polyfills should be injected. If this option is set, only the specified modules will be polyfilled. `include` is mutually exclusive with [`exclude`](#exclude).
+
+- **Type:** `string[]`
+- **Default:** `undefined`
+
+```ts
+pluginNodePolyfill({
+  include: ['buffer', 'crypto'], // Only "buffer" and "crypto" modules will be polyfilled.
+})
+```
+
+### exclude
+
+Specify an array of modules for which polyfills should not be injected from the default. If this option is set, the specified modules will be excluded from polyfilled. `exclude` is mutually exclusive with [`include`](#include).
+
+- **Type:** `string[]`
+- **Default:** `undefined`
+
+```ts
+pluginNodePolyfill({
+  exclude: ['http', 'https'], // All modules except "http" and "https" will be polyfilled.
+})
+```
+
+### overrides
+
+Override the default polyfills for specific modules.
+
+- **Type:** `Record<string, string>`
+- **Default:** `{}`
+
+```ts
+pluginNodePolyfill({
+  overrides: {
+    fs: 'memfs',
+  },
+})
+```
+
+## Exported variables
+
+- `builtinMappingResolved`: A map of Node.js builtin modules to their resolved corresponding polyfills modules.
+- `resolvedPolyfillToModules`: A map of resolved polyfill modules to the polyfill modules before resolving.
+
 ## License
 
 [MIT](./LICENSE).

package/dist/index.cjs

@@ -3,9 +3,6 @@ var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
 var __getOwnPropNames = Object.getOwnPropertyNames;
 var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __esm = (fn, res) => function __init() {
-  return fn && (res = (0, fn[__getOwnPropNames(fn)[0]])(fn = 0)), res;
-};
 var __export = (target, all) => {
   for (var name in all)
     __defProp(target, name, { get: all[name], enumerable: true });
@@ -20,154 +17,115 @@ var __copyProps = (to, from, except, desc) => {
 };
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 
-// node_modules/.pnpm/tsup@8.0.2_postcss@8.4.39_typescript@5.5.2/node_modules/tsup/assets/cjs_shims.js
-var getImportMetaUrl, importMetaUrl;
-var init_cjs_shims = __esm({
-  "node_modules/.pnpm/tsup@8.0.2_postcss@8.4.39_typescript@5.5.2/node_modules/tsup/assets/cjs_shims.js"() {
-    "use strict";
-    getImportMetaUrl = () => typeof document === "undefined" ? new URL("file:" + __filename).href : document.currentScript && document.currentScript.src || new URL("main.js", document.baseURI).href;
-    importMetaUrl = /* @__PURE__ */ getImportMetaUrl();
-  }
+// src/index.ts
+var src_exports = {};
+__export(src_exports, {
+  PLUGIN_NODE_POLYFILL_NAME: () => PLUGIN_NODE_POLYFILL_NAME,
+  builtinMappingResolved: () => builtinMappingResolved,
+  getProvideGlobals: () => getProvideGlobals,
+  getResolveFallback: () => getResolveFallback,
+  pluginNodePolyfill: () => pluginNodePolyfill,
+  resolvePolyfill: () => resolvePolyfill,
+  resolvedPolyfillToModules: () => resolvedPolyfillToModules
 });
+module.exports = __toCommonJS(src_exports);
+
+// node_modules/.pnpm/tsup@8.3.0_postcss@8.4.47_typescript@5.6.3/node_modules/tsup/assets/cjs_shims.js
+var getImportMetaUrl = () => typeof document === "undefined" ? new URL(`file:${__filename}`).href : document.currentScript && document.currentScript.src || new URL("main.js", document.baseURI).href;
+var importMetaUrl = /* @__PURE__ */ getImportMetaUrl();
 
 // src/ProtocolImportsPlugin.ts
-var ProtocolImportsPlugin_exports = {};
-__export(ProtocolImportsPlugin_exports, {
-  ProtocolImportsPlugin: () => ProtocolImportsPlugin
-});
-var ProtocolImportsPlugin;
-var init_ProtocolImportsPlugin = __esm({
-  "src/ProtocolImportsPlugin.ts"() {
-    "use strict";
-    init_cjs_shims();
-    ProtocolImportsPlugin = class {
-      apply(compiler) {
-        compiler.hooks.normalModuleFactory.tap(
+var ProtocolImportsPlugin = class {
+  apply(compiler) {
+    compiler.hooks.normalModuleFactory.tap(
+      "NormalModuleReplacementPlugin",
+      (nmf) => {
+        nmf.hooks.beforeResolve.tap(
           "NormalModuleReplacementPlugin",
-          (nmf) => {
-            nmf.hooks.beforeResolve.tap(
-              "NormalModuleReplacementPlugin",
-              (resource) => {
-                if (/^node:/.test(resource.request)) {
-                  resource.request = resource.request.replace(/^node:/, "");
-                }
-              }
-            );
+          (resource) => {
+            if (/^node:/.test(resource.request)) {
+              resource.request = resource.request.replace(/^node:/, "");
+            }
           }
         );
       }
-    };
+    );
   }
-});
-
-// src/index.ts
-var src_exports = {};
-__export(src_exports, {
-  PLUGIN_NODE_POLYFILL_NAME: () => PLUGIN_NODE_POLYFILL_NAME,
-  pluginNodePolyfill: () => pluginNodePolyfill
-});
-module.exports = __toCommonJS(src_exports);
-init_cjs_shims();
+};
 
 // src/libs.ts
-var libs_exports = {};
-__export(libs_exports, {
-  _stream_duplex: () => _stream_duplex,
-  _stream_passthrough: () => _stream_passthrough,
-  _stream_readable: () => _stream_readable,
-  _stream_transform: () => _stream_transform,
-  _stream_writable: () => _stream_writable,
-  assert: () => assert,
-  buffer: () => buffer,
-  child_process: () => child_process,
-  cluster: () => cluster,
-  console: () => console,
-  constants: () => constants,
-  crypto: () => crypto,
-  dgram: () => dgram,
-  dns: () => dns,
-  domain: () => domain,
-  events: () => events,
-  fs: () => fs,
-  http: () => http,
-  https: () => https,
-  module: () => module2,
-  net: () => net,
-  os: () => os,
-  path: () => path,
-  process: () => process,
-  punycode: () => punycode,
-  querystring: () => querystring,
-  readline: () => readline,
-  repl: () => repl,
-  stream: () => stream,
-  string_decoder: () => string_decoder,
-  sys: () => sys,
-  timers: () => timers,
-  tls: () => tls,
-  tty: () => tty,
-  url: () => url,
-  util: () => util,
-  vm: () => vm,
-  zlib: () => zlib
-});
-init_cjs_shims();
 var import_node_module = require("module");
 var require2 = (0, import_node_module.createRequire)(importMetaUrl);
-var assert = require2.resolve("assert/");
-var buffer = require2.resolve("buffer/");
-var child_process = null;
-var cluster = null;
-var console = require2.resolve("console-browserify");
-var constants = require2.resolve("constants-browserify");
-var crypto = require2.resolve("crypto-browserify");
-var dgram = null;
-var dns = null;
-var domain = require2.resolve("domain-browser");
-var events = require2.resolve("events/");
-var fs = null;
-var http = require2.resolve("stream-http");
-var https = require2.resolve("https-browserify");
-var module2 = null;
-var net = null;
-var os = require2.resolve("os-browserify/browser.js");
-var path = require2.resolve("path-browserify");
-var punycode = require2.resolve("punycode/");
-var process = require2.resolve("process/browser.js");
-var querystring = require2.resolve("querystring-es3/");
-var readline = null;
-var repl = null;
-var stream = require2.resolve("stream-browserify");
-var _stream_duplex = require2.resolve(
-  "readable-stream/lib/_stream_duplex.js"
-);
-var _stream_passthrough = require2.resolve(
-  "readable-stream/lib/_stream_passthrough.js"
-);
-var _stream_readable = require2.resolve(
-  "readable-stream/lib/_stream_readable.js"
-);
-var _stream_transform = require2.resolve(
-  "readable-stream/lib/_stream_transform.js"
-);
-var _stream_writable = require2.resolve(
-  "readable-stream/lib/_stream_writable.js"
+var builtinMappingResolved = {
+  assert: require2.resolve("assert/"),
+  buffer: require2.resolve("buffer/"),
+  child_process: null,
+  cluster: null,
+  console: require2.resolve("console-browserify"),
+  constants: require2.resolve("constants-browserify"),
+  crypto: require2.resolve("crypto-browserify"),
+  dgram: null,
+  dns: null,
+  domain: require2.resolve("domain-browser"),
+  events: require2.resolve("events/"),
+  fs: null,
+  http: require2.resolve("stream-http"),
+  https: require2.resolve("https-browserify"),
+  module: null,
+  net: null,
+  os: require2.resolve("os-browserify/browser.js"),
+  path: require2.resolve("path-browserify"),
+  punycode: require2.resolve("punycode/"),
+  process: require2.resolve("process/browser.js"),
+  querystring: require2.resolve("querystring-es3/"),
+  readline: null,
+  repl: null,
+  stream: require2.resolve("stream-browserify"),
+  _stream_duplex: require2.resolve("readable-stream/lib/_stream_duplex.js"),
+  _stream_passthrough: require2.resolve(
+    "readable-stream/lib/_stream_passthrough.js"
+  ),
+  _stream_readable: require2.resolve("readable-stream/lib/_stream_readable.js"),
+  _stream_transform: require2.resolve(
+    "readable-stream/lib/_stream_transform.js"
+  ),
+  _stream_writable: require2.resolve("readable-stream/lib/_stream_writable.js"),
+  string_decoder: require2.resolve("string_decoder/"),
+  sys: require2.resolve("util/util.js"),
+  timers: require2.resolve("timers-browserify"),
+  tls: null,
+  tty: require2.resolve("tty-browserify"),
+  url: require2.resolve("url/"),
+  util: require2.resolve("util/util.js"),
+  vm: require2.resolve("vm-browserify"),
+  zlib: require2.resolve("browserify-zlib")
+};
+var resolvedPolyfillToModules = Object.fromEntries(
+  Object.entries(builtinMappingResolved).filter(([key]) => key !== null).map(([key, value]) => [value, key])
 );
-var string_decoder = require2.resolve("string_decoder/");
-var sys = require2.resolve("util/util.js");
-var timers = require2.resolve("timers-browserify");
-var tls = null;
-var tty = require2.resolve("tty-browserify");
-var url = require2.resolve("url/");
-var util = require2.resolve("util/util.js");
-var vm = require2.resolve("vm-browserify");
-var zlib = require2.resolve("browserify-zlib");
 
 // src/index.ts
-var getResolveFallback = (protocolImports) => {
+var resolvePolyfill = (libPath, overrides) => {
+  if (overrides?.[libPath] !== void 0) {
+    return overrides[libPath];
+  }
+  return builtinMappingResolved[libPath];
+};
+var getResolveFallback = ({
+  protocolImports,
+  exclude,
+  include,
+  overrides
+}) => {
+  if (exclude && include) {
+    throw new Error("`include` is mutually exclusive with `exclude`.");
+  }
+  const resolvedNodeLibs = include ? include : Object.keys(builtinMappingResolved).filter((name) => {
+    return !(exclude || []).includes(name);
+  });
   const fallback = {};
-  for (const name of Object.keys(libs_exports)) {
-    const libPath = libs_exports[name];
+  for (const name of resolvedNodeLibs) {
+    const libPath = resolvePolyfill(name, overrides);
     fallback[name] = libPath ?? false;
     if (protocolImports) {
       fallback[`node:${name}`] = fallback[name];
@@ -175,19 +133,19 @@ var getResolveFallback = (protocolImports) => {
   }
   return fallback;
 };
-var getProvideGlobals = async (globals) => {
+var getProvideGlobals = async (globals, overrides) => {
   const result = {};
   if (globals?.Buffer !== false) {
-    result.Buffer = [buffer, "Buffer"];
+    result.Buffer = [resolvePolyfill("buffer", overrides), "Buffer"];
   }
   if (globals?.process !== false) {
-    result.process = [process];
+    result.process = [resolvePolyfill("process", overrides)];
   }
   return result;
 };
 var PLUGIN_NODE_POLYFILL_NAME = "rsbuild:node-polyfill";
 function pluginNodePolyfill(options = {}) {
-  const { protocolImports = true } = options;
+  const { protocolImports = true, include, exclude, overrides } = options;
   return {
     name: PLUGIN_NODE_POLYFILL_NAME,
     setup(api) {
@@ -195,14 +153,23 @@ function pluginNodePolyfill(options = {}) {
         if (isServer) {
           return;
         }
-        chain.resolve.fallback.merge(getResolveFallback(protocolImports));
-        const provideGlobals = await getProvideGlobals(options.globals);
+        chain.resolve.fallback.merge(
+          getResolveFallback({
+            protocolImports,
+            include,
+            exclude,
+            overrides
+          })
+        );
+        const provideGlobals = await getProvideGlobals(
+          options.globals,
+          overrides
+        );
         if (Object.keys(provideGlobals).length) {
           chain.plugin("node-polyfill-provide").use(bundler.ProvidePlugin, [provideGlobals]);
         }
         if (protocolImports) {
-          const { ProtocolImportsPlugin: ProtocolImportsPlugin2 } = await Promise.resolve().then(() => (init_ProtocolImportsPlugin(), ProtocolImportsPlugin_exports));
-          chain.plugin("protocol-imports").use(ProtocolImportsPlugin2);
+          chain.plugin("protocol-imports").use(ProtocolImportsPlugin);
         }
       });
     }
@@ -211,5 +178,10 @@ function pluginNodePolyfill(options = {}) {
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   PLUGIN_NODE_POLYFILL_NAME,
-  pluginNodePolyfill
+  builtinMappingResolved,
+  getProvideGlobals,
+  getResolveFallback,
+  pluginNodePolyfill,
+  resolvePolyfill,
+  resolvedPolyfillToModules
 });

package/dist/index.d.cts

@@ -1,5 +1,47 @@
 import { RsbuildPlugin } from '@rsbuild/core';
 
+declare const builtinMappingResolved: {
+    readonly assert: string;
+    readonly buffer: string;
+    readonly child_process: null;
+    readonly cluster: null;
+    readonly console: string;
+    readonly constants: string;
+    readonly crypto: string;
+    readonly dgram: null;
+    readonly dns: null;
+    readonly domain: string;
+    readonly events: string;
+    readonly fs: null;
+    readonly http: string;
+    readonly https: string;
+    readonly module: null;
+    readonly net: null;
+    readonly os: string;
+    readonly path: string;
+    readonly punycode: string;
+    readonly process: string;
+    readonly querystring: string;
+    readonly readline: null;
+    readonly repl: null;
+    readonly stream: string;
+    readonly _stream_duplex: string;
+    readonly _stream_passthrough: string;
+    readonly _stream_readable: string;
+    readonly _stream_transform: string;
+    readonly _stream_writable: string;
+    readonly string_decoder: string;
+    readonly sys: string;
+    readonly timers: string;
+    readonly tls: null;
+    readonly tty: string;
+    readonly url: string;
+    readonly util: string;
+    readonly vm: string;
+    readonly zlib: string;
+};
+declare const resolvedPolyfillToModules: any;
+
 type Globals = {
     process?: boolean;
     Buffer?: boolean;
@@ -20,8 +62,28 @@ type PluginNodePolyfillOptions = {
      * @default true
      */
     protocolImports?: boolean;
+    /**
+     * Exclude certain modules to be polyfilled.
+     * This option is mutually exclusive with {@link PluginNodePolyfillOptions.include | `include`}.
+     * @default undefined
+     */
+    exclude?: string[];
+    /**
+     * Only include certain modules to be polyfilled.
+     * This option is mutually exclusive with {@link PluginNodePolyfillOptions.exclude | `exclude`}.
+     * @default undefined
+     */
+    include?: string[];
+    /**
+     * Override the default polyfills for specific modules.
+     * @default undefined
+     */
+    overrides?: Record<string, string | false>;
 };
+declare const resolvePolyfill: (libPath: string, overrides?: PluginNodePolyfillOptions["overrides"]) => string | false | null;
+declare const getResolveFallback: ({ protocolImports, exclude, include, overrides, }: Pick<PluginNodePolyfillOptions, "protocolImports" | "exclude" | "include" | "overrides">) => Record<string, string | false>;
+declare const getProvideGlobals: (globals?: Globals, overrides?: PluginNodePolyfillOptions["overrides"]) => Promise<Record<string, string | string[]>>;
 declare const PLUGIN_NODE_POLYFILL_NAME = "rsbuild:node-polyfill";
 declare function pluginNodePolyfill(options?: PluginNodePolyfillOptions): RsbuildPlugin;
 
-export { PLUGIN_NODE_POLYFILL_NAME, type PluginNodePolyfillOptions, pluginNodePolyfill };
+export { PLUGIN_NODE_POLYFILL_NAME, type PluginNodePolyfillOptions, builtinMappingResolved, getProvideGlobals, getResolveFallback, pluginNodePolyfill, resolvePolyfill, resolvedPolyfillToModules };

package/dist/index.d.ts

@@ -1,5 +1,47 @@
 import { RsbuildPlugin } from '@rsbuild/core';
 
+declare const builtinMappingResolved: {
+    readonly assert: string;
+    readonly buffer: string;
+    readonly child_process: null;
+    readonly cluster: null;
+    readonly console: string;
+    readonly constants: string;
+    readonly crypto: string;
+    readonly dgram: null;
+    readonly dns: null;
+    readonly domain: string;
+    readonly events: string;
+    readonly fs: null;
+    readonly http: string;
+    readonly https: string;
+    readonly module: null;
+    readonly net: null;
+    readonly os: string;
+    readonly path: string;
+    readonly punycode: string;
+    readonly process: string;
+    readonly querystring: string;
+    readonly readline: null;
+    readonly repl: null;
+    readonly stream: string;
+    readonly _stream_duplex: string;
+    readonly _stream_passthrough: string;
+    readonly _stream_readable: string;
+    readonly _stream_transform: string;
+    readonly _stream_writable: string;
+    readonly string_decoder: string;
+    readonly sys: string;
+    readonly timers: string;
+    readonly tls: null;
+    readonly tty: string;
+    readonly url: string;
+    readonly util: string;
+    readonly vm: string;
+    readonly zlib: string;
+};
+declare const resolvedPolyfillToModules: any;
+
 type Globals = {
     process?: boolean;
     Buffer?: boolean;
@@ -20,8 +62,28 @@ type PluginNodePolyfillOptions = {
      * @default true
      */
     protocolImports?: boolean;
+    /**
+     * Exclude certain modules to be polyfilled.
+     * This option is mutually exclusive with {@link PluginNodePolyfillOptions.include | `include`}.
+     * @default undefined
+     */
+    exclude?: string[];
+    /**
+     * Only include certain modules to be polyfilled.
+     * This option is mutually exclusive with {@link PluginNodePolyfillOptions.exclude | `exclude`}.
+     * @default undefined
+     */
+    include?: string[];
+    /**
+     * Override the default polyfills for specific modules.
+     * @default undefined
+     */
+    overrides?: Record<string, string | false>;
 };
+declare const resolvePolyfill: (libPath: string, overrides?: PluginNodePolyfillOptions["overrides"]) => string | false | null;
+declare const getResolveFallback: ({ protocolImports, exclude, include, overrides, }: Pick<PluginNodePolyfillOptions, "protocolImports" | "exclude" | "include" | "overrides">) => Record<string, string | false>;
+declare const getProvideGlobals: (globals?: Globals, overrides?: PluginNodePolyfillOptions["overrides"]) => Promise<Record<string, string | string[]>>;
 declare const PLUGIN_NODE_POLYFILL_NAME = "rsbuild:node-polyfill";
 declare function pluginNodePolyfill(options?: PluginNodePolyfillOptions): RsbuildPlugin;
 
-export { PLUGIN_NODE_POLYFILL_NAME, type PluginNodePolyfillOptions, pluginNodePolyfill };
+export { PLUGIN_NODE_POLYFILL_NAME, type PluginNodePolyfillOptions, builtinMappingResolved, getProvideGlobals, getResolveFallback, pluginNodePolyfill, resolvePolyfill, resolvedPolyfillToModules };

package/dist/index.js

@@ -1,105 +1,95 @@
-import {
-  __export
-} from "./chunk-6C3VEZWH.js";
+// src/ProtocolImportsPlugin.ts
+var ProtocolImportsPlugin = class {
+  apply(compiler) {
+    compiler.hooks.normalModuleFactory.tap(
+      "NormalModuleReplacementPlugin",
+      (nmf) => {
+        nmf.hooks.beforeResolve.tap(
+          "NormalModuleReplacementPlugin",
+          (resource) => {
+            if (/^node:/.test(resource.request)) {
+              resource.request = resource.request.replace(/^node:/, "");
+            }
+          }
+        );
+      }
+    );
+  }
+};
 
 // src/libs.ts
-var libs_exports = {};
-__export(libs_exports, {
-  _stream_duplex: () => _stream_duplex,
-  _stream_passthrough: () => _stream_passthrough,
-  _stream_readable: () => _stream_readable,
-  _stream_transform: () => _stream_transform,
-  _stream_writable: () => _stream_writable,
-  assert: () => assert,
-  buffer: () => buffer,
-  child_process: () => child_process,
-  cluster: () => cluster,
-  console: () => console,
-  constants: () => constants,
-  crypto: () => crypto,
-  dgram: () => dgram,
-  dns: () => dns,
-  domain: () => domain,
-  events: () => events,
-  fs: () => fs,
-  http: () => http,
-  https: () => https,
-  module: () => module,
-  net: () => net,
-  os: () => os,
-  path: () => path,
-  process: () => process,
-  punycode: () => punycode,
-  querystring: () => querystring,
-  readline: () => readline,
-  repl: () => repl,
-  stream: () => stream,
-  string_decoder: () => string_decoder,
-  sys: () => sys,
-  timers: () => timers,
-  tls: () => tls,
-  tty: () => tty,
-  url: () => url,
-  util: () => util,
-  vm: () => vm,
-  zlib: () => zlib
-});
 import { createRequire } from "node:module";
 var require2 = createRequire(import.meta.url);
-var assert = require2.resolve("assert/");
-var buffer = require2.resolve("buffer/");
-var child_process = null;
-var cluster = null;
-var console = require2.resolve("console-browserify");
-var constants = require2.resolve("constants-browserify");
-var crypto = require2.resolve("crypto-browserify");
-var dgram = null;
-var dns = null;
-var domain = require2.resolve("domain-browser");
-var events = require2.resolve("events/");
-var fs = null;
-var http = require2.resolve("stream-http");
-var https = require2.resolve("https-browserify");
-var module = null;
-var net = null;
-var os = require2.resolve("os-browserify/browser.js");
-var path = require2.resolve("path-browserify");
-var punycode = require2.resolve("punycode/");
-var process = require2.resolve("process/browser.js");
-var querystring = require2.resolve("querystring-es3/");
-var readline = null;
-var repl = null;
-var stream = require2.resolve("stream-browserify");
-var _stream_duplex = require2.resolve(
-  "readable-stream/lib/_stream_duplex.js"
-);
-var _stream_passthrough = require2.resolve(
-  "readable-stream/lib/_stream_passthrough.js"
-);
-var _stream_readable = require2.resolve(
-  "readable-stream/lib/_stream_readable.js"
-);
-var _stream_transform = require2.resolve(
-  "readable-stream/lib/_stream_transform.js"
-);
-var _stream_writable = require2.resolve(
-  "readable-stream/lib/_stream_writable.js"
+var builtinMappingResolved = {
+  assert: require2.resolve("assert/"),
+  buffer: require2.resolve("buffer/"),
+  child_process: null,
+  cluster: null,
+  console: require2.resolve("console-browserify"),
+  constants: require2.resolve("constants-browserify"),
+  crypto: require2.resolve("crypto-browserify"),
+  dgram: null,
+  dns: null,
+  domain: require2.resolve("domain-browser"),
+  events: require2.resolve("events/"),
+  fs: null,
+  http: require2.resolve("stream-http"),
+  https: require2.resolve("https-browserify"),
+  module: null,
+  net: null,
+  os: require2.resolve("os-browserify/browser.js"),
+  path: require2.resolve("path-browserify"),
+  punycode: require2.resolve("punycode/"),
+  process: require2.resolve("process/browser.js"),
+  querystring: require2.resolve("querystring-es3/"),
+  readline: null,
+  repl: null,
+  stream: require2.resolve("stream-browserify"),
+  _stream_duplex: require2.resolve("readable-stream/lib/_stream_duplex.js"),
+  _stream_passthrough: require2.resolve(
+    "readable-stream/lib/_stream_passthrough.js"
+  ),
+  _stream_readable: require2.resolve("readable-stream/lib/_stream_readable.js"),
+  _stream_transform: require2.resolve(
+    "readable-stream/lib/_stream_transform.js"
+  ),
+  _stream_writable: require2.resolve("readable-stream/lib/_stream_writable.js"),
+  string_decoder: require2.resolve("string_decoder/"),
+  sys: require2.resolve("util/util.js"),
+  timers: require2.resolve("timers-browserify"),
+  tls: null,
+  tty: require2.resolve("tty-browserify"),
+  url: require2.resolve("url/"),
+  util: require2.resolve("util/util.js"),
+  vm: require2.resolve("vm-browserify"),
+  zlib: require2.resolve("browserify-zlib")
+};
+var resolvedPolyfillToModules = Object.fromEntries(
+  Object.entries(builtinMappingResolved).filter(([key]) => key !== null).map(([key, value]) => [value, key])
 );
-var string_decoder = require2.resolve("string_decoder/");
-var sys = require2.resolve("util/util.js");
-var timers = require2.resolve("timers-browserify");
-var tls = null;
-var tty = require2.resolve("tty-browserify");
-var url = require2.resolve("url/");
-var util = require2.resolve("util/util.js");
-var vm = require2.resolve("vm-browserify");
-var zlib = require2.resolve("browserify-zlib");
 
 // src/index.ts
-var getResolveFallback = (protocolImports) => {
+var resolvePolyfill = (libPath, overrides) => {
+  if (overrides?.[libPath] !== void 0) {
+    return overrides[libPath];
+  }
+  return builtinMappingResolved[libPath];
+};
+var getResolveFallback = ({
+  protocolImports,
+  exclude,
+  include,
+  overrides
+}) => {
+  if (exclude && include) {
+    throw new Error("`include` is mutually exclusive with `exclude`.");
+  }
+  const resolvedNodeLibs = include ? include : Object.keys(builtinMappingResolved).filter((name) => {
+    return !(exclude || []).includes(name);
+  });
   const fallback = {};
-  for (const name of Object.keys(libs_exports)) {
-    const libPath = libs_exports[name];
+  for (const name of resolvedNodeLibs) {
+    const libPath = resolvePolyfill(name, overrides);
     fallback[name] = libPath ?? false;
     if (protocolImports) {
       fallback[`node:${name}`] = fallback[name];
@@ -107,19 +97,19 @@ var getResolveFallback = (protocolImports) => {
   }
   return fallback;
 };
-var getProvideGlobals = async (globals) => {
+var getProvideGlobals = async (globals, overrides) => {
   const result = {};
   if (globals?.Buffer !== false) {
-    result.Buffer = [buffer, "Buffer"];
+    result.Buffer = [resolvePolyfill("buffer", overrides), "Buffer"];
   }
   if (globals?.process !== false) {
-    result.process = [process];
+    result.process = [resolvePolyfill("process", overrides)];
   }
   return result;
 };
 var PLUGIN_NODE_POLYFILL_NAME = "rsbuild:node-polyfill";
 function pluginNodePolyfill(options = {}) {
-  const { protocolImports = true } = options;
+  const { protocolImports = true, include, exclude, overrides } = options;
   return {
     name: PLUGIN_NODE_POLYFILL_NAME,
     setup(api) {
@@ -127,13 +117,22 @@ function pluginNodePolyfill(options = {}) {
         if (isServer) {
           return;
         }
-        chain.resolve.fallback.merge(getResolveFallback(protocolImports));
-        const provideGlobals = await getProvideGlobals(options.globals);
+        chain.resolve.fallback.merge(
+          getResolveFallback({
+            protocolImports,
+            include,
+            exclude,
+            overrides
+          })
+        );
+        const provideGlobals = await getProvideGlobals(
+          options.globals,
+          overrides
+        );
         if (Object.keys(provideGlobals).length) {
           chain.plugin("node-polyfill-provide").use(bundler.ProvidePlugin, [provideGlobals]);
         }
         if (protocolImports) {
-          const { ProtocolImportsPlugin } = await import("./ProtocolImportsPlugin-HUSWFIAE.js");
           chain.plugin("protocol-imports").use(ProtocolImportsPlugin);
         }
       });
@@ -142,5 +141,10 @@ function pluginNodePolyfill(options = {}) {
 }
 export {
   PLUGIN_NODE_POLYFILL_NAME,
-  pluginNodePolyfill
+  builtinMappingResolved,
+  getProvideGlobals,
+  getResolveFallback,
+  pluginNodePolyfill,
+  resolvePolyfill,
+  resolvedPolyfillToModules
 };

package/package.json

@@ -1,83 +1,87 @@
 {
-  "name": "@rsbuild/plugin-node-polyfill",
-  "version": "1.0.4",
-  "repository": "https://github.com/rspack-contrib/rsbuild-plugin-node-polyfill",
-  "license": "MIT",
-  "type": "module",
-  "exports": {
-    ".": {
-      "types": "./dist/index.d.ts",
-      "import": "./dist/index.js",
-      "require": "./dist/index.cjs"
-    }
-  },
-  "main": "./dist/index.js",
-  "module": "./dist/index.mjs",
-  "types": "./dist/index.d.ts",
-  "files": [
-    "dist"
-  ],
-  "simple-git-hooks": {
-    "pre-commit": "npx nano-staged"
-  },
-  "nano-staged": {
-    "*.{js,jsx,ts,tsx,mjs,cjs}": [
-      "biome check --write --no-errors-on-unmatched"
-    ]
-  },
-  "dependencies": {
-    "assert": "^2.1.0",
-    "browserify-zlib": "^0.2.0",
-    "buffer": "^5.7.1",
-    "console-browserify": "^1.2.0",
-    "constants-browserify": "^1.0.0",
-    "crypto-browserify": "^3.12.0",
-    "domain-browser": "^5.7.0",
-    "events": "^3.3.0",
-    "https-browserify": "^1.0.0",
-    "os-browserify": "^0.3.0",
-    "path-browserify": "^1.0.1",
-    "process": "^0.11.10",
-    "punycode": "^2.3.1",
-    "querystring-es3": "^0.2.1",
-    "readable-stream": "^4.5.2",
-    "stream-browserify": "^3.0.0",
-    "stream-http": "^3.2.0",
-    "string_decoder": "^1.3.0",
-    "timers-browserify": "^2.0.12",
-    "tty-browserify": "^0.0.1",
-    "url": "^0.11.3",
-    "util": "^0.12.5",
-    "vm-browserify": "^1.1.2"
-  },
-  "devDependencies": {
-    "@biomejs/biome": "^1.8.3",
-    "@playwright/test": "^1.44.1",
-    "@rsbuild/core": "^1.0.1-beta.10",
-    "@types/node": "^20.14.1",
-    "nano-staged": "^0.8.0",
-    "playwright": "^1.44.1",
-    "simple-git-hooks": "^2.11.1",
-    "tsup": "^8.0.2",
-    "typescript": "^5.5.2"
-  },
-  "peerDependencies": {
-    "@rsbuild/core": "1.x || ^1.0.1-beta.0"
-  },
-  "peerDependenciesMeta": {
-    "@rsbuild/core": {
-      "optional": true
-    }
-  },
-  "publishConfig": {
-    "access": "public",
-    "registry": "https://registry.npmjs.org/"
-  },
-  "scripts": {
-    "build": "tsup",
-    "dev": "tsup --watch",
-    "lint": "biome check .",
-    "lint:write": "biome check . --write",
-    "test": "playwright test"
-  }
-}
+	"name": "@rsbuild/plugin-node-polyfill",
+	"version": "1.2.0",
+	"repository": "https://github.com/rspack-contrib/rsbuild-plugin-node-polyfill",
+	"license": "MIT",
+	"type": "module",
+	"exports": {
+		".": {
+			"types": "./dist/index.d.ts",
+			"import": "./dist/index.js",
+			"require": "./dist/index.cjs"
+		}
+	},
+	"main": "./dist/index.js",
+	"module": "./dist/index.mjs",
+	"types": "./dist/index.d.ts",
+	"files": ["dist"],
+	"scripts": {
+		"build": "tsup",
+		"dev": "tsup --watch",
+		"lint": "biome check .",
+		"lint:write": "biome check . --write",
+		"prepare": "simple-git-hooks && npm run build",
+		"test": "pnpm run /^test:/",
+		"test:e2e": "playwright test",
+		"test:unit": "vitest run",
+		"bump": "npx bumpp"
+	},
+	"simple-git-hooks": {
+		"pre-commit": "npx nano-staged"
+	},
+	"nano-staged": {
+		"*.{js,jsx,ts,tsx,mjs,cjs}": [
+			"biome check --write --no-errors-on-unmatched"
+		]
+	},
+	"dependencies": {
+		"assert": "^2.1.0",
+		"browserify-zlib": "^0.2.0",
+		"buffer": "^5.7.1",
+		"console-browserify": "^1.2.0",
+		"constants-browserify": "^1.0.0",
+		"crypto-browserify": "^3.12.0",
+		"domain-browser": "^5.7.0",
+		"events": "^3.3.0",
+		"https-browserify": "^1.0.0",
+		"os-browserify": "^0.3.0",
+		"path-browserify": "^1.0.1",
+		"process": "^0.11.10",
+		"punycode": "^2.3.1",
+		"querystring-es3": "^0.2.1",
+		"readable-stream": "^4.5.2",
+		"stream-browserify": "^3.0.0",
+		"stream-http": "^3.2.0",
+		"string_decoder": "^1.3.0",
+		"timers-browserify": "^2.0.12",
+		"tty-browserify": "^0.0.1",
+		"url": "^0.11.4",
+		"util": "^0.12.5",
+		"vm-browserify": "^1.1.2"
+	},
+	"devDependencies": {
+		"@biomejs/biome": "^1.9.4",
+		"@playwright/test": "^1.48.1",
+		"@rsbuild/core": "^1.0.15",
+		"@types/node": "^20.16.13",
+		"nano-staged": "^0.8.0",
+		"playwright": "^1.48.1",
+		"simple-git-hooks": "^2.11.1",
+		"tsup": "^8.3.0",
+		"typescript": "^5.6.3",
+		"vitest": "^2.1.3"
+	},
+	"peerDependencies": {
+		"@rsbuild/core": "1.x || ^1.0.1-beta.0"
+	},
+	"peerDependenciesMeta": {
+		"@rsbuild/core": {
+			"optional": true
+		}
+	},
+	"packageManager": "pnpm@9.12.2",
+	"publishConfig": {
+		"access": "public",
+		"registry": "https://registry.npmjs.org/"
+	}
+}

package/dist/ProtocolImportsPlugin-HUSWFIAE.js

@@ -1,23 +0,0 @@
-import "./chunk-6C3VEZWH.js";
-
-// src/ProtocolImportsPlugin.ts
-var ProtocolImportsPlugin = class {
-  apply(compiler) {
-    compiler.hooks.normalModuleFactory.tap(
-      "NormalModuleReplacementPlugin",
-      (nmf) => {
-        nmf.hooks.beforeResolve.tap(
-          "NormalModuleReplacementPlugin",
-          (resource) => {
-            if (/^node:/.test(resource.request)) {
-              resource.request = resource.request.replace(/^node:/, "");
-            }
-          }
-        );
-      }
-    );
-  }
-};
-export {
-  ProtocolImportsPlugin
-};

package/dist/chunk-6C3VEZWH.js

@@ -1,9 +0,0 @@
-var __defProp = Object.defineProperty;
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
-};
-
-export {
-  __export
-};