From fc5b3788ba994415dbe548cf341741fcd357c856 Mon Sep 17 00:00:00 2001
From: "Andrew J. Hesford" <ajh@sideband.org>
Date: Mon, 15 Jan 2024 11:08:50 -0500
Subject: [PATCH] squash! [wip] Add ToggleShade

Add default mouse bindings, document actions
---
 docs/labwc-actions.5.scd | 9 +++++++++
 docs/rc.xml.all          | 8 ++++++++
 src/config/rcxml.c       | 4 ++++
 3 files changed, 21 insertions(+)

diff --git a/docs/labwc-actions.5.scd b/docs/labwc-actions.5.scd
index cad047bf..69ca8373 100644
--- a/docs/labwc-actions.5.scd
+++ b/docs/labwc-actions.5.scd
@@ -226,6 +226,15 @@ Actions are used in menus and keyboard/mouse bindings.
 	Use the automatic placement policy to move the active window to a
 	position on its output that will minimize overlap with other windows.
 
+*<action name="Shade" />*++
+*<action name="Unshade" />*++
+*<action name="ToggleShade" />*
+	Set, unset, or toggle, respectively, the "shaded" state of the active
+	window. When shaded, window contents are hidden, leaving only the
+	titlebar visible. Full-screen windows or those without server-side
+	decorations (including those for which the server-side titlebar has been
+	hidden) are not eligible for shading.
+
 *<action name="None" />*
 	If used as the only action for a binding: clear an earlier defined binding.
 
diff --git a/docs/rc.xml.all b/docs/rc.xml.all
index b498b953..29130b2f 100644
--- a/docs/rc.xml.all
+++ b/docs/rc.xml.all
@@ -312,6 +312,14 @@
         <action name="Focus" />
         <action name="Raise" />
       </mousebind>
+      <mousebind direction="Up" action="Scroll">
+        <action name="Unshade" />
+        <action name="Focus" />
+      </mousebind>
+      <mousebind direction="Down" action="Scroll">
+        <action name="Unfocus" />
+        <action name="Shade" />
+      </mousebind>
     </context>
 
     <context name="Title">
diff --git a/src/config/rcxml.c b/src/config/rcxml.c
index 2028556e..02b3d4d1 100644
--- a/src/config/rcxml.c
+++ b/src/config/rcxml.c
@@ -1162,6 +1162,10 @@ static struct mouse_combos {
 	{ "Frame", "A-Right", "Drag", "Resize", NULL, NULL},
 	{ "Titlebar", "Left", "Press", "Focus", NULL, NULL},
 	{ "Titlebar", "Left", "Press", "Raise", NULL, NULL},
+	{ "Titlebar", "Up", "Scroll", "Unfocus", NULL, NULL},
+	{ "Titlebar", "Up", "Scroll", "Shade", NULL, NULL},
+	{ "Titlebar", "Down", "Scroll", "Unshade", NULL, NULL},
+	{ "Titlebar", "Down", "Scroll", "Focus", NULL, NULL},
 	{ "Title", "Left", "Drag", "Move", NULL, NULL },
 	{ "Title", "Left", "DoubleClick", "ToggleMaximize", NULL, NULL },
 	{ "TitleBar", "Right", "Click", "Focus", NULL, NULL},