Merge remote-tracking branch 'origin/dev' into dev

# Conflicts:
#	src/Composite/Dictionary.php

Author: nejcdev

src/Composite/Struct/Struct.php

@@ -9,6 +9,7 @@
 final class Struct
 {
     /**
+
      * @var string
      */
     public string $name;
@@ -35,6 +36,7 @@ public function __construct(array $fields)
     }
 
     /**
+
      * Add a new field to the struct.
      *
      * Adds a field to the struct with its specified type and initializes it with a null value.
@@ -111,11 +113,13 @@ public function get(string $name): mixed
     }
 
     /**
+
      * Get all fields in the struct.
      *
      * Returns the entire set of fields in the struct along with their types and values.
      *
      * @return array<string, array{type: string, value: mixed}> The fields with their respective types and values.
+
      */
     public function getFields(): array
     {

src/Composite/Union/Union.php

@@ -6,28 +6,46 @@
 
 final class Union
 {
+    /**
+     * @var mixed
+     */
     private mixed $value;
+
+    /**
+     * @var array
+     */
     private array $allowedTypes;
 
+    /**
+     * @param array $allowedTypes
+     */
     public function __construct(array $allowedTypes)
     {
         $this->allowedTypes = $allowedTypes;
     }
 
-    // Set a value of one of the allowed types
+    /**
+     * @param mixed $value
+     * @return void
+     */
     public function setValue(mixed $value): void
     {
         $this->validateType($value);
         $this->value = $value;
     }
 
-    // Get the value
+    /**
+     * @return mixed
+     */
     public function getValue(): mixed
     {
         return $this->value;
     }
 
-    // Validate that the value matches one of the allowed types
+    /**
+     * @param mixed $value
+     * @return void
+     */
     private function validateType(mixed $value): void
     {
         $type = gettype($value);

src/helpers.php

@@ -21,62 +21,91 @@
 use Nejcc\PhpDatatypes\Scalar\Integers\Unsigned\UInt32;
 use Nejcc\PhpDatatypes\Scalar\Integers\Unsigned\UInt8;
 
+/**
+ * @param int $value
+ * @return Int8
+ */
 function int8(int $value): Int8
 {
     return new Int8($value);
 }
 
+/**
+ * @param int $value
+ * @return Int16
+ */
 function int16(int $value): Int16
 {
     return new Int16($value);
 }
 
+/**
+ * @param int $value
+ * @return Int32
+ */
 function int32(int $value): Int32
 {
     return new Int32($value);
 }
 
+/**
+ * @param int $value
+ * @return Int64
+ */
 function int64(int $value): Int64
 {
     return new Int64($value);
 }
 
+/**
+ * @param int $value
+ * @return Int128
+ */
 function int128(int $value): Int128
 {
     return new Int128($value);
 }
 
+/**
+ * @param int $value
+ * @return UInt8
+ */
 function uint8(int $value): UInt8
 {
     return new UInt8($value);
 }
 
+/**
+ * @param int $value
+ * @return UInt16
+ */
 function uint16(int $value): UInt16
 {
     return new UInt16($value);
 }
 
+/**
+ * @param int $value
+ * @return UInt32
+ */
 function uint32(int $value): UInt32
 {
     return new UInt32($value);
 }
 
-//
-//function uint64(int $value): Int64
-//{
-//    return new UInt64($value);
-//}
-//
-//function uint128(int $value): Int128
-//{
-//    return new UInt128($value);
-//}
-
+/**
+ * @param float $value
+ * @return Float32
+ */
 function float32(float $value): Float32
 {
     return new Float32($value);
 }
 
+/**
+ * @param float $value
+ * @return Float64
+ */
 function float64(float $value): Float64
 {
     return new Float64($value);