restty 0.1.16 → 0.1.17

package/dist/wasm/runtime.d.ts

@@ -1,7 +1,15 @@
+/**
+ * WASM ABI variant identifier.
+ * - info: render state via single info struct
+ * - render: render state via separate pointer exports
+ * - cells: cell state via separate pointer exports
+ */
 export type WasmAbiKind = "info" | "render" | "cells";
+/** WASM ABI variant descriptor. */
 export type WasmAbi = {
     kind: WasmAbiKind;
 };
+/** Cursor state from WASM terminal core. */
 export type CursorInfo = {
     row: number;
     col: number;
@@ -11,6 +19,7 @@ export type CursorInfo = {
     wideTail: number;
     color: number;
 };
+/** Kitty graphics protocol image placement descriptor. */
 export type KittyPlacement = {
     imageId: number;
     imageFormat: number;
@@ -30,6 +39,7 @@ export type KittyPlacement = {
     sourceWidth: number;
     sourceHeight: number;
 };
+/** Terminal render state snapshot with typed array views into WASM memory. */
 export type RenderState = {
     rows: number;
     cols: number;
@@ -54,6 +64,7 @@ export type RenderState = {
     selectionEnd: Int16Array | null;
     cursor: CursorInfo | null;
 };
+/** WASM module exports for terminal core API. */
 export type ResttyWasmExports = WebAssembly.Exports & {
     memory: WebAssembly.Memory;
     restty_create: (cols: number, rows: number, maxScrollback: number) => number;
@@ -126,30 +137,48 @@ export type ResttyWasmExports = WebAssembly.Exports & {
     restty_kitty_placement_count?: (handle: number) => number;
     restty_kitty_placements_ptr?: (handle: number) => number;
 };
+/** Construction options for WASM runtime. */
 export type ResttyWasmOptions = {
     log?: (message: string) => void;
 };
+/** WASM terminal core runtime with memory management and typed array caching. */
 export declare class ResttyWasm {
     readonly exports: ResttyWasmExports;
     readonly abi: WasmAbi;
     readonly memory: WebAssembly.Memory;
     private readonly renderViewCaches;
     private constructor();
+    /** Load and instantiate the embedded WASM module. */
     static load(options?: ResttyWasmOptions): Promise<ResttyWasm>;
+    /** Create a new terminal instance and return its handle. */
     create(cols: number, rows: number, maxScrollback: number): number;
+    /** Destroy a terminal instance and free its resources. */
     destroy(handle: number): void;
     private getRenderViewCache;
+    /** Resize the terminal grid. */
     resize(handle: number, cols: number, rows: number): void;
+    /** Set pixel dimensions for Kitty graphics protocol. */
     setPixelSize(handle: number, widthPx: number, heightPx: number): void;
+    /** Update internal render buffers after state changes. */
     renderUpdate(handle: number): void;
+    /** Scroll the viewport by delta rows. */
     scrollViewport(handle: number, delta: number): void;
+    /** Read and clear pending output replies from terminal. */
     drainOutput(handle: number): string;
+    /** Get active Kitty keyboard protocol flags. */
     getKittyKeyboardFlags(handle: number): number;
+    /** Get all active Kitty graphics placements. */
     getKittyPlacements(handle: number): KittyPlacement[];
+    /** Write text to terminal for processing. */
     write(handle: number, text: string): void;
+    /** Set default colors for terminal (RGB packed as 0xRRGGBB). */
     setDefaultColors(handle: number, fg: number, bg: number, cursor: number): void;
+    /** Set terminal color palette (RGB triples). */
     setPalette(handle: number, colors: Uint8Array, count: number): void;
+    /** Reset terminal palette to defaults. */
     resetPalette(handle: number): void;
+    /** Get current render state with cached typed array views. */
     getRenderState(handle: number): RenderState | null;
 }
+/** Load and instantiate the embedded WASM module (convenience function). */
 export declare function loadResttyWasm(options?: ResttyWasmOptions): Promise<ResttyWasm>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "restty",
-  "version": "0.1.16",
+  "version": "0.1.17",
   "description": "Browser terminal rendering library powered by WASM, WebGPU/WebGL2, and TypeScript text shaping.",
   "keywords": [
     "terminal",