allow state to be passed to attribute builder

src/AttributeBuilder.php

@@ -36,7 +36,6 @@ class AttributeBuilder
 
     public function __construct(
         protected ComponentAttributeBag &$attributeBag,
-        protected Collection $options,
         array $elements = []
     ) {
         // loop through each of the elements that have been specified
@@ -300,7 +299,7 @@ protected function conditionalPasses(string|callable $condition, bool $negateCon
             $conditionResult = !$conditionResult;
         }
 
-        return $conditionResult;
+        return !!$conditionResult;
     }
 
     /**

src/Components/Concerns/HasAttributeBuilder.php

@@ -26,6 +26,8 @@ trait HasAttributeBuilder
      */
     protected AttributeBuilder $attributeBuilder;
 
+    protected $attributeBuilderStates = [];
+
     /**
      * Add a new attribute builder parser at a given weight
      *
@@ -92,6 +94,14 @@ public static function resetAllCustomizations()
         static::resetAllAttributeBuilderParsers();
     }
 
+    public function exposePropertyAsState($property, $state = null) {
+        if (!$state) {
+            $state = $property;
+        }
+
+        $this->attributeBuilderStates[$state] = fn () => $this->{$property};
+    }
+
     /**
      * Register a new element for the attribute builder
      *
@@ -116,7 +126,11 @@ protected function registerAttributeBuilderElement(string $element): ElementAttr
     protected function runAttributeBuilder(array $data): array
     {
         // get the instance of the attribute builder
-        $this->attributeBuilder = new AttributeBuilder($data['attributes'], collect(), $this->attributeBuilderElements);
+        $this->attributeBuilder = new AttributeBuilder($data['attributes'], $this->attributeBuilderElements);
+
+        foreach ($this->attributeBuilderStates as $state => $closure) {
+            $this->attributeBuilder->registerConditional($state, $closure);
+        }
 
         // sort the parsers by their weight
         ksort(static::$attributeBuilderParsers);

tests/ComponentCustomisationTest.php

@@ -85,3 +85,27 @@
     // check that the attributes are created, and in the correct place
     expect($instance->getAttributeBuilder()->getAttributes())->toHaveKey('foo', 'bat');
 });
+
+it('can pass properties down to state', function () {
+    HigherOrderTestComponent::customise(function (AttributeBuilder $attributes) {
+        $attributes->setAttributeWhenToggle('foo', 'bar');
+    });
+
+    // render a component
+    $this->blade('<x-test-component />');
+
+    // get the instance of the component that was rendered
+    $instance = HigherOrderTestComponent::lastInstance();
+
+    // check that the attributes are created, and in the correct place
+    expect($instance->getAttributeBuilder()->getAttributes())->not()->toHaveKey('foo', 'bar');
+
+    // render another component
+    $this->blade('<x-test-component toggle="toggle" size="xs" />');
+
+    // get the instance of the component that was rendered
+    $instance = HigherOrderTestComponent::lastInstance();
+
+    // check that the attributes are created, and in the correct place
+    expect($instance->getAttributeBuilder()->getAttributes())->toHaveKey('foo', 'bar');
+});

tests/Components/HigherOrderTestComponent.php

@@ -10,7 +10,7 @@ class HigherOrderTestComponent extends TestComponent
      */
     private static $lastInstance = null;
 
-    public function __construct()
+    public function __construct($toggle = false, $size = '')
     {
         // store the last instance
         static::$lastInstance = $this;

tests/Components/TestComponent.php

@@ -12,10 +12,16 @@ class TestComponent extends Component
     use HasAttributeBuilder;
 
     /**
-     * Example property that can be set on the component
+     * Example boolean property that can be set on the component
      * @var bool
      */
-    public bool $property = true;
+    public bool $toggle = false;
+
+    /**
+     * Example string property that can be set on the component
+     * @var string
+     */
+    public string $size = '';
 
     /**
      * An example element attribute bag
@@ -28,9 +34,14 @@ class TestComponent extends Component
      *
      * @return void
      */
-    public function __construct()
+    public function __construct($toggle = false, $size = '')
     {
+        $this->toggle = $toggle;
+        $this->size = $size;
+
         $this->labelAttributes = $this->registerAttributeBuilderElement('label');
+
+        $this->exposePropertyAsState('toggle');
     }
 
     /**

tests/Pest.php

@@ -49,13 +49,13 @@
  * @param array $options
  * @return AttributeBuilder
  */
-function createAttributeBuilder($attributes = [], $options = [], $elements = [])
+function createAttributeBuilder($attributes = [], $elements = [])
 {
     // create an attribute bag that will be passed to the attribute builder
     $attributeBag = new ComponentAttributeBag($attributes);
 
     // return the attribute builder
-    return new AttributeBuilder($attributeBag, collect($options), $elements);
+    return new AttributeBuilder($attributeBag, $elements);
 }
 
 function addDataAttributeHelperToAttributeBuilder()