@moluoxixi/create-app 2.0.4 → 2.0.403

package/dist/utils/install.js

@@ -2,36 +2,79 @@
  * 依赖安装工具
  * 执行包管理器安装依赖
  */
-import { execSync } from 'node:child_process';
+import { exec } from 'node:child_process';
+import { promisify } from 'node:util';
+import { validatePath } from "./file.js";
+const execAsync = promisify(exec);
+/** 重试延迟基数（毫秒） */
+const RETRY_DELAY_BASE_MS = 1000;
+/**
+ * 验证命令参数安全性
+ * @param packageManager 包管理器类型
+ * @param cwd 工作目录
+ * @throws {Error} 如果参数不安全
+ */
+function validateInstallParams(packageManager, cwd) {
+    // 验证包管理器类型
+    const validPackageManagers = ['pnpm', 'npm', 'yarn'];
+    if (!validPackageManagers.includes(packageManager)) {
+        throw new Error(`不支持的包管理器: ${packageManager}`);
+    }
+    // 验证工作目录路径（防止路径遍历攻击）
+    validatePath(cwd);
+}
 /**
  * 安装依赖
  * @param packageManager 包管理器
  * @param cwd 工作目录
+ * @param retries 重试次数，默认 0（不重试）
+ * @returns Promise<void>
+ * @throws {Error} 如果安装失败
  */
-export function installDependencies(packageManager, cwd) {
+export async function installDependencies(packageManager, cwd, retries = 0) {
+    // 验证参数安全性
+    validateInstallParams(packageManager, cwd);
     const commands = {
         pnpm: 'pnpm install',
         npm: 'npm install',
         yarn: 'yarn install',
     };
     const command = commands[packageManager];
-    execSync(command, {
-        cwd,
-        stdio: 'inherit',
-    });
+    let lastError;
+    for (let attempt = 0; attempt <= retries; attempt++) {
+        try {
+            await execAsync(command, {
+                cwd,
+            });
+            return; // 成功则返回
+        }
+        catch (error) {
+            lastError = error instanceof Error ? error : new Error(String(error));
+            if (attempt < retries) {
+                // 等待后重试（指数退避）
+                await new Promise(resolve => setTimeout(resolve, RETRY_DELAY_BASE_MS * (attempt + 1)));
+            }
+        }
+    }
+    // 所有重试都失败，抛出详细错误
+    throw new Error(`依赖安装失败 (${packageManager}): ${lastError?.message || '未知错误'}\n`
+        + `工作目录: ${cwd}\n`
+        + `命令: ${command}`, { cause: lastError });
 }
 /**
  * 初始化 Git 仓库
  * @param cwd 工作目录
+ * @returns Promise<void>
  */
-export function initGit(cwd) {
+export async function initGit(cwd) {
     try {
-        execSync('git init', { cwd, stdio: 'ignore' });
-        execSync('git add .', { cwd, stdio: 'ignore' });
-        execSync('git commit -m "chore: initial commit"', { cwd, stdio: 'ignore' });
+        // 验证路径安全性
+        validatePath(cwd);
+        await execAsync('git init', { cwd });
+        await execAsync('git add .', { cwd });
+        await execAsync('git commit -m "chore: initial commit"', { cwd });
     }
     catch {
-        // Git 初始化失败不影响项目创建
+        // Git 初始化失败不影响项目创建，静默失败
     }
 }
-//# sourceMappingURL=install.js.map

package/dist/utils/npmConfig.d.ts

@@ -0,0 +1,15 @@
+/**
+ * 读取 npm 配置工具
+ * 用于获取全局配置作为默认值
+ */
+/**
+ * 获取默认作者信息
+ * 优先级：npm init-author-name/email > git user.name/email
+ * @returns 作者字符串，格式：Name <email> 或 Name
+ */
+export declare function getDefaultAuthor(): string;
+/**
+ * 获取默认许可证
+ * @returns 许可证名称，默认为 'MIT'
+ */
+export declare function getDefaultLicense(): string;

package/dist/utils/npmConfig.js

@@ -0,0 +1,79 @@
+/**
+ * 读取 npm 配置工具
+ * 用于获取全局配置作为默认值
+ */
+import { execSync } from 'node:child_process';
+/**
+ * 读取 npm 配置值
+ * @param key 配置键名
+ * @returns 配置值，如果不存在则返回 null
+ */
+function getNpmConfig(key) {
+    try {
+        // 使用 stdio: 'pipe' 并只读取 stdout，忽略 stderr 中的警告
+        const result = execSync(`npm config get ${key}`, {
+            encoding: 'utf-8',
+            stdio: ['ignore', 'pipe', 'ignore'], // stdin: ignore, stdout: pipe, stderr: ignore
+        });
+        const value = result.trim();
+        // npm config get 返回 "undefined" 字符串表示未设置
+        if (value === 'undefined' || value === '') {
+            return null;
+        }
+        return value;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * 读取 Git 配置值
+ * @param key 配置键名
+ * @returns 配置值，如果不存在则返回 null
+ */
+function getGitConfig(key) {
+    try {
+        const value = execSync(`git config --global ${key}`, { encoding: 'utf-8' }).trim();
+        if (value === '') {
+            return null;
+        }
+        return value;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * 获取默认作者信息
+ * 优先级：npm init-author-name/email > git user.name/email
+ * @returns 作者字符串，格式：Name <email> 或 Name
+ */
+export function getDefaultAuthor() {
+    // 优先从 npm 配置读取
+    const npmName = getNpmConfig('init-author-name');
+    const npmEmail = getNpmConfig('init-author-email');
+    const npmUrl = getNpmConfig('init-author-url');
+    // 如果 npm 配置不存在，尝试从 git 配置读取
+    const gitName = npmName || getGitConfig('user.name');
+    const gitEmail = npmEmail || getGitConfig('user.email');
+    // 组合作者信息
+    const parts = [];
+    if (gitName) {
+        parts.push(gitName);
+    }
+    if (gitEmail) {
+        parts.push(`<${gitEmail}>`);
+    }
+    if (npmUrl && !gitEmail) {
+        // 如果有 URL 但没有邮箱，添加 URL
+        parts.push(`(${npmUrl})`);
+    }
+    return parts.join(' ') || '';
+}
+/**
+ * 获取默认许可证
+ * @returns 许可证名称，默认为 'MIT'
+ */
+export function getDefaultLicense() {
+    return getNpmConfig('init-license') || 'MIT';
+}

package/dist/utils/prompts.d.ts

@@ -2,15 +2,16 @@
  * 交互式问答工具
  * 收集用户的项目配置信息（对标 create-vue）
  */
-import type { ProjectConfigType } from '../types';
+import type { ProjectConfigType } from '../types/index.ts';
 /**
  * 收集项目配置信息
  * @param projectName 项目名称（可选）
+ * @returns 项目配置对象
  */
 export declare function collectProjectConfig(projectName?: string): Promise<ProjectConfigType>;
 /**
  * 确认覆盖目录
  * @param dirPath 目录路径
+ * @returns 是否确认覆盖
  */
 export declare function confirmOverwrite(dirPath: string): Promise<boolean>;
-//# sourceMappingURL=prompts.d.ts.map

package/dist/utils/prompts.js

@@ -2,13 +2,18 @@
  * 交互式问答工具
  * 收集用户的项目配置信息（对标 create-vue）
  */
+import fs from 'node:fs';
 import process from 'node:process';
 import inquirer from 'inquirer';
+import { getDefaultAuthor } from "./npmConfig.js";
 /**
  * 收集项目配置信息
  * @param projectName 项目名称（可选）
+ * @returns 项目配置对象
  */
 export async function collectProjectConfig(projectName) {
+    // 获取默认作者信息
+    const defaultAuthor = getDefaultAuthor();
     const answers = await inquirer.prompt([
         // 项目名称
         {
@@ -17,12 +22,53 @@ export async function collectProjectConfig(projectName) {
             message: '项目名称:',
             default: projectName || 'my-project',
             validate: (input) => {
-                if (!input.trim()) {
+                const trimmed = input.trim();
+                if (!trimmed) {
                     return '项目名称不能为空';
                 }
-                if (!/^[\w-]+$/.test(input)) {
+                const minLength = 1;
+                const maxLength = 214;
+                if (trimmed.length < minLength || trimmed.length > maxLength) {
+                    return `项目名称长度必须在 ${minLength}-${maxLength} 个字符之间`;
+                }
+                if (!/^[\w-]+$/.test(trimmed)) {
                     return '项目名称只能包含字母、数字、连字符和下划线';
                 }
+                const reservedNames = [
+                    'node',
+                    'npm',
+                    'test',
+                    'lib',
+                    'api',
+                    'www',
+                    'admin',
+                    'root',
+                    'config',
+                    'build',
+                    'dist',
+                    'src',
+                    'public',
+                    'private',
+                ];
+                if (reservedNames.includes(trimmed.toLowerCase())) {
+                    return `项目名称不能使用保留名称: ${trimmed}`;
+                }
+                // 检查目标目录是否已存在且不为空
+                const targetDir = `${process.cwd()}/${trimmed}`;
+                if (fs.existsSync(targetDir)) {
+                    try {
+                        const stats = fs.statSync(targetDir);
+                        if (stats.isDirectory()) {
+                            const files = fs.readdirSync(targetDir);
+                            if (files.length > 0) {
+                                return `目录 ${targetDir} 已存在且不为空，请选择其他名称或先清空该目录`;
+                            }
+                        }
+                    }
+                    catch {
+                        // 忽略检查错误，让后续流程处理
+                    }
+                }
                 return true;
             },
         },
@@ -38,7 +84,7 @@ export async function collectProjectConfig(projectName) {
             type: 'input',
             name: 'author',
             message: '作者:',
-            default: '',
+            default: defaultAuthor,
         },
         // 框架选择
         {
@@ -130,7 +176,7 @@ export async function collectProjectConfig(projectName) {
             message: '是否启用 Git Hooks (husky + commitlint)?',
             default: true,
         },
-        // 包管理器
+        // 包管理器选择
         {
             type: 'list',
             name: 'packageManager',
@@ -165,6 +211,7 @@ export async function collectProjectConfig(projectName) {
 /**
  * 确认覆盖目录
  * @param dirPath 目录路径
+ * @returns 是否确认覆盖
  */
 export async function confirmOverwrite(dirPath) {
     const { confirm } = await inquirer.prompt([
@@ -177,4 +224,3 @@ export async function confirmOverwrite(dirPath) {
     ]);
     return confirm;
 }
-//# sourceMappingURL=prompts.js.map

package/dist/utils/renderFeatures.d.ts

@@ -2,17 +2,18 @@
  * Features 渲染工具
  * 统一处理 features 的渲染逻辑
  */
-import type { ProjectConfigType } from '../types';
+import type { ProjectConfigType } from '../types/index.ts';
 /**
  * 渲染框架特定的 features
  * @param config 项目配置
  * @param targetDir 目标目录
+ * @throws {Error} 如果路径不安全或模板渲染失败
  */
 export declare function renderFrameworkFeatures(config: ProjectConfigType, targetDir: string): void;
 /**
  * 渲染公共 features
  * @param config 项目配置
  * @param targetDir 目标目录
+ * @throws {Error} 如果路径不安全或模板渲染失败
  */
 export declare function renderCommonFeatures(config: ProjectConfigType, targetDir: string): void;
-//# sourceMappingURL=renderFeatures.d.ts.map

package/dist/utils/renderFeatures.js

@@ -3,25 +3,48 @@
  * 统一处理 features 的渲染逻辑
  */
 import path from 'node:path';
-import { getTemplatesDir } from './file.js';
-import { renderTemplate } from './renderTemplate.js';
+import { getTemplatesDir } from "./file.js";
+import { renderTemplate } from "./renderTemplate.js";
+import { getCommonFeatureMap, getConfigToFeatureMap, getRouteModeFeature, getUILibraryFeature, } from "./featureMapping.js";
+/**
+ * 检查 UI 库是否适用于指定框架
+ * @param framework 框架类型
+ * @param uiLibrary UI 库类型
+ * @returns 是否适用
+ */
+function isUILibrarySupported(framework, uiLibrary) {
+    if (framework === 'vue') {
+        return uiLibrary === 'element-plus' || uiLibrary === 'ant-design-vue';
+    }
+    if (framework === 'react') {
+        return uiLibrary === 'ant-design';
+    }
+    return false;
+}
+/**
+ * 渲染 UI 库特性模板
+ * @param config 项目配置
+ * @param targetDir 目标目录
+ * @param templatesDir 模板目录
+ * @throws {Error} 如果路径不安全或模板渲染失败
+ */
+function renderUILibraryFeature(config, targetDir, templatesDir) {
+    const { framework, uiLibrary } = config;
+    if (isUILibrarySupported(framework, uiLibrary)) {
+        const uiLibraryFeature = getUILibraryFeature(uiLibrary);
+        renderTemplate(path.join(templatesDir, framework, 'features', uiLibraryFeature), targetDir);
+    }
+}
 /**
  * 渲染框架特定的 features
  * @param config 项目配置
  * @param targetDir 目标目录
+ * @throws {Error} 如果路径不安全或模板渲染失败
  */
 export function renderFrameworkFeatures(config, targetDir) {
     const templatesDir = getTemplatesDir();
     const framework = config.framework;
-    // 定义 features 映射：配置项名称 -> feature 目录名称
-    const featureMap = {
-        router: 'router',
-        stateManagement: framework === 'vue' ? 'pinia' : 'zustand',
-        eslint: 'eslint',
-        i18n: 'i18n',
-        sentry: 'sentry',
-        qiankun: 'qiankun',
-    };
+    const featureMap = getConfigToFeatureMap(framework);
     // 统一处理布尔类型的 features
     for (const [configKey, featureName] of Object.entries(featureMap)) {
         if (config[configKey] === true) {
@@ -29,39 +52,21 @@ export function renderFrameworkFeatures(config, targetDir) {
             renderTemplate(featurePath, targetDir);
         }
     }
-    // 特殊处理：路由模式相关的 features
-    if (config.routeMode === 'manual') {
-        renderTemplate(path.join(templatesDir, framework, 'features', 'manualRoutes'), targetDir);
-    }
-    else if (config.routeMode === 'file-system') {
-        renderTemplate(path.join(templatesDir, framework, 'features', 'pageRoutes'), targetDir);
-    }
-    // 特殊处理：UI 库相关的 features
-    if (framework === 'vue') {
-        if (config.uiLibrary === 'element-plus') {
-            renderTemplate(path.join(templatesDir, framework, 'features', 'element-plus'), targetDir);
-        }
-        else if (config.uiLibrary === 'ant-design-vue') {
-            renderTemplate(path.join(templatesDir, framework, 'features', 'ant-design-vue'), targetDir);
-        }
-    }
-    else if (framework === 'react') {
-        if (config.uiLibrary === 'ant-design') {
-            renderTemplate(path.join(templatesDir, framework, 'features', 'ant-design'), targetDir);
-        }
-    }
+    // 路由模式
+    const routeModeFeature = getRouteModeFeature(config.routeMode);
+    renderTemplate(path.join(templatesDir, framework, 'features', routeModeFeature), targetDir);
+    // UI 库
+    renderUILibraryFeature(config, targetDir, templatesDir);
 }
 /**
  * 渲染公共 features
  * @param config 项目配置
  * @param targetDir 目标目录
+ * @throws {Error} 如果路径不安全或模板渲染失败
  */
 export function renderCommonFeatures(config, targetDir) {
     const templatesDir = getTemplatesDir();
-    // 公共 features 映射
-    const commonFeatureMap = {
-        gitHooks: 'husky',
-    };
+    const commonFeatureMap = getCommonFeatureMap();
     for (const [configKey, featureName] of Object.entries(commonFeatureMap)) {
         if (config[configKey] === true) {
             const featurePath = path.join(templatesDir, 'common', 'features', featureName);
@@ -69,4 +74,3 @@ export function renderCommonFeatures(config, targetDir) {
         }
     }
 }
-//# sourceMappingURL=renderFeatures.js.map

package/dist/utils/renderTemplate.d.ts

@@ -1,6 +1,18 @@
 /**
  * 渲染模板到目标目录
  * 支持物理路径合并和配置文件深度合并
+ * @param src 源路径
+ * @param dest 目标路径
+ * @throws {Error} 如果路径不安全、文件操作失败
  */
 export declare function renderTemplate(src: string, dest: string): void;
-//# sourceMappingURL=renderTemplate.d.ts.map
+/**
+ * 更新 package.json 的元数据字段（name, description, author, packageManager）
+ * @param packageJsonPath package.json 文件路径
+ * @param projectName 项目名称
+ * @param description 项目描述
+ * @param author 作者
+ * @param packageManager 包管理器类型
+ * @throws {Error} 如果文件读取失败、JSON 解析失败或写入失败
+ */
+export declare function updatePackageJsonMetadata(packageJsonPath: string, projectName: string, description: string, author: string, packageManager: string): void;