@modern-js/main-doc 2.35.1 → 2.36.0

package/docs/zh/guides/topic-detail/monorepo/sub-project-interface.mdx

@@ -11,7 +11,6 @@ sidebar_position: 3
 按照 [「创建子项目」](/guides/topic-detail/monorepo/create-sub-project) 章节的介绍（如果还没有看过，可以先了解一下），我们首先创建以下三个子项目：
 
 - 一个「应用」子项目
-- 一个「模块（内部）」子项目
 - 一个「模块」子项目
 
 执行 `pnpm run new`，并按照如下进行选择：
@@ -25,15 +24,6 @@ sidebar_position: 3
 ? 请选择开发语言：TS
 ```
 
-**「模块（内部）」子项目：**
-
-```
-? 请选择你想创建的工程类型：Npm 模块（内部）
-? 请填写子项目名称：internal-lib
-? 请填写子项目目录名称：internal-lib
-? 请选择开发语言：TS
-```
-
 **「模块」子项目：**
 
 ```
@@ -47,7 +37,6 @@ sidebar_position: 3
 
 - `./apps/app`
 - `./packages/components`
-- `./features/internal-lib`
 
 然后修改一下默认的代码和新增文件：
 
@@ -73,19 +62,10 @@ export default function ({ text }: { text: string }) {
 }
 ```
 
-**修改 `./features/internal-lib/src/index.ts`**
-
-```tsx
-export default function (text: string) {
-  return text.toUpperCase();
-}
-```
-
 **修改 `./apps/app/src/App.tsx`**
 
 ```tsx
 import { Switch, Route } from '@modern-js/runtime/router';
-import formatString from 'internal-lib';
 import Comp from 'components';
 
 import './App.css';
@@ -94,7 +74,7 @@ const App = () => (
   <Switch>
     <Route exact={true} path="/">
       <div className="container-box">
-        <Comp text={formatString('hello world')} />
+        <Comp text="hello world" />
         {/* 省略... */}
       </div>
     </Route>
@@ -107,7 +87,7 @@ const App = () => (
 export default App;
 ```
 
-到此为止我们创建了一个可以被发布到外部的组件项目、一个转换字符串的内部模块项目以及一个使用组件和内部模块的应用项目，如果直接运行应用项目还暂时无法正常使用。接下来将要介绍如何让它们能够互相联调使用，成功的使应用子项目 `apps/app` 正常运行。
+到此为止我们创建了一个可以被发布到外部的组件项目以及一个使用组件的应用项目，如果直接运行应用项目还暂时无法正常使用。接下来将要介绍如何让它们能够互相联调使用，成功的使应用子项目 `apps/app` 正常运行。
 
 :::info
 启动 `apps/app` 项目之前需要先构建（`pnpm run build`） `packages/component`。
@@ -118,25 +98,12 @@ export default App;
 
 ## 在使用 pnpm 的 Monorepo 中进行项目联调
 
-在 pnpm 的 Monorepo 项目中，我们通过在 `apps/app` 子项目下分别执行：
+在 pnpm 的 Monorepo 项目中，我们通过在 `apps/app` 子项目下执行以下命令，将 `packages/components` 子项目加入到应用的依赖列表当中。
 
 ```
 pnpm add components
 ```
 
-以及
-
-```
-pnpm add internal-lib -D
-```
-
-:::info
-注意这里将 internal-lib 作为 `apps/app` 项目的开发依赖，因为在构建环境会被打包到构建产物中。
-
-:::
-
-将 `packages/components` 与 `features/internal-lib` 子项目加入到应用的依赖列表当中。
-
 执行成功后，在 `apps/app/package.json` 会发生如下变化：
 
 ```json
@@ -144,9 +111,6 @@ pnpm add internal-lib -D
   "dependencies": {
 ++  "components": "workspace:^0.1.0"
   },
-  "devDependencies": {
-++  "internal-lib": "workspace:^0.1.0"
-  },
 }
 ```
 
@@ -157,18 +121,18 @@ pnpm add internal-lib -D
 
 当依赖安装成功之后，我们还需要将 `packages/components` 进行构建，因为需要使用其构建产物。
 
-到此为止，`app/apps` 应用子项目可以正常的运行了。在修改 `features/internal-lib` 的源码，或者修改 `packages/components` 的源码并构建之后都会触发应用子项目的热更新。
+到此为止，`app/apps` 应用子项目可以正常的运行了。在修改 `packages/components` 的源码并构建之后，会触发应用子项目的热更新。
 
 ## 在使用 Yarn 的 Monorepo 中进行项目联调
 
-在 Yarn 的 Monorepo 项目中，默认情况下可以直接在 `apps/app` 应用项目中直接使用组件项目和内部模块项目。
+在 Yarn 的 Monorepo 项目中，默认情况下可以直接在 `apps/app` 应用项目中直接使用组件项目。
 
 :::info 补充信息
-之所以可以直接在应用中使用使用组件项目和内部模块项目，是因为 Yarn 将这些子项目模块提升到了顶层的 `node_modules`内。
+之所以可以直接在应用中使用组件项目，是因为 Yarn 将这些子项目模块提升到了顶层的 `node_modules`内。
 
 :::
 
-但是由于组件 `components` 是非内部模块，因此建议在 `apps/app/package.json` 中进行依赖声明：
+但是考虑到依赖关系的严谨性，建议在 `apps/app/package.json` 中进行显式依赖声明：
 
 ```json
 {

package/docs/zh/tutorials/first-app/c05-loader.mdx

@@ -18,7 +18,7 @@ pnpm add faker@5
 pnpm add @types/faker@5 -D
 ```
 
-创建 `src/routes/page.loader.ts`：
+创建 `src/routes/page.data.ts`：
 
 ```tsx
 import { name, internet } from 'faker';
@@ -32,7 +32,7 @@ type LoaderData = {
   }[];
 };
 
-export default async (): Promise<LoaderData> => {
+export const loader = async (): Promise<LoaderData> => {
   const data = new Array(20).fill(0).map(() => {
     const firstName = name.firstName();
     return {

package/docs/zh/tutorials/first-app/c06-model.mdx

@@ -192,9 +192,9 @@ const Item = ({
 export default Item;
 ```
 
-接下来，我们修改 `src/routes/page.tsx` 和 `src/routes/page.loader.ts`，为 `<Item>` 组件传递更多参数：
+接下来，我们修改 `src/routes/page.tsx` 和 `src/routes/page.data.ts`，为 `<Item>` 组件传递更多参数：
 
-```ts title="src/routes/page.loader.ts"
+```ts title="src/routes/page.data.ts"
 export type LoaderData = {
   code: number;
   data: {
@@ -204,7 +204,7 @@ export type LoaderData = {
   }[];
 };
 
-export default async (): Promise<LoaderData> => {
+export const loader async (): Promise<LoaderData> => {
   const data = new Array(20).fill(0).map(() => {
     const firstName = name.firstName();
     return {

package/docs/zh/tutorials/first-app/c07-container.mdx

@@ -15,7 +15,7 @@ import { Tabs, Tab as TabItem } from "@theme";
 
 Modern.js 支持在 `layout.tsx` 通过 Data Loader 获取数据，我们先数据获取这部分代码移动到 `src/routes/layout.tsx` 中：
 
-```ts title="src/routes/layout.loader.ts"
+```ts title="src/routes/layout.data.ts"
 export type LoaderData = {
   code: number;
   data: {
@@ -25,7 +25,7 @@ export type LoaderData = {
   }[];
 };
 
-export default async (): Promise<LoaderData> => {
+export const loader = async (): Promise<LoaderData> => {
   const data = new Array(20).fill(0).map(() => {
     const firstName = name.firstName();
     return {
@@ -58,7 +58,7 @@ import 'tailwindcss/base.css';
 import 'tailwindcss/components.css';
 import 'tailwindcss/utilities.css';
 import '../styles/utils.css';
-import type { LoaderData } from './layout.loader';
+import type { LoaderData } from './layout.data';
 
 export default function Layout() {
   const { data } = useLoaderData() as LoaderData;

package/docs/zh/tutorials/foundations/introduction.mdx

@@ -31,8 +31,9 @@ sidebar_position: 1
 
 我们提供了一些在开发过程中常用的案例供你参考，可以在这里找到 Modern.js 提供的一些功能组合的使用方式，我们将持续完善这里的案例。
 
-- [路由鉴权](/tutorials/examples/csr-auth.html)
-- ...
+import ExampleList from '@site-docs/components/turtorials-example-list';
+
+<ExampleList />
 
 下面就让我们从 [创建项目](tutorials/first-app/c01-start) 开始吧！
 

package/package.json

@@ -15,17 +15,17 @@
     "modern",
     "modern.js"
   ],
-  "version": "2.35.1",
+  "version": "2.36.0",
   "publishConfig": {
     "registry": "https://registry.npmjs.org/",
     "access": "public",
     "provenance": true
   },
   "dependencies": {
-    "@modern-js/sandpack-react": "2.35.1"
+    "@modern-js/sandpack-react": "2.36.0"
   },
   "peerDependencies": {
-    "@modern-js/builder-doc": "^2.35.1"
+    "@modern-js/builder-doc": "^2.36.0"
   },
   "devDependencies": {
     "classnames": "^2",
@@ -35,12 +35,12 @@
     "ts-node": "^10.9.1",
     "typescript": "^5",
     "fs-extra": "^10",
-    "rspress": "0.0.13",
-    "@rspress/shared": "0.0.13",
+    "rspress": "1.0.0-beta.3",
+    "@rspress/shared": "1.0.0-beta.3",
     "@types/node": "^16",
     "@types/fs-extra": "^9",
-    "@modern-js/builder-doc": "2.35.1",
-    "@modern-js/doc-plugin-auto-sidebar": "2.35.1"
+    "@modern-js/builder-doc": "2.36.0",
+    "@modern-js/doc-plugin-auto-sidebar": "2.36.0"
   },
   "scripts": {
     "dev": "rspress dev",