@opentui/core 0.1.27 → 0.1.29

package/text-buffer-view.d.ts

@@ -0,0 +1,31 @@
+import { RGBA } from "./lib/RGBA";
+import { type LineInfo, type RenderLib } from "./zig";
+import { type Pointer } from "bun:ffi";
+import type { TextBuffer } from "./text-buffer";
+export declare class TextBufferView {
+    private lib;
+    private viewPtr;
+    private textBuffer;
+    private _destroyed;
+    constructor(lib: RenderLib, ptr: Pointer, textBuffer: TextBuffer);
+    static create(textBuffer: TextBuffer): TextBufferView;
+    private guard;
+    get ptr(): Pointer;
+    setSelection(start: number, 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): boolean;
+    resetLocalSelection(): void;
+    setWrapWidth(width: number | null): void;
+    setWrapMode(mode: "none" | "char" | "word"): void;
+    setViewportSize(width: number, height: number): void;
+    get lineInfo(): LineInfo;
+    get logicalLineInfo(): LineInfo;
+    getSelectedText(): string;
+    getPlainText(): string;
+    destroy(): void;
+}

package/text-buffer.d.ts

@@ -1,8 +1,9 @@
 import type { StyledText } from "./lib/styled-text";
 import { RGBA } from "./lib/RGBA";
-import { type LineInfo, type RenderLib } from "./zig";
+import { type RenderLib } from "./zig";
 import { type Pointer } from "bun:ffi";
-import { type WidthMethod } from "./types";
+import { type WidthMethod, type Highlight } from "./types";
+import type { SyntaxStyle } from "./syntax-style";
 export interface TextChunk {
     __isChunk: true;
     text: string;
@@ -14,37 +15,43 @@ export declare class TextBuffer {
     private lib;
     private bufferPtr;
     private _length;
+    private _byteSize;
     private _lineInfo?;
     private _destroyed;
+    private _syntaxStyle?;
+    private _textBytes?;
+    private _memId?;
     constructor(lib: RenderLib, ptr: Pointer);
     static create(widthMethod: WidthMethod): TextBuffer;
     private guard;
+    setText(text: string): void;
+    loadFile(path: string): void;
     setStyledText(text: StyledText): void;
     setDefaultFg(fg: RGBA | null): void;
     setDefaultBg(bg: RGBA | null): void;
     setDefaultAttributes(attributes: number | null): void;
     resetDefaults(): void;
     get length(): number;
+    get byteSize(): number;
     get ptr(): Pointer;
-    getSelectedText(): string;
     getPlainText(): string;
-    get lineInfo(): LineInfo;
-    setSelection(start: number, end: number, bgColor?: RGBA, fgColor?: RGBA): void;
-    resetSelection(): void;
-    setLocalSelection(anchorX: number, anchorY: number, focusX: number, focusY: number, bgColor?: RGBA, fgColor?: RGBA): boolean;
-    resetLocalSelection(): void;
-    getSelection(): {
-        start: number;
-        end: number;
-    } | null;
-    hasSelection(): boolean;
-    insertChunkGroup(index: number, text: string, fg?: RGBA, bg?: RGBA, attributes?: number): void;
-    insertEncodedChunkGroup(index: number, textBytes: Uint8Array, fg?: RGBA, bg?: RGBA, attributes?: number): void;
-    removeChunkGroup(index: number): void;
-    replaceChunkGroup(index: number, text: string, fg?: RGBA, bg?: RGBA, attributes?: number): void;
-    replaceEncodedChunkGroup(index: number, textBytes: Uint8Array, fg?: RGBA, bg?: RGBA, attributes?: number): void;
-    get chunkGroupCount(): number;
-    setWrapWidth(width: number | null): void;
-    setWrapMode(mode: "char" | "word"): void;
+    /**
+     * Add a highlight using character offsets into the full text.
+     * start/end in highlight represent absolute character positions.
+     */
+    addHighlightByCharRange(highlight: Highlight): void;
+    /**
+     * Add a highlight to a specific line by column positions.
+     * start/end in highlight represent column offsets.
+     */
+    addHighlight(lineIdx: number, highlight: Highlight): void;
+    removeHighlightsByRef(hlRef: number): void;
+    clearLineHighlights(lineIdx: number): void;
+    clearAllHighlights(): void;
+    getLineHighlights(lineIdx: number): Array<Highlight>;
+    setSyntaxStyle(style: SyntaxStyle | null): void;
+    getSyntaxStyle(): SyntaxStyle | null;
+    clear(): void;
+    reset(): void;
     destroy(): void;
 }

package/types.d.ts

@@ -55,6 +55,9 @@ export interface RenderContext extends EventEmitter {
     getLifecyclePasses: () => Set<Renderable>;
     keyInput: KeyHandler;
     _internalKeyInput: InternalKeyHandler;
+    clearSelection: () => void;
+    startSelection: (renderable: Renderable, x: number, y: number) => void;
+    updateSelection: (currentRenderable: Renderable | undefined, x: number, y: number) => void;
 }
 export type Timeout = ReturnType<typeof setTimeout> | undefined;
 export interface ViewportBounds {
@@ -63,3 +66,10 @@ export interface ViewportBounds {
     width: number;
     height: number;
 }
+export interface Highlight {
+    start: number;
+    end: number;
+    styleId: number;
+    priority?: number | null;
+    hlRef?: number | null;
+}

package/zig-structs.d.ts

@@ -0,0 +1,20 @@
+import { type Pointer } from "bun:ffi";
+import { RGBA } from "./lib/RGBA";
+export declare const StyledChunkStruct: import("bun-ffi-structs").DefineStructReturnType<[readonly ["text", "char*"], readonly ["text_len", "u64", {
+    readonly lengthOf: "text";
+}], readonly ["fg", "pointer", {
+    readonly optional: true;
+    readonly packTransform: (rgba?: RGBA) => Pointer | null;
+    readonly unpackTransform: (ptr?: Pointer) => RGBA | undefined;
+}], readonly ["bg", "pointer", {
+    readonly optional: true;
+    readonly packTransform: (rgba?: RGBA) => Pointer | null;
+    readonly unpackTransform: (ptr?: Pointer) => RGBA | undefined;
+}], readonly ["attributes", "u8", {
+    readonly optional: true;
+}]], {}>;
+export declare const HighlightStruct: import("bun-ffi-structs").DefineStructReturnType<[readonly ["start", "u32"], readonly ["end", "u32"], readonly ["styleId", "u32"], readonly ["priority", "u8", {
+    readonly default: 0;
+}], readonly ["hlRef", "u16", {
+    readonly default: 0;
+}]], {}>;

package/zig.d.ts

@@ -1,5 +1,5 @@
 import { type Pointer } from "bun:ffi";
-import { type CursorStyle, type DebugOverlayCorner, type WidthMethod } from "./types";
+import { type CursorStyle, type DebugOverlayCorner, type WidthMethod, type Highlight } from "./types";
 import { RGBA } from "./lib/RGBA";
 import { OptimizedBuffer } from "./buffer";
 import { TextBuffer } from "./text-buffer";
@@ -14,6 +14,19 @@ export interface LineInfo {
     lineWidths: number[];
     maxLineWidth: number;
 }
+/**
+ * VisualCursor represents a cursor position with both visual and logical coordinates.
+ * Visual coordinates (visualRow, visualCol) are VIEWPORT-RELATIVE.
+ * This means visualRow=0 is the first visible line in the viewport, not the first line in the document.
+ * Logical coordinates (logicalRow, logicalCol) are document-absolute.
+ */
+export interface VisualCursor {
+    visualRow: number;
+    visualCol: number;
+    logicalRow: number;
+    logicalCol: number;
+    offset: number;
+}
 export interface RenderLib {
     createRenderer: (width: number, height: number, options?: {
         testing: boolean;
@@ -71,46 +84,136 @@ export interface RenderLib {
     createTextBuffer: (widthMethod: WidthMethod) => TextBuffer;
     destroyTextBuffer: (buffer: Pointer) => void;
     textBufferGetLength: (buffer: Pointer) => number;
+    textBufferGetByteSize: (buffer: Pointer) => number;
     textBufferReset: (buffer: Pointer) => void;
-    textBufferSetSelection: (buffer: Pointer, start: number, end: number, bgColor: RGBA | null, fgColor: RGBA | null) => void;
-    textBufferResetSelection: (buffer: Pointer) => void;
-    textBufferSetLocalSelection: (buffer: Pointer, anchorX: number, anchorY: number, focusX: number, focusY: number, bgColor: RGBA | null, fgColor: RGBA | null) => boolean;
-    textBufferResetLocalSelection: (buffer: Pointer) => void;
+    textBufferClear: (buffer: Pointer) => void;
+    textBufferRegisterMemBuffer: (buffer: Pointer, bytes: Uint8Array, owned?: boolean) => number;
+    textBufferReplaceMemBuffer: (buffer: Pointer, memId: number, bytes: Uint8Array, owned?: boolean) => boolean;
+    textBufferClearMemRegistry: (buffer: Pointer) => void;
+    textBufferSetTextFromMem: (buffer: Pointer, memId: number) => void;
+    textBufferLoadFile: (buffer: Pointer, path: string) => boolean;
+    textBufferSetStyledText: (buffer: Pointer, chunks: Array<{
+        text: string;
+        fg?: RGBA | null;
+        bg?: RGBA | null;
+        attributes?: number;
+    }>) => void;
     textBufferSetDefaultFg: (buffer: Pointer, fg: RGBA | null) => void;
     textBufferSetDefaultBg: (buffer: Pointer, bg: RGBA | null) => void;
     textBufferSetDefaultAttributes: (buffer: Pointer, attributes: number | null) => void;
     textBufferResetDefaults: (buffer: Pointer) => void;
-    textBufferWriteChunk: (buffer: Pointer, textBytes: Uint8Array, fg: RGBA | null, bg: RGBA | null, attributes: number | null) => number;
-    textBufferFinalizeLineInfo: (buffer: Pointer) => void;
     textBufferGetLineCount: (buffer: Pointer) => number;
-    textBufferGetLineInfoDirect: (buffer: Pointer, lineStartsPtr: Pointer, lineWidthsPtr: Pointer) => void;
-    textBufferGetLineInfo: (buffer: Pointer) => LineInfo;
-    textBufferGetSelection: (buffer: Pointer) => {
+    getPlainTextBytes: (buffer: Pointer, maxLength: number) => Uint8Array | null;
+    createTextBufferView: (textBuffer: Pointer) => Pointer;
+    destroyTextBufferView: (view: Pointer) => void;
+    textBufferViewSetSelection: (view: Pointer, start: number, end: number, bgColor: RGBA | null, fgColor: RGBA | null) => void;
+    textBufferViewResetSelection: (view: Pointer) => void;
+    textBufferViewGetSelection: (view: Pointer) => {
         start: number;
         end: number;
     } | null;
-    getSelectedTextBytes: (buffer: Pointer, maxLength: number) => Uint8Array | null;
-    getPlainTextBytes: (buffer: Pointer, maxLength: number) => Uint8Array | null;
+    textBufferViewSetLocalSelection: (view: Pointer, anchorX: number, anchorY: number, focusX: number, focusY: number, bgColor: RGBA | null, fgColor: RGBA | null) => boolean;
+    textBufferViewResetLocalSelection: (view: Pointer) => void;
+    textBufferViewSetWrapWidth: (view: Pointer, width: number) => void;
+    textBufferViewSetWrapMode: (view: Pointer, mode: "none" | "char" | "word") => void;
+    textBufferViewSetViewportSize: (view: Pointer, width: number, height: number) => void;
+    textBufferViewGetLineInfo: (view: Pointer) => LineInfo;
+    textBufferViewGetLogicalLineInfo: (view: Pointer) => LineInfo;
+    textBufferViewGetSelectedTextBytes: (view: Pointer, maxLength: number) => Uint8Array | null;
+    textBufferViewGetPlainTextBytes: (view: Pointer, maxLength: number) => Uint8Array | null;
     readonly encoder: TextEncoder;
     readonly decoder: TextDecoder;
-    bufferDrawTextBuffer: (buffer: Pointer, textBuffer: Pointer, x: number, y: number, clipRect?: {
-        x: number;
-        y: number;
-        width: number;
+    bufferDrawTextBufferView: (buffer: Pointer, view: Pointer, x: number, y: number) => void;
+    bufferDrawEditorView: (buffer: Pointer, view: Pointer, x: number, y: number) => void;
+    createEditBuffer: (widthMethod: WidthMethod) => Pointer;
+    destroyEditBuffer: (buffer: Pointer) => void;
+    editBufferSetText: (buffer: Pointer, textBytes: Uint8Array, retainHistory?: boolean) => void;
+    editBufferSetTextFromMem: (buffer: Pointer, memId: number, retainHistory?: boolean) => void;
+    editBufferGetText: (buffer: Pointer, maxLength: number) => Uint8Array | null;
+    editBufferInsertChar: (buffer: Pointer, char: string) => void;
+    editBufferInsertText: (buffer: Pointer, text: string) => void;
+    editBufferDeleteChar: (buffer: Pointer) => void;
+    editBufferDeleteCharBackward: (buffer: Pointer) => void;
+    editBufferNewLine: (buffer: Pointer) => void;
+    editBufferDeleteLine: (buffer: Pointer) => void;
+    editBufferMoveCursorLeft: (buffer: Pointer) => void;
+    editBufferMoveCursorRight: (buffer: Pointer) => void;
+    editBufferMoveCursorUp: (buffer: Pointer) => void;
+    editBufferMoveCursorDown: (buffer: Pointer) => void;
+    editBufferGotoLine: (buffer: Pointer, line: number) => void;
+    editBufferSetCursor: (buffer: Pointer, line: number, col: number) => void;
+    editBufferSetCursorToLineCol: (buffer: Pointer, line: number, col: number) => void;
+    editBufferSetCursorByOffset: (buffer: Pointer, offset: number) => void;
+    editBufferGetCursorPosition: (buffer: Pointer) => {
+        line: number;
+        visualColumn: number;
+        offset: number;
+    };
+    editBufferGetId: (buffer: Pointer) => number;
+    editBufferGetTextBuffer: (buffer: Pointer) => Pointer;
+    editBufferDebugLogRope: (buffer: Pointer) => void;
+    editBufferUndo: (buffer: Pointer, maxLength: number) => Uint8Array | null;
+    editBufferRedo: (buffer: Pointer, maxLength: number) => Uint8Array | null;
+    editBufferCanUndo: (buffer: Pointer) => boolean;
+    editBufferCanRedo: (buffer: Pointer) => boolean;
+    editBufferClearHistory: (buffer: Pointer) => void;
+    editBufferSetPlaceholder: (buffer: Pointer, text: string | null) => void;
+    editBufferSetPlaceholderColor: (buffer: Pointer, color: RGBA) => void;
+    createEditorView: (editBufferPtr: Pointer, viewportWidth: number, viewportHeight: number) => Pointer;
+    destroyEditorView: (view: Pointer) => void;
+    editorViewSetViewportSize: (view: Pointer, width: number, height: number) => void;
+    editorViewGetViewport: (view: Pointer) => {
+        offsetY: number;
+        offsetX: number;
         height: number;
-    }) => void;
+        width: number;
+    };
+    editorViewSetScrollMargin: (view: Pointer, margin: number) => void;
+    editorViewSetWrapMode: (view: Pointer, mode: "none" | "char" | "word") => void;
+    editorViewGetVirtualLineCount: (view: Pointer) => number;
+    editorViewGetTotalVirtualLineCount: (view: Pointer) => number;
+    editorViewGetTextBufferView: (view: Pointer) => Pointer;
+    editorViewSetSelection: (view: Pointer, start: number, end: number, bgColor: RGBA | null, fgColor: RGBA | null) => void;
+    editorViewResetSelection: (view: Pointer) => void;
+    editorViewGetSelection: (view: Pointer) => {
+        start: number;
+        end: number;
+    } | null;
+    editorViewSetLocalSelection: (view: Pointer, anchorX: number, anchorY: number, focusX: number, focusY: number, bgColor: RGBA | null, fgColor: RGBA | null) => boolean;
+    editorViewResetLocalSelection: (view: Pointer) => void;
+    editorViewGetSelectedTextBytes: (view: Pointer, maxLength: number) => Uint8Array | null;
+    editorViewGetCursor: (view: Pointer) => {
+        row: number;
+        col: number;
+    };
+    editorViewGetText: (view: Pointer, maxLength: number) => Uint8Array | null;
+    editorViewGetVisualCursor: (view: Pointer) => VisualCursor;
+    editorViewMoveUpVisual: (view: Pointer) => void;
+    editorViewMoveDownVisual: (view: Pointer) => void;
+    editorViewDeleteSelectedText: (view: Pointer) => void;
+    editorViewSetCursorByOffset: (view: Pointer, offset: number) => void;
     bufferPushScissorRect: (buffer: Pointer, x: number, y: number, width: number, height: number) => void;
     bufferPopScissorRect: (buffer: Pointer) => void;
     bufferClearScissorRects: (buffer: Pointer) => void;
-    textBufferInsertChunkGroup: (buffer: Pointer, index: number, textBytes: Uint8Array, fg: RGBA | null, bg: RGBA | null, attributes: number | null) => number;
-    textBufferRemoveChunkGroup: (buffer: Pointer, index: number) => number;
-    textBufferReplaceChunkGroup: (buffer: Pointer, index: number, textBytes: Uint8Array, fg: RGBA | null, bg: RGBA | null, attributes: number | null) => number;
-    textBufferGetChunkGroupCount: (buffer: Pointer) => number;
-    textBufferSetWrapWidth: (buffer: Pointer, width: number) => void;
-    textBufferSetWrapMode: (buffer: Pointer, mode: "char" | "word") => void;
+    textBufferAddHighlightByCharRange: (buffer: Pointer, highlight: Highlight) => void;
+    textBufferAddHighlight: (buffer: Pointer, lineIdx: number, highlight: Highlight) => void;
+    textBufferRemoveHighlightsByRef: (buffer: Pointer, hlRef: number) => void;
+    textBufferClearLineHighlights: (buffer: Pointer, lineIdx: number) => void;
+    textBufferClearAllHighlights: (buffer: Pointer) => void;
+    textBufferSetSyntaxStyle: (buffer: Pointer, style: Pointer | null) => void;
+    textBufferGetLineHighlights: (buffer: Pointer, lineIdx: number) => Array<Highlight>;
     getArenaAllocatedBytes: () => number;
+    createSyntaxStyle: () => Pointer;
+    destroySyntaxStyle: (style: Pointer) => void;
+    syntaxStyleRegister: (style: Pointer, name: string, fg: RGBA | null, bg: RGBA | null, attributes: number) => number;
+    syntaxStyleResolveByName: (style: Pointer, name: string) => number | null;
+    syntaxStyleGetStyleCount: (style: Pointer) => number;
     getTerminalCapabilities: (renderer: Pointer) => any;
     processCapabilityResponse: (renderer: Pointer, response: string) => void;
+    onNativeEvent: (name: string, handler: (data: ArrayBuffer) => void) => void;
+    onceNativeEvent: (name: string, handler: (data: ArrayBuffer) => void) => void;
+    offNativeEvent: (name: string, handler: (data: ArrayBuffer) => void) => void;
+    onAnyNativeEvent: (handler: (name: string, data: ArrayBuffer) => void) => void;
 }
 export declare function setRenderLibPath(libPath: string): void;
 export declare function resolveRenderLib(): RenderLib;

package/lib/word-jumps.d.ts

@@ -1,2 +0,0 @@
-export declare function nextWordEndCrossLines(text: string, caret: number): number;
-export declare function previousWordStartCrossLines(text: string, caret: number): number;