Implement collapsible sections for options flow (#1313)

* Implement collapsible sections for options flow

Replace single-form options flow with collapsible sections:
- Basic options always visible (9 fields)
- Advanced options in collapsed section (collapsed by default)
- Single form, no multi-step navigation needed

Changes:
- const.py: Add BASIC_OPTIONS set defining which options are basic
- config_flow.py: Use section() from data_entry_flow to wrap advanced options
- strings.json: Restructure with sections.advanced for section translations
- tests: Update to handle nested section input format

* Update README.md, strings.json, and services.yaml

* Fix: Use vol.Required for section to render properly

* Fix section structure: separate basic and advanced fields in strings.json

* Remove accidentally added files

* Add local directories to gitignore

* Update README.md, strings.json, and services.yaml

* Preserve options behavior with collapsible sections

* Test serialized advanced options section

* fix: preserve config metadata when retrying options

* fix: keep options form defaults serializable

---------

Co-authored-by: github-actions[bot] <github-actions[bot]@users.noreply.github.com>

.github/update-strings.py

@@ -2,6 +2,7 @@
 
 import json
 import sys
+from copy import deepcopy
 from pathlib import Path
 
 import homeassistant.helpers.config_validation as cv
@@ -14,9 +15,35 @@ from custom_components.adaptive_lighting import const
 folder = Path("custom_components") / "adaptive_lighting"
 strings_fname = folder / "strings.json"
 en_fname = folder / "translations" / "en.json"
+translation_fnames = (folder / "translations").glob("*.json")
 with strings_fname.open() as f:
     strings = json.load(f)
 
+
+def _partition_options(values):
+    """Partition option translations into basic and advanced dictionaries."""
+    basic = {
+        key: values[key]
+        for key, _, _ in const.VALIDATION_TUPLES
+        if key in const.BASIC_OPTIONS and key in values
+    }
+    advanced = {
+        key: values[key]
+        for key, _, _ in const.VALIDATION_TUPLES
+        if key not in const.BASIC_OPTIONS and key in values
+    }
+    return basic, advanced
+
+
+def _migrate_translation_options(step):
+    """Move translated advanced options under the advanced section."""
+    sections = step.setdefault("sections", {})
+    advanced = sections.setdefault("advanced", {})
+    for key in ("data", "data_description"):
+        values = {**advanced.get(key, {}), **step.get(key, {})}
+        step[key], advanced[key] = _partition_options(values)
+
+
 # Set "options"
 data = {}
 data_description = {}
@@ -27,8 +54,19 @@ for k, _, typ in const.VALIDATION_TUPLES:
         data_description[k] = desc
     else:
         data[k] = f"{k}: {desc}"
-strings["options"]["step"]["init"]["data"] = data
-strings["options"]["step"]["init"]["data_description"] = data_description
+basic_data, advanced_data = _partition_options(data)
+basic_descriptions, advanced_descriptions = _partition_options(data_description)
+options_step = strings["options"]["step"]["init"]
+options_step["data"] = basic_data
+options_step["data_description"] = basic_descriptions
+options_step["sections"] = {
+    "advanced": {
+        "name": "Advanced settings",
+        "description": "Additional settings for fine-tuning Adaptive Lighting.",
+        "data": advanced_data,
+        "data_description": advanced_descriptions,
+    },
+}
 
 # Set "services"
 services_filename = Path("custom_components") / "adaptive_lighting" / "services.yaml"
@@ -58,13 +96,22 @@ with en_fname.open() as f:
     en = json.load(f)
 
 en["config"]["step"]["user"] = strings["config"]["step"]["user"]
-en["options"]["step"]["init"]["data"] = data
-en["options"]["step"]["init"]["data_description"] = data_description
-en["options"]["step"]["init"]["description"] = strings["options"]["step"]["init"][
-    "description"
-]
+en["options"]["step"]["init"] = deepcopy(options_step)
 en["services"] = services_json
 
 with en_fname.open("w") as f:
     json.dump(en, f, indent=2, ensure_ascii=False)
     f.write("\n")
+
+# Keep translated labels and descriptions when moving advanced options into a section.
+for translation_fname in translation_fnames:
+    if translation_fname == en_fname:
+        continue
+    with translation_fname.open() as f:
+        translation = json.load(f)
+    if "options" not in translation:
+        continue
+    _migrate_translation_options(translation["options"]["step"]["init"])
+    with translation_fname.open("w") as f:
+        json.dump(translation, f, indent=2, ensure_ascii=False)
+        f.write("\n")