[FEATURE] Add event AfterYamlParseEvent

Introduces a new event that is fired after the YAML configuration of
a content block is parsed and before it is processed.

Author: codemonkey1988

Classes/Event/AfterYamlParseEvent.php

@@ -0,0 +1,44 @@
+<?php
+
+declare(strict_types=1);
+
+/*
+ * This file is part of the TYPO3 CMS project.
+ *
+ * It is free software; you can redistribute it and/or modify it under
+ * the terms of the GNU General Public License, either version 2
+ * of the License, or any later version.
+ *
+ * For the full copyright and license information, please read the
+ * LICENSE.txt file that was distributed with this source code.
+ *
+ * The TYPO3 project - inspiring people to share!
+ */
+
+namespace TYPO3\CMS\ContentBlocks\Event;
+
+final class AfterYamlParseEvent
+{
+    /**
+     * @param array<string, mixed> $contentBlocksConfiguration
+     */
+    public function __construct(private array $contentBlocksConfiguration)
+    {
+    }
+
+    /**
+     * @return array<string, mixed>
+     */
+    public function getContentBlocksConfiguration(): array
+    {
+        return $this->contentBlocksConfiguration;
+    }
+
+    /**
+     * @param array<string, mixed> $contentBlocksConfiguration
+     */
+    public function setContentBlocksConfiguration(array $contentBlocksConfiguration): void
+    {
+        $this->contentBlocksConfiguration = $contentBlocksConfiguration;
+    }
+}

Classes/Loader/ContentBlockLoader.php

@@ -17,6 +17,7 @@
 
 namespace TYPO3\CMS\ContentBlocks\Loader;
 
+use Psr\EventDispatcher\EventDispatcherInterface;
 use Symfony\Component\DependencyInjection\Attribute\Autowire;
 use Symfony\Component\Finder\Finder;
 use TYPO3\CMS\ContentBlocks\Basics\BasicsLoader;
@@ -25,6 +26,7 @@
 use TYPO3\CMS\ContentBlocks\Definition\ContentType\ContentTypeIcon;
 use TYPO3\CMS\ContentBlocks\Definition\ContentType\PageIconSet;
 use TYPO3\CMS\ContentBlocks\Definition\Factory\UniqueIdentifierCreator;
+use TYPO3\CMS\ContentBlocks\Event\AfterYamlParseEvent;
 use TYPO3\CMS\ContentBlocks\Registry\ContentBlockRegistry;
 use TYPO3\CMS\ContentBlocks\Schema\SimpleTcaSchemaFactory;
 use TYPO3\CMS\ContentBlocks\Service\Icon\ContentTypeIconResolverInput;
@@ -81,6 +83,7 @@ public function __construct(
         protected readonly AssetPublisher $assetPublisher,
         protected readonly ContentBlocksYamlParserInterface $contentBlocksYamlLoader,
         protected readonly SimpleTcaSchemaFactory $simpleTcaSchemaFactory,
+        protected readonly EventDispatcherInterface $eventDispatcher,
     ) {}
 
     public function load(): ContentBlockRegistry
@@ -217,7 +220,9 @@ protected function parseConfigYaml(string $absoluteContentBlockPath, ContentType
                 );
             }
         }
-        return $config;
+        $afterYamlParseEvent = new AfterYamlParseEvent($config);
+        $this->eventDispatcher->dispatch($afterYamlParseEvent);
+        return $afterYamlParseEvent->getContentBlocksConfiguration();
     }
 
     protected function loadSingleContentBlock(

Documentation/DeveloperCorner/Events/Index.rst

@@ -0,0 +1,14 @@
+.. include:: /Includes.rst.txt
+.. _psr14-events:
+
+======
+Events
+======
+
+Content Blocks provides PSR-14 events. See
+`Event Dispatcher <https://docs.typo3.org/permalink/t3coreapi:EventDispatcher>`__ for implementation.
+
+Available events
+================
+
+- :php:`\TYPO3\CMS\ContentBlocks\Event\AfterYamlParseEvent`