@react-x11/components 0.2.0 → 0.3.0

package/dist/internal/heights.d.ts

@@ -24,8 +24,14 @@ export declare class RowHeights {
     private rows;
     /** Fenwick tree over the heights, 1-based. */
     private tree;
-    /** What an unmeasured row is assumed to be. */
+    /** What an unmeasured row is assumed to be, effectively: the caller's
+     *  `base`, until `adapt` has seen enough real rows to know better. */
     private estimate;
+    /** The estimate the caller declared. A caller changing it is a caller
+     *  changing their mind, and it wins back over adaptation. */
+    private base;
+    /** Running sum of the measured map's values, so `adapt` is O(1). */
+    private sum;
     /** Largest power of two <= n, for the O(log n) descent in `indexAt`. */
     private power;
     /** Set when a measurement could not be applied in place, so the next
@@ -42,6 +48,8 @@ export declare class RowHeights {
      * arrive, when a sort flips, when a filter runs, all O(n) events already.
      */
     sync(rows: readonly Keyed[], estimate: number): void;
+    /** Rebuild the tree from the measured map and the current estimate. */
+    private rebuild;
     /**
      * Record what a row actually laid out at. Returns whether this changed
      * anything — which is what tells the component whether to re-render, and
@@ -64,8 +72,32 @@ export declare class RowHeights {
      * twice.
      */
     indexAt(offset: number): number;
+    /**
+     * Whether anything has ever been measured — O(1), and the question a
+     * component that may not measure at all has to ask before it waits on a
+     * measurement. `measuredCount` answers a different, costlier question:
+     * how many of the rows *currently indexed* have one.
+     */
+    hasMeasurements(): boolean;
     /** How many of the current rows have a real measurement. */
     measuredCount(): number;
+    /**
+     * Let the estimate learn from the rows that have been measured.
+     *
+     * The fixed guess is why a measured list converges slowly: every row not
+     * yet seen is assumed `estimate`, the scrollbar believes the sum, and each
+     * newly measured row moves everything. Once enough rows have real numbers,
+     * their mean is a far better guess for the rest — one O(n) rebuild brings
+     * every unmeasured offset close to where measuring will find it, so the
+     * corrections that follow are small.
+     *
+     * Returns whether anything changed. **Every offset of every unmeasured row
+     * moves when it does** — the caller owns keeping what is on screen still,
+     * the same anchor arithmetic a measurement pass does. Deliberately not
+     * called from `measure`: the caller decides when a wholesale move is safe
+     * to make, which is while nothing is scrolling.
+     */
+    adapt(): boolean;
     /**
      * Forget every measurement, keeping the row list.
      *

package/dist/internal/heights.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"heights.d.ts","sourceRoot":"","sources":["../../src/internal/heights.ts"],"names":[],"mappings":"AAyCA;;sBAEsB;AACtB,MAAM,MAAM,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;AAErC;;qEAEqE;AACrE,UAAU,KAAK;IACb,EAAE,EAAE,MAAM,CAAC;CACZ;AAED;;;;;;;;GAQG;AACH,qBAAa,UAAU;IACrB,oDAAoD;IACpD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA6B;IACtD,iDAAiD;IACjD,OAAO,CAAC,IAAI,CAAwB;IACpC,8CAA8C;IAC9C,OAAO,CAAC,IAAI,CAAiB;IAC7B,+CAA+C;IAC/C,OAAO,CAAC,QAAQ,CAAK;IACrB,wEAAwE;IACxE,OAAO,CAAC,KAAK,CAAK;IAClB;uEACmE;IACnE,OAAO,CAAC,KAAK,CAAS;IAEtB,YAAY,QAAQ,EAAE,MAAM,EAE3B;IAED,OAAO,CAAC,QAAQ;IAKhB;;;;;;;OAOG;IACH,IAAI,CAAC,IAAI,EAAE,SAAS,KAAK,EAAE,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAkBnD;IAED;;;;OAIG;IACH,OAAO,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAkB1D;IAED,oEAAoE;IACpE,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAE9B;IAED,uEAAuE;IACvE,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAGjC;IAED,mEAAmE;IACnE,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAU9B;IAED,gEAAgE;IAChE,KAAK,IAAI,MAAM,CAEd;IAED;;;;;;OAMG;IACH,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAa9B;IAED,4DAA4D;IAC5D,aAAa,IAAI,MAAM,CAItB;IAED;;;;;;;;OAQG;IACH,KAAK,IAAI,IAAI,CAGZ;CACF"}
+{"version":3,"file":"heights.d.ts","sourceRoot":"","sources":["../../src/internal/heights.ts"],"names":[],"mappings":"AA0CA;;sBAEsB;AACtB,MAAM,MAAM,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;AAErC;;qEAEqE;AACrE,UAAU,KAAK;IACb,EAAE,EAAE,MAAM,CAAC;CACZ;AAED;;;;;;;;GAQG;AACH,qBAAa,UAAU;IACrB,oDAAoD;IACpD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA6B;IACtD,iDAAiD;IACjD,OAAO,CAAC,IAAI,CAAwB;IACpC,8CAA8C;IAC9C,OAAO,CAAC,IAAI,CAAiB;IAC7B;0EACsE;IACtE,OAAO,CAAC,QAAQ,CAAK;IACrB;iEAC6D;IAC7D,OAAO,CAAC,IAAI,CAAK;IACjB,oEAAoE;IACpE,OAAO,CAAC,GAAG,CAAK;IAChB,wEAAwE;IACxE,OAAO,CAAC,KAAK,CAAK;IAClB;uEACmE;IACnE,OAAO,CAAC,KAAK,CAAS;IAEtB,YAAY,QAAQ,EAAE,MAAM,EAG3B;IAED,OAAO,CAAC,QAAQ;IAKhB;;;;;;;OAOG;IACH,IAAI,CAAC,IAAI,EAAE,SAAS,KAAK,EAAE,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAanD;IAED,uEAAuE;IACvE,OAAO,CAAC,OAAO;IAgBf;;;;OAIG;IACH,OAAO,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAmB1D;IAED,oEAAoE;IACpE,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAE9B;IAED,uEAAuE;IACvE,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAGjC;IAED,mEAAmE;IACnE,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAU9B;IAED,gEAAgE;IAChE,KAAK,IAAI,MAAM,CAEd;IAED;;;;;;OAMG;IACH,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAa9B;IAED;;;;;OAKG;IACH,eAAe,IAAI,OAAO,CAEzB;IAED,4DAA4D;IAC5D,aAAa,IAAI,MAAM,CAItB;IAED;;;;;;;;;;;;;;;OAeG;IACH,KAAK,IAAI,OAAO,CAUf;IAED;;;;;;;;OAQG;IACH,KAAK,IAAI,IAAI,CAMZ;CACF"}

package/dist/internal/heights.js

@@ -1,10 +1,11 @@
 // Where every row starts, when rows are not all the same height.
 //
-// **Shared between `<Tree>` and `<Table>`** — the one piece of machinery
-// both virtualizers stand on, promoted here from the vendored copy the
-// table briefly carried (docs/prd-table.md records the decision). "No
-// component imports another component" holds: this is shared code, not a
-// component, and both import it.
+// **Shared between `<Tree>` and `<Table>`** — the first piece of machinery
+// both virtualizers stand on (`./timers.ts` and `./scroll.ts` are the other
+// two), promoted here from the vendored copy the table briefly carried
+// (docs/prd-table.md records the decision). "No component imports another
+// component" holds: this is shared code, not a component, and both import
+// it.
 //
 // **Deliberately not a shared *module*.** The directory has no `index.ts`,
 // so it has no subpath, no docs page, and is not public API — the repo's
@@ -54,15 +55,22 @@ export class RowHeights {
     rows = [];
     /** Fenwick tree over the heights, 1-based. */
     tree = [0];
-    /** What an unmeasured row is assumed to be. */
+    /** What an unmeasured row is assumed to be, effectively: the caller's
+     *  `base`, until `adapt` has seen enough real rows to know better. */
     estimate = 1;
+    /** The estimate the caller declared. A caller changing it is a caller
+     *  changing their mind, and it wins back over adaptation. */
+    base = 1;
+    /** Running sum of the measured map's values, so `adapt` is O(1). */
+    sum = 0;
     /** Largest power of two <= n, for the O(log n) descent in `indexAt`. */
     power = 0;
     /** Set when a measurement could not be applied in place, so the next
      *  `sync` must rebuild even though the row list did not change. */
     dirty = false;
     constructor(estimate) {
-        this.estimate = Math.max(1, estimate);
+        this.base = Math.max(1, estimate);
+        this.estimate = this.base;
     }
     heightOf(index) {
         const measured = this.measured.get(this.rows[index].id);
@@ -78,12 +86,23 @@ export class RowHeights {
      */
     sync(rows, estimate) {
         const next = Math.max(1, estimate);
-        if (!this.dirty && this.rows === rows && next === this.estimate)
+        if (next !== this.base) {
+            // The caller changed their declared estimate: that wins back over
+            // whatever `adapt` had learnt — it is the same caller telling us the
+            // rows changed character.
+            this.base = next;
+            this.estimate = next;
+            this.dirty = true;
+        }
+        if (!this.dirty && this.rows === rows)
             return;
-        this.dirty = false;
         this.rows = rows;
-        this.estimate = next;
-        const n = rows.length;
+        this.rebuild();
+    }
+    /** Rebuild the tree from the measured map and the current estimate. */
+    rebuild() {
+        this.dirty = false;
+        const n = this.rows.length;
         // Build in O(n): write each height at its own slot, then push every slot
         // into its parent. The textbook loop of point-updates is O(n log n) and
         // arrives at the same tree.
@@ -110,6 +129,7 @@ export class RowHeights {
         if (before === height)
             return false;
         this.measured.set(id, height);
+        this.sum += height - (before ?? 0);
         if (this.rows[index]?.id !== id) {
             // The caller's index is stale — the rows moved under a measurement
             // that was already in flight. Applying a delta at the wrong slot would
@@ -168,6 +188,15 @@ export class RowHeights {
         }
         return Math.max(0, Math.min(n - 1, index));
     }
+    /**
+     * Whether anything has ever been measured — O(1), and the question a
+     * component that may not measure at all has to ask before it waits on a
+     * measurement. `measuredCount` answers a different, costlier question:
+     * how many of the rows *currently indexed* have one.
+     */
+    hasMeasurements() {
+        return this.measured.size > 0;
+    }
     /** How many of the current rows have a real measurement. */
     measuredCount() {
         let count = 0;
@@ -176,6 +205,35 @@ export class RowHeights {
                 count++;
         return count;
     }
+    /**
+     * Let the estimate learn from the rows that have been measured.
+     *
+     * The fixed guess is why a measured list converges slowly: every row not
+     * yet seen is assumed `estimate`, the scrollbar believes the sum, and each
+     * newly measured row moves everything. Once enough rows have real numbers,
+     * their mean is a far better guess for the rest — one O(n) rebuild brings
+     * every unmeasured offset close to where measuring will find it, so the
+     * corrections that follow are small.
+     *
+     * Returns whether anything changed. **Every offset of every unmeasured row
+     * moves when it does** — the caller owns keeping what is on screen still,
+     * the same anchor arithmetic a measurement pass does. Deliberately not
+     * called from `measure`: the caller decides when a wholesale move is safe
+     * to make, which is while nothing is scrolling.
+     */
+    adapt() {
+        const n = this.measured.size;
+        if (n < 8)
+            return false; // too few rows to say anything about the rest
+        const mean = Math.round(this.sum / n);
+        // ±1 is noise — the mean drifts by that much as single rows arrive, and
+        // a rebuild per drift would run at the measure rate for no visible gain.
+        if (Math.abs(mean - this.estimate) <= 1)
+            return false;
+        this.estimate = Math.max(1, mean);
+        this.rebuild();
+        return true;
+    }
     /**
      * Forget every measurement, keeping the row list.
      *
@@ -187,6 +245,9 @@ export class RowHeights {
      */
     reset() {
         this.measured.clear();
+        this.sum = 0;
+        // adaptation came from the measurements just forgotten
+        this.estimate = this.base;
         this.dirty = true;
     }
 }

package/dist/internal/heights.js.map

@@ -1 +1 @@
-{"version":3,"file":"heights.js","sourceRoot":"","sources":["../../src/internal/heights.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"heights.js","sourceRoot":"","sources":["../../src/internal/heights.ts"],"names":[],"mappings":"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"}

package/dist/internal/scroll.d.ts

@@ -0,0 +1,73 @@
+import type { DrawnNode, ScrollableNode } from 'react-x11';
+import type { RowHeights, RowKey } from './heights.js';
+/** All a reveal needs of a row: `<TreeRow>` and `<TableRow>` are both this. */
+interface Keyed {
+    id: RowKey;
+}
+/** A row on screen, and the index it was drawn at — the shape both
+ *  components already keep their mounted rows in. */
+interface Drawn {
+    node: DrawnNode;
+    at: number;
+}
+/** What the component lends the reveal: everything it already has, by ref,
+ *  so nothing here goes stale between a render and the tick after layout. */
+export interface RevealSources {
+    /** The scroll pane. `<Table>`'s body; `<Tree>`'s own root. */
+    box: {
+        readonly current: ScrollableNode | null;
+    };
+    /** The rows in display order. */
+    rows: {
+        readonly current: readonly Keyed[];
+    };
+    /** The rows on screen, by id. */
+    nodes: {
+        readonly current: ReadonlyMap<RowKey, Drawn>;
+    };
+    /** Where the rows that are *not* on screen are — and how tall a row that
+     *  has never been drawn is assumed to be. */
+    heights: RowHeights;
+}
+export interface Reveal {
+    /** Owe a scroll to this row, and try to pay it now. */
+    to(id: RowKey): void;
+    /**
+     * The content above the viewport just changed size by `px` — measurements
+     * came in — and the offset must absorb the difference or what is on screen
+     * jumps. A debt rather than a one-shot for the same reason a reveal is:
+     * the pane clamps against the content height of the *last* layout, so a
+     * nudge made just after rows above grew taller lands short — near the
+     * bottom of the list, all of it lands short — and the remainder must be
+     * re-tried once the layout that admits the growth has run. Retried by
+     * `retry`, dropped by `heard`: a user mid-scroll keeps the pane.
+     */
+    nudge(px: number): void;
+    /**
+     * Try again: after a layout, or when the content changed size.
+     *
+     * Pass `provisional` on a pass where the height index just moved. The rows
+     * are still laid out at the heights it no longer believes, so a row that
+     * looks in view is not proof of anything yet — a row measured taller than
+     * the guess pushes everything after it down, and the row that was reached a
+     * moment ago ends up under the fold. The debt is kept until a pass that
+     * measured nothing new confirms it, which is exactly when the heights have
+     * converged.
+     */
+    retry(provisional?: boolean): void;
+    /** Scroll the pane, recording that this component is the one that asked. */
+    scrollTo(y: number): void;
+    /** An `onScroll` arrived. One this component did not ask for is the user
+     *  taking over, and it cancels whatever was owed. */
+    heard(scrollY: number): void;
+}
+/**
+ * The scroll a component owes a row, and the bookkeeping that pays it.
+ *
+ * Stable across renders — every method reads through the refs it was handed,
+ * so an event handler or a layout tick built in an earlier render still sees
+ * the current rows.
+ */
+export declare function useReveal(sources: RevealSources): Reveal;
+export {};
+//# sourceMappingURL=scroll.d.ts.map

package/dist/internal/scroll.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scroll.d.ts","sourceRoot":"","sources":["../../src/internal/scroll.ts"],"names":[],"mappings":"AAyCA,OAAO,KAAK,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAE3D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAIvD,+EAA+E;AAC/E,UAAU,KAAK;IACb,EAAE,EAAE,MAAM,CAAC;CACZ;AAED;qDACqD;AACrD,UAAU,KAAK;IACb,IAAI,EAAE,SAAS,CAAC;IAChB,EAAE,EAAE,MAAM,CAAC;CACZ;AAED;6EAC6E;AAC7E,MAAM,WAAW,aAAa;IAC5B,8DAA8D;IAC9D,GAAG,EAAE;QAAE,QAAQ,CAAC,OAAO,EAAE,cAAc,GAAG,IAAI,CAAA;KAAE,CAAC;IACjD,iCAAiC;IACjC,IAAI,EAAE;QAAE,QAAQ,CAAC,OAAO,EAAE,SAAS,KAAK,EAAE,CAAA;KAAE,CAAC;IAC7C,iCAAiC;IACjC,KAAK,EAAE;QAAE,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC,MAAM,EAAE,KAAK,CAAC,CAAA;KAAE,CAAC;IACxD;iDAC6C;IAC7C,OAAO,EAAE,UAAU,CAAC;CACrB;AAED,MAAM,WAAW,MAAM;IACrB,uDAAuD;IACvD,EAAE,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB;;;;;;;;;OASG;IACH,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB;;;;;;;;;;OAUG;IACH,KAAK,CAAC,WAAW,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IACnC,4EAA4E;IAC5E,QAAQ,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B;yDACqD;IACrD,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B;AAED;;;;;;GAMG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,aAAa,GAAG,MAAM,CAsOxD"}

package/dist/internal/scroll.js

@@ -0,0 +1,264 @@
+// Scrolling a row into view, when neither the row nor the scroll pane is
+// ready to be asked yet.
+//
+// **Shared between `<Tree>` and `<Table>`** — the third piece both
+// virtualizers stand on, beside `./heights.ts` and `./timers.ts`, and here
+// for the same reason: the logic is subtle, it is identical in both, and a
+// second copy of it is a second place for the bug below to come back.
+//
+// Two things a scroll pane does silently, both of them in the gap between a
+// commit and the layout it causes, and both of them enough on their own to
+// leave a virtualized list drawing rows the viewport is no longer looking at:
+//
+//   1. **`scrollTo` clamps against the content height the *last* layout
+//      measured.** A row appended in the commit now being laid out is past
+//      the bottom that clamp knows about, so the request lands short — and
+//      short *for good*, because nothing about it is retried. That is the
+//      live tail: a list that scrolls to its newest row on every update and
+//      settles one update behind, permanently. On mount, where no content
+//      has been laid out at all, the scroll simply never happens.
+//
+//   2. **The pane moves without saying so.** It resolves a queued
+//      `scrollIntoView` during layout, and it re-clamps an offset the
+//      content has outgrown or outshrunk — neither of which fires
+//      `onScroll`. A component that learns the offset only from that event
+//      keeps building its slice from where the pane *was*: the rows are
+//      drawn off-viewport, there is a blank band where they should be, and
+//      nothing puts it right until a scroll of your own re-syncs it by
+//      accident.
+//
+// So a reveal here is not a one-shot: it is a **debt**, kept by row id,
+// attempted at once and re-tried on the layout that makes the rest of the
+// move possible. It is dropped as soon as the row is in view, leaves the
+// list, or the user scrolls somewhere themselves — an owed scroll must never
+// yank the list back out from under a hand on the wheel.
+//
+// The offset is read back from the pane rather than trusted to the event;
+// `useReveal` does not do that itself, because what a component *does* with
+// the offset differs (a slice to rebuild, a header to shift), but it is the
+// other half of the same fix and both components run it on the same tick.
+import { useCallback, useEffect, useMemo, useRef } from 'react';
+import { afterLayout, cancelAfterLayout } from './timers.js';
+/**
+ * The scroll a component owes a row, and the bookkeeping that pays it.
+ *
+ * Stable across renders — every method reads through the refs it was handed,
+ * so an event handler or a layout tick built in an earlier render still sees
+ * the current rows.
+ */
+export function useReveal(sources) {
+    const src = useRef(sources);
+    src.current = sources;
+    /** The row still owed a scroll, by id. */
+    const owed = useRef(null);
+    /**
+     * The row the last reveal settled on, kept for one reason: a measurement
+     * pass can move the heights that settlement was judged against. A row that
+     * was in view when the debt was paid is not in view any more once the rows
+     * around it turn out taller than the index believed, and the honest answer
+     * to "is that still true?" is to owe it again and look. Measurement
+     * converges, so this stops asking.
+     */
+    const settled = useRef(null);
+    /** The offset the last scroll *this component* asked for, so the
+     *  `onScroll` that answers it is not read as the user taking over. */
+    const asked = useRef(null);
+    /**
+     * What the pane looked like at the last attempt that could not move.
+     *
+     * An attempt clamped by a content height that is a layout out of date has
+     * to be looked at again — and nothing else will schedule that look: the
+     * scroll that did not happen renders nothing, so the component's own tick
+     * after layout never comes. One is queued here instead, and only while the
+     * pane keeps changing under it: an attempt that finds the same offset and
+     * the same content as the last one has nothing new to try, and stops.
+     */
+    const stuck = useRef(null);
+    const look = useRef(null);
+    useEffect(() => () => cancelAfterLayout(look.current), []);
+    /** Pixels the pane still owes the content that grew or shrank above the
+     *  viewport — the unpaid remainder of `nudge`. */
+    const owedShift = useRef(0);
+    const scrollTo = useCallback((y) => {
+        const box = src.current.box.current;
+        if (!box)
+            return;
+        // Clamped here rather than left to the container, so what comes back on
+        // `onScroll` is the number that was asked for and can be recognised.
+        const to = Math.min(Math.max(0, y), Math.max(0, box.contentHeight - box.abs.height));
+        if (to === box.scrollY)
+            return;
+        asked.current = to;
+        box.scrollTo({ y: to });
+    }, []);
+    /** Pay as much of the owed shift as the pane will take right now. What it
+     *  refuses — a clamp still measuring the last layout's content — stays
+     *  owed, and the `retry` after the next layout tries again. */
+    const payShift = useCallback(() => {
+        const box = src.current.box.current;
+        const want = owedShift.current;
+        if (!box || want === 0)
+            return;
+        const was = box.scrollY;
+        scrollTo(was + want);
+        owedShift.current = want - (box.scrollY - was);
+    }, [scrollTo]);
+    const nudge = useCallback((px) => {
+        // Either the reveal owns the pane or the anchor does. While a row is
+        // owed — or settled and still being confirmed — the reveal re-places
+        // it against the heights as they settle, so preserving the anchor
+        // would fight it: a remainder paid out after the reveal has already
+        // put its row where it belongs scrolls straight past it.
+        if (owed.current !== null || settled.current !== null)
+            return;
+        if (px === 0)
+            return;
+        owedShift.current += px;
+        payShift();
+    }, [payShift]);
+    const retry = useCallback((provisional) => {
+        const { box: boxRef, rows: rowsRef, nodes, heights } = src.current;
+        const box = boxRef.current;
+        // The shift first: the reveal below judges placement from the offset,
+        // and an offset still owing the content above it is the wrong one to
+        // judge anything from.
+        payShift();
+        // The heights just moved, so what the last reveal settled on was settled
+        // against numbers that have changed: owe it again until it can be
+        // confirmed at the new ones.
+        if (provisional && owed.current === null)
+            owed.current = settled.current;
+        const id = owed.current;
+        if (!box || id === null)
+            return;
+        const rows = rowsRef.current;
+        const at = rows.findIndex((r) => r.id === id);
+        if (at < 0) {
+            // the row left the list
+            owed.current = null;
+            settled.current = null;
+            return;
+        }
+        const viewport = box.abs.height;
+        if (viewport <= 0)
+            return; // nothing laid out to scroll inside yet
+        // How far the row is outside the pane, in pixels of scrolling. The row's
+        // own rect answers when it is mounted — it knows what it really laid out
+        // at, and the arithmetic stays in screen coordinates, so a pane with
+        // padding on it needs no correction. The height index answers when the
+        // row is not mounted, which while virtualizing is the normal case.
+        const drawn = nodes.current.get(id);
+        const mounted = drawn && drawn.node.abs.height > 0 && rows[drawn.at]?.id === id
+            ? drawn.node
+            : null;
+        const placed = mounted
+            ? {
+                above: box.abs.y - mounted.abs.y,
+                below: mounted.abs.y + mounted.abs.height - (box.abs.y + viewport),
+                height: mounted.abs.height,
+            }
+            : {
+                above: box.scrollY - heights.offsetAt(at),
+                below: heights.offsetAt(at) +
+                    heights.heightAt(at) -
+                    (box.scrollY + viewport),
+                height: heights.heightAt(at),
+            };
+        /**
+         * Whether this is worth *settling* on, or only worth acting on.
+         *
+         * Two ways a row can look in view and not stay there. Its own placement
+         * may be a guess — the index's answer for a row nothing has measured —
+         * and "in view" judged from a guess is how a tail lands short of a bottom
+         * that has not been measured yet. Or a row *between* the viewport and it
+         * may still be a guess, and every one of those that turns out taller than
+         * the index believed pushes this row down by the difference, out of the
+         * view it had just been brought into.
+         *
+         * Both are settled by the same thing: measurement converges, so the rows
+         * that matter stop being guesses. A component that measures nothing at all
+         * has no guesses to wait on — `hasMeasurements` is how that is told
+         * apart, and it is what keeps a declared-uniform table from owing a debt
+         * for ever.
+         */
+        let certain = mounted !== null || heights.isMeasured(at);
+        if (certain && heights.hasMeasurements()) {
+            const from = Math.min(at, heights.indexAt(box.scrollY));
+            const to = Math.max(at, heights.indexAt(box.scrollY + viewport));
+            for (let i = from; i <= to && certain; i++) {
+                certain = heights.isMeasured(i);
+            }
+        }
+        let move = 0;
+        if (placed.height >= viewport) {
+            // A row taller than the pane is never *fully* in view, and asking for
+            // both its edges in turn is a debt that alternates for ever. Its top is
+            // the part worth showing — a wrapped row reads from its first line —
+            // and arriving there settles it.
+            move = -placed.above;
+        }
+        else if (placed.above > 0)
+            move = -placed.above;
+        else if (placed.below > 0)
+            move = placed.below;
+        if (move === 0) {
+            // As far in view as it can be — settled, unless what that was judged
+            // against is still moving: a placement that came from a guess, or a
+            // pass that has just changed the heights under it.
+            if (certain && !provisional) {
+                settled.current = id;
+                owed.current = null;
+            }
+            return;
+        }
+        // A move the pane cannot make yet leaves the debt standing: the layout
+        // that admits the rows just appended is the one that will let it finish.
+        const was = box.scrollY;
+        scrollTo(was + move);
+        if (box.scrollY !== was) {
+            stuck.current = null; // it moved; the scroll it caused brings us back
+            return;
+        }
+        const seen = stuck.current;
+        const now = { y: box.scrollY, content: box.contentHeight };
+        stuck.current = now;
+        if (seen && seen.y === now.y && seen.content === now.content)
+            return;
+        cancelAfterLayout(look.current);
+        look.current = afterLayout(() => {
+            look.current = null;
+            retryRef.current?.();
+        });
+    }, [scrollTo, payShift]);
+    /** `retry` referring to itself through a ref, so the queued look calls the
+     *  current one rather than closing over the render that queued it. */
+    const retryRef = useRef(null);
+    retryRef.current = retry;
+    const to = useCallback((id) => {
+        // Recorded before the attempt rather than after it, because the
+        // interesting case is the one that cannot succeed yet.
+        owed.current = id;
+        settled.current = null;
+        stuck.current = null;
+        // the reveal owns the pane now — see `nudge`
+        owedShift.current = 0;
+        retry();
+    }, [retry]);
+    const heard = useCallback((scrollY) => {
+        // A scroll this component did not ask for ends the whole chase, not just
+        // the outstanding half of it.
+        if (scrollY !== asked.current) {
+            owed.current = null;
+            settled.current = null;
+            owedShift.current = 0;
+        }
+        asked.current = null;
+    }, []);
+    // One stable object, not a fresh literal per render: callbacks built on
+    // this handle (`revealAt`, and the row handlers behind it) keep their
+    // identity, which is what lets a memoized row bail out of a scroll
+    // render. A literal here made every row re-render on every notch — the
+    // exact cost the memo exists to remove — with nothing anywhere naming it.
+    return useMemo(() => ({ to, retry, scrollTo, nudge, heard }), [to, retry, scrollTo, nudge, heard]);
+}
+//# sourceMappingURL=scroll.js.map

package/dist/internal/scroll.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scroll.js","sourceRoot":"","sources":["../../src/internal/scroll.ts"],"names":[],"mappings":"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"}

package/dist/internal/timers.d.ts

@@ -5,4 +5,12 @@ export type LayoutTick = {
 /** Run `fn` after the layout pass this commit will cause. */
 export declare function afterLayout(fn: () => void): LayoutTick;
 export declare function cancelAfterLayout(tick: LayoutTick): void;
+export type DelayTick = {
+    id: unknown;
+} | null;
+/** Run `fn` after `ms` — the idle clock prefetch paces itself on. Typed here
+ *  for the same reason `afterLayout` is: `src/` compiles with `types: []`,
+ *  and a bare `setTimeout` would demand `@types/node`. */
+export declare function later(fn: () => void, ms: number): DelayTick;
+export declare function cancelLater(tick: DelayTick): void;
 //# sourceMappingURL=timers.d.ts.map

package/dist/internal/timers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"timers.d.ts","sourceRoot":"","sources":["../../src/internal/timers.ts"],"names":[],"mappings":"AA0BA,MAAM,MAAM,UAAU,GAAG;IAAE,SAAS,EAAE,OAAO,CAAC;IAAC,EAAE,EAAE,OAAO,CAAA;CAAE,GAAG,IAAI,CAAC;AAEpE,6DAA6D;AAC7D,wBAAgB,WAAW,CAAC,EAAE,EAAE,MAAM,IAAI,GAAG,UAAU,CAQtD;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI,CAIxD"}
+{"version":3,"file":"timers.d.ts","sourceRoot":"","sources":["../../src/internal/timers.ts"],"names":[],"mappings":"AA0BA,MAAM,MAAM,UAAU,GAAG;IAAE,SAAS,EAAE,OAAO,CAAC;IAAC,EAAE,EAAE,OAAO,CAAA;CAAE,GAAG,IAAI,CAAC;AAEpE,6DAA6D;AAC7D,wBAAgB,WAAW,CAAC,EAAE,EAAE,MAAM,IAAI,GAAG,UAAU,CAQtD;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI,CAIxD;AAED,MAAM,MAAM,SAAS,GAAG;IAAE,EAAE,EAAE,OAAO,CAAA;CAAE,GAAG,IAAI,CAAC;AAE/C;;0DAE0D;AAC1D,wBAAgB,KAAK,CAAC,EAAE,EAAE,MAAM,IAAI,EAAE,EAAE,EAAE,MAAM,GAAG,SAAS,CAE3D;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,SAAS,GAAG,IAAI,CAEjD"}

package/dist/internal/timers.js

@@ -19,4 +19,14 @@ export function cancelAfterLayout(tick) {
     else
         g.clearTimeout?.(tick.id);
 }
+/** Run `fn` after `ms` — the idle clock prefetch paces itself on. Typed here
+ *  for the same reason `afterLayout` is: `src/` compiles with `types: []`,
+ *  and a bare `setTimeout` would demand `@types/node`. */
+export function later(fn, ms) {
+    return g.setTimeout ? { id: g.setTimeout(fn, ms) } : null;
+}
+export function cancelLater(tick) {
+    if (tick)
+        g.clearTimeout?.(tick.id);
+}
 //# sourceMappingURL=timers.js.map

package/dist/internal/timers.js.map

@@ -1 +1 @@
-{"version":3,"file":"timers.js","sourceRoot":"","sources":["../../src/internal/timers.ts"],"names":[],"mappings":"AAwBA,MAAM,CAAC,GAAG,UAAsB,CAAC;AAIjC,6DAA6D;AAC7D,MAAM,UAAU,WAAW,CAAC,EAAc;IACxC,yEAAyE;IACzE,2EAA2E;IAC3E,oEAAoE;IACpE,wEAAwE;IACxE,IAAI,CAAC,CAAC,YAAY;QAAE,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC,YAAY,CAAC,EAAE,CAAC,EAAE,CAAC;IACvE,IAAI,CAAC,CAAC,UAAU;QAAE,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,CAAC,UAAU,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC;IACvE,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,IAAgB;IAChD,IAAI,CAAC,IAAI;QAAE,OAAO;IAClB,IAAI,IAAI,CAAC,SAAS;QAAE,CAAC,CAAC,cAAc,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;;QAC3C,CAAC,CAAC,YAAY,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AACjC,CAAC"}
+{"version":3,"file":"timers.js","sourceRoot":"","sources":["../../src/internal/timers.ts"],"names":[],"mappings":"AAwBA,MAAM,CAAC,GAAG,UAAsB,CAAC;AAIjC,6DAA6D;AAC7D,MAAM,UAAU,WAAW,CAAC,EAAc;IACxC,yEAAyE;IACzE,2EAA2E;IAC3E,oEAAoE;IACpE,wEAAwE;IACxE,IAAI,CAAC,CAAC,YAAY;QAAE,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC,YAAY,CAAC,EAAE,CAAC,EAAE,CAAC;IACvE,IAAI,CAAC,CAAC,UAAU;QAAE,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,CAAC,UAAU,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC;IACvE,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,IAAgB;IAChD,IAAI,CAAC,IAAI;QAAE,OAAO;IAClB,IAAI,IAAI,CAAC,SAAS;QAAE,CAAC,CAAC,cAAc,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;;QAC3C,CAAC,CAAC,YAAY,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AACjC,CAAC;AAID;;0DAE0D;AAC1D,MAAM,UAAU,KAAK,CAAC,EAAc,EAAE,EAAU;IAC9C,OAAO,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,UAAU,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;AAC5D,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,IAAe;IACzC,IAAI,IAAI;QAAE,CAAC,CAAC,YAAY,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AACtC,CAAC"}