[paulbalandan]

Description
Follow-up to #10655. Adds Prompt::select(), which returns the chosen key, and Prompt::multiselect(), which returns the ticked options and can require at least one.

• On a terminal: arrow keys to move, space to tick, a to toggle all, enter to confirm. Long lists scroll.
• Elsewhere (Windows, piped input), the options are listed by number and a number is typed instead.
• A quiet output returns the defaults. Ctrl+C restores the terminal and re-raises SIGINT.

select.mp4

Demo script (run from the framework root)

<?php

declare(strict_types=1);

use CodeIgniter\CLI\CLI;
use CodeIgniter\CLI\Exceptions\CLIException;
use CodeIgniter\CLI\Verbosity;

require getcwd() . '/system/util_bootstrap.php';

CLI::init();

if (in_array('-q', $argv, true)) {
    CLI::getOutput()->setVerbosity(Verbosity::Quiet);
}

$prompt = CLI::getPrompt();

$agents = [
    'claude-code' => 'Claude Code',
    'cursor'      => 'Cursor',
    'copilot'     => 'VS Code Copilot',
    'codex'       => 'Codex CLI',
    'gemini'      => 'Gemini CLI',
    'windsurf'    => 'Windsurf',
    'zed'         => 'Zed',
];

$favourite = $prompt->select('Which agent do you use most?', $agents, 'cursor');
$used      = $prompt->multiselect('Which agents do you use?', $agents, ['claude-code', 'cursor']);

try {
    $features = $prompt->multiselect('Which features should be set up?', ['tools' => 'Tools', 'resources' => 'Resources', 'prompts' => 'Prompts'], required: true);
} catch (CLIException $e) {
    $features = $e->getMessage();
}

fwrite(STDOUT, var_export(['select' => $favourite, 'multiselect' => $used, 'required' => $features], true) . PHP_EOL);

Add -q to see the defaults returned, or pipe the answers to see the numbered fallback: printf '\n\n1,3\n' | php prompt-demo.php.

Checklist:

• Securely signed commits
• Component(s) with PHPDoc blocks, only if necessary or adds value (without duplication)
• Unit testing, with >80% coverage
• User guide updated
• Conforms to style guide