@fairyhunter13/opentui-core 0.1.91 → 0.1.92

package/console.d.ts

@@ -0,0 +1,143 @@
+import { EventEmitter } from "events";
+import type { CliRenderer, ColorInput, MouseEvent } from "./index.js";
+import { OptimizedBuffer } from "./buffer.js";
+import { type Clock } from "./lib/clock.js";
+import { Capture } from "./lib/output.capture.js";
+import { type KeyBinding as BaseKeyBinding, type KeyAliasMap } from "./lib/keymapping.js";
+export declare const capture: Capture;
+export declare enum ConsolePosition {
+    TOP = "top",
+    BOTTOM = "bottom",
+    LEFT = "left",
+    RIGHT = "right"
+}
+export type ConsoleAction = "scroll-up" | "scroll-down" | "scroll-to-top" | "scroll-to-bottom" | "position-previous" | "position-next" | "size-increase" | "size-decrease" | "save-logs" | "copy-selection";
+export type ConsoleKeyBinding = BaseKeyBinding<ConsoleAction>;
+export interface ConsoleOptions {
+    position?: ConsolePosition;
+    sizePercent?: number;
+    zIndex?: number;
+    colorInfo?: ColorInput;
+    colorWarn?: ColorInput;
+    colorError?: ColorInput;
+    colorDebug?: ColorInput;
+    colorDefault?: ColorInput;
+    backgroundColor?: ColorInput;
+    startInDebugMode?: boolean;
+    title?: string;
+    titleBarColor?: ColorInput;
+    titleBarTextColor?: ColorInput;
+    cursorColor?: ColorInput;
+    maxStoredLogs?: number;
+    maxDisplayLines?: number;
+    onCopySelection?: (text: string) => void;
+    keyBindings?: ConsoleKeyBinding[];
+    keyAliasMap?: KeyAliasMap;
+    selectionColor?: ColorInput;
+    copyButtonColor?: ColorInput;
+    clock?: Clock;
+}
+export declare class TerminalConsole extends EventEmitter {
+    private isVisible;
+    private isFocused;
+    private renderer;
+    private keyHandler;
+    private options;
+    private _debugModeEnabled;
+    private frameBuffer;
+    private consoleX;
+    private consoleY;
+    private consoleWidth;
+    private consoleHeight;
+    private scrollTopIndex;
+    private isScrolledToBottom;
+    private currentLineIndex;
+    private _displayLines;
+    private _allLogEntries;
+    private _needsFrameBufferUpdate;
+    private _entryListener;
+    private _selectionStart;
+    private _selectionEnd;
+    private _isDragging;
+    private _copyButtonBounds;
+    private _autoScrollInterval;
+    private readonly clock;
+    private _keyBindingsMap;
+    private _keyAliasMap;
+    private _keyBindings;
+    private _mergedKeyBindings;
+    private _actionHandlers;
+    private markNeedsRerender;
+    private getCopyButtonLabel;
+    private _rgbaInfo;
+    private _rgbaWarn;
+    private _rgbaError;
+    private _rgbaDebug;
+    private _rgbaDefault;
+    private backgroundColor;
+    private _rgbaTitleBar;
+    private _rgbaTitleBarText;
+    private _title;
+    private _rgbaCursor;
+    private _rgbaSelection;
+    private _rgbaCopyButton;
+    private _positions;
+    constructor(renderer: CliRenderer, options?: ConsoleOptions);
+    private buildActionHandlers;
+    activate(): void;
+    deactivate(): void;
+    private _handleNewLog;
+    private _updateConsoleDimensions;
+    private handleKeyPress;
+    private scrollUp;
+    private scrollDown;
+    private scrollToTop;
+    private scrollToBottomAction;
+    private positionPrevious;
+    private positionNext;
+    private sizeIncrease;
+    private sizeDecrease;
+    private saveLogsAction;
+    private triggerCopyAction;
+    private attachStdin;
+    private detachStdin;
+    private formatTimestamp;
+    private formatArguments;
+    resize(width: number, height: number): void;
+    clear(): void;
+    toggle(): void;
+    focus(): void;
+    blur(): void;
+    show(): void;
+    hide(): void;
+    destroy(): void;
+    getCachedLogs(): string;
+    private updateFrameBuffer;
+    renderToBuffer(buffer: OptimizedBuffer): void;
+    setDebugMode(enabled: boolean): void;
+    toggleDebugMode(): void;
+    set keyBindings(bindings: ConsoleKeyBinding[]);
+    set keyAliasMap(aliases: KeyAliasMap);
+    set onCopySelection(callback: ((text: string) => void) | undefined);
+    get onCopySelection(): ((text: string) => void) | undefined;
+    private _scrollToBottom;
+    private _processLogEntry;
+    private _processCachedLogs;
+    private hasSelection;
+    private normalizeSelection;
+    private getSelectedText;
+    private clearSelection;
+    private stopAutoScroll;
+    private startAutoScroll;
+    private triggerCopy;
+    private getLineSelectionRange;
+    handleMouse(event: MouseEvent): boolean;
+    get visible(): boolean;
+    get bounds(): {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    };
+    private saveLogsToFile;
+}

package/edit-buffer.d.ts

@@ -0,0 +1,98 @@
+import { type LogicalCursor, type RenderLib } from "./zig.js";
+import { type Pointer } from "bun:ffi";
+import { type WidthMethod, type Highlight } from "./types.js";
+import { RGBA } from "./lib/RGBA.js";
+import { EventEmitter } from "events";
+import type { SyntaxStyle } from "./syntax-style.js";
+export type { LogicalCursor };
+/**
+ * EditBuffer provides a text editing buffer with cursor management,
+ * incremental editing, and grapheme-aware operations.
+ */
+export declare class EditBuffer extends EventEmitter {
+    private static registry;
+    private static nativeEventsSubscribed;
+    private lib;
+    private bufferPtr;
+    private textBufferPtr;
+    readonly id: number;
+    private _destroyed;
+    private _textBytes;
+    private _singleTextBytes;
+    private _singleTextMemId;
+    private _syntaxStyle?;
+    constructor(lib: RenderLib, ptr: Pointer);
+    static create(widthMethod: WidthMethod): EditBuffer;
+    private static subscribeToNativeEvents;
+    private guard;
+    get ptr(): Pointer;
+    /**
+     * Set text and completely reset the buffer state (clears history, resets add_buffer).
+     * Use this for initial text setting or when you want a clean slate.
+     */
+    setText(text: string): void;
+    /**
+     * Set text using owned memory and completely reset the buffer state (clears history, resets add_buffer).
+     * The native code takes ownership of the memory.
+     */
+    setTextOwned(text: string): void;
+    /**
+     * Replace text while preserving undo history (creates an undo point).
+     * Use this when you want the setText operation to be undoable.
+     */
+    replaceText(text: string): void;
+    /**
+     * Replace text using owned memory while preserving undo history (creates an undo point).
+     * The native code takes ownership of the memory.
+     */
+    replaceTextOwned(text: string): void;
+    getLineCount(): number;
+    getText(): string;
+    insertChar(char: string): void;
+    insertText(text: string): void;
+    deleteChar(): void;
+    deleteCharBackward(): void;
+    deleteRange(startLine: number, startCol: number, endLine: number, endCol: number): void;
+    newLine(): void;
+    deleteLine(): void;
+    moveCursorLeft(): void;
+    moveCursorRight(): void;
+    moveCursorUp(): void;
+    moveCursorDown(): void;
+    gotoLine(line: number): void;
+    setCursor(line: number, col: number): void;
+    setCursorToLineCol(line: number, col: number): void;
+    setCursorByOffset(offset: number): void;
+    getCursorPosition(): LogicalCursor;
+    getNextWordBoundary(): LogicalCursor;
+    getPrevWordBoundary(): LogicalCursor;
+    getEOL(): LogicalCursor;
+    offsetToPosition(offset: number): {
+        row: number;
+        col: number;
+    } | null;
+    positionToOffset(row: number, col: number): number;
+    getLineStartOffset(row: number): number;
+    getTextRange(startOffset: number, endOffset: number): string;
+    getTextRangeByCoords(startRow: number, startCol: number, endRow: number, endCol: number): string;
+    debugLogRope(): void;
+    undo(): string | null;
+    redo(): string | null;
+    canUndo(): boolean;
+    canRedo(): boolean;
+    clearHistory(): void;
+    setDefaultFg(fg: RGBA | null): void;
+    setDefaultBg(bg: RGBA | null): void;
+    setDefaultAttributes(attributes: number | null): void;
+    resetDefaults(): void;
+    setSyntaxStyle(style: SyntaxStyle | null): void;
+    getSyntaxStyle(): SyntaxStyle | null;
+    addHighlight(lineIdx: number, highlight: Highlight): void;
+    addHighlightByCharRange(highlight: Highlight): void;
+    removeHighlightsByRef(hlRef: number): void;
+    clearLineHighlights(lineIdx: number): void;
+    clearAllHighlights(): void;
+    getLineHighlights(lineIdx: number): Array<Highlight>;
+    clear(): void;
+    destroy(): void;
+}

package/editor-view.d.ts

@@ -0,0 +1,73 @@
+import { RGBA } from "./lib/RGBA.js";
+import { type RenderLib, type VisualCursor, type LineInfo } from "./zig.js";
+import { type Pointer } from "bun:ffi";
+import type { EditBuffer } from "./edit-buffer.js";
+export interface Viewport {
+    offsetY: number;
+    offsetX: number;
+    height: number;
+    width: number;
+}
+export type { VisualCursor };
+export declare class EditorView {
+    private lib;
+    private viewPtr;
+    private editBuffer;
+    private _destroyed;
+    private _extmarksController?;
+    private _textBufferViewPtr?;
+    constructor(lib: RenderLib, ptr: Pointer, editBuffer: EditBuffer);
+    static create(editBuffer: EditBuffer, viewportWidth: number, viewportHeight: number): EditorView;
+    private guard;
+    get ptr(): Pointer;
+    setViewportSize(width: number, height: number): void;
+    setViewport(x: number, y: number, width: number, height: number, moveCursor?: boolean): void;
+    getViewport(): Viewport;
+    setScrollMargin(margin: number): void;
+    setWrapMode(mode: "none" | "char" | "word"): void;
+    getVirtualLineCount(): number;
+    getTotalVirtualLineCount(): number;
+    setSelection(start: number, end: number, bgColor?: RGBA, fgColor?: RGBA): void;
+    updateSelection(end: number, bgColor?: RGBA, fgColor?: RGBA): void;
+    resetSelection(): void;
+    getSelection(): {
+        start: number;
+        end: number;
+    } | null;
+    hasSelection(): boolean;
+    setLocalSelection(anchorX: number, anchorY: number, focusX: number, focusY: number, bgColor?: RGBA, fgColor?: RGBA, updateCursor?: boolean, followCursor?: boolean): boolean;
+    updateLocalSelection(anchorX: number, anchorY: number, focusX: number, focusY: number, bgColor?: RGBA, fgColor?: RGBA, updateCursor?: boolean, followCursor?: boolean): boolean;
+    resetLocalSelection(): void;
+    getSelectedText(): string;
+    getCursor(): {
+        row: number;
+        col: number;
+    };
+    getText(): string;
+    getVisualCursor(): VisualCursor;
+    moveUpVisual(): void;
+    moveDownVisual(): void;
+    deleteSelectedText(): void;
+    setCursorByOffset(offset: number): void;
+    getNextWordBoundary(): VisualCursor;
+    getPrevWordBoundary(): VisualCursor;
+    getEOL(): VisualCursor;
+    getVisualSOL(): VisualCursor;
+    getVisualEOL(): VisualCursor;
+    getLineInfo(): LineInfo;
+    getLogicalLineInfo(): LineInfo;
+    get extmarks(): any;
+    setPlaceholderStyledText(chunks: {
+        text: string;
+        fg?: RGBA;
+        bg?: RGBA;
+        attributes?: number;
+    }[]): void;
+    setTabIndicator(indicator: string | number): void;
+    setTabIndicatorColor(color: RGBA): void;
+    measureForDimensions(width: number, height: number): {
+        lineCount: number;
+        widthColsMax: number;
+    } | null;
+    destroy(): void;
+}