@aragon-agent/cli 0.6.47 → 0.6.48

package/dist/ui/PromptInput.d.ts

@@ -1,192 +0,0 @@
-/**
- * PromptInput (spec §3.6 / §3.10) — a controlled multiline input on Ink's
- * `useInput` with: full line editing (Home/End, word jump/delete, kill-line via
- * `input/keymap`), multi-line vertical cursor navigation, prompt-history recall
- * at the edges, a slash-command palette, and `@file` path completion.
- *
- * The buffer/cursor transforms (`applyEdit`, `moveVertical`) and the suggestion
- * computations (`slashSuggestions`, `fileTokenAt`) are pure module functions,
- * exported for `input.test.ts`, so the component itself stays thin.
- *
- * THE EDITOR'S FIVE PIECES OF STATE LIVE IN ONE REDUCER, and every branch of the
- * input handler performs AT MOST ONE `dispatch` (tui-input-flicker-fix §3.4).
- * Ink mounts a LEGACY React root, where `setState` outside a React event handler
- * is not batched — and `useInput` runs from a stdin `'data'` listener, which is
- * outside React entirely. The five `setState` calls one keystroke used to make
- * were five commits, five whole-tree Yoga layouts and, through Ink's 32 ms
- * leading+trailing throttle, two full-frame repaints per character. `fileMatches`
- * stays a plain `useState` because it is written from the debounced glob effect
- * rather than from a key.
- */
-import React from 'react';
-import type { Theme } from './theme.js';
-import type { TermCapabilities } from './capabilities.js';
-import { pickGlyphs } from './glyphs.js';
-import { type EditIntent } from '../input/keymap.js';
-import { type Suggestion } from './AutocompletePopup.js';
-import { type EditorState, type InputSegment } from './editor-reducer.js';
-import { type ComposerSubmitResult } from './composer-input.js';
-import type { AgentMode } from '../agent/agent-mode.js';
-export interface CommandOption {
-    name: string;
-    description: string;
-}
-interface PromptInputProps {
-    cols?: number;
-    terminalRows?: number;
-    statusExpanded?: boolean;
-    cursorVisible?: boolean;
-    onInteraction?: () => void;
-    isActive: boolean;
-    running: boolean;
-    history: string[];
-    commands: CommandOption[];
-    cwd: string;
-    theme: Theme;
-    caps: TermCapabilities;
-    /**
-     * Row budget for the completion popup (§5.2 / R-14).
-     *
-     * The popup shares the scrolling footer with the editor. Its height budget
-     * reserves visible message rows without changing the viewport or TODO rail.
-     */
-    popupMaxRows?: number;
-    /** Total menu rows, including borders and the overflow hint. */
-    popupMaxHeight?: number;
-    onPopupRowsChange?: (rows: number) => void;
-    onCompletionContextChange?: (context: 'none' | 'slash' | 'file') => void;
-    /** True only when the stdin filter normalized DEL before Ink parsed it. */
-    deleteDisambiguated?: boolean;
-    onSubmit: (text: string) => ComposerSubmitResult;
-    onHelp?: () => void;
-    onEscape?: () => void;
-    onEscapeDismiss?: () => void;
-    reducedMotion?: boolean;
-    /**
-     * Mirror of the session mode. Read for the placeholder only — the toggle
-     * itself belongs to `App`, and this component's job is to get out of its way
-     * (see the first statement of the input handler).
-     */
-    agentMode?: AgentMode;
-    borderColor?: string;
-    /**
-     * Fires when the draft flips empty ⇄ non-empty (for the border color) OR when
-     * its ROW COUNT changes (for `layout/budget.ts`) — never per keystroke.
-     *
-     * Widened from `(hasDraft: boolean)` by tui-paste-handling section 5.5. The row
-     * count is what makes I-8 true: the composer's rendered height and the
-     * `draftRows` handed to `viewportRows` have to be the same number, and the only
-     * component that knows the first one is this one. It is reported ALREADY
-     * CLAMPED, so a 218-line draft and a 400-line draft report the same value and
-     * the transcript stops moving once the composer is full (R-12).
-     */
-    onDraftChange?: (state: {
-        hasDraft: boolean;
-        rows: number;
-    }) => void;
-    /**
-     * Tell the user a paste was refused (D-11 / P1-4).
-     *
-     * `PASTE_DRAFT_MAX_BYTES` and `PASTE_MAX_BLOCKS` cannot be enforced in the
-     * filter (it does not know the draft) and cannot be enforced in the reducer (it
-     * is pure, so it can neither raise a toast nor say why it refused). This
-     * component is the only place that holds both facts.
-     */
-    onNotice?: (level: 'warn' | 'error', text: string) => void;
-    /**
-     * App-owned draft clearing (ctrl-c-clear-draft-exit): the second
-     * Ctrl+C of the armed ladder asks the editor to drop the draft. A
-     * NUMBER, not a boolean, so repeated requests stay distinguishable
-     * and the effect below never re-fires for an unchanged value.
-     * `'clear'` returns the editor to INITIAL_EDITOR_STATE, releasing
-     * paste payloads with it.
-     */
-    draftClearNonce?: number;
-    /**
-     * App-owned ONE-SHOT fill (quick-prompt-library D-6 / §4.6).
-     *
-     * The payload-carrying sibling of `draftClearNonce`: `{ nonce, text, submit }`, with
-     * the same monotonic-nonce discipline, because a nonce is the only thing that makes
-     * an effect idempotent under StrictMode and re-renders (I-8). It is applied through
-     * `transact`, NOT by dispatching and calling `onSubmit` here: the composer has
-     * exactly one submission path and a fill must not become the second one (P0-1 / I-9).
-     */
-    draftFill?: DraftFill;
-    /** `prompts.insertMode`: what a fill does to a draft that already has text. */
-    insertMode?: 'insert' | 'replace';
-    scrolledLines?: number;
-}
-/** A one-shot "put this text in the draft" payload (quick-prompt-library §4.6). */
-export interface DraftFill {
-    /** Monotonic; the same value is applied at most once. */
-    nonce: number;
-    text: string;
-    /** `true` = apply and submit in ONE transaction (the picker's `Ctrl+Enter`). */
-    submit?: boolean;
-}
-export interface ScrollChip {
-    text: string;
-    /** FIXED width, so the number gaining a digit cannot re-wrap the draft (P2-4). */
-    cells: number;
-}
-/**
- * Build the chip, or `null` when the viewport is pinned to the newest output.
- *
- * Every glyph comes from `pickGlyphs` and none from a literal (I-5): on a legacy
- * console this renders `v12` rather than mojibake, and `glyphs.test.ts`'s static
- * scan fails the build if that rule is broken here.
- */
-export declare function scrollChip(scrolledLines: number, cols: number, glyphs: ReturnType<typeof pickGlyphs>): ScrollChip | null;
-export interface OverflowChip {
-    text: string;
-    /** FIXED width, so a number gaining a digit cannot re-wrap the draft. */
-    cells: number;
-}
-/**
- * Build the "there is more draft above / below this window" indicator, or `null`
- * when the whole draft is on screen.
- *
- * Every glyph comes from `pickGlyphs` and none from a literal (I-5): on a legacy
- * console this renders `^3 v7` rather than mojibake, and `glyphs.test.ts`'s
- * static scan fails the build if that rule is broken here.
- */
-export declare function overflowChip(hiddenAbove: number, hiddenBelow: number, glyphs: ReturnType<typeof pickGlyphs>): OverflowChip | null;
-/**
- * Would these segments push the draft past a limit? Returns the refusal text, or
- * `null` when the paste is allowed.
- *
- * Checked BEFORE `dispatch`, so a refusal dispatches nothing at all and the draft
- * is left byte-for-byte unchanged (AC-9). The one-dispatch-per-key rule is
- * unaffected for the same reason.
- */
-export declare function draftLimitRefusal(segments: InputSegment[], editor: Pick<EditorState, 'pastes'>): string | null;
-/** Apply an edit intent as a pure buffer/cursor transform. */
-export declare function applyEdit(buffer: string, cursor: number, intent: EditIntent): {
-    buffer: string;
-    cursor: number;
-};
-/**
- * Move the cursor up/down one line preserving the column. Returns `null` at the
- * top/bottom edge (or for a single-line buffer) so the caller can fall back to
- * prompt-history recall.
- */
-export declare function moveVertical(buffer: string, cursor: number, dir: 'up' | 'down'): {
-    cursor: number;
-} | null;
-/**
- * Slash-command suggestions when the buffer is a bare `/word` (no space yet).
- *
- * The character class covers `-` and `:` as well as `\w` (D16). Skill names are
- * kebab-case and the namespaced fallback is `/skill:<name>`; with the original
- * `^\/(\w*)$` a user typing `/my-sk` got NO popup at all — not an error message,
- * just silence, which reads as "that command does not exist".
- */
-export declare function slashSuggestions(buffer: string, commands: CommandOption[]): Suggestion[] | null;
-/** The `@file` token under the cursor (`@` + non-space run), if any. */
-export declare function fileTokenAt(buffer: string, cursor: number): {
-    start: number;
-    end: number;
-    query: string;
-} | null;
-export declare function PromptInput({ cols: colsProp, terminalRows: terminalRowsProp, statusExpanded, cursorVisible, onInteraction, isActive, running, history, commands, cwd, theme, caps, popupMaxRows, popupMaxHeight, onPopupRowsChange, onCompletionContextChange, deleteDisambiguated, agentMode, onSubmit, onHelp, onEscape, onEscapeDismiss, reducedMotion, borderColor, onDraftChange, draftClearNonce, draftFill, insertMode, onNotice, }: PromptInputProps): React.ReactElement;
-export {};