Add documentation publishing script and fix null value handling (#30)

* Fix null value handling in `DataModelHelper.php`

* Add documentation publishing script and related composer configuration

Author: zero-to-prod

README.md

@@ -17,6 +17,8 @@
 - [Introduction](#introduction)
 - [Requirements](#requirements)
 - [Installation](#installation)
+- [Documentation Publishing](#documentation-publishing)
+  - [Automatic Documentation Publishing](#automatic-documentation-publishing)
 - [Usage](#usage)
     - [Including the Trait](#including-the-trait)
 - [Helper Methods](#helper-methods)
@@ -49,6 +51,39 @@ composer require zero-to-prod/data-model-helper
 
 This will add the package to your project’s dependencies and create an autoloader entry for it.
 
+## Documentation Publishing
+
+You can publish this README to your local documentation directory.
+
+This can be useful for providing documentation for AI agents.
+
+This can be done using the included script:
+
+```bash
+# Publish to default location (./docs/zero-to-prod/data-model-helper)
+vendor/bin/zero-to-prod-data-model-helper
+
+# Publish to custom directory
+vendor/bin/zero-to-prod-data-model-helper /path/to/your/docs
+```
+
+#### Automatic Documentation Publishing
+
+You can automatically publish documentation by adding the following to your `composer.json`:
+
+```json
+{
+  "scripts": {
+    "post-install-cmd": [
+      "zero-to-prod-data-model-helper"
+    ],
+    "post-update-cmd": [
+      "zero-to-prod-data-model-helper"
+    ]
+  }
+}
+```
+
 ## Usage
 
 ### Including the Trait

bin/zero-to-prod-data-model-factory

@@ -0,0 +1,32 @@
+#!/usr/bin/env php
+<?php
+
+/**
+ * Zero-to-Prod Factory Documentation Publisher
+ *
+ * Publishes the README.md file to the user's documentation directory.
+ */
+
+require getcwd().'/vendor/autoload.php';
+
+use Zerotoprod\PackageHelper\PackageHelper;
+
+$target_path = getcwd().'/docs/zero-to-prod/data-model-helper/';
+if (isset($argv[1])) {
+    $target_path = rtrim($argv[1], '/').'/';
+}
+
+$source_file = __DIR__.'/../README.md';
+
+if (!file_exists($source_file)) {
+    fwrite(STDERR, "Error: Not found $source_file\n");
+    exit(1);
+}
+
+try {
+    PackageHelper::copy($source_file, $target_path);
+    exit(0);
+} catch (RuntimeException $e) {
+    fwrite(STDERR, "Error: ".$e->getMessage()."\n");
+    exit(1);
+}

composer.json

@@ -1,57 +1,60 @@
 {
-  "type": "library",
-  "name": "zero-to-prod/data-model-helper",
-  "description": "Helpers for a DataModel.",
-  "keywords": [
-    "zero-to-prod",
-    "data-model-helper"
-  ],
-  "homepage": "https://github.com/zero-to-prod/data-model-helper",
-  "support": {
-    "email": "dave0016@gmail.com",
-    "issues": "https://github.com/zero-to-prod/data-model-helper/issues",
-    "source": "https://github.com/zero-to-prod/data-model-helper",
-    "docs": "https://zero-to-prod.github.io/data-model-helper",
-    "security": "https://github.com/zero-to-prod/data-model-helper/blob/main/SECURITY.md"
-  },
-  "license": "MIT",
-  "readme": "./README.md",
-  "authors": [
-    {
-      "name": "David Smith",
-      "email": "dave0016@gmail.com",
-      "homepage": "https://davidsmith.blog/",
-      "role": "maintainer"
+    "type": "library",
+    "name": "zero-to-prod/data-model-helper",
+    "description": "Helpers for a DataModel.",
+    "keywords": [
+        "zero-to-prod",
+        "data-model-helper"
+    ],
+    "homepage": "https://github.com/zero-to-prod/data-model-helper",
+    "support": {
+        "email": "dave0016@gmail.com",
+        "issues": "https://github.com/zero-to-prod/data-model-helper/issues",
+        "source": "https://github.com/zero-to-prod/data-model-helper",
+        "docs": "https://zero-to-prod.github.io/data-model-helper",
+        "security": "https://github.com/zero-to-prod/data-model-helper/blob/main/SECURITY.md"
+    },
+    "license": "MIT",
+    "readme": "./README.md",
+    "authors": [
+        {
+            "name": "David Smith",
+            "email": "dave0016@gmail.com",
+            "homepage": "https://davidsmith.blog/",
+            "role": "maintainer"
+        }
+    ],
+    "funding": [
+        {
+            "type": "GitHub",
+            "url": "https://github.com/sponsors/zero-to-prod"
+        }
+    ],
+    "require": {
+        "php": ">=8.1.0",
+        "zero-to-prod/data-model": "^v81.0.0",
+        "zero-to-prod/validate-url": "^71.0",
+        "zero-to-prod/validate-email": "^71.0",
+        "zero-to-prod/package-helper": "^1.1.3"
+    },
+    "autoload": {
+        "psr-4": {
+            "Zerotoprod\\DataModelHelper\\": "src/"
+        }
+    },
+    "autoload-dev": {
+        "psr-4": {
+            "Tests\\": "tests/"
+        }
+    },
+    "require-dev": {
+        "phpunit/phpunit": "<12.0"
+    },
+    "bin": [
+        "bin/zero-to-prod-data-model-factory"
+    ],
+    "suggest": {
+        "zero-to-prod/transformable": "Transform a class into different types.",
+        "zero-to-prod/data-model-factory": "Factories for a DataModel."
     }
-  ],
-  "funding": [
-    {
-      "type": "GitHub",
-      "url": "https://github.com/sponsors/zero-to-prod"
-    }
-  ],
-  "require": {
-    "php": ">=8.1.0",
-    "zero-to-prod/data-model": "^v81.0.0",
-    "zero-to-prod/validate-url": "^71.0",
-    "zero-to-prod/validate-email": "^71.0",
-    "zero-to-prod/package-helper": "^1.1.3"
-  },
-  "autoload": {
-    "psr-4": {
-      "Zerotoprod\\DataModelHelper\\": "src/"
-    }
-  },
-  "autoload-dev": {
-    "psr-4": {
-      "Tests\\": "tests/"
-    }
-  },
-  "require-dev": {
-    "phpunit/phpunit": "<12.0"
-  },
-  "suggest": {
-    "zero-to-prod/transformable": "Transform a class into different types.",
-    "zero-to-prod/data-model-factory": "Factories for a DataModel."
-  }
 }

src/DataModelHelper.php

@@ -96,7 +96,7 @@ public static function mapOf(mixed $value, array $context, ?ReflectionAttribute
                     );
         };
 
-        return $mapper($value, $args['level'] ?? 1);
+        return $mapper($value ?? [], $args['level'] ?? 1);
     }
 
     /**