[css-layout-api] s/doLayout/layoutNextFragment/g

Author: bfgeek

css-layout-api/EXPLAINER.md

@@ -97,7 +97,7 @@ registerLayout('centering', class extends Layout {
     let maxChildInlineSize = 0;
     let maxChildBlockSize = 0;
     for (let child of children) {
-      const childFragment = yield child.doLayout(childConstraintSpace);
+      const childFragment = yield child.layoutNextFragment(childConstraintSpace);
 
       maxChildInlineSize = Math.max(maxChildInlineSize, childFragments.inlineSize);
       maxChildBlockSize = Math.max(maxChildBlockSize, childFragments.blockSize);
@@ -196,7 +196,7 @@ child constraint space just sets the size available to the children.
 We now loop through all of our children and perform layout. This is done by:
 
 ```js
-const childFragment = yield child.doLayout(childConstraintSpace);
+const childFragment = yield child.layoutNextFragment(childConstraintSpace);
 ```
 
 `child` has a very simple API. You can query the style of a child and perform layout - e.g.
@@ -205,7 +205,7 @@ const childFragment = yield child.doLayout(childConstraintSpace);
 child instanceof LayoutChild; // true
 child.styleMap.get('--a-property');
 
-const fragment = yield child.doLayout(childConstraintSpace);
+const fragment = yield child.layoutNextFragment(childConstraintSpace);
 ```
 
 The result of performing layout on a child is a `Fragment`. A fragment is read-only except for
@@ -319,8 +319,8 @@ The quick brown fox jumped over the lazy dog.
 ```js
 child instanceof LayoutChild;
 
-const fragment1 = yield child.doLayout(constraintSpace);
-const fragment2 = yield child.doLayout(constraintSpace, fragment1.breakToken);
+const fragment1 = yield child.layoutNextFragment(constraintSpace);
+const fragment2 = yield child.layoutNextFragment(constraintSpace, fragment1.breakToken);
 
 fragment2.breakToken == null;
 ```
@@ -406,7 +406,7 @@ registerLayout('basic-inline', class extends Layout {
         inlineShrinkToFit: true,
       });
 
-      const fragment = yield child.doLayout(constraintSpace, childBreakToken);
+      const fragment = yield child.layoutNextFragment(constraintSpace, childBreakToken);
       childFragments.push(fragment);
 
       // Check if there is still space on the current line.
@@ -569,7 +569,7 @@ registerLayout('multi-col', class extends Layout {
         blockFragmentationType: 'column',
       });
 
-      const fragment = yield child.doLayout(childConstraintSpace);
+      const fragment = yield child.layoutNextFragment(childConstraintSpace);
     }
 
     // ... 

css-layout-api/Overview.bs

@@ -132,7 +132,7 @@ Layout Children {#layout-children}
 <pre class='idl'>
 [Exposed=LayoutWorklet]
 interface LayoutChild {
-    FragmentRequest doLayout(ConstraintSpace space, ChildBreakToken breakToken);
+    FragmentRequest layoutNextFragment(ConstraintSpace space, ChildBreakToken breakToken);
 };
 
 [Exposed=LayoutWorklet]
@@ -219,11 +219,11 @@ A {{BoxLayoutChild}} could be generated by:
 An array of {{LayoutChild}}ren is passed into the <a>layout method</a> which represents the children
 of the current box which is being laid out.
 
-To perform layout on a box the author can invoke the {{LayoutChild/doLayout()}} method. This will
-produce a {{Fragment}} which contains layout information.
+To perform layout on a box the author can invoke the {{LayoutChild/layoutNextFragment()}} method.
+This will produce a {{Fragment}} which contains layout information.
 
-The {{LayoutChild/doLayout()}} method may be invoked multiple times with different arguments to
-query the {{LayoutChild}} for different layout information.
+The {{LayoutChild/layoutNextFragment()}} method may be invoked multiple times with different
+arguments to query the {{LayoutChild}} for different layout information.
 
 Layout Fragments {#layout-fragments}
 ------------------------------------
@@ -247,12 +247,13 @@ interface Fragment {
 </pre>
 
 A {{Fragment}} represents a CSS <a>fragment</a> of a {{LayoutChild}} after layout has occurred on
-that child. This is produced by the {{LayoutChild/doLayout()}} method.
+that child. This is produced by the {{LayoutChild/layoutNextFragment()}} method.
 
 The {{Fragment}} has {{Fragment/inlineSize}} and {{Fragment/blockSize}} attributes, which are set by
 the respective child's layout algorithm. They cannot be changed. If the <a>current layout</a>
 requires a different {{Fragment/inlineSize}} or {{Fragment/blockSize}} the author must perform
-{{LayoutChild/doLayout()}} again with different arguments in order to get different results.
+{{LayoutChild/layoutNextFragment()}} again with different arguments in order to get different
+results.
 
 The {{Fragment}} has {{Fragment/inlineOverflowSize}} and {{Fragment/blockOverflowSize}} attributes.
 This is the size of the overflow area of the fragment. If the fragment didn't overflow these
@@ -296,7 +297,7 @@ registerLayout('block-like', class extends Layout {
         let blockOffset = bordersAndPadding.blockStart;
 
         for (let child of children) {
-            const fragment = yield child.doLayout(childConstraintSpace);
+            const fragment = yield child.layoutNextFragment(childConstraintSpace);
 
             // Position the fragment in a block like manner, centering it in the
             // inline direction.
@@ -329,10 +330,11 @@ registerLayout('block-like', class extends Layout {
 
 The {{Fragment}}'s {{Fragment/breakToken}} specifies where the {{LayoutChild}} last fragmented. If
 the {{Fragment/breakToken}} is null the {{LayoutChild}} wont produce any more {{Fragment}}s for that
-token chain. The {{Fragment/breakToken}} can be passed to the {{LayoutChild/doLayout()}} function to
-produce the next {{Fragment}} for a particular child. The {{Fragment/breakToken}} cannot be changed.
+token chain. The {{Fragment/breakToken}} can be passed to the {{LayoutChild/layoutNextFragment()}}
+function to produce the next {{Fragment}} for a particular child. The {{Fragment/breakToken}} cannot
+be changed.
 If the <a>current layout</a> requires a different {{Fragment/breakToken}} the author must perform
-{{LayoutChild/doLayout()}} again with different arguments.
+{{LayoutChild/layoutNextFragment()}} again with different arguments.
 
 The {{Fragment}}'s {{Fragment/dominantBaseline}} attribute specify where the dominant baseline is
 positioned relative to the block start of the fragment. It cannot be changed.
@@ -428,7 +430,7 @@ registerLayout('flex-distribution-like', class {
 
         // Calculate the unconstrained size for each child.
         for (let child of children) {
-            const fragment = yield child.doLayout(childConstraintSpace);
+            const fragment = yield child.layoutNextFragment(childConstraintSpace);
             unconstrainedSizes.push(fragment.inlineSize);
             totalSize += fragment.inlineSize;
         }
@@ -440,7 +442,7 @@ registerLayout('flex-distribution-like', class {
         let inlineOffset = 0;
         let maxChildBlockSize = 0;
         for (let i = 0; i < children.length; i++) {
-            let fragment = yield child.doLayout(new ConstraintSpace({
+            let fragment = yield child.layoutNextFragment(new ConstraintSpace({
                 inlineSize: unconstrainedSizes[i] + extraSpace,
                 inlineSizeFixed: true,
                 blockSize: availableBlockSize
@@ -603,8 +605,8 @@ registerLayout('basic-inline', class extends Layout {
                 inlineShrinkToFit: true,
             });
 
-            const fragment = yield child.doLayout(constraintSpace,
-                                                  childBreakToken);
+            const fragment = yield child.layoutNextFragment(constraintSpace,
+                                                            childBreakToken);
             childFragments.push(fragment);
 
             // Check if there is still space on the current line.
@@ -916,10 +918,10 @@ The layout method on the author supplied layout class is a generator function in
 javascript function. This is for user-agents to be able to support asynchronous and parallel layout
 engines.
 
-When an author invokes the {{LayoutChild/doLayout()}} method on a {{LayoutChild}} the user-agent
-doesn't synchronously generate a {{Fragment}} to return to the author's code. Instead it returns a
-{{FragmentRequest}}. This is a completely opaque object to the author but contains internal
-slots which encapsulates the {{LayoutChild/doLayout()}} method call.
+When an author invokes the {{LayoutChild/layoutNextFragment()}} method on a {{LayoutChild}} the
+user-agent doesn't synchronously generate a {{Fragment}} to return to the author's code. Instead it
+returns a {{FragmentRequest}}. This is a completely opaque object to the author but contains
+internal slots which encapsulates the {{LayoutChild/layoutNextFragment()}} method call.
 
 When a {{FragmentRequest}}(s) are yielded from a layout generator object the user-agent's
 layout engine may run the algorithm asynchronously with other work, and/or on a different thread of