@moluoxixi/create-app 2.0.4 → 2.0.402

package/dist/types/viteConfig.d.ts

@@ -2,16 +2,18 @@
  * Vite 配置数据类型定义
  * 用于 features 中的 vite.config.data.ts
  */
+/**
+ * Vite 配置数据接口
+ */
 export interface ViteConfigData {
-    /** 导入语句 */
+    /** 导入语句字符串数组（完整的 import 语句） */
     imports?: string[];
-    /** ViteConfig 选项 */
-    options?: Record<string, unknown>;
-    /** 插件配置 */
+    /** 插件初始化字符串数组 */
     plugins?: string[];
-    /** CSS 配置 */
-    css?: {
-        additionalData?: string;
-    };
+    /** 纯 JSON 数据配置（包含 server, build, resolve 等静态配置） */
+    config?: Record<string, unknown>;
+    /** ViteConfig 顶层选项（如 pageRoutes） */
+    options?: Record<string, unknown>;
+    /** 函数逻辑分片映射，Key 为配置项的深度访问路径（如 'css.preprocessorOptions.scss.additionalData'） */
+    hooks?: Record<string, string>;
 }
-//# sourceMappingURL=viteConfig.d.ts.map

package/dist/types/viteConfig.js

@@ -3,4 +3,3 @@
  * 用于 features 中的 vite.config.data.ts
  */
 export {};
-//# sourceMappingURL=viteConfig.js.map

package/dist/utils/deepMerge.d.ts

@@ -3,6 +3,8 @@
  * - 对象会递归合并
  * - 数组会合并并去重
  * - 基本类型后者覆盖前者
+ * @param target 目标对象
+ * @param source 源对象
+ * @returns 合并后的对象
  */
 export declare function deepMerge<T extends Record<string, unknown>>(target: T, source: Partial<T>): T;
-//# sourceMappingURL=deepMerge.d.ts.map

package/dist/utils/deepMerge.js

@@ -3,6 +3,9 @@
  * - 对象会递归合并
  * - 数组会合并并去重
  * - 基本类型后者覆盖前者
+ * @param target 目标对象
+ * @param source 源对象
+ * @returns 合并后的对象
  */
 export function deepMerge(target, source) {
     const result = { ...target };
@@ -27,7 +30,11 @@ export function deepMerge(target, source) {
     }
     return result;
 }
+/**
+ * 判断值是否为对象（非数组、非 null）
+ * @param val 待判断的值
+ * @returns 是否为对象
+ */
 function isObject(val) {
     return val !== null && typeof val === 'object' && !Array.isArray(val);
 }
-//# sourceMappingURL=deepMerge.js.map

package/dist/utils/ejs.d.ts

@@ -1,12 +1,13 @@
 /**
  * EJS 模板渲染工具
  */
-import type { EjsDataType } from '../types';
+import type { EjsDataType } from '../types/index.ts';
 /**
  * 渲染 EJS 模板文件
  * @param templatePath 模板文件路径
  * @param data 模板数据
  * @returns 渲染后的字符串内容
+ * @throws {Error} 如果模板文件不存在或渲染失败
  */
 export declare function renderEjsFile(templatePath: string, data: EjsDataType): string;
 /**
@@ -14,6 +15,6 @@ export declare function renderEjsFile(templatePath: string, data: EjsDataType):
  * @param templatePath 模板文件路径
  * @param targetPath 目标文件路径
  * @param data 模板数据
+ * @throws {Error} 如果模板文件不存在、渲染失败或写入失败
  */
 export declare function renderEjsToFile(templatePath: string, targetPath: string, data: EjsDataType): void;
-//# sourceMappingURL=ejs.d.ts.map

package/dist/utils/ejs.js

@@ -9,6 +9,7 @@ import ejs from 'ejs';
  * @param templatePath 模板文件路径
  * @param data 模板数据
  * @returns 渲染后的字符串内容
+ * @throws {Error} 如果模板文件不存在或渲染失败
  */
 export function renderEjsFile(templatePath, data) {
     const template = fs.readFileSync(templatePath, 'utf-8');
@@ -21,10 +22,10 @@ export function renderEjsFile(templatePath, data) {
  * @param templatePath 模板文件路径
  * @param targetPath 目标文件路径
  * @param data 模板数据
+ * @throws {Error} 如果模板文件不存在、渲染失败或写入失败
  */
 export function renderEjsToFile(templatePath, targetPath, data) {
     const content = renderEjsFile(templatePath, data);
     fs.mkdirSync(path.dirname(targetPath), { recursive: true });
     fs.writeFileSync(targetPath, content);
 }
-//# sourceMappingURL=ejs.js.map

package/dist/utils/featureMapping.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Features 映射工具
+ * 统一管理配置项到 feature 目录的映射关系
+ */
+import type { FrameworkType } from '../types/index.ts';
+/**
+ * 扫描所有 features（框架的 + 公共的）
+ * @param framework 框架类型
+ * @returns 所有 feature 名称数组（UI 库按优先级排序）
+ */
+export declare function scanAllFeatures(framework: FrameworkType): string[];
+/**
+ * 配置项到 feature 目录的映射（从 renderFeatures 提取）
+ * @param framework 框架类型
+ * @returns 配置键到 feature 名称的映射对象
+ */
+export declare function getConfigToFeatureMap(framework: FrameworkType): Record<string, string>;
+/**
+ * 公共 features 映射
+ * @returns 公共配置键到 feature 名称的映射对象
+ */
+export declare function getCommonFeatureMap(): Record<string, string>;
+/**
+ * 路由模式映射
+ * @param routeMode 路由模式（'manual' 或 'file-system'）
+ * @returns feature 名称
+ */
+export declare function getRouteModeFeature(routeMode: string): string;
+/**
+ * UI 库映射
+ * @param uiLibrary UI 库名称
+ * @returns feature 名称（通常与 UI 库名称相同）
+ */
+export declare function getUILibraryFeature(uiLibrary: string): string;
+/**
+ * Feature 名称转换为配置键和值（用于测试用例生成）
+ * @param feature feature 名称
+ * @param framework 框架类型
+ * @returns 配置键值对，如果无法映射则返回 null
+ */
+export declare function featureToConfig(feature: string, framework: FrameworkType): {
+    key: string;
+    value: string | boolean;
+} | null;

package/dist/utils/featureMapping.js

@@ -0,0 +1,119 @@
+/**
+ * Features 映射工具
+ * 统一管理配置项到 feature 目录的映射关系
+ */
+import fs from 'fs-extra';
+import path from 'node:path';
+import { getTemplatesDir } from "./file.js";
+/**
+ * UI 库优先级顺序（用于排序，确保默认选择）
+ */
+const UI_LIBRARY_PRIORITY = {
+    'element-plus': 1,
+    'ant-design-vue': 2,
+    'ant-design': 1,
+};
+/**
+ * 扫描所有 features（框架的 + 公共的）
+ * @param framework 框架类型
+ * @returns 所有 feature 名称数组（UI 库按优先级排序）
+ */
+export function scanAllFeatures(framework) {
+    const frameworkDir = path.join(getTemplatesDir(), framework, 'features');
+    const commonDir = path.join(getTemplatesDir(), 'common', 'features');
+    const features = [];
+    if (fs.existsSync(frameworkDir)) {
+        features.push(...fs.readdirSync(frameworkDir).filter(f => fs.statSync(path.join(frameworkDir, f)).isDirectory()));
+    }
+    if (fs.existsSync(commonDir)) {
+        features.push(...fs.readdirSync(commonDir).filter(f => fs.statSync(path.join(commonDir, f)).isDirectory()));
+    }
+    // 对 UI 库进行排序，确保 element-plus 优先（优先级数字越小越靠前）
+    return features.sort((a, b) => {
+        const priorityA = UI_LIBRARY_PRIORITY[a] ?? 999;
+        const priorityB = UI_LIBRARY_PRIORITY[b] ?? 999;
+        if (priorityA !== priorityB) {
+            return priorityA - priorityB;
+        }
+        // 相同优先级时保持字母顺序
+        return a.localeCompare(b);
+    });
+}
+/**
+ * 配置项到 feature 目录的映射（从 renderFeatures 提取）
+ * @param framework 框架类型
+ * @returns 配置键到 feature 名称的映射对象
+ */
+export function getConfigToFeatureMap(framework) {
+    return {
+        router: 'router',
+        stateManagement: framework === 'vue' ? 'pinia' : 'zustand',
+        eslint: 'eslint',
+        i18n: 'i18n',
+        sentry: 'sentry',
+        qiankun: 'qiankun',
+    };
+}
+/**
+ * 公共 features 映射
+ * @returns 公共配置键到 feature 名称的映射对象
+ */
+export function getCommonFeatureMap() {
+    return {
+        gitHooks: 'husky',
+    };
+}
+/**
+ * 路由模式映射
+ * @param routeMode 路由模式（'manual' 或 'file-system'）
+ * @returns feature 名称
+ */
+export function getRouteModeFeature(routeMode) {
+    return routeMode === 'manual' ? 'manualRoutes' : 'pageRoutes';
+}
+/**
+ * UI 库映射
+ * @param uiLibrary UI 库名称
+ * @returns feature 名称（通常与 UI 库名称相同）
+ */
+export function getUILibraryFeature(uiLibrary) {
+    return uiLibrary;
+}
+/**
+ * Feature 名称转换为配置键和值（用于测试用例生成）
+ * @param feature feature 名称
+ * @param framework 框架类型
+ * @returns 配置键值对，如果无法映射则返回 null
+ */
+export function featureToConfig(feature, framework) {
+    // 路由模式
+    if (feature === 'manualRoutes')
+        return { key: 'routeMode', value: 'manual' };
+    if (feature === 'pageRoutes')
+        return { key: 'routeMode', value: 'file-system' };
+    // UI 库
+    const uiLibraries = ['element-plus', 'ant-design-vue', 'ant-design'];
+    if (uiLibraries.includes(feature))
+        return { key: 'uiLibrary', value: feature };
+    // 状态管理（反向映射）
+    const stateManagementMap = {
+        pinia: 'stateManagement',
+        zustand: 'stateManagement',
+    };
+    if (stateManagementMap[feature])
+        return { key: stateManagementMap[feature], value: true };
+    // Git Hooks（公共 feature）
+    if (feature === 'husky')
+        return { key: 'gitHooks', value: true };
+    // 其他布尔 features（通过映射查找）
+    const configMap = getConfigToFeatureMap(framework);
+    const configKey = Object.keys(configMap).find(key => configMap[key] === feature);
+    if (configKey)
+        return { key: configKey, value: true };
+    // 公共 features
+    const commonMap = getCommonFeatureMap();
+    const commonKey = Object.keys(commonMap).find(key => commonMap[key] === feature);
+    if (commonKey)
+        return { key: commonKey, value: true };
+    return null;
+}

package/dist/utils/file.d.ts

@@ -2,69 +2,89 @@
  * 文件操作工具
  * 文件和目录操作相关函数
  */
+/**
+ * 验证路径安全性，防止路径遍历攻击
+ * @param filePath 文件路径
+ * @param baseDir 基础目录（可选，用于限制路径范围）
+ * @throws {Error} 如果路径不安全
+ */
+export declare function validatePath(filePath: string, baseDir?: string): void;
 /**
  * 创建目录
  * @param dirPath 目录路径
+ * @throws {Error} 如果目录创建失败
  */
 export declare function createDir(dirPath: string): void;
 /**
  * 清空并重新创建目录
  * @param dirPath 目录路径
+ * @throws {Error} 如果目录操作失败
  */
 export declare function emptyDir(dirPath: string): void;
 /**
  * 检查路径是否存在
  * @param filePath 文件路径
+ * @returns 路径是否存在
  */
 export declare function pathExists(filePath: string): boolean;
 /**
  * 复制文件
  * @param src 源文件路径
  * @param dest 目标文件路径
+ * @throws {Error} 如果文件复制失败
  */
 export declare function copyFile(src: string, dest: string): void;
 /**
  * 复制目录
  * @param src 源目录路径
  * @param dest 目标目录路径
+ * @throws {Error} 如果目录复制失败
  */
 export declare function copyDir(src: string, dest: string): void;
 /**
  * 写入文件
  * @param filePath 文件路径
  * @param content 文件内容
+ * @throws {Error} 如果文件写入失败
  */
 export declare function writeFile(filePath: string, content: string): void;
 /**
  * 读取文件
  * @param filePath 文件路径
+ * @returns 文件内容
+ * @throws {Error} 如果文件不存在或读取失败
  */
 export declare function readFile(filePath: string): string;
 /**
  * 读取 JSON 文件
  * @param filePath 文件路径
+ * @returns 解析后的 JSON 对象
+ * @throws {Error} 如果文件不存在、读取失败或 JSON 解析失败
  */
 export declare function readJsonFile<T = Record<string, unknown>>(filePath: string): T;
 /**
  * 写入 JSON 文件
  * @param filePath 文件路径
  * @param data 数据
+ * @throws {Error} 如果文件写入失败
  */
 export declare function writeJsonFile(filePath: string, data: unknown): void;
 /**
  * 获取目录下所有文件
  * @param dirPath 目录路径
- * @param recursive 是否递归
+ * @param recursive 是否递归，默认为 true
+ * @returns 文件路径数组
  */
 export declare function getFiles(dirPath: string, recursive?: boolean): string[];
 /**
  * 获取模板目录路径
+ * @returns 模板目录的绝对路径
  */
 export declare function getTemplatesDir(): string;
 /**
  * 获取相对路径
  * @param from 起始路径
  * @param to 目标路径
+ * @returns 相对路径字符串
  */
 export declare function getRelativePath(from: string, to: string): string;
-//# sourceMappingURL=file.d.ts.map

package/dist/utils/file.js

@@ -5,11 +5,32 @@
 import path from 'node:path';
 import { fileURLToPath } from 'node:url';
 import fs from 'fs-extra';
+/**
+ * 验证路径安全性，防止路径遍历攻击
+ * @param filePath 文件路径
+ * @param baseDir 基础目录（可选，用于限制路径范围）
+ * @throws {Error} 如果路径不安全
+ */
+export function validatePath(filePath, baseDir) {
+    // 检查路径遍历攻击（.. 和 ~）
+    if (filePath.includes('..') || filePath.includes('~')) {
+        throw new Error(`不安全的路径: ${filePath}`);
+    }
+    // 如果提供了基础目录，确保路径在基础目录内
+    if (baseDir) {
+        const resolvedPath = path.resolve(filePath);
+        const resolvedBase = path.resolve(baseDir);
+        if (!resolvedPath.startsWith(resolvedBase)) {
+            throw new Error(`路径超出允许范围: ${filePath}`);
+        }
+    }
+}
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = path.dirname(__filename);
 /**
  * 创建目录
  * @param dirPath 目录路径
+ * @throws {Error} 如果目录创建失败
  */
 export function createDir(dirPath) {
     fs.ensureDirSync(dirPath);
@@ -17,6 +38,7 @@ export function createDir(dirPath) {
 /**
  * 清空并重新创建目录
  * @param dirPath 目录路径
+ * @throws {Error} 如果目录操作失败
  */
 export function emptyDir(dirPath) {
     fs.emptyDirSync(dirPath);
@@ -24,6 +46,7 @@ export function emptyDir(dirPath) {
 /**
  * 检查路径是否存在
  * @param filePath 文件路径
+ * @returns 路径是否存在
  */
 export function pathExists(filePath) {
     return fs.existsSync(filePath);
@@ -32,6 +55,7 @@ export function pathExists(filePath) {
  * 复制文件
  * @param src 源文件路径
  * @param dest 目标文件路径
+ * @throws {Error} 如果文件复制失败
  */
 export function copyFile(src, dest) {
     fs.ensureDirSync(path.dirname(dest));
@@ -41,6 +65,7 @@ export function copyFile(src, dest) {
  * 复制目录
  * @param src 源目录路径
  * @param dest 目标目录路径
+ * @throws {Error} 如果目录复制失败
  */
 export function copyDir(src, dest) {
     fs.copySync(src, dest);
@@ -49,6 +74,7 @@ export function copyDir(src, dest) {
  * 写入文件
  * @param filePath 文件路径
  * @param content 文件内容
+ * @throws {Error} 如果文件写入失败
  */
 export function writeFile(filePath, content) {
     fs.ensureDirSync(path.dirname(filePath));
@@ -57,6 +83,8 @@ export function writeFile(filePath, content) {
 /**
  * 读取文件
  * @param filePath 文件路径
+ * @returns 文件内容
+ * @throws {Error} 如果文件不存在或读取失败
  */
 export function readFile(filePath) {
     return fs.readFileSync(filePath, 'utf-8');
@@ -64,6 +92,8 @@ export function readFile(filePath) {
 /**
  * 读取 JSON 文件
  * @param filePath 文件路径
+ * @returns 解析后的 JSON 对象
+ * @throws {Error} 如果文件不存在、读取失败或 JSON 解析失败
  */
 export function readJsonFile(filePath) {
     return fs.readJsonSync(filePath);
@@ -72,6 +102,7 @@ export function readJsonFile(filePath) {
  * 写入 JSON 文件
  * @param filePath 文件路径
  * @param data 数据
+ * @throws {Error} 如果文件写入失败
  */
 export function writeJsonFile(filePath, data) {
     fs.ensureDirSync(path.dirname(filePath));
@@ -80,7 +111,8 @@ export function writeJsonFile(filePath, data) {
 /**
  * 获取目录下所有文件
  * @param dirPath 目录路径
- * @param recursive 是否递归
+ * @param recursive 是否递归，默认为 true
+ * @returns 文件路径数组
  */
 export function getFiles(dirPath, recursive = true) {
     const files = [];
@@ -104,6 +136,7 @@ export function getFiles(dirPath, recursive = true) {
 }
 /**
  * 获取模板目录路径
+ * @returns 模板目录的绝对路径
  */
 export function getTemplatesDir() {
     return path.resolve(__dirname, '../../templates');
@@ -112,8 +145,8 @@ export function getTemplatesDir() {
  * 获取相对路径
  * @param from 起始路径
  * @param to 目标路径
+ * @returns 相对路径字符串
  */
 export function getRelativePath(from, to) {
     return path.relative(from, to);
 }
-//# sourceMappingURL=file.js.map

package/dist/utils/generateFrameworkProject.d.ts

@@ -0,0 +1,27 @@
+/**
+ * 框架项目生成通用工具
+ * 抽离 react.ts 和 vue.ts 的公共逻辑
+ */
+import type { ProjectConfigType } from '../types/index.ts';
+/**
+ * EJS 模板配置接口
+ * 定义框架项目生成所需的模板路径配置
+ */
+interface EjsTemplateConfig {
+    /** 主入口文件模板路径（相对于框架 base 目录） */
+    mainTemplate: string;
+    /** 主入口文件输出路径（相对于目标目录） */
+    mainOutput: string;
+    /** 路由文件模板路径（相对于框架 base 目录） */
+    routerTemplate: string;
+    /** 路由文件输出路径（相对于目标目录） */
+    routerOutput: string;
+}
+/**
+ * 生成框架项目的通用函数
+ * @param config 项目配置
+ * @param ejsConfig EJS 模板配置
+ * @throws {Error} 如果模板渲染失败、文件写入失败或配置生成失败
+ */
+export declare function generateFrameworkProject(config: ProjectConfigType, ejsConfig: EjsTemplateConfig): void;
+export {};

package/dist/utils/generateFrameworkProject.js

@@ -0,0 +1,47 @@
+/**
+ * 框架项目生成通用工具
+ * 抽离 react.ts 和 vue.ts 的公共逻辑
+ */
+import path from 'node:path';
+import { FILE_CONSTANTS } from "../constants/index.js";
+import { renderEjsToFile } from "./ejs.js";
+import { getTemplatesDir } from "./file.js";
+import { renderCommonFeatures, renderFrameworkFeatures } from "./renderFeatures.js";
+import { renderTemplate, updatePackageJsonMetadata } from "./index.js";
+import { getViteConfigEjsData } from "./viteConfigRender.js";
+/**
+ * 生成框架项目的通用函数
+ * @param config 项目配置
+ * @param ejsConfig EJS 模板配置
+ * @throws {Error} 如果模板渲染失败、文件写入失败或配置生成失败
+ */
+export function generateFrameworkProject(config, ejsConfig) {
+    const { targetDir, framework } = config;
+    const templatesDir = getTemplatesDir();
+    // 1. 渲染 L0 公共基础模板
+    renderTemplate(path.join(templatesDir, 'common', 'base'), targetDir);
+    // 2. 渲染公共特性模板
+    renderCommonFeatures(config, targetDir);
+    // 3. 渲染 L1 框架基础模板
+    renderTemplate(path.join(templatesDir, framework, 'base'), targetDir);
+    // 4. 渲染 L2 特性模板（统一处理）
+    renderFrameworkFeatures(config, targetDir);
+    // 5. 渲染 EJS 模板
+    const ejsData = {
+        i18n: config.i18n,
+        sentry: config.sentry,
+        qiankun: config.qiankun,
+        routeMode: config.routeMode,
+        uiLibrary: config.uiLibrary,
+    };
+    const frameworkBasePath = path.join(templatesDir, framework, 'base');
+    renderEjsToFile(path.join(frameworkBasePath, ejsConfig.mainTemplate), path.join(targetDir, ejsConfig.mainOutput), ejsData);
+    renderEjsToFile(path.join(frameworkBasePath, ejsConfig.routerTemplate), path.join(targetDir, ejsConfig.routerOutput), ejsData);
+    // 6. 数据驱动生成 vite.config.ts（使用 EJS 模板）
+    const viteConfigEjsData = getViteConfigEjsData(config);
+    const commonBasePath = path.join(templatesDir, 'common', 'base');
+    renderEjsToFile(path.join(commonBasePath, 'vite.config.ts.ejs'), path.join(targetDir, 'vite.config.ts'), viteConfigEjsData);
+    // 7. 更新 package.json 的元数据字段
+    const packageJsonPath = path.join(targetDir, FILE_CONSTANTS.PACKAGE_JSON);
+    updatePackageJsonMetadata(packageJsonPath, config.projectName, config.description, config.author, config.packageManager);
+}

package/dist/utils/index.d.ts

@@ -1,12 +1,14 @@
 /**
  * 工具函数导出
  */
-export * from './deepMerge';
-export * from './ejs';
-export * from './file';
-export * from './install';
-export * from './prompts';
-export * from './renderTemplate';
-export * from './sortDependencies';
-export * from './viteConfigRender';
-//# sourceMappingURL=index.d.ts.map
+export * from './deepMerge.ts';
+export * from './ejs.ts';
+export * from './file.ts';
+export * from './generateFrameworkProject.ts';
+export * from './install.ts';
+export * from './npmConfig.ts';
+export * from './prompts.ts';
+export { updatePackageJsonMetadata } from './renderTemplate.ts';
+export * from './renderTemplate.ts';
+export * from './sortDependencies.ts';
+export * from './viteConfigRender.ts';

package/dist/utils/index.js

@@ -1,12 +1,14 @@
 /**
  * 工具函数导出
  */
-export * from './deepMerge.js';
-export * from './ejs.js';
-export * from './file.js';
-export * from './install.js';
-export * from './prompts.js';
-export * from './renderTemplate.js';
-export * from './sortDependencies.js';
-export * from './viteConfigRender.js';
-//# sourceMappingURL=index.js.map
+export * from "./deepMerge.js";
+export * from "./ejs.js";
+export * from "./file.js";
+export * from "./generateFrameworkProject.js";
+export * from "./install.js";
+export * from "./npmConfig.js";
+export * from "./prompts.js";
+export { updatePackageJsonMetadata } from "./renderTemplate.js";
+export * from "./renderTemplate.js";
+export * from "./sortDependencies.js";
+export * from "./viteConfigRender.js";

package/dist/utils/install.d.ts

@@ -2,16 +2,19 @@
  * 依赖安装工具
  * 执行包管理器安装依赖
  */
-import type { PackageManagerType } from '../types';
+import type { PackageManagerType } from '../types/index.ts';
 /**
  * 安装依赖
  * @param packageManager 包管理器
  * @param cwd 工作目录
+ * @param retries 重试次数，默认 0（不重试）
+ * @returns Promise<void>
+ * @throws {Error} 如果安装失败
  */
-export declare function installDependencies(packageManager: PackageManagerType, cwd: string): void;
+export declare function installDependencies(packageManager: PackageManagerType, cwd: string, retries?: number): Promise<void>;
 /**
  * 初始化 Git 仓库
  * @param cwd 工作目录
+ * @returns Promise<void>
  */
-export declare function initGit(cwd: string): void;
-//# sourceMappingURL=install.d.ts.map
+export declare function initGit(cwd: string): Promise<void>;