@ai-matrx/records 0.86.2 → 0.87.2

package/dist/data/index.d.cts

@@ -22,6 +22,19 @@ interface Column {
     choices?: string[];
     /** For a link column: what it may point at (a custom table's id, or entity tokens). */
     linksTo?: string[];
+    /**
+     * For a link column: the alias, in the SAME port, that serves the table it points at — so a form can list
+     * the linked rows to pick from. Absent when no source of this Applet serves that table.
+     */
+    linksToSource?: string;
+    /**
+     * The store's own answer to "does this column hold more than one value" (`custom.field.multi`). A choice
+     * column's type is `list` whether it takes one word or many — only this tells them apart (Status, one
+     * value, drew as four switches and the store refused the list it sent: social planner, 2026-10-08).
+     */
+    multi?: boolean;
+    /** The column a row is named by (the table's `title_field`) — what a link to the row reads as. */
+    title?: boolean;
     readOnly: boolean;
 }
 /** §0. One row, keyed by `Column.key`. Underscore keys are the runtime's own. */

package/dist/data/index.d.ts

@@ -22,6 +22,19 @@ interface Column {
     choices?: string[];
     /** For a link column: what it may point at (a custom table's id, or entity tokens). */
     linksTo?: string[];
+    /**
+     * For a link column: the alias, in the SAME port, that serves the table it points at — so a form can list
+     * the linked rows to pick from. Absent when no source of this Applet serves that table.
+     */
+    linksToSource?: string;
+    /**
+     * The store's own answer to "does this column hold more than one value" (`custom.field.multi`). A choice
+     * column's type is `list` whether it takes one word or many — only this tells them apart (Status, one
+     * value, drew as four switches and the store refused the list it sent: social planner, 2026-10-08).
+     */
+    multi?: boolean;
+    /** The column a row is named by (the table's `title_field`) — what a link to the row reads as. */
+    title?: boolean;
     readOnly: boolean;
 }
 /** §0. One row, keyed by `Column.key`. Underscore keys are the runtime's own. */

package/dist/data/index.js

@@ -50,8 +50,9 @@ function optionsTableOf(field) {
   return typeof id === "string" && id ? id : null;
 }
 async function readTableShape(client, tableId) {
-  const fields = await client.fields({ table_id: tableId });
+  const [fields, table] = await Promise.all([client.fields({ table_id: tableId }), client.tableRead({ table_id: tableId, organization_id: client.config.organizationId })]);
   if (!fields.ok) return fields;
+  const titleField = table.ok ? table.data?.title_field ?? null : null;
   const choiceFields = fields.data.filter((f) => optionsTableOf(f) !== null);
   const options = await Promise.all(choiceFields.map((f) => client.fieldOptions({ field_id: f.id })));
   const choicesById = /* @__PURE__ */ new Map();
@@ -75,8 +76,10 @@ async function readTableShape(client, tableId) {
       type,
       origin: "custom",
       required: Boolean(field.required),
+      multi: field.multi === true,
       readOnly: COMPUTED_TYPES.has(field.type) || field.source === "formula" || field.compute_on !== null && field.compute_on !== void 0
     };
+    if (titleField !== null && (titleField === field.key || titleField === field.id)) column.title = true;
     const choices = choicesById.get(field.id);
     if (choices) column.choices = choices;
     if (field.type === "relation" && field.relation_target) column.linksTo = [field.relation_target];
@@ -229,7 +232,8 @@ function isWritingDoor(door) {
 }
 
 // src/core/recordChanges.ts
-var listeners = /* @__PURE__ */ new Set();
+import { globalSlot } from "@ai-matrx/kit/global-slot";
+var listeners = globalSlot("ai-matrx.records.record-change-listeners", () => /* @__PURE__ */ new Set());
 function announceRecordChanged(recordId) {
   for (const listener of [...listeners]) {
     try {
@@ -239,7 +243,7 @@ function announceRecordChanged(recordId) {
     }
   }
 }
-var removed = /* @__PURE__ */ new Set();
+var removed = globalSlot("ai-matrx.records.removed-records", () => /* @__PURE__ */ new Set());
 function markRecordRemoved(recordId) {
   removed.add(recordId);
 }
@@ -250,7 +254,7 @@ function onRecordChanged(listener) {
   listeners.add(listener);
   return () => listeners.delete(listener);
 }
-var tableListeners = /* @__PURE__ */ new Set();
+var tableListeners = globalSlot("ai-matrx.records.table-structure-listeners", () => /* @__PURE__ */ new Set());
 function announceTableStructureChanged(tableId) {
   for (const listener of [...tableListeners]) {
     try {
@@ -566,9 +570,10 @@ function sourceArchivedOf(value) {
 }
 
 // src/ops.ts
+import { globalSlot as globalSlot2 } from "@ai-matrx/kit/global-slot";
 var REMEMBER_MS = 3e4;
 var REMEMBER_MAX = 500;
-var ours = /* @__PURE__ */ new Map();
+var ours = globalSlot2("ai-matrx.records.op-ledger", () => /* @__PURE__ */ new Map());
 function trim(now) {
   for (const [id, at] of ours) {
     if (now - at <= REMEMBER_MS) break;
@@ -6379,7 +6384,15 @@ function createTableDataPort({ client, aliases }) {
       const binding = bindingOf(alias);
       if (!binding) return noSuchAlias(alias);
       const shape = await shapeOf(alias, binding);
-      return shape.ok ? { ok: true, data: shape.data.columns } : shape;
+      if (!shape.ok) return shape;
+      return {
+        ok: true,
+        data: shape.data.columns.map((c) => {
+          const target = c.type === "relation" && c.linksTo?.length === 1 ? c.linksTo[0] : null;
+          const served = target ? Object.entries(aliases).find(([, b]) => b.tableId === target)?.[0] : void 0;
+          return served ? { ...c, linksToSource: served } : c;
+        })
+      };
     },
     async list(alias, q = {}, cursor) {
       const binding = bindingOf(alias);