@modern-js/main-doc 3.9.2 → 3.10.0

package/docs/en/configure/app/usage.mdx

@@ -265,11 +265,7 @@ import { defineConfig } from '@modern-js/app-tools';
 import { xxPlugin } from '@modern-js/plugin-xx';
 
 export default defineConfig({
-  plugins: [
-    xxPlugin({
-      /** Add parameters here */
-    }),
-  ],
+  plugins: [xxPlugin({/** Add parameters here */})],
 });
 ```
 

package/docs/en/guides/advanced-features/bff/cross-project.mdx

@@ -9,6 +9,7 @@ Cross-project invocation consists of **producer** and **consumer** sides. The pr
 
 Enable cross-project invocation via configuration. Projects with BFF capabilities enabled can act as BFF producers, or you can create standalone BFF applications.
 When executing `dev` or `build`, the following artifacts for consumers will be automatically generated:
+
 - API functions under the `dist/client` directory
 - Runtime configuration functions under the `dist/runtime` directory
 - Interface exports defined in `exports` field of `package.json`
@@ -24,7 +25,7 @@ Ensure the current project has BFF enabled with API files defined under `api/lam
 export default defineConfig({
   bff: {
     crossProject: true,
-  }
+  },
 });
 ```
 
@@ -88,9 +89,9 @@ import { configure as innerConfigure } from '@modern-js/plugin-bff/client';
 import axios from 'axios';
 
 configure({
-    setDomain() {
-        return 'https://your-bff-api.com';
-    },
+  setDomain() {
+    return 'https://your-bff-api.com';
+  },
 });
 
 innerConfigure({

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

@@ -18,7 +18,6 @@ import DefaultBrowserslist from '@site-docs/components/default-browserslist';
 
 <DefaultBrowserslist />
 
-
 When the `overrideBrowserslist` configuration is not specified in the project, this `.browserslistrc` file will take effect.
 
 ### Method 2: Configure via package.json

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

@@ -68,7 +68,7 @@ i18nPlugin({
     localeDetectionByEntry: {
       admin: {
         localePathRedirect: false, // admin does not use path prefixes
-        languages: ['en'],         // admin only supports English
+        languages: ['en'], // admin only supports English
       },
       mobile: {
         languages: ['zh', 'en', 'ja'], // mobile supports more languages

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

@@ -10,14 +10,14 @@ title: API Reference
 
 ### Return Value
 
-| Field | Type | Description |
-| --- | --- | --- |
-| `language` | `string` | Current language code |
-| `changeLanguage` | `(lang: string) => Promise<void>` | Switches language |
-| `supportedLanguages` | `string[]` | Supported language list, from `localeDetection.languages` |
-| `isLanguageSupported` | `(lang: string) => boolean` | Checks whether a language is in the supported list |
-| `isResourcesReady` | `boolean` | Whether translation resources for the current language have finished loading |
-| `i18nInstance` | `I18nInstance` | i18next instance for advanced scenarios |
+| Field                 | Type                              | Description                                                                  |
+| --------------------- | --------------------------------- | ---------------------------------------------------------------------------- |
+| `language`            | `string`                          | Current language code                                                        |
+| `changeLanguage`      | `(lang: string) => Promise<void>` | Switches language                                                            |
+| `supportedLanguages`  | `string[]`                        | Supported language list, from `localeDetection.languages`                    |
+| `isLanguageSupported` | `(lang: string) => boolean`       | Checks whether a language is in the supported list                           |
+| `isResourcesReady`    | `boolean`                         | Whether translation resources for the current language have finished loading |
+| `i18nInstance`        | `I18nInstance`                    | i18next instance for advanced scenarios                                      |
 
 ### Basic Usage
 
@@ -85,13 +85,13 @@ A route link component with a locale prefix.
 
 ### Props
 
-| Prop | Type | Required | Description |
-| --- | --- | --- | --- |
-| `to` | `string` | Yes | Target path. Do not include the locale prefix |
-| `children` | `React.ReactNode` | Yes | Link content |
-| `replace` | `boolean` | No | Uses `history.replace` instead of `push` |
-| `state` | `any` | No | State passed to the target route |
-| Other Link props | - | No | Inherited from the `Link` component in `@modern-js/runtime/router` |
+| Prop             | Type              | Required | Description                                                        |
+| ---------------- | ----------------- | -------- | ------------------------------------------------------------------ |
+| `to`             | `string`          | Yes      | Target path. Do not include the locale prefix                      |
+| `children`       | `React.ReactNode` | Yes      | Link content                                                       |
+| `replace`        | `boolean`         | No       | Uses `history.replace` instead of `push`                           |
+| `state`          | `any`             | No       | State passed to the target route                                   |
+| Other Link props | -                 | No       | Inherited from the `Link` component in `@modern-js/runtime/router` |
 
 ### Usage
 
@@ -166,11 +166,11 @@ Type of the custom backend loader function:
 type I18nSdkLoader = (options: I18nSdkLoadOptions) => Promise<Resources>;
 
 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
 }
 
 type Resources = {
@@ -185,14 +185,14 @@ type Resources = {
 ```ts
 interface LanguageDetectorOptions {
   order?: string[];
-  lookupQuerystring?: string;   // Default: 'lng'
-  lookupCookie?: string;        // Default: 'i18next'
-  lookupLocalStorage?: string;  // Default: 'i18nextLng'
+  lookupQuerystring?: string; // Default: 'lng'
+  lookupCookie?: string; // Default: 'i18next'
+  lookupLocalStorage?: string; // Default: 'i18nextLng'
   lookupSession?: string;
-  lookupHeader?: string;        // Default: 'accept-language'
+  lookupHeader?: string; // Default: 'accept-language'
   lookupFromPathIndex?: number; // Default: 0
   caches?: false | string[];
-  cookieMinutes?: number;       // Default: 525600 (1 year)
+  cookieMinutes?: number; // Default: 525600 (1 year)
   cookieExpirationDate?: Date;
   cookieDomain?: string;
 }
@@ -212,8 +212,8 @@ import { useTranslation } from 'react-i18next';
 import { useModernI18n } from '@modern-js/plugin-i18n/runtime';
 
 function App() {
-  const { t } = useTranslation();                          // Translate text
-  const { language, changeLanguage } = useModernI18n();    // Switch language
+  const { t } = useTranslation(); // Translate text
+  const { language, changeLanguage } = useModernI18n(); // Switch language
 
   return (
     <div>
@@ -231,5 +231,11 @@ You can also get the i18next instance from `useModernI18n` and call capabilities
 const { i18nInstance } = useModernI18n();
 
 // Dynamically add translation resources.
-i18nInstance.addResourceBundle('zh', 'translation', { key: 'Value' }, true, true);
+i18nInstance.addResourceBundle(
+  'zh',
+  'translation',
+  { key: 'Value' },
+  true,
+  true,
+);
 ```

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

@@ -63,8 +63,8 @@ function ButtonGroup() {
   const { t } = useTranslation('common', { keyPrefix: 'button' });
   return (
     <>
-      <button>{t('submit')}</button>   {/* common:button.submit */}
-      <button>{t('cancel')}</button>   {/* common:button.cancel */}
+      <button>{t('submit')}</button> {/* common:button.submit */}
+      <button>{t('cancel')}</button> {/* common:button.cancel */}
     </>
   );
 }
@@ -94,9 +94,9 @@ The quality of translation key names directly affects maintenance cost. Recommen
 ```
 
 ```tsx
-t('page.title')
-t('form.username.label')
-t('form.submit', { defaultValue: 'Save' }) // defaultValue prevents showing the key string when the key is missing.
+t('page.title');
+t('form.username.label');
+t('form.submit', { defaultValue: 'Save' }); // defaultValue prevents showing the key string when the key is missing.
 ```
 
 ## Plurals
@@ -121,9 +121,9 @@ i18next automatically selects the correct plural form based on the `count` param
 ```
 
 ```tsx
-t('item', { count: 0 })  // "没有条目" / "No items"
-t('item', { count: 1 })  // "没有条目" / "1 item" (Chinese usually has only one form)
-t('item', { count: 5 })  // "5 个条目" / "5 items"
+t('item', { count: 0 }); // "没有条目" / "No items"
+t('item', { count: 1 }); // "没有条目" / "1 item" (Chinese usually has only one form)
+t('item', { count: 5 }); // "5 个条目" / "5 items"
 ```
 
 Different languages have different plural rules. English has singular and plural, while Russian has one/few/many forms. i18next automatically matches CLDR rules based on the language code.
@@ -152,8 +152,8 @@ Nested structures can clearly reflect UI hierarchy and are accessed with dots:
 ```
 
 ```tsx
-t('modal.confirm.title')
-t('modal.confirm.actions.ok')
+t('modal.confirm.title');
+t('modal.confirm.actions.ok');
 ```
 
 Avoid nesting deeper than 4 levels. Excessive depth makes key names long and hard to maintain.
@@ -199,8 +199,8 @@ Use `, format` in translation files to specify the formatting type:
 ```
 
 ```tsx
-t('price', { value: 99.5 })       // "当前价格：¥99.50" (zh) / "$99.50" (en)
-t('expiry', { date: new Date() }) // "到期日：2025年5月12日" (zh)
+t('price', { value: 99.5 }); // "当前价格：¥99.50" (zh) / "$99.50" (en)
+t('expiry', { date: new Date() }); // "到期日：2025年5月12日" (zh)
 ```
 
 ## Error Handling
@@ -237,7 +237,7 @@ if (!i18n.isInitialized) return null;
 Provide fallback text with `defaultValue` to prevent key strings from appearing in the UI:
 
 ```tsx
-t('missing.key', { defaultValue: 'Default text' })
+t('missing.key', { defaultValue: 'Default text' });
 ```
 
 In development, you can enable `saveMissing` to output missing keys to the console for debugging:
@@ -281,8 +281,8 @@ Referencing JSON file types directly is less likely to drift from actual transla
 
 ```tsx
 const { t } = useTranslation();
-t('welcome');       // TypeScript autocomplete
-t('nonExistent');   // TypeScript error
+t('welcome'); // TypeScript autocomplete
+t('nonExistent'); // TypeScript error
 ```
 
 :::tip Large projects

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