@farris/cli 2.0.3 → 2.1.1

package/lib/commands/workspace/create.js

@@ -0,0 +1,380 @@
+import { resolve, join } from 'node:path';
+import { existsSync, mkdirSync } from 'node:fs';
+import { spawn } from 'node:child_process';
+import inquirer from 'inquirer';
+import { DEFAULT_CATALOG_VERSIONS, CLI_VERSION, ExitCode, } from '../../common/constant.js';
+import { inspectTarget, checkPlannedConflicts } from '../../common/safety.js';
+import { collectTemplateOutputPaths, renderTemplateDir } from '../../common/template-renderer.js';
+import { Transaction } from '../../common/transaction.js';
+import { verifyWorkspace } from '../../common/verifier.js';
+import { sendJson, logInfo, logWarn, fail, setJsonMode, createSpinner } from '../../common/output.js';
+import { getDirname } from '../../common/constant.js';
+/**
+ * 从包名推导目录名（去掉 scope 并转为合法 kebab-case）
+ */
+export function deriveAppDir(name) {
+    const withoutScope = name.replace(/^@[^/]+\//, '');
+    return withoutScope
+        .toLowerCase()
+        .replace(/[^a-z0-9-_]/g, '-')
+        .replace(/^-+|-+$/g, '');
+}
+/**
+ * 校验 npm 包名有效性
+ */
+export function validatePackageName(name) {
+    if (!name || typeof name !== 'string') {
+        return false;
+    }
+    return /^(@[a-z0-9-~][a-z0-9-._~]*\/)?[a-z0-9-~][a-z0-9-._~]*$/.test(name);
+}
+/**
+ * 执行 pnpm install 安装依赖
+ */
+export function runPnpmInstall(targetDir, isJson = false) {
+    return new Promise((resolve) => {
+        const child = spawn('pnpm', ['install'], {
+            cwd: targetDir,
+            shell: true,
+            stdio: isJson ? ['ignore', 'pipe', 'pipe'] : 'inherit'
+        });
+        let stderrData = '';
+        if (isJson && child.stderr) {
+            child.stderr.on('data', (chunk) => {
+                stderrData += chunk.toString();
+                process.stderr.write(chunk);
+            });
+        }
+        child.on('close', (code) => {
+            if (code === 0) {
+                resolve({ success: true });
+            }
+            else {
+                resolve({ success: false, error: `pnpm install 退出码: ${code}` });
+            }
+        });
+        child.on('error', (err) => {
+            resolve({ success: false, error: err.message });
+        });
+    });
+}
+/* eslint-disable complexity */
+export async function createWorkspace(target = '.', options = {}) {
+    const isJson = !!options.json;
+    setJsonMode(isJson);
+    const inspect = inspectTarget(target);
+    if (!inspect.canCreate) {
+        fail({
+            command: 'workspace.create',
+            error: `目标目录无法创建 Workspace，状态: ${inspect.status}。${inspect.conflicts.length > 0 ? `冲突项: ${inspect.conflicts.join(', ')}` : ''}`,
+            exitCode: ExitCode.TARGET_CONFLICT,
+            extra: { status: inspect.status, conflicts: inspect.conflicts }
+        });
+    }
+    let { name, title, appDir } = options;
+    let router = options.router ?? false;
+    let routerMode = options.routerMode || 'hash';
+    let format = options.format || 'es';
+    let style = options.style || 'css';
+    let install = options.install ?? false;
+    // 非 JSON 模式下若缺失必填项，进行交互询问
+    if (!isJson && !options.yes && !name) {
+        const prompt = inquirer.createPromptModule();
+        const answers = await prompt([
+            {
+                type: 'input',
+                name: 'name',
+                message: '请输入应用名称 (package name):',
+                default: 'my-app',
+                validate: (input) => (validatePackageName(input) ? true : '请输入合法的 npm 包名 (如 my-app 或 @scope/my-app)')
+            },
+            {
+                type: 'input',
+                name: 'title',
+                message: '请输入展示标题 (title):',
+                default: (ans) => ans.name
+            },
+            {
+                type: 'confirm',
+                name: 'router',
+                message: '是否启用 Vue Router?',
+                default: false
+            },
+            {
+                type: 'list',
+                name: 'routerMode',
+                message: '选择路由模式:',
+                choices: ['hash', 'history'],
+                default: 'hash',
+                when: (ans) => ans.router
+            },
+            {
+                type: 'list',
+                name: 'style',
+                message: '选择应用样式方案:',
+                choices: ['css', 'scss', 'none'],
+                default: 'css'
+            },
+            {
+                type: 'list',
+                name: 'format',
+                message: '选择交付格式:',
+                choices: ['es', 'systemjs'],
+                default: 'es'
+            },
+            {
+                type: 'confirm',
+                name: 'install',
+                message: '是否在创建完成后自动安装依赖 (pnpm install)?',
+                default: false
+            }
+        ]);
+        ({ name } = answers);
+        title = answers.title || name;
+        router = !!answers.router;
+        if (answers.routerMode) {
+            ({ routerMode } = answers);
+        }
+        if (answers.style) {
+            ({ style } = answers);
+        }
+        if (answers.format) {
+            ({ format } = answers);
+        }
+        if (answers.install !== undefined) {
+            install = !!answers.install;
+        }
+    }
+    if (!name) {
+        fail({
+            command: 'workspace.create',
+            error: '必须指定应用名称 (--name <name>)',
+            exitCode: ExitCode.GENERAL_ERROR
+        });
+    }
+    if (!validatePackageName(name)) {
+        fail({
+            command: 'workspace.create',
+            error: `非法的应用包名: "${name}"`,
+            exitCode: ExitCode.GENERAL_ERROR
+        });
+    }
+    title = title || name;
+    appDir = appDir || deriveAppDir(name);
+    if (!appDir || !/^[a-z0-9-_]+$/.test(appDir)) {
+        fail({
+            command: 'workspace.create',
+            error: `非法的子目录名: "${appDir}"，仅支持小写字母、数字、短横线与下划线`,
+            exitCode: ExitCode.GENERAL_ERROR
+        });
+    }
+    const targetDir = inspect.target;
+    const templatesBase = resolve(getDirname(import.meta.url), '../../../templates/workspace');
+    const rootTemplateDir = join(templatesBase, 'root');
+    const appTemplateDir = join(templatesBase, 'app');
+    const rootVariables = {
+        pnpmVersion: DEFAULT_CATALOG_VERSIONS['pnpm'] || '9.15.4',
+        farrisUiVueVersion: DEFAULT_CATALOG_VERSIONS['@farris/ui-vue'] || '1.8.3',
+        farrisCliVersion: CLI_VERSION,
+        typescriptVersion: DEFAULT_CATALOG_VERSIONS['typescript'] || '5.7.3',
+        viteVersion: DEFAULT_CATALOG_VERSIONS['vite'] || '5.4.19',
+        vueVersion: DEFAULT_CATALOG_VERSIONS['vue'] || '3.5.13',
+        vueRouterVersion: DEFAULT_CATALOG_VERSIONS['vue-router'] || '4.5.0',
+        vueTscVersion: DEFAULT_CATALOG_VERSIONS['vue-tsc'] || '2.2.0',
+        sassVersion: DEFAULT_CATALOG_VERSIONS['sass'] || '1.90.0',
+        title,
+        appDir,
+        appName: name
+    };
+    const appTargetDir = join(targetDir, 'packages', appDir);
+    // 组装条件变量
+    const routerDependency = router ? ',\n    "vue-router": "catalog:"' : '';
+    const sassDevDependency = style === 'scss' ? ',\n    "sass": "catalog:"' : '';
+    let styleImport = '';
+    if (style === 'css') {
+        styleImport = "\nimport './styles/index.css';";
+    }
+    else if (style === 'scss') {
+        styleImport = "\nimport './styles/index.scss';";
+    }
+    const routerImport = router ? "\nimport router from './router';" : '';
+    const routerUse = router ? '\napp.use(router);' : '';
+    // 模板保留扩展点，但通用 CLI 不再内置 i18n 运行时契约。
+    const i18nImport = '';
+    const i18nUse = '';
+    const appRouterImport = router ? "\nimport { RouterView } from 'vue-router';" : '';
+    const appTemplateBody = router
+        ? '        <RouterView />'
+        : `        <h1>{${JSON.stringify(title)}}</h1>`;
+    const appVariables = {
+        appName: name,
+        title,
+        appDir,
+        base: './',
+        routerMode: router ? routerMode : 'none',
+        format,
+        routerDependency,
+        sassDevDependency,
+        styleImport,
+        routerImport,
+        routerUse,
+        i18nImport,
+        i18nUse,
+        appRouterImport,
+        appTemplateBody,
+        routerHistoryFunction: routerMode === 'history' ? 'createWebHistory' : 'createWebHashHistory',
+        routerHistoryCall: routerMode === 'history'
+            ? 'createWebHistory(import.meta.env.BASE_URL)'
+            : 'createWebHashHistory()'
+    };
+    // 模板文件过滤规则
+    const appFilter = (relPath) => {
+        const normalized = relPath.replace(/\\/g, '/');
+        // 样式过滤
+        if (style === 'none' && normalized.startsWith('src/styles')) {
+            return false;
+        }
+        if (style === 'css' && (normalized === 'src/styles/index.scss' || normalized === 'src/styles/index.scss.tpl')) {
+            return false;
+        }
+        if (style === 'scss' && (normalized === 'src/styles/index.css' || normalized === 'src/styles/index.css.tpl')) {
+            return false;
+        }
+        // Router 与 Views 过滤
+        if (!router) {
+            if (normalized.startsWith('src/router') || normalized.startsWith('src/views')) {
+                return false;
+            }
+        }
+        return true;
+    };
+    const plannedRelativeFiles = [
+        ...collectTemplateOutputPaths(rootTemplateDir),
+        ...collectTemplateOutputPaths(appTemplateDir, appFilter).map((path) => join('packages', appDir, path))
+    ];
+    const conflicts = checkPlannedConflicts(targetDir, plannedRelativeFiles);
+    if (conflicts.length > 0 && !options.force) {
+        const shouldOverwrite = !isJson &&
+            !options.yes &&
+            (await inquirer.createPromptModule()([
+                {
+                    type: 'confirm',
+                    name: 'overwrite',
+                    message: `以下 ${conflicts.length} 个文件已存在，是否覆盖？\n${conflicts.join('\n')}`,
+                    default: false
+                }
+            ])).overwrite;
+        if (!shouldOverwrite) {
+            fail({
+                command: 'workspace.create',
+                error: `目标目录包含将被模板写入的文件: ${conflicts.join(', ')}。请交互确认，或显式传入 --force 覆盖。`,
+                exitCode: ExitCode.TARGET_CONFLICT,
+                extra: { conflicts }
+            });
+        }
+    }
+    const transaction = new Transaction();
+    plannedRelativeFiles.forEach((path) => transaction.prepareWrite(join(targetDir, path)));
+    const spinner = createSpinner('正在生成 Workspace 工程模板...');
+    spinner.start();
+    try {
+        if (!existsSync(targetDir)) {
+            mkdirSync(targetDir, { recursive: true });
+            transaction.recordCreatedDir(targetDir);
+        }
+        // 1. 渲染根目录模板
+        const rootRender = renderTemplateDir({
+            sourceDir: rootTemplateDir,
+            targetDir,
+            variables: rootVariables,
+            skipExisting: false
+        });
+        if (rootRender.unreplacedPlaceholders.length > 0) {
+            throw new Error(`根模板渲染出现未替换占位符: ${rootRender.unreplacedPlaceholders.map((p) => `${p.file} (${p.placeholder})`).join(', ')}`);
+        }
+        // 2. 渲染子应用目录 (packages/<appDir>/)
+        mkdirSync(appTargetDir, { recursive: true });
+        transaction.recordCreatedDir(appTargetDir);
+        const appRender = renderTemplateDir({
+            sourceDir: appTemplateDir,
+            targetDir: appTargetDir,
+            variables: appVariables,
+            skipExisting: false,
+            filter: appFilter
+        });
+        if (appRender.unreplacedPlaceholders.length > 0) {
+            throw new Error(`应用模板渲染出现未替换占位符: ${appRender.unreplacedPlaceholders.map((p) => `${p.file} (${p.placeholder})`).join(', ')}`);
+        }
+        // 3. 执行 Verify
+        const verifyResult = verifyWorkspace(targetDir, inspect.preservedInputEntries);
+        if (!verifyResult.ok) {
+            throw new Error(`Workspace 校验失败: ${verifyResult.errors.join('; ')}`);
+        }
+        // 4. 提交事务
+        transaction.commit();
+        spinner.succeed('Workspace 工程生成并校验通过！');
+        // 5. 若启用 --install，自动执行依赖安装
+        let installed = false;
+        let installError;
+        if (install) {
+            const installSpinner = createSpinner('正在安装依赖 (pnpm install)...');
+            installSpinner.start();
+            const installRes = await runPnpmInstall(targetDir, isJson);
+            if (installRes.success) {
+                installed = true;
+                installSpinner.succeed('依赖安装成功！');
+            }
+            else {
+                installed = false;
+                installError = installRes.error;
+                installSpinner.fail('依赖安装失败');
+                logWarn(`\n提示: 依赖安装出现异常 (${installError})，您可以稍后进入目录手动执行 "pnpm install"`);
+            }
+        }
+        const allCreated = [...rootRender.filesCreated, ...appRender.filesCreated];
+        if (isJson) {
+            sendJson({
+                command: 'workspace.create',
+                ok: true,
+                target: targetDir,
+                appDir,
+                appName: name,
+                title,
+                router,
+                routerMode: router ? routerMode : 'none',
+                format,
+                style,
+                installed,
+                ...(installError ? { installError } : {}),
+                filesCreated: allCreated,
+                preservedInputVerified: inspect.preservedInputEntries.length > 0
+            });
+            return;
+        }
+        logInfo(`\n✨ Workspace 已就绪: ${targetDir}`);
+        logInfo(`- 应用: ${name} (目录: packages/${appDir})`);
+        logInfo(`- 路由: ${router ? routerMode : '未启用'}`);
+        logInfo(`- 样式: ${style}`);
+        logInfo(`- 交付格式: ${format}`);
+        logInfo(`- 依赖安装: ${installed ? '已完成' : '未执行 (可通过 pnpm install 安装)'}`);
+        logInfo('\n下一步 (Next Steps):');
+        logInfo(`  1. cd ${target}`);
+        if (!installed) {
+            logInfo('  2. pnpm install');
+            logInfo(`  3. pnpm --filter "${name}" dev\n`);
+        }
+        else {
+            logInfo(`  2. pnpm --filter "${name}" dev\n`);
+        }
+    }
+    catch (err) {
+        spinner.fail('Workspace 生成失败，正在回滚...');
+        transaction.rollback();
+        fail({
+            command: 'workspace.create',
+            error: `生成 Workspace 失败: ${err.message}`,
+            exitCode: ExitCode.GENERAL_ERROR
+        });
+    }
+}
+//# sourceMappingURL=create.js.map

package/lib/commands/workspace/create.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create.js","sourceRoot":"","sources":["../../../src/commands/workspace/create.ts"],"names":[],"mappings":"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"}

package/lib/commands/workspace/inspect.js

@@ -0,0 +1,31 @@
+import { inspectTarget } from '../../common/safety.js';
+import { sendJson, logInfo, logWarn, setJsonMode } from '../../common/output.js';
+export async function inspectWorkspace(target = '.', options = {}) {
+    const isJson = !!options.json;
+    setJsonMode(isJson);
+    const result = inspectTarget(target);
+    if (isJson) {
+        sendJson({
+            command: 'workspace.inspect',
+            ok: true,
+            status: result.status,
+            target: result.target,
+            canCreate: result.canCreate,
+            conflicts: result.conflicts,
+            preservedInputEntries: result.preservedInputEntries,
+            message: result.message
+        });
+        return result;
+    }
+    logInfo(`\n🔍 目标检查: ${result.target}`);
+    logInfo(`- 状态: ${result.status}`);
+    logInfo(`- 允许创建: ${result.canCreate ? '是' : '否'}`);
+    if (result.preservedInputEntries.length > 0) {
+        logInfo(`- 发现受保护输入 (${result.preservedInputEntries.length} 项): ${result.preservedInputEntries.join(', ')}`);
+    }
+    if (result.conflicts.length > 0) {
+        logWarn(`- 冲突文件/目录: ${result.conflicts.join(', ')}`);
+    }
+    return result;
+}
+//# sourceMappingURL=inspect.js.map

package/lib/commands/workspace/inspect.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"inspect.js","sourceRoot":"","sources":["../../../src/commands/workspace/inspect.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AACvD,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAY,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAO3F,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,SAAiB,GAAG,EAAE,UAA0B,EAAE;IACvF,MAAM,MAAM,GAAG,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC;IAC9B,WAAW,CAAC,MAAM,CAAC,CAAC;IAEpB,MAAM,MAAM,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC;IAErC,IAAI,MAAM,EAAE;QACV,QAAQ,CAAC;YACP,OAAO,EAAE,mBAAmB;YAC5B,EAAE,EAAE,IAAI;YACR,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,SAAS,EAAE,MAAM,CAAC,SAAS;YAC3B,SAAS,EAAE,MAAM,CAAC,SAAS;YAC3B,qBAAqB,EAAE,MAAM,CAAC,qBAAqB;YACnD,OAAO,EAAE,MAAM,CAAC,OAAO;SACxB,CAAC,CAAC;QACH,OAAO,MAAM,CAAC;KACf;IAED,OAAO,CAAC,cAAc,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;IACvC,OAAO,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;IAClC,OAAO,CAAC,WAAW,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC;IAEnD,IAAI,MAAM,CAAC,qBAAqB,CAAC,MAAM,GAAG,CAAC,EAAE;QAC3C,OAAO,CAAC,cAAc,MAAM,CAAC,qBAAqB,CAAC,MAAM,QAAQ,MAAM,CAAC,qBAAqB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;KAC7G;IAED,IAAI,MAAM,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE;QAC/B,OAAO,CAAC,cAAc,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;KACtD;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/lib/commands/workspace/verify.js

@@ -0,0 +1,39 @@
+import { verifyWorkspace } from '../../common/verifier.js';
+import { sendJson, logInfo, logError, setJsonMode, fail } from '../../common/output.js';
+import { ExitCode } from '../../common/constant.js';
+export async function verifyWorkspaceCommand(target = '.', options = {}) {
+    const isJson = !!options.json;
+    setJsonMode(isJson);
+    const result = verifyWorkspace(target);
+    if (isJson) {
+        sendJson({
+            command: 'workspace.verify',
+            ok: result.ok,
+            target: result.target,
+            checks: result.checks,
+            errors: result.errors
+        }, result.ok ? ExitCode.SUCCESS : ExitCode.VERIFY_FAILED);
+        return result;
+    }
+    logInfo(`\n📋 Workspace 验证报告: ${result.target}`);
+    result.checks.forEach((chk) => {
+        if (chk.passed) {
+            logInfo(`  ✔ [PASS] ${chk.name}`);
+        }
+        else {
+            logError(`  ✖ [FAIL] ${chk.name}: ${chk.message}`);
+        }
+    });
+    if (!result.ok) {
+        fail({
+            command: 'workspace.verify',
+            error: `Workspace 验证未通过，共发现 ${result.errors.length} 处问题`,
+            exitCode: ExitCode.VERIFY_FAILED
+        });
+    }
+    else {
+        logInfo('\n🎉 验证全部通过！\n');
+    }
+    return result;
+}
+//# sourceMappingURL=verify.js.map

package/lib/commands/workspace/verify.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"verify.js","sourceRoot":"","sources":["../../../src/commands/workspace/verify.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAC3D,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAW,QAAQ,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,wBAAwB,CAAC;AACjG,OAAO,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AAMpD,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAAC,SAAiB,GAAG,EAAE,UAAkC,EAAE;IACrG,MAAM,MAAM,GAAG,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC;IAC9B,WAAW,CAAC,MAAM,CAAC,CAAC;IAEpB,MAAM,MAAM,GAAG,eAAe,CAAC,MAAM,CAAC,CAAC;IAEvC,IAAI,MAAM,EAAE;QACV,QAAQ,CACN;YACE,OAAO,EAAE,kBAAkB;YAC3B,EAAE,EAAE,MAAM,CAAC,EAAE;YACb,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,MAAM,EAAE,MAAM,CAAC,MAAM;SACtB,EACD,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,aAAa,CACtD,CAAC;QACF,OAAO,MAAM,CAAC;KACf;IAED,OAAO,CAAC,wBAAwB,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;IACjD,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,EAAE;QAC5B,IAAI,GAAG,CAAC,MAAM,EAAE;YACd,OAAO,CAAC,cAAc,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC;SACnC;aAAM;YACL,QAAQ,CAAC,cAAc,GAAG,CAAC,IAAI,KAAK,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC;SACpD;IACH,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE;QACd,IAAI,CAAC;YACH,OAAO,EAAE,kBAAkB;YAC3B,KAAK,EAAE,uBAAuB,MAAM,CAAC,MAAM,CAAC,MAAM,MAAM;YACxD,QAAQ,EAAE,QAAQ,CAAC,aAAa;SACjC,CAAC,CAAC;KACJ;SAAM;QACL,OAAO,CAAC,gBAAgB,CAAC,CAAC;KAC3B;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/lib/common/constant.js

@@ -2,7 +2,7 @@ import { existsSync } from 'node:fs';
 import { fileURLToPath } from 'node:url';
 import { join, dirname } from 'node:path';
 function findRootDir(dir) {
-    if (existsSync(join(dir, 'farris.config.js'))) {
+    if (existsSync(join(dir, 'farris.config.js')) || existsSync(join(dir, 'farris.config.mjs'))) {
         return dir;
     }
     const parentDir = dirname(dir);
@@ -20,4 +20,45 @@ export const getPackageName = () => {
     const { PackageName = '@components' } = process.env;
     return PackageName;
 };
+// Schema & Version Baseline
+export const SCHEMA_VERSION = 1;
+export const CLI_VERSION = '2.1.0';
+// Catalog Dependency Versions Baseline
+export const DEFAULT_CATALOG_VERSIONS = {
+    '@farris/ui-vue': '1.8.3',
+    '@farris/cli': '2.1.0',
+    'typescript': '5.7.3',
+    'vite': '5.4.19',
+    'vue': '3.5.13',
+    'vue-router': '4.5.0',
+    'vue-tsc': '2.2.0',
+    'sass': '1.90.0',
+    'pnpm': '9.15.4'
+};
+// Standard Engines
+export const DEFAULT_ENGINES = {
+    node: '^18.0.0 || >=20.0.0',
+    pnpm: '>=9.0.0 <10.0.0'
+};
+// Exit Codes
+export var ExitCode;
+(function (ExitCode) {
+    ExitCode[ExitCode["SUCCESS"] = 0] = "SUCCESS";
+    ExitCode[ExitCode["GENERAL_ERROR"] = 1] = "GENERAL_ERROR";
+    ExitCode[ExitCode["TARGET_CONFLICT"] = 2] = "TARGET_CONFLICT";
+    ExitCode[ExitCode["VERIFY_FAILED"] = 3] = "VERIFY_FAILED";
+    ExitCode[ExitCode["FS_ERROR"] = 4] = "FS_ERROR";
+})(ExitCode || (ExitCode = {}));
+// Workspace Safety Status
+export var WorkspaceStatus;
+(function (WorkspaceStatus) {
+    WorkspaceStatus["MISSING"] = "missing";
+    WorkspaceStatus["EMPTY"] = "empty";
+    WorkspaceStatus["AI_CONFIG_ONLY"] = "ai-config-only";
+    WorkspaceStatus["PRESERVED_INPUT_ONLY"] = "preserved-input-only";
+    WorkspaceStatus["EXISTING_WORKSPACE"] = "existing-workspace";
+    WorkspaceStatus["EXISTING_OR_UNKNOWN_PROJECT"] = "existing-or-unknown-project";
+    WorkspaceStatus["NON_EMPTY_PROJECT"] = "non-empty-project";
+    WorkspaceStatus["INVALID_TARGET"] = "invalid-target";
+})(WorkspaceStatus || (WorkspaceStatus = {}));
 //# sourceMappingURL=constant.js.map

package/lib/common/constant.js.map

@@ -1 +1 @@
-{"version":3,"file":"constant.js","sourceRoot":"","sources":["../../src/common/constant.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAE1C,SAAS,WAAW,CAAC,GAAW;IAC9B,IAAI,UAAU,CAAC,IAAI,CAAC,GAAG,EAAE,kBAAkB,CAAC,CAAC,EAAE;QAC7C,OAAO,GAAG,CAAC;KACZ;IAED,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;IAC/B,IAAI,GAAG,KAAK,SAAS,EAAE;QACrB,OAAO,GAAG,CAAC;KACZ;IAED,OAAO,WAAW,CAAC,SAAS,CAAC,CAAC;AAChC,CAAC;AACD,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,GAAW,EAAC,EAAE,CAAC,aAAa,CAAC,IAAI,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC;AAE3E,aAAa;AAEb,MAAM,CAAC,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;AACjC,MAAM,CAAC,MAAM,IAAI,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC;AACrC,MAAM,CAAC,MAAM,kBAAkB,GAAG,IAAI,CAAC,GAAG,EAAE,mBAAmB,CAAC,CAAC;AAEjE,MAAM,CAAC,MAAM,cAAc,GAAG,GAAE,EAAE;IAChC,MAAM,EAAE,WAAW,GAAG,aAAa,EAAE,GAAG,OAAO,CAAC,GAAG,CAAC;IACpD,OAAO,WAAW,CAAC;AACrB,CAAC,CAAC"}
+{"version":3,"file":"constant.js","sourceRoot":"","sources":["../../src/common/constant.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAE1C,SAAS,WAAW,CAAC,GAAW;IAC9B,IAAI,UAAU,CAAC,IAAI,CAAC,GAAG,EAAE,kBAAkB,CAAC,CAAC,IAAI,UAAU,CAAC,IAAI,CAAC,GAAG,EAAE,mBAAmB,CAAC,CAAC,EAAE;QAC3F,OAAO,GAAG,CAAC;KACZ;IAED,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;IAC/B,IAAI,GAAG,KAAK,SAAS,EAAE;QACrB,OAAO,GAAG,CAAC;KACZ;IAED,OAAO,WAAW,CAAC,SAAS,CAAC,CAAC;AAChC,CAAC;AAED,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,GAAW,EAAE,EAAE,CAAC,aAAa,CAAC,IAAI,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC;AAE5E,aAAa;AACb,MAAM,CAAC,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;AACjC,MAAM,CAAC,MAAM,IAAI,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC;AACrC,MAAM,CAAC,MAAM,kBAAkB,GAAG,IAAI,CAAC,GAAG,EAAE,mBAAmB,CAAC,CAAC;AAEjE,MAAM,CAAC,MAAM,cAAc,GAAG,GAAG,EAAE;IACjC,MAAM,EAAE,WAAW,GAAG,aAAa,EAAE,GAAG,OAAO,CAAC,GAAG,CAAC;IACpD,OAAO,WAAW,CAAC;AACrB,CAAC,CAAC;AAEF,4BAA4B;AAC5B,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC;AAChC,MAAM,CAAC,MAAM,WAAW,GAAG,OAAO,CAAC;AAEnC,uCAAuC;AACvC,MAAM,CAAC,MAAM,wBAAwB,GAA2B;IAC9D,gBAAgB,EAAE,OAAO;IACzB,aAAa,EAAE,OAAO;IACtB,YAAY,EAAE,OAAO;IACrB,MAAM,EAAE,QAAQ;IAChB,KAAK,EAAE,QAAQ;IACf,YAAY,EAAE,OAAO;IACrB,SAAS,EAAE,OAAO;IAClB,MAAM,EAAE,QAAQ;IAChB,MAAM,EAAE,QAAQ;CACjB,CAAC;AAEF,mBAAmB;AACnB,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,IAAI,EAAE,qBAAqB;IAC3B,IAAI,EAAE,iBAAiB;CACxB,CAAC;AAEF,aAAa;AACb,MAAM,CAAN,IAAY,QAMX;AAND,WAAY,QAAQ;IAClB,6CAAW,CAAA;IACX,yDAAiB,CAAA;IACjB,6DAAmB,CAAA;IACnB,yDAAiB,CAAA;IACjB,+CAAY,CAAA;AACd,CAAC,EANW,QAAQ,KAAR,QAAQ,QAMnB;AAED,0BAA0B;AAC1B,MAAM,CAAN,IAAY,eASX;AATD,WAAY,eAAe;IACzB,sCAAmB,CAAA;IACnB,kCAAe,CAAA;IACf,oDAAiC,CAAA;IACjC,gEAA6C,CAAA;IAC7C,4DAAyC,CAAA;IACzC,8EAA2D,CAAA;IAC3D,0DAAuC,CAAA;IACvC,oDAAiC,CAAA;AACnC,CAAC,EATW,eAAe,KAAf,eAAe,QAS1B"}

package/lib/common/get-vite-config.js

@@ -1,27 +1,84 @@
-import { mergeConfig } from 'vite';
+import { mergeConfig, loadEnv } from 'vite';
 import { getFarrisConfigAsync } from './get-farris-config.js';
 import { getDependencies } from '../common/get-dependencies.js';
 import cssInjectedByJsPlugin from 'vite-plugin-css-injected-by-js';
-const formatFarrisConfig = (farrisConfig, type) => {
-    const { lib, format, target, minify = true, outDir, externals = { include: [], exclude: [] }, externalDependencies, plugins = [], alias, server, cssInjected, packageName = '@farris/mobile-ui-vue' } = farrisConfig;
+import { logWarn } from './output.js';
+import { CWD } from './constant.js';
+/**
+ * 解析有效 Base 及其来源
+ */
+export function resolveEffectiveBase(options) {
+    const { cliBase, mode = 'production', configBase, configPublicPath, cwd = CWD } = options;
+    // 1. CLI --base
+    if (cliBase !== undefined && cliBase !== '') {
+        return { effectiveBase: cliBase, baseSource: 'cli' };
+    }
+    // 2. VITE_BASE_URL (通过 loadEnv 加载当前 mode 的 .env 或环境变量)
+    const env = loadEnv(mode, cwd, '');
+    const envBase = env.VITE_BASE_URL || process.env.VITE_BASE_URL;
+    if (envBase !== undefined && envBase !== '') {
+        return { effectiveBase: envBase, baseSource: 'env' };
+    }
+    // 3. farris.config.mjs.base
+    if (configBase !== undefined && configBase !== '') {
+        if (configPublicPath !== undefined) {
+            logWarn('[WARN] farris.config.mjs 中同时存在 base 和 publicPath，优先使用 base，publicPath 已弃用。');
+        }
+        return { effectiveBase: configBase, baseSource: 'config.base' };
+    }
+    // 4. farris.config.mjs.publicPath (兼容别名)
+    if (configPublicPath !== undefined && configPublicPath !== '') {
+        logWarn('[WARN] farris.config.mjs 中的 publicPath 已弃用，请在配置文件中改用 base。');
+        return { effectiveBase: configPublicPath, baseSource: 'config.publicPath' };
+    }
+    // 5. 默认根路径
+    return { effectiveBase: '/', baseSource: 'default' };
+}
+/**
+ * 校验 Base 与 RouterMode 兼容性
+ */
+export function validateBaseAndRouterMode(base, routerMode) {
+    const isRelative = base.startsWith('.') || (!base.startsWith('/') && !base.startsWith('http://') && !base.startsWith('https://'));
+    if (isRelative && routerMode === 'history') {
+        throw new Error(`[Error] 配置冲突: 相对路径 base ("${base}") 无法与 history 路由模式 ("routerMode: 'history'") 同时使用。在 history 模式下必须使用绝对路径 base (如 "/")，或者切换为 hash 路由模式。`);
+    }
+}
+const formatFarrisConfig = (farrisConfig, type, cliOptions = {}) => {
+    const { lib, format, target, minify = true, outDir, externals = { include: [], exclude: [] }, externalDependencies, plugins = [], alias, server, cssInjected, packageName = '@farris/mobile-ui-vue', base: configBase, publicPath: configPublicPath, routerMode } = farrisConfig;
+    // 解析 base
+    const { effectiveBase } = resolveEffectiveBase({
+        cliBase: cliOptions.base,
+        mode: cliOptions.mode,
+        configBase,
+        configPublicPath
+    });
+    // 校验 base 与 routerMode
+    if (type === 'app') {
+        validateBaseAndRouterMode(effectiveBase, routerMode);
+    }
     const dependencies = externalDependencies ? getDependencies() : [];
     let external = externals.include ? [...externals.include, ...dependencies] : dependencies;
     external = external.filter((item) => !externals.exclude?.includes(item));
-    format && (process.env.FARRIS_FORMAT = format);
+    if (format) {
+        process.env.FARRIS_FORMAT = format;
+    }
     if (cssInjected) {
         plugins.push(cssInjectedByJsPlugin());
     }
     if (packageName) {
         process.env.PackageName = packageName;
     }
+    // Rollup format 转换：systemjs -> system
+    const rollupFormat = format === 'systemjs' ? 'system' : format;
     const viteConfig = {
+        base: effectiveBase,
         build: {
             target,
             minify,
             lib: type === 'lib' ? lib : undefined,
             rollupOptions: {
                 output: {
-                    format
+                    format: rollupFormat
                 },
                 external: externals.filter ? externals.filter(external) : external
             },
@@ -35,13 +92,13 @@ const formatFarrisConfig = (farrisConfig, type) => {
     };
     return viteConfig;
 };
-const formatViteConfig = async (type, configFile) => {
+const formatViteConfig = async (type, configFile, cliOptions = {}) => {
     const { viteConfig = {}, ...farrisConfig } = await getFarrisConfigAsync(configFile);
-    const customViteConfig = formatFarrisConfig(farrisConfig, type);
+    const customViteConfig = formatFarrisConfig(farrisConfig, type, cliOptions);
     return mergeConfig(customViteConfig, viteConfig);
 };
-const getViteConfig = async (type = 'app', configFile) => {
-    const viteConfig = await formatViteConfig(type, configFile);
+const getViteConfig = async (type = 'app', configFile, cliOptions = {}) => {
+    const viteConfig = await formatViteConfig(type, configFile, cliOptions);
     const { default: defaultViteConfig } = await import(`../config/vite-${type}.js`);
     return mergeConfig(defaultViteConfig, viteConfig);
 };