list, 'return_paths' => list]`, with * either key absent meaning "could not say". */ public readonly ?\Closure $lookup = null, ) { } /** * Ask the API, safely. * * The "never throws" rule is the provider's to keep, and this is the belt * to its braces: a provider that throws anyway costs an empty answer rather * than a settings screen with a stack trace on it. * * @return array{selectors?: list, return_paths?: list} */ public function ask(string $domain): array { if ($this->lookup === null || trim($domain) === '') { return []; } try { $answer = ($this->lookup)(trim($domain)); } catch (\Throwable) { return []; } return \is_array($answer) ? $answer : []; } }