@linxiraos/pi-tui 1.1.26 → 1.2.0

package/src/components/editor.d.ts

@@ -1,5 +1,5 @@
 import { type AutocompleteProvider } from "../autocomplete";
-import type { TspEditorDecoration, TspTone } from "@linxiraos/pi-wire";
+import type { TspEditorDecoration, TspText, TspTone } from "@linxiraos/pi-wire";
 import { type DescribeContext, type NativeChild, type NativeNode, type NativeTextEdit, type NativeUiEvent } from "../native/node";
 import type { SymbolTheme } from "../symbols";
 import { type Component, type Focusable } from "../tui";
@@ -106,8 +106,11 @@ export declare class Editor implements Component, Focusable {
      * dialog's text field; only the prompt composer claims `zeta.editor`).
      */
     describeLayout: ((input: NativeNode, cx: DescribeContext) => NativeEditorLayout) | undefined;
-    /** TSP placeholder for the empty buffer; natively it replaces the rotating ANSI {@link placeholder} hints. */
-    describePlaceholder: (() => string) | undefined;
+    /**
+     * TSP placeholder for the empty buffer; natively it replaces the rotating ANSI {@link placeholder} hints.
+     * Return a stable value (the same spans array) while it is unchanged: the editor node is reused by identity.
+     */
+    describePlaceholder: (() => TspText) | undefined;
     /** Called with the selected text when Visual mode yanks, so hosts can reach the system
      *  clipboard — `packages/tui` deliberately has no clipboard dependency of its own. */
     onYank?: (text: string) => void;
@@ -138,11 +141,20 @@ export declare class Editor implements Component, Focusable {
     onLargePaste?: (text: string, lineCount: number, options: PasteOptions) => boolean;
     onAutocompleteCancel?: () => void;
     disableSubmit: boolean;
+    /** Base editors accept native edits, not atomic sends. Implementations that
+     *  handle `send` override this readiness check for their submission path. */
+    protected get nativeSendable(): boolean;
     /** Placeholder painted right-aligned on the cursor row while the editor is empty and no
      *  autocomplete is open; hidden when it can't keep {@link PLACEHOLDER_MIN_GAP} cells from the
      *  cursor. The host styles it (ANSI allowed). Re-evaluated on every render, so hosts can derive
      *  it from live state. */
     placeholder?: () => string | undefined;
+    /** Whole-message prediction for the next prompt, painted as ghost text after the cursor while
+     *  the single-line buffer is a strict prefix of it, the cursor sits at its end, and no
+     *  autocomplete is open. A shown prediction replaces the {@link placeholder}; Tab or Right inserts
+     *  the rest without submitting. Must be a single line. Re-evaluated on every render, so hosts can
+     *  derive it from live state. */
+    prediction?: () => string | undefined;
     constructor(theme: EditorTheme);
     /** Return bounded editor content, cursor, and transient child state for debug inspection. */
     debugState(): Record<string, unknown>;
@@ -247,6 +259,8 @@ export declare class Editor implements Component, Focusable {
     get atoms(): ReadonlyMap<string, string>;
     /** Monotonic buffer-content revision for render caches. Cursor-only movement does not advance it. */
     get textRevision(): number;
+    /** Monotonic atom-table revision for render caches: advances whenever {@link atoms} is mutated or replaced. */
+    get atomsRevision(): number;
     /** Whether the buffer text equals `value`, without `getText()`'s full join —
      *  O(1) for the hot per-keystroke probes against short single-line values. */
     textEquals(value: string): boolean;
@@ -282,7 +296,7 @@ export declare class Editor implements Component, Focusable {
      *  Mirrors the transient state the key dispatch tears down before this action so the two
      *  cannot diverge: a pending character jump is cancelled by any other key, and an open
      *  spelling-assist popup is dismissed by anything that is not one of its accept keys (its
-     *  debounced refresh skips assist mode, so a surviving list would hang around forever).
+     *  refresh skips assist mode, so a surviving list would hang around forever).
      *  While Vim owns the buffer (Normal or Visual) the operation is Vim's `x` — deleting the
      *  selection and returning to Normal in Visual mode, the grapheme under the cursor
      *  otherwise. Only Insert mode and Vim-off editors delete straight through. */
@@ -296,7 +310,7 @@ export declare class Editor implements Component, Focusable {
     submit(): void;
     /** Insert text at the current cursor position */
     insertText(text: string): void;
-    /** Terminal-side selection edits on the `editor` node (see {@link applyHostEdit}). */
+    /** Terminal-side selection edits and undo on the `editor` node (see {@link applyHostEdit}). */
     handleNativeEvent(event: NativeUiEvent): void;
     /**
      * Apply an edit the terminal made over its own selection (TSP `edit`):
@@ -327,6 +341,10 @@ export declare class Editor implements Component, Focusable {
      *  {@link getExpandedText}). Hosts that intercept large pastes through {@link onLargePaste} use
      *  this to re-insert a (possibly transformed) paste without re-triggering the interception hook. */
     insertPaste(content: string): void;
+    /** Whether a character-jump hotkey is waiting for its target character. */
+    get isJumpPending(): boolean;
+    /** Type literal text through the character-editing pipeline without keybinding dispatch. */
+    typeCharacter(text: string): void;
     /**
      * Whether an autocomplete popup is on screen. An `@` list narrowed to no match
      * while its refresh is pending stays open internally but is hidden, so it does