@modern-js/main-doc 3.0.0 → 3.0.2

package/docs/en/guides/topic-detail/module-federation/usage.mdx

@@ -1,6 +1,6 @@
 # Getting Started
 
-To use Module Federation in Modern.js, we recommend using the official plugin `@module-federation/modern-js`.
+To use Module Federation in Modern.js, we recommend using the official plugin `@module-federation/modern-js-v3`.
 
 This section will introduce how to set up both producer and consumer applications using the official plugin. First, create two applications by following the [Modern.js Quick Start](/guides/get-started/quick-start).
 
@@ -10,7 +10,7 @@ After creating the applications, install the plugin for both projects:
 
 import { PackageManagerTabs } from '@theme';
 
-<PackageManagerTabs command="add @module-federation/modern-js" />
+<PackageManagerTabs command="add @module-federation/modern-js-v3" />
 
 ## Register the Plugin
 
@@ -18,7 +18,7 @@ After installing the plugin, you need to register it in the `modern.config.js` f
 
 ```ts
 import { appTools, defineConfig } from '@modern-js/app-tools';
-import { moduleFederationPlugin } from '@module-federation/modern-js';
+import { moduleFederationPlugin } from '@module-federation/modern-js-v3';
 
 export default defineConfig({
   plugins: [appTools(), moduleFederationPlugin()],
@@ -42,7 +42,7 @@ export const Button = () => {
 Then, add the `module-federation.config.ts` file at the project root to configure the Module Federation module's name, shared dependencies, and exports:
 
 ```ts title="module-federation.config.ts"
-import { createModuleFederationConfig } from '@module-federation/modern-js';
+import { createModuleFederationConfig } from '@module-federation/modern-js-v3';
 
 export default createModuleFederationConfig({
   name: 'remote',
@@ -68,7 +68,7 @@ Additionally, modify `modern.config.ts` to provide a development environment por
 
 ```ts title="modern.config.ts"
 import { appTools, defineConfig } from '@modern-js/app-tools';
-import { moduleFederationPlugin } from '@module-federation/modern-js';
+import { moduleFederationPlugin } from '@module-federation/modern-js-v3';
 
 export default defineConfig({
   server: {
@@ -85,7 +85,7 @@ Now, modify the consumer's code to use the module exported by the producer.
 Add the `module-federation.config.ts` file at the project root to configure the Module Federation module's name, shared dependencies, and the remote module to use:
 
 ```ts title="module-federation.config.ts"
-import { createModuleFederationConfig } from '@module-federation/modern-js';
+import { createModuleFederationConfig } from '@module-federation/modern-js-v3';
 
 export default createModuleFederationConfig({
   name: 'host',
@@ -172,7 +172,7 @@ If we want to simulate the production environment in local, but not configure `o
 
 ```ts
 import { appTools, defineConfig } from '@modern-js/app-tools';
-import { moduleFederationPlugin } from '@module-federation/modern-js';
+import { moduleFederationPlugin } from '@module-federation/modern-js-v3';
 
 // https://modernjs.dev/en/configure/app/usage
 export default defineConfig({

package/docs/en/guides/troubleshooting/builder.mdx

@@ -10,11 +10,11 @@ If you encounter any build-related issues, you can refer to the current document
 
 ### Rsbuild FAQ
 
-Modern.js is internally based on [Rsbuild](https://rsbuild.rs/) and encapsulates its own build tool, so you can directly refer to the FAQ document of Rsbuild:
+Modern.js is internally based on [Rsbuild](https://v2.rsbuild.dev/) and encapsulates its own build tool, so you can directly refer to the FAQ document of Rsbuild:
 
-- [Rsbuild - Features FAQ](https://rsbuild.rs/guide/faq/features)
-- [Rsbuild - Exceptions FAQ](https://rsbuild.rs/guide/faq/exceptions)
-- [Rsbuild - HMR FAQ](https://rsbuild.rs/guide/faq/hmr)
+- [Rsbuild - Features FAQ](https://v2.rsbuild.dev/guide/faq/features)
+- [Rsbuild - Exceptions FAQ](https://v2.rsbuild.dev/guide/faq/exceptions)
+- [Rsbuild - HMR FAQ](https://v2.rsbuild.dev/guide/faq/hmr)
 
 ---
 

package/docs/en/guides/upgrade/config.mdx

@@ -151,12 +151,40 @@ export default {
 
 ## tools
 
+### toos.postcss
+
+**Change**: The object configuration will override the built-in PostCSS configuration of Modern.js. If you need to extend based on the built-in configuration, please use the function configuration.
+
+```typescript
+// v2
+export default {
+  tools: {
+    postcss: {
+      postcssOptions: {
+        plugins: [tailwindcssPlugin],
+      },
+    },
+  },
+};
+```
+
+```typescript
+// v3
+export default {
+  tools: {
+    postcss: (opts, { addPlugins }) => {
+      addPlugins(tailwindcssPlugin);
+    },
+  },
+};
+```
+
 ### tools.esbuild
 
 **Change**: This configuration has been deprecated, you need to manually switch to esbuild minification.
 
 ```typescript
-// This configuration has been deprecated, please refer to [Switching Minifier](https://rsbuild.rs/config/output/minify#switching-minifier) to manually switch to esbuild minification
+// This configuration has been deprecated, please refer to [Switching Minifier](https://v2.rsbuild.dev/config/output/minify#switching-minifier) to manually switch to esbuild minification
 // tools: {
 //   esbuild: { /* configuration */ }
 // },
@@ -167,7 +195,7 @@ export default {
 **Change**: This configuration has been deprecated, you need to manually switch to Terser minification.
 
 ```typescript
-// This configuration has been deprecated, please refer to [Switching Minifier](https://rsbuild.rs/config/output/minify#switching-minifier) to manually switch to Terser minification
+// This configuration has been deprecated, please refer to [Switching Minifier](https://v2.rsbuild.dev/config/output/minify#switching-minifier) to manually switch to Terser minification
 // tools: {
 //   terser: { /* configuration */ }
 // },
@@ -889,7 +917,7 @@ export default defineRuntimeConfig({
 
 ### performance.bundleAnalyze
 
-**Change**: This configuration has been deprecated, it is recommended to use [Rsdoctor](https://rsbuild.rs/guide/debug/rsdoctor) to analyze bundle size.
+**Change**: This configuration has been deprecated, it is recommended to use [Rsdoctor](https://v2.rsbuild.dev/guide/debug/rsdoctor) to analyze bundle size.
 
 ### performance.transformLodash
 

package/docs/en/plugin/cli-plugins/api.mdx

@@ -192,7 +192,7 @@ Modify Rspack configuration using the chain API.
 - **Parameters:**
   - `modifyFn`: A modification function that receives a `RspackChain` instance and utility functions as parameters.
 - **Execution Phase:** When generating the final Rspack configuration.
-- **Corresponding Rsbuild Hook:** [modifyBundlerChain](https://rsbuild.rs/en/plugins/dev/hooks#modifybundlerchain)
+- **Corresponding Rsbuild Hook:** [modifyBundlerChain](https://v2.rsbuild.dev/plugins/dev/hooks#modifybundlerchain)
 - **Example:**
 
 ```typescript
@@ -212,7 +212,7 @@ Modify the Rsbuild configuration.
 - **Parameters:**
   - `modifyFn`: A modification function that receives the Rsbuild configuration object and utility functions as parameters. It can return the modified configuration object, a Promise, or nothing (modifying the original object directly).
 - **Execution Phase:** When generating the final Rsbuild configuration.
-- **Corresponding Rsbuild Hook:** [modifyRsbuildConfig](https://rsbuild.rs/en/plugins/dev/hooks#modifyrsbuildconfig)
+- **Corresponding Rsbuild Hook:** [modifyRsbuildConfig](https://v2.rsbuild.dev/plugins/dev/hooks#modifyrsbuildconfig)
 - **Example:**
 
 ```typescript
@@ -232,7 +232,7 @@ Modify the Rspack configuration (when using Rspack as the bundler).
 - **Parameters:**
   - `modifyFn`: A modification function that receives the Rspack configuration object and utility functions as parameters. It can return the modified configuration object, a Promise, or nothing (modifying the original object directly).
 - **Execution Phase:** When generating the final Rspack configuration.
-- **Corresponding Rsbuild Hook:** [modifyRspackConfig](https://rsbuild.rs/en/plugins/dev/hooks#modifyrspackconfig)
+- **Corresponding Rsbuild Hook:** [modifyRspackConfig](https://v2.rsbuild.dev/plugins/dev/hooks#modifyrspackconfig)
 - **Example:**
 
 ```typescript
@@ -407,7 +407,7 @@ Add additional logic before the build starts.
 - **Parameters:**
   - `buildFn`: A function to be executed before the build, without parameters, can be asynchronous.
 - **Execution Phase:** Before executing the build process.
-- **Corresponding Rsbuild Hook:** [onBeforeBuild](https://rsbuild.rs/en/plugins/dev/hooks#onbeforebuild)
+- **Corresponding Rsbuild Hook:** [onBeforeBuild](https://v2.rsbuild.dev/plugins/dev/hooks#onbeforebuild)
 - **Example:**
 
 ```typescript
@@ -426,7 +426,7 @@ Add additional logic after the build is complete.
 - **Parameters:**
   - `buildFn`: A function to be executed after the build, without parameters, can be asynchronous.
 - **Execution Phase:** After executing the build process.
-- **Corresponding Rsbuild Hook:** [onAfterBuild](https://rsbuild.rs/en/plugins/dev/hooks#onafterbuild)
+- **Corresponding Rsbuild Hook:** [onAfterBuild](https://v2.rsbuild.dev/plugins/dev/hooks#onafterbuild)
 - **Example:**
 
 ```typescript
@@ -445,7 +445,7 @@ Add additional logic after the development server compilation is complete.
 - **Parameters:**
   - `compileFn`: A function to be executed after compilation is complete.
 - **Execution Phase:** After the development server starts and the initial compilation is complete.
-- **Corresponding Rsbuild Hook:** [onDevCompileDone](https://rsbuild.rs/en/plugins/dev/hooks#ondevcompiledone)
+- **Corresponding Rsbuild Hook:** [onDevCompileDone](https://v2.rsbuild.dev/plugins/dev/hooks#ondevcompiledone)
 - **Example:**
 
 ```typescript
@@ -464,7 +464,7 @@ Add additional logic before creating the compiler instance.
 - **Parameters:**
   - `createFn`: A function to be executed before creation, without parameters, can be asynchronous.
 - **Execution Phase:** Before creating the Rspack compiler instance.
-- **Corresponding Rsbuild Hook:** [onBeforeCreateCompiler](https://rsbuild.rs/en/plugins/dev/hooks#onbeforecreatecompiler)
+- **Corresponding Rsbuild Hook:** [onBeforeCreateCompiler](https://v2.rsbuild.dev/plugins/dev/hooks#onbeforecreatecompiler)
 - **Example:**
 
 ```typescript
@@ -483,7 +483,7 @@ Add additional logic after creating the compiler instance.
 - **Parameters:**
   - `createFn`: A function to be executed after creation, without parameters, can be asynchronous.
 - **Execution Phase:** After creating the Rspack compiler instance.
-- **Corresponding Rsbuild Hook:** [onAfterCreateCompiler](https://rsbuild.rs/en/plugins/dev/hooks#onaftercreatecompiler)
+- **Corresponding Rsbuild Hook:** [onAfterCreateCompiler](https://v2.rsbuild.dev/plugins/dev/hooks#onaftercreatecompiler)
 - **Example:**
 
 ```typescript
@@ -521,7 +521,7 @@ Add additional logic after starting the development server.
 - **Parameters:**
   - `devFn`: A function to be executed after the development server starts.
 - **Execution Phase:** After the development server has successfully started.
-- **Corresponding Rsbuild Hook:** [onAfterStartDevServer](https://rsbuild.rs/en/plugins/dev/hooks#onafterstartdevserver)
+- **Corresponding Rsbuild Hook:** [onAfterStartDevServer](https://v2.rsbuild.dev/plugins/dev/hooks#onafterstartdevserver)
 - **Example:**
 
 ```typescript

package/docs/en/plugin/introduction.mdx

@@ -117,7 +117,7 @@ Rsbuild is the underlying build tool for Modern.js. By adding Rsbuild plugins, y
 You can register Rsbuild plugins in `modern.config.ts` via the `builderPlugins` option. See [builderPlugins](/configure/app/builder-plugins.html) for details.
 
 :::info
-You can read [Rsbuild Official Website - Plugins](https://rsbuild.rs/plugins/list/index) to learn more about the Rsbuild plugin system.
+You can read [Rsbuild Official Website - Plugins](https://v2.rsbuild.dev/plugins/list/index) to learn more about the Rsbuild plugin system.
 :::
 
 ### Official Plugins
@@ -128,9 +128,9 @@ The following are official Rsbuild plugins that are already built into Modern.js
 
 | Plugin                                                                                 | Description                                                                                                                                     | Modern.js Link                                                                                                                        |
 | -------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------- |
-| [React Plugin](https://rsbuild.rs/plugins/list/plugin-react)                        | Provides support for React                                                                                                                      | -                                                                                                                                     |
-| [SVGR Plugin](https://rsbuild.rs/plugins/list/plugin-svgr)                          | Supports converting SVG images into React components                                                                                            | [output.disableSvgr](/configure/app/output/disable-svgr)<br />[output.svgDefaultExport](/configure/app/output/svg-default-export)     |
-| [Assets Retry Plugin](https://rsbuild.rs/plugins/list/plugin-assets-retry)          | Automatically retries requests when static asset loading fails                                                                                  | [output.assetsRetry](/configure/app/output/assets-retry.html)                                                                         |
+| [React Plugin](https://v2.rsbuild.dev/plugins/list/plugin-react)                        | Provides support for React                                                                                                                      | -                                                                                                                                     |
+| [SVGR Plugin](https://v2.rsbuild.dev/plugins/list/plugin-svgr)                          | Supports converting SVG images into React components                                                                                            | [output.disableSvgr](/configure/app/output/disable-svgr)<br />[output.svgDefaultExport](/configure/app/output/svg-default-export)     |
+| [Assets Retry Plugin](https://github.com/rstackjs/rsbuild-plugin-assets-retry)          | Automatically retries requests when static asset loading fails                                                                                  | [output.assetsRetry](/configure/app/output/assets-retry.html)                                                                         |
 | [Type Check Plugin](https://github.com/rspack-contrib/rsbuild-plugin-type-check)       | Runs TypeScript type checking in a separate process                                                                                             | [output.disableTsChecker](/configure/app/output/disable-ts-checker.html)<br />[tools.tsChecker](/configure/app/tools/ts-checker.html) |
 | [Source Build Plugin](https://github.com/rspack-contrib/rsbuild-plugin-source-build)   | For monorepo scenarios, supports referencing source code from other subdirectories and completing builds and hot updates                        | [experiments.sourceBuild](/configure/app/experiments/source-build.html)                                                               |
 | [Check Syntax Plugin](https://github.com/rspack-contrib/rsbuild-plugin-check-syntax)   | Analyzes the syntax compatibility of the build artifacts to determine if there are any advanced syntax features that cause compatibility issues | [security.checkSyntax](/configure/app/security/check-syntax.html)                                                                     |
@@ -142,7 +142,7 @@ The following are official Rsbuild plugins that are already built into Modern.js
 The following are official Rsbuild plugins that are not built into Modern.js:
 
 - [Image Compress Plugin](https://github.com/rspack-contrib/rsbuild-plugin-image-compress): Compresses image resources used in the project.
-- [Stylus Plugin](https://rsbuild.rs/plugins/list/plugin-stylus): Uses Stylus as the CSS preprocessor.
+- [Stylus Plugin](https://v2.rsbuild.dev/plugins/list/plugin-stylus): Uses Stylus as the CSS preprocessor.
 - [UMD Plugin](https://github.com/rspack-contrib/rsbuild-plugin-umd): Used to build UMD format artifacts.
 - [YAML Plugin](https://github.com/rspack-contrib/rsbuild-plugin-yaml): Used to reference YAML files and convert them to JavaScript objects.
 - [TOML Plugin](https://github.com/rspack-contrib/rsbuild-plugin-toml): Used to reference TOML files and convert them to JavaScript objects.

package/docs/zh/_nav.json

@@ -31,6 +31,6 @@
   },
   {
     "text": "Modern.js 2.x 文档",
-    "link": "https://modernjs.dev/zh/guides/get-started/introduction.html"
+    "link": "https://modernjs.dev/v2/zh/"
   }
 ]

package/docs/zh/apis/app/commands.mdx

@@ -150,7 +150,7 @@ Options:
 
 ## modern inspect
 
-`modern inspect` 命令用于查看项目的 Modern.js 配置、[Rsbuild 配置](https://rsbuild.rs/zh/config/index) 以及 Rspack 配置。
+`modern inspect` 命令用于查看项目的 Modern.js 配置、[Rsbuild 配置](https://v2.rsbuild.dev/zh/config/index) 以及 Rspack 配置。
 
 ```bash
 Usage: modern inspect [options]

package/docs/zh/community/blog/_meta.json

@@ -1 +1,7 @@
-["overview", "v2-release-note", "2022-0910-updates", "2022-0708-updates"]
+[
+  "overview",
+  "v3-release-note.mdx",
+  "v2-release-note",
+  "2022-0910-updates",
+  "2022-0708-updates"
+]