feat(2.26.0): Add the ability to spread attributes from the ... attribute

Author: LexAgone

src/TwigComponent/CHANGELOG.md

@@ -1,5 +1,9 @@
 # CHANGELOG
 
+## 2.26.0
+
+-   Add the ability to spread attributes from the `...` attribute
+
 ## 2.25.2
 
 -   Fix `ComponentAttributes` rendering when using `StimulusAttributes` as default attributes

src/TwigComponent/src/ComponentAttributes.php

@@ -26,16 +26,23 @@ final class ComponentAttributes implements \Stringable, \IteratorAggregate, \Cou
     private const ALPINE_REGEX = '#^x-([a-z]+):[^:]+$#';
     private const VUE_REGEX = '#^v-([a-z]+):[^:]+$#';
 
+    private const SPREADABLE_ATTRIBUTE = '...';
+
+    /** @var array<string, string|bool> */
+    private array $attributes = [];
+
     /** @var array<string,true> */
     private array $rendered = [];
 
     /**
      * @param array<string, string|bool> $attributes
      */
     public function __construct(
-        private array $attributes,
+        array $attributes,
         private readonly EscaperRuntime $escaper,
-    ) {
+    )
+    {
+        $this->attributes = $this->handleAttributes($attributes);
     }
 
     public function __toString(): string
@@ -103,6 +110,31 @@ public function __clone(): void
         $this->rendered = [];
     }
 
+    private function handleAttributes(array $attributes): array
+    {
+        $spreadAttributes = $attributes[self::SPREADABLE_ATTRIBUTE] ?? null;
+
+        if (!$spreadAttributes) {
+            return $attributes;
+        }
+
+        if ($spreadAttributes instanceof StimulusAttributes) {
+            $spreadAttributes = $spreadAttributes->toArray();
+        }
+
+        if ($spreadAttributes instanceof \Traversable) {
+            $spreadAttributes = iterator_to_array($spreadAttributes);
+        }
+
+        if (!\is_array($spreadAttributes)) {
+            throw new \InvalidArgumentException(\sprintf('The "%s" attribute must be an array, "%s" given.', self::SPREADABLE_ATTRIBUTE, get_debug_type($spreadAttributes)));
+        }
+
+        unset($attributes[self::SPREADABLE_ATTRIBUTE]);
+
+        return [...$attributes, ...$spreadAttributes];
+    }
+
     public function render(string $attribute): ?string
     {
         if (null === $value = $this->attributes[$attribute] ?? null) {

src/TwigComponent/src/ComponentFactory.php

@@ -113,12 +113,6 @@ public function mountFromObject(object $component, array $data, ComponentMetadat
         $attributes = $data[$attributesVar] ?? [];
         unset($data[$attributesVar]);
 
-        foreach ($data as $key => $value) {
-            if ($value instanceof \Stringable) {
-                $data[$key] = (string) $value;
-            }
-        }
-
         return new MountedComponent(
             $componentMetadata->getName(),
             $component,