Adaptive layouts #
Capabilities use the full display frame, unaffected by the Dock or menu bar. A short edge below 1,000 points is compact; an aspect ratio of at least 2:1 is ultrawide. Placement uses the usable frame before Parcel's gaps and reserved edges. Unknown or zero-sized displays keep the last known adaptation until valid geometry returns.
| Layout | Compact landscape | Larger landscape | Portrait |
|---|---|---|---|
| Grid | 4 | 4 | 4 |
| Columns | 3 | 4 | 3 |
| Rows | 2 | 3 | 3 |
| Side | 3 | 4, or 5 ultrawide | 5 |
Tree, BSP, and Accordion keep their explicit topology and have no shape-based cap. windowCap is the requested limit; effectiveWindowCap also applies the display capability. The default request is 3. Explicit config window-cap = 0 retains the unlimited opt-out (Int.max in Core); positive requests use the capability limit. Config and commands both clamp positive requests to the display capability and report the limit. Reducing a limit remembers and merges trailing tiles, with a visible and VoiceOver notice. Raising it restores those tiles, not intentional stacks or overflow arrivals. Closing windows prunes this history; explicit rearrangements replace it.
Portrait Grid, Columns, and Side transpose their split axes; Rows stays vertical. Side places its main window above the secondary tiles. Ultrawide Side uses a three-quarter-width group for two large windows, with the remaining windows in a quarter-width column. Main-size presets divide the large group; both dividers remain freely resizable.
These are materialized tile trees, not alternate frame formulas. Layout and shared-edge hit testing traverse the same tree. Rotation preserves every fraction. Side keeps the other shape's tree for a return trip while stack membership matches; a changed membership starts a fresh topology. Ordinary relayout, unchanged config reloads, and cap changes preserve surviving custom splits. Retile deliberately balances the current variant.
LayoutDefaults carries configured landscape and portrait layouts into Core. Workspaces following these defaults switch on rotation; an explicit layout choice opts out, even when it matches the current default. Main-size presets apply only to Side.
Layout.capabilities(in:) is the shared source for engine limits and disabled UI choices. Workspace.adapt(to:fullFrame:) materializes the variant in the reducer. displaySize records usable geometry, while capabilitySize records full display geometry. LayoutEngine requires an already adapted workspace and never changes its tree. Workspace and display decoding accept earlier records without the new fields.