berry-agent-sdk 0.1.0-alpha.2

package/dist/src/channels/engine/cell.js.map

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

package/dist/src/channels/engine/diff.d.ts

@@ -0,0 +1,3 @@
+import type { CellBuffer } from './types.js';
+/** 单帧行级差分：返回本帧应写出的 ANSI 字节串（零变更返回空串） */
+export declare function renderFrameDiff(from: CellBuffer, to: CellBuffer): string;

package/dist/src/channels/engine/diff.js

@@ -0,0 +1,144 @@
+/**
+ * 行级差分件（07 篇 §4.1 自研引擎节件 3——批 10b 引擎核心）。
+ *
+ * 帧差分增量写出纪律：
+ * - 无变更帧零写出、未变行零写出（行粒度比较——cellEquals 逐格直比）；
+ * - 行尾变空白一律 EL 清行**禁空格填充**（空格填充闪烁史反课——擦除只走
+ *   EL，永不写空格游程）；
+ * - EL 前置样式复位（BCE 语义——EL 以当前背景色擦除，带背景样式发 EL 会
+ *   把擦除区染上底色污染行尾，故先 SGR 复位再 EL）；
+ * - 帧尾光标统一落位（定位 + 显 / 隐），显隐态跨帧去重——同态零冗余序列；
+ *   **双零（内容与光标均零变更）才整帧零写出**。
+ *
+ * 纯函数：from / to 两帧只读比对产 ANSI 字节串；帧管线（请求合并 / 帧率帽）
+ * 归引擎编排件（批 10c）。前置条件：两帧同几何——resize 路径编排侧清屏全量
+ * 重绘不走本函数，几何不同即编程错、fail-loud。
+ */
+import { cellEquals, EMPTY_STYLE, styleEquals } from './cell.js';
+const ESC = '\x1b';
+/** 光标定位（1 基转义序列——row/col 为 0 基入参） */
+const cup = (row, col) => `${ESC}[${row + 1};${col + 1}H`;
+const EL_TO_EOL = `${ESC}[K`; // EL 0：自光标至行尾
+const SGR_RESET = `${ESC}[0m`;
+const HIDE_CURSOR = `${ESC}[?25l`;
+const SHOW_CURSOR = `${ESC}[?25h`;
+/** 样式 → SGR 序列（全量形——属性位 + 16 色前景背景；空样式返回空串由调用方复位） */
+function buildSgr(style) {
+    const params = [];
+    if (style.bold)
+        params.push('1');
+    if (style.dim)
+        params.push('2');
+    if (style.italic)
+        params.push('3');
+    if (style.underline)
+        params.push('4');
+    if (style.inverse)
+        params.push('7');
+    if (style.fg !== undefined) {
+        // 前景 16 色：0-7 标准位 30+n / 8-15 亮位 90+(n-8)
+        params.push(String(style.fg < 8 ? 30 + style.fg : 82 + style.fg));
+    }
+    if (style.bg !== undefined) {
+        // 背景 16 色：0-7 标准位 40+n / 8-15 亮位 100+(n-8)
+        params.push(String(style.bg < 8 ? 40 + style.bg : 92 + style.bg));
+    }
+    return params.length > 0 ? `${ESC}[${params.join(';')}m` : '';
+}
+/** 单帧行级差分：返回本帧应写出的 ANSI 字节串（零变更返回空串） */
+export function renderFrameDiff(from, to) {
+    if (from.columns !== to.columns || from.rows !== to.rows) {
+        // 几何不同是编程错（resize 路径编排侧清屏全量重绘）——fail-loud 不产半帧
+        throw new Error(`renderFrameDiff: 两帧几何不同（${from.columns}x${from.rows} vs ${to.columns}x${to.rows}）——resize 路径不走帧差分`);
+    }
+    let out = '';
+    /** 帧首光标抑制是否已发（有写出才发——防写内容过程光标跳；幂等只发一次） */
+    let cursorSuppressed = false;
+    const suppress = () => {
+        if (!cursorSuppressed) {
+            out += HIDE_CURSOR;
+            cursorSuppressed = true;
+        }
+    };
+    for (let row = 0; row < to.rows; row++) {
+        if (rowEquals(from, to, row))
+            continue; // 未变行零写出
+        suppress();
+        out += renderRowDiff(from, to, row);
+    }
+    // 帧尾光标统一落位（显隐跨帧去重——同态零冗余序列）
+    out += renderCursorDiff(from, to, cursorSuppressed);
+    return out;
+}
+/** 行相等判定（逐格 cellEquals 直比——null 归一语义在 cellEquals 内） */
+function rowEquals(from, to, row) {
+    for (let col = 0; col < to.columns; col++) {
+        if (!cellEquals(from.getCell(row, col), to.getCell(row, col)))
+            return false;
+    }
+    return true;
+}
+/** 单变行差分：定位 + 写内容 + 行尾残留 EL（禁空格填充——擦除只走 EL） */
+function renderRowDiff(from, to, row) {
+    let out = '';
+    // 内容末列 = 最右语义非空格格（无样式空格与未写格语义等价、不算内容）；
+    // 续格（width 0）属首格字素占位、算内容延伸
+    let lastContentCol = -1;
+    for (let col = to.columns - 1; col >= 0; col--) {
+        if (!cellEquals(to.getCell(row, col), null)) {
+            lastContentCol = col;
+            break;
+        }
+    }
+    if (lastContentCol < 0) {
+        // 新帧整行空：定位行首 + 样式复位 + EL 清行（旧帧有残留才到得了本分支）
+        return cup(row, 0) + SGR_RESET + EL_TO_EOL;
+    }
+    // 定位行首并复位样式（跨行样式残留归零——确定态起写）
+    out += cup(row, 0) + SGR_RESET;
+    let currentStyle = EMPTY_STYLE;
+    for (let col = 0; col <= lastContentCol; col++) {
+        const cell = to.getCell(row, col);
+        if (cell !== null && cell.width === 0)
+            continue; // 续格跳过——首格字素已携双宽
+        const style = cell?.style ?? EMPTY_STYLE;
+        if (!styleEquals(currentStyle, style)) {
+            // 样式变更点：先复位再全量设（差量 SGR 优化不预造——闪烁面留给组件批实证）
+            out += SGR_RESET + buildSgr(style);
+            currentStyle = style;
+        }
+        out += cell === null ? ' ' : cell.grapheme; // 语义空格（行中内容洞）写字面空格
+    }
+    // 行尾残留：旧帧在内容末之后还有语义非空格格 → 复位 + EL（BCE：复位后擦除
+    // 才不染背景色）。内容写满至行尾列则无擦除空间、天然无残留可清。
+    for (let col = lastContentCol + 1; col < to.columns; col++) {
+        if (!cellEquals(from.getCell(row, col), null)) {
+            out += SGR_RESET + EL_TO_EOL;
+            break;
+        }
+    }
+    return out;
+}
+/** 帧尾光标落位（跨帧同态去重——值全等即零序列） */
+function renderCursorDiff(from, to, cursorSuppressed) {
+    const fromCursor = from.cursor;
+    const toCursor = to.cursor;
+    // 同态（含双 null / 值全等）零冗余序列——「显隐态跨帧去重」执法位
+    if (fromCursor === null && toCursor === null)
+        return '';
+    if (fromCursor !== null && toCursor !== null && cursorSame(fromCursor, toCursor)) {
+        // 内容有写出且帧首已抑制光标、声明仍显 → 恢复显示在原位（抑制的反向配对）
+        if (cursorSuppressed)
+            return SHOW_CURSOR + cup(toCursor.row, toCursor.col);
+        return '';
+    }
+    if (toCursor === null)
+        return HIDE_CURSOR; // 显 → 隐
+    // 隐 → 显 / 位置迁移：显 + 定位（SHOW 幂等——重复发无害；帧首抑制已发则仍显式定位）
+    return SHOW_CURSOR + cup(toCursor.row, toCursor.col);
+}
+/** 光标声明值相等（row / col / visible 三元） */
+function cursorSame(a, b) {
+    return a.row === b.row && a.col === b.col && a.visible === b.visible;
+}
+//# sourceMappingURL=diff.js.map

package/dist/src/channels/engine/diff.js.map

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

package/dist/src/channels/engine/engine.d.ts

@@ -0,0 +1,151 @@
+import type { InputEvent, KeyboardProtocol, Renderable, TerminalIO } from './types.js';
+/** 屏幕形态两分：inline 主屏（不进 1049）/ alt-screen 副屏（1049 备屏进出） */
+export type ScreenForm = 'inline' | 'alt-screen';
+/** 引擎事件面（零 durable 事件的运行时侧通道） */
+export interface EngineEventMap {
+    /** 结构化输入事件（key/text/ime/paste/mouse 五分——decoder 产出） */
+    input: InputEvent;
+    /** 几何变更（缓冲已弃旧换新、清屏锤已写——消费方按新几何重排） */
+    resize: {
+        columns: number;
+        rows: number;
+    };
+    /** kitty 探测落定（应答前缺省 legacy） */
+    keyboardProtocol: KeyboardProtocol;
+}
+/** 引擎构造选项 */
+export interface EngineOptions {
+    /** 终端 IO（缺省 ProcessTerminalIO——组合根注入替代品的注入口） */
+    io?: TerminalIO;
+    /** 屏幕形态（缺省 inline 主屏——alt-screen 为副屏回看器形态） */
+    screen?: ScreenForm;
+    /** 帧率帽 fps（帧间隔下限 = 1000/fps——缺省 60：性能回归锁校准定值，见 DEFAULT_FPS_CAP 注） */
+    fpsCap?: number;
+    /** lone-ESC 判定窗（ms；缺省 30） */
+    escapeWindowMs?: number;
+    /** 时钟注入（缺省 Date.now——测试假钟注入口） */
+    now?: () => number;
+    /** 调度注入（缺省 setTimeout——测试假钟注入口） */
+    schedule?: (fn: () => void, ms: number) => unknown;
+    /** 取消调度注入（缺省 clearTimeout） */
+    cancelSchedule?: (handle: unknown) => void;
+    /**
+     * X10 鼠标形首达降级回调（透传 decoder——per-entry 闩只发一次；开了 1006
+     * 的会话里 X10 形到达 ⟺ 终端无 SGR 能力，装配层据此 DECRST 关鼠标签听回
+     * 终端原生选区——降级编舞归 AltScreenHost 组合柄）
+     */
+    onMouseLegacy?: () => void;
+}
+/** TUI 引擎（构造后 start 进屏；dispose 终退） */
+export declare class Engine {
+    private readonly io;
+    private readonly screen;
+    /** 帧率帽（帧间隔下限 = 1000/fpsCap ms） */
+    private readonly minFrameMs;
+    /** 时钟 / 调度注入（测试假钟注入口） */
+    private readonly now;
+    private readonly scheduleFn;
+    private readonly cancelFn;
+    /** 渲染树根（shell 经 setRoot 装载） */
+    private root;
+    /** 双缓冲：front = 屏上真相（差分基线）/ back = 本帧渲染目标 */
+    private front;
+    private back;
+    /** 全量帧旗标（首帧 / 复起重进 / resize——front 基线失真时置位） */
+    private forceFull;
+    /** 帧定时器句柄（null = 无在飞帧——请求合并的合并位） */
+    private frameHandle;
+    /** 上帧时刻（FPS 帽锚——调度时刻滚；-Infinity = 首帧立即出） */
+    private lastFrameAt;
+    /** 生命周期态：idle 未启 / running 持屏 / suspended 挂起 / disposed 终退 */
+    private state;
+    /** start 时的 raw 先验态（suspend/dispose 复原依据） */
+    private priorRaw;
+    /** 输入解码器（kitty/legacy 双轨 + IME 组字态） */
+    private readonly decoder;
+    /** lone-ESC 判定窗（构造时留档——定时器装排用） */
+    private readonly decoderEscapeWindowMs;
+    /** lone-ESC 判定窗定时器句柄 */
+    private escapeHandle;
+    /** 输入监听退订函数（null = 未装） */
+    private unsubInput;
+    /** resize 监听退订函数（挂起期保留监听、dispose 才卸） */
+    private unsubResize;
+    /** 引擎事件面 */
+    private readonly events;
+    /** kitty 探测落定值（应答到达前缺省 legacy） */
+    private protocol;
+    /**
+     * 硬退复原钩子解除器（null = 未武装）：持屏窗内 fatal exit(1)/二次
+     * SIGINT exit(130) 不经 dispose——用户被留在死模式态（备屏 / 光标藏 /
+     * 粘贴开 / kitty 推栈）。生命周期 = 持屏窗〔start/resume → suspend/dispose〕。
+     */
+    private disarmExitRestore;
+    constructor(opts?: EngineOptions);
+    /** 当前网格宽（列——io 直查真值不缓存） */
+    get columns(): number;
+    /** 当前网格高（行） */
+    get rows(): number;
+    /** 挂起中旗标（换防面查询） */
+    get suspended(): boolean;
+    /** 生命周期态（idle/running/suspended/disposed） */
+    get lifecycle(): 'idle' | 'running' | 'suspended' | 'disposed';
+    /** kitty 探测落定值（应答前缺省 legacy） */
+    get keyboardProtocol(): KeyboardProtocol;
+    /** 事件订阅（返回卸载函数） */
+    on<K extends keyof EngineEventMap>(event: K, cb: (payload: EngineEventMap[K]) => void): () => void;
+    /**
+     * 进屏启动：模式串写出 + raw 设定 + 输入 / resize 监听装上 + 全量首帧。
+     * 幂等保护：仅 idle 可启（挂起复位走 resume）。
+     */
+    start(root: Renderable): void;
+    /** 换渲染树根（同帧请求合并——下帧生效） */
+    setRoot(root: Renderable): void;
+    /**
+     * 渲染请求（单入口语义）：挂起 / 终退态静默短路（闸门）；帧定时器在飞则
+     * 不另排（请求合并——多次请求一帧收）。
+     */
+    requestRender(): void;
+    /** 立即帧（测试与强制刷新面——绕过调度直出） */
+    renderNow(): void;
+    /**
+     * 挂起（换防交出方——三件套）：出屏模式串 → 卸输入监听 → 丢在途转义 →
+     * 停流 → raw 复原先验态。挂起后 requestRender 静默短路（闸门）；resize
+     * 监听保留（无副作用——复起几何核对兜住挂起期变更）。
+     */
+    suspend(): void;
+    /**
+     * 复位（换防接收方——六步）：进屏模式串清屏进 → raw 重设 → 监听重装 →
+     * **显式放流**（已被显式 pause 的流再挂监听不会自动回 flowing——缺放流则
+     * 复位后引擎永久失聪）→ 几何核对（挂起期 resize 事件被闸门整批丢弃——
+     * 复起重查当前真值，失配即 handleResize 同款弃旧换新）→ 全量首帧重绘
+     * （front 基线在挂起期已失真——对方栈写过屏）。
+     */
+    resume(): void;
+    /**
+     * 排空 stdin 缓冲（终退回 shell 前——交出面公开方法位）：临时吞处理器 +
+     * 放流 → 闲窗（idleMs 无新数据）或总帽（maxMs）到点收手。返回后输入处理
+     * 器保持卸载、stdin 暂停——干净交回 shell。dispose 不自动排空——终退编舞
+     * （排空 → 出屏 → dispose 序）由装配侧显式调用。
+     */
+    drainInput(maxMs?: number, idleMs?: number): Promise<void>;
+    /** 终退：出屏 + 一切复原（dispose 后引擎不可复用） */
+    dispose(): void;
+    /**
+     * 武装硬退复原钩子（仅真 ProcessTerminalIO——注入 io 零污染）：进屏模式串
+     * 是写字节开启的设备态（备屏 / 光标 / 粘贴 / kitty 推栈），fatal exit 不经
+     * dispose——钩子在 process 'exit' 兜底写 LEAVE_MODES（与出屏严格对称反序
+     * ——单源常量）+ raw 交还。
+     */
+    private armExitRestore;
+    /** 输入处理器（decoder 喂入 + 事件排空上抛 + lone-ESC 判定窗定时器装 / 卸） */
+    private readonly handleInput;
+    /** 排空 decoder 事件队列并上抛 emitter */
+    private flushDecoderEvents;
+    /** resize 处理器：缓冲弃旧换新 + 清屏锤 + 全量重绘 + 事件上抛 */
+    private readonly handleResize;
+    /** 取消在飞帧定时器 */
+    private cancelFrame;
+    /** 取消 lone-ESC 判定窗定时器 */
+    private cancelEscapeTimer;
+}