[BUGFIX] Fix tempnam() E_NOTICE when using PlantUML binary renderer

When using the local PlantUML binary renderer (renderer="plantuml"),
the upstream PlantumlRenderer calls tempnam() with a subdirectory
that may not exist, triggering a PHP E_NOTICE that appears in the
rendered documentation output.

This adds a DecoratingPlantumlBinaryRenderer that ensures the temp
directory exists before delegating to the inner renderer, fixing
the issue without requiring upstream changes or global E_NOTICE
suppression.

Resolves: TYPO3-Documentation#1099

Author: CybotTM

packages/typo3-docs-theme/resources/config/typo3-docs-theme.php

@@ -8,6 +8,7 @@
 use phpDocumentor\Guides\Event\PostProjectNodeCreated;
 use phpDocumentor\Guides\Event\PostRenderProcess;
 use phpDocumentor\Guides\Event\PreParseProcess;
+use phpDocumentor\Guides\Graphs\Renderer\PlantumlRenderer;
 use phpDocumentor\Guides\Graphs\Renderer\PlantumlServerRenderer;
 use phpDocumentor\Guides\ReferenceResolvers\DelegatingReferenceResolver;
 use phpDocumentor\Guides\ReferenceResolvers\Interlink\InventoryRepository;
@@ -56,6 +57,7 @@
 use T3Docs\Typo3DocsTheme\Parser\Productions\FieldList\TemplateFieldListItemRule;
 use T3Docs\Typo3DocsTheme\ReferenceResolvers\FileReferenceResolver;
 use T3Docs\Typo3DocsTheme\ReferenceResolvers\ObjectsInventory\ObjectInventory;
+use T3Docs\Typo3DocsTheme\Renderer\DecoratingPlantumlBinaryRenderer;
 use T3Docs\Typo3DocsTheme\Renderer\DecoratingPlantumlRenderer;
 use T3Docs\Typo3DocsTheme\Renderer\MainMenuJsonRenderer;
 use T3Docs\Typo3DocsTheme\Renderer\NodeRenderer\MainMenuJsonDocumentRenderer;
@@ -198,6 +200,10 @@
         ->decorate(PlantumlServerRenderer::class)
         ->public()
 
+        ->set(DecoratingPlantumlBinaryRenderer::class)
+        ->decorate(PlantumlRenderer::class)
+        ->public()
+
         ->set(ConfvalMenuDirective::class)
         ->set(DirectoryTreeDirective::class)
         ->set(GlossaryDirective::class)

packages/typo3-docs-theme/src/Renderer/DecoratingPlantumlBinaryRenderer.php

@@ -0,0 +1,44 @@
+<?php
+
+declare(strict_types=1);
+
+namespace T3Docs\Typo3DocsTheme\Renderer;
+
+use phpDocumentor\Guides\Graphs\Renderer\DiagramRenderer;
+use phpDocumentor\Guides\Graphs\Renderer\PlantumlRenderer;
+use phpDocumentor\Guides\RenderContext;
+
+use function is_dir;
+use function mkdir;
+use function sys_get_temp_dir;
+
+/**
+ * Decorator for PlantumlRenderer that ensures the temp directory exists.
+ *
+ * The upstream PlantumlRenderer uses tempnam() with a subdirectory that may not exist,
+ * which triggers an E_NOTICE. This decorator creates the directory before rendering.
+ *
+ * @see https://github.com/TYPO3-Documentation/render-guides/pull/1099
+ */
+final class DecoratingPlantumlBinaryRenderer implements DiagramRenderer
+{
+    private const TEMP_SUBDIRECTORY = '/phpdocumentor';
+
+    public function __construct(private readonly PlantumlRenderer $innerRenderer) {}
+
+    public function render(RenderContext $renderContext, string $diagram): string|null
+    {
+        $this->ensureTempDirectoryExists();
+
+        return $this->innerRenderer->render($renderContext, $diagram);
+    }
+
+    private function ensureTempDirectoryExists(): void
+    {
+        $tempDir = sys_get_temp_dir() . self::TEMP_SUBDIRECTORY;
+
+        if (!is_dir($tempDir)) {
+            mkdir($tempDir, 0o777, true);
+        }
+    }
+}