[FEATURE] Add PSR-14 Event before renderable is added to form (#1333) (#6058)

* [FEATURE] Add PSR-14 Event before renderable is added to form (#1333)

Resolves: TYPO3-Documentation/Changelog-To-Doc#1333
Releases: main

* [FEATURE] Add PSR-14 Event before renderable is added to form (#1333)

Resolves: TYPO3-Documentation/Changelog-To-Doc#1333
Releases: main

* [FEATURE] Add PSR-14 Event before renderable is added to form (#1333)

Resolves: TYPO3-Documentation/Changelog-To-Doc#1333
Releases: main

Author: sarahmccarthy123

Documentation/ApiOverview/Events/Events/Form/BeforeRenderableIsAddedToFormEvent.rst

@@ -0,0 +1,34 @@
+..  include:: /Includes.rst.txt
+..  index:: Events; BeforeRenderableIsAddedToFormEvent
+
+..  _BeforeRenderableIsAddedToFormEvent:
+
+==================================
+BeforeRenderableIsAddedToFormEvent
+==================================
+
+..  versionadded:: 14.0
+    The event :php-short:`TYPO3\CMS\Form\Event\BeforeRenderableIsAddedToFormEvent`
+    is a direct replacement for the removed hook
+    :php:`$GLOBALS['TYPO3_CONF_VARS']['SC_OPTIONS']['ext/form']['initializeFormElement']`.
+
+The event :php-short:`TYPO3\CMS\Form\Event\BeforeRenderableIsAddedToFormEvent`
+is dispatched before a renderable is constructed and added to a form. This
+event allows a renderable to be customized after everything has been
+initialized.
+
+
+..  _BeforeRenderableIsAddedToFormEvent-example:
+
+Example
+=======
+
+..  literalinclude:: _BeforeRenderableIsAddedToFormEvent/_MyEventListener.php
+    :caption: EXT:my_extension/Classes/EventListener/MyEventListener.php
+
+..  _BeforeRenderableIsAddedToFormEvent-api:
+
+API
+===
+
+..  include:: /CodeSnippets/Events/Form/BeforeRenderableIsAddedToFormEvent.rst.txt

Documentation/ApiOverview/Events/Events/Form/_BeforeRenderableIsAddedToFormEvent/_MyEventListener.php

@@ -0,0 +1,19 @@
+<?php
+
+declare(strict_types=1);
+
+namespace MyVendor\MyExtension\EventListener;
+
+use TYPO3\CMS\Core\Attribute\AsEventListener;
+use TYPO3\CMS\Form\Event\BeforeRenderableIsAddedToFormEvent;
+
+final readonly class MyEventListener
+{
+    #[AsEventListener(
+        identifier: 'my-extension/before-renderable-is-added-to-form-event',
+    )]
+    public function __invoke(BeforeRenderableIsAddedToFormEvent $event): void
+    {
+        $event->renderable->setLabel('foo');
+    }
+}

Documentation/ApiOverview/Localization/LocalizationApi/_LocalizationUtilityApi.rst.txt

@@ -5,7 +5,7 @@
 
     Localization helper which should be used to fetch localized labels.
 
-    ..  php:method:: translate(string $key, ?string $extensionName = NULL, ?array $arguments = NULL, ?TYPO3\CMS\Core\Localization\Locale|string|null $languageKey = NULL)
+    ..  php:method:: translate(string $key, ?string $extensionName = NULL, ?array $arguments = NULL, ?TYPO3\CMS\Core\Localization\Locale|string|null $languageKey = NULL, ?\Psr\Http\Message\ServerRequestInterface $request = NULL)
         :returns: `string|null`
 
         Returns the localized label of the LOCAL_LANG key, $key.
@@ -14,4 +14,5 @@
         :param $extensionName: The name of the extension, default: NULL
         :param $arguments: The arguments of the extension, being passed over to sprintf, default: NULL
         :param $languageKey: The language key or null for using the current language from the system, default: NULL
+        :param $request: the request, default: NULL
         :Return description: The value from LOCAL_LANG or null if no translation was found.

Documentation/CodeSnippets/Config/Api/Events/EventsForm.php

@@ -19,4 +19,10 @@
         'targetFileName' => 'CodeSnippets/Events/Form/BeforeFormIsCreatedEvent.rst.txt',
         'withCode' => false,
     ],
+    [
+        'action' => 'createPhpClassDocs',
+        'class' => \TYPO3\CMS\Form\Event\BeforeRenderableIsAddedToFormEvent::class,
+        'targetFileName' => 'CodeSnippets/Events/Form/BeforeRenderableIsAddedToFormEvent.rst.txt',
+        'withCode' => false,
+    ],
 ];

Documentation/CodeSnippets/Events/Form/BeforeRenderableIsAddedToFormEvent.rst.txt

@@ -0,0 +1,9 @@
+..  Generated by https://github.com/TYPO3-Documentation/t3docs-codesnippets
+..  php:namespace::  TYPO3\CMS\Form\Event
+
+..  php:class:: BeforeRenderableIsAddedToFormEvent
+
+    Listeners to this Event will be able to modify the renderable (form element) before being finally added to the form
+
+    ..  php:attr:: renderable
+        :public: