@ex-grid/pivot 0.2.0-beta.3 → 0.2.0-rc.1

package/dist/index.js

@@ -2998,7 +2998,7 @@ import {
 } from "@ex-grid/pivot-engine";
 
 // src/report-find.ts
-import { findMatches } from "@ex-grid/core";
+import { findAllPage, findMatches } from "@ex-grid/core";
 var findBlockCells = 2e4;
 var notFound = Object.freeze({ kind: "answered", answer: Object.freeze({ found: false }) });
 var notHeld = Object.freeze({ kind: "notHeld" });
@@ -3067,6 +3067,81 @@ async function findInReport(source, metadata, request, signal) {
   }
   return notFound;
 }
+var ReportFindAllMatches = class {
+  #columns;
+  #ordinals;
+  #texts;
+  constructor(columns, ordinals, texts) {
+    this.#columns = columns;
+    this.#ordinals = ordinals;
+    this.#texts = texts;
+  }
+  /** How many cells match. */
+  get total() {
+    return this.#ordinals.length;
+  }
+  /** The entries from `start`, `count` of them or every one left, under `rowSequenceVersion`. */
+  page(start, count, rowSequenceVersion) {
+    if (!Number.isInteger(start) || start < 0) throw new RangeError(`A Find All page starts at an entry at or after 0, not ${String(start)}.`);
+    if (!Number.isInteger(count) || count < 1) throw new RangeError(`A Find All page asks for 1 entry or more, not ${String(count)}.`);
+    const columns = this.#columns.length;
+    const matches = this.#ordinals.slice(start, start + count).map((ordinal, i) => ({
+      row: Math.floor(ordinal / columns),
+      column: elementAt(this.#columns, ordinal % columns),
+      text: elementAt(this.#texts, start + i)
+    }));
+    return findAllPage(this.total, matches, rowSequenceVersion);
+  }
+};
+async function findAllInReport(source, metadata, request, signal) {
+  const rows = metadata.rowCount;
+  const known = /* @__PURE__ */ new Set([...metadata.labelColumns.map((column) => column.name), ...metadata.valueColumns.map((column) => column.name)]);
+  const read = request.columns.flatMap((name, position) => known.has(name) ? [{ name, position }] : []);
+  const columns = request.columns.length;
+  const ordinals = [];
+  const texts = [];
+  const done = () => Object.freeze({ kind: "answered", matches: new ReportFindAllMatches(Object.freeze([...request.columns]), ordinals, texts) });
+  if (request.text === "" || rows === 0 || read.length === 0) return done();
+  const { scope } = request;
+  const names = Object.freeze(read.map((column) => column.name));
+  const blockRows = Math.max(1, Math.floor(findBlockCells / names.length));
+  let first = scope === void 0 ? 0 : rows - 1;
+  let last = scope === void 0 ? rows - 1 : 0;
+  if (scope !== void 0) {
+    for (const range of scope) {
+      first = Math.min(first, Math.max(0, range.topRow));
+      last = Math.max(last, Math.min(rows - 1, range.topRow + range.rowCount - 1));
+    }
+  }
+  for (let top = first; top <= last; top += blockRows) {
+    signal.throwIfAborted();
+    const bottom = Math.min(last, top + blockRows - 1);
+    const answer = await source.copy(Object.freeze({
+      version: metadata.version,
+      columns: names,
+      ranges: Object.freeze([Object.freeze({ top, left: 0, bottom, right: names.length - 1 })]),
+      maxCells: (bottom - top + 1) * names.length
+    }), signal);
+    signal.throwIfAborted();
+    if (answer.refusal?.kind === "reportVersionNotHeld") return notHeld;
+    if (answer.refusal !== void 0) return Object.freeze({ kind: "refused", refusal: answer.refusal });
+    const block = answer.blocks[0];
+    if (answer.version !== metadata.version || answer.blocks.length !== 1 || block === void 0 || block.rows.length !== bottom - top + 1 || block.rows.some((cells) => cells.length !== names.length)) {
+      return invalid;
+    }
+    for (let row = top; row <= bottom; row++) {
+      const cells = elementAt(block.rows, row - top);
+      read.forEach(({ position }, index) => {
+        if (scope !== void 0 && !scope.some((range) => row >= range.topRow && row < range.topRow + range.rowCount && position >= range.leftColumn && position < range.leftColumn + range.columnCount)) return;
+        const { text } = elementAt(cells, index);
+        if (!findMatches(text, request)) return;
+        ordinals.push(row * columns + position);
+        texts.push(text);
+      });
+    }
+  }
+  return done();
+}
 
 // src/report-summary.ts
 import { answeredSummary, declinedSummary, summaryFigureOrder } from "@ex-grid/core";
@@ -3360,10 +3435,24 @@ function reportRows(request) {
     request.findGivenUp(read);
     throw new DOMException("The Find step over the report was given up.", "AbortError");
   };
+  let listed;
+  const findAll = async (asked, _query, signal) => {
+    const key = JSON.stringify([asked.text, asked.matchCase, asked.wholeCell, asked.scope, asked.columns]);
+    if (listed?.key !== key) {
+      const read = await findAllInReport(request.source, answered.metadata, asked, signal);
+      if (read.kind !== "answered") {
+        request.findGivenUp(read);
+        throw new DOMException("The Find All over the report was given up.", "AbortError");
+      }
+      listed = { key, matches: read.matches };
+    }
+    return listed.matches.page(asked.start, asked.count, asked.rowSequenceVersion);
+  };
   return GridSource.fetch(fetch, {
     rowKey: reportRowKey,
     readAheadRows: 60,
     find,
+    findAll,
     // The Selection Summary is the report source's, over the report the selection was made on (ADR-0130).
     summarize: (summary, _query, signal) => summarizeReport(request.source, version, summary, request.words(), signal),
     // A Window of another report is never shown beside this one's rows: the pivot asks again, and the grid
@@ -3865,6 +3954,11 @@ var PivotView = class {
   #counts;
   #countsAsked;
   #grid;
+  // The report grid's Settled Mark, held while a question under the loading indication is out (ADR-0220 section 1):
+  // the report that question brings is the effect of the move, the Consumer's layout or the Refresh that asked it,
+  // and a reading taken before it lands reads the report before. A quiet question a source's notice asked holds
+  // nothing, as it shows no loading either: a live report would otherwise never settle.
+  #loadingHold;
   #rows;
   // The grid's columns as last drawn, whose names a copy asks the report source for.
   #gridColumns = [];
@@ -4203,6 +4297,7 @@ var PivotView = class {
     this.#generation++;
     this.#asked?.controller.abort();
     this.#asked = void 0;
+    this.#holdWhileLoading();
     this.#countsAsked?.abort();
     this.#placing?.();
     this.#grid?.destroy();
@@ -4393,8 +4488,18 @@ var PivotView = class {
       toggled: focusOn
     };
     this.#asked = question;
+    this.#holdWhileLoading();
     void this.#run(question);
   }
+  // Holds the report grid's Settled Mark while a question under the loading indication is out, and lets it go once
+  // none is: called wherever the question out or the grid changes, and by every draw, which follows each landing
+  // after the grid has the report it brought.
+  #holdWhileLoading() {
+    const grid = this.#loading() ? this.#grid : void 0;
+    if (this.#loadingHold?.grid === grid) return;
+    this.#loadingHold?.release();
+    this.#loadingHold = grid === void 0 ? void 0 : { grid, release: grid.holdSettled() };
+  }
   async #run(question) {
     const current = () => question.generation === this.#generation && !this.#destroyed;
     let update;
@@ -4659,6 +4764,7 @@ var PivotView = class {
     if (answered === void 0 || !this.#reportDrawn) {
       this.#grid?.destroy();
       this.#grid = void 0;
+      this.#holdWhileLoading();
       return;
     }
     const { answer, question } = answered;
@@ -4796,6 +4902,7 @@ var PivotView = class {
     if (this.#grid === void 0) {
       if (this.#gridRoot.parentNode !== this.#sheet) this.#sheet.prepend(this.#gridRoot);
       this.#grid = this.#mountGrid(this.#gridRoot, options);
+      this.#holdWhileLoading();
     } else {
       this.#grid.update(options);
     }
@@ -5677,6 +5784,7 @@ var PivotView = class {
   }
   #draw() {
     if (this.#destroyed) return;
+    this.#holdWhileLoading();
     const words = this.#words;
     const layout = this.#paneLayout;
     const fields = this.#options.source.fields;