Merge pull request #39057 from nextcloud/feat/ocp/type-icapabilities

feat(ocp): More specific type for ICapabilities::getCapabilities

apps/cloud_federation_api/lib/Capabilities.php

@@ -36,9 +36,6 @@ class Capabilities implements ICapability {
 
 	/**
 	 * Function an app uses to return the capabilities
-	 *
-	 * @return array Array containing the apps capabilities
-	 * @since 8.2.0
 	 */
 	public function getCapabilities() {
 		$url = $this->urlGenerator->linkToRouteAbsolute('cloud_federation_api.requesthandlercontroller.addShare');

apps/files/lib/Capabilities.php

@@ -38,8 +38,6 @@ class Capabilities implements ICapability {
 
 	/**
 	 * Return this classes capabilities
-	 *
-	 * @return array
 	 */
 	public function getCapabilities() {
 		return [

apps/files_sharing/lib/Capabilities.php

@@ -50,8 +50,6 @@ class Capabilities implements ICapability {
 
 	/**
 	 * Return this classes capabilities
-	 *
-	 * @return array
 	 */
 	public function getCapabilities() {
 		$res = [];

apps/files_trashbin/lib/Capabilities.php

@@ -33,8 +33,6 @@ class Capabilities implements ICapability {
 
 	/**
 	 * Return this classes capabilities
-	 *
-	 * @return array
 	 */
 	public function getCapabilities() {
 		return [

apps/files_versions/lib/Capabilities.php

@@ -42,8 +42,6 @@ class Capabilities implements ICapability {
 
 	/**
 	 * Return this classes capabilities
-	 *
-	 * @return array
 	 */
 	public function getCapabilities() {
 		$groupFolderInstalled = $this->appManager->isInstalled('groupfolders');

apps/provisioning_api/lib/Capabilities.php

@@ -37,8 +37,6 @@ class Capabilities implements ICapability {
 
 	/**
 	 * Function an app uses to return the capabilities
-	 *
-	 * @return array Array containing the apps capabilities
 	 */
 	public function getCapabilities() {
 		$federatedScopeEnabled = $this->appManager->isEnabledForUser('federation');

apps/theming/lib/Capabilities.php

@@ -64,8 +64,6 @@ class Capabilities implements IPublicCapability {
 
 	/**
 	 * Return this classes capabilities
-	 *
-	 * @return array
 	 */
 	public function getCapabilities() {
 		$backgroundLogo = $this->config->getAppValue('theming', 'backgroundMime', '');

apps/user_status/lib/Capabilities.php

@@ -40,9 +40,6 @@ class Capabilities implements ICapability {
 		$this->emojiHelper = $emojiHelper;
 	}
 
-	/**
-	 * @inheritDoc
-	 */
 	public function getCapabilities() {
 		return [
 			'user_status' => [

apps/weather_status/lib/Capabilities.php

@@ -43,9 +43,6 @@ class Capabilities implements ICapability {
 	public function __construct() {
 	}
 
-	/**
-	 * @inheritDoc
-	 */
 	public function getCapabilities() {
 		return [
 			Application::APP_ID => [

lib/private/OCS/CoreCapabilities.php

@@ -44,8 +44,6 @@ class CoreCapabilities implements ICapability {
 
 	/**
 	 * Return this classes capabilities
-	 *
-	 * @return array
 	 */
 	public function getCapabilities() {
 		return [

lib/public/Capabilities/ICapability.php

@@ -25,11 +25,8 @@ namespace OCP\Capabilities;
  * Minimal interface that has to be implemented for a class to be considered
  * a capability.
  *
- * In an application use:
- *   $this->getContainer()->registerCapability('OCA\MY_APP\Capabilities');
- * To register capabilities.
- *
- * The class 'OCA\MY_APP\Capabilities' must then implement ICapability
+ * In an application use \OCP\AppFramework\Bootstrap\IRegistrationContext::registerCapability
+ * to register capabilities.
  *
  * @since 8.2.0
  */
@@ -37,7 +34,19 @@ interface ICapability {
 	/**
 	 * Function an app uses to return the capabilities
 	 *
-	 * @return array Array containing the apps capabilities
+	 * ```php
+	 * return [
+	 *     'myapp' => [
+	 *         'awesomefeature' => true,
+	 *         'featureversion' => 3,
+	 *     ],
+	 *     'morecomplex' => [
+	 *         'a' => [1, 2],
+	 *     ],
+	 * ];
+	 * ```
+	 *
+	 * @return array<string, array<string, mixed>> Indexed array containing the app's capabilities
 	 * @since 8.2.0
 	 */
 	public function getCapabilities();