@xfe-repo/cli 2.0.11 → 2.0.13

package/dist/completion-core.js

@@ -1,201 +0,0 @@
-/**
- * @xfe-repo/cli - 补全核心（与 UI / shell 协议解耦）
- *
- * 集中维护：命令目录条目类型、查询/输入解析、option/value 建议计算、
- * 已用 flag 过滤、命令寻址、prefilled 提取、模糊匹配。
- *
- * 调用方：
- * - TUI Commands 组件复用全部能力（含模糊匹配 / 二级菜单 / 已用 flag 过滤）
- * - shell / 其他入口可按需复用 catalog 与 option 建议部分，不依赖 UI
- */
-import { parseCommandFlagTokens, splitCommandName, splitFlagTokens } from './command.js';
-// ─── Public API ─────────────────────────────────────────────
-/** 解析 query 是否进入二级菜单模式 */
-export function parseQuery(query, options) {
-    if (!query)
-        return { activeGroup: null, subQuery: '', topQuery: '' };
-    const spaceIndex = query.indexOf(' ');
-    if (spaceIndex > 0) {
-        const groupPart = query.slice(0, spaceIndex);
-        const subQuery = query.slice(spaceIndex + 1).trim();
-        const group = options.find((o) => o.type === 'group' && o.name.toLowerCase() === groupPart);
-        if (group)
-            return { activeGroup: group, subQuery, topQuery: '' };
-    }
-    const exactGroup = options.find((o) => o.type === 'group' && o.name.toLowerCase() === query);
-    if (exactGroup)
-        return { activeGroup: exactGroup, subQuery: '', topQuery: '' };
-    return { activeGroup: null, subQuery: '', topQuery: query };
-}
-/** 顶级查询过滤 + 评分排序 */
-export function filterTopLevel(options, query) {
-    return options
-        .filter((item) => fuzzyMatch(item.name, query))
-        .sort((a, b) => matchScore(a.name, query) - matchScore(b.name, query));
-}
-/** 二级子命令过滤：同时尝试匹配完整名和 action 名 */
-export function filterSubCommands(options, query) {
-    return options
-        .filter((opt) => {
-        const action = splitCommandName(opt.name).action;
-        return fuzzyMatch(action, query) || fuzzyMatch(opt.name, query);
-    })
-        .sort((a, b) => {
-        const aAction = splitCommandName(a.name).action;
-        const bAction = splitCommandName(b.name).action;
-        return matchScore(aAction, query) - matchScore(bAction, query);
-    });
-}
-/**
- * 识别 `<cmd> [--k=v ...] [--partial]` 形式的输入，返回 extras 模式
- *
- * 末尾 `--key=` 进入 value 模式；`--key` / `--` / 空 进入 name 模式
- */
-export function parseExtrasMode(rawQuery, options) {
-    const split = splitCommandAndFlags(rawQuery, options);
-    if (!split || !split.command.options?.length)
-        return null;
-    const { command, flagTokens, endsWithSpace } = split;
-    if (flagTokens.length === 0 && !endsWithSpace)
-        return null;
-    const newFlag = endsWithSpace || flagTokens.length === 0;
-    const usedNames = collectUsedNames(newFlag ? flagTokens : flagTokens.slice(0, -1));
-    if (newFlag)
-        return { kind: 'name', command, partial: '', usedNames };
-    const last = flagTokens[flagTokens.length - 1];
-    if (!last.startsWith('--'))
-        return null;
-    const eqIdx = last.indexOf('=');
-    if (eqIdx >= 0) {
-        const rawKey = last.slice(2, eqIdx);
-        const partial = last.slice(eqIdx + 1);
-        const opt = command.options?.find((o) => o.name.toLowerCase() === rawKey.toLowerCase());
-        if (!opt?.enumValues?.length)
-            return null;
-        return { kind: 'value', command, key: opt.name, partial, values: opt.enumValues };
-    }
-    return { kind: 'name', command, partial: last.slice(2), usedNames };
-}
-/** extras 模式建议项（option 名或枚举值） */
-export function buildExtrasSuggestions(mode) {
-    if (mode.kind === 'value') {
-        const partial = mode.partial.toLowerCase();
-        return mode.values
-            .filter((v) => !partial || v.toLowerCase().startsWith(partial))
-            .map((v) => ({ name: v, description: '', type: 'value' }));
-    }
-    const partial = mode.partial.toLowerCase();
-    return (mode.command.options ?? [])
-        .filter((o) => !mode.usedNames.has(o.name.toLowerCase()))
-        .filter((o) => !partial || o.name.toLowerCase().startsWith(partial))
-        .map((o) => ({ name: o.name, description: o.description, type: 'option' }));
-}
-/** extras 模式 Tab 补全：替换末尾未完成 token，或在末尾空格后追加新 flag */
-export function applyExtrasCompletion(input, mode, selected) {
-    const lastSpace = input.lastIndexOf(' ');
-    const prefix = input.slice(0, lastSpace + 1);
-    if (mode.kind === 'value')
-        return `${prefix}--${mode.key}=${selected} `;
-    const isBoolean = mode.command.options?.find((o) => o.name === selected)?.isBoolean === true;
-    return `${prefix}${isBoolean ? `--${selected} ` : `--${selected}=`}`;
-}
-/** 输入包含 flag 时尝试解析对应命令；不依赖命令是否声明 options，仅用于建议回显 */
-export function resolveMatchedCommandWithFlags(rawQuery, options) {
-    const split = splitFlagTokens(rawQuery);
-    if (!split || split.flagTokens.length === 0)
-        return null;
-    if (split.cmdTokens.length === 0 || split.cmdTokens.length > 2)
-        return null;
-    return resolveCommand(split.cmdTokens.join(' '), options);
-}
-/** Enter 提交时把 `/cmd --k1=v1 --k2 v2` 解析为命令 + prefilled */
-export function extractCommandAndPrefilled(input, options) {
-    const raw = input.startsWith('/') ? input.slice(1) : '';
-    const split = splitCommandAndFlags(raw, options);
-    if (!split || split.flagTokens.length === 0)
-        return { command: null, prefilled: {} };
-    return {
-        command: split.command,
-        prefilled: parseCommandFlagTokens(split.flagTokens, split.command.options),
-    };
-}
-/** 判断输入是否已经包含 `--flag` token */
-export function hasFlagToken(input) {
-    const raw = input.startsWith('/') ? input.slice(1) : input;
-    const split = splitFlagTokens(raw);
-    return !!split && split.flagTokens.length > 0;
-}
-// ─── Helpers ────────────────────────────────────────────────
-/**
- * 把 `<cmd...> [--flag ...]` 查询拆分为命令 + flag tokens
- *
- * 在 splitFlagTokens 基础上叠加目录解析，限制命令 tokens ≤ 2（顶级命令 或 group+action）
- */
-function splitCommandAndFlags(rawQuery, options) {
-    const split = splitFlagTokens(rawQuery);
-    if (!split || split.cmdTokens.length === 0 || split.cmdTokens.length > 2)
-        return null;
-    const command = resolveCommand(split.cmdTokens.join(' '), options);
-    if (!command)
-        return null;
-    return { command, flagTokens: split.flagTokens, endsWithSpace: split.endsWithSpace };
-}
-/** 通过 `<name>` 或 `<group> <action>` 解析命令 */
-function resolveCommand(cmdPart, options) {
-    const parts = cmdPart.trim().split(/\s+/);
-    if (parts.length === 1)
-        return findCommandByName(options, parts[0]);
-    if (parts.length !== 2)
-        return null;
-    const [groupName, action] = parts;
-    const group = options.find((o) => o.type === 'group' && o.name.toLowerCase() === groupName.toLowerCase());
-    if (!group?.children)
-        return null;
-    return group.children.find((c) => splitCommandName(c.name).action.toLowerCase() === action.toLowerCase()) ?? null;
-}
-function findCommandByName(options, name) {
-    const target = name.toLowerCase();
-    for (const opt of options) {
-        if (opt.type === 'group') {
-            const found = opt.children?.find((c) => c.name.toLowerCase() === target || splitCommandName(c.name).action.toLowerCase() === target);
-            if (found)
-                return found;
-            continue;
-        }
-        if (opt.name.toLowerCase() === target)
-            return opt;
-    }
-    return null;
-}
-function collectUsedNames(flagTokens) {
-    const used = new Set();
-    for (const t of flagTokens) {
-        if (!t.startsWith('--'))
-            continue;
-        const eq = t.indexOf('=');
-        const name = (eq >= 0 ? t.slice(2, eq) : t.slice(2)).toLowerCase();
-        if (name)
-            used.add(name);
-    }
-    return used;
-}
-function matchScore(text, query) {
-    const lower = text.toLowerCase();
-    if (lower.startsWith(query))
-        return 0;
-    if (lower.includes(query))
-        return 1;
-    return 2;
-}
-function fuzzyMatch(text, query) {
-    const lower = text.toLowerCase();
-    if (lower.includes(query))
-        return true;
-    let qi = 0;
-    for (let i = 0; i < lower.length && qi < query.length; i++) {
-        if (lower[i] === query[qi])
-            qi++;
-    }
-    return qi === query.length;
-}
-//# sourceMappingURL=completion-core.js.map

package/dist/completion.d.ts

@@ -1,21 +0,0 @@
-/**
- * @xfe-repo/cli - Shell 补全管理
- *
- * 使用 @bomb.sh/tab 实现 shell 自动补全
- * 通过 Commander.js 适配器集成，支持 zsh / bash / fish
- * install / uninstall 需手动检测 shell 类型并读写配置文件
- */
-import tab from '@bomb.sh/tab/commander';
-import type { Command } from 'commander';
-/**
- * 将 @bomb.sh/tab 补全能力注册到 Commander program（原地修改，包装 program.parse）
- *
- * 返回 RootCommand，可通过 `result.commands.get(name)?.options.get(key)?.handler = ...`
- * 注册 option 值补全。
- */
-export declare function initTabCompletion(program: Command): ReturnType<typeof tab>;
-/** 安装 shell 自动补全到当前 shell 配置文件 */
-export declare function installShellCompletion(): void;
-/** 卸载 shell 自动补全（从配置文件中删除相关行） */
-export declare function uninstallShellCompletion(): void;
-//# sourceMappingURL=completion.d.ts.map

package/dist/completion.js

@@ -1,127 +0,0 @@
-/**
- * @xfe-repo/cli - Shell 补全管理
- *
- * 使用 @bomb.sh/tab 实现 shell 自动补全
- * 通过 Commander.js 适配器集成，支持 zsh / bash / fish
- * install / uninstall 需手动检测 shell 类型并读写配置文件
- */
-import fs from 'node:fs';
-import os from 'node:os';
-import path from 'node:path';
-import { execSync } from 'node:child_process';
-import tab from '@bomb.sh/tab/commander';
-/** 根据 $SHELL 环境变量检测当前 shell 类型 */
-function detectShell() {
-    const shell = process.env.SHELL ?? '';
-    if (shell.endsWith('zsh'))
-        return 'zsh';
-    if (shell.endsWith('bash'))
-        return 'bash';
-    if (shell.endsWith('fish'))
-        return 'fish';
-    return 'zsh';
-}
-function getShellConfig(shell) {
-    const home = os.homedir();
-    switch (shell) {
-        case 'zsh':
-            return {
-                rcFile: path.join(home, '.zshrc'),
-                sourceLine: 'source <(xfe complete zsh)',
-            };
-        case 'bash':
-            return {
-                rcFile: path.join(home, '.bashrc'),
-                sourceLine: 'source <(xfe complete bash)',
-            };
-        case 'fish':
-            return {
-                rcFile: path.join(home, '.config', 'fish', 'completions', 'xfe.fish'),
-                sourceLine: '', // fish 采用直接写入策略
-            };
-    }
-}
-// ============================================================
-// 公开 API
-// ============================================================
-/**
- * 将 @bomb.sh/tab 补全能力注册到 Commander program（原地修改，包装 program.parse）
- *
- * 返回 RootCommand，可通过 `result.commands.get(name)?.options.get(key)?.handler = ...`
- * 注册 option 值补全。
- */
-export function initTabCompletion(program) {
-    return tab(program);
-}
-/** 安装 shell 自动补全到当前 shell 配置文件 */
-export function installShellCompletion() {
-    const shell = detectShell();
-    const config = getShellConfig(shell);
-    if (shell === 'fish') {
-        installFishCompletion(config.rcFile);
-        return;
-    }
-    const { rcFile, sourceLine } = config;
-    // 如果配置文件中已存在补全行则幂等跳过
-    if (fs.existsSync(rcFile)) {
-        const content = fs.readFileSync(rcFile, 'utf8');
-        if (content.includes(sourceLine)) {
-            console.log(`✅ 补全已存在于 ${rcFile}，无需重复安装`);
-            return;
-        }
-    }
-    fs.appendFileSync(rcFile, `\n# xfe shell completion\n${sourceLine}\n`);
-    console.log(`✅ 补全已安装到 ${rcFile}`);
-    console.log(`   请运行 \`source ${rcFile}\` 或重新打开终端以生效`);
-}
-/** 卸载 shell 自动补全（从配置文件中删除相关行） */
-export function uninstallShellCompletion() {
-    const shell = detectShell();
-    const config = getShellConfig(shell);
-    if (shell === 'fish') {
-        uninstallFishCompletion(config.rcFile);
-        return;
-    }
-    const { rcFile, sourceLine } = config;
-    if (!fs.existsSync(rcFile)) {
-        console.log(`⚠️  配置文件 ${rcFile} 不存在，无需卸载`);
-        return;
-    }
-    const original = fs.readFileSync(rcFile, 'utf8');
-    const cleaned = original
-        .split('\n')
-        .filter((line) => line !== sourceLine && line !== '# xfe shell completion')
-        .join('\n')
-        .replace(/\n{3,}/g, '\n\n'); // 合并多余空行
-    if (original === cleaned) {
-        console.log(`⚠️  未在 ${rcFile} 中找到 xfe 补全配置，无需卸载`);
-        return;
-    }
-    fs.writeFileSync(rcFile, cleaned, 'utf8');
-    console.log(`✅ 补全已从 ${rcFile} 中移除`);
-}
-// ============================================================
-// Fish 专用处理（直接写入补全文件）
-// ============================================================
-function installFishCompletion(completionFile) {
-    const dir = path.dirname(completionFile);
-    if (!fs.existsSync(dir))
-        fs.mkdirSync(dir, { recursive: true });
-    try {
-        const script = execSync('xfe complete fish', { encoding: 'utf8' });
-        fs.writeFileSync(completionFile, script, 'utf8');
-        console.log(`✅ Fish 补全已安装到 ${completionFile}`);
-    }
-    catch {
-        console.error('❌ 生成 fish 补全脚本失败，请确认 xfe 已正确安装');
-    }
-}
-function uninstallFishCompletion(completionFile) {
-    if (!fs.existsSync(completionFile)) {
-        console.log(`⚠️  Fish 补全文件 ${completionFile} 不存在，无需卸载`);
-        return;
-    }
-    fs.unlinkSync(completionFile);
-    console.log(`✅ Fish 补全文件 ${completionFile} 已删除`);
-}
-//# sourceMappingURL=completion.js.map