@rowsncolumns/spreadsheet-state 28.0.74 → 28.0.76

package/dist/esm/hooks/use-on-delete-cells-shift-left.d.ts

@@ -1,10 +1,12 @@
+import type { GridRange } from "@rowsncolumns/common-types";
 import { type CellInterface, type SelectionArea } from "@rowsncolumns/grid";
 import type { CellData, SelectionAttributes, Sheet } from "@rowsncolumns/spreadsheet";
+import type { TableView } from "@rowsncolumns/spreadsheet";
 import type { OnCommand } from "../commands";
+import type { useCalculation } from "./use-calculation";
 import type { CellXfsRegistry } from "./use-cellxfs-registry";
+import type { SheetData, UseSpreadsheetProps } from "./use-spreadsheet-state";
 import type { SharedStringRegistry } from "./use-ss-registry";
-import type { useCalculation } from "./use-calculation";
-import type { UseSpreadsheetProps } from "./use-spreadsheet-state";
 import type { SpreadsheetPatch } from "./use-undo-redo";
 export type UseOnDeleteCellsShiftLeftProps<T extends CellData, S extends Sheet> = {
     columnCount: number;
@@ -22,7 +24,15 @@ export type UseOnDeleteCellsShiftLeftProps<T extends CellData, S extends Sheet>
     onChangeSheetData: UseSpreadsheetProps<T, S>["onChangeSheetData"];
     onChangeSheets: UseSpreadsheetProps<T, S>["onChangeSheets"];
     onChangeCitations?: UseSpreadsheetProps<T, S>["onChangeCitations"];
+    onChangeTables?: UseSpreadsheetProps<T, S>["onChangeTables"];
     onCommand?: OnCommand;
+    /** Current document facets, read by the Excel refusal guards (`getShiftCellsRefusal`). */
+    sheetData?: SheetData<T>;
+    sheets?: S[];
+    tables?: TableView[];
+    /** CSE / dynamic-array ranges on a sheet — a partially covered one refuses the shift. */
+    getArrayRanges?: (sheetId: number) => GridRange[] | undefined;
+    getSheetName?: (sheetId: number) => string;
 };
-export declare const useOnDeleteCellsShiftLeft: <T extends CellData, S extends Sheet>({ rowCount, columnCount, locale, cellXfsRegistry, sharedStringRegistry, getActiveCell, getSelections, getDependents, createHistory, enqueueGraphOperation, enqueueCalculation, enqueueStructureChange, onChangeSheetData, onChangeSheets, onChangeCitations, onCommand, }: UseOnDeleteCellsShiftLeftProps<T, S>) => (sheetId: number, activeCell: CellInterface, selections: SelectionArea<SelectionAttributes>[]) => void;
+export declare const useOnDeleteCellsShiftLeft: <T extends CellData, S extends Sheet>({ rowCount, columnCount, locale, cellXfsRegistry, sharedStringRegistry, getActiveCell, getSelections, getDependents, createHistory, enqueueGraphOperation, enqueueCalculation, enqueueStructureChange, onChangeSheetData, onChangeSheets, onChangeCitations, onChangeTables, onCommand, sheetData, sheets, tables, getArrayRanges, getSheetName, }: UseOnDeleteCellsShiftLeftProps<T, S>) => (sheetId: number, activeCell: CellInterface, selections: SelectionArea<SelectionAttributes>[]) => void;
 //# sourceMappingURL=use-on-delete-cells-shift-left.d.ts.map

package/dist/esm/hooks/use-on-delete-cells-shift-left.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-on-delete-cells-shift-left.d.ts","sourceRoot":"","sources":["../../../hooks/use-on-delete-cells-shift-left.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,aAAa,EAAE,KAAK,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAC5E,OAAO,KAAK,EACV,QAAQ,EACR,mBAAmB,EACnB,KAAK,EACN,MAAM,2BAA2B,CAAC;AAGnC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE7C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAC9D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAOxD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AACnE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAExD,MAAM,MAAM,8BAA8B,CACxC,CAAC,SAAS,QAAQ,EAClB,CAAC,SAAS,KAAK,IACb;IACF,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,eAAe,CAAC,EAAE,eAAe,CAAC;IAClC,oBAAoB,CAAC,EAAE,oBAAoB,CAAC;IAC5C,aAAa,EAAE,MAAM,aAAa,CAAC;IACnC,aAAa,IAAI,aAAa,CAAC,mBAAmB,CAAC,EAAE,CAAC;IACtD,aAAa,EAAE,MAAM,CAAC,OAAO,EAAE,gBAAgB,KAAK,IAAI,CAAC;IACzD,aAAa,EAAE,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC,eAAe,CAAC,CAAC;IAClE,kBAAkB,EAAE,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC,oBAAoB,CAAC,CAAC;IAC5E,sBAAsB,CAAC,EAAE,UAAU,CACjC,OAAO,cAAc,CACtB,CAAC,wBAAwB,CAAC,CAAC;IAC5B,qBAAqB,EAAE,UAAU,CAC/B,OAAO,cAAc,CACtB,CAAC,uBAAuB,CAAC,CAAC;IAC3B,iBAAiB,EAAE,mBAAmB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC;IAClE,cAAc,EAAE,mBAAmB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC;IAC5D,iBAAiB,CAAC,EAAE,mBAAmB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC;IACnE,SAAS,CAAC,EAAE,SAAS,CAAC;CACvB,CAAC;AAEF,eAAO,MAAM,yBAAyB,GAAI,CAAC,SAAS,QAAQ,EAAE,CAAC,SAAS,KAAK,EAAE,2QAiB5E,8BAA8B,CAAC,CAAC,EAAE,CAAC,CAAC,eAMxB,MAAM,cACH,aAAa,cACb,aAAa,CAAC,mBAAmB,CAAC,EAAE,SA8DrD,CAAC"}
+{"version":3,"file":"use-on-delete-cells-shift-left.d.ts","sourceRoot":"","sources":["../../../hooks/use-on-delete-cells-shift-left.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AAC5D,OAAO,EAAE,KAAK,aAAa,EAAE,KAAK,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAC5E,OAAO,KAAK,EACV,QAAQ,EACR,mBAAmB,EACnB,KAAK,EACN,MAAM,2BAA2B,CAAC;AACnC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AAK3D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE7C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAMxD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,KAAK,EAAE,SAAS,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAC9E,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAC9D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAExD,MAAM,MAAM,8BAA8B,CACxC,CAAC,SAAS,QAAQ,EAClB,CAAC,SAAS,KAAK,IACb;IACF,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,eAAe,CAAC,EAAE,eAAe,CAAC;IAClC,oBAAoB,CAAC,EAAE,oBAAoB,CAAC;IAC5C,aAAa,EAAE,MAAM,aAAa,CAAC;IACnC,aAAa,IAAI,aAAa,CAAC,mBAAmB,CAAC,EAAE,CAAC;IACtD,aAAa,EAAE,MAAM,CAAC,OAAO,EAAE,gBAAgB,KAAK,IAAI,CAAC;IACzD,aAAa,EAAE,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC,eAAe,CAAC,CAAC;IAClE,kBAAkB,EAAE,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC,oBAAoB,CAAC,CAAC;IAC5E,sBAAsB,CAAC,EAAE,UAAU,CACjC,OAAO,cAAc,CACtB,CAAC,wBAAwB,CAAC,CAAC;IAC5B,qBAAqB,EAAE,UAAU,CAC/B,OAAO,cAAc,CACtB,CAAC,uBAAuB,CAAC,CAAC;IAC3B,iBAAiB,EAAE,mBAAmB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC;IAClE,cAAc,EAAE,mBAAmB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC;IAC5D,iBAAiB,CAAC,EAAE,mBAAmB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC;IACnE,cAAc,CAAC,EAAE,mBAAmB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC;IAC7D,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,0FAA0F;IAC1F,SAAS,CAAC,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC;IACzB,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC;IACb,MAAM,CAAC,EAAE,SAAS,EAAE,CAAC;IACrB,yFAAyF;IACzF,cAAc,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,SAAS,EAAE,GAAG,SAAS,CAAC;IAC9D,YAAY,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,MAAM,CAAC;CAC5C,CAAC;AAEF,eAAO,MAAM,yBAAyB,GAAI,CAAC,SAAS,QAAQ,EAAE,CAAC,SAAS,KAAK,EAAE,oVAuB5E,8BAA8B,CAAC,CAAC,EAAE,CAAC,CAAC,eAMxB,MAAM,cACH,aAAa,cACb,aAAa,CAAC,mBAAmB,CAAC,EAAE,SAsFrD,CAAC"}

package/dist/esm/hooks/use-on-delete-cells-shift-left.js

@@ -1,8 +1,9 @@
 import { useCallback } from "react";
-import { deleteCellsShiftLeft } from "../interface/delete-cells-shift-left";
+import { getShiftCellsRefusal, resolveShiftSelection } from "../api/structural-guards";
 import { useShowError } from "../atoms/error-state.atom";
+import { deleteCellsShiftLeft } from "../interface/delete-cells-shift-left";
 import { SHEET_PROTECTION_ERROR_TITLE, useCanEditCellRange, useCanPerformSheetAction, } from "./use-can-edit-cellrange";
-export const useOnDeleteCellsShiftLeft = ({ rowCount, columnCount, locale, cellXfsRegistry, sharedStringRegistry, getActiveCell, getSelections, getDependents, createHistory, enqueueGraphOperation, enqueueCalculation, enqueueStructureChange, onChangeSheetData, onChangeSheets, onChangeCitations, onCommand, }) => {
+export const useOnDeleteCellsShiftLeft = ({ rowCount, columnCount, locale, cellXfsRegistry, sharedStringRegistry, getActiveCell, getSelections, getDependents, createHistory, enqueueGraphOperation, enqueueCalculation, enqueueStructureChange, onChangeSheetData, onChangeSheets, onChangeCitations, onChangeTables, onCommand, sheetData, sheets, tables, getArrayRanges, getSheetName, }) => {
     const canEditCellRange = useCanEditCellRange();
     const canPerformSheetAction = useCanPerformSheetAction();
     const showError = useShowError();
@@ -18,6 +19,21 @@ export const useOnDeleteCellsShiftLeft = ({ rowCount, columnCount, locale, cellX
             console.debug("This range is protected, users cannot edit this cell range.");
             return;
         }
+        const selection = resolveShiftSelection(activeCell, selections);
+        const refusal = getShiftCellsRefusal({
+            direction: "left",
+            range: selection.range,
+            sheetId,
+            rows: sheetData?.[sheetId],
+            columnCount,
+            merges: sheets?.find((sheet) => sheet.sheetId === sheetId)?.merges,
+            tables,
+            arrayRanges: getArrayRanges?.(sheetId),
+        });
+        if (refusal) {
+            showError({ title: refusal.title, message: refusal.message });
+            return;
+        }
         deleteCellsShiftLeft({
             rowCount,
             columnCount,
@@ -34,6 +50,8 @@ export const useOnDeleteCellsShiftLeft = ({ rowCount, columnCount, locale, cellX
             onChangeSheetData,
             onChangeSheets,
             onChangeCitations,
+            onChangeTables,
+            getSheetName,
         })(sheetId, activeCell, selections);
         onCommand?.({
             command: "delete-cells-shift-left",
@@ -61,5 +79,11 @@ export const useOnDeleteCellsShiftLeft = ({ rowCount, columnCount, locale, cellX
         canPerformSheetAction,
         showError,
         onCommand,
+        onChangeTables,
+        sheetData,
+        sheets,
+        tables,
+        getArrayRanges,
+        getSheetName,
     ]);
 };

package/dist/esm/hooks/use-on-delete-cells-shift-up.d.ts

@@ -1,10 +1,12 @@
+import type { GridRange } from "@rowsncolumns/common-types";
 import { type CellInterface, type SelectionArea } from "@rowsncolumns/grid";
 import type { CellData, SelectionAttributes, Sheet } from "@rowsncolumns/spreadsheet";
+import type { TableView } from "@rowsncolumns/spreadsheet";
 import type { OnCommand } from "../commands";
+import type { useCalculation } from "./use-calculation";
 import type { CellXfsRegistry } from "./use-cellxfs-registry";
+import type { SheetData, UseSpreadsheetProps } from "./use-spreadsheet-state";
 import type { SharedStringRegistry } from "./use-ss-registry";
-import type { useCalculation } from "./use-calculation";
-import type { UseSpreadsheetProps } from "./use-spreadsheet-state";
 import type { SpreadsheetPatch } from "./use-undo-redo";
 export type UseOnDeleteCellsShiftUpProps<T extends CellData, S extends Sheet> = {
     rowCount: number;
@@ -22,7 +24,15 @@ export type UseOnDeleteCellsShiftUpProps<T extends CellData, S extends Sheet> =
     onChangeSheetData: UseSpreadsheetProps<T, S>["onChangeSheetData"];
     onChangeSheets: UseSpreadsheetProps<T, S>["onChangeSheets"];
     onChangeCitations?: UseSpreadsheetProps<T, S>["onChangeCitations"];
+    onChangeTables?: UseSpreadsheetProps<T, S>["onChangeTables"];
     onCommand?: OnCommand;
+    /** Current document facets, read by the Excel refusal guards (`getShiftCellsRefusal`). */
+    sheetData?: SheetData<T>;
+    sheets?: S[];
+    tables?: TableView[];
+    /** CSE / dynamic-array ranges on a sheet — a partially covered one refuses the shift. */
+    getArrayRanges?: (sheetId: number) => GridRange[] | undefined;
+    getSheetName?: (sheetId: number) => string;
 };
-export declare const useOnDeleteCellsShiftUp: <T extends CellData, S extends Sheet>({ rowCount, columnCount, locale, cellXfsRegistry, sharedStringRegistry, getActiveCell, getSelections, getDependents, createHistory, enqueueGraphOperation, enqueueCalculation, enqueueStructureChange, onChangeSheetData, onChangeSheets, onChangeCitations, onCommand, }: UseOnDeleteCellsShiftUpProps<T, S>) => (sheetId: number, activeCell: CellInterface, selections: SelectionArea<SelectionAttributes>[]) => void;
+export declare const useOnDeleteCellsShiftUp: <T extends CellData, S extends Sheet>({ rowCount, columnCount, locale, cellXfsRegistry, sharedStringRegistry, getActiveCell, getSelections, getDependents, createHistory, enqueueGraphOperation, enqueueCalculation, enqueueStructureChange, onChangeSheetData, onChangeSheets, onChangeCitations, onChangeTables, onCommand, sheetData, sheets, tables, getArrayRanges, getSheetName, }: UseOnDeleteCellsShiftUpProps<T, S>) => (sheetId: number, activeCell: CellInterface, selections: SelectionArea<SelectionAttributes>[]) => void;
 //# sourceMappingURL=use-on-delete-cells-shift-up.d.ts.map

package/dist/esm/hooks/use-on-delete-cells-shift-up.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-on-delete-cells-shift-up.d.ts","sourceRoot":"","sources":["../../../hooks/use-on-delete-cells-shift-up.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,aAAa,EAAE,KAAK,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAC5E,OAAO,KAAK,EACV,QAAQ,EACR,mBAAmB,EACnB,KAAK,EACN,MAAM,2BAA2B,CAAC;AAGnC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE7C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAC9D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAOxD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AACnE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAExD,MAAM,MAAM,4BAA4B,CACtC,CAAC,SAAS,QAAQ,EAClB,CAAC,SAAS,KAAK,IACb;IACF,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,eAAe,CAAC,EAAE,eAAe,CAAC;IAClC,oBAAoB,CAAC,EAAE,oBAAoB,CAAC;IAC5C,aAAa,EAAE,MAAM,aAAa,CAAC;IACnC,aAAa,IAAI,aAAa,CAAC,mBAAmB,CAAC,EAAE,CAAC;IACtD,aAAa,EAAE,MAAM,CAAC,OAAO,EAAE,gBAAgB,KAAK,IAAI,CAAC;IACzD,aAAa,EAAE,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC,eAAe,CAAC,CAAC;IAClE,kBAAkB,EAAE,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC,oBAAoB,CAAC,CAAC;IAC5E,sBAAsB,CAAC,EAAE,UAAU,CACjC,OAAO,cAAc,CACtB,CAAC,wBAAwB,CAAC,CAAC;IAC5B,qBAAqB,EAAE,UAAU,CAC/B,OAAO,cAAc,CACtB,CAAC,uBAAuB,CAAC,CAAC;IAC3B,iBAAiB,EAAE,mBAAmB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC;IAClE,cAAc,EAAE,mBAAmB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC;IAC5D,iBAAiB,CAAC,EAAE,mBAAmB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC;IACnE,SAAS,CAAC,EAAE,SAAS,CAAC;CACvB,CAAC;AAEF,eAAO,MAAM,uBAAuB,GAAI,CAAC,SAAS,QAAQ,EAAE,CAAC,SAAS,KAAK,EAAE,2QAiB1E,4BAA4B,CAAC,CAAC,EAAE,CAAC,CAAC,eAMtB,MAAM,cACH,aAAa,cACb,aAAa,CAAC,mBAAmB,CAAC,EAAE,SA8DrD,CAAC"}
+{"version":3,"file":"use-on-delete-cells-shift-up.d.ts","sourceRoot":"","sources":["../../../hooks/use-on-delete-cells-shift-up.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AAC5D,OAAO,EAAE,KAAK,aAAa,EAAE,KAAK,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAC5E,OAAO,KAAK,EACV,QAAQ,EACR,mBAAmB,EACnB,KAAK,EACN,MAAM,2BAA2B,CAAC;AACnC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AAK3D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE7C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAMxD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,KAAK,EAAE,SAAS,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAC9E,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAC9D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAExD,MAAM,MAAM,4BAA4B,CACtC,CAAC,SAAS,QAAQ,EAClB,CAAC,SAAS,KAAK,IACb;IACF,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,eAAe,CAAC,EAAE,eAAe,CAAC;IAClC,oBAAoB,CAAC,EAAE,oBAAoB,CAAC;IAC5C,aAAa,EAAE,MAAM,aAAa,CAAC;IACnC,aAAa,IAAI,aAAa,CAAC,mBAAmB,CAAC,EAAE,CAAC;IACtD,aAAa,EAAE,MAAM,CAAC,OAAO,EAAE,gBAAgB,KAAK,IAAI,CAAC;IACzD,aAAa,EAAE,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC,eAAe,CAAC,CAAC;IAClE,kBAAkB,EAAE,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC,oBAAoB,CAAC,CAAC;IAC5E,sBAAsB,CAAC,EAAE,UAAU,CACjC,OAAO,cAAc,CACtB,CAAC,wBAAwB,CAAC,CAAC;IAC5B,qBAAqB,EAAE,UAAU,CAC/B,OAAO,cAAc,CACtB,CAAC,uBAAuB,CAAC,CAAC;IAC3B,iBAAiB,EAAE,mBAAmB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC;IAClE,cAAc,EAAE,mBAAmB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC;IAC5D,iBAAiB,CAAC,EAAE,mBAAmB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC;IACnE,cAAc,CAAC,EAAE,mBAAmB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC;IAC7D,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,0FAA0F;IAC1F,SAAS,CAAC,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC;IACzB,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC;IACb,MAAM,CAAC,EAAE,SAAS,EAAE,CAAC;IACrB,yFAAyF;IACzF,cAAc,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,SAAS,EAAE,GAAG,SAAS,CAAC;IAC9D,YAAY,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,MAAM,CAAC;CAC5C,CAAC;AAEF,eAAO,MAAM,uBAAuB,GAAI,CAAC,SAAS,QAAQ,EAAE,CAAC,SAAS,KAAK,EAAE,oVAuB1E,4BAA4B,CAAC,CAAC,EAAE,CAAC,CAAC,eAMtB,MAAM,cACH,aAAa,cACb,aAAa,CAAC,mBAAmB,CAAC,EAAE,SAsFrD,CAAC"}

package/dist/esm/hooks/use-on-delete-cells-shift-up.js

@@ -1,8 +1,9 @@
 import { useCallback } from "react";
-import { deleteCellsShiftUp } from "../interface/delete-cells-shift-up";
+import { getShiftCellsRefusal, resolveShiftSelection } from "../api/structural-guards";
 import { useShowError } from "../atoms/error-state.atom";
+import { deleteCellsShiftUp } from "../interface/delete-cells-shift-up";
 import { SHEET_PROTECTION_ERROR_TITLE, useCanEditCellRange, useCanPerformSheetAction, } from "./use-can-edit-cellrange";
-export const useOnDeleteCellsShiftUp = ({ rowCount, columnCount, locale, cellXfsRegistry, sharedStringRegistry, getActiveCell, getSelections, getDependents, createHistory, enqueueGraphOperation, enqueueCalculation, enqueueStructureChange, onChangeSheetData, onChangeSheets, onChangeCitations, onCommand, }) => {
+export const useOnDeleteCellsShiftUp = ({ rowCount, columnCount, locale, cellXfsRegistry, sharedStringRegistry, getActiveCell, getSelections, getDependents, createHistory, enqueueGraphOperation, enqueueCalculation, enqueueStructureChange, onChangeSheetData, onChangeSheets, onChangeCitations, onChangeTables, onCommand, sheetData, sheets, tables, getArrayRanges, getSheetName, }) => {
     const canEditCellRange = useCanEditCellRange();
     const canPerformSheetAction = useCanPerformSheetAction();
     const showError = useShowError();
@@ -18,6 +19,21 @@ export const useOnDeleteCellsShiftUp = ({ rowCount, columnCount, locale, cellXfs
             console.debug("This range is protected, users cannot edit this cell range.");
             return;
         }
+        const selection = resolveShiftSelection(activeCell, selections);
+        const refusal = getShiftCellsRefusal({
+            direction: "up",
+            range: selection.range,
+            sheetId,
+            rows: sheetData?.[sheetId],
+            rowCount,
+            merges: sheets?.find((sheet) => sheet.sheetId === sheetId)?.merges,
+            tables,
+            arrayRanges: getArrayRanges?.(sheetId),
+        });
+        if (refusal) {
+            showError({ title: refusal.title, message: refusal.message });
+            return;
+        }
         deleteCellsShiftUp({
             rowCount,
             columnCount,
@@ -34,6 +50,8 @@ export const useOnDeleteCellsShiftUp = ({ rowCount, columnCount, locale, cellXfs
             onChangeSheetData,
             onChangeSheets,
             onChangeCitations,
+            onChangeTables,
+            getSheetName,
         })(sheetId, activeCell, selections);
         onCommand?.({
             command: "delete-cells-shift-up",
@@ -61,5 +79,11 @@ export const useOnDeleteCellsShiftUp = ({ rowCount, columnCount, locale, cellXfs
         canPerformSheetAction,
         showError,
         onCommand,
+        onChangeTables,
+        sheetData,
+        sheets,
+        tables,
+        getArrayRanges,
+        getSheetName,
     ]);
 };

package/dist/esm/hooks/use-on-delete-column.d.ts

@@ -1,11 +1,12 @@
 import type { CellInterface, SelectionArea } from "@rowsncolumns/grid";
 import type { CanvasGridProps } from "@rowsncolumns/spreadsheet";
-import { type CellData, type SelectionAttributes, type Sheet } from "@rowsncolumns/spreadsheet";
+import { type CellData, type SelectionAttributes, type Sheet, type TableView } from "@rowsncolumns/spreadsheet";
+import type { GetArrayRange } from "../api/structural-table-refs";
 import type { OnCommand } from "../commands";
-import type { CellXfsRegistry } from "./use-cellxfs-registry";
-import type { SharedStringRegistry } from "./use-ss-registry";
 import type { useCalculation } from "./use-calculation";
+import type { CellXfsRegistry } from "./use-cellxfs-registry";
 import type { UseSpreadsheetProps } from "./use-spreadsheet-state";
+import type { SharedStringRegistry } from "./use-ss-registry";
 import type { SpreadsheetPatch } from "./use-undo-redo";
 export type UseOnDeleteColumnProps<T extends CellData, S extends Sheet> = {
     rowCount: number;
@@ -31,8 +32,16 @@ export type UseOnDeleteColumnProps<T extends CellData, S extends Sheet> = {
     onChangeConditionalFormats?: UseSpreadsheetProps<T, S>["onChangeConditionalFormats"];
     onChangeCitations?: UseSpreadsheetProps<T, S>["onChangeCitations"];
     onChangePivotTables?: UseSpreadsheetProps<T, S>["onChangePivotTables"];
+    onChangeNamedRanges?: UseSpreadsheetProps<T, S>["onChangeNamedRanges"];
+    onChangeEmbeds?: UseSpreadsheetProps<T, S>["onChangeEmbeds"];
+    onChangeCharts?: UseSpreadsheetProps<T, S>["onChangeCharts"];
+    onChangeProtectedRanges?: UseSpreadsheetProps<T, S>["onChangeProtectedRanges"];
     getSheetName(sheetId: number): string;
     onCommand?: OnCommand;
+    /** Pre-edit table definitions: structured refs into deleted tables/columns break to `#REF!`. */
+    tables?: TableView[];
+    /** Live spill rectangle of a dynamic-array anchor: a deleted anchor takes its spill with it. */
+    getArrayRange?: GetArrayRange;
 };
-export declare const useOnDeleteColumn: <T extends CellData, S extends Sheet>({ rowCount, columnCount, locale, cellXfsRegistry, sharedStringRegistry, getActiveCell, getSelections, getDependents, getGraphNodes, getGraphNodesInSheet, createHistory, enqueueGraphOperation, enqueueCalculation, enqueueStructureChange, onChangeSheetData, onChangeSheets, onChangeTables, onChangeActiveCell, onChangeSelections, onChangeConditionalFormats, onChangeDataValidations, onChangeCitations, onChangePivotTables, getSheetName, onCommand, }: UseOnDeleteColumnProps<T, S>) => (sheetId: number, columnIndexes: number[]) => void;
+export declare const useOnDeleteColumn: <T extends CellData, S extends Sheet>({ rowCount, columnCount, locale, cellXfsRegistry, sharedStringRegistry, getActiveCell, getSelections, getDependents, getGraphNodes, getGraphNodesInSheet, createHistory, enqueueGraphOperation, enqueueCalculation, enqueueStructureChange, onChangeSheetData, onChangeSheets, onChangeTables, onChangeActiveCell, onChangeSelections, onChangeConditionalFormats, onChangeDataValidations, onChangeCitations, onChangePivotTables, onChangeNamedRanges, onChangeEmbeds, onChangeCharts, onChangeProtectedRanges, getSheetName, onCommand, tables, getArrayRange, }: UseOnDeleteColumnProps<T, S>) => (sheetId: number, columnIndexes: number[]) => void;
 //# sourceMappingURL=use-on-delete-column.d.ts.map

package/dist/esm/hooks/use-on-delete-column.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-on-delete-column.d.ts","sourceRoot":"","sources":["../../../hooks/use-on-delete-column.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"use-on-delete-column.d.ts","sourceRoot":"","sources":["../../../hooks/use-on-delete-column.ts"],"names":[],"mappings":"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"}

package/dist/esm/hooks/use-on-delete-column.js

@@ -1,8 +1,8 @@
 import { useCallback } from "react";
-import { deleteColumn } from "../interface/delete-column";
 import { useShowError } from "../atoms/error-state.atom";
+import { deleteColumn } from "../interface/delete-column";
 import { SHEET_PROTECTION_ERROR_TITLE, useCanEditSheet, useCanPerformSheetAction, } from "./use-can-edit-cellrange";
-export const useOnDeleteColumn = ({ rowCount, columnCount, locale, cellXfsRegistry, sharedStringRegistry, getActiveCell, getSelections, getDependents, getGraphNodes, getGraphNodesInSheet, createHistory, enqueueGraphOperation, enqueueCalculation, enqueueStructureChange, onChangeSheetData, onChangeSheets, onChangeTables, onChangeActiveCell, onChangeSelections, onChangeConditionalFormats, onChangeDataValidations, onChangeCitations, onChangePivotTables, getSheetName, onCommand, }) => {
+export const useOnDeleteColumn = ({ rowCount, columnCount, locale, cellXfsRegistry, sharedStringRegistry, getActiveCell, getSelections, getDependents, getGraphNodes, getGraphNodesInSheet, createHistory, enqueueGraphOperation, enqueueCalculation, enqueueStructureChange, onChangeSheetData, onChangeSheets, onChangeTables, onChangeActiveCell, onChangeSelections, onChangeConditionalFormats, onChangeDataValidations, onChangeCitations, onChangePivotTables, onChangeNamedRanges, onChangeEmbeds, onChangeCharts, onChangeProtectedRanges, getSheetName, onCommand, tables, getArrayRange, }) => {
     const canEditSheet = useCanEditSheet();
     const canPerformSheetAction = useCanPerformSheetAction();
     const showError = useShowError();
@@ -46,7 +46,13 @@ export const useOnDeleteColumn = ({ rowCount, columnCount, locale, cellXfsRegist
             onChangeDataValidations,
             onChangeCitations,
             onChangePivotTables,
+            onChangeNamedRanges,
+            onChangeEmbeds,
+            onChangeCharts,
+            onChangeProtectedRanges,
             getSheetName,
+            tables,
+            getArrayRange,
         })(sheetId, columnIndexes);
         onCommand?.({
             command: "delete-column",
@@ -77,10 +83,16 @@ export const useOnDeleteColumn = ({ rowCount, columnCount, locale, cellXfsRegist
         onChangeDataValidations,
         onChangeCitations,
         onChangePivotTables,
+        onChangeNamedRanges,
+        onChangeEmbeds,
+        onChangeCharts,
+        onChangeProtectedRanges,
         canEditSheet,
         canPerformSheetAction,
         showError,
         getSheetName,
         onCommand,
+        tables,
+        getArrayRange,
     ]);
 };

package/dist/esm/hooks/use-on-delete-row.d.ts

@@ -1,11 +1,12 @@
 import type { CellInterface, SelectionArea } from "@rowsncolumns/common-types";
 import type { CanvasGridProps } from "@rowsncolumns/spreadsheet";
-import { type CellData, type SelectionAttributes, type Sheet } from "@rowsncolumns/spreadsheet";
+import { type CellData, type SelectionAttributes, type Sheet, type TableView } from "@rowsncolumns/spreadsheet";
+import type { GetArrayRange } from "../api/structural-table-refs";
 import type { OnCommand } from "../commands";
-import type { CellXfsRegistry } from "./use-cellxfs-registry";
-import type { SharedStringRegistry } from "./use-ss-registry";
 import type { useCalculation } from "./use-calculation";
+import type { CellXfsRegistry } from "./use-cellxfs-registry";
 import type { UseSpreadsheetProps } from "./use-spreadsheet-state";
+import type { SharedStringRegistry } from "./use-ss-registry";
 import type { SpreadsheetPatch } from "./use-undo-redo";
 export type UseOnDeleteRowProps<T extends CellData, S extends Sheet> = {
     rowCount: number;
@@ -31,8 +32,16 @@ export type UseOnDeleteRowProps<T extends CellData, S extends Sheet> = {
     onChangeConditionalFormats?: UseSpreadsheetProps<T, S>["onChangeConditionalFormats"];
     onChangeCitations?: UseSpreadsheetProps<T, S>["onChangeCitations"];
     onChangePivotTables?: UseSpreadsheetProps<T, S>["onChangePivotTables"];
+    onChangeNamedRanges?: UseSpreadsheetProps<T, S>["onChangeNamedRanges"];
+    onChangeEmbeds?: UseSpreadsheetProps<T, S>["onChangeEmbeds"];
+    onChangeCharts?: UseSpreadsheetProps<T, S>["onChangeCharts"];
+    onChangeProtectedRanges?: UseSpreadsheetProps<T, S>["onChangeProtectedRanges"];
     getSheetName(sheetId: number): string;
     onCommand?: OnCommand;
+    /** Pre-edit table definitions: structured refs into deleted tables/columns break to `#REF!`. */
+    tables?: TableView[];
+    /** Live spill rectangle of a dynamic-array anchor: a deleted anchor takes its spill with it. */
+    getArrayRange?: GetArrayRange;
 };
-export declare const useOnDeleteRow: <T extends CellData, S extends Sheet>({ rowCount, columnCount, locale, cellXfsRegistry, sharedStringRegistry, getActiveCell, getSelections, getDependents, getGraphNodes, getGraphNodesInSheet, createHistory, enqueueGraphOperation, enqueueCalculation, enqueueStructureChange, onChangeSheetData, onChangeSheets, onChangeTables, onChangeActiveCell, onChangeSelections, onChangeConditionalFormats, onChangeDataValidations, onChangeCitations, onChangePivotTables, getSheetName, onCommand, }: UseOnDeleteRowProps<T, S>) => (sheetId: number, rowIndexes: number[]) => void;
+export declare const useOnDeleteRow: <T extends CellData, S extends Sheet>({ rowCount, columnCount, locale, cellXfsRegistry, sharedStringRegistry, getActiveCell, getSelections, getDependents, getGraphNodes, getGraphNodesInSheet, createHistory, enqueueGraphOperation, enqueueCalculation, enqueueStructureChange, onChangeSheetData, onChangeSheets, onChangeTables, onChangeActiveCell, onChangeSelections, onChangeConditionalFormats, onChangeDataValidations, onChangeCitations, onChangePivotTables, onChangeNamedRanges, onChangeEmbeds, onChangeCharts, onChangeProtectedRanges, getSheetName, onCommand, tables, getArrayRange, }: UseOnDeleteRowProps<T, S>) => (sheetId: number, rowIndexes: number[]) => void;
 //# sourceMappingURL=use-on-delete-row.d.ts.map

package/dist/esm/hooks/use-on-delete-row.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-on-delete-row.d.ts","sourceRoot":"","sources":["../../../hooks/use-on-delete-row.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"use-on-delete-row.d.ts","sourceRoot":"","sources":["../../../hooks/use-on-delete-row.ts"],"names":[],"mappings":"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"}

package/dist/esm/hooks/use-on-delete-row.js

@@ -1,8 +1,8 @@
 import { useCallback } from "react";
-import { deleteRow } from "../interface/delete-row";
 import { useShowError } from "../atoms/error-state.atom";
+import { deleteRow } from "../interface/delete-row";
 import { SHEET_PROTECTION_ERROR_TITLE, useCanEditSheet, useCanPerformSheetAction, } from "./use-can-edit-cellrange";
-export const useOnDeleteRow = ({ rowCount, columnCount, locale, cellXfsRegistry, sharedStringRegistry, getActiveCell, getSelections, getDependents, getGraphNodes, getGraphNodesInSheet, createHistory, enqueueGraphOperation, enqueueCalculation, enqueueStructureChange, onChangeSheetData, onChangeSheets, onChangeTables, onChangeActiveCell, onChangeSelections, onChangeConditionalFormats, onChangeDataValidations, onChangeCitations, onChangePivotTables, getSheetName, onCommand, }) => {
+export const useOnDeleteRow = ({ rowCount, columnCount, locale, cellXfsRegistry, sharedStringRegistry, getActiveCell, getSelections, getDependents, getGraphNodes, getGraphNodesInSheet, createHistory, enqueueGraphOperation, enqueueCalculation, enqueueStructureChange, onChangeSheetData, onChangeSheets, onChangeTables, onChangeActiveCell, onChangeSelections, onChangeConditionalFormats, onChangeDataValidations, onChangeCitations, onChangePivotTables, onChangeNamedRanges, onChangeEmbeds, onChangeCharts, onChangeProtectedRanges, getSheetName, onCommand, tables, getArrayRange, }) => {
     const canEditSheet = useCanEditSheet();
     const canPerformSheetAction = useCanPerformSheetAction();
     const showError = useShowError();
@@ -46,7 +46,13 @@ export const useOnDeleteRow = ({ rowCount, columnCount, locale, cellXfsRegistry,
             onChangeDataValidations,
             onChangeCitations,
             onChangePivotTables,
+            onChangeNamedRanges,
+            onChangeEmbeds,
+            onChangeCharts,
+            onChangeProtectedRanges,
             getSheetName,
+            tables,
+            getArrayRange,
         })(sheetId, rowIndexes);
         onCommand?.({
             command: "delete-row",
@@ -77,10 +83,16 @@ export const useOnDeleteRow = ({ rowCount, columnCount, locale, cellXfsRegistry,
         onChangeDataValidations,
         onChangeCitations,
         onChangePivotTables,
+        onChangeNamedRanges,
+        onChangeEmbeds,
+        onChangeCharts,
+        onChangeProtectedRanges,
         canEditSheet,
         canPerformSheetAction,
         showError,
         getSheetName,
         onCommand,
+        tables,
+        getArrayRange,
     ]);
 };

package/dist/esm/hooks/use-on-fill.d.ts

@@ -1,6 +1,6 @@
-import type { CellInterface, SelectionArea } from "@rowsncolumns/common-types";
-import { type CellData, type SelectionAttributes, type Sheet } from "@rowsncolumns/spreadsheet";
-import type { AutoFillType } from "../api/fill";
+import type { CellInterface, GridRange, SelectionArea } from "@rowsncolumns/common-types";
+import { type CellData, type FillOptions, type SelectionAttributes, type Sheet } from "@rowsncolumns/spreadsheet";
+import { type AutoFillType } from "../api/fill";
 import type { OnCommand } from "../commands";
 import type { CalculationOperation, useCalculation } from "./use-calculation";
 import type { CellXfsRegistry } from "./use-cellxfs-registry";
@@ -24,6 +24,15 @@ export type UseOnFillProps<T extends CellData, S extends Sheet> = {
     getAutoFillValues: NonNullable<UseSpreadsheetProps<T, S>["getAutoFillValues"]>;
     getSheetName(sheetId: number): string;
     onCommand?: OnCommand;
+    /**
+     * The sheet's merged ranges — a source tiled by identically sized merges fills block by block.
+     */
+    getMerges?(sheetId: number): GridRange[] | null | undefined;
+    /**
+     * Land the merge blocks a merged-seed fill produced: the target's own merges in `clearRange`
+     * give way, `merges` are created, and `selectRange` (the snapped fill extent) is re-selected.
+     */
+    onFillMerges?(sheetId: number, activeCell: CellInterface, clearRange: GridRange, merges: GridRange[], selectRange: GridRange): void;
 };
-export declare const useOnFill: <T extends CellData, S extends Sheet>({ locale, cellXfsRegistry, sharedStringRegistry, getCellData, getDataValidationById, getEffectiveValue, getFormattedValue, getAutoFillValues, getSheetName, enqueueCalculation, enqueueStructureChange, onChangeSheetData, onChangeDataValidations, createHistory, onCommand, }: UseOnFillProps<T, S>) => (sheetId: number, activeCell: CellInterface, fillSelection: SelectionArea, selections: SelectionArea<SelectionAttributes>[], fillableSelections?: SelectionArea<SelectionAttributes>[], fillType?: AutoFillType) => Promise<void>;
+export declare const useOnFill: <T extends CellData, S extends Sheet>({ locale, cellXfsRegistry, sharedStringRegistry, getCellData, getDataValidationById, getEffectiveValue, getFormattedValue, getAutoFillValues, getSheetName, enqueueCalculation, enqueueStructureChange, onChangeSheetData, onChangeDataValidations, createHistory, onCommand, getMerges, onFillMerges, }: UseOnFillProps<T, S>) => (sheetId: number, activeCell: CellInterface, fillSelection: SelectionArea, selections: SelectionArea<SelectionAttributes>[], fillableSelections?: SelectionArea<SelectionAttributes>[], fillType?: AutoFillType, options?: FillOptions) => Promise<void>;
 //# sourceMappingURL=use-on-fill.d.ts.map

package/dist/esm/hooks/use-on-fill.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-on-fill.d.ts","sourceRoot":"","sources":["../../../hooks/use-on-fill.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC/E,OAAO,EACL,KAAK,QAAQ,EACb,KAAK,mBAAmB,EACxB,KAAK,KAAK,EAEX,MAAM,2BAA2B,CAAC;AAGnC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE7C,OAAO,KAAK,EAAE,oBAAoB,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAE9E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AACjE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AACnE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAC9D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAExD,MAAM,MAAM,cAAc,CAAC,CAAC,SAAS,QAAQ,EAAE,CAAC,SAAS,KAAK,IAAI;IAChE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,eAAe,CAAC,EAAE,eAAe,CAAC;IAClC,oBAAoB,CAAC,EAAE,oBAAoB,CAAC;IAC5C,WAAW,EAAE,UAAU,CAAC,OAAO,kBAAkB,CAAC,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC;IACrE,qBAAqB,CAAC,EAAE,UAAU,CAChC,OAAO,kBAAkB,CAAC,CAAC,CAAC,CAC7B,CAAC,uBAAuB,CAAC,CAAC;IAC3B,iBAAiB,EAAE,UAAU,CAC3B,OAAO,kBAAkB,CAAC,CAAC,CAAC,CAC7B,CAAC,mBAAmB,CAAC,CAAC;IACvB,iBAAiB,EAAE,UAAU,CAC3B,OAAO,kBAAkB,CAAC,CAAC,CAAC,CAC7B,CAAC,mBAAmB,CAAC,CAAC;IACvB,kBAAkB,CAAC,SAAS,EAAE,oBAAoB,GAAG,IAAI,CAAC;IAC1D,sBAAsB,CAAC,EAAE,UAAU,CACjC,OAAO,cAAc,CACtB,CAAC,wBAAwB,CAAC,CAAC;IAC5B,iBAAiB,EAAE,mBAAmB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC;IAClE,uBAAuB,CAAC,EAAE,mBAAmB,CAC3C,CAAC,EACD,CAAC,CACF,CAAC,yBAAyB,CAAC,CAAC;IAC7B,aAAa,IAAI,CAAC,OAAO,EAAE,gBAAgB,KAAK,IAAI,CAAC;IACrD,iBAAiB,EAAE,WAAW,CAC5B,mBAAmB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAC/C,CAAC;IACF,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC;IACtC,SAAS,CAAC,EAAE,SAAS,CAAC;CACvB,CAAC;AAEF,eAAO,MAAM,SAAS,GAAI,CAAC,SAAS,QAAQ,EAAE,CAAC,SAAS,KAAK,EAAE,iRAgB5D,cAAc,CAAC,CAAC,EAAE,CAAC,CAAC,eAKR,MAAM,cACH,aAAa,iBACV,aAAa,cAChB,aAAa,CAAC,mBAAmB,CAAC,EAAE,uBAC3B,aAAa,CAAC,mBAAmB,CAAC,EAAE,aAC9C,YAAY,kBAwE5B,CAAC"}
+{"version":3,"file":"use-on-fill.d.ts","sourceRoot":"","sources":["../../../hooks/use-on-fill.ts"],"names":[],"mappings":"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"}

package/dist/esm/hooks/use-on-fill.js

@@ -1,11 +1,17 @@
 import { useLoadingIndicator, } from "@rowsncolumns/spreadsheet";
+import { error } from "@rowsncolumns/utils";
 import { useCallback } from "react";
+import { MergedFillSizeError } from "../api/fill";
 import { applyFill } from "../interface/apply-fill";
 import { useCanEditCellRange } from "./use-can-edit-cellrange";
-export const useOnFill = ({ locale, cellXfsRegistry, sharedStringRegistry, getCellData, getDataValidationById, getEffectiveValue, getFormattedValue, getAutoFillValues, getSheetName, enqueueCalculation, enqueueStructureChange, onChangeSheetData, onChangeDataValidations, createHistory, onCommand, }) => {
+export const useOnFill = ({ locale, cellXfsRegistry, sharedStringRegistry, getCellData, getDataValidationById, getEffectiveValue, getFormattedValue, getAutoFillValues, getSheetName, enqueueCalculation, enqueueStructureChange, onChangeSheetData, onChangeDataValidations, createHistory, onCommand, getMerges, onFillMerges, }) => {
     const canEditCellRange = useCanEditCellRange();
     const [showLoader, hideLoader] = useLoadingIndicator();
-    return useCallback(async (sheetId, activeCell, fillSelection, selections, fillableSelections, fillType) => {
+    return useCallback(async (sheetId, activeCell, fillSelection, selections, fillableSelections, fillType, 
+    // Modifier held on the fill handle / Series-dialog parameters. The
+    // positional `fillType` keeps working; `options.fillType` is a fallback.
+    options) => {
+        const resolvedFillType = fillType ?? options?.fillType;
         if (!canEditCellRange(sheetId, fillSelection.range)) {
             console.debug("This range is protected, users cannot edit this cell range.");
             return;
@@ -29,7 +35,17 @@ export const useOnFill = ({ locale, cellXfsRegistry, sharedStringRegistry, getCe
                 onChangeSheetData,
                 onChangeDataValidations,
                 createHistory,
-            })(sheetId, activeCell, fillSelection, selections, fillableSelections, fillType);
+                getMerges,
+                onFillMerges,
+            })(sheetId, activeCell, fillSelection, selections, fillableSelections, resolvedFillType, options);
+        }
+        catch (err) {
+            // Excel refuses a fill whose source mixes unequal merged blocks; nothing was written.
+            if (err instanceof MergedFillSizeError) {
+                error(err.message);
+                return;
+            }
+            throw err;
         }
         finally {
             hideLoader();
@@ -41,7 +57,9 @@ export const useOnFill = ({ locale, cellXfsRegistry, sharedStringRegistry, getCe
             fillSelection,
             selections,
             fillableSelections,
-            fillType,
+            fillType: resolvedFillType,
+            modifier: options?.modifier,
+            series: options?.series,
         });
     }, [
         locale,
@@ -62,5 +80,7 @@ export const useOnFill = ({ locale, cellXfsRegistry, sharedStringRegistry, getCe
         onChangeDataValidations,
         getSheetName,
         onCommand,
+        getMerges,
+        onFillMerges,
     ]);
 };

package/dist/esm/hooks/use-on-insert-cells-shift-down.d.ts

@@ -1,10 +1,12 @@
+import type { GridRange } from "@rowsncolumns/common-types";
 import { type CellInterface, type SelectionArea } from "@rowsncolumns/grid";
 import type { CellData, SelectionAttributes, Sheet } from "@rowsncolumns/spreadsheet";
+import type { TableView } from "@rowsncolumns/spreadsheet";
 import type { OnCommand } from "../commands";
+import type { useCalculation } from "./use-calculation";
 import type { CellXfsRegistry } from "./use-cellxfs-registry";
+import type { SheetData, UseSpreadsheetProps } from "./use-spreadsheet-state";
 import type { SharedStringRegistry } from "./use-ss-registry";
-import type { useCalculation } from "./use-calculation";
-import type { UseSpreadsheetProps } from "./use-spreadsheet-state";
 import type { SpreadsheetPatch } from "./use-undo-redo";
 export type UseOnInsertCellsShiftDown<T extends CellData, S extends Sheet> = {
     rowCount: number;
@@ -22,7 +24,15 @@ export type UseOnInsertCellsShiftDown<T extends CellData, S extends Sheet> = {
     onChangeSheetData: UseSpreadsheetProps<T, S>["onChangeSheetData"];
     onChangeSheets: UseSpreadsheetProps<T, S>["onChangeSheets"];
     onChangeCitations?: UseSpreadsheetProps<T, S>["onChangeCitations"];
+    onChangeTables?: UseSpreadsheetProps<T, S>["onChangeTables"];
     onCommand?: OnCommand;
+    /** Current document facets, read by the Excel refusal guards (`getShiftCellsRefusal`). */
+    sheetData?: SheetData<T>;
+    sheets?: S[];
+    tables?: TableView[];
+    /** CSE / dynamic-array ranges on a sheet — a partially covered one refuses the shift. */
+    getArrayRanges?: (sheetId: number) => GridRange[] | undefined;
+    getSheetName?: (sheetId: number) => string;
 };
-export declare const useOnInsertCellsShiftDown: <T extends CellData, S extends Sheet>({ rowCount, columnCount, locale, cellXfsRegistry, sharedStringRegistry, getActiveCell, getSelections, getDependents, createHistory, enqueueGraphOperation, enqueueCalculation, enqueueStructureChange, onChangeSheetData, onChangeSheets, onChangeCitations, onCommand, }: UseOnInsertCellsShiftDown<T, S>) => (sheetId: number, activeCell: CellInterface, selections: SelectionArea<SelectionAttributes>[]) => void;
+export declare const useOnInsertCellsShiftDown: <T extends CellData, S extends Sheet>({ rowCount, columnCount, locale, cellXfsRegistry, sharedStringRegistry, getActiveCell, getSelections, getDependents, createHistory, enqueueGraphOperation, enqueueCalculation, enqueueStructureChange, onChangeSheetData, onChangeSheets, onChangeCitations, onChangeTables, onCommand, sheetData, sheets, tables, getArrayRanges, getSheetName, }: UseOnInsertCellsShiftDown<T, S>) => (sheetId: number, activeCell: CellInterface, selections: SelectionArea<SelectionAttributes>[]) => void;
 //# sourceMappingURL=use-on-insert-cells-shift-down.d.ts.map

package/dist/esm/hooks/use-on-insert-cells-shift-down.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-on-insert-cells-shift-down.d.ts","sourceRoot":"","sources":["../../../hooks/use-on-insert-cells-shift-down.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,aAAa,EAAE,KAAK,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAC5E,OAAO,KAAK,EACV,QAAQ,EACR,mBAAmB,EACnB,KAAK,EACN,MAAM,2BAA2B,CAAC;AAGnC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE7C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAC9D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAOxD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AACnE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAExD,MAAM,MAAM,yBAAyB,CAAC,CAAC,SAAS,QAAQ,EAAE,CAAC,SAAS,KAAK,IAAI;IAC3E,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,eAAe,CAAC,EAAE,eAAe,CAAC;IAClC,oBAAoB,CAAC,EAAE,oBAAoB,CAAC;IAC5C,aAAa,EAAE,MAAM,aAAa,CAAC;IACnC,aAAa,IAAI,aAAa,CAAC,mBAAmB,CAAC,EAAE,CAAC;IACtD,aAAa,EAAE,MAAM,CAAC,OAAO,EAAE,gBAAgB,KAAK,IAAI,CAAC;IACzD,aAAa,EAAE,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC,eAAe,CAAC,CAAC;IAClE,kBAAkB,EAAE,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC,oBAAoB,CAAC,CAAC;IAC5E,sBAAsB,CAAC,EAAE,UAAU,CACjC,OAAO,cAAc,CACtB,CAAC,wBAAwB,CAAC,CAAC;IAC5B,qBAAqB,EAAE,UAAU,CAC/B,OAAO,cAAc,CACtB,CAAC,uBAAuB,CAAC,CAAC;IAC3B,iBAAiB,EAAE,mBAAmB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC;IAClE,cAAc,EAAE,mBAAmB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC;IAC5D,iBAAiB,CAAC,EAAE,mBAAmB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC;IACnE,SAAS,CAAC,EAAE,SAAS,CAAC;CACvB,CAAC;AAEF,eAAO,MAAM,yBAAyB,GAAI,CAAC,SAAS,QAAQ,EAAE,CAAC,SAAS,KAAK,EAAE,2QAiB5E,yBAAyB,CAAC,CAAC,EAAE,CAAC,CAAC,eAMnB,MAAM,cACH,aAAa,cACb,aAAa,CAAC,mBAAmB,CAAC,EAAE,SA+DrD,CAAC"}
+{"version":3,"file":"use-on-insert-cells-shift-down.d.ts","sourceRoot":"","sources":["../../../hooks/use-on-insert-cells-shift-down.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AAC5D,OAAO,EAAE,KAAK,aAAa,EAAE,KAAK,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAC5E,OAAO,KAAK,EACV,QAAQ,EACR,mBAAmB,EACnB,KAAK,EACN,MAAM,2BAA2B,CAAC;AACnC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AAK3D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE7C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAMxD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,KAAK,EAAE,SAAS,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAC9E,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAC9D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAExD,MAAM,MAAM,yBAAyB,CAAC,CAAC,SAAS,QAAQ,EAAE,CAAC,SAAS,KAAK,IAAI;IAC3E,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,eAAe,CAAC,EAAE,eAAe,CAAC;IAClC,oBAAoB,CAAC,EAAE,oBAAoB,CAAC;IAC5C,aAAa,EAAE,MAAM,aAAa,CAAC;IACnC,aAAa,IAAI,aAAa,CAAC,mBAAmB,CAAC,EAAE,CAAC;IACtD,aAAa,EAAE,MAAM,CAAC,OAAO,EAAE,gBAAgB,KAAK,IAAI,CAAC;IACzD,aAAa,EAAE,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC,eAAe,CAAC,CAAC;IAClE,kBAAkB,EAAE,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC,oBAAoB,CAAC,CAAC;IAC5E,sBAAsB,CAAC,EAAE,UAAU,CACjC,OAAO,cAAc,CACtB,CAAC,wBAAwB,CAAC,CAAC;IAC5B,qBAAqB,EAAE,UAAU,CAC/B,OAAO,cAAc,CACtB,CAAC,uBAAuB,CAAC,CAAC;IAC3B,iBAAiB,EAAE,mBAAmB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC;IAClE,cAAc,EAAE,mBAAmB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC;IAC5D,iBAAiB,CAAC,EAAE,mBAAmB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC;IACnE,cAAc,CAAC,EAAE,mBAAmB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC;IAC7D,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,0FAA0F;IAC1F,SAAS,CAAC,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC;IACzB,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC;IACb,MAAM,CAAC,EAAE,SAAS,EAAE,CAAC;IACrB,yFAAyF;IACzF,cAAc,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,SAAS,EAAE,GAAG,SAAS,CAAC;IAC9D,YAAY,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,MAAM,CAAC;CAC5C,CAAC;AAEF,eAAO,MAAM,yBAAyB,GAAI,CAAC,SAAS,QAAQ,EAAE,CAAC,SAAS,KAAK,EAAE,oVAuB5E,yBAAyB,CAAC,CAAC,EAAE,CAAC,CAAC,eAMnB,MAAM,cACH,aAAa,cACb,aAAa,CAAC,mBAAmB,CAAC,EAAE,SAuFrD,CAAC"}

package/dist/esm/hooks/use-on-insert-cells-shift-down.js

@@ -1,8 +1,9 @@
 import { useCallback } from "react";
-import { insertCellsShiftDown } from "../interface/insert-cells-shift-down";
+import { getShiftCellsRefusal, resolveShiftSelection } from "../api/structural-guards";
 import { useShowError } from "../atoms/error-state.atom";
+import { insertCellsShiftDown } from "../interface/insert-cells-shift-down";
 import { SHEET_PROTECTION_ERROR_TITLE, useCanEditCellRange, useCanPerformSheetAction, } from "./use-can-edit-cellrange";
-export const useOnInsertCellsShiftDown = ({ rowCount, columnCount, locale, cellXfsRegistry, sharedStringRegistry, getActiveCell, getSelections, getDependents, createHistory, enqueueGraphOperation, enqueueCalculation, enqueueStructureChange, onChangeSheetData, onChangeSheets, onChangeCitations, onCommand, }) => {
+export const useOnInsertCellsShiftDown = ({ rowCount, columnCount, locale, cellXfsRegistry, sharedStringRegistry, getActiveCell, getSelections, getDependents, createHistory, enqueueGraphOperation, enqueueCalculation, enqueueStructureChange, onChangeSheetData, onChangeSheets, onChangeCitations, onChangeTables, onCommand, sheetData, sheets, tables, getArrayRanges, getSheetName, }) => {
     const canEditCellRange = useCanEditCellRange();
     const canPerformSheetAction = useCanPerformSheetAction();
     const showError = useShowError();
@@ -18,6 +19,21 @@ export const useOnInsertCellsShiftDown = ({ rowCount, columnCount, locale, cellX
             console.debug("This range is protected, users cannot edit this cell range.");
             return;
         }
+        const selection = resolveShiftSelection(activeCell, selections);
+        const refusal = getShiftCellsRefusal({
+            direction: "down",
+            range: selection.range,
+            sheetId,
+            rows: sheetData?.[sheetId],
+            rowCount,
+            merges: sheets?.find((sheet) => sheet.sheetId === sheetId)?.merges,
+            tables,
+            arrayRanges: getArrayRanges?.(sheetId),
+        });
+        if (refusal) {
+            showError({ title: refusal.title, message: refusal.message });
+            return;
+        }
         insertCellsShiftDown({
             rowCount,
             columnCount,
@@ -34,6 +50,8 @@ export const useOnInsertCellsShiftDown = ({ rowCount, columnCount, locale, cellX
             onChangeSheetData,
             onChangeSheets,
             onChangeCitations,
+            onChangeTables,
+            getSheetName,
         })(sheetId, activeCell, selections);
         onCommand?.({
             command: "insert-cells-shift-down",
@@ -61,5 +79,11 @@ export const useOnInsertCellsShiftDown = ({ rowCount, columnCount, locale, cellX
         canPerformSheetAction,
         showError,
         onCommand,
+        onChangeTables,
+        sheetData,
+        sheets,
+        tables,
+        getArrayRanges,
+        getSheetName,
     ]);
 };