tiny.ui.SolvedRoot

1/// A solved root names a node by its `node` array index, and the admission survey rejects a2/// `node` index at or past the node count with `error.SolvedRootNodeOutOfBounds`.3/// Solved roots must be sorted and must not overlap, or `error.SolvedRootsUnordered`.4/// Every node with `flags.solved` requires exactly one matching `SolvedRoot` entry, and5/// admission returns `error.SolvedNodeWithoutRoot` when one is missing.6/// Admission rejects a retained subtree that contains a solved node with7/// `error.RetainedSolvedSubtree`, because splice does not carry solved rectangles from8/// the old publish.9///10/// A `SolvedRoot` points to the first rectangle for one contiguous preorder subtree through11/// `rect_first`. A node carrying `flags.solved` names the subtree: its descendants remain12/// real UI nodes for hit testing, facts, and accessibility.13///14/// The supplied rectangles are in the publisher's own frame, in layout units, because15/// their absolute positions in the UI viewport are not known at publish time. The root16/// rectangle's width and height are the size arrange uses when it treats the solved17/// subtree as one leaf, and its x and y define the publisher frame's origin for the18/// subtree. After arrange places that leaf, each descendant moves by the difference19/// between the arranged root origin and the supplied root origin. Every supplied width,20/// height, and relative offset remains the same.21///22/// A descendant can have a negative relative offset or extend beyond the root box: this is23/// visible overflow and belongs in subtree bounds. Scrolling uses the descendant's own24/// scroll and clip flags. Supplied rectangles are positions before scroll offset is applied.25pub const SolvedRoot = extern struct {26    /// `SolvedRoot.node` must carry the `solved` flag, or `error.SolvedRootNotSolved`.27    node: u32 = 0,28    /// `rect_first` is the first of `subtree_count + 1` rects, where `subtree_count` is that29    /// node's, and they must fit the rect table, or `error.SolvedRectsOutOfBounds`.30    rect_first: u32 = 0,31};

1pub const SolvedRoot = abi.SolvedRoot;