@modern-js/main-doc 2.19.2-alpha.0 → 2.21.0

package/docs/zh/guides/topic-detail/changesets/commit.mdx

@@ -197,7 +197,7 @@ commit 配置为 ./my-commit-config.js 即可:
 
 自定义 Changelog 还可以使用模块工程方案进行管理，提供通用方案。
 
-#### 使用 `npx @modern-js/create` 创建模块工程方案。
+#### 使用 `npx @modern-js/create@latest` 创建模块工程方案。
 
 ```md
 ? 请选择你想创建的工程类型：Npm 模块

package/docs/zh/guides/topic-detail/changesets/release-note.mdx

@@ -194,7 +194,7 @@ pnpm run gen-release-note -- --custom ./scripts/my-release-note-config.js
 
 custom 参数值还可以使用模块工程方案进行管理，提供通用方案。
 
-1. 使用 npx @modern-js/create 创建模块工程方案。
+1. 使用 npx @modern-js/create@latest 创建模块工程方案。
 
 ```md
 ? 请选择你想创建的工程类型：Npm 模块

package/docs/zh/guides/topic-detail/framework-plugin/extend.mdx

@@ -13,7 +13,7 @@ sidebar_position: 5
 首先我们初始化一个空的项目文件，并添加基础依赖：
 
 ```bash
-$ npx @modern-js/create modern-js-demo
+$ npx @modern-js/create@latest modern-js-demo
 ```
 
 ### 创建 Hook

package/docs/zh/guides/topic-detail/framework-plugin/hook-list.mdx

@@ -2,12 +2,35 @@
 title: Hook 列表
 sidebar_position: 8
 ---
+
 # Hook 列表
 
 在 Modern.js 中暴露了三类插件：CLI、Runtime、Server。下面列举下各类中的 Hook：
 
 ## CLI
 
+### `beforeConfig`
+
+- 功能：运行收集配置前的任务
+- 执行阶段：收集配置前
+- Hook 模型：AsyncWorkflow
+- 类型：`AsyncWorkflow<void, void>`
+- 使用示例：
+
+```ts
+import type { CliPlugin } from '@modern-js/core';
+
+export default (): CliPlugin => ({
+  setup(api) {
+    return {
+      beforeConfig: () => {
+        // do something
+      },
+    };
+  },
+});
+```
+
 ### `config`
 
 - 功能：收集配置
@@ -144,7 +167,6 @@ export default (): CliPlugin => ({
 });
 ```
 
-
 ### `commands`
 
 - 功能：为 command 添加新的命令
@@ -238,9 +260,9 @@ export default (): CliPlugin => ({
 ### `afterDev`
 
 - 功能：运行 dev 主流程的之后的任务
-- 执行阶段：`dev` 命令运行时，项目启动完成之后执行
+- 执行阶段：运行 `dev` 命令时，每一次编译完成后执行
 - Hook 模型：AsyncWorkflow
-- 类型：`AsyncWorkflow<void, unknown>`
+- 类型：`AsyncWorkflow<{ isFirstCompile: boolean }, unknown>`
 - 使用示例：
 
 ```ts
@@ -257,6 +279,24 @@ export default (): CliPlugin => ({
 });
 ```
 
+`afterDev` 会在每一次编译完成后执行，你可以通过 `isFirstCompile` 参数来判断是否为首次编译：
+
+```ts
+import type { CliPlugin } from '@modern-js/core';
+
+export default (): CliPlugin => ({
+  setup(api) {
+    return {
+      afterDev: ({ isFirstCompile }) => {
+        if (isFirstCompile) {
+          // do something
+        }
+      },
+    };
+  },
+});
+```
+
 ### `beforeCreateCompiler`
 
 - 功能：在中间件函数中可以拿到创建 Webpack Compiler 的 Webpack 配置
@@ -416,7 +456,7 @@ import type { CliPlugin } from '@modern-js/core';
 export default (): CliPlugin => ({
   setup(api) {
     return {
-      modifyEntryImports({ entrypoint, exportStatement }) {
+      modifyEntryExport({ entrypoint, exportStatement }) {
         return {
           entrypoint,
           exportStatement: [`export const foo = 'test'`, exportStatement].join(
@@ -756,7 +796,7 @@ export default (): Plugin => ({
           );
         };
         return next({
-          App: hoistNonReactStatics(AppWrapper, App)
+          App: hoistNonReactStatics(AppWrapper, App),
         });
       },
     };

package/docs/zh/guides/topic-detail/generator/codesmith/develop.mdx

@@ -48,6 +48,6 @@ npx @modern-js/codesmith-cli <generatorName>
 其中 generatorName 为生成器包名。
 
 :::info
-`@modern-js/create` 也支持运行微生成器，可以使用 `npx @modern-js/create --generator <generatorName>` 运行自定义的微生成器。
+`@modern-js/create` 也支持运行微生成器，可以使用 `npx @modern-js/create@latest --generator <generatorName>` 运行自定义的微生成器。
 
 :::

package/docs/zh/guides/topic-detail/generator/plugin/abstract.mdx

@@ -10,7 +10,7 @@ Modern.js 提供的初始化模板具有通用性，能满足一些通用的项
 
 当你深度使用 Modern.js 时，必然会发现每次创建的项目都会进行一些针对自身项目的特定的相似改动，比如修改示例代码、增加一些配置、开启某些功能等。
 
-生成器插件可以帮你将这些针对个人或团队特定的改动沉淀下来，在执行 `npx @modern-js/create` 只需简单的带上 `--plugin` 参数即可避免每次创建完项目都需重复性修改项目的工作。
+生成器插件可以帮你将这些针对个人或团队特定的改动沉淀下来，在执行 `npx @modern-js/create@latest` 只需简单的带上 `--plugin` 参数即可避免每次创建完项目都需重复性修改项目的工作。
 
 生成器插件是在 Modern.js 提供的初始化模板项目的基础上，提供对模板进行增加、删除、修改的方法，并通过快捷的方式修改 `package.json`、`modernConfig` 配置和开启功能等操作。
 

package/docs/zh/guides/topic-detail/generator/plugin/develop.mdx

@@ -9,7 +9,7 @@ sidebar_position: 3
 Modern.js 提供了生成器插件用于创建开发项目，可直接执行以下命令创建:
 
 ```bash
-npx @modern-js/create plugin --plugin @modern-js/generator-plugin-plugin
+npx @modern-js/create@latest plugin --plugin @modern-js/generator-plugin-plugin
 ```
 
 插件类型不同，会提问不同的问题，可根据需求选择插件类型

package/docs/zh/guides/topic-detail/generator/plugin/use.mdx

@@ -9,7 +9,7 @@ sidebar_position: 2
 你可直接执行下面命令使用生成器插件：
 
 ```bash
-npx @modern-js/create --plugin <pluginName>
+npx @modern-js/create@latest --plugin <pluginName>
 ```
 
 plugin 参数支持声明多次，代表同时使用多个生成器插件。

package/docs/zh/guides/topic-detail/generator/project.mdx

@@ -11,7 +11,7 @@ Modern.js 提供了 `@modern-js/create` 作为项目生成器用于进行 Modern
 不需要全局安装 `@modern-js/create`，直接使用 npx 执行该工具即可：
 
 ```bash
-npx @modern-js/create [projectDir]
+npx @modern-js/create@latest [projectDir]
 ```
 
 :::info
@@ -32,7 +32,7 @@ npx @modern-js/create [projectDir]
 获取 `@modern-js/create` 工具版本。
 
 ```bash
-$ npx @modern-js/create --version
+$ npx @modern-js/create@latest --version
 
 [INFO] @modern-js/create v2.0.0
 ```
@@ -52,7 +52,7 @@ $ npx @modern-js/create --version
 该字段为 JSON 字符串，例如需执行包管理工具时：
 
 ```bash
-npx @modern-js/create --config '{"packageManager": "pnpm"}'
+npx @modern-js/create@latest --config '{"packageManager": "pnpm"}'
 ```
 
 具体配置信息可查看[工程方案配置](/guides/topic-detail/generator/config/common)。
@@ -105,7 +105,7 @@ Modern.js 支持使用生成器插件定制 Modern.js 默认的工程方案类
 
 指定微生成器。
 
-默认情况下 `@modern-js/create` 会执行 Modern.js 框架内置的微生成器，如果你需要执行定制的微生成器，又需要使用 `npx @modern-js/create` 的姿势，可直接使用该参数。
+默认情况下 `@modern-js/create` 会执行 Modern.js 框架内置的微生成器，如果你需要执行定制的微生成器，又需要使用 `npx @modern-js/create@latest` 的姿势，可直接使用该参数。
 
 关于定制微生成器可以参考[开发微生成器](/guides/topic-detail/generator/codesmith/introduce)。
 

package/docs/zh/guides/topic-detail/micro-frontend/c02-development.mdx

@@ -24,7 +24,7 @@ title: 体验微前端
 
 ```bash
 mkdir masterApp && cd masterApp
-npx @modern-js/create
+npx @modern-js/create@latest
 ```
 
 import DefaultMWAGenerate from "@site-docs/components/default-mwa-generate";
@@ -106,7 +106,7 @@ export default Layout;
 
 ```bash
 mkdir masterApp && cd masterApp
-npx @modern-js/create
+npx @modern-js/create@latest
 ```
 
 <DefaultMWAGenerate />
@@ -134,7 +134,7 @@ import CustomRouterMicroFrontend from "@site-docs/components/custom-router-micro
 
 ```bash
 mkdir table && cd table
-npx @modern-js/create
+npx @modern-js/create@latest
 ```
 
 按照如下选择，生成项目：
@@ -186,7 +186,7 @@ export default Index;
 
 ```bash
 mkdir dashboard && cd dashboard
-npx @modern-js/create
+npx @modern-js/create@latest
 ```
 
 按照如下选择，生成项目：

package/docs/zh/tutorials/first-app/c01-start.mdx

@@ -17,7 +17,7 @@ import Prerequisites from "@site-docs/components/prerequisites"
 
 ```bash
 mkdir myapp && cd myapp
-npx @modern-js/create
+npx @modern-js/create@latest
 ```
 
 import InitApp from "@site-docs/components/init-app"

package/package.json

@@ -15,27 +15,27 @@
     "modern",
     "modern.js"
   ],
-  "version": "2.19.2-alpha.0",
+  "version": "2.21.0",
   "publishConfig": {
     "registry": "https://registry.npmjs.org/",
     "access": "public"
   },
   "peerDependencies": {
-    "@modern-js/builder-doc": "^2.19.1"
+    "@modern-js/builder-doc": "^2.21.0"
   },
   "devDependencies": {
     "classnames": "^2",
     "clsx": "^1.2.1",
     "react": "^18",
     "react-dom": "^18",
-    "ts-node": "^10",
-    "typescript": "^4",
+    "ts-node": "^10.9.1",
+    "typescript": "^5",
     "fs-extra": "^10",
     "@types/node": "^16",
     "@types/fs-extra": "^9",
-    "@modern-js/doc-plugin-auto-sidebar": "2.19.1",
-    "@modern-js/doc-tools": "2.19.1",
-    "@modern-js/builder-doc": "2.19.1"
+    "@modern-js/builder-doc": "2.21.0",
+    "@modern-js/doc-tools": "2.21.0",
+    "@modern-js/doc-plugin-auto-sidebar": "2.21.0"
   },
   "scripts": {
     "dev": "modern dev",

package/src/components/ShowcaseList/index.tsx

@@ -4,10 +4,10 @@ import styles from './index.module.scss';
 const getDomain = (url: string) => new URL(url).hostname;
 
 const TYPE_MAP = {
-  doc: 'Modern.js Doc',
-  module: 'Modern.js Module',
-  builder: 'Modern.js Builder',
-  framework: 'Modern.js Framework',
+  doc: 'Doc',
+  module: 'Module',
+  builder: 'Builder',
+  framework: 'Framework',
 };
 
 export const ShowcaseList = () => {