@farris/cli 2.0.2 → 2.1.0

package/lib/commands/workspace/create.js

@@ -0,0 +1,310 @@
+import { resolve, join } from 'node:path';
+import { existsSync, mkdirSync } from 'node:fs';
+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, 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);
+}
+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 = options.name;
+    let title = options.title;
+    let appDir = options.appDir;
+    let router = options.router ?? false;
+    let routerMode = options.routerMode || 'hash';
+    let format = options.format || 'es';
+    let style = options.style || 'css';
+    // 非 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'
+            }
+        ]);
+        name = answers.name;
+        title = answers.title || name;
+        router = !!answers.router;
+        if (answers.routerMode)
+            routerMode = answers.routerMode;
+        if (answers.style)
+            style = answers.style;
+        if (answers.format)
+            format = answers.format;
+    }
+    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 工程生成并校验通过！');
+        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,
+                filesCreated: allCreated,
+                preservedInputVerified: inspect.preservedInputEntries.length > 0
+            });
+            return;
+        }
+        logInfo(`\n✨ Workspace 已就绪: ${targetDir}`);
+        logInfo(`- 应用: ${name} (目录: packages/${appDir})`);
+        logInfo(`- 路由: ${router ? routerMode : '未启用'}`);
+        logInfo(`- 样式: ${style}`);
+        logInfo(`- 交付格式: ${format}`);
+        logInfo('\n下一步 (Next Steps):');
+        logInfo(`  1. cd ${target}`);
+        logInfo('  2. pnpm install');
+        logInfo(`  3. 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);
 };

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

@@ -1 +1 @@
-{"version":3,"file":"get-vite-config.js","sourceRoot":"","sources":["../../src/common/get-vite-config.ts"],"names":[],"mappings":"AAAA,OAAO,EAA8C,WAAW,EAAiB,MAAM,MAAM,CAAC;AAC9F,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAChE,OAAO,qBAAqB,MAAM,gCAAgC,CAAC;AAiBnE,MAAM,kBAAkB,GAAG,CAAC,YAA0B,EAAE,IAAY,EAAE,EAAE;IACtE,MAAM,EACJ,GAAG,EACH,MAAM,EACN,MAAM,EACN,MAAM,GAAG,IAAI,EACb,MAAM,EACN,SAAS,GAAG,EAAE,OAAO,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,EACxC,oBAAoB,EACpB,OAAO,GAAG,EAAE,EACZ,KAAK,EACL,MAAM,EACN,WAAW,EACX,WAAW,GAAG,uBAAuB,EACtC,GAAG,YAAY,CAAC;IAEjB,MAAM,YAAY,GAAG,oBAAoB,CAAC,CAAC,CAAC,eAAe,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IAEnE,IAAI,QAAQ,GAAG,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC,OAAO,EAAE,GAAG,YAAY,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC;IAE1F,QAAQ,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,SAAS,CAAC,OAAO,EAAE,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC;IAEzE,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,aAAa,GAAG,MAAM,CAAC,CAAC;IAE/C,IAAG,WAAW,EAAC;QACb,OAAO,CAAC,IAAI,CAAC,qBAAqB,EAAE,CAAC,CAAC;KACvC;IACD,IAAG,WAAW,EAAE;QACd,OAAO,CAAC,GAAG,CAAC,WAAW,GAAG,WAAW,CAAC;KACvC;IAED,MAAM,UAAU,GAAG;QACjB,KAAK,EAAE;YACL,MAAM;YACN,MAAM;YACN,GAAG,EAAE,IAAI,KAAK,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS;YACrC,aAAa,EAAE;gBACb,MAAM,EAAE;oBACN,MAAM;iBACP;gBACD,QAAQ,EAAE,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ;aACnE;YACD,MAAM;SACP;QACD,MAAM;QACN,OAAO;QACP,OAAO,EAAE;YACP,KAAK;SACN;KACF,CAAC;IACF,OAAO,UAAU,CAAC;AACpB,CAAC,CAAC;AAEF,MAAM,gBAAgB,GAAG,KAAK,EAAE,IAAY,EAAE,UAAmB,EAAE,EAAE;IACnE,MAAM,EAAE,UAAU,GAAG,EAAE,EAAE,GAAG,YAAY,EAAE,GAAG,MAAM,oBAAoB,CAAC,UAAU,CAAC,CAAC;IACpF,MAAM,gBAAgB,GAAG,kBAAkB,CAAC,YAAY,EAAE,IAAI,CAAC,CAAC;IAEhE,OAAO,WAAW,CAAC,gBAAgB,EAAE,UAAU,CAAC,CAAC;AACnD,CAAC,CAAC;AAEF,MAAM,aAAa,GAAG,KAAK,EAAE,IAAI,GAAG,KAAK,EAAE,UAAmB,EAAE,EAAE;IAChE,MAAM,UAAU,GAAG,MAAM,gBAAgB,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;IAC5D,MAAM,EAAE,OAAO,EAAE,iBAAiB,EAAE,GAAG,MAAM,MAAM,CAAC,kBAAkB,IAAI,KAAK,CAAC,CAAC;IAEjF,OAAO,WAAW,CAAC,iBAAiB,EAAE,UAAU,CAAC,CAAC;AACpD,CAAC,CAAC;AAEF,OAAO,EAAE,aAAa,EAAE,CAAC"}
+{"version":3,"file":"get-vite-config.js","sourceRoot":"","sources":["../../src/common/get-vite-config.ts"],"names":[],"mappings":"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"}