Copilot instructions

1---
2applyTo:
3  - "src/Core/src/Layouts/**"
4  - "src/Controls/src/Core/Layout/**"
5  - "src/Core/src/Handlers/Layout/**"
6---
7# Layout System Rules
8 
9## Measure/Arrange Contract
10- `Measure(widthConstraint, heightConstraint)` returns the desired size — it must not mutate layout state or trigger side effects
11- `ArrangeChildren(bounds)` positions children within the given bounds — it must respect the size returned from `Measure`, not compute independently
12- A child measured with `widthConstraint=200` must not be arranged with `width=300` — constraints must stay consistent across passes
13- Subtract padding, margin, and border thickness from constraints BEFORE passing to children
14 
15## Constraint Propagation
16- Stack layouts pass `double.PositiveInfinity` along the stacking axis and the parent constraint along the cross axis
17- Grid cells compute per-cell constraints from column/row definitions — do not pass the full grid constraint to each child
18- `MeasureContent` helpers on `IContentView` handle inset subtraction — use them instead of manual arithmetic
19- On Windows, `double.NaN` represents unconstrained dimensions (WinUI convention) — do not confuse with `double.PositiveInfinity` (MAUI convention)
20 
21## Infinite Loop Avoidance
22- Never create circular dependencies where child size depends on parent AND parent size depends on child
23- Layout invalidation (`InvalidateMeasure`) must not re-trigger during an active measure pass
24- ScrollView content must always be re-measured on layout trigger — do not aggressively cache child measurements in scrollable containers
25 
26## Performance on Hot Paths
27 
28> Layout measure/arrange methods are hot paths. All rules from `performance-hotpaths.instructions.md` apply — no LINQ, closures, or allocations. Additionally for layout:
29- Cache expensive computations (e.g., `GridStructure`) and invalidate only when inputs change
30- Bindable property change handlers should skip layout invalidation when the value has not actually changed
31