@ai-matrx/design-system 0.28.0 → 0.30.0

package/dist/{types-D9JBR6ZU.d.ts → types-CFmCZXVn.d.ts}

@@ -5,7 +5,7 @@ import { F as FieldFormatConfig } from './types-CJWU1Gae.js';
 import { GroupAggregateSpec, GroupOrder } from './data-table/grouping.js';
 import { CellPatch } from './data-table/fill.js';
 import { ColumnFacets } from './data-table/facets.js';
-import { SpreadsheetIntent } from './data-table/spreadsheet.js';
+import { SpreadsheetIntent, SpreadsheetPastePlan } from './data-table/spreadsheet.js';
 import { DateColumnFilterValue } from './data-table/date-filter.js';
 
 type TableSearchRole = "id" | "name" | "description" | "other";
@@ -1269,6 +1269,29 @@ interface MatrxDataTableSpreadsheetConfig<T> {
         columnId: string;
         value: unknown;
     }) => string | undefined) | undefined;
+    /**
+     * ASK BEFORE A PASTE IS WRITTEN, AND HAND OVER THE ROWS THAT DID NOT FIT.
+     *
+     * Absent (the default, and byte-for-byte what a paste did before): the table
+     * screens the block and applies it straight away, which is right for a paste
+     * of a handful of cells into rows that already exist.
+     *
+     * Present: the table computes the whole plan and applies NOTHING. The
+     * consumer is handed what would be written, what was refused and why, and the
+     * rows that landed past the last row — and calls `apply()` itself if the
+     * person says yes.
+     *
+     * WHY THE OVERFLOW IS HANDED OVER AT ALL. A paste of fifty spreadsheet rows
+     * into a table that holds three is the ordinary way a person fills a new
+     * table, and until 2026-09-21 forty-seven of those rows were counted and
+     * dropped ("landed past the edge of the table and were ignored"). The table
+     * cannot create rows — it does not own the writes — but it must not be the
+     * reason nobody can. So it says exactly which rows they were, in the grid's
+     * own column order, and a consumer that knows how to make a row makes them.
+     * A consumer that does not simply leaves `overflow` alone and the sentence is
+     * the same as before.
+     */
+    onPastePlan?: ((plan: SpreadsheetPastePlan) => void) | undefined;
 }
 /**
  * THE VALUES A COLUMN HOLDS, with a count beside each one.

package/dist/{types-jQddSUnj.d.cts → types-CYkwg9jR.d.cts}

@@ -5,7 +5,7 @@ import { F as FieldFormatConfig } from './types-CJWU1Gae.cjs';
 import { GroupAggregateSpec, GroupOrder } from './data-table/grouping.cjs';
 import { CellPatch } from './data-table/fill.cjs';
 import { ColumnFacets } from './data-table/facets.cjs';
-import { SpreadsheetIntent } from './data-table/spreadsheet.cjs';
+import { SpreadsheetIntent, SpreadsheetPastePlan } from './data-table/spreadsheet.cjs';
 import { DateColumnFilterValue } from './data-table/date-filter.cjs';
 
 type TableSearchRole = "id" | "name" | "description" | "other";
@@ -1269,6 +1269,29 @@ interface MatrxDataTableSpreadsheetConfig<T> {
         columnId: string;
         value: unknown;
     }) => string | undefined) | undefined;
+    /**
+     * ASK BEFORE A PASTE IS WRITTEN, AND HAND OVER THE ROWS THAT DID NOT FIT.
+     *
+     * Absent (the default, and byte-for-byte what a paste did before): the table
+     * screens the block and applies it straight away, which is right for a paste
+     * of a handful of cells into rows that already exist.
+     *
+     * Present: the table computes the whole plan and applies NOTHING. The
+     * consumer is handed what would be written, what was refused and why, and the
+     * rows that landed past the last row — and calls `apply()` itself if the
+     * person says yes.
+     *
+     * WHY THE OVERFLOW IS HANDED OVER AT ALL. A paste of fifty spreadsheet rows
+     * into a table that holds three is the ordinary way a person fills a new
+     * table, and until 2026-09-21 forty-seven of those rows were counted and
+     * dropped ("landed past the edge of the table and were ignored"). The table
+     * cannot create rows — it does not own the writes — but it must not be the
+     * reason nobody can. So it says exactly which rows they were, in the grid's
+     * own column order, and a consumer that knows how to make a row makes them.
+     * A consumer that does not simply leaves `overflow` alone and the sentence is
+     * the same as before.
+     */
+    onPastePlan?: ((plan: SpreadsheetPastePlan) => void) | undefined;
 }
 /**
  * THE VALUES A COLUMN HOLDS, with a count beside each one.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ai-matrx/design-system",
-  "version": "0.28.0",
+  "version": "0.30.0",
   "description": "AI Matrx semantic React primitives shared across Vite, Next.js, desktop, and customer-built applications.",
   "type": "module",
   "license": "MIT",