Function selectSimulator

src/cli/commands/setup.ts:559–611

(opts: {
  existingSimulatorId?: string;
  existingSimulatorName?: string;
  platformFilter: SetupPlatform[];
  executor: CommandExecutor;
  prompter: Prompter;
  isTTY: boolean;
  quietOutput: boolean;
})

}

async function selectSimulator(opts: {
  existingSimulatorId?: string;
  existingSimulatorName?: string;
  platformFilter: SetupPlatform[];
  executor: CommandExecutor;
  prompter: Prompter;
  isTTY: boolean;
  quietOutput: boolean;
}): Promise<ListedSimulator | null> {
  const allSimulators = await withSpinner({
    isTTY: opts.isTTY,
    quietOutput: opts.quietOutput,
    startMessage: 'Loading simulators...',
    stopMessage: 'Simulators loaded.',
    task: async () => {
      try {
        return await listSimulators(opts.executor);
      } catch {
        return [];
      }
    },
  });
  const simulators = filterSimulatorsByPlatforms(allSimulators, opts.platformFilter);

  const defaultIndex =
    simulators.length > 0
      ? getDefaultSimulatorIndex(simulators, opts.existingSimulatorId, opts.existingSimulatorName)
      : 0;

  showPromptHelp(
    'Select a simulator to set the default device target used by simulator commands.',
    opts.quietOutput,
  );
  return opts.prompter.selectOne({
    message: 'Select a simulator',
    options: [
      {
        value: null,
        label: 'No default simulator',
        description: 'Leave simulator commands unpinned during setup.',
      },
      ...simulators.map((simulator) => ({
        value: simulator,
        label: `${simulator.runtime} — ${simulator.name} (${simulator.udid})`,
        description: simulator.state,
      })),
    ],
    initialIndex:
      simulators.length > 0 && (opts.existingSimulatorId ?? opts.existingSimulatorName) != null
        ? defaultIndex + 1
        : 0,
  });
}

function requiresSimulatorDefault(enabledWorkflows: string[]): boolean {
  return enabledWorkflows.some((workflowId) => SIMULATOR_DEFAULT_WORKFLOWS.has(workflowId));