@havocrao/picktui 0.1.0 → 0.1.1

package/dist/esm/model.js

@@ -0,0 +1,332 @@
+/**
+ * model — 过滤选择器 TUI 状态机（纯逻辑，无 IO，可独立单测）。
+ *
+ * 对齐 Go 引擎 model：布局为 标题栏 / 分隔线 / 列表（视口滚动）/ 分隔线 /
+ * 输入行（闪烁光标）/ 状态栏；按键行为（循环移动、数字直选、多选勾选、
+ * ctrl+u/w 编辑）与引擎逐键一致。
+ *
+ * 本模块不接触终端：交互循环（tty.ts）只负责 按键 → update → view → 渲染。
+ */
+import { filterCands, highlightRanges } from './filter.js';
+/** 气泡风格配色开关（NO_COLOR 环境变量时降级纯文本，保障脚本输出干净）。 */
+let colorEnabled = true;
+export function setColorEnabled(v) {
+    colorEnabled = v;
+}
+export function isColorEnabled() {
+    return colorEnabled;
+}
+/** 样式（对齐引擎 lipgloss 调色：120 亮绿 / 241 灰 / 36 青绿 / 213 粉 / 237 分隔）。 */
+const STYLES = {
+    title: '\x1b[1;38;5;120m',
+    dim: '\x1b[38;5;241m',
+    ok: '\x1b[1;38;5;36m',
+    hl: '\x1b[38;5;213m',
+    cur: '\x1b[1;38;5;120m',
+    sep: '\x1b[38;5;237m',
+    prompt: '\x1b[1;38;5;120m',
+    reset: '\x1b[0m',
+};
+/** 包裹样式（颜色关闭时原样返回）。 */
+function paint(name, s) {
+    if (!colorEnabled) {
+        return s;
+    }
+    return STYLES[name] + s + STYLES.reset;
+}
+/** 固定行数：标题(1) + 分隔线(1) + [列表] + 分隔线(1) + 输入(1) + 状态(1)。 */
+const FIXED_LINES = 5;
+export function newModel(opts) {
+    let initial = opts.initial;
+    if (initial < 0 || initial >= opts.cands.length) {
+        initial = 0;
+    }
+    const m = {
+        opts,
+        filtered: [],
+        query: opts.query,
+        cursor: initial,
+        scrollY: 0,
+        height: 0,
+        width: 0,
+        phase: 0,
+        cancelled: false,
+        quit: false,
+        selected: new Set(opts.selected),
+    };
+    recompute(m);
+    return m;
+}
+/** 多选模式：按 Cands 顺序返回勾选的 Value 列表。 */
+export function selectedValues(m) {
+    if (m.selected.size === 0) {
+        return [];
+    }
+    const out = [];
+    for (const c of m.opts.cands) {
+        if (m.selected.has(c.value)) {
+            out.push(c.value);
+        }
+    }
+    return out;
+}
+/** 根据当前 query 重新过滤，保持光标在有效范围内。 */
+function recompute(m) {
+    m.filtered = filterCands(m.opts.cands, m.query, m.opts.filterOpts);
+    if (m.cursor >= m.filtered.length) {
+        m.cursor = m.filtered.length - 1;
+    }
+    if (m.cursor < 0) {
+        m.cursor = 0;
+    }
+    ensureVisible(m);
+}
+/** 处理一个按键，返回新模型（不可变；变化时替换字段）。 */
+export function update(m, key) {
+    switch (key) {
+        case 'ctrl+c':
+        case 'esc':
+            return { ...m, cancelled: true, quit: true };
+        case 'enter':
+            if (m.filtered.length > 0) {
+                return { ...m, quit: true };
+            }
+            return m;
+        case 'space':
+            // 多选模式：无过滤输入时空格勾选/取消；否则空格作为过滤字符
+            if (m.opts.multi && m.query === '' && m.cursor < m.filtered.length) {
+                const v = m.filtered[m.cursor].value;
+                const next = new Set(m.selected);
+                if (next.has(v)) {
+                    next.delete(v);
+                }
+                else {
+                    next.add(v);
+                }
+                return { ...m, selected: next };
+            }
+            return appendQuery(m, ' ');
+        case 'up':
+        case 'k':
+        case 'ctrl+p':
+            return stepCursor(m, -1);
+        case 'down':
+        case 'j':
+        case 'ctrl+n':
+        case 'tab':
+            return stepCursor(m, 1);
+        case 'backspace':
+            if (m.query.length > 0) {
+                const runes = [...m.query];
+                runes.pop();
+                return recomputeQuery(m, runes.join(''));
+            }
+            return m;
+        case 'ctrl+u':
+            return recomputeQuery(m, '');
+        case 'ctrl+w':
+            return recomputeQuery(m, dropLastField(m.query));
+        default: {
+            // 统一为字符串处理（tty 键 'k'/'j' 等已在上方 case 匹配；数字是字符串）
+            const s = typeof key === 'object' ? key.value : key;
+            // 数字直选（菜单）：无输入时 1-9 跳过逐行移动快速选中
+            if (m.opts.jumpKeys && m.query === '' && /^[1-9]$/.test(s)) {
+                const n = Number(s);
+                if (n - 1 < m.filtered.length) {
+                    return { ...m, cursor: n - 1, quit: true };
+                }
+                return m;
+            }
+            if (s === '') {
+                return m; // 被忽略的键（如左右方向键）
+            }
+            return appendQuery(m, s);
+        }
+    }
+}
+function appendQuery(m, s) {
+    return recomputeQuery(m, m.query + s);
+}
+function recomputeQuery(m, q) {
+    const next = { ...m, query: q };
+    recompute(next);
+    return next;
+}
+/** 循环移动：首项按上键回到末项，末项按下键回到首项。 */
+function stepCursor(m, delta) {
+    const n = m.filtered.length;
+    if (n <= 1) {
+        return m;
+    }
+    const cursor = (m.cursor + delta + n) % n;
+    const next = { ...m, cursor };
+    ensureVisible(next);
+    return next;
+}
+/** ctrl+w：去掉最后一词（与 Go strings.Fields 同语义）。 */
+function dropLastField(q) {
+    const fields = q.trim().split(/\s+/).filter(Boolean);
+    if (fields.length === 0) {
+        return '';
+    }
+    return fields.slice(0, -1).join(' ');
+}
+/** 调整视口使光标可见（固定行数 5）。 */
+function ensureVisible(m) {
+    const visibleRows = visibleRowsOf(m);
+    if (m.cursor < m.scrollY) {
+        m.scrollY = m.cursor;
+    }
+    if (m.cursor >= m.scrollY + visibleRows) {
+        m.scrollY = m.cursor - visibleRows + 1;
+    }
+}
+function visibleRowsOf(m) {
+    const rows = m.height - FIXED_LINES;
+    return rows > 0 ? rows : 10; // 尺寸未到达时的默认值
+}
+/** 渲染整屏画面（带 ANSI 样式）。 */
+export function view(m) {
+    const width = m.width > 0 ? m.width : 80;
+    const sep = paint('sep', '─'.repeat(width));
+    const out = [];
+    // 标题栏
+    let head = paint('title', m.opts.title);
+    if (m.opts.subtitle) {
+        head += paint('dim', '  ·  ' + m.opts.subtitle);
+    }
+    out.push(head, sep);
+    // 列表（视口区间）
+    const visibleRows = visibleRowsOf(m);
+    const end = Math.min(m.scrollY + visibleRows, m.filtered.length);
+    for (let i = m.scrollY; i < end; i++) {
+        const c = m.filtered[i];
+        let box = '';
+        if (m.opts.multi) {
+            box = m.selected.has(c.value) ? paint('ok', '[x] ') : '[ ] ';
+        }
+        if (i === m.cursor) {
+            // 光标行：整行绿色粗体（不再嵌套命中高亮，避免内层 reset 破坏外层颜色）
+            let line = '  ▸ ' + box + c.value;
+            if (c.desc) {
+                line += '  ' + c.desc;
+            }
+            const pad = width - displayWidth(line);
+            if (pad > 0) {
+                line += ' '.repeat(pad);
+            }
+            out.push(paint('cur', line));
+        }
+        else {
+            out.push('    ' + box + renderCandidateLine(c, m.query, m.opts.filterOpts, width));
+        }
+    }
+    if (m.filtered.length === 0) {
+        out.push(paint('dim', '    (no matches)'));
+    }
+    // 分隔线 + 输入行 + 状态栏
+    out.push(sep);
+    const cursorBlock = m.phase === 1 ? ' ' : '▏';
+    out.push(paint('prompt', '❯ ') + m.query + cursorBlock);
+    const count = `${m.filtered.length}/${m.opts.cands.length}`;
+    let status = '  ' + paint('ok', count);
+    if (m.opts.statusHint) {
+        status += paint('dim', '  ·  ' + m.opts.statusHint);
+    }
+    out.push(status);
+    return out.join('\n') + '\n';
+}
+/** 渲染候选行：value 命中高亮 + 灰色描述（按显示宽度截断）。 */
+function renderCandidateLine(c, query, opts, width) {
+    const value = renderHighlighted(c.value, query, opts);
+    if (!c.desc) {
+        return value;
+    }
+    // 描述仅占 value 之后的剩余宽度（减 2 个分隔空格），太窄就不展示
+    const remaining = width - displayWidth(value) - 2;
+    if (remaining < 4) {
+        return value;
+    }
+    return value + '  ' + paint('dim', truncateWidth(c.desc, remaining));
+}
+/** 按显示宽度截断 s，超长末尾补 …。 */
+export function truncateWidth(s, maxWidth) {
+    if (maxWidth <= 1) {
+        return '…';
+    }
+    if (displayWidth(s) <= maxWidth) {
+        return s;
+    }
+    let out = '';
+    let w = 0;
+    for (const r of s) {
+        const rw = charWidth(r);
+        if (w + rw > maxWidth - 1) {
+            break;
+        }
+        out += r;
+        w += rw;
+    }
+    return out + '…';
+}
+/** 渲染候选字符串，高亮匹配片段（粉色）。 */
+function renderHighlighted(s, query, opts) {
+    const ranges = highlightRanges(s, query, opts);
+    if (ranges.length === 0) {
+        return s;
+    }
+    const runes = [...s];
+    let out = '';
+    let pos = 0;
+    for (const [start, end] of ranges) {
+        if (pos < start) {
+            out += runes.slice(pos, start).join('');
+        }
+        out += paint('hl', runes.slice(start, end).join(''));
+        pos = end;
+    }
+    if (pos < runes.length) {
+        out += runes.slice(pos).join('');
+    }
+    return out;
+}
+/** 字符显示宽度（简化 wcwidth：CJK/全角=2，控制符=0，其余=1）。 */
+export function charWidth(ch) {
+    const cp = ch.codePointAt(0) ?? 0;
+    if (cp < 0x20 || cp === 0x7f) {
+        return 0;
+    }
+    if (isWide(cp)) {
+        return 2;
+    }
+    return 1;
+}
+/** 字符串显示宽度。 */
+export function displayWidth(s) {
+    let w = 0;
+    for (const ch of s) {
+        w += charWidth(ch);
+    }
+    return w;
+}
+/** East Asian Wide / Fullwidth / emoji 等宽字符区间判定。 */
+function isWide(cp) {
+    return ((cp >= 0x1100 && cp <= 0x115f) || // Hangul Jamo
+        (cp >= 0x2e80 && cp <= 0x303e) || // CJK Radicals 等
+        (cp >= 0x3041 && cp <= 0x33ff) || // 假名 / CJK 符号
+        (cp >= 0x3400 && cp <= 0x4dbf) || // CJK 扩展 A
+        (cp >= 0x4e00 && cp <= 0x9fff) || // CJK 统一表意
+        (cp >= 0xa000 && cp <= 0xa4cf) || // 彝文
+        (cp >= 0xa960 && cp <= 0xa97f) || // Hangul Jamo Extended-A
+        (cp >= 0xac00 && cp <= 0xd7a3) || // Hangul 音节
+        (cp >= 0xf900 && cp <= 0xfaff) || // CJK 兼容表意
+        (cp >= 0xfe10 && cp <= 0xfe19) || // 竖排形式
+        (cp >= 0xfe30 && cp <= 0xfe52) ||
+        (cp >= 0xfe54 && cp <= 0xfe66) ||
+        (cp >= 0xfe68 && cp <= 0xfe6b) ||
+        (cp >= 0xff00 && cp <= 0xff60) || // 全角形式
+        (cp >= 0xffe0 && cp <= 0xffe6) ||
+        (cp >= 0x1f1e6 && cp <= 0x1f1ff) || // 区域指示符（旗帜）
+        (cp >= 0x1f300 && cp <= 0x1faff) // emoji
+    );
+}

package/dist/esm/toml.js

@@ -0,0 +1,216 @@
+/** 裸 key 允许的字符（对齐 TOML bare key；其余 key 编码时加引号）。 */
+const BARE_KEY_RE = /^[A-Za-z0-9_-]+$/;
+/** 转义字符串内容（写入值时用）。 */
+export function escapeTomlString(s) {
+    let out = '';
+    for (const ch of s) {
+        switch (ch) {
+            case '\\':
+                out += '\\\\';
+                break;
+            case '"':
+                out += '\\"';
+                break;
+            case '\n':
+                out += '\\n';
+                break;
+            case '\t':
+                out += '\\t';
+                break;
+            case '\r':
+                out += '\\r';
+                break;
+            case '\b':
+                out += '\\b';
+                break;
+            case '\f':
+                out += '\\f';
+                break;
+            default:
+                out += ch;
+        }
+    }
+    return out;
+}
+/** 带引号的字符串字面量（含转义）。 */
+export function quoteTomlString(s) {
+    return '"' + escapeTomlString(s) + '"';
+}
+/** 表头/键名编码：裸 key 直接输出，否则带引号。 */
+export function keyLiteral(key) {
+    return BARE_KEY_RE.test(key) ? key : quoteTomlString(key);
+}
+/**
+ * 解析 TOML 子集。无法解析的行跳过（容错：状态文件损坏不阻断主流程）。
+ * 无任何可解析内容时返回 null。
+ */
+export function parseToml(text) {
+    const doc = new Map();
+    let cur = null;
+    let sawContent = false;
+    for (const rawLine of text.split('\n')) {
+        const line = rawLine.trim();
+        if (line === '' || line.startsWith('#')) {
+            continue;
+        }
+        if (line.startsWith('[') && line.endsWith(']')) {
+            const name = parseQuotedOrBare(line.slice(1, -1).trim());
+            if (name === null) {
+                continue;
+            }
+            cur = new Map();
+            doc.set(name, cur);
+            sawContent = true;
+            continue;
+        }
+        if (cur === null) {
+            continue; // 表头之前的游离键：本包格式不存在，跳过
+        }
+        const eq = line.indexOf('=');
+        if (eq < 0) {
+            continue;
+        }
+        const keyRaw = line.slice(0, eq).trim();
+        const key = parseQuotedOrBare(keyRaw);
+        if (key === null) {
+            continue;
+        }
+        const valueRaw = line.slice(eq + 1).trim();
+        const value = parseTomlValue(valueRaw);
+        if (value === null) {
+            continue;
+        }
+        cur.set(key, value);
+        sawContent = true;
+    }
+    if (!sawContent) {
+        return null;
+    }
+    return doc;
+}
+/** 解析 `"quoted"` 或裸字符串；失败返回 null。 */
+function parseQuotedOrBare(s) {
+    if (s.startsWith('"')) {
+        return parseTomlString(s);
+    }
+    return s;
+}
+/** 解析一个 TOML 字符串字面量（从首个引号到闭合引号，含转义）。 */
+function parseTomlString(s) {
+    if (!s.startsWith('"')) {
+        return null;
+    }
+    let out = '';
+    let i = 1;
+    while (i < s.length) {
+        const ch = s[i];
+        if (ch === '"') {
+            return out;
+        }
+        if (ch === '\\') {
+            const esc = s[i + 1];
+            if (esc === undefined) {
+                return null;
+            }
+            switch (esc) {
+                case 'n':
+                    out += '\n';
+                    break;
+                case 't':
+                    out += '\t';
+                    break;
+                case 'r':
+                    out += '\r';
+                    break;
+                case 'b':
+                    out += '\b';
+                    break;
+                case 'f':
+                    out += '\f';
+                    break;
+                case '"':
+                    out += '"';
+                    break;
+                case '\\':
+                    out += '\\';
+                    break;
+                case 'u': {
+                    const hex = s.slice(i + 2, i + 6);
+                    if (!/^[0-9a-fA-F]{4}$/.test(hex)) {
+                        return null;
+                    }
+                    out += String.fromCodePoint(parseInt(hex, 16));
+                    i += 4;
+                    break;
+                }
+                default:
+                    return null; // 不识别的转义
+            }
+            i += 2;
+            continue;
+        }
+        // TOML 基本字符串不允许裸控制字符
+        if (ch < ' ' && ch !== '\t') {
+            return null;
+        }
+        out += ch;
+        i++;
+    }
+    return null; // 未闭合
+}
+/** 解析字符串或字符串数组字面量；失败返回 null。 */
+function parseTomlValue(raw) {
+    if (raw.startsWith('[')) {
+        if (!raw.endsWith(']')) {
+            return null;
+        }
+        const inner = raw.slice(1, -1).trim();
+        if (inner === '') {
+            return [];
+        }
+        const values = [];
+        let i = 0;
+        while (i < inner.length) {
+            const ch = inner[i];
+            if (ch === ',' || ch === ' ' || ch === '\t') {
+                i++;
+                continue;
+            }
+            if (ch === '"') {
+                const start = i;
+                let j = i + 1;
+                let escaped = false;
+                while (j < inner.length) {
+                    const c = inner[j];
+                    if (c === '"' && !escaped) {
+                        break;
+                    }
+                    if (c === '\\' && !escaped) {
+                        escaped = true;
+                    }
+                    else {
+                        escaped = false;
+                    }
+                    j++;
+                }
+                if (j >= inner.length) {
+                    return null;
+                }
+                const literal = parseTomlString(inner.slice(start, j + 1));
+                if (literal === null) {
+                    return null;
+                }
+                values.push(literal);
+                i = j + 1;
+            }
+            else {
+                return null; // 仅支持字符串数组
+            }
+        }
+        return values;
+    }
+    if (raw.startsWith('"')) {
+        return parseTomlString(raw);
+    }
+    return null; // 布尔/数字等非本包类型
+}