berry-agent-sdk 0.1.0-alpha.2

package/dist/src/channels/tui/editor/visual-lines.js

@@ -0,0 +1,127 @@
+/**
+ * 视觉行映射纯函数（多行输入件 Editor 件族基件）：逻辑行 → 折行后视觉行
+ * 的映射单源（垂直光标移动 / 视口滚动 / 渲染三消费方共用）。
+ *
+ * 本仓化关键差异（07 引擎节件 6（组件与呈现装配件）「字素光标算术——CJK 双宽对齐」条款）：
+ * - 折行按**显示列宽**（字素 graphemeWidth 累计、整字下移不产半字——与引擎
+ *   width 件 wrapText 同规则），段记录 UTF-16 下标面（startCol/length 供
+ *   字符串切片）+ 显示宽面（width 供视觉列算术）双坐标；
+ * - 垂直移动的视觉列 = **显示列**（光标前字素列宽和），非 UTF-16 码元差
+ *   （pi 以码元差近似，CJK 双宽下 sticky 列漂移——本仓按规范双宽对齐）。
+ */
+import { graphemeWidth, splitGraphemes } from '../../engine/index.js';
+/**
+ * 单逻辑行按显示宽硬折（字素累宽超限整字下移——空行占一段零宽）。
+ * 返回段的 UTF-16 与显示宽双坐标。
+ */
+function foldLine(line, lineNo, width) {
+    if (width <= 0)
+        return [{ line: lineNo, startCol: 0, length: line.length, width: 0 }];
+    if (line === '')
+        return [{ line: lineNo, startCol: 0, length: 0, width: 0 }];
+    const segments = [];
+    let start = 0; // 当前段 UTF-16 起点
+    let usedCols = 0; // 当前段已占显示宽
+    let segLen = 0; // 当前段 UTF-16 长
+    for (const g of splitGraphemes(line)) {
+        const w = graphemeWidth(g);
+        if (usedCols + w > width) {
+            segments.push({ line: lineNo, startCol: start, length: segLen, width: usedCols });
+            start += segLen;
+            segLen = g.length;
+            usedCols = w;
+        }
+        else {
+            segLen += g.length;
+            usedCols += w;
+        }
+    }
+    segments.push({ line: lineNo, startCol: start, length: segLen, width: usedCols });
+    return segments;
+}
+/** 全文档视觉行映射（逻辑行逐行硬折串接） */
+export function buildVisualLineMap(lines, width) {
+    const out = [];
+    for (let i = 0; i < lines.length; i++)
+        out.push(...foldLine(lines[i] ?? '', i, width));
+    return out;
+}
+/**
+ * 定位逻辑位置所在视觉行下标（col 为 UTF-16）。
+ * 逻辑行末段的末位（col = 行长）属末段——光标在行尾不落「下一段开头」。
+ */
+export function findVisualLineAt(map, line, col) {
+    for (let i = 0; i < map.length; i++) {
+        const vl = map[i];
+        if (vl.line !== line)
+            continue;
+        const offset = col - vl.startCol;
+        const isLastOfLine = i === map.length - 1 || map[i + 1].line !== vl.line;
+        if (offset >= 0 && (offset < vl.length || (isLastOfLine && offset === vl.length)))
+            return i;
+    }
+    return map.length - 1;
+}
+/**
+ * 段内显示列反查 UTF-16 下标：从段起点起累计字素宽，到目标显示列 targetCols
+ * 的字素边界（**光标永不落半字**——目标列落在宽字素中间时吸到其首列前，
+ * 返回该字素起点的 UTF-16 下标）。targetCols 超段宽返回段尾下标。
+ */
+export function colAtDisplayColumn(line, startCol, targetCols) {
+    let used = 0;
+    let idx = startCol;
+    for (const g of splitGraphemes(line.slice(startCol))) {
+        const w = graphemeWidth(g);
+        if (used + w > targetCols)
+            return idx; // 目标列落在本字素内——吸到首列前（半字防线）
+        used += w;
+        idx += g.length;
+    }
+    return idx;
+}
+/**
+ * 位置前缀显示宽：line 内 [0, col) 前缀的字素列宽和（光标视觉列算术的
+ * 单源——渲染光标定位 / sticky 列共用）。
+ */
+export function prefixDisplayWidth(line, col) {
+    let used = 0;
+    let idx = 0;
+    for (const g of splitGraphemes(line)) {
+        if (idx >= col)
+            break;
+        used += graphemeWidth(g);
+        idx += g.length;
+    }
+    return used;
+}
+/**
+ * 光标前一个字素的边界（UTF-16）：backspace / moveLeft 的字素算术。
+ * col 已在行首返回 0。
+ */
+export function prevGraphemeBoundary(line, col) {
+    if (col <= 0)
+        return 0;
+    let idx = 0;
+    let prev = 0;
+    for (const g of splitGraphemes(line)) {
+        if (idx >= col)
+            return prev;
+        prev = idx;
+        idx += g.length;
+    }
+    return prev;
+}
+/**
+ * 光标后一个字素的终点（UTF-16）：deleteForward / moveRight 的字素算术。
+ * col 已在行尾返回 line.length。
+ */
+export function nextGraphemeBoundary(line, col) {
+    let idx = 0;
+    for (const g of splitGraphemes(line)) {
+        if (idx >= col)
+            return idx + g.length;
+        idx += g.length;
+    }
+    return line.length;
+}
+//# sourceMappingURL=visual-lines.js.map

package/dist/src/channels/tui/editor/visual-lines.js.map

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

package/dist/src/channels/tui/editor/word-nav.d.ts

@@ -0,0 +1,10 @@
+/**
+ * 光标向后移一词：跳过尾部空白，再跳一词（词内含 ASCII 标点切到最近标点
+ * 边界、标点 run 整段跳）。返回新光标（UTF-16 下标）——纯函数不改入参。
+ */
+export declare function findWordBackward(text: string, cursor: number): number;
+/**
+ * 光标向前移一词：跳过前导空白，再跳一词（词内标点切到首个标点前、
+ * 标点 run 整段跳）。返回新光标（UTF-16 下标）——纯函数。
+ */
+export declare function findWordForward(text: string, cursor: number): number;

package/dist/src/channels/tui/editor/word-nav.js

@@ -0,0 +1,107 @@
+/**
+ * 词级导航纯函数（多行输入件 Editor 件族基件）：findWordBackward /
+ * findWordForward——词级删除与词向移动共用的边界判定单源。
+ *
+ * 机制语义承 pi word-navigation.ts（裁 ⓪ 从零重写）：
+ * - Intl.Segmenter **word 粒度**切词（与引擎 width 件的 grapheme 粒度不同
+ *   面——此处自持单例）；
+ * - isWordLike 三分支：词内含 ASCII 标点时切到标点边界（foo.bar 一步到
+ *   '.' 前）、非词非空白的标点 run 整段跳、空白跳过；
+ * - 纯函数零状态——调用方（编辑模型）自持光标。
+ */
+const wordSegmenter = new Intl.Segmenter(undefined, { granularity: 'word' });
+/** ASCII 标点判（词内边界细化用——POSIX 图形字符中的非字母数字段） */
+function isPunctuation(ch) {
+    const c = ch.charCodeAt(0);
+    return (c >= 0x21 && c <= 0x2f) || (c >= 0x3a && c <= 0x40) || (c >= 0x5b && c <= 0x60) || (c >= 0x7b && c <= 0x7e);
+}
+/** 词粒度分段（字素串 + isWordLike 标记） */
+function segmentWords(text) {
+    const out = [];
+    for (const seg of wordSegmenter.segment(text)) {
+        out.push({ segment: seg.segment, isWordLike: seg.isWordLike === true });
+    }
+    return out;
+}
+/** 空白判（词导航语义的空白 = 空白段整体跳过） */
+function isWhitespace(text) {
+    return text.length > 0 && text.trim().length === 0;
+}
+/**
+ * 光标向后移一词：跳过尾部空白，再跳一词（词内含 ASCII 标点切到最近标点
+ * 边界、标点 run 整段跳）。返回新光标（UTF-16 下标）——纯函数不改入参。
+ */
+export function findWordBackward(text, cursor) {
+    if (cursor <= 0)
+        return 0;
+    const segments = segmentWords(text.slice(0, cursor));
+    let newCursor = cursor;
+    // 先跳尾部空白段
+    while (segments.length > 0 && isWhitespace(segments[segments.length - 1].segment)) {
+        newCursor -= segments.pop().segment.length;
+    }
+    if (segments.length === 0)
+        return newCursor;
+    const last = segments[segments.length - 1];
+    if (last.isWordLike) {
+        // 词内含 ASCII 标点：切到词内最后一段标点之后（foo.bar → '.' 前）
+        const segment = last.segment;
+        let cut = -1;
+        for (let ci = 0; ci < segment.length; ci++) {
+            if (isPunctuation(segment[ci]))
+                cut = ci + 1;
+        }
+        if (cut >= 0)
+            newCursor -= segment.length - cut;
+        else
+            newCursor -= segment.length;
+    }
+    else {
+        // 非词非空白 run（标点串）整段跳
+        while (segments.length > 0 &&
+            !segments[segments.length - 1].isWordLike &&
+            !isWhitespace(segments[segments.length - 1].segment)) {
+            newCursor -= segments.pop().segment.length;
+        }
+    }
+    return newCursor;
+}
+/**
+ * 光标向前移一词：跳过前导空白，再跳一词（词内标点切到首个标点前、
+ * 标点 run 整段跳）。返回新光标（UTF-16 下标）——纯函数。
+ */
+export function findWordForward(text, cursor) {
+    if (cursor >= text.length)
+        return text.length;
+    const segments = segmentWords(text.slice(cursor));
+    let newCursor = cursor;
+    let i = 0;
+    // 先跳前导空白段
+    while (i < segments.length && isWhitespace(segments[i].segment)) {
+        newCursor += segments[i].segment.length;
+        i++;
+    }
+    if (i >= segments.length)
+        return newCursor;
+    const first = segments[i];
+    if (first.isWordLike) {
+        // 词内含 ASCII 标点：切到词内首个标点前（bar.baz → '.' 前）
+        let stop = -1;
+        for (let ci = 0; ci < first.segment.length; ci++) {
+            if (isPunctuation(first.segment[ci])) {
+                stop = ci;
+                break;
+            }
+        }
+        newCursor += stop >= 0 ? stop : first.segment.length;
+    }
+    else {
+        // 非词非空白 run（标点串）整段跳
+        while (i < segments.length && !segments[i].isWordLike && !isWhitespace(segments[i].segment)) {
+            newCursor += segments[i].segment.length;
+            i++;
+        }
+    }
+    return newCursor;
+}
+//# sourceMappingURL=word-nav.js.map

package/dist/src/channels/tui/editor/word-nav.js.map

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

package/dist/src/channels/tui/history/history-viewer.d.ts

@@ -0,0 +1,133 @@
+/**
+ * 件 8 /history 全屏回看器（07 §4.1 呈现面件 8——批 10f-4 特性腿）：
+ * 副屏只读内容件（OverlayContent——经 AltScreenHost 装载入 1049 备屏）。
+ *
+ * - **数据源 = 复用主屏同一渲染管线**（07 件 8 条款）：history() 注入拉取的
+ *   全量 durable 正文投影 → LiveTranscript 全量档（blockCap = Infinity——
+ *   恒一致的是管线非范围，主屏按滚动帽 / 回看器全量）→ renderBlockStyledLines
+ *   带样式行集（同输入同行集、零第二渲染器）；瞬时面（状态行/todo/活动面板）
+ *   不进回看器——数据腿只有 durable 投影，结构上即不进；
+ * - **快照档 v1**（条款）：行集构造后静态——回看期新事件不进副屏（无追加
+ *   路），返回主屏全帧补显（resumeMain 自持）；活体跟随挂账未落；
+ * - **键盘滚动**（首版键盘先行——滚轮随鼠标批接）：ScrollView 装载
+ *   （↑/↓/PgUp/PgDn/Home/End——折叠与偏移算术恒归 ScrollView，样式呈现经
+ *   writeSlice 覆写接缝注入，零第二滚动引擎）；
+ * - **鼠标选区 + 滚轮**（2026-09-11 鼠标解码批 mu-2——07 件 8 细则）：线性
+ *   选区（press 左键锚定 → motion 按住拖动扩展 → release 触发复制），锚/焦点
+ *   存逻辑行 + 行内 UTF-16 下标（渲染无关坐标系——滚动/重折/resize 后仍指同
+ *   一正文位）；release 行间拼 LF 经 onCopy 注入柄写出（OSC 52——装配层铸序
+ *   列）；选区帽 64 KiB 按明文 UTF-8 字节数计，超帽拒复制 + 底行提示常显至
+ *   选区清除；视口外命中（头行/底铬/滚动条列）零动作；搜索框在场拖选禁用
+ *   （输入模态优先）；双击词选/越视口自动滚动/滚动条拖拽挂账不预造。滚轮归
+ *   ScrollView wheel 消费路（搜索在场也照常滚——禁的是拖选）；
+ * - **搜索三动作**（条款锁能力不锁键位——缺省 Ctrl+Shift+F）：开（搜索框
+ *   在场——Editor 单行档复用，IME/粘贴/字素光标白得）/ 跳匹配（Enter 下一、
+ *   Shift+Enter 上一、循环；当前匹配反色高亮）/ 关（Esc——高亮清、查询文
+ *   本保留续搜）；
+ * - **退出让位判据**（条款）：q/Esc 退出只在搜索框不在场时消费——否则打
+ *   不出字母 q；
+ * - **副屏键面补丁**（与主屏同键面——07 §4.3 输入路由拦截链条款）：Ctrl+C
+ *   = 打断在飞 run（滤 kitty release）、Ctrl+D = 退出（先收副屏——onExit
+ *   先于 onQuit；搜索框有文不退，与主屏空框闸同律）。
+ */
+import type { CellBuffer, InputEvent, Region } from '../../engine/index.js';
+import { ScrollView } from '../scroll/scroll-view.js';
+import { type VisualSegment } from '../editor/visual-lines.js';
+import type { OverlayContent } from '../overlay/overlay.js';
+import type { AgentMessage } from '../../../contracts/index.js';
+/** 回看器装配选项 */
+export interface HistoryViewerOptions {
+    /** 会话归属（呈现会话短 id——header 行） */
+    readonly sessionId: string;
+    /** 全量 durable 正文投影（history() 注入拉取的快照——构造后静态，快照档 v1） */
+    readonly messages: readonly AgentMessage[];
+    /** 行集构建折宽锚（开屏时终端列宽——渲染期 ScrollView 按实际 region 宽重折） */
+    readonly columns: number;
+    /** 退出回看器（q/Esc/Ctrl+D——装配接线：收副屏〔AltScreenHost close〕） */
+    readonly onExit: () => void;
+    /** 打断在飞 run（Ctrl+C 副屏键面补丁——与主屏同键面，装配柄透传） */
+    readonly onInterrupt?: (sessionId: string) => void;
+    /** 退出进程（Ctrl+D——先收副屏〔onExit 已先调〕再转装配退出柄） */
+    readonly onQuit?: () => void;
+    /** OSC 52 复制写出柄（release 选区触发——onExit/onInterrupt 装配柄同形先例；装配层包 buildOsc52Copy 铸序列） */
+    readonly onCopy?: (text: string) => void;
+}
+/**
+ * 回看器内容件：ScrollView 子类（滚动/折叠/偏移算术继承）+ OverlayContent
+ * （副屏 root——render 直收全屏 region，量高不经布局路）。
+ */
+export declare class HistoryViewer extends ScrollView implements OverlayContent {
+    private readonly sessionId;
+    private readonly shortId;
+    /** 带样式行集（构造后静态——快照档 v1：回看期新事件不进副屏） */
+    private readonly styledLines;
+    private readonly onExit;
+    private readonly onInterrupt;
+    private readonly onQuit;
+    private readonly onCopy;
+    private searchOpen;
+    private readonly searchEditor;
+    private matches;
+    private matchIndex;
+    /** 退出闭锁（同批多事件只退一次——q 与 Esc 竞发的防御位） */
+    private exited;
+    private selAnchor;
+    private selFocus;
+    /** 底行提示文案（超帽拒复制——常显至选区清除；null = 常态键面提示） */
+    private selectionNotice;
+    constructor(options: HistoryViewerOptions);
+    /** 量高：头行 + 视口全量 + 底铬（副屏 root 不经布局路——契约的诚实实现） */
+    measure(width: number): number;
+    /**
+     * 落位（副屏全屏 region 自底盘向上三段）：头行（档名 + 会话短 id 会话区分色
+     * + 搜索计数）→ 滚动视口（super.render——折叠/偏移/滚动条恒归 ScrollView）→
+     * 底铬（搜索在场 = 单行 Editor；否则键面提示行）。
+     */
+    render(buffer: CellBuffer, region: Region): void;
+    /**
+     * 事件分发（副屏内容终局消费——未消费键不穿透，模态独占）。
+     * 序：Ctrl+C / Ctrl+D 副屏键面补丁 → 搜索开关键 → 搜索在场模态（让位判据：
+     * q/Esc 不退出）→ 常态退出键（q/Esc）→ 滚动键（ScrollView）。
+     */
+    handleEvent(event: InputEvent): boolean;
+    /** super.handleEvent 直呼（子类覆写同名面后仍需触达基类滚动路的显式位） */
+    private handleEventSuper;
+    /**
+     * mouse 事件路（副屏内容件终局消费——未消费 mouse 不穿透，模态独占）：
+     * 滚轮归 ScrollView（搜索在场也照常滚——禁的是拖选）；选区 = 左键 press
+     * 锚定 → motion 扩展 → release 复制（release 后选区高亮保留，下次 press
+     * 清除/重锚）。
+     */
+    private handleMouse;
+    /**
+     * 屏幕坐标 → 选区定位点（逻辑行 + 行内 UTF-16 下标）：视口外命中（头行/
+     * 底铬/滚动条列/界外）返 null 零动作；列反查走字素宽累加（与折叠算术同源
+     * ——CJK 双宽对齐，命中字素含半格命中归该字素首）。
+     */
+    private screenToLogical;
+    /** 选区规范化（锚/焦点 → 升序两端点；无选区 null） */
+    private selectionBounds;
+    /** 选区明文（行间拼 LF——release 复制与帽计量的单源；空选区空串） */
+    private selectionText;
+    /**
+     * 本逻辑行的选中区间（端点含头不含尾；end = Infinity 表行尾开放——跨行尾
+     * 段；无选区/异行 null）。writeSlice 高亮与 selectionText 共用此规范化。
+     */
+    private selectionSpanFor;
+    /** 开：搜索框在场 + 按在框文本重算匹配并跳首匹配 */
+    private openSearch;
+    /** 关：框退场 + 高亮清（查询文本保留——重开续搜的增量检索延续） */
+    private closeSearch;
+    /** 匹配重算（查询变更路）：全行不区分大小写子串扫描 + 跳首匹配 */
+    private recomputeMatches;
+    /** 跳匹配（±1 循环——尾后回首、首前到尾） */
+    private jumpMatch;
+    /** 退出（闭锁——单次） */
+    private exit;
+    /**
+     * 视口切片带样式写出：样式段（管线单源产物）按切片边界分段落格 + 当前匹配
+     * 反色高亮叠加。列位经 prefixDisplayWidth 换算（UTF-16 切片下标 → 显示列
+     * ——CJK 双宽对齐与折叠算术同源）。
+     */
+    protected writeSlice(buffer: CellBuffer, region: Region, displayRow: number, seg: VisualSegment): void;
+}