This directory is the browser adapter for the same official libghostty-vt C ABI used by Android. It is intentionally not an xterm compatibility layer.

runtime.ts owns the singleton WebAssembly instance and runtime ABI layouts.
ghostty-write-pty.wasm is a 112-byte callback trampoline for terminal-generated PTY replies.
core.ts owns per-terminal Ghostty handles and translates the C ABI into render snapshots.
renderer.ts batches backgrounds and style runs into a Canvas 2D frame.
surface.ts owns browser input, IME, selection, scrolling, sizing, links, and cursor blinking.
fonts/ vendors the symbols-only Nerd Font (MIT) the surface registers lazily, so prompt glyphs render without a locally installed Nerd Font.
vendor/ holds only the artifacts, reproducibly generated by apps/web/scripts/build-libghostty-wasm.sh. The upstream pin and license live once, at native/libghostty-vt/ at the repository root; the wasm embeds the pinned revision in its build info and the ABI test verifies it against mobile's VERSION.

Keep browser behavior here and terminal transport in the existing client runtime. Do not add React state to the render loop. Both WASM artifacts are ordinary read-only assets, not executables.