`8.3.19 (2026-03-20) <https://github.com/neos/flow-development-collection/releases/tag/8.3.19>`_
================================================================================================

Overview of merged pull requests
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

`BUGFIX: Replace outdated postgresql-action with docker command <https://github.com/neos/flow-development-collection/pull/3539>`_
---------------------------------------------------------------------------------------------------------------------------------

The github action ``harmon758/postgresql-action@v1`` is outdated and doesn't work with the current docker version anymore. So it needs to get replaced.

* Packages: ``.github``

`BUGFIX: Remove singleton annotation on validators <https://github.com/neos/flow-development-collection/pull/3537>`_
--------------------------------------------------------------------------------------------------------------------

* Fixes: `#2879 <https://github.com/neos/flow-development-collection/issues/2879>`_ 

The validators are not meant to be singleton. The singleton annotations causes issues if you try to set options via ``Flow\\Validate`` annotation or try to create a validator with ``ValidatorResolver->createValidator()``.

Technically a singleton would work for validators without options. But the advantage in not constructing them every time, seems to be negligible.

* Packages: ``Flow``

`TASK: Configurable Flow support for Xdebug native path mapping <https://github.com/neos/flow-development-collection/pull/3535>`_
---------------------------------------------------------------------------------------------------------------------------------

**Adds Flow support for Xdebug native path mapping (>= 3.5).**

If enabled (disabled by default for now), the XdebugPathMappingBuilder connects to the "afterCompile" signal and builds a ``./xdebug/flow.map`` to provide the path mapping information for xdebug.

Example (.xdebug/flow.map)
```
# Created by Flow Framework during compile time proxy generation.
#
# Ensure you are using xdebug >= v3.5 with enabled path mapping.
# Configuration in your php.ini:
# xdebug.mode = develop
# xdebug.path_mapping = 1
#
# ----------------------------------------------------------------
# Last update: 2026-03-03 22:49:57
remote_prefix:/var/www/html/Data/Temporary/Development/SubContextDdev/Cache/Code/Flow_Object_Classes/
local_prefix:/var/www/html/
Neos_Diff_Diff.php = Packages/Neos/Neos.Diff/Classes/Diff.php
Neos_Diff_SequenceMatcher.php = Packages/Neos/Neos.Diff/Classes/SequenceMatcher.php
Neos_Diff_Renderer_Html_HtmlInlineRenderer.php = Packages/Neos/Neos.Diff/Classes/Renderer/Html/HtmlInlineRenderer.php
Neos_Diff_Renderer_Html_HtmlSideBySideRenderer.php = Packages/Neos/Neos.Diff/Classes/Renderer/Html/HtmlSideBySideRenderer.php
...
```

**Configuration**
```
Neos:
  Flow:
    object:
      proxy:
        enableXdebugPathMapping: true
```
_Should be only enabled in development context._

**Why targeting 8.3?**
Even if this is a new feature, we wanted to provide this all developers as soon as possible. So we add this already to 8.3 but disabled by default, to be non-breaking.
We will enable the path mapping file generation by default in development context beginning with Flow 9.2. 

**How to use**
You need xdebug in v3.5+ with enabled path mapping. Also the xdebug mode needs to be not "OFF". The php.ini configuration could be:
```
xdebug.mode = develop
xdebug.path_mapping = 1
```

See: https://xdebug.org/funding/001-native-path-mapping

Depends on: `#3538 <https://github.com/neos/flow-development-collection/issues/3538>`_
* Fixes: `#3480 <https://github.com/neos/flow-development-collection/issues/3480>`_ 

* Packages: ``Flow``

`TASK: Replace broken signal "compiledClasses" with "afterCompile" <https://github.com/neos/flow-development-collection/pull/3538>`_
------------------------------------------------------------------------------------------------------------------------------------

This replaces the broken signal ``compiledClasses``, which has never worked as it was missing the manual signal dispatch, because the Compiler is not proxied.

This is a preparation for https://github.com/neos/flow-development-collection/issues/3480, which needs a new slighlty different signal.

This also fixes the AnnotationCacheFlusher dependency injection, to get this working again.

* Packages: ``Flow``

`TASK: Raise composer/composer version constraint <https://github.com/neos/flow-development-collection/pull/3534>`_
-------------------------------------------------------------------------------------------------------------------

… to avoid ANSI sequence injection vulnerability.


`Detailed log <https://github.com/neos/flow-development-collection/compare/8.3.18...8.3.19>`_
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~