Add example object generation to SchemaBuilder

Author: Jurager

src/Builders/SchemaBuilder.php

@@ -103,10 +103,13 @@ public function build(array $rules, array $docParams = []): array
             }
         }
 
+        $example = $this->buildExample($props);
+
         return array_filter([
             'type' => 'object',
             'properties' => $props,
             'required' => $required ?: null,
+            'example' => $example ?: null,
         ]);
     }
 
@@ -242,6 +245,29 @@ private function normalizeType(string $type): string
         };
     }
 
+    /**
+     * Build example object from schema properties.
+     */
+    private function buildExample(array $props): array
+    {
+        $example = [];
+
+        foreach ($props as $name => $prop) {
+            $type = $prop['type'] ?? 'string';
+
+            if ($type === 'array') {
+                $itemProps = $prop['items']['properties'] ?? null;
+                $example[$name] = $itemProps
+                    ? [$this->buildExample($itemProps)]
+                    : [$this->generateValue($name, 'string')];
+            } else {
+                $example[$name] = $this->generateValue($name, $type);
+            }
+        }
+
+        return $example;
+    }
+
     /**
      * Generate random integer between min and max.
      *