Rename method ArrayDefinition::setReferenceContainer() to withReferenceContainer() and make him immutable

CHANGELOG.md

@@ -4,6 +4,8 @@
 
 - New #37: Make method `DefinitionValidator::validateArrayDefinition()` public (vjik)
 - Chg #37: Remove method `ParameterDefinition::isBuiltin()` (vjik)
+- Chg #30: Rename method `ArrayDefinition::setReferenceContainer()` to `withReferenceContainer()` and make it
+  immutable (vjik)
 
 ## 1.0.2 April 01, 2022
 

src/ArrayDefinition.php

@@ -59,9 +59,11 @@ private function __construct(string $class, array $constructorArguments, array $
     /**
      * @param ContainerInterface|null $referenceContainer Container to resolve references with.
      */
-    public function setReferenceContainer(?ContainerInterface $referenceContainer): void
+    public function withReferenceContainer(?ContainerInterface $referenceContainer): self
     {
-        $this->referenceContainer = $referenceContainer;
+        $new = clone $this;
+        $new->referenceContainer = $referenceContainer;
+        return $new;
     }
 
     /**

tests/Unit/ArrayDefinitionTest.php

@@ -314,11 +314,12 @@ public function testReferenceContainer(): void
             'class' => Car::class,
             'setColor()' => [Reference::to(ColorInterface::class)],
         ]);
-        $definition->setReferenceContainer($referenceContainer);
+        $newDefinition = $definition->withReferenceContainer($referenceContainer);
 
         /** @var Car $object */
-        $object = $definition->resolve($container);
+        $object = $newDefinition->resolve($container);
 
+        $this->assertNotSame($definition, $newDefinition);
         $this->assertInstanceOf(Car::class, $object);
         $this->assertInstanceOf(EngineMarkOne::class, $object->getEngine());
     }