Add Hidden attribute to support non-serializable properties

Introduce a new `Hidden` attribute to mark properties that should be excluded from serialization. Updated `BaseData` and `PropertyContext` to handle this behavior, added a corresponding unit test, and documented the feature in `PropertyAttributes.md`.

Author: Fa-BRAIK

docs/PropertyAttributes.md

@@ -3,6 +3,7 @@ Property Attributes
 
 In order to provide more functionality to your DTOs, you can use the following attributes:
 - [Computed](#Computed) - To define a property that is computed from other properties.
+- [Hidden](#Hidden) - To define a property that should not be serialized.
 - [Aliases](#Aliases) - To define aliases for a property.
 - [DefaultsTo](#DefaultsTo) - To define a default value for a property using a fallback resolver.
 - [CipherTarget](#CipherTarget) - To define a property that should be encrypted/decrypted.
@@ -33,6 +34,29 @@ final readonly class PersonData extends Data
 
 This will make the DTO aware of the `fullName` property, and it will not be serialized or deserialized.
 
+Hidden
+-
+
+Sometimes, we may need to specify that a property should not be serialized.
+
+This can be done using the `Hidden` attribute.
+
+```php
+use Nuxtifyts\PhpDto\Attributes\Property\Hidden;
+use Nuxtifyts\PhpDto\Data;
+
+final readonly class PersonData extends Data
+{
+    public function __construct(
+        public string $firstName,
+        #[Hidden]
+        public string $lastName
+    ) {}
+} 
+```
+
+When serializing the DTO, the `lastName` property will not be included in the output.
+
 Aliases
 -
 

src/Attributes/Property/Hidden.php

@@ -0,0 +1,10 @@
+<?php
+
+namespace Nuxtifyts\PhpDto\Attributes\Property;
+
+use Attribute;
+
+#[Attribute(Attribute::TARGET_PROPERTY)]
+class Hidden
+{
+}

src/Concerns/BaseData.php

@@ -130,7 +130,7 @@ final public function jsonSerialize(): array
 
             $serializedData = [];
             foreach ($context->properties as $propertyContext) {
-                if ($propertyContext->isComputed) {
+                if ($propertyContext->isComputed || $propertyContext->isHidden) {
                     continue;
                 }
 

src/Contexts/PropertyContext.php

@@ -9,6 +9,7 @@
 use Nuxtifyts\PhpDto\Attributes\Property\CipherTarget;
 use Nuxtifyts\PhpDto\Attributes\Property\Computed;
 use Nuxtifyts\PhpDto\Attributes\Property\DefaultsTo;
+use Nuxtifyts\PhpDto\Attributes\Property\Hidden;
 use Nuxtifyts\PhpDto\Attributes\Property\WithRefiner;
 use Nuxtifyts\PhpDto\Contexts\Concerns\HasTypes;
 use Nuxtifyts\PhpDto\Data;
@@ -51,6 +52,8 @@ class PropertyContext
 
     private(set) bool $isComputed = false;
 
+    private(set) bool $isHidden = false;
+
     private(set) ?CipherConfig $cipherConfig = null;
 
     private(set) ?FallbackConfig $fallbackConfig = null;
@@ -104,6 +107,7 @@ private static function getKey(ReflectionProperty $property): string
     private function syncPropertyAttributes(): void
     {
         $this->isComputed = !empty($this->reflection->getAttributes(Computed::class));
+        $this->isHidden = !empty($this->reflection->getAttributes(Hidden::class));
 
         foreach ($this->reflection->getAttributes(WithRefiner::class) as $withRefinerAttribute) {
             /** @var ReflectionAttribute<WithRefiner> $withRefinerAttribute */

tests/Unit/Attributes/HiddenTest.php

@@ -0,0 +1,31 @@
+<?php
+
+namespace Nuxtifyts\PhpDto\Tests\Unit\Attributes;
+
+use Nuxtifyts\PhpDto\Attributes\Property\Hidden;
+use Nuxtifyts\PhpDto\Data;
+use Nuxtifyts\PhpDto\Tests\Unit\UnitCase;
+use PHPUnit\Framework\Attributes\CoversClass;
+use PHPUnit\Framework\Attributes\Test;
+use Throwable;
+
+#[CoversClass(Hidden::class)]
+final class HiddenTest extends UnitCase
+{
+    /**
+     * @throws Throwable
+     */
+    #[Test]
+    public function test_it_can_hide_a_property(): void
+    {
+        $object = new readonly class ('Something that should be hidden') extends Data {
+              public function __construct(
+                  #[Hidden]
+                  public string $hidden
+              ) {
+              }
+        };
+
+        self::assertEquals([], $object->toArray());
+    }
+}