@ai-matrx/records-ui 0.110.4 → 0.110.6

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # Changelog — @ai-matrx/records-ui
 
+## 0.110.6
+
+Automatic changed-only republish (docs/metadata drift since the last tag — see
+`git diff npm/records-ui/v0.110.5..npm/records-ui/v0.110.6 -- apps/shared/records-ui`).
+No source changes intended and no consumer action required.
+
+## 0.110.5
+
+Automatic changed-only republish (docs/metadata drift since the last tag — see
+`git diff npm/records-ui/v0.110.4..npm/records-ui/v0.110.5 -- apps/shared/records-ui`).
+No source changes intended and no consumer action required.
+
 ## 0.110.4
 ### lane PERF-REVIEW-FIX
 

package/dist/first-page.cjs

@@ -1,15 +1,24 @@
 'use strict';
 
 var core = require('@ai-matrx/records/core');
+var uuid = require('@ai-matrx/kit/uuid');
+var textCase = require('@ai-matrx/kit/text-case');
 var records = require('@ai-matrx/records');
-require('@ai-matrx/kit/text-case');
-require('@ai-matrx/design-system/data-table');
+var dataTable = require('@ai-matrx/design-system/data-table');
+require('react');
 var tableStyle = require('@ai-matrx/design-system/data-table/table-style');
 require('@ai-matrx/design-system/field-formats');
-var uuid = require('@ai-matrx/kit/uuid');
 var realtime = require('@ai-matrx/realtime');
 
 // src/firstPage.ts
+function fieldName(field2) {
+  const label = (field2.label ?? "").trim();
+  if (label !== "" && label === field2.key && /^[a-z0-9]+(?:[_.-][a-z0-9]+)+$/.test(label)) return textCase.humanizeIdentifier(label);
+  if (label !== "") return label;
+  const name = (field2.name ?? "").trim();
+  if (name !== "") return name;
+  return textCase.humanizeIdentifier(field2.key);
+}
 var kernelId = (name) => records.KERNEL_TABLES.find((t) => t.name === name)?.id ?? "";
 var KERNEL_FILE_TABLE = kernelId("File");
 var KERNEL_PERSON_TABLE = kernelId("Person");
@@ -17,8 +26,8 @@ Object.fromEntries(
   records.PARITY_FIELD_TYPES.map((p) => [p.parity_type, p.made_of])
 );
 var KERNEL = { file: KERNEL_FILE_TABLE, person: KERNEL_PERSON_TABLE };
-function editorKindFor(field) {
-  return records.fieldKindFor(field, KERNEL);
+function editorKindFor(field2) {
+  return records.fieldKindFor(field2, KERNEL);
 }
 
 // src/gridLook.ts
@@ -45,25 +54,212 @@ function defaultSortOf(table, fields) {
     if (String(entry["direction"] ?? "").toLowerCase() === "desc") direction = "desc";
   }
   if (!name) return null;
-  const field = fields.find((f) => f.key === name) ?? fields.find((f) => f.id === name);
-  return field ? { id: field.key, direction } : null;
+  const field2 = fields.find((f) => f.key === name) ?? fields.find((f) => f.id === name);
+  return field2 ? { id: field2.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"
+};
+
+// src/gridPage.ts
+function filterRefusal(f) {
+  if (!computedOnRead(f)) return null;
+  return `${fieldName(f)} is worked out each time it is read, so the store keeps no value to filter the whole table by. Filter by a column it is worked out from.`;
+}
+function computedOnRead(f) {
+  const kind = String(editorKindFor(f));
+  return (f.type === "formula" || kind === "formula" || kind === "lookup" || kind === "rollup") && String(f.compute_on ?? "read") === "read";
 }
-function holdsNumbers(field) {
-  const kind = String(editorKindFor(field));
+function holdsNumbers(field2) {
+  const kind = String(editorKindFor(field2));
   if (kind === "number" || kind === "currency" || kind === "percent") return true;
-  return String((field.config ?? {})["system"] ?? "") === "autonumber";
+  return String((field2.config ?? {})["system"] ?? "") === "autonumber";
 }
-function sortAsFor(field) {
-  const kind = String(editorKindFor(field));
-  if (holdsNumbers(field)) return "number";
+function sortAsFor(field2) {
+  const kind = String(editorKindFor(field2));
+  if (holdsNumbers(field2)) return "number";
   if (kind === "datetime") return "date";
   return "text";
 }
 function pageSortFor(fields, sort) {
   if (!sort) return [];
-  const field = fields.find((f) => f.key === sort.id);
-  if (!field) return [];
-  return [{ field: field.key, direction: sort.direction === "desc" ? "desc" : "asc", as: sortAsFor(field) }];
+  const field2 = fields.find((f) => f.key === sort.id);
+  if (!field2) return [];
+  return [{ field: field2.key, direction: sort.direction === "desc" ? "desc" : "asc", as: sortAsFor(field2) }];
+}
+function containsPattern(text) {
+  return `(?i)${text.replace(/[.*+?^${}()|[\]\\]/g, "\\$&")}`;
+}
+var BLANK_VALUE = "__empty__";
+var field = (f) => ({ field: f.id });
+var constant = (value) => ({ const: value });
+var withinWindow = (f, window) => ({ op: "within", args: [field(f), constant(window)] });
+var op = (name, ...args) => ({ op: name, args });
+function clauseFor(f, value, now = /* @__PURE__ */ new Date()) {
+  const name = fieldName(f);
+  const refused = filterRefusal(f);
+  if (refused) return refused;
+  const not = (rule) => op("not", rule);
+  switch (value.kind) {
+    case "text": {
+      const mode = value.mode ?? "contains";
+      if (mode === "empty" || mode === "null") return value.negated ? { rule: op("present", field(f)) } : { rule: not(op("present", field(f))) };
+      if (mode === "not_empty" || mode === "not_null") return value.negated ? { rule: not(op("present", field(f))) } : { rule: op("present", field(f)) };
+      const text = value.value.trim();
+      if (text === "") return null;
+      const kind = String(editorKindFor(f));
+      if (kind === "number" || kind === "currency" || kind === "percent" || kind === "checkbox") {
+        return `${name} holds numbers, so it is filtered by a range, not by words.`;
+      }
+      const matches = op("matches", field(f), constant(containsPattern(text)));
+      return { rule: value.negated ? not(matches) : matches };
+    }
+    case "select": {
+      const ticked = value.values ?? (value.value === "" ? [] : [value.value]);
+      const blank = ticked.includes(BLANK_VALUE);
+      const words = ticked.filter((w) => w !== BLANK_VALUE);
+      if (!blank && words.length === 0) return value.negated ? null : { rule: constant(false) };
+      const present = op("present", field(f));
+      const kind = String(editorKindFor(f));
+      if (kind === "datetime" || kind === "date") {
+        if (words.length === 0) return { rule: value.negated ? present : not(present) };
+        const holdsDays = String((f.config ?? {})["kind"] ?? "") === "date";
+        if (words.length === 1 && !blank && !value.negated) return { flat: { [f.key]: dayWindow(words[0], holdsDays) } };
+        const leaves = words.map((day) => withinWindow(f, dayWindow(day, holdsDays)));
+        const anyDay = leaves.length === 1 ? leaves[0] : op("or", ...leaves);
+        if (!value.negated) return { rule: blank ? op("or", not(present), anyDay) : anyDay };
+        return { rule: blank ? op("and", present, not(anyDay)) : not(anyDay) };
+      }
+      const asStored = (w) => holdsNumbers(f) || kind === "rating" ? Number.isFinite(Number(w)) ? Number(w) : w : kind === "checkbox" && (w === "true" || w === "false") ? w === "true" : w;
+      const stored = words.map(asStored);
+      const anyWord = stored.length === 0 ? null : stored.length === 1 ? op("eq", field(f), constant(stored[0])) : op("or", ...stored.map((w) => op("eq", field(f), constant(w))));
+      if (!value.negated) {
+        if (!blank && stored.length === 1) return { flat: { [f.key]: stored[0] } };
+        if (!blank) return { rule: anyWord };
+        return { rule: anyWord ? op("or", not(present), anyWord) : not(present) };
+      }
+      if (blank) return { rule: anyWord ? op("and", present, not(anyWord)) : present };
+      return { rule: op("or", not(present), not(anyWord)) };
+    }
+    case "boolean":
+      return value.negated ? { rule: op("ne", field(f), constant(value.value)) } : { flat: { [f.key]: value.value } };
+    case "number": {
+      const turned = (rule) => ({ rule: value.negated ? not(rule) : rule });
+      if (value.op === "empty") return turned(not(op("present", field(f))));
+      if (value.op === "not_empty") return turned(op("present", field(f)));
+      if (value.op === "eq" || value.op === "ne") {
+        if (typeof value.min !== "number") return null;
+        return turned(op(value.op, field(f), constant(value.min)));
+      }
+      if (value.op === "lt") return typeof value.max === "number" ? turned(op("lt", field(f), constant(value.max))) : null;
+      if (value.op === "gt") return typeof value.min === "number" ? turned(op("gt", field(f), constant(value.min))) : null;
+      const parts = [];
+      if (typeof value.min === "number") parts.push(op("gte", field(f), constant(value.min)));
+      if (typeof value.max === "number") parts.push(op("lte", field(f), constant(value.max)));
+      if (parts.length === 0) return null;
+      const range = parts.length === 1 ? parts[0] : op("and", ...parts);
+      return { rule: value.negated ? not(range) : range };
+    }
+    case "date": {
+      const zone2 = void 0;
+      const moments = dataTable.dateFilterBounds(value.preset ? { ...value, anchor: now.toISOString() } : value, now, zone2);
+      const holdsDays = String((f.config ?? {})["kind"] ?? "") === "date";
+      const bounds = holdsDays ? dataTable.dateFilterDayBounds(moments, zone2) : moments;
+      if (bounds.since === void 0 && bounds.until === void 0) return null;
+      return {
+        flat: {
+          [f.key]: {
+            ...bounds.since === void 0 ? {} : { from: bounds.since },
+            ...bounds.until === void 0 ? {} : { to: bounds.until }
+          }
+        }
+      };
+    }
+    default:
+      return `${name} cannot be filtered that way by the store.`;
+  }
+}
+function dayWindow(day, holdsDays) {
+  if (!holdsDays) return dataTable.dayInstantWindow(day, void 0);
+  const [y, m, d] = day.split("-").map(Number);
+  const ymd = (t) => `${t.getUTCFullYear()}-${String(t.getUTCMonth() + 1).padStart(2, "0")}-${String(t.getUTCDate()).padStart(2, "0")}`;
+  return { from: ymd(new Date(Date.UTC(y, (m ?? 1) - 1, d ?? 1))), to: ymd(new Date(Date.UTC(y, (m ?? 1) - 1, (d ?? 1) + 1))) };
+}
+function storeQuestion(fields, base, columnFilters, now = /* @__PURE__ */ new Date()) {
+  const refused = [];
+  const flat = {};
+  const rules = [];
+  if (base && records.isRuleFilter(base)) rules.push(base);
+  else if (base) Object.assign(flat, base);
+  for (const [key, value] of Object.entries(columnFilters)) {
+    if (!value) continue;
+    const f = fields.find((candidate) => candidate.key === key);
+    if (!f) continue;
+    const clause = clauseFor(f, value, now);
+    if (clause === null) continue;
+    if (typeof clause === "string") {
+      refused.push(clause);
+      continue;
+    }
+    if ("flat" in clause) Object.assign(flat, clause.flat);
+    else rules.push(clause.rule);
+  }
+  const flatKeys = Object.keys(flat);
+  if (rules.length === 0) return { filter: flatKeys.length > 0 ? flat : void 0, refused };
+  for (const key of flatKeys) {
+    const f = fields.find((candidate) => candidate.key === key);
+    const value = flat[key];
+    if (!f) continue;
+    if (value !== null && typeof value === "object") {
+      rules.push(withinWindow(f, value));
+      continue;
+    }
+    rules.push(value === null ? op("not", op("present", field(f))) : op("eq", field(f), constant(value)));
+  }
+  return { filter: rules.length === 1 ? rules[0] : op("and", ...rules), refused };
+}
+
+// src/rowVersion.ts
+function ownVersion(row) {
+  const v = row.version;
+  return typeof v === "number" ? v : null;
+}
+
+// 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 field2 = fields.find((f) => f.key === groupKey);
+  if (!field2) return sort;
+  return [{ field: groupKey, direction: "asc", as: sortAsFor(field2) }, ...sort.filter((s) => s.field !== groupKey)];
+}
+function chosenEntries(chosen) {
+  return JSON.parse(JSON.stringify(Object.entries(chosen).sort())).filter(([, op2]) => op2 in MEASURE_LABEL);
+}
+function groupFactMeasures(chosen) {
+  return [{ op: "count" }, ...chosenEntries(chosen).filter(([, op2]) => op2 !== "count").map(([key, op2]) => ({ op: op2, key }))];
+}
+function summaryBarMeasures(chosen) {
+  return chosenEntries(chosen).map(([key, op2]) => op2 === "count" ? { op: "count" } : { op: op2, key });
+}
+function choiceFieldKeys(fields) {
+  return fields.filter((f) => {
+    const kind = String(editorKindFor(f));
+    return kind === "select" || kind === "multi_select";
+  }).map((f) => f.key);
 }
 var MIN_ROW_HEIGHT = 24;
 var MAX_ROW_HEIGHT = 96;
@@ -163,8 +359,8 @@ function parseGridPresentation(raw) {
   if (footer === "sticky" || footer === "inline") out.footer = footer;
   if (isRecord(value["summaries"])) {
     const summaries = {};
-    for (const [key, op] of Object.entries(value["summaries"])) {
-      if (typeof op === "string" && op.trim() !== "") summaries[key] = op;
+    for (const [key, op2] of Object.entries(value["summaries"])) {
+      if (typeof op2 === "string" && op2.trim() !== "") summaries[key] = op2;
     }
     if (Object.keys(summaries).length > 0) out.summaries = summaries;
   }
@@ -172,9 +368,9 @@ function parseGridPresentation(raw) {
 }
 function parseGrouping(raw) {
   if (!isRecord(raw)) return void 0;
-  const field = raw["field"];
-  if (typeof field !== "string" || field.trim() === "") return void 0;
-  const out = { field };
+  const field2 = raw["field"];
+  if (typeof field2 !== "string" || field2.trim() === "") return void 0;
+  const out = { field: field2 };
   if (isRecord(raw["aggregates"])) {
     const aggregates = {};
     for (const [key, spec] of Object.entries(raw["aggregates"])) {
@@ -954,39 +1150,68 @@ async function askTileSeed(input) {
 // src/firstPage.ts
 var TABLE_PAGE_SIZE = 100;
 var EMBEDDED_PAGE_SIZE = 50;
+function viewFilterOf(shown, fields) {
+  if (!shown) return void 0;
+  const base = shown.where ?? (shown.filters && Object.keys(shown.filters).length > 0 ? shown.filters : void 0);
+  return storeQuestion(fields, base, {}).filter;
+}
 function firstGridPageArgs(input) {
   const { shown, fields } = input;
   if (!shown) return null;
   if ((shown.layout ?? "grid") !== "grid") return null;
   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);
   return {
     p_table_id: input.tableId,
-    p_filter: {},
+    p_filter: viewFilterOf(shown, fields) ?? {},
     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;
+}
+function defaultSpec(tableId) {
+  return { name: "All", subject: tableId, layout: "grid", isDefault: true };
+}
+function shownFromSpec(spec, tableId) {
+  return { ...spec, subject: spec.subject ?? tableId, id: "", movedFrom: null };
+}
+async function firstGridOpening(client, tableId, options) {
+  const explicit = options.view;
   const [table, fields, views, looks] = await Promise.all([
     client.tableRead({ table_id: tableId }),
     client.fields({ table_id: tableId }),
-    client.views({ table_id: tableId }),
-    readLooks(client, tableId)
+    explicit ? Promise.resolve(null) : client.views({ table_id: tableId }),
+    explicit ? Promise.resolve(null) : readLooks(client, tableId)
   ]);
-  if (!table.ok || !fields.ok || !views.ok || !looks.ok) return null;
-  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 } : {} });
+  if (!table.ok || !fields.ok) return null;
+  let shown;
+  if (explicit) {
+    shown = shownFromSpec(explicit, tableId);
+  } else {
+    if (!views?.ok || !looks?.ok) return null;
+    const mine = views.data.map(viewFromRow).filter((v) => v.subject === tableId);
+    const view = defaultViewOf(mine) ?? mine[0] ?? null;
+    shown = view ? applyLook(view, looks.data[view.id]) : shownFromSpec(defaultSpec(tableId), tableId);
+  }
+  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");
@@ -1008,10 +1233,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 } : {}, ...input.view ? { view: input.view } : {} });
     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,
@@ -1020,6 +1246,34 @@ 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 = [];
+        const filter = args.p_filter && Object.keys(args.p_filter).length > 0 ? args.p_filter : void 0;
+        if (groupKey) {
+          reads.push(client.recordAggregate({ table_id: input.tableId, groupBy: [groupKey], measures: groupFactMeasures(chosen), limit: 1e3, ...filter ? { filter } : {} }));
+        }
+        const bar = summaryBarMeasures(chosen);
+        if (bar.length > 0) reads.push(client.recordAggregate({ table_id: input.tableId, measures: bar, ...filter ? { filter } : {} }));
+        for (const field2 of fields) {
+          if (field2.type !== "list" && field2.type !== "relation") continue;
+          const ids = /* @__PURE__ */ new Set();
+          for (const row of page.data.rows) {
+            const value = row.document?.[field2.key];
+            for (const id of Array.isArray(value) ? value.map(String) : typeof value === "string" ? [value] : []) if (uuid.isUuidShape(id)) ids.add(id);
+          }
+          if (ids.size > 0) reads.push(client.relationWordsMany({ field_id: field2.id, record_ids: [...ids] }));
+        }
+        if (input.merged) {
+          for (const key of choiceFieldKeys(fields)) {
+            reads.push(client.recordAggregate({ table_id: input.tableId, groupBy: [key], measures: [{ op: "count" }], limit: 500, ...filter ? { filter } : {} }));
+          }
+        }
+        const unversioned = page.data.rows.filter((row) => ownVersion(row) === null).map((row) => row.id);
+        if (unversioned.length > 0) reads.push(client.recordHeaders({ ids: unversioned }));
+        await Promise.all(reads.map((read) => read.catch(() => null)));
+      }
     }
   } catch {
   }
@@ -1037,5 +1291,6 @@ exports.firstGridPageArgs = firstGridPageArgs;
 exports.firstGridPageRequest = firstGridPageRequest;
 exports.mergeSeeds = mergeSeeds;
 exports.serverRowsOf = serverRowsOf;
+exports.viewFilterOf = viewFilterOf;
 //# sourceMappingURL=first-page.cjs.map
 //# sourceMappingURL=first-page.cjs.map