added phpdoc basic configuration

and added some class-level docs

Author: nix

.gitignore

@@ -2,3 +2,6 @@
 /tests-output/
 /phpunit.xml
 /phpstan.neon
+/phpdoc.xml
+/.phpdoc/
+/api-docs/

composer.json

@@ -15,6 +15,7 @@
         "php": ">=8.2"
     },
     "require-dev": {
+        "phpdocumentor/shim": "^3.8",
         "phpstan/phpstan": "^2.1",
         "phpunit/phpunit": "~11.5"
     },
@@ -29,7 +30,10 @@
         }
     },
     "config": {
-        "sort-packages": true
+        "sort-packages": true,
+        "allow-plugins": {
+            "phpdocumentor/shim": true
+        }
     },
     "extra": {
         "branch-alias": {
@@ -43,6 +47,7 @@
             "phpunit"
         ],
         "stan": "phpstan",
-        "stan-tests": "phpstan analyse -c phpstan-tests.neon"
+        "stan-tests": "phpstan analyse -c phpstan-tests.neon",
+        "api-docs": "phpdoc"
     }
 }

composer.lock

@@ -0,0 +1,21 @@
+<?xml version="1.0" encoding="UTF-8" ?>
+<phpdocumentor
+        configVersion="3"
+        xmlns="https://www.phpdoc.org" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+        xsi:noNamespaceSchemaLocation="https://raw.githubusercontent.com/phpDocumentor/phpDocumentor/master/data/xsd/phpdoc.xsd">
+    <paths>
+        <output>api-docs</output>
+    </paths>
+    <version number="latest">
+        <api>
+            <source dsn=".">
+                <path>src</path>
+            </source>
+            <default-package-name>nixn\php</default-package-name>
+            <visibility>public</visibility>
+            <ignore-tags>
+                <ignore-tag>phpstan-ignore</ignore-tag>
+            </ignore-tags>
+        </api>
+    </version>
+</phpdocumentor>

phpdoc.dist.xml

@@ -1,7 +1,11 @@
 <?php
 namespace nixn\php;
 
-/** @since 1.0 */
+/**
+ * Utilities for arrays or iterables.
+ *
+ * @since 1.0
+ */
 final class Arr
 {
 	/** @codeCoverageIgnore */

src/Arr.php

@@ -1,7 +1,11 @@
 <?php
 namespace nixn\php;
 
-/** @since 1.0 */
+/**
+ * Partial functions.
+ *
+ * @since 1.0
+ */
 enum Partial
 {
 	case PLACEHOLDER;
@@ -22,7 +26,7 @@ enum Partial
 	 */
 	public static function partial(callable $callable, mixed ...$args): callable
 	{
-		return function(mixed ... $placeholder_args) use ($callable, $args): mixed {
+		return static function(mixed ... $placeholder_args) use ($callable, $args): mixed {
 			$final_args = [];
 			foreach ($args as $key => $arg)
 			{

src/Partial.php

@@ -1,7 +1,11 @@
 <?php
 namespace nixn\php;
 
-/** @since 1.0 */
+/**
+ * Utilities for strings.
+ *
+ * @since 1.0
+ */
 final class Str
 {
 	/** @codeCoverageIgnore */

src/Str.php

@@ -1,7 +1,11 @@
 <?php
 namespace nixn\php;
 
-/** @since 1.0 */
+/**
+ * Miscellaneous utilities.
+ *
+ * @since 1.0
+ */
 final class Util
 {
 	/** @codeCoverageIgnore */