restty 0.1.16 → 0.1.18

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.18",
   "description": "Browser terminal rendering library powered by WASM, WebGPU/WebGL2, and TypeScript text shaping.",
   "keywords": [
     "terminal",
@@ -33,83 +33,30 @@
     "LICENSE"
   ],
   "type": "module",
-  "main": "./dist/index.js",
-  "module": "./dist/index.js",
+  "main": "./dist/restty.js",
+  "module": "./dist/restty.js",
   "types": "./dist/index.d.ts",
   "exports": {
     ".": {
       "types": "./dist/index.d.ts",
-      "import": "./dist/index.js",
-      "default": "./dist/index.js"
+      "import": "./dist/restty.js",
+      "default": "./dist/restty.js"
     },
     "./internal": {
       "types": "./dist/internal.d.ts",
       "import": "./dist/internal.js",
       "default": "./dist/internal.js"
-    },
-    "./app": {
-      "types": "./dist/app/index.d.ts",
-      "import": "./dist/app/index.js",
-      "default": "./dist/app/index.js"
-    },
-    "./pty": {
-      "types": "./dist/pty/index.d.ts",
-      "import": "./dist/pty/index.js",
-      "default": "./dist/pty/index.js"
-    },
-    "./input": {
-      "types": "./dist/input/index.d.ts",
-      "import": "./dist/input/index.js",
-      "default": "./dist/input/index.js"
-    },
-    "./theme": {
-      "types": "./dist/theme/index.d.ts",
-      "import": "./dist/theme/index.js",
-      "default": "./dist/theme/index.js"
-    },
-    "./wasm": {
-      "types": "./dist/wasm/index.d.ts",
-      "import": "./dist/wasm/index.js",
-      "default": "./dist/wasm/index.js"
-    },
-    "./fonts": {
-      "types": "./dist/fonts/index.d.ts",
-      "import": "./dist/fonts/index.js",
-      "default": "./dist/fonts/index.js"
-    },
-    "./renderer": {
-      "types": "./dist/renderer/index.d.ts",
-      "import": "./dist/renderer/index.js",
-      "default": "./dist/renderer/index.js"
-    },
-    "./grid": {
-      "types": "./dist/grid/index.d.ts",
-      "import": "./dist/grid/index.js",
-      "default": "./dist/grid/index.js"
-    },
-    "./selection": {
-      "types": "./dist/selection/index.d.ts",
-      "import": "./dist/selection/index.js",
-      "default": "./dist/selection/index.js"
-    },
-    "./ime": {
-      "types": "./dist/ime/index.d.ts",
-      "import": "./dist/ime/index.js",
-      "default": "./dist/ime/index.js"
     }
   },
   "scripts": {
     "setup:wgpu-polyfill": "bun run scripts/setup-wgpu-polyfill.ts",
     "clean:dist": "rm -rf dist && mkdir -p dist",
     "build:themes": "bun run scripts/generate-builtin-themes.ts",
-    "build:lib": "bun build ./src/index.ts ./src/internal.ts ./src/app/index.ts ./src/pty/index.ts ./src/input/index.ts ./src/theme/index.ts ./src/wasm/index.ts ./src/fonts/index.ts ./src/renderer/index.ts ./src/grid/index.ts ./src/selection/index.ts ./src/ime/index.ts --root ./src --outdir ./dist --target browser --format esm",
+    "build:lib": "bun run scripts/build-lib.ts",
     "build:types": "tsc -p tsconfig.build.json",
     "build": "bun run build:themes && bun run clean:dist && bun run build:lib && bun run build:types",
-    "build:text-shaper": "bun run playground/build-text-shaper.ts",
-    "build:restty-input": "bun run playground/build-restty-input.ts",
-    "build:restty-wasm": "bun run playground/build-restty-wasm.ts",
     "build:playground-app": "bun run playground/build-playground-app.ts",
-    "build:assets": "bun run build:text-shaper && bun run build:restty-input && bun run build:restty-wasm && bun run build:playground-app",
+    "build:assets": "bun run build:playground-app",
     "check:themes": "bun run build:themes && git diff --exit-code -- src/theme/builtin-themes.ts",
     "lint": "oxlint src playground scripts tests",
     "format:base": "oxfmt src --config .oxfmtrc.json --ignore-path .gitignore --ignore-path .oxfmtignore",
@@ -119,7 +66,7 @@
     "test": "bun test ./tests",
     "test:ci": "bun test $(find tests -name '*.test.ts' ! -name 'webgpu-glyph.test.ts' | sort)",
     "pty": "bun run playground/pty-server.ts",
-    "playground": "bun run playground/dev-server.ts",
+    "playground": "bun run scripts/playground-dev.ts",
     "playground:static": "bun run playground/server.ts"
   },
   "dependencies": {