@opentuah/core 0.1.77

package/lib/KeyHandler.d.ts

@@ -0,0 +1,61 @@
+import { EventEmitter } from "events";
+import { type KeyEventType, type ParsedKey } from "./parse.keypress";
+export declare class KeyEvent implements ParsedKey {
+    name: string;
+    ctrl: boolean;
+    meta: boolean;
+    shift: boolean;
+    option: boolean;
+    sequence: string;
+    number: boolean;
+    raw: string;
+    eventType: KeyEventType;
+    source: "raw" | "kitty";
+    code?: string;
+    super?: boolean;
+    hyper?: boolean;
+    capsLock?: boolean;
+    numLock?: boolean;
+    baseCode?: number;
+    repeated?: boolean;
+    private _defaultPrevented;
+    private _propagationStopped;
+    constructor(key: ParsedKey);
+    get defaultPrevented(): boolean;
+    get propagationStopped(): boolean;
+    preventDefault(): void;
+    stopPropagation(): void;
+}
+export declare class PasteEvent {
+    text: string;
+    private _defaultPrevented;
+    private _propagationStopped;
+    constructor(text: string);
+    get defaultPrevented(): boolean;
+    get propagationStopped(): boolean;
+    preventDefault(): void;
+    stopPropagation(): void;
+}
+export type KeyHandlerEventMap = {
+    keypress: [KeyEvent];
+    keyrelease: [KeyEvent];
+    paste: [PasteEvent];
+};
+export declare class KeyHandler extends EventEmitter<KeyHandlerEventMap> {
+    protected useKittyKeyboard: boolean;
+    constructor(useKittyKeyboard?: boolean);
+    processInput(data: string): boolean;
+    processPaste(data: string): void;
+}
+/**
+ * This class is used internally by the renderer to ensure global handlers
+ * can preventDefault before renderable handlers process events.
+ */
+export declare class InternalKeyHandler extends KeyHandler {
+    private renderableHandlers;
+    constructor(useKittyKeyboard?: boolean);
+    emit<K extends keyof KeyHandlerEventMap>(event: K, ...args: KeyHandlerEventMap[K]): boolean;
+    private emitWithPriority;
+    onInternal<K extends keyof KeyHandlerEventMap>(event: K, handler: (...args: KeyHandlerEventMap[K]) => void): void;
+    offInternal<K extends keyof KeyHandlerEventMap>(event: K, handler: (...args: KeyHandlerEventMap[K]) => void): void;
+}

package/lib/RGBA.d.ts

@@ -0,0 +1,27 @@
+export declare class RGBA {
+    buffer: Float32Array;
+    constructor(buffer: Float32Array);
+    static fromArray(array: Float32Array): RGBA;
+    static fromValues(r: number, g: number, b: number, a?: number): RGBA;
+    static fromInts(r: number, g: number, b: number, a?: number): RGBA;
+    static fromHex(hex: string): RGBA;
+    toInts(): [number, number, number, number];
+    get r(): number;
+    set r(value: number);
+    get g(): number;
+    set g(value: number);
+    get b(): number;
+    set b(value: number);
+    get a(): number;
+    set a(value: number);
+    map<R>(fn: (value: number) => R): R[];
+    toString(): string;
+    brighten(factor: number): RGBA;
+    withAlpha(alpha: number): RGBA;
+    equals(other?: RGBA): boolean;
+}
+export type ColorInput = string | RGBA;
+export declare function hexToRgb(hex: string): RGBA;
+export declare function rgbToHex(rgb: RGBA): string;
+export declare function hsvToRgb(h: number, s: number, v: number): RGBA;
+export declare function parseColor(color: ColorInput): RGBA;

package/lib/ascii.font.d.ts

@@ -0,0 +1,508 @@
+import { OptimizedBuffer } from "../buffer";
+import { type ColorInput } from "./RGBA";
+export type ASCIIFontName = "tiny" | "block" | "shade" | "slick" | "huge" | "grid" | "pallet";
+export declare const fonts: {
+    tiny: {
+        name: string;
+        version: string;
+        homepage: string;
+        colors: number;
+        lines: number;
+        buffer: string[];
+        letterspace: string[];
+        letterspace_size: number;
+        chars: {
+            A: string[];
+            B: string[];
+            C: string[];
+            D: string[];
+            E: string[];
+            F: string[];
+            G: string[];
+            H: string[];
+            I: string[];
+            J: string[];
+            K: string[];
+            L: string[];
+            M: string[];
+            N: string[];
+            O: string[];
+            P: string[];
+            Q: string[];
+            R: string[];
+            S: string[];
+            T: string[];
+            U: string[];
+            V: string[];
+            W: string[];
+            X: string[];
+            Y: string[];
+            Z: string[];
+            "0": string[];
+            "1": string[];
+            "2": string[];
+            "3": string[];
+            "4": string[];
+            "5": string[];
+            "6": string[];
+            "7": string[];
+            "8": string[];
+            "9": string[];
+            "!": string[];
+            "?": string[];
+            ".": string[];
+            "+": string[];
+            "-": string[];
+            _: string[];
+            "=": string[];
+            "@": string[];
+            "#": string[];
+            $: string[];
+            "%": string[];
+            "&": string[];
+            "(": string[];
+            ")": string[];
+            "/": string[];
+            ":": string[];
+            ";": string[];
+            ",": string[];
+            "'": string[];
+            "\"": string[];
+            " ": string[];
+        };
+    };
+    block: {
+        name: string;
+        version: string;
+        homepage: string;
+        colors: number;
+        lines: number;
+        buffer: string[];
+        letterspace: string[];
+        letterspace_size: number;
+        chars: {
+            A: string[];
+            B: string[];
+            C: string[];
+            D: string[];
+            E: string[];
+            F: string[];
+            G: string[];
+            H: string[];
+            I: string[];
+            J: string[];
+            K: string[];
+            L: string[];
+            M: string[];
+            N: string[];
+            O: string[];
+            P: string[];
+            Q: string[];
+            R: string[];
+            S: string[];
+            T: string[];
+            U: string[];
+            V: string[];
+            W: string[];
+            X: string[];
+            Y: string[];
+            Z: string[];
+            "0": string[];
+            "1": string[];
+            "2": string[];
+            "3": string[];
+            "4": string[];
+            "5": string[];
+            "6": string[];
+            "7": string[];
+            "8": string[];
+            "9": string[];
+            "!": string[];
+            "?": string[];
+            ".": string[];
+            "+": string[];
+            "-": string[];
+            _: string[];
+            "=": string[];
+            "@": string[];
+            "#": string[];
+            $: string[];
+            "%": string[];
+            "&": string[];
+            "(": string[];
+            ")": string[];
+            "/": string[];
+            ":": string[];
+            ";": string[];
+            ",": string[];
+            "'": string[];
+            "\"": string[];
+            " ": string[];
+        };
+    };
+    shade: {
+        name: string;
+        version: string;
+        homepage: string;
+        colors: number;
+        lines: number;
+        buffer: string[];
+        letterspace: string[];
+        letterspace_size: number;
+        chars: {
+            A: string[];
+            B: string[];
+            C: string[];
+            D: string[];
+            E: string[];
+            F: string[];
+            G: string[];
+            H: string[];
+            I: string[];
+            J: string[];
+            K: string[];
+            L: string[];
+            M: string[];
+            N: string[];
+            O: string[];
+            P: string[];
+            Q: string[];
+            R: string[];
+            S: string[];
+            T: string[];
+            U: string[];
+            V: string[];
+            W: string[];
+            X: string[];
+            Y: string[];
+            Z: string[];
+            "0": string[];
+            "1": string[];
+            "2": string[];
+            "3": string[];
+            "4": string[];
+            "5": string[];
+            "6": string[];
+            "7": string[];
+            "8": string[];
+            "9": string[];
+            "!": string[];
+            "?": string[];
+            ".": string[];
+            "+": string[];
+            "-": string[];
+            _: string[];
+            "=": string[];
+            "@": string[];
+            "#": string[];
+            $: string[];
+            "%": string[];
+            "&": string[];
+            "(": string[];
+            ")": string[];
+            "/": string[];
+            ":": string[];
+            ";": string[];
+            ",": string[];
+            "'": string[];
+            "\"": string[];
+            " ": string[];
+        };
+    };
+    slick: {
+        name: string;
+        version: string;
+        homepage: string;
+        colors: number;
+        lines: number;
+        buffer: string[];
+        letterspace: string[];
+        letterspace_size: number;
+        chars: {
+            A: string[];
+            B: string[];
+            C: string[];
+            D: string[];
+            E: string[];
+            F: string[];
+            G: string[];
+            H: string[];
+            I: string[];
+            J: string[];
+            K: string[];
+            L: string[];
+            M: string[];
+            N: string[];
+            O: string[];
+            P: string[];
+            Q: string[];
+            R: string[];
+            S: string[];
+            T: string[];
+            U: string[];
+            V: string[];
+            W: string[];
+            X: string[];
+            Y: string[];
+            Z: string[];
+            "0": string[];
+            "1": string[];
+            "2": string[];
+            "3": string[];
+            "4": string[];
+            "5": string[];
+            "6": string[];
+            "7": string[];
+            "8": string[];
+            "9": string[];
+            "!": string[];
+            "?": string[];
+            ".": string[];
+            "+": string[];
+            "-": string[];
+            _: string[];
+            "=": string[];
+            "@": string[];
+            "#": string[];
+            $: string[];
+            "%": string[];
+            "&": string[];
+            "(": string[];
+            ")": string[];
+            "/": string[];
+            ":": string[];
+            ";": string[];
+            ",": string[];
+            "'": string[];
+            "\"": string[];
+            " ": string[];
+        };
+    };
+    huge: {
+        name: string;
+        version: string;
+        homepage: string;
+        colors: number;
+        lines: number;
+        buffer: string[];
+        letterspace: string[];
+        letterspace_size: number;
+        chars: {
+            A: string[];
+            B: string[];
+            C: string[];
+            D: string[];
+            E: string[];
+            F: string[];
+            G: string[];
+            H: string[];
+            I: string[];
+            J: string[];
+            K: string[];
+            L: string[];
+            M: string[];
+            N: string[];
+            O: string[];
+            P: string[];
+            Q: string[];
+            R: string[];
+            S: string[];
+            T: string[];
+            U: string[];
+            V: string[];
+            W: string[];
+            X: string[];
+            Y: string[];
+            Z: string[];
+            "0": string[];
+            "1": string[];
+            "2": string[];
+            "3": string[];
+            "4": string[];
+            "5": string[];
+            "6": string[];
+            "7": string[];
+            "8": string[];
+            "9": string[];
+            "!": string[];
+            "?": string[];
+            ".": string[];
+            "+": string[];
+            "-": string[];
+            _: string[];
+            "=": string[];
+            "@": string[];
+            "#": string[];
+            $: string[];
+            "%": string[];
+            "&": string[];
+            "(": string[];
+            ")": string[];
+            "/": string[];
+            ":": string[];
+            ";": string[];
+            ",": string[];
+            "'": string[];
+            "\"": string[];
+            " ": string[];
+        };
+    };
+    grid: {
+        name: string;
+        version: string;
+        homepage: string;
+        colors: number;
+        lines: number;
+        buffer: string[];
+        letterspace: string[];
+        letterspace_size: number;
+        chars: {
+            A: string[];
+            B: string[];
+            C: string[];
+            D: string[];
+            E: string[];
+            F: string[];
+            G: string[];
+            H: string[];
+            I: string[];
+            J: string[];
+            K: string[];
+            L: string[];
+            M: string[];
+            N: string[];
+            O: string[];
+            P: string[];
+            Q: string[];
+            R: string[];
+            S: string[];
+            T: string[];
+            U: string[];
+            V: string[];
+            W: string[];
+            X: string[];
+            Y: string[];
+            Z: string[];
+            "0": string[];
+            "1": string[];
+            "2": string[];
+            "3": string[];
+            "4": string[];
+            "5": string[];
+            "6": string[];
+            "7": string[];
+            "8": string[];
+            "9": string[];
+            "!": string[];
+            "?": string[];
+            ".": string[];
+            "+": string[];
+            "-": string[];
+            _: string[];
+            "=": string[];
+            "@": string[];
+            "#": string[];
+            $: string[];
+            "%": string[];
+            "&": string[];
+            "(": string[];
+            ")": string[];
+            "/": string[];
+            ":": string[];
+            ";": string[];
+            ",": string[];
+            "'": string[];
+            "\"": string[];
+            " ": string[];
+        };
+    };
+    pallet: {
+        name: string;
+        version: string;
+        homepage: string;
+        colors: number;
+        lines: number;
+        buffer: string[];
+        letterspace: string[];
+        letterspace_size: number;
+        chars: {
+            A: string[];
+            B: string[];
+            C: string[];
+            D: string[];
+            E: string[];
+            F: string[];
+            G: string[];
+            H: string[];
+            I: string[];
+            J: string[];
+            K: string[];
+            L: string[];
+            M: string[];
+            N: string[];
+            O: string[];
+            P: string[];
+            Q: string[];
+            R: string[];
+            S: string[];
+            T: string[];
+            U: string[];
+            V: string[];
+            W: string[];
+            X: string[];
+            Y: string[];
+            Z: string[];
+            "0": string[];
+            "1": string[];
+            "2": string[];
+            "3": string[];
+            "4": string[];
+            "5": string[];
+            "6": string[];
+            "7": string[];
+            "8": string[];
+            "9": string[];
+            "!": string[];
+            "?": string[];
+            ".": string[];
+            "+": string[];
+            "-": string[];
+            _: string[];
+            "=": string[];
+            "@": string[];
+            "#": string[];
+            $: string[];
+            "%": string[];
+            "&": string[];
+            "(": string[];
+            ")": string[];
+            "/": string[];
+            ":": string[];
+            ";": string[];
+            ",": string[];
+            "'": string[];
+            "\"": string[];
+            " ": string[];
+        };
+    };
+};
+export declare function measureText({ text, font }: {
+    text: string;
+    font?: keyof typeof fonts;
+}): {
+    width: number;
+    height: number;
+};
+export declare function getCharacterPositions(text: string, font?: keyof typeof fonts): number[];
+export declare function coordinateToCharacterIndex(x: number, text: string, font?: keyof typeof fonts): number;
+export declare function renderFontToFrameBuffer(buffer: OptimizedBuffer, { text, x, y, color, backgroundColor, font, }: {
+    text: string;
+    x?: number;
+    y?: number;
+    color?: ColorInput | ColorInput[];
+    backgroundColor?: ColorInput;
+    font?: keyof typeof fonts;
+}): {
+    width: number;
+    height: number;
+};

package/lib/border.d.ts

@@ -0,0 +1,49 @@
+import type { ColorInput } from "./RGBA";
+export interface BorderCharacters {
+    topLeft: string;
+    topRight: string;
+    bottomLeft: string;
+    bottomRight: string;
+    horizontal: string;
+    vertical: string;
+    topT: string;
+    bottomT: string;
+    leftT: string;
+    rightT: string;
+    cross: string;
+}
+export type BorderStyle = "single" | "double" | "rounded" | "heavy";
+export type BorderSides = "top" | "right" | "bottom" | "left";
+export declare function isValidBorderStyle(value: unknown): value is BorderStyle;
+export declare function parseBorderStyle(value: unknown, fallback?: BorderStyle): BorderStyle;
+export declare const BorderChars: Record<BorderStyle, BorderCharacters>;
+export interface BorderConfig {
+    borderStyle: BorderStyle;
+    border: boolean | BorderSides[];
+    borderColor?: ColorInput;
+    customBorderChars?: BorderCharacters;
+}
+export interface BoxDrawOptions {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+    borderStyle: BorderStyle;
+    border: boolean | BorderSides[];
+    borderColor: ColorInput;
+    customBorderChars?: BorderCharacters;
+    backgroundColor: ColorInput;
+    shouldFill?: boolean;
+    title?: string;
+    titleAlignment?: "left" | "center" | "right";
+}
+export interface BorderSidesConfig {
+    top: boolean;
+    right: boolean;
+    bottom: boolean;
+    left: boolean;
+}
+export declare function getBorderFromSides(sides: BorderSidesConfig): boolean | BorderSides[];
+export declare function getBorderSides(border: boolean | BorderSides[]): BorderSidesConfig;
+export declare function borderCharsToArray(chars: BorderCharacters): Uint32Array;
+export declare const BorderCharArrays: Record<BorderStyle, Uint32Array>;

package/lib/bunfs.d.ts

@@ -0,0 +1,7 @@
+export declare function isBunfsPath(path: string): boolean;
+export declare function getBunfsRootPath(): string;
+/**
+ * Normalizes a path to the embedded root.
+ * Flattens directory structure to ensure file exists at root.
+ */
+export declare function normalizeBunfsPath(fileName: string): string;

package/lib/clipboard.d.ts

@@ -0,0 +1,17 @@
+import type { Pointer } from "bun:ffi";
+import type { RenderLib } from "../zig";
+export declare enum ClipboardTarget {
+    Clipboard = 0,
+    Primary = 1,
+    Secondary = 2,
+    Query = 3
+}
+export declare function encodeOsc52Payload(text: string, encoder?: TextEncoder): Uint8Array;
+export declare class Clipboard {
+    private lib;
+    private rendererPtr;
+    constructor(lib: RenderLib, rendererPtr: Pointer);
+    copyToClipboardOSC52(text: string, target?: ClipboardTarget): boolean;
+    clearClipboardOSC52(target?: ClipboardTarget): boolean;
+    isOsc52Supported(): boolean;
+}

package/lib/data-paths.d.ts

@@ -0,0 +1,26 @@
+import { EventEmitter } from "events";
+export interface DataPaths {
+    globalConfigPath: string;
+    globalConfigFile: string;
+    localConfigFile: string;
+    globalDataPath: string;
+}
+export interface DataPathsEvents {
+    "paths:changed": [paths: DataPaths];
+}
+export declare class DataPathsManager extends EventEmitter<DataPathsEvents> {
+    private _appName;
+    private _globalConfigPath?;
+    private _globalConfigFile?;
+    private _localConfigFile?;
+    private _globalDataPath?;
+    constructor();
+    get appName(): string;
+    set appName(value: string);
+    get globalConfigPath(): string;
+    get globalConfigFile(): string;
+    get localConfigFile(): string;
+    get globalDataPath(): string;
+    toObject(): DataPaths;
+}
+export declare function getDataPaths(): DataPathsManager;