@ai-matrx/records-ui 0.28.0 → 0.30.0

package/CHANGELOG.md

@@ -1,5 +1,74 @@
 # Changelog — @ai-matrx/records-ui
 
+## 0.30.0
+
+**The notification editor stops asking for the notifier's own reader.**
+
+`NotifyRuleEditor` listed subscriptions with `client.aggSubscriptions()` and read
+its cadences from `client.aggSubscriptionCadences()`. Both are `custom.agg_*` —
+the NOTIFIER's internals — and neither holds a client grant, so a signed-in
+person opened this panel on *"permission denied for function agg_subscriptions"*
+and the cadence picker silently fell back to a word typed into the file. Lane
+TEST-BENCH photographed that refusal on the try-everything page on 2026-09-20.
+
+It now asks the person's own doors: `client.subscriptions({ table_id })`, which
+answers what is addressed to them plus — only where they hold admin on this
+Table — anyone's over it, narrowed to Tables they can already open; and
+`client.subscriptionCadences()`, which delegates to the notifier's one array.
+
+Two consequences, both visible: the list is now scoped to the Table the editor is
+about (it used to answer the whole organization), and a **muted** subscription
+appears with the sentence *"Switched off — it tells nobody until somebody
+switches it back on."* The notifier's reader excluded muted rows, so switching one
+off used to make it vanish from this list and read as gone rather than as off.
+
+**Consumer action:** requires `@ai-matrx/records` 0.17.0 or above.
+
+## 0.29.0
+
+**A saved view can now say how the table is SECTIONED, how wide its columns are,
+and how tall its rows are — and the grid windows itself and stops implying it
+counted everything.**
+
+The shared data table gained grouping, controlled column widths, virtualization
+and an honest count in design-system 0.23.0. This is the store's half, and it
+rides the document a view already has (`records_ui_view.presentation`): no new
+column, no new table, and an agent sets any of it with the same record write it
+already uses for colors and formats.
+
+- **Sections by a Field.** `presentation.grouping` names a Field key, with
+  optional per-Field subtotals, a section order and the sections to keep shut.
+  Grouped by Status, the table draws one collapsible header per status with a
+  count of records on it — and a view that names a Field but no subtotals gets a
+  COUNT, never a total nobody asked for.
+- **Remembered column widths.** `presentation.widths` is sparse and keyed by
+  Field key, so a view saved before widths existed still reads. Drag a column
+  wider and the width is kept.
+- **A row height.** `presentation.rowHeight`, clamped to 24–96px. A view asking
+  for anything outside that is dropped rather than obeyed, because a saved look
+  must not be able to make a table unreadable.
+- **The grid windows itself.** Virtualization is on for every record table; the
+  primitive's own threshold decides when it engages, so short tables are
+  untouched and a very long one scrolls.
+- **The count says what it covers.** The search and filters in the grid's
+  toolbar run in the browser over the page the read door returned, so the table
+  now states that in plain English instead of letting the loaded count pose as
+  the whole table — and says the total is unknown when the door cannot give one.
+- **The person's own changes are saved back onto the view.** Picking a column to
+  group by, shutting a section and resizing a column travel `Grid`'s new
+  `onPresentationChange` into the door every other view change already uses, so
+  `TablePage` writes them onto the view record with the version it read. A host
+  that binds no door still gets all three for the visit.
+
+### Consumer action
+
+- Nothing to change. Every new field is optional and a view that carries none of
+  them renders exactly as it did.
+- A host that mounts `Grid` directly and wants these remembered binds
+  `onPresentationChange` and saves the look onto its view record;
+  `ViewSwitcher` and `TablePage` already do.
+- Needs `@ai-matrx/design-system` 0.23.0 or above.
+
 ## 0.28.0
 
 **The publish canary installs every peer this package declares.** It named
@@ -12,6 +81,8 @@ installed in a pass of their own so each brings its own peers (`react-is` is
 `recharts`'). 0.27.0 was tagged and never published; its tag was left where it
 is.
 
+## 0.27.0
+
 **A first-time admin could not make a table, and the gate could not see it.**
 
 Creating one showed a red refusal and made a table anyway; that table opened with

package/dist/index.cjs

@@ -81,6 +81,8 @@ __export(src_exports, {
   LAYOUT_NO_FIELD: () => LAYOUT_NO_FIELD,
   LEVEL_WORD: () => LEVEL_WORD,
   MACHINE_IDENTITY: () => MACHINE_IDENTITY,
+  MAX_ROW_HEIGHT: () => MAX_ROW_HEIGHT,
+  MIN_ROW_HEIGHT: () => MIN_ROW_HEIGHT,
   NOT_ANSWERED_YET: () => NOT_ANSWERED_YET,
   NO_CHAT_REASON: () => NO_CHAT_REASON,
   NO_COLUMNS_WHY: () => NO_COLUMNS_WHY,
@@ -1874,6 +1876,27 @@ var import_data_table3 = require("@ai-matrx/design-system/data-table");
 var import_data_table2 = require("@ai-matrx/design-system/data-table");
 var EMPTY_PRESENTATION = {};
 var FROZEN_COLUMN_WIDTH = 200;
+var MIN_ROW_HEIGHT = 24;
+var MAX_ROW_HEIGHT = 96;
+var AGGREGATE_KINDS = [
+  "count",
+  "sum",
+  "average",
+  "min",
+  "max",
+  "empty",
+  "filled",
+  "unique",
+  "checked",
+  "unchecked",
+  "percentFilled"
+];
+var GROUP_ORDERS = [
+  "value-asc",
+  "value-desc",
+  "count-desc",
+  "first-seen"
+];
 function isRecord(v) {
   return typeof v === "object" && v !== null && !Array.isArray(v);
 }
@@ -1910,10 +1933,51 @@ function parseGridPresentation(raw) {
     const frozen = value["frozen"].filter((k) => typeof k === "string");
     if (frozen.length > 0) out.frozen = frozen;
   }
+  const grouping = parseGrouping(value["grouping"]);
+  if (grouping) out.grouping = grouping;
+  if (isRecord(value["widths"])) {
+    const widths = {};
+    for (const [key, raw2] of Object.entries(value["widths"])) {
+      if (typeof raw2 !== "number" || !Number.isFinite(raw2) || raw2 <= 0) continue;
+      widths[key] = Math.round(raw2);
+    }
+    if (Object.keys(widths).length > 0) out.widths = widths;
+  }
+  const rowHeight = value["rowHeight"];
+  if (typeof rowHeight === "number" && Number.isFinite(rowHeight) && rowHeight >= MIN_ROW_HEIGHT && rowHeight <= MAX_ROW_HEIGHT) {
+    out.rowHeight = Math.round(rowHeight);
+  }
+  return out;
+}
+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 };
+  if (isRecord(raw["aggregates"])) {
+    const aggregates = {};
+    for (const [key, spec] of Object.entries(raw["aggregates"])) {
+      if (!isRecord(spec)) continue;
+      const kind = spec["kind"];
+      if (typeof kind !== "string") continue;
+      if (!AGGREGATE_KINDS.includes(kind)) continue;
+      const label = spec["label"];
+      aggregates[key] = typeof label === "string" ? { kind, label } : { kind };
+    }
+    if (Object.keys(aggregates).length > 0) out.aggregates = aggregates;
+  }
+  const order = raw["order"];
+  if (typeof order === "string" && GROUP_ORDERS.includes(order)) {
+    out.order = order;
+  }
+  if (Array.isArray(raw["collapsed"])) {
+    const collapsed = raw["collapsed"].filter((k) => typeof k === "string");
+    if (collapsed.length > 0) out.collapsed = collapsed;
+  }
   return out;
 }
 function presentationIsEmpty(p) {
-  return (p.style === void 0 || (0, import_data_table2.tableStyleIsEmpty)(p.style)) && Object.keys(p.formats ?? {}).length === 0 && (p.frozen?.length ?? 0) === 0;
+  return (p.style === void 0 || (0, import_data_table2.tableStyleIsEmpty)(p.style)) && Object.keys(p.formats ?? {}).length === 0 && (p.frozen?.length ?? 0) === 0 && p.grouping === void 0 && Object.keys(p.widths ?? {}).length === 0 && p.rowHeight === void 0;
 }
 function presentationDocument(p) {
   return presentationIsEmpty(p) ? "" : JSON.stringify(p);
@@ -1984,6 +2048,7 @@ function Grid({
   toolbarActions,
   editable = true,
   presentation = EMPTY_PRESENTATION,
+  onPresentationChange,
   className
 }) {
   const host = useRecordsUi();
@@ -2035,6 +2100,67 @@ function Grid({
     ),
     [ordered, canWrite, editing, mayWriteRow, whyNotRow, presentation.formats, frozenKeys]
   );
+  const columnIds = (0, import_react13.useMemo)(() => ordered.map((field) => field.key), [ordered]);
+  const [localColumns, setLocalColumns] = (0, import_react13.useState)(
+    null
+  );
+  const [localWidths, setLocalWidths] = (0, import_react13.useState)(null);
+  const writeLook = (0, import_react13.useCallback)(
+    (next) => onPresentationChange?.(next),
+    [onPresentationChange]
+  );
+  const widths = localWidths ?? presentation.widths;
+  const columnState = (0, import_react13.useMemo)(
+    () => ({
+      order: localColumns?.order ?? columnIds,
+      hidden: localColumns?.hidden ?? [],
+      onChange: (next) => setLocalColumns(next),
+      ...widths ? { widths } : {},
+      // A drag that changed nothing would be the silent half of a control that
+      // looks alive, so the width always lands somewhere — the session at
+      // least, the view record when a door is bound.
+      onWidthsChange: (next) => {
+        setLocalWidths(next);
+        writeLook({ ...presentation, widths: next });
+      }
+    }),
+    [columnIds, localColumns, widths, presentation, writeLook]
+  );
+  const groupingConfig = (0, import_react13.useMemo)(() => {
+    const view = presentation.grouping;
+    const field = view?.field ?? null;
+    if (field === null && !onPresentationChange) return null;
+    const aggregates = view && Object.keys(view.aggregates ?? {}).length > 0 ? view.aggregates : field ? { [field]: { kind: "count" } } : void 0;
+    return {
+      columnId: field,
+      rowNoun: "record",
+      ...aggregates ? { aggregates } : {},
+      ...view?.order ? { order: view.order } : {},
+      ...view?.collapsed ? { collapsed: view.collapsed } : {},
+      ...onPresentationChange ? {
+        onColumnIdChange: (columnId) => {
+          if (columnId === null) {
+            const { grouping: _dropped, ...rest } = presentation;
+            writeLook(rest);
+            return;
+          }
+          writeLook({
+            ...presentation,
+            grouping: {
+              field: columnId,
+              ...presentation.grouping?.aggregates ? { aggregates: presentation.grouping.aggregates } : {},
+              ...presentation.grouping?.order ? { order: presentation.grouping.order } : {}
+            }
+          });
+        },
+        onCollapsedChange: (collapsed) => {
+          const current = presentation.grouping;
+          if (!current) return;
+          writeLook({ ...presentation, grouping: { ...current, collapsed } });
+        }
+      } : {}
+    };
+  }, [presentation, onPresentationChange, writeLook]);
   if (table.error) return /* @__PURE__ */ (0, import_jsx_runtime9.jsx)(RefusalNotice, { error: table.error, className });
   if (fields.error) return /* @__PURE__ */ (0, import_jsx_runtime9.jsx)(RefusalNotice, { error: fields.error, className });
   const nothingToShowYet = table.loading || fields.loading || !rights.known || records.loading && rows.length === 0;
@@ -2098,6 +2224,15 @@ function Grid({
           pageSize,
           detail: { enabled: false },
           window: { enabled: false },
+          ...groupingConfig ? { grouping: groupingConfig } : {},
+          columnState,
+          ...presentation.rowHeight ? { rowHeight: presentation.rowHeight } : {},
+          virtualize: true,
+          coverage: {
+            answeredBy: "client",
+            noun: "record",
+            ...typeof records.data?.total === "number" ? { total: records.data.total } : {}
+          },
           ...presentation.style ? {
             tableStyle: {
               style: presentation.style,
@@ -3990,6 +4125,7 @@ function ViewSwitcher({
         tableId: view.subject,
         pageSize,
         ...local.presentation ?? view.presentation ? { presentation: local.presentation ?? view.presentation } : {},
+        ...onViewChange ? { onPresentationChange: (next) => change({ presentation: next }) } : {},
         ...onOpenRecord ? { onOpenRecord } : {},
         ...onNewRecordForm ? { onNewRecordForm } : {}
       }
@@ -6833,10 +6969,13 @@ function NotifyRuleEditor({ tableId, seed, className }) {
   const [busy, setBusy] = (0, import_react64.useState)(false);
   const load = (0, import_react64.useCallback)(async () => {
     const [held, offered] = await Promise.all([
-      client.aggSubscriptions(),
+      // THE PERSON'S OWN DOOR, not the notifier's. It answers what is addressed
+      // to them plus — only where they hold admin on this Table — anyone's over
+      // it, and it is narrowed to Tables they can already open.
+      client.subscriptions({ table_id: tableId }),
       // The cadences are ASKED of the store, never a list typed into a picker
       // here that could drift from what the digest runner understands.
-      client.aggSubscriptionCadences()
+      client.subscriptionCadences()
     ]);
     if (!held.ok) {
       setError(held.error);
@@ -6847,7 +6986,7 @@ function NotifyRuleEditor({ tableId, seed, className }) {
     if (offered.ok) setCadences(offered.data);
     if (host.savedViews) setViews(await host.savedViews());
     else setViews(null);
-  }, [client, host]);
+  }, [client, host, tableId]);
   (0, import_react64.useEffect)(() => {
     void load();
   }, [load]);
@@ -6937,6 +7076,7 @@ function NotifyRuleEditor({ tableId, seed, className }) {
       held.cadence === "digest" && held.schedule ? /* @__PURE__ */ (0, import_jsx_runtime32.jsx)("span", { className: "text-muted-foreground", children: held.schedule }) : null,
       held.recipient_user_id === null ? /* @__PURE__ */ (0, import_jsx_runtime32.jsx)("span", { className: "text-destructive", children: "This one has nobody to tell, so it fires at nobody." }) : null,
       held.saved_view_id === null ? /* @__PURE__ */ (0, import_jsx_runtime32.jsx)("span", { className: "text-destructive", children: "This one names no view, so the store never admits a record to it." }) : null,
+      held.muted ? /* @__PURE__ */ (0, import_jsx_runtime32.jsx)("span", { className: "text-muted-foreground", children: "Switched off \u2014 it tells nobody until somebody switches it back on." }) : null,
       rights.write ? /* @__PURE__ */ (0, import_jsx_runtime32.jsx)(
         import_design_system30.Button,
         {