labwc/include/common
stormshadow ba5a0b9829 feat: implement Openbox-style bottom window handle and grips
Add full handle/grip assembly to the bottom of SSD window frames,
following the Openbox themerc specification for geometry and theming.
Theme parsing:
- Parse window.handle.width (handle bar height, default 6)
- Parse window.grip.width (corner grip width, default 20)
- Parse window.[active|inactive].handle.bg with Solid/Gradient support
- Parse window.[active|inactive].grip.bg (inherits from handle if unset)
- Pre-render 1px-wide fill buffers and cairo patterns for handle/grip
Scene graph (new ssd-handle.c):
- Handle assembly replaces bottom border when active, with its own
  left/right/top borders and three-segment bottom border
- Grips at left/right corners for diagonal resize (sw/se-resize)
- Center handle for vertical resize (s-resize)
- Vertical separator lines between grips and handle using border color
- Per Openbox spec, handle_width is content-only height with borders
  drawn around it (total assembly height = 2*border_width + handle_width)
Interactive visual states (grips only):
- Hover: 20% black overlay on grip content area
- Pressed: 40% black overlay with 1px inset shadow (dark top/left,
  light bottom/right) for a pushed-in 3D effect
- Dragging: 20% overlay with inset shadow maintained
- Global hover tracking (server.hovered_handle_ssd/element) ensures
  proper cleanup when cursor moves across views or to desktop
Decoration toggle cycle (ToggleDecorations action):
- New LAB_SSD_MODE_BORDER_HANDLE between BORDER and FULL
- keepBorder=true: full -> border+handle -> border -> none -> full
- keepBorder=false: full -> none -> full (unchanged)
Node types and input:
- New LAB_NODE_HANDLE, LAB_NODE_GRIP_LEFT, LAB_NODE_GRIP_RIGHT
- Integrated into LAB_NODE_BORDER/BORDER_BOTTOM containment so
  existing Border context mousebinds (Resize) work automatically
- Handle/grip descriptors resolved directly in get_cursor_context()
  bypassing ssd_get_resizing_type() for precise cursor shapes
Visibility rules:
- Hidden when maximized, shaded, or handle_width is 0
- Hidden in LAB_SSD_MODE_BORDER and LAB_SSD_MODE_NONE states
- Bottom border in ssd-border.c disabled when handle is active
Documentation:
- labwc-theme.5.scd: document all handle/grip theme properties
- labwc-actions.5.scd: update ToggleDecorations to 4-state cycle
- docs/themerc: add handle/grip default values
2026-05-16 21:00:50 +05:30
..
array.h array: use die_if_null() from common/mem.c 2025-09-07 19:17:18 +09:00
border.h Move border-struct to common/border.h for sharing 2023-06-26 06:04:07 +01:00
box.h box: factor out box_center() 2025-12-02 14:57:41 +09:00
buf.h Don't remove newlines when parsing config, menu and XBM 2025-10-17 22:08:41 +09:00
dir.h config: support merging multiple config files 2024-01-18 20:20:36 +00:00
edge.h common: flesh out enum lab_edge and prefer over wlr_edges/wlr_direction 2025-08-26 20:36:43 -04:00
fd-util.h Replace _ with - in source file names 2024-05-22 07:10:51 +01:00
file-helpers.h common/file-helpers.c: share file_exists() to reduce duplication 2023-09-17 19:26:41 +01:00
font.h scaled-buffer: introduce scaled_font_buffer_update_markup() 2026-05-05 19:16:59 +01:00
graphic-helpers.h include: add missing header dependencies 2025-07-29 21:51:56 +01:00
lab-scene-rect.h Replace multi_rect with lab_scene_rect 2025-06-10 06:03:03 +09:00
list.h common/list: add WL_LIST_INIT() macro 2024-11-21 20:31:41 +00:00
macros.h common/macros: change WLR_VERSION macro to runtime evaluation 2026-05-07 06:24:30 +01:00
match.h docs: simplify description of shell wildcard patterns 2024-12-01 20:17:04 +01:00
mem.h array: use die_if_null() from common/mem.c 2025-09-07 19:17:18 +09:00
node-type.h feat: implement Openbox-style bottom window handle and grips 2026-05-16 21:00:50 +05:30
nodename.h include: reduce unnecessary #includes 2025-09-07 19:34:30 +09:00
parse-bool.h include: add config/types.h 2025-08-21 16:55:25 +09:00
parse-double.h common: validate and properly parse floats 2024-04-02 10:37:50 -04:00
scene-helpers.h tree-wide: use die_if_null() for wlr_scene alloc failures 2026-03-15 21:26:37 +00:00
set.h key-state.c: generalize set operations 2024-10-13 20:45:16 +01:00
spawn.h session: run activation env update synchronously 2026-04-29 19:45:01 +01:00
string-helpers.h string-helpers: update comments for str_equal() 2026-02-04 19:14:51 +09:00
xml.h include/common/xml.h: fix declaration/definition arg name difference 2025-09-30 02:38:13 +02:00