docs(decorated-window): document reactive GNOME titlebar button layout support

- Add details on observing `button-layout` changes via GSettings to runtime and changelog documentation.
- Explain reactive updates, supported configurations, and fallback behavior for KDE and other environments.
- Include Kotlin usage example for `rememberLinuxButtonLayout()`.

Author: kdroidFilter

docs/changelog.md

@@ -1,5 +1,19 @@
 # Changelog
 
+## v1.11.0
+
+**Released: 2026-04-13**
+
+### New Features
+
+- **GNOME titlebar button layout support** — Decorated windows on Linux now read the system `button-layout` GSettings key to determine which buttons to show (close, minimize, maximize) and on which side (left or right). The layout updates reactively when the user changes it in GNOME Tweaks or via `gsettings set`. Falls back to the default layout on KDE and other desktop environments.
+
+### Documentation
+
+- **GraalVM status updated to alpha** — GraalVM Native Image support is now labeled "alpha" instead of "experimental", reflecting the improved out-of-the-box experience with centralized reachability metadata
+
+---
+
 ## v1.10.0
 
 **Released: 2026-04-12**

docs/runtime/decorated-window.md

@@ -194,6 +194,7 @@ The following tables compare a standard Compose `Window()`, the JBR module (`dec
 | Custom title bar content | No | Yes (fully undecorated) | Yes (fully undecorated) |
 | Window controls | WM-provided | Compose `WindowControlArea` (SVG) | Compose `WindowControlArea` (SVG) |
 | Desktop environment styling | WM-provided | GNOME Adwaita / KDE Breeze icons | GNOME Adwaita / KDE Breeze icons |
+| System button layout | WM-provided | Reactive (GSettings observer) | Reactive (GSettings observer) |
 | Window shape | WM-provided | Rounded corners (GNOME 12dp, KDE 5dp top only) | Rounded corners (GNOME 12dp, KDE 5dp top only) |
 | Title bar drag | WM-provided | `JBR.getWindowMove()` | `_NET_WM_MOVERESIZE` via JNI or Compose fallback |
 | Double-click maximize | WM-provided | Compose detection | Compose detection |
@@ -687,3 +688,26 @@ On Linux, the module detects the current desktop environment and loads the appro
 - **Other** — Falls back to GNOME style
 
 Detection uses `XDG_CURRENT_DESKTOP` and `DESKTOP_SESSION` environment variables.
+
+### System Button Layout
+
+On GNOME, the module reads the `org.gnome.desktop.wm.preferences` → `button-layout` GSettings key to determine which titlebar buttons to display and on which side. This is done via `libgio` (`dlopen`, no hard compile-time dependency).
+
+The layout updates **reactively** — if the user changes the button configuration in GNOME Tweaks (or via `gsettings set`), the title bar updates in real time without restarting the application.
+
+Supported configurations include:
+
+- `:minimize,maximize,close` — right side, all buttons (GNOME with tweaks)
+- `close,minimize,maximize:` — left side, Ubuntu style
+- `appmenu:close` — right side, close only (GNOME default)
+
+On **KDE** and other desktop environments, the module falls back to the default layout (close, maximize, minimize on the right).
+
+If you need the layout value directly (e.g. for custom rendering), use the `rememberLinuxButtonLayout()` composable:
+
+```kotlin
+val layout = rememberLinuxButtonLayout()
+// layout.buttons — ordered list of visible buttons
+// layout.controlsOnRight — true if buttons are on the right side
+// layout.hasClose / layout.hasMinimize / layout.hasMaximize
+```