[docs] core/composer

1. Completed PHPDoc for the `toArrayOrValue()` core method.
2. Updated `composer.json` to include relevant keywords for better package discovery.

Author: Administrator

CHANGELOG.md

@@ -4,7 +4,16 @@ Here’s your English version of that changelog entry, keeping the same structur
 
 ---
 
-## [v3.1.0] - 2025-10-27
+## [v3.1.0-rc.2] - 2025-10-29
+
+### Added
+- Completed PHPDoc for the `toArrayOrValue()` core method.
+
+### Changed
+- Updated `composer.json` to include relevant keywords for better package discovery.
+
+
+## [v3.1.0-rc] - 2025-10-27
 
 ###  ⚠️Note
 > Starting from this release, the CHANGELOG will be maintained in English only.<br>

composer.json

@@ -24,10 +24,18 @@
     }
   ],
   "keywords": [
+    "php",
     "dto",
-    "data-transfer-object",
+    "toArray",
+    "utility",
+    "immutable",
+    "reflection",
+    "type-safety",
     "value-object",
-    "immutable"
+    "serialization",
+    "normalization",
+    "array-conversion",
+    "data-transfer-object"
   ],
   "require-dev": {
     "phpunit/phpunit": "^10",

src/ImmutableBase.php

@@ -463,6 +463,20 @@ final public function toArray(): array
         });
         return $properties;
     }
+    /**
+     * Converts an object to an array if possible, otherwise returns the original value.
+     *
+     * This method checks whether the given value is an object implementing a `toArray()` method.
+     * If so, it invokes that method and returns the resulting array. For all other values, the
+     * original input is returned unchanged.
+     *
+     * This utility provides a lightweight normalization step for mixed-type data, ensuring that
+     * objects capable of array conversion are consistently represented as arrays.
+     *
+     * @param mixed $value The value to be normalized or returned as-is.
+     *
+     * @return mixed The array representation of the object, or the original value if no conversion applies.
+     */
     private function toArrayOrValue(mixed $value)
     {
         if (is_object($value)) {