@vui-rs/core 0.1.0

package/dist/native/load-native-lib.d.ts

@@ -0,0 +1,384 @@
+import { Attr, CELL_BYTES, EXPECTED_ABI_VERSION, EditMotion, EditMotionCode, LINK_SHIFT, NativeTextWrap, NativeTextWrapCode, NodeKindCode, STYLE_FFI_BYTES, Status, symbols } from "./ffi-symbols.js";
+
+//#region src/native/load-native-lib.d.ts
+declare function open(path: string): 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;
+  };
+}>;
+type NativeLib = ReturnType<typeof open>;
+//#endregion
+export { NativeLib };

package/dist/native/load-native-lib.js

@@ -0,0 +1,63 @@
+import { symbols } from "./ffi-symbols.js";
+import { dlopen, suffix } from "bun:ffi";
+import { existsSync, statSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+//#region src/native/load-native-lib.ts
+const here = dirname(fileURLToPath(import.meta.url));
+const repoRoot = join(here, "..", "..", "..", "..");
+function libFileName() {
+	return `${process.platform === "win32" ? "" : "lib"}vui_core.${suffix}`;
+}
+/**
+* Library lookup order (the newest existing candidate actually wins — see
+* `loadNativeLib`):
+*  1. Published layout: dylib copied next to the loader inside `dist/` by the
+*     tsdown `copy` step (`dist/native/<arch>/`). The only candidate that exists
+*     in a published package.
+*  2. Dev: stable copy produced by `scripts/build-native.ts` at the package's
+*     `native/<arch>/` dir.
+*  3. Dev fallbacks: the cargo workspace build directory (release, then debug).
+*
+* `here` is `<pkg>/src/native` in dev and `<pkg>/dist/native` in a build — both
+* sit at the same depth, so the relative joins resolve correctly either way.
+*/
+function candidatePaths() {
+	const file = libFileName();
+	const platformArch = `${process.platform}-${process.arch}`;
+	const buildDir = join(repoRoot, "target");
+	return [
+		join(here, platformArch, file),
+		join(here, "..", "..", "native", platformArch, file),
+		join(buildDir, "release", file),
+		join(buildDir, "debug", file)
+	];
+}
+function open(path) {
+	return dlopen(path, symbols);
+}
+let cached;
+/**
+* Resolve, `dlopen`, ABI-check, and memoize the vui-core native library.
+*
+* When several candidates exist (e.g. a debug build alongside a stale release
+* copy) the most recently modified one wins, so a fresh `cargo build` always
+* takes precedence over an old artifact during iterative development.
+*/
+function loadNativeLib() {
+	if (cached) return cached;
+	const candidates = candidatePaths();
+	const existing = candidates.filter((p) => existsSync(p));
+	if (existing.length === 0) throw new Error("vui-core native library not found. Searched:\n" + candidates.map((p) => `  - ${p}`).join("\n") + "\nBuild it with: bun run build:native");
+	const lib = open(existing.reduce((newest, p) => statSync(p).mtimeMs > statSync(newest).mtimeMs ? p : newest));
+	const abi = lib.symbols.vui_abi_version();
+	if (abi !== 12) throw new Error(`vui-core ABI mismatch: native=${abi}, expected=12. Rebuild the native lib: bun run build:native`);
+	const cellBytes = Number(lib.symbols.vui_cell_size_bytes());
+	if (cellBytes !== 16) throw new Error(`vui-core Cell size mismatch: native=${cellBytes}, expected=16. Rebuild the native lib: bun run build:native`);
+	const styleBytes = Number(lib.symbols.vui_style_ffi_size());
+	if (styleBytes !== 236) throw new Error(`vui-core StyleFfi size mismatch: native=${styleBytes}, expected=236. Rebuild the native lib: bun run build:native`);
+	cached = lib;
+	return cached;
+}
+//#endregion
+export { loadNativeLib };

package/dist/node.d.ts

@@ -0,0 +1,61 @@
+import { NativeLib } from "./native/load-native-lib.js";
+import { VuiStyle } from "./style.js";
+import { Pointer } from "bun:ffi";
+
+//#region src/node.d.ts
+interface TextRun {
+  text: string;
+  fg?: number;
+  bg?: number;
+  attrs?: number;
+}
+type TextWrapName = 'word' | 'char' | 'nowrap';
+/** Per-side insets (cells, fractional) reported by layout. */
+interface RectEdges {
+  left: number;
+  right: number;
+  top: number;
+  bottom: number;
+}
+/** A node's computed taffy box: parent-relative origin + size + padding/border insets. */
+interface LayoutRect {
+  x: number;
+  y: number;
+  w: number;
+  h: number;
+  padding: RectEdges;
+  border: RectEdges;
+}
+declare class VuiNode {
+  #private;
+  readonly id: number;
+  /** Node-kind code mirrored for the structural hash (0 root, 1 box, 2 text). */
+  readonly kindCode: number;
+  /** JS mirror of the native child order — kept in lockstep by the tree ops. */
+  readonly children: VuiNode[];
+  constructor(lib: NativeLib, ptr: Pointer, id: number, kindCode: number);
+  setStyle(style: VuiStyle): this;
+  /**
+   * This node's computed layout box after `Renderer.computeLayout`, or `null` if
+   * layout hasn't run yet (or the handle is stale). The JS-host paint walk reads
+   * these to place each Renderable.
+   */
+  layoutRect(): LayoutRect | null;
+  setText(text: string): this;
+  setTextRuns(runs: TextRun[]): this;
+  /**
+   * Text flow for a `<text>` node: `"word"` (default) breaks at word
+   * boundaries with char fallback, `"char"` wraps by grapheme, and `"nowrap"`
+   * keeps each physical line on one row and clips overflow.
+   */
+  setTextWrap(mode: TextWrapName): this;
+  appendChild(child: VuiNode): this;
+  insertBefore(child: VuiNode, anchor: VuiNode): this;
+  removeChild(child: VuiNode): this;
+  /** Destroy this node and its subtree natively, and unlink it from the mirror. */
+  free(): void;
+}
+/** Structural hash of the host mirror, comparable to `Renderer.treeHash()`. */
+declare function hostTreeHash(root: VuiNode): bigint;
+//#endregion
+export { LayoutRect, RectEdges, TextRun, TextWrapName, VuiNode, hostTreeHash };

package/dist/node.js

@@ -0,0 +1,157 @@
+import { NativeTextWrap, Status } from "./native/ffi-symbols.js";
+import { packStyle } from "./style.js";
+//#region src/node.ts
+const encoder = new TextEncoder();
+const rectScratch = new Float32Array(48 / 4);
+function check(status, op) {
+	if (status !== Status.OK) throw new Error(`vui-core node ${op} failed with status ${status}`);
+}
+var VuiNode = class {
+	id;
+	/** Node-kind code mirrored for the structural hash (0 root, 1 box, 2 text). */
+	kindCode;
+	/** JS mirror of the native child order — kept in lockstep by the tree ops. */
+	children = [];
+	#parent;
+	#lib;
+	#ptr;
+	constructor(lib, ptr, id, kindCode) {
+		this.#lib = lib;
+		this.#ptr = ptr;
+		this.id = id;
+		this.kindCode = kindCode;
+	}
+	setStyle(style) {
+		const bytes = packStyle(style);
+		check(this.#lib.symbols.vui_node_set_style(this.#ptr, this.id, bytes), "set_style");
+		return this;
+	}
+	/**
+	* This node's computed layout box after `Renderer.computeLayout`, or `null` if
+	* layout hasn't run yet (or the handle is stale). The JS-host paint walk reads
+	* these to place each Renderable.
+	*/
+	layoutRect() {
+		if (this.#lib.symbols.vui_node_rect(this.#ptr, this.id, rectScratch) !== Status.OK) return null;
+		return {
+			x: rectScratch[0],
+			y: rectScratch[1],
+			w: rectScratch[2],
+			h: rectScratch[3],
+			padding: {
+				left: rectScratch[4],
+				right: rectScratch[5],
+				top: rectScratch[6],
+				bottom: rectScratch[7]
+			},
+			border: {
+				left: rectScratch[8],
+				right: rectScratch[9],
+				top: rectScratch[10],
+				bottom: rectScratch[11]
+			}
+		};
+	}
+	setText(text) {
+		const bytes = encoder.encode(text);
+		check(this.#lib.symbols.vui_node_set_text(this.#ptr, this.id, bytes, bytes.byteLength), "set_text");
+		return this;
+	}
+	setTextRuns(runs) {
+		const { bytes, runBytes } = packTextRuns(runs);
+		check(this.#lib.symbols.vui_node_set_text_runs(this.#ptr, this.id, runBytes, runs.length, bytes, bytes.byteLength), "set_text_runs");
+		return this;
+	}
+	/**
+	* Text flow for a `<text>` node: `"word"` (default) breaks at word
+	* boundaries with char fallback, `"char"` wraps by grapheme, and `"nowrap"`
+	* keeps each physical line on one row and clips overflow.
+	*/
+	setTextWrap(mode) {
+		check(this.#lib.symbols.vui_node_set_text_wrap(this.#ptr, this.id, wrapCode(mode)), "set_text_wrap");
+		return this;
+	}
+	appendChild(child) {
+		check(this.#lib.symbols.vui_node_append_child(this.#ptr, this.id, child.id), "append_child");
+		child.#detachFromParent();
+		child.#parent = this;
+		this.children.push(child);
+		return this;
+	}
+	insertBefore(child, anchor) {
+		check(this.#lib.symbols.vui_node_insert_before(this.#ptr, this.id, child.id, anchor.id), "insert_before");
+		child.#detachFromParent();
+		child.#parent = this;
+		const at = this.children.indexOf(anchor);
+		if (at < 0) this.children.push(child);
+		else this.children.splice(at, 0, child);
+		return this;
+	}
+	removeChild(child) {
+		check(this.#lib.symbols.vui_node_remove_child(this.#ptr, this.id, child.id), "remove_child");
+		child.#detachFromParent();
+		return this;
+	}
+	/** Destroy this node and its subtree natively, and unlink it from the mirror. */
+	free() {
+		check(this.#lib.symbols.vui_node_free(this.#ptr, this.id), "free");
+		this.#detachFromParent();
+	}
+	#detachFromParent() {
+		if (!this.#parent) return;
+		const siblings = this.#parent.children;
+		const at = siblings.indexOf(this);
+		if (at >= 0) siblings.splice(at, 1);
+		this.#parent = void 0;
+	}
+};
+function packTextRuns(runs) {
+	const chunks = runs.map((r) => encoder.encode(r.text));
+	const total = chunks.reduce((n, c) => n + c.byteLength, 0);
+	const bytes = new Uint8Array(total);
+	const runBuf = /* @__PURE__ */ new ArrayBuffer(runs.length * 20);
+	const dv = new DataView(runBuf);
+	let off = 0;
+	runs.forEach((run, i) => {
+		const chunk = chunks[i];
+		bytes.set(chunk, off);
+		const base = i * 20;
+		dv.setUint32(base + 0, off, true);
+		dv.setUint32(base + 4, chunk.byteLength, true);
+		dv.setUint32(base + 8, (run.fg ?? 0) >>> 0, true);
+		dv.setUint32(base + 12, (run.bg ?? 0) >>> 0, true);
+		dv.setUint16(base + 16, (run.attrs ?? 0) & 65535, true);
+		dv.setUint8(base + 18, run.fg !== void 0 ? 1 : 0);
+		dv.setUint8(base + 19, run.bg !== void 0 ? 1 : 0);
+		off += chunk.byteLength;
+	});
+	return {
+		bytes,
+		runBytes: new Uint8Array(runBuf)
+	};
+}
+function wrapCode(mode) {
+	if (mode === "nowrap") return NativeTextWrap.None;
+	if (mode === "char") return NativeTextWrap.Char;
+	return NativeTextWrap.Word;
+}
+const FNV_OFFSET = 14695981039346656037n;
+const FNV_PRIME = 1099511628211n;
+const U64 = 18446744073709551615n;
+function mix(h, v) {
+	h ^= v & U64;
+	return h * FNV_PRIME & U64;
+}
+function hashNode(node, h) {
+	h = mix(h, BigInt(node.kindCode));
+	h = mix(h, BigInt(node.children.length));
+	for (const c of node.children) h = mix(h, BigInt(c.id));
+	for (const c of node.children) h = hashNode(c, h);
+	return h;
+}
+/** Structural hash of the host mirror, comparable to `Renderer.treeHash()`. */
+function hostTreeHash(root) {
+	return hashNode(root, FNV_OFFSET);
+}
+//#endregion
+export { VuiNode, hostTreeHash, packTextRuns };