[TASK] Wire parallel parsing and rendering handlers

Enable full pipeline parallelization by tagging the parallel handlers:

- ParallelParseDirectoryHandler: replaces ParseDirectoryHandler
  for parallel file parsing using pcntl_fork

- ForkingRenderer: replaces HTML TypeRenderer for parallel
  document rendering using pcntl_fork with copy-on-write memory

Both handlers use MIN_DOCS_FOR_PARALLEL=10 threshold and
auto-detect CPU count (capped at 8 workers).

Also fixes FileAttributes array access in ParallelParseDirectoryHandler
(use $item['basename'] instead of $item->path()).

Author: CybotTM

packages/typo3-guides-extension/resources/config/typo3-guides.php

@@ -30,6 +30,7 @@
 use phpDocumentor\Guides\Compiler\NodeTransformers\NodeTransformerFactory;
 use phpDocumentor\Guides\FileCollector;
 use phpDocumentor\Guides\Handlers\CompileDocumentsCommand;
+use phpDocumentor\Guides\Handlers\ParseDirectoryCommand;
 
 use function Symfony\Component\DependencyInjection\Loader\Configurator\inline_service;
 use function Symfony\Component\DependencyInjection\Loader\Configurator\param;
@@ -117,6 +118,7 @@
             ->arg('$commandBus', service('League\Tactician\CommandBus'))
             ->arg('$eventDispatcher', service('Psr\EventDispatcher\EventDispatcherInterface'))
             ->arg('$logger', service('Psr\Log\LoggerInterface')->nullOnInvalid())
+            ->tag('phpdoc.guides.command', ['command' => ParseDirectoryCommand::class])
 
         // Parallel Rendering - Document navigation for forked processes
         // Singleton that stores pre-computed prev/next relationships for use in child processes
@@ -131,10 +133,18 @@
             ->arg('$logger', service('Psr\Log\LoggerInterface')->nullOnInvalid())
 
         // Parallel Rendering - pcntl_fork based renderer for cold builds
+        // Replaces the default HTML TypeRenderer for parallel rendering
         ->set(ForkingRenderer::class)
             ->arg('$commandBus', service('League\Tactician\CommandBus'))
             ->arg('$navigationProvider', service(DocumentNavigationProvider::class))
             ->arg('$logger', service('Psr\Log\LoggerInterface')->nullOnInvalid())
+            ->tag(
+                'phpdoc.renderer.typerenderer',
+                [
+                    'noderender_tag' => 'phpdoc.guides.noderenderer.html',
+                    'format' => 'html',
+                ],
+            )
 
         // Parallel Compilation Infrastructure
         // The ParallelCompiler uses pcntl_fork for parallel compilation. Currently

packages/typo3-guides-extension/src/Parser/ParallelParseDirectoryHandler.php

@@ -310,9 +310,11 @@ private function getDirectoryIndexFile(ParseDirectoryCommand $command): string
 
         $contentFromFilesystem = $filesystem->listContents($directory);
         $hashedContentFromFilesystem = [];
-        /** @var \League\Flysystem\StorageAttributes $itemFromFilesystem */
+        /** @var \ArrayAccess<string, mixed> $itemFromFilesystem */
         foreach ($contentFromFilesystem as $itemFromFilesystem) {
-            $basename = basename($itemFromFilesystem->path());
+            // Use array access as phpDocumentor's FileAttributes wrapper supports it
+            /** @var string $basename */
+            $basename = $itemFromFilesystem['basename'];
             $hashedContentFromFilesystem[$basename] = true;
         }