From b28c101df590b442c6f38ec7a5b6600311691afd Mon Sep 17 00:00:00 2001
From: Maxcastel <maxence.nord@gmail.com>
Date: Tue, 8 Sep 2026 16:01:30 +0200
Subject: [PATCH] chore(metadata): defer FilterInterface::getDescription()
 removal to 6.0

---
 src/Metadata/FilterInterface.php       | 2 +-
 src/OpenApi/Factory/OpenApiFactory.php | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/src/Metadata/FilterInterface.php b/src/Metadata/FilterInterface.php
index 72a8db12f97..ce8f9ae90ff 100644
--- a/src/Metadata/FilterInterface.php
+++ b/src/Metadata/FilterInterface.php
@@ -51,7 +51,7 @@ interface FilterInterface
      *
      * @return array<string, array{property?: string, type?: string, required?: bool, description?: string, strategy?: string, is_collection?: bool, openapi?: \ApiPlatform\OpenApi\Model\Parameter, schema?: array<string, mixed>}>
      *
-     * @deprecated in 4.2, to be removed in 5.0
+     * @deprecated in 4.2, to be removed in 6.0
      */
     public function getDescription(string $resourceClass): array;
 }
diff --git a/src/OpenApi/Factory/OpenApiFactory.php b/src/OpenApi/Factory/OpenApiFactory.php
index 1612d6e22e9..4290352579c 100644
--- a/src/OpenApi/Factory/OpenApiFactory.php
+++ b/src/OpenApi/Factory/OpenApiFactory.php
@@ -720,7 +720,7 @@ private function getFiltersParameters(CollectionOperationInterface|HttpOperation
     private function getFilterParameter(string $name, array $description, string $shortName, string $filter): Parameter
     {
         if (isset($description['swagger'])) {
-            trigger_deprecation('api-platform/core', '4.0', \sprintf('Using the "swagger" field of the %s::getDescription() (%s) is deprecated.', $filter, $shortName));
+            trigger_deprecation('api-platform/core', '4.0', \sprintf('Using the "swagger" field of the %s::getDescription() (%s) is deprecated and will be removed in 6.0.', $filter, $shortName));
         }
 
         if (!isset($description['openapi']) || $description['openapi'] instanceof Parameter) {