@rsbuild/plugin-node-polyfill 1.1.0 → 1.3.0

package/README.md

@@ -186,6 +186,39 @@ pluginNodePolyfill({
 });
 ```
 
+### overrides
+
+Override the default polyfills for specific modules.
+
+- **Type:** `Record<string, string>`
+- **Default:** `{}`
+
+```ts
+pluginNodePolyfill({
+  overrides: {
+    fs: "memfs",
+  },
+});
+```
+
+### force
+
+By default, the plugin only polyfills the browser-side code. If you want to polyfill the server-side code as well (when `output.target` is `node`), you can set the `force` option to `true`.
+
+- **Type:** `boolean`
+- **Default:** `false`
+
+```ts
+pluginNodePolyfill({
+  force: true,
+});
+```
+
+## 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/ProtocolImportsPlugin.d.ts

@@ -0,0 +1,4 @@
+import type { Rspack } from '@rsbuild/core';
+export declare class ProtocolImportsPlugin {
+    apply(compiler: Rspack.Compiler): void;
+}

package/dist/index.cjs

@@ -1,208 +1,159 @@
 "use strict";
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
-};
-var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (let key of __getOwnPropNames(from))
-      if (!__hasOwnProp.call(to, key) && key !== except)
-        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
-  }
-  return to;
-};
-var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-
-// src/index.ts
-var src_exports = {};
-__export(src_exports, {
-  PLUGIN_NODE_POLYFILL_NAME: () => PLUGIN_NODE_POLYFILL_NAME,
-  getProvideGlobals: () => getProvideGlobals,
-  getResolveFallback: () => getResolveFallback,
-  pluginNodePolyfill: () => pluginNodePolyfill
+const __rslib_import_meta_url__ = /*#__PURE__*/ function() {
+    return 'undefined' == typeof document ? new (require('url'.replace('', ''))).URL('file:' + __filename).href : document.currentScript && document.currentScript.src || new URL('main.js', document.baseURI).href;
+}();
+// The require scope
+var __webpack_require__ = {};
+/************************************************************************/ // webpack/runtime/define_property_getters
+(()=>{
+    __webpack_require__.d = function(exports1, definition) {
+        for(var key in definition)if (__webpack_require__.o(definition, key) && !__webpack_require__.o(exports1, key)) Object.defineProperty(exports1, key, {
+            enumerable: true,
+            get: definition[key]
+        });
+    };
+})();
+// webpack/runtime/has_own_property
+(()=>{
+    __webpack_require__.o = function(obj, prop) {
+        return Object.prototype.hasOwnProperty.call(obj, prop);
+    };
+})();
+// webpack/runtime/make_namespace_object
+(()=>{
+    // define __esModule on exports
+    __webpack_require__.r = function(exports1) {
+        if ('undefined' != typeof Symbol && Symbol.toStringTag) Object.defineProperty(exports1, Symbol.toStringTag, {
+            value: 'Module'
+        });
+        Object.defineProperty(exports1, '__esModule', {
+            value: true
+        });
+    };
+})();
+/************************************************************************/ var __webpack_exports__ = {};
+// ESM COMPAT FLAG
+__webpack_require__.r(__webpack_exports__);
+// EXPORTS
+__webpack_require__.d(__webpack_exports__, {
+    PLUGIN_NODE_POLYFILL_NAME: ()=>/* binding */ PLUGIN_NODE_POLYFILL_NAME,
+    resolvedPolyfillToModules: ()=>/* reexport */ resolvedPolyfillToModules,
+    builtinMappingResolved: ()=>/* reexport */ builtinMappingResolved,
+    getResolveFallback: ()=>/* binding */ getResolveFallback,
+    pluginNodePolyfill: ()=>/* binding */ pluginNodePolyfill,
+    resolvePolyfill: ()=>/* binding */ resolvePolyfill,
+    getProvideGlobals: ()=>/* binding */ getProvideGlobals
 });
-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 = 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:/, "");
-            }
-          }
-        );
-      }
-    );
-  }
+class ProtocolImportsPlugin {
+    apply(compiler) {
+        compiler.hooks.normalModuleFactory.tap('NormalModuleReplacementPlugin', (nmf)=>{
+            nmf.hooks.beforeResolve.tap('NormalModuleReplacementPlugin', (resource)=>{
+                // Remove the `node:` prefix
+                // see: https://github.com/webpack/webpack/issues/14166
+                if (/^node:/.test(resource.request)) resource.request = resource.request.replace(/^node:/, '');
+            });
+        });
+    }
+}
+const external_node_module_namespaceObject = require("node:module");
+const libs_require = (0, external_node_module_namespaceObject.createRequire)(__rslib_import_meta_url__);
+const builtinMappingResolved = {
+    assert: libs_require.resolve('assert/'),
+    buffer: libs_require.resolve('buffer/'),
+    child_process: null,
+    cluster: null,
+    console: libs_require.resolve('console-browserify'),
+    constants: libs_require.resolve('constants-browserify'),
+    crypto: libs_require.resolve('crypto-browserify'),
+    dgram: null,
+    dns: null,
+    domain: libs_require.resolve('domain-browser'),
+    events: libs_require.resolve('events/'),
+    fs: null,
+    http: libs_require.resolve('stream-http'),
+    https: libs_require.resolve('https-browserify'),
+    module: null,
+    net: null,
+    os: libs_require.resolve('os-browserify/browser.js'),
+    path: libs_require.resolve('path-browserify'),
+    punycode: libs_require.resolve('punycode/'),
+    process: libs_require.resolve('process/browser.js'),
+    querystring: libs_require.resolve('querystring-es3/'),
+    readline: null,
+    repl: null,
+    stream: libs_require.resolve('stream-browserify'),
+    _stream_duplex: libs_require.resolve('readable-stream/lib/_stream_duplex.js'),
+    _stream_passthrough: libs_require.resolve('readable-stream/lib/_stream_passthrough.js'),
+    _stream_readable: libs_require.resolve('readable-stream/lib/_stream_readable.js'),
+    _stream_transform: libs_require.resolve('readable-stream/lib/_stream_transform.js'),
+    _stream_writable: libs_require.resolve('readable-stream/lib/_stream_writable.js'),
+    string_decoder: libs_require.resolve('string_decoder/'),
+    sys: libs_require.resolve('util/util.js'),
+    timers: libs_require.resolve('timers-browserify'),
+    tls: null,
+    tty: libs_require.resolve('tty-browserify'),
+    url: libs_require.resolve('url/'),
+    util: libs_require.resolve('util/util.js'),
+    vm: libs_require.resolve('vm-browserify'),
+    zlib: libs_require.resolve('browserify-zlib')
 };
-
-// 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 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,
-  exclude,
-  include
-}) => {
-  if (exclude && include) {
-    throw new Error("`include` is mutually exclusive with `exclude`.");
-  }
-  const resolvedNodeLibs = include ? include : Object.keys(libs_exports).filter((name) => {
-    return !(exclude || []).includes(name);
-  });
-  const fallback = {};
-  for (const name of resolvedNodeLibs) {
-    const libPath = libs_exports[name];
-    fallback[name] = libPath ?? false;
-    if (protocolImports) {
-      fallback[`node:${name}`] = fallback[name];
+const resolvedPolyfillToModules = Object.fromEntries(Object.entries(builtinMappingResolved).filter(([key])=>null !== key).map(([key, value])=>[
+        value,
+        key
+    ]));
+const resolvePolyfill = (libPath, overrides)=>{
+    if ((null == overrides ? void 0 : overrides[libPath]) !== void 0) return overrides[libPath];
+    return builtinMappingResolved[libPath];
+};
+const 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)=>!(exclude || []).includes(name));
+    const fallback = {};
+    for (const name of resolvedNodeLibs){
+        const libPath = resolvePolyfill(name, overrides);
+        fallback[name] = libPath ?? false;
+        if (protocolImports) fallback[`node:${name}`] = fallback[name];
     }
-  }
-  return fallback;
+    return fallback;
 };
-var getProvideGlobals = async (globals) => {
-  const result = {};
-  if (globals?.Buffer !== false) {
-    result.Buffer = [buffer, "Buffer"];
-  }
-  if (globals?.process !== false) {
-    result.process = [process];
-  }
-  return result;
+const getProvideGlobals = async (globals, overrides)=>{
+    const result = {};
+    if ((null == globals ? void 0 : globals.Buffer) !== false) result.Buffer = [
+        resolvePolyfill('buffer', overrides),
+        'Buffer'
+    ];
+    if ((null == globals ? void 0 : globals.process) !== false) result.process = [
+        resolvePolyfill('process', overrides)
+    ];
+    return result;
 };
-var PLUGIN_NODE_POLYFILL_NAME = "rsbuild:node-polyfill";
+const PLUGIN_NODE_POLYFILL_NAME = 'rsbuild:node-polyfill';
 function pluginNodePolyfill(options = {}) {
-  const { protocolImports = true, include, exclude } = options;
-  return {
-    name: PLUGIN_NODE_POLYFILL_NAME,
-    setup(api) {
-      api.modifyBundlerChain(async (chain, { isServer, bundler }) => {
-        if (isServer) {
-          return;
-        }
-        chain.resolve.fallback.merge(
-          getResolveFallback({ protocolImports, include, exclude })
-        );
-        const provideGlobals = await getProvideGlobals(options.globals);
-        if (Object.keys(provideGlobals).length) {
-          chain.plugin("node-polyfill-provide").use(bundler.ProvidePlugin, [provideGlobals]);
+    const { protocolImports = true, include, exclude, overrides, force = false } = options;
+    return {
+        name: PLUGIN_NODE_POLYFILL_NAME,
+        setup (api) {
+            api.modifyBundlerChain(async (chain, { isServer, bundler })=>{
+                // The server bundle does not require node polyfill
+                if (isServer && !force) return;
+                // module polyfill
+                chain.resolve.fallback.merge(getResolveFallback({
+                    protocolImports,
+                    include: 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) chain.plugin('protocol-imports').use(ProtocolImportsPlugin);
+            });
         }
-        if (protocolImports) {
-          chain.plugin("protocol-imports").use(ProtocolImportsPlugin);
-        }
-      });
-    }
-  };
+    };
 }
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  PLUGIN_NODE_POLYFILL_NAME,
-  getProvideGlobals,
-  getResolveFallback,
-  pluginNodePolyfill
+var __webpack_export_target__ = exports;
+for(var __webpack_i__ in __webpack_exports__)__webpack_export_target__[__webpack_i__] = __webpack_exports__[__webpack_i__];
+if (__webpack_exports__.__esModule) Object.defineProperty(__webpack_export_target__, '__esModule', {
+    value: true
 });

package/dist/index.d.ts

@@ -1,10 +1,9 @@
-import { RsbuildPlugin } from '@rsbuild/core';
-
+import type { RsbuildPlugin } from '@rsbuild/core';
 type Globals = {
     process?: boolean;
     Buffer?: boolean;
 };
-type PluginNodePolyfillOptions = {
+export type PluginNodePolyfillOptions = {
     /**
      * Whether to provide polyfill of globals.
      * @default
@@ -32,10 +31,22 @@ type PluginNodePolyfillOptions = {
      * @default undefined
      */
     include?: string[];
+    /**
+     * Override the default polyfills for specific modules.
+     * @default undefined
+     */
+    overrides?: Record<string, string | false>;
+    /**
+     * By default, the plugin only polyfills the browser-side code.
+     * If you want to polyfill the server-side code as well (when `output.target` is `node`),
+     * you can set the `force` option to `true`.
+     * @default false
+     */
+    force?: boolean;
 };
-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 PLUGIN_NODE_POLYFILL_NAME = "rsbuild:node-polyfill";
-declare function pluginNodePolyfill(options?: PluginNodePolyfillOptions): RsbuildPlugin;
-
-export { PLUGIN_NODE_POLYFILL_NAME, type PluginNodePolyfillOptions, getProvideGlobals, getResolveFallback, pluginNodePolyfill };
+export declare const resolvePolyfill: (libPath: string, overrides?: PluginNodePolyfillOptions["overrides"]) => string | false | null;
+export declare const getResolveFallback: ({ protocolImports, exclude, include, overrides, }: Pick<PluginNodePolyfillOptions, "protocolImports" | "exclude" | "include" | "overrides">) => Record<string, string | false>;
+export declare const getProvideGlobals: (globals?: Globals, overrides?: PluginNodePolyfillOptions["overrides"]) => Promise<Record<string, string | string[]>>;
+export declare const PLUGIN_NODE_POLYFILL_NAME = "rsbuild:node-polyfill";
+export declare function pluginNodePolyfill(options?: PluginNodePolyfillOptions): RsbuildPlugin;
+export { builtinMappingResolved, resolvedPolyfillToModules, } from './libs.js';

package/dist/index.js

@@ -1,180 +1,109 @@
-var __defProp = Object.defineProperty;
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
+import * as __WEBPACK_EXTERNAL_MODULE_node_module__ from "node:module";
+class ProtocolImportsPlugin {
+    apply(compiler) {
+        compiler.hooks.normalModuleFactory.tap('NormalModuleReplacementPlugin', (nmf)=>{
+            nmf.hooks.beforeResolve.tap('NormalModuleReplacementPlugin', (resource)=>{
+                // Remove the `node:` prefix
+                // see: https://github.com/webpack/webpack/issues/14166
+                if (/^node:/.test(resource.request)) resource.request = resource.request.replace(/^node:/, '');
+            });
+        });
+    }
+}
+const libs_require = (0, __WEBPACK_EXTERNAL_MODULE_node_module__.createRequire)(import.meta.url);
+const builtinMappingResolved = {
+    assert: libs_require.resolve('assert/'),
+    buffer: libs_require.resolve('buffer/'),
+    child_process: null,
+    cluster: null,
+    console: libs_require.resolve('console-browserify'),
+    constants: libs_require.resolve('constants-browserify'),
+    crypto: libs_require.resolve('crypto-browserify'),
+    dgram: null,
+    dns: null,
+    domain: libs_require.resolve('domain-browser'),
+    events: libs_require.resolve('events/'),
+    fs: null,
+    http: libs_require.resolve('stream-http'),
+    https: libs_require.resolve('https-browserify'),
+    module: null,
+    net: null,
+    os: libs_require.resolve('os-browserify/browser.js'),
+    path: libs_require.resolve('path-browserify'),
+    punycode: libs_require.resolve('punycode/'),
+    process: libs_require.resolve('process/browser.js'),
+    querystring: libs_require.resolve('querystring-es3/'),
+    readline: null,
+    repl: null,
+    stream: libs_require.resolve('stream-browserify'),
+    _stream_duplex: libs_require.resolve('readable-stream/lib/_stream_duplex.js'),
+    _stream_passthrough: libs_require.resolve('readable-stream/lib/_stream_passthrough.js'),
+    _stream_readable: libs_require.resolve('readable-stream/lib/_stream_readable.js'),
+    _stream_transform: libs_require.resolve('readable-stream/lib/_stream_transform.js'),
+    _stream_writable: libs_require.resolve('readable-stream/lib/_stream_writable.js'),
+    string_decoder: libs_require.resolve('string_decoder/'),
+    sys: libs_require.resolve('util/util.js'),
+    timers: libs_require.resolve('timers-browserify'),
+    tls: null,
+    tty: libs_require.resolve('tty-browserify'),
+    url: libs_require.resolve('url/'),
+    util: libs_require.resolve('util/util.js'),
+    vm: libs_require.resolve('vm-browserify'),
+    zlib: libs_require.resolve('browserify-zlib')
 };
-
-// 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:/, "");
-            }
-          }
-        );
-      }
-    );
-  }
+const resolvedPolyfillToModules = Object.fromEntries(Object.entries(builtinMappingResolved).filter(([key])=>null !== key).map(([key, value])=>[
+        value,
+        key
+    ]));
+const resolvePolyfill = (libPath, overrides)=>{
+    if ((null == overrides ? void 0 : overrides[libPath]) !== void 0) return overrides[libPath];
+    return builtinMappingResolved[libPath];
 };
-
-// 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 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,
-  exclude,
-  include
-}) => {
-  if (exclude && include) {
-    throw new Error("`include` is mutually exclusive with `exclude`.");
-  }
-  const resolvedNodeLibs = include ? include : Object.keys(libs_exports).filter((name) => {
-    return !(exclude || []).includes(name);
-  });
-  const fallback = {};
-  for (const name of resolvedNodeLibs) {
-    const libPath = libs_exports[name];
-    fallback[name] = libPath ?? false;
-    if (protocolImports) {
-      fallback[`node:${name}`] = fallback[name];
+const 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)=>!(exclude || []).includes(name));
+    const fallback = {};
+    for (const name of resolvedNodeLibs){
+        const libPath = resolvePolyfill(name, overrides);
+        fallback[name] = libPath ?? false;
+        if (protocolImports) fallback[`node:${name}`] = fallback[name];
     }
-  }
-  return fallback;
+    return fallback;
 };
-var getProvideGlobals = async (globals) => {
-  const result = {};
-  if (globals?.Buffer !== false) {
-    result.Buffer = [buffer, "Buffer"];
-  }
-  if (globals?.process !== false) {
-    result.process = [process];
-  }
-  return result;
+const getProvideGlobals = async (globals, overrides)=>{
+    const result = {};
+    if ((null == globals ? void 0 : globals.Buffer) !== false) result.Buffer = [
+        resolvePolyfill('buffer', overrides),
+        'Buffer'
+    ];
+    if ((null == globals ? void 0 : globals.process) !== false) result.process = [
+        resolvePolyfill('process', overrides)
+    ];
+    return result;
 };
-var PLUGIN_NODE_POLYFILL_NAME = "rsbuild:node-polyfill";
+const PLUGIN_NODE_POLYFILL_NAME = 'rsbuild:node-polyfill';
 function pluginNodePolyfill(options = {}) {
-  const { protocolImports = true, include, exclude } = options;
-  return {
-    name: PLUGIN_NODE_POLYFILL_NAME,
-    setup(api) {
-      api.modifyBundlerChain(async (chain, { isServer, bundler }) => {
-        if (isServer) {
-          return;
-        }
-        chain.resolve.fallback.merge(
-          getResolveFallback({ protocolImports, include, exclude })
-        );
-        const provideGlobals = await getProvideGlobals(options.globals);
-        if (Object.keys(provideGlobals).length) {
-          chain.plugin("node-polyfill-provide").use(bundler.ProvidePlugin, [provideGlobals]);
+    const { protocolImports = true, include, exclude, overrides, force = false } = options;
+    return {
+        name: PLUGIN_NODE_POLYFILL_NAME,
+        setup (api) {
+            api.modifyBundlerChain(async (chain, { isServer, bundler })=>{
+                // The server bundle does not require node polyfill
+                if (isServer && !force) return;
+                // module polyfill
+                chain.resolve.fallback.merge(getResolveFallback({
+                    protocolImports,
+                    include: 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) chain.plugin('protocol-imports').use(ProtocolImportsPlugin);
+            });
         }
-        if (protocolImports) {
-          chain.plugin("protocol-imports").use(ProtocolImportsPlugin);
-        }
-      });
-    }
-  };
+    };
 }
-export {
-  PLUGIN_NODE_POLYFILL_NAME,
-  getProvideGlobals,
-  getResolveFallback,
-  pluginNodePolyfill
-};
+export { PLUGIN_NODE_POLYFILL_NAME, builtinMappingResolved, getProvideGlobals, getResolveFallback, pluginNodePolyfill, resolvePolyfill, resolvedPolyfillToModules };

package/dist/libs.d.ts

@@ -0,0 +1,41 @@
+export 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;
+};
+export declare const resolvedPolyfillToModules: any;

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@rsbuild/plugin-node-polyfill",
-	"version": "1.1.0",
+	"version": "1.3.0",
 	"repository": "https://github.com/rspack-contrib/rsbuild-plugin-node-polyfill",
 	"license": "MIT",
 	"type": "module",
@@ -16,8 +16,8 @@
 	"types": "./dist/index.d.ts",
 	"files": ["dist"],
 	"scripts": {
-		"build": "tsup",
-		"dev": "tsup --watch",
+		"build": "rslib build",
+		"dev": "rslib build --watch",
 		"lint": "biome check .",
 		"lint:write": "biome check . --write",
 		"prepare": "simple-git-hooks && npm run build",
@@ -40,7 +40,7 @@
 		"buffer": "^5.7.1",
 		"console-browserify": "^1.2.0",
 		"constants-browserify": "^1.0.0",
-		"crypto-browserify": "^3.12.0",
+		"crypto-browserify": "^3.12.1",
 		"domain-browser": "^5.7.0",
 		"events": "^3.3.0",
 		"https-browserify": "^1.0.0",
@@ -61,25 +61,25 @@
 	},
 	"devDependencies": {
 		"@biomejs/biome": "^1.9.4",
-		"@playwright/test": "^1.48.1",
-		"@rsbuild/core": "^1.0.15",
-		"@types/node": "^20.16.13",
+		"@playwright/test": "^1.49.0",
+		"@rsbuild/core": "^1.1.6",
+		"@rslib/core": "^0.1.1",
+		"@types/node": "^22.10.1",
 		"nano-staged": "^0.8.0",
-		"playwright": "^1.48.1",
+		"playwright": "^1.49.0",
 		"simple-git-hooks": "^2.11.1",
-		"tsup": "^8.3.0",
-		"typescript": "^5.6.3",
-		"vitest": "^2.1.3"
+		"typescript": "^5.7.2",
+		"vitest": "^2.1.6"
 	},
 	"peerDependencies": {
-		"@rsbuild/core": "1.x || ^1.0.1-beta.0"
+		"@rsbuild/core": "1.x"
 	},
 	"peerDependenciesMeta": {
 		"@rsbuild/core": {
 			"optional": true
 		}
 	},
-	"packageManager": "pnpm@9.12.2",
+	"packageManager": "pnpm@9.14.4",
 	"publishConfig": {
 		"access": "public",
 		"registry": "https://registry.npmjs.org/"

package/dist/index.d.cts

@@ -1,41 +0,0 @@
-import { RsbuildPlugin } from '@rsbuild/core';
-
-type Globals = {
-    process?: boolean;
-    Buffer?: boolean;
-};
-type PluginNodePolyfillOptions = {
-    /**
-     * Whether to provide polyfill of globals.
-     * @default
-     * {
-     *   Buffer: true,
-     *   process: true,
-     * }
-     */
-    globals?: Globals;
-    /**
-     * Whether to polyfill Node.js builtin modules starting with `node:`.
-     * @see https://nodejs.org/api/esm.html#node-imports
-     * @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[];
-};
-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 PLUGIN_NODE_POLYFILL_NAME = "rsbuild:node-polyfill";
-declare function pluginNodePolyfill(options?: PluginNodePolyfillOptions): RsbuildPlugin;
-
-export { PLUGIN_NODE_POLYFILL_NAME, type PluginNodePolyfillOptions, getProvideGlobals, getResolveFallback, pluginNodePolyfill };