@ai-matrx/records-ui 0.110.4 → 0.110.5

package/dist/first-page.d.cts

@@ -339,6 +339,12 @@ declare function firstGridPageArgs(input: {
     /** The view as THIS person sees it (the saved view with her look over it), or null for none. */
     shown: SavedView | null;
     pageSize?: number;
+    /**
+     * The host draws the MERGED grid (`RecordsUiProvider grid="merged"`), which keeps a plain grouping as rows
+     * under group headers: the page is then read in group order. The classic grid opens the drill for a
+     * grouped view, so a grouped view stays unseeded there.
+     */
+    merged?: boolean;
 }): FirstGridPageArgs | null;
 /**
  * Read what the screen reads (through `client`, e.g. one served from `custom.table_page_bundle`)
@@ -346,6 +352,7 @@ declare function firstGridPageArgs(input: {
  */
 declare function firstGridPageRequest(client: Pick<RecordsClient, "tableRead" | "fields" | "views" | "viewLookRead">, tableId: Uuid, options?: {
     pageSize?: number;
+    merged?: boolean;
 }): Promise<FirstGridPageArgs | null>;
 /**
  * A TABLE PAGE'S SEED, ASKED BY THE SERVER AS THE PERSON (lane SSR-ROWS).
@@ -389,6 +396,12 @@ declare function askTablePageSeed(input: {
     /** The table is drawn EMBEDDED (`TablePage presentation="embedded"`, a Space's inline table): its page size. */
     embedded?: boolean;
     pageSize?: number;
+    /**
+     * The host draws the merged grid. A view grouped by one field (no sub-levels, pivot or drill trail) is then
+     * seeded too: the page in group order, the group counts, the summary bar, and the words of the links on the
+     * page — each asked with the arguments the grid sends, so the browser's own call finds its answer.
+     */
+    merged?: boolean;
 }): Promise<RecordsSeed>;
 
 export { EMBEDDED_PAGE_SIZE, type FirstGridPageArgs, TABLE_PAGE_SIZE, type TileSpec, askChartSeed, askEntityBlockSeed, askTablePageSeed, askTileSeed, firstGridPageArgs, firstGridPageRequest, mergeSeeds, serverRowsOf };

package/dist/first-page.d.ts

@@ -339,6 +339,12 @@ declare function firstGridPageArgs(input: {
     /** The view as THIS person sees it (the saved view with her look over it), or null for none. */
     shown: SavedView | null;
     pageSize?: number;
+    /**
+     * The host draws the MERGED grid (`RecordsUiProvider grid="merged"`), which keeps a plain grouping as rows
+     * under group headers: the page is then read in group order. The classic grid opens the drill for a
+     * grouped view, so a grouped view stays unseeded there.
+     */
+    merged?: boolean;
 }): FirstGridPageArgs | null;
 /**
  * Read what the screen reads (through `client`, e.g. one served from `custom.table_page_bundle`)
@@ -346,6 +352,7 @@ declare function firstGridPageArgs(input: {
  */
 declare function firstGridPageRequest(client: Pick<RecordsClient, "tableRead" | "fields" | "views" | "viewLookRead">, tableId: Uuid, options?: {
     pageSize?: number;
+    merged?: boolean;
 }): Promise<FirstGridPageArgs | null>;
 /**
  * A TABLE PAGE'S SEED, ASKED BY THE SERVER AS THE PERSON (lane SSR-ROWS).
@@ -389,6 +396,12 @@ declare function askTablePageSeed(input: {
     /** The table is drawn EMBEDDED (`TablePage presentation="embedded"`, a Space's inline table): its page size. */
     embedded?: boolean;
     pageSize?: number;
+    /**
+     * The host draws the merged grid. A view grouped by one field (no sub-levels, pivot or drill trail) is then
+     * seeded too: the page in group order, the group counts, the summary bar, and the words of the links on the
+     * page — each asked with the arguments the grid sends, so the browser's own call finds its answer.
+     */
+    merged?: boolean;
 }): Promise<RecordsSeed>;
 
 export { EMBEDDED_PAGE_SIZE, type FirstGridPageArgs, TABLE_PAGE_SIZE, type TileSpec, askChartSeed, askEntityBlockSeed, askTablePageSeed, askTileSeed, firstGridPageArgs, firstGridPageRequest, mergeSeeds, serverRowsOf };

package/dist/first-page.js

@@ -1,10 +1,10 @@
 import { recordingDataSource, asRecordsDataSource, createRecordsClient, mapPgError } from '@ai-matrx/records/core';
+import { isUuidShape } from '@ai-matrx/kit/uuid';
 import { PARITY_FIELD_TYPES, KERNEL_TABLES, mintOpId, fieldKindFor } from '@ai-matrx/records';
 import '@ai-matrx/kit/text-case';
 import '@ai-matrx/design-system/data-table';
 import { parseTableStyle, tableStyleIsEmpty } from '@ai-matrx/design-system/data-table/table-style';
 import '@ai-matrx/design-system/field-formats';
-import { isUuidShape } from '@ai-matrx/kit/uuid';
 import { defineChannelNamespace } from '@ai-matrx/realtime';
 
 // src/firstPage.ts
@@ -46,6 +46,20 @@ function defaultSortOf(table, fields) {
   const field = fields.find((f) => f.key === name) ?? fields.find((f) => f.id === name);
   return field ? { id: field.key, direction } : null;
 }
+var MEASURE_LABEL = {
+  count: "Count",
+  sum: "Sum",
+  avg: "Average",
+  min: "Smallest",
+  max: "Largest",
+  median: "Median",
+  filled: "Filled",
+  empty: "Empty",
+  unique: "Unique",
+  percent_empty: "Percent empty",
+  percent_filled: "Percent filled",
+  range: "Range"
+};
 function holdsNumbers(field) {
   const kind = String(editorKindFor(field));
   if (kind === "number" || kind === "currency" || kind === "percent") return true;
@@ -63,6 +77,26 @@ function pageSortFor(fields, sort) {
   if (!field) return [];
   return [{ field: field.key, direction: sort.direction === "desc" ? "desc" : "asc", as: sortAsFor(field) }];
 }
+
+// src/groupReads.ts
+function isPlainGrouping(grouping) {
+  return Boolean(grouping) && !(grouping.then && grouping.then.length > 0) && !grouping.across && !(grouping.trail && grouping.trail.length > 0);
+}
+function groupedPageSort(fields, groupKey, sort) {
+  if (!groupKey) return sort;
+  const field = fields.find((f) => f.key === groupKey);
+  if (!field) return sort;
+  return [{ field: groupKey, direction: "asc", as: sortAsFor(field) }, ...sort.filter((s) => s.field !== groupKey)];
+}
+function chosenEntries(chosen) {
+  return JSON.parse(JSON.stringify(Object.entries(chosen).sort())).filter(([, op]) => op in MEASURE_LABEL);
+}
+function groupFactMeasures(chosen) {
+  return [{ op: "count" }, ...chosenEntries(chosen).filter(([, op]) => op !== "count").map(([key, op]) => ({ op, key }))];
+}
+function summaryBarMeasures(chosen) {
+  return chosenEntries(chosen).map(([key, op]) => op === "count" ? { op: "count" } : { op, key });
+}
 var MIN_ROW_HEIGHT = 24;
 var MAX_ROW_HEIGHT = 96;
 var AGGREGATE_KINDS = [
@@ -959,7 +993,8 @@ function firstGridPageArgs(input) {
   if (shown.ruleId) return null;
   if (shown.order === "manual") return null;
   if (shown.filters && Object.keys(shown.filters).length > 0) return null;
-  if (shown.presentation?.grouping) return null;
+  const grouping = shown.presentation?.grouping;
+  if (grouping && !(input.merged && isPlainGrouping(grouping))) return null;
   const first = (shown.sorts ?? [])[0];
   const viewSort = first && fields.some((f) => f.key === first.field) ? { id: first.field, direction: first.direction } : null;
   const opening = viewSort ?? defaultSortOf(input.table, fields);
@@ -967,13 +1002,16 @@ function firstGridPageArgs(input) {
     p_table_id: input.tableId,
     p_filter: {},
     p_search: null,
-    p_sort: pageSortFor(fields, opening),
+    p_sort: groupedPageSort(fields, grouping?.field ?? null, pageSortFor(fields, opening)),
     p_view_id: null,
     p_limit: input.pageSize ?? TABLE_PAGE_SIZE,
     p_offset: 0
   };
 }
 async function firstGridPageRequest(client, tableId, options = {}) {
+  return (await firstGridOpening(client, tableId, options))?.args ?? null;
+}
+async function firstGridOpening(client, tableId, options) {
   const [table, fields, views, looks] = await Promise.all([
     client.tableRead({ table_id: tableId }),
     client.fields({ table_id: tableId }),
@@ -984,7 +1022,15 @@ async function firstGridPageRequest(client, tableId, options = {}) {
   const mine = views.data.map(viewFromRow).filter((v) => v.subject === tableId);
   const view = defaultViewOf(mine) ?? mine[0] ?? null;
   const shown = view ? applyLook(view, looks.data[view.id]) : null;
-  return firstGridPageArgs({ tableId, table: table.data, fields: fields.data, shown, ...options.pageSize ? { pageSize: options.pageSize } : {} });
+  const args = firstGridPageArgs({
+    tableId,
+    table: table.data,
+    fields: fields.data,
+    shown,
+    ...options.pageSize ? { pageSize: options.pageSize } : {},
+    ...options.merged ? { merged: true } : {}
+  });
+  return args ? { args, shown, fields: fields.data } : null;
 }
 function serverRowsOf(seed) {
   const found = seed?.answers.find((a) => a.door === "server_rows");
@@ -1006,10 +1052,11 @@ async function askTablePageSeed(input) {
   ).catch(() => null) : null;
   try {
     const pageSize = input.pageSize ?? (input.embedded ? EMBEDDED_PAGE_SIZE : TABLE_PAGE_SIZE);
-    const args = await firstGridPageRequest(client, input.tableId, { pageSize });
+    const opening = await firstGridOpening(client, input.tableId, { pageSize, ...input.merged ? { merged: true } : {} });
     const wantRows = typeof input.rows === "function" ? input.rows(recording.seed()) : input.rows !== false;
-    if (args && wantRows) {
-      await client.listPage({
+    if (opening && wantRows) {
+      const { args, shown, fields } = opening;
+      const page = await client.listPage({
         table_id: args.p_table_id,
         filter: args.p_filter,
         search: args.p_search,
@@ -1018,6 +1065,26 @@ async function askTablePageSeed(input) {
         limit: args.p_limit,
         offset: args.p_offset
       });
+      if (page.ok) {
+        const chosen = shown?.presentation?.summaries ?? {};
+        const groupKey = shown?.presentation?.grouping?.field ?? null;
+        const reads = [];
+        if (groupKey) {
+          reads.push(client.recordAggregate({ table_id: input.tableId, groupBy: [groupKey], measures: groupFactMeasures(chosen), limit: 1e3 }));
+        }
+        const bar = summaryBarMeasures(chosen);
+        if (bar.length > 0) reads.push(client.recordAggregate({ table_id: input.tableId, measures: bar }));
+        for (const field of fields) {
+          if (field.type !== "list" && field.type !== "relation") continue;
+          const ids = /* @__PURE__ */ new Set();
+          for (const row of page.data.rows) {
+            const value = row.document?.[field.key];
+            for (const id of Array.isArray(value) ? value.map(String) : typeof value === "string" ? [value] : []) if (isUuidShape(id)) ids.add(id);
+          }
+          if (ids.size > 0) reads.push(client.relationWordsMany({ field_id: field.id, record_ids: [...ids] }));
+        }
+        await Promise.all(reads.map((read) => read.catch(() => null)));
+      }
     }
   } catch {
   }