From 8b5e438d787ff73c3344b4c5ea1141cf8b23ef69 Mon Sep 17 00:00:00 2001
From: Craig Jennings <c@cjennings.net>
Date: Mon, 24 Aug 2026 14:27:57 -0600
Subject: chore: stage the Hyprland Lua port with its redeploy kit
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Hyprland 0.57 drops the .conf format. The port is built and measured identical to the current config in a nested compositor — 38 settings, 103 binds, the host-override chain — but it is not deployed. I put it live this afternoon and took it back out the same hour, because it had not been run on real hardware and the machine has to stay usable until it has.

working/hyprland-lua-port/ carries what the switch needs, including the two reader changes as replayable patches. Those matter more than the config itself: four things read hyprland.conf as a source of truth, and dotfiles-validate globs hypr/*.conf, so with the .conf gone it finds nothing and reports a clean tree.

Two facts not worth re-deriving: with both files present 0.56.2 loads the .lua, so keeping the .conf beside it buys no rollback; and a running compositor rewrites a stub config within a second of the file vanishing, which is what fights a restow.

Also archives finished tasks and folds in several sessions of task-review edits.
---
 working/hyprland-lua-port/velox-local.lua | 64 +++++++++++++++++++++++++++++++
 1 file changed, 64 insertions(+)
 create mode 100644 working/hyprland-lua-port/velox-local.lua

(limited to 'working/hyprland-lua-port/velox-local.lua')

diff --git a/working/hyprland-lua-port/velox-local.lua b/working/hyprland-lua-port/velox-local.lua
new file mode 100644
index 0000000..1da7359
--- /dev/null
+++ b/working/hyprland-lua-port/velox-local.lua
@@ -0,0 +1,64 @@
+-- velox — Framework 13, HiDPI 2256x1504. Sourced via conf.d/*.lua glob;
+-- values here override hyprland.lua (last wins).
+
+hl.monitor({
+    output = "eDP-1",
+    mode = "preferred",
+    position = "auto",
+    scale = "1.566667",
+})
+
+-- Scaling on this panel comes from the compositor alone.
+--
+-- There used to be `env = GDK_SCALE,1.5` and `env = QT_SCALE_FACTOR,1.5` here,
+-- to compensate for `xwayland:force_zero_scaling = true` in hyprland.lua, which
+-- makes XWayland clients render unscaled and therefore tiny. That worked for
+-- XWayland and broke everything else, because env vars reach every app, not just
+-- the XWayland ones. Qt 6 and GTK on Wayland already take their scale from the
+-- compositor, so the factor multiplied the monitor scale above: Qt saw a 960x640
+-- logical screen instead of 1440x960 and drew half again too large. Measured
+-- with QScreen.geometry on 2026-08-19; 2256/1.566667 is exactly 1440, which is
+-- what Qt reports once nothing overrides it.
+--
+-- Turning force_zero_scaling off for this host is the other half. XWayland then
+-- scales through the compositor, so those apps come out the right size and a
+-- little soft rather than sharp and tiny. That cost lands only on XWayland,
+-- which is the thing I avoid anyway, and correctly-sized beats crisp for the
+-- occasional Zoom window the browser spawns.
+--
+-- ratio needs neither: its monitor runs at scale 1, so nothing multiplies and
+-- XWayland has nothing to compensate for.
+hl.config({
+    xwayland = {
+        force_zero_scaling = false,
+    },
+})
+
+-- calibre renders oversized at the 1.57 compositor scale. Pin its own DPI so its
+-- UI is comfortable without touching the desktop or other apps (validated at 96,
+-- 2026-06-27). CALIBRE_OVERRIDE_DPI is calibre-only, so a session-wide env is safe.
+hl.env("CALIBRE_OVERRIDE_DPI", "96")
+-- No XCURSOR_SIZE here: Hyprland scales the native cursor by the monitor scale
+-- already, so the shared default (24) renders correctly on HiDPI. Pre-scaling it
+-- (the old 36 = 24 x 1.5) double-applied on top of the compositor's scale.
+
+-- org-capture popup: match the terminal scratchpad (75% x 70% of the 1437x958
+-- logical desktop = 1078 x 671 px). Native window rules ignore percentages, so
+-- it's pinned in pixels here rather than in the shared hyprland.lua.
+hl.window_rule({
+    match = {
+        title = "^(org-capture)$",
+    },
+    size = "1078 671",
+})
+
+-- Growth cap (Craig, 2026-07-14): the frame must never outgrow its pinned
+-- size even when capture content pushes it. 1078 px is ~98 Emacs columns,
+-- already under the 120-column cap ratio uses.
+hl.window_rule({
+    match = {
+        title = "^(org-capture)$",
+    },
+    max_size = "1078 671",
+})
+
-- 
cgit v1.2.3