@linxiraos/pi-tui 1.2.1 → 1.3.0

package/dist/types/tui.d.ts

@@ -115,9 +115,6 @@ export interface Component {
      * last time.
      */
     render(width: number): readonly string[];
-    /** Inline decision panels must keep displaced settled transcript rows in
-     * native scrollback even when mounted inside a transient editor container. */
-    readonly retireDisplacedTranscript?: boolean;
     /**
      * Describe the component semantically for a Tern Surface Protocol
      * terminal (see `native/node.ts`). Called instead of `render()` when the
@@ -351,6 +348,7 @@ export declare class TUI extends Container {
     overlayStack: {
         component: Component;
         options?: OverlayOptions;
+        /** Focus restored after closing; tracks live focus changes beneath an input-less key holder. */
         preFocus: Component | null;
         hidden: boolean;
         /**
@@ -458,6 +456,16 @@ export declare class TUI extends Container {
         top: number;
         length: number;
     };
+    /**
+     * Rows of native history the last paint left on screen above a mutable
+     * viewport that reached the bottom row, or `undefined` when that paint left
+     * rows free below it (or none happened, or a destructive reset will repaint
+     * from row zero). Rows above a bottom-reaching viewport may already sit in
+     * native scrollback, which a later shrink cannot pull back down.
+     */
+    getFilledHistoryRows(): number | undefined;
+    /** Whether native history holds rows the frame provider committed since the last destructive reset. */
+    hasProviderHistory(): boolean;
     /**
      * Probe for opt-in normal-buffer click capture. The provider is read every
      * frame; while it returns true (and no fullscreen overlay owns the
@@ -507,6 +515,13 @@ export declare class TUI extends Container {
      * overtaking them. No-op unless `previous` owns the held keys.
      */
     replaceHeldFocus(previous: Component, next: Component): void;
+    /**
+     * Register a hook that re-enables terminal modes on every start(). A hook
+     * added while the TUI is already running (a prepaint composer starts it
+     * before the interactive mode wires its controllers) missed that start, so
+     * it runs immediately instead of waiting for a stop/start cycle that may
+     * never come.
+     */
     addStartListener(listener: StartListener): () => void;
     addInputListener(listener: InputListener): () => void;
     removeInputListener(listener: InputListener): void;
@@ -519,6 +534,8 @@ export declare class TUI extends Container {
      */
     resetDisplay(): void;
     requestRender(force?: boolean, options?: RenderRequestOptions): void;
+    /** Run `callback` after `delayMs` on the render scheduler's clock, unless the TUI has stopped. */
+    scheduleAfter(delayMs: number, callback: () => void): RenderTimer;
     /**
      * Paint a forced frame synchronously when startup must hand off an already
      * visible component tree before further async initialization. Same as

package/package.json

@@ -1,7 +1,7 @@
 {
 	"type": "module",
 	"name": "@linxiraos/pi-tui",
-	"version": "1.2.1",
+	"version": "1.3.0",
 	"description": "Terminal User Interface library with differential rendering for efficient text-based applications",
 	"homepage": "https://linxira-os.github.io/zeta/",
 	"author": "Linxira-OS",
@@ -30,7 +30,7 @@
 	"types": "./dist/types/index.d.ts",
 	"scripts": {
 		"check": "oxlint . && oxfmt --check --no-error-on-unmatched-pattern 'src/**/*.{ts,tsx}' '{test,bench,examples,scripts}/**/*.ts' '*.ts' && bun run check:types",
-		"check:types": "tsgo -p tsconfig.json --noEmit",
+		"check:types": "tsc -p tsconfig.json --noEmit",
 		"lint": "oxlint .",
 		"test": "bun test --parallel test/*.test.ts",
 		"fix": "oxlint --fix --fix-suggestions . && bun run fmt",
@@ -38,14 +38,14 @@
 		"gen:glyphs": "bun scripts/gen-glyphs.ts"
 	},
 	"dependencies": {
-		"@linxiraos/pi-omptype": "1.2.1",
-		"@linxiraos/pi-agent-core": "1.2.1",
-		"@linxiraos/pi-ai": "1.2.1",
-		"@linxiraos/pi-catalog": "1.2.1",
-		"@linxiraos/pi-natives": "1.2.1",
-		"@linxiraos/pi-utils": "1.2.1",
-		"@linxiraos/pi-wire": "1.2.1",
-		"@linxiraos/pi-snapcompact": "1.2.1"
+		"@linxiraos/pi-omptype": "1.3.0",
+		"@linxiraos/pi-agent-core": "1.3.0",
+		"@linxiraos/pi-ai": "1.3.0",
+		"@linxiraos/pi-catalog": "1.3.0",
+		"@linxiraos/pi-natives": "1.3.0",
+		"@linxiraos/pi-utils": "1.3.0",
+		"@linxiraos/pi-wire": "1.3.0",
+		"@linxiraos/pi-snapcompact": "1.3.0"
 	},
 	"devDependencies": {
 		"kitty-vt-wasm": "^0.2.0"

package/src/app-keybindings.d.ts

@@ -17,6 +17,8 @@ interface AppKeybindings {
     "app.model.selectTemporary": true;
     "app.tools.expand": true;
     "app.tools.toggleVisibility": true;
+    "app.ask.hide": true;
+    "app.approval.approve": true;
     "app.editor.external": true;
     "app.message.followUp": true;
     "app.retry": true;
@@ -36,8 +38,8 @@ interface AppKeybindings {
     "app.session.rename": true;
     "app.session.delete": true;
     "app.session.deleteNoninvasive": true;
-    "app.tree.foldOrUp": true;
-    "app.tree.unfoldOrDown": true;
+    "app.tree.previousBranch": true;
+    "app.tree.nextBranch": true;
     "app.plan.toggle": true;
     "app.history.search": true;
     "app.stt.pushToTalk": true;
@@ -238,6 +240,14 @@ export declare const KEYBINDINGS: {
         readonly defaultKeys: "ctrl+shift+o";
         readonly description: "Show or hide tool activity";
     };
+    readonly "app.ask.hide": {
+        readonly defaultKeys: "alt+h";
+        readonly description: "Hide or show a pending ask dialog";
+    };
+    readonly "app.approval.approve": {
+        readonly defaultKeys: ["ctrl+enter", "ctrl+q"];
+        readonly description: "Approve a pending tool call";
+    };
     readonly "app.editor.external": {
         readonly defaultKeys: "ctrl+g";
         readonly description: "Open external editor";
@@ -314,13 +324,13 @@ export declare const KEYBINDINGS: {
         readonly defaultKeys: "ctrl+backspace";
         readonly description: "Delete session (non-invasive)";
     };
-    readonly "app.tree.foldOrUp": {
-        readonly defaultKeys: ["ctrl+left", "alt+left"];
-        readonly description: "Fold or move up";
+    readonly "app.tree.previousBranch": {
+        readonly defaultKeys: [];
+        readonly description: "Jump to the previous branch in /tree";
     };
-    readonly "app.tree.unfoldOrDown": {
-        readonly defaultKeys: ["ctrl+right", "alt+right"];
-        readonly description: "Unfold or move down";
+    readonly "app.tree.nextBranch": {
+        readonly defaultKeys: [];
+        readonly description: "Jump to the next branch in /tree";
     };
     readonly "app.plan.toggle": {
         readonly defaultKeys: "alt+shift+p";

package/src/app-keybindings.ts

@@ -37,6 +37,8 @@ interface AppKeybindings {
 	"app.model.selectTemporary": true;
 	"app.tools.expand": true;
 	"app.tools.toggleVisibility": true;
+	"app.ask.hide": true;
+	"app.approval.approve": true;
 	"app.editor.external": true;
 	"app.message.followUp": true;
 	"app.retry": true;
@@ -56,8 +58,8 @@ interface AppKeybindings {
 	"app.session.rename": true;
 	"app.session.delete": true;
 	"app.session.deleteNoninvasive": true;
-	"app.tree.foldOrUp": true;
-	"app.tree.unfoldOrDown": true;
+	"app.tree.previousBranch": true;
+	"app.tree.nextBranch": true;
 	"app.plan.toggle": true;
 	"app.history.search": true;
 	"app.stt.pushToTalk": true;
@@ -138,6 +140,16 @@ export const KEYBINDINGS = {
 		defaultKeys: "ctrl+shift+o",
 		description: "Show or hide tool activity",
 	},
+	"app.ask.hide": {
+		defaultKeys: "alt+h",
+		description: "Hide or show a pending ask dialog",
+	},
+	"app.approval.approve": {
+		// A chord, not Enter: an Enter typed for the composer as the prompt appears must not approve.
+		// Ctrl+Q backs up Ctrl+Enter, which Windows Terminal cannot deliver (#1903).
+		defaultKeys: ["ctrl+enter", "ctrl+q"],
+		description: "Approve a pending tool call",
+	},
 	"app.editor.external": {
 		defaultKeys: "ctrl+g",
 		description: "Open external editor",
@@ -222,13 +234,13 @@ export const KEYBINDINGS = {
 		defaultKeys: "ctrl+backspace",
 		description: "Delete session (non-invasive)",
 	},
-	"app.tree.foldOrUp": {
-		defaultKeys: ["ctrl+left", "alt+left"],
-		description: "Fold or move up",
+	"app.tree.previousBranch": {
+		defaultKeys: [],
+		description: "Jump to the previous branch in /tree",
 	},
-	"app.tree.unfoldOrDown": {
-		defaultKeys: ["ctrl+right", "alt+right"],
-		description: "Unfold or move down",
+	"app.tree.nextBranch": {
+		defaultKeys: [],
+		description: "Jump to the next branch in /tree",
 	},
 	"app.plan.toggle": {
 		defaultKeys: "alt+shift+p",