@modern-js/main-doc 3.9.3 → 3.10.1

package/docs/en/guides/upgrade/web-server.md

@@ -21,7 +21,10 @@ These two approaches are mutually exclusive in the legacy version. When migratin
 
 ```typescript
 // Legacy - server/index.ts
-export const unstableMiddleware: UnstableMiddleware[] = [middleware1, middleware2];
+export const unstableMiddleware: UnstableMiddleware[] = [
+  middleware1,
+  middleware2,
+];
 
 // New - server/modern.server.ts
 import { defineServerConfig } from '@modern-js/server-runtime';
@@ -38,13 +41,22 @@ export default defineServerConfig({
 
 ```typescript
 // Legacy
-import type { UnstableMiddleware, UnstableMiddlewareContext } from '@modern-js/server-runtime';
-const middleware: UnstableMiddleware = async (c: UnstableMiddlewareContext, next) => {
+import type {
+  UnstableMiddleware,
+  UnstableMiddlewareContext,
+} from '@modern-js/server-runtime';
+const middleware: UnstableMiddleware = async (
+  c: UnstableMiddlewareContext,
+  next,
+) => {
   return c.response.raw('response'); // Will continue rendering even without calling next
 };
 
 // New
-import { defineServerConfig, type MiddlewareHandler } from '@modern-js/server-runtime';
+import {
+  defineServerConfig,
+  type MiddlewareHandler,
+} from '@modern-js/server-runtime';
 const middleware: MiddlewareHandler = async (c, next) => {
   await next(); // Must call
   return c.text('response');
@@ -53,17 +65,17 @@ const middleware: MiddlewareHandler = async (c, next) => {
 
 ### Context API Comparison
 
-| Legacy API               | New API                 | Description            |
-| -------------------- | ---------------------- | ------------- |
-| `c.request.cookie`   | `getCookie(c, 'key')`  | Cookie reading      |
-| `c.req.cookie()`     | `getCookie(c, 'key')`  | Hono v4 deprecated    |
-| `c.request.pathname` | `c.req.path`           | Request path          |
-| `c.request.host`     | `c.req.header('Host')` | Request host          |
-| `c.request.query`    | `c.req.query()`        | Query parameters          |
-| `c.request.headers`  | `c.req.header()`       | Request headers           |
-| `c.response.status`  | `c.status()`           | Response status code         |
-| `c.response.set`     | `c.res.headers.set`    | Set response headers         |
-| `c.response.raw`     | `c.text` / `c.json`    | Response body           |
+| Legacy API           | New API                | Description          |
+| -------------------- | ---------------------- | -------------------- |
+| `c.request.cookie`   | `getCookie(c, 'key')`  | Cookie reading       |
+| `c.req.cookie()`     | `getCookie(c, 'key')`  | Hono v4 deprecated   |
+| `c.request.pathname` | `c.req.path`           | Request path         |
+| `c.request.host`     | `c.req.header('Host')` | Request host         |
+| `c.request.query`    | `c.req.query()`        | Query parameters     |
+| `c.request.headers`  | `c.req.header()`       | Request headers      |
+| `c.response.status`  | `c.status()`           | Response status code |
+| `c.response.set`     | `c.res.headers.set`    | Set response headers |
+| `c.response.raw`     | `c.text` / `c.json`    | Response body        |
 
 ## afterRender Hook
 
@@ -88,7 +100,10 @@ export const afterRender = (ctx, next) => {
 };
 
 // New - server/modern.server.ts
-import { defineServerConfig, type MiddlewareHandler } from '@modern-js/server-runtime';
+import {
+  defineServerConfig,
+  type MiddlewareHandler,
+} from '@modern-js/server-runtime';
 
 const renderMiddleware: MiddlewareHandler = async (c, next) => {
   await next(); // Wait for page rendering first
@@ -104,6 +119,8 @@ const renderMiddleware: MiddlewareHandler = async (c, next) => {
 };
 
 export default defineServerConfig({
-  renderMiddlewares: [{ name: 'custom-content-injection', handler: renderMiddleware }],
+  renderMiddlewares: [
+    { name: 'custom-content-injection', handler: renderMiddleware },
+  ],
 });
 ```

package/docs/en/index.md

@@ -1,4 +1,5 @@
 ---
 pageType: home
 ---
+
 # Modern.js - A Progressive React Framework for modern web development

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

@@ -39,29 +39,29 @@ Gets the context information of the Modern.js application.
 
 - **Returns:** An `AppContext` object containing the following fields:
 
-| Field Name             | Type                | Description                                                      | When Available               |
-| ---------------------- | ------------------- | ---------------------------------------------------------------- | ---------------------------- |
-| `command`              | `string`            | The currently executing command (e.g., `dev`, `build`, `deploy`) | -                            |
-| `port`                 | `number`            | The development server port number                               | After `onPrepare`            |
-| `configFile`           | `string`            | The absolute path to the configuration file                      | -                            |
-| `isProd`               | `boolean`           | Whether it is in production mode                                 | -                            |
-| `appDirectory`         | `string`            | The absolute path to the project root directory                  | -                            |
-| `srcDirectory`         | `string`            | The absolute path to the project source code directory           | -                            |
-| `distDirectory`        | `string`            | The absolute path to the project output directory                | In `onPrepare` (and later)   |
-| `sharedDirectory`      | `string`            | The absolute path to the shared modules directory                | -                            |
-| `nodeModulesDirectory` | `string`            | The absolute path to the `node_modules` directory                | -                            |
-| `ip`                   | `string`            | The IPv4 address of the current machine                          | -                            |
-| `packageName`          | `string`            | The `name` field in the project's `package.json`                 | -                            |
-| `plugins`              | `object[]`          | The list of currently registered plugins                         | -                            |
-| `entrypoints`          | `object[]`          | Information about page entry points                              | -                            |
-| `serverRoutes`         | `object[]`          | Server-side routing information                                  | -                            |
-| `bundlerType`          | `webpack \| rspack` | The type of bundler currently in use (`webpack` or `rspack`)     | After `onPrepare`            |
-| `metaName`             | `string`            | The internal name of the framework                               | -                            |
-| `apiDirectory`         | `string`            | The absolute path to the API module directory (used by BFF)      | -                            |
-| `lambdaDirectory`      | `string`            | The absolute path to the Lambda module directory (used by BFF)   | -                            |
-| `runtimeConfigFile`    | `string`            | The name of the runtime configuration file                       | -                            |
-| `checkedEntries`       | `string[]`          | Specified entry information                                      | -                            |
-| `apiOnly`              | `boolean`           | Whether it is in `apiOnly` mode                                  | -                            |
+| Field Name             | Type                | Description                                                      | When Available             |
+| ---------------------- | ------------------- | ---------------------------------------------------------------- | -------------------------- |
+| `command`              | `string`            | The currently executing command (e.g., `dev`, `build`, `deploy`) | -                          |
+| `port`                 | `number`            | The development server port number                               | After `onPrepare`          |
+| `configFile`           | `string`            | The absolute path to the configuration file                      | -                          |
+| `isProd`               | `boolean`           | Whether it is in production mode                                 | -                          |
+| `appDirectory`         | `string`            | The absolute path to the project root directory                  | -                          |
+| `srcDirectory`         | `string`            | The absolute path to the project source code directory           | -                          |
+| `distDirectory`        | `string`            | The absolute path to the project output directory                | In `onPrepare` (and later) |
+| `sharedDirectory`      | `string`            | The absolute path to the shared modules directory                | -                          |
+| `nodeModulesDirectory` | `string`            | The absolute path to the `node_modules` directory                | -                          |
+| `ip`                   | `string`            | The IPv4 address of the current machine                          | -                          |
+| `packageName`          | `string`            | The `name` field in the project's `package.json`                 | -                          |
+| `plugins`              | `object[]`          | The list of currently registered plugins                         | -                          |
+| `entrypoints`          | `object[]`          | Information about page entry points                              | -                          |
+| `serverRoutes`         | `object[]`          | Server-side routing information                                  | -                          |
+| `bundlerType`          | `webpack \| rspack` | The type of bundler currently in use (`webpack` or `rspack`)     | After `onPrepare`          |
+| `metaName`             | `string`            | The internal name of the framework                               | -                          |
+| `apiDirectory`         | `string`            | The absolute path to the API module directory (used by BFF)      | -                          |
+| `lambdaDirectory`      | `string`            | The absolute path to the Lambda module directory (used by BFF)   | -                          |
+| `runtimeConfigFile`    | `string`            | The name of the runtime configuration file                       | -                          |
+| `checkedEntries`       | `string[]`          | Specified entry information                                      | -                          |
+| `apiOnly`              | `boolean`           | Whether it is in `apiOnly` mode                                  | -                          |
 
 - **Example:**
 

package/docs/en/plugin/cli-plugins/life-cycle.mdx

@@ -131,5 +131,7 @@ flowchart TD
     style spacer7 fill:none,stroke:none,height:0px;
     style spacer8 fill:none,stroke:none,height:0px;
     style spacer9 fill:none,stroke:none,height:0px;
+
 `}
+
 </Mermaid>

package/docs/en/plugin/introduction.mdx

@@ -126,12 +126,12 @@ You can read [Rsbuild Official Website - Plugins](https://v2.rsbuild.rs/plugins/
 
 The following are official Rsbuild plugins that are already built into Modern.js. They can be enabled without installation:
 
-| Plugin                                                                                 | Description                                                                                                                                     | Modern.js Link                                                                                                                        |
-| -------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------- |
-| [React Plugin](https://v2.rsbuild.rs/plugins/list/plugin-react)                        | Provides support for React                                                                                                                      | -                                                                                                                                     |
-| [SVGR Plugin](https://v2.rsbuild.rs/plugins/list/plugin-svgr)                          | Supports converting SVG images into React components                                                                                            | [tools.svgr](/configure/app/tools/svgr)     |
-| [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/rstackjs/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) |
+| Plugin                                                                           | Description                                                                                                                                     | Modern.js Link                                                                                                                        |
+| -------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------- |
+| [React Plugin](https://v2.rsbuild.rs/plugins/list/plugin-react)                  | Provides support for React                                                                                                                      | -                                                                                                                                     |
+| [SVGR Plugin](https://v2.rsbuild.rs/plugins/list/plugin-svgr)                    | Supports converting SVG images into React components                                                                                            | [tools.svgr](/configure/app/tools/svgr)                                                                                               |
+| [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/rstackjs/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/rstackjs/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/rstackjs/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)                                                                     |
 | [CSS Minimizer Plugin](https://github.com/rstackjs/rsbuild-plugin-css-minimizer) | Used to customize the CSS compression tool, switch to [cssnano](https://cssnano.co/) or other tools for CSS compression                         | [tools.minifyCss](/configure/app/tools/minify-css.html)                                                                               |

package/docs/en/plugin/official/cli-plugins/plugin-bff.mdx

@@ -2,4 +2,4 @@
 
 In a Modern.js application, developers can define API files under the `api/lambda` directory and export API functions using the BFF plugin. In the frontend code, these API functions can be directly invoked by importing the file, which initiates the API requests.
 
-For more details, refer to [BFF - Basic Usage](/guides/advanced-features/bff/function).
+For more details, refer to [BFF - Basic Usage](/guides/advanced-features/bff/function).

package/docs/en/plugin/official/cli-plugins/plugin-ssg.mdx

@@ -2,4 +2,4 @@
 
 SSG (Static Site Generation) is a technical solution that renders complete static web pages at build time based on data and templates. This means that in a production environment, pages are populated with content by default and can be cached by a CDN. For pages that do not require dynamic data, SSG can provide better performance and higher security.
 
-For more details, refer to [Static Site Generation (SSG)](/guides/basic-features/render/ssg).
+For more details, refer to [Static Site Generation (SSG)](/guides/basic-features/render/ssg).

package/docs/en/plugin/plugin-system.mdx

@@ -16,31 +16,26 @@ Modern.js adheres to the design philosophy of "everything is a plugin," modulari
 Modern.js provides three main plugin types, corresponding to different stages of application development:
 
 **CLI Plugins:**
-    -   **Active Stage:** Build time (when executing the `modern` command).
-    -   **Typical Scenarios:**
-        -   Extending command-line tools.
-        -   Modifying build configurations.
-        -   Listening for file changes.
-        -   Controlling the build process.
-    -   **Configuration Method:** The `plugins` field in `modern.config.ts`.
+
+- **Active Stage:** Build time (when executing the `modern` command).
+- **Typical Scenarios:**
+  - Extending command-line tools.
+  - Modifying build configurations.
+  - Listening for file changes.
+  - Controlling the build process.
+- **Configuration Method:** The `plugins` field in `modern.config.ts`.
 
 **Runtime Plugins:**
-    -   **Active Stage:** Application runtime (browser/Node.js environment).
-    -   **Typical Scenarios:**
-        -   Initializing global state or services.
-        -   Encapsulating React Higher-Order Components (HOCs).
-        -   Intercepting or modifying routing behavior.
-        -   Controlling the rendering process.
-    -   **Configuration Method:** The `plugins` field in `src/modern.runtime.ts`.
-
-{/* **Server Plugins:**
-    -   **Active Stage:** Server request processing stage.
-    -   **Typical Scenarios:**
-        -   Adding custom middleware.
-        -   Extending server-side APIs.
-        -   Customizing SSR logic.
-        -   Integrating with backend frameworks.
-    -   **Configuration Method:** The `plugins` field in `server/modern.server.ts`. */}
+
+- **Active Stage:** Application runtime (browser/Node.js environment).
+- **Typical Scenarios:**
+  - Initializing global state or services.
+  - Encapsulating React Higher-Order Components (HOCs).
+  - Intercepting or modifying routing behavior.
+  - Controlling the rendering process.
+- **Configuration Method:** The `plugins` field in `src/modern.runtime.ts`.
+
+{/* **Server Plugins:** - **Active Stage:** Server request processing stage. - **Typical Scenarios:** - Adding custom middleware. - Extending server-side APIs. - Customizing SSR logic. - Integrating with backend frameworks. - **Configuration Method:** The `plugins` field in `server/modern.server.ts`. */}
 
 ## Plugin Structure
 
@@ -196,9 +191,7 @@ Example:
 // Define Hooks
 import { createSyncHook } from '@modern-js/plugin';
 
-type RouteObject = {
-  /** TODO **/
-};
+type RouteObject = {/** TODO **/};
 const modifyRoutes = createSyncHook<(routes: RouteObject[]) => RouteObject[]>();
 
 // Register Hooks in the plugin

package/docs/en/plugin/runtime-plugins/life-cycle.mdx

@@ -25,5 +25,7 @@ flowchart TD
     style registry_hooks stroke-dasharray:5 5,fill:#9CA3AF,font-size:10px;
     style wrapRoot font-size:10px;
     style onBeforeRender font-size:10px;
+
 `}
+
 </Mermaid>

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

@@ -46,17 +46,17 @@ Gets the context information of the Modern.js server.
 
 - **Returns:** A `ServerContext` object containing the following fields:
 
-| Field Name          | Type              | Description                           |
-| ------------------- | ----------------- | ------------------------------------- |
-| `middlewares`       | `MiddlewareObj[]` | Middleware list                       |
-| `renderMiddlewares` | `MiddlewareObj[]` | Render middleware list                |
-| `routes`            | `ServerRoute[]`   | Server routing information            |
-| `appDirectory`      | `string`          | Absolute path to the project root    |
-| `apiDirectory`      | `string`          | Absolute path to the API module dir  |
-| `lambdaDirectory`   | `string`          | Absolute path to the Lambda module dir|
-| `sharedDirectory`   | `string`          | Absolute path to the shared module dir|
-| `distDirectory`     | `string`          | Absolute path to the output directory|
-| `plugins`            | `ServerPlugin[]`  | List of currently registered plugins  |
+| Field Name          | Type              | Description                            |
+| ------------------- | ----------------- | -------------------------------------- |
+| `middlewares`       | `MiddlewareObj[]` | Middleware list                        |
+| `renderMiddlewares` | `MiddlewareObj[]` | Render middleware list                 |
+| `routes`            | `ServerRoute[]`   | Server routing information             |
+| `appDirectory`      | `string`          | Absolute path to the project root      |
+| `apiDirectory`      | `string`          | Absolute path to the API module dir    |
+| `lambdaDirectory`   | `string`          | Absolute path to the Lambda module dir |
+| `sharedDirectory`   | `string`          | Absolute path to the shared module dir |
+| `distDirectory`     | `string`          | Absolute path to the output directory  |
+| `plugins`           | `ServerPlugin[]`  | List of currently registered plugins   |
 
 - **Example:**
 
@@ -111,7 +111,6 @@ In custom plugins, you can only manually call the hooks registered by the corres
 
 ---
 
-
 ## Context Modification
 
 #### `api.updateServerContext`
@@ -143,7 +142,6 @@ api.onPrepare(() => {
 
 ---
 
-
 ## Lifecycle Hooks
 
 #### `api.onPrepare`
@@ -205,7 +203,6 @@ api.onReset(async ({ event }) => {
 
 ---
 
-
 ## Other Notes
 
 - Refer to [Server Plugin Lifecycle](./life-cycle.mdx) to understand the execution order of plugin hooks.

package/docs/en/plugin/server-plugins/life-cycle.mdx

@@ -28,7 +28,9 @@ flowchart TD
     style modifyConfig font-size:10px;
     style onPrepare font-size:10px;
     style apply_middlewares font-size:10px;
+
 `}
+
 </Mermaid>
 
 :::info

package/docs/zh/apis/app/hooks/api/lambda.mdx

@@ -3,7 +3,7 @@ title: lambda/*.ts
 sidebar_position: 3
 ---
 
-# lambda/*.ts
+# lambda/\*.ts
 
 开启 BFF 后，`lambda/` 目录下的文件会按照约定被注册为 BFF 的路由。
 

package/docs/zh/apis/app/hooks/config/html.mdx

@@ -2,6 +2,7 @@
 title: html/
 sidebar_position: 1
 ---
+
 # html/
 
 通过 `config/html` 目录可以在内部默认 html 模板的不同位置注入自定义的 html 片段。

package/docs/zh/apis/app/hooks/config/mock.mdx

@@ -2,6 +2,7 @@
 title: mock/
 sidebar_position: 5
 ---
+
 # mock/
 
 当项目目录下存在 `config/mock/index.ts` 或 `config/mock/index.js` 时，Modern.js

package/docs/zh/apis/app/hooks/config/public.mdx

@@ -2,6 +2,7 @@
 title: public/
 sidebar_position: 3
 ---
+
 # public/
 
 `public/` 目录中可以放置任意格式的静态资源文件，文件会被服务端部署到对应的应用域名下。

package/docs/zh/apis/app/hooks/config/upload.mdx

@@ -2,6 +2,7 @@
 title: upload/
 sidebar_position: 4
 ---
+
 # upload/
 
 `upload/` 目录中可以放置任意格式的静态资源文件。
@@ -30,9 +31,7 @@ sidebar_position: 4
 
 ```tsx
 export default () => {
-  return (
-    <img src={`${process.env.ASSET_PREFIX}/upload/banner.png`}></img>
-  );
+  return <img src={`${process.env.ASSET_PREFIX}/upload/banner.png`}></img>;
 };
 ```
 

package/docs/zh/apis/app/hooks/modern-config.mdx

@@ -2,6 +2,7 @@
 title: modern.config.ts
 sidebar_position: 8
 ---
+
 # modern.config.ts
 
 Modern.js 配置文件, 通过该文件可以对当前项目的各个方面进行个性化配置。

package/docs/zh/apis/app/hooks/shared.mdx

@@ -2,6 +2,7 @@
 title: shared/
 sidebar_position: 5
 ---
+
 # shared/
 
 共享源码目录。当项目在 `api/`、`server/`、`src/` 下有公共代码时，可将这些代码放到 `shared` 目录下，而不是直接引用。

package/docs/zh/apis/app/hooks/src/modern.runtime.mdx

@@ -2,6 +2,7 @@
 title: modern.runtime.ts
 sidebar_position: 4
 ---
+
 # modern.runtime.ts
 
 Modern.js Runtime 配置文件, 通过该文件可以对当前项目的 Runtime 能力进行个性化配置。

package/docs/zh/apis/app/hooks/src/routes.mdx

@@ -2,6 +2,7 @@
 title: routes/
 sidebar_position: 2
 ---
+
 # routes/
 
 应用使用 [约定式路由](/guides/basic-features/routes/routes#约定式路由) 时的入口标识。

package/docs/zh/apis/app/hooks/src/server.mdx

@@ -2,6 +2,7 @@
 title: '*.[server|node].tsx'
 sidebar_position: 8
 ---
-# *.[server|node].tsx
+
+# \*.[server|node].tsx
 
 应用项目中使用，用于放置服务端代码，当 `*.tsx` 和 `*.[server|node].tsx` 共存时，SSR 在服务端执行渲染时，会优先使用 `*.[server|node].tsx` 文件，而不是 `*.tsx` 文件。

package/docs/zh/apis/app/runtime/bff/use-hono-context.mdx

@@ -1,11 +1,11 @@
 ---
 title: useHonoContext
 ---
+
 # useHonoContext
 
 用于在一体化 BFF 函数中获取 Hono 上下文。
 
-
 ## 使用姿势
 
 ```ts

package/docs/zh/apis/app/runtime/core/create-root.mdx

@@ -1,6 +1,7 @@
 ---
 title: createRoot
 ---
+
 # createRoot
 
 用于创建 Modern.js 提供的根组件，该根组件会自动注册 Runtime 插件，并完成 Runtime 插件初始化。
@@ -14,7 +15,9 @@ import { createRoot } from '@modern-js/runtime/react';
 ## 函数签名
 
 ```ts
-export function createRoot(UserApp?: React.ComponentType | null): React.ComponentType<any>;
+export function createRoot(
+  UserApp?: React.ComponentType | null,
+): React.ComponentType<any>;
 ```
 
 ### 参数

package/docs/zh/apis/app/runtime/core/render.mdx

@@ -1,6 +1,7 @@
 ---
 title: render
 ---
+
 # render
 
 用于渲染项目组件。
@@ -16,7 +17,10 @@ render(<ModernRoot />);
 ## 函数签名
 
 ```ts
-export function render(App: React.ReactElement, id?: HTMLElement | string): Promise<any>;
+export function render(
+  App: React.ReactElement,
+  id?: HTMLElement | string,
+): Promise<any>;
 ```
 
 ### 参数
@@ -33,11 +37,10 @@ import { render } from '@modern-js/runtime/browser';
 const ModernRoot = createRoot();
 
 async function beforeRender() {
-   // todo
+  // todo
 }
 
 beforeRender().then(() => {
   render(<ModernRoot />);
 });
 ```
-

package/docs/zh/apis/app/runtime/core/runtime-context.mdx

@@ -1,6 +1,7 @@
 ---
 title: RuntimeContext
 ---
+
 # RuntimeContext
 
 `RuntimeContext` 是一个 React Context，用于在组件中获取 Runtime 上下文信息。该 Context 可以通过 React 的 `use` 或 `useContext` API 访问。
@@ -19,7 +20,7 @@ import { RuntimeContext } from '@modern-js/runtime';
 
 export function App() {
   const runtimeContext = use(RuntimeContext); // 也可以使用 useContext(RuntimeContext)
-  return <div>Hello World</div>
+  return <div>Hello World</div>;
 }
 ```
 
@@ -53,21 +54,21 @@ type TRuntimeContext = {
 ```ts
 type RequestContext = {
   request: {
-    params: Record<string, string>;      // 路由参数
-    pathname: string;                    // 路径名
-    query: Record<string, string>;       // 查询参数
-    headers: IncomingHttpHeaders;        // 请求头
-    host: string;                        // 主机名
-    url: string;                         // 完整 URL
-    referer?: string;                    // 来源页面
-    userAgent?: string;                  // 用户代理
-    cookie?: string;                     // Cookie 字符串
-    cookieMap?: Record<string, string>;  // Cookie 映射对象
+    params: Record<string, string>; // 路由参数
+    pathname: string; // 路径名
+    query: Record<string, string>; // 查询参数
+    headers: IncomingHttpHeaders; // 请求头
+    host: string; // 主机名
+    url: string; // 完整 URL
+    referer?: string; // 来源页面
+    userAgent?: string; // 用户代理
+    cookie?: string; // Cookie 字符串
+    cookieMap?: Record<string, string>; // Cookie 映射对象
   };
   response: {
-    setHeader: (key: string, value: string) => void;  // 设置响应头（仅服务端）
-    status: (code: number) => void;                    // 设置状态码（仅服务端）
-    locals: Record<string, any>;                       // 本地数据
+    setHeader: (key: string, value: string) => void; // 设置响应头（仅服务端）
+    status: (code: number) => void; // 设置状态码（仅服务端）
+    locals: Record<string, any>; // 本地数据
   };
 };
 ```
@@ -91,11 +92,11 @@ function App() {
 
   if (isBrowser === true) {
     // 浏览器端执行逻辑
-    console.log('browser render')
+    console.log('browser render');
   } else {
     // 服务器端执行逻辑
     // 注意：logger 等功能需要通过 Runtime 插件注入到 context 中
-    console.log('server render')
+    console.log('server render');
   }
 }
 ```
@@ -157,4 +158,3 @@ export default function MyComponent() {
   return <div>{message}</div>;
 }
 ```
-

package/docs/zh/apis/app/runtime/router/router.mdx

@@ -2,6 +2,7 @@
 title: router
 sidebar_position: 1
 ---
+
 # router
 
 :::info 补充信息
@@ -135,8 +136,10 @@ export default ErrorBoundary;
 ```ts
 declare function Link(props: LinkProps): React.ReactElement;
 
-interface LinkProps
-  extends Omit<React.AnchorHTMLAttributes<HTMLAnchorElement>, 'href'> {
+interface LinkProps extends Omit<
+  React.AnchorHTMLAttributes<HTMLAnchorElement>,
+  'href'
+> {
   replace?: boolean;
   state?: any;
   to: To;
@@ -157,12 +160,13 @@ type To = string | Partial<Path>;
 ```ts
 declare function NavLink(props: NavLinkProps): React.ReactElement;
 
-interface NavLinkProps
-  extends Omit<LinkProps, 'className' | 'style' | 'children'> {
+interface NavLinkProps extends Omit<
+  LinkProps,
+  'className' | 'style' | 'children'
+> {
   caseSensitive?: boolean;
   children?:
-    | React.ReactNode
-    | ((props: { isActive: boolean }) => React.ReactNode);
+    React.ReactNode | ((props: { isActive: boolean }) => React.ReactNode);
   className?: string | ((props: { isActive: boolean }) => string | undefined);
   end?: boolean;
   style?:

package/docs/zh/apis/app/runtime/ssr/no-ssr.mdx

@@ -1,6 +1,7 @@
 ---
 title: NoSSR
 ---
+
 # NoSSR
 
 被 NoSSR 包裹的内容在服务端不会进行渲染，在客户端 hydrate 阶段也不会渲染，等到整个 App 渲染完成后便会立即渲染。

package/docs/zh/apis/app/runtime/utility/head.mdx

@@ -1,6 +1,7 @@
 ---
 title: Head
 ---
+
 # Head
 
 用于给 `<head>` 元素内添加 html 元素（如 title、meta、script 等），支持 `SSR`。