@react-x11/components 0.1.0 → 0.2.1

package/dist/internal/heights.js

@@ -0,0 +1,203 @@
+// Where every row starts, when rows are not all the same height.
+//
+// **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
+// guards (`test/docs.test.ts`, `scripts/check-package.ts`) key on
+// `src/<name>/index.ts`, and that is the seam this uses. The day an app
+// outside this package needs a height index of its own, the promotion is
+// mechanical: give the directory an `index.ts` and the full shared-module
+// treatment (subpath, page, barrel), the way `richtext` has it.
+//
+// The id-keying earns its place twice: in the tree a measured height
+// survives a collapse and re-expand, and in the table it survives a
+// **re-sort** — the permutation rebuilds offsets without remeasuring a
+// single row.
+//
+// A fixed-height list needs no structure at all: row `i` is at `i * h`, and
+// the row at offset `y` is `y / h`. That one multiplication is the whole
+// reason fixed-height virtualization is easy, and it is what this file
+// replaces — because a tree row wraps, carries two lines, or is whatever a
+// render seam returned, and demanding that they all match would be the
+// component telling the application what its data may look like.
+//
+// What replaces it has to answer three questions on every scroll, over a
+// list that may be a hundred thousand rows long:
+//
+//   - where does row `i` start?           `offsetAt`
+//   - which row is at offset `y`?         `indexAt`
+//   - how tall is the whole thing?        `total`
+//
+// A prefix-sum array answers the first and third in O(1) but costs O(n) per
+// measurement, and measurements arrive in bursts — every row that scrolls
+// into view is one. A Fenwick tree (binary indexed tree) answers all three in
+// O(log n) and updates in O(log n), which is what makes "measure the rows
+// that just appeared, then re-render" affordable at any size.
+/**
+ * The heights of the rows, and where each one starts.
+ *
+ * Mutable and long-lived: one of these belongs to a component for as long
+ * as it is mounted, and `sync` re-points it at the rows a render is about
+ * to draw. It is deliberately **not** React state — a measurement pass
+ * touches it once per rendered row and the component re-renders once, on a
+ * version counter, and only when something actually moved.
+ */
+export class RowHeights {
+    /** Measured heights, by row id. Survives `sync`. */
+    measured = new Map();
+    /** The rows currently indexed, in draw order. */
+    rows = [];
+    /** Fenwick tree over the heights, 1-based. */
+    tree = [0];
+    /** What an unmeasured row is assumed to be. */
+    estimate = 1;
+    /** 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);
+    }
+    heightOf(index) {
+        const measured = this.measured.get(this.rows[index].id);
+        return measured === undefined ? this.estimate : measured;
+    }
+    /**
+     * Point the index at the rows about to be drawn.
+     *
+     * Rebuilt rather than patched, and cheap to call on every render: the row
+     * list is memoized, so the common case is an identity check. When it does
+     * rebuild it is O(n) — the rows change when a branch opens, when items
+     * arrive, when a sort flips, when a filter runs, all O(n) events already.
+     */
+    sync(rows, estimate) {
+        const next = Math.max(1, estimate);
+        if (!this.dirty && this.rows === rows && next === this.estimate)
+            return;
+        this.dirty = false;
+        this.rows = rows;
+        this.estimate = next;
+        const n = 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.
+        const tree = new Array(n + 1).fill(0);
+        for (let i = 0; i < n; i++)
+            tree[i + 1] = this.heightOf(i);
+        for (let i = 1; i <= n; i++) {
+            const parent = i + (i & -i);
+            if (parent <= n)
+                tree[parent] += tree[i];
+        }
+        this.tree = tree;
+        this.power = n > 0 ? 1 << Math.floor(Math.log2(n)) : 0;
+    }
+    /**
+     * Record what a row actually laid out at. Returns whether this changed
+     * anything — which is what tells the component whether to re-render, and
+     * the reason a measurement pass that finds nothing new costs nothing.
+     */
+    measure(id, index, height) {
+        if (!(height > 0))
+            return false;
+        const before = this.measured.get(id);
+        if (before === height)
+            return false;
+        this.measured.set(id, height);
+        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
+            // corrupt every offset after it, so the tree is rebuilt instead.
+            this.dirty = true;
+            return true;
+        }
+        const delta = height - (before === undefined ? this.estimate : before);
+        if (delta === 0)
+            return false;
+        for (let i = index + 1; i < this.tree.length; i += i & -i) {
+            this.tree[i] += delta;
+        }
+        return true;
+    }
+    /** What a row measured, or the estimate if it has not been seen. */
+    heightAt(index) {
+        return index >= 0 && index < this.rows.length ? this.heightOf(index) : 0;
+    }
+    /** Whether this row has a real measurement rather than an estimate. */
+    isMeasured(index) {
+        const row = this.rows[index];
+        return row !== undefined && this.measured.has(row.id);
+    }
+    /** Where row `index` starts. `offsetAt(rowCount)` is the total. */
+    offsetAt(index) {
+        let sum = 0;
+        for (let i = Math.max(0, Math.min(index, this.rows.length)); i > 0; i -= i & -i) {
+            sum += this.tree[i];
+        }
+        return sum;
+    }
+    /** How tall the whole list is — what the scrollbar measures. */
+    total() {
+        return this.offsetAt(this.rows.length);
+    }
+    /**
+     * The row containing `offset`, clamped into the list.
+     *
+     * A descent down the tree rather than a binary search over `offsetAt`,
+     * which would be O(log² n) — this is the operation every scroll performs,
+     * twice.
+     */
+    indexAt(offset) {
+        const n = this.rows.length;
+        if (n === 0)
+            return 0;
+        let index = 0;
+        let remaining = offset;
+        for (let step = this.power; step > 0; step >>= 1) {
+            const next = index + step;
+            if (next <= n && this.tree[next] <= remaining) {
+                index = next;
+                remaining -= this.tree[next];
+            }
+        }
+        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;
+        for (const row of this.rows)
+            if (this.measured.has(row.id))
+                count++;
+        return count;
+    }
+    /**
+     * Forget every measurement, keeping the row list.
+     *
+     * For a change that invalidates heights wholesale rather than row by row.
+     * Nothing calls it for new items — their ids are simply not in the map yet
+     * — and nothing calls it on a resize either: rows re-measure as they are
+     * drawn, and throwing away the heights of rows whose content does not
+     * depend on the width would make the scrollbar worse, not better.
+     */
+    reset() {
+        this.measured.clear();
+        this.dirty = true;
+    }
+}
+//# sourceMappingURL=heights.js.map

package/dist/internal/heights.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"heights.js","sourceRoot":"","sources":["../../src/internal/heights.ts"],"names":[],"mappings":"AAAA,iEAAiE;AACjE,EAAE;AACF,2EAA2E;AAC3E,4EAA4E;AAC5E,uEAAuE;AACvE,0EAA0E;AAC1E,0EAA0E;AAC1E,MAAM;AACN,EAAE;AACF,2EAA2E;AAC3E,yEAAyE;AACzE,kEAAkE;AAClE,wEAAwE;AACxE,yEAAyE;AACzE,0EAA0E;AAC1E,gEAAgE;AAChE,EAAE;AACF,qEAAqE;AACrE,oEAAoE;AACpE,uEAAuE;AACvE,cAAc;AACd,EAAE;AACF,4EAA4E;AAC5E,yEAAyE;AACzE,uEAAuE;AACvE,2EAA2E;AAC3E,uEAAuE;AACvE,iEAAiE;AACjE,EAAE;AACF,yEAAyE;AACzE,iDAAiD;AACjD,EAAE;AACF,qDAAqD;AACrD,oDAAoD;AACpD,kDAAkD;AAClD,EAAE;AACF,4EAA4E;AAC5E,0EAA0E;AAC1E,8EAA8E;AAC9E,0EAA0E;AAC1E,8DAA8D;AAc9D;;;;;;;;GAQG;AACH,MAAM,OAAO,UAAU;IACrB,oDAAoD;IACnC,QAAQ,GAAG,IAAI,GAAG,EAAkB,CAAC;IACtD,iDAAiD;IACzC,IAAI,GAAqB,EAAE,CAAC;IACpC,8CAA8C;IACtC,IAAI,GAAa,CAAC,CAAC,CAAC,CAAC;IAC7B,+CAA+C;IACvC,QAAQ,GAAG,CAAC,CAAC;IACrB,wEAAwE;IAChE,KAAK,GAAG,CAAC,CAAC;IAClB;uEACmE;IAC3D,KAAK,GAAG,KAAK,CAAC;IAEtB,YAAY,QAAgB;QAC1B,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC;IACxC,CAAC;IAEO,QAAQ,CAAC,KAAa;QAC5B,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC;QACxD,OAAO,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC;IAC3D,CAAC;IAED;;;;;;;OAOG;IACH,IAAI,CAAC,IAAsB,EAAE,QAAgB;QAC3C,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC;QACnC,IAAI,CAAC,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,IAAI,KAAK,IAAI,IAAI,IAAI,KAAK,IAAI,CAAC,QAAQ;YAAE,OAAO;QACxE,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC;QACrB,MAAM,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC;QACtB,yEAAyE;QACzE,wEAAwE;QACxE,4BAA4B;QAC5B,MAAM,IAAI,GAAG,IAAI,KAAK,CAAS,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAC9C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE;YAAE,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;QAC3D,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;YAC5B,MAAM,MAAM,GAAG,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;YAC5B,IAAI,MAAM,IAAI,CAAC;gBAAE,IAAI,CAAC,MAAM,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC;QAC3C,CAAC;QACD,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,KAAK,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACzD,CAAC;IAED;;;;OAIG;IACH,OAAO,CAAC,EAAU,EAAE,KAAa,EAAE,MAAc;QAC/C,IAAI,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC;YAAE,OAAO,KAAK,CAAC;QAChC,MAAM,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACrC,IAAI,MAAM,KAAK,MAAM;YAAE,OAAO,KAAK,CAAC;QACpC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;QAC9B,IAAI,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,EAAE,KAAK,EAAE,EAAE,CAAC;YAChC,mEAAmE;YACnE,uEAAuE;YACvE,iEAAiE;YACjE,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;YAClB,OAAO,IAAI,CAAC;QACd,CAAC;QACD,MAAM,KAAK,GAAG,MAAM,GAAG,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;QACvE,IAAI,KAAK,KAAK,CAAC;YAAE,OAAO,KAAK,CAAC;QAC9B,KAAK,IAAI,CAAC,GAAG,KAAK,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC;YAC1D,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC;QACxB,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,oEAAoE;IACpE,QAAQ,CAAC,KAAa;QACpB,OAAO,KAAK,IAAI,CAAC,IAAI,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC3E,CAAC;IAED,uEAAuE;IACvE,UAAU,CAAC,KAAa;QACtB,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC7B,OAAO,GAAG,KAAK,SAAS,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IACxD,CAAC;IAED,mEAAmE;IACnE,QAAQ,CAAC,KAAa;QACpB,IAAI,GAAG,GAAG,CAAC,CAAC;QACZ,KACE,IAAI,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,EACtD,CAAC,GAAG,CAAC,EACL,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EACX,CAAC;YACD,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACtB,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC;IAED,gEAAgE;IAChE,KAAK;QACH,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACzC,CAAC;IAED;;;;;;OAMG;IACH,OAAO,CAAC,MAAc;QACpB,MAAM,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC;QAC3B,IAAI,CAAC,KAAK,CAAC;YAAE,OAAO,CAAC,CAAC;QACtB,IAAI,KAAK,GAAG,CAAC,CAAC;QACd,IAAI,SAAS,GAAG,MAAM,CAAC;QACvB,KAAK,IAAI,IAAI,GAAG,IAAI,CAAC,KAAK,EAAE,IAAI,GAAG,CAAC,EAAE,IAAI,KAAK,CAAC,EAAE,CAAC;YACjD,MAAM,IAAI,GAAG,KAAK,GAAG,IAAI,CAAC;YAC1B,IAAI,IAAI,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,SAAS,EAAE,CAAC;gBAC9C,KAAK,GAAG,IAAI,CAAC;gBACb,SAAS,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAC/B,CAAC;QACH,CAAC;QACD,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC;IAC7C,CAAC;IAED;;;;;OAKG;IACH,eAAe;QACb,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI,GAAG,CAAC,CAAC;IAChC,CAAC;IAED,4DAA4D;IAC5D,aAAa;QACX,IAAI,KAAK,GAAG,CAAC,CAAC;QACd,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,IAAI;YAAE,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;gBAAE,KAAK,EAAE,CAAC;QACpE,OAAO,KAAK,CAAC;IACf,CAAC;IAED;;;;;;;;OAQG;IACH,KAAK;QACH,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;QACtB,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;IACpB,CAAC;CACF"}

package/dist/internal/hx.d.ts

@@ -0,0 +1,24 @@
+import type { Key, ReactElement, ReactNode } from 'react';
+import type { ReactX11Elements, Theme } from 'react-x11';
+/** The host elements, by name. */
+export type Host = ReactX11Elements;
+/**
+ * What every element takes on top of its own props.
+ *
+ * `theme` is honoured by **every** node — `Node.theme` merges `props.theme`
+ * over the inherited palette, whatever the kind — but react-x11's element
+ * declarations only put it on `<window>`. A widget re-declares the theme it
+ * read from context onto its own root so that `$token` values still resolve
+ * inside a `<popup>`, which is a separate window and does not inherit the
+ * trigger's node tree. So the prop is real; only the declaration is narrow.
+ */
+interface CommonProps {
+    key?: Key;
+    /** `Theme` is listed alongside the record because it is an interface, and
+     *  an interface has no implicit index signature — so the palette `useTheme`
+     *  hands back is not assignable to the record react-x11 declares. */
+    theme?: Theme | Record<string, string | number>;
+}
+export declare function hx<K extends keyof Host>(type: K, props?: (Omit<Host[K], 'theme'> & CommonProps) | null, ...children: ReactNode[]): ReactElement;
+export {};
+//# sourceMappingURL=hx.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"hx.d.ts","sourceRoot":"","sources":["../../src/internal/hx.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,GAAG,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAC1D,OAAO,KAAK,EAAE,gBAAgB,EAAE,KAAK,EAAE,MAAM,WAAW,CAAC;AAEzD,kCAAkC;AAClC,MAAM,MAAM,IAAI,GAAG,gBAAgB,CAAC;AAEpC;;;;;;;;;GASG;AACH,UAAU,WAAW;IACnB,GAAG,CAAC,EAAE,GAAG,CAAC;IACV;;yEAEqE;IACrE,KAAK,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,CAAC;CACjD;AAED,wBAAgB,EAAE,CAAC,CAAC,SAAS,MAAM,IAAI,EACrC,IAAI,EAAE,CAAC,EAIP,KAAK,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,GAAG,WAAW,CAAC,GAAG,IAAI,EACrD,GAAG,QAAQ,EAAE,SAAS,EAAE,GACvB,YAAY,CAKd"}

package/dist/internal/hx.js

@@ -0,0 +1,27 @@
+// `React.createElement`, typed against react-x11's host elements.
+//
+// The library writes `h(...)` rather than JSX — a convention inherited from
+// core, and worth keeping so moving code between the two repos stays a
+// rename. Shared by every composed widget out here (`<Calendar>`,
+// `<DatePicker>`, `<ColorPicker>`, `<ColorField>`), which is why it sits in
+// `src/internal/` rather than in one of them. But `React.createElement`'s own overloads are `@types/react`'s, and
+// they describe the DOM: a `<box onKeyDown>` handler is checked against
+// React's `KeyboardEvent`, not react-x11's, and the whole props object is
+// measured against `DOMAttributes`. Everything interesting fails.
+//
+// So the element name is looked up in react-x11's own element table instead.
+// `hx('box', …)` gets `<box>`'s real props — `ev.keysym` on a key handler,
+// `onDraw` on a `<canvas>` — and `hx('div', …)` is an error, which is the
+// same guarantee the JSX namespace gives `examples/` and `test/types/`.
+import React from 'react';
+export function hx(type, 
+// `theme` is dropped from the element's own props before the merge:
+// `<window>` and `<popup>` already declare it, narrower, and intersecting
+// the two would demand a value satisfying both.
+props, ...children) {
+    // The cast is the whole point of the wrapper: `createElement`'s string
+    // overload insists on DOM props, and the signature above has already
+    // checked these against the element that will actually receive them.
+    return React.createElement(type, props, ...children);
+}
+//# sourceMappingURL=hx.js.map

package/dist/internal/hx.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hx.js","sourceRoot":"","sources":["../../src/internal/hx.ts"],"names":[],"mappings":"AAAA,kEAAkE;AAClE,EAAE;AACF,4EAA4E;AAC5E,uEAAuE;AACvE,kEAAkE;AAClE,4EAA4E;AAC5E,kHAAkH;AAClH,wEAAwE;AACxE,0EAA0E;AAC1E,kEAAkE;AAClE,EAAE;AACF,6EAA6E;AAC7E,2EAA2E;AAC3E,0EAA0E;AAC1E,wEAAwE;AACxE,OAAO,KAAK,MAAM,OAAO,CAAC;AAyB1B,MAAM,UAAU,EAAE,CAChB,IAAO;AACP,oEAAoE;AACpE,0EAA0E;AAC1E,gDAAgD;AAChD,KAAqD,EACrD,GAAG,QAAqB;IAExB,uEAAuE;IACvE,qEAAqE;IACrE,qEAAqE;IACrE,OAAO,KAAK,CAAC,aAAa,CAAC,IAAc,EAAE,KAAc,EAAE,GAAG,QAAQ,CAAC,CAAC;AAC1E,CAAC"}

package/dist/internal/scroll.d.ts

@@ -0,0 +1,62 @@
+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;
+    /**
+     * 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;;;;;;;;;;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,CAyLxD"}

package/dist/internal/scroll.js

@@ -0,0 +1,224 @@
+// 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, 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), []);
+    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 });
+    }, []);
+    const retry = useCallback((provisional) => {
+        const { box: boxRef, rows: rowsRef, nodes, heights } = src.current;
+        const box = boxRef.current;
+        // 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]);
+    /** `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;
+        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;
+        }
+        asked.current = null;
+    }, []);
+    return { to, retry, scrollTo, 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/text.d.ts

@@ -0,0 +1,6 @@
+/** Code point index -> UTF-16 offset, with one extra entry for the end. */
+export declare function codeUnitOffsets(text: string): number[];
+/** The code point index for a UTF-16 offset, rounded down to a whole
+ *  character. Binary search over `codeUnitOffsets`. */
+export declare function codePointAtOffset(offsets: number[], offset: number): number;
+//# sourceMappingURL=text.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"text.d.ts","sourceRoot":"","sources":["../../src/internal/text.ts"],"names":[],"mappings":"AAoBA,2EAA2E;AAC3E,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAStD;AAED;uDACuD;AACvD,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAS3E"}

package/dist/internal/text.js

@@ -0,0 +1,44 @@
+// The bits `<richtext>` and `<Html>` need that react-x11 has but does not
+// export. Same situation, and the same shape, as `src/calendar/internal.ts` —
+// each is small and pure, and if core ever puts one on its exports map,
+// delete it from here and import it. `tint` was the first to go that way: it
+// is `react-x11/style`'s now, and the surfaces here import it from there.
+//
+// It sits in `src/internal/` rather than in `src/richtext/` because two
+// things share it now — the shared module and `src/html/`'s own layout — and
+// that is exactly what this directory is for (AGENTS.md, "the half-step below
+// a shared module").
+// --- code points vs code units ---------------------------------------------
+//
+// ntk's line runs report their extent in **code units** while its caret API
+// speaks **code points**, so anything reading run geometry has to translate.
+// Core has exactly these two functions in `src/textrange.js` (react-x11#291)
+// and its `<text>` uses them for the same purpose; they are copied rather
+// than imported because that module is not on core's exports map. Delete
+// them the day it is.
+/** Code point index -> UTF-16 offset, with one extra entry for the end. */
+export function codeUnitOffsets(text) {
+    const offsets = [];
+    const s = text ?? '';
+    for (let i = 0; i < s.length;) {
+        offsets.push(i);
+        i += (s.codePointAt(i) ?? 0) > 0xffff ? 2 : 1;
+    }
+    offsets.push(s.length);
+    return offsets;
+}
+/** The code point index for a UTF-16 offset, rounded down to a whole
+ *  character. Binary search over `codeUnitOffsets`. */
+export function codePointAtOffset(offsets, offset) {
+    let lo = 0;
+    let hi = offsets.length - 1;
+    while (lo < hi) {
+        const mid = (lo + hi + 1) >> 1;
+        if (offsets[mid] <= offset)
+            lo = mid;
+        else
+            hi = mid - 1;
+    }
+    return lo;
+}
+//# sourceMappingURL=text.js.map

package/dist/internal/text.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"text.js","sourceRoot":"","sources":["../../src/internal/text.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAC1E,8EAA8E;AAC9E,wEAAwE;AACxE,6EAA6E;AAC7E,0EAA0E;AAC1E,EAAE;AACF,wEAAwE;AACxE,6EAA6E;AAC7E,8EAA8E;AAC9E,qBAAqB;AAErB,8EAA8E;AAC9E,EAAE;AACF,4EAA4E;AAC5E,6EAA6E;AAC7E,6EAA6E;AAC7E,0EAA0E;AAC1E,yEAAyE;AACzE,sBAAsB;AAEtB,2EAA2E;AAC3E,MAAM,UAAU,eAAe,CAAC,IAAY;IAC1C,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,MAAM,CAAC,GAAG,IAAI,IAAI,EAAE,CAAC;IACrB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,MAAM,GAAG,CAAC;QAC9B,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAChB,CAAC,IAAI,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAChD,CAAC;IACD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;IACvB,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;uDACuD;AACvD,MAAM,UAAU,iBAAiB,CAAC,OAAiB,EAAE,MAAc;IACjE,IAAI,EAAE,GAAG,CAAC,CAAC;IACX,IAAI,EAAE,GAAG,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC;IAC5B,OAAO,EAAE,GAAG,EAAE,EAAE,CAAC;QACf,MAAM,GAAG,GAAG,CAAC,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC;QAC/B,IAAI,OAAO,CAAC,GAAG,CAAC,IAAI,MAAM;YAAE,EAAE,GAAG,GAAG,CAAC;;YAChC,EAAE,GAAG,GAAG,GAAG,CAAC,CAAC;IACpB,CAAC;IACD,OAAO,EAAE,CAAC;AACZ,CAAC"}

package/dist/internal/timers.d.ts

@@ -0,0 +1,8 @@
+export type LayoutTick = {
+    immediate: boolean;
+    id: unknown;
+} | null;
+/** Run `fn` after the layout pass this commit will cause. */
+export declare function afterLayout(fn: () => void): LayoutTick;
+export declare function cancelAfterLayout(tick: LayoutTick): void;
+//# sourceMappingURL=timers.d.ts.map