Bug 1986987 [wpt PR 54697] - [Gap Decorations]: Major paint logic for Optimized GapGeometry, a=testonly

Automatic update from web-platform-tests
[Gap Decorations]: Major paint logic for Optimized GapGeometry

This CL implements the core paint logic for the optimized approach to
gap geometry. The main changes are in the "population" methods in
`gap_geometry.h` and the addition of the new `GapPainter` class in
`gap_painter.h`.

Gap decorations are painted relative to intersections within a gap, as a
result this change generates these intersection points at paint time
rather than storing precomputed intersections from layout. The general
principle for generating intersection points is:

content-start → intersections between main × cross gaps → content-end

However, the way we compute the middle intersections depends on the
container type. For flex cross gaps, there are only two intersections
(start and end), so the pattern doesn’t fully apply. This distinction
requires calculating the end offset for flex cross gaps dynamically.

The code is exercised through existing web tests in the
virtual/css-gap-decorations-optimized/external/wpt/css/css-gaps/ folder
as all changes are behind the CSSGapDecorationOptimized feature flag.

Note: This CL does not yet handle rule-break behavior as a result tests
that are exercising that logic are marked as failing in this CL.
Currently, decorations are painted from the start to the end of a gap
without interruption. Rule-break handling will be addressed in an
upcoming change.

Other changes made in this CL are:
* For flex:
- Previously, ContentStart and ContentEnd offsets were not set when a flex line contained only a single item. This has been corrected.
- The offset for the main gap no longer needs to be adjusted based on flex direction. It now consistently represents the position where the flex line ends plus the gap. (Relevant test updated accordingly.)
* For `MainGap` and `CrossGapRange`:
- Introduced getters and setters for `CrossGapRange`, improving ease of use during paint time.
* For grid tests:
- Updated test references to use standard div elements instead of relying on column rules from multi-column layout.

Bug: 436140061, 357648037
Change-Id: I0a0eadbad7f4911a98ae22060327ef1acc526ab3
Reviewed-on: https://chromium-review.googlesource.com/c/chromium/src/+/6848348
Reviewed-by: Alison Maher <almahermicrosoft.com>
Commit-Queue: Sam Davis Omekara <samomekarajrmicrosoft.com>
Cr-Commit-Position: refs/heads/main{#1511107}

--

wpt-commits: 6c1e98272dfd3f340eff1a5250832ebf02bf2fbe
wpt-pr: 54697

UltraBlame original commit: b82e85be6eb3ec6c2f57f812e349ae6122c39a52

Author: marco-c

testing/web-platform/tests/css/css-gaps/grid/grid-gap-decorations-003-ref.html

@@ -71,58 +71,42 @@
 .
 container
 {
-width
-:
-110px
-;
 height
 :
 110px
 ;
-column
--
-count
+width
 :
-2
+110px
 ;
-column
--
-gap
+display
 :
-10px
+grid
 ;
-column
+grid
 -
-rule
+template
 -
-color
+columns
 :
-pink
+repeat
+(
+2
+1fr
+)
 ;
 column
 -
-rule
--
-style
+gap
 :
-dotted
+10px
 ;
-column
--
-rule
+row
 -
-width
+gap
 :
 10px
 ;
-overflow
-:
-hidden
-;
-position
-:
-relative
-;
 }
 .
 item
@@ -145,53 +129,51 @@
 0
 ;
 }
-/
-*
-For
-2x2
-grid
--
-like
-layout
-add
-a
-10px
-bottom
-margin
-to
-odd
-children
-(
-#
-1
-&
-#
-3
-)
-to
-simulate
-a
-horizontal
-row
-gap
 .
-*
-/
-.
-item
-:
-nth
+col
 -
-child
-(
-odd
-)
+rule
 {
 margin
+:
+0px
+;
+padding
+:
+0px
+;
+width
+:
+0px
+;
+height
+:
+110px
+;
+border
 -
-bottom
+right
 :
 10px
+dotted
+;
+border
+-
+color
+:
+pink
+;
+position
+:
+absolute
+;
+left
+:
+50px
+;
+top
+:
+0px
 ;
 }
 .
@@ -306,6 +288,20 @@
 class
 =
 "
+col
+-
+rule
+"
+>
+<
+/
+div
+>
+<
+div
+class
+=
+"
 row
 -
 rule