@ai-matrx/records-ui 0.7.0 → 0.10.3

package/CHANGELOG.md

@@ -1,5 +1,178 @@
 # Changelog — @ai-matrx/records-ui
 
+## 0.10.3
+
+Reissues the unpublished 0.10.2 candidate. Its live-store release gate exposed
+a race in the field-add smoke harness: it unmounted each panel immediately
+after clicking Save, before the asynchronous declaration had landed. The
+helper now waits until the real store reports the exact new Field before
+proceeding. Package behavior is unchanged.
+
+### Consumer action
+
+None.
+
+## 0.10.2
+
+Reissues the unpublished 0.10.1 candidate after its live-store release gate
+revealed that the demo selector read `document.title` while the actual
+`custom.record` row exposes the record payload as `data.title`. The smoke test
+now selects Acme Industrial from the real row shape; package behavior is unchanged.
+
+### Consumer action
+
+None.
+
+## 0.10.1
+
+Reissues the unpublished 0.10.0 package after its live-store smoke test selected
+the oldest demo record while asserting the identity of Acme Industrial. The
+test now selects that record by title, so re-seeding cannot substitute another
+record. Package behavior is unchanged from the 0.10.0 candidate.
+
+### Consumer action
+
+None.
+
+## 0.10.0
+
+**The three things the 19 September verdict (fifth pass) said a person hits the
+moment they touch a table.**
+
+**A double-click opens the typed editor, on every cell.** The verdict: "only the
+Title column can be opened by double-clicking; double-clicking any other cell
+opens a developer inspector — a floating window showing the record's raw JSON,
+its machine keys, a truncated id, and the headings DOCUMENT, LEVEL and HIDDEN."
+Two things did that. The data table ships a side panel AND a floating window,
+both falling back to `DataRowInspector`; the grid now turns both OFF, because
+this package has a record panel of its own (`Peek`, through `onRowOpen`) and a
+second one beside it is the parallel layer the platform forbids. And a cell now
+FILLS its cell and answers `dblclick` itself — the second press used to land on
+bare table cell after the first had swapped the DOM under the pointer, and a
+bare cell is a row click, which is exactly why a wide column worked and every
+narrow one did not.
+
+**Tab commits the typed value before it moves.** The verdict: "when we tabbed
+along a row, the first five values saved and the last four were silently
+dropped." The draft used to live in the open CELL, and this screen re-renders
+that cell for reasons that have nothing to do with the person typing — every
+accepted write calls `reload()`, which rebuilds the rows, the columns and the
+cells. A cell that remounted mid-edit came back initialised from the stored
+value, so the commit wrote what was already there and the screen correctly
+treated it as "nothing changed". The draft now lives in the editing session,
+beside the address of the open cell and the value it started from; `commit(move)`
+takes no value at all, because there is only one place the typed value can be
+read from. The editor is focused once per opening rather than on every render.
+
+**"Total of linked records" can be added, and a refusal is a sentence.** The
+panel now offers EVERY relation column — including the ones that hold a single
+record, marked "holds one" — because hiding "Crew lead" from the list taught a
+person nothing. `whatIsMissing` asks, in the panel's own words, what has not been
+answered yet ("Crew lead points at one record at a time, so there is nothing to
+total. Tick 'Can hold more than one' on Crew lead, or use Borrowed value to read
+its one value."), the sentence sits under the button, and the panel never sends a
+declaration it already knows the store must refuse.
+
+**A hint written for an engineer never reaches a person.** A store refusal
+carries a message for the person and a hint for whoever has to fix the caller
+("FLD-11: … config.via names a relation Field of this same table, by its key").
+This package printed both. `hintForAPerson` now filters the hint BY SHAPE — a
+contract row id, a schema-qualified database object, a path inside a document,
+a snake_case identifier or a SQLSTATE — and what it filters joins the SQLSTATE on
+the notice's title, for an engineer. A hint in ordinary words is still shown
+verbatim.
+
+New exports: `whatIsMissing`, `hintForAPerson`, `hintIsMachineIdentity`.
+
+### Consumer action
+
+None. `GridEditing.commit` now takes `(move)` instead of `(value, move)` and
+carries `draft` / `type`; nothing outside this package calls it.
+
+## 0.9.0
+
+**Sharing reaches the record and table screens (SCR-N-5).** `ShareControl` puts a
+Share button on the record peek and on the table page, and hands the subject to
+the host through a new `share` port on `<RecordsUiProvider>`.
+
+This package ships NO share dialog, deliberately, for the same reason it ships no
+chat: AI Matrx has exactly one sharing surface, and a second one here would give
+the platform two answers to "who can see this". With no `share` port bound there
+is NO BUTTON — not a greyed one, not one that opens an empty panel — and
+`NO_SHARE_REASON` names the port for anything that asks why.
+
+A Table is a record in this store, so one control, one subject shape and one
+dialog serve both screens; `kind` only changes the noun in the sentences.
+
+New exports: `ShareControl`, `useCanShare`, `shareUnavailableReason`,
+`NO_SHARE_REASON`, and the `ShareSubject` type.
+
+### Consumer action
+
+Bind `share` on your `<RecordsMount host={{ … }}>` with the app's own sharing
+dialog, e.g. in matrx-frontend:
+
+```tsx
+import { recordStoreShare } from "@/features/sharing/components/RecordStoreShareSurface";
+
+<RecordsMount host={{ Link, density: "condensed", share: recordStoreShare }} …>
+```
+
+Leave it out and nothing changes — the screens render exactly as they did in
+0.8.0, with no Share button.
+
+
+## 0.8.0
+
+**The worst finding of the 19 September verdict: "Add field" opened a proper
+panel and then refused everything.** Number and Date were refused as undeclared,
+Person was refused as a Formula, a choice list demanded a table the panel could
+not name, and before any of those the Key box was blank, unmarked and required.
+A table made with the product's own button had exactly one column.
+
+- **The panel collects an INTENTION, and the store decides the rest.**
+  `FieldEditor` writes through `custom.field_declare` (`useFieldMutation`) and no
+  longer assembles a Field document of its own. It never sets a behaviour, a
+  format, a unit, a relation target, a relation maximum, a compute_on or a
+  pattern Rule — every one of those was a second place for the thirteen types to
+  be wrong.
+- **Sixteen things a column can hold, in a menu under four headings**, each with
+  one line saying what it is FOR. `fieldTypes.ts` is new;
+  `parityTypesWithNoExplanation()` fails the suite the moment the store ships a
+  fourteenth parity type nobody has written a sentence for.
+- **A choice list is defined where a person defines it** — the words go in a box
+  and the store keeps them as a Table (FLD-5 / FLD-6 untouched). Nobody is asked
+  to build a table before they can have a dropdown.
+- **A Person field offers people.** It resolves to a relation at the kernel
+  Person Table, decided by the store.
+- **The Key box is gone.** The key is derived from the name and shown, never
+  demanded.
+- **A field is edited and removed from the same panel**, and removal names the
+  consequence before the second press. `TableSettings` retires through the field
+  door rather than deleting the record, so the TABLE stops declaring the column
+  too; the three unsafe removals (the title field, the last field, one another
+  field reads through) are refused by name.
+- **Ids stopped being drawn as values.** `RecordLabelProvider` resolves a choice
+  or a relation id to the name of the record it points at, once per Field, for
+  every read-only surface — the Kanban board's column headings were bare
+  36-character identifiers.
+- **`3` in `units` no longer renders as `units3`.** `editorKindFor` called any
+  range field with a unit longer than one character a currency; a currency is a
+  range whose FORMAT is currency, which is what the store's own `parity_type`
+  says.
+- **One word per type everywhere** — the settings row says what the panel
+  offered, and the store's "made of" sentences (`REC-31: a File record reached
+  through a relation`, `evaluated by custom.rule_eval`) are out of the UI.
+- The person picker draws a name and an email as two facts, not one run-on
+  string.
+
+### Consumer action
+
+`renderValue` still works and still draws an unresolved id as "Loading…". A host
+drawing values outside `RecordsMount` should render `<RecordValue>` (or wrap in
+`RecordLabelProvider`) so ids resolve to names.
+
+
 ## 0.7.0
 
 What the first headless walk of 0.6.0 through a real browser found, in the same