[READ-ONLY] Mirror of https://github.com/bombshell-dev/tty. Platform independent 2D layout engine for terminal applications based on Clay bomb.sh/docs/tty
Something went wrong. Try again.
tty term-native.ts
8.3 kB · 269 lines
TypeScript
123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270import { f32, offsets, struct } from "./typedef.ts";
export interface BoundingBox { x: number; y: number; width: number; height: number;}
const BoundingBoxStruct = struct<BoundingBox>({ x: f32(), y: f32(), width: f32(), height: f32(),});
const BOUNDING_BOX = offsets(BoundingBoxStruct);
const WASM_PAGE_BYTES = 65536;const TEXT_TRANSFER_BUFFER_BYTES = 1024 * 1024;const CLAY_DEFAULT_MAX_ELEMENT_COUNT = 8192;
// Conservative fixed wire-format budget per element. This covers the largest// non-text open/close element encoding we currently support; text, element id,// and snapshot payload bytes live in TEXT_TRANSFER_BUFFER_BYTES.const MAX_FIXED_ELEMENT_WIRE_BYTES = 116;
/** Color capability evidence the renderer consumes for emission * (color-encoding-spec §4.2). The default colors are the §7.9 chain's * resolution (reported theme > defaultTheme > black/white), packed as * 24-bit RGB. */export interface ColorCaps { colors: number; trueColor: boolean; defaultBg: number; defaultFg: number;}
export interface Native { memory: WebAssembly.Memory; statePtr: number; opsBuf: number; /** The color capability evidence currently held by the renderer. */ readonly caps: ColorCaps; /** * Re-initialize renderer state for new dimensions in place * (renderer-spec 7.7). Reuses this instance and memory; statePtr and * opsBuf may change. Growing memory detaches prior buffer views. */ update(w: number, h: number): void; /** * Push color capability evidence into the renderer. Called by the * host after update() folds capability events that change any value * (color-encoding-spec §4.2); re-pushed internally after any re-init * so the values survive resize updates. */ setCapabilities( colors: number, trueColor: boolean, defaultBg: number, defaultFg: number, ): void; reduce( ct: number, buf: number, len: number, mode: number, row: number, deltaTime: number, ): void; output(ct: number): number; length(ct: number): number; setPointer(x: number, y: number, down: boolean): void; getPointerOverIds(): string[]; getElementBounds(id: string): BoundingBox | undefined; animating(ct: number): number; errorCount(ct: number): number; errorType(ct: number, index: number): number; errorMessage(ct: number, index: number): string;}
import { compiled } from "./wasm.ts";
export async function createTermNative( w: number, h: number, caps: ColorCaps,): Promise<Native> { let memory = new WebAssembly.Memory({ initial: 2 }); let exports: Record<string, CallableFunction> = {};
let instance = await WebAssembly.instantiate(compiled, { env: { memory }, clay: { measureTextFunction( ret: number, text: number, _config: number, _userData: number, ) { exports.measure(ret, text); }, queryScrollOffsetFunction( ret: number, _elementId: number, _userData: number, ) { let view = new DataView(memory.buffer); view.setFloat32(ret, 0, true); view.setFloat32(ret + 4, 0, true); }, }, });
Object.assign(exports, instance.exports);
let ct = exports as unknown as { __heap_base: WebAssembly.Global; clayterm_size(w: number, h: number): number; init(mem: number, w: number, h: number): number; reduce( ct: number, buf: number, len: number, mode: number, row: number, deltaTime: number, ): void; output(ct: number): number; length(ct: number): number; set_capabilities( ct: number, colors: number, truecolor: number, default_bg: number, default_fg: number, ): void; Clay_SetPointerState(vec: number, down: number): void; pointer_over_count(): number; pointer_over_id_string_length(index: number): number; pointer_over_id_string_ptr(index: number): number; get_element_bounds(name: number, len: number, out: number): number; animating(ct: number): number; error_count(ct: number): number; error_type(ct: number, index: number): number; error_message_length(ct: number, index: number): number; error_message_ptr(ct: number, index: number): number; };
// The transfer budget is intentionally fixed: text/id/snapshot payload bytes // get 1MB, and fixed op overhead gets one max-sized element per Clay element. // Do not grow this dynamically per render; improve the wire format instead. let transferBytes = TEXT_TRANSFER_BUFFER_BYTES + CLAY_DEFAULT_MAX_ELEMENT_COUNT * MAX_FIXED_ELEMENT_WIRE_BYTES;
let statePtr!: number; let opsBuf = 0;
// Current color capability evidence. init() zeroes instance state, so // the values are re-pushed after every (re)init — this is what makes // the evidence survive resize updates (color-encoding-spec §4.2). let currentCaps: ColorCaps = caps;
function pushCaps(): void { ct.set_capabilities( statePtr, currentCaps.colors, currentCaps.trueColor ? 1 : 0, currentCaps.defaultBg, currentCaps.defaultFg, ); }
// Renderer state and the fixed transfer buffer share linear memory as // [heap: state][opsBuf]; opsBuf moves when the state size changes. Memory is // grown to fit but never reclaimed, so a downsize keeps the high-water mark // (renderer-spec 7.7). function layout(lw: number, lh: number): void { let heap = ct.__heap_base.value as number; let size = ct.clayterm_size(lw, lh); let needed = heap + size + transferBytes; let pages = Math.ceil(needed / WASM_PAGE_BYTES); let current = memory.buffer.byteLength / WASM_PAGE_BYTES; if (pages > current) { memory.grow(pages - current); } statePtr = ct.init(heap, lw, lh); opsBuf = (heap + size + 3) & ~3; pushCaps(); } layout(w, h);
return { memory, get statePtr() { return statePtr; }, get opsBuf() { return opsBuf; }, get caps(): ColorCaps { return currentCaps; }, update(uw: number, uh: number): void { layout(uw, uh); }, setCapabilities( colors: number, trueColor: boolean, defaultBg: number, defaultFg: number, ): void { currentCaps = { colors, trueColor, defaultBg, defaultFg }; pushCaps(); }, reduce: ct.reduce, output: ct.output, length: ct.length, animating: ct.animating, setPointer(x: number, y: number, down: boolean) { let view = new DataView(memory.buffer); view.setFloat32(opsBuf, x, true); view.setFloat32(opsBuf + 4, y, true); ct.Clay_SetPointerState(opsBuf, down ? 1 : 0); }, getPointerOverIds(): string[] { let decoder = new TextDecoder(); let count = ct.pointer_over_count(); let ids: string[] = []; for (let i = 0; i < count; i++) { let len = ct.pointer_over_id_string_length(i); if (len === 0) continue; let ptr = ct.pointer_over_id_string_ptr(i); ids.push(decoder.decode(new Uint8Array(memory.buffer, ptr, len))); } return ids; }, getElementBounds(id: string): BoundingBox | undefined { let enc = new TextEncoder(); let bytes = enc.encode(id); new Uint8Array(memory.buffer).set(bytes, opsBuf); let out = opsBuf + 256; let found = ct.get_element_bounds(opsBuf, bytes.length, out); if (!found) { return undefined; } let view = new DataView(memory.buffer); return { x: view.getFloat32(out + BOUNDING_BOX.x, true), y: view.getFloat32(out + BOUNDING_BOX.y, true), width: view.getFloat32(out + BOUNDING_BOX.width, true), height: view.getFloat32(out + BOUNDING_BOX.height, true), }; }, errorCount(ptr: number): number { return ct.error_count(ptr); }, errorType(ptr: number, index: number): number { return ct.error_type(ptr, index); }, errorMessage(ptr: number, index: number): string { let len = ct.error_message_length(ptr, index); if (len === 0) return ""; let p = ct.error_message_ptr(ptr, index); let decoder = new TextDecoder(); return decoder.decode(new Uint8Array(memory.buffer, p, len)); }, };}