@modern-js/main-doc 2.3.0 → 2.5.0

package/.turbo/turbo-build.log

@@ -1,4 +1,4 @@
 
-> @modern-js/main-doc@2.3.0 build /github/workspace/packages/toolkit/main-doc
+> @modern-js/main-doc@2.5.0 build /github/workspace/packages/toolkit/main-doc
 > npx ts-node ./scripts/sync.ts
 

package/LICENSE

@@ -19,126 +19,3 @@ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
 LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
 OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
 SOFTWARE.
-
-
-The code implementation modified from external library  are:
-
-- vite
-
-    MIT License
-
-    Copyright (c) 2019-present, Yuxi (Evan) You and Vite contributors
-
-    Permission is hereby granted, free of charge, to any person obtaining a copy
-    of this software and associated documentation files (the "Software"), to deal
-    in the Software without restriction, including without limitation the rights
-    to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-    copies of the Software, and to permit persons to whom the Software is
-    furnished to do so, subject to the following conditions:
-
-    The above copyright notice and this permission notice shall be included in all
-    copies or substantial portions of the Software.
-
-    THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-    IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-    FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-    AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-    LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-    OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-    SOFTWARE.
-
-- wmr
-
-    MIT License
-
-    Copyright (c) 2020 The Preact Authors
-
-    Permission is hereby granted, free of charge, to any person obtaining a copy
-    of this software and associated documentation files (the "Software"), to deal
-    in the Software without restriction, including without limitation the rights
-    to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-    copies of the Software, and to permit persons to whom the Software is
-    furnished to do so, subject to the following conditions:
-
-    The above copyright notice and this permission notice shall be included in all
-    copies or substantial portions of the Software.
-
-    THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-    IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-    FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-    AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-    LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-    OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-    SOFTWARE.
-
-- bundle-require
-
-    The MIT License (MIT)
-
-    Copyright © 2021 EGOIST (https://github.com/sponsors/egoist)
-
-    Permission is hereby granted, free of charge, to any person obtaining a copy
-    of this software and associated documentation files (the "Software"), to deal
-    in the Software without restriction, including without limitation the rights
-    to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-    copies of the Software, and to permit persons to whom the Software is
-    furnished to do so, subject to the following conditions:
-
-    The above copyright notice and this permission notice shall be included in all
-    copies or substantial portions of the Software.
-
-    THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-    IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-    FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-    AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-    LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-    OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-    SOFTWARE
-
-- react-dev-utils
-
-    MIT License
-
-    Copyright (c) 2013-present, Facebook, Inc.
-
-    Permission is hereby granted, free of charge, to any person obtaining a copy
-    of this software and associated documentation files (the "Software"), to deal
-    in the Software without restriction, including without limitation the rights
-    to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-    copies of the Software, and to permit persons to whom the Software is
-    furnished to do so, subject to the following conditions:
-
-    The above copyright notice and this permission notice shall be included in all
-    copies or substantial portions of the Software.
-
-    THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-    IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-    FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-    AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-    LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-    OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-    SOFTWARE.
-
-- jest-cli
-
-    MIT License
-
-    Copyright (c) Facebook, Inc. and its affiliates.
-
-    Permission is hereby granted, free of charge, to any person obtaining a copy
-    of this software and associated documentation files (the "Software"), to deal
-    in the Software without restriction, including without limitation the rights
-    to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-    copies of the Software, and to permit persons to whom the Software is
-    furnished to do so, subject to the following conditions:
-
-    The above copyright notice and this permission notice shall be included in all
-    copies or substantial portions of the Software.
-
-    THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-    IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-    FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-    AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-    LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-    OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-    SOFTWARE.

package/README.md

@@ -0,0 +1,26 @@
+<p align="center">
+  <a href="https://modernjs.dev" target="blank"><img src="https://lf3-static.bytednsdoc.com/obj/eden-cn/ylaelkeh7nuhfnuhf/modernjs-cover.png" width="300" alt="Modern.js Logo" /></a>
+</p>
+
+<h1 align="center">Modern.js</h1>
+
+<p align="center">
+  A Progressive React Framework for modern web development.
+</p>
+
+## Getting Started
+
+Please follow [Quick Start](https://modernjs.dev/en/guides/get-started/quick-start) to get started with Modern.js.
+
+## Documentation
+
+- [English Documentation](https://modernjs.dev/en/)
+- [中文文档](https://modernjs.dev)
+
+## Contributing
+
+Please read the [Contributing Guide](https://github.com/modern-js-dev/modern.js/blob/main/CONTRIBUTING.md).
+
+## License
+
+Modern.js is [MIT licensed](https://github.com/modern-js-dev/modern.js/blob/main/LICENSE).

package/en/apis/app/commands/_category_.json

@@ -1,8 +1,5 @@
 {
   "label": "Commands",
   "position": 0,
-  "link": {
-    "type": "doc",
-    "id": "apis/app/commands/index"
-  }
+  "collapsed": false
 }

package/en/apis/app/commands/new.mdx

@@ -26,9 +26,9 @@ In the project, execute the `new` command to add entries as follows:
 
 ```bash
 $ npx modern new
-? 请选择你想要的操作 创建工程元素
-? 创建工程元素 新建「应用入口」
-? 请填写入口名称 entry
+? Action Create project element
+? Create project element New "entry"
+? Entry name entry
 ```
 
 ### Enable Features
@@ -37,13 +37,14 @@ In the project, execute the `new` command to enable features as follows:
 
 ```bash
 $ npx modern new
-? 请选择你想要的操作 启用可选功能
-? 启用可选功能 (Use arrow keys)
-❯ 启用 Tailwind CSS 支持
-  启用「BFF」功能
-  启用「微前端」模式
-  启用「单元测试 / 集成测试」功能
-  启用「Visual Testing (Storybook)」模式
+? Action Enable features
+? Enable features (Use arrow keys)
+❯ Enable Tailwind CSS
+  Enable BFF
+  Enable SSG
+  Enable Micro Frontend
+  Enable Unit Test / Integration Test
+  Enable Visual Testing (Storybook)
 ```
 
 :::caution

package/en/apis/app/commands/test.mdx

@@ -30,6 +30,6 @@ Time:        0.994 s, estimated 1 s
 ```
 
 :::info
-files match `*.test.(js|ts)` in `api/` or `src/` will be recognized as test cases by default。
+files match `*.test.(js|ts)` in `api/` or `src/` will be recognized as test cases by default.
 
 :::

package/en/apis/app/hooks/_category_.json

@@ -1,8 +1,5 @@
 {
   "label": "Convention",
   "position": 1,
-  "link": {
-    "type": "doc",
-    "id": "apis/app/hooks/index"
-  }
+  "collapsed": false
 }

package/en/apis/app/hooks/api/framework/lambda.mdx

@@ -40,7 +40,7 @@ Dynamic named routing parameters can be supported by creating folders or files w
 - `api/lambda/user/[username]/delete.ts` -> `$BASENAME/user/:username/delete`
 - `api/lambda/article/[id]/info.ts` -> `$BASENAME/article/:id/info`
 
-the `$BASENAME` can be configured in `modern.config.js`，the default value is `/api`。
+the `$BASENAME` can be configured in `modern.config.js`，the default value is `/api`.
 
 ### Allow List
 

package/en/apis/app/hooks/api/functions/api.mdx

@@ -40,7 +40,7 @@ Dynamic named routing parameters can be supported by creating folders or files w
 - `api/user/[username]/delete.ts` -> `$BASENAME/user/:username/delete`
 - `api/article/[id]/info.ts` -> `$BASENAME/article/:id/info`
 
-the `$BASENAME` can be configured in `modern.config.js`，the default value is `/api`。
+the `$BASENAME` can be configured in `modern.config.js`，the default value is `/api`.
 
 ### Allow List
 

package/en/apis/app/hooks/server/index_.mdx

@@ -2,6 +2,7 @@
 title: index.[tj]s
 sidebar_position: 1
 ---
+
 # index.[tj]s
 
 A file that extends the Modern.js Web Server, to add a Hook or Middleware to the Web Server that the project uses.
@@ -11,6 +12,6 @@ It can intercept requests and responses, authenticate and role, request preproce
 It can also be inserted logic into the built-in processing handler (including route matching, resource addressing, header injection, page rendering, static web hosting).
 
 :::info
-For detail, see [Hook](/apis/app/runtime/web-server/hook) & [Middleware](/apis/app/runtime/web-server/middleware)。
+For detail, see [Hook](/apis/app/runtime/web-server/hook) & [Middleware](/apis/app/runtime/web-server/middleware).
 
 :::

package/en/apis/app/hooks/src/pages.mdx

@@ -107,16 +107,16 @@ For example the following directory structure:
     └── index.js
 ```
 
-- access `/`, the `Component` is `pages/index.js`。
-- access `/a`, the `Component` is `pages/a/index.js`。
-- access `/a/b`, the `Component` is `pages/a/b/index.js`。
+- access `/`, the `Component` is `pages/index.js`.
+- access `/a`, the `Component` is `pages/a/index.js`.
+- access `/a/b`, the `Component` is `pages/a/b/index.js`.
 
 :::tip Advantages
 
 - preserve the state of the global layout when the page changes.
 - add global css.
 - handle ComponentDidCatch error
-- use `defineConfig`(/docs/apis/app/runtime/app/define-config) dynamic configuration runtime.
+- use [defineConfig](/apis/app/runtime/app/define-config) dynamic configuration runtime.
 
 :::
 
@@ -149,8 +149,8 @@ export default ALayout;
 
 The Component props is the specific route, for example
 
-- access `/a`, the `Component` is `pages/a/index.js`。
-- 访问 `/a/b`, the `Component` is `pages/a/b/index.js`。
+- access `/a`, the `Component` is `pages/a/index.js`.
+- 访问 `/a/b`, the `Component` is `pages/a/b/index.js`.
 
 In this way, you can use `pages/a/_layout.js` to display the routing common layout in the `a` directory.
 
@@ -179,4 +179,4 @@ the generated route is configured is as:
 ]
 ```
 
-All unmatched routes will match to `pages/404.[tj]s`。
+All unmatched routes will match to `pages/404.[tj]s`.

package/en/apis/app/hooks/src/routes.mdx

@@ -52,7 +52,7 @@ If the directory name of the route file is named with `[]`, the generated route
 
 The `routes/[id]/page.tsx` file will be converted to a `/:id` route. All `/xxx` will match that route, except for the `/blog` route, which can be matched exactly.
 
-In the component, you can get the corresponding parameters by [useParams](/apis/app/runtime/router/#useparams).
+In the component, you can get the corresponding parameters by [useParams](/apis/app/runtime/router/router#useparams).
 
 In the loader, params will be used as input to [loader](/guides/basic-features/data-fetch#loader-function), and the corresponding parameters can be retrieved through the property `params`.
 

package/en/apis/app/runtime/_category_.json

@@ -1,9 +1,5 @@
 {
   "label": "runtime",
   "position": 3,
-  "collapsed": false,
-  "link": {
-    "type": "doc",
-    "id": "apis/app/runtime/index"
-  }
+  "collapsed": false
 }

package/en/apis/app/runtime/app/define-config.mdx

@@ -28,8 +28,8 @@ function defineConfig(Component, config): any;
 
 ### Input
 
-- Component: App root Component。
-- config: runtime config。
+- Component: App root Component.
+- config: runtime config.
 
 ## Example
 

package/en/apis/app/runtime/core/bootstrap.mdx

@@ -3,7 +3,7 @@ title: bootstrap
 ---
 # bootstrap
 
-Used to start and mount App, usually without manual calls。This API is only required when using [Custom App](/guides/concept/entries#自定义-app).
+Used to start and mount App, usually without manual calls. This API is only required when using [Custom App](/guides/concept/entries#自定义-app).
 
 ## Usage
 

package/en/apis/app/runtime/core/create-app.mdx

@@ -3,7 +3,7 @@ title: createApp
 ---
 # createApp
 
-Used to create custom entries, custom runtime plugins. This API is only required when using [Custom App](/guides/concept/entries#自定义-app).
+Used to create custom entries, custom runtime plugins. This API is only required when using [Custom App](/guides/concept/entries#app).
 
 ## Usage
 
@@ -28,7 +28,7 @@ function createApp(options: { plugins: Plugin[] }): React.ComponentType<any>;
 
 ### Create Custom Entry
 
-For details, see [`bootstrap`](./bootstrap.md)。
+For details, see [`bootstrap`](./bootstrap.mdx).
 
 ### Custom Plugins
 

package/en/apis/app/runtime/core/use-loader.mdx

@@ -3,7 +3,7 @@ title: useLoader
 ---
 # useLoader
 
-Isomorphic API，usually used to make asynchronous requests。When SSR, the server level uses `useLoader` to prefetch the data, and the browser side also reuses this part of the data.
+Isomorphic API，usually used to make asynchronous requests. When SSR, the server level uses `useLoader` to prefetch the data, and the browser side also reuses this part of the data.
 
 ## Usage
 
@@ -35,7 +35,7 @@ function useLoader(loaderFn: LoaderFn, options: Options): ReturnData;
 ```
 
 :::info
-`runtimeContext` can refer to [useRuntimeContext](/apis/app/runtime/core/use-runtime-context)。
+`runtimeContext` can refer to [useRuntimeContext](/apis/app/runtime/core/use-runtime-context).
 
 :::
 
@@ -47,14 +47,14 @@ function useLoader(loaderFn: LoaderFn, options: Options): ReturnData;
   - `onError`: error callback.
   - `initialData`: the initial data before the first execution,.
   - `skip`: when the value is `true`, the function does not execute.
-  - `params`: when the result of the `params` serialization changes，the function is re-executed。`params` is also passed in as the second argument of the function.
+  - `params`: when the result of the `params` serialization changes，the function is re-executed. `params` is also passed in as the second argument of the function.
   - `static`: when the value is `true`, `useLoader` is used for [SSG](/guides/advanced-features/ssg).
 
 ### Return Value
 
 - `data`: return data on successful execution.
 - `loading`: indicates whether the function is in execution.
-- `error`: error message when function execution fails。
+- `error`: error message when function execution fails.
 - `reload`: the function can be re-executed after the call.
   - `params`: when the value is `undefined`, the last value will be reused; otherwise, the function will be re-executed with the new value.
 - `reloading`: during the execution of the call to `reload`, the value of `reloading` is `true`.

package/en/apis/app/runtime/core/use-module-apps.mdx

@@ -46,7 +46,7 @@ defineConfig(App, {
   masterApp: {
     apps: [
       {
-        // name 区分大小写，name 提供的是什么 useModuleApps 返回的就是什么
+        // name is case-sensitive, what name provides is what useModuleApps returns
         name: 'Home',
         entry: 'http://127.0.0.1:8081/',
       },
@@ -63,7 +63,7 @@ Get the `Home` and `Contact` sub-application components(the same as name in the
 
 ### Centralized Routing
 
-**Centralized Routing** is a way to centrally configure the activation routes of sub-applications. Add `activeWhen` config to enable **Centralized Routing**。
+**Centralized Routing** is a way to centrally configure the activation routes of sub-applications. Add `activeWhen` config to enable **Centralized Routing**.
 
 import MicroRuntimeConfig from "@site-docs-en/components/micro-runtime-config";
 

package/en/apis/app/runtime/model/Provider.mdx

@@ -21,8 +21,8 @@ interface ProviderProps {
 
 ### Input
 
-- store: the Store object created by [`createStore`](./create-store.md).
-- config: this config to create Reduck Store, same as `config` param in [`createApp`](./create-app.md).
+- store: the Store object created by [`createStore`](./create-store.mdx).
+- config: this config to create Reduck Store, same as `config` param in [`createApp`](./create-app.mdx).
 
 ## Example
 

package/en/apis/app/runtime/model/auto-actions.mdx

@@ -19,7 +19,7 @@ can use [`runtime.state.autoActions`](/configure/app/runtime/state#autoactions)
 
 ### Basic Data Type
 
-State type in `string`、`number`、`boolean`、`null`，generate `setState` Action。
+State type in `string`、`number`、`boolean`、`null`，generate `setState` Action.
 
 ```tsx title="example"
 const fooModel = model('foo').define({
@@ -93,7 +93,7 @@ function App() {
 
 ### PlainObject
 
-State type is PlainObject，base on the names contained in State，generate `set${key}`(Camel-Case) Actions。
+State type is PlainObject，base on the names contained in State，generate `set${key}`(Camel-Case) Actions.
 
 ```tsx title="example"
 const fooModel = model('foo').define({

package/en/apis/app/runtime/model/connect.mdx

@@ -9,7 +9,7 @@ import ReduckTip from "@site-docs-en/components/reduck-tip"
 <ReduckTip />
 
 :::tip
-The original type of Reduck is complex. The following type definition shows the simplified type information. For the original type, see [**connect**](https://github.com/modern-js-dev/reduck/blob/main/packages/react/src/connect.ts)。
+The original type of Reduck is complex. The following type definition shows the simplified type information. For the original type, see [**connect**](https://github.com/modern-js-dev/reduck/blob/main/packages/react/src/connect.ts).
 
 :::
 
@@ -82,11 +82,11 @@ const modelB = model('modelB').define({
 });
 
 function Test(props) {
-  props.incA(); // call modelA 的 action
-  props.incB(); // call modelB 的 action
+  props.incA(); // call modelA's action
+  props.incB(); // call modelB's action
 
-  props.a; // get modelA 的 state: a
-  props.b; // get modelB 的 state: b
+  props.a; // get modelA's state: a
+  props.b; // get modelB's state: b
 }
 
 export default connect([modelA, modelB])(Test);

package/en/apis/app/runtime/model/create-app.mdx

@@ -8,7 +8,7 @@ import ReduckTip from "@site-docs-en/components/reduck-tip"
 
 <ReduckTip />
 
-Reduck will call `createApp` to create a global application by default. If the entire application only needs one Store, then there is no need to call `createApp` manually。Only need to use `createApp` when you need to create a Store locally in the app.
+Reduck will call `createApp` to create a global application by default. If the entire application only needs one Store, then there is no need to call `createApp` manually.Only need to use `createApp` when you need to create a Store locally in the app.
 
 :::caution
 Note that the exported `createApp` in `@modern-js/runtime/model` is used to manage state, while the exported `createApp` in `@modern-js/runtime` is used to create the entire application. The two are differently.
@@ -29,19 +29,19 @@ function createApp(config: AppConfig): object;
 ### Input
 
 - `config`
-  - `StoreConfig`: the same as [`createStore`](./create-store.md) params.
-  - `devTools`: the default value is `true`. when it is an object type，configuring [Options](https://github.com/reduxjs/redux-devtools/blob/main/extension/docs/API/Arguments.md) of Redux DevTools。
-  - `autoActions`: the default value is `true`。if [auto generate Actions](./auto-actions.md)。
+  - `StoreConfig`: the same as [`createStore`](./create-store.mdx) params.
+  - `devTools`: the default value is `true`. when it is an object type，configuring [Options](https://github.com/reduxjs/redux-devtools/blob/main/extension/docs/API/Arguments.md) of Redux DevTools.
+  - `autoActions`: the default value is `true`.if [auto generate Actions](./auto-actions.mdx).
 
 ### Return Value
 
 Reduck App, consists of the following properties:
 
-- `Provider`: inject shared Store into locally component tree, same as [`Provider`](./Provider.md)。
-- `useModel`: get the Model mounted by the app's local Store, same as [`useModel`](./use-model.md)。
-- `useStaticModel`: get the Model mounted by the app's local Store. same as [`useStaticModel`](./use-static-model.md)。
-- `useLocalModel`: get the Model mounted by the app's local Store. same as [`useLocalModel`](./use-local-model.md)。
-- `useStore`: get the Store used locally by the app. same as [`useStore`](./use-store.md)。
+- `Provider`: inject shared Store into locally component tree, same as [`Provider`](./Provider.mdx).
+- `useModel`: get the Model mounted by the app's local Store, same as [`useModel`](./use-model.mdx).
+- `useStaticModel`: get the Model mounted by the app's local Store. same as [`useStaticModel`](./use-static-model.mdx).
+- `useLocalModel`: get the Model mounted by the app's local Store. same as [`useLocalModel`](./use-local-model.mdx).
+- `useStore`: get the Store used locally by the app. same as [`useStore`](./use-store.mdx).
 
 ## Example
 

package/en/apis/app/runtime/model/create-store.mdx

@@ -10,7 +10,7 @@ import ReduckTip from "@site-docs-en/components/reduck-tip"
 
 `createStore` is used to create a Store. Reduck’s Store based on Redux's [Store](https://redux.js.org/api/store) implementatio. Used to store the state of the application and managing the state and Model.
 
-In general, this API is only used when you need to have full control over the creation of the Store. For example, to customize a Store, pass in the ['Provider'](./Provider.md) component to use.
+In general, this API is only used when you need to have full control over the creation of the Store. For example, to customize a Store, pass in the ['Provider'](./Provider.mdx) component to use.
 
 ## Function Signature
 
@@ -38,13 +38,13 @@ function createStore(config?: StoreConfig): ReduckStore;
   - `models`: set the Model to mount to the Store in advance(No need for normal use).
   - `middlewares`: set Redux [middleware](https://redux.js.org/understanding/thinking-in-redux/glossary#middleware).
   - `enhancers`: set Redux [Store enhancer](https://redux.js.org/understanding/thinking-in-redux/glossary#store-enhancer).
-  - `plugins`: set Reduck plugin。***experimental API, not recommended***。
+  - `plugins`: set Reduck plugin.***experimental API, not recommended***.
 
 ### Return Value
 
 Reduck Store:
 
-- `use`: mount and fetch Model objects dynamically. Usage is the same as ['useModel'](./use-model.md), but can be used outside of React components.
+- `use`: mount and fetch Model objects dynamically. Usage is the same as ['useModel'](./use-model.mdx), but can be used outside of React components.
 - `unmount`: unmount the Model object, and the Model State is cleared from the Store.
 - `ReduxStore`: [Redux Store API](https://redux.js.org/tutorials/fundamentals/part-4-store#redux-store).
 

package/en/apis/app/runtime/model/handle-effect.mdx

@@ -59,7 +59,7 @@ interface State {
 
 ```ts
 interface State {
-  items: any; // 默认的 result -> items
+  items: any; // Default result -> items
   pending: boolean;
   error: string;
 }
@@ -78,7 +78,7 @@ interface State {
 
 - `error`: the default value is `"error"`. Change the name of the `error` field in the returned State. Usage is the same as `result`.
 
-- `combineMode`: the default value is `"merge"`。get fulfilled state results. There are two ways to deal with it (The data types that can be automatically processed here are also limited to simple object or array types):
+- `combineMode`: the default value is `"merge"`. Get fulfilled state results. There are two ways to deal with it (The data types that can be automatically processed here are also limited to simple object or array types):
 
   - `"merge"`: the previous data is merged with the current data. the data is an array type, operation is similar to `[].concat(lastData, currentData)`. the data is an object，operation is similar to `{...lastData, ...curData}`.
   - `"replace"`: the current data directly replaces the previous data.

package/en/apis/app/runtime/model/model_.mdx

@@ -9,7 +9,7 @@ import ReduckTip from "@site-docs-en/components/reduck-tip"
 <ReduckTip />
 
 :::tip
-The original type of Reduck is complex. The following type definition shows the simplified type information. For the original type, see [**model**](https://github.com/modern-js-dev/reduck/blob/main/packages/store/src/model/model.ts)。
+The original type of Reduck is complex. The following type definition shows the simplified type information. For the original type, see [**model**](https://github.com/modern-js-dev/reduck/blob/main/packages/store/src/model/model.ts).
 
 :::
 

package/en/apis/app/runtime/model/use-local-model.mdx

@@ -8,7 +8,7 @@ import ReduckTip from "@site-docs-en/components/reduck-tip"
 
 <ReduckTip />
 
-To use the State in the Model as a local state, the effect is similar to React's `useState`. `useLocalModel` API same as `useModel`. For detail, see [`useModel`](./use-model.md)。
+To use the State in the Model as a local state, the effect is similar to React's `useState`. `useLocalModel` API same as `useModel`. For detail, see [`useModel`](./use-model.mdx).
 
 ## Example
 

package/en/apis/app/runtime/model/use-model.mdx

@@ -9,7 +9,7 @@ import ReduckTip from "@site-docs-en/components/reduck-tip"
 <ReduckTip />
 
 :::tip
-The original type of Reduck is complex. The following type definition shows the simplified type information. For the original type, see [**model**](https://github.com/modern-js-dev/reduck/blob/main/packages/store/src/model/model.ts)。
+The original type of Reduck is complex. The following type definition shows the simplified type information. For the original type, see [**model**](https://github.com/modern-js-dev/reduck/blob/main/packages/store/src/model/model.ts).
 
 :::
 

package/en/apis/app/runtime/model/use-static-model.mdx

@@ -8,18 +8,18 @@ import ReduckTip from "@site-docs-en/components/reduck-tip"
 
 <ReduckTip />
 
-If want to consume a Model in the form of React Hook in the component，and can get the current latest state at any time，but you don't want the Model state to be updated, which will cause the component to be re-rendered, we can use `useStaticModel`。
+If want to consume a Model in the form of React Hook in the component，and can get the current latest state at any time，but you don't want the Model state to be updated, which will cause the component to be re-rendered, we can use `useStaticModel`.
 
-`useStaticModel` API is same as `useModel`。For detail, see [`useModel`](./use-model.md)。
+`useStaticModel` API is same as `useModel`.For detail, see [`useModel`](./use-model.mdx).
 
 To ensure that the latest state is always available, be careful not to deconstruct the returned `state`.
 
 ```tsx
 function App() {
-  // ❌ Do not deconstruct state，but can deconstruct actions。
+  // ❌ Do not deconstruct state，but can deconstruct actions.
   const [{ username }, { logout }] = useStaticModel(userModel);
 
-  // ✅ True Usage。
+  // ✅ True Usage.
   const [state, { logout }] = useStaticModel(userModel);
 
   useEffect(() => {

package/en/apis/app/runtime/model/use-store.mdx

@@ -18,7 +18,7 @@ function useStore(): ReduckStore;
 
 ### Return Type
 
-- ReduckStore: Reduck Store，type refer to the return type of [createStore](./create-store.md).
+- ReduckStore: Reduck Store，type refer to the return type of [createStore](./create-store.mdx).
 
 :::info More
 [Use Model](/guides/topic-detail/model/use-model).

package/en/apis/app/runtime/router/router.mdx

@@ -29,7 +29,7 @@ interface NavigateFunction {
 }
 ```
 
-The `useNavigate` hook returns a function that lets you navigate programmatically。
+The `useNavigate` hook returns a function that lets you navigate programmatically.
 
 ```tsx
 import { useNavigate } from '@modern-js/runtime/router';