@dst0/p-tui 0.4.41 → 5.0.2

package/dist/tui/helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.js","sourceRoot":"","sources":["../../src/tui/helpers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AAGvD,MAAM,UAAU,qBAAqB,CAAC,IAAY,EAAgC;IAChF,MAAM,aAAa,GAAG,IAAI,CAAC,OAAO,CAAC,qBAAqB,CAAC,CAAC;IAC1D,IAAI,aAAa,KAAK,CAAC,CAAC;QAAE,OAAO,SAAS,CAAC;IAE3C,MAAM,WAAW,GAAG,aAAa,GAAG,qBAAqB,CAAC,MAAM,CAAC;IACjE,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,WAAW,CAAC,CAAC;IACjD,IAAI,SAAS,KAAK,CAAC,CAAC;QAAE,OAAO,SAAS,CAAC;IAEvC,MAAM,GAAG,GAAa,EAAE,CAAC;IACzB,IAAI,IAAI,GAAG,CAAC,CAAC;IACb,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC;IAClD,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;QACtC,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;QACzC,IAAI,KAAK,KAAK,SAAS;YAAE,SAAS;QAClC,MAAM,WAAW,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;QAClC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,WAAW,CAAC,IAAI,WAAW,IAAI,CAAC,IAAI,WAAW,GAAG,UAAU;YAAE,SAAS;QAC7F,IAAI,GAAG,KAAK,GAAG,EAAE,CAAC;YAChB,GAAG,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QACxB,CAAC;aAAM,IAAI,GAAG,KAAK,GAAG,EAAE,CAAC;YACvB,IAAI,GAAG,WAAW,CAAC;QACrB,CAAC;IACH,CAAC;IACD,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC;AAAA,CACtB;AAED,MAAM,UAAU,oBAAoB,CAAC,IAAY,EAAY;IAC3D,OAAO,qBAAqB,CAAC,IAAI,CAAC,EAAE,GAAG,IAAI,EAAE,CAAC;AAAA,CAC/C;AAED,MAAM,UAAU,qBAAqB,CAAC,IAAY,EAAU;IAC1D,OAAO,qBAAqB,CAAC,IAAI,CAAC,EAAE,IAAI,IAAI,CAAC,CAAC;AAAA,CAC/C;AAED,MAAM,UAAU,WAAW,CAAC,SAA2B,EAAsC;IAC3F,OAAO,SAAS,KAAK,IAAI,IAAI,SAAS,IAAI,SAAS,CAAC;AAAA,CACrD;AAED,MAAM,UAAU,cAAc,CAAC,KAA4B,EAAE,aAAqB,EAAsB;IACtG,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAC1C,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC5C,qCAAqC;IACrC,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,oBAAoB,CAAC,CAAC;IAChD,IAAI,KAAK,EAAE,CAAC;QACV,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,aAAa,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC;IAClE,CAAC;IACD,OAAO,SAAS,CAAC;AAAA,CAClB;AAED,MAAM,UAAU,eAAe,GAAY;IACzC,OAAO,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;AAAA,CAC5C","sourcesContent":["import { KITTY_SEQUENCE_PREFIX } from \"./constants.ts\";\nimport type { Component, Focusable, KittyImageHeader, SizeValue } from \"./types.ts\";\n\nexport function parseKittyImageHeader(line: string): KittyImageHeader | undefined {\n  const sequenceStart = line.indexOf(KITTY_SEQUENCE_PREFIX);\n  if (sequenceStart === -1) return undefined;\n\n  const paramsStart = sequenceStart + KITTY_SEQUENCE_PREFIX.length;\n  const paramsEnd = line.indexOf(\";\", paramsStart);\n  if (paramsEnd === -1) return undefined;\n\n  const ids: number[] = [];\n  let rows = 1;\n  const params = line.slice(paramsStart, paramsEnd);\n  for (const param of params.split(\",\")) {\n    const [key, value] = param.split(\"=\", 2);\n    if (value === undefined) continue;\n    const numberValue = Number(value);\n    if (!Number.isInteger(numberValue) || numberValue <= 0 || numberValue > 0xffffffff) continue;\n    if (key === \"i\") {\n      ids.push(numberValue);\n    } else if (key === \"r\") {\n      rows = numberValue;\n    }\n  }\n  return { ids, rows };\n}\n\nexport function extractKittyImageIds(line: string): number[] {\n  return parseKittyImageHeader(line)?.ids ?? [];\n}\n\nexport function extractKittyImageRows(line: string): number {\n  return parseKittyImageHeader(line)?.rows ?? 1;\n}\n\nexport function isFocusable(component: Component | null): component is Component & Focusable {\n  return component !== null && \"focused\" in component;\n}\n\nexport function parseSizeValue(value: SizeValue | undefined, referenceSize: number): number | undefined {\n  if (value === undefined) return undefined;\n  if (typeof value === \"number\") return value;\n  // Parse percentage string like \"50%\"\n  const match = value.match(/^(\\d+(?:\\.\\d+)?)%$/);\n  if (match) {\n    return Math.floor((referenceSize * parseFloat(match[1])) / 100);\n  }\n  return undefined;\n}\n\nexport function isTermuxSession(): boolean {\n  return Boolean(process.env.TERMUX_VERSION);\n}\n"]}

package/dist/tui/index.d.ts

@@ -0,0 +1,6 @@
+export { CURSOR_MARKER } from "./constants.ts";
+export { Container } from "./container.ts";
+export { isFocusable } from "./helpers.ts";
+export { TUI } from "./tui.ts";
+export type { Component, Focusable, OverlayAnchor, OverlayHandle, OverlayMargin, OverlayOptions, OverlayUnfocusOptions, SizeValue, } from "./types.ts";
+//# sourceMappingURL=index.d.ts.map

package/dist/tui/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tui/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAC/B,YAAY,EACV,SAAS,EACT,SAAS,EACT,aAAa,EACb,aAAa,EACb,aAAa,EACb,cAAc,EACd,qBAAqB,EACrB,SAAS,GACV,MAAM,YAAY,CAAC","sourcesContent":["export { CURSOR_MARKER } from \"./constants.ts\";\nexport { Container } from \"./container.ts\";\nexport { isFocusable } from \"./helpers.ts\";\nexport { TUI } from \"./tui.ts\";\nexport type {\n  Component,\n  Focusable,\n  OverlayAnchor,\n  OverlayHandle,\n  OverlayMargin,\n  OverlayOptions,\n  OverlayUnfocusOptions,\n  SizeValue,\n} from \"./types.ts\";\n"]}

package/dist/tui/index.js

@@ -0,0 +1,5 @@
+export { CURSOR_MARKER } from "./constants.js";
+export { Container } from "./container.js";
+export { isFocusable } from "./helpers.js";
+export { TUI } from "./tui.js";
+//# sourceMappingURL=index.js.map

package/dist/tui/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tui/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC","sourcesContent":["export { CURSOR_MARKER } from \"./constants.ts\";\nexport { Container } from \"./container.ts\";\nexport { isFocusable } from \"./helpers.ts\";\nexport { TUI } from \"./tui.ts\";\nexport type {\n  Component,\n  Focusable,\n  OverlayAnchor,\n  OverlayHandle,\n  OverlayMargin,\n  OverlayOptions,\n  OverlayUnfocusOptions,\n  SizeValue,\n} from \"./types.ts\";\n"]}

package/dist/tui/tui-methods/configuration.d.ts

@@ -0,0 +1,20 @@
+import type { TUI } from "../tui.ts";
+import type { BlockedOverlayFocusRestoreState, Component, OverlayFocusRestorePolicy, OverlayFocusRestoreState, OverlayStackEntry } from "../types.ts";
+export declare function do_getShowHardwareCursor(self: TUI): boolean;
+export declare function do_setShowHardwareCursor(self: TUI, enabled: boolean): void;
+export declare function do_getClearOnShrink(self: TUI): boolean;
+export declare function do_setClearOnShrink(self: TUI, enabled: boolean): void;
+export declare function do_setFocus(self: TUI, component: Component | null): void;
+export declare function do_setFocusInternal(self: TUI, { component, overlayFocusRestore }: {
+    component: Component | null;
+    overlayFocusRestore: OverlayFocusRestorePolicy;
+}): void;
+export declare function do_clearOverlayFocusRestore(self: TUI): void;
+export declare function do_clearOverlayFocusRestoreFor(self: TUI, overlay: OverlayStackEntry): void;
+export declare function do_resolveBlockedOverlayFocusResume(self: TUI, restoreState: BlockedOverlayFocusRestoreState): Component | null;
+export declare function do_getVisibleOverlayFocusRestore(self: TUI): OverlayFocusRestoreState;
+export declare function do_isOverlayFocusAncestor(self: TUI, entry: OverlayStackEntry, component: Component): boolean;
+export declare function do_retargetOverlayPreFocus(self: TUI, removed: OverlayStackEntry): void;
+export declare function do_isComponentMounted(self: TUI, component: Component): boolean;
+export declare function do_containsComponent(self: TUI, root: Component, target: Component): boolean;
+//# sourceMappingURL=configuration.d.ts.map

package/dist/tui/tui-methods/configuration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"configuration.d.ts","sourceRoot":"","sources":["../../../src/tui/tui-methods/configuration.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,WAAW,CAAC;AACrC,OAAO,KAAK,EACV,+BAA+B,EAC/B,SAAS,EACT,yBAAyB,EACzB,wBAAwB,EACxB,iBAAiB,EAClB,MAAM,aAAa,CAAC;AAErB,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,GAAG,GAAG,OAAO,CAE3D;AAED,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,GAAG,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI,CAO1E;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,GAAG,GAAG,OAAO,CAEtD;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,GAAG,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI,CAErE;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,GAAG,EAAE,SAAS,EAAE,SAAS,GAAG,IAAI,GAAG,IAAI,CAExE;AAED,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,GAAG,EACT,EACE,SAAS,EACT,mBAAmB,EACpB,EAAE;IACD,SAAS,EAAE,SAAS,GAAG,IAAI,CAAC;IAC5B,mBAAmB,EAAE,yBAAyB,CAAC;CAChD,GACA,IAAI,CAyDN;AAED,wBAAgB,2BAA2B,CAAC,IAAI,EAAE,GAAG,GAAG,IAAI,CAE3D;AAED,wBAAgB,8BAA8B,CAAC,IAAI,EAAE,GAAG,EAAE,OAAO,EAAE,iBAAiB,GAAG,IAAI,CAI1F;AAED,wBAAgB,mCAAmC,CACjD,IAAI,EAAE,GAAG,EACT,YAAY,EAAE,+BAA+B,GAC5C,SAAS,GAAG,IAAI,CAIlB;AAED,wBAAgB,gCAAgC,CAAC,IAAI,EAAE,GAAG,GAAG,wBAAwB,CAOpF;AAED,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,GAAG,EAAE,KAAK,EAAE,iBAAiB,EAAE,SAAS,EAAE,SAAS,GAAG,OAAO,CAS5G;AAED,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,GAAG,EAAE,OAAO,EAAE,iBAAiB,GAAG,IAAI,CAMtF;AAED,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,GAAG,EAAE,SAAS,EAAE,SAAS,GAAG,OAAO,CAE9E;AAED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,GAAG,OAAO,CAI3F","sourcesContent":["import { Container } from \"../container.ts\";\nimport { isFocusable } from \"../helpers.ts\";\nimport type { TUI } from \"../tui.ts\";\nimport type {\n  BlockedOverlayFocusRestoreState,\n  Component,\n  OverlayFocusRestorePolicy,\n  OverlayFocusRestoreState,\n  OverlayStackEntry,\n} from \"../types.ts\";\n\nexport function do_getShowHardwareCursor(self: TUI): boolean {\n  return self.showHardwareCursor;\n}\n\nexport function do_setShowHardwareCursor(self: TUI, enabled: boolean): void {\n  if (self.showHardwareCursor === enabled) return;\n  self.showHardwareCursor = enabled;\n  if (!enabled) {\n    self.terminal.hideCursor();\n  }\n  self.requestRender();\n}\n\nexport function do_getClearOnShrink(self: TUI): boolean {\n  return self.clearOnShrink;\n}\n\nexport function do_setClearOnShrink(self: TUI, enabled: boolean): void {\n  self.clearOnShrink = enabled;\n}\n\nexport function do_setFocus(self: TUI, component: Component | null): void {\n  self.setFocusInternal({ component, overlayFocusRestore: \"clear\" });\n}\n\nexport function do_setFocusInternal(\n  self: TUI,\n  {\n    component,\n    overlayFocusRestore,\n  }: {\n    component: Component | null;\n    overlayFocusRestore: OverlayFocusRestorePolicy;\n  },\n): void {\n  const previousFocus = self.focusedComponent;\n  let nextFocus = component;\n  const previousFocusedOverlay = previousFocus\n    ? self.overlayStack.find((entry) => entry.component === previousFocus && self.isOverlayVisible(entry))\n    : undefined;\n  const nextFocusIsOverlay = nextFocus ? self.overlayStack.some((entry) => entry.component === nextFocus) : false;\n  const restoreState = self.getVisibleOverlayFocusRestore();\n  if (nextFocus && !nextFocusIsOverlay) {\n    if (restoreState.status === \"blocked\" && restoreState.blockedBy === previousFocus) {\n      if (restoreState.resume.status === \"focus-target\" || !self.isComponentMounted(restoreState.blockedBy)) {\n        nextFocus = self.resolveBlockedOverlayFocusResume(restoreState);\n      } else {\n        self.overlayFocusRestore = {\n          status: \"blocked\",\n          overlay: restoreState.overlay,\n          blockedBy: nextFocus,\n          resume: restoreState.resume,\n        };\n      }\n    } else if (\n      previousFocusedOverlay &&\n      restoreState.status !== \"inactive\" &&\n      restoreState.overlay === previousFocusedOverlay &&\n      !self.isOverlayFocusAncestor(previousFocusedOverlay, nextFocus)\n    ) {\n      self.overlayFocusRestore = {\n        status: \"blocked\",\n        overlay: previousFocusedOverlay,\n        blockedBy: nextFocus,\n        resume: { status: \"restore-overlay\" },\n      };\n    }\n  } else if (nextFocus === null) {\n    if (restoreState.status === \"blocked\" && restoreState.blockedBy === previousFocus) {\n      nextFocus = self.resolveBlockedOverlayFocusResume(restoreState);\n    } else if (overlayFocusRestore === \"clear\") {\n      self.clearOverlayFocusRestore();\n    }\n  }\n\n  if (isFocusable(self.focusedComponent)) {\n    self.focusedComponent.focused = false;\n  }\n\n  self.focusedComponent = nextFocus;\n\n  if (isFocusable(nextFocus)) {\n    nextFocus.focused = true;\n  }\n\n  const focusedOverlay = nextFocus\n    ? self.overlayStack.find((entry) => entry.component === nextFocus && self.isOverlayVisible(entry))\n    : undefined;\n  if (focusedOverlay) {\n    self.overlayFocusRestore = { status: \"eligible\", overlay: focusedOverlay };\n  }\n}\n\nexport function do_clearOverlayFocusRestore(self: TUI): void {\n  self.overlayFocusRestore = { status: \"inactive\" };\n}\n\nexport function do_clearOverlayFocusRestoreFor(self: TUI, overlay: OverlayStackEntry): void {\n  if (self.overlayFocusRestore.status !== \"inactive\" && self.overlayFocusRestore.overlay === overlay) {\n    self.clearOverlayFocusRestore();\n  }\n}\n\nexport function do_resolveBlockedOverlayFocusResume(\n  self: TUI,\n  restoreState: BlockedOverlayFocusRestoreState,\n): Component | null {\n  if (restoreState.resume.status === \"restore-overlay\") return restoreState.overlay.component;\n  self.clearOverlayFocusRestore();\n  return restoreState.resume.target;\n}\n\nexport function do_getVisibleOverlayFocusRestore(self: TUI): OverlayFocusRestoreState {\n  const restoreState = self.overlayFocusRestore;\n  if (restoreState.status === \"inactive\") return restoreState;\n  if (!self.overlayStack.includes(restoreState.overlay) || !self.isOverlayVisible(restoreState.overlay)) {\n    return { status: \"inactive\" };\n  }\n  return restoreState;\n}\n\nexport function do_isOverlayFocusAncestor(self: TUI, entry: OverlayStackEntry, component: Component): boolean {\n  const visited = new Set<Component>();\n  let current = entry.preFocus;\n  while (current && !visited.has(current)) {\n    visited.add(current);\n    if (current === component) return true;\n    current = self.overlayStack.find((overlay) => overlay.component === current)?.preFocus ?? null;\n  }\n  return false;\n}\n\nexport function do_retargetOverlayPreFocus(self: TUI, removed: OverlayStackEntry): void {\n  for (const overlay of self.overlayStack) {\n    if (overlay !== removed && overlay.preFocus === removed.component) {\n      overlay.preFocus = removed.preFocus;\n    }\n  }\n}\n\nexport function do_isComponentMounted(self: TUI, component: Component): boolean {\n  return self.children.some((child) => self.containsComponent(child, component));\n}\n\nexport function do_containsComponent(self: TUI, root: Component, target: Component): boolean {\n  if (root === target) return true;\n  if (!(root instanceof Container)) return false;\n  return root.children.some((child) => self.containsComponent(child, target));\n}\n"]}

package/dist/tui/tui-methods/configuration.js

@@ -0,0 +1,131 @@
+import { Container } from "../container.js";
+import { isFocusable } from "../helpers.js";
+export function do_getShowHardwareCursor(self) {
+    return self.showHardwareCursor;
+}
+export function do_setShowHardwareCursor(self, enabled) {
+    if (self.showHardwareCursor === enabled)
+        return;
+    self.showHardwareCursor = enabled;
+    if (!enabled) {
+        self.terminal.hideCursor();
+    }
+    self.requestRender();
+}
+export function do_getClearOnShrink(self) {
+    return self.clearOnShrink;
+}
+export function do_setClearOnShrink(self, enabled) {
+    self.clearOnShrink = enabled;
+}
+export function do_setFocus(self, component) {
+    self.setFocusInternal({ component, overlayFocusRestore: "clear" });
+}
+export function do_setFocusInternal(self, { component, overlayFocusRestore, }) {
+    const previousFocus = self.focusedComponent;
+    let nextFocus = component;
+    const previousFocusedOverlay = previousFocus
+        ? self.overlayStack.find((entry) => entry.component === previousFocus && self.isOverlayVisible(entry))
+        : undefined;
+    const nextFocusIsOverlay = nextFocus ? self.overlayStack.some((entry) => entry.component === nextFocus) : false;
+    const restoreState = self.getVisibleOverlayFocusRestore();
+    if (nextFocus && !nextFocusIsOverlay) {
+        if (restoreState.status === "blocked" && restoreState.blockedBy === previousFocus) {
+            if (restoreState.resume.status === "focus-target" || !self.isComponentMounted(restoreState.blockedBy)) {
+                nextFocus = self.resolveBlockedOverlayFocusResume(restoreState);
+            }
+            else {
+                self.overlayFocusRestore = {
+                    status: "blocked",
+                    overlay: restoreState.overlay,
+                    blockedBy: nextFocus,
+                    resume: restoreState.resume,
+                };
+            }
+        }
+        else if (previousFocusedOverlay &&
+            restoreState.status !== "inactive" &&
+            restoreState.overlay === previousFocusedOverlay &&
+            !self.isOverlayFocusAncestor(previousFocusedOverlay, nextFocus)) {
+            self.overlayFocusRestore = {
+                status: "blocked",
+                overlay: previousFocusedOverlay,
+                blockedBy: nextFocus,
+                resume: { status: "restore-overlay" },
+            };
+        }
+    }
+    else if (nextFocus === null) {
+        if (restoreState.status === "blocked" && restoreState.blockedBy === previousFocus) {
+            nextFocus = self.resolveBlockedOverlayFocusResume(restoreState);
+        }
+        else if (overlayFocusRestore === "clear") {
+            self.clearOverlayFocusRestore();
+        }
+    }
+    if (isFocusable(self.focusedComponent)) {
+        self.focusedComponent.focused = false;
+    }
+    self.focusedComponent = nextFocus;
+    if (isFocusable(nextFocus)) {
+        nextFocus.focused = true;
+    }
+    const focusedOverlay = nextFocus
+        ? self.overlayStack.find((entry) => entry.component === nextFocus && self.isOverlayVisible(entry))
+        : undefined;
+    if (focusedOverlay) {
+        self.overlayFocusRestore = { status: "eligible", overlay: focusedOverlay };
+    }
+}
+export function do_clearOverlayFocusRestore(self) {
+    self.overlayFocusRestore = { status: "inactive" };
+}
+export function do_clearOverlayFocusRestoreFor(self, overlay) {
+    if (self.overlayFocusRestore.status !== "inactive" && self.overlayFocusRestore.overlay === overlay) {
+        self.clearOverlayFocusRestore();
+    }
+}
+export function do_resolveBlockedOverlayFocusResume(self, restoreState) {
+    if (restoreState.resume.status === "restore-overlay")
+        return restoreState.overlay.component;
+    self.clearOverlayFocusRestore();
+    return restoreState.resume.target;
+}
+export function do_getVisibleOverlayFocusRestore(self) {
+    const restoreState = self.overlayFocusRestore;
+    if (restoreState.status === "inactive")
+        return restoreState;
+    if (!self.overlayStack.includes(restoreState.overlay) || !self.isOverlayVisible(restoreState.overlay)) {
+        return { status: "inactive" };
+    }
+    return restoreState;
+}
+export function do_isOverlayFocusAncestor(self, entry, component) {
+    const visited = new Set();
+    let current = entry.preFocus;
+    while (current && !visited.has(current)) {
+        visited.add(current);
+        if (current === component)
+            return true;
+        current = self.overlayStack.find((overlay) => overlay.component === current)?.preFocus ?? null;
+    }
+    return false;
+}
+export function do_retargetOverlayPreFocus(self, removed) {
+    for (const overlay of self.overlayStack) {
+        if (overlay !== removed && overlay.preFocus === removed.component) {
+            overlay.preFocus = removed.preFocus;
+        }
+    }
+}
+export function do_isComponentMounted(self, component) {
+    return self.children.some((child) => self.containsComponent(child, component));
+}
+export function do_containsComponent(self, root, target) {
+    if (root === target)
+        return true;
+    if (!(root instanceof Container))
+        return false;
+    return root.children.some((child) => self.containsComponent(child, target));
+}
+//# sourceMappingURL=configuration.js.map

package/dist/tui/tui-methods/configuration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"configuration.js","sourceRoot":"","sources":["../../../src/tui/tui-methods/configuration.ts"],"names":[],"mappings":"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","sourcesContent":["import { Container } from \"../container.ts\";\nimport { isFocusable } from \"../helpers.ts\";\nimport type { TUI } from \"../tui.ts\";\nimport type {\n  BlockedOverlayFocusRestoreState,\n  Component,\n  OverlayFocusRestorePolicy,\n  OverlayFocusRestoreState,\n  OverlayStackEntry,\n} from \"../types.ts\";\n\nexport function do_getShowHardwareCursor(self: TUI): boolean {\n  return self.showHardwareCursor;\n}\n\nexport function do_setShowHardwareCursor(self: TUI, enabled: boolean): void {\n  if (self.showHardwareCursor === enabled) return;\n  self.showHardwareCursor = enabled;\n  if (!enabled) {\n    self.terminal.hideCursor();\n  }\n  self.requestRender();\n}\n\nexport function do_getClearOnShrink(self: TUI): boolean {\n  return self.clearOnShrink;\n}\n\nexport function do_setClearOnShrink(self: TUI, enabled: boolean): void {\n  self.clearOnShrink = enabled;\n}\n\nexport function do_setFocus(self: TUI, component: Component | null): void {\n  self.setFocusInternal({ component, overlayFocusRestore: \"clear\" });\n}\n\nexport function do_setFocusInternal(\n  self: TUI,\n  {\n    component,\n    overlayFocusRestore,\n  }: {\n    component: Component | null;\n    overlayFocusRestore: OverlayFocusRestorePolicy;\n  },\n): void {\n  const previousFocus = self.focusedComponent;\n  let nextFocus = component;\n  const previousFocusedOverlay = previousFocus\n    ? self.overlayStack.find((entry) => entry.component === previousFocus && self.isOverlayVisible(entry))\n    : undefined;\n  const nextFocusIsOverlay = nextFocus ? self.overlayStack.some((entry) => entry.component === nextFocus) : false;\n  const restoreState = self.getVisibleOverlayFocusRestore();\n  if (nextFocus && !nextFocusIsOverlay) {\n    if (restoreState.status === \"blocked\" && restoreState.blockedBy === previousFocus) {\n      if (restoreState.resume.status === \"focus-target\" || !self.isComponentMounted(restoreState.blockedBy)) {\n        nextFocus = self.resolveBlockedOverlayFocusResume(restoreState);\n      } else {\n        self.overlayFocusRestore = {\n          status: \"blocked\",\n          overlay: restoreState.overlay,\n          blockedBy: nextFocus,\n          resume: restoreState.resume,\n        };\n      }\n    } else if (\n      previousFocusedOverlay &&\n      restoreState.status !== \"inactive\" &&\n      restoreState.overlay === previousFocusedOverlay &&\n      !self.isOverlayFocusAncestor(previousFocusedOverlay, nextFocus)\n    ) {\n      self.overlayFocusRestore = {\n        status: \"blocked\",\n        overlay: previousFocusedOverlay,\n        blockedBy: nextFocus,\n        resume: { status: \"restore-overlay\" },\n      };\n    }\n  } else if (nextFocus === null) {\n    if (restoreState.status === \"blocked\" && restoreState.blockedBy === previousFocus) {\n      nextFocus = self.resolveBlockedOverlayFocusResume(restoreState);\n    } else if (overlayFocusRestore === \"clear\") {\n      self.clearOverlayFocusRestore();\n    }\n  }\n\n  if (isFocusable(self.focusedComponent)) {\n    self.focusedComponent.focused = false;\n  }\n\n  self.focusedComponent = nextFocus;\n\n  if (isFocusable(nextFocus)) {\n    nextFocus.focused = true;\n  }\n\n  const focusedOverlay = nextFocus\n    ? self.overlayStack.find((entry) => entry.component === nextFocus && self.isOverlayVisible(entry))\n    : undefined;\n  if (focusedOverlay) {\n    self.overlayFocusRestore = { status: \"eligible\", overlay: focusedOverlay };\n  }\n}\n\nexport function do_clearOverlayFocusRestore(self: TUI): void {\n  self.overlayFocusRestore = { status: \"inactive\" };\n}\n\nexport function do_clearOverlayFocusRestoreFor(self: TUI, overlay: OverlayStackEntry): void {\n  if (self.overlayFocusRestore.status !== \"inactive\" && self.overlayFocusRestore.overlay === overlay) {\n    self.clearOverlayFocusRestore();\n  }\n}\n\nexport function do_resolveBlockedOverlayFocusResume(\n  self: TUI,\n  restoreState: BlockedOverlayFocusRestoreState,\n): Component | null {\n  if (restoreState.resume.status === \"restore-overlay\") return restoreState.overlay.component;\n  self.clearOverlayFocusRestore();\n  return restoreState.resume.target;\n}\n\nexport function do_getVisibleOverlayFocusRestore(self: TUI): OverlayFocusRestoreState {\n  const restoreState = self.overlayFocusRestore;\n  if (restoreState.status === \"inactive\") return restoreState;\n  if (!self.overlayStack.includes(restoreState.overlay) || !self.isOverlayVisible(restoreState.overlay)) {\n    return { status: \"inactive\" };\n  }\n  return restoreState;\n}\n\nexport function do_isOverlayFocusAncestor(self: TUI, entry: OverlayStackEntry, component: Component): boolean {\n  const visited = new Set<Component>();\n  let current = entry.preFocus;\n  while (current && !visited.has(current)) {\n    visited.add(current);\n    if (current === component) return true;\n    current = self.overlayStack.find((overlay) => overlay.component === current)?.preFocus ?? null;\n  }\n  return false;\n}\n\nexport function do_retargetOverlayPreFocus(self: TUI, removed: OverlayStackEntry): void {\n  for (const overlay of self.overlayStack) {\n    if (overlay !== removed && overlay.preFocus === removed.component) {\n      overlay.preFocus = removed.preFocus;\n    }\n  }\n}\n\nexport function do_isComponentMounted(self: TUI, component: Component): boolean {\n  return self.children.some((child) => self.containsComponent(child, component));\n}\n\nexport function do_containsComponent(self: TUI, root: Component, target: Component): boolean {\n  if (root === target) return true;\n  if (!(root instanceof Container)) return false;\n  return root.children.some((child) => self.containsComponent(child, target));\n}\n"]}

package/dist/tui/tui-methods/cursor-background.d.ts

@@ -0,0 +1,10 @@
+import type { RgbColor } from "../../terminal-colors.ts";
+import type { TUI } from "../tui.ts";
+export declare function do_positionHardwareCursor(self: TUI, cursorPos: {
+    row: number;
+    col: number;
+} | null, totalLines: number): void;
+export declare function do_queryTerminalBackgroundColor(self: TUI, { timeoutMs }: {
+    timeoutMs: number;
+}): Promise<RgbColor | undefined>;
+//# sourceMappingURL=cursor-background.d.ts.map

package/dist/tui/tui-methods/cursor-background.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cursor-background.d.ts","sourceRoot":"","sources":["../../../src/tui/tui-methods/cursor-background.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AACzD,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,WAAW,CAAC;AAGrC,wBAAgB,yBAAyB,CACvC,IAAI,EAAE,GAAG,EACT,SAAS,EAAE;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,EAC9C,UAAU,EAAE,MAAM,GACjB,IAAI,CA+BN;AAED,wBAAgB,+BAA+B,CAC7C,IAAI,EAAE,GAAG,EACT,EAAE,SAAS,EAAE,EAAE;IAAE,SAAS,EAAE,MAAM,CAAA;CAAE,GACnC,OAAO,CAAC,QAAQ,GAAG,SAAS,CAAC,CAqB/B","sourcesContent":["import type { RgbColor } from \"../../terminal-colors.ts\";\nimport type { TUI } from \"../tui.ts\";\nimport type { PendingOsc11BackgroundQuery } from \"../types.ts\";\n\nexport function do_positionHardwareCursor(\n  self: TUI,\n  cursorPos: { row: number; col: number } | null,\n  totalLines: number,\n): void {\n  if (!cursorPos || totalLines <= 0) {\n    self.terminal.hideCursor();\n    return;\n  }\n\n  // Clamp cursor position to valid range\n  const targetRow = Math.max(0, Math.min(cursorPos.row, totalLines - 1));\n  const targetCol = Math.max(0, cursorPos.col);\n\n  // Move cursor from current position to target\n  const rowDelta = targetRow - self.hardwareCursorRow;\n  let buffer = \"\";\n  if (rowDelta > 0) {\n    buffer += `\\x1b[${rowDelta}B`; // Move down\n  } else if (rowDelta < 0) {\n    buffer += `\\x1b[${-rowDelta}A`; // Move up\n  }\n  // Move to absolute column (1-indexed)\n  buffer += `\\x1b[${targetCol + 1}G`;\n\n  if (buffer) {\n    self.terminal.write(buffer);\n  }\n\n  self.hardwareCursorRow = targetRow;\n  if (self.showHardwareCursor) {\n    self.terminal.showCursor();\n  } else {\n    self.terminal.hideCursor();\n  }\n}\n\nexport function do_queryTerminalBackgroundColor(\n  self: TUI,\n  { timeoutMs }: { timeoutMs: number },\n): Promise<RgbColor | undefined> {\n  return new Promise((resolve) => {\n    const query: PendingOsc11BackgroundQuery = {\n      settled: false,\n      resolve,\n      timer: undefined,\n    };\n\n    query.timer = setTimeout(() => {\n      if (query.settled) {\n        return;\n      }\n      query.settled = true;\n      query.timer = undefined;\n      query.resolve?.(undefined);\n      query.resolve = undefined;\n    }, timeoutMs);\n    self.pendingOsc11BackgroundQueries.push(query);\n    self.pendingOsc11BackgroundReplies += 1;\n    self.terminal.write(\"\\x1b]11;?\\x07\");\n  });\n}\n"]}

package/dist/tui/tui-methods/cursor-background.js

@@ -0,0 +1,52 @@
+export function do_positionHardwareCursor(self, cursorPos, totalLines) {
+    if (!cursorPos || totalLines <= 0) {
+        self.terminal.hideCursor();
+        return;
+    }
+    // Clamp cursor position to valid range
+    const targetRow = Math.max(0, Math.min(cursorPos.row, totalLines - 1));
+    const targetCol = Math.max(0, cursorPos.col);
+    // Move cursor from current position to target
+    const rowDelta = targetRow - self.hardwareCursorRow;
+    let buffer = "";
+    if (rowDelta > 0) {
+        buffer += `\x1b[${rowDelta}B`; // Move down
+    }
+    else if (rowDelta < 0) {
+        buffer += `\x1b[${-rowDelta}A`; // Move up
+    }
+    // Move to absolute column (1-indexed)
+    buffer += `\x1b[${targetCol + 1}G`;
+    if (buffer) {
+        self.terminal.write(buffer);
+    }
+    self.hardwareCursorRow = targetRow;
+    if (self.showHardwareCursor) {
+        self.terminal.showCursor();
+    }
+    else {
+        self.terminal.hideCursor();
+    }
+}
+export function do_queryTerminalBackgroundColor(self, { timeoutMs }) {
+    return new Promise((resolve) => {
+        const query = {
+            settled: false,
+            resolve,
+            timer: undefined,
+        };
+        query.timer = setTimeout(() => {
+            if (query.settled) {
+                return;
+            }
+            query.settled = true;
+            query.timer = undefined;
+            query.resolve?.(undefined);
+            query.resolve = undefined;
+        }, timeoutMs);
+        self.pendingOsc11BackgroundQueries.push(query);
+        self.pendingOsc11BackgroundReplies += 1;
+        self.terminal.write("\x1b]11;?\x07");
+    });
+}
+//# sourceMappingURL=cursor-background.js.map

package/dist/tui/tui-methods/cursor-background.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cursor-background.js","sourceRoot":"","sources":["../../../src/tui/tui-methods/cursor-background.ts"],"names":[],"mappings":"AAIA,MAAM,UAAU,yBAAyB,CACvC,IAAS,EACT,SAA8C,EAC9C,UAAkB,EACZ;IACN,IAAI,CAAC,SAAS,IAAI,UAAU,IAAI,CAAC,EAAE,CAAC;QAClC,IAAI,CAAC,QAAQ,CAAC,UAAU,EAAE,CAAC;QAC3B,OAAO;IACT,CAAC;IAED,uCAAuC;IACvC,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,GAAG,EAAE,UAAU,GAAG,CAAC,CAAC,CAAC,CAAC;IACvE,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,SAAS,CAAC,GAAG,CAAC,CAAC;IAE7C,8CAA8C;IAC9C,MAAM,QAAQ,GAAG,SAAS,GAAG,IAAI,CAAC,iBAAiB,CAAC;IACpD,IAAI,MAAM,GAAG,EAAE,CAAC;IAChB,IAAI,QAAQ,GAAG,CAAC,EAAE,CAAC;QACjB,MAAM,IAAI,QAAQ,QAAQ,GAAG,CAAC,CAAC,YAAY;IAC7C,CAAC;SAAM,IAAI,QAAQ,GAAG,CAAC,EAAE,CAAC;QACxB,MAAM,IAAI,QAAQ,CAAC,QAAQ,GAAG,CAAC,CAAC,UAAU;IAC5C,CAAC;IACD,sCAAsC;IACtC,MAAM,IAAI,QAAQ,SAAS,GAAG,CAAC,GAAG,CAAC;IAEnC,IAAI,MAAM,EAAE,CAAC;QACX,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IAC9B,CAAC;IAED,IAAI,CAAC,iBAAiB,GAAG,SAAS,CAAC;IACnC,IAAI,IAAI,CAAC,kBAAkB,EAAE,CAAC;QAC5B,IAAI,CAAC,QAAQ,CAAC,UAAU,EAAE,CAAC;IAC7B,CAAC;SAAM,CAAC;QACN,IAAI,CAAC,QAAQ,CAAC,UAAU,EAAE,CAAC;IAC7B,CAAC;AAAA,CACF;AAED,MAAM,UAAU,+BAA+B,CAC7C,IAAS,EACT,EAAE,SAAS,EAAyB,EACL;IAC/B,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC;QAC9B,MAAM,KAAK,GAAgC;YACzC,OAAO,EAAE,KAAK;YACd,OAAO;YACP,KAAK,EAAE,SAAS;SACjB,CAAC;QAEF,KAAK,CAAC,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC;YAC7B,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;gBAClB,OAAO;YACT,CAAC;YACD,KAAK,CAAC,OAAO,GAAG,IAAI,CAAC;YACrB,KAAK,CAAC,KAAK,GAAG,SAAS,CAAC;YACxB,KAAK,CAAC,OAAO,EAAE,CAAC,SAAS,CAAC,CAAC;YAC3B,KAAK,CAAC,OAAO,GAAG,SAAS,CAAC;QAAA,CAC3B,EAAE,SAAS,CAAC,CAAC;QACd,IAAI,CAAC,6BAA6B,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC/C,IAAI,CAAC,6BAA6B,IAAI,CAAC,CAAC;QACxC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC;IAAA,CACtC,CAAC,CAAC;AAAA,CACJ","sourcesContent":["import type { RgbColor } from \"../../terminal-colors.ts\";\nimport type { TUI } from \"../tui.ts\";\nimport type { PendingOsc11BackgroundQuery } from \"../types.ts\";\n\nexport function do_positionHardwareCursor(\n  self: TUI,\n  cursorPos: { row: number; col: number } | null,\n  totalLines: number,\n): void {\n  if (!cursorPos || totalLines <= 0) {\n    self.terminal.hideCursor();\n    return;\n  }\n\n  // Clamp cursor position to valid range\n  const targetRow = Math.max(0, Math.min(cursorPos.row, totalLines - 1));\n  const targetCol = Math.max(0, cursorPos.col);\n\n  // Move cursor from current position to target\n  const rowDelta = targetRow - self.hardwareCursorRow;\n  let buffer = \"\";\n  if (rowDelta > 0) {\n    buffer += `\\x1b[${rowDelta}B`; // Move down\n  } else if (rowDelta < 0) {\n    buffer += `\\x1b[${-rowDelta}A`; // Move up\n  }\n  // Move to absolute column (1-indexed)\n  buffer += `\\x1b[${targetCol + 1}G`;\n\n  if (buffer) {\n    self.terminal.write(buffer);\n  }\n\n  self.hardwareCursorRow = targetRow;\n  if (self.showHardwareCursor) {\n    self.terminal.showCursor();\n  } else {\n    self.terminal.hideCursor();\n  }\n}\n\nexport function do_queryTerminalBackgroundColor(\n  self: TUI,\n  { timeoutMs }: { timeoutMs: number },\n): Promise<RgbColor | undefined> {\n  return new Promise((resolve) => {\n    const query: PendingOsc11BackgroundQuery = {\n      settled: false,\n      resolve,\n      timer: undefined,\n    };\n\n    query.timer = setTimeout(() => {\n      if (query.settled) {\n        return;\n      }\n      query.settled = true;\n      query.timer = undefined;\n      query.resolve?.(undefined);\n      query.resolve = undefined;\n    }, timeoutMs);\n    self.pendingOsc11BackgroundQueries.push(query);\n    self.pendingOsc11BackgroundReplies += 1;\n    self.terminal.write(\"\\x1b]11;?\\x07\");\n  });\n}\n"]}

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

@@ -0,0 +1,17 @@
+import type { TUI } from "../tui.ts";
+export declare function renderIncremental(self: TUI, options: {
+    computeLineDiff: (targetRow: number) => number;
+    cursorPos: {
+        row: number;
+        col: number;
+    } | null;
+    fullRender: (clear: boolean) => void;
+    hardwareCursorRow: number;
+    height: number;
+    logRedraw: (reason: string) => void;
+    newLines: string[];
+    prevViewportTop: number;
+    viewportTop: number;
+    width: number;
+}): void;
+//# sourceMappingURL=incremental-render.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"incremental-render.d.ts","sourceRoot":"","sources":["../../../src/tui/tui-methods/incremental-render.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,WAAW,CAAC;AAGrC,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,GAAG,EACT,OAAO,EAAE;IACP,eAAe,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,MAAM,CAAC;IAC/C,SAAS,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IAC/C,UAAU,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;IACrC,iBAAiB,EAAE,MAAM,CAAC;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IACpC,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,eAAe,EAAE,MAAM,CAAC;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;CACf,GACA,IAAI,CAyQN","sourcesContent":["import * as fs from \"node:fs\";\nimport * as path from \"node:path\";\nimport { isImageLine } from \"../../terminal-image.ts\";\nimport { visibleWidth } from \"../../utils.ts\";\nimport type { TUI } from \"../tui.ts\";\nimport { throwRenderWidthError } from \"./render-width-error.ts\";\n\nexport function renderIncremental(\n  self: TUI,\n  options: {\n    computeLineDiff: (targetRow: number) => number;\n    cursorPos: { row: number; col: number } | null;\n    fullRender: (clear: boolean) => void;\n    hardwareCursorRow: number;\n    height: number;\n    logRedraw: (reason: string) => void;\n    newLines: string[];\n    prevViewportTop: number;\n    viewportTop: number;\n    width: number;\n  },\n): void {\n  const { computeLineDiff, cursorPos, fullRender, height, logRedraw, newLines, width } = options;\n  let { hardwareCursorRow, prevViewportTop, viewportTop } = options;\n  // Find first and last changed lines\n  let firstChanged = -1;\n  let lastChanged = -1;\n  const maxLines = Math.max(newLines.length, self.previousLines.length);\n  for (let i = 0; i < maxLines; i++) {\n    const oldLine = i < self.previousLines.length ? self.previousLines[i] : \"\";\n    const newLine = i < newLines.length ? newLines[i] : \"\";\n\n    if (oldLine !== newLine) {\n      if (firstChanged === -1) {\n        firstChanged = i;\n      }\n      lastChanged = i;\n    }\n  }\n  const appendedLines = newLines.length > self.previousLines.length;\n  if (appendedLines) {\n    if (firstChanged === -1) {\n      firstChanged = self.previousLines.length;\n    }\n    lastChanged = newLines.length - 1;\n  }\n  if (firstChanged !== -1) {\n    const expandedRange = self.expandChangedRangeForKittyImages(firstChanged, lastChanged, newLines);\n    firstChanged = expandedRange.firstChanged;\n    lastChanged = expandedRange.lastChanged;\n  }\n  const appendStart = appendedLines && firstChanged === self.previousLines.length && firstChanged > 0;\n\n  // No changes - but still need to update hardware cursor position if it moved\n  if (firstChanged === -1) {\n    self.positionHardwareCursor(cursorPos, newLines.length);\n    self.previousViewportTop = prevViewportTop;\n    self.previousHeight = height;\n    return;\n  }\n\n  // All changes are in deleted lines (nothing to render, just clear)\n  if (firstChanged >= newLines.length) {\n    if (self.previousLines.length > newLines.length) {\n      let buffer = \"\\x1b[?2026h\";\n      buffer += self.deleteChangedKittyImages(firstChanged, lastChanged);\n      // Move to end of new content (clamp to 0 for empty content)\n      const targetRow = Math.max(0, newLines.length - 1);\n      if (targetRow < prevViewportTop) {\n        logRedraw(`deleted lines moved viewport up (${targetRow} < ${prevViewportTop})`);\n        fullRender(true);\n        return;\n      }\n      const lineDiff = computeLineDiff(targetRow);\n      if (lineDiff > 0) buffer += `\\x1b[${lineDiff}B`;\n      else if (lineDiff < 0) buffer += `\\x1b[${-lineDiff}A`;\n      buffer += \"\\r\";\n      // Clear extra lines without scrolling\n      const extraLines = self.previousLines.length - newLines.length;\n      if (extraLines > height) {\n        logRedraw(`extraLines > height (${extraLines} > ${height})`);\n        fullRender(true);\n        return;\n      }\n      const clearStartOffset = newLines.length === 0 ? 0 : 1;\n      if (extraLines > 0 && clearStartOffset > 0) {\n        buffer += `\\x1b[${clearStartOffset}B`;\n      }\n      for (let i = 0; i < extraLines; i++) {\n        buffer += \"\\r\\x1b[2K\";\n        if (i < extraLines - 1) buffer += \"\\x1b[1B\";\n      }\n      const moveBack = Math.max(0, extraLines - 1 + clearStartOffset);\n      if (moveBack > 0) {\n        buffer += `\\x1b[${moveBack}A`;\n      }\n      buffer += \"\\x1b[?2026l\";\n      self.terminal.write(buffer);\n      self.cursorRow = targetRow;\n      self.hardwareCursorRow = targetRow;\n    }\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    self.previousViewportTop = prevViewportTop;\n    return;\n  }\n\n  // Differential rendering can only touch what was actually visible.\n  // If the first changed line is above the previous viewport, redraw only the visible screen rows\n  // without clearing scrollback (\\x1b[3J) or replaying the full history into stdout / dumping visible screen (\\x1b[2J).\n  if (firstChanged < prevViewportTop) {\n    logRedraw(`firstChanged < viewportTop (${firstChanged} < ${prevViewportTop})`);\n    self.fullRedrawCount += 1;\n    // Preserve the user's scroll position by adjusting for lines added/removed above the viewport.\n    // Do NOT scroll to bottom just because content above changed (e.g., tool output expansion).\n    const lineDelta = newLines.length - self.previousLines.length;\n    const newViewportTop = Math.max(0, Math.min(prevViewportTop + lineDelta, Math.max(0, newLines.length - height)));\n    let buffer = \"\\x1b[?2026h\\x1b[H\";\n    buffer += self.deleteChangedKittyImages(0, newLines.length - 1);\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 < 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  // Render from first changed line to end\n  // Build buffer with all updates wrapped in synchronized output\n  let buffer = \"\\x1b[?2026h\"; // Begin synchronized output\n  buffer += self.deleteChangedKittyImages(firstChanged, lastChanged);\n  const prevViewportBottom = prevViewportTop + height - 1;\n  const moveTargetRow = appendStart ? firstChanged - 1 : firstChanged;\n  if (moveTargetRow > prevViewportBottom) {\n    const currentScreenRow = Math.max(0, Math.min(height - 1, hardwareCursorRow - prevViewportTop));\n    const moveToBottom = height - 1 - currentScreenRow;\n    if (moveToBottom > 0) {\n      buffer += `\\x1b[${moveToBottom}B`;\n    }\n    const scroll = moveTargetRow - prevViewportBottom;\n    buffer += \"\\r\\n\".repeat(scroll);\n    prevViewportTop += scroll;\n    viewportTop += scroll;\n    hardwareCursorRow = moveTargetRow;\n  }\n\n  // Move cursor to first changed line (use hardwareCursorRow for actual position)\n  const lineDiff = computeLineDiff(moveTargetRow);\n  if (lineDiff > 0) {\n    buffer += `\\x1b[${lineDiff}B`; // Move down\n  } else if (lineDiff < 0) {\n    buffer += `\\x1b[${-lineDiff}A`; // Move up\n  }\n\n  buffer += appendStart ? \"\\r\\n\" : \"\\r\"; // Move to column 0\n\n  // Only render changed lines (firstChanged to lastChanged), not all lines to end\n  // This reduces flicker when only a single line changes (e.g., spinner animation)\n  const renderEnd = Math.min(lastChanged, newLines.length - 1);\n  for (let i = firstChanged; i <= renderEnd; i++) {\n    if (i > firstChanged) buffer += \"\\r\\n\";\n    const line = newLines[i];\n    const isImage = isImageLine(line);\n    const imageReservedRows = isImage ? self.getKittyImageReservedRows(newLines, i, renderEnd) : 1;\n    if (imageReservedRows > 1) {\n      const imageStartScreenRow = i - viewportTop;\n      if (imageStartScreenRow < 0 || imageStartScreenRow + imageReservedRows > height) {\n        logRedraw(`kitty image pre-clear would scroll (${imageStartScreenRow} + ${imageReservedRows} > ${height})`);\n        fullRender(true);\n        return;\n      }\n\n      buffer += \"\\x1b[2K\";\n      for (let row = 1; row < imageReservedRows; row++) {\n        buffer += \"\\r\\n\\x1b[2K\";\n      }\n      buffer += `\\x1b[${imageReservedRows - 1}A`;\n      buffer += line;\n      buffer += `\\x1b[${imageReservedRows - 1}B`;\n      i += imageReservedRows - 1;\n      continue;\n    }\n\n    buffer += \"\\x1b[2K\"; // Clear current line\n    if (!isImage && visibleWidth(line) > width) {\n      throwRenderWidthError(self, newLines, line, i, width);\n    }\n    buffer += line;\n  }\n\n  // Track where cursor ended up after rendering\n  let finalCursorRow = renderEnd;\n\n  // If we had more lines before, clear them and move cursor back\n  if (self.previousLines.length > newLines.length) {\n    // Move to end of new content first if we stopped before it\n    if (renderEnd < newLines.length - 1) {\n      const moveDown = newLines.length - 1 - renderEnd;\n      buffer += `\\x1b[${moveDown}B`;\n      finalCursorRow = newLines.length - 1;\n    }\n    const extraLines = self.previousLines.length - newLines.length;\n    for (let i = newLines.length; i < self.previousLines.length; i++) {\n      buffer += \"\\r\\n\\x1b[2K\";\n    }\n    // Move cursor back to end of new content\n    buffer += `\\x1b[${extraLines}A`;\n  }\n\n  buffer += \"\\x1b[?2026l\"; // End synchronized output\n\n  if (process.env.PI_TUI_DEBUG === \"1\") {\n    const debugDir = \"/tmp/tui\";\n    fs.mkdirSync(debugDir, { recursive: true });\n    const debugPath = path.join(debugDir, `render-${Date.now()}-${Math.random().toString(36).slice(2)}.log`);\n    const debugData = [\n      `firstChanged: ${firstChanged}`,\n      `viewportTop: ${viewportTop}`,\n      `cursorRow: ${self.cursorRow}`,\n      `height: ${height}`,\n      `lineDiff: ${lineDiff}`,\n      `hardwareCursorRow: ${hardwareCursorRow}`,\n      `renderEnd: ${renderEnd}`,\n      `finalCursorRow: ${finalCursorRow}`,\n      `cursorPos: ${JSON.stringify(cursorPos)}`,\n      `newLines.length: ${newLines.length}`,\n      `previousLines.length: ${self.previousLines.length}`,\n      \"\",\n      \"=== newLines ===\",\n      JSON.stringify(newLines, null, 2),\n      \"\",\n      \"=== previousLines ===\",\n      JSON.stringify(self.previousLines, null, 2),\n      \"\",\n      \"=== buffer ===\",\n      JSON.stringify(buffer),\n    ].join(\"\\n\");\n    fs.writeFileSync(debugPath, debugData);\n  }\n\n  // Write entire buffer at once\n  self.terminal.write(buffer);\n\n  // Track cursor position for next render\n  // cursorRow tracks end of content (for viewport calculation)\n  // hardwareCursorRow tracks actual terminal cursor position (for movement)\n  self.cursorRow = Math.max(0, newLines.length - 1);\n  self.hardwareCursorRow = finalCursorRow;\n  // Track terminal's working area (grows but doesn't shrink unless cleared)\n  self.maxLinesRendered = Math.max(self.maxLinesRendered, newLines.length);\n  self.previousViewportTop = Math.max(prevViewportTop, finalCursorRow - height + 1);\n\n  // Position hardware cursor for IME\n  self.positionHardwareCursor(cursorPos, newLines.length);\n\n  self.previousLines = newLines;\n  self.previousKittyImageIds = self.collectKittyImageIds(newLines);\n  self.previousWidth = width;\n  self.previousHeight = height;\n}\n"]}

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

@@ -0,0 +1,259 @@
+import * as fs from "node:fs";
+import * as path from "node:path";
+import { isImageLine } from "../../terminal-image.js";
+import { visibleWidth } from "../../utils.js";
+import { throwRenderWidthError } from "./render-width-error.js";
+export function renderIncremental(self, options) {
+    const { computeLineDiff, cursorPos, fullRender, height, logRedraw, newLines, width } = options;
+    let { hardwareCursorRow, prevViewportTop, viewportTop } = options;
+    // Find first and last changed lines
+    let firstChanged = -1;
+    let lastChanged = -1;
+    const maxLines = Math.max(newLines.length, self.previousLines.length);
+    for (let i = 0; i < maxLines; i++) {
+        const oldLine = i < self.previousLines.length ? self.previousLines[i] : "";
+        const newLine = i < newLines.length ? newLines[i] : "";
+        if (oldLine !== newLine) {
+            if (firstChanged === -1) {
+                firstChanged = i;
+            }
+            lastChanged = i;
+        }
+    }
+    const appendedLines = newLines.length > self.previousLines.length;
+    if (appendedLines) {
+        if (firstChanged === -1) {
+            firstChanged = self.previousLines.length;
+        }
+        lastChanged = newLines.length - 1;
+    }
+    if (firstChanged !== -1) {
+        const expandedRange = self.expandChangedRangeForKittyImages(firstChanged, lastChanged, newLines);
+        firstChanged = expandedRange.firstChanged;
+        lastChanged = expandedRange.lastChanged;
+    }
+    const appendStart = appendedLines && firstChanged === self.previousLines.length && firstChanged > 0;
+    // No changes - but still need to update hardware cursor position if it moved
+    if (firstChanged === -1) {
+        self.positionHardwareCursor(cursorPos, newLines.length);
+        self.previousViewportTop = prevViewportTop;
+        self.previousHeight = height;
+        return;
+    }
+    // All changes are in deleted lines (nothing to render, just clear)
+    if (firstChanged >= newLines.length) {
+        if (self.previousLines.length > newLines.length) {
+            let buffer = "\x1b[?2026h";
+            buffer += self.deleteChangedKittyImages(firstChanged, lastChanged);
+            // Move to end of new content (clamp to 0 for empty content)
+            const targetRow = Math.max(0, newLines.length - 1);
+            if (targetRow < prevViewportTop) {
+                logRedraw(`deleted lines moved viewport up (${targetRow} < ${prevViewportTop})`);
+                fullRender(true);
+                return;
+            }
+            const lineDiff = computeLineDiff(targetRow);
+            if (lineDiff > 0)
+                buffer += `\x1b[${lineDiff}B`;
+            else if (lineDiff < 0)
+                buffer += `\x1b[${-lineDiff}A`;
+            buffer += "\r";
+            // Clear extra lines without scrolling
+            const extraLines = self.previousLines.length - newLines.length;
+            if (extraLines > height) {
+                logRedraw(`extraLines > height (${extraLines} > ${height})`);
+                fullRender(true);
+                return;
+            }
+            const clearStartOffset = newLines.length === 0 ? 0 : 1;
+            if (extraLines > 0 && clearStartOffset > 0) {
+                buffer += `\x1b[${clearStartOffset}B`;
+            }
+            for (let i = 0; i < extraLines; i++) {
+                buffer += "\r\x1b[2K";
+                if (i < extraLines - 1)
+                    buffer += "\x1b[1B";
+            }
+            const moveBack = Math.max(0, extraLines - 1 + clearStartOffset);
+            if (moveBack > 0) {
+                buffer += `\x1b[${moveBack}A`;
+            }
+            buffer += "\x1b[?2026l";
+            self.terminal.write(buffer);
+            self.cursorRow = targetRow;
+            self.hardwareCursorRow = targetRow;
+        }
+        self.positionHardwareCursor(cursorPos, newLines.length);
+        self.previousLines = newLines;
+        self.previousKittyImageIds = self.collectKittyImageIds(newLines);
+        self.previousWidth = width;
+        self.previousHeight = height;
+        self.previousViewportTop = prevViewportTop;
+        return;
+    }
+    // Differential rendering can only touch what was actually visible.
+    // If the first changed line is above the previous viewport, redraw only the visible screen rows
+    // without clearing scrollback (\x1b[3J) or replaying the full history into stdout / dumping visible screen (\x1b[2J).
+    if (firstChanged < prevViewportTop) {
+        logRedraw(`firstChanged < viewportTop (${firstChanged} < ${prevViewportTop})`);
+        self.fullRedrawCount += 1;
+        // Preserve the user's scroll position by adjusting for lines added/removed above the viewport.
+        // Do NOT scroll to bottom just because content above changed (e.g., tool output expansion).
+        const lineDelta = newLines.length - self.previousLines.length;
+        const newViewportTop = Math.max(0, Math.min(prevViewportTop + lineDelta, Math.max(0, newLines.length - height)));
+        let buffer = "\x1b[?2026h\x1b[H";
+        buffer += self.deleteChangedKittyImages(0, newLines.length - 1);
+        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 < 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;
+    }
+    // Render from first changed line to end
+    // Build buffer with all updates wrapped in synchronized output
+    let buffer = "\x1b[?2026h"; // Begin synchronized output
+    buffer += self.deleteChangedKittyImages(firstChanged, lastChanged);
+    const prevViewportBottom = prevViewportTop + height - 1;
+    const moveTargetRow = appendStart ? firstChanged - 1 : firstChanged;
+    if (moveTargetRow > prevViewportBottom) {
+        const currentScreenRow = Math.max(0, Math.min(height - 1, hardwareCursorRow - prevViewportTop));
+        const moveToBottom = height - 1 - currentScreenRow;
+        if (moveToBottom > 0) {
+            buffer += `\x1b[${moveToBottom}B`;
+        }
+        const scroll = moveTargetRow - prevViewportBottom;
+        buffer += "\r\n".repeat(scroll);
+        prevViewportTop += scroll;
+        viewportTop += scroll;
+        hardwareCursorRow = moveTargetRow;
+    }
+    // Move cursor to first changed line (use hardwareCursorRow for actual position)
+    const lineDiff = computeLineDiff(moveTargetRow);
+    if (lineDiff > 0) {
+        buffer += `\x1b[${lineDiff}B`; // Move down
+    }
+    else if (lineDiff < 0) {
+        buffer += `\x1b[${-lineDiff}A`; // Move up
+    }
+    buffer += appendStart ? "\r\n" : "\r"; // Move to column 0
+    // Only render changed lines (firstChanged to lastChanged), not all lines to end
+    // This reduces flicker when only a single line changes (e.g., spinner animation)
+    const renderEnd = Math.min(lastChanged, newLines.length - 1);
+    for (let i = firstChanged; i <= renderEnd; i++) {
+        if (i > firstChanged)
+            buffer += "\r\n";
+        const line = newLines[i];
+        const isImage = isImageLine(line);
+        const imageReservedRows = isImage ? self.getKittyImageReservedRows(newLines, i, renderEnd) : 1;
+        if (imageReservedRows > 1) {
+            const imageStartScreenRow = i - viewportTop;
+            if (imageStartScreenRow < 0 || imageStartScreenRow + imageReservedRows > height) {
+                logRedraw(`kitty image pre-clear would scroll (${imageStartScreenRow} + ${imageReservedRows} > ${height})`);
+                fullRender(true);
+                return;
+            }
+            buffer += "\x1b[2K";
+            for (let row = 1; row < imageReservedRows; row++) {
+                buffer += "\r\n\x1b[2K";
+            }
+            buffer += `\x1b[${imageReservedRows - 1}A`;
+            buffer += line;
+            buffer += `\x1b[${imageReservedRows - 1}B`;
+            i += imageReservedRows - 1;
+            continue;
+        }
+        buffer += "\x1b[2K"; // Clear current line
+        if (!isImage && visibleWidth(line) > width) {
+            throwRenderWidthError(self, newLines, line, i, width);
+        }
+        buffer += line;
+    }
+    // Track where cursor ended up after rendering
+    let finalCursorRow = renderEnd;
+    // If we had more lines before, clear them and move cursor back
+    if (self.previousLines.length > newLines.length) {
+        // Move to end of new content first if we stopped before it
+        if (renderEnd < newLines.length - 1) {
+            const moveDown = newLines.length - 1 - renderEnd;
+            buffer += `\x1b[${moveDown}B`;
+            finalCursorRow = newLines.length - 1;
+        }
+        const extraLines = self.previousLines.length - newLines.length;
+        for (let i = newLines.length; i < self.previousLines.length; i++) {
+            buffer += "\r\n\x1b[2K";
+        }
+        // Move cursor back to end of new content
+        buffer += `\x1b[${extraLines}A`;
+    }
+    buffer += "\x1b[?2026l"; // End synchronized output
+    if (process.env.PI_TUI_DEBUG === "1") {
+        const debugDir = "/tmp/tui";
+        fs.mkdirSync(debugDir, { recursive: true });
+        const debugPath = path.join(debugDir, `render-${Date.now()}-${Math.random().toString(36).slice(2)}.log`);
+        const debugData = [
+            `firstChanged: ${firstChanged}`,
+            `viewportTop: ${viewportTop}`,
+            `cursorRow: ${self.cursorRow}`,
+            `height: ${height}`,
+            `lineDiff: ${lineDiff}`,
+            `hardwareCursorRow: ${hardwareCursorRow}`,
+            `renderEnd: ${renderEnd}`,
+            `finalCursorRow: ${finalCursorRow}`,
+            `cursorPos: ${JSON.stringify(cursorPos)}`,
+            `newLines.length: ${newLines.length}`,
+            `previousLines.length: ${self.previousLines.length}`,
+            "",
+            "=== newLines ===",
+            JSON.stringify(newLines, null, 2),
+            "",
+            "=== previousLines ===",
+            JSON.stringify(self.previousLines, null, 2),
+            "",
+            "=== buffer ===",
+            JSON.stringify(buffer),
+        ].join("\n");
+        fs.writeFileSync(debugPath, debugData);
+    }
+    // Write entire buffer at once
+    self.terminal.write(buffer);
+    // Track cursor position for next render
+    // cursorRow tracks end of content (for viewport calculation)
+    // hardwareCursorRow tracks actual terminal cursor position (for movement)
+    self.cursorRow = Math.max(0, newLines.length - 1);
+    self.hardwareCursorRow = finalCursorRow;
+    // Track terminal's working area (grows but doesn't shrink unless cleared)
+    self.maxLinesRendered = Math.max(self.maxLinesRendered, newLines.length);
+    self.previousViewportTop = Math.max(prevViewportTop, finalCursorRow - height + 1);
+    // Position hardware cursor for IME
+    self.positionHardwareCursor(cursorPos, newLines.length);
+    self.previousLines = newLines;
+    self.previousKittyImageIds = self.collectKittyImageIds(newLines);
+    self.previousWidth = width;
+    self.previousHeight = height;
+}
+//# sourceMappingURL=incremental-render.js.map