[fix] ib-writer

1. Add Enum documentation blocks for all Enum types referenced by, ImmutableBase properties, displaying case names and backing values
2. Add default value column to property tables: #[Defaults] shows literal values, defaultValues() shows "(dynamic)", BackedEnum shows backing value, UnitEnum shows case name, ImmutableBase sub-objects show class name
3. Collect referenced Enums during type resolution and append Enum blocks after class blocks

Author: ReallifeKip

CHANGELOG.md

@@ -1,5 +1,17 @@
 # CHANGELOG
 
+## [4.1.1] - 2025-03-07
+
+### Fixed
+#### ib-writer
+- Property tables now include a `default` column displaying default
+  values from `#[Defaults]` attributes and `defaultValues()` overrides
+- Enum types referenced as property types now generate their own
+  documentation blocks with case listings and backing values
+- BackedEnum defaults display the backing value; UnitEnum defaults
+  display the case name; dynamic defaults from `defaultValues()`
+  display as `(dynamic)`
+
 ## [v4.1.0] - 2026-03-07
 
 ### Added

src/CLI/writer/Markdown.php

@@ -4,6 +4,7 @@
 
 use ReallifeKip\ImmutableBase\Attributes\Spec;
 use ReallifeKip\ImmutableBase\CLI\Writer;
+use ReallifeKip\ImmutableBase\ImmutableBase;
 use ReallifeKip\ImmutableBase\Types;
 use ReflectionProperty;
 
@@ -25,6 +26,7 @@
 abstract class Markdown
 {
     public static array $header = [];
+    public static array $enums  = [];
     /**
      * Iterates all namespace groups and delegates each class to
      * Writer::buildClassBlock() for Markdown table generation.
@@ -42,6 +44,7 @@ public static function namespaceBlocksGenerate(array $namespaceGroups, array $cl
                 $content = array_merge($content ?? [], Writer::buildClassBlock($entry, $classMap, $shortNameCount));
             }
         }
+        $content = array_merge($content ?? [], self::enumBlocksGenerate());
 
         return $content;
     }
@@ -71,8 +74,8 @@ public static function contentBlocksGenerate(array $classMap, array $entry)
             $content[] = $spec;
         }
         $content[] = '';
-        $content[] = '|name|required|type|description|';
-        $content[] = '|--|--|--|--|';
+        $content[] = '|name|required|type|default|description|';
+        $content[] = '|--|--|--|--|--|';
         foreach ($types as $type) {
             /** @var ReflectionProperty $propRef */
             $propRef  = $type['propertyRef'] ?? $ref->getProperty($type['propertyName']);
@@ -90,8 +93,26 @@ public static function contentBlocksGenerate(array $classMap, array $entry)
                     $shortname = end($shortname);
                     $typename  = "[$shortname](#$typename)";
                 }
+                if (enum_exists($type['typename']['string'])) {
+                    self::$enums[$type['typename']['string']] = true;
+                }
+            }
+            $desc    = $propDocs['desc'] ?: '-';
+            $default = '-';
+            if (isset($type['defaults'])) {
+                $default = $type['defaults'];
+                $default = match (true) {
+                    $default instanceof \BackedEnum   => (string) $default->value,
+                    $default instanceof \UnitEnum     => $default->name,
+                    $default instanceof ImmutableBase => $default::class,
+                    is_callable($default)             => '(dynamic)',
+                    \is_array($default)               => json_encode($default),
+                    $default === null                 => 'null',
+                    $default === false                => 'false',
+                    default                           => (string) $default
+                };
             }
-            $content[] = "| {$type['propertyName']} | $required | $typename | " . ($propDocs['desc'] ?: '-') . ' |';
+            $content[] = "| {$type['propertyName']} | $required | $typename | $default | $desc |";
         }
         $content[] = '';
         $content[] = '---';
@@ -136,9 +157,57 @@ final protected static function unionTypeNamesParser(array $type): string
             $shortname = explode('\\', $typename);
             $shortname = end($shortname);
 
+            if (enum_exists($typename)) {
+                self::$enums[$typename] = true;
+            }
+
             return "[$shortname](#$typename)";
         }
 
         return $typename;
     }
+    /**
+     * Generates Markdown documentation blocks for all Enum classes
+     * referenced by ImmutableBase property types. Only Enums actually
+     * used as property types are included. BackedEnum cases display
+     * both name and backing value; UnitEnum cases display name only.
+     *
+     * @return list<string>
+     */
+    public static function enumBlocksGenerate(): array
+    {
+        $content = [];
+
+        foreach (self::$enums as $enumClass => $_) {
+            $ref       = new \ReflectionEnum($enumClass);
+            $shortName = $ref->getShortName();
+            $isBacked  = $ref->isBacked();
+
+            $content[] = "# {$shortName} {#{$enumClass}}";
+            $content[] = '';
+
+            if ($isBacked) {
+                $backingType = $ref->getBackingType()->getName();
+                $content[]   = "| case | value ({$backingType}) |";
+                $content[]   = '|--|--|';
+                foreach ($ref->getCases() as $case) {
+                    /** @var \ReflectionEnumBackedCase $case */
+                    $value     = $case->getBackingValue();
+                    $content[] = "| {$case->getName()} | {$value} |";
+                }
+            } else {
+                $content[] = '| case |';
+                $content[] = '|--|';
+                foreach ($ref->getCases() as $case) {
+                    $content[] = "| {$case->getName()} |";
+                }
+            }
+
+            $content[] = '';
+            $content[] = '---';
+            $content[] = '';
+        }
+
+        return $content;
+    }
 }