everything

README.md

@@ -145,6 +145,26 @@ try (Terminal terminal = Ghostty.open(TerminalOptions.of(80, 24))) {
 }
 ```
 
+## Full Native Surface
+
+The public Java API covers the common terminal, paste, build-info, focus, mode-report, size-report, and Kitty graphics paths. For libghostty-vt APIs that do not yet have ergonomic Java wrappers, use `GhosttyNative`:
+
+```java
+MethodHandle handle = GhosttyNative.downcall(
+    "ghostty_render_state_new",
+    FunctionDescriptor.of(ValueLayout.JAVA_INT, ValueLayout.ADDRESS, ValueLayout.ADDRESS)
+);
+```
+
+`GhosttyNative.symbolNames()` lists every exported symbol found in the current public headers. Some entries are target-specific, such as WASM helpers, so use `GhosttyNative.findSymbol(name)` when probing optional symbols.
+
+Build metadata and C struct layout JSON are exposed directly:
+
+```java
+GhosttyBuildInfo info = Ghostty.buildInfo();
+String typeJson = Ghostty.typeJson();
+```
+
 ## Kitty Graphics
 
 Kitty graphics storage can be enabled and inspected: