v0.18.0

Compare Source

Highlights 💡

Enable persistent build cache by default

Rslib enables Rspack's persistent build cache by default, allowing it to reuse the cached results instead of rebuilding from scratch, which can significantly reduce build time for large projects.

// rslib.config.ts
export default {
  performance: {
    buildCache: true,
  },
};

More details:

• performance.buildCache - Rsbuild
• experiments.cache - Rspack

What's Changed

New Features 🎉

• feat: enable buildCache by default by @​Timeless0911 in #​1334

Document 📖

• docs: update some configurations of Rspress v2 by @​Timeless0911 in #​1339

Other Changes

• chore(deps): bump Rslib 0.17.2 by @​Timeless0911 in #​1337
• security: enable pnpm's no-downgrade trustPolicy by @​Timeless0911 in #​1333
• chore(deps): update all non-major dependencies by @​renovate[bot] in #​1338
• Release v0.18.0 by @​Timeless0911 in #​1340

Full Changelog: web-infra-dev/rslib@v0.17.2...v0.18.0

v0.17.2

Compare Source

What's Changed

New Features 🎉

• feat: log a flag to mark first compile done in watch mode by @​fi3ework in #​1330

Bug Fixes 🐞

• fix: do not modify mf’s output config by @​fi3ework in #​1322
• fix: upgrade MF@​0.21.3 to fix lazy compilation issue by @​2heal1 in #​1327
• fix(create-rslib): support repeatable —tools flag by @​fi3ework in #​1328

Document 📖

• docs: remove complex twoslash code block by @​Timeless0911 in #​1302
• docs: assets output filename and distPath by @​Timeless0911 in #​1332

Other Changes

• test: set max workers number by @​Timeless0911 in #​1323
• chore(deps): bump Rstest 0.6.2 by @​Timeless0911 in #​1324
• chore(deps): update all non-major dependencies by @​renovate[bot] in #​1326
• chore(build): use advanced ESM by @​Timeless0911 in #​1325
• chore(deps): bump Rsbuild 1.6.6 by @​Timeless0911 in #​1335
• Release v0.17.2 by @​Timeless0911 in #​1336

Full Changelog: web-infra-dev/rslib@v0.17.1...v0.17.2

v0.17.1

Compare Source

What's Changed

New Features 🎉

• feat: export Rsbuild types by @​Timeless0911 in #​1314
• feat(CLI): run rslib without any sub-command to trigger build by @​Timeless0911 in #​1316
• feat(create-rslib): add AGENTS.md by @​Timeless0911 in #​1317
• feat: runtime chunk name default to rslib-runtime by @​Timeless0911 in #​1320

Bug Fixes 🐞

• fix(create-rslib): compatible with Storybook 10 by @​fi3ework in #​1310
• fix: verbose Rslib normalized config only in Rslib debug mode by @​Timeless0911 in #​1312
• fix: remove externalsPresets.node by @​fi3ework in #​1318

Other Changes

• chore(deps): update dependency vitest to v4 by @​renovate[bot] in #​1306
• chore(deps): update dependency @​types/node to v24 by @​renovate[bot] in #​1305
• chore(deps): update all non-major dependencies by @​renovate[bot] in #​1307
• chore(deps): update all non-major dependencies by @​renovate[bot] in #​1308
• chore: add type module to package.json in examples by @​Timeless0911 in #​1313
• chore: rename rsbuildConfig to config by @​chenjiahan in #​1315
• chore(deps): bump Rsbuild 1.6.2 by @​Timeless0911 in #​1319
• Release v0.17.1 by @​Timeless0911 in #​1321

Full Changelog: web-infra-dev/rslib@v0.17.0...v0.17.1

v0.17.0

Compare Source

Highlights 💡

Improved ESM output

Optimizing ESM output has long been one of the key challenges faced by Rspack. Previously, we relied on module concatenation to optimize ESM outputs, but that approach had several limitations:

• Impure output – The generated files contained Rspack's runtime code.
• Prone to errors – Some modules could not be correctly concatenated, leading to unexpected runtime issues.
• Limited code-splitting support – Split bundles became complex and difficult to analyze or optimize statically.

To address these issues once and for all, we introduced an experimental plugin called EsmLibraryPlugin, purpose-built for constructing clean and efficient ESM libraries:

• Full control over the bundling process – All modules are linked during compilation, eliminating reliance on Rspack's runtime.
• Code-splitting support – Code after splitting can be statically analyzed and is tree-shaking friendly.

The image below compares the code splitting output before and after using this plugin — the left side shows the previous output, while the right side shows the cleaner output produced by EsmLibraryPlugin:

In Rslib, the EsmLibraryPlugin is now integrated out-of-the-box with experiments.advancedEsm enabled to generate ESM output that is high-quality, more friendly to static analysis, and supports code splitting.

export default {
  lib: [
    {
      format: 'esm',
      bundle: true,
      experiments: {
        advancedEsm: true,
      },
    },
  ],
};

[!TIP]
Currently this option only takes effect in bundle mode when format is 'esm'.

What's Changed

New Features 🎉

• feat: introduce experiments.advancedEsm with Rspack's EsmLibraryPlugin by @​JSerFeng in #​1273

Other Changes

• chore(deps): update all non-major dependencies by @​renovate[bot] in #​1293
• chore(deps): update dependency nx to v22 by @​renovate[bot] in #​1294
• ci: add ecosystem CI by @​fi3ework in #​1296
• ci: add per commit notify by @​fi3ework in #​1298
• ci: fix yaml file by @​fi3ework in #​1299
• ci: add main branch to ecosystem-ci by @​fi3ework in #​1300
• ci: remove useless input by @​fi3ework in #​1301
• chore(deps): bump Rsbuild 1.6.0 by @​Timeless0911 in #​1303
• Release v0.17.0 by @​Timeless0911 in #​1304

New Contributors

• @​JSerFeng made their first contribution in #​1273

Full Changelog: web-infra-dev/rslib@v0.16.1...v0.17.0

v0.16.1

Compare Source

What's Changed

Bug Fixes 🐞

• fix: align esX browserslist expression to SWC by @​fi3ework in #​1287

Other Changes

• chore(CI): extract reusable yml and remove Node 20 tests by @​Timeless0911 in #​1283
• chore(deps): update all non-major dependencies by @​renovate[bot] in #​1284
• chore: bump Rsbuild 1.6.0-beta.1 and remove special output.distPath merge logic by @​Timeless0911 in #​1285
• chore(build): avoid using require in configuration file by @​chenjiahan in #​1288
• Release v0.16.1 by @​Timeless0911 in #​1289

Full Changelog: web-infra-dev/rslib@v0.16.0...v0.16.1

v0.16.0

Compare Source

Highlights 💡

Additional build CLI options

The Rslib build command now supports additional CLI options that take precedence over configuration file settings, and can even be used without any configuration file entirely.

For example: rslib build --entry index.ts --minify --tsconfig tsconfig.build.json.

Usage:
  $ rslib build

Options:
  -w, --watch            turn on watch mode, watch for changes and rebuild
  --entry <entry>        set entry file or pattern (repeatable)
  --dist-path <dir>      set output directory
  --bundle               enable bundle mode (use --no-bundle to disable)
  --format <format>      specify the output format (esm | cjs | umd | mf | iife)
  --syntax <syntax>      set build syntax target (repeatable)
  --target <target>      set runtime target (web | node)
  --dts                  emit declaration files (use --no-dts to disable)
  --externals <pkg>      add package to externals (repeatable)
  --minify               minify output (use --no-minify to disable)
  --clean                clean output directory before build (use --no-clean to disable)
  --auto-extension       control automatic extension redirect (use --no-auto-extension to disable)
  --auto-external        control automatic dependency externalization (use --no-auto-external to disable)
  --tsconfig <path>      use specific tsconfig (relative to project root)

What's Changed

New Features 🎉

• feat(dts): support using output.distPath as dts emit path by @​Timeless0911 in #​1269
• feat: support more cli options for build command by @​fi3ework in #​1258
• feat: support build without config file by @​fi3ework in #​1275

Bug Fixes 🐞

• fix: merge output.distPath correctly by @​Timeless0911 in #​1270
• fix: Node shims for 'javascript/esm' files by @​Timeless0911 in #​1274
• fix: cjs import.meta.url shims in async chunks by @​Timeless0911 in #​1281
• fix: align esX browserslist expression to caniuse by @​fi3ework in #​1280

Document 📖

• docs: specify how to debug Rslib config by @​Timeless0911 in #​1279

Other Changes

• chore(deps): update actions/setup-node action to v6 by @​renovate[bot] in #​1268
• chore(deps): bump Rsbuild 1.6.0-beta.0 by @​Timeless0911 in #​1267
• chore: use shorter string value for output.distPath by @​Timeless0911 in #​1271
• test: fix shims disable test by @​Timeless0911 in #​1272
• chore(deps): update all non-major dependencies by @​renovate[bot] in #​1276
• chore: disable lazyCompilation to make mf e2e case stable by @​Timeless0911 in #​1278
• Release v0.16.0 by @​Timeless0911 in #​1282

Full Changelog: web-infra-dev/rslib@v0.15.1...v0.16.0

v0.15.1

Compare Source

What's Changed

Bug Fixes 🐞

• fix: treat module as normal variable in ESM by @​fi3ework in #​1260

Document 📖

• docs: link redirect.dts.extension in dts.autoExtension by @​fi3ework in #​1263
• docs: distinguish watch mode in configuration files by @​Timeless0911 in #​1265

Other Changes

• chore: supersede strip-ansi with stripVTControlCharacters by @​fi3ework in #​1261
• chore(deps): update all non-major dependencies by @​renovate[bot] in #​1262
• chore(deps): update all non-major dependencies by @​renovate[bot] in #​1264
• Release v0.15.1 by @​Timeless0911 in #​1266

Full Changelog: web-infra-dev/rslib@v0.15.0...v0.15.1