@modern-js/main-doc 3.9.3 → 3.10.0

package/docs/en/guides/advanced-features/international/configuration.mdx

@@ -6,10 +6,10 @@ title: Configuration
 
 Plugin configuration is split between two files, each with a different responsibility:
 
-| File | Purpose |
-| --- | --- |
-| `modern.config.ts` | Basic plugin settings, read during build/startup |
-| `src/modern.runtime.ts` | i18next initialization options, read at runtime |
+| File                    | Purpose                                          |
+| ----------------------- | ------------------------------------------------ |
+| `modern.config.ts`      | Basic plugin settings, read during build/startup |
+| `src/modern.runtime.ts` | i18next initialization options, read at runtime  |
 
 :::warning Function values can only be configured at runtime
 `modern.config.ts` runs at build time and cannot serialize functions. SDK loaders, custom detection functions, and similar function values must be placed in `modern.runtime.ts`.
@@ -17,13 +17,13 @@ Plugin configuration is split between two files, each with a different responsib
 
 ## Configuration Ownership
 
-| Configuration | Where to configure |
-| --- | --- |
-| `localeDetection` (language detection, path redirects, etc.) | `modern.config.ts` |
-| `backend` (resource paths, SDK declaration, etc.) | `modern.config.ts` |
-| `i18nInstance` | `modern.runtime.ts` |
+| Configuration                                                  | Where to configure  |
+| -------------------------------------------------------------- | ------------------- |
+| `localeDetection` (language detection, path redirects, etc.)   | `modern.config.ts`  |
+| `backend` (resource paths, SDK declaration, etc.)              | `modern.config.ts`  |
+| `i18nInstance`                                                 | `modern.runtime.ts` |
 | `initOptions` (`fallbackLng`, `ns`, and other i18next options) | `modern.runtime.ts` |
-| The actual `backend.sdk` loader function | `modern.runtime.ts` |
+| The actual `backend.sdk` loader function                       | `modern.runtime.ts` |
 
 ## CLI Configuration
 
@@ -44,15 +44,15 @@ export default defineConfig({
 
 ### localeDetection Options
 
-| Field | Type | Default | Description |
-| --- | --- | --- | --- |
-| `languages` | `string[]` | `[]` | Supported language list |
-| `fallbackLanguage` | `string` | `''` | Fallback language when detection fails |
-| `localePathRedirect` | `boolean` | `false` | Handles URL locale prefix recognition, redirects, and switching. See [Routing Integration](./routing.md#enable-locale-path-prefixes) |
-| `i18nextDetector` | `boolean` | `false` | Enables the i18next detector (Cookie / Header, etc.) |
-| `detection` | `LanguageDetectorOptions` | - | Detailed i18next detector configuration. See [Locale Detection](./locale-detection.md) |
-| `ignoreRedirectRoutes` | `string[] \| Function` | - | Routes that skip redirects. See [Locale Detection](./locale-detection.md#ignoreredirectroutes) |
-| `localeDetectionByEntry` | `Record<string, ...>` | - | Per-entry overrides for multiple entries |
+| Field                    | Type                      | Default | Description                                                                                                                          |
+| ------------------------ | ------------------------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------ |
+| `languages`              | `string[]`                | `[]`    | Supported language list                                                                                                              |
+| `fallbackLanguage`       | `string`                  | `''`    | Fallback language when detection fails                                                                                               |
+| `localePathRedirect`     | `boolean`                 | `false` | Handles URL locale prefix recognition, redirects, and switching. See [Routing Integration](./routing.md#enable-locale-path-prefixes) |
+| `i18nextDetector`        | `boolean`                 | `false` | Enables the i18next detector (Cookie / Header, etc.)                                                                                 |
+| `detection`              | `LanguageDetectorOptions` | -       | Detailed i18next detector configuration. See [Locale Detection](./locale-detection.md)                                               |
+| `ignoreRedirectRoutes`   | `string[] \| Function`    | -       | Routes that skip redirects. See [Locale Detection](./locale-detection.md#ignoreredirectroutes)                                       |
+| `localeDetectionByEntry` | `Record<string, ...>`     | -       | Per-entry overrides for multiple entries                                                                                             |
 
 **Example:**
 
@@ -105,11 +105,11 @@ interface BackendOptions {
 
 **backend auto-enable rules:**
 
-| Situation | Result |
-| --- | --- |
-| `loadPath` or `addPath` is configured | Automatically enabled. No need to write `enabled: true` |
-| No backend is configured, but a `locales` directory exists and contains JSON files | Automatically enabled with the default `loadPath` |
-| `enabled: false` is set explicitly | Disabled, and auto-detection is skipped |
+| Situation                                                                          | Result                                                  |
+| ---------------------------------------------------------------------------------- | ------------------------------------------------------- |
+| `loadPath` or `addPath` is configured                                              | Automatically enabled. No need to write `enabled: true` |
+| No backend is configured, but a `locales` directory exists and contains JSON files | Automatically enabled with the default `loadPath`       |
+| `enabled: false` is set explicitly                                                 | Disabled, and auto-detection is skipped                 |
 
 Auto-detected directory locations, in priority order:
 
@@ -118,11 +118,11 @@ Auto-detected directory locations, in priority order:
 
 **Which backend should you choose?**
 
-| Scenario | Recommended approach |
-| --- | --- |
-| Translation files are local to the project | Static file backend (configure `loadPath`; CSR/SSR switch automatically) |
-| Translations come from a remote API or translation platform | Custom backend (configure `sdk: true`) |
-| Local fallback + remote real-time updates | Chained backend (configure both `loadPath` and `sdk`) |
+| Scenario                                                    | Recommended approach                                                     |
+| ----------------------------------------------------------- | ------------------------------------------------------------------------ |
+| Translation files are local to the project                  | Static file backend (configure `loadPath`; CSR/SSR switch automatically) |
+| Translations come from a remote API or translation platform | Custom backend (configure `sdk: true`)                                   |
+| Local fallback + remote real-time updates                   | Chained backend (configure both `loadPath` and `sdk`)                    |
 
 See [Resource Loading](./resource-loading.md) for detailed usage.
 
@@ -136,7 +136,7 @@ const i18nInstance = i18next.createInstance();
 
 export default defineRuntimeConfig({
   i18n: {
-    i18nInstance,   // Optional. An isolated instance is recommended.
+    i18nInstance, // Optional. An isolated instance is recommended.
     initOptions: {
       fallbackLng: 'en',
       supportedLngs: ['zh', 'en'],
@@ -164,13 +164,13 @@ import Desc from '@site-docs/components/international/init-options-desc';
 
 <Desc />
 
-| Field | Description |
-| --- | --- |
-| `fallbackLng` | Which language resources i18next falls back to when a translation key is missing. Supports strings, arrays, and maps (fallback chains) |
-| `supportedLngs` | Language list supported by i18next |
-| `ns` | Namespace list. Default is `['translation']` |
-| `defaultNS` | Default namespace. Default is `'translation'` |
-| `lng` | Forces the initial language. Usually not needed because the detector decides it |
+| Field           | Description                                                                                                                            |
+| --------------- | -------------------------------------------------------------------------------------------------------------------------------------- |
+| `fallbackLng`   | Which language resources i18next falls back to when a translation key is missing. Supports strings, arrays, and maps (fallback chains) |
+| `supportedLngs` | Language list supported by i18next                                                                                                     |
+| `ns`            | Namespace list. Default is `['translation']`                                                                                           |
+| `defaultNS`     | Default namespace. Default is `'translation'`                                                                                          |
+| `lng`           | Forces the initial language. Usually not needed because the detector decides it                                                        |
 
 `fallbackLng` supports fallback chains, which are useful for regional language degradation:
 

package/docs/en/guides/advanced-features/international/locale-detection.mdx

@@ -64,8 +64,8 @@ Both methods can be enabled at the same time:
 ```ts
 i18nPlugin({
   localeDetection: {
-    localePathRedirect: true,   // Path prefix
-    i18nextDetector: true,      // Cookie / Header, etc.
+    localePathRedirect: true, // Path prefix
+    i18nextDetector: true, // Cookie / Header, etc.
     languages: ['zh', 'en'],
     fallbackLanguage: 'en',
     detection: {
@@ -77,39 +77,48 @@ i18nPlugin({
 
 ## Detection Options (`detection`)
 
-| Option | Type | Default | Description |
-| --- | --- | --- | --- |
-| `order` | `string[]` | See below | Detection order inside the i18next detector |
-| `lookupQuerystring` | `string` | `'lng'` | Query parameter key, such as `?lng=en` |
-| `lookupCookie` | `string` | `'i18next'` | Cookie key |
-| `lookupLocalStorage` | `string` | `'i18nextLng'` | LocalStorage key (browser only) |
-| `lookupSession` | `string` | - | SessionStorage key (browser only) |
-| `lookupHeader` | `string` | `'accept-language'` | HTTP request header key |
-| `lookupFromPathIndex` | `number` | `0` | Which URL path segment to start recognizing language from |
-| `caches` | `false \| string[]` | - | Where to cache the detected language, such as `['cookie']` |
-| `cookieMinutes` | `number` | `525600` (1 year) | Cookie expiration time in minutes |
-| `cookieExpirationDate` | `Date` | - | Cookie expiration date. Takes precedence over `cookieMinutes` |
-| `cookieDomain` | `string` | - | Cookie domain |
+| Option                 | Type                | Default             | Description                                                   |
+| ---------------------- | ------------------- | ------------------- | ------------------------------------------------------------- |
+| `order`                | `string[]`          | See below           | Detection order inside the i18next detector                   |
+| `lookupQuerystring`    | `string`            | `'lng'`             | Query parameter key, such as `?lng=en`                        |
+| `lookupCookie`         | `string`            | `'i18next'`         | Cookie key                                                    |
+| `lookupLocalStorage`   | `string`            | `'i18nextLng'`      | LocalStorage key (browser only)                               |
+| `lookupSession`        | `string`            | -                   | SessionStorage key (browser only)                             |
+| `lookupHeader`         | `string`            | `'accept-language'` | HTTP request header key                                       |
+| `lookupFromPathIndex`  | `number`            | `0`                 | Which URL path segment to start recognizing language from     |
+| `caches`               | `false \| string[]` | -                   | Where to cache the detected language, such as `['cookie']`    |
+| `cookieMinutes`        | `number`            | `525600` (1 year)   | Cookie expiration time in minutes                             |
+| `cookieExpirationDate` | `Date`              | -                   | Cookie expiration date. Takes precedence over `cookieMinutes` |
+| `cookieDomain`         | `string`            | -                   | Cookie domain                                                 |
 
 **Default detection order when `order` is not configured:**
 
 ```ts
-['querystring', 'cookie', 'localStorage', 'header', 'navigator', 'htmlTag', 'path', 'subdomain']
+[
+  'querystring',
+  'cookie',
+  'localStorage',
+  'header',
+  'navigator',
+  'htmlTag',
+  'path',
+  'subdomain',
+];
 ```
 
 **Available `order` values:**
 
-| Value | Source | Limitation |
-| --- | --- | --- |
-| `querystring` | URL query parameter (`?lng=en`) | - |
-| `cookie` | Cookie | - |
-| `localStorage` | LocalStorage | Browser only |
-| `sessionStorage` | SessionStorage | Browser only |
-| `navigator` | Browser language settings | Browser only |
-| `htmlTag` | `<html lang="...">` | Browser only |
-| `header` | `Accept-Language` request header | - |
-| `path` | URL path (requires `localePathRedirect`) | - |
-| `subdomain` | Subdomain (`en.example.com`) | - |
+| Value            | Source                                   | Limitation   |
+| ---------------- | ---------------------------------------- | ------------ |
+| `querystring`    | URL query parameter (`?lng=en`)          | -            |
+| `cookie`         | Cookie                                   | -            |
+| `localStorage`   | LocalStorage                             | Browser only |
+| `sessionStorage` | SessionStorage                           | Browser only |
+| `navigator`      | Browser language settings                | Browser only |
+| `htmlTag`        | `<html lang="...">`                      | Browser only |
+| `header`         | `Accept-Language` request header         | -            |
+| `path`           | URL path (requires `localePathRedirect`) | -            |
+| `subdomain`      | Subdomain (`en.example.com`)             | -            |
 
 ## ignoreRedirectRoutes
 
@@ -118,7 +127,7 @@ Specify which paths should skip locale path redirects. This is useful for API ro
 **Syntax 1: string array** (supports exact match and prefix match)
 
 ```ts
-ignoreRedirectRoutes: ['/api', '/admin', '/static']
+ignoreRedirectRoutes: ['/api', '/admin', '/static'];
 // '/api' matches both /api and /api/users.
 ```
 

package/docs/en/guides/advanced-features/international/resource-loading.mdx

@@ -6,11 +6,11 @@ title: Resource Loading
 
 How translation files are loaded depends on where your translation resources are stored:
 
-| Scenario | Loading method |
-| --- | --- |
-| Translation files are local to the project | Static file backend (the default method in this guide) |
-| Translations come from a remote API or translation platform | Custom backend |
-| Both: local fallback + remote real-time updates | Chained backend |
+| Scenario                                                    | Loading method                                         |
+| ----------------------------------------------------------- | ------------------------------------------------------ |
+| Translation files are local to the project                  | Static file backend (the default method in this guide) |
+| Translations come from a remote API or translation platform | Custom backend                                         |
+| Both: local fallback + remote real-time updates             | Chained backend                                        |
 
 ## Static File Backend
 
@@ -103,11 +103,11 @@ export default defineRuntimeConfig({
 
 ```ts
 interface I18nSdkLoadOptions {
-  lng?: string;      // Single language code
-  ns?: string;       // Single namespace
-  lngs?: string[];   // Multiple language codes
-  nss?: string[];    // Multiple namespaces
-  all?: boolean;     // Load all resources
+  lng?: string; // Single language code
+  ns?: string; // Single namespace
+  lngs?: string[]; // Multiple language codes
+  nss?: string[]; // Multiple namespaces
+  all?: boolean; // Load all resources
 }
 ```
 
@@ -125,7 +125,7 @@ Use local files and a custom backend together to implement "show local translati
 i18nPlugin({
   backend: {
     loadPath: '/locales/{{lng}}/{{ns}}.json', // Local files, fast display
-    sdk: true,                                 // Remote loading, async update
+    sdk: true, // Remote loading, async update
   },
 });
 ```
@@ -138,7 +138,9 @@ export default defineRuntimeConfig({
       backend: {
         sdk: async options => {
           if (options.lng && options.ns) {
-            const res = await fetch(`https://api.example.com/i18n/${options.lng}/${options.ns}`);
+            const res = await fetch(
+              `https://api.example.com/i18n/${options.lng}/${options.ns}`,
+            );
             return { [options.lng]: { [options.ns]: await res.json() } };
           }
           return {};
@@ -151,8 +153,8 @@ export default defineRuntimeConfig({
 
 **`cacheHitMode` option** (controls how the two backends cooperate):
 
-| Value | Behavior |
-| --- | --- |
-| `'none'` | Use local files after a successful local hit and do not request the custom backend |
-| `'refresh'` | Continue requesting the custom backend and update cache, but do not update the current page |
-| `'refreshAndUpdateStore'` | Continue requesting the custom backend, update cache, and refresh page text (default) |
+| Value                     | Behavior                                                                                    |
+| ------------------------- | ------------------------------------------------------------------------------------------- |
+| `'none'`                  | Use local files after a successful local hit and do not request the custom backend          |
+| `'refresh'`               | Continue requesting the custom backend and update cache, but do not update the current page |
+| `'refreshAndUpdateStore'` | Continue requesting the custom backend, update cache, and refresh page text (default)       |

package/docs/en/guides/advanced-features/international/routing.mdx

@@ -26,11 +26,11 @@ i18nPlugin({
 
 **Result:**
 
-| Visited path | Result |
-| --- | --- |
-| `/about` | Redirects to `/en/about` |
-| `/en/about` | Visits normally, language is `en` |
-| `/zh/about` | Visits normally, language is `zh` |
+| Visited path | Result                            |
+| ------------ | --------------------------------- |
+| `/about`     | Redirects to `/en/about`          |
+| `/en/about`  | Visits normally, language is `en` |
+| `/zh/about`  | Visits normally, language is `zh` |
 
 Some paths, such as API routes and static assets, do not need locale prefixes. Use `ignoreRedirectRoutes` to skip redirects. See [Locale Detection -> ignoreRedirectRoutes](./locale-detection.md#ignoreredirectroutes).
 
@@ -108,7 +108,9 @@ function Navigation() {
     <nav>
       <I18nLink to="/">Home</I18nLink>
       <I18nLink to="/about">About</I18nLink>
-      <I18nLink to="/contact" replace>Contact</I18nLink>
+      <I18nLink to="/contact" replace>
+        Contact
+      </I18nLink>
     </nav>
   );
 }

package/docs/en/guides/advanced-features/international.mdx

@@ -10,15 +10,15 @@ import I18nPluginIntroduce from '@site-docs/components/international/introduce';
 
 ## Where to start?
 
-| What you want to do | Documentation |
-| --- | --- |
-| Integrate for the first time and run an example | [Quick Start](./international/quick-start.md) |
-| Learn all configuration options | [Configuration](./international/configuration.md) |
-| Detect language from URL / Cookie / Header | [Locale Detection](./international/locale-detection.md) |
-| Implement paths with locale prefixes, such as `/en/about` | [Routing Integration](./international/routing.md) |
+| What you want to do                                          | Documentation                                                                            |
+| ------------------------------------------------------------ | ---------------------------------------------------------------------------------------- |
+| Integrate for the first time and run an example              | [Quick Start](./international/quick-start.md)                                            |
+| Learn all configuration options                              | [Configuration](./international/configuration.md)                                        |
+| Detect language from URL / Cookie / Header                   | [Locale Detection](./international/locale-detection.md)                                  |
+| Implement paths with locale prefixes, such as `/en/about`    | [Routing Integration](./international/routing.md)                                        |
 | Load translation resources from a remote service or platform | [Resource Loading -> Custom Backend](./international/resource-loading.md#custom-backend) |
-| SSR, multiple entries, or custom instances | [Advanced Usage](./international/advanced.md) |
-| Look up Hooks / components / type definitions | [API Reference](./international/api.md) |
+| SSR, multiple entries, or custom instances                   | [Advanced Usage](./international/advanced.md)                                            |
+| Look up Hooks / components / type definitions                | [API Reference](./international/api.md)                                                  |
 
 ## Core Capabilities
 

package/docs/en/guides/advanced-features/server-monitor/logger.mdx

@@ -6,11 +6,11 @@ Log events are distributed by Modern.js as events of type `log`.
 
 Based on server-side runtime logic, Modern.js provides the following log events:
 
-| Stage           | Message                                      | Level |
-| --------------- | -------------------------------------------- | ----- |
-| RENDER_HTML     | App Render To HTML                           | error |
-| RENDER_STREAM   | An error occurs during streaming SSR         | error |
-| RENDER_SHELL    | An error occurs during streaming render shell | error |
+| Stage         | Message                                       | Level |
+| ------------- | --------------------------------------------- | ----- |
+| RENDER_HTML   | App Render To HTML                            | error |
+| RENDER_STREAM | An error occurs during streaming SSR          | error |
+| RENDER_SHELL  | An error occurs during streaming render shell | error |
 
 ## Built-in Monitor
 

package/docs/en/guides/advanced-features/server-monitor/metrics.mdx

@@ -8,15 +8,15 @@ When SSR is enabled, we need to monitor server-side phase durations and have the
 
 Based on server-side runtime logic, Modern.js provides the following metric events:
 
-| Key                      | Description              |
-| ------------------------ | ------------------------ |
-| server-handle-request    | Modern.js Server request handling duration                          |
+| Key                      | Description                                                                                                           |
+| ------------------------ | --------------------------------------------------------------------------------------------------------------------- |
+| server-handle-request    | Modern.js Server request handling duration                                                                            |
 | ssr-render-shell         | [SSR] When using Streaming SSR, React renders a shell for early streaming. This marks shell rendering completion time |
-| ssr-render-html          | [SSR] Time taken by React to render component tree to HTML (typically under 50ms) |
-| server-middleware        | Total execution time of Modern.js custom server middlewares         |
-| server-loader            | Server-side Data Loader total duration                          |
-| server-loader-#id        | Individual Data Loader durations on server-side                 |
-| server-loader-navigation | Server-side Data Loader duration during client navigation       |
+| ssr-render-html          | [SSR] Time taken by React to render component tree to HTML (typically under 50ms)                                     |
+| server-middleware        | Total execution time of Modern.js custom server middlewares                                                           |
+| server-loader            | Server-side Data Loader total duration                                                                                |
+| server-loader-#id        | Individual Data Loader durations on server-side                                                                       |
+| server-loader-navigation | Server-side Data Loader duration during client navigation                                                             |
 
 Modern.js server workflow diagram:
 

package/docs/en/guides/advanced-features/server-monitor/monitors.mdx

@@ -129,9 +129,7 @@ const myMonitorPlugin = (): ServerPlugin => ({
           console.log(`[${event.payload.level}] ${event.payload.message}`);
         } else if (event.type === 'timing') {
           // Handle timing events
-          console.log(
-            `Timing: ${event.payload.name} = ${event.payload.dur}ms`,
-          );
+          console.log(`Timing: ${event.payload.name} = ${event.payload.dur}ms`);
         } else if (event.type === 'counter') {
           // Handle counter events
           console.log(`Counter: ${event.payload.name}`);

package/docs/en/guides/advanced-features/source-build.mdx

@@ -142,7 +142,7 @@ At the same time, we need to set `composite` to `true` in the lib project's `tsc
 {
   "compilerOptions": {
     "composite": true
-  },
+  }
 }
 ```
 

package/docs/en/guides/advanced-features/web-server.mdx

@@ -50,13 +50,13 @@ After creating the file, you can write custom logic in this file.
 
 3. Include `server` directory in `tsconfig.json`
 
-```json5
+```jsonc
 {
   // ...
   "include": [
     // ...
-    "server"
-  ]
+    "server",
+  ],
 }
 ```
 

package/docs/en/guides/basic-features/data/data-fetch.mdx

@@ -24,9 +24,7 @@ Modern.js recommends managing routes using [conventional routing](/guides/basic-
 In the `routes/user/page.data.ts` file, you can export a Data Loader function:
 
 ```ts title="routes/user/page.data.ts"
-export type ProfileData = {
-  /*  some types */
-};
+export type ProfileData = {/*  some types */};
 
 export const loader = async (): Promise<ProfileData> => {
   const res = await fetch('https://api/user/profile');

package/docs/en/guides/basic-features/data/data-write.mdx

@@ -42,7 +42,7 @@ import {
   useFetcher,
   useLoaderData,
   useParams,
-  Outlet
+  Outlet,
 } from '@modern-js/runtime/router';
 
 export default () => {
@@ -50,23 +50,21 @@ export default () => {
   const { submit } = useFetcher();
   const editUser = () => {
     const newUser = {
-      name: 'Modern.js'
-    }
+      name: 'Modern.js',
+    };
     return submit(newUser, {
       method: 'post',
       encType: 'application/json',
-    })
-  }
+    });
+  };
   return (
     <div>
       <button onClick={editUser}>edit user</button>
-      <div className="user-profile">
-        {userInfo}
-      </div>
+      <div className="user-profile">{userInfo}</div>
       <Outlet context={userInfo}></Outlet>
     </div>
-  )
-}
+  );
+};
 ```
 
 After executing `submit`, the defined `action` function will be triggered. You can get the submitted data from the [parameters](/guides/basic-features/data/data-write.html#parameters) in the `action` function and ultimately send the data to the server.
@@ -123,17 +121,18 @@ useSubmit:
 
 ```ts
 const submit = useSubmit();
-submit(null, { method: "post", action: "/logout" });
+submit(null, { method: 'post', action: '/logout' });
 ```
 
 useFetcher:
 
 ```ts
 const { submit } = useFetcher();
-submit(null, { method: "post", action: "/logout" });
+submit(null, { method: 'post', action: '/logout' });
 ```
 
 The `submit` function takes two parameters. The first parameter is the `formData` passed to the server. The second parameter is an optional object where:
+
 - `method` corresponds to the form submission method. In most data writing scenarios, you can set the `method` to `post`.
 - `action` specifies the route component to trigger the Data Action. If not provided, it defaults to the current route component's action. For example, executing submit in `user/page.tsx` or its sub-components will trigger the action defined in `user/page.data.ts`.
 
@@ -151,7 +150,7 @@ For example, `FormData`:
 
 ```ts
 let formData = new FormData();
-formData.append("cheese", "gouda");
+formData.append('cheese', 'gouda');
 submit(formData);
 // In the action, you can get the data by request.json
 ```
@@ -160,7 +159,7 @@ or `URLSearchParams`:
 
 ```ts
 let searchParams = new URLSearchParams();
-searchParams.append("cheese", "gouda");
+searchParams.append('cheese', 'gouda');
 submit(searchParams);
 // In the action, you can get the data by request.json
 ```
@@ -168,10 +167,10 @@ submit(searchParams);
 or any value that the `URLSearchParams` constructor accepts:
 
 ```ts
-submit("cheese=gouda&toasted=yes");
+submit('cheese=gouda&toasted=yes');
 submit([
-  ["cheese", "gouda"],
-  ["toasted", "yes"],
+  ['cheese', 'gouda'],
+  ['toasted', 'yes'],
 ]);
 // In the action, you can get the data by request.json
 ```
@@ -180,11 +179,11 @@ By default, if the first parameter of the `submit` function is an object, the co
 
 ```ts
 submit(
-  { key: "value" },
+  { key: 'value' },
   {
-    method: "post",
-    encType: "application/x-www-form-urlencoded",
-  }
+    method: 'post',
+    encType: 'application/x-www-form-urlencoded',
+  },
 );
 
 // In the action, you can get the data by request.formData
@@ -193,14 +192,11 @@ submit(
 You can also specify the encoding type via the second parameter:
 
 ```tsx
-submit(
-  { key: "value" },
-  { method: "post", encType: "application/json" }
-);
+submit({ key: 'value' }, { method: 'post', encType: 'application/json' });
 
 submit('{"key":"value"}', {
-  method: "post",
-  encType: "application/json",
+  method: 'post',
+  encType: 'application/json',
 });
 
 // In the action, you can get the data by request.json
@@ -209,7 +205,7 @@ submit('{"key":"value"}', {
 or submit plain text:
 
 ```ts
-submit("value", { method: "post", encType: "text/plain" });
+submit('value', { method: 'post', encType: 'text/plain' });
 // In the action, you can get the data by request.text
 ```
 

package/docs/en/guides/basic-features/debug/mock.mdx

@@ -102,8 +102,8 @@ type MockConfig = {
 };
 
 export const config = {
-  enable: false
-}
+  enable: false,
+};
 ```
 
 Currently only the `enable` configuration is supported, which allows developers to control whether to execute mock.

package/docs/en/guides/basic-features/debug/using-storybook.mdx

@@ -2,7 +2,7 @@
 sidebar_position: 15
 ---
 
-import { PackageManagerTabs } from '@theme'
+import { PackageManagerTabs } from '@theme';
 
 # Using Storybook
 
@@ -33,17 +33,16 @@ You need to install `@rsbuild/core` in your project, otherwise the plugin may no
 ## Configure `.storybook/main.ts`
 
 ```ts
-import type { StorybookConfig } from 'storybook-react-rsbuild'
+import type { StorybookConfig } from 'storybook-react-rsbuild';
 
 const config: StorybookConfig = {
   stories: ['../src/**/*.stories.@(js|jsx|mjs|ts|tsx)'],
   addons: ['storybook-addon-modernjs'],
   framework: 'storybook-react-rsbuild',
-}
-export default config
+};
+export default config;
 ```
 
-
 ## BFF Integrated Calls in Storybook
 
 When you want to call BFF APIs directly in Storybook components (for example `/api/**`), start the BFF service and configure a proxy in Storybook's dev server to avoid CORS issues.
@@ -56,7 +55,7 @@ Add the following scripts to `package.json` to start the BFF server and Storyboo
 {
   "scripts": {
     "dev:api": "modern dev --api-only",
-    "storybook": "BFF_PROXY=1 storybook dev -p 6006 --no-open",
+    "storybook": "BFF_PROXY=1 storybook dev -p 6006 --no-open"
   }
 }
 ```

package/docs/en/guides/basic-features/html.mdx

@@ -19,9 +19,8 @@ For example, consider the following directory structure:
     ├── entry-a
     │   ├── Document.tsx
     │   └── routes
-    ├── entry-b
-    │    └── routes
-    └── modern-app-env.d.ts
+    └── entry-b
+         └── routes
 ```
 
 `entry-a` will use the `Document.tsx` file under the current entry as the template. If there is no `Document.tsx` file under the current entry, like `entry-b`, it will look for the `Document.tsx` file under the root directory.