feat!: modernize error handling and HTTP integration for PHP 8.3

.changelog/fix-optional-callable-event-composition.md

@@ -0,0 +1,6 @@
+---
+category: fixed
+type: patch
+---
+
+Skip structural autowiring failure for an unconfigured optional callable reporter so the default major aggregate still delivers PSR-14 events. Preserve configured reporter order and explicit factory failures, and document the container's remaining concrete fallback boundary.

.changelog/modernize-error-handler.md

@@ -0,0 +1,59 @@
+---
+category: changed
+type: major
+---
+
+Modernize the library for PHP 8.3+ while retaining the package
+`coisa/error-handler` and namespace `CoiSA\ErrorHandler`.
+- Require PHP `^8.3`, with a tested CI matrix of PHP 8.3–8.5.
+- Require FastForward Container `^1.10` and expose the Interop service provider as the
+  container entrypoint. Remove the standalone Container/ConfigProvider APIs,
+  their package-specific exceptions and constructor-only factories. Keep explicit
+  lifecycle/composition factories under `ServiceProvider\Factory`.
+- Keep construction and discovery inert. Preserve cached services and provide
+  explicit fresh handler/middleware factories. Require reverse-order unregistration,
+  retain one shutdown callback per handler and notify only the active owner.
+- Exit 1 after successful registered uncaught-exception reporting. Preserve direct
+  calls without termination; propagate reporter failures without retry during a
+  failed registration while allowing independent direct deliveries.
+- Separate HTTP reporting from rendering. Middleware requires both contracts,
+  reports once and then invokes a pure response factory. Use a generic stream by
+  default, standard reason phrases and integer HTTP error statuses through 599.
+- Keep explicit public output capture as an opt-in renderer adapter. Preserve `0`,
+  use a generic fallback for empty output, clean reachable buffers after success and failure,
+  and retain renderer-failure precedence over cleanup failures. If no capture
+  remains above the caller's entry depth, use the generic fallback without reading caller output.
+- Retain delivered 2.x handlers and native release tooling. Add distribution checks
+  and organized PHPUnit Unit/Functional/Process coverage. Cover partial callback
+  ownership, fail-fast reporter identity and native fatal diagnostic metadata.
+  Preserve the configurable 80% overall coverage floor and real comparisons;
+  retire the prototype Fire/HTTP/Python parents and custom release publisher.
+- Check all complete cookbook recipes against executable source, retaining
+  the exact inventory and omitting only each leading license header.
+- Ship the canonical `resources/skills/coisa-error-handler` package with
+  configuration-first examples for the Interop provider and pure
+  renderer contracts. Preserve its license and optional installer metadata, and
+  require the complete consumer payload in distribution checks.
+- Add a direct native regression for output-handler destruction that replaces its
+  removed buffer, proving bounded cleanup, primary-failure and caller ownership.
+- Preserve the JSON, optional Whoops and explicit reporting adapters published in
+  2.5.0. Compose pure renderers after the middleware report; retain trusted debug
+  configuration, lazy page overrides and fresh middleware scopes without a second
+  diagnostic delivery. Consolidate response profiles into the request-aware
+  provider described in the companion negotiation entry.
+- Accept matching callables in all three ErrorHandler constructor inputs using
+  existing adapters. Preserve interface identity and precedence, required reporter,
+  optional null defaults, inert construction and the existing reporting policies.
+  Keep explicit provider factories for cached services and fresh scopes.
+- Refresh Composer development-tool ranges to the current stable lines, retaining
+  PHP 8.3 support through PHPUnit 12.5 and Symfony Process 7.4 alternatives.
+  Require Nyholm 1.8.2 in development for its PHP 8.5 fixes; retain the compatible
+  PSR ranges and optional Whoops 2.18.7 minimum with its upstream native STDIN source-read fix.
+  The Whoops compatibility fix preserves its renderer contract; the lifecycle and
+  HTTP-default changes above apply to this major.
+- Describe the accompanying API without temporary PR or publication status,
+  and clarify that diagnostic reporter output remains outside the PSR-7 body.
+- Correct callable-filtering guidance, clarify generic stream and fatal-reporting
+  contracts, and distinguish checkout recipes from bundled application examples.
+  Keep installed documentation links usable and release instructions current.
+- Keep available representations and diagnostic authorization under application control.

.changelog/negotiate-the-html-response-charset.md

@@ -0,0 +1,8 @@
+---
+category: fixed
+type: patch
+---
+
+Negotiate the built-in HTML renderer using its actual UTF-8 media type. Honor
+charset-specific Accept preferences and exclusions instead of choosing HTML when
+its charset is explicitly forbidden or falling back when UTF-8 HTML is accepted.

.changelog/request-aware-response-negotiation.md

@@ -0,0 +1,26 @@
+---
+category: changed
+type: major
+---
+
+Negotiate error responses from the current request through a single
+`ErrorHandlerServiceProvider`. Replace the JSON and Whoops profile providers with
+lazy Problem Details JSON, plain-text and Symfony HTML representations. Accept a required
+`ServerRequestInterface` alongside the original throwable in every response
+factory and forward it unchanged after one middleware report.
+
+Keep diagnostic output disabled by default. Explicit debug configuration enables
+JSON diagnostics and Symfony's detailed HTML, while production HTML remains a
+generic status page. Keep Whoops available only through explicit application
+composition, without changing the default based on installed optional packages.
+Respect Accept quality and exclusions, preserve existing Vary fields and keep
+selection independent across requests that reuse the same cached service.
+
+Serialize Problem Details with Symfony Serializer, preserving public HTTP status
+codes and keeping trace arguments and objects out of debug responses. Support
+compatible Symfony component majors without requiring a matching VarDumper major.
+Exclude older component patches that emit native PHP 8.4+ deprecations, including
+incompatible transitive VarDumper versions, without adding a direct dependency.
+Offer an explicit Symfony CLI reporter through the same provider, writing to
+STDERR or the application's Console error output without installing native hooks.
+Demonstrate PSR-14 reporting with FastForward Event Dispatcher and its provider.

.github/workflows/changelog.yml

@@ -21,7 +21,7 @@ jobs:
       issues: read
       statuses: write
 
-    # Official v0 compatibility branch; reviewed against v0.2.0.
+    # Official v0 compatibility branch; reviewed against v0.3.0.
     uses: php-fast-forward/changelog/.github/workflows/changelog.yml@v0
 
     with:

.github/workflows/ci.yml

@@ -63,17 +63,76 @@ jobs:
       - name: Run formatting, PHPCS, PHPUnit and maximum src-plus-tests analysis
         run: composer --no-plugins check
 
+  symfony-compatibility:
+    name: Symfony ${{ matrix.error-handler }} / PHP ${{ matrix.php }}
+    runs-on: ubuntu-latest
+    timeout-minutes: 15
+    strategy:
+      fail-fast: false
+      matrix:
+        include:
+          - php: '8.3'
+            error-handler: '~5.4.0'
+            serializer: '~5.4.0'
+            http-foundation: '~6.4.0'
+          - php: '8.3'
+            error-handler: '~6.4.0'
+            serializer: '~6.4.0'
+            http-foundation: '~6.4.0'
+          - php: '8.4'
+            error-handler: '~7.0.0'
+            serializer: '~7.0.0'
+            http-foundation: '~7.4.0'
+          - php: '8.5'
+            error-handler: '~8.0.0'
+            serializer: '~8.0.0'
+            http-foundation: '~8.1.0'
+
+    steps:
+      - uses: actions/checkout@v7
+        with:
+          persist-credentials: false
+
+      - name: Isolate Composer state
+        run: |
+          echo "COMPOSER_HOME=$RUNNER_TEMP/composer-home" >> "$GITHUB_ENV"
+          echo "COMPOSER_CACHE_DIR=$RUNNER_TEMP/composer-cache" >> "$GITHUB_ENV"
+
+      - uses: shivammathur/setup-php@v2
+        with:
+          php-version: ${{ matrix.php }}
+          extensions: dom, mbstring, xml, xmlwriter
+          ini-values: error_reporting=E_ALL
+          coverage: none
+          tools: composer:v2
+
+      - name: Resolve the supported Symfony combination
+        env:
+          ERROR_HANDLER: ${{ matrix.error-handler }}
+          SERIALIZER: ${{ matrix.serializer }}
+          HTTP_FOUNDATION: ${{ matrix.http-foundation }}
+        run: |
+          composer update --no-plugins --no-scripts --no-interaction --prefer-dist --no-progress \
+            --with "symfony/error-handler:$ERROR_HANDLER" \
+            --with "symfony/serializer:$SERIALIZER" \
+            --with "symfony/http-foundation:$HTTP_FOUNDATION"
+          composer check-platform-reqs
+          composer show --locked
+
+      - name: Verify the adapters and application composition
+        run: composer --no-plugins check
+
   production:
     name: Production / PHP ${{ matrix.php }} / ${{ matrix.dependencies }}
     runs-on: ubuntu-latest
     timeout-minutes: 10
     strategy:
       fail-fast: false
       matrix:
-        php: ['7.4', '8.0', '8.1', '8.2', '8.3', '8.4', '8.5']
+        php: ['8.3', '8.4', '8.5']
         dependencies: [highest]
         include:
-          - php: '7.4'
+          - php: '8.3'
             dependencies: lowest
           - php: '8.5'
             dependencies: lowest
@@ -246,3 +305,4 @@ jobs:
         with:
           header: phpunit-coverage
           path: ${{ steps.coverage-diff.outputs.file }}
+

.gitignore

@@ -3,6 +3,7 @@
 /composer.lock
 .idea/
 vendor/
+/tmp/
 tests/html/
 tests/clover.xml
 tests/cobertura.xml

.php-cs-fixer.dist.php

@@ -25,8 +25,12 @@
 $header = HeaderExtractor::extractFromFile(__FILE__);
 
 return PhpCsFixer::create($paths, $header, [
-    'trailing_comma_in_multiline' => [
-        'after_heredoc' => true,
-        'elements'     => ['arguments', 'array_destructuring', 'arrays'],
+    // PER3 sections 4/4.4 recommend concise empty bodies (SHOULD); keep multiline bodies
+    // to converge with complete PSR12 checking, including braced namespaces.
+    // https://github.com/php-fig/per-coding-style/blob/3.0.0/spec.md#44-methods-and-functions
+    'single_line_empty_body' => false,
+    'braces_position' => [
+        'allow_single_line_anonymous_functions' => false,
+        'allow_single_line_empty_anonymous_classes' => false,
     ],
 ]);