Final Class Yiisoft\Yii\AuthClient\Widget\AuthChoice

                public function __construct(
    Collection $clientCollection,
    private readonly UrlGeneratorInterface $urlGenerator,
    private readonly AssetManager $assetManager,
) {
    $this->clients = $clientCollection->getClients();
}

            

                public function authRoute(string $authRoute): self
{
    $this->authRoute = $authRoute;
    return $this;
}

            

                public function begin(): ?string
{
    parent::begin();
    echo $this->renderOpenTag();
    return null;
}

            

                public function clientLink(OAuth2Interface $client, ?string $text = null, array $htmlOptions = []): string
{
    $viewOptions = $client->getViewOptions();
    if (!empty($viewOptions['widget'])) {
        return $this->renderClientItemWidget($client, (array) $viewOptions['widget']);
    }
    $encodeText = $text !== null;
    if ($text === null) {
        $icon = $this->renderClientLogo($client);
        /** @infection-ignore-all Each arm renders different content for the three display modes */
        $text = match ($this->displayMode) {
            AuthChoiceDisplayMode::Icon => $icon,
            AuthChoiceDisplayMode::Text => $client->getTitle(),
            AuthChoiceDisplayMode::Both => $icon
                . Html::span($client->getTitle(), ['class' => 'auth-title ms-2'])->render(),
        };
        $encodeText = $this->displayMode === AuthChoiceDisplayMode::Text;
    }
    if (!isset($htmlOptions['title'])) {
        $htmlOptions['title'] = $client->getTitle();
    }
    $hasExplicitClass = isset($htmlOptions['class']);
    Html::addCssClass($htmlOptions, ['widget' => 'auth-link']);
    foreach ($this->linkAttributes as $key => $value) {
        if ($key !== 'class') {
            $htmlOptions[$key] = $value;
        } elseif (!$hasExplicitClass) {
            Html::addCssClass($htmlOptions, (string) $value);
        }
    }
    if ($this->popupMode) {
        if (isset($viewOptions['popupWidth'])) {
            /**
             * @var int $viewOptions['popupWidth']
             * @var int $htmlOptions['data-popup-width']
             */
            $htmlOptions['data-popup-width'] = $viewOptions['popupWidth'];
        }
        if (isset($viewOptions['popupHeight'])) {
            /**
            * @var int $viewOptions['popupHeight']
            * @var int $htmlOptions['data-popup-height']
            */
            $htmlOptions['data-popup-height'] = $viewOptions['popupHeight'];
        }
    }
    return Html::a($text, $this->createClientUrl($client), $htmlOptions)->encode($encodeText)->render();
}

            

                public function clientOptions(array $clientOptions): self
{
    $this->clientOptions = $clientOptions;
    return $this;
}

            

                public function createClientUrl($client): string
{
    /** @infection-ignore-all Disable auto-render when URL is requested directly; caller handles rendering */
    $this->autoRender = false;
    $params = [];
    $params[$this->clientIdGetParamName] = $client->getName();
    return $this->urlGenerator->generate($this->authRoute, $params);
}

            

                public function displayMode(AuthChoiceDisplayMode $displayMode): self
{
    $this->displayMode = $displayMode;
    return $this;
}

            

                public function getClient(string $name): OAuth2Interface
{
    $clients = array_filter(
        $this->getClients(),
        fn($client) => $client->getName() === $name,
    );
    $client = end($clients);
    if ($client === false) {
        throw new InvalidConfigException("OAuth2 client with name '{$name}' not found.");
    }
    return $client;
}

            

                public function getClients(): array
{
    return $this->clients;
}

            

                public function iconAttributes(array $iconAttributes): self
{
    $this->iconAttributes = $iconAttributes;
    return $this;
}

            

                public function iconHeight(?string $iconHeight): self
{
    $this->iconHeight = $iconHeight;
    return $this;
}

            

                public function iconWidth(?string $iconWidth): self
{
    $this->iconWidth = $iconWidth;
    return $this;
}

            

                public function iconWrapperAttributes(array $iconWrapperAttributes): self
{
    $this->iconWrapperAttributes = $iconWrapperAttributes;
    return $this;
}

            

                public function linkAttributes(array $linkAttributes): self
{
    $this->linkAttributes = $linkAttributes;
    return $this;
}

            

                public function options(array $options): self
{
    $this->options = $options;
    return $this;
}

            

                public function popupMode(bool $popupMode): self
{
    $this->popupMode = $popupMode;
    return $this;
}

            

                public function render(): string
{
    $content = $this->renderOpenTag();
    if ($this->autoRender) {
        $content .= $this->renderMainContent();
    }
    $content .= Html::div()->close();
    return $content;
}

            

                protected function renderMainContent(): string
{
    $content = '';
    /**
     * @var OAuth2Interface $externalService
     */
    foreach ($this->getClients() as $externalService) {
        // clientLink() already returns rendered, safe-to-embed HTML.
        /** @infection-ignore-all Must concatenate to render all clients, not just the last one */
        $content .= $this->clientLink($externalService);
    }
    return $content;
}

            

                public function setClients(array $clients): void
{
    $this->clients = $clients;
}