@linxiraos/pi-tui 1.1.27 → 1.2.1

package/dist/types/tools/task.d.ts

@@ -107,8 +107,6 @@ export interface TaskItem {
     solutionSpace?: string;
     /** Per-spawn thinking effort: lowest/middle/highest level the resolved model supports. Overrides the agent's default selector (e.g. `auto`). */
     effort?: "lo" | "med" | "hi";
-    /** Per-spawn model selector or ordered selector array; overrides agent and settings preferences. */
-    model?: string | string[];
     /** Caller-provided output schema; its presence overrides the selected agent's schema. */
     outputSchema?: unknown;
     /** Validation behavior for a caller-provided or inherited output schema. */
@@ -135,8 +133,6 @@ export interface TaskParams {
     solutionSpace?: string;
     /** Per-spawn thinking effort (flat form): lowest/middle/highest level the resolved model supports. */
     effort?: "lo" | "med" | "hi";
-    /** Per-spawn model selector or ordered selector array; overrides agent and settings preferences. */
-    model?: string | string[];
     /** Caller-provided output schema; its presence overrides the selected agent's schema. */
     outputSchema?: unknown;
     /** Validation behavior for a caller-provided or inherited output schema. */

package/dist/types/tools/write.d.ts

@@ -6,7 +6,7 @@ import { type ProcWriteDetails } from "./proc-render.js";
 import { type CfgWriteDetails } from "./cfg-render.js";
 import type { FileDiagnosticsResult } from "./lsp.js";
 import type { OutputMeta } from "./output-meta.js";
-import type { NativeToolView, RenderResultOptions, ToolActivityContext, ToolActivitySummary } from "./renderer.js";
+import type { NativeToolView, RenderResultOptions, ToolActivityContext, ToolActivitySummary, ToolFigure } from "./renderer.js";
 import { type XdevRenderDispatch, type XdevMountedRenderer } from "./xdev.js";
 /** Details returned by the write tool for transcript rendering. */
 export interface WriteToolDetails {
@@ -37,6 +37,12 @@ interface WriteResult {
     details?: WriteToolDetails;
     isError?: boolean;
 }
+/**
+ * The fence a file write draws as while its content streams and after: its
+ * extension names a figure language and it has content, closed once the args
+ * are final. None for URL-card writes, or after an error.
+ */
+declare function writeFigure(args: WriteRenderArgs | undefined, result: WriteResult | undefined, options: RenderResultOptions): ToolFigure | undefined;
 declare const writeStreamingPreviewStateKey: unique symbol;
 /**
  * Per-component state for incrementally rendering a streamed write.
@@ -75,7 +81,7 @@ export declare const writeToolRenderer: {
     renderCall(args: WriteRenderArgs, options: RenderResultOptions & WriteStreamingPreviewStateCarrier & {
         renderContext?: WriteRenderContext;
     }, uiTheme: Theme): Component | undefined;
-    renderResult(result: WriteResult, options: RenderResultOptions & {
+    renderResult(result: WriteResult, options: RenderResultOptions & WriteStreamingPreviewStateCarrier & {
         renderContext?: WriteRenderContext;
     }, uiTheme: Theme, args?: WriteRenderArgs): Component;
     describeCall(args: WriteRenderArgs, options: RenderResultOptions & {
@@ -84,6 +90,7 @@ export declare const writeToolRenderer: {
     describeResult(result: WriteResult, options: RenderResultOptions & {
         renderContext?: WriteRenderContext;
     }, args?: WriteRenderArgs): NativeToolView | undefined;
+    figure: typeof writeFigure;
     mergeCallAndResult: true;
     forceFirstResultViewportRepaint: (args: unknown, options: RenderResultOptions) => boolean;
 };

package/dist/types/tools/yield.d.ts

@@ -0,0 +1,22 @@
+import type { Theme } from "../theme/theme.js";
+import type { Component } from "../tui.js";
+import type { NativeToolView, RenderResultContextOptions, RenderResultOptions, ToolRenderResult } from "./renderer.js";
+import type { YieldItem } from "./task.js";
+/** `yield` arguments as sent; strict-mode providers send omitted optionals as `null`. */
+interface YieldRenderArgs {
+    type?: string | string[] | null;
+    data?: unknown;
+    error?: string | null;
+    /** 1-based workpool item number. */
+    key?: number;
+}
+/** Shows a `yield` call's submitted data instead of its model-facing acknowledgement. */
+export declare const yieldToolRenderer: {
+    renderCall(args: YieldRenderArgs, options: RenderResultOptions, theme: Theme): Component;
+    renderResult(result: ToolRenderResult<YieldItem>, options: RenderResultContextOptions, theme: Theme, args?: YieldRenderArgs): Component;
+    describeCall(args: YieldRenderArgs, options: RenderResultOptions): NativeToolView;
+    describeResult(result: ToolRenderResult<YieldItem>, _options: RenderResultContextOptions, args?: YieldRenderArgs): NativeToolView;
+    mergeCallAndResult: true;
+    animatedPendingPreview: true;
+};
+export {};

package/dist/types/tui.d.ts

@@ -78,6 +78,10 @@ export interface TUIStartOptions {
      * Paint without owning stdin: the terminal stays in cooked mode (kernel
      * echo + line editing at the hardware cursor) until {@link TUI.enableInput}
      * switches to raw input and replays the kernel-buffered keystrokes.
+     *
+     * A terminal expected to speak TSP needs raw input from the start, so it
+     * gets it; its keystrokes are held instead (TSP events and the cell-size
+     * reply still apply) until {@link TUI.releaseHeldInput} replays them.
      */
     deferInput?: boolean;
 }
@@ -169,6 +173,16 @@ export interface Component {
      * Called when theme changes or when component needs to re-render from scratch.
      */
     invalidate?(): void;
+    /**
+     * Optional hook to drop memoized render output (rows, parse and wrap state)
+     * that the next `render()` can rebuild from state the component keeps.
+     * Unlike {@link invalidate}, it must not rebuild anything eagerly: no
+     * renderer or extension callbacks, no image conversions, and no child
+     * replacement or disposal. The next render must return the same rows it
+     * would have returned without the release. Components without it are
+     * simply not released.
+     */
+    releaseRenderCaches?(): void;
     /**
      * Optional hook to set whether this component ignores tight layout mode.
      */
@@ -308,6 +322,7 @@ export declare class Container implements Component {
     /** Dispose every child, then detach it from this container. */
     disposeChildren(): void;
     invalidate(): void;
+    releaseRenderCaches(): void;
     /**
      * Propagate teardown to children. Call when the container's children are
      * being permanently discarded (not when they are detached for reuse — use
@@ -476,6 +491,22 @@ export declare class TUI extends Container {
      * path. Idempotent; no-op when input was never deferred.
      */
     enableInput(): void;
+    /**
+     * Replay the keystrokes held since a TSP `deferInput` start through the
+     * normal input path, then deliver input live. Call once the app's key
+     * handlers are installed so a hotkey pressed during startup still fires.
+     * Only keys typed while the start-time focus owner had focus are held. The
+     * hold survives a stop/start until released. Idempotent; no-op when nothing
+     * is held.
+     */
+    releaseHeldInput(): void;
+    /**
+     * Hand held-key ownership from `previous` to `next` when the app replaces
+     * the component focused at start (a swapped-in custom editor), so keys
+     * typed into the replacement stay queued behind the held ones instead of
+     * overtaking them. No-op unless `previous` owns the held keys.
+     */
+    replaceHeldFocus(previous: Component, next: Component): void;
     addStartListener(listener: StartListener): () => void;
     addInputListener(listener: InputListener): () => void;
     removeInputListener(listener: InputListener): void;

package/dist/types/utils.d.ts

@@ -26,6 +26,12 @@ export interface TextSizingOptions {
  */
 export declare function encodeTextSized(text: string, options?: TextSizingOptions): string;
 export declare function sliceWithWidth(line: string, startCol: number, length: number, strict?: boolean | null): SliceResult;
+/**
+ * Hard-wrap one literal terminal row without trimming spaces or splitting graphemes.
+ * An oversized grapheme is emitted intact even when it exceeds the requested width.
+ * Zero-cell rows remain one empty row, matching restored-terminal reflow.
+ */
+export declare function wrapLiteralLine(line: string, width: number): string[];
 export declare function truncateToWidth(text: string, maxWidth: number, ellipsisKind?: Ellipsis | null | "", pad?: boolean | null): string;
 export declare function wrapTextWithAnsi(text: string, width: number): string[];
 export declare function extractSegments(line: string, beforeEnd: number, afterStart: number, afterLen: number, strictAfter: boolean): ExtractSegmentsResult;

package/dist/types/vim.d.ts

@@ -8,8 +8,8 @@
  * This is a usable subset of Vim, not a reimplementation of it (see issue #3299): Normal and Visual
  * modes, the common motions, and operators built from those motions.
  */
-export type VimMode = "insert" | "normal" | "visual" | "visual-line";
-export type VimOperator = "d" | "y" | "c";
+export type VimMode = "insert" | "normal" | "visual" | "visual-line" | "replace";
+export type VimOperator = "d" | "y" | "c" | ">" | "<";
 export interface VimPosition {
     line: number;
     col: number;
@@ -50,6 +50,20 @@ export type VimCommand = {
     count: number;
 } | {
     kind: "undo";
+} | {
+    kind: "replace";
+    from: VimPosition;
+    to: VimPosition;
+    text: string;
+} | {
+    kind: "join";
+    fromLine: number;
+    lines: number;
+} | {
+    kind: "indent";
+    fromLine: number;
+    toLine: number;
+    out: boolean;
 };
 /** Start offset of the grapheme after `col`, clamped to `text.length`. */
 export declare function nextGraphemeStart(text: string, col: number): number;
@@ -62,11 +76,11 @@ export declare class VimState {
     mode: VimMode;
     /** Fixed end of a Visual selection; the cursor is the moving end. */
     anchor: VimPosition | null;
-    /** True while a count, operator, `g`, or text-object prefix is half-typed — Escape cancels it. */
+    /** True while a count, operator, `g`, text-object, find, or `r` prefix is half-typed — Escape cancels it. */
     get pending(): boolean;
     /**
-     * The half-typed command as Vim would echo it (`"2"`, `"d"`, `"2d"`, `"di"`) — empty when
-     * nothing is pending. Hosts render this next to the mode so a partially entered operator is
+     * The half-typed command as Vim would echo it (`"2"`, `"d"`, `"2d"`, `"di"`, `"df"`, `"r"`) — empty
+     * when nothing is pending. Hosts render this next to the mode so a partially entered operator is
      * visible instead of silently swallowing the next keystroke.
      */
     get pendingText(): string;

package/package.json

@@ -1,7 +1,7 @@
 {
 	"type": "module",
 	"name": "@linxiraos/pi-tui",
-	"version": "1.1.27",
+	"version": "1.2.1",
 	"description": "Terminal User Interface library with differential rendering for efficient text-based applications",
 	"homepage": "https://linxira-os.github.io/zeta/",
 	"author": "Linxira-OS",
@@ -38,14 +38,14 @@
 		"gen:glyphs": "bun scripts/gen-glyphs.ts"
 	},
 	"dependencies": {
-		"@linxiraos/pi-omptype": "1.1.27",
-		"@linxiraos/pi-agent-core": "1.1.27",
-		"@linxiraos/pi-ai": "1.1.27",
-		"@linxiraos/pi-catalog": "1.1.27",
-		"@linxiraos/pi-natives": "1.1.27",
-		"@linxiraos/pi-utils": "1.1.27",
-		"@linxiraos/pi-wire": "1.1.27",
-		"@linxiraos/pi-snapcompact": "1.1.27"
+		"@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"
 	},
 	"devDependencies": {
 		"kitty-vt-wasm": "^0.2.0"
@@ -102,6 +102,10 @@
 			"types": "./dist/types/components/*.d.ts",
 			"import": "./src/components/*.ts"
 		},
+		"./native/*": {
+			"types": "./dist/types/native/*.d.ts",
+			"import": "./src/native/*.ts"
+		},
 		"./*.js": "./src/*.ts"
 	}
 }

package/src/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/src/app-keybindings.ts

@@ -2,7 +2,7 @@ import * as fs from "node:fs";
 import * as path from "node:path";
 // Subpaths, not the `@linxiraos/pi-utils` barrel: the barrel loads the native
 // addon (file-lock), and key-hint formatting runs on addon-free CLI paths
-// (`omp --version`, help) through cli/command-help.ts.
+// (`zetacode --version`, help) through cli/command-help.ts.
 import { getActiveProfile, getAgentDir, getProfileRootDir } from "@linxiraos/pi-utils/dirs";
 import { isEnoent } from "@linxiraos/pi-utils/fs-error";
 import * as logger from "@linxiraos/pi-utils/logger";

package/src/apps/autoresearch-dashboard.ts

@@ -17,8 +17,8 @@ import {
 import { formatNum, type ExperimentResult, type ExperimentState } from "../tools/autoresearch";
 import type { TspSpan, TspTableColumn, TspText } from "@linxiraos/pi-wire";
 import { card, col, elapsed, keyed, node, row, span, text } from "../native/describe";
-import type { DescribeContext, NativeNode } from "../native/node";
-import { hintsRow } from "../native/overlay";
+import type { DescribeContext, NativeNode, NativeUiEvent } from "../native/node";
+import { actionBar, actionButton, hintsRow } from "../native/overlay";
 import { Memo } from "../native/memo";
 import { isNativeRendering } from "../native/state";
 
@@ -190,9 +190,9 @@ export function createDashboardController(): DashboardController {
 											{ keys: ["up", "down", "j", "k"], label: "scroll" },
 											{ keys: ["pageUp", "pageDown"], label: "page" },
 											{ keys: ["g", "shift+g"], label: "top/bottom" },
-											{ keys: ["escape"], label: "close" },
 										]),
 									);
+									children.push(actionBar([null, actionButton("Close", "close", { keys: "escape" })]));
 									return col(children, { gap: "md", role: "zeta.app.autoresearch" });
 								},
 							);
@@ -214,6 +214,10 @@ export function createDashboardController(): DashboardController {
 							scrollView.setHeight(viewportRows);
 							return [header, ...scrollView.render(width), renderOverlayFooter(width, theme)];
 						},
+						/** The Close button runs Esc's path. */
+						handleNativeEvent(event: NativeUiEvent): void {
+							if (event.type === "action" && event.act === "close") done(undefined);
+						},
 						handleInput(data: string): void {
 							if (matchesKey(data, "escape") || matchesKey(data, "esc") || data === "q") {
 								done(undefined);

package/src/apps/cleanse-board.ts

@@ -1,5 +1,5 @@
 /**
- * Live status board for `omp cleanse`.
+ * Live status board for `zetacode cleanse`.
  *
  * Interactive terminals get a transient board repainted in place: a phase
  * spinner (model resolution, checker discovery), one row per running checker,
@@ -59,7 +59,7 @@ const REPAIR_BAR_STYLE: ProgressBarStyle = {
 	styleEmpty: text => fgOrPlain("dim", text),
 };
 
-/** 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/src/apps/cleanse-picker.ts

@@ -1,5 +1,5 @@
 /**
- * Standalone TUI pickers for `omp cleanse`.
+ * Standalone TUI pickers for `zetacode cleanse`.
  *
  * One-shot {@link selectStandaloneItem} and {@link promptStandaloneText}
  * prompts, resolved on select/submit/cancel so the command can keep writing