@vui-rs/core 0.1.0

package/README.md

@@ -0,0 +1,29 @@
+# @vui-rs/core
+
+Native terminal rendering engine for [vui-rs](https://github.com/open-ai-sdk/vui-rs) — a Rust cell buffer (truecolor, unicode/grapheme width, borders, [taffy](https://github.com/DioxusLabs/taffy) flexbox layout, inline images) driven from **Bun** via FFI.
+
+> **Runtime:** Bun only. This package loads a native library through `bun:ffi`; it does not run under Node.js.
+
+## Install
+
+```sh
+bun add @vui-rs/core
+```
+
+Prebuilt native binaries for `darwin-arm64`, `darwin-x64`, `linux-x64`, `linux-arm64`, and `win32-x64` ship inside the package; the loader picks the right one at runtime.
+
+## Usage
+
+```ts
+import { Renderer } from "@vui-rs/core";
+
+const r = new Renderer(80, 24);
+// …draw into the cell buffer, then flush.
+r.free();
+```
+
+Most apps use [`@vui-rs/vue`](https://www.npmjs.com/package/@vui-rs/vue) (a Vue custom renderer) on top of this engine rather than calling it directly.
+
+## License
+
+MIT

package/dist/char-width.d.ts

@@ -0,0 +1,7 @@
+//#region src/char-width.d.ts
+/** Column width of a single codepoint: 0 (combining/control), 1, or 2. */
+declare function charWidth(cp: number): number;
+/** Width of a single-codepoint string's leading codepoint (`charWidth` for graphemes). */
+declare function strWidth(ch: string): number;
+//#endregion
+export { charWidth, strWidth };

package/dist/char-width.js

@@ -0,0 +1,20 @@
+import { loadNativeLib } from "./native/load-native-lib.js";
+//#region src/char-width.ts
+const cache = /* @__PURE__ */ new Map();
+let lib = null;
+/** Column width of a single codepoint: 0 (combining/control), 1, or 2. */
+function charWidth(cp) {
+	const hit = cache.get(cp);
+	if (hit !== void 0) return hit;
+	lib ??= loadNativeLib();
+	const w = lib.symbols.vui_char_width(cp >>> 0);
+	cache.set(cp, w);
+	return w;
+}
+/** Width of a single-codepoint string's leading codepoint (`charWidth` for graphemes). */
+function strWidth(ch) {
+	const cp = ch.codePointAt(0);
+	return cp === void 0 ? 0 : charWidth(cp);
+}
+//#endregion
+export { charWidth, strWidth };

package/dist/color-names.js

@@ -0,0 +1,46 @@
+//#region src/color-names.json
+var color_names_default = {
+	black: "#000000",
+	white: "#ffffff",
+	red: "#ff0000",
+	green: "#008000",
+	lime: "#00ff00",
+	blue: "#0000ff",
+	yellow: "#ffff00",
+	cyan: "#00ffff",
+	aqua: "#00ffff",
+	magenta: "#ff00ff",
+	fuchsia: "#ff00ff",
+	gray: "#808080",
+	grey: "#808080",
+	silver: "#c0c0c0",
+	maroon: "#800000",
+	olive: "#808000",
+	navy: "#000080",
+	teal: "#008080",
+	purple: "#800080",
+	orange: "#ffa500",
+	gold: "#ffd700",
+	pink: "#ffc0cb",
+	brown: "#a52a2a",
+	coral: "#ff7f50",
+	salmon: "#fa8072",
+	tomato: "#ff6347",
+	crimson: "#dc143c",
+	indigo: "#4b0082",
+	violet: "#ee82ee",
+	turquoise: "#40e0d0",
+	skyblue: "#87ceeb",
+	royalblue: "#4169e1",
+	steelblue: "#4682b4",
+	slategray: "#708090",
+	slategrey: "#708090",
+	forestgreen: "#228b22",
+	seagreen: "#2e8b57",
+	khaki: "#f0e68c",
+	beige: "#f5f5dc",
+	ivory: "#fffff0",
+	transparent: "#00000000"
+};
+//#endregion
+export { color_names_default as default };

package/dist/color.d.ts

@@ -0,0 +1,5 @@
+//#region src/color.d.ts
+/** Coerce a prop value to a packed `0xRRGGBBAA` color, or `undefined` for unset. */
+declare function parseColor(value: unknown): number | undefined;
+//#endregion
+export { parseColor };

package/dist/color.js

@@ -0,0 +1,57 @@
+import { NAMED_COLORS, parseHex } from "./named-colors.js";
+//#region src/color.ts
+let warnedColors = null;
+/** Coerce a prop value to a packed `0xRRGGBBAA` color, or `undefined` for unset. */
+function parseColor(value) {
+	if (value == null) return void 0;
+	if (typeof value === "number") return value >>> 0;
+	if (typeof value === "string") {
+		const parsed = parseColorString(value.trim());
+		if (parsed !== void 0) return parsed;
+		warnBadColor(value);
+	}
+}
+function parseColorString(value) {
+	if (value.startsWith("#")) return parseHex(value);
+	if (value.startsWith("rgb")) return parseRgbFunction(value);
+	return NAMED_COLORS.get(value.toLowerCase());
+}
+function parseRgbFunction(value) {
+	const open = value.indexOf("(");
+	if (open < 0 || !value.endsWith(")")) return void 0;
+	const parts = value.slice(open + 1, -1).split(",").map((p) => p.trim());
+	if (parts.length < 3 || parts.length > 4) return void 0;
+	const r = channel(parts[0]);
+	const g = channel(parts[1]);
+	const b = channel(parts[2]);
+	if (r === void 0 || g === void 0 || b === void 0) return void 0;
+	let a = 255;
+	if (parts.length === 4) {
+		const raw = decimal(parts[3]);
+		if (raw === void 0) return void 0;
+		a = raw <= 1 ? Math.round(raw * 255) : Math.round(raw);
+	}
+	return (r << 24 | g << 16 | b << 8 | clamp255(a)) >>> 0;
+}
+function channel(s) {
+	const n = decimal(s);
+	return n === void 0 ? void 0 : clamp255(Math.round(n));
+}
+const DECIMAL = /^[+-]?(\d+\.?\d*|\.\d+)([eE][+-]?\d+)?$/;
+function decimal(s) {
+	if (!DECIMAL.test(s)) return void 0;
+	const n = Number(s);
+	return Number.isFinite(n) ? n : void 0;
+}
+function clamp255(n) {
+	return n < 0 ? 0 : n > 255 ? 255 : n;
+}
+function warnBadColor(value) {
+	if (process.env.NODE_ENV === "production") return;
+	warnedColors ??= /* @__PURE__ */ new Set();
+	if (warnedColors.has(value)) return;
+	warnedColors.add(value);
+	console.warn(`vui: unparseable color "${value}" — expected a number, #rrggbb(aa), rgb()/rgba(), or a named color; treated as unset`);
+}
+//#endregion
+export { parseColor };

package/dist/image-decode.d.ts

@@ -0,0 +1,21 @@
+//#region src/image-decode.d.ts
+interface DecodedImage {
+  width: number;
+  height: number;
+  /** Tightly-packed RGBA8, `width * height * 4` bytes (JS-owned copy). */
+  rgba: Uint8Array;
+}
+/**
+ * Decode `path` and fit within `maxW`×`maxH` pixels (aspect preserved; 0 = no
+ * resize). Returns null on any decode/read error so callers render nothing. The
+ * native handle is freed before returning — the pixels are copied out.
+ */
+declare function decodeImage(path: string, maxW?: number, maxH?: number): DecodedImage | null;
+/**
+ * Decode an image from in-memory bytes (format auto-detected) and fit within
+ * `maxW`×`maxH` px. For remote/fetched images the host already has as a buffer.
+ * Returns null on any decode error.
+ */
+declare function decodeImageBytes(bytes: Uint8Array, maxW?: number, maxH?: number): DecodedImage | null;
+//#endregion
+export { DecodedImage, decodeImage, decodeImageBytes };

package/dist/image-decode.js

@@ -0,0 +1,42 @@
+import { loadNativeLib } from "./native/load-native-lib.js";
+import { toArrayBuffer } from "bun:ffi";
+//#region src/image-decode.ts
+/**
+* Decode `path` and fit within `maxW`×`maxH` pixels (aspect preserved; 0 = no
+* resize). Returns null on any decode/read error so callers render nothing. The
+* native handle is freed before returning — the pixels are copied out.
+*/
+function decodeImage(path, maxW = 0, maxH = 0) {
+	const bytes = new TextEncoder().encode(path);
+	return readHandle((lib) => lib.symbols.vui_image_decode(bytes, bytes.byteLength, maxW, maxH));
+}
+/**
+* Decode an image from in-memory bytes (format auto-detected) and fit within
+* `maxW`×`maxH` px. For remote/fetched images the host already has as a buffer.
+* Returns null on any decode error.
+*/
+function decodeImageBytes(bytes, maxW = 0, maxH = 0) {
+	return readHandle((lib) => lib.symbols.vui_image_decode_bytes(bytes, bytes.byteLength, maxW, maxH));
+}
+/** Run a decode that yields a native handle, copy its RGBA out, and free it. */
+function readHandle(decode) {
+	const lib = loadNativeLib();
+	const handle = decode(lib);
+	if (handle === null) return null;
+	try {
+		const width = lib.symbols.vui_image_width(handle);
+		const height = lib.symbols.vui_image_height(handle);
+		const ptr = lib.symbols.vui_image_rgba_ptr(handle);
+		const len = Number(lib.symbols.vui_image_rgba_len(handle));
+		if (ptr === null || len === 0) return null;
+		return {
+			width,
+			height,
+			rgba: new Uint8Array(toArrayBuffer(ptr, 0, len)).slice()
+		};
+	} finally {
+		lib.symbols.vui_image_free(handle);
+	}
+}
+//#endregion
+export { decodeImage, decodeImageBytes };

package/dist/index.d.ts

@@ -0,0 +1,402 @@
+import { Attr, CELL_BYTES, EXPECTED_ABI_VERSION, EditMotion, EditMotionCode, LINK_SHIFT, NativeTextWrap, NativeTextWrapCode, NodeKindCode, STYLE_FFI_BYTES, Status, symbols } from "./native/ffi-symbols.js";
+import { NativeLib } from "./native/load-native-lib.js";
+import { parseColor } from "./color.js";
+import { NAMED_COLORS, parseHex } from "./named-colors.js";
+import { AlignValue, Dim, JustifyValue, Sides, VuiStyle, packStyle } from "./style.js";
+import { LayoutRect, RectEdges, TextRun, TextWrapName, VuiNode, hostTreeHash } from "./node.js";
+import { OffscreenBuffer } from "./offscreen-buffer.js";
+import { TextBuffer } from "./text/text-buffer.js";
+import { TextBufferView, TextMeasure, TextWrapMode, wrapCode } from "./text/text-buffer-view.js";
+import { EditBuffer } from "./text/edit-buffer.js";
+import { EditorView } from "./text/editor-view.js";
+import { ClipRect, Renderer, TextStyle, rgba } from "./renderer.js";
+import { charWidth, strWidth } from "./char-width.js";
+import { DecodedImage, decodeImage, decodeImageBytes } from "./image-decode.js";
+import { InputEvent, Key, KeyDecoder, KeyEvent, MouseButton, MouseEvent, PasteEvent, createKeyDecoder, matchesKey, parseKeys } from "./keys.js";
+import { TerminalSession, TerminalSessionOptions, createTerminalSession } from "./terminal-session.js";
+
+//#region src/index.d.ts
+/**
+ * Memoized handle to the loaded vui-core native library. The first call
+ * resolves, opens, and ABI-checks the library; subsequent calls reuse it.
+ */
+declare function getNativeLib(): import("bun:ffi").Library<{
+  readonly vui_version: {
+    readonly args: readonly [];
+    readonly returns: import("bun:ffi").FFIType.uint32_t;
+  };
+  readonly vui_abi_version: {
+    readonly args: readonly [];
+    readonly returns: import("bun:ffi").FFIType.uint32_t;
+  };
+  readonly vui_char_width: {
+    readonly args: readonly [import("bun:ffi").FFIType.uint32_t];
+    readonly returns: import("bun:ffi").FFIType.uint32_t;
+  };
+  readonly vui_renderer_new: {
+    readonly args: readonly [import("bun:ffi").FFIType.uint32_t, import("bun:ffi").FFIType.uint32_t];
+    readonly returns: import("bun:ffi").FFIType.ptr;
+  };
+  readonly vui_renderer_free: {
+    readonly args: readonly [import("bun:ffi").FFIType.ptr];
+    readonly returns: import("bun:ffi").FFIType.void;
+  };
+  readonly vui_renderer_resize: {
+    readonly args: readonly [import("bun:ffi").FFIType.ptr, import("bun:ffi").FFIType.uint32_t, import("bun:ffi").FFIType.uint32_t];
+    readonly returns: import("bun:ffi").FFIType.uint32_t;
+  };
+  readonly vui_renderer_back_buffer_ptr: {
+    readonly args: readonly [import("bun:ffi").FFIType.ptr];
+    readonly returns: import("bun:ffi").FFIType.ptr;
+  };
+  readonly vui_renderer_buffer_len: {
+    readonly args: readonly [import("bun:ffi").FFIType.ptr];
+    readonly returns: "usize";
+  };
+  readonly vui_cell_size_bytes: {
+    readonly args: readonly [];
+    readonly returns: "usize";
+  };
+  readonly vui_buffer_draw_text: {
+    readonly args: readonly [import("bun:ffi").FFIType.ptr, import("bun:ffi").FFIType.uint32_t, import("bun:ffi").FFIType.uint32_t, import("bun:ffi").FFIType.ptr, "usize", import("bun:ffi").FFIType.uint32_t, import("bun:ffi").FFIType.uint32_t, import("bun:ffi").FFIType.uint16_t];
+    readonly returns: import("bun:ffi").FFIType.uint32_t;
+  };
+  readonly vui_buffer_fill_rect: {
+    readonly args: readonly [import("bun:ffi").FFIType.ptr, import("bun:ffi").FFIType.uint32_t, import("bun:ffi").FFIType.uint32_t, import("bun:ffi").FFIType.uint32_t, import("bun:ffi").FFIType.uint32_t, import("bun:ffi").FFIType.uint32_t];
+    readonly returns: import("bun:ffi").FFIType.uint32_t;
+  };
+  readonly vui_buffer_set_cell: {
+    readonly args: readonly [import("bun:ffi").FFIType.ptr, import("bun:ffi").FFIType.uint32_t, import("bun:ffi").FFIType.uint32_t, import("bun:ffi").FFIType.uint32_t, import("bun:ffi").FFIType.uint32_t, import("bun:ffi").FFIType.uint32_t, import("bun:ffi").FFIType.uint16_t];
+    readonly returns: import("bun:ffi").FFIType.uint32_t;
+  };
+  readonly vui_buffer_clear: {
+    readonly args: readonly [import("bun:ffi").FFIType.ptr, import("bun:ffi").FFIType.uint32_t];
+    readonly returns: import("bun:ffi").FFIType.uint32_t;
+  };
+  readonly vui_renderer_render: {
+    readonly args: readonly [import("bun:ffi").FFIType.ptr];
+    readonly returns: import("bun:ffi").FFIType.uint32_t;
+  };
+  readonly vui_renderer_flush: {
+    readonly args: readonly [import("bun:ffi").FFIType.ptr];
+    readonly returns: import("bun:ffi").FFIType.uint32_t;
+  };
+  readonly vui_renderer_clear_links: {
+    readonly args: readonly [import("bun:ffi").FFIType.ptr];
+    readonly returns: import("bun:ffi").FFIType.uint32_t;
+  };
+  readonly vui_renderer_stage_link: {
+    readonly args: readonly [import("bun:ffi").FFIType.ptr, import("bun:ffi").FFIType.uint16_t, import("bun:ffi").FFIType.ptr, "usize"];
+    readonly returns: import("bun:ffi").FFIType.uint32_t;
+  };
+  readonly vui_renderer_stage_passthrough: {
+    readonly args: readonly [import("bun:ffi").FFIType.ptr, import("bun:ffi").FFIType.ptr, "usize"];
+    readonly returns: import("bun:ffi").FFIType.uint32_t;
+  };
+  readonly vui_image_decode: {
+    readonly args: readonly [import("bun:ffi").FFIType.ptr, "usize", import("bun:ffi").FFIType.uint32_t, import("bun:ffi").FFIType.uint32_t];
+    readonly returns: import("bun:ffi").FFIType.ptr;
+  };
+  readonly vui_renderer_stage_image_placement: {
+    readonly args: readonly [import("bun:ffi").FFIType.ptr, import("bun:ffi").FFIType.uint32_t, import("bun:ffi").FFIType.int32_t, import("bun:ffi").FFIType.int32_t];
+    readonly returns: import("bun:ffi").FFIType.uint32_t;
+  };
+  readonly vui_renderer_clear_image_placements: {
+    readonly args: readonly [import("bun:ffi").FFIType.ptr];
+    readonly returns: import("bun:ffi").FFIType.uint32_t;
+  };
+  readonly vui_image_decode_bytes: {
+    readonly args: readonly [import("bun:ffi").FFIType.ptr, "usize", import("bun:ffi").FFIType.uint32_t, import("bun:ffi").FFIType.uint32_t];
+    readonly returns: import("bun:ffi").FFIType.ptr;
+  };
+  readonly vui_image_width: {
+    readonly args: readonly [import("bun:ffi").FFIType.ptr];
+    readonly returns: import("bun:ffi").FFIType.uint32_t;
+  };
+  readonly vui_image_height: {
+    readonly args: readonly [import("bun:ffi").FFIType.ptr];
+    readonly returns: import("bun:ffi").FFIType.uint32_t;
+  };
+  readonly vui_image_rgba_ptr: {
+    readonly args: readonly [import("bun:ffi").FFIType.ptr];
+    readonly returns: import("bun:ffi").FFIType.ptr;
+  };
+  readonly vui_image_rgba_len: {
+    readonly args: readonly [import("bun:ffi").FFIType.ptr];
+    readonly returns: "usize";
+  };
+  readonly vui_image_free: {
+    readonly args: readonly [import("bun:ffi").FFIType.ptr];
+    readonly returns: import("bun:ffi").FFIType.void;
+  };
+  readonly vui_buffer_draw_text_clipped: {
+    readonly args: readonly [import("bun:ffi").FFIType.ptr, import("bun:ffi").FFIType.int32_t, import("bun:ffi").FFIType.int32_t, import("bun:ffi").FFIType.ptr, "usize", import("bun:ffi").FFIType.uint32_t, import("bun:ffi").FFIType.uint32_t, import("bun:ffi").FFIType.uint16_t, import("bun:ffi").FFIType.ptr];
+    readonly returns: import("bun:ffi").FFIType.uint32_t;
+  };
+  readonly vui_buffer_fill_rect_clipped: {
+    readonly args: readonly [import("bun:ffi").FFIType.ptr, import("bun:ffi").FFIType.int32_t, import("bun:ffi").FFIType.int32_t, import("bun:ffi").FFIType.uint32_t, import("bun:ffi").FFIType.uint32_t, import("bun:ffi").FFIType.uint32_t, import("bun:ffi").FFIType.ptr];
+    readonly returns: import("bun:ffi").FFIType.uint32_t;
+  };
+  readonly vui_buffer_set_cell_clipped: {
+    readonly args: readonly [import("bun:ffi").FFIType.ptr, import("bun:ffi").FFIType.int32_t, import("bun:ffi").FFIType.int32_t, import("bun:ffi").FFIType.uint32_t, import("bun:ffi").FFIType.uint32_t, import("bun:ffi").FFIType.uint32_t, import("bun:ffi").FFIType.uint16_t, import("bun:ffi").FFIType.ptr];
+    readonly returns: import("bun:ffi").FFIType.uint32_t;
+  };
+  readonly vui_buffer_blit: {
+    readonly args: readonly [import("bun:ffi").FFIType.ptr, import("bun:ffi").FFIType.ptr, import("bun:ffi").FFIType.int32_t, import("bun:ffi").FFIType.int32_t, import("bun:ffi").FFIType.ptr];
+    readonly returns: import("bun:ffi").FFIType.uint32_t;
+  };
+  readonly vui_buffer_draw_textbuffer: {
+    readonly args: readonly [import("bun:ffi").FFIType.ptr, import("bun:ffi").FFIType.ptr, import("bun:ffi").FFIType.int32_t, import("bun:ffi").FFIType.int32_t, import("bun:ffi").FFIType.uint32_t, import("bun:ffi").FFIType.uint32_t, import("bun:ffi").FFIType.uint8_t, import("bun:ffi").FFIType.uint16_t, import("bun:ffi").FFIType.ptr];
+    readonly returns: import("bun:ffi").FFIType.uint32_t;
+  };
+  readonly vui_buffer_draw_editor: {
+    readonly args: readonly [import("bun:ffi").FFIType.ptr, import("bun:ffi").FFIType.ptr, import("bun:ffi").FFIType.int32_t, import("bun:ffi").FFIType.int32_t, import("bun:ffi").FFIType.uint32_t, import("bun:ffi").FFIType.uint32_t, import("bun:ffi").FFIType.uint32_t, import("bun:ffi").FFIType.uint16_t, import("bun:ffi").FFIType.ptr];
+    readonly returns: import("bun:ffi").FFIType.uint32_t;
+  };
+  readonly vui_textbuf_new: {
+    readonly args: readonly [];
+    readonly returns: import("bun:ffi").FFIType.ptr;
+  };
+  readonly vui_textbuf_free: {
+    readonly args: readonly [import("bun:ffi").FFIType.ptr];
+    readonly returns: import("bun:ffi").FFIType.void;
+  };
+  readonly vui_textbuf_set_text: {
+    readonly args: readonly [import("bun:ffi").FFIType.ptr, import("bun:ffi").FFIType.ptr, "usize"];
+    readonly returns: import("bun:ffi").FFIType.uint32_t;
+  };
+  readonly vui_textbuf_set_runs: {
+    readonly args: readonly [import("bun:ffi").FFIType.ptr, import("bun:ffi").FFIType.ptr, "usize", import("bun:ffi").FFIType.ptr, "usize"];
+    readonly returns: import("bun:ffi").FFIType.uint32_t;
+  };
+  readonly vui_textbuf_line_count: {
+    readonly args: readonly [import("bun:ffi").FFIType.ptr];
+    readonly returns: import("bun:ffi").FFIType.uint32_t;
+  };
+  readonly vui_textbuf_length: {
+    readonly args: readonly [import("bun:ffi").FFIType.ptr];
+    readonly returns: import("bun:ffi").FFIType.uint32_t;
+  };
+  readonly vui_textview_new: {
+    readonly args: readonly [import("bun:ffi").FFIType.ptr];
+    readonly returns: import("bun:ffi").FFIType.ptr;
+  };
+  readonly vui_textview_free: {
+    readonly args: readonly [import("bun:ffi").FFIType.ptr];
+    readonly returns: import("bun:ffi").FFIType.void;
+  };
+  readonly vui_textview_set_wrap: {
+    readonly args: readonly [import("bun:ffi").FFIType.ptr, import("bun:ffi").FFIType.uint8_t];
+    readonly returns: import("bun:ffi").FFIType.uint32_t;
+  };
+  readonly vui_textview_set_width: {
+    readonly args: readonly [import("bun:ffi").FFIType.ptr, import("bun:ffi").FFIType.uint32_t];
+    readonly returns: import("bun:ffi").FFIType.uint32_t;
+  };
+  readonly vui_textview_measure: {
+    readonly args: readonly [import("bun:ffi").FFIType.ptr, import("bun:ffi").FFIType.uint32_t, import("bun:ffi").FFIType.uint8_t, import("bun:ffi").FFIType.ptr];
+    readonly returns: import("bun:ffi").FFIType.uint32_t;
+  };
+  readonly vui_editbuf_new: {
+    readonly args: readonly [];
+    readonly returns: import("bun:ffi").FFIType.ptr;
+  };
+  readonly vui_editbuf_free: {
+    readonly args: readonly [import("bun:ffi").FFIType.ptr];
+    readonly returns: import("bun:ffi").FFIType.void;
+  };
+  readonly vui_editbuf_set_value: {
+    readonly args: readonly [import("bun:ffi").FFIType.ptr, import("bun:ffi").FFIType.ptr, "usize"];
+    readonly returns: import("bun:ffi").FFIType.uint32_t;
+  };
+  readonly vui_editbuf_value_len: {
+    readonly args: readonly [import("bun:ffi").FFIType.ptr];
+    readonly returns: "usize";
+  };
+  readonly vui_editbuf_copy_value: {
+    readonly args: readonly [import("bun:ffi").FFIType.ptr, import("bun:ffi").FFIType.ptr, "usize"];
+    readonly returns: "usize";
+  };
+  readonly vui_editbuf_insert: {
+    readonly args: readonly [import("bun:ffi").FFIType.ptr, import("bun:ffi").FFIType.ptr, "usize"];
+    readonly returns: import("bun:ffi").FFIType.uint32_t;
+  };
+  readonly vui_editbuf_backspace: {
+    readonly args: readonly [import("bun:ffi").FFIType.ptr];
+    readonly returns: import("bun:ffi").FFIType.uint32_t;
+  };
+  readonly vui_editbuf_delete: {
+    readonly args: readonly [import("bun:ffi").FFIType.ptr];
+    readonly returns: import("bun:ffi").FFIType.uint32_t;
+  };
+  readonly vui_editbuf_newline: {
+    readonly args: readonly [import("bun:ffi").FFIType.ptr];
+    readonly returns: import("bun:ffi").FFIType.uint32_t;
+  };
+  readonly vui_editbuf_move: {
+    readonly args: readonly [import("bun:ffi").FFIType.ptr, import("bun:ffi").FFIType.uint8_t, import("bun:ffi").FFIType.uint8_t];
+    readonly returns: import("bun:ffi").FFIType.uint32_t;
+  };
+  readonly vui_editbuf_select_all: {
+    readonly args: readonly [import("bun:ffi").FFIType.ptr];
+    readonly returns: import("bun:ffi").FFIType.uint32_t;
+  };
+  readonly vui_editbuf_has_selection: {
+    readonly args: readonly [import("bun:ffi").FFIType.ptr];
+    readonly returns: import("bun:ffi").FFIType.uint32_t;
+  };
+  readonly vui_editbuf_selected_len: {
+    readonly args: readonly [import("bun:ffi").FFIType.ptr];
+    readonly returns: "usize";
+  };
+  readonly vui_editbuf_copy_selected: {
+    readonly args: readonly [import("bun:ffi").FFIType.ptr, import("bun:ffi").FFIType.ptr, "usize"];
+    readonly returns: "usize";
+  };
+  readonly vui_editbuf_delete_selection: {
+    readonly args: readonly [import("bun:ffi").FFIType.ptr, import("bun:ffi").FFIType.ptr];
+    readonly returns: import("bun:ffi").FFIType.uint32_t;
+  };
+  readonly vui_editbuf_undo: {
+    readonly args: readonly [import("bun:ffi").FFIType.ptr, import("bun:ffi").FFIType.ptr];
+    readonly returns: import("bun:ffi").FFIType.uint32_t;
+  };
+  readonly vui_editbuf_redo: {
+    readonly args: readonly [import("bun:ffi").FFIType.ptr, import("bun:ffi").FFIType.ptr];
+    readonly returns: import("bun:ffi").FFIType.uint32_t;
+  };
+  readonly vui_editbuf_can_undo: {
+    readonly args: readonly [import("bun:ffi").FFIType.ptr];
+    readonly returns: import("bun:ffi").FFIType.uint32_t;
+  };
+  readonly vui_editbuf_can_redo: {
+    readonly args: readonly [import("bun:ffi").FFIType.ptr];
+    readonly returns: import("bun:ffi").FFIType.uint32_t;
+  };
+  readonly vui_editbuf_cursor: {
+    readonly args: readonly [import("bun:ffi").FFIType.ptr, import("bun:ffi").FFIType.ptr, import("bun:ffi").FFIType.ptr];
+    readonly returns: import("bun:ffi").FFIType.uint32_t;
+  };
+  readonly vui_editor_new: {
+    readonly args: readonly [import("bun:ffi").FFIType.ptr, import("bun:ffi").FFIType.uint32_t, import("bun:ffi").FFIType.uint32_t];
+    readonly returns: import("bun:ffi").FFIType.ptr;
+  };
+  readonly vui_editor_free: {
+    readonly args: readonly [import("bun:ffi").FFIType.ptr];
+    readonly returns: import("bun:ffi").FFIType.void;
+  };
+  readonly vui_editor_set_wrap: {
+    readonly args: readonly [import("bun:ffi").FFIType.ptr, import("bun:ffi").FFIType.uint8_t];
+    readonly returns: import("bun:ffi").FFIType.uint32_t;
+  };
+  readonly vui_editor_set_viewport: {
+    readonly args: readonly [import("bun:ffi").FFIType.ptr, import("bun:ffi").FFIType.uint32_t, import("bun:ffi").FFIType.uint32_t];
+    readonly returns: import("bun:ffi").FFIType.uint32_t;
+  };
+  readonly vui_editor_set_focused: {
+    readonly args: readonly [import("bun:ffi").FFIType.ptr, import("bun:ffi").FFIType.uint8_t];
+    readonly returns: import("bun:ffi").FFIType.uint32_t;
+  };
+  readonly vui_editor_move: {
+    readonly args: readonly [import("bun:ffi").FFIType.ptr, import("bun:ffi").FFIType.uint8_t, import("bun:ffi").FFIType.uint8_t];
+    readonly returns: import("bun:ffi").FFIType.uint32_t;
+  };
+  readonly vui_editor_measure: {
+    readonly args: readonly [import("bun:ffi").FFIType.ptr, import("bun:ffi").FFIType.uint32_t, import("bun:ffi").FFIType.uint8_t, import("bun:ffi").FFIType.ptr];
+    readonly returns: import("bun:ffi").FFIType.uint32_t;
+  };
+  readonly vui_cbuf_new: {
+    readonly args: readonly [import("bun:ffi").FFIType.uint32_t, import("bun:ffi").FFIType.uint32_t];
+    readonly returns: import("bun:ffi").FFIType.ptr;
+  };
+  readonly vui_cbuf_free: {
+    readonly args: readonly [import("bun:ffi").FFIType.ptr];
+    readonly returns: import("bun:ffi").FFIType.void;
+  };
+  readonly vui_cbuf_resize: {
+    readonly args: readonly [import("bun:ffi").FFIType.ptr, import("bun:ffi").FFIType.uint32_t, import("bun:ffi").FFIType.uint32_t];
+    readonly returns: import("bun:ffi").FFIType.uint32_t;
+  };
+  readonly vui_cbuf_ptr: {
+    readonly args: readonly [import("bun:ffi").FFIType.ptr];
+    readonly returns: import("bun:ffi").FFIType.ptr;
+  };
+  readonly vui_cbuf_len: {
+    readonly args: readonly [import("bun:ffi").FFIType.ptr];
+    readonly returns: "usize";
+  };
+  readonly vui_cbuf_clear: {
+    readonly args: readonly [import("bun:ffi").FFIType.ptr, import("bun:ffi").FFIType.uint32_t];
+    readonly returns: import("bun:ffi").FFIType.uint32_t;
+  };
+  readonly vui_cbuf_draw_text: {
+    readonly args: readonly [import("bun:ffi").FFIType.ptr, import("bun:ffi").FFIType.uint32_t, import("bun:ffi").FFIType.uint32_t, import("bun:ffi").FFIType.ptr, "usize", import("bun:ffi").FFIType.uint32_t, import("bun:ffi").FFIType.uint32_t, import("bun:ffi").FFIType.uint16_t];
+    readonly returns: import("bun:ffi").FFIType.uint32_t;
+  };
+  readonly vui_cbuf_fill_rect: {
+    readonly args: readonly [import("bun:ffi").FFIType.ptr, import("bun:ffi").FFIType.uint32_t, import("bun:ffi").FFIType.uint32_t, import("bun:ffi").FFIType.uint32_t, import("bun:ffi").FFIType.uint32_t, import("bun:ffi").FFIType.uint32_t];
+    readonly returns: import("bun:ffi").FFIType.uint32_t;
+  };
+  readonly vui_cbuf_set_cell: {
+    readonly args: readonly [import("bun:ffi").FFIType.ptr, import("bun:ffi").FFIType.uint32_t, import("bun:ffi").FFIType.uint32_t, import("bun:ffi").FFIType.uint32_t, import("bun:ffi").FFIType.uint32_t, import("bun:ffi").FFIType.uint32_t, import("bun:ffi").FFIType.uint16_t];
+    readonly returns: import("bun:ffi").FFIType.uint32_t;
+  };
+  readonly vui_renderer_set_root: {
+    readonly args: readonly [import("bun:ffi").FFIType.ptr];
+    readonly returns: import("bun:ffi").FFIType.uint32_t;
+  };
+  readonly vui_node_new: {
+    readonly args: readonly [import("bun:ffi").FFIType.ptr, import("bun:ffi").FFIType.uint8_t];
+    readonly returns: import("bun:ffi").FFIType.uint32_t;
+  };
+  readonly vui_node_free: {
+    readonly args: readonly [import("bun:ffi").FFIType.ptr, import("bun:ffi").FFIType.uint32_t];
+    readonly returns: import("bun:ffi").FFIType.uint32_t;
+  };
+  readonly vui_node_append_child: {
+    readonly args: readonly [import("bun:ffi").FFIType.ptr, import("bun:ffi").FFIType.uint32_t, import("bun:ffi").FFIType.uint32_t];
+    readonly returns: import("bun:ffi").FFIType.uint32_t;
+  };
+  readonly vui_node_insert_before: {
+    readonly args: readonly [import("bun:ffi").FFIType.ptr, import("bun:ffi").FFIType.uint32_t, import("bun:ffi").FFIType.uint32_t, import("bun:ffi").FFIType.uint32_t];
+    readonly returns: import("bun:ffi").FFIType.uint32_t;
+  };
+  readonly vui_node_remove_child: {
+    readonly args: readonly [import("bun:ffi").FFIType.ptr, import("bun:ffi").FFIType.uint32_t, import("bun:ffi").FFIType.uint32_t];
+    readonly returns: import("bun:ffi").FFIType.uint32_t;
+  };
+  readonly vui_node_set_text: {
+    readonly args: readonly [import("bun:ffi").FFIType.ptr, import("bun:ffi").FFIType.uint32_t, import("bun:ffi").FFIType.ptr, "usize"];
+    readonly returns: import("bun:ffi").FFIType.uint32_t;
+  };
+  readonly vui_node_set_text_runs: {
+    readonly args: readonly [import("bun:ffi").FFIType.ptr, import("bun:ffi").FFIType.uint32_t, import("bun:ffi").FFIType.ptr, "usize", import("bun:ffi").FFIType.ptr, "usize"];
+    readonly returns: import("bun:ffi").FFIType.uint32_t;
+  };
+  readonly vui_node_set_text_wrap: {
+    readonly args: readonly [import("bun:ffi").FFIType.ptr, import("bun:ffi").FFIType.uint32_t, import("bun:ffi").FFIType.uint8_t];
+    readonly returns: import("bun:ffi").FFIType.uint32_t;
+  };
+  readonly vui_node_set_style: {
+    readonly args: readonly [import("bun:ffi").FFIType.ptr, import("bun:ffi").FFIType.uint32_t, import("bun:ffi").FFIType.ptr];
+    readonly returns: import("bun:ffi").FFIType.uint32_t;
+  };
+  readonly vui_style_ffi_size: {
+    readonly args: readonly [];
+    readonly returns: "usize";
+  };
+  readonly vui_debug_tree_hash: {
+    readonly args: readonly [import("bun:ffi").FFIType.ptr];
+    readonly returns: import("bun:ffi").FFIType.uint64_t;
+  };
+  readonly vui_layout_compute: {
+    readonly args: readonly [import("bun:ffi").FFIType.ptr, import("bun:ffi").FFIType.uint32_t, import("bun:ffi").FFIType.uint32_t];
+    readonly returns: import("bun:ffi").FFIType.uint32_t;
+  };
+  readonly vui_node_rect: {
+    readonly args: readonly [import("bun:ffi").FFIType.ptr, import("bun:ffi").FFIType.uint32_t, import("bun:ffi").FFIType.ptr];
+    readonly returns: import("bun:ffi").FFIType.uint32_t;
+  };
+}>;
+//#endregion
+export { type AlignValue, Attr, CELL_BYTES, type ClipRect, type DecodedImage, type Dim, EXPECTED_ABI_VERSION, EditBuffer, EditMotion, type EditMotionCode, EditorView, type InputEvent, type JustifyValue, Key, type KeyDecoder, type KeyEvent, LINK_SHIFT, type LayoutRect, type MouseButton, type MouseEvent, NAMED_COLORS, type NativeLib, NativeTextWrap, type NativeTextWrapCode, NodeKindCode, OffscreenBuffer, type PasteEvent, type RectEdges, Renderer, STYLE_FFI_BYTES, type Sides, Status, type TerminalSession, type TerminalSessionOptions, TextBuffer, TextBufferView, type TextMeasure, type TextRun, type TextStyle, type TextWrapMode, type TextWrapName, VuiNode, type VuiStyle, charWidth, createKeyDecoder, createTerminalSession, decodeImage, decodeImageBytes, getNativeLib, hostTreeHash, matchesKey, packStyle, parseColor, parseHex, parseKeys, rgba, strWidth, symbols, wrapCode };

package/dist/index.js

@@ -0,0 +1,27 @@
+import { Attr, CELL_BYTES, EXPECTED_ABI_VERSION, EditMotion, LINK_SHIFT, NativeTextWrap, NodeKindCode, STYLE_FFI_BYTES, Status, symbols } from "./native/ffi-symbols.js";
+import { loadNativeLib } from "./native/load-native-lib.js";
+import { NAMED_COLORS, parseHex } from "./named-colors.js";
+import { parseColor } from "./color.js";
+import { packStyle } from "./style.js";
+import { VuiNode, hostTreeHash } from "./node.js";
+import { OffscreenBuffer } from "./offscreen-buffer.js";
+import { Renderer, rgba } from "./renderer.js";
+import { TextBuffer } from "./text/text-buffer.js";
+import { TextBufferView, wrapCode } from "./text/text-buffer-view.js";
+import { EditBuffer } from "./text/edit-buffer.js";
+import { EditorView } from "./text/editor-view.js";
+import "./text/index.js";
+import { charWidth, strWidth } from "./char-width.js";
+import { decodeImage, decodeImageBytes } from "./image-decode.js";
+import { Key, createKeyDecoder, matchesKey, parseKeys } from "./keys.js";
+import { createTerminalSession } from "./terminal-session.js";
+//#region src/index.ts
+/**
+* Memoized handle to the loaded vui-core native library. The first call
+* resolves, opens, and ABI-checks the library; subsequent calls reuse it.
+*/
+function getNativeLib() {
+	return loadNativeLib();
+}
+//#endregion
+export { Attr, CELL_BYTES, EXPECTED_ABI_VERSION, EditBuffer, EditMotion, EditorView, Key, LINK_SHIFT, NAMED_COLORS, NativeTextWrap, NodeKindCode, OffscreenBuffer, Renderer, STYLE_FFI_BYTES, Status, TextBuffer, TextBufferView, VuiNode, charWidth, createKeyDecoder, createTerminalSession, decodeImage, decodeImageBytes, getNativeLib, hostTreeHash, matchesKey, packStyle, parseColor, parseHex, parseKeys, rgba, strWidth, symbols, wrapCode };