@moluoxixi/create-app 2.0.431 → 2.0.433

package/dist/types/viteConfig.d.ts

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

package/dist/types/viteConfig.js

@@ -1,5 +0,0 @@
-/**
- * Vite 配置数据类型定义
- * 用于 features 中的 vite.config.data.ts
- */
-export {};

package/dist/utils/ejs.d.ts

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

package/dist/utils/ejs.js

@@ -1,31 +0,0 @@
-/**
- * EJS 模板渲染工具
- */
-import fs from 'node:fs';
-import path from 'node:path';
-import ejs from 'ejs';
-/**
- * 渲染 EJS 模板文件
- * @param templatePath 模板文件路径
- * @param data 模板数据
- * @returns 渲染后的字符串内容
- * @throws {Error} 如果模板文件不存在或渲染失败
- */
-export function renderEjsFile(templatePath, data) {
-    const template = fs.readFileSync(templatePath, 'utf-8');
-    return ejs.render(template, data, {
-        filename: templatePath,
-    });
-}
-/**
- * 渲染 EJS 模板并写入目标文件
- * @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);
-}

package/dist/utils/featureMapping.d.ts

@@ -1,23 +0,0 @@
-/**
- * Features 映射工具
- * 用于测试用例生成和 feature 扫描
- * 注意：配置名称与 feature 目录名称完全一致，无需额外映射
- */
-import type { FrameworkType } from '../types/index.ts';
-/**
- * 扫描所有 features（框架的 + 公共的）
- * @param framework 框架类型
- * @returns 所有 feature 名称数组（UI 库按优先级排序）
- */
-export declare function scanAllFeatures(framework: FrameworkType): string[];
-/**
- * Feature 名称转换为配置键和值（用于测试用例生成）
- * 注意：大部分情况下 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

@@ -1,76 +0,0 @@
-/**
- * Features 映射工具
- * 用于测试用例生成和 feature 扫描
- * 注意：配置名称与 feature 目录名称完全一致，无需额外映射
- */
-import fs from 'fs-extra';
-import path from 'node:path';
-import { getTemplatesDir } from "./file.js";
-/**
- * UI 库优先级顺序（用于排序，确保默认选择）
- * TODO: ant-design-vue 和 ant-design (React) 功能暂时关闭
- */
-const UI_LIBRARY_PRIORITY = {
-    'element-plus': 1,
-    // 'ant-design-vue': 2,  // TODO: 暂时关闭
-    // 'ant-design': 1,      // TODO: 暂时关闭 (React)
-};
-/**
- * 扫描所有 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 名称转换为配置键和值（用于测试用例生成）
- * 注意：大部分情况下 feature 名称 === 配置名称
- * @param feature feature 名称
- * @param _framework 框架类型（保留参数以保持接口兼容性）
- * @returns 配置键值对，如果无法映射则返回 null
- */
-export function featureToConfig(feature, _framework) {
-    // UI 库：配置键是 uiLibrary，值是 feature 名称
-    // TODO: ant-design-vue 和 ant-design (React) 功能暂时关闭
-    // const uiLibraries = ['element-plus', 'ant-design-vue', 'ant-design']
-    const uiLibraries = ['element-plus'];
-    if (uiLibraries.includes(feature)) {
-        return { key: 'uiLibrary', value: feature };
-    }
-    // 路由模式 features：用于测试分类
-    if (feature === 'manualRoutes' || feature === 'pageRoutes') {
-        return { key: 'routeMode', value: feature };
-    }
-    // 布尔类型的 features：配置名 === feature 名
-    const booleanFeatures = [
-        'eslint',
-        'i18n',
-        'sentry',
-        'pinia',
-        'zustand',
-        'husky',
-    ];
-    if (booleanFeatures.includes(feature)) {
-        return { key: feature, value: true };
-    }
-    return null;
-}

package/dist/utils/generateFrameworkProject.d.ts

@@ -1,15 +0,0 @@
-/**
- * Framework project generation utility
- * Extract common logic from react.ts and vue.ts
- * Support three-layer nested priority (L1: common, L2: framework, L3: micro-frontend)
- * No longer uses EJS templates - all templates are fixed TypeScript files
- */
-import type { ProjectConfigType } from '../types/index.ts';
-/**
- * Generate framework project
- * Render templates in three-layer nested priority: L1 (common) -> L2 (framework) -> L3 (micro-frontend)
- * Uses fixed TypeScript templates with glob import for feature discovery
- * @param config - Project configuration
- * @throws {Error} If template rendering fails, file writing fails, or configuration generation fails
- */
-export declare function generateFrameworkProject(config: ProjectConfigType): void;

package/dist/utils/generateFrameworkProject.js

@@ -1,67 +0,0 @@
-/**
- * Framework project generation utility
- * Extract common logic from react.ts and vue.ts
- * Support three-layer nested priority (L1: common, L2: framework, L3: micro-frontend)
- * No longer uses EJS templates - all templates are fixed TypeScript files
- */
-import path from 'node:path';
-import { FILE_CONSTANTS } from "../constants/index.js";
-import { getTemplatesDir } from "./file.js";
-import { renderCommonFeatures, renderFrameworkFeatures, renderMicroFrontendFeatures } from "./renderFeatures.js";
-import { renderTemplate, updatePackageJsonMetadata } from "./index.js";
-/**
- * Render all base templates
- * Render in three-layer nested priority: L1 (common) -> L2 (framework) -> L3 (micro-frontend)
- * @param templatesDir - Templates root directory
- * @param framework - Framework type
- * @param microFrontend - Whether micro-frontend is enabled
- * @param microFrontendEngine - Micro-frontend engine type
- * @param targetDir - Target directory
- * @throws {Error} If template rendering fails
- */
-function renderBaseTemplates(templatesDir, framework, microFrontend, microFrontendEngine, targetDir) {
-    // 1. Render L1: Common base template (universal layer)
-    renderTemplate(path.join(templatesDir, 'common', 'base'), targetDir);
-    // 2. Render L2: Framework base template (framework standard layer)
-    renderTemplate(path.join(templatesDir, framework, 'base'), targetDir);
-    // 3. Render L3: Micro-frontend base template (architecture enhancement layer) - on-demand override
-    if (microFrontend && microFrontendEngine) {
-        const microFrontendPath = path.join(templatesDir, framework, 'micro-frontends', microFrontendEngine, 'base');
-        renderTemplate(microFrontendPath, targetDir);
-    }
-}
-/**
- * Render all feature templates
- * Render in three-layer nested priority: common features -> framework features -> micro-frontend features
- * @param config - Project configuration
- * @param targetDir - Target directory
- * @throws {Error} If feature rendering fails
- */
-function renderAllFeatures(config, targetDir) {
-    // 1. Render common feature templates
-    renderCommonFeatures(config, targetDir);
-    // 2. Render framework feature templates
-    renderFrameworkFeatures(config, targetDir);
-    // 3. Render micro-frontend specific features (override standard features)
-    if (config.microFrontend && config.microFrontendEngine) {
-        renderMicroFrontendFeatures(config, targetDir, config.microFrontendEngine);
-    }
-}
-/**
- * Generate framework project
- * Render templates in three-layer nested priority: L1 (common) -> L2 (framework) -> L3 (micro-frontend)
- * Uses fixed TypeScript templates with glob import for feature discovery
- * @param config - Project configuration
- * @throws {Error} If template rendering fails, file writing fails, or configuration generation fails
- */
-export function generateFrameworkProject(config) {
-    const { targetDir, framework, microFrontend, microFrontendEngine } = config;
-    const templatesDir = getTemplatesDir();
-    // 1. Render all base templates
-    renderBaseTemplates(templatesDir, framework, microFrontend, microFrontendEngine, targetDir);
-    // 2. Render all feature templates
-    renderAllFeatures(config, targetDir);
-    // 3. Update package.json metadata fields
-    const packageJsonPath = path.join(targetDir, FILE_CONSTANTS.PACKAGE_JSON);
-    updatePackageJsonMetadata(packageJsonPath, config.projectName, config.description, config.author, config.packageManager);
-}

package/dist/utils/prompts.d.ts

@@ -1,17 +0,0 @@
-/**
- * 交互式问答工具
- * 收集用户的项目配置信息（对标 create-vue）
- */
-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>;

package/dist/utils/prompts.js

@@ -1,235 +0,0 @@
-/**
- * 交互式问答工具
- * 收集用户的项目配置信息（对标 create-vue）
- */
-import fs from 'node:fs';
-import process from 'node:process';
-import inquirer from 'inquirer';
-import { getDefaultAuthor } from "./npmConfig.js";
-import { getRouteModeFeatures } from "./routeModeMapping.js";
-/**
- * 收集项目配置信息
- * @param projectName 项目名称（可选）
- * @returns 项目配置对象
- */
-export async function collectProjectConfig(projectName) {
-    // 获取默认作者信息
-    const defaultAuthor = getDefaultAuthor();
-    const answers = await inquirer.prompt([
-        // 项目名称
-        {
-            type: 'input',
-            name: 'projectName',
-            message: '项目名称:',
-            default: projectName || 'my-project',
-            validate: (input) => {
-                const trimmed = input.trim();
-                if (!trimmed) {
-                    return '项目名称不能为空';
-                }
-                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;
-            },
-        },
-        // 项目描述
-        {
-            type: 'input',
-            name: 'description',
-            message: '项目描述:',
-            default: 'A Vite project',
-        },
-        // 作者
-        {
-            type: 'input',
-            name: 'author',
-            message: '作者:',
-            default: defaultAuthor,
-        },
-        // 框架选择
-        {
-            type: 'list',
-            name: 'framework',
-            message: '选择框架:',
-            choices: [
-                { name: 'Vue 3', value: 'vue' },
-                // TODO: React 功能暂时关闭
-                // { name: 'React', value: 'react' },
-            ],
-        },
-        // UI 库选择
-        {
-            type: 'list',
-            name: 'uiLibrary',
-            message: '选择 UI 组件库:',
-            choices: (answers) => {
-                if (answers.framework === 'vue') {
-                    return [
-                        { name: 'Element Plus', value: 'element-plus' },
-                        // TODO: Ant Design Vue 功能暂时关闭
-                        // { name: 'Ant Design Vue', value: 'ant-design-vue' },
-                    ];
-                }
-                else {
-                    // TODO: React 功能暂时关闭
-                    // return [{ name: 'Ant Design', value: 'ant-design' }]
-                    return [];
-                }
-            },
-        },
-        // 路由模式（路由已内置，只需选择模式）
-        {
-            type: 'list',
-            name: 'routeMode',
-            message: '选择路由模式:',
-            choices: [
-                { name: '文件系统路由 (vite-plugin-pages)', value: 'pageRoutes' },
-                { name: '手动配置路由', value: 'manualRoutes' },
-            ],
-        },
-        // 是否启用国际化
-        {
-            type: 'confirm',
-            name: 'i18n',
-            message: '是否启用国际化 (i18n)?',
-            default: true,
-        },
-        // 是否启用微前端
-        {
-            type: 'confirm',
-            name: 'microFrontend',
-            message: '是否启用微前端支持?',
-            default: false,
-        },
-        // 微前端引擎选择
-        {
-            type: 'list',
-            name: 'microFrontendEngine',
-            message: '选择微前端引擎:',
-            choices: [
-                { name: 'qiankun (阿里开源)', value: 'qiankun' },
-                // TODO: 还没有,后续可考虑接入
-                // { name: 'micro-app (京东开源)', value: 'micro-app' },
-            ],
-            when: (answers) => answers.microFrontend === true,
-        },
-        // 是否启用错误监控
-        {
-            type: 'confirm',
-            name: 'sentry',
-            message: '是否启用错误监控 (Sentry)?',
-            default: false,
-        },
-        // 是否启用 ESLint
-        {
-            type: 'confirm',
-            name: 'eslint',
-            message: '是否启用 ESLint 代码规范检查?',
-            default: true,
-        },
-        // 是否启用 Git Hooks
-        {
-            type: 'confirm',
-            name: 'gitHooks',
-            message: '是否启用 Git Hooks (husky + commitlint)?',
-            default: true,
-        },
-        // 包管理器选择
-        {
-            type: 'list',
-            name: 'packageManager',
-            message: '选择包管理器:',
-            choices: [
-                { name: 'pnpm (推荐)', value: 'pnpm' },
-                { name: 'npm', value: 'npm' },
-                { name: 'yarn', value: 'yarn' },
-            ],
-            default: 'pnpm',
-        },
-    ]);
-    const targetDir = `${process.cwd()}/${answers.projectName}`;
-    // 根据框架确定状态管理 feature
-    const isPinia = answers.framework === 'vue';
-    const isZustand = answers.framework === 'react';
-    // 根据路由模式获取对应的布尔特征配置
-    const routeMode = answers.routeMode;
-    const routeModeFeatures = getRouteModeFeatures(routeMode);
-    return {
-        projectName: answers.projectName,
-        description: answers.description,
-        author: answers.author,
-        framework: answers.framework,
-        uiLibrary: answers.uiLibrary,
-        routeMode,
-        // feature 名称与目录名称一致
-        pinia: isPinia,
-        zustand: isZustand,
-        manualRoutes: routeModeFeatures.manualRoutes,
-        pageRoutes: routeModeFeatures.pageRoutes,
-        i18n: answers.i18n,
-        microFrontend: answers.microFrontend || false,
-        microFrontendEngine: answers.microFrontendEngine,
-        sentry: answers.sentry,
-        eslint: answers.eslint,
-        husky: answers.gitHooks,
-        packageManager: answers.packageManager,
-        targetDir,
-    };
-}
-/**
- * 确认覆盖目录
- * @param dirPath 目录路径
- * @returns 是否确认覆盖
- */
-export async function confirmOverwrite(dirPath) {
-    const { confirm } = await inquirer.prompt([
-        {
-            type: 'confirm',
-            name: 'confirm',
-            message: `目录 ${dirPath} 已存在，是否覆盖?`,
-            default: false,
-        },
-    ]);
-    return confirm;
-}

package/dist/utils/renderFeatures.d.ts

@@ -1,56 +0,0 @@
-/**
- * Features 渲染工具
- * 统一处理 features 的渲染逻辑
- * 配置名称与 feature 目录名称完全一致，无需映射
- * 通过文件系统扫描自动发现 features，无需维护常量
- */
-import type { FrameworkType, ProjectConfigType } from '../types/index.ts';
-/**
- * 渲染框架特定的 features
- * 通过文件系统扫描自动发现并渲染 features
- * @param config 项目配置
- * @param targetDir 目标目录
- * @throws {Error} 如果路径不安全或模板渲染失败
- */
-export declare function renderFrameworkFeatures(config: ProjectConfigType, targetDir: string): void;
-/**
- * 渲染公共 features
- * 通过文件系统扫描自动发现并渲染公共 features
- * @param config 项目配置
- * @param targetDir 目标目录
- * @throws {Error} 如果路径不安全或模板渲染失败
- */
-export declare function renderCommonFeatures(config: ProjectConfigType, targetDir: string): void;
-/**
- * 验证微前端引擎是否存在
- * @param framework 框架类型
- * @param engine 微前端引擎名称
- * @returns 引擎是否存在
- */
-export declare function validateMicroFrontendEngine(framework: FrameworkType, engine: string): boolean;
-/**
- * 获取可用的公共 features（用于测试和文档生成）
- * @returns 公共 feature 名称数组
- */
-export declare function getAvailableCommonFeatures(): string[];
-/**
- * 获取可用的框架 features（用于测试和文档生成）
- * @param framework 框架类型
- * @returns 框架 feature 名称数组
- */
-export declare function getAvailableFrameworkFeatures(framework: FrameworkType): string[];
-/**
- * 获取可用的微前端引擎（用于测试和文档生成）
- * @param framework 框架类型
- * @returns 微前端引擎名称数组
- */
-export declare function getAvailableMicroFrontendEngines(framework: FrameworkType): string[];
-/**
- * 渲染微前端专属的 features（覆盖标准 features）
- * 只渲染文件系统中存在的微前端 features，实现按需覆盖
- * @param config 项目配置
- * @param targetDir 目标目录
- * @param microFrontendEngine 微前端引擎类型
- * @throws {Error} 如果路径不安全或模板渲染失败
- */
-export declare function renderMicroFrontendFeatures(config: ProjectConfigType, targetDir: string, microFrontendEngine: string): void;