Copilot instructions

1---
2applyTo:
3  - "src/Core/src/Layouts/**"
4  - "src/Core/src/Platform/**"
5  - "src/Controls/src/Core/Handlers/Items/**"
6  - "src/Controls/src/Core/Handlers/Items2/**"
7  - "src/Controls/src/Core/ScrollView/**"
8---
9# Performance-Critical Path Rules
10 
11> **Scope rationale**: globs target the actual hot paths — layout measure/arrange,
12> platform scroll/touch callbacks, CollectionView/CarouselView (Items + Items2)
13> recycling, and ScrollView. The full handler tree is intentionally NOT included;
14> most handlers (Button, DatePicker, CheckBox, …) are not hot paths and don't need
15> these constraints. If you're working on a handler that IS allocation-sensitive
16> (image decoding, animation tick, etc.), apply these rules anyway.
17 
18## Hot Paths in MAUI
19Measure/arrange cycles, scrolling callbacks, binding propagation, and property change notifications are called at high frequency. All rules below apply to code on these paths.
20 
21## Allocation Avoidance
22- No LINQ methods (`.Where`, `.Select`, `.FirstOrDefault`, `.ToList`) — use indexed `for` loops
23- No closures or lambdas that capture variables — these allocate a compiler-generated class per invocation
24- No string concatenation or interpolation — use `StringBuilder` or pre-allocated strings if logging is required
25- Prefer `Count` + indexer over `IEnumerable` iteration to avoid enumerator allocation
26 
27## Caching and Invalidation
28- Cache results of expensive computations called multiple times per layout pass
29- Invalidate caches when inputs change — stale caches cause incorrect layout
30- Skip redundant work: if a property's new value equals the old value, do not trigger layout invalidation or re-render
31 
32## Collection Iteration
33- When the source implements `IList` or `IReadOnlyList`, use `for (int i = 0; i < list.Count; i++)` instead of `foreach`
34- `ObservableCollection` change handlers should process only the affected range, not re-enumerate the entire collection
35