@fusion.dev/helix-headless 0.182.1 → 0.183.0

package/dist/toast/root/toast-root.js

@@ -1,9 +1,4 @@
-var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
-    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
-    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
-    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
-    return c > 3 && r && Object.defineProperty(target, key, r), r;
-};
+import { __decorate } from "tslib";
 import { animationsFinished, customElement, DelayController, deepActiveElement, deepContains, FocusScopeController, focusableElements, formatWords, HelixElement, hostAria, matchesChord, onApple, scrollHolders, words, } from '@fusion.dev/helix-core';
 import { html } from 'lit';
 import { property, state } from 'lit/decorators.js';

package/dist/toggle/group/toggle-group.js

@@ -1,9 +1,4 @@
-var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
-    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
-    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
-    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
-    return c > 3 && r && Object.defineProperty(target, key, r), r;
-};
+import { __decorate } from "tslib";
 import { commaList, customElement, DisabledCascadeController, HelixFormElement, hostAria, IndicatorController, KeyboardNavigationController, MixinControllerValue, MixinField, reportValues, rovingStop, toggleValue, toolbarAround, UpgradeController, } from '@fusion.dev/helix-core';
 import { html, nothing } from 'lit';
 import { property } from 'lit/decorators.js';

package/dist/toggle/root/toggle-root.js

@@ -1,9 +1,4 @@
-var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
-    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
-    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
-    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
-    return c > 3 && r && Object.defineProperty(target, key, r), r;
-};
+import { __decorate } from "tslib";
 import { auditName, customElement, HelixElement, HostClickController, MixinSelectableItem, } from '@fusion.dev/helix-core';
 import { html, nothing } from 'lit';
 import { property } from 'lit/decorators.js';

package/dist/toolbar/root/toolbar-root.js

@@ -1,10 +1,5 @@
-var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
-    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
-    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
-    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
-    return c > 3 && r && Object.defineProperty(target, key, r), r;
-};
 var HelixHeadlessToolbar_1;
+import { __decorate } from "tslib";
 import { AriaForwardController, closestInstance, customElement, HelixElement, inlineStep, keyClaimed, toolbarAround, words, } from '@fusion.dev/helix-core';
 import { html, nothing } from 'lit';
 import { property } from 'lit/decorators.js';

package/dist/tooltip/root/tooltip-root.js

@@ -1,9 +1,4 @@
-var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
-    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
-    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
-    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
-    return c > 3 && r && Object.defineProperty(target, key, r), r;
-};
+import { __decorate } from "tslib";
 import { anchorElement, arrowReach, customElement, elementById, focusTarget, HelixElement, hostAria, linkDescription, MixinControllerOpen, OpenPhaseController, onUnlessFalse, PopoverController, reportRuntime, sideOf, unlinkDescription, } from '@fusion.dev/helix-core';
 import { html } from 'lit';
 import { property, state } from 'lit/decorators.js';

package/dist/tour/root/tour-root.js

@@ -1,9 +1,4 @@
-var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
-    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
-    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
-    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
-    return c > 3 && r && Object.defineProperty(target, key, r), r;
-};
+import { __decorate } from "tslib";
 import { auditName, controlsIn, customElement, deepActiveElement, deepContains, formatWords, HelixActivateEvent, HelixBeforeActivateEvent, HelixCompleteEvent, HelixElement, HelixTourStatusEvent, hostAria, inlineStep, keyClaimed, MixinControllerOpen, requestChange, whenHydrated, words, } from '@fusion.dev/helix-core';
 import { html } from 'lit';
 import { property, queryAssignedElements, state } from 'lit/decorators.js';

package/dist/tour/stop/tour-stop.js

@@ -1,9 +1,4 @@
-var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
-    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
-    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
-    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
-    return c > 3 && r && Object.defineProperty(target, key, r), r;
-};
+import { __decorate } from "tslib";
 import { arrowReach, customElement, elementById, HelixElement, HelixTourAskEvent, OpenPhaseController, PopoverController, reflectElements, sideOf, words, } from '@fusion.dev/helix-core';
 import { nothing } from 'lit';
 import { property, state } from 'lit/decorators.js';

package/dist/tree/item/tree-item.js

@@ -1,9 +1,4 @@
-var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
-    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
-    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
-    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
-    return c > 3 && r && Object.defineProperty(target, key, r), r;
-};
+import { __decorate } from "tslib";
 import { auditNesting, customElement, HelixElement, HelixLoadEvent, HelixSelectEvent, MixinControllerOpen, } from '@fusion.dev/helix-core';
 import { caretDown, check, dotsSixVertical, minus } from '@fusion.dev/helix-icons';
 import { html, nothing } from 'lit';

package/dist/tree/root/tree-root.js

@@ -1,9 +1,4 @@
-var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
-    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
-    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
-    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
-    return c > 3 && r && Object.defineProperty(target, key, r), r;
-};
+import { __decorate } from "tslib";
 import { AriaForwardController, auditName, closestInstance, commaList, customElement, deepActiveElement, formatWords, HelixElement, inlineStep, keyClaimed, MixinCollection, MixinControllerActive, ReorderController, requestReorder, scrollItemIntoView, selectsAll, slottedWords, Typeahead, treeArrow, typesCharacter, UpgradeController, whenHydrated, words, } from '@fusion.dev/helix-core';
 import { html, nothing } from 'lit';
 import { property } from 'lit/decorators.js';

package/dist/trend/root/trend-root.js

@@ -1,9 +1,4 @@
-var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
-    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
-    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
-    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
-    return c > 3 && r && Object.defineProperty(target, key, r), r;
-};
+import { __decorate } from "tslib";
 import { customElement, formatWords, HelixElement, reportRuntime, words, wordsLocale, } from '@fusion.dev/helix-core';
 import { arrowDown, arrowUp, minus } from '@fusion.dev/helix-icons';
 import { html } from 'lit';

package/dist/video/root/video-root.js

@@ -1,9 +1,4 @@
-var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
-    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
-    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
-    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
-    return c > 3 && r && Object.defineProperty(target, key, r), r;
-};
+import { __decorate } from "tslib";
 import { activeCue, adoptTrack, auditName, CueController, captionsAmong, captionTracks, copiesOf, customElement, drawIcon, FullscreenController, formatWords, HelixElement, HelixNextEvent, HelixPreviousEvent, IdleController, MediaSessionController, onUnlessFalse, RemotePlaybackController, reportRuntime, SKIP_SECONDS, sameCopies, showCaption, words, writtenList, writtenNumbers, } from '@fusion.dev/helix-core';
 import { airplay, arrowClockwise, arrowCounterClockwise, closedCaptioning, cornersIn, cornersOut, dotsThreeVertical, download, gauge, pause, pictureInPicture, play, skipBack, skipForward, speakerHigh, speakerX, } from '@fusion.dev/helix-icons';
 import { nothing } from 'lit';

package/dist/video-playlist/item/video-playlist-item.js

@@ -1,9 +1,4 @@
-var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
-    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
-    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
-    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
-    return c > 3 && r && Object.defineProperty(target, key, r), r;
-};
+import { __decorate } from "tslib";
 import { customElement, HelixElement, HelixSelectEvent } from '@fusion.dev/helix-core';
 import { html, nothing } from 'lit';
 import { property } from 'lit/decorators.js';

package/dist/video-playlist/menu/video-playlist-menu.js

@@ -1,9 +1,4 @@
-var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
-    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
-    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
-    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
-    return c > 3 && r && Object.defineProperty(target, key, r), r;
-};
+import { __decorate } from "tslib";
 import { closestInstance, customElement, drawIcon, HelixElement, HelixSelectEvent, words, } from '@fusion.dev/helix-core';
 import { list } from '@fusion.dev/helix-icons';
 import { nothing } from 'lit';

package/dist/video-playlist/root/video-playlist-root.js

@@ -1,9 +1,4 @@
-var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
-    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
-    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
-    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
-    return c > 3 && r && Object.defineProperty(target, key, r), r;
-};
+import { __decorate } from "tslib";
 import { customElement, drawStatus, formatWords, HelixElement, HelixEndEvent, inlineStep, MixinControllerActive, ReorderController, StatusController, words, } from '@fusion.dev/helix-core';
 import { html, nothing } from 'lit';
 import { property } from 'lit/decorators.js';

package/dist/virtual-list/reorder/virtual-list-reorder.js

@@ -57,7 +57,11 @@ export class VirtualListReorderController {
     }
     get enabled() {
         const host = this.host;
-        return (host.reorderable && host.columns <= 1 && host.minColumnWidth <= 0 && host.sectionField === '');
+        return (host.reorderable &&
+            host.columns <= 1 &&
+            host.minColumnWidth <= 0 &&
+            host.sectionField === '' &&
+            host.layout !== 'waterfall');
     }
     hostUpdated() {
         queueMicrotask(() => this.mark());

package/dist/virtual-list/root/virtual-list-root.d.ts

@@ -61,6 +61,32 @@ export interface VirtualListRange {
  * smallest item size, and follows the box as it resizes. `gap` spaces the rows, and the columns
  * of a grid, by a number of pixels the list counts in each row's place.
  *
+ * A grid without `selection-mode` is a grid to a reader, as the APG's grid
+ * and React Aria's grid list are: the box is a `grid` with `aria-rowcount`
+ * and `aria-colcount`, each line drawn is a `row` with `aria-rowindex`, and
+ * each item a `gridcell` with `aria-colindex`. Each line is a slot of the
+ * list's own, so your rows stay its children: give an item one element. With
+ * `selection-mode` it stays a list box of options, as React Aria's list box
+ * in a grid layout does.
+ *
+ * **A waterfall.** `layout="waterfall"` puts each item, in the order of the
+ * set, under the column that ends highest so far, the leftmost of a tie, as a
+ * wall of photos of different heights is, and as React Aria's waterfall
+ * layout and TanStack Virtual's lanes do. `columns`, or `min-column-width`,
+ * says how many columns. Every item is measured, at the width of its column,
+ * and placed at its column and its height, so items of any height leave no
+ * holes. The list draws the items that reach into the box, and the item
+ * holding focus. A reader hears a list, or a list box, in the order of the
+ * set, which is also the order Tab and a screen reader's own keys take.
+ *
+ * In a waterfall, Down and Up move along the column to the next or the
+ * previous item in it, Right and Left move to the next or the previous
+ * column, to the item there that sits beside this one the most, or the
+ * nearest above where none does, and Page Down and Page Up move a box down
+ * or up the column. Home and End go to the first and the last item of the
+ * set, and Shift with a key takes in the items between in the order of the
+ * set.
+ *
  * **Across.** `orientation="horizontal"` lays the items out along a line and
  * scrolls it sideways, as a strip of cards does, windowed the same way:
  * `estimate` is then an item's width, and the box needs an inline size.
@@ -79,10 +105,11 @@ export interface VirtualListRange {
  *
  * | Key | What it does |
  * |---|---|
- * | Down, Up | Moves to the next or the previous item, or in a grid to the item in the same column on the next or the previous line. |
- * | Right, Left | In a grid, moves to the next or the previous item along the line, the other way round on a right-to-left page. In a list that runs across, moves to the next or the previous item the same way, and Down and Up are left to the row. |
- * | Home, End | Moves to the first or the last item. |
- * | Page Down, Page Up | Moves by the number of items, or of lines in a grid, on screen. |
+ * | Down, Up | Moves to the next or the previous item, or in a grid to the item in the same column on the next or the previous line, or in a waterfall to the next or the previous item down the same column. |
+ * | Right, Left | In a grid, moves to the next or the previous item along the line, the other way round on a right-to-left page. In a waterfall, moves to the item beside in the next or the previous column. In a list that runs across, moves to the next or the previous item the same way, and Down and Up are left to the row. |
+ * | Home, End | Moves to the first or the last item. In a grid without `selection-mode`, to the first or the last item of the line. |
+ * | Control or Command with Home or End | In a grid without `selection-mode`, moves to the first or the last item. |
+ * | Page Down, Page Up | Moves by the number of items, or of lines in a grid, on screen, or in a waterfall a box down or up the column. |
  * | A letter or a word | Moves to the next item whose text starts with what you typed. |
  * | Escape | Lets go of every chosen item, in a list with `selection-mode`. |
  * | Alt with Up or Down | In a `reorderable` list, moves the item a place. Alt with Home or End moves it to either end. |
@@ -97,8 +124,9 @@ export interface VirtualListRange {
  * or the item itself when it is a string or a number.
  *
  * Each row says its place in the whole set with `aria-posinset` and
- * `aria-setsize`, so a screen reader says "4,000 of 10,000". The row holding
- * focus stays drawn when it scrolls out.
+ * `aria-setsize`, so a screen reader says "4,000 of 10,000", and each cell of
+ * a grid its line and its column. The row holding focus stays drawn when it
+ * scrolls out.
  *
  * **Selecting.** `selection-mode` makes the list a list box a reader chooses
  * from: `single` selects one item and `multiple` any number. Space or a press
@@ -204,6 +232,7 @@ export interface VirtualListRange {
  * @cssstate loading - While `loading` is set.
  */
 export declare class HelixHeadlessVirtualList extends HelixElement {
+    protected static markRules: string[];
     /**
      * The key this family's words are registered under, its styled tag:
      * `registerWords('de', { 'helix-virtual-list': { loadingLabel: 'Weitere werden geladen' } })`.
@@ -266,6 +295,15 @@ export declare class HelixHeadlessVirtualList extends HelixElement {
      * wins over this.
      */
     label: string;
+    /**
+     * How items of more than one column are laid out. `grid`, the default, puts
+     * them in lines of equal columns. `waterfall` puts each item, in the order
+     * of the set, under the column that ends highest, as a wall of photos of
+     * different heights is: `columns`, or `min-column-width`, says how many
+     * columns. Rows of a waterfall are measured, and Up and Down move along a
+     * column.
+     */
+    layout: 'grid' | 'waterfall';
     /**
      * Marks the list as busy fetching more items, and draws a row after the last
      * item that says so.
@@ -299,7 +337,7 @@ export declare class HelixHeadlessVirtualList extends HelixElement {
      * Which way the list runs. `horizontal` lays the items out along a line
      * and scrolls it sideways: Left and Right move between items, the other
      * way round on a right-to-left page, and `estimate` is an item's width. A
-     * grid always runs down.
+     * grid and a waterfall always run down.
      */
     orientation: 'horizontal' | 'vertical';
     /**
@@ -323,7 +361,8 @@ export declare class HelixHeadlessVirtualList extends HelixElement {
      * with an arrow moves the row the keys are on, and a pointer drags a row.
      * The list moves no item itself: you move your `items` on `helix-reorder`.
      * Without that import it does nothing, so a list that never moves items
-     * carries none of the code. A list of one column, without sections.
+     * carries none of the code. A list of one column, without sections or a
+     * waterfall.
      */
     reorderable: boolean;
     /**
@@ -421,24 +460,42 @@ export declare class HelixHeadlessVirtualList extends HelixElement {
     get range(): VirtualListRange;
     /** The gap in pixels, none where it is not a positive number. */
     private get space();
+    /** Where each item of a waterfall stands, which the controller places. */
+    private readonly lanes;
+    /** Whether the items are laid out as a waterfall, each down a column. */
+    private get waterfall();
     /**
-     * How many items a line holds: as many as fit at `min-column-width` where
-     * it is set and the box has a width, and `columns` otherwise, at least one.
+     * Whether the list is a grid a reader reads, and not a list box: lines of
+     * columns with no `selection-mode`, which are `grid`, `row` and `gridcell`
+     * to a reader, as the APG's grid and React Aria's grid list are.
+     */
+    private get lined();
+    /**
+     * How many items a line holds, which a waterfall draws one at a time: its
+     * columns are not lines.
      */
     private get across();
+    /**
+     * How many columns there are: as many as fit at `min-column-width` where
+     * it is set and the box has a width, and `columns` otherwise, at least one.
+     */
+    private get columnCount();
     /** How wide the box is, read for `min-column-width`. */
     private boxWidth;
     /** Watches the box's width, for `min-column-width`. */
     private widthWatch;
-    /** The items to a line the measurements were taken at. */
+    /** The items to a line the measurements were taken at, or a waterfall's columns and width. */
     private measuredAcross;
-    /** Watches the box for its width while `min-column-width` asks for it. */
+    /**
+     * Watches the box for its width while `min-column-width` asks for it, or a
+     * waterfall, whose items are as tall as their width makes them.
+     */
     private watchWidth;
     /** The items a span of lines holds. */
     private itemsOn;
     /** The line item `at` is on: its entry in a list with sections. */
     private lineOf;
-    /** Whether the list runs across, which a grid never does. */
+    /** Whether the list runs across, which a grid and a waterfall never do. */
     private get horizontal();
     /** The sections and the items they were read from, kept until either changes. */
     private sectionsRead;
@@ -540,6 +597,14 @@ export declare class HelixHeadlessVirtualList extends HelixElement {
      * is that control's, so a field in a row keeps its arrows.
      */
     private readonly handleKeydown;
+    /**
+     * Where a key goes in a waterfall, through the columns `Waterfall.step`
+     * reads: along the column for Down, Up, Page Down and Page Up, and to the
+     * item beside in the next column or the one before for the keys along the
+     * line, the other way round on a right-to-left page. Past a disabled item,
+     * on the same way.
+     */
+    private inWaterfall;
     /** The key of item `at` in `value`. See `keyField`. */
     private keyAt;
     /** @internal Every item's key, in the order of the set, which the reorder entry moves. */
@@ -599,15 +664,25 @@ export declare class HelixHeadlessVirtualList extends HelixElement {
     private keptIndex;
     /**
      * Writes a row's role, and whether it is chosen in a list that selects:
-     * `option` with `aria-selected` there, and `listitem` otherwise, and
-     * `aria-disabled` on an item `disabled-keys` names. Every pass,
-     * since a choice changes no row's content.
+     * `option` with `aria-selected` there, `gridcell` in a grid, and `listitem`
+     * otherwise, and `aria-disabled` on an item `disabled-keys` names. Every
+     * pass, since a choice changes no row's content.
+     *
+     * Its place too: `aria-posinset` and `aria-setsize` in a list, and in a
+     * grid its column, with the line's `row` given by the slot it is drawn in.
      *
      * `data-selected` and `data-disabled` say the same to a stylesheet, as
      * React Aria's rows do, so one rule reads the same in either kind of list.
      */
     private mark;
-    /** Writes a row's place in the set. */
+    /**
+     * Writes which item a row drew, for the controller to measure it against:
+     * the real index, the same one `aria-posinset` carries one higher.
+     *
+     * `mark` writes the place a reader hears from it, the real index and the
+     * real total, not the position in the window. A reader arrowing through
+     * this should hear where they are in the set.
+     */
     private stamp;
     /** Fills a drawn row from its item, by `renderItem` or by the template's holes. */
     private fill;
@@ -641,6 +716,10 @@ export declare class HelixHeadlessVirtualList extends HelixElement {
     private place;
     /** The sections the rows were last placed in. */
     private placedSections;
+    /** Whether the rows were last placed in a waterfall. */
+    private placedWaterfall;
+    /** The lines of a grid drawn on the last pass, each a `row` the render draws a slot in. */
+    private drawnLines;
     /** The function the drawn headers were drawn by, so a new one draws them again. */
     private headedBy;
     /** Ties each header's id to this list. */