@rowsncolumns/spreadsheet-state 28.0.75 → 29.0.0

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,
     ]);
 };

package/dist/esm/hooks/use-on-insert-cells-shift-right.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 UseOnInsertCellsShiftRight<T extends CellData, S extends Sheet> = {
     rowCount: number;
@@ -22,7 +24,15 @@ export type UseOnInsertCellsShiftRight<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 useOnInsertCellsShiftRight: <T extends CellData, S extends Sheet>({ rowCount, columnCount, locale, cellXfsRegistry, sharedStringRegistry, getActiveCell, getSelections, getDependents, createHistory, enqueueGraphOperation, enqueueCalculation, enqueueStructureChange, onChangeSheetData, onChangeSheets, onChangeCitations, onCommand, }: UseOnInsertCellsShiftRight<T, S>) => (sheetId: number, activeCell: CellInterface, selections: SelectionArea<SelectionAttributes>[]) => void;
+export declare const useOnInsertCellsShiftRight: <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, }: UseOnInsertCellsShiftRight<T, S>) => (sheetId: number, activeCell: CellInterface, selections: SelectionArea<SelectionAttributes>[]) => void;
 //# sourceMappingURL=use-on-insert-cells-shift-right.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"use-on-insert-cells-shift-right.d.ts","sourceRoot":"","sources":["../../../hooks/use-on-insert-cells-shift-right.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,0BAA0B,CAAC,CAAC,SAAS,QAAQ,EAAE,CAAC,SAAS,KAAK,IAAI;IAC5E,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,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC,eAAe,CAAC,CAAC;IAClE,aAAa,EAAE,MAAM,CAAC,OAAO,EAAE,gBAAgB,KAAK,IAAI,CAAC;IACzD,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,0BAA0B,GACrC,CAAC,SAAS,QAAQ,EAClB,CAAC,SAAS,KAAK,EACf,2QAiBC,0BAA0B,CAAC,CAAC,EAAE,CAAC,CAAC,eAMpB,MAAM,cACH,aAAa,cACb,aAAa,CAAC,mBAAmB,CAAC,EAAE,SA8DrD,CAAC"}
+{"version":3,"file":"use-on-insert-cells-shift-right.d.ts","sourceRoot":"","sources":["../../../hooks/use-on-insert-cells-shift-right.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,0BAA0B,CAAC,CAAC,SAAS,QAAQ,EAAE,CAAC,SAAS,KAAK,IAAI;IAC5E,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,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC,eAAe,CAAC,CAAC;IAClE,aAAa,EAAE,MAAM,CAAC,OAAO,EAAE,gBAAgB,KAAK,IAAI,CAAC;IACzD,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,0BAA0B,GACrC,CAAC,SAAS,QAAQ,EAClB,CAAC,SAAS,KAAK,EACf,oVAuBC,0BAA0B,CAAC,CAAC,EAAE,CAAC,CAAC,eAMpB,MAAM,cACH,aAAa,cACb,aAAa,CAAC,mBAAmB,CAAC,EAAE,SAsFrD,CAAC"}

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

@@ -1,8 +1,9 @@
 import { useCallback } from "react";
-import { insertCellsShiftRight } from "../interface/insert-cells-shift-right";
+import { getShiftCellsRefusal, resolveShiftSelection } from "../api/structural-guards";
 import { useShowError } from "../atoms/error-state.atom";
+import { insertCellsShiftRight } from "../interface/insert-cells-shift-right";
 import { SHEET_PROTECTION_ERROR_TITLE, useCanEditCellRange, useCanPerformSheetAction, } from "./use-can-edit-cellrange";
-export const useOnInsertCellsShiftRight = ({ rowCount, columnCount, locale, cellXfsRegistry, sharedStringRegistry, getActiveCell, getSelections, getDependents, createHistory, enqueueGraphOperation, enqueueCalculation, enqueueStructureChange, onChangeSheetData, onChangeSheets, onChangeCitations, onCommand, }) => {
+export const useOnInsertCellsShiftRight = ({ 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 useOnInsertCellsShiftRight = ({ rowCount, columnCount, locale, cell
             console.debug("This range is protected, users cannot edit this cell range.");
             return;
         }
+        const selection = resolveShiftSelection(activeCell, selections);
+        const refusal = getShiftCellsRefusal({
+            direction: "right",
+            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;
+        }
         insertCellsShiftRight({
             rowCount,
             columnCount,
@@ -34,6 +50,8 @@ export const useOnInsertCellsShiftRight = ({ rowCount, columnCount, locale, cell
             onChangeSheetData,
             onChangeSheets,
             onChangeCitations,
+            onChangeTables,
+            getSheetName,
         })(sheetId, activeCell, selections);
         onCommand?.({
             command: "insert-cells-shift-right",
@@ -61,5 +79,11 @@ export const useOnInsertCellsShiftRight = ({ rowCount, columnCount, locale, cell
         canPerformSheetAction,
         showError,
         onCommand,
+        onChangeTables,
+        sheetData,
+        sheets,
+        tables,
+        getArrayRanges,
+        getSheetName,
     ]);
 };

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

@@ -3,10 +3,10 @@ import type { SelectionAttributes, TableView } from "@rowsncolumns/spreadsheet";
 import { type CellData, type Sheet } from "@rowsncolumns/spreadsheet";
 import type { OnCommand } from "../commands";
 import type { GeneratedNames } from "../generated-names";
+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 UseOnInsertColumnProps<T extends CellData, S extends Sheet> = {
     rowCount: number;
@@ -14,6 +14,9 @@ export type UseOnInsertColumnProps<T extends CellData, S extends Sheet> = {
     locale?: string;
     tables?: TableView[];
     maxColumnCount?: number;
+    /** Current sheet data — lets the grid-cap check refuse only when a NON-BLANK cell would be pushed
+     * off the sheet (INS-09); blank trailing columns fall off silently, as in Excel. */
+    sheetData?: SheetData<T>;
     cellXfsRegistry?: CellXfsRegistry;
     sharedStringRegistry?: SharedStringRegistry;
     getActiveCell: () => CellInterface;
@@ -32,9 +35,13 @@ export type UseOnInsertColumnProps<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;
     generatedNames?: GeneratedNames;
 };
-export declare const useOnInsertColumn: <T extends CellData, S extends Sheet>({ rowCount, columnCount, locale, tables, maxColumnCount, cellXfsRegistry, sharedStringRegistry, getDependents, getGraphNodes, getGraphNodesInSheet, createHistory, enqueueGraphOperation, enqueueCalculation, enqueueStructureChange, onChangeSheetData, onChangeSheets, onChangeTables, onChangeConditionalFormats, onChangeDataValidations, onChangeCitations, onChangePivotTables, getActiveCell, getSelections, getSheetName, onCommand, generatedNames, }: UseOnInsertColumnProps<T, S>) => (sheetId: number, referenceColumnIndex: number, numColumns?: number) => void;
+export declare const useOnInsertColumn: <T extends CellData, S extends Sheet>({ rowCount, columnCount, locale, tables, maxColumnCount, cellXfsRegistry, sharedStringRegistry, getDependents, getGraphNodes, getGraphNodesInSheet, createHistory, enqueueGraphOperation, enqueueCalculation, enqueueStructureChange, onChangeSheetData, onChangeSheets, onChangeTables, onChangeConditionalFormats, onChangeDataValidations, onChangeCitations, onChangePivotTables, onChangeNamedRanges, onChangeEmbeds, onChangeCharts, onChangeProtectedRanges, getActiveCell, getSelections, getSheetName, onCommand, generatedNames, sheetData, }: UseOnInsertColumnProps<T, S>) => (sheetId: number, referenceColumnIndex: number, numColumns?: number) => void;
 //# sourceMappingURL=use-on-insert-column.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"use-on-insert-column.d.ts","sourceRoot":"","sources":["../../../hooks/use-on-insert-column.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC/E,OAAO,KAAK,EAAE,mBAAmB,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AAChF,OAAO,EAAE,KAAK,QAAQ,EAAE,KAAK,KAAK,EAAE,MAAM,2BAA2B,CAAC;AAKtE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEzD,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;AAMxD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AACnE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAExD,MAAM,MAAM,sBAAsB,CAAC,CAAC,SAAS,QAAQ,EAAE,CAAC,SAAS,KAAK,IAAI;IACxE,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,SAAS,EAAE,CAAC;IACrB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,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,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC,eAAe,CAAC,CAAC;IAClE,aAAa,CAAC,EAAE,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC,eAAe,CAAC,CAAC;IACnE,oBAAoB,CAAC,EAAE,UAAU,CAC/B,OAAO,cAAc,CACtB,CAAC,sBAAsB,CAAC,CAAC;IAC1B,aAAa,EAAE,MAAM,CAAC,OAAO,EAAE,gBAAgB,KAAK,IAAI,CAAC;IACzD,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,cAAc,EAAE,mBAAmB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC;IAC5D,uBAAuB,CAAC,EAAE,mBAAmB,CAC3C,CAAC,EACD,CAAC,CACF,CAAC,yBAAyB,CAAC,CAAC;IAC7B,0BAA0B,CAAC,EAAE,mBAAmB,CAC9C,CAAC,EACD,CAAC,CACF,CAAC,4BAA4B,CAAC,CAAC;IAChC,iBAAiB,CAAC,EAAE,mBAAmB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC;IACnE,mBAAmB,CAAC,EAAE,mBAAmB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,qBAAqB,CAAC,CAAC;IACvE,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC;IACtC,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,cAAc,CAAC,EAAE,cAAc,CAAC;CACjC,CAAC;AAEF,eAAO,MAAM,iBAAiB,GAAI,CAAC,SAAS,QAAQ,EAAE,CAAC,SAAS,KAAK,EAAE,gcA2BpE,sBAAsB,CAAC,CAAC,EAAE,CAAC,CAAC,eAMjB,MAAM,wBAAwB,MAAM,8BAuFjD,CAAC"}
+{"version":3,"file":"use-on-insert-column.d.ts","sourceRoot":"","sources":["../../../hooks/use-on-insert-column.ts"],"names":[],"mappings":"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"}

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

@@ -1,9 +1,10 @@
 import { isNil } from "@rowsncolumns/utils";
 import { useCallback } from "react";
+import { getInsertLinesRefusal } from "../api/structural-guards";
 import { useShowError } from "../atoms/error-state.atom";
 import { insertColumn } from "../interface/insert-column";
 import { SHEET_PROTECTION_ERROR_TITLE, useCanEditSheet, useCanPerformSheetAction, } from "./use-can-edit-cellrange";
-export const useOnInsertColumn = ({ rowCount, columnCount, locale, tables, maxColumnCount, cellXfsRegistry, sharedStringRegistry, getDependents, getGraphNodes, getGraphNodesInSheet, createHistory, enqueueGraphOperation, enqueueCalculation, enqueueStructureChange, onChangeSheetData, onChangeSheets, onChangeTables, onChangeConditionalFormats, onChangeDataValidations, onChangeCitations, onChangePivotTables, getActiveCell, getSelections, getSheetName, onCommand, generatedNames, }) => {
+export const useOnInsertColumn = ({ rowCount, columnCount, locale, tables, maxColumnCount, cellXfsRegistry, sharedStringRegistry, getDependents, getGraphNodes, getGraphNodesInSheet, createHistory, enqueueGraphOperation, enqueueCalculation, enqueueStructureChange, onChangeSheetData, onChangeSheets, onChangeTables, onChangeConditionalFormats, onChangeDataValidations, onChangeCitations, onChangePivotTables, onChangeNamedRanges, onChangeEmbeds, onChangeCharts, onChangeProtectedRanges, getActiveCell, getSelections, getSheetName, onCommand, generatedNames, sheetData, }) => {
     const canEditSheet = useCanEditSheet();
     const canPerformSheetAction = useCanPerformSheetAction();
     const showError = useShowError();
@@ -19,17 +20,33 @@ export const useOnInsertColumn = ({ rowCount, columnCount, locale, tables, maxCo
             });
             return;
         }
-        if (!isNil(maxColumnCount) && columnCount >= maxColumnCount) {
-            showError({
-                title: "New columns cannot be added",
-                message: "You have reached the maximum number of columns.",
-            });
-            return;
+        if (!isNil(maxColumnCount) && columnCount + numColumns > maxColumnCount) {
+            // INS-09: at the grid cap, Excel refuses only when a non-blank (or formatted) cell would
+            // be pushed off the end; blank trailing columns are simply discarded.
+            const refusal = sheetData
+                ? getInsertLinesRefusal({
+                    axis: "column",
+                    referenceIndex: referenceColumnIndex,
+                    count: numColumns,
+                    rows: sheetData[sheetId],
+                    limit: maxColumnCount,
+                })
+                : columnCount >= maxColumnCount
+                    ? {
+                        title: "New columns cannot be added",
+                        message: "You have reached the maximum number of columns.",
+                    }
+                    : undefined;
+            if (refusal) {
+                showError({ title: refusal.title, message: refusal.message });
+                return;
+            }
         }
         insertColumn({
             rowCount,
             columnCount,
             locale,
+            maxColumnCount,
             tables,
             cellXfsRegistry,
             sharedStringRegistry,
@@ -47,6 +64,10 @@ export const useOnInsertColumn = ({ rowCount, columnCount, locale, tables, maxCo
             onChangeDataValidations,
             onChangeCitations,
             onChangePivotTables,
+            onChangeNamedRanges,
+            onChangeEmbeds,
+            onChangeCharts,
+            onChangeProtectedRanges,
             getActiveCell,
             getSelections,
             getSheetName,
@@ -82,10 +103,15 @@ export const useOnInsertColumn = ({ rowCount, columnCount, locale, tables, maxCo
         onChangeConditionalFormats,
         onChangeDataValidations,
         onChangePivotTables,
+        onChangeNamedRanges,
+        onChangeEmbeds,
+        onChangeCharts,
+        onChangeProtectedRanges,
         canEditSheet,
         canPerformSheetAction,
         getSheetName,
         onCommand,
         generatedNames,
+        sheetData,
     ]);
 };

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

@@ -2,10 +2,10 @@ import type { CellInterface, SelectionArea } from "@rowsncolumns/common-types";
 import type { SelectionAttributes } from "@rowsncolumns/spreadsheet";
 import { type CellData, type Sheet } 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 UseOnInsertRowProps<T extends CellData, S extends Sheet> = {
     rowCount: number;
@@ -25,6 +25,9 @@ export type UseOnInsertRowProps<T extends CellData, S extends Sheet> = {
     getSelections(): SelectionArea<SelectionAttributes>[];
     getSheetName(sheetId: number): string;
     enableInsertRowTimingLogs?: boolean;
+    /** Current sheet data — lets the grid-cap check refuse only when a NON-BLANK cell would be pushed
+     * off the sheet (INS-06); blank trailing rows fall off silently, as in Excel. */
+    sheetData?: SheetData<T>;
     onChangeSheetData?: UseSpreadsheetProps<T, S>["onChangeSheetData"];
     onChangeSheets?: UseSpreadsheetProps<T, S>["onChangeSheets"];
     onChangeTables?: UseSpreadsheetProps<T, S>["onChangeTables"];
@@ -32,7 +35,11 @@ export type UseOnInsertRowProps<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"];
     onCommand?: OnCommand;
 };
-export declare const useOnInsertRow: <T extends CellData, S extends Sheet>({ rowCount, columnCount, locale, maxRowCount, cellXfsRegistry, sharedStringRegistry, getActiveCell, getSelections, getDependents, getGraphNodes, getGraphNodesInSheet, createHistory, enqueueGraphOperation, enqueueCalculation, enqueueStructureChange, onChangeSheetData, onChangeSheets, onChangeTables, onChangeConditionalFormats, onChangeDataValidations, onChangeCitations, onChangePivotTables, getSheetName, enableInsertRowTimingLogs, onCommand, }: UseOnInsertRowProps<T, S>) => (sheetId: number, referenceRowIndex: number, numRows?: number) => void;
+export declare const useOnInsertRow: <T extends CellData, S extends Sheet>({ rowCount, columnCount, locale, maxRowCount, cellXfsRegistry, sharedStringRegistry, getActiveCell, getSelections, getDependents, getGraphNodes, getGraphNodesInSheet, createHistory, enqueueGraphOperation, enqueueCalculation, enqueueStructureChange, onChangeSheetData, onChangeSheets, onChangeTables, onChangeConditionalFormats, onChangeDataValidations, onChangeCitations, onChangePivotTables, onChangeNamedRanges, onChangeEmbeds, onChangeCharts, onChangeProtectedRanges, getSheetName, enableInsertRowTimingLogs, sheetData, onCommand, }: UseOnInsertRowProps<T, S>) => (sheetId: number, referenceRowIndex: number, numRows?: number) => void;
 //# sourceMappingURL=use-on-insert-row.d.ts.map

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

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

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

@@ -1,9 +1,10 @@
 import { isNil } from "@rowsncolumns/utils";
 import { useCallback } from "react";
+import { getInsertLinesRefusal } from "../api/structural-guards";
 import { useShowError } from "../atoms/error-state.atom";
 import { insertRow } from "../interface/insert-row";
 import { SHEET_PROTECTION_ERROR_TITLE, useCanEditSheet, useCanPerformSheetAction, } from "./use-can-edit-cellrange";
-export const useOnInsertRow = ({ rowCount, columnCount, locale, maxRowCount, cellXfsRegistry, sharedStringRegistry, getActiveCell, getSelections, getDependents, getGraphNodes, getGraphNodesInSheet, createHistory, enqueueGraphOperation, enqueueCalculation, enqueueStructureChange, onChangeSheetData, onChangeSheets, onChangeTables, onChangeConditionalFormats, onChangeDataValidations, onChangeCitations, onChangePivotTables, getSheetName, enableInsertRowTimingLogs, onCommand, }) => {
+export const useOnInsertRow = ({ rowCount, columnCount, locale, maxRowCount, cellXfsRegistry, sharedStringRegistry, getActiveCell, getSelections, getDependents, getGraphNodes, getGraphNodesInSheet, createHistory, enqueueGraphOperation, enqueueCalculation, enqueueStructureChange, onChangeSheetData, onChangeSheets, onChangeTables, onChangeConditionalFormats, onChangeDataValidations, onChangeCitations, onChangePivotTables, onChangeNamedRanges, onChangeEmbeds, onChangeCharts, onChangeProtectedRanges, getSheetName, enableInsertRowTimingLogs, sheetData, onCommand, }) => {
     const canEditSheet = useCanEditSheet();
     const canPerformSheetAction = useCanPerformSheetAction();
     const showError = useShowError();
@@ -23,12 +24,27 @@ export const useOnInsertRow = ({ rowCount, columnCount, locale, maxRowCount, cel
             });
             return;
         }
-        if (!isNil(maxRowCount) && rowCount >= maxRowCount) {
-            showError({
-                title: "New rows cannot be added",
-                message: "You have reached the maximum number of rows.",
-            });
-            return;
+        if (!isNil(maxRowCount) && rowCount + numRows > maxRowCount) {
+            // INS-06: at the grid cap, Excel refuses only when a non-blank (or formatted) cell would
+            // be pushed off the end; blank trailing rows are simply discarded.
+            const refusal = sheetData
+                ? getInsertLinesRefusal({
+                    axis: "row",
+                    referenceIndex: referenceRowIndex,
+                    count: numRows,
+                    rows: sheetData[sheetId],
+                    limit: maxRowCount,
+                })
+                : rowCount >= maxRowCount
+                    ? {
+                        title: "New rows cannot be added",
+                        message: "You have reached the maximum number of rows.",
+                    }
+                    : undefined;
+            if (refusal) {
+                showError({ title: refusal.title, message: refusal.message });
+                return;
+            }
         }
         // Inserts row
         const startMs = now();
@@ -55,6 +71,10 @@ export const useOnInsertRow = ({ rowCount, columnCount, locale, maxRowCount, cel
             onChangeDataValidations,
             onChangeCitations,
             onChangePivotTables,
+            onChangeNamedRanges,
+            onChangeEmbeds,
+            onChangeCharts,
+            onChangeProtectedRanges,
             getSheetName,
         })(sheetId, referenceRowIndex, numRows);
         const elapsedMs = now() - startMs;
@@ -92,6 +112,10 @@ export const useOnInsertRow = ({ rowCount, columnCount, locale, maxRowCount, cel
         onChangeConditionalFormats,
         onChangeDataValidations,
         onChangePivotTables,
+        onChangeNamedRanges,
+        onChangeEmbeds,
+        onChangeCharts,
+        onChangeProtectedRanges,
         enqueueGraphOperation,
         enqueueCalculation,
         enqueueStructureChange,
@@ -99,6 +123,7 @@ export const useOnInsertRow = ({ rowCount, columnCount, locale, maxRowCount, cel
         canPerformSheetAction,
         getSheetName,
         enableInsertRowTimingLogs,
+        sheetData,
         onCommand,
     ]);
 };

package/dist/esm/hooks/use-on-move-columns.d.ts

@@ -2,6 +2,7 @@ import type { CellInterface } from "@rowsncolumns/common-types";
 import { type CellData, type Sheet } from "@rowsncolumns/spreadsheet";
 import type { OnCommand } from "../commands";
 import type { useCalculation } from "./use-calculation";
+import { type MoveDimensionOptions } from "./use-on-move-rows";
 import type { useSheetProperties } from "./use-sheet-properties";
 import type { UseSpreadsheetProps } from "./use-spreadsheet-state";
 import type { SpreadsheetPatch } from "./use-undo-redo";
@@ -23,6 +24,6 @@ type UseOnMoveColumnsProps<T extends CellData, S extends Sheet> = {
     getActiveCell: () => CellInterface;
     onCommand?: OnCommand;
 };
-export declare const useOnMoveColumns: <T extends CellData, S extends Sheet>({ rowCount, columnCount, locale, createHistory, onChangeSheetData, onChangeSheets, onChangeTables, onChangeConditionalFormats, onChangeDataValidations, enqueueGraphOperation, enqueueCalculation, enqueueStructureChange, getDependents, getDataRowCount, getActiveCell, onCommand, }: UseOnMoveColumnsProps<T, S>) => (sheetId: number, columns: number[], referenceColumnIndex: number) => void;
+export declare const useOnMoveColumns: <T extends CellData, S extends Sheet>({ rowCount, columnCount, locale, createHistory, onChangeSheetData, onChangeSheets, onChangeTables, onChangeConditionalFormats, onChangeDataValidations, enqueueGraphOperation, enqueueCalculation, enqueueStructureChange, getDependents, getDataRowCount, getActiveCell, onCommand, }: UseOnMoveColumnsProps<T, S>) => (sheetId: number, columns: number[], rawReferenceColumnIndex: number, options?: MoveDimensionOptions) => void;
 export {};
 //# sourceMappingURL=use-on-move-columns.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"use-on-move-columns.d.ts","sourceRoot":"","sources":["../../../hooks/use-on-move-columns.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAa,MAAM,4BAA4B,CAAC;AAE3E,OAAO,EAAE,KAAK,QAAQ,EAAE,KAAK,KAAK,EAAE,MAAM,2BAA2B,CAAC;AAWtE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE7C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAExD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AACjE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AACnE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAExD,KAAK,qBAAqB,CAAC,CAAC,SAAS,QAAQ,EAAE,CAAC,SAAS,KAAK,IAAI;IAChE,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,MAAM,CAAC,OAAO,EAAE,gBAAgB,KAAK,IAAI,CAAC;IACzD,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,cAAc,EAAE,mBAAmB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC;IAC5D,0BAA0B,CAAC,EAAE,mBAAmB,CAC9C,CAAC,EACD,CAAC,CACF,CAAC,4BAA4B,CAAC,CAAC;IAChC,uBAAuB,CAAC,EAAE,mBAAmB,CAC3C,CAAC,EACD,CAAC,CACF,CAAC,yBAAyB,CAAC,CAAC;IAC7B,aAAa,EAAE,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC,eAAe,CAAC,CAAC;IAClE,eAAe,CAAC,EAAE,UAAU,CAAC,OAAO,kBAAkB,CAAC,CAAC,iBAAiB,CAAC,CAAC;IAC3E,aAAa,EAAE,MAAM,aAAa,CAAC;IACnC,SAAS,CAAC,EAAE,SAAS,CAAC;CACvB,CAAC;AAEF,eAAO,MAAM,gBAAgB,GAAI,CAAC,SAAS,QAAQ,EAAE,CAAC,SAAS,KAAK,EAAE,wRAiBnE,qBAAqB,CAAC,CAAC,EAAE,CAAC,CAAC,eAGhB,MAAM,WAAW,MAAM,EAAE,wBAAwB,MAAM,SAsYpE,CAAC"}
+{"version":3,"file":"use-on-move-columns.d.ts","sourceRoot":"","sources":["../../../hooks/use-on-move-columns.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAa,MAAM,4BAA4B,CAAC;AAE3E,OAAO,EAAE,KAAK,QAAQ,EAAE,KAAK,KAAK,EAAE,MAAM,2BAA2B,CAAC;AAWtE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE7C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAExD,OAAO,EACL,KAAK,oBAAoB,EAE1B,MAAM,oBAAoB,CAAC;AAC5B,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AACjE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AACnE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAExD,KAAK,qBAAqB,CAAC,CAAC,SAAS,QAAQ,EAAE,CAAC,SAAS,KAAK,IAAI;IAChE,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,MAAM,CAAC,OAAO,EAAE,gBAAgB,KAAK,IAAI,CAAC;IACzD,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,cAAc,EAAE,mBAAmB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC;IAC5D,0BAA0B,CAAC,EAAE,mBAAmB,CAC9C,CAAC,EACD,CAAC,CACF,CAAC,4BAA4B,CAAC,CAAC;IAChC,uBAAuB,CAAC,EAAE,mBAAmB,CAC3C,CAAC,EACD,CAAC,CACF,CAAC,yBAAyB,CAAC,CAAC;IAC7B,aAAa,EAAE,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC,eAAe,CAAC,CAAC;IAClE,eAAe,CAAC,EAAE,UAAU,CAAC,OAAO,kBAAkB,CAAC,CAAC,iBAAiB,CAAC,CAAC;IAC3E,aAAa,EAAE,MAAM,aAAa,CAAC;IACnC,SAAS,CAAC,EAAE,SAAS,CAAC;CACvB,CAAC;AAEF,eAAO,MAAM,gBAAgB,GAAI,CAAC,SAAS,QAAQ,EAAE,CAAC,SAAS,KAAK,EAAE,wRAiBnE,qBAAqB,CAAC,CAAC,EAAE,CAAC,CAAC,eAIf,MAAM,WACN,MAAM,EAAE,2BACQ,MAAM,YACrB,oBAAoB,SAkZnC,CAAC"}

package/dist/esm/hooks/use-on-move-columns.js

@@ -8,9 +8,10 @@ import { moveMergedCells } from "../api/merges";
 import { updateRangedRulesOnReorder } from "../api/range-rule-helpers";
 import { shiftTableMovingColumns } from "../api/table";
 import { useCanEditSheet } from "./use-can-edit-cellrange";
+import { resolveMoveReferenceIndex, } from "./use-on-move-rows";
 export const useOnMoveColumns = ({ rowCount, columnCount, locale, createHistory, onChangeSheetData, onChangeSheets, onChangeTables, onChangeConditionalFormats, onChangeDataValidations, enqueueGraphOperation, enqueueCalculation, enqueueStructureChange, getDependents, getDataRowCount, getActiveCell, onCommand, }) => {
     const canEditSheet = useCanEditSheet();
-    return useCallback((sheetId, columns, referenceColumnIndex) => {
+    return useCallback((sheetId, columns, rawReferenceColumnIndex, options) => {
         if (!canEditSheet(sheetId)) {
             console.debug("This range is protected, users cannot edit this cell range.");
             return;
@@ -18,6 +19,10 @@ export const useOnMoveColumns = ({ rowCount, columnCount, locale, createHistory,
         if (!columns.length) {
             return;
         }
+        const referenceColumnIndex = resolveMoveReferenceIndex(columns, rawReferenceColumnIndex, options);
+        if (referenceColumnIndex === undefined) {
+            return;
+        }
         const saveHistory = createHistory();
         const { 0: firstColumn, [columns.length - 1]: lastColumn } = columns;
         // We need to track this for history. Precedent cells
@@ -43,11 +48,15 @@ export const useOnMoveColumns = ({ rowCount, columnCount, locale, createHistory,
             startRowIndex: 1,
             endRowIndex: dataRowCount,
         };
-        // When you move columns, the resident columns
-        // gets shifted
+        // The columns the move displaces (Excel: refs into them shift by ±count). Moving LEFT,
+        // columns `referenceColumnIndex..firstColumn-1` slide right; moving RIGHT, columns
+        // `lastColumn+1..referenceColumnIndex+count-1` slide left (the block lands at
+        // `referenceColumnIndex` in the post-removal frame).
         const shiftedRange = {
-            startColumnIndex: Math.min(referenceColumnIndex + count, firstColumn + count),
-            endColumnIndex: Math.max(referenceColumnIndex + count - 1, firstColumn),
+            startColumnIndex: direction === Direction.Left ? referenceColumnIndex : lastColumn + 1,
+            endColumnIndex: direction === Direction.Left
+                ? firstColumn - 1
+                : referenceColumnIndex + count - 1,
             startRowIndex: 1,
             endRowIndex: dataRowCount,
         };

package/dist/esm/hooks/use-on-move-rows.d.ts

@@ -25,6 +25,21 @@ type UseOnMoveRowsProps<T extends CellData, S extends Sheet> = {
     getActiveCell: () => CellInterface;
     onCommand?: OnCommand;
 };
-export declare const useOnMoveRows: <T extends CellData, S extends Sheet>({ rowCount, columnCount, locale, createHistory, onChangeSheetData, onChangeSheets, onChangeTables, onChangeConditionalFormats, onChangeDataValidations, enqueueGraphOperation, enqueueCalculation, enqueueStructureChange, getDependents, getNonEmptyColumnCount, getActiveCell, onCommand, }: UseOnMoveRowsProps<T, S>) => (sheetId: number, rows: number[], referenceRowIndex: number) => void;
+/**
+ * Landing semantics for a row/column move. By default `referenceIndex` is the block's FINAL
+ * position in the post-removal frame (what the header-drag hook computes). `insertBefore`
+ * selects Excel's "Insert Cut Cells" semantics instead: `referenceIndex` is the row/column the
+ * block is inserted BEFORE in the PRE-removal numbering, so a downward move lands `count` earlier
+ * (cut row 2 → Insert Cut Cells at row 6 lands the row at 5: r1 r3 r4 r5 r2 r6).
+ */
+export type MoveDimensionOptions = {
+    insertBefore?: boolean;
+};
+/**
+ * Translate an Insert-Cut-Cells reference (pre-removal numbering) into the hook's post-removal
+ * landing index. Returns `undefined` when the reference falls inside the moved block (a no-op).
+ */
+export declare const resolveMoveReferenceIndex: (dims: number[], referenceIndex: number, options?: MoveDimensionOptions) => number | undefined;
+export declare const useOnMoveRows: <T extends CellData, S extends Sheet>({ rowCount, columnCount, locale, createHistory, onChangeSheetData, onChangeSheets, onChangeTables, onChangeConditionalFormats, onChangeDataValidations, enqueueGraphOperation, enqueueCalculation, enqueueStructureChange, getDependents, getNonEmptyColumnCount, getActiveCell, onCommand, }: UseOnMoveRowsProps<T, S>) => (sheetId: number, rows: number[], rawReferenceRowIndex: number, options?: MoveDimensionOptions) => void;
 export {};
 //# sourceMappingURL=use-on-move-rows.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"use-on-move-rows.d.ts","sourceRoot":"","sources":["../../../hooks/use-on-move-rows.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAa,MAAM,4BAA4B,CAAC;AAE3E,OAAO,EAAE,KAAK,QAAQ,EAAE,KAAK,KAAK,EAAE,MAAM,2BAA2B,CAAC;AAUtE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE7C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAExD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AACjE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AACnE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAExD,KAAK,kBAAkB,CAAC,CAAC,SAAS,QAAQ,EAAE,CAAC,SAAS,KAAK,IAAI;IAC7D,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,MAAM,CAAC,OAAO,EAAE,gBAAgB,KAAK,IAAI,CAAC;IACzD,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,cAAc,EAAE,mBAAmB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC;IAC5D,mBAAmB,EAAE,mBAAmB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,qBAAqB,CAAC,CAAC;IACtE,0BAA0B,CAAC,EAAE,mBAAmB,CAC9C,CAAC,EACD,CAAC,CACF,CAAC,4BAA4B,CAAC,CAAC;IAChC,uBAAuB,CAAC,EAAE,mBAAmB,CAC3C,CAAC,EACD,CAAC,CACF,CAAC,yBAAyB,CAAC,CAAC;IAC7B,aAAa,EAAE,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC,eAAe,CAAC,CAAC;IAClE,eAAe,CAAC,EAAE,UAAU,CAAC,OAAO,kBAAkB,CAAC,CAAC,iBAAiB,CAAC,CAAC;IAC3E,sBAAsB,CAAC,EAAE,UAAU,CACjC,OAAO,kBAAkB,CAC1B,CAAC,wBAAwB,CAAC,CAAC;IAC5B,aAAa,EAAE,MAAM,aAAa,CAAC;IACnC,SAAS,CAAC,EAAE,SAAS,CAAC;CACvB,CAAC;AAEF,eAAO,MAAM,aAAa,GAAI,CAAC,SAAS,QAAQ,EAAE,CAAC,SAAS,KAAK,EAAE,+RAiBhE,kBAAkB,CAAC,CAAC,EAAE,CAAC,CAAC,eAGb,MAAM,QAAQ,MAAM,EAAE,qBAAqB,MAAM,SA2U9D,CAAC"}
+{"version":3,"file":"use-on-move-rows.d.ts","sourceRoot":"","sources":["../../../hooks/use-on-move-rows.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAa,MAAM,4BAA4B,CAAC;AAE3E,OAAO,EAAE,KAAK,QAAQ,EAAE,KAAK,KAAK,EAAE,MAAM,2BAA2B,CAAC;AAUtE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE7C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAExD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AACjE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AACnE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAExD,KAAK,kBAAkB,CAAC,CAAC,SAAS,QAAQ,EAAE,CAAC,SAAS,KAAK,IAAI;IAC7D,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,MAAM,CAAC,OAAO,EAAE,gBAAgB,KAAK,IAAI,CAAC;IACzD,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,cAAc,EAAE,mBAAmB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC;IAC5D,mBAAmB,EAAE,mBAAmB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,qBAAqB,CAAC,CAAC;IACtE,0BAA0B,CAAC,EAAE,mBAAmB,CAC9C,CAAC,EACD,CAAC,CACF,CAAC,4BAA4B,CAAC,CAAC;IAChC,uBAAuB,CAAC,EAAE,mBAAmB,CAC3C,CAAC,EACD,CAAC,CACF,CAAC,yBAAyB,CAAC,CAAC;IAC7B,aAAa,EAAE,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC,eAAe,CAAC,CAAC;IAClE,eAAe,CAAC,EAAE,UAAU,CAAC,OAAO,kBAAkB,CAAC,CAAC,iBAAiB,CAAC,CAAC;IAC3E,sBAAsB,CAAC,EAAE,UAAU,CACjC,OAAO,kBAAkB,CAC1B,CAAC,wBAAwB,CAAC,CAAC;IAC5B,aAAa,EAAE,MAAM,aAAa,CAAC;IACnC,SAAS,CAAC,EAAE,SAAS,CAAC;CACvB,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,MAAM,oBAAoB,GAAG;IACjC,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,yBAAyB,GACpC,MAAM,MAAM,EAAE,EACd,gBAAgB,MAAM,EACtB,UAAU,oBAAoB,KAC7B,MAAM,GAAG,SAYX,CAAC;AAEF,eAAO,MAAM,aAAa,GAAI,CAAC,SAAS,QAAQ,EAAE,CAAC,SAAS,KAAK,EAAE,+RAiBhE,kBAAkB,CAAC,CAAC,EAAE,CAAC,CAAC,eAIZ,MAAM,QACT,MAAM,EAAE,wBACQ,MAAM,YAClB,oBAAoB,SA0VnC,CAAC"}

package/dist/esm/hooks/use-on-move-rows.js

@@ -8,9 +8,26 @@ import { moveMergedCells } from "../api/merges";
 import { updateRangedRulesOnReorder } from "../api/range-rule-helpers";
 import { shiftTableMovingRows } from "../api/table";
 import { useCanEditSheet } from "./use-can-edit-cellrange";
+/**
+ * Translate an Insert-Cut-Cells reference (pre-removal numbering) into the hook's post-removal
+ * landing index. Returns `undefined` when the reference falls inside the moved block (a no-op).
+ */
+export const resolveMoveReferenceIndex = (dims, referenceIndex, options) => {
+    if (!options?.insertBefore) {
+        return referenceIndex;
+    }
+    const { 0: first, [dims.length - 1]: last } = dims;
+    if (referenceIndex > last) {
+        return referenceIndex - dims.length;
+    }
+    if (referenceIndex > first) {
+        return undefined;
+    }
+    return referenceIndex;
+};
 export const useOnMoveRows = ({ rowCount, columnCount, locale, createHistory, onChangeSheetData, onChangeSheets, onChangeTables, onChangeConditionalFormats, onChangeDataValidations, enqueueGraphOperation, enqueueCalculation, enqueueStructureChange, getDependents, getNonEmptyColumnCount, getActiveCell, onCommand, }) => {
     const canEditSheet = useCanEditSheet();
-    return useCallback((sheetId, rows, referenceRowIndex) => {
+    return useCallback((sheetId, rows, rawReferenceRowIndex, options) => {
         if (!canEditSheet(sheetId)) {
             console.debug("This range is protected, users cannot edit this cell range.");
             return;
@@ -18,6 +35,10 @@ export const useOnMoveRows = ({ rowCount, columnCount, locale, createHistory, on
         if (!rows.length) {
             return;
         }
+        const referenceRowIndex = resolveMoveReferenceIndex(rows, rawReferenceRowIndex, options);
+        if (referenceRowIndex === undefined) {
+            return;
+        }
         const saveHistory = createHistory();
         const { 0: firstRow, [rows.length - 1]: lastRow } = rows;
         // We need to track this for history. Precedent cells
@@ -118,13 +139,17 @@ export const useOnMoveRows = ({ rowCount, columnCount, locale, createHistory, on
                         columnCount,
                     });
                 }
-                // When you move columns, the resident columns
-                // gets shifted
+                // The rows the move displaces (Excel: refs into them shift by ±count). Moving UP,
+                // rows `referenceRowIndex..firstRow-1` slide down; moving DOWN, rows
+                // `lastRow+1..referenceRowIndex+count-1` slide up (the block lands at
+                // `referenceRowIndex` in the post-removal frame).
                 const shiftedRange = {
                     startColumnIndex: 1,
                     endColumnIndex: columnCount,
-                    startRowIndex: Math.min(referenceRowIndex + count, firstRow),
-                    endRowIndex: Math.max(referenceRowIndex - count, firstRow),
+                    startRowIndex: direction === Direction.Left ? referenceRowIndex : lastRow + 1,
+                    endRowIndex: direction === Direction.Left
+                        ? firstRow - 1
+                        : referenceRowIndex + count - 1,
                 };
                 // Update formulas
                 for (const [rowIndex, columnIndex] of iterateCellsInRange({

package/dist/esm/hooks/use-on-move-selection.d.ts

@@ -1,4 +1,4 @@
-import type { CellInterface, SelectionArea } from "@rowsncolumns/common-types";
+import type { CellInterface, GridRange, SelectionArea } from "@rowsncolumns/common-types";
 import type { CellData, SelectionAttributes, Sheet, TableView } from "@rowsncolumns/spreadsheet";
 import type { OnCommand } from "../commands";
 import type { CalculationOperation, useCalculation } from "./use-calculation";
@@ -29,7 +29,12 @@ export type UseOnMoveSelectionProps<T extends CellData, S extends Sheet> = {
     onChangePivotTables?: UseSpreadsheetProps<T, S>["onChangePivotTables"];
     getDependents: ReturnType<typeof useCalculation>["getDependents"];
     getActiveCell: () => CellInterface;
+    /**
+     * Merged ranges of a sheet — a drag-move whose destination (or source) covers a merge only
+     * partially is refused, like Excel ("We can't do that to a merged cell.").
+     */
+    getSheetMerges?: (sheetId: number) => GridRange[] | undefined | null;
     onCommand?: OnCommand;
 };
-export declare const useOnMoveSelection: <T extends CellData, S extends Sheet>({ rowCount, columnCount, tables, locale, cellXfsRegistry, sharedStringRegistry, getDependents, getActiveCell, onChangeTables, onChangeSheets, onChangeNamedRanges, onChangeDataValidations, onChangeConditionalFormats, onChangePivotTables, onChangeSheetData, createHistory, enqueueGraphOperation, enqueueCalculation, enqueueStructureChange, isArrayFormula, getDataValidationById, onCommand, }: UseOnMoveSelectionProps<T, S>) => (sheetId: number, from: SelectionArea<SelectionAttributes>, to: SelectionArea<SelectionAttributes>) => void;
+export declare const useOnMoveSelection: <T extends CellData, S extends Sheet>({ rowCount, columnCount, tables, locale, cellXfsRegistry, sharedStringRegistry, getDependents, getActiveCell, onChangeTables, onChangeSheets, onChangeNamedRanges, onChangeDataValidations, onChangeConditionalFormats, onChangePivotTables, onChangeSheetData, createHistory, enqueueGraphOperation, enqueueCalculation, enqueueStructureChange, isArrayFormula, getDataValidationById, getSheetMerges, onCommand, }: UseOnMoveSelectionProps<T, S>) => (sheetId: number, from: SelectionArea<SelectionAttributes>, to: SelectionArea<SelectionAttributes>) => void;
 //# sourceMappingURL=use-on-move-selection.d.ts.map