@linxiraos/pi-tui 1.1.27 → 1.2.0

package/README.md

@@ -66,14 +66,16 @@ interface Component {
 	render(width: number): readonly string[];
 	handleInput?(data: string): void;
 	invalidate?(): void;
+	releaseRenderCaches?(): void;
 }
 ```
 
-| Method               | Description                                                                                                                                                        |
-| -------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
-| `render(width)`      | Returns an array of strings, one per line. Each line **must not exceed `width`** or the TUI will error. Use `truncateToWidth()` or manual wrapping to ensure this. The result is component-owned and immutable to callers; return the same array reference when unchanged (enables renderer memoization) and a new array when content changed. |
-| `handleInput?(data)` | Called when the component has focus and receives keyboard input. The `data` string contains raw terminal input (may include ANSI escape sequences).                |
-| `invalidate?()`      | Called to clear any cached render state. Components should re-render from scratch on the next `render()` call.                                                     |
+| Method                   | Description                                                                                                                                                        |
+| ------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
+| `render(width)`          | Returns an array of strings, one per line. Each line **must not exceed `width`** or the TUI will error. Use `truncateToWidth()` or manual wrapping to ensure this. The result is component-owned and immutable to callers; return the same array reference when unchanged (enables renderer memoization) and a new array when content changed. |
+| `handleInput?(data)`     | Called when the component has focus and receives keyboard input. The `data` string contains raw terminal input (may include ANSI escape sequences).                |
+| `invalidate?()`          | Called to clear any cached render state. Components should re-render from scratch on the next `render()` call.                                                     |
+| `releaseRenderCaches?()` | Drops only derived render caches. The next `render()` must return the same rows without eager rebuilds, renderer callbacks, image conversions, or child replacement. |
 
 ## Built-in Components
 

package/dist/types/app-keybindings.d.ts

@@ -119,7 +119,7 @@ export declare const KEYBINDINGS: {
         readonly description: "Delete word backward";
     };
     readonly "tui.editor.deleteWordForward": {
-        readonly defaultKeys: ["alt+delete", "alt+d", "super+alt+delete", "super+alt+d"];
+        readonly defaultKeys: ["alt+delete", "alt+d", "ctrl+delete", "super+alt+delete", "super+alt+d"];
         readonly description: "Delete word forward";
     };
     readonly "tui.editor.deleteToLineStart": {

package/dist/types/apps/cleanse-board.d.ts

@@ -25,7 +25,7 @@ export interface CleanseAgentOutcome {
     error?: string;
     resolvedModel?: string;
 }
-/** Rendering surface for one `omp cleanse` run. */
+/** Rendering surface for one `zetacode cleanse` run. */
 export interface CleanseStatusBoard {
     readonly interactive: boolean;
     /** Print a permanent line above the live area (plain write when non-TTY). */

package/dist/types/apps/debug/log-viewer.d.ts

@@ -15,6 +15,8 @@ type DebugLogViewerModelOptions = {
     processPid?: number;
     hasOlderLogs?: () => boolean;
     loadOlderLogs?: (limitDays?: number) => Promise<string>;
+    /** Most entries kept; older history beyond it is not loaded. Defaults to {@link MAX_LOG_ENTRIES}. */
+    maxLogEntries?: number;
 };
 type ViewerRow = {
     kind: "warning";
@@ -33,6 +35,8 @@ export declare class DebugLogViewerModel {
     #private;
     constructor(logText: string, options?: DebugLogViewerModelOptions);
     get logCount(): number;
+    /** True once the entry cap is reached, so older history no longer loads. */
+    get historyLimitReached(): boolean;
     get visibleLogCount(): number;
     get rows(): readonly ViewerRow[];
     get cursorRowIndex(): number | undefined;

package/dist/types/apps/debug/raw-sse-buffer.d.ts

@@ -41,6 +41,8 @@ export declare function rawSseRecordLines(record: RawSseDebugRecord): string[];
 /** Bounded, observable capture of raw provider responses and SSE frames. */
 export declare class RawSseDebugBuffer {
     #private;
+    /** Bumped on every change to the captured window (append, eviction, clear); equal revisions mean equal snapshots. */
+    get revision(): number;
     subscribe(listener: () => void): () => void;
     recordResponse(response: ProviderResponseMetadata, model?: Model): void;
     recordEvent(event: RawSseEvent, model?: Model): void;

package/dist/types/apps/git/git-tui.d.ts

@@ -1,5 +1,5 @@
 /**
- * `omp git` — fullscreen repository TUI.
+ * `zetacode git` — fullscreen repository TUI.
  *
  * Layout: header (file path, encoding, stage-file button, close), toolbar
  * (scope chip, file/diff toggle, hunk navigation, hunk/inline/split view
@@ -63,5 +63,5 @@ export interface GitTuiHost {
  * slash command). Resolves when the user closes it; the caller restores focus.
  */
 export declare function showGitOverlay(ui: TUI, host: GitTuiHost): Promise<void>;
-/** Run the fullscreen git TUI standalone (`omp git`) until the user quits. */
+/** Run the fullscreen git TUI standalone (`zetacode git`) until the user quits. */
 export declare function runGitTui(host: GitTuiHost): Promise<void>;

package/dist/types/apps/git/help.d.ts

@@ -1,4 +1,4 @@
-import type { NativeNode } from "../../native/node.js";
+import type { NativeNode, NativeUiEvent } from "../../native/node.js";
 import type { Component } from "../../tui.js";
 /** The shortcuts overlay; any of `?`, escape or `q` closes it. */
 export declare class GitHelpSheet implements Component {
@@ -10,6 +10,8 @@ export declare class GitHelpSheet implements Component {
     };
     constructor(close: () => void);
     handleInput(data: string): void;
+    /** Close runs what Esc runs. */
+    handleNativeEvent(event: NativeUiEvent): void;
     describe(): NativeNode;
     render(width: number): readonly string[];
     invalidate(): void;

package/dist/types/apps/if-bench-board.d.ts

@@ -1,5 +1,5 @@
 /**
- * Live board and scoreboard for `omp if-bench`.
+ * Live board and scoreboard for `zetacode if-bench`.
  *
  * Interactive terminals get one repainted row per model — a turn ladder that
  * fills as turns pass, the in-flight turn as a spinner cell, and the live
@@ -47,7 +47,7 @@ export interface IfBenchObserver<Turn extends IfBenchTurnRecord = IfBenchTurnRec
     turnFinished?(label: string, record: Turn): void;
     modelFinished?(report: Report): void;
 }
-/** Rendering surface for one `omp if-bench` run. */
+/** Rendering surface for one `zetacode if-bench` run. */
 export interface IfBenchBoard extends IfBenchObserver {
     readonly interactive: boolean;
     /** Print a permanent line above the live rows (plain write when non-TTY). */

package/dist/types/apps/setup-model-picker.d.ts

@@ -1,5 +1,5 @@
 /**
- * Standalone TUI model picker used by `omp setup speech`.
+ * Standalone TUI model picker used by `zetacode setup speech`.
  *
  * One-shot {@link selectStandaloneItem} prompt: resolve on select/cancel and
  * let the adapter tear the UI down. The standalone TUI auto-renders on input,

package/dist/types/autocomplete.d.ts

@@ -77,8 +77,11 @@ export interface AutocompleteProvider {
     };
     /** Get inline hint text to show as dim ghost text after the cursor */
     getInlineHint?(lines: string[], cursorLine: number, cursorCol: number): string | null;
-    /** Synchronously try to complete a slash command at the start of a line (no async I/O). */
-    /** Returns matched items and the full prefix, or null if not applicable. */
+    /**
+     * Synchronously list slash command-name completions for a leading slash token (no async I/O).
+     * Mirrors the command-name branch of {@link getSuggestions}, including the bare `/` listing and
+     * the collapsed `/skill:` namespace row. Returns null outside a command-name token or with no match.
+     */
     trySyncSlashCompletion?(textBeforeCursor: string): {
         items: AutocompleteItem[];
         prefix: string;