docs: describe influence of take_over_control_mode on adapt_only_on_bare_turn_on

README.md

@@ -106,7 +106,7 @@ The YAML and frontend configuration methods support all of the options listed be
 <!-- OUTPUT:START -->
 <!-- ⚠️ This content is auto-generated by `markdown-code-runner`. -->
 | Variable name                  | Description                                                                                                                                                                                                                                                                                                                                                                                                                                         | Default        | Type                                    |
-|:-------------------------------|:-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|:---------------|:----------------------------------------|
+|:-------------------------------|:----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|:---------------|:----------------------------------------|
 | `lights`                       | List of light entity_ids to be controlled (may be empty). 🌟                                                                                                                                                                                                                                                                                                                                                                                         | `[]`           | list of `entity_id`s                    |
 | `interval`                     | Frequency to adapt the lights, in seconds. 🔄                                                                                                                                                                                                                                                                                                                                                                                                        | `90`           | `int > 0`                               |
 | `transition`                   | Duration of transition when lights change, in seconds. 🕑                                                                                                                                                                                                                                                                                                                                                                                            | `45`           | `float` 0-6553                          |
@@ -138,7 +138,7 @@ The YAML and frontend configuration methods support all of the options listed be
 | `detect_non_ha_changes`        | Detects and halts adaptations for non-`light.turn_on` state changes. Needs `take_over_control` enabled. 🕵️ Caution: ⚠️ Some lights might falsely indicate an 'on' state, which could result in lights turning on unexpectedly. Note that this calls `homeassistant.update_entity` every `interval`! Disable this feature if you encounter such issues.                                                                                              | `False`        | `bool`                                  |
 | `autoreset_control_seconds`    | Automatically reset the manual control after a number of seconds. Set to 0 to disable. ⏲️                                                                                                                                                                                                                                                                                                                                                           | `0`            | `int` 0-31536000                        |
 | `only_once`                    | Adapt lights only when they are turned on (`true`) or keep adapting them (`false`). 🔄                                                                                                                                                                                                                                                                                                                                                               | `False`        | `bool`                                  |
-| `adapt_only_on_bare_turn_on`   | When turning lights on initially. If set to `true`, AL adapts only if `light.turn_on` is invoked without specifying color or brightness. ❌🌈 This e.g., prevents adaptation when activating a scene. If `false`, AL adapts regardless of the presence of color or brightness in the initial `service_data`. Needs `take_over_control` enabled. 🕵️       | `False`        | `bool`                                  |
+| `adapt_only_on_bare_turn_on`   | When turning lights on initially. When `true`, AL adapts only if `light.turn_on` is called without color and brightness attributes. ❌🌈 This e.g., prevents adaptation when activating a scene. If `take_over_control_mode` is `pause_changed`, AL will still adapt attributes that were not specified. If `false`, AL adapts regardless of the presence of color or brightness in the initial `service_data`. Needs `take_over_control` enabled. 🕵️ | `False`        | `bool`                                  |
 | `separate_turn_on_commands`    | Use separate `light.turn_on` calls for color and brightness, needed for some light types. 🔀                                                                                                                                                                                                                                                                                                                                                         | `False`        | `bool`                                  |
 | `send_split_delay`             | Delay (ms) between `separate_turn_on_commands` for lights that don't support simultaneous brightness and color setting. ⏲️                                                                                                                                                                                                                                                                                                                          | `0`            | `int` 0-10000                           |
 | `adapt_delay`                  | Wait time (seconds) between light turn on and Adaptive Lighting applying changes. Might help to avoid flickering. ⏲️                                                                                                                                                                                                                                                                                                                                | `0`            | `float > 0`                             |

custom_components/adaptive_lighting/const.py

@@ -93,9 +93,10 @@ CONF_ADAPT_ONLY_ON_BARE_TURN_ON, DEFAULT_ADAPT_ONLY_ON_BARE_TURN_ON = (
     False,
 )
 DOCS[CONF_ADAPT_ONLY_ON_BARE_TURN_ON] = (
-    "When turning lights on initially. If set to `true`, AL adapts only if `light.turn_on` is "
+    "When turning lights on initially. When `true`, AL adapts only if `light.turn_on` is "
-    "invoked without specifying color or brightness. ❌🌈 "
+    "called without color and brightness attributes. ❌🌈 "
     "This e.g., prevents adaptation when activating a scene. "
+    "If `take_over_control_mode` is `pause_changed`, AL will still adapt attributes that were not specified. "
     "If `false`, AL adapts regardless of the presence of color or brightness in the initial `service_data`. "
     "Needs `take_over_control` enabled. 🕵️"
 )

custom_components/adaptive_lighting/strings.json

@@ -57,7 +57,7 @@
           "detect_non_ha_changes": "detect_non_ha_changes: Detects and halts adaptations for non-`light.turn_on` state changes. Needs `take_over_control` enabled. 🕵️ Caution: ⚠️ Some lights might falsely indicate an 'on' state, which could result in lights turning on unexpectedly. Note that this calls `homeassistant.update_entity` every `interval`! Disable this feature if you encounter such issues.",
           "autoreset_control_seconds": "autoreset_control_seconds",
           "only_once": "only_once: Adapt lights only when they are turned on (`true`) or keep adapting them (`false`). 🔄",
-          "adapt_only_on_bare_turn_on": "adapt_only_on_bare_turn_on: When turning lights on initially. If set to `true`, AL adapts only if `light.turn_on` is invoked without specifying color or brightness. ❌🌈 This e.g., prevents adaptation when activating a scene. If `false`, AL adapts regardless of the presence of color or brightness in the initial `service_data`. Needs `take_over_control` enabled. 🕵️",
+          "adapt_only_on_bare_turn_on": "adapt_only_on_bare_turn_on: When turning lights on initially. When `true`, AL adapts only if `light.turn_on` is called without color and brightness attributes. ❌🌈 This e.g., prevents adaptation when activating a scene. If `take_over_control_mode` is `pause_changed`, AL will still adapt attributes that were not specified. If `false`, AL adapts regardless of the presence of color or brightness in the initial `service_data`. Needs `take_over_control` enabled. 🕵️",
           "separate_turn_on_commands": "separate_turn_on_commands: Use separate `light.turn_on` calls for color and brightness, needed for some light types. 🔀",
           "send_split_delay": "send_split_delay",
           "adapt_delay": "adapt_delay",

custom_components/adaptive_lighting/translations/en.json

@@ -58,7 +58,7 @@
           "detect_non_ha_changes": "detect_non_ha_changes: Detects and halts adaptations for non-`light.turn_on` state changes. Needs `take_over_control` enabled. 🕵️ Caution: ⚠️ Some lights might falsely indicate an 'on' state, which could result in lights turning on unexpectedly. Note that this calls `homeassistant.update_entity` every `interval`! Disable this feature if you encounter such issues.",
           "autoreset_control_seconds": "autoreset_control_seconds",
           "only_once": "only_once: Adapt lights only when they are turned on (`true`) or keep adapting them (`false`). 🔄",
-          "adapt_only_on_bare_turn_on": "adapt_only_on_bare_turn_on: When turning lights on initially. If set to `true`, AL adapts only if `light.turn_on` is invoked without specifying color or brightness. ❌🌈 This e.g., prevents adaptation when activating a scene. If `false`, AL adapts regardless of the presence of color or brightness in the initial `service_data`. Needs `take_over_control` enabled. 🕵️",
+          "adapt_only_on_bare_turn_on": "adapt_only_on_bare_turn_on: When turning lights on initially. When `true`, AL adapts only if `light.turn_on` is called without color and brightness attributes. ❌🌈 This e.g., prevents adaptation when activating a scene. If `take_over_control_mode` is `pause_changed`, AL will still adapt attributes that were not specified. If `false`, AL adapts regardless of the presence of color or brightness in the initial `service_data`. Needs `take_over_control` enabled. 🕵️",
           "separate_turn_on_commands": "separate_turn_on_commands: Use separate `light.turn_on` calls for color and brightness, needed for some light types. 🔀",
           "send_split_delay": "send_split_delay",
           "adapt_delay": "adapt_delay",