@ai-matrx/records-ui 0.108.0 → 0.109.4

package/CHANGELOG.md

@@ -1,5 +1,46 @@
 # Changelog — @ai-matrx/records-ui
 
+## 0.109.4
+### lane TABLE-EDITING-EDGES
+
+- NEW RECORD ON A TABLE WITH A REQUIRED COLUMN OPENS THE FORM, never a red banner: the grid asks the store's own mirror (`predictWriteRefusals`) before writing a blank record; when it would be refused ("Brand name is required") the record form opens with the cursor on the first required column, and the required check speaks only when Create is tried. No refused write is sent, so nothing lands in the error inspector. A refusal the mirror did not foresee opens the form too. (`Grid`, `NewRecordControl` takes `ask`; `RecordForm` takes `focusFirstRequired`.)
+- A typed date is read in every control that uses the one reader, including bare digits (`10142026`, `101426`) — see `@ai-matrx/records` 0.81.2; the form's date box test now holds `10142026`, `10/14/2026` and `10/14/26` to what is saved.
+
+**Consumer action:** none.
+
+## 0.109.3
+### lane DESCRIBE-INSTALL: a preview never claims a save
+
+- `FormRunner`'s preview thank-you no longer shows the form's own words ("Brand saved.") as if they were this send's result: under a preview they follow "After a real send, people read:", and the last line still says "Preview · nothing saved".
+
+**Consumer action:** none.
+
+## 0.109.2
+### lane SORT-REACTS
+
+- A grid edit that changes a sorted, filtered or grouped value moves its row: the page is read again (see `@ai-matrx/records`), and the edited row glides to its new place and is lit for a moment (`gridRowMove.ts`; the design system's `--matrx-motion-duration-slow` / `--matrx-motion-ease-panel`, none under reduced motion), its cell stays selected, and a row that landed out of view is scrolled to. A row that left the filter says so with Undo (`gridViewMove.ts`, already there — it now sees the move on a live page too). Layout check: `pnpm test:layout` case 9.
+
+**Consumer action:** none.
+
+## 0.109.1
+
+Release of 0.109.0's SSR-ROWS work (its publish gate stopped at the new test's untyped `jsdom` import; the test now types the one constructor it uses). No source change.
+
+**Consumer action:** none.
+
+## 0.109.0
+### Archive record from the row menu works
+
+- The grid's row menu "Archive record" opens its confirm once the menu has closed (`afterMenuLayerCloses`, exported from `gridControls`); opened inside the menu's select callback, the closing menu dismissed it at once (always inside a contenteditable host such as a Space), so the press did nothing. A row the page no longer holds says so. No consumer action.
+
+### SSR-ROWS: the table page arrives with its rows
+
+- NEW in `@ai-matrx/records-ui/first-page`: `askTablePageSeed({ dataSource, organizationId, tableId, actor, recordId?, rows?, embedded?, pageSize? })` — a host's server asks, AS THE PERSON, the table's bundle, the grid's exact first page (`firstGridPageRequest`) and on a record page the record's bundle, and gets a `RecordsSeed`. Mount `<RecordsSeedProvider seed>` (`@ai-matrx/records/react`) above `TablePage` and the page is drawn — rows included — in the server's HTML, then hydrates with no mismatch and no page read. `embedded: true` asks the embedded table's page size (`EMBEDDED_PAGE_SIZE`, now declared here).
+- `first-page` is built WITHOUT the package's "use client" banner (its own tsup entry), so a server component can call it; `presentation.ts` reads `parseTableStyle` from `@ai-matrx/design-system/data-table/table-style` (client-free) for the same reason.
+- `TablePage` starts from the seed's saved views and looks (`useSeededAnswer`), so it knows its face in the first pass instead of drawing its skeleton until two effects land; `ViewBar` takes `initialViews` and skips its mount read. Without a seed both read exactly as before.
+
+**Consumer action:** none (additive). Spaces: ask `askTablePageSeed({ …, embedded: true })` in the route and wrap the inline table in `<RecordsSeedProvider>`.
+
 ## 0.108.0
 ### PAGE-BUNDLE-2: the grid's first page, asked before the grid exists
 

package/dist/first-page.cjs

@@ -1,44 +1,22 @@
-"use client";
-"use strict";
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
-};
-var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (let key of __getOwnPropNames(from))
-      if (!__hasOwnProp.call(to, key) && key !== except)
-        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
-  }
-  return to;
-};
-var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+'use strict';
 
-// src/firstPage.ts
-var firstPage_exports = {};
-__export(firstPage_exports, {
-  TABLE_PAGE_SIZE: () => TABLE_PAGE_SIZE,
-  firstGridPageArgs: () => firstGridPageArgs,
-  firstGridPageRequest: () => firstGridPageRequest
-});
-module.exports = __toCommonJS(firstPage_exports);
+var core = require('@ai-matrx/records/core');
+var records = require('@ai-matrx/records');
+require('@ai-matrx/kit/text-case');
+require('@ai-matrx/design-system/data-table');
+var tableStyle = require('@ai-matrx/design-system/data-table/table-style');
+require('@ai-matrx/design-system/field-formats');
 
-// src/parity.ts
-var import_records = require("@ai-matrx/records");
-var import_text_case = require("@ai-matrx/kit/text-case");
-var kernelId = (name) => import_records.KERNEL_TABLES.find((t) => t.name === name)?.id ?? "";
+// src/firstPage.ts
+var kernelId = (name) => records.KERNEL_TABLES.find((t) => t.name === name)?.id ?? "";
 var KERNEL_FILE_TABLE = kernelId("File");
 var KERNEL_PERSON_TABLE = kernelId("Person");
-var PARITY_MADE_OF = Object.fromEntries(
-  import_records.PARITY_FIELD_TYPES.map((p) => [p.parity_type, p.made_of])
+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 (0, import_records.fieldKindFor)(field, KERNEL);
+  return records.fieldKindFor(field, KERNEL);
 }
 
 // src/gridLook.ts
@@ -68,10 +46,6 @@ 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;
 }
-
-// src/gridPage.ts
-var import_records2 = require("@ai-matrx/records");
-var import_data_table = require("@ai-matrx/design-system/data-table");
 function holdsNumbers(field) {
   const kind = String(editorKindFor(field));
   if (kind === "number" || kind === "currency" || kind === "percent") return true;
@@ -89,11 +63,6 @@ function pageSortFor(fields, sort) {
   if (!field) return [];
   return [{ field: field.key, direction: sort.direction === "desc" ? "desc" : "asc", as: sortAsFor(field) }];
 }
-
-// src/presentation.ts
-var import_data_table2 = require("@ai-matrx/design-system/data-table");
-var import_field_formats = require("@ai-matrx/design-system/field-formats");
-var import_records3 = require("@ai-matrx/records");
 var MIN_ROW_HEIGHT = 24;
 var MAX_ROW_HEIGHT = 96;
 var AGGREGATE_KINDS = [
@@ -131,8 +100,8 @@ function parseGridPresentation(raw) {
   }
   if (!isRecord(value)) return {};
   const out = {};
-  const style = (0, import_data_table2.parseTableStyle)(value["style"]);
-  if (!(0, import_data_table2.tableStyleIsEmpty)(style)) out.style = style;
+  const style = tableStyle.parseTableStyle(value["style"]);
+  if (!tableStyle.tableStyleIsEmpty(style)) out.style = style;
   if (isRecord(value["formats"])) {
     const formats = {};
     for (const [key, cfg] of Object.entries(value["formats"])) {
@@ -261,53 +230,7 @@ function parseGrouping(raw) {
   }
   return out;
 }
-
-// src/viewKeys.ts
-var STORE_KEEPS_TIMELINE = true;
-var ALL = ["grid", "kanban", "calendar", "gallery", ...STORE_KEEPS_TIMELINE ? ["timeline"] : [], "list"];
-var HIDES = ["grid", "gallery", "kanban", "calendar", ...STORE_KEEPS_TIMELINE ? ["timeline"] : [], "list"];
-var GRIDS = ["grid"];
-var VIEW_KEYS = [
-  { path: "layout", shape: "kind", layouts: ALL, writer: "caller" },
-  { path: "filters", shape: "filter", layouts: ALL, writer: "caller" },
-  { path: "where", shape: "rule", layouts: ALL, writer: "caller" },
-  { path: "group_field", shape: "field", layouts: ["kanban", ...STORE_KEEPS_TIMELINE ? ["timeline"] : []], writer: "caller" },
-  { path: "swimlane_field", shape: "field:lane", layouts: ["kanban"], writer: "caller" },
-  { path: "collapsed_columns", shape: "values", layouts: ["kanban"], writer: "caller" },
-  { path: "measure", shape: "field:number", layouts: ["kanban"], writer: "caller" },
-  { path: "date_field", shape: "field:date", layouts: ["calendar"], writer: "caller" },
-  ...STORE_KEEPS_TIMELINE ? [
-    { path: "start_field", shape: "field:date", layouts: ["timeline"], writer: "caller" },
-    { path: "end_field", shape: "field:date", layouts: ["calendar", "timeline"], writer: "caller" }
-  ] : [],
-  { path: "image_field", shape: "field", layouts: ["gallery"], writer: "caller" },
-  { path: "sorts", shape: "sorts", layouts: ALL, writer: "caller" },
-  { path: "rule_id", shape: "uuid", layouts: ALL, writer: "caller" },
-  { path: "is_default", shape: "boolean", layouts: ALL, writer: "caller" },
-  { path: "presentation", shape: "presentation", layouts: ALL, writer: "caller" },
-  { path: "presentation.style", shape: "style", layouts: ALL, writer: "caller" },
-  { path: "presentation.formats", shape: "object", layouts: GRIDS, writer: "caller" },
-  { path: "presentation.frozen", shape: "fields", layouts: GRIDS, writer: "caller" },
-  { path: "presentation.grouping", shape: "grouping", layouts: ["grid", "gallery", "list"], writer: "caller" },
-  { path: "presentation.widths", shape: "widths", layouts: GRIDS, writer: "caller" },
-  { path: "presentation.rowHeight", shape: "row_height", layouts: GRIDS, writer: "caller" },
-  { path: "presentation.hiddenFields", shape: "fields", layouts: HIDES, writer: "caller" },
-  { path: "presentation.cardHidden", shape: "fields", layouts: ["kanban", "calendar", ...STORE_KEEPS_TIMELINE ? ["timeline"] : [], "list", "gallery"], writer: "caller" },
-  { path: "presentation.columnOrder", shape: "fields", layouts: GRIDS, writer: "caller" },
-  { path: "presentation.gallerySize", shape: "gallery_size", layouts: ["gallery"], writer: "caller" },
-  { path: "presentation.wrap", shape: "boolean", layouts: GRIDS, writer: "caller" },
-  { path: "presentation.wrapColumns", shape: "fields", layouts: GRIDS, writer: "caller" },
-  { path: "presentation.fit", shape: "fit", layouts: GRIDS, writer: "caller" },
-  { path: "presentation.freezeFirst", shape: "boolean", layouts: GRIDS, writer: "caller" },
-  { path: "presentation.footer", shape: "footer", layouts: GRIDS, writer: "caller" },
-  { path: "presentation.summaries", shape: "summaries", layouts: GRIDS, writer: "caller" },
-  { path: "grid", shape: "grid", layouts: GRIDS, writer: "caller" },
-  { path: "hidden_fields", shape: "input", layouts: HIDES, writer: "input" },
-  { path: "table_id", shape: "server", layouts: ALL, writer: "server" },
-  { path: "order", shape: "server", layouts: GRIDS, writer: "server" },
-  { path: "moved_from", shape: "server", layouts: ALL, writer: "server" }
-];
-var STORE_KEPT_LAYOUTS = ["grid", "kanban", "calendar", "gallery", ...STORE_KEEPS_TIMELINE ? ["timeline"] : [], "list"];
+var STORE_KEPT_LAYOUTS = ["grid", "kanban", "calendar", "gallery", ...["timeline"] , "list"];
 var KINDS = STORE_KEPT_LAYOUTS;
 function viewSettings(definition, rowFilters) {
   const data = definition ?? {};
@@ -360,14 +283,6 @@ function parseSorts(raw) {
 
 // src/views.ts
 var VIEW_LAYOUTS = ["grid", "kanban", "calendar", "gallery", "timeline", "list"];
-var LAYOUT_LABEL = {
-  grid: "Grid",
-  kanban: "Kanban",
-  calendar: "Calendar",
-  gallery: "Gallery",
-  timeline: "Timeline",
-  list: "List"
-};
 function viewOrderOf(definition) {
   const raw = definition?.["order"];
   return raw === "manual" ? "manual" : raw === "sorted" ? "sorted" : null;
@@ -375,12 +290,6 @@ function viewOrderOf(definition) {
 function defaultViewOf(views) {
   return views.find((v) => v.isDefault);
 }
-var PAGE_VIEWS = [...VIEW_LAYOUTS, "dashboards", "archived"];
-var PAGE_VIEW_LABEL = {
-  ...LAYOUT_LABEL,
-  dashboards: "Dashboards",
-  archived: "Archived"
-};
 function viewFromRow(row) {
   const data = row.definition ?? {};
   const k = viewSettings(data, row.filters && Object.keys(row.filters).length > 0 ? row.filters : null);
@@ -450,6 +359,7 @@ async function readLooks(client, tableId) {
 
 // src/firstPage.ts
 var TABLE_PAGE_SIZE = 100;
+var EMBEDDED_PAGE_SIZE = 50;
 function firstGridPageArgs(input) {
   const { shown, fields } = input;
   if (!shown) return null;
@@ -484,4 +394,42 @@ async function firstGridPageRequest(client, tableId, options = {}) {
   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 } : {} });
 }
+async function askTablePageSeed(input) {
+  const recording = core.recordingDataSource(core.asRecordsDataSource(input.dataSource));
+  const client = core.createRecordsClient({
+    dataSource: recording.source,
+    organizationId: input.organizationId,
+    actor: input.actor,
+    onError: () => {
+    }
+  });
+  const record = input.recordId ? Promise.resolve(
+    recording.source.rpc("record_page_bundle", { p_organization_id: input.organizationId, p_record_id: input.recordId }, { schema: "custom" })
+  ).catch(() => null) : null;
+  try {
+    const pageSize = input.pageSize ?? (input.embedded ? EMBEDDED_PAGE_SIZE : TABLE_PAGE_SIZE);
+    const args = await firstGridPageRequest(client, input.tableId, { pageSize });
+    if (args && input.rows !== false) {
+      await client.listPage({
+        table_id: args.p_table_id,
+        filter: args.p_filter,
+        search: args.p_search,
+        sort: args.p_sort,
+        view_id: args.p_view_id,
+        limit: args.p_limit,
+        offset: args.p_offset
+      });
+    }
+  } catch {
+  }
+  if (record) await record;
+  return recording.seed();
+}
+
+exports.EMBEDDED_PAGE_SIZE = EMBEDDED_PAGE_SIZE;
+exports.TABLE_PAGE_SIZE = TABLE_PAGE_SIZE;
+exports.askTablePageSeed = askTablePageSeed;
+exports.firstGridPageArgs = firstGridPageArgs;
+exports.firstGridPageRequest = firstGridPageRequest;
+//# sourceMappingURL=first-page.cjs.map
 //# sourceMappingURL=first-page.cjs.map