@ai-matrx/records-ui 0.50.0 → 0.51.0

package/CHANGELOG.md

@@ -1,5 +1,45 @@
 # Changelog — @ai-matrx/records-ui
 
+## 0.51.0
+
+**Paste fifty rows out of a spreadsheet, see what they will become, and only
+then write them.**
+
+Real-data crew C, 2026-09-21, entering fifty US airports: *"No 'Paste' control
+(bulk paste of a spreadsheet block) exists on the `/data-v2` grid toolbar —
+only 'New record' (one blank row at a time) and per-cell double-click
+editing"*. That is two hundred and fifty double-clicks for one ordinary
+spreadsheet. The canonical grid has had Excel/Sheets TSV paste since lane
+GRID-ONE; the store's own table never opted in.
+
+It opts in now, with the three things a paste into a real store needs and a
+spreadsheet's paste has none of:
+
+* **Per-cell refusals in plain words, before the write.** Every clipboard
+  string is coerced the way that column's own editor coerces it — `$1,250.50`
+  is 1250.5 on a money column, `(75.00)` is −75, `TRUE`/`yes`/`N` are a tick
+  box — and what cannot be coerced is left alone and named: *"Callout fee holds
+  a number, and “waived” is not one."* A list, a person, a file or another
+  record is an identity rather than a word, so a pasted word into one of those
+  is refused with the control that does hold it. Then the row is put to
+  `predictValueRefusals`, the package's mirror of `custom.validate_values`, so
+  a required column left empty comes back in the STORE's sentence rather than
+  one this screen invented.
+* **A preview.** The grid's new `onPastePlan` means the primitive applies
+  nothing: the person sees the values as they will be stored, how many records
+  change and how many are **created**, and every cell that will be left alone
+  with its reason — then presses the button themselves.
+* **Success only after a read-back.** The writes go through the two doors the
+  grid already uses — `recordUpdate` for a row that exists, `recordWrite` for
+  one that does not — one call per row rather than per cell, and then the table
+  is READ AGAIN and the values counted. The door's yes is not the answer; that
+  confusion is what made "Add field" report success over a column that was not
+  there.
+
+The rows past the last row become new records, which is the whole point: a
+person filling a new table has three rows on screen and fifty lines on the
+clipboard. Needs `@ai-matrx/design-system` 0.29.0.
+
 ## 0.50.0
 
 **Rules for entering this stage — the screen that writes a gate.**