feat(ios): add iOS 27 platform APIs

crates/perry-api-manifest/src/entries.rs

@@ -132,6 +132,7 @@ pub const NATIVE_MODULES: &[&str] = &[
     "perry/tui",      // terminal-UI framework
     "perry/yoga",     // Yoga flexbox layout
     "perry/ui",       // native UI (AppKit/UIKit/Win32/GTK4/…)
+    "perry/ios",      // iOS-only UIKit/Foundation Models APIs
     "perry/system",   // OS integration (keychain, notifications, …)
     "perry/plugin",   // compile-time plugin surface
     "perry/widget",   // home-screen widgets (WidgetKit/Glance)
@@ -265,6 +266,7 @@ pub const RUNTIME_ONLY_MODULES: &[&str] = &[
     // (registry + fs interception); no perry-stdlib surface needed.
     "perry",
     "perry/ui",
+    "perry/ios",
     "perry/system",
     "perry/widget",
     "perry/i18n",

crates/perry-api-manifest/src/entries/part_4.rs

@@ -593,6 +593,14 @@ pub(crate) const API_MANIFEST_PART_4: &[ApiEntry] = &[
     method("perry/media", "onTimeUpdate", false, None),
     method("perry/media", "setNowPlaying", false, None),
     method("perry/media", "destroy", false, None),
+    // --- perry/ios (issue #5536) — auto-derivable from PERRY_IOS_TABLE. ---
+    method("perry/ios", "getLayoutEnvironment", false, None),
+    method("perry/ios", "onLayoutChange", false, None),
+    method("perry/ios", "offLayoutChange", false, None),
+    method("perry/ios", "foundationModelAvailability", false, None),
+    method("perry/ios", "createLanguageModelSession", false, None),
+    method("perry/ios", "respond", false, None),
+    method("perry/ios", "destroyLanguageModelSession", false, None),
     // --- perry/audio (issue #1867) — auto-derivable from PERRY_AUDIO_TABLE. ---
     method("perry/audio", "loadSound", false, None),
     method("perry/audio", "unload", false, None),

crates/perry-codegen/src/lower_call/mod.rs

@@ -123,9 +123,9 @@ use ui_styling::apply_inline_style;
 // table-lookup family and `lower_perry_ui_table_call` unchanged.
 pub(super) use ui_tables::{
     lower_perry_ui_table_call, perry_audio_table_lookup, perry_background_table_lookup,
-    perry_i18n_table_lookup, perry_media_table_lookup, perry_plugin_instance_method_lookup,
-    perry_plugin_table_lookup, perry_system_table_lookup, perry_ui_instance_method_lookup,
-    perry_ui_table_lookup, perry_updater_table_lookup,
+    perry_i18n_table_lookup, perry_ios_table_lookup, perry_media_table_lookup,
+    perry_plugin_instance_method_lookup, perry_plugin_table_lookup, perry_system_table_lookup,
+    perry_ui_instance_method_lookup, perry_ui_table_lookup, perry_updater_table_lookup,
 };
 // Same for `native_module_dispatch.rs` — `native.rs` consumes both
 // `native_module_lookup` and `lower_native_module_dispatch` via

crates/perry-codegen/src/lower_call/native/mod.rs

@@ -41,10 +41,10 @@ pub(super) use super::{
     find_outer_writes_stmt, find_thread_hazard_in_body, get_raw_string_ptr,
     hazardous_module_global_ids, lower_fetch_native_method, lower_native_module_dispatch,
     lower_notification_schedule, lower_perry_ui_table_call, native_module_lookup,
-    perry_audio_table_lookup, perry_i18n_table_lookup, perry_media_table_lookup,
-    perry_plugin_instance_method_lookup, perry_plugin_table_lookup, perry_system_table_lookup,
-    perry_ui_instance_method_lookup, perry_ui_table_lookup, perry_updater_table_lookup,
-    ThreadClosureHazard,
+    perry_audio_table_lookup, perry_i18n_table_lookup, perry_ios_table_lookup,
+    perry_media_table_lookup, perry_plugin_instance_method_lookup, perry_plugin_table_lookup,
+    perry_system_table_lookup, perry_ui_instance_method_lookup, perry_ui_table_lookup,
+    perry_updater_table_lookup, ThreadClosureHazard,
 };
 
 mod box_style;

crates/perry-codegen/src/lower_call/native/native_ui_widgets_branch.rs

@@ -346,6 +346,26 @@
         );
     }
 
+    // iOS-only adaptive scene geometry + Foundation Models (#5536). The
+    // module is deliberately platform-specific so other UI backends never
+    // receive unresolved UIKit/Swift symbols.
+    if module == "perry/ios" && object.is_none() {
+        if !ctx.target_triple.contains("apple-ios") {
+            bail!(
+                "perry/ios is only available for --target ios or ios-simulator (current target: {})",
+                ctx.target_triple
+            );
+        }
+        if let Some(sig) = perry_ios_table_lookup(method) {
+            return lower_perry_ui_table_call(ctx, sig, args);
+        }
+        bail!(
+            "perry/ios: '{}' is not a known function (args: {}). Check types/perry/ios/index.d.ts for the supported API surface.",
+            method,
+            args.len()
+        );
+    }
+
     // perry/i18n format wrappers: Currency, Percent, FormatNumber, ShortDate,
     // LongDate, FormatTime, Raw. Without this, the call falls through to the
     // receiver-less early-out and returns NaN-boxed `undefined` (issue #188).

crates/perry-codegen/src/lower_call/ui_tables.rs

@@ -16,8 +16,8 @@ use crate::types::{DOUBLE, I64};
 
 use perry_dispatch::{
     ArgKind as UiArgKind, MethodRow as UiSig, ReturnKind as UiReturnKind, PERRY_AUDIO_TABLE,
-    PERRY_BACKGROUND_TABLE, PERRY_I18N_TABLE, PERRY_MEDIA_TABLE, PERRY_SYSTEM_TABLE,
-    PERRY_UI_INSTANCE_TABLE, PERRY_UI_TABLE, PERRY_UPDATER_TABLE,
+    PERRY_BACKGROUND_TABLE, PERRY_I18N_TABLE, PERRY_IOS_TABLE, PERRY_MEDIA_TABLE,
+    PERRY_SYSTEM_TABLE, PERRY_UI_INSTANCE_TABLE, PERRY_UI_TABLE, PERRY_UPDATER_TABLE,
 };
 
 use super::apply_inline_style;
@@ -54,6 +54,14 @@ pub fn perry_media_table_lookup(method: &str) -> Option<&'static UiSig> {
     PERRY_MEDIA_TABLE.iter().find(|s| s.method == method)
 }
 
+// =============================================================================
+// perry/ios dispatch table (issue #5536)
+// =============================================================================
+
+pub fn perry_ios_table_lookup(method: &str) -> Option<&'static UiSig> {
+    PERRY_IOS_TABLE.iter().find(|s| s.method == method)
+}
+
 // =============================================================================
 // perry/i18n format-wrapper dispatch table
 // =============================================================================

crates/perry-codegen/tests/ios_platform_api_lowering.rs

@@ -0,0 +1,166 @@
+//! Regression coverage for the iOS-only `perry/ios` table (#5536).
+
+use perry_codegen::{compile_module, AppMetadata, CompileOptions};
+use perry_hir::types::Type;
+use perry_hir::{Expr, Function, Module, ModuleInitKind, Stmt};
+
+fn options(target: Option<&str>) -> CompileOptions {
+    CompileOptions {
+        target: target.map(str::to_string),
+        is_entry_module: false,
+        non_entry_module_prefixes: Vec::new(),
+        import_function_prefixes: Default::default(),
+        import_function_ffi_aliases: Default::default(),
+        import_function_origin_names: Default::default(),
+        import_function_v8_specifiers: Default::default(),
+        import_function_node_submodule: Default::default(),
+        namespace_node_submodules: Default::default(),
+        namespace_v8_specifiers: Default::default(),
+        namespace_member_prefixes: Default::default(),
+        namespace_member_origin_names: Default::default(),
+        emit_ir_only: true,
+        verify_native_regions: false,
+        disable_buffer_fast_path: false,
+        namespace_imports: Vec::new(),
+        namespace_member_nested: Vec::new(),
+        imported_classes: Vec::new(),
+        imported_enums: Vec::new(),
+        imported_async_funcs: Default::default(),
+        type_aliases: Default::default(),
+        imported_func_param_counts: Default::default(),
+        imported_func_has_rest: Default::default(),
+        imported_func_synthetic_arguments: Default::default(),
+        imported_func_return_types: Default::default(),
+        imported_vars: Default::default(),
+        output_type: "executable".to_string(),
+        needs_stdlib: false,
+        needs_ui: true,
+        needs_geisterhand: false,
+        geisterhand_port: 7676,
+        enabled_features: Vec::new(),
+        native_module_init_names: Vec::new(),
+        js_module_specifiers: Vec::new(),
+        bundled_extensions: Vec::new(),
+        native_library_functions: Vec::new(),
+        i18n_table: None,
+        fast_math: false,
+        fp_contract_mode: perry_codegen::FpContractMode::Off,
+        app_metadata: AppMetadata::default(),
+        namespace_entries: Vec::new(),
+        dynamic_import_path_to_prefix: Default::default(),
+        nextjs_path_init_modules: Vec::new(),
+        deferred_module_prefixes: Default::default(),
+        module_init_deps: Vec::new(),
+        is_dynamic_import_target: false,
+        debug_locations: false,
+        module_source: None,
+        debug_source_line_offset: 0,
+    }
+}
+
+fn call(method: &str, args: Vec<Expr>) -> Stmt {
+    Stmt::Expr(Expr::NativeMethodCall {
+        module: "perry/ios".to_string(),
+        class_name: None,
+        object: None,
+        method: method.to_string(),
+        args,
+    })
+}
+
+fn module(body: Vec<Stmt>) -> Module {
+    Module {
+        name: "ios_platform_api_probe".to_string(),
+        imports: Vec::new(),
+        exports: Vec::new(),
+        classes: Vec::new(),
+        interfaces: Vec::new(),
+        type_aliases: Vec::new(),
+        enums: Vec::new(),
+        globals: Vec::new(),
+        functions: vec![Function {
+            id: 1,
+            name: "probe".to_string(),
+            type_params: Vec::new(),
+            params: Vec::new(),
+            return_type: Type::Number,
+            body,
+            is_async: false,
+            is_generator: false,
+            is_strict: false,
+            is_exported: false,
+            captures: Vec::new(),
+            decorators: Vec::new(),
+            was_plain_async: false,
+            was_unrolled: false,
+        }],
+        init: Vec::new(),
+        exported_native_instances: Vec::new(),
+        exported_func_return_native_instances: Vec::new(),
+        exported_objects: Vec::new(),
+        exported_functions: Vec::new(),
+        script_global_functions: Vec::new(),
+        references_global_this: false,
+        annexb_global_undefined_names: Vec::new(),
+        widgets: Vec::new(),
+        uses_fetch: false,
+        uses_webassembly: false,
+        extern_funcs: Vec::new(),
+        init_was_unrolled: false,
+        has_top_level_await: false,
+        init_kind: ModuleInitKind::Eager,
+        async_step_closures: Default::default(),
+        closure_display_names: Default::default(),
+        class_display_names: Default::default(),
+        closure_source_text: Default::default(),
+        async_generator_funcs: Default::default(),
+        local_source_spans: Default::default(),
+        gen_param_prologue_len: Default::default(),
+    }
+}
+
+#[test]
+fn ios_layout_and_foundation_model_calls_emit_runtime_symbols() {
+    let hir = module(vec![
+        call("getLayoutEnvironment", vec![]),
+        call("onLayoutChange", vec![Expr::Number(0.0)]),
+        call("offLayoutChange", vec![Expr::Number(1.0)]),
+        call("foundationModelAvailability", vec![]),
+        // The optional instructions argument must pad to an empty runtime string.
+        call("createLanguageModelSession", vec![]),
+        call(
+            "respond",
+            vec![Expr::Number(1.0), Expr::String("Hello".to_string())],
+        ),
+        call("destroyLanguageModelSession", vec![Expr::Number(1.0)]),
+    ]);
+    let ir =
+        String::from_utf8(compile_module(&hir, options(Some("aarch64-apple-ios17.0"))).unwrap())
+            .unwrap();
+
+    for symbol in [
+        "@perry_ios_get_layout_environment",
+        "@perry_ios_on_layout_change",
+        "@perry_ios_off_layout_change",
+        "@perry_ios_foundation_model_availability",
+        "@perry_ios_foundation_model_session_create",
+        "@perry_ios_foundation_model_respond",
+        "@perry_ios_foundation_model_session_destroy",
+    ] {
+        assert!(ir.contains(symbol), "missing {symbol} in IR:\n{ir}");
+    }
+}
+
+#[test]
+fn ios_module_is_rejected_for_non_ios_targets() {
+    let error = compile_module(
+        &module(vec![call("getLayoutEnvironment", vec![])]),
+        options(Some("aarch64-apple-darwin")),
+    )
+    .unwrap_err();
+    let error = format!("{error:#}");
+    assert!(
+        error.contains("perry/ios is only available"),
+        "unexpected diagnostic: {error}"
+    );
+}

crates/perry-dispatch/src/ios_table.rs

@@ -0,0 +1,51 @@
+//! `PERRY_IOS_TABLE` — iOS-specific adaptive layout and Foundation Models.
+
+use super::*;
+
+/// APIs that intentionally expose iOS-only platform capabilities. Keeping
+/// these out of `PERRY_UI_TABLE` prevents other UI backends from having to
+/// pretend that UIKit scene geometry or Foundation Models exist.
+pub static PERRY_IOS_TABLE: &[MethodRow] = &[
+    MethodRow {
+        method: "getLayoutEnvironment",
+        runtime: "perry_ios_get_layout_environment",
+        args: &[],
+        ret: ReturnKind::Widget,
+    },
+    MethodRow {
+        method: "onLayoutChange",
+        runtime: "perry_ios_on_layout_change",
+        args: &[ArgKind::Closure],
+        ret: ReturnKind::I64AsF64,
+    },
+    MethodRow {
+        method: "offLayoutChange",
+        runtime: "perry_ios_off_layout_change",
+        args: &[ArgKind::F64],
+        ret: ReturnKind::Void,
+    },
+    MethodRow {
+        method: "foundationModelAvailability",
+        runtime: "perry_ios_foundation_model_availability",
+        args: &[],
+        ret: ReturnKind::Str,
+    },
+    MethodRow {
+        method: "createLanguageModelSession",
+        runtime: "perry_ios_foundation_model_session_create",
+        args: &[ArgKind::Str],
+        ret: ReturnKind::I64AsF64,
+    },
+    MethodRow {
+        method: "respond",
+        runtime: "perry_ios_foundation_model_respond",
+        args: &[ArgKind::F64, ArgKind::Str],
+        ret: ReturnKind::Promise,
+    },
+    MethodRow {
+        method: "destroyLanguageModelSession",
+        runtime: "perry_ios_foundation_model_session_destroy",
+        args: &[ArgKind::F64],
+        ret: ReturnKind::Void,
+    },
+];

crates/perry-dispatch/src/lib.rs

@@ -97,6 +97,7 @@ pub struct MethodRow {
 mod audio_table;
 mod background_table;
 mod i18n_table;
+mod ios_table;
 mod media_table;
 mod system_table;
 mod ui_instance_table;
@@ -106,6 +107,7 @@ mod updater_table;
 pub use audio_table::PERRY_AUDIO_TABLE;
 pub use background_table::PERRY_BACKGROUND_TABLE;
 pub use i18n_table::PERRY_I18N_TABLE;
+pub use ios_table::PERRY_IOS_TABLE;
 pub use media_table::PERRY_MEDIA_TABLE;
 pub use system_table::PERRY_SYSTEM_TABLE;
 pub use ui_instance_table::PERRY_UI_INSTANCE_TABLE;
@@ -134,6 +136,11 @@ pub fn perry_i18n_lookup(method: &str) -> Option<&'static MethodRow> {
     PERRY_I18N_TABLE.iter().find(|s| s.method == method)
 }
 
+/// Look up a TS method name in the iOS-only platform table.
+pub fn perry_ios_lookup(method: &str) -> Option<&'static MethodRow> {
+    PERRY_IOS_TABLE.iter().find(|s| s.method == method)
+}
+
 /// Look up a TS method name in the perry/updater table.
 pub fn perry_updater_lookup(method: &str) -> Option<&'static MethodRow> {
     PERRY_UPDATER_TABLE.iter().find(|s| s.method == method)