@rsbuild/plugin-node-polyfill 1.1.0 → 1.2.0

package/README.md

@@ -28,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
@@ -47,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:
@@ -58,7 +58,7 @@ pluginNodePolyfill({
     Buffer: false,
     process: false,
   },
-});
+})
 ```
 
 ### Modules
@@ -95,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
@@ -116,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
@@ -131,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:**
@@ -142,7 +142,7 @@ type Globals = {
 const defaultGlobals = {
   Buffer: true,
   process: true,
-};
+}
 ```
 
 ### protocolImports
@@ -157,7 +157,7 @@ For example, if you disable `protocolImports`, modules such as `node:path`, `nod
 ```ts
 pluginNodePolyfill({
   protocolImports: false,
-});
+})
 ```
 
 ### include
@@ -169,8 +169,8 @@ Specify an array of modules for which polyfills should be injected. If this opti
 
 ```ts
 pluginNodePolyfill({
-  include: ["buffer", "crypto"], // Only "buffer" and "crypto" modules will be polyfilled.
-});
+  include: ['buffer', 'crypto'], // Only "buffer" and "crypto" modules will be polyfilled.
+})
 ```
 
 ### exclude
@@ -182,10 +182,30 @@ Specify an array of modules for which polyfills should not be injected from the
 
 ```ts
 pluginNodePolyfill({
-  exclude: ["http", "https"], // All modules except "http" and "https" will be polyfilled.
-});
+  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

@@ -21,9 +21,12 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var src_exports = {};
 __export(src_exports, {
   PLUGIN_NODE_POLYFILL_NAME: () => PLUGIN_NODE_POLYFILL_NAME,
+  builtinMappingResolved: () => builtinMappingResolved,
   getProvideGlobals: () => getProvideGlobals,
   getResolveFallback: () => getResolveFallback,
-  pluginNodePolyfill: () => pluginNodePolyfill
+  pluginNodePolyfill: () => pluginNodePolyfill,
+  resolvePolyfill: () => resolvePolyfill,
+  resolvedPolyfillToModules: () => resolvedPolyfillToModules
 });
 module.exports = __toCommonJS(src_exports);
 
@@ -51,113 +54,78 @@ var ProtocolImportsPlugin = class {
 };
 
 // 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
-});
 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 resolvePolyfill = (libPath, overrides) => {
+  if (overrides?.[libPath] !== void 0) {
+    return overrides[libPath];
+  }
+  return builtinMappingResolved[libPath];
+};
 var getResolveFallback = ({
   protocolImports,
   exclude,
-  include
+  include,
+  overrides
 }) => {
   if (exclude && include) {
     throw new Error("`include` is mutually exclusive with `exclude`.");
   }
-  const resolvedNodeLibs = include ? include : Object.keys(libs_exports).filter((name) => {
+  const resolvedNodeLibs = include ? include : Object.keys(builtinMappingResolved).filter((name) => {
     return !(exclude || []).includes(name);
   });
   const fallback = {};
   for (const name of resolvedNodeLibs) {
-    const libPath = libs_exports[name];
+    const libPath = resolvePolyfill(name, overrides);
     fallback[name] = libPath ?? false;
     if (protocolImports) {
       fallback[`node:${name}`] = fallback[name];
@@ -165,19 +133,19 @@ var getResolveFallback = ({
   }
   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, include, exclude } = options;
+  const { protocolImports = true, include, exclude, overrides } = options;
   return {
     name: PLUGIN_NODE_POLYFILL_NAME,
     setup(api) {
@@ -186,9 +154,17 @@ function pluginNodePolyfill(options = {}) {
           return;
         }
         chain.resolve.fallback.merge(
-          getResolveFallback({ protocolImports, include, exclude })
+          getResolveFallback({
+            protocolImports,
+            include,
+            exclude,
+            overrides
+          })
+        );
+        const provideGlobals = await getProvideGlobals(
+          options.globals,
+          overrides
         );
-        const provideGlobals = await getProvideGlobals(options.globals);
         if (Object.keys(provideGlobals).length) {
           chain.plugin("node-polyfill-provide").use(bundler.ProvidePlugin, [provideGlobals]);
         }
@@ -202,7 +178,10 @@ function pluginNodePolyfill(options = {}) {
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   PLUGIN_NODE_POLYFILL_NAME,
+  builtinMappingResolved,
   getProvideGlobals,
   getResolveFallback,
-  pluginNodePolyfill
+  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;
@@ -32,10 +74,16 @@ type PluginNodePolyfillOptions = {
      * @default undefined
      */
     include?: string[];
+    /**
+     * Override the default polyfills for specific modules.
+     * @default undefined
+     */
+    overrides?: Record<string, string | false>;
 };
-declare const getResolveFallback: ({ protocolImports, exclude, include, }: Pick<PluginNodePolyfillOptions, "protocolImports" | "exclude" | "include">) => Record<string, string | false>;
-declare const getProvideGlobals: (globals?: Globals) => Promise<Record<string, string | string[]>>;
+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, getProvideGlobals, getResolveFallback, 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;
@@ -32,10 +74,16 @@ type PluginNodePolyfillOptions = {
      * @default undefined
      */
     include?: string[];
+    /**
+     * Override the default polyfills for specific modules.
+     * @default undefined
+     */
+    overrides?: Record<string, string | false>;
 };
-declare const getResolveFallback: ({ protocolImports, exclude, include, }: Pick<PluginNodePolyfillOptions, "protocolImports" | "exclude" | "include">) => Record<string, string | false>;
-declare const getProvideGlobals: (globals?: Globals) => Promise<Record<string, string | string[]>>;
+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, getProvideGlobals, getResolveFallback, pluginNodePolyfill };
+export { PLUGIN_NODE_POLYFILL_NAME, type PluginNodePolyfillOptions, builtinMappingResolved, getProvideGlobals, getResolveFallback, pluginNodePolyfill, resolvePolyfill, resolvedPolyfillToModules };

package/dist/index.js

@@ -1,9 +1,3 @@
-var __defProp = Object.defineProperty;
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
-};
-
 // src/ProtocolImportsPlugin.ts
 var ProtocolImportsPlugin = class {
   apply(compiler) {
@@ -24,113 +18,78 @@ var ProtocolImportsPlugin = class {
 };
 
 // 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 resolvePolyfill = (libPath, overrides) => {
+  if (overrides?.[libPath] !== void 0) {
+    return overrides[libPath];
+  }
+  return builtinMappingResolved[libPath];
+};
 var getResolveFallback = ({
   protocolImports,
   exclude,
-  include
+  include,
+  overrides
 }) => {
   if (exclude && include) {
     throw new Error("`include` is mutually exclusive with `exclude`.");
   }
-  const resolvedNodeLibs = include ? include : Object.keys(libs_exports).filter((name) => {
+  const resolvedNodeLibs = include ? include : Object.keys(builtinMappingResolved).filter((name) => {
     return !(exclude || []).includes(name);
   });
   const fallback = {};
   for (const name of resolvedNodeLibs) {
-    const libPath = libs_exports[name];
+    const libPath = resolvePolyfill(name, overrides);
     fallback[name] = libPath ?? false;
     if (protocolImports) {
       fallback[`node:${name}`] = fallback[name];
@@ -138,19 +97,19 @@ var getResolveFallback = ({
   }
   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, include, exclude } = options;
+  const { protocolImports = true, include, exclude, overrides } = options;
   return {
     name: PLUGIN_NODE_POLYFILL_NAME,
     setup(api) {
@@ -159,9 +118,17 @@ function pluginNodePolyfill(options = {}) {
           return;
         }
         chain.resolve.fallback.merge(
-          getResolveFallback({ protocolImports, include, exclude })
+          getResolveFallback({
+            protocolImports,
+            include,
+            exclude,
+            overrides
+          })
+        );
+        const provideGlobals = await getProvideGlobals(
+          options.globals,
+          overrides
         );
-        const provideGlobals = await getProvideGlobals(options.globals);
         if (Object.keys(provideGlobals).length) {
           chain.plugin("node-polyfill-provide").use(bundler.ProvidePlugin, [provideGlobals]);
         }
@@ -174,7 +141,10 @@ function pluginNodePolyfill(options = {}) {
 }
 export {
   PLUGIN_NODE_POLYFILL_NAME,
+  builtinMappingResolved,
   getProvideGlobals,
   getResolveFallback,
-  pluginNodePolyfill
+  pluginNodePolyfill,
+  resolvePolyfill,
+  resolvedPolyfillToModules
 };

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@rsbuild/plugin-node-polyfill",
-	"version": "1.1.0",
+	"version": "1.2.0",
 	"repository": "https://github.com/rspack-contrib/rsbuild-plugin-node-polyfill",
 	"license": "MIT",
 	"type": "module",