@ai-matrx/records-ui 0.56.0 → 0.58.0

package/CHANGELOG.md

@@ -1,5 +1,73 @@
 # Changelog — @ai-matrx/records-ui
 
+## 0.58.0
+
+**A word pasted into a choice column becomes that option — and a paste is no
+longer capped by the page it is looking at.**
+
+**Pasting "Gold Annual" into a choice column.** Until now every word pasted into
+a `select` or `multi_select` was refused outright: correct about a raw string,
+and useless to Rincon Plumbing's office manager whose Service plan column says
+"Gold Annual" forty times. Airtable, the champion here, matches the word to the
+option labelled that word, and so does this.
+
+* The grid now READS each choice column's options before the preview draws, so
+  the preview is an answer rather than a "loading" a person would have to
+  confirm blind.
+* Matching ignores case and also accepts the option's key or id, so a round trip
+  through a spreadsheet comes back in. A multi-choice cell splits on commas and
+  semicolons and is written WHOLE or not at all — half a multi-choice answer is
+  a wrong answer, not a partial one.
+* What is stored is the option RECORD'S ID (FLD-5/FLD-6), which is what the
+  store's own validator accepts — writing the slug would have made the preview
+  promise a write the door then refused.
+* An unmatched word is REFUSED, naming the line, the column and the options that
+  ARE on offer, and **never silently created**: a typo promoted to a lifecycle
+  stage is a column nobody chose. The preview offers them back as ONE explicit
+  "Add these N options" action, pressed by a person; it sends the existing labels
+  back with the new ones (the door REPLACES the list) and re-plans, so the rows
+  land without pasting again.
+
+**A 120-line paste against a 50-row page.** The page ceiling was never a paste
+ceiling, and nothing exercised past it.
+
+* The creates now chunk through `record_write_many` at the grid's own page size —
+  the number a person is looking at is the number that travels. A refused chunk is
+  refused whole, so every line in it is NAMED ("Rows 51-100: …"); updates stay one
+  at a time because they carry a per-row optimistic version and no bulk door can
+  honour it.
+* The read-back PAGES. A single `limit: 500` read silently stopped counting at row
+  500, so a table that had grown past it reported values "missing" that were
+  sitting in it — a read-back that lies is worse than none.
+
+**Consumer action:** none. `PastePreview` gains an optional `onAddOptions`; a host
+that does not pass it simply does not offer the action.
+
+## 0.57.0
+
+**The builders are usable where a person actually reaches them: a 384px rail.**
+
+The first browser walk (lane BUILDERS, Ironline Fitness, 2026-09-21) pressed
+"Build the form" on a real gym's members table and got a preview of an empty
+form and **no controls at all**. `FormBuilder` was authored as two desktop
+columns — controls left, live preview in a `w-96` aside right — and the rail it
+is mounted in is itself `w-96`, so the fixed-width preview took the entire rail
+and squeezed the controls to nothing. The screen looked like a builder and could
+not build.
+
+A viewport breakpoint cannot fix that: the viewport was 1680px wide while the
+container was 384px. Every split in these four screens is now a **container
+query**, so they are the same screen in a rail, a dialog or a full page:
+
+* `FormBuilder` stacks to one column and its preview goes full-width below the
+  controls until the component itself is wide enough for two (`@3xl`).
+* `BookingBuilder`, `PortalBuilder` and `DigestScheduler` drop their two-column
+  grids and fixed-width inputs to one column under `@md`.
+
+**Consumer action:** none. The host must already scan this package's `dist` for
+Tailwind classes (`@source "…/@ai-matrx/records-ui/dist"`), which matrx-frontend
+does; the container variants are generated from there like every other class.
+
 ## 0.56.0
 
 **A condition the builder cannot draw is said in words, not blanked.**