@bleedingdev/modern-js-main-doc 3.2.0-ultramodern.74 → 3.2.0-ultramodern.77

package/docs/zh/guides/basic-features/deploy.mdx

@@ -15,11 +15,11 @@ sidebar_position: 15
 
 ## 构建部署产物
 
-执行 `modern deploy` 命令将自动输出部署产物。此过程包括优化 Bundler 构建产物及产物依赖，检测当前部署平台，并自动生成可以在该平台运行的产物。
+执行 `ultramodern deploy` 命令将自动输出部署产物。此过程包括优化 Bundler 构建产物及产物依赖，检测当前部署平台，并自动生成可以在该平台运行的产物。
 如果你希望在本地生成并测试特定部署平台的产物，可以通过设置环境变量来指定平台：
 
 ```bash
-MODERNJS_DEPLOY=netlify npx modern deploy
+MODERNJS_DEPLOY=netlify npx ultramodern deploy
 ```
 
 :::info
@@ -35,10 +35,10 @@ MODERNJS_DEPLOY=netlify npx modern deploy
 你可以使用以下命令构建项目：
 
 ```bash
-npx modern deploy
+npx ultramodern deploy
 ```
 
-当执行 `modern deploy` 命令时，Modern.js 将生成可执行的部署产物，并在控制台输出以下内容：
+当执行 `ultramodern deploy` 命令时，UltraModern.js 将生成可执行的部署产物，并在控制台输出以下内容：
 
 ```bash
 Static directory: `.output/static`
@@ -66,7 +66,7 @@ PORT=3000 node .output/index
 {
   "scripts": {
     "build:packages": "pnpm --filter 'app^...' run build",
-    "deploy": "pnpm run build:packages && modern deploy"
+    "deploy": "pnpm run build:packages && ultramodern deploy"
   }
 }
 ```
@@ -77,7 +77,7 @@ PORT=3000 node .output/index
 {
   "scripts": {
     "build:packages": "rush rebuild --to-except app",
-    "deploy": "rushx build:packages && modern deploy"
+    "deploy": "rushx build:packages && ultramodern deploy"
   }
 }
 ```
@@ -105,7 +105,7 @@ Netlify 是一个流行的 Web 开发平台，专为构建、发布和维护现
 ```toml
 [build]
   publish = "dist"
-  command = "modern deploy"
+  command = "ultramodern deploy"
 ```
 
 :::info
@@ -121,7 +121,7 @@ Netlify 是一个流行的 Web 开发平台，专为构建、发布和维护现
 ```toml title="netlify.toml"
 [build]
   publish = "dist"
-  command = "modern deploy"
+  command = "ultramodern deploy"
 
 [functions]
   directory = ".netlify/functions"
@@ -167,7 +167,7 @@ Netlify 是一个流行的 Web 开发平台，专为构建、发布和维护现
 {
   "scripts": {
     "build:packages": "pnpm --filter 'app^...' run build",
-    "deploy": "pnpm run build:packages && modern deploy"
+    "deploy": "pnpm run build:packages && ultramodern deploy"
   }
 }
 ```
@@ -207,7 +207,7 @@ Vercel 是一个面向现代 Web 应用的部署平台，它提供了丰富的
 
 ```json title="vercel.json"
 {
-  "buildCommand": "modern deploy",
+  "buildCommand": "ultramodern deploy",
   "outputDirectory": ".vercel/output"
 }
 ```
@@ -272,7 +272,7 @@ Vercel 是一个面向现代 Web 应用的部署平台，它提供了丰富的
 {
   "scripts": {
     "build:packages": "pnpm --filter 'app^...' run build",
-    "deploy": "pnpm run build:packages && modern deploy"
+    "deploy": "pnpm run build:packages && ultramodern deploy"
   }
 }
 ```
@@ -311,12 +311,12 @@ Github Pages 支持两种部署方式，通过分支部署或通过 Github Actio
 
 1. 在 github 仓库中，选择 `Settings > Pages > Source > Deploy from a branch`。
 2. 安装 `gh-pages` 依赖作为开发依赖。
-3. 在 package.json 的 `scripts` 中添加 `"deploy:gh-pages": "MODERNJS_DEPLOY=ghPages modern deploy && gh-pages -d .output"`。
+3. 在 package.json 的 `scripts` 中添加 `"deploy:gh-pages": "MODERNJS_DEPLOY=ghPages ultramodern deploy && gh-pages -d .output"`。
 4. 执行 `npm run deploy:gh-pages`。
 
 :::info
 
-1. 执行 `MODERNJS_DEPLOY=ghPages modern deploy`，Modern.js 会把可用于 github 部署的产物构建到 `.output` 目录。
+1. 执行 `MODERNJS_DEPLOY=ghPages ultramodern deploy`，UltraModern.js 会把可用于 github 部署的产物构建到 `.output` 目录。
 2. 可以参考项目[示例](https://github.com/web-infra-dev/modern-js-examples/tree/main/examples/modern-js-deploy-csr)。
 
 :::

package/docs/zh/guides/basic-features/env-vars.mdx

@@ -16,8 +16,8 @@ Modern.js 提供了对环境变量的支持，包含内置的环境变量和自
 
 表示当前的执行环境，是**只读的**的环境变量，其值在不同的执行命令下具有不同的值：
 
-- `production`：执行 `modern build`、`modern serve` 命令时的默认值。
-- `development`：执行 `modern dev` 命令时的默认值，同时也是其他所有情况下的默认值。
+- `production`：执行 `ultramodern build`、`ultramodern serve` 命令时的默认值。
+- `development`：执行 `ultramodern dev` 命令时的默认值，同时也是其他所有情况下的默认值。
 
 ### MODERN_ENV
 

package/docs/zh/guides/basic-features/routes/config-routes.mdx

@@ -270,7 +270,7 @@ Modern.js 会自动查找并加载：
 
 :::info
 
-当前路由结构可以通过 [`modern routes`](#调试路由) 命令查看
+当前路由结构可以通过 [`ultramodern routes`](#调试路由) 命令查看
 
 :::
 
@@ -318,7 +318,7 @@ export default defineRoutes(({ page }, fileRoutes) => {
 
 ```bash
 # 生成路由结构分析报告
-npx modern routes
+npx ultramodern routes
 ```
 
 该命令会在 `dist/routes-inspect.json` 文件中生成最终的路由结构，帮助你了解合并后的完整路由信息。

package/docs/zh/guides/concept/server.mdx

@@ -26,10 +26,10 @@ Modern.js 开发环境和生产环境的 Web 服务器流程是完全同构的
 
 Modern.js 支持在任何 Node.js 环境运行构建产物。在 CI 环境中，通常情况下已经安装了应用全部的依赖。
 
-你可以执行 [`modern build`](/apis/app/commands#modern-build) 来构建应用，执行 [`modern serve`](/apis/app/commands#modern-serve) 命令来运行 Web 服务器，启动 Modern.js 应用。
+你可以执行 [`ultramodern build`](/apis/app/commands#ultramodern-build) 来构建应用，执行 [`ultramodern serve`](/apis/app/commands#ultramodern-serve) 命令来运行 Web 服务器，启动 UltraModern.js 应用。
 
 ## 在生产环境中运行
 
 在部署到生产环境时，产物体积应该尽可能小，而上述在 CI 中运行的方案，会保留原项目的所有产物。因此在生产环境，不推荐通过上述命令运行应用。
 
-Modern.js 提供了独立的部署方案，当运行 [`modern deploy`](/apis/app/commands#modern-deploy) 命令时，产物中会包含可运行 Web 服务器的入口文件。
+UltraModern.js 提供了独立的部署方案，当运行 [`ultramodern deploy`](/apis/app/commands#ultramodern-deploy) 命令时，产物中会包含可运行 Web 服务器的入口文件。

package/docs/zh/guides/get-started/quick-start.mdx

@@ -25,7 +25,7 @@ import DebugApp from '@site-docs/components/debug-app';
 
 ## 使用配置
 
-通过 `@modern-js/create` 创建的 Modern.js 项目中，会默认生成 `modern.config.ts` 文件。
+通过 `@bleedingdev/modern-js-create` 创建的 UltraModern.js 项目中，会默认生成 `modern.config.ts` 文件。
 
 你可以通过该配置文件修改配置，覆盖 Modern.js 的默认行为。例如添加如下配置，开启 SSR：
 
@@ -46,7 +46,7 @@ export default defineConfig({
 
 在新创建的工程中，默认会安装 `@modern-js/app-tools` npm 包，它是 Modern.js 框架的核心包，主要提供以下能力：
 
-- 提供 `modern dev`, `modern build` 等常用的 CLI 命令。
+- 提供 `ultramodern dev`, `ultramodern build` 等常用的 CLI 命令。
 - 集成 Rsbuild，提供构建能力。
 - 集成 Modern.js Server，提供开发和生产服务器相关能力。
 

package/docs/zh/guides/get-started/tech-stack.mdx

@@ -18,13 +18,13 @@ Modern.js 底层的 Rsbuild 支持构建 Vue 应用，如果你需要使用 Vue
 
 Modern.js 提供两套一方路由方案：
 
-- 默认使用 [React Router 7](https://reactrouter.com/en/main)，通过 `@modern-js/runtime/router` 导出 API。
-- 支持 [TanStack Router](https://tanstack.com/router)，通过 `@modern-js/plugin-tanstack/runtime` 导出 API。
+- 默认使用 [TanStack Router](https://tanstack.com/router)，通过 `@modern-js/plugin-tanstack/runtime` 导出 API。
+- 兼容 [React Router 7](https://reactrouter.com/en/main)，通过 `@modern-js/runtime/router` 导出 API。
 
-创建项目时，可通过以下命令选择 TanStack Router：
+创建 UltraModern 项目时，默认会包含 TanStack Router：
 
 ```bash
-npx @modern-js/create@latest myapp --router tanstack
+pnpm dlx @bleedingdev/modern-js-create myapp
 ```
 
 Modern.js 支持约定式路由、自控式路由或其他路由方案，请参考 [页面入口](/guides/concept/entries) 进行选择。

package/docs/zh/guides/topic-detail/module-federation/application.mdx

@@ -104,7 +104,7 @@ export default RemoteApp;
 
 ## 启动应用
 
-现在，生产者应用和消费者应用都已经搭建完毕，我们可以在本地运行 `modern dev` 启动两个应用。
+现在，生产者应用和消费者应用都已经搭建完毕，我们可以在本地运行 `ultramodern dev` 启动两个应用。
 
 启动后，消费者应用访问 `/remote` 路由时，会进入生产者应用中。访问 `http://localhost:8080/remote`，可以看到页面中已经包含了生产者的远程模块的完整页面。
 

package/docs/zh/guides/topic-detail/module-federation/deploy.mdx

@@ -88,10 +88,10 @@ export default createModuleFederationConfig({
 
 ## 本地验证部署
 
-Modern.js 提供了 `modern deploy` 命令，可以方便生成可运行在 Node.js 环境的产物。
+Modern.js 提供了 `ultramodern deploy` 命令，可以方便生成可运行在 Node.js 环境的产物。
 
 ```bash
-modern deploy
+ultramodern deploy
 ```
 
 执行命令后，可以在控制台看到以下输出：

package/docs/zh/guides/topic-detail/module-federation/usage.mdx

@@ -154,7 +154,7 @@ export default Index;
 
 ## 启动应用
 
-现在，生产者应用和消费者应用都已经搭建完毕，我们可以在本地运行 `modern dev` 启动两个应用。
+现在，生产者应用和消费者应用都已经搭建完毕，我们可以在本地运行 `ultramodern dev` 启动两个应用。
 
 启动后，消费者中对生产者模块的引入，不会再出现抛错，类型已经下载到消费者应用中。
 
@@ -164,7 +164,7 @@ export default Index;
 
 访问 `http://localhost:8080/remote`，可以看到页面中已经包含了生产者的远程模块 `Button` 组件。
 
-我们也可以在本地执行 `modern serve` 来模拟生产环境。
+我们也可以在本地执行 `ultramodern serve` 来模拟生产环境。
 
 因为 Module Federation 插件会自动读取 Modern.js 的 `output.assetPrefix` 配置作为远程模块的访问地址，而该值在生产环境下构建后默认是 `/`。如果不做特殊处理，消费者将从自己的域名下拉取远程模块的入口文件。我们可以添加如下配置：
 
@@ -178,7 +178,7 @@ export default defineConfig({
     port: 3051,
   },
   output: {
-    // Now this configuration is only used in the local when you run modern serve command.
+    // Now this configuration is only used in the local when you run ultramodern serve command.
     // If you want to deploy the application to the platform, use your own domain name.
     // Module federation will automatically write it to mf-manifest.json, which influences consumer to fetch remoteEntry.js.
     assetPrefix: 'http://127.0.0.1:3051',
@@ -187,10 +187,10 @@ export default defineConfig({
 });
 ```
 
-现在，在生产者中运行 `modern build && MODERN_MF_AUTO_CORS=true modern serve`，在消费者中运行 `modern build && modern serve`，即可在本地模拟生产环境，访问到远程模块。
+现在，在生产者中运行 `ultramodern build && MODERN_MF_AUTO_CORS=true ultramodern serve`，在消费者中运行 `ultramodern build && ultramodern serve`，即可在本地模拟生产环境，访问到远程模块。
 
 :::tip
-在使用 `modern serve` 命令时，需要在启动生产者项目时携带 `MODERN_MF_AUTO_CORS=true` 环境变量，以自动处理跨域问题，确保消费者可以正常访问生产者的远程模块资源。
+在使用 `ultramodern serve` 命令时，需要在启动生产者项目时携带 `MODERN_MF_AUTO_CORS=true` 环境变量，以自动处理跨域问题，确保消费者可以正常访问生产者的远程模块资源。
 :::
 
 上述用例可以参考：[Modern.js & Module Federation 基础用法示例](https://github.com/web-infra-dev/modern-js-examples/tree/main/examples/module-federation/base)。

package/docs/zh/guides/troubleshooting/builder.mdx

@@ -23,7 +23,7 @@ Modern.js 内部基于 [Rsbuild](https://v2.rsbuild.rs/) 封装了自身的构
 Modern.js 提供 [inspect 命令](/apis/app/commands.html) 用于查看项目最终生成的 Modern.js 配置以及 Rspack 配置。
 
 ```bash
-➜ npx modern inspect
+➜ npx ultramodern inspect
 
 Inspect config succeed, open following files to view the content:
 

package/docs/zh/guides/upgrade/other.md

@@ -88,14 +88,14 @@ Modern.js 3.0 默认使用 React Router v7 作为路由库。React Router v7 相
 
 如果需要使用 React Router v5 或 React Router v6，需要使用**自控式路由**模式。自控式路由允许你完全控制路由配置，不受 Modern.js 约定式路由的限制。
 
-## 使用 @modern-js/create 创建 Monorepo 和 Modern.js Module
+## 使用 @bleedingdev/modern-js-create 创建 Monorepo 和 Modern.js Module
 
-Modern.js 3.0 不再支持通过 `@modern-js/create` 创建 Monorepo 项目和 Modern.js Module 项目。
+Modern.js 3.0 不再支持通过 `@bleedingdev/modern-js-create` 创建 Monorepo 项目和 Modern.js Module 项目。
 
 **变更内容**：
 
-- 在 [v2.53.0](https://github.com/web-infra-dev/modern.js/releases/tag/v2.53.0) 版本中，移除了使用 `@modern-js/create` 创建 Monorepo 项目的功能
-- 在 [v2.61.0](https://github.com/web-infra-dev/modern.js/releases/tag/v2.61.0) 版本中，移除了使用 `@modern-js/create` 和 `modern new` 命令创建 Modern.js Module 项目的功能
+- 在 [v2.53.0](https://github.com/web-infra-dev/modern.js/releases/tag/v2.53.0) 版本中，移除了使用 `@bleedingdev/modern-js-create` 创建 Monorepo 项目的功能
+- 在 [v2.61.0](https://github.com/web-infra-dev/modern.js/releases/tag/v2.61.0) 版本中，移除了使用 `@bleedingdev/modern-js-create` 和 `ultramodern new` 命令创建 Modern.js Module 项目的功能
 
 **处理方式**：
 
@@ -104,12 +104,12 @@ Modern.js 3.0 不再支持通过 `@modern-js/create` 创建 Monorepo 项目和 M
 
 ## new 命令和 upgrade 命令移除
 
-Modern.js 3.0 移除了 `modern new` 和 `modern upgrade` 命令，需要按照文档手动操作。
+Modern.js 3.0 移除了 `ultramodern new` 和 `ultramodern upgrade` 命令，需要按照文档手动操作。
 
 **变更内容**：
 
-- `modern new` 命令在 Modern.js 3.0 中不再支持，无法通过命令添加入口或启用功能
-- `modern upgrade` 命令在 Modern.js 3.0 中不再支持，无法通过命令自动升级依赖
+- `ultramodern new` 命令在 Modern.js 3.0 中不再支持，无法通过命令添加入口或启用功能
+- `ultramodern upgrade` 命令在 Modern.js 3.0 中不再支持，无法通过命令自动升级依赖
 
 **处理方式**：
 
@@ -187,4 +187,3 @@ Modern.js 之前提供了 ESLint 的完整规则集，涵盖了 @modern-js（针
 
 
 
-

package/package.json

@@ -18,14 +18,14 @@
     "modern",
     "modern.js"
   ],
-  "version": "3.2.0-ultramodern.74",
+  "version": "3.2.0-ultramodern.77",
   "publishConfig": {
     "registry": "https://registry.npmjs.org/",
     "access": "public"
   },
   "dependencies": {
     "mermaid": "^11.15.0",
-    "@modern-js/sandpack-react": "npm:@bleedingdev/modern-js-sandpack-react@3.2.0-ultramodern.74"
+    "@modern-js/sandpack-react": "npm:@bleedingdev/modern-js-sandpack-react@3.2.0-ultramodern.77"
   },
   "devDependencies": {
     "@rsbuild/plugin-sass": "1.5.2",