@modern-js/main-doc 2.54.4 → 2.54.5

package/docs/en/guides/advanced-features/rspack-start.mdx

@@ -123,19 +123,46 @@ When Rspack is enabled for building through dev / build, the current version of
 
 You can override Rspack to a specific version using the capbilities provided by package managers such as pnpm, yarn, npm.
 
-For example, if you are using pnpm, you can update the Rspack version with `overrides` as shown below:
+For example, if you are using pnpm, you can override the Rspack version with `overrides`. Assume that the version of Rspack needs to be specified as 0.7.5:
 
 ```json title=package.json
 {
   "pnpm": {
     "overrides": {
-      "@rspack/core": "nightly",
-      "@rspack/plugin-react-refresh": "nightly",
+      "@rspack/binding": "0.7.5",
+      "@rspack/core": "0.7.5",
+      "@rspack/plugin-react-refresh": "0.7.5"
     }
   }
 }
 ```
 
+If you need to use the nightly/canary version of Rspack, the package name of the nightly/canary version of Rspack will be released after adding the `-canary` suffix, and needs to be modified to:
+
+```json title=package.json
+{
+  "pnpm": {
+    "overrides": {
+      "@rspack/binding": "npm:@rspack/binding-canary@nightly",
+      "@rspack/core": "npm:@rspack/core-canary@nightly",
+      "@rspack/plugin-react-refresh": "npm:@rspack/plugin-react-refresh-canary@nightly"
+    },
+    "peerDependencyRules": {
+      "allowAny": [
+        "@rspack/*"
+      ]
+    }
+  }
+}
+```
+
+Rspack provides [install-rspack](https://github.com/rspack-contrib/install-rspack) tooling to quickly override versions:
+
+```sh
+npx install-rspack --version nightly # nightly npm tag
+npx install-rspack --version 0.7.5-canary-d614005-20240625082730 # A specific canary version
+```
+
 :::tip What is Rspack Nightly Version
 The Rspack nightly build fully replicates the full release build for catching errors early.
 Usually it is available and any errors that arise will fixed promptly.

package/docs/zh/guides/advanced-features/rspack-start.mdx

@@ -122,19 +122,46 @@ export default defineConfig<'rspack'>({
 
 可以使用 pnpm / yarn / npm 等包管理工具自带的依赖升级功能来将 Rspack 强制升级到指定版本。
 
-以 pnpm 为例，可通过 `overrides` 以下依赖更新 Rspack 版本:
+以 pnpm 为例，可通过 `overrides` 修改内置的 Rspack 版本。假设需要指定 Rspack 的版本为 0.7.5:
 
 ```json title=package.json
 {
   "pnpm": {
     "overrides": {
-      "@rspack/core": "nightly",
-      "@rspack/plugin-react-refresh": "nightly",
+      "@rspack/binding": "0.7.5",
+      "@rspack/core": "0.7.5",
+      "@rspack/plugin-react-refresh": "0.7.5"
     }
   }
 }
 ```
 
+如果需要使用 Rspack 的 nightly/canary 版本，Rspack 的 nightly/canary 版本的包名会在增加 `-canary` 后缀之后发布，需要修改为:
+
+```json title=package.json
+{
+  "pnpm": {
+    "overrides": {
+      "@rspack/binding": "npm:@rspack/binding-canary@nightly",
+      "@rspack/core": "npm:@rspack/core-canary@nightly",
+      "@rspack/plugin-react-refresh": "npm:@rspack/plugin-react-refresh@nightly"
+    },
+    "peerDependencyRules": {
+      "allowAny": [
+        "@rspack/*"
+      ]
+    }
+  }
+}
+```
+
+Rspack 提供了 [install-rspack](https://github.com/rspack-contrib/install-rspack) 工具来快速修改 Rspack 版本:
+
+```sh
+npx install-rspack --version nightly # nightly npm tag
+npx install-rspack --version 0.7.5-canary-d614005-20240625082730 # A specific canary version
+```
+
 :::tip Nightly 版本介绍
 每天，Rspack 会自动构建基于最新代码的 nightly 版本，用于测试和及早发现错误。
 通常情况下，这些版本是可用的。如果发现问题，我们会及时进行修复。但如果 Rspack 有一些 breaking change、需要 Modern.js 同步修改代码，那么我们建议等待下一个 Modern.js 版本再进行更新。

package/package.json

@@ -15,17 +15,17 @@
     "modern",
     "modern.js"
   ],
-  "version": "2.54.4",
+  "version": "2.54.5",
   "publishConfig": {
     "registry": "https://registry.npmjs.org/",
     "access": "public",
     "provenance": true
   },
   "dependencies": {
-    "@modern-js/sandpack-react": "2.54.4"
+    "@modern-js/sandpack-react": "2.54.5"
   },
   "peerDependencies": {
-    "@modern-js/builder-doc": "^2.54.4"
+    "@modern-js/builder-doc": "^2.54.5"
   },
   "devDependencies": {
     "classnames": "^2",
@@ -39,8 +39,8 @@
     "@rspress/shared": "1.18.2",
     "@types/node": "^16",
     "@types/fs-extra": "9.0.13",
-    "@modern-js/builder-doc": "2.54.4",
-    "@modern-js/doc-plugin-auto-sidebar": "2.54.4"
+    "@modern-js/doc-plugin-auto-sidebar": "2.54.5",
+    "@modern-js/builder-doc": "2.54.5"
   },
   "scripts": {
     "dev": "rspress dev",