ADR 0005 slice 5: fold style-only single-child boxes into their child
Maintainers usually reply within 1 day
Nobody has claimed this yet.
Assessment
- Difficulty
- 5/5
- Estimated time
- Over a week
- Newbie friendliness
- 35/100
Research direction
Start by reading ADR 0005 (#6160) and slice 4 (#6239), then inspect the classifier and parity checks for the Wix capture. Implement the geometry-proven fold rules and add the requested table-driven contract test with one fold and one refusal per rule. Done means reporting per-route fold counts, meeting the depth and groups-per-leaf targets, and preserving desktop and mobile parity with slice 4.
Written by the indexing model from the issue text.
Description
Slice 5 of ADR 0005 (#6160). Depends on slice 4 (https://github.com/Automattic/blocks-engine/issues/6239).
Goal: fold single-child boxes that are load-bearing only because of their own styles into that child, proved by geometry. Once the engine owns every rule (slice 3), moving a declaration is safe, because no author selector depends on the box.
Fold rules: each applies only when the box has exactly one child, no semantics, references, interaction or motion, and the result is proved at every captured viewport:
- Own sizing (padding): the box's padding becomes the child's margin when the child is block-level, has no margin on that side, and the child's border box sits exactly inside the box's padding edge. Sizing constraints (
width,max-width,min-height) move only when the child's used size is already equal. - Paint: background, border, radius or shadow moves to the child when the child's border box equals the box's border box and the child doesn't paint on those properties.
- Containing block:
position:relativemoves to the child when every positioned descendant's offsets resolve to the same rectangle (the child's border box equals the box's). - Never fold: clipping, multi-child layout, semantic tags, transforms, filters or opacity (they create stacking contexts), or pseudo-elements that render.
Measured today (classifier on the Wix capture, structural boxes): Home 258 (109 neutral; 38 own-sizing, 21 paint, 22 containing-block). About 110 (44 neutral; 16, 10, 5). The ceiling after slice 5 is about 68 structural boxes on Home, roughly 70% fewer wrappers.
Acceptance:
- Report the fold count per rule per route, plus emitted depth and groups per leaf. The ADR targets are depth ≤ 10 and groups per leaf ≤ 1.1.
- Desktop and mobile parity against slice 4 shows no regression.
- One table-driven contract test, with one fold and one refusal per rule.
AI disclosure: written by Franklin (Claude Opus via Pi, Roadie).
- Dominant language
- PHP
- Stars
- 28
- Forks
- 5
- Avg merge
- 2h 59m
- Merged PRs (30d)
- 942
Getting set up
- No Dockerfile or Docker Compose file
- No pull request template
- Read the contributing guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
More from Automattic/blocks-engine
-
Difficulty 2/5 1-3 hours Newbie friendliness 79/100
Automattic/blocks-engine#6318 ·
Maintainers usually reply within 1 day
-
Difficulty 2/5 1-3 hours Newbie friendliness 70/100
Automattic/blocks-engine#4943 ·
Maintainers usually reply within 1 day
-
Difficulty 2/5 1-3 hours Newbie friendliness 70/100
Automattic/blocks-engine#4942 ·
Maintainers usually reply within 1 day
-
Difficulty 2/5 1-3 hours Newbie friendliness 75/100
Automattic/blocks-engine#4921 ·
Maintainers usually reply within 1 day
-
Difficulty 2/5 1-3 hours Newbie friendliness 82/100
Automattic/blocks-engine#775 ·
Maintainers usually reply within 1 day
All issues in Automattic/blocks-engine
Similar issues
-
Difficulty 2/5 1-3 hours Newbie friendliness 82/100
TYPO3-Solr/ext-solr#4850 ·
Maintainers usually reply within 2 days
-
[Sync EN] stream: document the errors of the stream_context_*() and stream filter functions (#6091)Opensync-en
Difficulty 2/5 1-3 hours Newbie friendliness 78/100
Maintainers usually reply within 1 day
-
[Sync EN] stream: document the errors of the stream_context_*() and stream filter functions (#6091)Opensync-en
Difficulty 2/5 1-3 hours Newbie friendliness 66/100
Maintainers usually reply within 1 day
-
Перевод устарел
Difficulty 2/5 1-3 hours Newbie friendliness 72/100
Maintainers usually reply within 1 day
-
Difficulty 2/5 1-3 hours Newbie friendliness 72/100
glpi-project/glpi#26353 · 2 comments ·
Maintainers usually reply within 1 day