Function resolveAppleDevice

src/core/dispatch-resolve.ts:62–80

* Resolves the best iOS device given pre-fetched candidates. When no explicit * device selector was used, physical devices are rejected in favour of a * bootable simulator discovered via `findBootableSimulator`. * * Exported for testing; production callers should use `resolveTargetDevice`.

(
  devices: DeviceInfo[],
  selector: AppleDeviceSelector,
  context: { simulatorSetPath?: string },
)

 * Exported for testing; production callers should use `resolveTargetDevice`.
 */
async function resolveAppleDevice(
  devices: DeviceInfo[],
  selector: AppleDeviceSelector,
  context: { simulatorSetPath?: string },
): Promise<DeviceInfo> {
  const selected = await resolveAppleDeviceCandidate(devices, selector, context);

  if (shouldUseAppleSimulatorFallback(selector, selected)) {
    const { findBootableIosSimulator } = await import('../platforms/apple/core/devices.ts');
    const simulator = await findBootableIosSimulator({
      simulatorSetPath: context.simulatorSetPath,
      target: selector.target,
    });
    if (simulator) return simulator;
  }

  if (selected) return selected;
  throw new AppError('DEVICE_NOT_FOUND', 'No devices found', { selector });
}

async function resolveAppleDeviceCandidate(
  devices: DeviceInfo[],