@opentui/core 0.0.0-20251008-63d6b70d → 0.0.0-20251026-8b7fde6b

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,24 @@ 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 LogicalCursor {
+    row: number;
+    col: number;
+    offset: number;
+}
 export interface RenderLib {
     createRenderer: (width: number, height: number, options?: {
         testing: boolean;
@@ -71,46 +89,152 @@ 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;
+    editBufferDeleteRange: (buffer: Pointer, startLine: number, startCol: number, endLine: number, endCol: number) => 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) => LogicalCursor;
+    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;
+    editBufferClear: (buffer: Pointer) => void;
+    editBufferGetNextWordBoundary: (buffer: Pointer) => {
+        row: number;
+        col: number;
+        offset: number;
+    };
+    editBufferGetPrevWordBoundary: (buffer: Pointer) => {
+        row: number;
+        col: number;
+        offset: number;
+    };
+    editBufferGetEOL: (buffer: Pointer) => {
+        row: number;
+        col: number;
+        offset: number;
+    };
+    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;
+    editorViewGetNextWordBoundary: (view: Pointer) => VisualCursor;
+    editorViewGetPrevWordBoundary: (view: Pointer) => VisualCursor;
+    editorViewGetEOL: (view: Pointer) => VisualCursor;
     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;