@opentuah/core 0.1.77

package/assets/zig/highlights.scm

@@ -0,0 +1,284 @@
+; Query from: https://github.com/nvim-treesitter/nvim-treesitter/raw/refs/heads/master/queries/zig/highlights.scm
+; Variables
+(identifier) @variable
+
+; Parameters
+(parameter
+  name: (identifier) @variable.parameter)
+
+(payload
+  (identifier) @variable.parameter)
+
+; Types
+(parameter
+  type: (identifier) @type)
+
+((identifier) @type
+  (#lua-match? @type "^[A-Z_][a-zA-Z0-9_]*"))
+
+(variable_declaration
+  (identifier) @type
+  "="
+  [
+    (struct_declaration)
+    (enum_declaration)
+    (union_declaration)
+    (opaque_declaration)
+  ])
+
+[
+  (builtin_type)
+  "anyframe"
+] @type.builtin
+
+; Constants
+((identifier) @constant
+  (#lua-match? @constant "^[A-Z][A-Z_0-9]+$"))
+
+[
+  "null"
+  "unreachable"
+  "undefined"
+] @constant.builtin
+
+(field_expression
+  .
+  member: (identifier) @constant)
+
+(enum_declaration
+  (container_field
+    type: (identifier) @constant))
+
+; Labels
+(block_label
+  (identifier) @label)
+
+(break_label
+  (identifier) @label)
+
+; Fields
+(field_initializer
+  .
+  (identifier) @variable.member)
+
+(field_expression
+  (_)
+  member: (identifier) @variable.member)
+
+(container_field
+  name: (identifier) @variable.member)
+
+(initializer_list
+  (assignment_expression
+    left: (field_expression
+      .
+      member: (identifier) @variable.member)))
+
+; Functions
+(builtin_identifier) @function.builtin
+
+(call_expression
+  function: (identifier) @function.call)
+
+(call_expression
+  function: (field_expression
+    member: (identifier) @function.call))
+
+(function_declaration
+  name: (identifier) @function)
+
+; Modules
+(variable_declaration
+  (identifier) @module
+  (builtin_function
+    (builtin_identifier) @keyword.import
+    (#any-of? @keyword.import "@import" "@cImport")))
+
+; Builtins
+[
+  "c"
+  "..."
+] @variable.builtin
+
+((identifier) @variable.builtin
+  (#eq? @variable.builtin "_"))
+
+(calling_convention
+  (identifier) @variable.builtin)
+
+; Keywords
+[
+  "asm"
+  "defer"
+  "errdefer"
+  "test"
+  "error"
+  "const"
+  "var"
+] @keyword
+
+[
+  "struct"
+  "union"
+  "enum"
+  "opaque"
+] @keyword.type
+
+[
+  "async"
+  "await"
+  "suspend"
+  "nosuspend"
+  "resume"
+] @keyword.coroutine
+
+"fn" @keyword.function
+
+[
+  "and"
+  "or"
+  "orelse"
+] @keyword.operator
+
+"return" @keyword.return
+
+[
+  "if"
+  "else"
+  "switch"
+] @keyword.conditional
+
+[
+  "for"
+  "while"
+  "break"
+  "continue"
+] @keyword.repeat
+
+[
+  "usingnamespace"
+  "export"
+] @keyword.import
+
+[
+  "try"
+  "catch"
+] @keyword.exception
+
+[
+  "volatile"
+  "allowzero"
+  "noalias"
+  "addrspace"
+  "align"
+  "callconv"
+  "linksection"
+  "pub"
+  "inline"
+  "noinline"
+  "extern"
+  "comptime"
+  "packed"
+  "threadlocal"
+] @keyword.modifier
+
+; Operator
+[
+  "="
+  "*="
+  "*%="
+  "*|="
+  "/="
+  "%="
+  "+="
+  "+%="
+  "+|="
+  "-="
+  "-%="
+  "-|="
+  "<<="
+  "<<|="
+  ">>="
+  "&="
+  "^="
+  "|="
+  "!"
+  "~"
+  "-"
+  "-%"
+  "&"
+  "=="
+  "!="
+  ">"
+  ">="
+  "<="
+  "<"
+  "&"
+  "^"
+  "|"
+  "<<"
+  ">>"
+  "<<|"
+  "+"
+  "++"
+  "+%"
+  "-%"
+  "+|"
+  "-|"
+  "*"
+  "/"
+  "%"
+  "**"
+  "*%"
+  "*|"
+  "||"
+  ".*"
+  ".?"
+  "?"
+  ".."
+] @operator
+
+; Literals
+(character) @character
+
+([
+  (string)
+  (multiline_string)
+] @string
+  (#set! "priority" 95))
+
+(integer) @number
+
+(float) @number.float
+
+(boolean) @boolean
+
+(escape_sequence) @string.escape
+
+; Punctuation
+[
+  "["
+  "]"
+  "("
+  ")"
+  "{"
+  "}"
+] @punctuation.bracket
+
+[
+  ";"
+  "."
+  ","
+  ":"
+  "=>"
+  "->"
+] @punctuation.delimiter
+
+(payload
+  "|" @punctuation.bracket)
+
+; Comments
+(comment) @comment @spell
+
+((comment) @comment.documentation
+  (#lua-match? @comment.documentation "^//!"))

package/buffer.d.ts

@@ -0,0 +1,98 @@
+import { RGBA } from "./lib";
+import { type RenderLib } from "./zig";
+import { type Pointer } from "bun:ffi";
+import { type BorderStyle, type BorderSides } from "./lib";
+import { type WidthMethod, type CapturedLine } from "./types";
+import type { TextBufferView } from "./text-buffer-view";
+import type { EditorView } from "./editor-view";
+export declare class OptimizedBuffer {
+    private static fbIdCounter;
+    id: string;
+    lib: RenderLib;
+    private bufferPtr;
+    private _width;
+    private _height;
+    private _widthMethod;
+    respectAlpha: boolean;
+    private _rawBuffers;
+    private _destroyed;
+    get ptr(): Pointer;
+    private guard;
+    get buffers(): {
+        char: Uint32Array;
+        fg: Float32Array;
+        bg: Float32Array;
+        attributes: Uint32Array;
+    };
+    constructor(lib: RenderLib, ptr: Pointer, width: number, height: number, options: {
+        respectAlpha?: boolean;
+        id?: string;
+        widthMethod?: WidthMethod;
+    });
+    static create(width: number, height: number, widthMethod: WidthMethod, options?: {
+        respectAlpha?: boolean;
+        id?: string;
+    }): OptimizedBuffer;
+    get widthMethod(): WidthMethod;
+    get width(): number;
+    get height(): number;
+    setRespectAlpha(respectAlpha: boolean): void;
+    getNativeId(): string;
+    getRealCharBytes(addLineBreaks?: boolean): Uint8Array;
+    getSpanLines(): CapturedLine[];
+    clear(bg?: RGBA): void;
+    setCell(x: number, y: number, char: string, fg: RGBA, bg: RGBA, attributes?: number): void;
+    setCellWithAlphaBlending(x: number, y: number, char: string, fg: RGBA, bg: RGBA, attributes?: number): void;
+    drawText(text: string, x: number, y: number, fg: RGBA, bg?: RGBA, attributes?: number, selection?: {
+        start: number;
+        end: number;
+        bgColor?: RGBA;
+        fgColor?: RGBA;
+    } | null): void;
+    fillRect(x: number, y: number, width: number, height: number, bg: RGBA): void;
+    drawFrameBuffer(destX: number, destY: number, frameBuffer: OptimizedBuffer, sourceX?: number, sourceY?: number, sourceWidth?: number, sourceHeight?: number): void;
+    destroy(): void;
+    drawTextBuffer(textBufferView: TextBufferView, x: number, y: number): void;
+    drawEditorView(editorView: EditorView, x: number, y: number): void;
+    drawSuperSampleBuffer(x: number, y: number, pixelDataPtr: Pointer, pixelDataLength: number, format: "bgra8unorm" | "rgba8unorm", alignedBytesPerRow: number): void;
+    drawPackedBuffer(dataPtr: Pointer, dataLen: number, posX: number, posY: number, terminalWidthCells: number, terminalHeightCells: number): void;
+    drawGrayscaleBuffer(posX: number, posY: number, intensities: Float32Array, srcWidth: number, srcHeight: number, fg?: RGBA | null, bg?: RGBA | null): void;
+    drawGrayscaleBufferSupersampled(posX: number, posY: number, intensities: Float32Array, srcWidth: number, srcHeight: number, fg?: RGBA | null, bg?: RGBA | null): void;
+    resize(width: number, height: number): void;
+    drawBox(options: {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+        borderStyle?: BorderStyle;
+        customBorderChars?: Uint32Array;
+        border: boolean | BorderSides[];
+        borderColor: RGBA;
+        backgroundColor: RGBA;
+        shouldFill?: boolean;
+        title?: string;
+        titleAlignment?: "left" | "center" | "right";
+    }): void;
+    pushScissorRect(x: number, y: number, width: number, height: number): void;
+    popScissorRect(): void;
+    clearScissorRects(): void;
+    pushOpacity(opacity: number): void;
+    popOpacity(): void;
+    getCurrentOpacity(): number;
+    clearOpacity(): void;
+    encodeUnicode(text: string): {
+        ptr: Pointer;
+        data: Array<{
+            width: number;
+            char: number;
+        }>;
+    } | null;
+    freeUnicode(encoded: {
+        ptr: Pointer;
+        data: Array<{
+            width: number;
+            char: number;
+        }>;
+    }): void;
+    drawChar(char: number, x: number, y: number, fg: RGBA, bg: RGBA, attributes?: number): void;
+}

package/console.d.ts

@@ -0,0 +1,140 @@
+import { EventEmitter } from "events";
+import type { CliRenderer, ColorInput, MouseEvent } from ".";
+import { OptimizedBuffer } from "./buffer";
+import { Capture } from "./lib/output.capture";
+import { type KeyBinding as BaseKeyBinding, type KeyAliasMap } from "./lib/keymapping";
+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;
+}
+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 _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";
+import { type Pointer } from "bun:ffi";
+import { type WidthMethod, type Highlight } from "./types";
+import { RGBA } from "./lib/RGBA";
+import { EventEmitter } from "events";
+import type { SyntaxStyle } from "./syntax-style";
+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";
+import { type RenderLib, type VisualCursor, type LineInfo } from "./zig";
+import { type Pointer } from "bun:ffi";
+import type { EditBuffer } from "./edit-buffer";
+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;
+        maxWidth: number;
+    } | null;
+    destroy(): void;
+}