From 9bfda08f85b8b5d7b4463b13871e837061d1d3e1 Mon Sep 17 00:00:00 2001 From: iris-ai <4+iris-ai@noreply.localhost> Date: Mon, 14 Sep 2026 20:30:15 -0400 Subject: [PATCH] Split the performance section so a fresh reader can find the settle order Co-Authored-By: Claude Opus 5 --- docs/IRIS_EXTRACTION_HANDOFF.md | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/docs/IRIS_EXTRACTION_HANDOFF.md b/docs/IRIS_EXTRACTION_HANDOFF.md index e18625b..03f7810 100644 --- a/docs/IRIS_EXTRACTION_HANDOFF.md +++ b/docs/IRIS_EXTRACTION_HANDOFF.md @@ -377,6 +377,8 @@ holds a *drawing* keyed on what produced it, and the widget still draws. The five reference renders and the resize render are byte-identical, and the sweep passes. +### Settling a dirty set, and why the order is not free to change + **Why picking any dirty widget does not work, found 2026-09-14.** `try_reuse` asks whether the widget in front of it is dirty and, if not, hands its parent the size it last reported. It does not ask whether a dirty widget sits under it @@ -456,6 +458,8 @@ hits and only two lines differ between the builds. Nothing here rests on that difference, but it means those two rows are worth re-measuring before anyone builds on them. +### Dirtying many widgets at once + **A frame that dirties many widgets at once was not being checked, and it is where the settle order shows.** `77bb75e` adds two generated cases -- every declared size changing together, and a spread of widgets marked for redraw