@ai-matrx/design-system 0.28.0 → 0.31.0

package/CHANGELOG.md

@@ -1,5 +1,76 @@
 # Changelog
 
+## 0.31.0 — 2026-09-21
+
+**A paste refusal now carries the value it refused.**
+
+`SpreadsheetPastePlan.refusals` named a row and a column and dropped the cell's
+value, so a consumer showing a person their fifty pasted rows could say a cell
+was skipped but not what was in it — and, if it re-planned the block, could not
+put the cell back where it belonged. Measured on Rincon Plumbing's September
+billing run: every refusal on an existing record read "Row 0, amount_due",
+because the value never reached the code that knew the line number and the
+column's name. A refusal nobody can locate is half a refusal.
+
+`PasteRefusal.value` is what `validateCell` turned away. Additive; nothing that
+ignores it changes.
+
+## 0.30.0 — 2026-09-21
+
+**"Set as my default" had not picked an organization for anybody since
+2026-09-19, and went on saying it would.**
+
+The owner deleted the durable-default rung from the platform's org resolver on
+2026-09-19 — *"a default organization is at most a per-client DISPLAY
+preference; the org picker may show it and nothing else may read it"* — and
+nobody changed this switch's words. It still read **Set as my default**, with
+*"Next startup opens Acme"* and *"Auto-select this at startup"* underneath.
+
+Crew D2 met that on 2026-09-21 and reported it as a persistence bug: the
+selection gone on a fresh browser profile *"with no persistence despite a 'Set
+as my default' toggle implying it should stick"*. Measured on production, the
+selection persists perfectly on the machine that made it — across navigation, a
+fresh tab, the record's own URL and a reload, restored from the apex cookie even
+with the browser cache emptied. What was broken was the sentence.
+
+So the switch says what it does — **Keep it at the top** — and it now DOES
+something, which it never did: the starred organization is drawn **first** in
+the list, every other row left in the host's order. With ninety organizations
+in the picker, the one you work in every day was somewhere in the middle of it.
+That is what a star is for in Slack and in Linear.
+
+A clause holds the line: no sentence on that control may contain *startup*,
+*next time*, *automatic*, *auto-select* or *by default* again.
+
+## 0.29.0 — 2026-09-21
+
+**A paste of fifty spreadsheet rows stopped throwing forty-six of them away.**
+
+Real-data crew C copied fifty US airports out of a spreadsheet and pasted them
+into a table that held four rows. Four rows were written, and the other
+forty-six came back as *"46 landed past the edge of the table and were
+ignored"* — an honest sentence about a useless outcome. The grid is the one
+thing that knows which rows they were, and it was counting them and dropping
+them.
+
+It still does not create rows: the table owns the gestures and the consumer
+owns the writes, and that boundary is what keeps every table's persistence its
+own. So it hands the rows over instead. `spreadsheet.onPastePlan` is the new
+half of the contract:
+
+* absent — byte-for-byte the paste that existed before, screened and applied;
+* present — the table computes the plan, applies **nothing**, and hands over
+  `accepted` (the cells it would write, already screened by `validateCell`),
+  `refusals` (each with the row it belongs to, which they did not carry before,
+  and the sentence that says why), `overflow` (the rows past the last row,
+  whole, in the grid's current column order) and `pastRightEdge` (cells with no
+  column to hold them — those there will never be a home for). `apply()` writes
+  the accepted cells exactly as an unconfirmed paste would.
+
+That is what lets a surface show a person what is about to be written before it
+is written, and what lets one that knows how to make a row make the other
+forty-six.
+
 ## 0.28.0 — 2026-09-21
 
 **Two organizations with the same name were indistinguishable in the picker.**

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-jQddSUnj.cjs';
+import { g as MatrxDataTableCopyConfig, M as MatrxColumnDef } from '../types-CYkwg9jR.cjs';
 import '../content-transfer.cjs';
 import 'react';
 import '@ai-matrx/kit/content-transfer';

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-D9JBR6ZU.js';
+import { g as MatrxDataTableCopyConfig, M as MatrxColumnDef } from '../types-CFmCZXVn.js';
 import '../content-transfer.js';
 import 'react';
 import '@ai-matrx/kit/content-transfer';

package/dist/data-table/filter-engine.d.cts

@@ -1,4 +1,4 @@
-import { M as MatrxColumnDef, C as ColumnFiltersState, S as SortState, L as LayeredFilterRule, T as TableSearchMatchMode, a as ColumnFilterValue } from '../types-jQddSUnj.cjs';
+import { M as MatrxColumnDef, C as ColumnFiltersState, S as SortState, L as LayeredFilterRule, T as TableSearchMatchMode, a as ColumnFilterValue } from '../types-CYkwg9jR.cjs';
 import '../content-transfer.cjs';
 import 'react';
 import '@ai-matrx/kit/content-transfer';

package/dist/data-table/filter-engine.d.ts

@@ -1,4 +1,4 @@
-import { M as MatrxColumnDef, C as ColumnFiltersState, S as SortState, L as LayeredFilterRule, T as TableSearchMatchMode, a as ColumnFilterValue } from '../types-D9JBR6ZU.js';
+import { M as MatrxColumnDef, C as ColumnFiltersState, S as SortState, L as LayeredFilterRule, T as TableSearchMatchMode, a as ColumnFilterValue } from '../types-CFmCZXVn.js';
 import '../content-transfer.js';
 import 'react';
 import '@ai-matrx/kit/content-transfer';

package/dist/data-table/host.d.cts

@@ -2,7 +2,7 @@ import * as React from 'react';
 import { ComponentType, ReactNode, MouseEventHandler } from 'react';
 import { CopyControlProps } from './copy-types.cjs';
 export { AgentPayloadInput, AiCustomSource, AiVariant, CopyExportConfig } from './copy-types.cjs';
-import { b as TableSavedViewsProps, c as MatrxDataTableDensity, d as MatrxDataTableRecordControls } from '../types-jQddSUnj.cjs';
+import { b as TableSavedViewsProps, c as MatrxDataTableDensity, d as MatrxDataTableRecordControls } from '../types-CYkwg9jR.cjs';
 import { MatrxTableMenuTarget, MatrxTableMenuPayload } from './menu-targets.cjs';
 import '../content-transfer.cjs';
 import '@ai-matrx/kit/content-transfer';

package/dist/data-table/host.d.ts

@@ -2,7 +2,7 @@ import * as React from 'react';
 import { ComponentType, ReactNode, MouseEventHandler } from 'react';
 import { CopyControlProps } from './copy-types.js';
 export { AgentPayloadInput, AiCustomSource, AiVariant, CopyExportConfig } from './copy-types.js';
-import { b as TableSavedViewsProps, c as MatrxDataTableDensity, d as MatrxDataTableRecordControls } from '../types-D9JBR6ZU.js';
+import { b as TableSavedViewsProps, c as MatrxDataTableDensity, d as MatrxDataTableRecordControls } from '../types-CFmCZXVn.js';
 import { MatrxTableMenuTarget, MatrxTableMenuPayload } from './menu-targets.js';
 import '../content-transfer.js';
 import '@ai-matrx/kit/content-transfer';

package/dist/data-table/index.cjs

@@ -8482,7 +8482,7 @@ function useSpreadsheetGrid(options) {
         } catch {
           reason = void 0;
         }
-        if (reason) refusals.push({ columnId: patch.columnId, reason });
+        if (reason) refusals.push({ rowId: patch.rowId, columnId: patch.columnId, reason, value: patch.value });
         else accepted.push(patch);
       }
       return { accepted, refusals };
@@ -8561,6 +8561,7 @@ function useSpreadsheetGrid(options) {
         if (rowId === void 0 || columnId2 === void 0) continue;
         if (!current.isColumnWritable(columnId2)) {
           skipped.push({
+            rowId,
             columnId: columnId2,
             reason: current.columnRefusal?.(columnId2) ?? `${columnId2} cannot be cleared.`
           });
@@ -8724,18 +8725,33 @@ function useSpreadsheetGrid(options) {
       if (startRow === -1 || startCol === -1) return;
       const patches = [];
       const skipped = [];
-      let outside = 0;
+      let pastRightEdge = 0;
+      const overflow = [];
       for (let r = 0; r < block.length; r += 1) {
         const line = block[r] ?? [];
+        const rowId = rowIds[startRow + r];
+        if (rowId === void 0) {
+          const beyond = {};
+          for (let c = 0; c < line.length; c += 1) {
+            const columnId2 = columnIds[startCol + c];
+            if (columnId2 === void 0) {
+              pastRightEdge += 1;
+              continue;
+            }
+            beyond[columnId2] = line[c] ?? "";
+          }
+          overflow.push(beyond);
+          continue;
+        }
         for (let c = 0; c < line.length; c += 1) {
-          const rowId = rowIds[startRow + r];
           const columnId2 = columnIds[startCol + c];
-          if (rowId === void 0 || columnId2 === void 0) {
-            outside += 1;
+          if (columnId2 === void 0) {
+            pastRightEdge += 1;
             continue;
           }
           if (!current.isColumnWritable(columnId2)) {
             skipped.push({
+              rowId,
               columnId: columnId2,
               reason: current.columnRefusal?.(columnId2) ?? `${columnId2} cannot take a pasted value.`
             });
@@ -8745,9 +8761,24 @@ function useSpreadsheetGrid(options) {
         }
       }
       const screened = screenPatches(patches);
+      const refusals = [...skipped, ...screened.refusals];
+      if (current.onPastePlan) {
+        const accepted = screened.accepted;
+        current.onPastePlan({
+          accepted,
+          refusals,
+          overflow,
+          pastRightEdge,
+          apply: async () => {
+            await applyPatches(accepted, "paste", "Pasted");
+          }
+        });
+        return;
+      }
       void applyPatches(screened.accepted, "paste", "Pasted");
+      const outside = pastRightEdge + overflow.reduce((n2, row) => n2 + Object.keys(row).length, 0);
       const tail = outside > 0 ? ` ${outside} landed past the edge of the table and were ignored.` : "";
-      announceSkips([...skipped, ...screened.refusals], `Pasted ${screened.accepted.length} cells.${tail}`);
+      announceSkips(refusals, `Pasted ${screened.accepted.length} cells.${tail}`);
     },
     [range, rowIds, columnIds, applyPatches, announceSkips, screenPatches]
   );
@@ -13172,7 +13203,8 @@ function MatrxDataTableCore({
       ...spreadsheet.paste === void 0 ? {} : { paste: spreadsheet.paste },
       notify: spreadsheet.notify ?? ((message) => toast.success(message)),
       onEditRequest: (address, seed) => requestCellEditRef.current(address, seed),
-      ...spreadsheet.validateCell ? { validateCell: spreadsheet.validateCell } : {}
+      ...spreadsheet.validateCell ? { validateCell: spreadsheet.validateCell } : {},
+      ...spreadsheet.onPastePlan ? { onPastePlan: spreadsheet.onPastePlan } : {}
     } : null
   );
   const sheetRef = (0, import_react21.useRef)(sheet);