An auto tiler for macOS
1.7 kB · 11 lines
Markdown
at main

Focus modes #

Each native Space keeps its own temporary mode state. All modes start off at launch.

Focus fills the usable display inside reserved edges and outer gaps without changing the tile tree. Toggling it off restores the layout. Switching documents, opening a document, a layout command, or dragging a tiled window ends Focus. The selected document stays expanded while its app's sheets, dialogs, and auxiliary panels open, receive keyboard focus, or close. Switching native Spaces preserves it until you return. A temporary loss of keyboard focus does not end the expanded arrangement.

No peek and Clean Space belong to the display and native Space where you turn them on. They disappear when that display switches Spaces and return with their Space, even if another display has focus. No peek keeps the last managed focus uncovered when focus leaves managed windows; if that window is gone, it covers the whole display. Only known auxiliary windows and the app's actual focused window get additional cutouts. Clean Space adds a plain backdrop and ends on sleep, lock, or display disconnect.

Use focus-toggle, no-peek-toggle, and clean-space-toggle in keybindings or with prcl. Settings changes appearance, not the per-Space enabled state. prcl query workspaces includes focus_modes.

Privacy panels belong to Parcel; no foreign window opacity or ordering is changed. Cutouts follow observed frames, not layout targets. Compositor dimming requires visible-effect verification. Without a verifier, the privacy overlay is the intended presentation, not a warning. An attempted verification failure is surfaced, and its notice clears when dimming is turned off.