@gridland/core 0.2.21

package/dist/index.d.ts

@@ -0,0 +1,287 @@
+export { useKeyboard, useTerminalDimensions } from '@opentui/react';
+import { EventEmitter } from 'events';
+import * as react from 'react';
+import { ReactNode } from 'react';
+
+interface ReadableCharBuffer {
+    width: number;
+    height: number;
+    char: Uint32Array;
+}
+declare function bufferToText(buffer: ReadableCharBuffer): string;
+
+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;
+    get r(): number;
+    set r(v: number);
+    get g(): number;
+    set g(v: number);
+    get b(): number;
+    set b(v: number);
+    get a(): number;
+    set a(v: number);
+    toInts(): [number, number, number, number];
+    map<R>(fn: (value: number) => R): R[];
+    toString(): string;
+    equals(other?: RGBA): boolean;
+}
+
+type CursorStyle = "block" | "line" | "underline";
+type MousePointerStyle = "default" | "pointer" | "text" | "crosshair" | "move" | "not-allowed";
+type WidthMethod$1 = "wcwidth" | "unicode";
+interface CursorStyleOptions {
+    style?: CursorStyle;
+    blinking?: boolean;
+    color?: RGBA;
+    cursor?: MousePointerStyle;
+}
+interface RenderContext {
+    addToHitGrid: (x: number, y: number, width: number, height: number, id: number) => void;
+    pushHitGridScissorRect: (x: number, y: number, width: number, height: number) => void;
+    popHitGridScissorRect: () => void;
+    clearHitGridScissorRects: () => void;
+    width: number;
+    height: number;
+    requestRender: () => void;
+    setCursorPosition: (x: number, y: number, visible: boolean) => void;
+    setCursorStyle: (options: CursorStyleOptions) => void;
+    setCursorColor: (color: RGBA) => void;
+    setMousePointer: (shape: MousePointerStyle) => void;
+    widthMethod: WidthMethod$1;
+    capabilities: any | null;
+    requestLive: () => void;
+    dropLive: () => void;
+    hasSelection: boolean;
+    getSelection: () => any | null;
+    requestSelectionUpdate: () => void;
+    currentFocusedRenderable: any | null;
+    focusRenderable: (renderable: any) => void;
+    registerLifecyclePass: (renderable: any) => void;
+    unregisterLifecyclePass: (renderable: any) => void;
+    getLifecyclePasses: () => Set<any>;
+    keyInput: any;
+    _internalKeyInput: any;
+    clearSelection: () => void;
+    startSelection: (renderable: any, x: number, y: number) => void;
+    updateSelection: (currentRenderable: any | undefined, x: number, y: number, options?: {
+        finishDragging?: boolean;
+    }) => void;
+    on: (event: string, listener: (...args: any[]) => void) => any;
+    off: (event: string, listener: (...args: any[]) => void) => any;
+    emit: (event: string, ...args: any[]) => boolean;
+    removeAllListeners: (event?: string) => any;
+}
+interface CapturedSpan {
+    text: string;
+    fg: RGBA;
+    bg: RGBA;
+    attributes: number;
+    width: number;
+}
+interface CapturedLine {
+    spans: CapturedSpan[];
+}
+
+type WidthMethod = "wcwidth" | "unicode";
+interface BorderDrawOptions {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+    borderStyle?: string;
+    customBorderChars?: Uint32Array;
+    border: boolean | string[];
+    borderColor: RGBA;
+    backgroundColor: RGBA;
+    shouldFill?: boolean;
+    title?: string;
+    titleAlignment?: "left" | "center" | "right";
+}
+declare class BrowserBuffer {
+    id: string;
+    respectAlpha: boolean;
+    private _width;
+    private _height;
+    private _widthMethod;
+    char: Uint32Array;
+    fg: Float32Array;
+    bg: Float32Array;
+    attributes: Uint32Array;
+    private scissorStack;
+    private opacityStack;
+    linkRegistry: Map<number, string>;
+    private nextLinkId;
+    /** Cursor rendering config -- set by renderer before pipeline, read by drawEditorView */
+    cursorColor: RGBA | null;
+    cursorStyleType: CursorStyle;
+    /** Line cursor position -- set by drawEditorView during pipeline, read by renderer after */
+    lineCursorPosition: {
+        x: number;
+        y: number;
+    } | null;
+    constructor(width: number, height: number, options?: {
+        respectAlpha?: boolean;
+        id?: string;
+        widthMethod?: WidthMethod;
+    });
+    static create(width: number, height: number, widthMethod: WidthMethod, options?: {
+        respectAlpha?: boolean;
+        id?: string;
+    }): BrowserBuffer;
+    get width(): number;
+    get height(): number;
+    get widthMethod(): WidthMethod;
+    get ptr(): number;
+    get buffers(): {
+        char: Uint32Array<ArrayBufferLike>;
+        fg: Float32Array<ArrayBufferLike>;
+        bg: Float32Array<ArrayBufferLike>;
+        attributes: Uint32Array<ArrayBufferLike>;
+    };
+    setRespectAlpha(respectAlpha: boolean): void;
+    getNativeId(): string;
+    registerLink(url: string): number;
+    getLinkUrl(linkId: number): string | undefined;
+    private isInScissor;
+    private getCurrentOpacityMultiplier;
+    private applyOpacity;
+    clear(bg?: RGBA): void;
+    setCell(x: number, y: number, char: string, fgColor: RGBA, bgColor: RGBA, attr?: number): void;
+    setCellWithAlphaBlending(x: number, y: number, char: string, fgColor: RGBA, bgColor: RGBA, attr?: number): void;
+    drawChar(charCode: number, x: number, y: number, fgColor: RGBA, bgColor: RGBA, attr?: number): void;
+    drawText(text: string, x: number, y: number, fgColor: RGBA, bgColor?: RGBA, attr?: number, _selection?: {
+        start: number;
+        end: number;
+        bgColor?: RGBA;
+        fgColor?: RGBA;
+    } | null): void;
+    fillRect(x: number, y: number, width: number, height: number, bgColor: RGBA): void;
+    drawBox(options: BorderDrawOptions): void;
+    private getDefaultBorderChars;
+    pushScissorRect(x: number, y: number, width: number, height: number): void;
+    popScissorRect(): void;
+    clearScissorRects(): void;
+    pushOpacity(opacity: number): void;
+    popOpacity(): void;
+    getCurrentOpacity(): number;
+    clearOpacity(): void;
+    resize(width: number, height: number): void;
+    getSpanLines(): CapturedLine[];
+    drawTextBufferView(view: any, x: number, y: number): void;
+    drawTextBuffer(textBufferView: any, x: number, y: number): void;
+    drawFrameBuffer(destX: number, destY: number, frameBuffer: BrowserBuffer, sourceX?: number, sourceY?: number, sourceWidth?: number, sourceHeight?: number): void;
+    drawEditorView(editorView: any, x: number, y: number): void;
+    drawSuperSampleBuffer(): void;
+    drawPackedBuffer(): void;
+    drawGrayscaleBuffer(): void;
+    drawGrayscaleBufferSupersampled(): void;
+    drawGrid(): void;
+    encodeUnicode(_text: string): null;
+    freeUnicode(): void;
+    getRealCharBytes(): Uint8Array;
+    destroy(): void;
+}
+
+declare class BrowserKeyHandler extends EventEmitter {
+    constructor();
+    processInput(_data: string): boolean;
+}
+declare class BrowserInternalKeyHandler extends BrowserKeyHandler {
+    private renderableHandlers;
+    onInternal(event: string, handler: Function): void;
+    offInternal(event: string, handler: Function): void;
+    emit(event: string, ...args: any[]): boolean;
+}
+declare class BrowserRenderContext extends EventEmitter implements RenderContext {
+    private _width;
+    private _height;
+    private _widthMethod;
+    private _renderRequested;
+    private _onRenderRequest;
+    private _lifecyclePasses;
+    private _focusedRenderable;
+    cursorColor: RGBA | null;
+    cursorStyleType: CursorStyle;
+    cursorBlinking: boolean;
+    keyInput: BrowserKeyHandler;
+    _internalKeyInput: BrowserInternalKeyHandler;
+    constructor(width: number, height: number, widthMethod?: WidthMethod$1);
+    get width(): number;
+    get height(): number;
+    get widthMethod(): WidthMethod$1;
+    get capabilities(): any;
+    get hasSelection(): boolean;
+    get currentFocusedRenderable(): any | null;
+    setOnRenderRequest(callback: () => void): void;
+    resize(width: number, height: number): void;
+    addToHitGrid(_x: number, _y: number, _width: number, _height: number, _id: number): void;
+    pushHitGridScissorRect(_x: number, _y: number, _width: number, _height: number): void;
+    popHitGridScissorRect(): void;
+    clearHitGridScissorRects(): void;
+    requestRender(): void;
+    setCursorPosition(_x: number, _y: number, _visible: boolean): void;
+    setCursorStyle(options: CursorStyleOptions): void;
+    setCursorColor(color: RGBA): void;
+    setMousePointer(_shape: MousePointerStyle): void;
+    requestLive(): void;
+    dropLive(): void;
+    getSelection(): any | null;
+    requestSelectionUpdate(): void;
+    focusRenderable(renderable: any): void;
+    registerLifecyclePass(renderable: any): void;
+    unregisterLifecyclePass(renderable: any): void;
+    getLifecyclePasses(): Set<any>;
+    clearSelection(): void;
+    startSelection(_renderable: any, _x: number, _y: number): void;
+    updateSelection(_currentRenderable: any | undefined, _x: number, _y: number, _options?: {
+        finishDragging?: boolean;
+    }): void;
+}
+
+declare function setHeadlessRootRenderableClass(cls: any): void;
+interface HeadlessRendererOptions {
+    cols: number;
+    rows: number;
+}
+declare class HeadlessRenderer {
+    buffer: BrowserBuffer;
+    renderContext: BrowserRenderContext;
+    root: any;
+    constructor(options: HeadlessRendererOptions);
+    renderOnce(): void;
+    toText(): string;
+    resize(cols: number, rows: number): void;
+}
+
+interface HeadlessRoot {
+    render(node: ReactNode): void;
+    renderToText(node: ReactNode): string;
+    unmount(): void;
+}
+declare function createHeadlessRoot(renderer: HeadlessRenderer): HeadlessRoot;
+
+interface BrowserContextValue {
+    renderContext: BrowserRenderContext;
+}
+declare const BrowserContext: react.Context<BrowserContextValue | null>;
+
+/**
+ * SSR-safe utilities for @gridland/web.
+ * These can be imported in any environment (Node.js, browser, edge).
+ */
+/** Check if running in a browser environment */
+declare function isBrowser(): boolean;
+/** Check if canvas is supported */
+declare function isCanvasSupported(): boolean;
+/** Calculate grid dimensions from pixel dimensions and font size */
+declare function calculateGridSize(widthPx: number, heightPx: number, cellWidth: number, cellHeight: number): {
+    cols: number;
+    rows: number;
+};
+
+export { BrowserContext, type BrowserContextValue, HeadlessRenderer, type HeadlessRendererOptions, type HeadlessRoot, bufferToText, calculateGridSize, createHeadlessRoot, isBrowser, isCanvasSupported, setHeadlessRootRenderableClass };