@modern-js/module-tools-docs 2.57.1 → 2.58.1

package/CHANGELOG.md

@@ -1,5 +1,14 @@
 # @modern-js/module-tools-docs
 
+## 2.58.1
+
+### Patch Changes
+
+- 3824a0e: refactor(website): refactor modern.js docs to latest usage of rspress
+  refactor(website): 重构 modern.js 文档，使用最新 rspress 的用法
+
+## 2.58.0
+
 ## 2.57.1
 
 ## 2.57.0

package/docs/en/api/config/build-config.mdx

@@ -753,7 +753,8 @@ Build lifecycle hooks that allow custom logic to be injected at specific stages
 ```ts
 type HookList = {
   name: string;
-  apply: (compiler: ICompiler) => void.
+  apply: (compiler: ICompiler) => void;
+  applyAfterBuiltIn?: boolean;
 }
 
 ```
@@ -881,6 +882,24 @@ For more information about JSX Transform, you can refer to the following links:
 
 :::
 
+
+## loader
+
+**Experimental**
+
+This option is used to change the interpretation method of the given input file.
+For example, you need to handle the js file as jsx.
+
+```js title="modern.config.ts"
+export default defineConfig({
+  buildConfig: {
+    loader: {
+      '.js': 'jsx',
+    }
+  },
+});
+```
+
 ## metafile
 
 This option is used for build analysis. When enabled, esbuild will generate metadata about the build in JSON format.

package/docs/en/guide/advance/in-depth-about-build.md

@@ -95,6 +95,10 @@ Serial hooks that stop the execution of other tapped functions if a tapped funct
 
 Serial hooks whose results are passed to the next tapped function.
 
+### Hook Order
+
+The execution order of hooks follows the registration order. You can control whether a hook is registered before or after the built-in hooks using `applyAfterBuiltIn`.
+
 ### Hook API
 
 #### load

package/docs/en/guide/faq/basic.mdx

@@ -9,5 +9,5 @@ Modern.js Module uses esbuild to build toolkits and component libraries, and Rsb
 Modern.js Module is based on esbuild for building and cannot use tools from the webpack-related ecosystem.
 You can find more community plugins for esbuild [here](https://github.com/esbuild/community-plugins)
 
-If the UMD product produced by Modern.js Module does not meet your requirements, you can use Rsbuild and add [UMD Plugin](https://rsbuild.dev/plugins/list/plugin-umd) to build UMD products.
+If the UMD product produced by Modern.js Module does not meet your requirements, you can use Rsbuild and add [UMD Plugin](https://github.com/rspack-contrib/rsbuild-plugin-umd) to build UMD products.
 

package/docs/zh/api/config/build-config.mdx

@@ -744,6 +744,8 @@ export default defineConfig({
 type HookList = {
   name: string;
   apply: (compiler: ICompiler) => void;
+  // 是否在 buildIn 钩子之后执行
+  applyAfterBuiltIn?: boolean;
 };
 ```
 
@@ -870,6 +872,22 @@ export default defineConfig({
 
 :::
 
+## loader
+
+**试验性功能**
+
+此选项用来更改给定输入文件的解释方式。例如你需要将 js 文件当做 jsx 处理
+
+```js title="modern.config.ts"
+export default defineConfig({
+  buildConfig: {
+    loader: {
+      '.js': 'jsx',
+    }
+  },
+});
+```
+
 ## metafile
 
 这个选项用于构建分析，开启该选项后，esbuild 会以 JSON 格式生成有关构建的一些元数据。

package/docs/zh/guide/advance/in-depth-about-build.md

@@ -95,6 +95,10 @@ Modern.js Module Hook 使用了 [tapable](https://github.com/webpack/tapable)
 
 串行执行的 hooks，其结果会传递给下一个 tapped function
 
+### Hook 顺序
+
+Hook 的执行顺序和注册顺序保持一致，可以通过 `applyAfterBuiltIn` 来控制在 BuiltIn Hook 前或后注册。
+
 ### Hook API
 
 #### load

package/docs/zh/guide/faq/basic.mdx

@@ -9,4 +9,4 @@ Modern.js Module 使用 esbuild 构建工具库和组件库，Rsbuild 专注于
 Modern.js Module 基于 esbuild 构建，无法使用 webpack 相关生态的工具。
 [这里](https://github.com/esbuild/community-plugins)可以发现更多 esbuild 社区插件
 
-如果 Modern.js Module 生产的 UMD 产物达不到你的要求，可以使用 Rsbuild 并添加 [UMD Plugin](https://rsbuild.dev/zh/plugins/list/plugin-umd) 构建 UMD 产物。
+如果 Modern.js Module 生产的 UMD 产物达不到你的要求，可以使用 Rsbuild 并添加 [UMD Plugin](https://github.com/rspack-contrib/rsbuild-plugin-umd) 构建 UMD 产物。

package/package.json

@@ -9,14 +9,14 @@
     "directory": "packages/document/module-doc"
   },
   "license": "MIT",
-  "version": "2.57.1",
+  "version": "2.58.1",
   "main": "index.js",
   "devDependencies": {
+    "@rspress/shared": "1.27.0",
     "react": "^18.2.0",
     "react-dom": "^18.2.0",
-    "rspress": "1.26.1",
-    "@rspress/shared": "1.26.1",
-    "@modern-js/doc-plugin-auto-sidebar": "2.57.1"
+    "rspress": "1.27.0",
+    "@modern-js/doc-plugin-auto-sidebar": "2.58.1"
   },
   "scripts": {
     "dev": "rspress dev",