gacela-project / container

src/Container/ContextualBindingBuilder.php

<?php

declare(strict_types=1);

namespace Gacela\Container;

use RuntimeException;

use function is_array;

/**
 * Builder for creating contextual bindings.
 * Allows different concrete implementations based on the requesting class.
 */
final class ContextualBindingBuilder
{
    /** @var list<class-string> */
    private array $concrete = [];

    private ?string $needs = null;

    /**
     * @param array<string, array<class-string, class-string|callable|object>> $contextualBindings

The doc comment array<string, array<class-string, class-string|callable|object>> at position 6 could not be parsed: Unknown type name 'class-string' at position 6 in array<string, array<class-string, class-string|callable|object>>.

     */
    public function __construct(
        private array &$contextualBindings,
    ) {
    }

    /**
     * Define which class(es) this binding applies to.
     *
     * @param class-string|list<class-string> $concrete

The doc comment class-string|list<class-string> at position 0 could not be parsed: Unknown type name 'class-string' at position 0 in class-string|list<class-string>.

     */
    public function when(string|array $concrete): self
    {
        $this->concrete = is_array($concrete) ? $concrete : [$concrete];

The condition is_array($concrete) is always true.

It seems like is_array($concrete) ? $concrete : array($concrete) of type array is incompatible with the declared type Gacela\Container\list of property $concrete.

        return $this;
    }

    /**
     * Define which dependency to bind.
     *
     * @param class-string $abstract
     */
    public function needs(string $abstract): self
    {
        $this->needs = $abstract;

        return $this;
    }

    /**
     * Define what to give when the dependency is needed.
     *
     * @param class-string|callable|object $implementation

The doc comment class-string|callable|object at position 0 could not be parsed: Unknown type name 'class-string' at position 0 in class-string|callable|object.

     */
    public function give(mixed $implementation): void
    {
        if ($this->needs === null) {
            throw new RuntimeException('Must call needs() before give()');
        }

        foreach ($this->concrete as $concreteClass) {
            if (!isset($this->contextualBindings[$concreteClass])) {
                /** @psalm-suppress PropertyTypeCoercion */
                $this->contextualBindings[$concreteClass] = [];
            }

            /**
             * @psalm-suppress PropertyTypeCoercion
             *
             * @phpstan-ignore assign.propertyType
             */
            $this->contextualBindings[$concreteClass][$this->needs] = $implementation;
        }
    }
}