@fressh/react-native-terminal 0.1.0

package/cpp/generated/shim_uniffi.hpp

@@ -0,0 +1,364 @@
+// This file was autogenerated by some hot garbage in the
+// `uniffi-bindgen-react-native` crate. Trust me, you don't want to mess with
+// it!
+#pragma once
+#include "UniffiCallInvoker.h"
+#include <ReactCommon/CallInvoker.h>
+#include <iostream>
+#include <jsi/jsi.h>
+#include <map>
+#include <memory>
+
+namespace react = facebook::react;
+namespace jsi = facebook::jsi;
+
+class NativeShimUniffi : public jsi::HostObject {
+private:
+  // For calling back into JS from Rust.
+  std::shared_ptr<uniffi_runtime::UniffiCallInvoker> callInvoker;
+
+protected:
+  std::map<std::string, jsi::Value> props;
+  jsi::Value cpp_uniffi_internal_fn_func_ffi__string_to_byte_length(
+      jsi::Runtime &rt, const jsi::Value &thisVal, const jsi::Value *args,
+      size_t count);
+  jsi::Value cpp_uniffi_internal_fn_func_ffi__string_to_buffer(
+      jsi::Runtime &rt, const jsi::Value &thisVal, const jsi::Value *args,
+      size_t count);
+  jsi::Value cpp_uniffi_internal_fn_func_ffi__string_from_buffer(
+      jsi::Runtime &rt, const jsi::Value &thisVal, const jsi::Value *args,
+      size_t count);
+  jsi::Value cpp_uniffi_internal_fn_func_ffi__read_string_from_buffer(
+      jsi::Runtime &rt, const jsi::Value &thisVal, const jsi::Value *args,
+      size_t count);
+  jsi::Value cpp_uniffi_shim_uniffi_fn_clone_fressheventlistener(
+      jsi::Runtime &rt, const jsi::Value &thisVal, const jsi::Value *args,
+      size_t count);
+  jsi::Value cpp_uniffi_shim_uniffi_fn_free_fressheventlistener(
+      jsi::Runtime &rt, const jsi::Value &thisVal, const jsi::Value *args,
+      size_t count);
+  jsi::Value cpp_uniffi_shim_uniffi_fn_init_callback_vtable_fressheventlistener(
+      jsi::Runtime &rt, const jsi::Value &thisVal, const jsi::Value *args,
+      size_t count);
+  jsi::Value cpp_uniffi_shim_uniffi_fn_method_fressheventlistener_on_event(
+      jsi::Runtime &rt, const jsi::Value &thisVal, const jsi::Value *args,
+      size_t count);
+  jsi::Value cpp_uniffi_shim_uniffi_fn_func_close_preview(
+      jsi::Runtime &rt, const jsi::Value &thisVal, const jsi::Value *args,
+      size_t count);
+  jsi::Value cpp_uniffi_shim_uniffi_fn_func_close_shell(
+      jsi::Runtime &rt, const jsi::Value &thisVal, const jsi::Value *args,
+      size_t count);
+  jsi::Value cpp_uniffi_shim_uniffi_fn_func_connect(jsi::Runtime &rt,
+                                                    const jsi::Value &thisVal,
+                                                    const jsi::Value *args,
+                                                    size_t count);
+  jsi::Value cpp_uniffi_shim_uniffi_fn_func_create_preview(
+      jsi::Runtime &rt, const jsi::Value &thisVal, const jsi::Value *args,
+      size_t count);
+  jsi::Value cpp_uniffi_shim_uniffi_fn_func_disconnect(
+      jsi::Runtime &rt, const jsi::Value &thisVal, const jsi::Value *args,
+      size_t count);
+  jsi::Value cpp_uniffi_shim_uniffi_fn_func_generate_key_pair(
+      jsi::Runtime &rt, const jsi::Value &thisVal, const jsi::Value *args,
+      size_t count);
+  jsi::Value cpp_uniffi_shim_uniffi_fn_func_resize(jsi::Runtime &rt,
+                                                   const jsi::Value &thisVal,
+                                                   const jsi::Value *args,
+                                                   size_t count);
+  jsi::Value cpp_uniffi_shim_uniffi_fn_func_respond_to_host_key(
+      jsi::Runtime &rt, const jsi::Value &thisVal, const jsi::Value *args,
+      size_t count);
+  jsi::Value cpp_uniffi_shim_uniffi_fn_func_run_command(
+      jsi::Runtime &rt, const jsi::Value &thisVal, const jsi::Value *args,
+      size_t count);
+  jsi::Value cpp_uniffi_shim_uniffi_fn_func_scroll(jsi::Runtime &rt,
+                                                   const jsi::Value &thisVal,
+                                                   const jsi::Value *args,
+                                                   size_t count);
+  jsi::Value cpp_uniffi_shim_uniffi_fn_func_selection_clear(
+      jsi::Runtime &rt, const jsi::Value &thisVal, const jsi::Value *args,
+      size_t count);
+  jsi::Value cpp_uniffi_shim_uniffi_fn_func_selection_start(
+      jsi::Runtime &rt, const jsi::Value &thisVal, const jsi::Value *args,
+      size_t count);
+  jsi::Value cpp_uniffi_shim_uniffi_fn_func_selection_text(
+      jsi::Runtime &rt, const jsi::Value &thisVal, const jsi::Value *args,
+      size_t count);
+  jsi::Value cpp_uniffi_shim_uniffi_fn_func_selection_update(
+      jsi::Runtime &rt, const jsi::Value &thisVal, const jsi::Value *args,
+      size_t count);
+  jsi::Value cpp_uniffi_shim_uniffi_fn_func_send_data(jsi::Runtime &rt,
+                                                      const jsi::Value &thisVal,
+                                                      const jsi::Value *args,
+                                                      size_t count);
+  jsi::Value cpp_uniffi_shim_uniffi_fn_func_set_event_listener(
+      jsi::Runtime &rt, const jsi::Value &thisVal, const jsi::Value *args,
+      size_t count);
+  jsi::Value cpp_uniffi_shim_uniffi_fn_func_start_shell(
+      jsi::Runtime &rt, const jsi::Value &thisVal, const jsi::Value *args,
+      size_t count);
+  jsi::Value cpp_uniffi_shim_uniffi_fn_func_validate_private_key(
+      jsi::Runtime &rt, const jsi::Value &thisVal, const jsi::Value *args,
+      size_t count);
+  jsi::Value cpp_ffi_shim_uniffi_rust_future_poll_u8(jsi::Runtime &rt,
+                                                     const jsi::Value &thisVal,
+                                                     const jsi::Value *args,
+                                                     size_t count);
+  jsi::Value cpp_ffi_shim_uniffi_rust_future_cancel_u8(
+      jsi::Runtime &rt, const jsi::Value &thisVal, const jsi::Value *args,
+      size_t count);
+  jsi::Value cpp_ffi_shim_uniffi_rust_future_free_u8(jsi::Runtime &rt,
+                                                     const jsi::Value &thisVal,
+                                                     const jsi::Value *args,
+                                                     size_t count);
+  jsi::Value cpp_ffi_shim_uniffi_rust_future_complete_u8(
+      jsi::Runtime &rt, const jsi::Value &thisVal, const jsi::Value *args,
+      size_t count);
+  jsi::Value cpp_ffi_shim_uniffi_rust_future_poll_i8(jsi::Runtime &rt,
+                                                     const jsi::Value &thisVal,
+                                                     const jsi::Value *args,
+                                                     size_t count);
+  jsi::Value cpp_ffi_shim_uniffi_rust_future_cancel_i8(
+      jsi::Runtime &rt, const jsi::Value &thisVal, const jsi::Value *args,
+      size_t count);
+  jsi::Value cpp_ffi_shim_uniffi_rust_future_free_i8(jsi::Runtime &rt,
+                                                     const jsi::Value &thisVal,
+                                                     const jsi::Value *args,
+                                                     size_t count);
+  jsi::Value cpp_ffi_shim_uniffi_rust_future_complete_i8(
+      jsi::Runtime &rt, const jsi::Value &thisVal, const jsi::Value *args,
+      size_t count);
+  jsi::Value cpp_ffi_shim_uniffi_rust_future_poll_u16(jsi::Runtime &rt,
+                                                      const jsi::Value &thisVal,
+                                                      const jsi::Value *args,
+                                                      size_t count);
+  jsi::Value cpp_ffi_shim_uniffi_rust_future_cancel_u16(
+      jsi::Runtime &rt, const jsi::Value &thisVal, const jsi::Value *args,
+      size_t count);
+  jsi::Value cpp_ffi_shim_uniffi_rust_future_free_u16(jsi::Runtime &rt,
+                                                      const jsi::Value &thisVal,
+                                                      const jsi::Value *args,
+                                                      size_t count);
+  jsi::Value cpp_ffi_shim_uniffi_rust_future_complete_u16(
+      jsi::Runtime &rt, const jsi::Value &thisVal, const jsi::Value *args,
+      size_t count);
+  jsi::Value cpp_ffi_shim_uniffi_rust_future_poll_i16(jsi::Runtime &rt,
+                                                      const jsi::Value &thisVal,
+                                                      const jsi::Value *args,
+                                                      size_t count);
+  jsi::Value cpp_ffi_shim_uniffi_rust_future_cancel_i16(
+      jsi::Runtime &rt, const jsi::Value &thisVal, const jsi::Value *args,
+      size_t count);
+  jsi::Value cpp_ffi_shim_uniffi_rust_future_free_i16(jsi::Runtime &rt,
+                                                      const jsi::Value &thisVal,
+                                                      const jsi::Value *args,
+                                                      size_t count);
+  jsi::Value cpp_ffi_shim_uniffi_rust_future_complete_i16(
+      jsi::Runtime &rt, const jsi::Value &thisVal, const jsi::Value *args,
+      size_t count);
+  jsi::Value cpp_ffi_shim_uniffi_rust_future_poll_u32(jsi::Runtime &rt,
+                                                      const jsi::Value &thisVal,
+                                                      const jsi::Value *args,
+                                                      size_t count);
+  jsi::Value cpp_ffi_shim_uniffi_rust_future_cancel_u32(
+      jsi::Runtime &rt, const jsi::Value &thisVal, const jsi::Value *args,
+      size_t count);
+  jsi::Value cpp_ffi_shim_uniffi_rust_future_free_u32(jsi::Runtime &rt,
+                                                      const jsi::Value &thisVal,
+                                                      const jsi::Value *args,
+                                                      size_t count);
+  jsi::Value cpp_ffi_shim_uniffi_rust_future_complete_u32(
+      jsi::Runtime &rt, const jsi::Value &thisVal, const jsi::Value *args,
+      size_t count);
+  jsi::Value cpp_ffi_shim_uniffi_rust_future_poll_i32(jsi::Runtime &rt,
+                                                      const jsi::Value &thisVal,
+                                                      const jsi::Value *args,
+                                                      size_t count);
+  jsi::Value cpp_ffi_shim_uniffi_rust_future_cancel_i32(
+      jsi::Runtime &rt, const jsi::Value &thisVal, const jsi::Value *args,
+      size_t count);
+  jsi::Value cpp_ffi_shim_uniffi_rust_future_free_i32(jsi::Runtime &rt,
+                                                      const jsi::Value &thisVal,
+                                                      const jsi::Value *args,
+                                                      size_t count);
+  jsi::Value cpp_ffi_shim_uniffi_rust_future_complete_i32(
+      jsi::Runtime &rt, const jsi::Value &thisVal, const jsi::Value *args,
+      size_t count);
+  jsi::Value cpp_ffi_shim_uniffi_rust_future_poll_u64(jsi::Runtime &rt,
+                                                      const jsi::Value &thisVal,
+                                                      const jsi::Value *args,
+                                                      size_t count);
+  jsi::Value cpp_ffi_shim_uniffi_rust_future_cancel_u64(
+      jsi::Runtime &rt, const jsi::Value &thisVal, const jsi::Value *args,
+      size_t count);
+  jsi::Value cpp_ffi_shim_uniffi_rust_future_free_u64(jsi::Runtime &rt,
+                                                      const jsi::Value &thisVal,
+                                                      const jsi::Value *args,
+                                                      size_t count);
+  jsi::Value cpp_ffi_shim_uniffi_rust_future_complete_u64(
+      jsi::Runtime &rt, const jsi::Value &thisVal, const jsi::Value *args,
+      size_t count);
+  jsi::Value cpp_ffi_shim_uniffi_rust_future_poll_i64(jsi::Runtime &rt,
+                                                      const jsi::Value &thisVal,
+                                                      const jsi::Value *args,
+                                                      size_t count);
+  jsi::Value cpp_ffi_shim_uniffi_rust_future_cancel_i64(
+      jsi::Runtime &rt, const jsi::Value &thisVal, const jsi::Value *args,
+      size_t count);
+  jsi::Value cpp_ffi_shim_uniffi_rust_future_free_i64(jsi::Runtime &rt,
+                                                      const jsi::Value &thisVal,
+                                                      const jsi::Value *args,
+                                                      size_t count);
+  jsi::Value cpp_ffi_shim_uniffi_rust_future_complete_i64(
+      jsi::Runtime &rt, const jsi::Value &thisVal, const jsi::Value *args,
+      size_t count);
+  jsi::Value cpp_ffi_shim_uniffi_rust_future_poll_f32(jsi::Runtime &rt,
+                                                      const jsi::Value &thisVal,
+                                                      const jsi::Value *args,
+                                                      size_t count);
+  jsi::Value cpp_ffi_shim_uniffi_rust_future_cancel_f32(
+      jsi::Runtime &rt, const jsi::Value &thisVal, const jsi::Value *args,
+      size_t count);
+  jsi::Value cpp_ffi_shim_uniffi_rust_future_free_f32(jsi::Runtime &rt,
+                                                      const jsi::Value &thisVal,
+                                                      const jsi::Value *args,
+                                                      size_t count);
+  jsi::Value cpp_ffi_shim_uniffi_rust_future_complete_f32(
+      jsi::Runtime &rt, const jsi::Value &thisVal, const jsi::Value *args,
+      size_t count);
+  jsi::Value cpp_ffi_shim_uniffi_rust_future_poll_f64(jsi::Runtime &rt,
+                                                      const jsi::Value &thisVal,
+                                                      const jsi::Value *args,
+                                                      size_t count);
+  jsi::Value cpp_ffi_shim_uniffi_rust_future_cancel_f64(
+      jsi::Runtime &rt, const jsi::Value &thisVal, const jsi::Value *args,
+      size_t count);
+  jsi::Value cpp_ffi_shim_uniffi_rust_future_free_f64(jsi::Runtime &rt,
+                                                      const jsi::Value &thisVal,
+                                                      const jsi::Value *args,
+                                                      size_t count);
+  jsi::Value cpp_ffi_shim_uniffi_rust_future_complete_f64(
+      jsi::Runtime &rt, const jsi::Value &thisVal, const jsi::Value *args,
+      size_t count);
+  jsi::Value cpp_ffi_shim_uniffi_rust_future_poll_rust_buffer(
+      jsi::Runtime &rt, const jsi::Value &thisVal, const jsi::Value *args,
+      size_t count);
+  jsi::Value cpp_ffi_shim_uniffi_rust_future_cancel_rust_buffer(
+      jsi::Runtime &rt, const jsi::Value &thisVal, const jsi::Value *args,
+      size_t count);
+  jsi::Value cpp_ffi_shim_uniffi_rust_future_free_rust_buffer(
+      jsi::Runtime &rt, const jsi::Value &thisVal, const jsi::Value *args,
+      size_t count);
+  jsi::Value cpp_ffi_shim_uniffi_rust_future_complete_rust_buffer(
+      jsi::Runtime &rt, const jsi::Value &thisVal, const jsi::Value *args,
+      size_t count);
+  jsi::Value cpp_ffi_shim_uniffi_rust_future_poll_void(
+      jsi::Runtime &rt, const jsi::Value &thisVal, const jsi::Value *args,
+      size_t count);
+  jsi::Value cpp_ffi_shim_uniffi_rust_future_cancel_void(
+      jsi::Runtime &rt, const jsi::Value &thisVal, const jsi::Value *args,
+      size_t count);
+  jsi::Value cpp_ffi_shim_uniffi_rust_future_free_void(
+      jsi::Runtime &rt, const jsi::Value &thisVal, const jsi::Value *args,
+      size_t count);
+  jsi::Value cpp_ffi_shim_uniffi_rust_future_complete_void(
+      jsi::Runtime &rt, const jsi::Value &thisVal, const jsi::Value *args,
+      size_t count);
+  jsi::Value cpp_uniffi_shim_uniffi_checksum_func_close_preview(
+      jsi::Runtime &rt, const jsi::Value &thisVal, const jsi::Value *args,
+      size_t count);
+  jsi::Value cpp_uniffi_shim_uniffi_checksum_func_close_shell(
+      jsi::Runtime &rt, const jsi::Value &thisVal, const jsi::Value *args,
+      size_t count);
+  jsi::Value cpp_uniffi_shim_uniffi_checksum_func_connect(
+      jsi::Runtime &rt, const jsi::Value &thisVal, const jsi::Value *args,
+      size_t count);
+  jsi::Value cpp_uniffi_shim_uniffi_checksum_func_create_preview(
+      jsi::Runtime &rt, const jsi::Value &thisVal, const jsi::Value *args,
+      size_t count);
+  jsi::Value cpp_uniffi_shim_uniffi_checksum_func_disconnect(
+      jsi::Runtime &rt, const jsi::Value &thisVal, const jsi::Value *args,
+      size_t count);
+  jsi::Value cpp_uniffi_shim_uniffi_checksum_func_generate_key_pair(
+      jsi::Runtime &rt, const jsi::Value &thisVal, const jsi::Value *args,
+      size_t count);
+  jsi::Value cpp_uniffi_shim_uniffi_checksum_func_resize(
+      jsi::Runtime &rt, const jsi::Value &thisVal, const jsi::Value *args,
+      size_t count);
+  jsi::Value cpp_uniffi_shim_uniffi_checksum_func_respond_to_host_key(
+      jsi::Runtime &rt, const jsi::Value &thisVal, const jsi::Value *args,
+      size_t count);
+  jsi::Value cpp_uniffi_shim_uniffi_checksum_func_run_command(
+      jsi::Runtime &rt, const jsi::Value &thisVal, const jsi::Value *args,
+      size_t count);
+  jsi::Value cpp_uniffi_shim_uniffi_checksum_func_scroll(
+      jsi::Runtime &rt, const jsi::Value &thisVal, const jsi::Value *args,
+      size_t count);
+  jsi::Value cpp_uniffi_shim_uniffi_checksum_func_selection_clear(
+      jsi::Runtime &rt, const jsi::Value &thisVal, const jsi::Value *args,
+      size_t count);
+  jsi::Value cpp_uniffi_shim_uniffi_checksum_func_selection_start(
+      jsi::Runtime &rt, const jsi::Value &thisVal, const jsi::Value *args,
+      size_t count);
+  jsi::Value cpp_uniffi_shim_uniffi_checksum_func_selection_text(
+      jsi::Runtime &rt, const jsi::Value &thisVal, const jsi::Value *args,
+      size_t count);
+  jsi::Value cpp_uniffi_shim_uniffi_checksum_func_selection_update(
+      jsi::Runtime &rt, const jsi::Value &thisVal, const jsi::Value *args,
+      size_t count);
+  jsi::Value cpp_uniffi_shim_uniffi_checksum_func_send_data(
+      jsi::Runtime &rt, const jsi::Value &thisVal, const jsi::Value *args,
+      size_t count);
+  jsi::Value cpp_uniffi_shim_uniffi_checksum_func_set_event_listener(
+      jsi::Runtime &rt, const jsi::Value &thisVal, const jsi::Value *args,
+      size_t count);
+  jsi::Value cpp_uniffi_shim_uniffi_checksum_func_start_shell(
+      jsi::Runtime &rt, const jsi::Value &thisVal, const jsi::Value *args,
+      size_t count);
+  jsi::Value cpp_uniffi_shim_uniffi_checksum_func_validate_private_key(
+      jsi::Runtime &rt, const jsi::Value &thisVal, const jsi::Value *args,
+      size_t count);
+  jsi::Value
+  cpp_uniffi_shim_uniffi_checksum_method_fressheventlistener_on_event(
+      jsi::Runtime &rt, const jsi::Value &thisVal, const jsi::Value *args,
+      size_t count);
+  jsi::Value cpp_ffi_shim_uniffi_uniffi_contract_version(
+      jsi::Runtime &rt, const jsi::Value &thisVal, const jsi::Value *args,
+      size_t count);
+  jsi::Value
+  cpp_uniffi_internal_fn_method_fressheventlistener_ffi__bless_pointer(
+      jsi::Runtime &rt, const jsi::Value &thisVal, const jsi::Value *args,
+      size_t count);
+
+public:
+  NativeShimUniffi(
+      jsi::Runtime &rt,
+      std::shared_ptr<uniffi_runtime::UniffiCallInvoker> callInvoker);
+  virtual ~NativeShimUniffi();
+
+  /**
+   * The entry point into the crate.
+   *
+   * React Native must call `NativeShimUniffi.registerModule(rt, callInvoker)`
+   * before using the Javascript interface.
+   */
+  static void registerModule(jsi::Runtime &rt,
+                             std::shared_ptr<react::CallInvoker> callInvoker);
+
+  /**
+   * Some cleanup into the crate goes here.
+   *
+   * Current implementation is empty, however, this is not guaranteed to always
+   * be the case.
+   *
+   * Clients should call `NativeShimUniffi.unregisterModule(rt)` after final use
+   * where possible.
+   */
+  static void unregisterModule(jsi::Runtime &rt);
+
+  virtual jsi::Value get(jsi::Runtime &rt, const jsi::PropNameID &name);
+  virtual void set(jsi::Runtime &rt, const jsi::PropNameID &name,
+                   const jsi::Value &value);
+  virtual std::vector<jsi::PropNameID> getPropertyNames(jsi::Runtime &rt);
+};

package/ios/FresshTerminalRenderABI.h

@@ -0,0 +1,46 @@
+// Render-plane C-ABI declarations (the iOS analogue of the `extern "C"` block in
+// Android's cpp-adapter.cpp). Lets HybridTerminal.swift call the Rust render
+// entry points in shim_uniffi.xcframework. Symbols are defined in
+// shim-uniffi/src/render.rs; the staticlib is linked via the podspec.
+//
+// `window` is a `CAMetalLayer*` on iOS (ANGLE→Metal, §5). The handle is opaque.
+
+#ifndef FRESSH_TERMINAL_RENDER_ABI_H
+#define FRESSH_TERMINAL_RENDER_ABI_H
+
+#include <stddef.h>
+#include <stdint.h>
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+/// Create an EGL/GLES2 (ANGLE→Metal) renderer for `window` (a `CAMetalLayer*`),
+/// optionally bound to `shell_id`. Returns NULL on failure (see the unified log).
+void *fressh_terminal_attach(void *window, const char *font_path,
+                             const char *config_json, const char *shell_id);
+
+/// (Re)bind the view to a shell id (e.g. once `startShell` resolves on the JS side).
+void fressh_terminal_set_shell(void *handle, const char *shell_id);
+
+/// Apply a new render config (JSON, physical px) at runtime.
+void fressh_terminal_set_config(void *handle, const char *config_json);
+
+/// Draw one frame (the bound shell's `Term`, or a cleared frame). Call per vsync.
+void fressh_terminal_draw(void *handle);
+
+/// Re-sync the renderer to the surface's current size (call on layout changes).
+void fressh_terminal_resize(void *handle);
+
+/// Send user input (stdin) to the bound shell.
+void fressh_terminal_send_input(void *handle, const uint8_t *data, size_t len);
+
+/// Drop the renderer/EGL context. The shell's `Term` stays alive in the registry,
+/// so re-attaching to the same `shellId` resumes instantly (§9).
+void fressh_terminal_destroy(void *handle);
+
+#ifdef __cplusplus
+}
+#endif
+
+#endif /* FRESSH_TERMINAL_RENDER_ABI_H */

package/ios/HybridTerminal.swift

@@ -0,0 +1,144 @@
+import NitroModules
+import QuartzCore
+import UIKit
+
+/// CAMetalLayer-backed view that drives the Rust render C-ABI (ANGLE→Metal, §5) —
+/// the iOS analogue of HybridTerminal.kt's `SurfaceView` + `Choreographer` loop.
+///
+/// On first layout it `fressh_terminal_attach`es its `CAMetalLayer` to ANGLE,
+/// runs a `CADisplayLink` (vsync) loop → `fressh_terminal_draw` (which looks the
+/// shell's durable `Term` up from fressh-core's registry by `shellId` and draws it
+/// — the byte stream never reaches JS), and forwards shellId/config/resize/teardown
+/// to the C-ABI. Changing `shellId` rebinds (instant reattach, full scrollback, §9).
+final class TerminalMetalView: UIView {
+  // The view's backing layer IS a CAMetalLayer — what ANGLE renders into via Metal.
+  override class var layerClass: AnyClass { CAMetalLayer.self }
+  private var metalLayer: CAMetalLayer { layer as! CAMetalLayer }
+
+  /// Opaque Rust render handle (nil = not attached).
+  private var handle: UnsafeMutableRawPointer?
+  private var displayLink: CADisplayLink?
+
+  /// Bundled monospace font file path (no fontconfig on mobile, §6/§8).
+  var fontPath: String = ""
+
+  /// Render config JSON (physical px), assembled by the JS `<Terminal config>` wrapper.
+  var configJson: String? {
+    didSet {
+      guard let handle else { return }
+      withOptCString(configJson) { fressh_terminal_set_config(handle, $0) }
+    }
+  }
+
+  /// The durable shell to render. Rebinds the live view without a remount.
+  var shellId: String? {
+    didSet {
+      guard let handle else { return }
+      withOptCString(shellId) { fressh_terminal_set_shell(handle, $0) }
+    }
+  }
+
+  override func didMoveToWindow() {
+    super.didMoveToWindow()
+    if window == nil { teardown() } else { attachIfNeeded() }
+  }
+
+  override func layoutSubviews() {
+    super.layoutSubviews()
+    syncDrawableSize()
+    // Attach once we have real bounds; afterwards just keep the grid in lockstep
+    // with the on-screen size (keyboard open/close), mirroring the Android resize poll.
+    if handle != nil {
+      fressh_terminal_resize(handle)
+    } else {
+      attachIfNeeded()
+    }
+  }
+
+  /// Keep the Metal drawable in physical px (logical bounds × screen scale).
+  private func syncDrawableSize() {
+    let scale = window?.screen.scale ?? UIScreen.main.scale
+    metalLayer.contentsScale = scale
+    let size = CGSize(width: bounds.width * scale, height: bounds.height * scale)
+    if size.width > 0, size.height > 0 { metalLayer.drawableSize = size }
+  }
+
+  private func attachIfNeeded() {
+    guard handle == nil, window != nil, bounds.width > 0, bounds.height > 0 else { return }
+    syncDrawableSize()
+    let layerPtr = Unmanaged.passUnretained(metalLayer).toOpaque()
+    handle = resolveFontPath().withCString { fp in
+      withOptCString(configJson) { cfg in
+        withOptCString(shellId) { sid in
+          fressh_terminal_attach(layerPtr, fp, cfg, sid)
+        }
+      }
+    }
+    if handle != nil { startRenderLoop() }
+  }
+
+  private func startRenderLoop() {
+    let link = CADisplayLink(target: self, selector: #selector(onFrame))
+    link.add(to: .main, forMode: .common)
+    displayLink = link
+  }
+
+  @objc private func onFrame() {
+    guard let handle else { return }
+    fressh_terminal_draw(handle)
+  }
+
+  /// Drop the renderer/EGL context. The shell's `Term` survives in the registry,
+  /// so a later attach to the same `shellId` resumes instantly (§9).
+  func teardown() {
+    displayLink?.invalidate()
+    displayLink = nil
+    if let handle {
+      fressh_terminal_destroy(handle)
+      self.handle = nil
+    }
+  }
+
+  /// The native renderer needs a font *file* path. Fall back to the bundled
+  /// DejaVu Sans Mono shipped in the podspec resource bundle.
+  private func resolveFontPath() -> String {
+    if !fontPath.isEmpty { return fontPath }
+    let owner = Bundle(for: TerminalMetalView.self)
+    if let bundleURL = owner.url(forResource: "FresshTerminalFonts", withExtension: "bundle"),
+      let resources = Bundle(url: bundleURL),
+      let font = resources.path(forResource: "DejaVuSansMono", ofType: "ttf")
+    {
+      return font
+    }
+    return owner.path(forResource: "DejaVuSansMono", ofType: "ttf") ?? ""
+  }
+
+  deinit { teardown() }
+}
+
+/// Call `body` with a C string for `s`, or NULL when `s` is nil.
+private func withOptCString<R>(_ s: String?, _ body: (UnsafePointer<CChar>?) -> R) -> R {
+  if let s { return s.withCString { body($0) } }
+  return body(nil)
+}
+
+/// iOS implementation of the `Terminal` Nitro HybridView (the render plane, §10).
+/// Owns the `CAMetalLayer` view and forwards props to it.
+class HybridTerminal: HybridTerminalSpec {
+  private let metalView = TerminalMetalView()
+  var view: UIView { metalView }
+
+  var fontPath: String = "" {
+    didSet { metalView.fontPath = fontPath }
+  }
+  var configJson: String? {
+    didSet { metalView.configJson = configJson }
+  }
+  var shellId: String? {
+    didSet { metalView.shellId = shellId }
+  }
+
+  func onDropView() {
+    metalView.teardown()
+  }
+}

package/ios/ReactNativeTerminalUniffi.mm

@@ -0,0 +1,77 @@
+// Control-plane installer (iOS) — the analogue of Android's
+// ReactNativeTerminalModule.kt + cpp-adapter.cpp `nativeInstallRustCrate` (§5/§8).
+//
+// JS calls `ReactNativeTerminalUniffi.installRustCrate()` once at startup
+// (src/ssh.ts → ensureNativeInstalled). That installs the
+// `globalThis.NativeShimUniffi` host object the ubrn-generated TS bindings call;
+// without it the first uniffi call throws "Cannot read property
+// 'ubrn_uniffi_shim_uniffi_fn_func_*' of undefined".
+//
+// We hand-wire this (rather than `ubrn build`'s generated TurboModule) so the
+// Rust links into the SAME pod/binary as the Nitro render view → ONE copy of
+// fressh-core's registry statics (§8). We call the lower-level
+// `NativeShimUniffi::registerModule` primitive directly, exactly like Android.
+//
+// Mechanism: a non-codegen C++ TurboModule. The install host function receives
+// the `jsi::Runtime&` directly (no fragile bridge-runtime lookup, which is awkward
+// in bridgeless mode) and the CallInvoker from `params.jsInvoker`.
+//
+// CRITICAL: the class MUST conform to `RCTTurboModule`. RCTTurboModuleManager gates
+// the whole getTurboModule: path on `conformsToProtocol:@protocol(RCTTurboModule)`
+// (RCTTurboModuleManager.mm) — without it the module is treated as a legacy interop
+// module, getTurboModule: is never called, and the `methodMap_` methods (incl.
+// installRustCrate) never surface to JS. This app is new-arch only (Nitro mandates
+// it), so no old-arch fallback is needed.
+
+#import <Foundation/Foundation.h>
+#import <React/RCTBridgeModule.h>
+#import <ReactCommon/RCTTurboModule.h>
+
+#include <memory>
+
+#include "shim_uniffi.hpp" // ::NativeShimUniffi::registerModule
+
+namespace fressh_terminal_install {
+using namespace facebook;
+using namespace facebook::react;
+
+// TurboModule carrying the CallInvoker so the install host function can hand it to
+// registerModule (Rust uses it to call back into JS for the event sink).
+class ReactNativeTerminalUniffiModule : public ObjCTurboModule {
+public:
+  ReactNativeTerminalUniffiModule(const ObjCTurboModule::InitParams &params);
+  std::shared_ptr<CallInvoker> callInvoker;
+};
+
+// Installs globalThis.NativeShimUniffi. Synchronous: ssh.ts uses the bindings
+// immediately after this returns. Returns true on success (parity with Android's
+// boolean nativeInstallRustCrate).
+static jsi::Value installRustCrate(jsi::Runtime &rt, TurboModule &turboModule,
+                                   const jsi::Value * /*args*/, size_t /*count*/) {
+  auto &tm = static_cast<ReactNativeTerminalUniffiModule &>(turboModule);
+  ::NativeShimUniffi::registerModule(rt, tm.callInvoker);
+  return jsi::Value(true);
+}
+
+ReactNativeTerminalUniffiModule::ReactNativeTerminalUniffiModule(
+    const ObjCTurboModule::InitParams &params)
+    : ObjCTurboModule(params), callInvoker(params.jsInvoker) {
+  methodMap_["installRustCrate"] = MethodMetadata{0, installRustCrate};
+}
+} // namespace fressh_terminal_install
+
+@interface ReactNativeTerminalUniffi : NSObject <RCTBridgeModule, RCTTurboModule>
+@end
+
+@implementation ReactNativeTerminalUniffi
+
+// Module name = "ReactNativeTerminalUniffi" (matches the TurboModuleRegistry lookup
+// in ssh.ts and the Android ReactNativeTerminalModule.NAME).
+RCT_EXPORT_MODULE()
+
+- (std::shared_ptr<facebook::react::TurboModule>)getTurboModule:
+    (const facebook::react::ObjCTurboModule::InitParams &)params {
+  return std::make_shared<fressh_terminal_install::ReactNativeTerminalUniffiModule>(params);
+}
+
+@end

package/ios/fetch-angle.sh

@@ -0,0 +1,39 @@
+#!/usr/bin/env bash
+#
+# Vendor prebuilt ANGLE (libEGL + libGLESv2, Metal backend) for iOS — the GLES2
+# driver our renderer runs over on iOS (Strategy A + ANGLE→Metal, §2/§5). ANGLE
+# has no published iOS dylibs from Google; we use the kivy/angle-builder release,
+# which packages mainline ANGLE as `libEGL.xcframework` + `libGLESv2.xcframework`
+# (each device + arm64/x64 simulator), with the dlopen-able dynamic libs our
+# `khronos-egl` `dynamic` path resolves at runtime.
+#
+# Extracts the two xcframeworks to the PACKAGE ROOT, where they are COMMITTED
+# (stable third-party prebuilts — see .gitignore, which ignores only the
+# rust-derived shim_uniffi.xcframework). So this only needs re-running when bumping
+# the pinned tag, NOT on every clean checkout. Pin the tag; bump deliberately. Run
+# from the package dir: `bun run angle:fetch`.
+
+set -euo pipefail
+
+# Pinned ANGLE release (kivy/angle-builder). Bump intentionally + re-verify.
+ANGLE_REPO="kivy/angle-builder"
+ANGLE_TAG="chromium-7151_rev1"
+ANGLE_ASSET="angle-iphoneall-universal.tar.gz" # device + arm64/x64 sim, universal
+
+# Package root = parent of this script's ios/ dir.
+PKG_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
+TMP="$(mktemp -d)"
+trap 'rm -rf "$TMP"' EXIT
+
+echo "▸ Downloading ANGLE ${ANGLE_TAG}/${ANGLE_ASSET}"
+gh release download "$ANGLE_TAG" -R "$ANGLE_REPO" -p "$ANGLE_ASSET" -D "$TMP"
+
+echo "▸ Extracting libEGL.xcframework + libGLESv2.xcframework → ${PKG_DIR}"
+tar xzf "$TMP/$ANGLE_ASSET" -C "$TMP"
+for fw in libEGL.xcframework libGLESv2.xcframework; do
+	rm -rf "${PKG_DIR:?}/${fw}"
+	cp -R "$TMP/$fw" "$PKG_DIR/$fw"
+	echo "  ✓ $fw"
+done
+
+echo "✓ ANGLE vendored at ${PKG_DIR} (libEGL.xcframework, libGLESv2.xcframework)"