feat(ios): enable alerts on physical devices

Author: thymikee

src/core/__tests__/capabilities.test.ts

@@ -18,6 +18,14 @@ const iosDevice: DeviceInfo = {
   kind: 'device',
 };
 
+const iPadOsDevice: DeviceInfo = {
+  platform: 'apple',
+  appleOs: 'ipados',
+  id: 'ipad-dev-1',
+  name: 'iPad',
+  kind: 'device',
+};
+
 const androidDevice: DeviceInfo = {
   platform: 'android',
   id: 'and-1',
@@ -91,7 +99,8 @@ test('device capability matrix stays consistent across shared command groups', (
       commands: ['alert'],
       checks: [
         { device: iosSimulator, expected: true, label: 'on iOS sim' },
-        { device: iosDevice, expected: false, label: 'on iOS device' },
+        { device: iosDevice, expected: true, label: 'on iOS device' },
+        { device: iPadOsDevice, expected: false, label: 'on iPadOS device' },
         { device: androidDevice, expected: true, label: 'on Android' },
         { device: macOsDevice, expected: true, label: 'on macOS' },
       ],

src/core/__tests__/capability-plugin-routing-parity.test.ts

@@ -106,6 +106,9 @@ const SAMPLE_DEVICES: DeviceInfo[] = [
 const isNotMacOs = (device: DeviceInfo): boolean => !isMacOs(device);
 const isMacOsOrAppleSimulator = (device: DeviceInfo): boolean =>
   isMacOs(device) || device.kind === 'simulator';
+const isIosOs = (device: DeviceInfo): boolean =>
+  device.platform === 'apple' &&
+  (device.appleOs ? device.appleOs === 'ios' : device.target !== 'tv');
 const supportsAndroidOrIosNonTv = (device: DeviceInfo): boolean =>
   device.platform === 'android' || (isIosFamily(device) && device.target !== 'tv');
 const supportsTvRemote = (device: DeviceInfo): boolean =>
@@ -136,7 +139,8 @@ const SUPPORTS_REF: Record<string, (device: DeviceInfo) => boolean> = {
   keyboard: supportsAndroidOrIosNonTv,
   rotate: supportsAndroidOrIosNonTv,
   'tv-remote': supportsTvRemote,
-  alert: (device) => device.platform === 'android' || isMacOsOrAppleSimulator(device),
+  alert: (device) =>
+    device.platform === 'android' || isIosOs(device) || isMacOsOrAppleSimulator(device),
   settings: (device) =>
     device.platform === 'android' || isMacOs(device) || device.kind === 'simulator',
   audio: supportsHostAudioProbe,

src/core/platform-plugin/__tests__/apple-os-capability-table-parity.test.ts

@@ -47,6 +47,9 @@ registerBuiltinPlatformPlugins();
 const isNotMacOs = (device: DeviceInfo): boolean => !isMacOs(device);
 const isMacOsOrAppleSimulator = (device: DeviceInfo): boolean =>
   isMacOs(device) || device.kind === 'simulator';
+const isIosOs = (device: DeviceInfo): boolean =>
+  device.platform === 'apple' &&
+  (device.appleOs ? device.appleOs === 'ios' : device.target !== 'tv');
 const supportsAndroidOrIosNonTv = (device: DeviceInfo): boolean =>
   device.platform === 'android' || (isIosFamily(device) && device.target !== 'tv');
 const supportsTvRemote = (device: DeviceInfo): boolean =>
@@ -68,7 +71,8 @@ const SUPPORTS_REF: Record<string, (device: DeviceInfo) => boolean> = {
   keyboard: supportsAndroidOrIosNonTv,
   rotate: supportsAndroidOrIosNonTv,
   'tv-remote': supportsTvRemote,
-  alert: (device) => device.platform === 'android' || isMacOsOrAppleSimulator(device),
+  alert: (device) =>
+    device.platform === 'android' || isIosOs(device) || isMacOsOrAppleSimulator(device),
   settings: (device) =>
     device.platform === 'android' || isMacOs(device) || device.kind === 'simulator',
   // `audio` is NOT part of the AppleOS-table relocation — it stays the standalone

src/platforms/apple/capabilities.ts

@@ -35,9 +35,10 @@ export type AppleOsCapabilityProfile = {
   /** `rotate` — device orientation. tvOS (focus-only) and macOS lack it. */
   readonly orientation: boolean;
   /**
-   * Whether `clipboard` / `alert` / `settings` are reachable on a PHYSICAL device of
+   * Whether `clipboard` / `settings` are reachable on a PHYSICAL device of
    * this OS. Only the macOS host exposes them without a simulator; the reading closure
    * still admits every Apple *simulator* via its own `kind === 'simulator'` check.
+   * Alert support has a separate command predicate because physical iOS is verified.
    */
   readonly physicalDeviceSurfaces: boolean;
 };

src/platforms/apple/plugin.ts

@@ -6,7 +6,12 @@ import {
   shouldUseHostMacFastPath,
   type DeviceInventoryRequest,
 } from '../../contracts/device-inventory.ts';
-import { isMacOs, isTvOsDevice, type DeviceInfo } from '../../kernel/device.ts';
+import {
+  isMacOs,
+  isTvOsDevice,
+  resolveDeviceAppleOs,
+  type DeviceInfo,
+} from '../../kernel/device.ts';
 import type { RunnerContext } from '../../core/interactor-types.ts';
 
 // ---------------------------------------------------------------------------
@@ -44,7 +49,7 @@ const supportsOrientation = (device: DeviceInfo): boolean => {
   return caps ? caps.orientation : device.platform === 'android';
 };
 
-// The Apple arm shared by `clipboard`/`alert`/`settings` (was `macos || simulator`):
+// The Apple arm shared by `clipboard`/`settings` (was `macos || simulator`):
 // reachable on the macOS host directly, on every other Apple OS only on the simulator.
 // Off Apple this preserves the trailing `device.kind === 'simulator'` term verbatim.
 const supportsHostOrSimulatorSurface = (device: DeviceInfo): boolean => {
@@ -54,6 +59,12 @@ const supportsHostOrSimulatorSurface = (device: DeviceInfo): boolean => {
     : device.kind === 'simulator';
 };
 
+// Alerts use the host/simulator surface plus physical iOS, whose XCTest path is
+// device-verified. iPadOS/visionOS remain closed until independently verified.
+const supportsAlertSurface = (device: DeviceInfo): boolean =>
+  device.platform === 'android' ||
+  (device.platform === 'apple' && resolveDeviceAppleOs(device) === 'ios') ||
+  supportsHostOrSimulatorSurface(device);
 // `tv-remote` is Android-TV or tvOS only. Off Apple this preserves the Android-TV
 // branch so the relocated Apple closure stays equivalent to the full original
 // supports predicate under the parity guard; the closure is only consulted for Apple
@@ -80,8 +91,7 @@ const APPLE_SUPPORTS_BY_DEFAULT: Record<string, (device: DeviceInfo) => boolean>
   [PUBLIC_COMMANDS.keyboard]: supportsKeyboard,
   [PUBLIC_COMMANDS.rotate]: supportsOrientation,
   [PUBLIC_COMMANDS.tvRemote]: supportsTvRemote,
-  [PUBLIC_COMMANDS.alert]: (device) =>
-    device.platform === 'android' || supportsHostOrSimulatorSurface(device),
+  [PUBLIC_COMMANDS.alert]: supportsAlertSurface,
   [PUBLIC_COMMANDS.settings]: (device) =>
     device.platform === 'android' || supportsHostOrSimulatorSurface(device),
   [PUBLIC_COMMANDS.audio]: isAudioProbeSupportedDevice,