[Autocomplete] Triggered deprecation on getPropertyMetadata method + updated return doc

Author: evertharmeling

src/Autocomplete/composer.json

@@ -26,6 +26,7 @@
     "require": {
         "php": ">=8.1",
         "symfony/dependency-injection": "^6.3|^7.0",
+        "symfony/deprecation-contracts": "^2.5|^3",
         "symfony/http-foundation": "^6.3|^7.0",
         "symfony/http-kernel": "^6.3|^7.0",
         "symfony/property-access": "^6.3|^7.0",

src/Autocomplete/src/Doctrine/EntityMetadata.php

@@ -41,6 +41,21 @@ public function isEmbeddedClassProperty(string $propertyName): bool
         return \array_key_exists($propertyNameParts[0], $this->metadata->embeddedClasses);
     }
 
+    public function getPropertyMetadata(string $propertyName): array
+    {
+        trigger_deprecation('symfony/ux-autocomplete', '2.15.0', 'Calling EntityMetadata::getPropertyMetadata() is deprecated. You should stop using it, as it will be removed in the future.');
+
+        try {
+            return $this->getFieldMetadata($propertyName);
+        } catch (\InvalidArgumentException $e) {
+            return $this->getAssociationMetadata($propertyName);
+        }
+    }
+
+    /**
+     * @internal
+     * @return array<string, mixed>
+     */
     public function getFieldMetadata(string $propertyName): array
     {
         if (\array_key_exists($propertyName, $this->metadata->fieldMappings)) {
@@ -57,6 +72,10 @@ public function getFieldMetadata(string $propertyName): array
         throw new \InvalidArgumentException(sprintf('The "%s" field does not exist in the "%s" entity.', $propertyName, $this->metadata->getName()));
     }
 
+    /**
+     * @internal
+     * @return array<string, mixed>
+     */
     public function getAssociationMetadata(string $propertyName): array
     {
         if (\array_key_exists($propertyName, $this->metadata->associationMappings)) {