Rslib features track

[Timeless0911]

CLI

• Support npm create rslib@latest to create a Rslib project
• Support --inspect to show Rslib/Rsbuild/Rspack config
• [Feature]: Support watch rslib.config to rebuild #138
• Add some debug info to better debugging Rslib

Config

• Provide preset templates to default set some common configs for basic scenes
• Support better shared Rsbuild config

Features

We try to keep the features aligned with Modern.js Module

bundle / bundleless

• basic support

format

output.library.type

• cjs
• esm
• umd
• mf

platform

• support output.target
• support control the syntax target for downgration

alias

• use source.alias

autoExtension

• js extension
  • .js with esm format and .cjs with cjs format when type: module
  • .js with cjs format and .mjs with esm format when type: commonjs
• dts extension
  • .d.ts with esm format and .d.cts with cjs format when type: module
  • .d.ts with cjs format and .d.mts with esm format when type: commonjs

externals

output.externals

• prevent externalizing entry modules in bundleless mode
• make node built-in modules external when target is node
• support auto external dependencies and peerDependencies
• support tools.swc to external helpers

redirect

• redirect in js outputs of bundleless mode
  • path
  • extension (import/export)
  • style
  • asset path
• redirect in DTS outputs of bundleless mode
  • path
  • extension

shims

• shims __filename and __dirname in esm
• shims import.meta.url in cjs
• set module.parser.javascript.importMeta = false in esm

banner & footer

• integrate banner-plugin to inject content
• support inject in dts files

dts

• support cleanDistPath to clean DTS output before emit
• use ts compiler API to generate bundleless dts
  • watch api in watch mode
  • incremental build with project reference
• use api-extractor to generate dts bundle
  • auto external packages
• optimize log output and error handler
• support autoExtension for dts files
• support abortOnError option to control whether to exit process when dts build error
• support generate dts when isolatedDeclarations enabled

css

• less support @rsbuild/plugin-less
• sass support @rsbuild/plugin-sass
• css modules output.cssModules
• postcss tools.postcss
• tailwind css using tailwind CSS
• style inject output.injectStyles

Module Federation

• [Feature]: Support for Module Federation #212

input

• use source.entry

copy

• use output.copy

define

• use source.define

minify

• use output.minify

outDir

• use output.distPath

resolve

• use resolve

sourcemap

• use output.sourcemap

transformImport

• use source.transformImport

decorators

• use source.decorators

asset

• asset import / export in outputs
• name: output.filename
• limit: output.dataUriLimit
• path: output.distPath
• publicPath: output.assetPrefix
• svgr: @rsbuild/plugin-svgr

polyfill

• node polyfill
• polyfill with core-js-pure

prebundle

• like what ncc do

Ecosystem

• Storybook integration
• Support using Rspress to build a static site for module doc
• Monorepo development with fast one-time HMR
• Simple bump and publish workflow
• Vue component support

Advanced

• JS API
• Zero-config use
• Config check
  • package.json, like publint
  • tsconfig.json
  • types, like Are the types wrong?

Migration

• Config map between Rslib and Modern.js Module
• Migrate E2E test cases from Modern.js Module
• performance benchmark with other tools
• Adding integration tests about using Rsbuild to bundle packages built by Rslib

[yee94]

Usually this kind of tools need extends options, don't you think?

[Timeless0911]

Usually this kind of tools need extends options, don't you think?

Can you give some examples of what extends is going to do?

[lanmingle]

突然说 Modern.js Module 不推荐使用，用 rslib 了，测试了一下，更简单很灵活，很棒！

另外请完善文档（以及中文文档支持），例如 Tailwind CSS 等只库上使用，打包不使用，自定义模板等等，现在这个文档  😂

功能请求：npm create rslib@latest 请添加一些命令行参数，可以选择不交互模式，如 --name / -n 名称，-lang / -l = ts ，additional : -a =biome 等等，方便拷贝一条命令就可以创建项目，而不是交互模式。

[Timeless0911]

@lanmingle

突然说 Modern.js Module 不推荐使用，用 rslib 了，测试了一下，更简单很灵活，很棒！

Thank you for your dogfooding, we will release the first stable version 0.1.0 in the end of year.

另外请完善文档（以及中文文档支持），例如 Tailwind CSS 等只库上使用，打包不使用，自定义模板等等，现在这个文档 😂

Rslib documentation is still under construction, stay tuned for a stable version and we will translate the Chinese document after the English document is completed.

功能请求：npm create rslib@latest 请添加一些命令行参数，可以选择不交互模式，如 --name / -n 名称，-lang / -l = ts ，additional : -a =biome 等等，方便拷贝一条命令就可以创建项目，而不是交互模式。

You can open an issue in https://github.com/rspack-contrib/create-rstack.

[chenjiahan]

You can open an issue in https://github.com/rspack-contrib/create-rstack.

create-rslib already provides some CLI flags, see: https://lib.rsbuild.dev/guide/start/quick-start#quick-creation

[lanmingle]

@lanmingle

突然说 Modern.js Module 不推荐使用，用 rslib 了，测试了一下，更简单很灵活，很棒！

Thank you for your dogfooding, we will release the first stable version 0.1.0 in the end of year.

另外请完善文档（以及中文文档支持），例如 Tailwind CSS 等只库上使用，打包不使用，自定义模板等等，现在这个文档 😂

Rslib documentation is still under construction, stay tuned for a stable version and we will translate the Chinese document after the English document is completed.

功能请求：npm create rslib@latest 请添加一些命令行参数，可以选择不交互模式，如 --name / -n 名称，-lang / -l = ts ，additional : -a =biome 等等，方便拷贝一条命令就可以创建项目，而不是交互模式。

You can open an issue in https://github.com/rspack-contrib/create-rstack.

rspack-contrib/create-rstack#21