@modern-js/main-doc 0.0.0-next-1686121516109 → 0.0.0-next-1686150559103

package/CHANGELOG.md

@@ -1,6 +1,6 @@
 # @modern-js/main-doc
 
-## 0.0.0-next-1686121516109
+## 0.0.0-next-1686150559103
 
 ### Patch Changes
 
@@ -8,7 +8,7 @@
 
   docs: 修复 reset command 翻译问题
 
-- 31b5230f4: docs(main): update concept doc
+- bce7a1274: docs(main): update concept doc
 
   docs(main): 更新核心概念文档
 
@@ -22,7 +22,7 @@
 
 - Updated dependencies [bd4b15040]
 - Updated dependencies [2ede584c3]
-  - @modern-js/builder-doc@0.0.0-next-1686121516109
+  - @modern-js/builder-doc@0.0.0-next-1686150559103
 
 ## 2.22.0
 

package/docs/en/configure/app/output/css-modules.mdx

@@ -0,0 +1,13 @@
+---
+sidebar_label: cssModules
+---
+
+# output.cssModules
+
+:::tip
+This config is provided by Modern.js Builder, more detail can see [output.cssModules](https://modernjs.dev/builder/en/api/config-output.html#outputcssmodules).
+:::
+
+import Main from '@modern-js/builder-doc/docs/en/config/output/cssModules.md';
+
+<Main />

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

@@ -4,9 +4,9 @@ sidebar_position: 2
 
 # Builder
 
-**Modern.js's build capability is provided by [Modern.js Builder](https://modernjs.dev/builder).**
+**Modern.js uses [Modern.js Builder](https://modernjs.dev/builder/en) to build your Web App.**
 
-Modern.js Builder is one of the core components of the Modern.js system. It is a build engine for web development scenarios that can be used independently of Modern.js. Modern.js Builder supports multiple packaging tools such as webpack and Rspack, and by default uses the most mature webpack for packaging.
+Modern.js Builder is one of the core components of the Modern.js system. It is a build engine for web development scenarios that can be used independently of Modern.js. Modern.js Builder supports multiple bundlers such as webpack and Rspack, and by default uses the most mature webpack for bundling.
 
 ## Build Architecture
 
@@ -14,21 +14,21 @@ From a building perspective, Modern.js is divided into three layers, from top to
 
 - Upper-level development framework: Modern.js.
 - Common build engine: Modern.js Builder.
-- Lower-level packaging tool: webpack and Rspack.
+- Low-level bundler: webpack and Rspack.
 
 <img src="https://lf3-static.bytednsdoc.com/obj/eden-cn/zq-uylkvT/ljhwZthlaukjlkulzlp/builder-layers-1117.png" style={{ width: '100%', maxWidth: '540px' }} />
 
 ## Builder Documentation
 
-Since Modern.js Builder is a module that can be used independently, we have provided separate documentation for it, which can be found at [modernjs.dev/builder](https://modernjs.dev/builder).
+Since Modern.js Builder is a module that can be used independently, we have provided separate documentation for it, which can be found at [modernjs.dev/builder](https://modernjs.dev/builder/en).
 
-In this documentation, you can learn about the detailed introduction of Modern.js Builder, and you can also find complete usage guides for various building capabilities. When you have building needs or problems, it is recommended that you read the Modern.js Builder documentation first to solve them.
+In this documentation, you can learn about the detailed introduction of Modern.js Builder, and you can also find complete usage guides for various building capabilities. If you have any building needs or problems, it is recommended that you read the Modern.js Builder documentation first to solve them.
 
 ## Builder Configuration
 
 Modern.js's configuration inherits from Modern.js Builder, so you can use all the build configurations provided by Modern.js Builder in Modern.js.
 
-Taking the `html.title` configuration item of Modern.js Builder as an example, you can directly use this configuration item in the `modern.config.ts` file, and it will be automatically passed to Modern.js Builder.
+Taking the `html.title` config option of Modern.js Builder as an example, you can directly use this option in the `modern.config.ts` file, and it will be automatically passed to Modern.js Builder.
 
 ```ts title="modern.config.js"
 export default defineConfig({
@@ -38,10 +38,10 @@ export default defineConfig({
 });
 ```
 
-For detailed information about build configuration, please refer to [「Modern.js Builder - Builder Configuration」](https://modernjs.dev/builder/guide/basic/builder-config.html).
+For detailed information about build configuration, please refer to [「Modern.js Builder - Builder Config」](https://modernjs.dev/builder/en/guide/basic/builder-config.html).
 
 ## Builder Capabilities
 
 Modern.js Builder provides rich build capabilities, including JavaScript compilation, CSS compilation, static resource processing, code hot update, code compression, TS type checking, and dozens of other capabilities.
 
-We recommend that you read [「Modern.js Builder - Feature Navigation」](https://modernjs.dev/builder/guide/features.html) to learn about all the build capabilities provided by Modern.js Builder.
+We recommend that you read [「Modern.js Builder - All Features」](https://modernjs.dev/builder/en/guide/features.html) to learn about all the features provided by Modern.js Builder.

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

@@ -29,3 +29,11 @@ Please refer to [Modern.js Builder - Exceptions FAQ](https://modernjs.dev/builde
 - 'compilation' argument error when webpack compiling?
 - Compile error `You may need additional loader`?
 - Find `exports is not defined` runtime error?
+
+## HMR FAQ
+
+Please refer to [Modern.js Builder - HMR FAQ](https://modernjs.dev/builder/guide/faq/hmr.html), such as:
+
+- HMR not working when external React?
+- HMR not working when setting filename hash in development mode?
+- HMR not working when updating React components?

package/docs/zh/configure/app/output/css-modules.mdx

@@ -0,0 +1,13 @@
+---
+sidebar_label: cssModules
+---
+
+# output.cssModules
+
+:::tip
+该配置由 Modern.js Builder 提供，更多信息可参考 [output.cssModules](https://modernjs.dev/builder/api/config-output.html#outputcssmodules)。
+:::
+
+import Main from '@modern-js/builder-doc/docs/zh/config/output/cssModules.md';
+
+<Main />

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

@@ -29,3 +29,11 @@ sidebar_position: 3
 - webpack 编译出现 'compilation' argument 报错？
 - 编译时报错 `You may need additional loader`？
 - 打开页面后报错，提示 `exports is not defined`？
+
+## 热更新问题
+
+请参考 [「Modern.js Builder - 热更新问题」](https://modernjs.dev/builder/guide/faq/hmr.html)，比如：
+
+- 打包时 external React 后，热更新不生效？
+- 开发环境设置文件名的 hash 后，热更新不生效？
+- React 组件的热更新无法生效？

package/package.json

@@ -15,13 +15,13 @@
     "modern",
     "modern.js"
   ],
-  "version": "0.0.0-next-1686121516109",
+  "version": "0.0.0-next-1686150559103",
   "publishConfig": {
     "registry": "https://registry.npmjs.org/",
     "access": "public"
   },
   "peerDependencies": {
-    "@modern-js/builder-doc": "0.0.0-next-1686121516109"
+    "@modern-js/builder-doc": "0.0.0-next-1686150559103"
   },
   "devDependencies": {
     "classnames": "^2",
@@ -33,9 +33,9 @@
     "fs-extra": "^10",
     "@types/node": "^16",
     "@types/fs-extra": "^9",
-    "@modern-js/builder-doc": "0.0.0-next-1686121516109",
-    "@modern-js/doc-tools": "0.0.0-next-1686121516109",
-    "@modern-js/doc-plugin-auto-sidebar": "0.0.0-next-1686121516109"
+    "@modern-js/builder-doc": "0.0.0-next-1686150559103",
+    "@modern-js/doc-tools": "0.0.0-next-1686150559103",
+    "@modern-js/doc-plugin-auto-sidebar": "0.0.0-next-1686150559103"
   },
   "scripts": {
     "dev": "modern dev",