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',
@@ -101,7 +109,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 isIosMobileSimulator = (device: DeviceInfo): boolean =>
   isIosFamily(device) && device.kind === 'simulator' && device.target !== 'tv';
 const supportsSynthesisGesture = (device: DeviceInfo): boolean =>
@@ -150,7 +153,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

@@ -49,6 +49,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 isIosMobileSimulator = (device: DeviceInfo): boolean =>
   isIosFamily(device) && device.kind === 'simulator' && device.target !== 'tv';
 const supportsSynthesisGesture = (device: DeviceInfo): boolean =>
@@ -84,7 +87,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

@@ -36,9 +36,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

@@ -1,4 +1,4 @@
-import { appleOsCapabilities } from './capabilities.ts';
+import { appleOsCapabilities, resolveDeviceAppleOs } from './capabilities.ts';
 import type { PlatformPlugin } from '../../core/platform-plugin/plugin.ts';
 import { PUBLIC_COMMANDS } from '../../command-catalog.ts';
 import { isAudioProbeSupportedDevice } from '../../kernel/audio-probe-support.ts';
@@ -44,7 +44,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 +54,13 @@ 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);
+
 // `pinch`/`rotate-gesture`/`transform-gesture` (was `android || (ios && simulator &&
 // target !== 'tv')`). Apple: the OS multi-touch model AND a simulator (physical iOS
 // cannot synthesize). Off Apple: only `android`.
@@ -103,8 +110,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,