berry-agent-sdk 0.1.0-alpha.2

package/dist/src/channels/tui/editor/editor-view.js

@@ -0,0 +1,141 @@
+import { prefixDisplayWidth } from './visual-lines.js';
+import { ACCENT_INDEX } from '../theme.js';
+import { ansiColor } from '../../engine/index.js';
+/** 边框字符（制表符单宽——写格按字素推进） */
+const BORDER_TOP_LEFT = '┌';
+const BORDER_TOP_RIGHT = '┐';
+const BORDER_BOTTOM_LEFT = '└';
+const BORDER_BOTTOM_RIGHT = '┘';
+const BORDER_H = '─';
+const BORDER_V = '│';
+/** 聚焦态边框样式（accent 定值——theme 单源） */
+const FOCUSED_BORDER = Object.freeze({ fg: ansiColor(ACCENT_INDEX) });
+/** 最大可视行数缺省（装配层按终端高 30% 注入覆盖——pi 同形 max(5, rows*0.3)） */
+const DEFAULT_MAX_VISIBLE_LINES = 8;
+/**
+ * 编辑器视图：模型只读消费 + 自持视口偏移；measure / render 双段协商。
+ */
+export class EditorView {
+    model;
+    focused = false;
+    /** 视口首行（视觉行下标——render 时对光标夹取自愈） */
+    scrollOffset = 0;
+    maxVisibleLines;
+    constructor(model, options = {}) {
+        this.model = model;
+        this.maxVisibleLines = Math.max(1, options.maxVisibleLines ?? DEFAULT_MAX_VISIBLE_LINES);
+    }
+    /** 聚焦态切换（事件路由裁决后由组件调用） */
+    setFocused(focused) {
+        this.focused = focused;
+    }
+    /** 量高：边框 2 + 视觉行数夹 maxVisibleLines（量高即分配承诺——不超卖） */
+    measure(width) {
+        this.model.setLayoutWidth(innerWidth(width));
+        const count = this.model.visualLines().length;
+        return 2 + Math.min(count, this.maxVisibleLines);
+    }
+    /** 落位渲染：边框 → 视口行 → 预编辑段 → 光标声明 */
+    render(buffer, region) {
+        const innerW = innerWidth(region.width);
+        const innerH = region.height - 2;
+        this.model.setLayoutWidth(innerW);
+        if (innerH <= 0 || innerW <= 0)
+            return; // 边框都容不下——防御位
+        const map = this.model.visualLines();
+        const cursorVL = this.model.currentVisualLine(map);
+        // 视口夹取自愈：光标恒可视（滚出上方提顶 / 滚出下方沉底）
+        this.scrollOffset = clampScroll(this.scrollOffset, cursorVL, innerH, map.length);
+        this.drawBorder(buffer, region, map.length);
+        this.drawContent(buffer, region, map, innerH);
+        this.drawCursor(buffer, region, map, cursorVL);
+    }
+    /* ---------------- 边框（含滚动指示） ---------------- */
+    drawBorder(buffer, region, totalLines) {
+        const style = this.focused ? FOCUSED_BORDER : undefined;
+        const lastRow = region.row + region.height - 1;
+        const lastCol = region.col + region.width - 1;
+        // 四角
+        buffer.setCell(region.row, region.col, BORDER_TOP_LEFT, style);
+        buffer.setCell(region.row, lastCol, BORDER_TOP_RIGHT, style);
+        buffer.setCell(lastRow, region.col, BORDER_BOTTOM_LEFT, style);
+        buffer.setCell(lastRow, lastCol, BORDER_BOTTOM_RIGHT, style);
+        // 横边（顶 / 底）
+        for (let c = region.col + 1; c < lastCol; c++) {
+            buffer.setCell(region.row, c, BORDER_H, style);
+            buffer.setCell(lastRow, c, BORDER_H, style);
+        }
+        // 竖边（左 / 右）
+        for (let r = region.row + 1; r < lastRow; r++) {
+            buffer.setCell(r, region.col, BORDER_V, style);
+            buffer.setCell(r, lastCol, BORDER_V, style);
+        }
+        // 滚动指示（有溢出才显——写入边框行右端、覆盖既有横边格）
+        const above = this.scrollOffset;
+        const below = totalLines - this.scrollOffset - (region.height - 2);
+        if (above > 0)
+            this.writeIndicator(buffer, region.row, lastCol, ` ↑${above}`, style);
+        if (below > 0)
+            this.writeIndicator(buffer, lastRow, lastCol, ` ↓${below}`, style);
+    }
+    /** 右端对齐写入指示文本（覆盖边框横格；越界由缓冲吸收） */
+    writeIndicator(buffer, row, lastCol, text, style) {
+        buffer.writeText(row, lastCol - text.length, text, style);
+    }
+    /* ---------------- 正文（视口内视觉行） ---------------- */
+    drawContent(buffer, region, map, innerH) {
+        const lines = this.model.getLines();
+        const preedit = this.model.pendingPreedit;
+        const cursor = this.model.getCursor();
+        const end = Math.min(map.length, this.scrollOffset + innerH);
+        for (let vi = this.scrollOffset; vi < end; vi++) {
+            const seg = map[vi];
+            const row = region.row + 1 + (vi - this.scrollOffset);
+            const line = lines[seg.line] ?? '';
+            const plain = line.slice(seg.startCol, seg.startCol + seg.length);
+            // 光标在本段且组字中：前缀 + 预编辑（下划线）+ 后缀三段呈现
+            if (preedit !== null &&
+                seg.line === cursor.line &&
+                cursor.col >= seg.startCol &&
+                cursor.col <= seg.startCol + seg.length) {
+                const prefix = line.slice(seg.startCol, cursor.col);
+                const suffix = line.slice(cursor.col, seg.startCol + seg.length);
+                const next = buffer.writeText(row, region.col + 1, prefix);
+                const afterPreedit = buffer.writeText(row, next, preedit, PREEDIT_STYLE);
+                buffer.writeText(row, afterPreedit, suffix);
+                continue;
+            }
+            buffer.writeText(row, region.col + 1, plain);
+        }
+    }
+    /* ---------------- 光标声明（聚焦态独占） ---------------- */
+    drawCursor(buffer, region, map, cursorVL) {
+        if (!this.focused)
+            return; // 非聚焦不声明——不抢其他交互件的本帧声明
+        const seg = map[cursorVL];
+        const cursor = this.model.getCursor();
+        const line = this.model.getLines()[seg.line] ?? '';
+        // 光标段内显示列（前缀宽差——宽字素边界由模型算术保证，落在首列）
+        const displayCol = prefixDisplayWidth(line, cursor.col) - prefixDisplayWidth(line, seg.startCol);
+        const preedit = this.model.pendingPreedit;
+        const preeditCols = preedit !== null ? prefixDisplayWidth(preedit, preedit.length) : 0;
+        buffer.setCursor(region.row + 1 + (cursorVL - this.scrollOffset), region.col + 1 + displayCol + preeditCols);
+    }
+}
+/** 预编辑段样式（下划线——组字中的挂起提示） */
+const PREEDIT_STYLE = Object.freeze({ underline: true });
+/** 内容区宽（左右边框各 1） */
+function innerWidth(width) {
+    return Math.max(0, width - 2);
+}
+/** 视口夹取：光标滚出上方提顶、滚出下方沉底；内容短于视口归零 */
+function clampScroll(offset, cursorVL, innerH, total) {
+    let next = offset;
+    if (cursorVL < next)
+        next = cursorVL;
+    if (cursorVL >= next + innerH)
+        next = cursorVL - innerH + 1;
+    const maxOffset = Math.max(0, total - innerH);
+    return Math.min(Math.max(0, next), maxOffset);
+}
+//# sourceMappingURL=editor-view.js.map

package/dist/src/channels/tui/editor/editor-view.js.map

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

package/dist/src/channels/tui/editor/editor.d.ts

@@ -0,0 +1,50 @@
+/**
+ * 多行输入件（Editor 件族组装件）：模型 + 视图组合 + 输入事件分发。
+ *
+ * 事件面（07 §4.1 引擎节件 6（组件与呈现装配件） 输入件条款 + 批 10c 输入事件模型）：
+ * - handleEvent 四路分发（key / text / ime / paste），返回是否消费；
+ * - mouse 事件零消费直达 false（主屏零鼠标——到达即吞归上层；2026-09-11
+ *   鼠标解码批输入模型扩五分，本件非 mouse 消费方）；
+ * - ctrl+c 不消费（返 false 归上层 abort 路——复制语义在无选区模型下无承接）；
+ * - 键位表平移 pi keybindings（本仓化差异：undo 双绑 ctrl+- / ctrl+_ ——
+ *   kitty 轨 ctrl+- 规范形、legacy 轨 0x1f 解码为 '_'）；
+ * - jump 词向两态（ctrl+] / ctrl+alt+] 进入待靶态、下一可打印字符为靶）；
+ * - ↑ 在首视觉行且（空框 / 浏览态 / 行首）触发历史回溯，否则视觉行上移；
+ *   ↓ 在末视觉行触发历史回新，否则下移。
+ */
+import type { CellBuffer, InputEvent, Region, Renderable } from '../../engine/index.js';
+import { EditorModel } from './editor-model.js';
+import { EditorView } from './editor-view.js';
+/** 组件装配面 */
+export interface EditorOptions {
+    /** 提交回调（trim 后非空才触发；历史入册在组件内先于回调完成） */
+    onSubmit?: (text: string) => void;
+    /** 内容变更通知（装配层接重绘请求） */
+    onChange?: (text: string) => void;
+    /** 最大可视行数（装配层按终端高 30% 注入；缺省 8） */
+    maxVisibleLines?: number;
+}
+/**
+ * 多行输入组件：状态归模型、呈现归视图、本件只做事件分发与装配面。
+ */
+export declare class Editor implements Renderable {
+    readonly model: EditorModel;
+    readonly view: EditorView;
+    /** jump 待靶方向（null = 常态） */
+    private jumpPending;
+    private readonly onSubmit;
+    private readonly pageSize;
+    constructor(options?: EditorOptions);
+    /** 聚焦态切换（事件路由器裁决） */
+    setFocused(focused: boolean): void;
+    getText(): string;
+    setText(text: string): void;
+    measure(width: number): number;
+    render(buffer: CellBuffer, region: Region): void;
+    /** 四路分发：返回是否消费（false = 归上层，如 ctrl+c 的 abort 路） */
+    handleEvent(event: InputEvent): boolean;
+    /** 键事件路（release 相不动作；ctrl+c 显式透传） */
+    private handleKey;
+    /** 提交：模型全清取文、非空才入册 + 回调 */
+    private handleSubmit;
+}

package/dist/src/channels/tui/editor/editor.js

@@ -0,0 +1,276 @@
+import { EditorModel } from './editor-model.js';
+import { EditorView } from './editor-view.js';
+/* ---------------- 键位表（pi 平移——见类注差异注记） ---------------- */
+const SUBMIT = [{ key: 'enter' }];
+const NEW_LINE = [
+    { key: 'enter', shift: true },
+    { key: 'j', ctrl: true },
+];
+const UNDO = [
+    { key: '-', ctrl: true }, // kitty 轨规范形
+    { key: '_', ctrl: true }, // legacy 轨 0x1f 解码形
+];
+const MOVE_LEFT = [{ key: 'left' }, { key: 'b', ctrl: true }];
+const MOVE_RIGHT = [{ key: 'right' }, { key: 'f', ctrl: true }];
+const MOVE_WORD_LEFT = [
+    { key: 'left', alt: true },
+    { key: 'left', ctrl: true },
+    { key: 'b', alt: true },
+];
+const MOVE_WORD_RIGHT = [
+    { key: 'right', alt: true },
+    { key: 'right', ctrl: true },
+    { key: 'f', alt: true },
+];
+const LINE_START = [{ key: 'home' }, { key: 'a', ctrl: true }];
+const LINE_END = [{ key: 'end' }, { key: 'e', ctrl: true }];
+const JUMP_FORWARD = [{ key: ']', ctrl: true }];
+const JUMP_BACKWARD = [{ key: ']', ctrl: true, alt: true }];
+const PAGE_UP = [{ key: 'pageup' }];
+const PAGE_DOWN = [{ key: 'pagedown' }];
+const DELETE_BACKWARD = [{ key: 'backspace' }];
+const DELETE_FORWARD = [{ key: 'delete' }, { key: 'd', ctrl: true }];
+const DELETE_WORD_BACKWARD = [
+    { key: 'w', ctrl: true },
+    { key: 'backspace', alt: true },
+];
+const DELETE_WORD_FORWARD = [
+    { key: 'd', alt: true },
+    { key: 'delete', alt: true },
+];
+const DELETE_TO_LINE_START = [{ key: 'u', ctrl: true }];
+const DELETE_TO_LINE_END = [{ key: 'k', ctrl: true }];
+const HISTORY_PREV = [{ key: 'up' }];
+const HISTORY_NEXT = [{ key: 'down' }];
+/** 键位匹配（单字符键名大小写不敏感归一——shift 产大写形） */
+function matches(e, b) {
+    if (e.meta)
+        return false;
+    if (e.ctrl !== !!b.ctrl || e.alt !== !!b.alt || e.shift !== !!b.shift)
+        return false;
+    if (e.key === b.key)
+        return true;
+    return e.key.length === 1 && b.key.length === 1 && e.key.toLowerCase() === b.key;
+}
+function matchesAny(e, bindings) {
+    return bindings.some((b) => matches(e, b));
+}
+/** 可打印字符键判（jump 待靶态的靶字符判据——无修饰或仅 shift） */
+function isPlainCharKey(e) {
+    return e.key.length === 1 && !e.ctrl && !e.alt && !e.meta;
+}
+/**
+ * 多行输入组件：状态归模型、呈现归视图、本件只做事件分发与装配面。
+ */
+export class Editor {
+    model;
+    view;
+    /** jump 待靶方向（null = 常态） */
+    jumpPending = null;
+    onSubmit;
+    pageSize;
+    constructor(options = {}) {
+        this.onSubmit = options.onSubmit;
+        this.pageSize = Math.max(1, options.maxVisibleLines ?? 8);
+        this.model = new EditorModel();
+        this.model.onChange = (text) => options.onChange?.(text);
+        this.view = new EditorView(this.model, { maxVisibleLines: options.maxVisibleLines });
+    }
+    /* ---------------- 装配面便捷委托 ---------------- */
+    /** 聚焦态切换（事件路由器裁决） */
+    setFocused(focused) {
+        this.view.setFocused(focused);
+    }
+    getText() {
+        return this.model.getText();
+    }
+    setText(text) {
+        this.model.setText(text);
+    }
+    /* ---------------- 渲染委托（两段协商直通视图） ---------------- */
+    measure(width) {
+        return this.view.measure(width);
+    }
+    render(buffer, region) {
+        this.view.render(buffer, region);
+    }
+    /* ---------------- 输入事件分发 ---------------- */
+    /** 四路分发：返回是否消费（false = 归上层，如 ctrl+c 的 abort 路） */
+    handleEvent(event) {
+        switch (event.kind) {
+            case 'key':
+                return this.handleKey(event);
+            case 'text': {
+                // jump 待靶态：首字符为跳转靶（kitty / legacy 可打印均走 text 事件）
+                if (this.jumpPending !== null && event.text.length > 0) {
+                    this.model.jumpToChar([...event.text][0], this.jumpPending);
+                    this.jumpPending = null;
+                    return true;
+                }
+                this.model.insertText(event.text);
+                return true;
+            }
+            case 'ime':
+                if (event.committed) {
+                    this.model.setPreedit(null);
+                    this.model.insertText(event.text);
+                }
+                else {
+                    this.model.setPreedit(event.text);
+                }
+                return true;
+            case 'paste':
+                // 整段入正文（规范条款——无标记机制，多行粘贴直接呈现）
+                this.jumpPending = null;
+                this.model.insertText(event.text);
+                return true;
+            case 'mouse':
+                return false; // 主屏零鼠标（07 屏模型注）——到达即吞不消费（副屏选区路不经本件）
+        }
+    }
+    /** 键事件路（release 相不动作；ctrl+c 显式透传） */
+    handleKey(e) {
+        if (e.phase === 'release')
+            return false; // 释放相归上层（不消费）
+        // jump 待靶态：escape 取消、可打印字符为靶（key 路防御位——text 路为主）
+        if (this.jumpPending !== null) {
+            if (matchesAny(e, [{ key: 'escape' }])) {
+                this.jumpPending = null;
+                return true;
+            }
+            if (isPlainCharKey(e)) {
+                this.model.jumpToChar(e.key, this.jumpPending);
+                this.jumpPending = null;
+                return true;
+            }
+        }
+        if (e.ctrl && !e.alt && !e.shift && !e.meta && e.key === 'c')
+            return false; // ctrl+c 透传上层 abort
+        if (matchesAny(e, SUBMIT))
+            return this.handleSubmit();
+        if (matchesAny(e, NEW_LINE)) {
+            this.jumpPending = null;
+            this.model.addNewLine();
+            return true;
+        }
+        if (matchesAny(e, UNDO)) {
+            this.jumpPending = null;
+            this.model.undo();
+            return true;
+        }
+        if (matchesAny(e, MOVE_LEFT)) {
+            this.jumpPending = null;
+            this.model.moveLeft();
+            return true;
+        }
+        if (matchesAny(e, MOVE_RIGHT)) {
+            this.jumpPending = null;
+            this.model.moveRight();
+            return true;
+        }
+        if (matchesAny(e, MOVE_WORD_LEFT)) {
+            this.jumpPending = null;
+            this.model.moveWordBackward();
+            return true;
+        }
+        if (matchesAny(e, MOVE_WORD_RIGHT)) {
+            this.jumpPending = null;
+            this.model.moveWordForward();
+            return true;
+        }
+        if (matchesAny(e, LINE_START)) {
+            this.jumpPending = null;
+            this.model.moveHome();
+            return true;
+        }
+        if (matchesAny(e, LINE_END)) {
+            this.jumpPending = null;
+            this.model.moveEnd();
+            return true;
+        }
+        if (matchesAny(e, JUMP_FORWARD)) {
+            this.jumpPending = 'forward';
+            return true;
+        }
+        if (matchesAny(e, JUMP_BACKWARD)) {
+            this.jumpPending = 'backward';
+            return true;
+        }
+        if (matchesAny(e, PAGE_UP)) {
+            this.jumpPending = null;
+            this.model.pageUp(this.pageSize);
+            return true;
+        }
+        if (matchesAny(e, PAGE_DOWN)) {
+            this.jumpPending = null;
+            this.model.pageDown(this.pageSize);
+            return true;
+        }
+        if (matchesAny(e, DELETE_BACKWARD)) {
+            this.jumpPending = null;
+            this.model.backspace();
+            return true;
+        }
+        if (matchesAny(e, DELETE_FORWARD)) {
+            this.jumpPending = null;
+            this.model.deleteForward();
+            return true;
+        }
+        if (matchesAny(e, DELETE_WORD_BACKWARD)) {
+            this.jumpPending = null;
+            this.model.deleteWordBackward();
+            return true;
+        }
+        if (matchesAny(e, DELETE_WORD_FORWARD)) {
+            this.jumpPending = null;
+            this.model.deleteWordForward();
+            return true;
+        }
+        if (matchesAny(e, DELETE_TO_LINE_START)) {
+            this.jumpPending = null;
+            this.model.deleteToLineStart();
+            return true;
+        }
+        if (matchesAny(e, DELETE_TO_LINE_END)) {
+            this.jumpPending = null;
+            this.model.deleteToLineEnd();
+            return true;
+        }
+        if (matchesAny(e, HISTORY_PREV)) {
+            this.jumpPending = null;
+            // 首视觉行 +（空框 / 已在浏览态 / 逻辑行首）→ 历史回溯；否则视觉行上移
+            const cursor = this.model.getCursor();
+            if (this.model.isOnFirstVisualLine() &&
+                (this.model.isEmpty() || this.model.isBrowsingHistory() || cursor.col === 0)) {
+                this.model.navigateHistory(-1);
+            }
+            else {
+                this.model.moveUp();
+            }
+            return true;
+        }
+        if (matchesAny(e, HISTORY_NEXT)) {
+            this.jumpPending = null;
+            // 末视觉行 → 历史回新（含回草稿）；否则视觉行下移
+            if (this.model.isOnLastVisualLine()) {
+                this.model.navigateHistory(1);
+            }
+            else {
+                this.model.moveDown();
+            }
+            return true;
+        }
+        return false; // 未绑定键归上层（escape / f 键 / tab…）
+    }
+    /** 提交：模型全清取文、非空才入册 + 回调 */
+    handleSubmit() {
+        this.jumpPending = null;
+        const text = this.model.submit();
+        if (text !== '') {
+            this.model.addToHistory(text);
+            this.onSubmit?.(text);
+        }
+        return true;
+    }
+}
+//# sourceMappingURL=editor.js.map

package/dist/src/channels/tui/editor/editor.js.map

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

package/dist/src/channels/tui/editor/undo-stack.d.ts

@@ -0,0 +1,22 @@
+/**
+ * 泛型 undo 栈（多行输入件 Editor 件族基件——07 §4.1 引擎节件 6（组件与呈现装配件）
+ * 「undo 上限收 v1」条款的载体）。
+ *
+ * clone-on-push：入栈即深拷贝快照（structuredClone），弹出直付（已脱钩
+ * 无需再拷）；上限超量丢最旧（上限值码面定 100——与输入历史帽同值，
+ * 规范只钉「有上限」不收数字）。
+ */
+/** 快照类型约束：可 structuredClone 的纯数据形 */
+/** undo 栈：深拷贝快照栈 + 上帽丢最旧 */
+export declare class UndoStack<S> {
+    private readonly limit;
+    private readonly stack;
+    constructor(limit?: number);
+    /** 深拷贝入栈（超帽丢最旧——最近编辑永远可撤） */
+    push(state: S): void;
+    /** 弹出最近快照（空栈 undefined） */
+    pop(): S | undefined;
+    /** 清空（提交后弃撤回域） */
+    clear(): void;
+    get length(): number;
+}

package/dist/src/channels/tui/editor/undo-stack.js

@@ -0,0 +1,36 @@
+/**
+ * 泛型 undo 栈（多行输入件 Editor 件族基件——07 §4.1 引擎节件 6（组件与呈现装配件）
+ * 「undo 上限收 v1」条款的载体）。
+ *
+ * clone-on-push：入栈即深拷贝快照（structuredClone），弹出直付（已脱钩
+ * 无需再拷）；上限超量丢最旧（上限值码面定 100——与输入历史帽同值，
+ * 规范只钉「有上限」不收数字）。
+ */
+/** 快照类型约束：可 structuredClone 的纯数据形 */
+// （泛型约束不写死——structuredClone 接受任意可克隆值，调用面以类型保证）
+/** undo 栈：深拷贝快照栈 + 上帽丢最旧 */
+export class UndoStack {
+    limit;
+    stack = [];
+    constructor(limit = 100) {
+        this.limit = limit;
+    }
+    /** 深拷贝入栈（超帽丢最旧——最近编辑永远可撤） */
+    push(state) {
+        this.stack.push(structuredClone(state));
+        if (this.stack.length > this.limit)
+            this.stack.shift();
+    }
+    /** 弹出最近快照（空栈 undefined） */
+    pop() {
+        return this.stack.pop();
+    }
+    /** 清空（提交后弃撤回域） */
+    clear() {
+        this.stack.length = 0;
+    }
+    get length() {
+        return this.stack.length;
+    }
+}
+//# sourceMappingURL=undo-stack.js.map

package/dist/src/channels/tui/editor/undo-stack.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"undo-stack.js","sourceRoot":"","sources":["../../../../../../../src/channels/tui/editor/undo-stack.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,qCAAqC;AACrC,+CAA+C;AAE/C,4BAA4B;AAC5B,MAAM,OAAO,SAAS;IAGS;IAFZ,KAAK,GAAQ,EAAE,CAAC;IAEjC,YAA6B,QAAgB,GAAG;QAAnB,UAAK,GAAL,KAAK,CAAc;IAAG,CAAC;IAEpD,6BAA6B;IAC7B,IAAI,CAAC,KAAQ;QACX,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC,CAAC;QACxC,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,IAAI,CAAC,KAAK;YAAE,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;IACzD,CAAC;IAED,2BAA2B;IAC3B,GAAG;QACD,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC;IAC1B,CAAC;IAED,kBAAkB;IAClB,KAAK;QACH,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC;IACxB,CAAC;IAED,IAAI,MAAM;QACR,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC;IAC3B,CAAC;CACF"}

package/dist/src/channels/tui/editor/visual-lines.d.ts

@@ -0,0 +1,39 @@
+/** 视觉行段（一段 = 一条折行后的可视行） */
+export interface VisualSegment {
+    /** 逻辑行下标 */
+    readonly line: number;
+    /** 段起点在逻辑行内的 UTF-16 下标 */
+    readonly startCol: number;
+    /** 段长（UTF-16 码元数） */
+    readonly length: number;
+    /** 段显示宽（列数） */
+    readonly width: number;
+}
+/** 全文档视觉行映射（逻辑行逐行硬折串接） */
+export declare function buildVisualLineMap(lines: string[], width: number): VisualSegment[];
+/**
+ * 定位逻辑位置所在视觉行下标（col 为 UTF-16）。
+ * 逻辑行末段的末位（col = 行长）属末段——光标在行尾不落「下一段开头」。
+ */
+export declare function findVisualLineAt(map: VisualSegment[], line: number, col: number): number;
+/**
+ * 段内显示列反查 UTF-16 下标：从段起点起累计字素宽，到目标显示列 targetCols
+ * 的字素边界（**光标永不落半字**——目标列落在宽字素中间时吸到其首列前，
+ * 返回该字素起点的 UTF-16 下标）。targetCols 超段宽返回段尾下标。
+ */
+export declare function colAtDisplayColumn(line: string, startCol: number, targetCols: number): number;
+/**
+ * 位置前缀显示宽：line 内 [0, col) 前缀的字素列宽和（光标视觉列算术的
+ * 单源——渲染光标定位 / sticky 列共用）。
+ */
+export declare function prefixDisplayWidth(line: string, col: number): number;
+/**
+ * 光标前一个字素的边界（UTF-16）：backspace / moveLeft 的字素算术。
+ * col 已在行首返回 0。
+ */
+export declare function prevGraphemeBoundary(line: string, col: number): number;
+/**
+ * 光标后一个字素的终点（UTF-16）：deleteForward / moveRight 的字素算术。
+ * col 已在行尾返回 line.length。
+ */
+export declare function nextGraphemeBoundary(line: string, col: number): number;