feat: Add support for default values on metadata properties

src/Meta/MetaProperty.php

@@ -12,6 +12,11 @@ final public function __construct(
         $this->value = $this->transform($value);
     }
 
+    public static function defaultValue(): mixed
+    {
+        return null;
+    }
+
     public static function make(mixed $value): static
     {
         return new static($value);

src/Meta/Reflection.php

@@ -73,6 +73,6 @@ public static function metaValue(string $metaProperty, mixed $enum): mixed
             return $properties[0]->value;
         }
 
-        return null;
+        return $metaProperty::defaultValue() ?? null;
     }
 }

tests/Pest.php

@@ -29,6 +29,17 @@ protected function transform(mixed $value): mixed
     }
 }
 
+#[Attribute]
+class IsActive extends MetaProperty
+{
+    public static string $method = 'isActive';
+
+    public static function defaultValue(): mixed
+    {
+        return false;
+    }
+}
+
 /**
  * @method string description()
  * @method string color()
@@ -62,6 +73,25 @@ enum Role
     case GUEST;
 }
 
+#[Meta([IsActive::class])]
+enum ReferenceType: int
+{
+    use InvokableCases, Options, Names, Values, From, Metadata, Comparable;
+
+    #[IsActive(true)]
+    case ACTIVE_TYPE = 1;
+
+    case INACTIVE_TYPE = 0;
+}
+
+#[Meta([Desc::class])]
+enum RoleWithoutAttribute
+{
+    use InvokableCases, Options, Names, Values, From, Metadata, Comparable;
+
+    case ADMIN;
+}
+
 enum MultiWordSnakeCaseEnum
 {
     use Options;

tests/Pest/MetadataTest.php

@@ -60,4 +60,12 @@
 
 test('tryFromMeta silently fails when the enum cannot be instantiated')
     ->expect(Role::tryFromMeta(Color::make('foobar')))
-    ->toBe(null);
+    ->toBeNull();
+
+test('metadata properties return null if missing on the case')
+    ->expect(RoleWithoutAttribute::ADMIN->desc())
+    ->toBeNull();
+
+test('metadata can have default values')
+    ->expect(ReferenceType::INACTIVE_TYPE->isActive())
+    ->toBeFalse();