fix(attribute): Better naming prefix CanBe for boolean attributes. (#85)

Author: terabytesoftw

CHANGELOG.md

@@ -55,6 +55,7 @@
 - Bug #82: Update `ui-awesome/html-helper` requirement to use stable version constraint `^0.7` in `composer.json` (@terabytesoftw)
 - Enh #83: Enhance `HasAria`, `HasData`, and `HasEvents` traits to support prefix attributes `aria-`, `data-`, and `on` (@terabytesoftw)
 - Bug #84: Refactor attribute documentation in traits (@terabytesoftw)
+- Bug #85: Bug `#85`: Rename boolean attribute traits from `Has*` prefix to improve naming clarity (@terabytesoftw)
 
 ## 0.5.2 January 29, 2026
 

src/HasDisabled.php src/CanBeDisabled.phpsrc/HasDisabled.php renamed to src/CanBeDisabled.php

@@ -15,15 +15,14 @@
  * @copyright Copyright (C) 2026 Terabytesoftw.
  * @license https://opensource.org/license/bsd-3-clause BSD 3-Clause License.
  */
-trait HasDisabled
+trait CanBeDisabled
 {
     /**
      * Sets the `disabled` attribute.
      *
      * Usage example:
      * ```php
      * $element->disabled(true);
-     * $element->disabled(false);
      * $element->disabled(null);
      * ```
      *

src/Form/HasChecked.php src/Form/CanBeChecked.phpsrc/Form/HasChecked.php renamed to src/Form/CanBeChecked.php

@@ -15,15 +15,14 @@
  * @copyright Copyright (C) 2026 Terabytesoftw.
  * @license https://opensource.org/license/bsd-3-clause BSD 3-Clause License.
  */
-trait HasChecked
+trait CanBeChecked
 {
     /**
      * Sets the `checked` attribute.
      *
      * Usage example:
      * ```php
      * $element->checked(true);
-     * $element->checked(false);
      * $element->checked(null);
      * ```
      *

src/Form/HasMultiple.php src/Form/CanBeMultiple.phpsrc/Form/HasMultiple.php renamed to src/Form/CanBeMultiple.php

@@ -15,15 +15,14 @@
  * @copyright Copyright (C) 2026 Terabytesoftw.
  * @license https://opensource.org/license/bsd-3-clause BSD 3-Clause License.
  */
-trait HasMultiple
+trait CanBeMultiple
 {
     /**
      * Sets the `multiple` attribute.
      *
      * Usage example:
      * ```php
      * $element->multiple(true);
-     * $element->multiple(false);
      * $element->multiple(null);
      * ```
      *

src/Form/HasReadonly.php src/Form/CanBeReadonly.phpsrc/Form/HasReadonly.php renamed to src/Form/CanBeReadonly.php

@@ -15,15 +15,14 @@
  * @copyright Copyright (C) 2026 Terabytesoftw.
  * @license https://opensource.org/license/bsd-3-clause BSD 3-Clause License.
  */
-trait HasReadonly
+trait CanBeReadonly
 {
     /**
      * Sets the `readonly` attribute.
      *
      * Usage example:
      * ```php
      * $element->readonly(true);
-     * $element->readonly(false);
      * $element->readonly(null);
      * ```
      *

src/Form/HasRequired.php src/Form/CanBeRequired.phpsrc/Form/HasRequired.php renamed to src/Form/CanBeRequired.php

@@ -15,15 +15,14 @@
  * @copyright Copyright (C) 2026 Terabytesoftw.
  * @license https://opensource.org/license/bsd-3-clause BSD 3-Clause License.
  */
-trait HasRequired
+trait CanBeRequired
 {
     /**
      * Sets the `required` attribute.
      *
      * Usage example:
      * ```php
      * $element->required(true);
-     * $element->required(false);
      * $element->required(null);
      * ```
      *

src/Global/CanBeAutofocus.php

@@ -25,11 +25,12 @@ trait CanBeAutofocus
      * $element->autofocus(true);
      * ```
      *
-     * @param bool $value Whether to enable autofocus. Use `true` to enable and `false` to disable.
+     * @param bool|null $value Whether to enable autofocus. Use `true` to enable, `false` to disable, or `null` to
+     * remove the attribute.
      *
      * @return static New instance with the updated `autofocus` attribute.
      */
-    public function autofocus(bool $value): static
+    public function autofocus(bool|null $value): static
     {
         return $this->setAttribute(GlobalAttribute::AUTOFOCUS, $value);
     }

src/Global/CanBeHidden.php

@@ -26,11 +26,12 @@ trait CanBeHidden
      * $element->hidden(false);
      * ```
      *
-     * @param bool $value Whether to hide the element. Use `true` to hide and `false` to show.
+     * @param bool|null $value Whether to hide the element. Use `true` to hide, `false` to show, or `null` to remove the
+     * attribute.
      *
      * @return static New instance with the updated `hidden` attribute.
      */
-    public function hidden(bool $value): static
+    public function hidden(bool|null $value): static
     {
         return $this->setAttribute(GlobalAttribute::HIDDEN, $value);
     }

tests/HasDisabledTest.php tests/CanBeDisabledTest.phptests/HasDisabledTest.php renamed to tests/CanBeDisabledTest.php

@@ -6,14 +6,14 @@
 
 use PHPUnit\Framework\Attributes\{DataProviderExternal, Group};
 use PHPUnit\Framework\TestCase;
-use UIAwesome\Html\Attribute\HasDisabled;
+use UIAwesome\Html\Attribute\CanBeDisabled;
 use UIAwesome\Html\Attribute\Tests\Provider\DisabledProvider;
 use UIAwesome\Html\Attribute\Values\Attribute;
 use UIAwesome\Html\Helper\Attributes;
 use UIAwesome\Html\Mixin\HasAttributes;
 
 /**
- * Unit tests for the {@see HasDisabled} trait managing the `disabled` HTML attribute.
+ * Unit tests for the {@see CanBeDisabled} trait managing the `disabled` HTML attribute.
  *
  * Test coverage.
  * - Ensures fluent setters return new instances (immutability).
@@ -26,13 +26,13 @@
  * @license https://opensource.org/license/bsd-3-clause BSD 3-Clause License.
  */
 #[Group('attribute')]
-final class HasDisabledTest extends TestCase
+final class CanBeDisabledTest extends TestCase
 {
     public function testReturnEmptyWhenDisabledAttributeNotSet(): void
     {
         $instance = new class {
+            use CanBeDisabled;
             use HasAttributes;
-            use HasDisabled;
         };
 
         self::assertEmpty(
@@ -44,8 +44,8 @@ public function testReturnEmptyWhenDisabledAttributeNotSet(): void
     public function testReturnNewInstanceWhenSettingDisabledAttribute(): void
     {
         $instance = new class {
+            use CanBeDisabled;
             use HasAttributes;
-            use HasDisabled;
         };
 
         self::assertNotSame(
@@ -62,13 +62,13 @@ public function testReturnNewInstanceWhenSettingDisabledAttribute(): void
     public function testSetDisabledAttributeValue(
         bool|null $disabled,
         array $attributes,
-        bool|string|null $expectedValue,
+        bool|null $expectedValue,
         string $expectedRenderAttributes,
         string $message,
     ): void {
         $instance = new class {
+            use CanBeDisabled;
             use HasAttributes;
-            use HasDisabled;
         };
 
         $instance = $instance->attributes($attributes)->disabled($disabled);

tests/Form/HasCheckedTest.php tests/Form/CanBeCheckedTest.phptests/Form/HasCheckedTest.php renamed to tests/Form/CanBeCheckedTest.php

@@ -6,14 +6,14 @@
 
 use PHPUnit\Framework\Attributes\{DataProviderExternal, Group};
 use PHPUnit\Framework\TestCase;
-use UIAwesome\Html\Attribute\Form\HasChecked;
+use UIAwesome\Html\Attribute\Form\CanBeChecked;
 use UIAwesome\Html\Attribute\Tests\Provider\Form\CheckedProvider;
 use UIAwesome\Html\Attribute\Values\Attribute;
 use UIAwesome\Html\Helper\Attributes;
 use UIAwesome\Html\Mixin\HasAttributes;
 
 /**
- * Unit tests for the {@see HasChecked} trait managing the `checked` HTML attribute.
+ * Unit tests for the {@see CanBeChecked} trait managing the `checked` HTML attribute.
  *
  * Test coverage.
  * - Ensures fluent setters return new instances (immutability).
@@ -26,13 +26,13 @@
  * @license https://opensource.org/license/bsd-3-clause BSD 3-Clause License.
  */
 #[Group('attribute')]
-final class HasCheckedTest extends TestCase
+final class CanBeCheckedTest extends TestCase
 {
     public function testReturnEmptyWhenCheckedAttributeNotSet(): void
     {
         $instance = new class {
+            use CanBeChecked;
             use HasAttributes;
-            use HasChecked;
         };
 
         self::assertEmpty(
@@ -44,8 +44,8 @@ public function testReturnEmptyWhenCheckedAttributeNotSet(): void
     public function testReturnNewInstanceWhenSettingCheckedAttribute(): void
     {
         $instance = new class {
+            use CanBeChecked;
             use HasAttributes;
-            use HasChecked;
         };
 
         self::assertNotSame(
@@ -62,13 +62,13 @@ public function testReturnNewInstanceWhenSettingCheckedAttribute(): void
     public function testSetCheckedAttributeValue(
         bool|null $checked,
         array $attributes,
-        bool|string|null $expectedValue,
+        bool|null $expectedValue,
         string $expectedRenderAttributes,
         string $message,
     ): void {
         $instance = new class {
+            use CanBeChecked;
             use HasAttributes;
-            use HasChecked;
         };
 
         $instance = $instance->attributes($attributes)->checked($checked);