From 6c1dfe191843ad56aaa0381e5645ad9e74c38b8b Mon Sep 17 00:00:00 2001
From: srdusr <99972264+srdusr@users.noreply.github.com>
Date: Fri, 17 Jan 2025 23:01:00 +0200
Subject: Accumulate config engine, build metadata, and doc updates

Remaining files from the backlog: Lua config engine
additions (general/register/support/window), workspace Cargo.toml/
Cargo.lock churn from the new dependencies added elsewhere in this
sweep, srdwm/main.rs wiring, and docs (DEFAULTS.md plus a new
SESSION_HANDOFF.md written mid-session for continuity across a restart
- see that file's own header for what it is and isn't).
---
 docs/DEFAULTS.md | 18 ++++++++++++++++--
 1 file changed, 16 insertions(+), 2 deletions(-)

(limited to 'docs/DEFAULTS.md')

diff --git a/docs/DEFAULTS.md b/docs/DEFAULTS.md
index 4b4e195..68d3839 100644
--- a/docs/DEFAULTS.md
+++ b/docs/DEFAULTS.md
@@ -153,6 +153,7 @@ srd.theme.set_colors({
 srd.theme.set_decorations({
     border = {
         width = 2,                                      -- Default: 2
+        radius = 6,                                      -- Default: 6 (corner radius, logical px)
         active_color = "#88c0d0",                       -- Default: Nord blue
         inactive_color = "#2e3440",                     -- Default: Nord dark
         focused_style = "solid",                        -- Default: "solid"
@@ -164,7 +165,20 @@ srd.theme.set_decorations({
         font = "JetBrains Mono 10",                     -- Default: "JetBrains Mono 10"
         background = "#2e3440",                         -- Default: Nord dark
         foreground = "#eceff4"                          -- Default: Nord light
-    }
+    },
+    - Which decoration mode a window gets before any per-window rule or
+    - the window's own `xdg-decoration` request has a say. "server"
+    - (default): srdwm draws its own titlebar for anything that doesn't
+    - ask otherwise - consistent Windows/macOS-style chrome, and KDE/
+    - KWin's own choice too. "client": srdwm steps back by default and
+    - lets every window draw its own chrome (GNOME/Mutter's approach) --
+    - a window with no titlebar opinion of its own then gets no titlebar
+    - at all. A client that explicitly requests a mode is always honored
+    - either way; this only decides what a client with *no* preference
+    - ends up with. Also live-settable without a config reload/restart:
+    - `srd set decoration_mode server` / `srd set decoration_mode client`
+    - (affects windows created after the call, not already-open ones).
+    default_mode = "server"                             -- Default: "server"
 })
 ```
 
@@ -217,7 +231,7 @@ srd.rule(matcher, actions)
 - `x`, `y`, `width`, `height` (number) - explicit geometry; all four must be
   given together to take effect
 - `decorated` (bool)
-- `border_color` (`{r, g, b}`), `border_width` (number)
+- `border_color` (`{r, g, b}`), `border_width` (number), `corner_radius` (number)
 - `pinned` (bool) - always-on-top
 - `opacity` (number, `0.0`..=`1.0`) - content opacity; srdwm's own
   titlebar/border/shadow always stay fully opaque regardless
-- 
cgit v1.2.3