@ai-matrx/records 0.87.14 → 0.87.15

package/CHANGELOG.md

@@ -1,9 +1,24 @@
 # Changelog — @ai-matrx/records
 
-## 0.87.14
+## 0.87.15
+### lane AO: a blank format-checked field is no value (0.87.14)
+
+From the final live test of the Applet builder (v0.4.3018, 2026-10-08): Brand form, only the name filled,
+Save → `record_write` 400 / 23514 "Contact Email is not written the way this field expects". The table data
+port kept "" for email / url / phone as "words", but every one of them carries a `pattern` Rule (measured live
+on `custom.field`: email 1209/1209, phone 999/999, url 236/236) and the store's pattern Rule refuses "".
+- `blankToNull(type, value, field?)` (`./data`): "" is kept ONLY for free text (`text`, `long`, `long_text`,
+  `rich_text`, `markdown`) whose Field carries no pattern Rule; every other column — every format the store
+  checks (email, url, phone, address, color, date, time, json, tags, signature, array) and every typed one —
+  writes a blank as null. `createTableDataPort` passes the column's Field.
+- Tests: `a-blank-format-checked-field-is-no-value.test.ts` — the Brands field rows captured live, through the
+  real `readTableShape` + `createTableDataPort`, judged by a mirror of `custom.validate_values` (red before).
+- **Consumer action:** none. An Applet's blank optional email / link / phone now saves.
+
+## 0.87.13
 
 Automatic changed-only republish (docs/metadata drift since the last tag — see
-`git diff npm/records/v0.87.13..npm/records/v0.87.14 -- apps/shared/records`).
+`git diff npm/records/v0.87.12..npm/records/v0.87.13 -- apps/shared/records`).
 No source changes intended and no consumer action required.
 
 ## 0.87.11

package/dist/data/index.cjs

@@ -6330,10 +6330,14 @@ function relationIdsOf(value) {
   }
   return out;
 }
-var WORD_TYPES = /* @__PURE__ */ new Set(["text", "long_text", "rich_text", "email", "url", "phone", "markdown"]);
-function blankToNull(type, value) {
-  if (typeof value === "string" && value.trim() === "" && !WORD_TYPES.has(type)) return null;
-  return value;
+var FREE_WORD_TYPES = /* @__PURE__ */ new Set(["text", "long", "long_text", "rich_text", "markdown"]);
+function hasPatternRule(field) {
+  return Array.isArray(field?.rules) && field.rules.some((rule) => rule?.kind === "pattern");
+}
+function blankToNull(type, value, field) {
+  if (typeof value !== "string" || value.trim() !== "") return value;
+  if (!FREE_WORD_TYPES.has(type)) return null;
+  return hasPatternRule(field) ? null : value;
 }
 function createTableDataPort({ client, aliases }) {
   const shapes = /* @__PURE__ */ new Map();
@@ -6408,7 +6412,7 @@ function createTableDataPort({ client, aliases }) {
       if (!column) return refuse2("invalid_argument", `This table has no column "${key}".`, "Ask columns() for the keys this table has now. Nothing was saved.");
       if (column.readOnly) return refuse2("invalid_argument", `"${column.label}" is worked out by the table, so it cannot be written.`, "Nothing was saved.");
       const kinds = column.type === "relation" ? entityKindsOf(shape.fields.get(key)) : [];
-      out[key] = kinds.length ? entityRefsOf2(value, kinds) : column.type === "relation" ? relationIdsOf(value) : blankToNull(column.type, value);
+      out[key] = kinds.length ? entityRefsOf2(value, kinds) : column.type === "relation" ? relationIdsOf(value) : blankToNull(column.type, value, shape.fields.get(key));
     }
     return { ok: true, data: out };
   }