Add override parameter to activeClass method. (#179)

src/Attribute/Component/HasActiveClass.php

@@ -10,18 +10,21 @@
 trait HasActiveClass
 {
     protected string $activeClass = 'active';
+    protected bool $override = false;
 
     /**
      * Set the `CSS` class to be appended to the active class.
      *
      * @param string $value The `CSS` class to be appended to the active class.
+     * @param bool $override Whether to override the current active class or not.
      *
      * @return static A new instance of the current class with the specified active class.
      */
-    public function activeClass(string $value): static
+    public function activeClass(string $value, bool $override = false): static
     {
         $new = clone $this;
         $new->activeClass = $value;
+        $new->override = $override;
 
         return $new;
     }

tests/Attribute/Component/HasActiveClassTest.php

@@ -15,6 +15,33 @@ public function testImmutability(): void
             use HasActiveClass;
         };
 
-        $this->assertNotSame($instance, $instance->activeClass(''));
+        $this->assertNotSame($instance, $instance->activeClass('', true));
+    }
+
+    public function testOverride(): void
+    {
+        $instance = new class () {
+            use HasActiveClass;
+
+            public function getActiveClass(): string
+            {
+                return $this->activeClass;
+            }
+
+            public function getOverride(): bool
+            {
+                return $this->override;
+            }
+        };
+
+        $instance = $instance->activeClass('active');
+
+        $this->assertSame('active', $instance->getActiveClass());
+        $this->assertFalse($instance->getOverride());
+
+        $instance = $instance->activeClass('active', true);
+
+        $this->assertSame('active', $instance->getActiveClass());
+        $this->assertTrue($instance->getOverride());
     }
 }