fix route yaml generation missing documentation first level key

Author: Ehyiah

src/Command/ComponentGeneration/Route/RouteTuiGenerator.php

@@ -1164,6 +1164,7 @@ private function generateRoute(Tui $tui, RouteTuiState $state): void
 
         $array = $builder->build();
         unset($array['components']);
+        $array = ['documentation' => $array];
 
         $destination = ComponentType::Routes->value;
 
@@ -1174,7 +1175,8 @@ private function generateRoute(Tui $tui, RouteTuiState $state): void
             // Merge with existing config to preserve manually-added fields (YAML only)
             if ('php' !== pathinfo($state->loadedFrom, PATHINFO_EXTENSION)) {
                 $existingConfig = \Symfony\Component\Yaml\Yaml::parseFile($state->loadedFrom);
-                if (isset($existingConfig['paths'])) {
+                $existingPaths = $existingConfig['documentation']['paths'] ?? $existingConfig['paths'] ?? null;
+                if (null !== $existingPaths) {
                     $array = array_replace_recursive($existingConfig, $array);
                 }
             }

src/Command/ComponentGeneration/Route/RouteTuiManager.php

@@ -204,7 +204,12 @@ public function loadRouteConfig(string $routeName, string $componentType): array
                 }
             } else {
                 $config = \Symfony\Component\Yaml\Yaml::parseFile($file->getRealPath());
-                if (isset($config['paths'])) {
+                $pathsConfig = $config['documentation']['paths'] ?? $config['paths'] ?? null;
+                if (null !== $pathsConfig) {
+                    if (isset($config['documentation']['paths'])) {
+                        $config = ['paths' => $config['documentation']['paths']];
+                    }
+
                     return ['methodsConfig' => $this->extractMethodsConfig($config, $path)];
                 }
             }
@@ -253,7 +258,7 @@ private function parseRoutePhpFile(string $filePath, string $path): ?array
                     $methodsConfig[$currentMethod]['tags'][] = $m[1];
                 } elseif (preg_match("/->security\\('([^']+)'\\)/", $line, $m)) {
                     $methodsConfig[$currentMethod]['security'][] = $m[1];
-                } elseif (preg_match('/->response\\((\\d+)\\)/', $line, $m)) {
+                } elseif (preg_match('/->response\((\d+)\)/', $line, $m)) {
                     $statusCode = (int)$m[1];
                     $methodsConfig[$currentMethod]['responses'][$statusCode] = [
                         'schema' => null,

src/Command/Traits/GenerateFileTrait.php

@@ -779,7 +779,7 @@ protected function buildRouteCode(array $array, string $routeName, int $indent):
         $pad = str_repeat('    ', $indent);
         $code = '';
 
-        $paths = $array['paths'] ?? [];
+        $paths = $array['documentation']['paths'] ?? $array['paths'] ?? [];
         foreach ($paths as $path => $methods) {
             if (!is_array($methods)) {
                 continue;

tests/ehyiah_api_doc_test.yaml

@@ -2,7 +2,3 @@ framework:
     router:
         utf8: true
         resource: '%kernel.project_dir%/config/routes.yaml'
-
-ehyiah_api_doc:
-    source_path: '/var/Swagger'
-    dump_path: '/var/Dump'