[LiveComponent] add AttributeBag/HasAttributesTrait

Author: kbond

src/TwigComponent/src/AttributeBag.php

@@ -0,0 +1,83 @@
+<?php
+
+/*
+ * This file is part of the Symfony package.
+ *
+ * (c) Fabien Potencier <[email protected]>
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Symfony\UX\TwigComponent;
+
+/**
+ * @author Kevin Bond <[email protected]>
+ *
+ * @experimental
+ */
+final class AttributeBag
+{
+    /**
+     * @param array<string, string> $attributes
+     */
+    public function __construct(public array $attributes)
+    {
+    }
+
+    public static function create(array|self $attributes): self
+    {
+        return $attributes instanceof self ? $attributes : new self($attributes);
+    }
+
+    public function __toString(): string
+    {
+        return \array_reduce(
+            \array_keys($this->attributes),
+            fn(string $carry, string $key) => \sprintf('%s %s="%s"', $carry, $key, $this->attributes[$key]),
+            ''
+        );
+    }
+
+    public function prepend(array $with): self
+    {
+        foreach ($this->attributes as $key => $value) {
+            $with[$key] = isset($with[$key]) ? "{$with[$key]} {$value}" : $value;
+        }
+
+        return new self($with);
+    }
+
+    public function append(array $with): self
+    {
+        foreach ($this->attributes as $key => $value) {
+            $with[$key] = isset($with[$key]) ? "{$value} {$with[$key]}" : $value;
+        }
+
+        return new self($with);
+    }
+
+    public function only(string ...$keys): self
+    {
+        $attributes = [];
+
+        foreach ($this->attributes as $key => $value) {
+            if (in_array($key, $keys, true)) {
+                $attributes[$key] = $value;
+            }
+        }
+
+        return new self($attributes);
+    }
+
+    public function reject(string ...$keys): self
+    {
+        $clone = clone $this;
+
+        foreach ($keys as $key) {
+            unset($clone->attributes[$key]);
+        }
+
+        return $clone;
+    }
+}

src/TwigComponent/src/HasAttributesTrait.php

@@ -0,0 +1,32 @@
+<?php
+
+
+namespace Symfony\UX\TwigComponent;
+
+use Symfony\UX\TwigComponent\Attribute\PreMount;
+
+/**
+ * @author Kevin Bond <[email protected]>
+ *
+ * @experimental
+ */
+trait HasAttributesTrait
+{
+    public AttributeBag $attributes;
+
+    #[PreMount]
+    public function mapAttributes(array $data): array
+    {
+        $data['attributes'] = $this->initAttributes($data['attributes'] ?? []);
+
+        return $data;
+    }
+
+    /**
+     * Override to add your own attribute initialization.
+     */
+    protected function initAttributes(array $attributes): AttributeBag
+    {
+        return AttributeBag::create($attributes);
+    }
+}