rolldown-plugin-require-cjs 0.1.5 → 0.2.0

package/README.md

@@ -18,6 +18,44 @@ See more: https://x.com/sanxiaozhizi/status/1968580207322808812
 npm i rolldown-plugin-require-cjs
 ```
 
+## Options
+
+```ts
+export interface Options {
+  include?: Array<string | RegExp> | string | RegExp
+  exclude?: Array<string | RegExp> | string | RegExp
+  order?: 'pre' | 'post' | undefined
+  /**
+   * A function to determine whether a module should be transformed.
+   * Return `true` to force transformation, `false` to skip transformation,
+   * or `undefined` to let the plugin decide automatically.
+   */
+  shouldTransform?: string[] | TransformFn
+  /**
+   * Whether to transform Node.js built-in modules (e.g., `fs`, `path`)
+   * to `process.getBuiltinModule()` calls, which has the best performance.
+   *
+   * Note: `process.getBuiltinModule` is available since Node.js 20.16.0 and 22.3.0.
+   */
+  builtinNodeModules?: boolean
+}
+
+/**
+ * @returns A boolean or a promise that resolves to a boolean,
+ * or `undefined` to let the plugin decide automatically.
+ */
+export type TransformFn = (
+  /**
+   * The module ID (path) being imported.
+   */
+  id: string,
+  /**
+   * The module ID (path) of the importer.
+   */
+  importer: string,
+) => Awaitable<boolean | undefined | void>
+```
+
 ## Example
 
 ```ts

package/dist/index.d.ts

@@ -3,6 +3,10 @@ import { Plugin } from "rolldown";
 //#region src/options.d.ts
 type FilterPattern = Array<string | RegExp> | string | RegExp;
 type Awaitable<T> = T | Promise<T>;
+/**
+* @returns A boolean or a promise that resolves to a boolean,
+* or `undefined` to let the plugin decide automatically.
+*/
 type TransformFn = (id: string, importer: string) => Awaitable<boolean | undefined | void>;
 interface Options {
   include?: FilterPattern;
@@ -12,12 +16,15 @@ interface Options {
   * A function to determine whether a module should be transformed.
   * Return `true` to force transformation, `false` to skip transformation,
   * or `undefined` to let the plugin decide automatically.
-  *
-  * @param id The module ID (path) being imported.
-  * @param importer The module ID (path) of the importer.
-  * @returns A boolean or a promise that resolves to a boolean, or `undefined`.
   */
   shouldTransform?: string[] | TransformFn;
+  /**
+  * Whether to transform Node.js built-in modules (e.g., `fs`, `path`)
+  * to `process.getBuiltinModule()` calls, which has the best performance.
+  *
+  * Note: `process.getBuiltinModule` is available since Node.js 20.16.0 and 22.3.0.
+  */
+  builtinNodeModules?: boolean;
 }
 type Overwrite<T, U> = Pick<T, Exclude<keyof T, keyof U>> & U;
 type OptionsResolved = Overwrite<Required<Options>, Pick<Options, "order"> & {

package/dist/index.js

@@ -1,4 +1,4 @@
-import { createRequire } from "node:module";
+import { builtinModules, createRequire } from "node:module";
 import { readFile } from "node:fs/promises";
 import path from "node:path";
 import { init, parse } from "cjs-module-lexer";
@@ -21,7 +21,8 @@ function resolveOptions(options) {
 		include: options.include || [/\.[cm]?[jt]sx?$/],
 		exclude: options.exclude || [/node_modules/, /\.d\.[cm]?ts$/],
 		order: "order" in options ? options.order : "pre",
-		shouldTransform: options.shouldTransform
+		shouldTransform: options.shouldTransform,
+		builtinNodeModules: !!options.builtinNodeModules
 	};
 }
 
@@ -29,12 +30,14 @@ function resolveOptions(options) {
 //#region src/index.ts
 let initted = false;
 function RequireCJS(userOptions = {}) {
-	const { include, exclude, order, shouldTransform } = resolveOptions(userOptions);
+	const { include, exclude, order, shouldTransform, builtinNodeModules } = resolveOptions(userOptions);
 	return {
 		name: "rolldown-plugin-require-cjs",
 		async buildStart() {
-			await init();
-			initted = true;
+			if (!initted) {
+				await init();
+				initted = true;
+			}
 		},
 		options(options) {
 			if (options.platform !== "node") this.error("`rolldown-plugin-require-cjs` plugin is designed only for the Node.js environment. Please make sure to set `platform: \"node\"` in the options.");
@@ -58,11 +61,13 @@ function RequireCJS(userOptions = {}) {
 				for (const stmt of body) if (stmt.type === "ImportDeclaration") {
 					if (stmt.importKind === "type") continue;
 					const source = stmt.source.value;
-					const resolution = await this.resolve(source, id);
+					const isBuiltinModule = builtinNodeModules && (builtinModules.includes(source) || source.startsWith("node:"));
+					const resolution = isBuiltinModule ? null : await this.resolve(source, id);
 					if (resolution && resolution.external === false) continue;
-					if (!(await shouldTransform?.(source, id) ?? await isPureCJS(source, id))) continue;
+					if (!(isBuiltinModule || (await shouldTransform?.(source, id) ?? await isPureCJS(source, id)))) continue;
 					if (stmt.specifiers.length === 0) {
-						s.overwriteNode(stmt, `require(${s.sliceNode(stmt.source)});`);
+						if (isBuiltinModule) s.removeNode(stmt);
+						else s.overwriteNode(stmt, `require(${s.sliceNode(stmt.source)});`);
 						continue;
 					}
 					const mapping = {};
@@ -73,7 +78,7 @@ function RequireCJS(userOptions = {}) {
 						if (specifier.importKind === "type") continue;
 						mapping[s.sliceNode(specifier.imported)] = s.sliceNode(specifier.local);
 					} else defaultId = s.sliceNode(specifier.local);
-					const requireCode = `require(${s.sliceNode(stmt.source)})`;
+					const requireCode = isBuiltinModule ? `process.getBuiltinModule(${s.sliceNode(stmt.source)})` : `require(${s.sliceNode(stmt.source)})`;
 					let str = "";
 					if (namespaceId) defaultId ||= `_cjs_${namespaceId}_default`;
 					if (defaultId) str += `const ${defaultId} = ${requireCode};`;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "rolldown-plugin-require-cjs",
-  "version": "0.1.5",
+  "version": "0.2.0",
   "description": "Transform ESM imports to CJS requires when the imported module is pure CJS.",
   "type": "module",
   "license": "MIT",
@@ -38,16 +38,16 @@
   },
   "devDependencies": {
     "@babel/parser": "^7.28.4",
-    "@sxzz/eslint-config": "^7.1.4",
+    "@sxzz/eslint-config": "^7.2.1",
     "@sxzz/prettier-config": "^2.2.4",
     "@sxzz/test-utils": "^0.5.11",
-    "@types/node": "^24.4.0",
+    "@types/node": "^24.5.2",
     "bumpp": "^10.2.3",
-    "eslint": "^9.35.0",
+    "eslint": "^9.36.0",
     "eslint-plugin-vue": "^10.5.0",
     "prettier": "^3.6.2",
-    "rolldown": "1.0.0-beta.38",
-    "tsdown": "^0.15.1",
+    "rolldown": "1.0.0-beta.39",
+    "tsdown": "^0.15.4",
     "typescript": "^5.9.2",
     "vitest": "^3.2.4"
   },