Fix medium code quality issues: RGB validation, type annotations (#557)

- Add RGB tuple length validation in _clamp_rgb_tuple (ValueError if
  not exactly 3 elements)
- Fix name_from_value return type: str -> str | None
- Fix device_ranges type annotation: dict[range] -> dict[str, tuple]

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

Author: JeffSteinbok

custom_components/dreo/pydreo/helpers.py

@@ -177,7 +177,7 @@ def api_timestamp() -> str:
         return str(int(time.time() * 1000))
 
     @staticmethod
-    def name_from_value(name_value_list : list[tuple], value) -> str:
+    def name_from_value(name_value_list : list[tuple], value) -> str | None:
         """Return name from list of tuples."""
         if not name_value_list:
             _LOGGER.error("Helpers::name_from_value - name_value_list is None")

custom_components/dreo/pydreo/models.py

@@ -54,7 +54,7 @@ class DreoDeviceDetails:
     preset_modes: list[str]
     """List of possible preset mode names"""
 
-    device_ranges: dict[range]
+    device_ranges: dict[str, tuple]
     """Dictionary of different ranges"""
 
     mode_names: list[str] | dict

custom_components/dreo/pydreo/pydreoceilingfan.py

@@ -32,6 +32,8 @@ class PyDreoCeilingFan(PyDreoFanBase):
     @staticmethod
     def _clamp_rgb_tuple(rgb: tuple) -> tuple[int, int, int]:
         """Clamp RGB tuple values to 0-255 integers."""
+        if len(rgb) != 3:
+            raise ValueError(f"RGB tuple must have exactly 3 elements, got {len(rgb)}")
         return tuple(max(0, min(255, int(round(c)))) for c in rgb)
 
     @staticmethod