@ai-matrx/records-ui 0.85.18 → 0.88.0

package/CHANGELOG.md

@@ -1,12 +1,143 @@
 # Changelog — @ai-matrx/records-ui
 
-## 0.85.18
+## 0.88.0 (2026-09-26 — type-to-edit; needs @ai-matrx/design-system 0.43.0)
+
+- **Type to edit (both grids).** Select a cell and type: the cell opens ITS OWN Field editor
+  holding what was typed — a letter, an IME composition, an Option/AltGr character, dictation —
+  through design-system 0.43's type catcher and `spreadsheet.onEditRequest`. A column a person
+  types into opens with the typed text replacing the value (numbers only when it is a number); a
+  picker column opens as usual; a worked-out column or a row this person may not write swallows
+  nothing. The editor opens with the caret at the end. `GridEditing.begin(address, seed?)`.
+- **"Who changed this?" moved off the bare `h`** (it clashed with typing): Option-Shift-H
+  (`asksWhoChanged`, read off `code`), the cell's own badge, and the merged grid's right-click
+  Cell section ("Who changed this?  ⌥⇧H").
+- Test doubles: `store-rule-gaps.test.tsx` answers `field_options` (the column settings read an
+  existing choice column's words for its colours) — 0.87.0's CI publish failed on it.
+
+## Unreleased
+
+- **Fix: the one toolbar row never overlaps and never spills** (lane V25-UI-FIXES; VERIFIER-25 on
+  production at 1600 px: with Settings open, the purple *Settings* button and the grid's *Manual*
+  sort chip overprinted; with a personal look pending the row ran to 1663 px in 1532 px, *New record*
+  cut to "Ne", *Layout* past the edge). The layout's slot in `TablePage`'s row is its own sideways
+  scroller, so what a layout draws there can never spill over the buttons after it; every piece
+  after the slot keeps its width. The row MEASURES its pieces (`useToolbarFit`, `toolbarFit.ts`) and,
+  when they do not fit, folds the least it must — first your look's three doors into one
+  **Your look** menu (same doors, same words), then the inline layout chooser into the table's menu
+  (where a phone already has it) — from widths measured unfolded, so it never flips back and forth.
+  Pure `toolbarFold` and the layout pair guard `overlappingPieces` are exported for walks. Suites:
+  `the-toolbar-row-never-overlaps.test.tsx` RED 5/5 on 0.87.0 bytes → GREEN 5/5;
+  `toolbarFit.test.tsx` 7/7.
+
+## 0.87.0 (2026-09-25 — one-grid merge step 5 + tranches 6a / 6b; needs @ai-matrx/design-system 0.42.0)
+
+- **THE MERGED GRID, behind a temporary switch (`RecordsUiHost.grid?: "classic" | "merged"`,
+  default `classic`).** Arman and the custom-data lead ruled that the older /data grid's behaviour
+  becomes THE table grid in this package. `merged` lays its control layer over `Grid`'s data paths
+  (`gridControls.tsx`, pure builders in `gridMenus.ts`):
+  - **Column header menu** (`MatrxColumnDef.headerMenu`): Rename column, Column settings…, Insert
+    column left… / right…, Use as row label (`title_field`), Hide column, Delete column… — each
+    through the store's own doors (`field_update`, `field_declare` via `FieldEditor`,
+    `field_retire`, the table record's `title_field`); a person who may not change the table's
+    shape sees each item with the reason, never a dead one.
+  - **Right-click** (`contextMenu.sections`): Cell (copy, paste, clear, who changed this, show rows
+    with this value), Row (open record, row history, copy row, insert row above/below on a
+    hand-ordered view, duplicate, delete), Column (sort A→Z / Z→A / clear, plus the header items),
+    Table (new record, add column); a selected range gets copy / clear / fill down. Every write is
+    the grid's own versioned cell write.
+  - **Column order and hidden columns are kept on the view's look** (`presentation.columnOrder` —
+    new, sparse like `widths` — and `presentation.hiddenFields`), written through
+    `onPresentationChange` (the table page's `view_look_set`), so they survive a reload.
+  - A column inserted left/right of another lands beside it in the view's order.
+- **Merge step 5 (pure refactor):** `Grid.tsx`'s drawing parts moved to `gridColumns.tsx`
+  (`columnForField`, `workedOutFrom`, `reorderItems` still exported from `Grid`).
+- **A reader can copy (both grids):** readers get the spreadsheet cursor with `readOnly` — range
+  select, select all, Cmd-C — and every write gesture says why it cannot run.
+- **A choice wears the colour its column keeps (both grids, tranche 6f early):** the Field's own
+  `display_format.options.choices` colours (what the /data-v2 Sheet's seam writes) now paint choice
+  chips (design-system `CELL_TINT_CLASS`) and the colour-by lookup; a word with no kept colour
+  still reads plain / hashes as before (`choiceLooks.ts`).
+- **Column settings edit an existing column's look** (`FieldEditor`): per-choice colours
+  (`ChoiceColorsEditor`) and "Shows as" for plain columns (`ShowsAsPicker`, the design-system
+  format registry), both sent as the Field's `display_format` in the same `field_update`;
+  `formatForField` now honours a plain column's `display_format` (`shownAsOf`).
+- **Fix:** `Grid` called a hook after its refusal early-return, so a refused table read threw
+  "Rendered fewer hooks than expected" instead of drawing the store's sentence (exposed when
+  `useTable` moved to `read_records_by_ids`). The clinic testkit models that door.
+- **Guard:** `the-package-imports-no-app.test.tsx` — no source file imports `next/*`, `@/…`,
+  supabase or redux.
+
+## 0.86.1
 
 Automatic changed-only republish (docs/metadata drift since the last tag — see
-`git diff npm/records-ui/v0.85.17..npm/records-ui/v0.85.18 -- apps/shared/records-ui`).
+`git diff npm/records-ui/v0.86.0..npm/records-ui/v0.86.1 -- apps/shared/records-ui`).
 No source changes intended and no consumer action required.
 
-## Unreleased
+## 0.86.0 (2026-09-25 — version and notes set by PUBLISHER-5; needs @ai-matrx/design-system 0.40.0)
+
+- **A text kept as a file is edited WHOLE (lane BIG-VALUES-WRITE, owner 2026-09-25: "Make sure that
+  large data size is easy for users").** A text of any size now simply saves — the store keeps the
+  first 1000 characters in the cell and the whole text as a file, behind the scenes. So the grid's
+  cell editor (`useGridEditing.begin`, and tabbing into such a cell) reads the WHOLE text through the
+  host's `readFileText` and opens on it; saving writes the whole edited text (the store files it as
+  the next version) and a conflict is judged against what the store holds. The record form's box is
+  the new `WholeValueEditor` (the whole text in a 12-row box, spanning the form). A host that cannot
+  read files opens NO editor on such a cell — the cell keeps its words and "Open the whole text" —
+  because an editor holding the first 1000 characters would, on save, cut the value to its start.
+  New in `WholeValue.tsx` (package-internal): `WholeValueEditor`, `useWholeText`, `wholeValueOpening`,
+  `WHOLE_VALUE_NOT_EDITABLE_HERE`. **Consumer action:** bind `readFileText` (matrx-frontend's
+  `RECORDS_FILES` already does) or file-backed cells are read-only in place.
+
+- **Three rows above the data (lane TABLE-PAGE-CHROME, owner 2026-09-25: "six distinct rows sit
+  above the actual data … consolidate").** `TablePage` draws ONE toolbar row: the view picker (one
+  chip — the view's name — opening the list, New view and the view's own settings), the layout
+  chooser, the view's filter and your look (Save to view / Save as new view / Reset to view as
+  compact controls, the sentence as their title), then a SLOT where the showing layout puts its own
+  controls: the Grid draws its data-table toolbar (search, columns, sort) INTO the row
+  (design-system `toolbar.portalInto` + `singleRow`), a board its "Group by" / "Dates from"
+  (`InTableToolbar`), and a host layout is handed the slot as `render({ toolbarSlot })`. Nothing
+  wraps; on a phone the row scrolls sideways. The look bar's own row and the saved-view tabs row are
+  gone. Exported: `InTableToolbar`, `TableToolbarSlotContext`, `useTableToolbarSlot`.
+- **`TablePage.header(chrome)`** replaces `leading`: the host is handed `{ actions, tableName }` —
+  Share and the table's one menu — and draws them in ITS page header (the app's back button and
+  title switcher beside them). Without `header` they end the toolbar row. The menu no longer
+  carries a second list of views or the "Saved views" toggle; views live in the one picker.
+  `actions` is a fragment of two siblings (Share, the menu) so a host's header can fold them one by
+  one; on a phone Share is an item of the menu ("Share…") and the header keeps back, the title and
+  ONE menu. **Consumer action:** a host that passed `leading` passes nothing (the organization belongs to the
+  host's header); a host with a page header passes `header`. `TablePageHeaderChrome` is exported.
+- **The hand-order sentence is toolbar state.** "Sort: Manual · set by hand" / "Sorted by X ↑ ·
+  hand-set order set aside  Back to manual  Use this sort instead" was a sentence row; it is now
+  `SortStateControl` — a sort icon, the order in a word, a badge while a column sort sets the hand
+  order aside, and a popover that says the state in one line with Back to manual / Use this sort.
+  `handOrderSortState`, `handOrderLine` and `MANUAL_SORT` are exported so a host's Sheet draws the
+  same control.
+- **Where the footer sits is a view setting** (`presentation.footer`: `sticky` | `inline`, store key
+  declared by `custom.view_keys()` on production 2026-09-26 02:4xZ). Default `sticky` (the older
+  grid's pinned counts and pages): the records fill the page's height and the layout scrolls inside;
+  `inline`: the region scrolls and the footer follows the last row. Chosen in the view picker's
+  "Footer" setting, kept as the person's look until Save to view. `Grid.footer`,
+  `ViewSwitcher.footer`, host layouts get `render({ footer })`. Exported: `footerOf`,
+  `DEFAULT_FOOTER`, `FooterPlacement`, `FOOTER_WORDS`. **Consumer action:** mount `TablePage` in a
+  height-bounded body (`h-full overflow-hidden`) so the sticky footer has a height to fill.
+- **A chip's words are drawn in their own surface's foreground.** The view tab's "default" was
+  `text-muted-foreground` on the pressed `bg-secondary` tab (black on dark purple in light mode); the
+  picker is the `subtle` surface and its Default tag the `neutral` Badge. Census, same class, fixed:
+  `EntityReferenceControl` and `EntityReferenceKindPicker` (× on a secondary Badge) and `DocTemplate`
+  (version on a secondary tab) now inherit the surface's colour. Guard `crossedPairs` in
+  `the-table-page-is-three-rows.test.tsx`.
+- On a table page the Grid's "Not live" is a word in the toolbar row (the reason on hover), not a
+  line under it; the inline footer region is a plain scrolling block so the layout is as tall as
+  its rows. Walk: `demo/table-chrome-walk.mjs` (harness on the dev clone, source bytes) GREEN 14/14 —
+  three rows above the first data row at 1600, the sort popover, the footer sticky → inline → reset,
+  no crossed chip foreground light or dark, one toolbar line at 390.
+- Suite `the-table-page-is-three-rows.test.tsx` RED 8/9 on the prior bytes → GREEN 9/9; the hand-order,
+  saved-view and designation suites were moved to the new contract.
+
+## 0.85.18
+
+The auto release stubbed this version as a docs-only republish; it carried V24-TAILS's source
+change below (notes placed under it by PUBLISHER-5, 2026-09-25).
 
 - `TablePage` takes `onShownViewChange(shown: ShownViewReport)` (lane V24-TAILS, VERIFIER-24 item 6):
   the view exactly as the page draws it — saved view, the person's look laid over it, the address's
@@ -3756,3 +3887,4 @@ First release: `Grid`, `RecordForm`, `FieldEditor`, `TableSettings`,
 `CustomFieldsSection`, plus the `RecordsUiProvider` rights port and the shared
 refusal surface. Every one of them is proven headlessly against the rehearsal
 branch by `pnpm test`.
+