Add brightness control to Key Colors targets with HAOS integration

Adds brightness (0.0-1.0) to KeyColorsSettings, applies scaling in the
KC processing pipeline after smoothing, exposes a slider on the WebUI
target card, and creates a HA number entity for KC target brightness.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

custom_components/wled_screen_controller/number.py

@@ -1,4 +1,4 @@
-"""Number platform for LED Screen Controller (device brightness)."""
+"""Number platform for LED Screen Controller (device & KC target brightness)."""
 from __future__ import annotations
 
 import logging
@@ -32,15 +32,20 @@ async def async_setup_entry(
         for target_id, target_data in coordinator.data["targets"].items():
             info = target_data["info"]
 
-            # Only LED targets have a device_id
             if info.get("target_type") == TARGET_TYPE_KEY_COLORS:
+                # KC target — brightness lives in key_colors_settings
+                entities.append(
+                    WLEDScreenControllerKCBrightness(
+                        coordinator, target_id, entry.entry_id,
+                    )
+                )
                 continue
 
+            # LED target — brightness lives on the device
             device_id = info.get("device_id", "")
             if not device_id:
                 continue
 
-            # Check if the device supports brightness control
             device_data = devices.get(device_id)
             if not device_data:
                 continue
@@ -110,3 +115,55 @@ class WLEDScreenControllerBrightness(CoordinatorEntity, NumberEntity):
     async def async_set_native_value(self, value: float) -> None:
         """Set brightness value."""
         await self.coordinator.set_brightness(self._device_id, int(value))
+
+
+class WLEDScreenControllerKCBrightness(CoordinatorEntity, NumberEntity):
+    """Brightness control for a Key Colors target."""
+
+    _attr_has_entity_name = True
+    _attr_native_min_value = 0
+    _attr_native_max_value = 255
+    _attr_native_step = 1
+    _attr_mode = NumberMode.SLIDER
+    _attr_icon = "mdi:brightness-6"
+
+    def __init__(
+        self,
+        coordinator: WLEDScreenControllerCoordinator,
+        target_id: str,
+        entry_id: str,
+    ) -> None:
+        """Initialize the KC brightness number."""
+        super().__init__(coordinator)
+        self._target_id = target_id
+        self._entry_id = entry_id
+        self._attr_unique_id = f"{target_id}_brightness"
+        self._attr_translation_key = "brightness"
+
+    @property
+    def device_info(self) -> dict[str, Any]:
+        """Return device information."""
+        return {"identifiers": {(DOMAIN, self._target_id)}}
+
+    @property
+    def native_value(self) -> float | None:
+        """Return the current brightness value (0-255)."""
+        if not self.coordinator.data:
+            return None
+        target_data = self.coordinator.data.get("targets", {}).get(self._target_id)
+        if not target_data:
+            return None
+        kc_settings = target_data.get("info", {}).get("key_colors_settings") or {}
+        brightness_float = kc_settings.get("brightness", 1.0)
+        return round(brightness_float * 255)
+
+    @property
+    def available(self) -> bool:
+        """Return if entity is available."""
+        if not self.coordinator.data:
+            return False
+        return self._target_id in self.coordinator.data.get("targets", {})
+
+    async def async_set_native_value(self, value: float) -> None:
+        """Set brightness value."""
+        await self.coordinator.set_kc_brightness(self._target_id, int(value))