rolldown-plugin-require-cjs 0.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright © 2025-PRESENT Kevin Deng (https://github.com/sxzz)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,40 @@
+# rolldown-plugin-require-cjs
+
+[![npm version][npm-version-src]][npm-version-href]
+[![npm downloads][npm-downloads-src]][npm-downloads-href]
+[![Unit Test][unit-test-src]][unit-test-href]
+
+Transform ESM imports to CJS requires when the imported module is pure CJS.
+
+## Why?
+
+Some packages only provide CJS builds (e.g., [`typescript`](https://npmjs.com/package/typescript), [`@babel/parser`](https://npmjs.com/package/@babel/parser)), and importing them using ESM syntax increases Node's `cjs-module-lexer` overhead. This plugin converts ESM imports to CJS requires for such pure CJS packages, allowing Node to skip the cjs-module-lexer step and improve performance.
+
+See more: https://x.com/sanxiaozhizi/status/1968580207322808812
+
+## Install
+
+```bash
+npm i rolldown-plugin-require-cjs
+```
+
+## Sponsors
+
+<p align="center">
+  <a href="https://cdn.jsdelivr.net/gh/sxzz/sponsors/sponsors.svg">
+    <img src='https://cdn.jsdelivr.net/gh/sxzz/sponsors/sponsors.svg'/>
+  </a>
+</p>
+
+## License
+
+[MIT](./LICENSE) License © 2025-PRESENT [Kevin Deng](https://github.com/sxzz)
+
+<!-- Badges -->
+
+[npm-version-src]: https://img.shields.io/npm/v/rolldown-plugin-require-cjs.svg
+[npm-version-href]: https://npmjs.com/package/rolldown-plugin-require-cjs
+[npm-downloads-src]: https://img.shields.io/npm/dm/rolldown-plugin-require-cjs
+[npm-downloads-href]: https://www.npmcharts.com/compare/rolldown-plugin-require-cjs?interval=30
+[unit-test-src]: https://github.com/sxzz/rolldown-plugin-require-cjs/actions/workflows/unit-test.yml/badge.svg
+[unit-test-href]: https://github.com/sxzz/rolldown-plugin-require-cjs/actions/workflows/unit-test.yml

package/dist/index.d.ts

@@ -0,0 +1,29 @@
+import { Plugin } from "rolldown";
+
+//#region src/options.d.ts
+type FilterPattern = Array<string | RegExp> | string | RegExp;
+type Awaitable<T> = T | Promise<T>;
+interface Options {
+  include?: FilterPattern;
+  exclude?: FilterPattern;
+  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.
+  *
+  * @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?: (id: string, importer: string) => Awaitable<boolean | undefined>;
+}
+type Overwrite<T, U> = Pick<T, Exclude<keyof T, keyof U>> & U;
+type OptionsResolved = Overwrite<Required<Options>, Pick<Options, "order" | "shouldTransform">>;
+declare function resolveOptions(options: Options): OptionsResolved;
+//#endregion
+//#region src/index.d.ts
+declare function RequireCJS(userOptions?: Options): Plugin;
+declare function isPureCJS(id: string, importer: string): Promise<boolean>;
+//#endregion
+export { Options, OptionsResolved, RequireCJS, isPureCJS, resolveOptions };