truce-gui-utils

Cross-backend host-side platform helpers for truce GUI backends.

Overview

Small helper crate shared by the GUI backends that embed a child view (wgpu- or CALayer-backed) into a DAW-provided parent window. It exists so each backend (truce-gui, truce-egui, truce-iced, truce-vizia) does not re-implement the same host-window quirks. No rendering, no widgets.

Currently macOS-only in effect. On Linux and Windows the host manages child-window positioning natively, so the helpers compile to no-ops there.

Key functions

• reanchor_to_superview_top -- pin an embedded NSView's top edge to its superview's top across host-driven resizes (AppKit's autoresize math only runs on parent resize, so resizing the child alone drifts it off-anchor and clips the header row)
• reanchor_all_children_to_top -- the same, applied to every child of a given parent NSView
• should_skip_frame -- host-resize stability check; lets a backend drop a frame mid-resize rather than render against a transient surface size

All take a raw_window_handle::RawWindowHandle (or raw parent pointer) and are no-ops on non-macOS targets, so callers can invoke them unconditionally.

Part of truce. Docs.