@dst0/p-tui 0.4.40 → 5.0.2

package/dist/tui/tui-methods/terminal-control.js

@@ -0,0 +1,101 @@
+import { performance } from "node:perf_hooks";
+import { formatOsc11BackgroundColor, formatOsc111ResetBackgroundColor } from "../../terminal-colors.js";
+import { getCapabilities } from "../../terminal-image.js";
+import { TUI } from "../tui.js";
+export function do_queryCellSize(self) {
+    // Only query if terminal supports images (cell size is only used for image rendering)
+    if (!getCapabilities().images) {
+        return;
+    }
+    // Query terminal for cell size in pixels: CSI 16 t
+    // Response format: CSI 6 ; height ; width t
+    self.terminal.write("\x1b[16t");
+}
+export function do_setTerminalBackgroundColor(self, colorHex) {
+    if (self.currentBackgroundColorHex === colorHex)
+        return;
+    self.currentBackgroundColorHex = colorHex;
+    if (colorHex) {
+        self.terminal.write(formatOsc11BackgroundColor(colorHex));
+    }
+    else {
+        self.terminal.write(formatOsc111ResetBackgroundColor());
+    }
+}
+export function do_resetTerminalBackgroundColor(self) {
+    if (self.currentBackgroundColorHex !== undefined) {
+        self.currentBackgroundColorHex = undefined;
+        self.terminal.write(formatOsc111ResetBackgroundColor());
+    }
+}
+export function do_stop(self) {
+    self.stopped = true;
+    if (self.renderTimer) {
+        clearTimeout(self.renderTimer);
+        self.renderTimer = undefined;
+    }
+    self.resetTerminalBackgroundColor();
+    // Move cursor to the end of the content to prevent overwriting/artifacts on exit
+    if (self.previousLines.length > 0) {
+        const targetRow = self.previousLines.length; // Line after the last content
+        const lineDiff = targetRow - self.hardwareCursorRow;
+        if (lineDiff > 0) {
+            self.terminal.write(`\x1b[${lineDiff}B`);
+        }
+        else if (lineDiff < 0) {
+            self.terminal.write(`\x1b[${-lineDiff}A`);
+        }
+        self.terminal.write("\r\n");
+    }
+    self.terminal.showCursor();
+    self.terminal.stop();
+}
+export function do_requestRender(self, force = false) {
+    if (force) {
+        self.previousLines = [];
+        self.previousWidth = -1; // -1 triggers widthChanged, forcing a full clear
+        self.previousHeight = -1; // -1 triggers heightChanged, forcing a full clear
+        self.cursorRow = 0;
+        self.hardwareCursorRow = 0;
+        self.maxLinesRendered = 0;
+        self.previousViewportTop = 0;
+        if (self.renderTimer) {
+            clearTimeout(self.renderTimer);
+            self.renderTimer = undefined;
+        }
+        self.renderRequested = true;
+        process.nextTick(() => {
+            if (self.stopped || !self.renderRequested) {
+                return;
+            }
+            self.renderRequested = false;
+            self.lastRenderAt = performance.now();
+            self.doRender();
+        });
+        return;
+    }
+    if (self.renderRequested)
+        return;
+    self.renderRequested = true;
+    process.nextTick(() => self.scheduleRender());
+}
+export function do_scheduleRender(self) {
+    if (self.stopped || self.renderTimer || !self.renderRequested) {
+        return;
+    }
+    const elapsed = performance.now() - self.lastRenderAt;
+    const delay = Math.max(0, TUI.MIN_RENDER_INTERVAL_MS - elapsed);
+    self.renderTimer = setTimeout(() => {
+        self.renderTimer = undefined;
+        if (self.stopped || !self.renderRequested) {
+            return;
+        }
+        self.renderRequested = false;
+        self.lastRenderAt = performance.now();
+        self.doRender();
+        if (self.renderRequested) {
+            self.scheduleRender();
+        }
+    }, delay);
+}
+//# sourceMappingURL=terminal-control.js.map

package/dist/tui/tui-methods/terminal-control.js.map

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

package/dist/tui/tui.d.ts

@@ -0,0 +1,59 @@
+import type { Terminal } from "../terminal.ts";
+import type { RgbColor } from "../terminal-colors.ts";
+import { type DelegatedMethods } from "../utils/install-delegated-methods.ts";
+import { Container } from "./container.ts";
+import * as configurationDelegates from "./tui-methods/configuration.ts";
+import * as cursorBackgroundDelegates from "./tui-methods/cursor-background.ts";
+import * as inputHandlingDelegates from "./tui-methods/input-handling.ts";
+import * as lineCompositingDelegates from "./tui-methods/line-compositing.ts";
+import * as overlayCompositingDelegates from "./tui-methods/overlay-compositing.ts";
+import * as overlayLayoutDelegates from "./tui-methods/overlay-layout.ts";
+import * as overlayManagementDelegates from "./tui-methods/overlay-management.ts";
+import * as renderPipelineDelegates from "./tui-methods/render-pipeline.ts";
+import * as terminalControlDelegates from "./tui-methods/terminal-control.ts";
+import type { Component, InputListener, OverlayFocusRestorePolicy, OverlayFocusRestoreState, OverlayStackEntry, PendingOsc11BackgroundQuery } from "./types.ts";
+export declare class TUI extends Container {
+    terminal: Terminal;
+    previousLines: string[];
+    previousKittyImageIds: Set<number>;
+    previousWidth: number;
+    previousHeight: number;
+    focusedComponent: Component | null;
+    inputListeners: Set<InputListener>;
+    onDebug?: () => void;
+    renderRequested: boolean;
+    renderTimer: NodeJS.Timeout | undefined;
+    lastRenderAt: number;
+    static readonly MIN_RENDER_INTERVAL_MS = 16;
+    cursorRow: number;
+    hardwareCursorRow: number;
+    showHardwareCursor: boolean;
+    clearOnShrink: boolean;
+    maxLinesRendered: number;
+    previousViewportTop: number;
+    fullRedrawCount: number;
+    stopped: boolean;
+    pendingOsc11BackgroundReplies: number;
+    pendingOsc11BackgroundQueries: PendingOsc11BackgroundQuery[];
+    focusOrderCounter: number;
+    overlayStack: OverlayStackEntry[];
+    previousOverlayCount: number;
+    overlayFocusRestore: OverlayFocusRestoreState;
+    constructor(terminal: Terminal, showHardwareCursor?: boolean);
+    get fullRedraws(): number;
+    currentBackgroundColorHex: string | undefined;
+    static readonly SEGMENT_RESET = "\u001B[0m\u001B]8;;\u0007";
+    invalidate(): void;
+    setFocusInternal({ component, overlayFocusRestore }: {
+        component: Component | null;
+        overlayFocusRestore: OverlayFocusRestorePolicy;
+    }): void;
+    queryTerminalBackgroundColor({ timeoutMs }: {
+        timeoutMs: number;
+    }): Promise<RgbColor | undefined>;
+}
+type TUIMethods = Omit<DelegatedMethods<TUI, typeof configurationDelegates & typeof cursorBackgroundDelegates & typeof inputHandlingDelegates & typeof lineCompositingDelegates & typeof overlayCompositingDelegates & typeof overlayLayoutDelegates & typeof overlayManagementDelegates & typeof renderPipelineDelegates & typeof terminalControlDelegates>, "queryTerminalBackgroundColor" | "setFocusInternal">;
+export interface TUI extends TUIMethods {
+}
+export {};
+//# sourceMappingURL=tui.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tui.d.ts","sourceRoot":"","sources":["../../src/tui/tui.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,EAAE,KAAK,gBAAgB,EAA2B,MAAM,uCAAuC,CAAC;AACvG,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,KAAK,sBAAsB,MAAM,gCAAgC,CAAC;AACzE,OAAO,KAAK,yBAAyB,MAAM,oCAAoC,CAAC;AAChF,OAAO,KAAK,sBAAsB,MAAM,iCAAiC,CAAC;AAC1E,OAAO,KAAK,wBAAwB,MAAM,mCAAmC,CAAC;AAC9E,OAAO,KAAK,2BAA2B,MAAM,sCAAsC,CAAC;AACpF,OAAO,KAAK,sBAAsB,MAAM,iCAAiC,CAAC;AAC1E,OAAO,KAAK,0BAA0B,MAAM,qCAAqC,CAAC;AAClF,OAAO,KAAK,uBAAuB,MAAM,kCAAkC,CAAC;AAC5E,OAAO,KAAK,wBAAwB,MAAM,mCAAmC,CAAC;AAC9E,OAAO,KAAK,EACV,SAAS,EACT,aAAa,EACb,yBAAyB,EACzB,wBAAwB,EACxB,iBAAiB,EACjB,2BAA2B,EAC5B,MAAM,YAAY,CAAC;AAGpB,qBAAa,GAAI,SAAQ,SAAS;IACzB,QAAQ,EAAE,QAAQ,CAAC;IAEnB,aAAa,EAAE,MAAM,EAAE,CAAM;IAE7B,qBAAqB,cAAqB;IAE1C,aAAa,SAAK;IAElB,cAAc,SAAK;IAEnB,gBAAgB,EAAE,SAAS,GAAG,IAAI,CAAQ;IAE1C,cAAc,qBAA4B;IAE1C,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IAErB,eAAe,UAAS;IAExB,WAAW,EAAE,MAAM,CAAC,OAAO,GAAG,SAAS,CAAC;IAExC,YAAY,SAAK;IAExB,gBAAuB,sBAAsB,MAAM;IAE5C,SAAS,SAAK;IAEd,iBAAiB,SAAK;IAEtB,kBAAkB,UAA0C;IAE5D,aAAa,UAA0C;IAEvD,gBAAgB,SAAK;IAErB,mBAAmB,SAAK;IAExB,eAAe,SAAK;IAEpB,OAAO,UAAS;IAEhB,6BAA6B,SAAK;IAElC,6BAA6B,EAAE,2BAA2B,EAAE,CAAM;IAElE,iBAAiB,SAAK;IAEtB,YAAY,EAAE,iBAAiB,EAAE,CAAM;IAEvC,oBAAoB,SAAK;IAEzB,mBAAmB,EAAE,wBAAwB,CAA0B;IAE9E,YAAY,QAAQ,EAAE,QAAQ,EAAE,kBAAkB,CAAC,EAAE,OAAO,EAM3D;IAED,IAAI,WAAW,IAAI,MAAM,CAExB;IAEM,yBAAyB,EAAE,MAAM,GAAG,SAAS,CAAa;IAEjE,gBAAuB,aAAa,+BAAyB;IAEpD,UAAU,IAAI,IAAI,CAG1B;IAED,gBAAgB,CAAC,EACf,SAAS,EACT,mBAAmB,EACpB,EAAE;QACD,SAAS,EAAE,SAAS,GAAG,IAAI,CAAC;QAC5B,mBAAmB,EAAE,yBAAyB,CAAC;KAChD,GAAG,IAAI,CAKP;IAED,4BAA4B,CAAC,EAAE,SAAS,EAAE,EAAE;QAAE,SAAS,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,QAAQ,GAAG,SAAS,CAAC,CAEhG;CACF;AAED,KAAK,UAAU,GAAG,IAAI,CACpB,gBAAgB,CACd,GAAG,EACH,OAAO,sBAAsB,GAC3B,OAAO,yBAAyB,GAChC,OAAO,sBAAsB,GAC7B,OAAO,wBAAwB,GAC/B,OAAO,2BAA2B,GAClC,OAAO,sBAAsB,GAC7B,OAAO,0BAA0B,GACjC,OAAO,uBAAuB,GAC9B,OAAO,wBAAwB,CAClC,EACD,8BAA8B,GAAG,kBAAkB,CACpD,CAAC;AAEF,MAAM,WAAW,GAAI,SAAQ,UAAU;CAAG","sourcesContent":["import type { Terminal } from \"../terminal.ts\";\nimport type { RgbColor } from \"../terminal-colors.ts\";\nimport { type DelegatedMethods, installDelegatedMethods } from \"../utils/install-delegated-methods.ts\";\nimport { Container } from \"./container.ts\";\nimport * as configurationDelegates from \"./tui-methods/configuration.ts\";\nimport * as cursorBackgroundDelegates from \"./tui-methods/cursor-background.ts\";\nimport * as inputHandlingDelegates from \"./tui-methods/input-handling.ts\";\nimport * as lineCompositingDelegates from \"./tui-methods/line-compositing.ts\";\nimport * as overlayCompositingDelegates from \"./tui-methods/overlay-compositing.ts\";\nimport * as overlayLayoutDelegates from \"./tui-methods/overlay-layout.ts\";\nimport * as overlayManagementDelegates from \"./tui-methods/overlay-management.ts\";\nimport * as renderPipelineDelegates from \"./tui-methods/render-pipeline.ts\";\nimport * as terminalControlDelegates from \"./tui-methods/terminal-control.ts\";\nimport type {\n  Component,\n  InputListener,\n  OverlayFocusRestorePolicy,\n  OverlayFocusRestoreState,\n  OverlayStackEntry,\n  PendingOsc11BackgroundQuery,\n} from \"./types.ts\";\n\n// biome-ignore lint/suspicious/noUnsafeDeclarationMerging: The installer below synchronously defines every delegated method.\nexport class TUI extends Container {\n  public terminal: Terminal;\n\n  public previousLines: string[] = [];\n\n  public previousKittyImageIds = new Set<number>();\n\n  public previousWidth = 0;\n\n  public previousHeight = 0;\n\n  public focusedComponent: Component | null = null;\n\n  public inputListeners = new Set<InputListener>();\n\n  public onDebug?: () => void;\n\n  public renderRequested = false;\n\n  public renderTimer: NodeJS.Timeout | undefined;\n\n  public lastRenderAt = 0;\n\n  public static readonly MIN_RENDER_INTERVAL_MS = 16;\n\n  public cursorRow = 0;\n\n  public hardwareCursorRow = 0;\n\n  public showHardwareCursor = process.env.PI_HARDWARE_CURSOR === \"1\";\n\n  public clearOnShrink = process.env.PI_CLEAR_ON_SHRINK === \"1\";\n\n  public maxLinesRendered = 0;\n\n  public previousViewportTop = 0;\n\n  public fullRedrawCount = 0;\n\n  public stopped = false;\n\n  public pendingOsc11BackgroundReplies = 0;\n\n  public pendingOsc11BackgroundQueries: PendingOsc11BackgroundQuery[] = [];\n\n  public focusOrderCounter = 0;\n\n  public overlayStack: OverlayStackEntry[] = [];\n\n  public previousOverlayCount = 0;\n\n  public overlayFocusRestore: OverlayFocusRestoreState = { status: \"inactive\" };\n\n  constructor(terminal: Terminal, showHardwareCursor?: boolean) {\n    super();\n    this.terminal = terminal;\n    if (showHardwareCursor !== undefined) {\n      this.showHardwareCursor = showHardwareCursor;\n    }\n  }\n\n  get fullRedraws(): number {\n    return this.fullRedrawCount;\n  }\n\n  public currentBackgroundColorHex: string | undefined = undefined;\n\n  public static readonly SEGMENT_RESET = \"\\x1b[0m\\x1b]8;;\\x07\";\n\n  override invalidate(): void {\n    super.invalidate();\n    for (const overlay of this.overlayStack) overlay.component.invalidate?.();\n  }\n\n  setFocusInternal({\n    component,\n    overlayFocusRestore,\n  }: {\n    component: Component | null;\n    overlayFocusRestore: OverlayFocusRestorePolicy;\n  }): void {\n    configurationDelegates.do_setFocusInternal(this, {\n      component,\n      overlayFocusRestore,\n    });\n  }\n\n  queryTerminalBackgroundColor({ timeoutMs }: { timeoutMs: number }): Promise<RgbColor | undefined> {\n    return cursorBackgroundDelegates.do_queryTerminalBackgroundColor(this, { timeoutMs });\n  }\n}\n\ntype TUIMethods = Omit<\n  DelegatedMethods<\n    TUI,\n    typeof configurationDelegates &\n      typeof cursorBackgroundDelegates &\n      typeof inputHandlingDelegates &\n      typeof lineCompositingDelegates &\n      typeof overlayCompositingDelegates &\n      typeof overlayLayoutDelegates &\n      typeof overlayManagementDelegates &\n      typeof renderPipelineDelegates &\n      typeof terminalControlDelegates\n  >,\n  \"queryTerminalBackgroundColor\" | \"setFocusInternal\"\n>;\n\nexport interface TUI extends TUIMethods {}\n\ninstallDelegatedMethods(TUI.prototype, [\n  configurationDelegates,\n  cursorBackgroundDelegates,\n  inputHandlingDelegates,\n  lineCompositingDelegates,\n  overlayCompositingDelegates,\n  overlayLayoutDelegates,\n  overlayManagementDelegates,\n  renderPipelineDelegates,\n  terminalControlDelegates,\n]);\n"]}

package/dist/tui/tui.js

@@ -0,0 +1,78 @@
+import { installDelegatedMethods } from "../utils/install-delegated-methods.js";
+import { Container } from "./container.js";
+import * as configurationDelegates from "./tui-methods/configuration.js";
+import * as cursorBackgroundDelegates from "./tui-methods/cursor-background.js";
+import * as inputHandlingDelegates from "./tui-methods/input-handling.js";
+import * as lineCompositingDelegates from "./tui-methods/line-compositing.js";
+import * as overlayCompositingDelegates from "./tui-methods/overlay-compositing.js";
+import * as overlayLayoutDelegates from "./tui-methods/overlay-layout.js";
+import * as overlayManagementDelegates from "./tui-methods/overlay-management.js";
+import * as renderPipelineDelegates from "./tui-methods/render-pipeline.js";
+import * as terminalControlDelegates from "./tui-methods/terminal-control.js";
+// biome-ignore lint/suspicious/noUnsafeDeclarationMerging: The installer below synchronously defines every delegated method.
+export class TUI extends Container {
+    terminal;
+    previousLines = [];
+    previousKittyImageIds = new Set();
+    previousWidth = 0;
+    previousHeight = 0;
+    focusedComponent = null;
+    inputListeners = new Set();
+    onDebug;
+    renderRequested = false;
+    renderTimer;
+    lastRenderAt = 0;
+    static MIN_RENDER_INTERVAL_MS = 16;
+    cursorRow = 0;
+    hardwareCursorRow = 0;
+    showHardwareCursor = process.env.PI_HARDWARE_CURSOR === "1";
+    clearOnShrink = process.env.PI_CLEAR_ON_SHRINK === "1";
+    maxLinesRendered = 0;
+    previousViewportTop = 0;
+    fullRedrawCount = 0;
+    stopped = false;
+    pendingOsc11BackgroundReplies = 0;
+    pendingOsc11BackgroundQueries = [];
+    focusOrderCounter = 0;
+    overlayStack = [];
+    previousOverlayCount = 0;
+    overlayFocusRestore = { status: "inactive" };
+    constructor(terminal, showHardwareCursor) {
+        super();
+        this.terminal = terminal;
+        if (showHardwareCursor !== undefined) {
+            this.showHardwareCursor = showHardwareCursor;
+        }
+    }
+    get fullRedraws() {
+        return this.fullRedrawCount;
+    }
+    currentBackgroundColorHex = undefined;
+    static SEGMENT_RESET = "\x1b[0m\x1b]8;;\x07";
+    invalidate() {
+        super.invalidate();
+        for (const overlay of this.overlayStack)
+            overlay.component.invalidate?.();
+    }
+    setFocusInternal({ component, overlayFocusRestore, }) {
+        configurationDelegates.do_setFocusInternal(this, {
+            component,
+            overlayFocusRestore,
+        });
+    }
+    queryTerminalBackgroundColor({ timeoutMs }) {
+        return cursorBackgroundDelegates.do_queryTerminalBackgroundColor(this, { timeoutMs });
+    }
+}
+installDelegatedMethods(TUI.prototype, [
+    configurationDelegates,
+    cursorBackgroundDelegates,
+    inputHandlingDelegates,
+    lineCompositingDelegates,
+    overlayCompositingDelegates,
+    overlayLayoutDelegates,
+    overlayManagementDelegates,
+    renderPipelineDelegates,
+    terminalControlDelegates,
+]);
+//# sourceMappingURL=tui.js.map

package/dist/tui/tui.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tui.js","sourceRoot":"","sources":["../../src/tui/tui.ts"],"names":[],"mappings":"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","sourcesContent":["import type { Terminal } from \"../terminal.ts\";\nimport type { RgbColor } from \"../terminal-colors.ts\";\nimport { type DelegatedMethods, installDelegatedMethods } from \"../utils/install-delegated-methods.ts\";\nimport { Container } from \"./container.ts\";\nimport * as configurationDelegates from \"./tui-methods/configuration.ts\";\nimport * as cursorBackgroundDelegates from \"./tui-methods/cursor-background.ts\";\nimport * as inputHandlingDelegates from \"./tui-methods/input-handling.ts\";\nimport * as lineCompositingDelegates from \"./tui-methods/line-compositing.ts\";\nimport * as overlayCompositingDelegates from \"./tui-methods/overlay-compositing.ts\";\nimport * as overlayLayoutDelegates from \"./tui-methods/overlay-layout.ts\";\nimport * as overlayManagementDelegates from \"./tui-methods/overlay-management.ts\";\nimport * as renderPipelineDelegates from \"./tui-methods/render-pipeline.ts\";\nimport * as terminalControlDelegates from \"./tui-methods/terminal-control.ts\";\nimport type {\n  Component,\n  InputListener,\n  OverlayFocusRestorePolicy,\n  OverlayFocusRestoreState,\n  OverlayStackEntry,\n  PendingOsc11BackgroundQuery,\n} from \"./types.ts\";\n\n// biome-ignore lint/suspicious/noUnsafeDeclarationMerging: The installer below synchronously defines every delegated method.\nexport class TUI extends Container {\n  public terminal: Terminal;\n\n  public previousLines: string[] = [];\n\n  public previousKittyImageIds = new Set<number>();\n\n  public previousWidth = 0;\n\n  public previousHeight = 0;\n\n  public focusedComponent: Component | null = null;\n\n  public inputListeners = new Set<InputListener>();\n\n  public onDebug?: () => void;\n\n  public renderRequested = false;\n\n  public renderTimer: NodeJS.Timeout | undefined;\n\n  public lastRenderAt = 0;\n\n  public static readonly MIN_RENDER_INTERVAL_MS = 16;\n\n  public cursorRow = 0;\n\n  public hardwareCursorRow = 0;\n\n  public showHardwareCursor = process.env.PI_HARDWARE_CURSOR === \"1\";\n\n  public clearOnShrink = process.env.PI_CLEAR_ON_SHRINK === \"1\";\n\n  public maxLinesRendered = 0;\n\n  public previousViewportTop = 0;\n\n  public fullRedrawCount = 0;\n\n  public stopped = false;\n\n  public pendingOsc11BackgroundReplies = 0;\n\n  public pendingOsc11BackgroundQueries: PendingOsc11BackgroundQuery[] = [];\n\n  public focusOrderCounter = 0;\n\n  public overlayStack: OverlayStackEntry[] = [];\n\n  public previousOverlayCount = 0;\n\n  public overlayFocusRestore: OverlayFocusRestoreState = { status: \"inactive\" };\n\n  constructor(terminal: Terminal, showHardwareCursor?: boolean) {\n    super();\n    this.terminal = terminal;\n    if (showHardwareCursor !== undefined) {\n      this.showHardwareCursor = showHardwareCursor;\n    }\n  }\n\n  get fullRedraws(): number {\n    return this.fullRedrawCount;\n  }\n\n  public currentBackgroundColorHex: string | undefined = undefined;\n\n  public static readonly SEGMENT_RESET = \"\\x1b[0m\\x1b]8;;\\x07\";\n\n  override invalidate(): void {\n    super.invalidate();\n    for (const overlay of this.overlayStack) overlay.component.invalidate?.();\n  }\n\n  setFocusInternal({\n    component,\n    overlayFocusRestore,\n  }: {\n    component: Component | null;\n    overlayFocusRestore: OverlayFocusRestorePolicy;\n  }): void {\n    configurationDelegates.do_setFocusInternal(this, {\n      component,\n      overlayFocusRestore,\n    });\n  }\n\n  queryTerminalBackgroundColor({ timeoutMs }: { timeoutMs: number }): Promise<RgbColor | undefined> {\n    return cursorBackgroundDelegates.do_queryTerminalBackgroundColor(this, { timeoutMs });\n  }\n}\n\ntype TUIMethods = Omit<\n  DelegatedMethods<\n    TUI,\n    typeof configurationDelegates &\n      typeof cursorBackgroundDelegates &\n      typeof inputHandlingDelegates &\n      typeof lineCompositingDelegates &\n      typeof overlayCompositingDelegates &\n      typeof overlayLayoutDelegates &\n      typeof overlayManagementDelegates &\n      typeof renderPipelineDelegates &\n      typeof terminalControlDelegates\n  >,\n  \"queryTerminalBackgroundColor\" | \"setFocusInternal\"\n>;\n\nexport interface TUI extends TUIMethods {}\n\ninstallDelegatedMethods(TUI.prototype, [\n  configurationDelegates,\n  cursorBackgroundDelegates,\n  inputHandlingDelegates,\n  lineCompositingDelegates,\n  overlayCompositingDelegates,\n  overlayLayoutDelegates,\n  overlayManagementDelegates,\n  renderPipelineDelegates,\n  terminalControlDelegates,\n]);\n"]}

package/dist/tui/types.d.ts

@@ -0,0 +1,124 @@
+import type { RgbColor } from "../terminal-colors.ts";
+export interface KittyImageHeader {
+    ids: number[];
+    rows: number;
+}
+export interface Component {
+    /**
+     * Render the component to lines for the given viewport width
+     * @param width - Current viewport width
+     * @returns Array of strings, each representing a line
+     */
+    render(width: number): string[];
+    /**
+     * Optional handler for keyboard input when component has focus
+     */
+    handleInput?(data: string): void;
+    /**
+     * If true, component receives key release events (Kitty protocol).
+     * Default is false - release events are filtered out.
+     */
+    wantsKeyRelease?: boolean;
+    /**
+     * Invalidate any cached rendering state.
+     * Called when theme changes or when component needs to re-render from scratch.
+     */
+    invalidate(): void;
+}
+export type InputListenerResult = {
+    consume?: boolean;
+    data?: string;
+} | undefined;
+export type InputListener = (data: string) => InputListenerResult;
+export type PendingOsc11BackgroundQuery = {
+    settled: boolean;
+    resolve: ((rgb: RgbColor | undefined) => void) | undefined;
+    timer: NodeJS.Timeout | undefined;
+};
+export interface Focusable {
+    /** Set by TUI when focus changes. Component should emit CURSOR_MARKER when true. */
+    focused: boolean;
+}
+export type OverlayAnchor = "center" | "top-left" | "top-right" | "bottom-left" | "bottom-right" | "top-center" | "bottom-center" | "left-center" | "right-center";
+export interface OverlayMargin {
+    top?: number;
+    right?: number;
+    bottom?: number;
+    left?: number;
+}
+export type SizeValue = number | `${number}%`;
+export interface OverlayOptions {
+    /** Width in columns, or percentage of terminal width (e.g., "50%") */
+    width?: SizeValue;
+    /** Minimum width in columns */
+    minWidth?: number;
+    /** Maximum height in rows, or percentage of terminal height (e.g., "50%") */
+    maxHeight?: SizeValue;
+    /** Anchor point for positioning (default: 'center') */
+    anchor?: OverlayAnchor;
+    /** Horizontal offset from anchor position (positive = right) */
+    offsetX?: number;
+    /** Vertical offset from anchor position (positive = down) */
+    offsetY?: number;
+    /** Row position: absolute number, or percentage (e.g., "25%" = 25% from top) */
+    row?: SizeValue;
+    /** Column position: absolute number, or percentage (e.g., "50%" = centered horizontally) */
+    col?: SizeValue;
+    /** Margin from terminal edges. Number applies to all sides. */
+    margin?: OverlayMargin | number;
+    /**
+     * Control overlay visibility based on terminal dimensions.
+     * If provided, overlay is only rendered when this returns true.
+     * Called each render cycle with current terminal dimensions.
+     */
+    visible?: (termWidth: number, termHeight: number) => boolean;
+    /** If true, don't capture keyboard focus when shown */
+    nonCapturing?: boolean;
+}
+export interface OverlayUnfocusOptions {
+    /** Explicit target to focus after releasing this overlay. */
+    target: Component | null;
+}
+export interface OverlayHandle {
+    /** Permanently remove the overlay (cannot be shown again) */
+    hide(): void;
+    /** Temporarily hide or show the overlay */
+    setHidden(hidden: boolean): void;
+    /** Check if overlay is temporarily hidden */
+    isHidden(): boolean;
+    /** Focus this overlay and bring it to the visual front */
+    focus(): void;
+    /** Release focus to the next visible capturing overlay or previous target, or to an explicit target when provided */
+    unfocus(options?: OverlayUnfocusOptions): void;
+    /** Check if this overlay currently has focus */
+    isFocused(): boolean;
+}
+export type OverlayStackEntry = {
+    component: Component;
+    options?: OverlayOptions;
+    preFocus: Component | null;
+    hidden: boolean;
+    focusOrder: number;
+};
+export type OverlayBlockedFocusResume = {
+    status: "restore-overlay";
+} | {
+    status: "focus-target";
+    target: Component | null;
+};
+export type EligibleOverlayFocusRestoreState = {
+    status: "eligible";
+    overlay: OverlayStackEntry;
+};
+export type BlockedOverlayFocusRestoreState = {
+    status: "blocked";
+    overlay: OverlayStackEntry;
+    blockedBy: Component;
+    resume: OverlayBlockedFocusResume;
+};
+export type ActiveOverlayFocusRestoreState = EligibleOverlayFocusRestoreState | BlockedOverlayFocusRestoreState;
+export type OverlayFocusRestoreState = {
+    status: "inactive";
+} | ActiveOverlayFocusRestoreState;
+export type OverlayFocusRestorePolicy = "clear" | "preserve";
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/tui/types.ts"],"names":[],"mappings":"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","sourcesContent":["import type { RgbColor } from \"../terminal-colors.ts\";\n\nexport interface KittyImageHeader {\n  ids: number[];\n  rows: number;\n}\n\nexport interface Component {\n  /**\n   * Render the component to lines for the given viewport width\n   * @param width - Current viewport width\n   * @returns Array of strings, each representing a line\n   */\n  render(width: number): string[];\n\n  /**\n   * Optional handler for keyboard input when component has focus\n   */\n  handleInput?(data: string): void;\n\n  /**\n   * If true, component receives key release events (Kitty protocol).\n   * Default is false - release events are filtered out.\n   */\n  wantsKeyRelease?: boolean;\n\n  /**\n   * Invalidate any cached rendering state.\n   * Called when theme changes or when component needs to re-render from scratch.\n   */\n  invalidate(): void;\n}\n\nexport type InputListenerResult = { consume?: boolean; data?: string } | undefined;\n\nexport type InputListener = (data: string) => InputListenerResult;\n\nexport type PendingOsc11BackgroundQuery = {\n  settled: boolean;\n  resolve: ((rgb: RgbColor | undefined) => void) | undefined;\n  timer: NodeJS.Timeout | undefined;\n};\n\nexport interface Focusable {\n  /** Set by TUI when focus changes. Component should emit CURSOR_MARKER when true. */\n  focused: boolean;\n}\n\nexport type OverlayAnchor =\n  | \"center\"\n  | \"top-left\"\n  | \"top-right\"\n  | \"bottom-left\"\n  | \"bottom-right\"\n  | \"top-center\"\n  | \"bottom-center\"\n  | \"left-center\"\n  | \"right-center\";\n\nexport interface OverlayMargin {\n  top?: number;\n  right?: number;\n  bottom?: number;\n  left?: number;\n}\n\nexport type SizeValue = number | `${number}%`;\n\nexport interface OverlayOptions {\n  // === Sizing ===\n  /** Width in columns, or percentage of terminal width (e.g., \"50%\") */\n  width?: SizeValue;\n  /** Minimum width in columns */\n  minWidth?: number;\n  /** Maximum height in rows, or percentage of terminal height (e.g., \"50%\") */\n  maxHeight?: SizeValue;\n\n  // === Positioning - anchor-based ===\n  /** Anchor point for positioning (default: 'center') */\n  anchor?: OverlayAnchor;\n  /** Horizontal offset from anchor position (positive = right) */\n  offsetX?: number;\n  /** Vertical offset from anchor position (positive = down) */\n  offsetY?: number;\n\n  // === Positioning - percentage or absolute ===\n  /** Row position: absolute number, or percentage (e.g., \"25%\" = 25% from top) */\n  row?: SizeValue;\n  /** Column position: absolute number, or percentage (e.g., \"50%\" = centered horizontally) */\n  col?: SizeValue;\n\n  // === Margin from terminal edges ===\n  /** Margin from terminal edges. Number applies to all sides. */\n  margin?: OverlayMargin | number;\n\n  // === Visibility ===\n  /**\n   * Control overlay visibility based on terminal dimensions.\n   * If provided, overlay is only rendered when this returns true.\n   * Called each render cycle with current terminal dimensions.\n   */\n  visible?: (termWidth: number, termHeight: number) => boolean;\n  /** If true, don't capture keyboard focus when shown */\n  nonCapturing?: boolean;\n}\n\nexport interface OverlayUnfocusOptions {\n  /** Explicit target to focus after releasing this overlay. */\n  target: Component | null;\n}\n\nexport interface OverlayHandle {\n  /** Permanently remove the overlay (cannot be shown again) */\n  hide(): void;\n  /** Temporarily hide or show the overlay */\n  setHidden(hidden: boolean): void;\n  /** Check if overlay is temporarily hidden */\n  isHidden(): boolean;\n  /** Focus this overlay and bring it to the visual front */\n  focus(): void;\n  /** Release focus to the next visible capturing overlay or previous target, or to an explicit target when provided */\n  unfocus(options?: OverlayUnfocusOptions): void;\n  /** Check if this overlay currently has focus */\n  isFocused(): boolean;\n}\n\nexport type OverlayStackEntry = {\n  component: Component;\n  options?: OverlayOptions;\n  preFocus: Component | null;\n  hidden: boolean;\n  focusOrder: number;\n};\n\nexport type OverlayBlockedFocusResume =\n  | { status: \"restore-overlay\" }\n  | { status: \"focus-target\"; target: Component | null };\n\nexport type EligibleOverlayFocusRestoreState = { status: \"eligible\"; overlay: OverlayStackEntry };\n\nexport type BlockedOverlayFocusRestoreState = {\n  status: \"blocked\";\n  overlay: OverlayStackEntry;\n  blockedBy: Component;\n  resume: OverlayBlockedFocusResume;\n};\n\nexport type ActiveOverlayFocusRestoreState = EligibleOverlayFocusRestoreState | BlockedOverlayFocusRestoreState;\n\nexport type OverlayFocusRestoreState = { status: \"inactive\" } | ActiveOverlayFocusRestoreState;\n\nexport type OverlayFocusRestorePolicy = \"clear\" | \"preserve\";\n"]}

package/dist/tui/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/tui/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/tui/types.ts"],"names":[],"mappings":"","sourcesContent":["import type { RgbColor } from \"../terminal-colors.ts\";\n\nexport interface KittyImageHeader {\n  ids: number[];\n  rows: number;\n}\n\nexport interface Component {\n  /**\n   * Render the component to lines for the given viewport width\n   * @param width - Current viewport width\n   * @returns Array of strings, each representing a line\n   */\n  render(width: number): string[];\n\n  /**\n   * Optional handler for keyboard input when component has focus\n   */\n  handleInput?(data: string): void;\n\n  /**\n   * If true, component receives key release events (Kitty protocol).\n   * Default is false - release events are filtered out.\n   */\n  wantsKeyRelease?: boolean;\n\n  /**\n   * Invalidate any cached rendering state.\n   * Called when theme changes or when component needs to re-render from scratch.\n   */\n  invalidate(): void;\n}\n\nexport type InputListenerResult = { consume?: boolean; data?: string } | undefined;\n\nexport type InputListener = (data: string) => InputListenerResult;\n\nexport type PendingOsc11BackgroundQuery = {\n  settled: boolean;\n  resolve: ((rgb: RgbColor | undefined) => void) | undefined;\n  timer: NodeJS.Timeout | undefined;\n};\n\nexport interface Focusable {\n  /** Set by TUI when focus changes. Component should emit CURSOR_MARKER when true. */\n  focused: boolean;\n}\n\nexport type OverlayAnchor =\n  | \"center\"\n  | \"top-left\"\n  | \"top-right\"\n  | \"bottom-left\"\n  | \"bottom-right\"\n  | \"top-center\"\n  | \"bottom-center\"\n  | \"left-center\"\n  | \"right-center\";\n\nexport interface OverlayMargin {\n  top?: number;\n  right?: number;\n  bottom?: number;\n  left?: number;\n}\n\nexport type SizeValue = number | `${number}%`;\n\nexport interface OverlayOptions {\n  // === Sizing ===\n  /** Width in columns, or percentage of terminal width (e.g., \"50%\") */\n  width?: SizeValue;\n  /** Minimum width in columns */\n  minWidth?: number;\n  /** Maximum height in rows, or percentage of terminal height (e.g., \"50%\") */\n  maxHeight?: SizeValue;\n\n  // === Positioning - anchor-based ===\n  /** Anchor point for positioning (default: 'center') */\n  anchor?: OverlayAnchor;\n  /** Horizontal offset from anchor position (positive = right) */\n  offsetX?: number;\n  /** Vertical offset from anchor position (positive = down) */\n  offsetY?: number;\n\n  // === Positioning - percentage or absolute ===\n  /** Row position: absolute number, or percentage (e.g., \"25%\" = 25% from top) */\n  row?: SizeValue;\n  /** Column position: absolute number, or percentage (e.g., \"50%\" = centered horizontally) */\n  col?: SizeValue;\n\n  // === Margin from terminal edges ===\n  /** Margin from terminal edges. Number applies to all sides. */\n  margin?: OverlayMargin | number;\n\n  // === Visibility ===\n  /**\n   * Control overlay visibility based on terminal dimensions.\n   * If provided, overlay is only rendered when this returns true.\n   * Called each render cycle with current terminal dimensions.\n   */\n  visible?: (termWidth: number, termHeight: number) => boolean;\n  /** If true, don't capture keyboard focus when shown */\n  nonCapturing?: boolean;\n}\n\nexport interface OverlayUnfocusOptions {\n  /** Explicit target to focus after releasing this overlay. */\n  target: Component | null;\n}\n\nexport interface OverlayHandle {\n  /** Permanently remove the overlay (cannot be shown again) */\n  hide(): void;\n  /** Temporarily hide or show the overlay */\n  setHidden(hidden: boolean): void;\n  /** Check if overlay is temporarily hidden */\n  isHidden(): boolean;\n  /** Focus this overlay and bring it to the visual front */\n  focus(): void;\n  /** Release focus to the next visible capturing overlay or previous target, or to an explicit target when provided */\n  unfocus(options?: OverlayUnfocusOptions): void;\n  /** Check if this overlay currently has focus */\n  isFocused(): boolean;\n}\n\nexport type OverlayStackEntry = {\n  component: Component;\n  options?: OverlayOptions;\n  preFocus: Component | null;\n  hidden: boolean;\n  focusOrder: number;\n};\n\nexport type OverlayBlockedFocusResume =\n  | { status: \"restore-overlay\" }\n  | { status: \"focus-target\"; target: Component | null };\n\nexport type EligibleOverlayFocusRestoreState = { status: \"eligible\"; overlay: OverlayStackEntry };\n\nexport type BlockedOverlayFocusRestoreState = {\n  status: \"blocked\";\n  overlay: OverlayStackEntry;\n  blockedBy: Component;\n  resume: OverlayBlockedFocusResume;\n};\n\nexport type ActiveOverlayFocusRestoreState = EligibleOverlayFocusRestoreState | BlockedOverlayFocusRestoreState;\n\nexport type OverlayFocusRestoreState = { status: \"inactive\" } | ActiveOverlayFocusRestoreState;\n\nexport type OverlayFocusRestorePolicy = \"clear\" | \"preserve\";\n"]}