@modern-js/main-doc 2.54.3 → 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/en/guides/deprecat.md

@@ -0,0 +1,15 @@
+---
+sidebar_position: 10
+---
+
+# Deprecated Functions
+
+This article will introduce the functions that were previously supported by Modern.js, but have now been deprecated, along with the recommended alternatives.
+
+## Creating a Monorepo using @modern-js/create
+
+The Monorepo solution previously provided by Modern.js was implemented based on [pnpm Workspace](https://pnpm.io/workspaces) and did not offer substantial Monorepo management capabilities. In version [v2.53.0](https://github.com/web-infra-dev/modern.js/releases/tag/v2.53.0), the functionality to create Monorepo projects using `@modern-js/create` has been removed. It is recommended to directly use the Monorepo solutions provided by the community.
+
+## Enabling the test capability with the new command
+
+The test capability previously provided by Modern.js was a simple wrapper based on Jest, which led to issues such as unintuitive Jest configuration and more complex user configuration. In version [v2.53.0](https://github.com/web-infra-dev/modern.js/releases/tag/v2.53.0), the option to enable the test feature in application and module projects has been removed. It is recommended to directly use the testing solutions provided by the community.

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/docs/zh/guides/deprecat.md

@@ -0,0 +1,15 @@
+---
+sidebar_position: 10
+---
+
+# 已下线功能
+
+本文将介绍 Modern.js 之前支持，但是现在已下线的功能及推荐替代方案。
+
+## 使用 @modern-js/create 创建 Monorepo
+
+Modern.js 之前提供的 Monorepo 方案是基于 [pnpm Workspace](https://pnpm.io/workspaces) 实现的，并未提供实质性的 Monorepo 管理能力。在 [v2.53.0](https://github.com/web-infra-dev/modern.js/releases/tag/v2.53.0) 版本中，移除了使用 `@modern-js/create` 创建 Monorepo 项目的功能。推荐直接使用社区提供的 Monorepo 方案。
+
+## new 命令开启 test 能力
+
+Modern.js 之前提供的测试能力是基于 Jest 的简单封装。该封装导致 Jest 配置不直观、用户配置更加复杂等问题。在 [v2.53.0](https://github.com/web-infra-dev/modern.js/releases/tag/v2.53.0) 版本中，移除了在应用项目和模块项目中开启 test 功能的选项。推荐直接使用社区提供的测试方案。

package/package.json

@@ -15,17 +15,17 @@
     "modern",
     "modern.js"
   ],
-  "version": "2.54.3",
+  "version": "2.54.5",
   "publishConfig": {
     "registry": "https://registry.npmjs.org/",
     "access": "public",
     "provenance": true
   },
   "dependencies": {
-    "@modern-js/sandpack-react": "2.54.3"
+    "@modern-js/sandpack-react": "2.54.5"
   },
   "peerDependencies": {
-    "@modern-js/builder-doc": "^2.54.3"
+    "@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/doc-plugin-auto-sidebar": "2.54.3",
-    "@modern-js/builder-doc": "2.54.3"
+    "@modern-js/doc-plugin-auto-sidebar": "2.54.5",
+    "@modern-js/builder-doc": "2.54.5"
   },
   "scripts": {
     "dev": "rspress dev",