@ai-matrx/records 0.96.3 → 0.96.5

package/dist/{types-BhGs3f8s.d.cts → types-KdeN9-5L.d.cts}

@@ -301,13 +301,21 @@ interface TemplateTable extends UseCaseTable {
     /**
      * REUSE, NEVER DUPLICATE (CHAIR-DESCRIBE-2): this template table IS one the organization already has.
      * The install makes no table for it — `tables.<token>` is the existing table's id from the first step —
-     * declares only the fields it lacks (`fields` = the keys it already has), seeds none of its rows, never
-     * resets its Dimensions, and links the template's new tables to it. Uninstall archives only what the
-     * install added (its new fields, views, forms), never the table.
+     * declares only the fields it lacks (`fields` = the keys it already has), never resets its Dimensions, and
+     * links the template's new tables to it. Uninstall archives only what the install added (its new fields,
+     * views, forms), never the table.
+     *
+     * ITS ROWS (a sample row is never dropped whole): by default it seeds none, and a new table's value that
+     * points at one of its sample rows is left empty. `seedRows` - the caller found the table EMPTY - writes
+     * the template's sample rows into it, so every link to them lands. `rowIds` - the table HAS rows - maps a
+     * sample row's key to the id of the existing row it means; a link to a mapped key lands on that row, a link
+     * to any other key is left empty (and the field stops being required, so the new row still installs).
      */
     bindsTo?: {
         tableId: string;
         fields: string[];
+        seedRows?: boolean;
+        rowIds?: Record<string, string>;
     };
     /**
      * Ordered date pairs that hold on every seed row: [earlier, later]. A side is a field of

package/dist/{types-DAruHh1G.d.ts → types-qvGJwpw3.d.ts}

@@ -301,13 +301,21 @@ interface TemplateTable extends UseCaseTable {
     /**
      * REUSE, NEVER DUPLICATE (CHAIR-DESCRIBE-2): this template table IS one the organization already has.
      * The install makes no table for it — `tables.<token>` is the existing table's id from the first step —
-     * declares only the fields it lacks (`fields` = the keys it already has), seeds none of its rows, never
-     * resets its Dimensions, and links the template's new tables to it. Uninstall archives only what the
-     * install added (its new fields, views, forms), never the table.
+     * declares only the fields it lacks (`fields` = the keys it already has), never resets its Dimensions, and
+     * links the template's new tables to it. Uninstall archives only what the install added (its new fields,
+     * views, forms), never the table.
+     *
+     * ITS ROWS (a sample row is never dropped whole): by default it seeds none, and a new table's value that
+     * points at one of its sample rows is left empty. `seedRows` - the caller found the table EMPTY - writes
+     * the template's sample rows into it, so every link to them lands. `rowIds` - the table HAS rows - maps a
+     * sample row's key to the id of the existing row it means; a link to a mapped key lands on that row, a link
+     * to any other key is left empty (and the field stops being required, so the new row still installs).
      */
     bindsTo?: {
         tableId: string;
         fields: string[];
+        seedRows?: boolean;
+        rowIds?: Record<string, string>;
     };
     /**
      * Ordered date pairs that hold on every seed row: [earlier, later]. A side is a field of

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ai-matrx/records",
-  "version": "0.96.3",
+  "version": "0.96.5",
   "description": "The headless client of the AI Matrx record store: the Table / Field / Rule / Record / Relation / Home types, the closed vocabularies and refusal codes read from the store itself, the typed calls over the store's doors and nothing else, the merge-field declaration, a validation mirror that predicts only what the store's own triggers refuse, and the never-throw result envelope. Zero React, zero DOM in the root and /core.",
   "type": "module",
   "main": "./dist/index.cjs",
@@ -320,5 +320,5 @@
     "describe-bench:run": "../../../.venv/bin/python scripts/describe-bench/score-env.py run",
     "describe-bench:arms": "../../../.venv/bin/python scripts/describe-bench/score-env.py arms"
   },
-  "gitHead": "18fdbaf713c5f2525433f92c52d183c6b27bd8b4"
+  "gitHead": "830c3f8d93353b81a6ededebf020a3643a309d09"
 }