bug #914 [TwigComponent] Fix breaking (deprecation instead) when using .add() + StimulusBundle (weaverryan)

This PR was squashed before being merged into the 2.x branch.

Discussion
----------

[TwigComponent] Fix breaking (deprecation instead) when using .add() + StimulusBundle

| Q             | A
| ------------- | ---
| Bug fix?      | yes
| New feature?  | no
| Tickets       | None - reported on Slack.
| License       | MIT

Accidental break if upgrading to use new StimulusBundle, but still using `attributes.add(stimulus_controller())`.

Cheers!

Commits
-------

88f1f05 [TwigComponent] Fix breaking (deprecation instead) when using .add() + StimulusBundle

Author: weaverryan

src/TwigComponent/src/ComponentAttributes.php

@@ -11,6 +11,7 @@
 
 namespace Symfony\UX\TwigComponent;
 
+use Symfony\UX\StimulusBundle\Dto\StimulusAttributes;
 use Symfony\WebpackEncoreBundle\Dto\AbstractStimulusDto;
 
 /**
@@ -115,9 +116,17 @@ public function without(string ...$keys): self
         return $clone;
     }
 
-    public function add(AbstractStimulusDto $stimulusDto): self
+    public function add($stimulusDto): self
     {
-        trigger_deprecation('symfony/ux-twig-component', '2.9.0', 'Passing a StimulusDto to ComponentAttributes::add() is deprecated. Run "composer require symfony/stimulus-bundle" then use "attributes.defaults(stimulus_controller(\'...\'))".');
+        if ($stimulusDto instanceof AbstractStimulusDto) {
+            trigger_deprecation('symfony/ux-twig-component', '2.9.0', 'Passing a StimulusDto to ComponentAttributes::add() is deprecated. Run "composer require symfony/stimulus-bundle" then use "attributes.defaults(stimulus_controller(\'...\'))".');
+        } elseif ($stimulusDto instanceof StimulusAttributes) {
+            trigger_deprecation('symfony/ux-twig-component', '2.9.0', 'Calling ComponentAttributes::add() is deprecated. Instead use "attributes.defaults(stimulus_controller(\'...\'))".');
+
+            return $this->defaults($stimulusDto);
+        } else {
+            throw new \InvalidArgumentException(sprintf('Argument 1 passed to "%s()" must be an instance of "%s" or "%s", "%s" given.', __METHOD__, AbstractStimulusDto::class, StimulusAttributes::class, get_debug_type($stimulusDto)));
+        }
 
         $controllersAttributes = $stimulusDto->toArray();
         $attributes = $this->attributes;