From e89d61d37bf47033dec16b922a98b557546f6ddb Mon Sep 17 00:00:00 2001
From: Adrien Dupuis <61695653+adriendupuis@users.noreply.github.com>
Date: Fri, 22 Aug 2025 15:02:23 +0200
Subject: [PATCH] Update Provider.php

---
 src/contracts/UniversalDiscovery/Provider.php | 25 ++++++++++++++++---
 1 file changed, 22 insertions(+), 3 deletions(-)

diff --git a/src/contracts/UniversalDiscovery/Provider.php b/src/contracts/UniversalDiscovery/Provider.php
index 64f7cf80aa..b4b9f70e16 100644
--- a/src/contracts/UniversalDiscovery/Provider.php
+++ b/src/contracts/UniversalDiscovery/Provider.php
@@ -83,9 +83,28 @@ public function getLocationGridViewData(
     ): array;
 
     /**
-     * @param list<string> $locationIds
-     *
-     * @return array<array{
+     * Get list of (@see \Ibexa\Contracts\Core\Repository\Values\Content\Location locations} with their permissions.
+     * 
+     * Returns a indexed array of hashes with the following structure:
+     * ```
+     * [
+     *     [
+     *         'location' => (@see \Ibexa\Contracts\Core\Repository\Values\Content\Location],
+     *         'permissions' => [
+     *             'create' => [
+     *                 'hasAccess' => bool true/false,
+     *                 'restrictedContentTypeIds' => [1, 2, 3]
+     *             ],
+     *             'edit' => [],
+     *         ],
+     *     ],
+     * ]
+     * ```
+     * 
+     * @param array<int, string> $locationIds
+     * 
+     * @return array<int, array> An array of assiative arrays with "location" and "permissions" keys
+     * @phpstan-return array<array{
      *     location: \Ibexa\Contracts\Core\Repository\Values\Content\Location,
      *     permissions: array{
      *       create: array{