feat: watchOS native app support (v0.3.2)

Add full watchOS app compilation via --target watchos/watchos-simulator.
Uses a data-driven SwiftUI renderer: native code builds a UI tree via
perry_ui_* FFI calls, and a fixed PerryWatchApp.swift (shipped with Perry)
queries the tree and renders it as SwiftUI views reactively. No transpilation.

- New perry-ui-watchos crate: data-driven widget tree, reactive state system,
  full perry_ui_* FFI surface (15 supported widgets + stubs for unsupported)
- Cranelift ISA for aarch64-apple-watchos, COMPILE_TARGET=5
- swiftc-based linking (compiles PerryWatchApp.swift alongside native code)
- watchOS .app bundling with WKApplication/WKWatchOnly Info.plist
- perry setup watchos wizard (shares App Store Connect creds with iOS)
- perry run watchos with Apple Watch simulator auto-detection
- [watchos] config section in perry.toml
- Platform docs: docs/src/platforms/watchos.md

Author: proggeramlug

CLAUDE.md

@@ -8,7 +8,7 @@ This file provides guidance to Claude Code (claude.ai/code) when working with co
 
 Perry is a native TypeScript compiler written in Rust that compiles TypeScript source code directly to native executables. It uses SWC for TypeScript parsing and Cranelift for code generation.
 
-**Current Version:** 0.3.0
+**Current Version:** 0.3.2
 
 ## Workflow Requirements
 
@@ -153,6 +153,9 @@ Projects can list npm packages to compile natively instead of routing to V8. Con
 
 ## Recent Changes
 
+### v0.3.2
+- watchOS native app support (`--target watchos`/`--target watchos-simulator`): data-driven SwiftUI renderer, `perry-ui-watchos` crate with full `perry_ui_*` FFI surface, fixed PerryWatchApp.swift runtime, `perry setup watchos`, `perry run watchos`, `[watchos]` config in perry.toml
+
 ### v0.3.0
 - Compile-time i18n system (`perry/i18n` module): zero-ceremony localization for UI strings, `[i18n]` config in perry.toml, embedded 2D string table, native locale detection (all 6 platforms via OS APIs), `{param}` interpolation, CLDR plural rules (30+ locales), format wrappers (`Currency`, `Percent`, `ShortDate`, `LongDate`, `FormatNumber`, `FormatTime`, `Raw`), `perry i18n extract` CLI, iOS `.lproj` + Android `values-xx/` generation, compile-time validation
 

Cargo.lock

@@ -17,6 +17,7 @@ members = [
     "crates/perry-ui-android",
     "crates/perry-ui-gtk4",
     "crates/perry-ui-windows",
+    "crates/perry-ui-watchos",
     "crates/perry-ui-geisterhand",
     "crates/perry-codegen-js",
     "crates/perry-codegen-swiftui",
@@ -79,7 +80,7 @@ opt-level = "s"       # Optimize for size in stdlib
 opt-level = 3
 
 [workspace.package]
-version = "0.3.1"
+version = "0.3.2"
 edition = "2021"
 license = "MIT"
 repository = "https://github.com/PerryTS/perry"

Cargo.toml

@@ -149,6 +149,16 @@ impl Compiler {
                     .finish(settings::Flags::new(flag_builder))
                     .map_err(|e| anyhow!("{}", e))?
             }
+            Some("watchos") | Some("watchos-simulator") => {
+                // Cross-compile for aarch64-apple-watchos (Mach-O)
+                let triple = target_lexicon::Triple::from_str("aarch64-apple-watchos")
+                    .map_err(|e| anyhow!("Bad triple: {}", e))?;
+                let isa_builder = cranelift::codegen::isa::lookup(triple)
+                    .map_err(|e| anyhow!("Failed to create watchOS ISA: {}", e))?;
+                isa_builder
+                    .finish(settings::Flags::new(flag_builder))
+                    .map_err(|e| anyhow!("{}", e))?
+            }
             Some("android") => {
                 // Cross-compile for aarch64-linux-android (ELF)
                 let triple = target_lexicon::Triple::from_str("aarch64-unknown-linux-android")
@@ -197,10 +207,11 @@ impl Compiler {
         let ctx = module.make_context();
 
         // Determine the compile-time platform constant for __platform__:
-        // 0 = macOS, 1 = iOS, 2 = Android, 3 = Windows, 4 = Linux
+        // 0 = macOS, 1 = iOS, 2 = Android, 3 = Windows, 4 = Linux, 5 = watchOS
         let compile_target: i64 = match target {
             Some("ios") | Some("ios-simulator") => 1,
             Some("android") => 2,
+            Some("watchos") | Some("watchos-simulator") => 5,
             Some("windows") => 3,
             Some("linux") => 4,
             _ => {

crates/perry-codegen/src/codegen.rs

@@ -0,0 +1,16 @@
+[package]
+name = "perry-ui-watchos"
+version.workspace = true
+edition.workspace = true
+
+[lib]
+crate-type = ["rlib", "staticlib"]
+
+[features]
+default = []
+plugins = []
+geisterhand = []
+
+[dependencies]
+perry-ui = { path = "../perry-ui" }
+perry-runtime = { path = "../perry-runtime", default-features = false }

crates/perry-ui-watchos/Cargo.toml

@@ -0,0 +1,35 @@
+//! App lifecycle for watchOS.
+//!
+//! Since watchOS uses SwiftUI's @main App, the actual app lifecycle is managed
+//! by the fixed PerryWatchApp.swift. This module stores config and provides
+//! the entry point that Swift calls to run the compiled TypeScript init code.
+
+use std::cell::RefCell;
+
+use crate::tree::{self, NodeData, NodeKind};
+
+thread_local! {
+    static PENDING_BODY: RefCell<Option<i64>> = RefCell::new(None);
+}
+
+pub fn app_create(_title_ptr: *const u8, _width: f64, _height: f64) -> i64 {
+    // On watchOS, the app is created by the SwiftUI @main struct.
+    // We just return a handle to satisfy the API contract.
+    1
+}
+
+pub fn app_set_body(_app_handle: i64, root_handle: i64) {
+    tree::set_root(root_handle);
+    PENDING_BODY.with(|b| {
+        *b.borrow_mut() = Some(root_handle);
+    });
+}
+
+pub fn app_run(_app_handle: i64) {
+    // On watchOS, the SwiftUI run loop is managed by PerryWatchApp.swift.
+    // The compiled TypeScript calls perry_ui_app_run() at the end of init,
+    // but on watchOS this is a no-op — the Swift @main struct drives the loop.
+    //
+    // perry_main_init() is called from Swift before the app body is rendered,
+    // so by the time SwiftUI queries the tree, it's fully built.
+}