@dst0/p-tui 0.4.41 → 5.0.2

package/dist/tui/tui-methods/overlay-layout.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"overlay-layout.js","sourceRoot":"","sources":["../../../src/tui/tui-methods/overlay-layout.ts"],"names":[],"mappings":"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","sourcesContent":["import { parseSizeValue } from \"../helpers.ts\";\nimport type { TUI } from \"../tui.ts\";\nimport type { OverlayAnchor, OverlayOptions } from \"../types.ts\";\n\nexport function do_resolveOverlayLayout(\n  self: TUI,\n  options: OverlayOptions | undefined,\n  overlayHeight: number,\n  termWidth: number,\n  termHeight: number,\n): { width: number; row: number; col: number; maxHeight: number | undefined } {\n  const opt = options ?? {};\n\n  // Parse margin (clamp to non-negative)\n  const margin =\n    typeof opt.margin === \"number\"\n      ? { top: opt.margin, right: opt.margin, bottom: opt.margin, left: opt.margin }\n      : (opt.margin ?? {});\n  const marginTop = Math.max(0, margin.top ?? 0);\n  const marginRight = Math.max(0, margin.right ?? 0);\n  const marginBottom = Math.max(0, margin.bottom ?? 0);\n  const marginLeft = Math.max(0, margin.left ?? 0);\n\n  // Available space after margins\n  const availWidth = Math.max(1, termWidth - marginLeft - marginRight);\n  const availHeight = Math.max(1, termHeight - marginTop - marginBottom);\n\n  // === Resolve width ===\n  let width = parseSizeValue(opt.width, termWidth) ?? Math.min(80, availWidth);\n  // Apply minWidth\n  if (opt.minWidth !== undefined) {\n    width = Math.max(width, opt.minWidth);\n  }\n  // Clamp to available space\n  width = Math.max(1, Math.min(width, availWidth));\n\n  // === Resolve maxHeight ===\n  let maxHeight = parseSizeValue(opt.maxHeight, termHeight);\n  // Clamp to available space\n  if (maxHeight !== undefined) {\n    maxHeight = Math.max(1, Math.min(maxHeight, availHeight));\n  }\n\n  // Effective overlay height (may be clamped by maxHeight)\n  const effectiveHeight = maxHeight !== undefined ? Math.min(overlayHeight, maxHeight) : overlayHeight;\n\n  // === Resolve position ===\n  let row: number;\n  let col: number;\n\n  if (opt.row !== undefined) {\n    if (typeof opt.row === \"string\") {\n      // Percentage: 0% = top, 100% = bottom (overlay stays within bounds)\n      const match = opt.row.match(/^(\\d+(?:\\.\\d+)?)%$/);\n      if (match) {\n        const maxRow = Math.max(0, availHeight - effectiveHeight);\n        const percent = parseFloat(match[1]) / 100;\n        row = marginTop + Math.floor(maxRow * percent);\n      } else {\n        // Invalid format, fall back to center\n        row = self.resolveAnchorRow(\"center\", effectiveHeight, availHeight, marginTop);\n      }\n    } else {\n      // Absolute row position\n      row = opt.row;\n    }\n  } else {\n    // Anchor-based (default: center)\n    const anchor = opt.anchor ?? \"center\";\n    row = self.resolveAnchorRow(anchor, effectiveHeight, availHeight, marginTop);\n  }\n\n  if (opt.col !== undefined) {\n    if (typeof opt.col === \"string\") {\n      // Percentage: 0% = left, 100% = right (overlay stays within bounds)\n      const match = opt.col.match(/^(\\d+(?:\\.\\d+)?)%$/);\n      if (match) {\n        const maxCol = Math.max(0, availWidth - width);\n        const percent = parseFloat(match[1]) / 100;\n        col = marginLeft + Math.floor(maxCol * percent);\n      } else {\n        // Invalid format, fall back to center\n        col = self.resolveAnchorCol(\"center\", width, availWidth, marginLeft);\n      }\n    } else {\n      // Absolute column position\n      col = opt.col;\n    }\n  } else {\n    // Anchor-based (default: center)\n    const anchor = opt.anchor ?? \"center\";\n    col = self.resolveAnchorCol(anchor, width, availWidth, marginLeft);\n  }\n\n  // Apply offsets\n  if (opt.offsetY !== undefined) row += opt.offsetY;\n  if (opt.offsetX !== undefined) col += opt.offsetX;\n\n  // Clamp to terminal bounds (respecting margins)\n  row = Math.max(marginTop, Math.min(row, termHeight - marginBottom - effectiveHeight));\n  col = Math.max(marginLeft, Math.min(col, termWidth - marginRight - width));\n\n  return { width, row, col, maxHeight };\n}\n\nexport function do_resolveAnchorRow(\n  _self: TUI,\n  anchor: OverlayAnchor,\n  height: number,\n  availHeight: number,\n  marginTop: number,\n): number {\n  switch (anchor) {\n    case \"top-left\":\n    case \"top-center\":\n    case \"top-right\":\n      return marginTop;\n    case \"bottom-left\":\n    case \"bottom-center\":\n    case \"bottom-right\":\n      return marginTop + availHeight - height;\n    case \"left-center\":\n    case \"center\":\n    case \"right-center\":\n      return marginTop + Math.floor((availHeight - height) / 2);\n  }\n}\n\nexport function do_resolveAnchorCol(\n  _self: TUI,\n  anchor: OverlayAnchor,\n  width: number,\n  availWidth: number,\n  marginLeft: number,\n): number {\n  switch (anchor) {\n    case \"top-left\":\n    case \"left-center\":\n    case \"bottom-left\":\n      return marginLeft;\n    case \"top-right\":\n    case \"right-center\":\n    case \"bottom-right\":\n      return marginLeft + availWidth - width;\n    case \"top-center\":\n    case \"center\":\n    case \"bottom-center\":\n      return marginLeft + Math.floor((availWidth - width) / 2);\n  }\n}\n"]}

package/dist/tui/tui-methods/overlay-management.d.ts

@@ -0,0 +1,11 @@
+import type { TUI } from "../tui.ts";
+import type { Component, InputListener, OverlayHandle, OverlayOptions, OverlayStackEntry } from "../types.ts";
+export declare function do_showOverlay(self: TUI, component: Component, options?: OverlayOptions): OverlayHandle;
+export declare function do_hideOverlay(self: TUI): void;
+export declare function do_hasOverlay(self: TUI): boolean;
+export declare function do_isOverlayVisible(self: TUI, entry: OverlayStackEntry): boolean;
+export declare function do_getTopmostVisibleOverlay(self: TUI): OverlayStackEntry | undefined;
+export declare function do_start(self: TUI): void;
+export declare function do_addInputListener(self: TUI, listener: InputListener): () => void;
+export declare function do_removeInputListener(self: TUI, listener: InputListener): void;
+//# sourceMappingURL=overlay-management.d.ts.map

package/dist/tui/tui-methods/overlay-management.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"overlay-management.d.ts","sourceRoot":"","sources":["../../../src/tui/tui-methods/overlay-management.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,WAAW,CAAC;AACrC,OAAO,KAAK,EAAE,SAAS,EAAE,aAAa,EAAE,aAAa,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAE9G,wBAAgB,cAAc,CAAC,IAAI,EAAE,GAAG,EAAE,SAAS,EAAE,SAAS,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,aAAa,CA6FvG;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,GAAG,GAAG,IAAI,CAa9C;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,GAAG,GAAG,OAAO,CAEhD;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,GAAG,EAAE,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAMhF;AAED,wBAAgB,2BAA2B,CAAC,IAAI,EAAE,GAAG,GAAG,iBAAiB,GAAG,SAAS,CASpF;AAED,wBAAgB,QAAQ,CAAC,IAAI,EAAE,GAAG,GAAG,IAAI,CASxC;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,GAAG,EAAE,QAAQ,EAAE,aAAa,GAAG,MAAM,IAAI,CAKlF;AAED,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,GAAG,EAAE,QAAQ,EAAE,aAAa,GAAG,IAAI,CAE/E","sourcesContent":["import type { TUI } from \"../tui.ts\";\nimport type { Component, InputListener, OverlayHandle, OverlayOptions, OverlayStackEntry } from \"../types.ts\";\n\nexport function do_showOverlay(self: TUI, component: Component, options?: OverlayOptions): OverlayHandle {\n  const entry: OverlayStackEntry = {\n    component,\n    ...(options === undefined ? {} : { options }),\n    preFocus: self.focusedComponent,\n    hidden: false,\n    focusOrder: ++self.focusOrderCounter,\n  };\n  self.overlayStack.push(entry);\n  // Only focus if overlay is actually visible\n  if (!options?.nonCapturing && self.isOverlayVisible(entry)) {\n    self.setFocus(component);\n  }\n  self.terminal.hideCursor();\n  self.requestRender();\n\n  // Return handle for controlling self overlay\n  return {\n    hide: () => {\n      const index = self.overlayStack.indexOf(entry);\n      if (index !== -1) {\n        self.clearOverlayFocusRestoreFor(entry);\n        self.retargetOverlayPreFocus(entry);\n        self.overlayStack.splice(index, 1);\n        // Restore focus if self overlay had focus\n        if (self.focusedComponent === component) {\n          const topVisible = self.getTopmostVisibleOverlay();\n          self.setFocus(topVisible?.component ?? entry.preFocus);\n        }\n        if (self.overlayStack.length === 0) self.terminal.hideCursor();\n        self.requestRender();\n      }\n    },\n    setHidden: (hidden: boolean) => {\n      if (entry.hidden === hidden) return;\n      entry.hidden = hidden;\n      // Update focus when hiding/showing\n      if (hidden) {\n        self.clearOverlayFocusRestoreFor(entry);\n        // If self overlay had focus, move focus to next visible or preFocus\n        if (self.focusedComponent === component) {\n          const topVisible = self.getTopmostVisibleOverlay();\n          self.setFocus(topVisible?.component ?? entry.preFocus);\n        }\n      } else {\n        // Restore focus to self overlay when showing (if it's actually visible)\n        if (!options?.nonCapturing && self.isOverlayVisible(entry)) {\n          entry.focusOrder = ++self.focusOrderCounter;\n          self.setFocus(component);\n        }\n      }\n      self.requestRender();\n    },\n    isHidden: () => entry.hidden,\n    focus: () => {\n      if (!self.overlayStack.includes(entry) || !self.isOverlayVisible(entry)) return;\n      entry.focusOrder = ++self.focusOrderCounter;\n      self.setFocus(component);\n      self.requestRender();\n    },\n    unfocus: (unfocusOptions) => {\n      const isFocused = self.focusedComponent === component;\n      const restoreState = self.overlayFocusRestore;\n      const hasPendingRestore = restoreState.status !== \"inactive\" && restoreState.overlay === entry;\n      if (!isFocused && !hasPendingRestore) return;\n      if (\n        restoreState.status === \"blocked\" &&\n        restoreState.overlay === entry &&\n        self.focusedComponent === restoreState.blockedBy\n      ) {\n        if (unfocusOptions) {\n          self.overlayFocusRestore = {\n            status: \"blocked\",\n            overlay: entry,\n            blockedBy: restoreState.blockedBy,\n            resume: { status: \"focus-target\", target: unfocusOptions.target },\n          };\n        } else {\n          self.clearOverlayFocusRestore();\n        }\n        self.requestRender();\n        return;\n      }\n      self.clearOverlayFocusRestoreFor(entry);\n      if (isFocused || unfocusOptions) {\n        const topVisible = self.getTopmostVisibleOverlay();\n        const fallbackTarget = topVisible && topVisible !== entry ? topVisible.component : entry.preFocus;\n        self.setFocus(unfocusOptions ? unfocusOptions.target : fallbackTarget);\n      }\n      self.requestRender();\n    },\n    isFocused: () => self.focusedComponent === component,\n  };\n}\n\nexport function do_hideOverlay(self: TUI): void {\n  const overlay = self.overlayStack[self.overlayStack.length - 1];\n  if (!overlay) return;\n  self.clearOverlayFocusRestoreFor(overlay);\n  self.retargetOverlayPreFocus(overlay);\n  self.overlayStack.pop();\n  if (self.focusedComponent === overlay.component) {\n    // Find topmost visible overlay, or fall back to preFocus\n    const topVisible = self.getTopmostVisibleOverlay();\n    self.setFocus(topVisible?.component ?? overlay.preFocus);\n  }\n  if (self.overlayStack.length === 0) self.terminal.hideCursor();\n  self.requestRender();\n}\n\nexport function do_hasOverlay(self: TUI): boolean {\n  return self.overlayStack.some((o) => self.isOverlayVisible(o));\n}\n\nexport function do_isOverlayVisible(self: TUI, entry: OverlayStackEntry): boolean {\n  if (entry.hidden) return false;\n  if (entry.options?.visible) {\n    return entry.options.visible(self.terminal.columns, self.terminal.rows);\n  }\n  return true;\n}\n\nexport function do_getTopmostVisibleOverlay(self: TUI): OverlayStackEntry | undefined {\n  let topmost: OverlayStackEntry | undefined;\n  for (const overlay of self.overlayStack) {\n    if (overlay.options?.nonCapturing || !self.isOverlayVisible(overlay)) continue;\n    if (!topmost || overlay.focusOrder > topmost.focusOrder) {\n      topmost = overlay;\n    }\n  }\n  return topmost;\n}\n\nexport function do_start(self: TUI): void {\n  self.stopped = false;\n  self.terminal.start(\n    (data) => self.handleInput(data),\n    () => self.requestRender(),\n  );\n  self.terminal.hideCursor();\n  self.queryCellSize();\n  self.requestRender();\n}\n\nexport function do_addInputListener(self: TUI, listener: InputListener): () => void {\n  self.inputListeners.add(listener);\n  return () => {\n    self.inputListeners.delete(listener);\n  };\n}\n\nexport function do_removeInputListener(self: TUI, listener: InputListener): void {\n  self.inputListeners.delete(listener);\n}\n"]}

package/dist/tui/tui-methods/overlay-management.js

@@ -0,0 +1,152 @@
+export function do_showOverlay(self, component, options) {
+    const entry = {
+        component,
+        ...(options === undefined ? {} : { options }),
+        preFocus: self.focusedComponent,
+        hidden: false,
+        focusOrder: ++self.focusOrderCounter,
+    };
+    self.overlayStack.push(entry);
+    // Only focus if overlay is actually visible
+    if (!options?.nonCapturing && self.isOverlayVisible(entry)) {
+        self.setFocus(component);
+    }
+    self.terminal.hideCursor();
+    self.requestRender();
+    // Return handle for controlling self overlay
+    return {
+        hide: () => {
+            const index = self.overlayStack.indexOf(entry);
+            if (index !== -1) {
+                self.clearOverlayFocusRestoreFor(entry);
+                self.retargetOverlayPreFocus(entry);
+                self.overlayStack.splice(index, 1);
+                // Restore focus if self overlay had focus
+                if (self.focusedComponent === component) {
+                    const topVisible = self.getTopmostVisibleOverlay();
+                    self.setFocus(topVisible?.component ?? entry.preFocus);
+                }
+                if (self.overlayStack.length === 0)
+                    self.terminal.hideCursor();
+                self.requestRender();
+            }
+        },
+        setHidden: (hidden) => {
+            if (entry.hidden === hidden)
+                return;
+            entry.hidden = hidden;
+            // Update focus when hiding/showing
+            if (hidden) {
+                self.clearOverlayFocusRestoreFor(entry);
+                // If self overlay had focus, move focus to next visible or preFocus
+                if (self.focusedComponent === component) {
+                    const topVisible = self.getTopmostVisibleOverlay();
+                    self.setFocus(topVisible?.component ?? entry.preFocus);
+                }
+            }
+            else {
+                // Restore focus to self overlay when showing (if it's actually visible)
+                if (!options?.nonCapturing && self.isOverlayVisible(entry)) {
+                    entry.focusOrder = ++self.focusOrderCounter;
+                    self.setFocus(component);
+                }
+            }
+            self.requestRender();
+        },
+        isHidden: () => entry.hidden,
+        focus: () => {
+            if (!self.overlayStack.includes(entry) || !self.isOverlayVisible(entry))
+                return;
+            entry.focusOrder = ++self.focusOrderCounter;
+            self.setFocus(component);
+            self.requestRender();
+        },
+        unfocus: (unfocusOptions) => {
+            const isFocused = self.focusedComponent === component;
+            const restoreState = self.overlayFocusRestore;
+            const hasPendingRestore = restoreState.status !== "inactive" && restoreState.overlay === entry;
+            if (!isFocused && !hasPendingRestore)
+                return;
+            if (restoreState.status === "blocked" &&
+                restoreState.overlay === entry &&
+                self.focusedComponent === restoreState.blockedBy) {
+                if (unfocusOptions) {
+                    self.overlayFocusRestore = {
+                        status: "blocked",
+                        overlay: entry,
+                        blockedBy: restoreState.blockedBy,
+                        resume: { status: "focus-target", target: unfocusOptions.target },
+                    };
+                }
+                else {
+                    self.clearOverlayFocusRestore();
+                }
+                self.requestRender();
+                return;
+            }
+            self.clearOverlayFocusRestoreFor(entry);
+            if (isFocused || unfocusOptions) {
+                const topVisible = self.getTopmostVisibleOverlay();
+                const fallbackTarget = topVisible && topVisible !== entry ? topVisible.component : entry.preFocus;
+                self.setFocus(unfocusOptions ? unfocusOptions.target : fallbackTarget);
+            }
+            self.requestRender();
+        },
+        isFocused: () => self.focusedComponent === component,
+    };
+}
+export function do_hideOverlay(self) {
+    const overlay = self.overlayStack[self.overlayStack.length - 1];
+    if (!overlay)
+        return;
+    self.clearOverlayFocusRestoreFor(overlay);
+    self.retargetOverlayPreFocus(overlay);
+    self.overlayStack.pop();
+    if (self.focusedComponent === overlay.component) {
+        // Find topmost visible overlay, or fall back to preFocus
+        const topVisible = self.getTopmostVisibleOverlay();
+        self.setFocus(topVisible?.component ?? overlay.preFocus);
+    }
+    if (self.overlayStack.length === 0)
+        self.terminal.hideCursor();
+    self.requestRender();
+}
+export function do_hasOverlay(self) {
+    return self.overlayStack.some((o) => self.isOverlayVisible(o));
+}
+export function do_isOverlayVisible(self, entry) {
+    if (entry.hidden)
+        return false;
+    if (entry.options?.visible) {
+        return entry.options.visible(self.terminal.columns, self.terminal.rows);
+    }
+    return true;
+}
+export function do_getTopmostVisibleOverlay(self) {
+    let topmost;
+    for (const overlay of self.overlayStack) {
+        if (overlay.options?.nonCapturing || !self.isOverlayVisible(overlay))
+            continue;
+        if (!topmost || overlay.focusOrder > topmost.focusOrder) {
+            topmost = overlay;
+        }
+    }
+    return topmost;
+}
+export function do_start(self) {
+    self.stopped = false;
+    self.terminal.start((data) => self.handleInput(data), () => self.requestRender());
+    self.terminal.hideCursor();
+    self.queryCellSize();
+    self.requestRender();
+}
+export function do_addInputListener(self, listener) {
+    self.inputListeners.add(listener);
+    return () => {
+        self.inputListeners.delete(listener);
+    };
+}
+export function do_removeInputListener(self, listener) {
+    self.inputListeners.delete(listener);
+}
+//# sourceMappingURL=overlay-management.js.map

package/dist/tui/tui-methods/overlay-management.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"overlay-management.js","sourceRoot":"","sources":["../../../src/tui/tui-methods/overlay-management.ts"],"names":[],"mappings":"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","sourcesContent":["import type { TUI } from \"../tui.ts\";\nimport type { Component, InputListener, OverlayHandle, OverlayOptions, OverlayStackEntry } from \"../types.ts\";\n\nexport function do_showOverlay(self: TUI, component: Component, options?: OverlayOptions): OverlayHandle {\n  const entry: OverlayStackEntry = {\n    component,\n    ...(options === undefined ? {} : { options }),\n    preFocus: self.focusedComponent,\n    hidden: false,\n    focusOrder: ++self.focusOrderCounter,\n  };\n  self.overlayStack.push(entry);\n  // Only focus if overlay is actually visible\n  if (!options?.nonCapturing && self.isOverlayVisible(entry)) {\n    self.setFocus(component);\n  }\n  self.terminal.hideCursor();\n  self.requestRender();\n\n  // Return handle for controlling self overlay\n  return {\n    hide: () => {\n      const index = self.overlayStack.indexOf(entry);\n      if (index !== -1) {\n        self.clearOverlayFocusRestoreFor(entry);\n        self.retargetOverlayPreFocus(entry);\n        self.overlayStack.splice(index, 1);\n        // Restore focus if self overlay had focus\n        if (self.focusedComponent === component) {\n          const topVisible = self.getTopmostVisibleOverlay();\n          self.setFocus(topVisible?.component ?? entry.preFocus);\n        }\n        if (self.overlayStack.length === 0) self.terminal.hideCursor();\n        self.requestRender();\n      }\n    },\n    setHidden: (hidden: boolean) => {\n      if (entry.hidden === hidden) return;\n      entry.hidden = hidden;\n      // Update focus when hiding/showing\n      if (hidden) {\n        self.clearOverlayFocusRestoreFor(entry);\n        // If self overlay had focus, move focus to next visible or preFocus\n        if (self.focusedComponent === component) {\n          const topVisible = self.getTopmostVisibleOverlay();\n          self.setFocus(topVisible?.component ?? entry.preFocus);\n        }\n      } else {\n        // Restore focus to self overlay when showing (if it's actually visible)\n        if (!options?.nonCapturing && self.isOverlayVisible(entry)) {\n          entry.focusOrder = ++self.focusOrderCounter;\n          self.setFocus(component);\n        }\n      }\n      self.requestRender();\n    },\n    isHidden: () => entry.hidden,\n    focus: () => {\n      if (!self.overlayStack.includes(entry) || !self.isOverlayVisible(entry)) return;\n      entry.focusOrder = ++self.focusOrderCounter;\n      self.setFocus(component);\n      self.requestRender();\n    },\n    unfocus: (unfocusOptions) => {\n      const isFocused = self.focusedComponent === component;\n      const restoreState = self.overlayFocusRestore;\n      const hasPendingRestore = restoreState.status !== \"inactive\" && restoreState.overlay === entry;\n      if (!isFocused && !hasPendingRestore) return;\n      if (\n        restoreState.status === \"blocked\" &&\n        restoreState.overlay === entry &&\n        self.focusedComponent === restoreState.blockedBy\n      ) {\n        if (unfocusOptions) {\n          self.overlayFocusRestore = {\n            status: \"blocked\",\n            overlay: entry,\n            blockedBy: restoreState.blockedBy,\n            resume: { status: \"focus-target\", target: unfocusOptions.target },\n          };\n        } else {\n          self.clearOverlayFocusRestore();\n        }\n        self.requestRender();\n        return;\n      }\n      self.clearOverlayFocusRestoreFor(entry);\n      if (isFocused || unfocusOptions) {\n        const topVisible = self.getTopmostVisibleOverlay();\n        const fallbackTarget = topVisible && topVisible !== entry ? topVisible.component : entry.preFocus;\n        self.setFocus(unfocusOptions ? unfocusOptions.target : fallbackTarget);\n      }\n      self.requestRender();\n    },\n    isFocused: () => self.focusedComponent === component,\n  };\n}\n\nexport function do_hideOverlay(self: TUI): void {\n  const overlay = self.overlayStack[self.overlayStack.length - 1];\n  if (!overlay) return;\n  self.clearOverlayFocusRestoreFor(overlay);\n  self.retargetOverlayPreFocus(overlay);\n  self.overlayStack.pop();\n  if (self.focusedComponent === overlay.component) {\n    // Find topmost visible overlay, or fall back to preFocus\n    const topVisible = self.getTopmostVisibleOverlay();\n    self.setFocus(topVisible?.component ?? overlay.preFocus);\n  }\n  if (self.overlayStack.length === 0) self.terminal.hideCursor();\n  self.requestRender();\n}\n\nexport function do_hasOverlay(self: TUI): boolean {\n  return self.overlayStack.some((o) => self.isOverlayVisible(o));\n}\n\nexport function do_isOverlayVisible(self: TUI, entry: OverlayStackEntry): boolean {\n  if (entry.hidden) return false;\n  if (entry.options?.visible) {\n    return entry.options.visible(self.terminal.columns, self.terminal.rows);\n  }\n  return true;\n}\n\nexport function do_getTopmostVisibleOverlay(self: TUI): OverlayStackEntry | undefined {\n  let topmost: OverlayStackEntry | undefined;\n  for (const overlay of self.overlayStack) {\n    if (overlay.options?.nonCapturing || !self.isOverlayVisible(overlay)) continue;\n    if (!topmost || overlay.focusOrder > topmost.focusOrder) {\n      topmost = overlay;\n    }\n  }\n  return topmost;\n}\n\nexport function do_start(self: TUI): void {\n  self.stopped = false;\n  self.terminal.start(\n    (data) => self.handleInput(data),\n    () => self.requestRender(),\n  );\n  self.terminal.hideCursor();\n  self.queryCellSize();\n  self.requestRender();\n}\n\nexport function do_addInputListener(self: TUI, listener: InputListener): () => void {\n  self.inputListeners.add(listener);\n  return () => {\n    self.inputListeners.delete(listener);\n  };\n}\n\nexport function do_removeInputListener(self: TUI, listener: InputListener): void {\n  self.inputListeners.delete(listener);\n}\n"]}

package/dist/tui/tui-methods/render-pipeline.d.ts

@@ -0,0 +1,3 @@
+import type { TUI } from "../tui.ts";
+export declare function do_doRender(self: TUI): void;
+//# sourceMappingURL=render-pipeline.d.ts.map

package/dist/tui/tui-methods/render-pipeline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"render-pipeline.d.ts","sourceRoot":"","sources":["../../../src/tui/tui-methods/render-pipeline.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,WAAW,CAAC;AAGrC,wBAAgB,WAAW,CAAC,IAAI,EAAE,GAAG,GAAG,IAAI,CAgL3C","sourcesContent":["import * as fs from \"node:fs\";\nimport * as os from \"node:os\";\nimport * as path from \"node:path\";\nimport { isImageLine } from \"../../terminal-image.ts\";\nimport { isTermuxSession } from \"../helpers.ts\";\nimport type { TUI } from \"../tui.ts\";\nimport { renderIncremental } from \"./incremental-render.ts\";\n\nexport function do_doRender(self: TUI): void {\n  if (self.stopped) return;\n  const width = self.terminal.columns;\n  const height = self.terminal.rows;\n  const widthChanged = self.previousWidth !== 0 && self.previousWidth !== width;\n  const heightChanged = self.previousHeight !== 0 && self.previousHeight !== height;\n  const previousBufferLength = self.previousHeight > 0 ? self.previousViewportTop + self.previousHeight : height;\n  const prevViewportTop = heightChanged ? Math.max(0, previousBufferLength - height) : self.previousViewportTop;\n  const viewportTop = prevViewportTop;\n  const hardwareCursorRow = self.hardwareCursorRow;\n  const computeLineDiff = (targetRow: number): number => {\n    const currentScreenRow = hardwareCursorRow - prevViewportTop;\n    const targetScreenRow = targetRow - viewportTop;\n    return targetScreenRow - currentScreenRow;\n  };\n\n  // Render all components to get new lines\n  let newLines = self.render(width);\n\n  // Composite overlays into the rendered lines (before differential compare)\n  if (self.overlayStack.length > 0) {\n    newLines = self.compositeOverlays(newLines, width, height);\n  }\n\n  // Extract cursor position before applying line resets (marker must be found first)\n  const cursorPos = self.extractCursorPosition(newLines, height);\n\n  newLines = self.applyLineResets(newLines);\n\n  // Helper to clear scrollback and viewport and render all new lines\n  const fullRender = (clear: boolean): void => {\n    self.fullRedrawCount += 1;\n    let buffer = \"\\x1b[?2026h\"; // Begin synchronized output\n    if (clear) {\n      buffer += self.deleteKittyImages(self.previousKittyImageIds);\n      buffer += \"\\x1b[2J\\x1b[H\\x1b[3J\"; // Clear screen, home, then clear scrollback\n    }\n    for (let i = 0; i < newLines.length; i++) {\n      if (i > 0) buffer += \"\\r\\n\";\n      const line = newLines[i];\n      const isImage = isImageLine(line);\n      const imageReservedRows = isImage ? self.getKittyImageReservedRows(newLines, i) : 1;\n      if (imageReservedRows > 1 && imageReservedRows <= height) {\n        for (let row = 1; row < imageReservedRows; row++) {\n          buffer += \"\\r\\n\";\n        }\n        buffer += `\\x1b[${imageReservedRows - 1}A`;\n        buffer += line;\n        buffer += `\\x1b[${imageReservedRows - 1}B`;\n        i += imageReservedRows - 1;\n        continue;\n      }\n      buffer += line;\n    }\n    buffer += \"\\x1b[?2026l\"; // End synchronized output\n    self.terminal.write(buffer);\n    self.cursorRow = Math.max(0, newLines.length - 1);\n    self.hardwareCursorRow = self.cursorRow;\n    // Reset max lines when clearing, otherwise track growth\n    if (clear) {\n      self.maxLinesRendered = newLines.length;\n    } else {\n      self.maxLinesRendered = Math.max(self.maxLinesRendered, newLines.length);\n    }\n    const bufferLength = Math.max(height, newLines.length);\n    self.previousViewportTop = Math.max(0, bufferLength - height);\n    self.positionHardwareCursor(cursorPos, newLines.length);\n    self.previousLines = newLines;\n    self.previousKittyImageIds = self.collectKittyImageIds(newLines);\n    self.previousWidth = width;\n    self.previousHeight = height;\n  };\n\n  const debugRedraw = process.env.PI_DEBUG_REDRAW === \"1\";\n  const logRedraw = (reason: string): void => {\n    if (!debugRedraw) return;\n    const logPath = path.join(os.homedir(), \".p\", \"agent\", \"pi-debug.log\");\n    const msg = `[${new Date().toISOString()}] fullRender: ${reason} (prev=${self.previousLines.length}, new=${newLines.length}, height=${height})\\n`;\n    fs.appendFileSync(logPath, msg);\n  };\n\n  // First render - just output everything without clearing (assumes clean screen)\n  if (self.previousLines.length === 0 && !widthChanged && !heightChanged) {\n    logRedraw(\"first render\");\n    fullRender(false);\n    return;\n  }\n\n  // Width changes always need a full re-render because wrapping changes.\n  if (widthChanged) {\n    logRedraw(`terminal width changed (${self.previousWidth} -> ${width})`);\n    fullRender(true);\n    return;\n  }\n\n  // Height changes normally need a full re-render to keep the visible viewport aligned,\n  // but Termux changes height when the software keyboard shows or hides.\n  // In that environment, a full redraw causes the entire history to replay on every toggle.\n  if (heightChanged && !isTermuxSession()) {\n    logRedraw(`terminal height changed (${self.previousHeight} -> ${height})`);\n    fullRender(true);\n    return;\n  }\n\n  // Content shrunk below the working area and no overlays - re-render to clear empty rows\n  // (overlays need the padding, so only do self when no overlays are active)\n  // Configurable via setClearOnShrink() or PI_CLEAR_ON_SHRINK=0 env var\n  if (self.clearOnShrink && newLines.length < self.maxLinesRendered && self.overlayStack.length === 0) {\n    logRedraw(`clearOnShrink (maxLinesRendered=${self.maxLinesRendered})`);\n    fullRender(true);\n    return;\n  }\n\n  // When an overlay is active or was just active, redraw only the visible screen rows (last height lines)\n  // with synchronized output without clearing scrollback history (\\x1b[3J) or dumping screen to scrollback (\\x1b[2J).\n  const newViewportTop = Math.max(0, newLines.length - height);\n  const visibleOverlayCount = self.overlayStack.filter((e) => self.isOverlayVisible(e)).length;\n  const hasVisibleOverlay = visibleOverlayCount > 0;\n  const hadVisibleOverlay = self.previousOverlayCount > 0;\n  self.previousOverlayCount = visibleOverlayCount;\n\n  if (hasVisibleOverlay || hadVisibleOverlay) {\n    logRedraw(`overlay active redraw (has=${hasVisibleOverlay}, had=${hadVisibleOverlay})`);\n    let buffer = \"\\x1b[?2026h\\x1b[H\";\n    const visibleEnd = Math.min(newLines.length, newViewportTop + height);\n    for (let i = newViewportTop; i < visibleEnd; i++) {\n      buffer += \"\\x1b[2K\";\n      buffer += newLines[i];\n      if (i < visibleEnd - 1) {\n        buffer += \"\\r\\n\";\n      }\n    }\n    const renderedCount = visibleEnd - newViewportTop;\n    if (renderedCount === 0) {\n      buffer += \"\\x1b[2K\";\n      for (let i = 1; i < height; i++) {\n        buffer += \"\\r\\n\\x1b[2K\";\n      }\n      if (height > 1) {\n        buffer += `\\x1b[${height - 1}A`;\n      }\n    } else if (renderedCount < height) {\n      for (let i = renderedCount; i < height; i++) {\n        buffer += \"\\r\\n\\x1b[2K\";\n      }\n      const moveBack = height - renderedCount;\n      if (moveBack > 0) {\n        buffer += `\\x1b[${moveBack}A`;\n      }\n    }\n    buffer += \"\\x1b[?2026l\";\n    self.terminal.write(buffer);\n    self.previousLines = newLines;\n    self.previousKittyImageIds = self.collectKittyImageIds(newLines);\n    self.previousWidth = width;\n    self.previousHeight = height;\n    self.previousViewportTop = newViewportTop;\n    self.cursorRow = Math.max(0, visibleEnd - 1);\n    self.hardwareCursorRow = self.cursorRow;\n    self.maxLinesRendered = Math.max(self.maxLinesRendered, newLines.length);\n    self.positionHardwareCursor(cursorPos, newLines.length);\n    return;\n  }\n\n  renderIncremental(self, {\n    computeLineDiff,\n    cursorPos,\n    fullRender,\n    hardwareCursorRow,\n    height,\n    logRedraw,\n    newLines,\n    prevViewportTop,\n    viewportTop,\n    width,\n  });\n}\n"]}

package/dist/tui/tui-methods/render-pipeline.js

@@ -0,0 +1,176 @@
+import * as fs from "node:fs";
+import * as os from "node:os";
+import * as path from "node:path";
+import { isImageLine } from "../../terminal-image.js";
+import { isTermuxSession } from "../helpers.js";
+import { renderIncremental } from "./incremental-render.js";
+export function do_doRender(self) {
+    if (self.stopped)
+        return;
+    const width = self.terminal.columns;
+    const height = self.terminal.rows;
+    const widthChanged = self.previousWidth !== 0 && self.previousWidth !== width;
+    const heightChanged = self.previousHeight !== 0 && self.previousHeight !== height;
+    const previousBufferLength = self.previousHeight > 0 ? self.previousViewportTop + self.previousHeight : height;
+    const prevViewportTop = heightChanged ? Math.max(0, previousBufferLength - height) : self.previousViewportTop;
+    const viewportTop = prevViewportTop;
+    const hardwareCursorRow = self.hardwareCursorRow;
+    const computeLineDiff = (targetRow) => {
+        const currentScreenRow = hardwareCursorRow - prevViewportTop;
+        const targetScreenRow = targetRow - viewportTop;
+        return targetScreenRow - currentScreenRow;
+    };
+    // Render all components to get new lines
+    let newLines = self.render(width);
+    // Composite overlays into the rendered lines (before differential compare)
+    if (self.overlayStack.length > 0) {
+        newLines = self.compositeOverlays(newLines, width, height);
+    }
+    // Extract cursor position before applying line resets (marker must be found first)
+    const cursorPos = self.extractCursorPosition(newLines, height);
+    newLines = self.applyLineResets(newLines);
+    // Helper to clear scrollback and viewport and render all new lines
+    const fullRender = (clear) => {
+        self.fullRedrawCount += 1;
+        let buffer = "\x1b[?2026h"; // Begin synchronized output
+        if (clear) {
+            buffer += self.deleteKittyImages(self.previousKittyImageIds);
+            buffer += "\x1b[2J\x1b[H\x1b[3J"; // Clear screen, home, then clear scrollback
+        }
+        for (let i = 0; i < newLines.length; i++) {
+            if (i > 0)
+                buffer += "\r\n";
+            const line = newLines[i];
+            const isImage = isImageLine(line);
+            const imageReservedRows = isImage ? self.getKittyImageReservedRows(newLines, i) : 1;
+            if (imageReservedRows > 1 && imageReservedRows <= height) {
+                for (let row = 1; row < imageReservedRows; row++) {
+                    buffer += "\r\n";
+                }
+                buffer += `\x1b[${imageReservedRows - 1}A`;
+                buffer += line;
+                buffer += `\x1b[${imageReservedRows - 1}B`;
+                i += imageReservedRows - 1;
+                continue;
+            }
+            buffer += line;
+        }
+        buffer += "\x1b[?2026l"; // End synchronized output
+        self.terminal.write(buffer);
+        self.cursorRow = Math.max(0, newLines.length - 1);
+        self.hardwareCursorRow = self.cursorRow;
+        // Reset max lines when clearing, otherwise track growth
+        if (clear) {
+            self.maxLinesRendered = newLines.length;
+        }
+        else {
+            self.maxLinesRendered = Math.max(self.maxLinesRendered, newLines.length);
+        }
+        const bufferLength = Math.max(height, newLines.length);
+        self.previousViewportTop = Math.max(0, bufferLength - height);
+        self.positionHardwareCursor(cursorPos, newLines.length);
+        self.previousLines = newLines;
+        self.previousKittyImageIds = self.collectKittyImageIds(newLines);
+        self.previousWidth = width;
+        self.previousHeight = height;
+    };
+    const debugRedraw = process.env.PI_DEBUG_REDRAW === "1";
+    const logRedraw = (reason) => {
+        if (!debugRedraw)
+            return;
+        const logPath = path.join(os.homedir(), ".p", "agent", "pi-debug.log");
+        const msg = `[${new Date().toISOString()}] fullRender: ${reason} (prev=${self.previousLines.length}, new=${newLines.length}, height=${height})\n`;
+        fs.appendFileSync(logPath, msg);
+    };
+    // First render - just output everything without clearing (assumes clean screen)
+    if (self.previousLines.length === 0 && !widthChanged && !heightChanged) {
+        logRedraw("first render");
+        fullRender(false);
+        return;
+    }
+    // Width changes always need a full re-render because wrapping changes.
+    if (widthChanged) {
+        logRedraw(`terminal width changed (${self.previousWidth} -> ${width})`);
+        fullRender(true);
+        return;
+    }
+    // Height changes normally need a full re-render to keep the visible viewport aligned,
+    // but Termux changes height when the software keyboard shows or hides.
+    // In that environment, a full redraw causes the entire history to replay on every toggle.
+    if (heightChanged && !isTermuxSession()) {
+        logRedraw(`terminal height changed (${self.previousHeight} -> ${height})`);
+        fullRender(true);
+        return;
+    }
+    // Content shrunk below the working area and no overlays - re-render to clear empty rows
+    // (overlays need the padding, so only do self when no overlays are active)
+    // Configurable via setClearOnShrink() or PI_CLEAR_ON_SHRINK=0 env var
+    if (self.clearOnShrink && newLines.length < self.maxLinesRendered && self.overlayStack.length === 0) {
+        logRedraw(`clearOnShrink (maxLinesRendered=${self.maxLinesRendered})`);
+        fullRender(true);
+        return;
+    }
+    // When an overlay is active or was just active, redraw only the visible screen rows (last height lines)
+    // with synchronized output without clearing scrollback history (\x1b[3J) or dumping screen to scrollback (\x1b[2J).
+    const newViewportTop = Math.max(0, newLines.length - height);
+    const visibleOverlayCount = self.overlayStack.filter((e) => self.isOverlayVisible(e)).length;
+    const hasVisibleOverlay = visibleOverlayCount > 0;
+    const hadVisibleOverlay = self.previousOverlayCount > 0;
+    self.previousOverlayCount = visibleOverlayCount;
+    if (hasVisibleOverlay || hadVisibleOverlay) {
+        logRedraw(`overlay active redraw (has=${hasVisibleOverlay}, had=${hadVisibleOverlay})`);
+        let buffer = "\x1b[?2026h\x1b[H";
+        const visibleEnd = Math.min(newLines.length, newViewportTop + height);
+        for (let i = newViewportTop; i < visibleEnd; i++) {
+            buffer += "\x1b[2K";
+            buffer += newLines[i];
+            if (i < visibleEnd - 1) {
+                buffer += "\r\n";
+            }
+        }
+        const renderedCount = visibleEnd - newViewportTop;
+        if (renderedCount === 0) {
+            buffer += "\x1b[2K";
+            for (let i = 1; i < height; i++) {
+                buffer += "\r\n\x1b[2K";
+            }
+            if (height > 1) {
+                buffer += `\x1b[${height - 1}A`;
+            }
+        }
+        else if (renderedCount < height) {
+            for (let i = renderedCount; i < height; i++) {
+                buffer += "\r\n\x1b[2K";
+            }
+            const moveBack = height - renderedCount;
+            if (moveBack > 0) {
+                buffer += `\x1b[${moveBack}A`;
+            }
+        }
+        buffer += "\x1b[?2026l";
+        self.terminal.write(buffer);
+        self.previousLines = newLines;
+        self.previousKittyImageIds = self.collectKittyImageIds(newLines);
+        self.previousWidth = width;
+        self.previousHeight = height;
+        self.previousViewportTop = newViewportTop;
+        self.cursorRow = Math.max(0, visibleEnd - 1);
+        self.hardwareCursorRow = self.cursorRow;
+        self.maxLinesRendered = Math.max(self.maxLinesRendered, newLines.length);
+        self.positionHardwareCursor(cursorPos, newLines.length);
+        return;
+    }
+    renderIncremental(self, {
+        computeLineDiff,
+        cursorPos,
+        fullRender,
+        hardwareCursorRow,
+        height,
+        logRedraw,
+        newLines,
+        prevViewportTop,
+        viewportTop,
+        width,
+    });
+}
+//# sourceMappingURL=render-pipeline.js.map

package/dist/tui/tui-methods/render-pipeline.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"render-pipeline.js","sourceRoot":"","sources":["../../../src/tui/tui-methods/render-pipeline.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AACtD,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAEhD,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAE5D,MAAM,UAAU,WAAW,CAAC,IAAS,EAAQ;IAC3C,IAAI,IAAI,CAAC,OAAO;QAAE,OAAO;IACzB,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC;IACpC,MAAM,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC;IAClC,MAAM,YAAY,GAAG,IAAI,CAAC,aAAa,KAAK,CAAC,IAAI,IAAI,CAAC,aAAa,KAAK,KAAK,CAAC;IAC9E,MAAM,aAAa,GAAG,IAAI,CAAC,cAAc,KAAK,CAAC,IAAI,IAAI,CAAC,cAAc,KAAK,MAAM,CAAC;IAClF,MAAM,oBAAoB,GAAG,IAAI,CAAC,cAAc,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,mBAAmB,GAAG,IAAI,CAAC,cAAc,CAAC,CAAC,CAAC,MAAM,CAAC;IAC/G,MAAM,eAAe,GAAG,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,oBAAoB,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,mBAAmB,CAAC;IAC9G,MAAM,WAAW,GAAG,eAAe,CAAC;IACpC,MAAM,iBAAiB,GAAG,IAAI,CAAC,iBAAiB,CAAC;IACjD,MAAM,eAAe,GAAG,CAAC,SAAiB,EAAU,EAAE,CAAC;QACrD,MAAM,gBAAgB,GAAG,iBAAiB,GAAG,eAAe,CAAC;QAC7D,MAAM,eAAe,GAAG,SAAS,GAAG,WAAW,CAAC;QAChD,OAAO,eAAe,GAAG,gBAAgB,CAAC;IAAA,CAC3C,CAAC;IAEF,yCAAyC;IACzC,IAAI,QAAQ,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAElC,2EAA2E;IAC3E,IAAI,IAAI,CAAC,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACjC,QAAQ,GAAG,IAAI,CAAC,iBAAiB,CAAC,QAAQ,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC;IAC7D,CAAC;IAED,mFAAmF;IACnF,MAAM,SAAS,GAAG,IAAI,CAAC,qBAAqB,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IAE/D,QAAQ,GAAG,IAAI,CAAC,eAAe,CAAC,QAAQ,CAAC,CAAC;IAE1C,mEAAmE;IACnE,MAAM,UAAU,GAAG,CAAC,KAAc,EAAQ,EAAE,CAAC;QAC3C,IAAI,CAAC,eAAe,IAAI,CAAC,CAAC;QAC1B,IAAI,MAAM,GAAG,aAAa,CAAC,CAAC,4BAA4B;QACxD,IAAI,KAAK,EAAE,CAAC;YACV,MAAM,IAAI,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC;YAC7D,MAAM,IAAI,sBAAsB,CAAC,CAAC,4CAA4C;QAChF,CAAC;QACD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,QAAQ,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACzC,IAAI,CAAC,GAAG,CAAC;gBAAE,MAAM,IAAI,MAAM,CAAC;YAC5B,MAAM,IAAI,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;YACzB,MAAM,OAAO,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC;YAClC,MAAM,iBAAiB,GAAG,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,yBAAyB,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YACpF,IAAI,iBAAiB,GAAG,CAAC,IAAI,iBAAiB,IAAI,MAAM,EAAE,CAAC;gBACzD,KAAK,IAAI,GAAG,GAAG,CAAC,EAAE,GAAG,GAAG,iBAAiB,EAAE,GAAG,EAAE,EAAE,CAAC;oBACjD,MAAM,IAAI,MAAM,CAAC;gBACnB,CAAC;gBACD,MAAM,IAAI,QAAQ,iBAAiB,GAAG,CAAC,GAAG,CAAC;gBAC3C,MAAM,IAAI,IAAI,CAAC;gBACf,MAAM,IAAI,QAAQ,iBAAiB,GAAG,CAAC,GAAG,CAAC;gBAC3C,CAAC,IAAI,iBAAiB,GAAG,CAAC,CAAC;gBAC3B,SAAS;YACX,CAAC;YACD,MAAM,IAAI,IAAI,CAAC;QACjB,CAAC;QACD,MAAM,IAAI,aAAa,CAAC,CAAC,0BAA0B;QACnD,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QAC5B,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QAClD,IAAI,CAAC,iBAAiB,GAAG,IAAI,CAAC,SAAS,CAAC;QACxC,wDAAwD;QACxD,IAAI,KAAK,EAAE,CAAC;YACV,IAAI,CAAC,gBAAgB,GAAG,QAAQ,CAAC,MAAM,CAAC;QAC1C,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,gBAAgB,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,gBAAgB,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;QAC3E,CAAC;QACD,MAAM,YAAY,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;QACvD,IAAI,CAAC,mBAAmB,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,YAAY,GAAG,MAAM,CAAC,CAAC;QAC9D,IAAI,CAAC,sBAAsB,CAAC,SAAS,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;QACxD,IAAI,CAAC,aAAa,GAAG,QAAQ,CAAC;QAC9B,IAAI,CAAC,qBAAqB,GAAG,IAAI,CAAC,oBAAoB,CAAC,QAAQ,CAAC,CAAC;QACjE,IAAI,CAAC,aAAa,GAAG,KAAK,CAAC;QAC3B,IAAI,CAAC,cAAc,GAAG,MAAM,CAAC;IAAA,CAC9B,CAAC;IAEF,MAAM,WAAW,GAAG,OAAO,CAAC,GAAG,CAAC,eAAe,KAAK,GAAG,CAAC;IACxD,MAAM,SAAS,GAAG,CAAC,MAAc,EAAQ,EAAE,CAAC;QAC1C,IAAI,CAAC,WAAW;YAAE,OAAO;QACzB,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,cAAc,CAAC,CAAC;QACvE,MAAM,GAAG,GAAG,IAAI,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,iBAAiB,MAAM,UAAU,IAAI,CAAC,aAAa,CAAC,MAAM,SAAS,QAAQ,CAAC,MAAM,YAAY,MAAM,KAAK,CAAC;QAClJ,EAAE,CAAC,cAAc,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;IAAA,CACjC,CAAC;IAEF,gFAAgF;IAChF,IAAI,IAAI,CAAC,aAAa,CAAC,MAAM,KAAK,CAAC,IAAI,CAAC,YAAY,IAAI,CAAC,aAAa,EAAE,CAAC;QACvE,SAAS,CAAC,cAAc,CAAC,CAAC;QAC1B,UAAU,CAAC,KAAK,CAAC,CAAC;QAClB,OAAO;IACT,CAAC;IAED,uEAAuE;IACvE,IAAI,YAAY,EAAE,CAAC;QACjB,SAAS,CAAC,2BAA2B,IAAI,CAAC,aAAa,OAAO,KAAK,GAAG,CAAC,CAAC;QACxE,UAAU,CAAC,IAAI,CAAC,CAAC;QACjB,OAAO;IACT,CAAC;IAED,sFAAsF;IACtF,uEAAuE;IACvE,0FAA0F;IAC1F,IAAI,aAAa,IAAI,CAAC,eAAe,EAAE,EAAE,CAAC;QACxC,SAAS,CAAC,4BAA4B,IAAI,CAAC,cAAc,OAAO,MAAM,GAAG,CAAC,CAAC;QAC3E,UAAU,CAAC,IAAI,CAAC,CAAC;QACjB,OAAO;IACT,CAAC;IAED,wFAAwF;IACxF,2EAA2E;IAC3E,sEAAsE;IACtE,IAAI,IAAI,CAAC,aAAa,IAAI,QAAQ,CAAC,MAAM,GAAG,IAAI,CAAC,gBAAgB,IAAI,IAAI,CAAC,YAAY,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACpG,SAAS,CAAC,mCAAmC,IAAI,CAAC,gBAAgB,GAAG,CAAC,CAAC;QACvE,UAAU,CAAC,IAAI,CAAC,CAAC;QACjB,OAAO;IACT,CAAC;IAED,wGAAwG;IACxG,oHAAoH;IACpH,MAAM,cAAc,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,QAAQ,CAAC,MAAM,GAAG,MAAM,CAAC,CAAC;IAC7D,MAAM,mBAAmB,GAAG,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;IAC7F,MAAM,iBAAiB,GAAG,mBAAmB,GAAG,CAAC,CAAC;IAClD,MAAM,iBAAiB,GAAG,IAAI,CAAC,oBAAoB,GAAG,CAAC,CAAC;IACxD,IAAI,CAAC,oBAAoB,GAAG,mBAAmB,CAAC;IAEhD,IAAI,iBAAiB,IAAI,iBAAiB,EAAE,CAAC;QAC3C,SAAS,CAAC,8BAA8B,iBAAiB,SAAS,iBAAiB,GAAG,CAAC,CAAC;QACxF,IAAI,MAAM,GAAG,mBAAmB,CAAC;QACjC,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,MAAM,EAAE,cAAc,GAAG,MAAM,CAAC,CAAC;QACtE,KAAK,IAAI,CAAC,GAAG,cAAc,EAAE,CAAC,GAAG,UAAU,EAAE,CAAC,EAAE,EAAE,CAAC;YACjD,MAAM,IAAI,SAAS,CAAC;YACpB,MAAM,IAAI,QAAQ,CAAC,CAAC,CAAC,CAAC;YACtB,IAAI,CAAC,GAAG,UAAU,GAAG,CAAC,EAAE,CAAC;gBACvB,MAAM,IAAI,MAAM,CAAC;YACnB,CAAC;QACH,CAAC;QACD,MAAM,aAAa,GAAG,UAAU,GAAG,cAAc,CAAC;QAClD,IAAI,aAAa,KAAK,CAAC,EAAE,CAAC;YACxB,MAAM,IAAI,SAAS,CAAC;YACpB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;gBAChC,MAAM,IAAI,aAAa,CAAC;YAC1B,CAAC;YACD,IAAI,MAAM,GAAG,CAAC,EAAE,CAAC;gBACf,MAAM,IAAI,QAAQ,MAAM,GAAG,CAAC,GAAG,CAAC;YAClC,CAAC;QACH,CAAC;aAAM,IAAI,aAAa,GAAG,MAAM,EAAE,CAAC;YAClC,KAAK,IAAI,CAAC,GAAG,aAAa,EAAE,CAAC,GAAG,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;gBAC5C,MAAM,IAAI,aAAa,CAAC;YAC1B,CAAC;YACD,MAAM,QAAQ,GAAG,MAAM,GAAG,aAAa,CAAC;YACxC,IAAI,QAAQ,GAAG,CAAC,EAAE,CAAC;gBACjB,MAAM,IAAI,QAAQ,QAAQ,GAAG,CAAC;YAChC,CAAC;QACH,CAAC;QACD,MAAM,IAAI,aAAa,CAAC;QACxB,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QAC5B,IAAI,CAAC,aAAa,GAAG,QAAQ,CAAC;QAC9B,IAAI,CAAC,qBAAqB,GAAG,IAAI,CAAC,oBAAoB,CAAC,QAAQ,CAAC,CAAC;QACjE,IAAI,CAAC,aAAa,GAAG,KAAK,CAAC;QAC3B,IAAI,CAAC,cAAc,GAAG,MAAM,CAAC;QAC7B,IAAI,CAAC,mBAAmB,GAAG,cAAc,CAAC;QAC1C,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,UAAU,GAAG,CAAC,CAAC,CAAC;QAC7C,IAAI,CAAC,iBAAiB,GAAG,IAAI,CAAC,SAAS,CAAC;QACxC,IAAI,CAAC,gBAAgB,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,gBAAgB,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;QACzE,IAAI,CAAC,sBAAsB,CAAC,SAAS,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;QACxD,OAAO;IACT,CAAC;IAED,iBAAiB,CAAC,IAAI,EAAE;QACtB,eAAe;QACf,SAAS;QACT,UAAU;QACV,iBAAiB;QACjB,MAAM;QACN,SAAS;QACT,QAAQ;QACR,eAAe;QACf,WAAW;QACX,KAAK;KACN,CAAC,CAAC;AAAA,CACJ","sourcesContent":["import * as fs from \"node:fs\";\nimport * as os from \"node:os\";\nimport * as path from \"node:path\";\nimport { isImageLine } from \"../../terminal-image.ts\";\nimport { isTermuxSession } from \"../helpers.ts\";\nimport type { TUI } from \"../tui.ts\";\nimport { renderIncremental } from \"./incremental-render.ts\";\n\nexport function do_doRender(self: TUI): void {\n  if (self.stopped) return;\n  const width = self.terminal.columns;\n  const height = self.terminal.rows;\n  const widthChanged = self.previousWidth !== 0 && self.previousWidth !== width;\n  const heightChanged = self.previousHeight !== 0 && self.previousHeight !== height;\n  const previousBufferLength = self.previousHeight > 0 ? self.previousViewportTop + self.previousHeight : height;\n  const prevViewportTop = heightChanged ? Math.max(0, previousBufferLength - height) : self.previousViewportTop;\n  const viewportTop = prevViewportTop;\n  const hardwareCursorRow = self.hardwareCursorRow;\n  const computeLineDiff = (targetRow: number): number => {\n    const currentScreenRow = hardwareCursorRow - prevViewportTop;\n    const targetScreenRow = targetRow - viewportTop;\n    return targetScreenRow - currentScreenRow;\n  };\n\n  // Render all components to get new lines\n  let newLines = self.render(width);\n\n  // Composite overlays into the rendered lines (before differential compare)\n  if (self.overlayStack.length > 0) {\n    newLines = self.compositeOverlays(newLines, width, height);\n  }\n\n  // Extract cursor position before applying line resets (marker must be found first)\n  const cursorPos = self.extractCursorPosition(newLines, height);\n\n  newLines = self.applyLineResets(newLines);\n\n  // Helper to clear scrollback and viewport and render all new lines\n  const fullRender = (clear: boolean): void => {\n    self.fullRedrawCount += 1;\n    let buffer = \"\\x1b[?2026h\"; // Begin synchronized output\n    if (clear) {\n      buffer += self.deleteKittyImages(self.previousKittyImageIds);\n      buffer += \"\\x1b[2J\\x1b[H\\x1b[3J\"; // Clear screen, home, then clear scrollback\n    }\n    for (let i = 0; i < newLines.length; i++) {\n      if (i > 0) buffer += \"\\r\\n\";\n      const line = newLines[i];\n      const isImage = isImageLine(line);\n      const imageReservedRows = isImage ? self.getKittyImageReservedRows(newLines, i) : 1;\n      if (imageReservedRows > 1 && imageReservedRows <= height) {\n        for (let row = 1; row < imageReservedRows; row++) {\n          buffer += \"\\r\\n\";\n        }\n        buffer += `\\x1b[${imageReservedRows - 1}A`;\n        buffer += line;\n        buffer += `\\x1b[${imageReservedRows - 1}B`;\n        i += imageReservedRows - 1;\n        continue;\n      }\n      buffer += line;\n    }\n    buffer += \"\\x1b[?2026l\"; // End synchronized output\n    self.terminal.write(buffer);\n    self.cursorRow = Math.max(0, newLines.length - 1);\n    self.hardwareCursorRow = self.cursorRow;\n    // Reset max lines when clearing, otherwise track growth\n    if (clear) {\n      self.maxLinesRendered = newLines.length;\n    } else {\n      self.maxLinesRendered = Math.max(self.maxLinesRendered, newLines.length);\n    }\n    const bufferLength = Math.max(height, newLines.length);\n    self.previousViewportTop = Math.max(0, bufferLength - height);\n    self.positionHardwareCursor(cursorPos, newLines.length);\n    self.previousLines = newLines;\n    self.previousKittyImageIds = self.collectKittyImageIds(newLines);\n    self.previousWidth = width;\n    self.previousHeight = height;\n  };\n\n  const debugRedraw = process.env.PI_DEBUG_REDRAW === \"1\";\n  const logRedraw = (reason: string): void => {\n    if (!debugRedraw) return;\n    const logPath = path.join(os.homedir(), \".p\", \"agent\", \"pi-debug.log\");\n    const msg = `[${new Date().toISOString()}] fullRender: ${reason} (prev=${self.previousLines.length}, new=${newLines.length}, height=${height})\\n`;\n    fs.appendFileSync(logPath, msg);\n  };\n\n  // First render - just output everything without clearing (assumes clean screen)\n  if (self.previousLines.length === 0 && !widthChanged && !heightChanged) {\n    logRedraw(\"first render\");\n    fullRender(false);\n    return;\n  }\n\n  // Width changes always need a full re-render because wrapping changes.\n  if (widthChanged) {\n    logRedraw(`terminal width changed (${self.previousWidth} -> ${width})`);\n    fullRender(true);\n    return;\n  }\n\n  // Height changes normally need a full re-render to keep the visible viewport aligned,\n  // but Termux changes height when the software keyboard shows or hides.\n  // In that environment, a full redraw causes the entire history to replay on every toggle.\n  if (heightChanged && !isTermuxSession()) {\n    logRedraw(`terminal height changed (${self.previousHeight} -> ${height})`);\n    fullRender(true);\n    return;\n  }\n\n  // Content shrunk below the working area and no overlays - re-render to clear empty rows\n  // (overlays need the padding, so only do self when no overlays are active)\n  // Configurable via setClearOnShrink() or PI_CLEAR_ON_SHRINK=0 env var\n  if (self.clearOnShrink && newLines.length < self.maxLinesRendered && self.overlayStack.length === 0) {\n    logRedraw(`clearOnShrink (maxLinesRendered=${self.maxLinesRendered})`);\n    fullRender(true);\n    return;\n  }\n\n  // When an overlay is active or was just active, redraw only the visible screen rows (last height lines)\n  // with synchronized output without clearing scrollback history (\\x1b[3J) or dumping screen to scrollback (\\x1b[2J).\n  const newViewportTop = Math.max(0, newLines.length - height);\n  const visibleOverlayCount = self.overlayStack.filter((e) => self.isOverlayVisible(e)).length;\n  const hasVisibleOverlay = visibleOverlayCount > 0;\n  const hadVisibleOverlay = self.previousOverlayCount > 0;\n  self.previousOverlayCount = visibleOverlayCount;\n\n  if (hasVisibleOverlay || hadVisibleOverlay) {\n    logRedraw(`overlay active redraw (has=${hasVisibleOverlay}, had=${hadVisibleOverlay})`);\n    let buffer = \"\\x1b[?2026h\\x1b[H\";\n    const visibleEnd = Math.min(newLines.length, newViewportTop + height);\n    for (let i = newViewportTop; i < visibleEnd; i++) {\n      buffer += \"\\x1b[2K\";\n      buffer += newLines[i];\n      if (i < visibleEnd - 1) {\n        buffer += \"\\r\\n\";\n      }\n    }\n    const renderedCount = visibleEnd - newViewportTop;\n    if (renderedCount === 0) {\n      buffer += \"\\x1b[2K\";\n      for (let i = 1; i < height; i++) {\n        buffer += \"\\r\\n\\x1b[2K\";\n      }\n      if (height > 1) {\n        buffer += `\\x1b[${height - 1}A`;\n      }\n    } else if (renderedCount < height) {\n      for (let i = renderedCount; i < height; i++) {\n        buffer += \"\\r\\n\\x1b[2K\";\n      }\n      const moveBack = height - renderedCount;\n      if (moveBack > 0) {\n        buffer += `\\x1b[${moveBack}A`;\n      }\n    }\n    buffer += \"\\x1b[?2026l\";\n    self.terminal.write(buffer);\n    self.previousLines = newLines;\n    self.previousKittyImageIds = self.collectKittyImageIds(newLines);\n    self.previousWidth = width;\n    self.previousHeight = height;\n    self.previousViewportTop = newViewportTop;\n    self.cursorRow = Math.max(0, visibleEnd - 1);\n    self.hardwareCursorRow = self.cursorRow;\n    self.maxLinesRendered = Math.max(self.maxLinesRendered, newLines.length);\n    self.positionHardwareCursor(cursorPos, newLines.length);\n    return;\n  }\n\n  renderIncremental(self, {\n    computeLineDiff,\n    cursorPos,\n    fullRender,\n    hardwareCursorRow,\n    height,\n    logRedraw,\n    newLines,\n    prevViewportTop,\n    viewportTop,\n    width,\n  });\n}\n"]}

package/dist/tui/tui-methods/render-width-error.d.ts

@@ -0,0 +1,3 @@
+import type { TUI } from "../tui.ts";
+export declare function throwRenderWidthError(self: TUI, newLines: string[], line: string, index: number, width: number): never;
+//# sourceMappingURL=render-width-error.d.ts.map

package/dist/tui/tui-methods/render-width-error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"render-width-error.d.ts","sourceRoot":"","sources":["../../../src/tui/tui-methods/render-width-error.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,WAAW,CAAC;AAErC,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,GAAG,EACT,QAAQ,EAAE,MAAM,EAAE,EAClB,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,GACZ,KAAK,CA2BP","sourcesContent":["import * as fs from \"node:fs\";\nimport * as os from \"node:os\";\nimport * as path from \"node:path\";\nimport { visibleWidth } from \"../../utils.ts\";\nimport type { TUI } from \"../tui.ts\";\n\nexport function throwRenderWidthError(\n  self: TUI,\n  newLines: string[],\n  line: string,\n  index: number,\n  width: number,\n): never {\n  const crashLogPath = path.join(os.homedir(), \".p\", \"agent\", \"pi-crash.log\");\n  const crashData = [\n    `Crash at ${new Date().toISOString()}`,\n    `Terminal width: ${width}`,\n    `Line ${index} visible width: ${visibleWidth(line)}`,\n    \"\",\n    \"=== All rendered lines ===\",\n    ...newLines.map(\n      (renderedLine, renderedIndex) => `[${renderedIndex}] (w=${visibleWidth(renderedLine)}) ${renderedLine}`,\n    ),\n    \"\",\n  ].join(\"\\n\");\n  fs.mkdirSync(path.dirname(crashLogPath), { recursive: true });\n  fs.writeFileSync(crashLogPath, crashData);\n  self.stop();\n\n  throw new Error(\n    [\n      `Rendered line ${index} exceeds terminal width (${visibleWidth(line)} > ${width}).`,\n      \"\",\n      \"This is likely caused by a custom TUI component not truncating its output.\",\n      \"Use visibleWidth() to measure and truncateToWidth() to truncate lines.\",\n      \"\",\n      `Debug log written to: ${crashLogPath}`,\n    ].join(\"\\n\"),\n  );\n}\n"]}

package/dist/tui/tui-methods/render-width-error.js

@@ -0,0 +1,28 @@
+import * as fs from "node:fs";
+import * as os from "node:os";
+import * as path from "node:path";
+import { visibleWidth } from "../../utils.js";
+export function throwRenderWidthError(self, newLines, line, index, width) {
+    const crashLogPath = path.join(os.homedir(), ".p", "agent", "pi-crash.log");
+    const crashData = [
+        `Crash at ${new Date().toISOString()}`,
+        `Terminal width: ${width}`,
+        `Line ${index} visible width: ${visibleWidth(line)}`,
+        "",
+        "=== All rendered lines ===",
+        ...newLines.map((renderedLine, renderedIndex) => `[${renderedIndex}] (w=${visibleWidth(renderedLine)}) ${renderedLine}`),
+        "",
+    ].join("\n");
+    fs.mkdirSync(path.dirname(crashLogPath), { recursive: true });
+    fs.writeFileSync(crashLogPath, crashData);
+    self.stop();
+    throw new Error([
+        `Rendered line ${index} exceeds terminal width (${visibleWidth(line)} > ${width}).`,
+        "",
+        "This is likely caused by a custom TUI component not truncating its output.",
+        "Use visibleWidth() to measure and truncateToWidth() to truncate lines.",
+        "",
+        `Debug log written to: ${crashLogPath}`,
+    ].join("\n"));
+}
+//# sourceMappingURL=render-width-error.js.map

package/dist/tui/tui-methods/render-width-error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"render-width-error.js","sourceRoot":"","sources":["../../../src/tui/tui-methods/render-width-error.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAG9C,MAAM,UAAU,qBAAqB,CACnC,IAAS,EACT,QAAkB,EAClB,IAAY,EACZ,KAAa,EACb,KAAa,EACN;IACP,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,cAAc,CAAC,CAAC;IAC5E,MAAM,SAAS,GAAG;QAChB,YAAY,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE;QACtC,mBAAmB,KAAK,EAAE;QAC1B,QAAQ,KAAK,mBAAmB,YAAY,CAAC,IAAI,CAAC,EAAE;QACpD,EAAE;QACF,4BAA4B;QAC5B,GAAG,QAAQ,CAAC,GAAG,CACb,CAAC,YAAY,EAAE,aAAa,EAAE,EAAE,CAAC,IAAI,aAAa,QAAQ,YAAY,CAAC,YAAY,CAAC,KAAK,YAAY,EAAE,CACxG;QACD,EAAE;KACH,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACb,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC9D,EAAE,CAAC,aAAa,CAAC,YAAY,EAAE,SAAS,CAAC,CAAC;IAC1C,IAAI,CAAC,IAAI,EAAE,CAAC;IAEZ,MAAM,IAAI,KAAK,CACb;QACE,iBAAiB,KAAK,4BAA4B,YAAY,CAAC,IAAI,CAAC,MAAM,KAAK,IAAI;QACnF,EAAE;QACF,4EAA4E;QAC5E,wEAAwE;QACxE,EAAE;QACF,yBAAyB,YAAY,EAAE;KACxC,CAAC,IAAI,CAAC,IAAI,CAAC,CACb,CAAC;AAAA,CACH","sourcesContent":["import * as fs from \"node:fs\";\nimport * as os from \"node:os\";\nimport * as path from \"node:path\";\nimport { visibleWidth } from \"../../utils.ts\";\nimport type { TUI } from \"../tui.ts\";\n\nexport function throwRenderWidthError(\n  self: TUI,\n  newLines: string[],\n  line: string,\n  index: number,\n  width: number,\n): never {\n  const crashLogPath = path.join(os.homedir(), \".p\", \"agent\", \"pi-crash.log\");\n  const crashData = [\n    `Crash at ${new Date().toISOString()}`,\n    `Terminal width: ${width}`,\n    `Line ${index} visible width: ${visibleWidth(line)}`,\n    \"\",\n    \"=== All rendered lines ===\",\n    ...newLines.map(\n      (renderedLine, renderedIndex) => `[${renderedIndex}] (w=${visibleWidth(renderedLine)}) ${renderedLine}`,\n    ),\n    \"\",\n  ].join(\"\\n\");\n  fs.mkdirSync(path.dirname(crashLogPath), { recursive: true });\n  fs.writeFileSync(crashLogPath, crashData);\n  self.stop();\n\n  throw new Error(\n    [\n      `Rendered line ${index} exceeds terminal width (${visibleWidth(line)} > ${width}).`,\n      \"\",\n      \"This is likely caused by a custom TUI component not truncating its output.\",\n      \"Use visibleWidth() to measure and truncateToWidth() to truncate lines.\",\n      \"\",\n      `Debug log written to: ${crashLogPath}`,\n    ].join(\"\\n\"),\n  );\n}\n"]}

package/dist/tui/tui-methods/terminal-control.d.ts

@@ -0,0 +1,8 @@
+import { TUI } from "../tui.ts";
+export declare function do_queryCellSize(self: TUI): void;
+export declare function do_setTerminalBackgroundColor(self: TUI, colorHex?: string): void;
+export declare function do_resetTerminalBackgroundColor(self: TUI): void;
+export declare function do_stop(self: TUI): void;
+export declare function do_requestRender(self: TUI, force?: boolean): void;
+export declare function do_scheduleRender(self: TUI): void;
+//# sourceMappingURL=terminal-control.d.ts.map

package/dist/tui/tui-methods/terminal-control.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"terminal-control.d.ts","sourceRoot":"","sources":["../../../src/tui/tui-methods/terminal-control.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,GAAG,EAAE,MAAM,WAAW,CAAC;AAEhC,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,GAAG,GAAG,IAAI,CAQhD;AAED,wBAAgB,6BAA6B,CAAC,IAAI,EAAE,GAAG,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAQhF;AAED,wBAAgB,+BAA+B,CAAC,IAAI,EAAE,GAAG,GAAG,IAAI,CAK/D;AAED,wBAAgB,OAAO,CAAC,IAAI,EAAE,GAAG,GAAG,IAAI,CAqBvC;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,GAAG,EAAE,KAAK,UAAQ,GAAG,IAAI,CA2B/D;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,GAAG,GAAG,IAAI,CAkBjD","sourcesContent":["import { performance } from \"node:perf_hooks\";\nimport { formatOsc11BackgroundColor, formatOsc111ResetBackgroundColor } from \"../../terminal-colors.ts\";\nimport { getCapabilities } from \"../../terminal-image.ts\";\nimport { TUI } from \"../tui.ts\";\n\nexport function do_queryCellSize(self: TUI): void {\n  // Only query if terminal supports images (cell size is only used for image rendering)\n  if (!getCapabilities().images) {\n    return;\n  }\n  // Query terminal for cell size in pixels: CSI 16 t\n  // Response format: CSI 6 ; height ; width t\n  self.terminal.write(\"\\x1b[16t\");\n}\n\nexport function do_setTerminalBackgroundColor(self: TUI, colorHex?: string): void {\n  if (self.currentBackgroundColorHex === colorHex) return;\n  self.currentBackgroundColorHex = colorHex;\n  if (colorHex) {\n    self.terminal.write(formatOsc11BackgroundColor(colorHex));\n  } else {\n    self.terminal.write(formatOsc111ResetBackgroundColor());\n  }\n}\n\nexport function do_resetTerminalBackgroundColor(self: TUI): void {\n  if (self.currentBackgroundColorHex !== undefined) {\n    self.currentBackgroundColorHex = undefined;\n    self.terminal.write(formatOsc111ResetBackgroundColor());\n  }\n}\n\nexport function do_stop(self: TUI): void {\n  self.stopped = true;\n  if (self.renderTimer) {\n    clearTimeout(self.renderTimer);\n    self.renderTimer = undefined;\n  }\n  self.resetTerminalBackgroundColor();\n  // Move cursor to the end of the content to prevent overwriting/artifacts on exit\n  if (self.previousLines.length > 0) {\n    const targetRow = self.previousLines.length; // Line after the last content\n    const lineDiff = targetRow - self.hardwareCursorRow;\n    if (lineDiff > 0) {\n      self.terminal.write(`\\x1b[${lineDiff}B`);\n    } else if (lineDiff < 0) {\n      self.terminal.write(`\\x1b[${-lineDiff}A`);\n    }\n    self.terminal.write(\"\\r\\n\");\n  }\n\n  self.terminal.showCursor();\n  self.terminal.stop();\n}\n\nexport function do_requestRender(self: TUI, force = false): void {\n  if (force) {\n    self.previousLines = [];\n    self.previousWidth = -1; // -1 triggers widthChanged, forcing a full clear\n    self.previousHeight = -1; // -1 triggers heightChanged, forcing a full clear\n    self.cursorRow = 0;\n    self.hardwareCursorRow = 0;\n    self.maxLinesRendered = 0;\n    self.previousViewportTop = 0;\n    if (self.renderTimer) {\n      clearTimeout(self.renderTimer);\n      self.renderTimer = undefined;\n    }\n    self.renderRequested = true;\n    process.nextTick(() => {\n      if (self.stopped || !self.renderRequested) {\n        return;\n      }\n      self.renderRequested = false;\n      self.lastRenderAt = performance.now();\n      self.doRender();\n    });\n    return;\n  }\n  if (self.renderRequested) return;\n  self.renderRequested = true;\n  process.nextTick(() => self.scheduleRender());\n}\n\nexport function do_scheduleRender(self: TUI): void {\n  if (self.stopped || self.renderTimer || !self.renderRequested) {\n    return;\n  }\n  const elapsed = performance.now() - self.lastRenderAt;\n  const delay = Math.max(0, TUI.MIN_RENDER_INTERVAL_MS - elapsed);\n  self.renderTimer = setTimeout(() => {\n    self.renderTimer = undefined;\n    if (self.stopped || !self.renderRequested) {\n      return;\n    }\n    self.renderRequested = false;\n    self.lastRenderAt = performance.now();\n    self.doRender();\n    if (self.renderRequested) {\n      self.scheduleRender();\n    }\n  }, delay);\n}\n"]}