Add set_dimming_delta method

This method sets the brightness_delta value and its action based on the
value to up/down/stop. This can be useful if someone wants to dim a light to
the max/min value within a dedicated transition time but stop the
transition  when for instance a btn was released.

Author: olsen-sorensen

aiohue/v2/controllers/groups.py

@@ -9,7 +9,9 @@
     ColorFeaturePut,
     ColorPoint,
     ColorTemperatureFeaturePut,
+    DeltaAction,
     DimmingFeaturePut,
+    DimmingDeltaFeaturePut,
     DynamicsFeaturePut,
     OnFeature,
 )
@@ -142,6 +144,23 @@ async def set_state(
 
         await self.update(id, update_obj)
 
+    async def set_dimming_delta(
+        self, id: str, brightness_delta: float | None = None
+    ) -> None:
+        """
+        Set brightness_delta value and action via DimmingDeltaFeature.
+
+        The action to be send depends on brightness_delta value:
+         > 0: UP,
+         < 0: DOWN,
+         else: STOP (this immediately stops any dimming transition)
+        """
+        if brightness_delta is not None:
+            update_obj = GroupedLightPut()
+            action = DeltaAction.DOWN if brightness_delta < 0 else DeltaAction.UP if brightness_delta > 0 else DeltaAction.STOP
+            update_obj.dimming_delta = DimmingDeltaFeaturePut(action=action, brightness_delta=brightness_delta)
+            await self.update(id, update_obj)
+
 
 class GroupsController(GroupedControllerBase[Union[Room, Zone, GroupedLight]]):  # noqa: UP007
     """Controller grouping resources of both room and zone."""

aiohue/v2/controllers/lights.py

@@ -6,7 +6,9 @@
     ColorFeaturePut,
     ColorPoint,
     ColorTemperatureFeaturePut,
+    DeltaAction,
     DimmingFeaturePut,
+    DimmingDeltaFeaturePut,
     DynamicsFeaturePut,
     EffectsFeaturePut,
     EffectStatus,
@@ -100,3 +102,20 @@ async def set_state(
         elif effect is not None:
             update_obj.effects = EffectsFeaturePut(effect=effect)
         await self.update(id, update_obj)
+
+    async def set_dimming_delta(
+        self, id: str, brightness_delta: float | None = None
+    ) -> None:
+        """
+        Set brightness_delta value and action via DimmingDeltaFeature.
+
+        The action to be send depends on brightness_delta value:
+         > 0: UP,
+         < 0: DOWN,
+         else: STOP (this immediately stops any dimming transition)
+        """
+        if brightness_delta is not None:
+            update_obj = LightPut()
+            action = DeltaAction.DOWN if brightness_delta < 0 else DeltaAction.UP if brightness_delta > 0 else DeltaAction.STOP
+            update_obj.dimming_delta = DimmingDeltaFeaturePut(action=action, brightness_delta=brightness_delta)
+            await self.update(id, update_obj)