fix(theming): deprecate OCA.Theming and move to capabilities

Signed-off-by: skjnldsv <skjnldsv@protonmail.com>

Author: skjnldsv

apps/theming/lib/Capabilities.php

@@ -8,6 +8,7 @@
 
 use OCA\Theming\AppInfo\Application;
 use OCA\Theming\Service\BackgroundService;
+use OCA\Theming\Service\ThemesService;
 use OCP\Capabilities\IPublicCapability;
 use OCP\IConfig;
 use OCP\IURLGenerator;
@@ -21,18 +22,13 @@
  */
 class Capabilities implements IPublicCapability {
 
-	/**
-	 * @param ThemingDefaults $theming
-	 * @param Util $util
-	 * @param IURLGenerator $url
-	 * @param IConfig $config
-	 */
 	public function __construct(
 		protected ThemingDefaults $theming,
 		protected Util $util,
 		protected IURLGenerator $url,
 		protected IConfig $config,
 		protected IUserSession $userSession,
+		protected ThemesService $themesService,
 	) {
 	}
 
@@ -44,6 +40,8 @@ public function __construct(
 	 *         name: string,
 	 *         productName: string,
 	 *         url: string,
+	 *         imprintUrl: string,
+	 *         privacyUrl: string,
 	 *         slogan: string,
 	 *         color: string,
 	 *         color-text: string,
@@ -57,6 +55,13 @@ public function __construct(
 	 *         background-default: bool,
 	 *         logoheader: string,
 	 *         favicon: string,
+	 *         primaryColor: string,
+	 *         backgroundColor: string,
+	 *         defaultPrimaryColor: string,
+	 *         defaultBackgroundColor: string,
+	 *         inverted: bool,
+	 *         cacheBuster: string,
+	 *         enabledThemes: list<string>,
 	 *     },
 	 * }
 	 */
@@ -98,6 +103,8 @@ public function getCapabilities() {
 				'name' => $this->theming->getName(),
 				'productName' => $this->theming->getProductName(),
 				'url' => $this->theming->getBaseUrl(),
+				'imprintUrl' => $this->theming->getImprintUrl(),
+				'privacyUrl' => $this->theming->getPrivacyUrl(),
 				'slogan' => $this->theming->getSlogan(),
 				'color' => $color,
 				'color-text' => $colorText,
@@ -111,6 +118,13 @@ public function getCapabilities() {
 				'background-default' => !$this->util->isBackgroundThemed(),
 				'logoheader' => $this->url->getAbsoluteURL($this->theming->getLogo()),
 				'favicon' => $this->url->getAbsoluteURL($this->theming->getLogo()),
+				'primaryColor' => $color,
+				'backgroundColor' => $backgroundColor,
+				'defaultPrimaryColor' => $this->theming->getDefaultColorPrimary(),
+				'defaultBackgroundColor' => $this->theming->getDefaultColorBackground(),
+				'inverted' => $this->util->invertTextColor($color),
+				'cacheBuster' => $this->util->getCacheBuster(),
+				'enabledThemes' => $this->themesService->getEnabledThemes(),
 			],
 		];
 	}

apps/theming/lib/Listener/BeforeTemplateRenderedListener.php

@@ -37,6 +37,7 @@ public function __construct(
 	public function handle(Event $event): void {
 		$this->initialState->provideLazyInitialState(
 			'data',
+			// @psalm-suppress DeprecatedClass - deprecated since 34
 			fn () => $this->container->get(JSDataService::class),
 		);
 

apps/theming/lib/Service/JSDataService.php

@@ -11,6 +11,9 @@
 use OCA\Theming\ThemingDefaults;
 use OCA\Theming\Util;
 
+/**
+ * @deprecated since Nextcloud 32 — all properties are now exposed via Capabilities
+ */
 class JSDataService implements \JsonSerializable {
 
 	public function __construct(
@@ -40,10 +43,6 @@ public function jsonSerialize(): array {
 
 			'cacheBuster' => $this->util->getCacheBuster(),
 			'enabledThemes' => $this->themesService->getEnabledThemes(),
-
-			// deprecated use primaryColor
-			'color' => $this->themingDefaults->getColorPrimary(),
-			'' => 'color is deprecated since Nextcloud 29, use primaryColor instead'
 		];
 	}
 }

apps/theming/openapi.json

@@ -81,6 +81,8 @@
                             "name",
                             "productName",
                             "url",
+                            "imprintUrl",
+                            "privacyUrl",
                             "slogan",
                             "color",
                             "color-text",
@@ -93,7 +95,14 @@
                             "background-plain",
                             "background-default",
                             "logoheader",
-                            "favicon"
+                            "favicon",
+                            "primaryColor",
+                            "backgroundColor",
+                            "defaultPrimaryColor",
+                            "defaultBackgroundColor",
+                            "inverted",
+                            "cacheBuster",
+                            "enabledThemes"
                         ],
                         "properties": {
                             "name": {
@@ -105,6 +114,12 @@
                             "url": {
                                 "type": "string"
                             },
+                            "imprintUrl": {
+                                "type": "string"
+                            },
+                            "privacyUrl": {
+                                "type": "string"
+                            },
                             "slogan": {
                                 "type": "string"
                             },
@@ -143,6 +158,30 @@
                             },
                             "favicon": {
                                 "type": "string"
+                            },
+                            "primaryColor": {
+                                "type": "string"
+                            },
+                            "backgroundColor": {
+                                "type": "string"
+                            },
+                            "defaultPrimaryColor": {
+                                "type": "string"
+                            },
+                            "defaultBackgroundColor": {
+                                "type": "string"
+                            },
+                            "inverted": {
+                                "type": "boolean"
+                            },
+                            "cacheBuster": {
+                                "type": "string"
+                            },
+                            "enabledThemes": {
+                                "type": "array",
+                                "items": {
+                                    "type": "string"
+                                }
                             }
                         }
                     }