@ai-matrx/design-system 0.25.0 → 0.26.0

package/CHANGELOG.md

@@ -1,5 +1,81 @@
 # Changelog
 
+## 0.26.0 — 2026-09-20
+
+**The four things a re-point of the owner's `/data` grid would have lost, now
+first-class in the shared table.**
+
+A capability-by-capability walk of that route against this package found four
+gaps. Each is built here, in the shared layer, so every table in the product
+gets it — not one route.
+
+- **THE FOUR RIGHT-CLICK LEVELS.** The package exposed exactly ONE context
+  descriptor — the row — so a surface wanting a cell, a column or a selection
+  menu had to fork the table. It now answers all four. `menu-targets.ts` reads
+  which level the pointer was aimed at off the anchors the table renders
+  (`data-matrx-header-column-id` is new on every header; body cells already
+  carried `data-matrx-table-column-id`), with the precedence a spreadsheet
+  person expects: a click inside an extended range is the RANGE, never the one
+  cell under it — except a range of one cell, which is a cell.
+  `MatrxDataTableContextMenuConfig` gained `resolveCellContext`,
+  `resolveColumnContext`, `resolveSelectionContext` and `resolveTableContext`;
+  the host's `createDefaultRowContext` became `createDefaultMenuContext`, which
+  takes one payload carrying the level and what it is acting on. The package
+  still never interprets a menu — that stays the application's.
+- **ENTER TO EDIT, AND TYPE TO REPLACE.** `classifyGridKey` had classified
+  `edit` and `editSeeded` since the gestures landed and nothing consumed them.
+  `useSpreadsheetGrid` now asks its consumer through `onEditRequest(address,
+  seed)` and consumes the keystroke only when an editor actually opened — so a
+  read-only column types nothing instead of swallowing the character.
+  `MatrxDataTable` performs it through the SAME `editRequest` door the row
+  menu's "Edit row" already used, and a seeded editor opens holding the typed
+  character rather than the old value.
+- **FILTER VALUE COUNTS.** A "Contains…" box asks the reader to already know
+  what is in the column. `facets.ts` counts the real values, blanks included as
+  a countable option, and `MatrxDataTableFacetsConfig` decides where the counts
+  come from: the browser when it holds every row the counts describe, the
+  consumer's `source` when it does not — and when neither can answer for the
+  whole table, the popover SAYS the counts cover only the loaded rows. A
+  complete answer says nothing at all. Counting happens when someone opens a
+  popover, never on first paint.
+- **VALIDATION REFUSALS, IN THE CELL, IN WORDS.** `data-table/validation` was a
+  published module the table never called. `edit.validate` now judges a value
+  before it enters the draft and a returned sentence is a refusal: the editor
+  stays open holding what the person typed and the sentence renders under the
+  cell in amber, clearing the moment they change the value. The same judgement
+  screens paste, fill and clear through `spreadsheet.validateCell` — a rule a
+  paste can walk around is not a rule.
+
+**Two defects only a real browser could find**, both in the seam between the
+cell cursor and the editor, both green in jsdom:
+
+- **A click selected the cell and then every keystroke went to the document
+  body.** `preventDefault` on a mousedown also prevents focus, so the grid
+  container never got it — and Enter, a typed character, an arrow and Cmd-Z all
+  landed on nothing. A jsdom test dispatches the keydown ON the container by
+  hand and can never see it. The cell cursor now focuses the grid.
+- **A click on a string-editable cell dropped straight into a text box**, which
+  is THE CLICK LAW broken at the one place the two paths meet: the same click
+  starts a range, and an editor opening under the pointer eats the drag and the
+  next keystroke. With spreadsheet gestures on, the editor opens the way it does
+  in Excel — Enter, F2, the hover pencil, or typing — and an explicit
+  `editTrigger: "click"` does not override it.
+
+New entry points: `/data-table/facets` and `/data-table/menu-targets`, both
+pure. Suite: 101 files / 1,073 passed. Red twin
+`MatrxDataTable.four-levels.red.tsx`: 13/13 fail. Three absence-asserting
+clauses and one rendering clause are deliberately not twinned, and the red file
+says which and why. Browser proof on a production build, 1440x900 headless
+Chromium, zero console errors: right-click answered `cell · Amount`,
+`column · Status`, `row · Row` and `selection · 16 cells`; Enter opened the cell
+on `Ada` and typing `Z` opened it on `Z`, committing `Zara`; the Status filter
+listed five values at 400 each and filtering to Done left only Done on screen;
+a 500-row table declaring 84,312 said *"These counts cover the 500 rows loaded
+here, not the whole table."* and a complete answer said nothing; a blank Owner
+was refused in the cell with *"Owner cannot be empty. Every job needs someone on
+it."* while the editor stayed open, and the same rule refused a paste
+(`Pasted 0 cells.`) that never touches an editor.
+
 ## 0.25.0 — 2026-09-20
 
 **Five defects a real browser found that jsdom could not, and the table's own

package/dist/data-table/copy-helpers.d.cts

@@ -1,5 +1,5 @@
 import { AgentPayloadInput } from './copy-types.cjs';
-import { g as MatrxDataTableCopyConfig, M as MatrxColumnDef } from '../types-CmQrOz-T.cjs';
+import { g as MatrxDataTableCopyConfig, M as MatrxColumnDef } from '../types-DrJXAAoD.cjs';
 import '../content-transfer.cjs';
 import 'react';
 import '@ai-matrx/kit/content-transfer';
@@ -7,6 +7,7 @@ import '../content-transfer/icon.cjs';
 import '../types-CJWU1Gae.cjs';
 import './grouping.cjs';
 import './fill.cjs';
+import './facets.cjs';
 import './spreadsheet.cjs';
 import './grid-selection.cjs';
 

package/dist/data-table/copy-helpers.d.ts

@@ -1,5 +1,5 @@
 import { AgentPayloadInput } from './copy-types.js';
-import { g as MatrxDataTableCopyConfig, M as MatrxColumnDef } from '../types-nlLCMiqd.js';
+import { g as MatrxDataTableCopyConfig, M as MatrxColumnDef } from '../types-Cu5_eUG1.js';
 import '../content-transfer.js';
 import 'react';
 import '@ai-matrx/kit/content-transfer';
@@ -7,6 +7,7 @@ import '../content-transfer/icon.js';
 import '../types-CJWU1Gae.js';
 import './grouping.js';
 import './fill.js';
+import './facets.js';
 import './spreadsheet.js';
 import './grid-selection.js';