Summary

• New default library type for CommonJS: Rslib changes the default value of output.library.type for CommonJS from commonjs to commonjs-static. Now, individual exports will be set as properties on module.exports and the output can be statically analyzable, thus named exports are importable into ESM via Node.js. This is useful when source code is written in ESM and the output should be compatible with both CJS and ESM. (feat!: change to commonjs-static library type of commonjs format #819)

  Named exports are importable into ESM via Node.js

  • Input:

  export function doSomething() {}

  • Output:

  function doSomething() {}
  // …
  exports.doSomething = __webpack_exports__.doSomething;

  • Consumption (CommonJS):

  const { doSomething } = require('./output.cjs'); // doSomething => [Function: doSomething]

  • Consumption (ESM):

  import { doSomething } from './output.cjs'; // doSomething => [Function: doSomething]

Related Links

commonjs-static will directly skip all unprovided exports, which will lead to lose exports. We need to fix this in webpack / Rspack: add commonjs like runtime code to export dynamically as the fallback of unprovided exports.

fix: #351
fix: #714

Checklist

• Tests updated (or not required).
• Documentation updated (or not required).