From d070b5e312f8177cab83597e909a726a52eb83bd Mon Sep 17 00:00:00 2001
From: Javier Peletier <jm@epiclabs.io>
Date: Fri, 24 Oct 2025 20:59:00 +0200
Subject: [PATCH] Document additional extend/remove supported behavior

---
 content/components/packages.md | 39 ++++++++++++++++++++++++++++++++++
 1 file changed, 39 insertions(+)

diff --git a/content/components/packages.md b/content/components/packages.md
index 20af5a6aa3..601c85649c 100644
--- a/content/components/packages.md
+++ b/content/components/packages.md
@@ -194,6 +194,32 @@ sensor:
     update_interval: 10s
 ```
 
+LVGL-style configuration hierarchies are also supported:
+
+```yaml
+# In interface.yaml
+lvgl:
+  pages:
+    - id: main_page
+      widgets:
+        - label:
+            id: title_label
+            text: "Main Page"
+```
+
+```yaml
+packages:
+  - !include interface.yaml
+lvgl:
+  pages:
+    - id: !extend main_page
+      widgets:
+        - label:
+            id: !extend title_label
+            text: "New Title"
+            text_color: red
+```
+
 `!extend` also works with substitutions and jinja:
 
 ```yaml
@@ -235,6 +261,19 @@ sensor:
   - id: !remove uptime_sensor
 ```
 
+Remove an item in a LVGL-style configuration:
+
+```yaml
+packages:
+  - !include interface.yaml # see above
+lvgl:
+  pages:
+    - id: !extend main_page
+      widgets:
+        - label:
+            id: !remove title_label
+```
+
 To remove captive portal for a specific device:
 
 ```yaml