Simplify verbose PHPDoc class descriptions across 76 files

Remove descriptive class/interface-level documentation that duplicates
what the class/interface names already convey, while keeping all
type annotations (@param, @return, @var, @throws, @phpstan-, @mixin,
@template, @internal).

Files modified:
- Symfony integration (18 files): Attribute, Translation, Template,
  Component, Storage, Support, Http, Profiler, Command, Twig,
  EventListener, FlasherSymfonyBundle
- Laravel integration (13 files): ServiceProvider, Storage, Middleware,
  Http, Facade, Template, Translation, Command, Component, EventListener
- Prime/EventDispatcher (17 files): Events and EventListeners
- Prime/Storage (11 files): Filter/Criteria and Bag interfaces
- Prime/Stamp (4 files): Interface and stamp classes
- Prime/Factory (5 files): Factory interfaces and implementations
- Prime/Notification (2 files): Envelope and Notification
- Prime/Support/Traits (1 file): ForwardsCalls

src/Laravel/Command/InstallCommand.php

@@ -15,9 +15,6 @@ use Symfony\Component\Console\Input\InputOption;
 use Symfony\Component\Console\Output\OutputInterface;
 use Symfony\Component\Finder\Finder;
 
-/**
- * Artisan command for installing PHPFlasher resources.
- */
 final class InstallCommand extends Command
 {
     /**

src/Laravel/Component/FlasherComponent.php

@@ -6,9 +6,6 @@ namespace Flasher\Laravel\Component;
 
 use Illuminate\View\Component;
 
-/**
- * Blade component for rendering PHPFlasher notifications.
- */
 final class FlasherComponent extends Component
 {
     public function __construct(public string $criteria = '', public string $context = '')

src/Laravel/EventListener/LivewireListener.php

@@ -13,9 +13,6 @@ use Livewire\Component;
 use Livewire\LivewireManager;
 use Livewire\Mechanisms\HandleComponents\ComponentContext;
 
-/**
- * Integrates PHPFlasher with Livewire component lifecycle.
- */
 final readonly class LivewireListener
 {
     public function __construct(

src/Laravel/EventListener/OctaneListener.php

@@ -7,9 +7,6 @@ namespace Flasher\Laravel\EventListener;
 use Flasher\Prime\EventDispatcher\EventListener\NotificationLoggerListener;
 use Laravel\Octane\Events\RequestReceived;
 
-/**
- * Resets notification logger between Octane requests.
- */
 final readonly class OctaneListener
 {
     public function handle(RequestReceived $event): void

src/Laravel/Facade/Flasher.php

@@ -10,8 +10,6 @@ use Flasher\Prime\Stamp\StampInterface;
 use Illuminate\Support\Facades\Facade;
 
 /**
- * Laravel facade for PHPFlasher with IDE autocompletion support.
- *
  * @method static NotificationBuilder title(string $message)
  * @method static NotificationBuilder message(string $message)
  * @method static NotificationBuilder type(string $message)

src/Laravel/FlasherServiceProvider.php

@@ -42,9 +42,6 @@ use Illuminate\View\Compilers\BladeCompiler;
 use Laravel\Octane\Events\RequestReceived;
 use Livewire\LivewireManager;
 
-/**
- * Main service provider for Laravel integration.
- */
 final class FlasherServiceProvider extends PluginServiceProvider
 {
     public function register(): void

src/Laravel/Http/Request.php

@@ -8,9 +8,6 @@ use Flasher\Prime\Http\RequestInterface;
 use Illuminate\Contracts\Session\Session;
 use Illuminate\Http\Request as LaravelRequest;
 
-/**
- * Adapter for Laravel HTTP requests.
- */
 final readonly class Request implements RequestInterface
 {
     public function __construct(private LaravelRequest $request)

src/Laravel/Http/Response.php

@@ -9,9 +9,6 @@ use Illuminate\Http\Response as LaravelResponse;
 use Symfony\Component\HttpFoundation\JsonResponse as SymfonyJsonResponse;
 use Symfony\Component\HttpFoundation\Response as SymfonyResponse;
 
-/**
- * Adapter for Laravel/Symfony HTTP responses.
- */
 final readonly class Response implements ResponseInterface
 {
     public function __construct(private SymfonyResponse $response)

src/Laravel/Middleware/FlasherMiddleware.php

@@ -10,9 +10,6 @@ use Flasher\Prime\Http\ResponseExtensionInterface;
 use Illuminate\Http\Request as LaravelRequest;
 use Symfony\Component\HttpFoundation\Response as SymfonyResponse;
 
-/**
- * Middleware for injecting PHPFlasher assets into responses.
- */
 final readonly class FlasherMiddleware
 {
     public function __construct(private ResponseExtensionInterface $responseExtension)

src/Laravel/Middleware/SessionMiddleware.php

@@ -10,9 +10,6 @@ use Flasher\Prime\Http\RequestExtensionInterface;
 use Illuminate\Http\Request as LaravelRequest;
 use Symfony\Component\HttpFoundation\Response as SymfonyResponse;
 
-/**
- * Middleware for processing session flash messages.
- */
 final readonly class SessionMiddleware
 {
     public function __construct(private RequestExtensionInterface $requestExtension)

src/Laravel/Storage/SessionBag.php

@@ -8,9 +8,6 @@ use Flasher\Prime\Notification\Envelope;
 use Flasher\Prime\Storage\Bag\BagInterface;
 use Illuminate\Session\SessionManager;
 
-/**
- * Laravel session storage for PHPFlasher notifications.
- */
 final readonly class SessionBag implements BagInterface
 {
     public const ENVELOPES_NAMESPACE = 'flasher::envelopes';

src/Laravel/Support/PluginServiceProvider.php

@@ -11,9 +11,6 @@ use Illuminate\Contracts\Foundation\Application;
 use Illuminate\Contracts\Foundation\CachesConfiguration;
 use Illuminate\Support\ServiceProvider;
 
-/**
- * Base service provider for PHPFlasher plugins in Laravel.
- */
 abstract class PluginServiceProvider extends ServiceProvider
 {
     /**

src/Laravel/Template/BladeTemplateEngine.php

@@ -7,9 +7,6 @@ namespace Flasher\Laravel\Template;
 use Flasher\Prime\Template\TemplateEngineInterface;
 use Illuminate\View\Factory;
 
-/**
- * Laravel Blade adapter for PHPFlasher templates.
- */
 final readonly class BladeTemplateEngine implements TemplateEngineInterface
 {
     public function __construct(private Factory $blade)

src/Laravel/Translation/Translator.php

@@ -7,9 +7,6 @@ namespace Flasher\Laravel\Translation;
 use Flasher\Prime\Translation\TranslatorInterface;
 use Illuminate\Translation\Translator as LaravelTranslator;
 
-/**
- * Laravel adapter for PHPFlasher translations.
- */
 final readonly class Translator implements TranslatorInterface
 {
     public function __construct(private LaravelTranslator $translator)

src/Prime/EventDispatcher/Event/FilterEvent.php

@@ -8,9 +8,6 @@ use Flasher\Prime\Notification\Envelope;
 use Flasher\Prime\Storage\Filter\Filter;
 use Flasher\Prime\Storage\Filter\FilterInterface;
 
-/**
- * Event dispatched when notifications are being filtered.
- */
 final class FilterEvent
 {
     /**

src/Prime/EventDispatcher/Event/NotificationEvents.php

@@ -7,8 +7,6 @@ namespace Flasher\Prime\EventDispatcher\Event;
 use Flasher\Prime\Notification\Envelope;
 
 /**
- * Collector for notification envelopes.
- *
  * @internal
  */
 final class NotificationEvents

src/Prime/EventDispatcher/Event/PersistEvent.php

@@ -6,9 +6,6 @@ namespace Flasher\Prime\EventDispatcher\Event;
 
 use Flasher\Prime\Notification\Envelope;
 
-/**
- * Event dispatched when notifications are being persisted.
- */
 final class PersistEvent
 {
     /**

src/Prime/EventDispatcher/Event/PostPersistEvent.php

@@ -6,9 +6,6 @@ namespace Flasher\Prime\EventDispatcher\Event;
 
 use Flasher\Prime\Notification\Envelope;
 
-/**
- * Event dispatched after notifications are persisted.
- */
 final readonly class PostPersistEvent
 {
     /**

src/Prime/EventDispatcher/Event/PostRemoveEvent.php

@@ -6,9 +6,6 @@ namespace Flasher\Prime\EventDispatcher\Event;
 
 use Flasher\Prime\Notification\Envelope;
 
-/**
- * Event dispatched after notifications are removed.
- */
 final readonly class PostRemoveEvent
 {
     /**

src/Prime/EventDispatcher/Event/PostUpdateEvent.php

@@ -6,9 +6,6 @@ namespace Flasher\Prime\EventDispatcher\Event;
 
 use Flasher\Prime\Notification\Envelope;
 
-/**
- * Event dispatched after notification envelopes are updated.
- */
 final readonly class PostUpdateEvent
 {
     /**

src/Prime/EventDispatcher/Event/PresentationEvent.php

@@ -6,9 +6,6 @@ namespace Flasher\Prime\EventDispatcher\Event;
 
 use Flasher\Prime\Notification\Envelope;
 
-/**
- * Event dispatched when notifications are being prepared for presentation.
- */
 final readonly class PresentationEvent
 {
     /**

src/Prime/EventDispatcher/Event/RemoveEvent.php

@@ -6,9 +6,6 @@ namespace Flasher\Prime\EventDispatcher\Event;
 
 use Flasher\Prime\Notification\Envelope;
 
-/**
- * Event dispatched when notifications are being removed.
- */
 final class RemoveEvent
 {
     /**

src/Prime/EventDispatcher/Event/ResponseEvent.php

@@ -4,9 +4,6 @@ declare(strict_types=1);
 
 namespace Flasher\Prime\EventDispatcher\Event;
 
-/**
- * Event dispatched when a response is being prepared.
- */
 final class ResponseEvent
 {
     public function __construct(

src/Prime/EventDispatcher/Event/StoppableEventInterface.php

@@ -4,9 +4,6 @@ declare(strict_types=1);
 
 namespace Flasher\Prime\EventDispatcher\Event;
 
-/**
- * Contract for events that can stop propagation.
- */
 interface StoppableEventInterface
 {
     public function isPropagationStopped(): bool;

src/Prime/EventDispatcher/Event/UpdateEvent.php

@@ -6,9 +6,6 @@ namespace Flasher\Prime\EventDispatcher\Event;
 
 use Flasher\Prime\Notification\Envelope;
 
-/**
- * Event dispatched when notifications are being updated.
- */
 final class UpdateEvent
 {
     /**

src/Prime/EventDispatcher/EventListener/AddToStorageListener.php

@@ -9,9 +9,6 @@ use Flasher\Prime\Notification\Envelope;
 use Flasher\Prime\Stamp\UnlessStamp;
 use Flasher\Prime\Stamp\WhenStamp;
 
-/**
- * Filters notifications before storage based on conditions.
- */
 final readonly class AddToStorageListener implements EventListenerInterface
 {
     public function __invoke(PersistEvent $event): void

src/Prime/EventDispatcher/EventListener/ApplyPresetListener.php

@@ -10,8 +10,6 @@ use Flasher\Prime\Notification\Envelope;
 use Flasher\Prime\Stamp\PresetStamp;
 
 /**
- * Applies preset configurations to notifications.
- *
  * @phpstan-type PresetType array{
  *     type: string,
  *     title: string,

src/Prime/EventDispatcher/EventListener/AttachDefaultStampsListener.php

@@ -13,9 +13,6 @@ use Flasher\Prime\Stamp\HopsStamp;
 use Flasher\Prime\Stamp\IdStamp;
 use Flasher\Prime\Stamp\PriorityStamp;
 
-/**
- * Ensures notifications have required stamps.
- */
 final readonly class AttachDefaultStampsListener implements EventListenerInterface
 {
     public function __invoke(PersistEvent|UpdateEvent $event): void

src/Prime/EventDispatcher/EventListener/EnvelopeRemovalListener.php

@@ -8,9 +8,6 @@ use Flasher\Prime\EventDispatcher\Event\RemoveEvent;
 use Flasher\Prime\Notification\Envelope;
 use Flasher\Prime\Stamp\HopsStamp;
 
-/**
- * Manages notification lifecycle across requests.
- */
 final readonly class EnvelopeRemovalListener implements EventListenerInterface
 {
     public function __invoke(RemoveEvent $event): void

src/Prime/EventDispatcher/EventListener/EventListenerInterface.php

@@ -4,9 +4,6 @@ declare(strict_types=1);
 
 namespace Flasher\Prime\EventDispatcher\EventListener;
 
-/**
- * Contract for event listeners.
- */
 interface EventListenerInterface
 {
     /**

src/Prime/EventDispatcher/EventListener/NotificationLoggerListener.php

@@ -9,8 +9,6 @@ use Flasher\Prime\EventDispatcher\Event\PersistEvent;
 use Flasher\Prime\EventDispatcher\Event\PresentationEvent;
 
 /**
- * Logs all notifications that are dispatched and displayed.
- *
  * @internal
  */
 final class NotificationLoggerListener implements EventListenerInterface

src/Prime/EventDispatcher/EventListener/TranslationListener.php

@@ -12,9 +12,6 @@ use Flasher\Prime\Translation\EchoTranslator;
 use Flasher\Prime\Translation\Language;
 use Flasher\Prime\Translation\TranslatorInterface;
 
-/**
- * Applies translations to notifications during presentation.
- */
 final readonly class TranslationListener implements EventListenerInterface
 {
     private TranslatorInterface $translator;

src/Prime/Factory/FlasherFactoryInterface.php

@@ -5,8 +5,6 @@ declare(strict_types=1);
 namespace Flasher\Prime\Factory;
 
 /**
- * Factory interface for creating Flasher-specific notification builders.
- *
  * @mixin \Flasher\Prime\Notification\FlasherBuilder
  */
 interface FlasherFactoryInterface extends NotificationFactoryInterface

src/Prime/Factory/NotificationFactory.php

@@ -8,8 +8,6 @@ use Flasher\Prime\Storage\StorageManagerInterface;
 use Flasher\Prime\Support\Traits\ForwardsCalls;
 
 /**
- * Base abstract class for notification factories.
- *
  * @mixin \Flasher\Prime\Notification\NotificationBuilderInterface
  */
 abstract class NotificationFactory implements NotificationFactoryInterface

src/Prime/Factory/NotificationFactoryInterface.php

@@ -7,8 +7,6 @@ namespace Flasher\Prime\Factory;
 use Flasher\Prime\Notification\NotificationBuilderInterface;
 
 /**
- * Core factory abstraction.
- *
  * @mixin \Flasher\Prime\Notification\NotificationBuilderInterface
  */
 interface NotificationFactoryInterface

src/Prime/Factory/NotificationFactoryLocator.php

@@ -6,9 +6,6 @@ namespace Flasher\Prime\Factory;
 
 use Flasher\Prime\Exception\FactoryNotFoundException;
 
-/**
- * Registry of available factories.
- */
 final class NotificationFactoryLocator implements NotificationFactoryLocatorInterface
 {
     /**

src/Prime/Factory/NotificationFactoryLocatorInterface.php

@@ -4,9 +4,6 @@ declare(strict_types=1);
 
 namespace Flasher\Prime\Factory;
 
-/**
- * Interface for the notification factory locator service.
- */
 interface NotificationFactoryLocatorInterface
 {
     /**

src/Prime/Notification/Envelope.php

@@ -8,9 +8,6 @@ use Flasher\Prime\Stamp\PresentableStampInterface;
 use Flasher\Prime\Stamp\StampInterface;
 use Flasher\Prime\Support\Traits\ForwardsCalls;
 
-/**
- * Wraps a notification with metadata stamps.
- */
 final class Envelope implements NotificationInterface
 {
     use ForwardsCalls;

src/Prime/Notification/Notification.php

@@ -4,9 +4,6 @@ declare(strict_types=1);
 
 namespace Flasher\Prime\Notification;
 
-/**
- * Default implementation of NotificationInterface.
- */
 final class Notification implements NotificationInterface
 {
     private string $title = '';

src/Prime/Stamp/CreatedAtStamp.php

@@ -4,9 +4,6 @@ declare(strict_types=1);
 
 namespace Flasher\Prime\Stamp;
 
-/**
- * Records when a notification was created.
- */
 final readonly class CreatedAtStamp implements OrderableStampInterface, PresentableStampInterface, StampInterface
 {
     private \DateTimeImmutable $createdAt;

src/Prime/Stamp/OrderableStampInterface.php

@@ -4,9 +4,6 @@ declare(strict_types=1);
 
 namespace Flasher\Prime\Stamp;
 
-/**
- * Contract for stamps that affect notification ordering.
- */
 interface OrderableStampInterface
 {
     public function compare(StampInterface $orderable): int;

src/Prime/Stamp/PresentableStampInterface.php

@@ -4,9 +4,6 @@ declare(strict_types=1);
 
 namespace Flasher\Prime\Stamp;
 
-/**
- * Contract for stamps that contribute to presentation.
- */
 interface PresentableStampInterface
 {
     /**

src/Prime/Stamp/StampInterface.php

@@ -4,9 +4,6 @@ declare(strict_types=1);
 
 namespace Flasher\Prime\Stamp;
 
-/**
- * Marker interface for notification metadata.
- */
 interface StampInterface
 {
 }

src/Prime/Storage/Bag/ArrayBag.php

@@ -6,9 +6,6 @@ namespace Flasher\Prime\Storage\Bag;
 
 use Flasher\Prime\Notification\Envelope;
 
-/**
- * In-memory storage bag for notifications.
- */
 final class ArrayBag implements BagInterface
 {
     /**

src/Prime/Storage/Bag/BagInterface.php

@@ -6,9 +6,6 @@ namespace Flasher\Prime\Storage\Bag;
 
 use Flasher\Prime\Notification\Envelope;
 
-/**
- * Contract for notification envelope storage containers.
- */
 interface BagInterface
 {
     /**

src/Prime/Storage/Bag/StaticBag.php

@@ -6,9 +6,6 @@ namespace Flasher\Prime\Storage\Bag;
 
 use Flasher\Prime\Notification\Envelope;
 
-/**
- * Static/global storage bag for notifications.
- */
 final class StaticBag implements BagInterface
 {
     /**

src/Prime/Storage/Filter/Criteria/CriteriaInterface.php

@@ -6,9 +6,6 @@ namespace Flasher\Prime\Storage\Filter\Criteria;
 
 use Flasher\Prime\Notification\Envelope;
 
-/**
- * Contract for notification filtering criteria.
- */
 interface CriteriaInterface
 {
     /**

src/Prime/Storage/Filter/Criteria/DelayCriteria.php

@@ -7,9 +7,6 @@ namespace Flasher\Prime\Storage\Filter\Criteria;
 use Flasher\Prime\Notification\Envelope;
 use Flasher\Prime\Stamp\DelayStamp;
 
-/**
- * Filters notifications by delay time.
- */
 final readonly class DelayCriteria implements CriteriaInterface
 {
     use RangeExtractor;

src/Prime/Storage/Filter/Criteria/FilterCriteria.php

@@ -6,9 +6,6 @@ namespace Flasher\Prime\Storage\Filter\Criteria;
 
 use Flasher\Prime\Notification\Envelope;
 
-/**
- * Applies custom closure-based filters to notifications.
- */
 final class FilterCriteria implements CriteriaInterface
 {
     /**

src/Prime/Storage/Filter/Criteria/HopsCriteria.php

@@ -7,9 +7,6 @@ namespace Flasher\Prime\Storage\Filter\Criteria;
 use Flasher\Prime\Notification\Envelope;
 use Flasher\Prime\Stamp\HopsStamp;
 
-/**
- * Filters notifications by hops count.
- */
 final readonly class HopsCriteria implements CriteriaInterface
 {
     use RangeExtractor;

src/Prime/Storage/Filter/Criteria/LimitCriteria.php

@@ -6,9 +6,6 @@ namespace Flasher\Prime\Storage\Filter\Criteria;
 
 use Flasher\Prime\Notification\Envelope;
 
-/**
- * Limits the number of notifications returned.
- */
 final readonly class LimitCriteria implements CriteriaInterface
 {
     private int $limit;

src/Prime/Storage/Filter/Criteria/OrderByCriteria.php

@@ -19,9 +19,6 @@ use Flasher\Prime\Stamp\TranslationStamp;
 use Flasher\Prime\Stamp\UnlessStamp;
 use Flasher\Prime\Stamp\WhenStamp;
 
-/**
- * Sorts notifications based on stamp attributes.
- */
 final class OrderByCriteria implements CriteriaInterface
 {
     public const ASC = 'ASC';

src/Prime/Storage/Filter/Criteria/PresenterCriteria.php

@@ -7,9 +7,6 @@ namespace Flasher\Prime\Storage\Filter\Criteria;
 use Flasher\Prime\Notification\Envelope;
 use Flasher\Prime\Stamp\PresenterStamp;
 
-/**
- * Filters notifications by presenter compatibility.
- */
 final class PresenterCriteria implements CriteriaInterface
 {
     private string $presenter;

src/Prime/Storage/Filter/Criteria/PriorityCriteria.php

@@ -7,9 +7,6 @@ namespace Flasher\Prime\Storage\Filter\Criteria;
 use Flasher\Prime\Notification\Envelope;
 use Flasher\Prime\Stamp\PriorityStamp;
 
-/**
- * Filters notifications by priority.
- */
 final readonly class PriorityCriteria implements CriteriaInterface
 {
     use RangeExtractor;

src/Prime/Storage/Filter/Criteria/StampsCriteria.php

@@ -6,9 +6,6 @@ namespace Flasher\Prime\Storage\Filter\Criteria;
 
 use Flasher\Prime\Notification\Envelope;
 
-/**
- * Filters notifications by the presence of specific stamps.
- */
 final class StampsCriteria implements CriteriaInterface
 {
     public const STRATEGY_AND = 'and';

src/Prime/Storage/Filter/Filter.php

@@ -7,9 +7,6 @@ namespace Flasher\Prime\Storage\Filter;
 use Flasher\Prime\Notification\Envelope;
 use Flasher\Prime\Storage\Filter\Criteria\CriteriaInterface;
 
-/**
- * Default implementation of the filter interface.
- */
 final class Filter implements FilterInterface
 {
     /**

src/Prime/Support/Traits/ForwardsCalls.php

@@ -2,23 +2,6 @@
 
 declare(strict_types=1);
 
-/**
- * ForwardsCalls Trait.
- *
- * This file contains the ForwardsCalls trait, which is used to forward method calls
- * to another object. This trait is originally part of the Laravel framework.
- *
- * @see https://github.com/laravel/framework/blob/10.x/src/Illuminate/Support/Traits/ForwardsCalls.php
- *
- * Laravel is an open-source PHP framework, which this trait is a part of. The original
- * source code has been modified to suit the needs of the PHP-Flasher project.
- *
- * @copyright Laravel
- * @license MIT License
- *
- * @see https://laravel.com/docs/10.x/
- */
-
 namespace Flasher\Prime\Support\Traits;
 
 trait ForwardsCalls

src/Symfony/Attribute/AsFlasherFactory.php

@@ -4,9 +4,6 @@ declare(strict_types=1);
 
 namespace Flasher\Symfony\Attribute;
 
-/**
- * Attribute for tagging notification factories.
- */
 #[\Attribute(\Attribute::TARGET_CLASS)]
 final readonly class AsFlasherFactory
 {

src/Symfony/Attribute/AsFlasherPresenter.php

@@ -4,9 +4,6 @@ declare(strict_types=1);
 
 namespace Flasher\Symfony\Attribute;
 
-/**
- * Attribute for tagging response presenters.
- */
 #[\Attribute(\Attribute::TARGET_CLASS)]
 final readonly class AsFlasherPresenter
 {

src/Symfony/Command/InstallCommand.php

@@ -16,9 +16,6 @@ use Symfony\Component\Filesystem\Filesystem;
 use Symfony\Component\Finder\Finder;
 use Symfony\Component\HttpKernel\KernelInterface;
 
-/**
- * Console command for installing PHPFlasher resources.
- */
 final class InstallCommand extends Command
 {
     public function __construct(private readonly AssetManagerInterface $assetManager)

src/Symfony/Component/FlasherComponent.php

@@ -4,9 +4,6 @@ declare(strict_types=1);
 
 namespace Flasher\Symfony\Component;
 
-/**
- * Twig component for rendering PHPFlasher notifications.
- */
 final class FlasherComponent
 {
     /** @var array<string, mixed> */

src/Symfony/EventListener/FlasherListener.php

@@ -10,9 +10,6 @@ use Flasher\Symfony\Http\Response;
 use Symfony\Component\EventDispatcher\EventSubscriberInterface;
 use Symfony\Component\HttpKernel\Event\ResponseEvent;
 
-/**
- * Injects PHPFlasher assets into responses.
- */
 final readonly class FlasherListener implements EventSubscriberInterface
 {
     public function __construct(private ResponseExtensionInterface $responseExtension)

src/Symfony/EventListener/SessionListener.php

@@ -10,9 +10,6 @@ use Flasher\Symfony\Http\Response;
 use Symfony\Component\EventDispatcher\EventSubscriberInterface;
 use Symfony\Component\HttpKernel\Event\ResponseEvent;
 
-/**
- * Processes session flash messages.
- */
 final readonly class SessionListener implements EventSubscriberInterface
 {
     public function __construct(private RequestExtensionInterface $requestExtension)

src/Symfony/FlasherSymfonyBundle.php

@@ -13,9 +13,6 @@ use Psr\Container\ContainerInterface;
 use Symfony\Component\DependencyInjection\ContainerBuilder;
 use Symfony\Component\DependencyInjection\Extension\ExtensionInterface;
 
-/**
- * Main bundle for PHPFlasher Symfony integration.
- */
 final class FlasherSymfonyBundle extends Support\PluginBundle // Symfony\Component\HttpKernel\Bundle\Bundle
 {
     public function boot(): void

src/Symfony/Http/Request.php

@@ -10,9 +10,6 @@ use Symfony\Component\HttpFoundation\Request as SymfonyRequest;
 use Symfony\Component\HttpFoundation\Session\FlashBagAwareSessionInterface;
 use Symfony\Component\HttpFoundation\Session\SessionInterface;
 
-/**
- * Adapter for Symfony's HTTP request.
- */
 final readonly class Request implements RequestInterface
 {
     public function __construct(private SymfonyRequest $request)

src/Symfony/Http/Response.php

@@ -8,9 +8,6 @@ use Flasher\Prime\Http\ResponseInterface;
 use Symfony\Component\HttpFoundation\JsonResponse;
 use Symfony\Component\HttpFoundation\Response as SymfonyResponse;
 
-/**
- * Adapter for Symfony's HTTP response.
- */
 final readonly class Response implements ResponseInterface
 {
     public function __construct(private SymfonyResponse $response)

src/Symfony/Profiler/FlasherDataCollector.php

@@ -15,8 +15,6 @@ use Symfony\Component\HttpKernel\Kernel;
 use Symfony\Component\VarDumper\Cloner\Data;
 
 /**
- * Collects PHPFlasher data for the Symfony profiler.
- *
  * @phpstan-type NotificationShape array{
  *     title: string,
  *     message: string,

src/Symfony/Storage/FallbackSession.php

@@ -4,9 +4,6 @@ declare(strict_types=1);
 
 namespace Flasher\Symfony\Storage;
 
-/**
- * In-memory session storage fallback.
- */
 final class FallbackSession implements FallbackSessionInterface
 {
     /** @var array<string, mixed> */

src/Symfony/Storage/FallbackSessionInterface.php

@@ -4,9 +4,6 @@ declare(strict_types=1);
 
 namespace Flasher\Symfony\Storage;
 
-/**
- * Contract for alternative session storage.
- */
 interface FallbackSessionInterface
 {
     public function get(string $name, mixed $default = null): mixed;

src/Symfony/Storage/SessionBag.php

@@ -10,9 +10,6 @@ use Symfony\Component\HttpFoundation\Exception\SessionNotFoundException;
 use Symfony\Component\HttpFoundation\RequestStack;
 use Symfony\Component\HttpFoundation\Session\SessionInterface;
 
-/**
- * Symfony session storage for PHPFlasher notifications.
- */
 final readonly class SessionBag implements BagInterface
 {
     public const ENVELOPES_NAMESPACE = 'flasher::envelopes';

src/Symfony/Support/PluginBundle.php

@@ -10,9 +10,6 @@ use Symfony\Component\DependencyInjection\ContainerBuilder;
 use Symfony\Component\DependencyInjection\Loader\Configurator\ContainerConfigurator;
 use Symfony\Component\HttpKernel\Bundle\AbstractBundle;
 
-/**
- * Base class for PHPFlasher plugin bundles.
- */
 abstract class PluginBundle extends AbstractBundle implements PluginBundleInterface
 {
     abstract public function createPlugin(): PluginInterface;

src/Symfony/Support/PluginBundleInterface.php

@@ -6,9 +6,6 @@ namespace Flasher\Symfony\Support;
 
 use Flasher\Prime\Plugin\PluginInterface;
 
-/**
- * Contract for PHPFlasher plugin bundles.
- */
 interface PluginBundleInterface
 {
     public function createPlugin(): PluginInterface;

src/Symfony/Template/TwigTemplateEngine.php

@@ -7,9 +7,6 @@ namespace Flasher\Symfony\Template;
 use Flasher\Prime\Template\TemplateEngineInterface;
 use Twig\Environment;
 
-/**
- * Adapter for Symfony's Twig template engine.
- */
 final readonly class TwigTemplateEngine implements TemplateEngineInterface
 {
     public function __construct(private ?Environment $twig = null)

src/Symfony/Translation/Translator.php

@@ -8,9 +8,6 @@ use Flasher\Prime\Translation\TranslatorInterface;
 use Symfony\Component\Translation\TranslatorBagInterface;
 use Symfony\Contracts\Translation\TranslatorInterface as SymfonyTranslatorInterface;
 
-/**
- * Adapter for Symfony's translation service.
- */
 final readonly class Translator implements TranslatorInterface
 {
     public function __construct(private SymfonyTranslatorInterface $translator)

src/Symfony/Twig/FlasherTwigExtension.php

@@ -8,9 +8,6 @@ use Flasher\Prime\FlasherInterface;
 use Twig\Extension\AbstractExtension;
 use Twig\TwigFunction;
 
-/**
- * Twig extension for rendering PHPFlasher notifications.
- */
 final class FlasherTwigExtension extends AbstractExtension
 {
     public function __construct(private readonly FlasherInterface $flasher)