@code-yeongyu/senpi-tui 2026.7.31 → 2026.8.3

package/dist/tui.js

@@ -22,20 +22,17 @@ function parseKittyImageHeader(line) {
         return undefined;
     const ids = [];
     let rows = 1;
-    const params = line.slice(paramsStart, paramsEnd);
-    for (const param of params.split(",")) {
+    for (const param of line.slice(paramsStart, paramsEnd).split(",")) {
         const [key, value] = param.split("=", 2);
         if (value === undefined)
             continue;
         const numberValue = Number(value);
         if (!Number.isInteger(numberValue) || numberValue <= 0 || numberValue > 0xffffffff)
             continue;
-        if (key === "i") {
+        if (key === "i")
             ids.push(numberValue);
-        }
-        else if (key === "r") {
+        else if (key === "r")
             rows = numberValue;
-        }
     }
     return { ids, rows };
 }
@@ -45,6 +42,9 @@ function extractKittyImageIds(line) {
 function extractKittyImageRows(line) {
     return parseKittyImageHeader(line)?.rows ?? 1;
 }
+function isTermuxSession() {
+    return Boolean(process.env.TERMUX_VERSION);
+}
 /** Type guard to check if a component implements Focusable */
 export function isFocusable(component) {
     return component !== null && "focused" in component;
@@ -186,9 +186,6 @@ function parseSizeValue(value, referenceSize) {
     }
     return undefined;
 }
-function isTermuxSession() {
-    return Boolean(process.env.TERMUX_VERSION);
-}
 /**
  * Container - a component that contains other components
  */
@@ -258,15 +255,51 @@ export class Container {
 /**
  * TUI - Main class for managing terminal UI with differential rendering
  */
-export class TUI extends Container {
+const SEGMENT_RESET = "\x1b[0m\x1b]8;;\x07";
+/** Composite overlay content into a terminal line at a fixed column. */
+export function compositeTuiLine(baseLine, overlayLine, startCol, overlayWidth, totalWidth) {
+    if (isImageLine(baseLine) && visibleWidth(baseLine) === 0)
+        return baseLine;
+    const placeholderIndex = baseLine.indexOf("\u{10eeee}");
+    const protocolEnd = placeholderIndex === -1 ? -1 : baseLine.lastIndexOf("\x1b\\", placeholderIndex);
+    const protocolPrefix = protocolEnd === -1 ? "" : baseLine.slice(0, protocolEnd + 2);
+    const afterStart = startCol + overlayWidth;
+    const base = extractSegments(baseLine, startCol, afterStart, totalWidth - afterStart, true);
+    const overlay = sliceWithWidth(overlayLine, 0, overlayWidth, true);
+    const beforePad = Math.max(0, startCol - base.beforeWidth);
+    const overlayPad = Math.max(0, overlayWidth - overlay.width);
+    const actualBeforeWidth = Math.max(startCol, base.beforeWidth);
+    const actualOverlayWidth = Math.max(overlayWidth, overlay.width);
+    const afterTarget = Math.max(0, totalWidth - actualBeforeWidth - actualOverlayWidth);
+    const afterPad = Math.max(0, afterTarget - base.afterWidth);
+    const result = base.before +
+        " ".repeat(beforePad) +
+        SEGMENT_RESET +
+        overlay.text +
+        " ".repeat(overlayPad) +
+        SEGMENT_RESET +
+        base.after +
+        " ".repeat(afterPad);
+    const composited = visibleWidth(result) <= totalWidth ? result : sliceByColumn(result, 0, totalWidth, true);
+    return protocolPrefix + composited;
+}
+export const VIEWPORT_TUI = Symbol.for("@earendil-works/pi-tui/viewport");
+export function isViewportTUI(tui) {
+    return tui[VIEWPORT_TUI] === true;
+}
+export class TuiBase extends Container {
     /** Minimum interval between scheduled renders. Default preserves the historic ~60fps cap. */
     #minRenderIntervalMs;
     #lastCursorVisibility;
+    get hasOverlayEntries() {
+        return this.overlayStack.length > 0;
+    }
     #muxDetector;
-    constructor(terminal, options) {
+    constructor(terminal, options, logDirectory) {
         super();
         this.previousLines = [];
         this.previousRawLines = [];
+        this.normalizeMemo = new Map();
         this.previousKittyImageIds = new Set();
         this.previousWidth = 0;
         this.previousHeight = 0;
@@ -299,10 +332,16 @@ export class TUI extends Container {
         // Preserve existing positional boolean callers while allowing explicit render-policy overrides.
         const normalizedOptions = typeof options === "boolean" ? { showHardwareCursor: options } : (options ?? {});
         this.#muxDetector = normalizedOptions.muxDetector ?? isMultiplexerSession;
+        this.logDirectory = logDirectory ?? path.join(os.homedir(), ".senpi", "agent");
         if (normalizedOptions.showHardwareCursor !== undefined) {
             this.showHardwareCursor = normalizedOptions.showHardwareCursor;
         }
     }
+    resetRenderState() { }
+    beforeTerminalStart() { }
+    afterTerminalStart() { }
+    beforeTerminalStop() { }
+    afterTerminalStop() { }
     get fullRedraws() {
         return this.fullRedrawCount;
     }
@@ -432,8 +471,11 @@ export class TUI extends Container {
             }
         }
     }
+    getMountedRoots() {
+        return this.children;
+    }
     isComponentMounted(component) {
-        return this.children.some((child) => this.containsComponent(child, component));
+        return this.getMountedRoots().some((child) => this.containsComponent(child, component));
     }
     containsComponent(root, target) {
         if (root === target)
@@ -595,7 +637,9 @@ export class TUI extends Container {
         this.renderRequested = false;
         this.inputRenderPending = false;
         this.#lastCursorVisibility = undefined;
-        this.terminal.start((data) => this.handleInput(data), () => this.requestRender());
+        this.beforeTerminalStart();
+        this.terminal.start((data) => this.handleTerminalInput(data), () => this.requestRender());
+        this.afterTerminalStart();
         if (process.env.TMUX)
             this.terminal.write(ENABLE_FOCUS_REPORTING);
         this.#setCursorVisibility(false);
@@ -649,6 +693,7 @@ export class TUI extends Container {
         if (this.terminalColorSchemeNotificationsEnabled) {
             this.terminal.write("\x1b[?2031l");
         }
+        this.beforeTerminalStop();
         // Move cursor to the end of the content to prevent overwriting/artifacts on exit
         if (this.previousLines.length > 0) {
             // Overwrite the inverted cursor with a normal space to clear the artifact
@@ -668,6 +713,8 @@ export class TUI extends Container {
         if (process.env.TMUX)
             this.terminal.write(DISABLE_FOCUS_REPORTING);
         this.terminal.stop();
+        this.afterTerminalStop();
+        this.resetRenderState();
         this.#lastCursorVisibility = undefined;
         this.previousLines = [];
         this.previousRawLines = [];
@@ -693,6 +740,7 @@ export class TUI extends Container {
     requestRender(force = false, source = "unknown") {
         if (force) {
             this.inputRenderPending = false;
+            this.resetRenderState();
             this.previousLines = [];
             this.previousRawLines = [];
             this.previousWidth = -1; // -1 triggers widthChanged, forcing a full clear
@@ -772,7 +820,7 @@ export class TUI extends Container {
         this.lastRenderAt = performance.now();
         this.doRender();
     }
-    handleInput(data) {
+    handleTerminalInput(data) {
         const focus = consumeTmuxFocusEvent(data);
         if (focus.event !== null) {
             resetCapabilitiesCache();
@@ -1098,21 +1146,37 @@ export class TUI extends Container {
         if (isImageLine(line)) {
             return { line, normalized: false };
         }
-        return { line: normalizeTerminalOutput(line) + TUI.SEGMENT_RESET, normalized: true };
+        const cached = this.normalizeMemo.get(line);
+        if (cached !== undefined) {
+            return { line: cached, normalized: false };
+        }
+        const normalized = normalizeTerminalOutput(line) + TUI.SEGMENT_RESET;
+        this.normalizeMemo.set(line, normalized);
+        return { line: normalized, normalized: true };
     }
-    applyLineResets(lines, mode = "full") {
+    applyLineResets(lines) {
+        return this.applyLineResetResult(lines).lines;
+    }
+    applyLineResetResult(lines, mode = "full") {
+        const previousMemo = this.normalizeMemo;
+        const nextMemo = new Map();
         const normalizedLines = [];
         let normalizedCount = 0;
         for (let i = 0; i < lines.length; i++) {
             const line = lines[i];
             if (isImageLine(line)) {
                 normalizedLines.push(line);
+                continue;
             }
-            else {
-                normalizedLines.push(normalizeTerminalOutput(line) + TUI.SEGMENT_RESET);
+            let normalized = nextMemo.get(line) ?? previousMemo.get(line);
+            if (normalized === undefined) {
+                normalized = normalizeTerminalOutput(line) + TUI.SEGMENT_RESET;
                 normalizedCount += 1;
             }
+            nextMemo.set(line, normalized);
+            normalizedLines.push(normalized);
         }
+        this.normalizeMemo = nextMemo;
         recordViewportRenderStats(normalizedCount, mode);
         return {
             lines: normalizedLines,
@@ -1127,7 +1191,7 @@ export class TUI extends Container {
             this.previousLines.length === 0 ||
             this.previousLines.length !== rawLines.length ||
             this.previousRawLines.length !== rawLines.length) {
-            return this.applyLineResets(rawLines);
+            return this.applyLineResetResult(rawLines);
         }
         const windowStart = Math.max(0, viewportTop - VIEWPORT_RENDER_OVERSCAN);
         const windowEnd = Math.min(rawLines.length, viewportTop + height + VIEWPORT_RENDER_OVERSCAN);
@@ -1140,7 +1204,7 @@ export class TUI extends Container {
                 firstRawChanged = i;
             }
             if (i < windowStart || i >= windowEnd) {
-                return this.applyLineResets(rawLines, "escaped");
+                return this.applyLineResetResult(rawLines, "escaped");
             }
         }
         const lines = this.previousLines.slice();
@@ -1531,8 +1595,9 @@ export class TUI extends Container {
         const logRedraw = (reason) => {
             if (!debugRedraw)
                 return;
-            const logPath = path.join(os.homedir(), ".senpi", "agent", "senpi-debug.log");
+            const logPath = path.join(this.logDirectory, "pi-debug.log");
             const msg = `[${new Date().toISOString()}] fullRender: ${reason} (prev=${this.previousLines.length}, new=${newLines.length}, height=${height})\n`;
+            fs.mkdirSync(path.dirname(logPath), { recursive: true });
             fs.appendFileSync(logPath, msg, { encoding: "utf8", mode: DIAGNOSTIC_LOG_MODE });
             chmodDiagnosticLogBestEffort(logPath);
         };
@@ -1982,4 +2047,7 @@ export class TUI extends Container {
         });
     }
 }
+/** Legacy main-screen renderer export. */
+export class TUI extends TuiBase {
+}
 //# sourceMappingURL=tui.js.map