@modern-js/module-tools-docs 2.25.0 → 2.25.2-beta.0

package/docs/zh/guide/basic/modify-output-product.md

@@ -6,20 +6,24 @@ sidebar_position: 3
 
 ## 默认输出产物
 
-当在初始化的项目里使用 `modern build` 命令的时候，会根据 Module Tools 默认支持的配置生成相应的产物。默认支持的配置具体如下：
+当你在初始化的项目里使用 `modern build` 命令的时候，Module Tools 会根据当前配置内容，生成相应的构建产物。
+
+默认的配置内容如下：
 
 ```ts title="modern.config.ts"
 import { moduleTools, defineConfig } from '@modern-js/module-tools';
 
 export default defineConfig({
+  // 注册 Module Tools 的 CLI 工具
   plugins: [moduleTools()],
+  // 指定构建预设配置
   buildPreset: 'npm-library',
 });
 ```
 
 **默认生成产物具有以下特点**：
 
-- 会生成[CommonJS](https://nodejs.org/api/modules.html#modules-commonjs-modules)和[ESM](https://nodejs.org/api/esm.html#modules-ecmascript-modules)两份产物。
+- 会生成 [CommonJS](https://nodejs.org/api/modules.html#modules-commonjs-modules) 和 [ESM](https://nodejs.org/api/esm.html#modules-ecmascript-modules) 两份产物。
 - 代码语法支持到 `ES6` ,更高级的语法将会被转换。
 - 所有的代码经过打包变成了一个文件，即进行了 **bundle** 处理。
 - 产物输出根目录为项目下的 `dist` 目录，类型文件输出的目录为 `dist/types`。
@@ -29,7 +33,7 @@ export default defineConfig({
 1. `buildPreset` 是什么？
 2. 产物的这些特点是由什么决定的？
 
-那么接下来首先解释一下 `buildPreset`。
+接下来，我们首先来了解一下 `buildPreset`。
 
 ## 构建预设
 
@@ -70,10 +74,17 @@ export default defineConfig({
 });
 ```
 
-在上面的代码实现中，`preset.NPM_LIBRARY` 与预设字符串 `"npm-library"` 是相对应的，它代表着 `"npm-library"` 等价的多组构建相关的配置。我们通过 `map` 方法遍历了 `NPM_LIBRARY` 这个数组，在这个数组中包含了多个 `buildConfig` 对象。我们将原本的 `buildConfig` 对象进行了浅拷贝，并修改了浅拷贝后 `target` 的值，将它指定为 `es5`。
+在上面的代码实现中，`preset.NPM_LIBRARY` 与预设字符串 `"npm-library"` 是相对应的，它代表与 `"npm-library"` 等价的多个构建相关的配置。
+
+我们通过 `map` 方法遍历了 `NPM_LIBRARY` 这个数组，在这个数组中包含了多个 `buildConfig` 对象。我们将原本的 `buildConfig` 对象进行了浅拷贝，并修改了浅拷贝后 `target` 的值，将它指定为 `es5`。
+
+如果你想了解 `preset.NPM_LIBRARY` 具体包含的内容，可以通过 [BuildPreset API](/api/config/build-preset) 查看。
+
+此外，在 `preset` 对象下，不仅包含了 `NPM_LIBRARY`，也包含了其他类似的常量。
 
-> 关于 `preset.NPM_LIBRARY` 具体对应的值，可以通过 [BuildPreset API](/api/config/build-preset) 查看。在 `preset` 对象下不仅包含了 `NPM_LIBRARY`，还包含了其他类似的常量。
-> 我们不仅可以使用 `preset.NPM_LIBRARY` 来获取 `"npm-library"` 对应的构建配置，也可以使用 `preset['npm-library']` 这样的方式。
+:::tip
+我们不仅可以使用 `preset.NPM_LIBRARY` 来获取 `"npm-library"` 对应的构建配置，也可以使用 `preset['npm-library']` 这样的方式。
+:::
 
 那么这里的 `buildConfig` 对象是什么呢？之前提到的构建产物特点又是根据什么呢？
 
@@ -81,7 +92,7 @@ export default defineConfig({
 
 ## 构建配置（对象）
 
-**`buildConfig` 是一个用来描述如何编译、生成构建产物的配置对象**。在最开始提到的关于“_构建产物的特点_”，其实都是 `buildConfig` 所支持的属性。目前所支持的属性覆盖了大部分模块类型项目在构建产物时的需求，`buildConfig` 不仅包含一些产物所具备的属性，也包含了构建产物所需要的一些特性功能。接下来从分类的角度简单罗列一下：
+**`buildConfig` 是一个用来描述如何编译、生成构建产物的配置项**。在最开始提到的关于“_构建产物的特点_”，其实都是 `buildConfig` 所支持的属性。目前所支持的属性覆盖了大部分模块类型项目在构建产物时的需求，`buildConfig` 不仅包含一些产物所具备的属性，也包含了构建产物所需要的一些特性功能。接下来从分类的角度简单罗列一下：
 
 **构建产物的基本属性包括：**
 

package/docs/zh/guide/best-practices/components.mdx

@@ -609,7 +609,7 @@ Tailwind CSS 提供了 [`@apply`](https://v2.tailwindcss.com/docs/functions-and-
 
 对于以下代码，在 bundle 和 bundleless 两种模式下，构建产物会有很大区别。
 
-> 所谓 bundle 和 bundleless 可以查看 [【Bundle 和 Bundleless】](/guide/advance/in-depth-about-build#bundle-和-bundleless)
+> 所谓 bundle 和 bundleless 可以查看 [「Bundle 和 Bundleless」](/guide/advance/in-depth-about-build#bundle-和-bundleless)
 
 ```tsx ./src/index.tsx
 import 'tailwindcss/utilities.css';
@@ -786,8 +786,8 @@ export default defineConfig({
 
 ## 测试组件
 
-关于如何对组件进行测试，可以参考 [【测试项目】](/guide/basic/test-your-project)。
+关于如何对组件进行测试，可以参考 [「测试项目」](/guide/basic/test-your-project)。
 
 ## 发布组件
 
-推荐使用模块工程提供版本发布功能，可以参考 [【版本管理与发布】](/guide/basic/publish-your-project)。
+推荐使用模块工程提供版本发布功能，可以参考 [「版本管理与发布」](/guide/basic/publish-your-project)。

package/docs/zh/guide/faq/_category_.json

@@ -0,0 +1,4 @@
+{
+  "label": "常见问题",
+  "sidebar_position": 5
+}

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

@@ -0,0 +1,247 @@
+# 构建相关问题
+
+## 产物问题
+
+import BuildProductFAQ from '@site-docs/components/faq-build-product';
+
+<BuildProductFAQ/>
+
+### Class Fields 的初始化处理
+
+TypeSript 提供了 `useDefineForClassFields` 配置用于控制对于 `public class fields` 的转换处理。
+
+如果有一段代码：
+
+``` ts
+class C {
+  foo = 100;
+  bar: string;
+}
+```
+
+当 `useDefineForClassFields` 为 `false` 的时候，则编译后的代码会变为：
+
+``` ts
+class C {
+  constructor() {
+    this.foo = 100;
+  }
+}
+```
+
+当 `useDefineForClassFields` 为 `true` 的时候，则编译后的代码会变为：
+
+``` ts
+class C {
+  constructor() {
+    Object.defineProperty(this, "foo", {
+      enumerable: true,
+      configurable: true,
+      writable: true,
+      value: 100,
+    });
+    Object.defineProperty(this, "bar", {
+      enumerable: true,
+      configurable: true,
+      writable: true,
+      value: void 0,
+    });
+  }
+}
+```
+
+同时该配置的默认值会根据 tsconfig.json 的 [`target`](https://www.typescriptlang.org/tsconfig#target) 配置而变化：**当 `target` 是 ES2022 或者更高的时候，则 `useDefineForClassFields` 默认配置为 `true`，否则就是默认为 `false`**。
+
+关于 TypeScript 这个配置的更多信息，可以参考下面的链接：
+
+- [The useDefineForClassFields Flag and The declare Property Modifier](https://www.typescriptlang.org/docs/handbook/release-notes/typescript-3-7.html#the-usedefineforclassfields-flag-and-the-declare-property-modifier)
+
+Modern.js Module 目前会根据下面的逻辑进行处理：
+
+1. 首先根据当前项目的 tsconfig.json 的 `useDefineForClassFields` 配置确定在 Modern.js Module 内部如何处理。目前只会读取当前项目路径下的 tsconfig.json 文件的内容，暂时不支持根据 [`extends`](https://www.typescriptlang.org/tsconfig#extends) 配置来获取最终的 tsconfig 配置。
+2. 如果没有检测 tsconfig.json 的 `useDefineForClassFields` 配置，则会根据 tsconfig.json 的 `target` 配置来确定默认值。如果 `target` 大于 `ES2022`（包含 `EsNext`），则`useDefineForClassFields`默认为 `true`，否则为 `false`。
+3. 如果没有检测到 tsconfig.json 的 `target`，则按照 `useDefineForClassFields`的值 为 `true` 进行处理。
+
+### babel-plugin-lodash 将引入的 lodash 处理成 `undefined`
+
+当使用类似下面的方式的时候，会出现这个问题：
+
+``` ts
+import * as Lodash from 'lodash';
+
+export const libs = {
+  _: Lodash,
+}
+```
+
+目前在 `babel-plugin-lodash` Github 上的相关 Issue：
+
+- [#235](https://github.com/lodash/babel-plugin-lodash/issues/235)
+
+这个问题的解决办法是移除 `babel-plugin-lodash`，因为此时不需要该插件进行按需引用，使用该插件会产生副作用。
+
+类似的情况在 `babel-plugin-import` 上也可能会出现。比如有类似如下的代码：
+
+``` ts
+import * as Comps from 'components';
+
+export const libs = {
+  comps: Comps,
+};
+```
+
+此时 `babel-plugin-import` 也可能会导致 `Comps` 变为 `undefined`。因此也需要移除对应的 `babel-plugin-import`。
+
+## 异常类问题
+
+import BuildExceptionFAQ from '@site-docs/components/faq-build-exception';
+
+<BuildExceptionFAQ />
+
+### Dynamic require of "react" is not supported
+
+#### 问题描述
+
+当构建的产物配置中产物格式为 ES modules 的时候：
+
+``` ts
+export default defineConfig({
+  buildConfig: {
+    format: 'esm',
+  },
+});
+```
+
+如果导入了的第三方 npm 包的 cjs 产物，那么生成的产物可能会在 webpack 下有可能无法正常运行。
+
+![](https://lf3-static.bytednsdoc.com/obj/eden-cn/shylnyhaeh7uldvivhn/1280X1280.png)
+
+#### 解决办法
+
+1. **首先需要找到是哪个第三方包引起的问题**。例如报错信息中指向了 `react` 这个包，那么就要寻找在哪个第三方包里存在 `require('react')` 这样的代码。比如 [`react-draggable`](https://web-bnpm.byted.org/package/react-draggable) ，这个包仅包含 `cjs` 产物，那么问题定位到 `react-draggable` 这个包。
+2. 然后我们需要将这个包通过下面的配置进行排除，即**不打包存在问题的第三方包**。
+
+``` ts
+export default defineConfig({
+  buildConfig: {
+    externals: ['react-draggable'],
+  }
+});
+```
+
+#### 参考链接
+
+- [When using esbuild with external react I get Dynamic require of "react" is not supported](https://stackoverflow.com/questions/68423950/when-using-esbuild-with-external-react-i-get-dynamic-require-of-react-is-not-s)
+
+
+### 编译过程中，因为某个组件库的 less 文件报错：`'Operation on an invalid type'`
+
+可能是因为该组件库依赖的 Less 版本是 v3，而 Modern.js Module 默认是 v4。v3 与 v4 在 `math` 配置上存在有 Break Change，可以查看这个[链接](https://stackoverflow.com/questions/73298187/less-error-operation-on-an-invalid-type-in-antd-dependency) 了解详情。
+
+因此，如果是在源码中使用了类似这样的组件库：
+
+在构建配置中使用了 `buildPreset` 的情况下，按照下面进行修改：
+
+``` js
+module.exports = {
+  buildPreset({ extendPreset }) {
+    return extendPreset('your-build-preset', {
+      style: {
+        less: {
+          lessOptions: {
+            math: 'always',
+          },
+        },
+      },
+    });
+  },
+}
+```
+
+或者使用了自定义的 `buildConfig` 的情况下，按照下面进行修改：
+
+``` js
+module.exports = {
+  buildConfig: {
+    style: {
+      less: {
+        lessOptions: {
+          math: 'always',
+        },
+      },
+    },
+  }
+};
+```
+
+如果是在 Storybook 中使用了类似这样的组件，则需要修改 Storybook 的调试配置：
+
+```js
+module.exports = {
+  dev: {
+    storybook: {
+      webpackChain(chain, { CHAIN_ID }) {
+        chain.module
+          .rule(CHAIN_ID.RULE.LESS)
+          .use(CHAIN_ID.USE.LESS)
+          .tap(options => {
+            options.lessOptions = {
+              ...options.lessOptions,
+              math: 'always',
+            };
+            return options;
+          });
+      },
+    },
+  },
+}
+```
+
+### Bundle DTS failed
+
+正常情况下，使用 `tsc` Modern.js Module 不仅支持输出松散的类型文件产物，同时也支持打包类型文件，可以将这些松散的类型文件以及第三方依赖的类型文件打包成一个文件。
+
+不过，打包第三方依赖的类型文件是存在风险的，**因为存在第三方依赖的类型文件无法打包的情况**。
+
+因此当遇到 Modern.js Module 构建过程中出现 `Bundle DTS failed` 的错误信息标题的时候，可以观察报错信息是来自某个第三方依赖。尝试设置 [`dts.respectExternal`](/api/config/build-config.html#dtsrespectexternal) 为 `false` 来关闭打包第三方依赖的类型文件的行为。
+
+### `defineConfig` 函数类型报错：`如果没有引用 "..."，则无法命名 "default" 的推断类型`
+
+检查项目的 tsconfig.json 文件中是否存在 [`include`](https://www.typescriptlang.org/tsconfig#include) 配置，如果没有，则尝试增加下面的内容：
+
+```json
+{
+  "include": ["src"]
+}
+```
+
+## 其他
+
+import BuildOtherFAQ from '@site-docs/components/faq-build-other';
+
+<BuildOtherFAQ />
+
+### 增加额外的编译能力
+
+Modern.js Module 基于 esbuild 实现，因此如果有特殊需求或者想要增加额外的编译能力，可以通过实现 esbuild 插件来解决。
+
+Modern.js Module 提供了 [`esbuildOptions`](/api/config/build-config.html#esbuildoptions) 配置允许修改 Modern.js Module 内部的 esbuild 配置，因此可以通过该配置来增加自定义的 esbuild 插件：
+
+``` js
+export default defineConfig({
+  buildConfig: {
+    esbuildOptions: options => {
+      options.plugins = [
+        ...options.plugins,
+        yourEsbuildPlugin,
+      ];
+      return option;
+    },
+  },
+});
+```
+
+### 支持生成 CSS Modules 的 TypeScript 声明文件
+
+- 方案一：[typed-css-modules](https://github.com/Quramy/typed-css-modules)
+- 方案二：[postcss-modules-dts](https://www.npmjs.com/package/@guanghechen/postcss-modules-dts)

package/docs/zh/guide/faq/index.md

@@ -0,0 +1,7 @@
+# 常见问题
+
+这里是 Modern.js Module 常见问题分类列表：
+
+- [代码构建相关的问题](./build.mdx)
+- [测试相关的问题](./test.mdx)
+- [Storybook 相关的问题](./storybook.mdx)

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

@@ -0,0 +1,101 @@
+# Storybook 相关问题
+
+import BuildStorybookFAQ from '@site-docs/components/faq-storybook';
+
+<BuildStorybookFAQ />
+
+## 支持 Storybook v7
+
+Storybook v7 目前还没支持，目前计划在 Storybook v7 中支持 Rspack 构建，因此进度会慢一些。
+相关 Issue：[#3376](https://github.com/web-infra-dev/modern.js/issues/3376)。
+
+## 使用 Storybook Addon 或者其他配置不生效
+
+Modern.js Module 目前使用的 Storybook 版本是 v6，如果使用了 v7 版本的 Addon 可能会出现插件不生效的情况。
+
+除了 Addon 以外，其他配置也可能会有区别。比如修改 `preview.js` 配置文件的话，Storybook v6 与 v7 的写法也不相同：
+
+- v6：[文档链接](https://storybook.js.org/docs/6.5/react/writing-stories/decorators#global-decorators)
+- v7：[文档链接](https://storybook.js.org/docs/react/writing-stories/decorators#global-decorators)
+
+## Cannot find module 'react-dom/package.json
+
+在执行 Storybook 调试的时候，出现下面的报错提示：
+
+```bash
+ERR! Error: Cannot find module 'react-dom/package.json'
+```
+
+解决办法：在项目中安装 `react-dom` 依赖。
+
+``` json
+{
+    "devDependencies": {
+        "react-dom": "^17"
+    }
+}
+```
+
+## 报错后，看不到具体报错信息
+
+解决办法：
+
+1. 找到 `@storybook/core-server/dist/cjs/dev-server.js`
+2. 找到 `var _await$Promise$all = await Promise.all([preview, manager` 这附近的代码。
+3. 修改成：
+
+``` js
+var _await$Promise$all = await Promise.all([
+    preview.catch(e => console.info(e)),
+    manager // TODO #13083 Restore this when compiling the preview is fast enough
+  // .then((result) => {
+  //   if (!options.ci && !options.smokeTest) openInBrowser(address);
+  //   return result;
+  // })
+  .catch(previewBuilder.bail)]),
+      _await$Promise$all2 = _slicedToArray(_await$Promise$all, 2),
+      previewResult = _await$Promise$all2[0],
+      managerResult = _await$Promise$all2[1]; // TODO #13083 Remove this when compiling the preview is fast enough
+```
+
+## Couldn't find any stories is your Storybook
+
+![storybook-error](https://lf3-static.bytednsdoc.com/obj/eden-cn/shylnyhaeh7uldvivhn/screenshot-20230703-162111.png)
+
+当在预览区域看到类似这样的报错提示的时候，首先可以打开一下浏览器的控制台，应该会有些报错信息。可以先根据报错信息来推断是不是编写代码里出现的问题导致 Storybook 无法正常运行。修复后，再次刷新查看是否正常。
+
+## Storybook 添加 Proxy 功能
+
+Storybook 没有提供相关方案，不过 Storybook Issue 中有找到相关的解决办法。在 Modern.js Module 中，你可以：
+
+1. 添加 `config/storybook/middleware.js` 文件，并初始化下面的内容：
+
+``` js
+/* eslint-disable filenames/match-exported */
+module.exports = function expressMiddleware(router) {
+    // router is express router
+    // import { Router } from 'express'
+    // router = new Router();
+};
+```
+
+2. 添加 http-proxy-middleware 依赖
+3. 添加代理路由相关配置
+
+``` js
+/* eslint-disable filenames/match-exported */
+const { createProxyMiddleware } = require("http-proxy-middleware");
+
+module.exports = function expressMiddleware (router) {
+  router.use('/api', createProxyMiddleware({
+    target: "http://localhost:8000",
+    changeOrigin: true
+  }))
+}
+```
+
+相关 issue 链接：[#11551](https://github.com/storybookjs/storybook/issues/11551)。
+
+## 修改存在 Story 文件的目录
+
+目前暂时无法修改存放 Story 文件的目录，仅对 `your-project/stories` 目录下的 `*.stories.(t|j)s(x)`、`*.stories.md(x)` 文件识别为 Story 文件。

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

@@ -0,0 +1,11 @@
+# 测试相关问题
+
+import TestFAQ from '@site-docs/components/faq-test';
+
+<TestFAQ />
+
+## 执行 `test` 命令报错 `TypeError: Cannot read property 'testEnvironmentOptions' of undefined`
+
+![jest-error](https://lf3-static.bytednsdoc.com/obj/eden-cn/shylnyhaeh7uldvivhn/jest-error-testEnvironmentOptions-of-undefined.jpeg)
+
+问题原因多是存在多个版本的 `jest-environment-jsdom` 依赖，可以检查 Monorepo 中其他项目是否有 `jest-environment-jsdom` 依赖，并通过 Monorepo 提供的 overrides 能力统一依赖版本。

package/docs/zh/plugins/guide/setup-function.mdx

@@ -4,7 +4,7 @@ sidebar_position: 3
 
 # Setup 函数
 
-在[【插件对象】](/plugins/guide/plugin-object) 部分我们知道插件对象包含了一个 `setup` 函数，该函数不仅包含了一个 `api` 对象参数，同时还可以返回一个 Hooks 对象。
+在[「插件对象」](/plugins/guide/plugin-object) 部分我们知道插件对象包含了一个 `setup` 函数，该函数不仅包含了一个 `api` 对象参数，同时还可以返回一个 Hooks 对象。
 
 ## 插件 API 对象
 

package/docs/zh/plugins/official-list/plugin-banner.md

@@ -39,7 +39,7 @@ export default defineConfig({
 ```
 
 :::tip
-注意：CSS 的注释不支持 `//comment` 这样的写法。详见[【CSS 注释】](https://developer.mozilla.org/zh-CN/docs/Web/CSS/Comments)
+注意：CSS 的注释不支持 `//comment` 这样的写法。详见[「CSS 注释」](https://developer.mozilla.org/zh-CN/docs/Web/CSS/Comments)
 :::
 
 ## 示例

package/docs/zh/plugins/official-list/plugin-import.mdx

@@ -3,7 +3,7 @@
 提供与 [babel-plugin-import](https://github.com/umijs/babel-plugin-import) 等价的能力和配置，基于 [SWC](https://swc.rs/) 实现。
 
 :::tip
-从 @modern-js/module-tools 2.16.0 版本开始，该插件功能内置在 module-tools 中，由 [`transformImport`](api/config/build-config.html#transformimport)
+从 `@modern-js/module-tools` v2.16.0 版本开始，该插件功能内置在 Module Tools 中，由 [`transformImport`](api/config/build-config.html#transformimport)
 配置提供。
 :::
 
@@ -34,10 +34,12 @@ export default defineConfig({
   plugins: [
     moduleTools(),
     modulePluginImport({
-      pluginImport: [{
-        libraryName: 'antd',
-        style: true,
-      }],
+      pluginImport: [
+        {
+          libraryName: 'antd',
+          style: true,
+        },
+      ],
     }),
   ],
 });
@@ -47,17 +49,17 @@ export default defineConfig({
 
 ## 配置
 
-* **类型：**
+- **类型：**
 
 ```ts
 type Options = {
   pluginImport?: ImportItem[];
-}
+};
 ```
 
 ### pluginImport
 
-* 类型：`Array`
+- 类型：`object[]`
 
 其中数组元素为一个 babel-plugin-import 的配置对象。配置对象可以参考 [options](https://github.com/umijs/babel-plugin-import#options)。
 
@@ -76,7 +78,7 @@ export default defineConfig({
         {
           libraryName: 'foo',
           style: true,
-        }
+        },
       ],
     }),
   ],
@@ -117,10 +119,12 @@ export default defineConfig({
   plugins: [
     moduleTools(),
     modulePluginImport({
-      pluginImport: [{
-        libraryName: 'foo',
-        customName: 'foo/es/{{ member }}'
-      }],
+      pluginImport: [
+        {
+          libraryName: 'foo',
+          customName: 'foo/es/{{ member }}',
+        },
+      ],
     }),
   ],
 });
@@ -138,16 +142,19 @@ export default defineConfig({
   plugins: [
     moduleTools(),
     modulePluginImport({
-      pluginImport: [{
-        libraryName: 'foo',
-        customName: 'foo/es/{{ member }}'
-      }],
+      pluginImport: [
+        {
+          libraryName: 'foo',
+          customName: 'foo/es/{{ member }}',
+        },
+      ],
     }),
   ],
 });
 ```
 
 ---
+
 转换后:
 
 ```ts
@@ -168,10 +175,12 @@ export default defineConfig({
   plugins: [
     moduleTools(),
     modulePluginImport({
-      pluginImport: [{
-        libraryName: 'foo',
-        customName: 'foo/es/{{ kebabCase member }}',
-      }],
+      pluginImport: [
+        {
+          libraryName: 'foo',
+          customName: 'foo/es/{{ kebabCase member }}',
+        },
+      ],
     }),
   ],
 });

package/modern.config.ts

@@ -123,6 +123,13 @@ export default defineConfig({
       dev: {
         startUrl: 'http://localhost:<port>/module-tools/',
       },
+      source: {
+        alias: {
+          '@site-docs': path.join(__dirname, './docs/zh'),
+          '@site-docs-en': path.join(__dirname, './docs/en'),
+          '@site': require('path').resolve(__dirname),
+        },
+      }
     },
   },
 });

package/package.json

@@ -9,15 +9,15 @@
     "directory": "packages/document/module-doc"
   },
   "license": "MIT",
-  "version": "2.25.0",
+  "version": "2.25.2-beta.0",
   "main": "index.js",
   "dependencies": {
     "@code-hike/mdx": "^0.7.4",
     "react": "^18.2.0",
     "react-dom": "^18.2.0",
     "shiki": "^0.11.1",
-    "@modern-js/doc-plugin-auto-sidebar": "2.25.0",
-    "@modern-js/doc-tools": "2.25.0"
+    "@modern-js/doc-plugin-auto-sidebar": "2.25.1",
+    "@modern-js/doc-tools": "2.25.1"
   },
   "scripts": {
     "dev": "modern dev",