@yannick-z/modulo 0.2.0 → 0.3.1

package/.vscode/extensions.json

@@ -0,0 +1,3 @@
+{
+	"recommendations": ["biomejs.biome"]
+}

package/README.md

@@ -1,6 +1,6 @@
 # Modulo - 高性能通用前端打包工具
 
-Modulo 是一款现代、灵活且功能强大的通用前端项目打包工具。它基于高性能的 Rust 工具链，旨在为现代前端项目提供极速的开发体验和高效的构建流程。通过简洁的配置，Modulo 即可支持 React、Vue 等多种主流框架，并具备良好的扩展性。
+Modulo 是一款现代、灵活且功能强大的通用前端项目打包工具。它基于高性能的 Rust 工具链 (Rspack/Rsbuild)，旨在为现代前端项目提供极速的开发体验和高效的构建流程。通过简洁的配置，Modulo 即可支持 React、Vue 等多种主流框架，并具备良好的扩展性。
 
 ---
 
@@ -10,29 +10,30 @@ Modulo 是一款现代、灵活且功能强大的通用前端项目打包工具
 - [📦 先决条件](#-先决条件)
 - [🚀 命令行接口 (CLI)](#-命令行接口-cli)
 - [🧠 核心概念：入口发现机制](#-核心概念入口发现机制)
-- [⚙️ 配置文件 (`modulo.config.json`)](#️-配置文件-moduloconfigjson)
+- [⚙️ 配置文件 (`modulo.config.ts`)](#️-配置文件-moduloconfigts)
 - [🌐 强大的 `externals` 配置](#-强大的-externals-配置)
 
 ---
 
 ## ✨ 核心功能
 
-- **极速构建**: 底层采用高性能 Rust 工具链，提供极致的开发和构建速度。
+- **极速构建**: 底层采用高性能 Rust 工具链 (Rspack/Rsbuild)，提供极致的开发和构建速度。
 - **自动入口发现**: 无需手动配置每一个入口，Modulo 会自动扫描指定目录来发现项目的所有入口。
 - **多框架支持**: 内置对 React、Vue 等流行框架的支持，并为 React 提供 `react-refresh` 等现代化开发体验。
 - **零配置启动**: 通过 `modulo init` 命令快速初始化项目，自动生成配置文件和 `package.json` 脚本。
 - **强大的开发服务器**: 内置高效的开发服务器，支持热模块替换（HMR）。
 - **多种打包目标**: 支持将项目打包为**页面应用** (`page`) 或**独立的库** (`module`)。
-- **强大的外部依赖管理**: 通过 `externals` 配置，轻松地将公共库从构建中排除，并通过 CDN 或本地路径在 HTML 中自动注入。
+- **自动 External**: 通过 `autoExternal` 功能，自动识别项目中使用的第三方库，并根据配置按需注入 Import Map 或 Script 标签，无需手动维护冗长的 HTML 模板。
+- **灵活的产物格式**: 支持 `importmap` (ESM) 和 `script` (Global Variable) 两种 External 模式，适应不同的部署场景。
 
 ## 📦 先决条件
 
-- [Node.js](https://nodejs.org/) (version 18+)
+- [Node.js](https://nodejs.org/) (version 24+)
 - [pnpm](https://pnpm.io/)
 
 ## 🚀 命令行接口 (CLI)
 
-Modulo 提供 `init` 和 `pack` (`dev`/`build`) 两个核心命令。
+Modulo 提供 `init` 和 `pack` (`dev`/`build`/`preview`) 两个核心命令组。
 
 ### `modulo init`
 
@@ -42,22 +43,23 @@ Modulo 提供 `init` 和 `pack` (`dev`/`build`) 两个核心命令。
 
 - **`target` (必需):**
 
-  - `config`: 创建 `modulo.config.json` 配置文件。
+  - `config`: 创建配置文件（支持 `modulo.config.ts`, `modulo.config.js`, `modulo.config.json`）。
   - `script`: 在 `package.json` 中添加 `dev` 和 `build` 脚本。
+  - `project`: 初始化一个新的 Modulo 项目。
 
 - **`options`:**
 
-| 参数                       | 简写 | 描述                                                                                                 |
-| :------------------------- | :--- | :--------------------------------------------------------------------------------------------------- |
-| `--path <path>`            |      | 指定配置文件的输出路径 (仅当 `target` 为 `config` 时有效)。                                          |
-| `--force`                  | `-f` | 强制覆盖现有文件 (仅当 `target` 为 `config` 时有效)。                                                |
-| `--preset <react17\|vue2>` |      | 指定预设配置，目前支持 `react17` 和 `vue2`。如果未提供，将尝试根据 `package.json` 中的依赖自动识别。 |
+| 参数 | 简写 | 描述 |
+| :--- | :--- | :--- |
+| `--path <path>` | | 指定配置文件的输出路径 (仅当 `target` 为 `config` 时有效)，或者指定新项目的路径（仅当 `target` 为 `project` 时有效）。 |
+| `--force` | `-f` | 强制覆盖现有文件 (仅当 `target` 为 `config` 时有效)。 |
+| `--preset <preset>` | | 指定预设配置，目前支持 `react19`, `vue`, `vue2`。 |
 
-### `modulo dev` / `modulo build`
+### `modulo dev` / `modulo build` / `modulo preview`
 
-用于启动开发服务器或执行生产构建。
+用于启动开发服务器、执行生产构建或预览产物。
 
-**用法:** `modulo <dev|build> <target> [options]`
+**用法:** `modulo <dev|build|preview> <target> [options]`
 
 - **`<target>` (位置参数, 必需):**
 
@@ -67,14 +69,13 @@ Modulo 提供 `init` 和 `pack` (`dev`/`build`) 两个核心命令。
 
 - **`options`:**
 
-| 参数               | 简写       | 描述                                                             |
-| :----------------- | :--------- | :--------------------------------------------------------------- |
-| `--env <dev\|prd>` |            | 指定构建环境。`dev` 命令默认为 `dev`，`build` 命令默认为 `prd`。 |
-| `--config <path>`  |            | 指定 `modulo.config.json` 文件的路径。                           |
-| `--watch`          | `-w`       | 在 `build` 模式下启用监听模式（对 `all` target 无效）。          |
-| `--format <esm>`   | `-f <esm>` | 将页面打包为 ESM 格式，以支持 `importmaps`。                     |
-| `--debug`          |            | 启用 Modulo 的调试日志。                                         |
-| `--verbose`        | `-v`       | 显示更详细的日志信息。                                           |
+| 参数 | 简写 | 描述 |
+| :--- | :--- | :--- |
+| `--env <dev\|prd>` | | 指定构建环境。`dev` 命令默认为 `dev`，`build` 命令默认为 `prd`。 |
+| `--config <path>` | `-c` | 指定配置文件路径 (默认为 `modulo.config.ts`, `modulo.config.js`, `modulo.config.json` 之一)。 |
+| `--watch` | `-w` | 在 `build` 模式下启用监听模式（对 `all` target 无效）。 |
+| `--debug` | | 启用 Modulo 的调试日志，并在当前目录生成 `modulo.debug.log`。 |
+| `--verbose` | `-v` | 在控制台显示更详细的日志信息。 |
 
 ## 🧠 核心概念：入口发现机制
 
@@ -82,7 +83,7 @@ Modulo 的一大特性是**自动入口发现**，您无需在配置文件中手
 
 其工作方式如下：
 
-1.  在 `modulo.config.json` 的 `input` 字段中，您需要定义 `pages` 和 `modules` 的根目录（例如 `src/pages` 或 `src/modules`）。
+1.  在配置文件的 `input` 字段中，您需要定义 `pages` 和 `modules` 的根目录（例如 `src/pages` 或 `src/modules`）。
 2.  当您运行 `modulo dev page` 或 `modulo dev module` 时，Modulo 会自动扫描 `input.pages` 或 `input.modules` 指定的目录。
 3.  它会将每一个包含有效入口文件的**直接子目录**识别为一个独立的模块入口。
 4.  对于每个子目录，Modulo 会按照以下优先级顺序查找入口文件：
@@ -95,7 +96,9 @@ Modulo 的一大特性是**自动入口发现**，您无需在配置文件中手
 
 **示例**：对于一个名为 `src/pages/my-page` 的目录，如果项目是 Vue 框架，Modulo 可能会按 `index.ts` -> `index.vue` -> `my-page.vue` 的顺序查找入口文件。
 
-## ⚙️ 配置文件 (`modulo.config.json`)
+## ⚙️ 配置文件 (`modulo.config.ts`)
+
+Modulo 配置文件支持 `.ts`, `.js`, `.json` 格式。默认查找顺序为 `modulo.config.ts`, `modulo.config.js`, `modulo.config.json`。
 
 这是 Modulo 的核心配置文件，提供了丰富的选项来满足各种定制化需求。
 
@@ -113,17 +116,6 @@ Modulo 的一大特性是**自动入口发现**，您无需在配置文件中手
 - **特别说明**:
   - 如果您的现有项目结构与 Modulo 的默认 `src/modules` 或 `src/pages` 不符，您可以直接修改这些路径以匹配您的项目。
   - 另一种灵活的做法是，在符合 Modulo 预设的目录（例如 `src/pages/`）下，为旧项目中的模块创建新的入口文件（如 `index.ts`）。这些新的入口文件可以简单地从旧路径导出模块，从而在不侵入式修改旧代码的情况下，让 Modulo 能够识别并打包它们。
-- **示例 (为旧项目模块创建 Modulo 兼容入口)**:
-  假设您的旧项目有一个位于 `old-project/components/Button.js` 的组件，并且您希望 Modulo 将其作为一个模块打包。
-  1.  在 `modulo.config.json` 中，确保 `input.modules` 指向 `src/modules` (或您自定义的模块目录)。
-  2.  在 `src/modules/my-button/` 目录下创建一个 `index.ts` 文件：
-      `typescript
-// src/modules/my-button/index.ts
-export { default as Button } from '../../old-project/components/Button.js';
-// 或者，如果旧模块是命名导出：
-// export * from '../../old-project/components/Button.js';
-`
-      这样，Modulo 就会将 `src/modules/my-button` 识别为一个模块入口，并打包 `Button.js`。
 
 ### `output`
 
@@ -219,6 +211,25 @@ export { default as Button } from '../../old-project/components/Button.js';
 
 ---
 
+### `autoExternal`
+
+- **描述**: 是否开启自动 External 功能。开启后，Modulo 会自动扫描代码中引入的 `node_modules` 依赖，如果它们在 `externals` 中有定义，则自动注入对应的 Import Map 或 Script 标签。
+- **类型**: `boolean`
+- **默认值**: `true`。
+
+---
+
+### `externalsType`
+
+- **描述**: 指定 External 的注入模式。
+- **类型**: `"importmap" | "script"`
+- **默认值**: `"importmap"`。
+- **选项**:
+  - `importmap`: 使用原生的 Import Map 特性（需要浏览器支持或 polyfill），适合 ESM 现代开发模式。
+  - `script`: 将 External 映射为全局变量（如 `window.React`），适合传统 UMD 模式。
+
+---
+
 ## 🌐 强大的 `externals` 配置
 
 `externals` 是 Modulo 的一项核心功能，它允许您将一些体积较大、不常变动的第三方库（如 React, Vue, Lodash）从您的应用包中分离出去，改为通过 CDN 或其他外部服务器加载。
@@ -228,13 +239,14 @@ export { default as Button } from '../../old-project/components/Button.js';
 - **减小包体积**: 显著减少主包大小，加快应用加载速度。
 - **利用浏览器缓存**: 用户在访问不同应用时，可以复用已缓存的公共库。
 - **加快构建速度**: 无需重复打包这些大型库。
+- **按需注入**: 配合 `autoExternal: true`，只有当页面真正引用了某个库时，它的 CDN 链接才会被注入到 HTML 中。
 
 ### 工作原理
 
 当您在 `externals` 中配置一个库时，Modulo 会执行两个关键操作：
 
 1.  **告知打包器**: 它会配置底层的打包器（Rspack），告诉它在代码中遇到 `import React from 'react'` 这样的语句时，不要将 `react` 库打包进来，而是将其视为一个“外部的”、在运行时已经存在的依赖。
-2.  **自动注入脚本**: 对于 `page` 类型的入口，Modulo 会读取 `externals` 的配置，并自动在生成的 HTML 文件中注入相应的 `<script>` 标签，以从您指定的 URL 加载这个库。
+2.  **自动注入脚本**: 对于 `page` 类型的入口，Modulo 会读取 `externals` 的配置，并自动在生成的 HTML 文件中注入相应的 `<script>` 标签（Import Map 或普通 Script），以从您指定的 URL 加载这个库。
 
 ### 配置详解
 
@@ -255,10 +267,7 @@ export { default as Button } from '../../old-project/components/Button.js';
   "externals": {
     "react-dom": {
       "importName": ["react-dom", "ReactDOM"],
-      "url": {
-        "umd": "/packages/common/js/react-17.0.2/umd/react-dom.production.min.js",
-        "esm": "https://cdn.jsdelivr.net/npm/react-dom@17.0.2/+esm"
-      }
+      "url": "https://esm.sh/react-dom@19.2.4"
     }
   }
   ```
@@ -268,32 +277,27 @@ export { default as Button } from '../../old-project/components/Button.js';
   - **`url`** (`string | object`, 必需):
     - **作用**: 指定库的加载地址。
     - **字符串形式**: 如果是字符串，则在所有模式下都使用该 URL。
-    - **对象形式**:
-      - `umd` (`string`): 提供 UMD (Universal Module Definition) 格式的库 URL。这是传统的、可以通过 `<script>` 标签直接加载并在全局（如 `window.ReactDOM`）暴露变量的格式。
-      - `esm` (`string`): 提供 ES Module 格式的库 URL。当您使用 `--format esm` 构建时，Modulo 会使用此 URL，并通过 `importmap` 机制来加载模块。
     - **dev 和 prd 模式**
-      - 对 url 对象或字符串进行嵌套，以分别指定 dev 和 prd 模式下的 URL。
+      - 对 url 对象进行嵌套，以分别指定 dev 和 prd 模式下的 URL。
 
 ## 外部依赖加载
 
 当 `modulo` 打包您的应用程序时，它会以特定的方式处理外部依赖项，以支持模块化加载和高效缓存。外部依赖项（如 React、Vue、jQuery 等）不会直接打包到您的模块输出中。相反，它们期望在运行时由宿主环境提供。
 
-这主要通过 **SystemJS 导入映射 (Import Maps)** 进行管理。
+这主要通过 **Import Maps (ESM)** 或 **Global Variables (UMD)** 进行管理，具体取决于 `externalsType` 的配置。
 
-### SystemJS 导入映射
+### Import Maps (推荐)
 
 导入映射是一个 JSON 对象，允许您控制模块说明符的解析。在 `modulo` 的上下文中，您可以在 `index.html`（或类似的入口文件）中的导入映射中定义您的外部依赖项及其对应的 URL。
 
 **导入映射示例：**
 
 ```html
-<script type="systemjs-importmap">
+<script type="importmap">
   {
     "imports": {
-      "react": "https://cdn.jsdelivr.net/npm/react@17.0.2/umd/react.production.min.js",
-      "react-dom": "/packages/common/js/react-17.0.2/umd/react-dom.production.min.js",
-      "vue": "https://cdn.jsdelivr.net/npm/vue@2.7.16/dist/vue.js",
-      "jquery": "https://cdn.jsdelivr.net/npm/jquery@3.7.1/dist/jquery.min.js"
+      "react": "https://esm.sh/react@19.2.4",
+      "react-dom": "https://esm.sh/react-dom@19.2.4"
     }
   }
 </script>
@@ -301,11 +305,4 @@ export { default as Button } from '../../old-project/components/Button.js';
 
 在此示例中：
 
-- 当您的打包模块尝试 `import 'react'` 时，SystemJS 会将其解析为 `https://cdn.jsdelivr.net/npm/react@17.0.2/umd/react.production.min.js`。
-- 本地路径，例如此示例中的 `react-dom` 或 `vue`，如果依赖项托管在本地或您的项目结构中，也可以使用。
-
-### `webhost` 的作用
-
-`webhost` 库（位于 `packages/webhost`）旨在与此外部依赖加载机制协同工作。**`webhost` 会通过 `modulo.config.json` 中 `html.tags` 配置项自动注入到所有页面应用中，以提供开箱即用的模块加载能力。** 它提供了一组实用函数，通过 `window.webhost.remote_module` 对象暴露，可简化加载和挂载依赖于这些外部框架的模块的过程。
-
-`window.webhost.remote_module.mount` 函数内部使用 SystemJS 导入指定的模块及其依赖项（通过导入映射解析），然后处理初始化和挂载的框架特定逻辑，并能自动识别 React 或 Vue 组件。此外，还提供了 `mount_react` 和 `mount_vue2` 等特定框架的挂载函数。
+- 当您的打包模块尝试 `import React from 'react'` 时，浏览器会将其解析为 `https://esm.sh/react@19.2.4`。

package/bin/modulo.js

@@ -1,22 +1,32 @@
 #! /usr/bin/env node
 
+const requiredVersion = 24;
+const currentVersion = process.version.match(/^v(\d+)/)?.[1];
+
+if (!currentVersion || parseInt(currentVersion) < requiredVersion) {
+	console.error(
+		`\x1b[31mError: Node.js version ${process.version} is not supported. Please use Node.js v${requiredVersion} or higher.\x1b[0m`,
+	);
+	process.exit(1);
+}
+
 import("../src/index.ts")
-  .then((module) => {
-    console.log("\nsupport ts, use Typescript code\n");
-    try {
-      module.exec();
-    } catch (e) {
-      console.error(e);
-    }
-  })
-  .catch((e) => {
-    console.error(e);
-    import("../dist/index.js").then((module) => {
-      console.log("\nnot support ts, use JavaScript code\n");
-      try {
-        module.exec();
-      } catch (e) {
-        console.error(e);
-      }
-    });
-  });
+	.then((module) => {
+		// console.log("\nsupport ts, use Typescript code\n");
+		try {
+			module.exec();
+		} catch (e) {
+			console.error(e);
+			process.exit(1);
+		}
+	})
+	.catch((e) => {
+		console.error(
+			"\x1b[31mError: Failed to load TypeScript source code.\x1b[0m",
+		);
+		console.error(e);
+		console.error(
+			`\x1b[33mTip: Ensure you are running with Node.js v${requiredVersion}+ which supports TypeScript natively (experimental).\x1b[0m`,
+		);
+		process.exit(1);
+	});

package/biome.json

@@ -0,0 +1,34 @@
+{
+	"$schema": "https://biomejs.dev/schemas/2.4.4/schema.json",
+	"vcs": {
+		"enabled": false,
+		"clientKind": "git",
+		"useIgnoreFile": false
+	},
+	"files": {
+		"ignoreUnknown": false
+	},
+	"formatter": {
+		"enabled": true,
+		"indentStyle": "tab"
+	},
+	"linter": {
+		"enabled": true,
+		"rules": {
+			"recommended": true
+		}
+	},
+	"javascript": {
+		"formatter": {
+			"quoteStyle": "double"
+		}
+	},
+	"assist": {
+		"enabled": true,
+		"actions": {
+			"source": {
+				"organizeImports": "on"
+			}
+		}
+	}
+}

package/package.json

@@ -1,36 +1,37 @@
 {
-  "name": "@yannick-z/modulo",
-  "description": "",
-  "type": "module",
-  "version": "0.2.0",
-  "main": "./src/index.ts",
-  "author": "oyangxiao",
-  "scripts": {
-    "build": "rslib build",
-    "dev": "rslib build -w"
-  },
-  "bin": {
-    "modulo": "./bin/modulo.js"
-  },
-  "dependencies": {
-    "@rsbuild/core":"^1.7.2",
-    "@rsbuild/plugin-less":"^1.5.0",
-    "@rsbuild/plugin-react":"^1.4.2",
-    "@rsbuild/plugin-umd":"^1.0.5",
-    "@rsbuild/plugin-vue2":"^1.0.5",
-    "@rslib/core":"^0.19.3",
-    "@types/node":"^24.0.0",
-    "@types/semver": "^7.7.1",
-    "minimist":"^1.2.8",
-    "picocolors":"^1.1.1",
-    "semver":"^7.7.3",
-    "typescript":"^5.9.3"
-  },
-  "devDependencies": {
-    "@types/minimist": "^1.2.5"
-  },
-  "license": "ISC",
-  "publishConfig": {
-    "registry": "https://registry.npmjs.org/"
-  }
-}
+	"name": "@yannick-z/modulo",
+	"description": "",
+	"type": "module",
+	"version": "0.3.1",
+	"main": "./src/index.ts",
+	"author": "oyangxiao",
+	"scripts": {
+		"build": "直接使用ts执行，所以不需要build",
+		"lint": "biome lint .",
+		"format": "biome format --write .",
+		"check": "biome check --write ."
+	},
+	"bin": {
+		"modulo": "./bin/modulo.js"
+	},
+	"dependencies": {
+		"@rsbuild/core": "^1.7.3",
+		"@rsbuild/plugin-less": "^1.6.0",
+		"@rsbuild/plugin-react": "^1.4.5",
+		"@rsbuild/plugin-vue2": "^1.1.0",
+		"@rslib/core": "^0.19.6",
+		"@types/node": "^24.0.0",
+		"cac": "^6.7.14",
+		"picocolors": "^1.1.1",
+		"semver": "^7.7.2",
+		"typescript": "^5.9.3"
+	},
+	"devDependencies": {
+		"@biomejs/biome": "2.4.4",
+		"@types/semver": "^7.7.1"
+	},
+	"license": "ISC",
+	"publishConfig": {
+		"registry": "https://registry.npmjs.org/"
+	}
+}

package/rslib.config.ts

@@ -1,22 +1,22 @@
-import { defineConfig } from '@rslib/core';
+import { defineConfig } from "@rslib/core";
 
 export default defineConfig({
-  lib: [
-    {
-      dts: false,
-      format: 'esm',
-      syntax: 'esnext',
-    },
-  ],
-  output: {
-    distPath: {
-      root: './dist',
-    },
-    target: 'node',
-  },
-  source: {
-    entry: {
-      index: './src/index.ts',
-    },
-  },
+	lib: [
+		{
+			dts: false,
+			format: "esm",
+			syntax: "esnext",
+		},
+	],
+	output: {
+		distPath: {
+			root: "./dist",
+		},
+		target: "node",
+	},
+	source: {
+		entry: {
+			index: "./src/index.ts",
+		},
+	},
 });

package/src/args/get-framework-name.ts

@@ -4,16 +4,16 @@ import { PANIC_IF } from "../tools/panic.ts";
 import semver from "semver";
 
 export function detect_preset() {
-  const { dependencies } = get_packagejson();
+	const { dependencies } = get_packagejson();
 
-  const framework_name = get_framework_name();
-  const version = semver.parse(dependencies[framework_name])!;
+	const framework_name = get_framework_name();
+	const version = semver.parse(dependencies[framework_name])!;
 
-  PANIC_IF(!version, `package.json中未识别到${framework_name}的版本信息`);
+	PANIC_IF(!version, `package.json中未识别到${framework_name}的版本信息`);
 
-  //需要识别
+	//需要识别
 
-  const preset = `${framework_name}${version.major}`;
+	const preset = `${framework_name}${version.major}`;
 
-  return preset;
+	return preset;
 }

package/src/args/index.ts

@@ -1,80 +1,22 @@
-import minimist from "minimist";
-import { default_config_file_name } from "../config/example/example-config.ts";
-import type { preset_ui_libs } from "../config/preset/libs.ts";
-import { get_cmd, type ModuloCmd_Init, type ModuloCmd_Pack } from "./cmd.ts";
-import { get_env } from "./mode.ts";
-import { set_node_env } from "./node_env.ts";
-import { get_preset_for_init } from "./preset.ts";
-import {
-  get_cmd_target,
-  type ModuloTarget_Init,
-  type ModuloTarget_Pack,
-} from "./target.ts";
+import type { preset_ui_libs } from "../config/presets.ts";
 
 export interface ModuloArgs_Pack {
-  cmd: ModuloCmd_Pack;
-  target: ModuloTarget_Pack;
-  pack: {
-    config: string;
-    env: "dev" | "prd";
-    watch: boolean;
-    esm: boolean;
-  };
+	cmd: "build" | "dev" | "preview";
+	target: "page" | "module" | "all";
+	pack: {
+		config?: string;
+		env: "dev" | "prd";
+		watch: boolean;
+		esm: boolean;
+	};
 }
 
 export interface ModuloArgs_Init {
-  cmd: ModuloCmd_Init;
-  target: ModuloTarget_Init;
-  init: {
-    path: string;
-    force: boolean;
-    preset: keyof typeof preset_ui_libs;
-  };
-}
-
-let args: ModuloArgs_Init | ModuloArgs_Pack;
-
-const argv = minimist(process.argv.slice(2));
-export const argv_debug = argv.debug === "true";
-export const argv_verbose = argv.verbose === "true" || argv.v;
-
-export function get_args() {
-  if (!args) {
-    const cmd = get_cmd(argv);
-
-    if (cmd === "build" || cmd === "dev") {
-      const target = get_cmd_target(argv, cmd);
-      // watch只能对单个构建目标使用
-      const watch = target === "all" ? false : argv.watch === "true" || argv.w;
-      args = {
-        cmd,
-        target,
-        // 是否是调试modulo
-        pack: {
-          // 配置文件路径
-          config:
-            (argv.config as string | undefined) || default_config_file_name,
-          // 运行模式, dev | prd
-          env: cmd === "build" || cmd === "dev" ? get_env(argv, cmd) : "prd",
-          watch,
-          esm: argv.format === "esm" || argv.f === "esm",
-        },
-      };
-      args.pack.env && set_node_env(args.pack.env);
-    } else {
-      args = {
-        cmd,
-        target: get_cmd_target(argv, cmd),
-        init: {
-          path: argv.path,
-          force: argv.force === "true" || argv.f,
-          preset: get_preset_for_init(argv),
-        },
-      };
-    }
-
-    if (argv_verbose) console.log("args: ", args);
-  }
-
-  return args;
+	cmd: "init";
+	target: "config" | "script" | "project";
+	init: {
+		path: string;
+		force: boolean;
+		preset: keyof typeof preset_ui_libs;
+	};
 }

package/src/args/preset.ts

@@ -4,23 +4,23 @@ import { detect_preset } from "./get-framework-name.ts";
 import { PANIC_IF } from "../tools/panic.ts";
 
 export function get_preset_for_init(argv: minimist.ParsedArgs) {
-  let preset = argv.preset;
+	let preset = argv.preset;
 
-  if (!preset) {
-    preset = detect_preset();
-    console.log(
-      picocolors.blue(
-        "未输入preset，但是根据package.json中的依赖自动识别到preset为: " +
-          preset
-      )
-    );
-  }
+	if (!preset) {
+		preset = detect_preset();
+		console.log(
+			picocolors.blue(
+				"未输入preset，但是根据package.json中的依赖自动识别到preset为: " +
+					preset,
+			),
+		);
+	}
 
-  preset &&
-    PANIC_IF(
-      preset !== "react17" && preset !== "vue2",
-      "目前只支持react17和vue2"
-    );
+	preset &&
+		PANIC_IF(
+			preset !== "react17" && preset !== "react19" && preset !== "vue2",
+			"目前只支持react17, react19和vue2",
+		);
 
-  return preset;
+	return preset;
 }

package/src/cli/init.ts

@@ -1,12 +1,16 @@
 import type { ModuloArgs_Init } from "../args/index.ts";
 import { create_config_file } from "../initiator/create-config-file.ts";
 import { modify_scripts } from "../initiator/modify-scripts.ts";
+import { create_project } from "../initiator/create-project.ts";
 
 export function init_tool(args: ModuloArgs_Init) {
-  if (args.target === "config") {
-    create_config_file(args);
-  }
-  if (args.target === "script") {
-    modify_scripts();
-  }
+	if (args.target === "config") {
+		create_config_file(args);
+	}
+	if (args.target === "script") {
+		modify_scripts();
+	}
+	if (args.target === "project") {
+		create_project(args);
+	}
 }