@dexto/tui 1.6.2

package/dist/components/shared/text-buffer.d.ts

@@ -0,0 +1,185 @@
+/**
+ * Text Buffer - Core text editing buffer with visual line wrapping
+ */
+import type { Key } from '../../hooks/useKeypress.js';
+export type Direction = 'left' | 'right' | 'up' | 'down' | 'wordLeft' | 'wordRight' | 'home' | 'end';
+export declare const findNextWordStartInLine: (line: string, col: number) => number | null;
+export declare const findPrevWordStartInLine: (line: string, col: number) => number | null;
+export declare const findWordEndInLine: (line: string, col: number) => number | null;
+export declare const findNextWordAcrossLines: (lines: string[], cursorRow: number, cursorCol: number, searchForWordStart: boolean) => {
+    row: number;
+    col: number;
+} | null;
+export declare const findPrevWordAcrossLines: (lines: string[], cursorRow: number, cursorCol: number) => {
+    row: number;
+    col: number;
+} | null;
+export declare const getPositionFromOffsets: (startOffset: number, endOffset: number, lines: string[]) => {
+    startRow: number;
+    startCol: number;
+    endRow: number;
+    endCol: number;
+};
+export declare const getLineRangeOffsets: (startRow: number, lineCount: number, lines: string[]) => {
+    startOffset: number;
+    endOffset: number;
+};
+export declare const replaceRangeInternal: (state: TextBufferState, startRow: number, startCol: number, endRow: number, endCol: number, text: string) => TextBufferState;
+export interface Viewport {
+    height: number;
+    width: number;
+}
+interface UseTextBufferProps {
+    initialText?: string;
+    initialCursorOffset?: number;
+    viewport: Viewport;
+    onChange?: (text: string) => void;
+    inputFilter?: (text: string) => string;
+    singleLine?: boolean;
+}
+interface UndoHistoryEntry {
+    lines: string[];
+    cursorRow: number;
+    cursorCol: number;
+}
+export declare function offsetToLogicalPos(text: string, offset: number): [number, number];
+/**
+ * Converts logical row/col position to absolute text offset
+ * Inverse operation of offsetToLogicalPos
+ */
+export declare function logicalPosToOffset(lines: string[], row: number, col: number): number;
+export interface VisualLayout {
+    visualLines: string[];
+    logicalToVisualMap: Array<Array<[number, number]>>;
+    visualToLogicalMap: Array<[number, number]>;
+}
+export interface TextBufferState {
+    lines: string[];
+    cursorRow: number;
+    cursorCol: number;
+    preferredCol: number | null;
+    undoStack: UndoHistoryEntry[];
+    redoStack: UndoHistoryEntry[];
+    viewportWidth: number;
+    viewportHeight: number;
+    visualLayout: VisualLayout;
+}
+export declare const pushUndo: (currentState: TextBufferState) => TextBufferState;
+export type TextBufferAction = {
+    type: 'set_text';
+    payload: string;
+    pushToUndo?: boolean;
+} | {
+    type: 'insert';
+    payload: string;
+} | {
+    type: 'backspace';
+} | {
+    type: 'move';
+    payload: {
+        dir: Direction;
+    };
+} | {
+    type: 'set_cursor';
+    payload: {
+        cursorRow: number;
+        cursorCol: number;
+        preferredCol: number | null;
+    };
+} | {
+    type: 'delete';
+} | {
+    type: 'delete_word_left';
+} | {
+    type: 'delete_word_right';
+} | {
+    type: 'kill_line_right';
+} | {
+    type: 'kill_line_left';
+} | {
+    type: 'undo';
+} | {
+    type: 'redo';
+} | {
+    type: 'replace_range';
+    payload: {
+        startRow: number;
+        startCol: number;
+        endRow: number;
+        endCol: number;
+        text: string;
+    };
+} | {
+    type: 'move_to_offset';
+    payload: {
+        offset: number;
+    };
+} | {
+    type: 'create_undo_snapshot';
+} | {
+    type: 'set_viewport';
+    payload: {
+        width: number;
+        height: number;
+    };
+};
+export interface TextBufferOptions {
+    inputFilter?: ((text: string) => string) | undefined;
+    singleLine?: boolean | undefined;
+}
+export declare function textBufferReducer(state: TextBufferState, action: TextBufferAction, options?: TextBufferOptions): TextBufferState;
+export declare function useTextBuffer({ initialText, initialCursorOffset, viewport, onChange, inputFilter, singleLine, }: UseTextBufferProps): TextBuffer;
+export interface TextBuffer {
+    lines: string[];
+    text: string;
+    cursor: [number, number];
+    /**
+     * When the user moves the caret vertically we try to keep their original
+     * horizontal column even when passing through shorter lines. We remember
+     * that *preferred* column in this field while the user is still travelling
+     * vertically. Any explicit horizontal movement resets the preference.
+     */
+    preferredCol: number | null;
+    allVisualLines: string[];
+    viewportVisualLines: string[];
+    visualCursor: [number, number];
+    visualScrollRow: number;
+    /**
+     * For each visual line (by absolute index in allVisualLines) provides a tuple
+     * [logicalLineIndex, startColInLogical] that maps where that visual line
+     * begins within the logical buffer. Indices are code-point based.
+     */
+    visualToLogicalMap: Array<[number, number]>;
+    /** Replaces the entire buffer content with the provided text. Undoable. */
+    setText: (text: string) => void;
+    /** Insert a single character or string. */
+    insert: (ch: string, opts?: {
+        paste?: boolean;
+    }) => void;
+    newline: () => void;
+    backspace: () => void;
+    del: () => void;
+    move: (dir: Direction) => void;
+    undo: () => void;
+    redo: () => void;
+    /** Replaces the text within the specified range with new text. */
+    replaceRange: (startRow: number, startCol: number, endRow: number, endCol: number, text: string) => void;
+    /** Delete the word to the left of the caret. */
+    deleteWordLeft: () => void;
+    /** Delete the word to the right of the caret. */
+    deleteWordRight: () => void;
+    /** Deletes text from the cursor to the end of the current line. */
+    killLineRight: () => void;
+    /** Deletes text from the start of the current line to the cursor. */
+    killLineLeft: () => void;
+    /** High level "handleInput" – receives what Ink gives us. */
+    handleInput: (key: Key) => void;
+    replaceRangeByOffset: (startOffset: number, endOffset: number, replacementText: string) => void;
+    getOffset: () => number;
+    moveToOffset(offset: number): void;
+    moveToVisualPosition(visualRow: number, visualCol: number): void;
+    /** Update the viewport dimensions. */
+    setViewport: (width: number, height: number) => void;
+}
+export {};
+//# sourceMappingURL=text-buffer.d.ts.map

package/dist/components/shared/text-buffer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"text-buffer.d.ts","sourceRoot":"","sources":["../../../src/components/shared/text-buffer.ts"],"names":[],"mappings":"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"}