@rowsncolumns/spreadsheet-state 28.0.74 → 28.0.76

package/dist/cjs/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/cjs/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/cjs/hooks/use-on-delete-row.js

@@ -1,9 +1,9 @@
 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 var useOnDeleteRow = function (_a) {
-    var rowCount = _a.rowCount, columnCount = _a.columnCount, locale = _a.locale, cellXfsRegistry = _a.cellXfsRegistry, sharedStringRegistry = _a.sharedStringRegistry, getActiveCell = _a.getActiveCell, getSelections = _a.getSelections, getDependents = _a.getDependents, getGraphNodes = _a.getGraphNodes, getGraphNodesInSheet = _a.getGraphNodesInSheet, createHistory = _a.createHistory, enqueueGraphOperation = _a.enqueueGraphOperation, enqueueCalculation = _a.enqueueCalculation, enqueueStructureChange = _a.enqueueStructureChange, onChangeSheetData = _a.onChangeSheetData, onChangeSheets = _a.onChangeSheets, onChangeTables = _a.onChangeTables, onChangeActiveCell = _a.onChangeActiveCell, onChangeSelections = _a.onChangeSelections, onChangeConditionalFormats = _a.onChangeConditionalFormats, onChangeDataValidations = _a.onChangeDataValidations, onChangeCitations = _a.onChangeCitations, onChangePivotTables = _a.onChangePivotTables, getSheetName = _a.getSheetName, onCommand = _a.onCommand;
+    var rowCount = _a.rowCount, columnCount = _a.columnCount, locale = _a.locale, cellXfsRegistry = _a.cellXfsRegistry, sharedStringRegistry = _a.sharedStringRegistry, getActiveCell = _a.getActiveCell, getSelections = _a.getSelections, getDependents = _a.getDependents, getGraphNodes = _a.getGraphNodes, getGraphNodesInSheet = _a.getGraphNodesInSheet, createHistory = _a.createHistory, enqueueGraphOperation = _a.enqueueGraphOperation, enqueueCalculation = _a.enqueueCalculation, enqueueStructureChange = _a.enqueueStructureChange, onChangeSheetData = _a.onChangeSheetData, onChangeSheets = _a.onChangeSheets, onChangeTables = _a.onChangeTables, onChangeActiveCell = _a.onChangeActiveCell, onChangeSelections = _a.onChangeSelections, onChangeConditionalFormats = _a.onChangeConditionalFormats, onChangeDataValidations = _a.onChangeDataValidations, onChangeCitations = _a.onChangeCitations, onChangePivotTables = _a.onChangePivotTables, onChangeNamedRanges = _a.onChangeNamedRanges, onChangeEmbeds = _a.onChangeEmbeds, onChangeCharts = _a.onChangeCharts, onChangeProtectedRanges = _a.onChangeProtectedRanges, getSheetName = _a.getSheetName, onCommand = _a.onCommand, tables = _a.tables, getArrayRange = _a.getArrayRange;
     var canEditSheet = useCanEditSheet();
     var canPerformSheetAction = useCanPerformSheetAction();
     var showError = useShowError();
@@ -47,7 +47,13 @@ export var useOnDeleteRow = function (_a) {
             onChangeDataValidations: onChangeDataValidations,
             onChangeCitations: onChangeCitations,
             onChangePivotTables: onChangePivotTables,
+            onChangeNamedRanges: onChangeNamedRanges,
+            onChangeEmbeds: onChangeEmbeds,
+            onChangeCharts: onChangeCharts,
+            onChangeProtectedRanges: onChangeProtectedRanges,
             getSheetName: getSheetName,
+            tables: tables,
+            getArrayRange: getArrayRange,
         })(sheetId, rowIndexes);
         onCommand === null || onCommand === void 0 ? void 0 : onCommand({
             command: "delete-row",
@@ -78,10 +84,16 @@ export var useOnDeleteRow = function (_a) {
         onChangeDataValidations,
         onChangeCitations,
         onChangePivotTables,
+        onChangeNamedRanges,
+        onChangeEmbeds,
+        onChangeCharts,
+        onChangeProtectedRanges,
         canEditSheet,
         canPerformSheetAction,
         showError,
         getSheetName,
         onCommand,
+        tables,
+        getArrayRange,
     ]);
 };

package/dist/cjs/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/cjs/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/cjs/hooks/use-on-fill.js

@@ -1,16 +1,23 @@
 import { __awaiter, __generator, __read } from "tslib";
 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 var useOnFill = function (_a) {
-    var locale = _a.locale, cellXfsRegistry = _a.cellXfsRegistry, sharedStringRegistry = _a.sharedStringRegistry, getCellData = _a.getCellData, getDataValidationById = _a.getDataValidationById, getEffectiveValue = _a.getEffectiveValue, getFormattedValue = _a.getFormattedValue, getAutoFillValues = _a.getAutoFillValues, getSheetName = _a.getSheetName, enqueueCalculation = _a.enqueueCalculation, enqueueStructureChange = _a.enqueueStructureChange, onChangeSheetData = _a.onChangeSheetData, onChangeDataValidations = _a.onChangeDataValidations, createHistory = _a.createHistory, onCommand = _a.onCommand;
+    var locale = _a.locale, cellXfsRegistry = _a.cellXfsRegistry, sharedStringRegistry = _a.sharedStringRegistry, getCellData = _a.getCellData, getDataValidationById = _a.getDataValidationById, getEffectiveValue = _a.getEffectiveValue, getFormattedValue = _a.getFormattedValue, getAutoFillValues = _a.getAutoFillValues, getSheetName = _a.getSheetName, enqueueCalculation = _a.enqueueCalculation, enqueueStructureChange = _a.enqueueStructureChange, onChangeSheetData = _a.onChangeSheetData, onChangeDataValidations = _a.onChangeDataValidations, createHistory = _a.createHistory, onCommand = _a.onCommand, getMerges = _a.getMerges, onFillMerges = _a.onFillMerges;
     var canEditCellRange = useCanEditCellRange();
     var _b = __read(useLoadingIndicator(), 2), showLoader = _b[0], hideLoader = _b[1];
-    return useCallback(function (sheetId, activeCell, fillSelection, selections, fillableSelections, fillType) { return __awaiter(void 0, void 0, void 0, function () {
+    return useCallback(function (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) { return __awaiter(void 0, void 0, void 0, function () {
+        var resolvedFillType, err_1;
         return __generator(this, function (_a) {
             switch (_a.label) {
                 case 0:
+                    resolvedFillType = fillType !== null && fillType !== void 0 ? fillType : options === null || options === void 0 ? void 0 : options.fillType;
                     if (!canEditCellRange(sheetId, fillSelection.range)) {
                         console.debug("This range is protected, users cannot edit this cell range.");
                         return [2 /*return*/];
@@ -19,7 +26,7 @@ export var useOnFill = function (_a) {
                     showLoader();
                     _a.label = 1;
                 case 1:
-                    _a.trys.push([1, , 3, 4]);
+                    _a.trys.push([1, 3, 4, 5]);
                     return [4 /*yield*/, applyFill({
                             locale: locale,
                             cellXfsRegistry: cellXfsRegistry,
@@ -35,14 +42,24 @@ export var useOnFill = function (_a) {
                             onChangeSheetData: onChangeSheetData,
                             onChangeDataValidations: onChangeDataValidations,
                             createHistory: createHistory,
-                        })(sheetId, activeCell, fillSelection, selections, fillableSelections, fillType)];
+                            getMerges: getMerges,
+                            onFillMerges: onFillMerges,
+                        })(sheetId, activeCell, fillSelection, selections, fillableSelections, resolvedFillType, options)];
                 case 2:
                     _a.sent();
-                    return [3 /*break*/, 4];
+                    return [3 /*break*/, 5];
                 case 3:
+                    err_1 = _a.sent();
+                    // Excel refuses a fill whose source mixes unequal merged blocks; nothing was written.
+                    if (err_1 instanceof MergedFillSizeError) {
+                        error(err_1.message);
+                        return [2 /*return*/];
+                    }
+                    throw err_1;
+                case 4:
                     hideLoader();
                     return [7 /*endfinally*/];
-                case 4:
+                case 5:
                     onCommand === null || onCommand === void 0 ? void 0 : onCommand({
                         command: "fill",
                         sheetId: sheetId,
@@ -50,7 +67,9 @@ export var useOnFill = function (_a) {
                         fillSelection: fillSelection,
                         selections: selections,
                         fillableSelections: fillableSelections,
-                        fillType: fillType,
+                        fillType: resolvedFillType,
+                        modifier: options === null || options === void 0 ? void 0 : options.modifier,
+                        series: options === null || options === void 0 ? void 0 : options.series,
                     });
                     return [2 /*return*/];
             }
@@ -74,5 +93,7 @@ export var useOnFill = function (_a) {
         onChangeDataValidations,
         getSheetName,
         onCommand,
+        getMerges,
+        onFillMerges,
     ]);
 };

package/dist/cjs/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/cjs/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/cjs/hooks/use-on-insert-cells-shift-down.js

@@ -1,13 +1,15 @@
 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 var useOnInsertCellsShiftDown = function (_a) {
-    var rowCount = _a.rowCount, columnCount = _a.columnCount, locale = _a.locale, cellXfsRegistry = _a.cellXfsRegistry, sharedStringRegistry = _a.sharedStringRegistry, getActiveCell = _a.getActiveCell, getSelections = _a.getSelections, getDependents = _a.getDependents, createHistory = _a.createHistory, enqueueGraphOperation = _a.enqueueGraphOperation, enqueueCalculation = _a.enqueueCalculation, enqueueStructureChange = _a.enqueueStructureChange, onChangeSheetData = _a.onChangeSheetData, onChangeSheets = _a.onChangeSheets, onChangeCitations = _a.onChangeCitations, onCommand = _a.onCommand;
+    var rowCount = _a.rowCount, columnCount = _a.columnCount, locale = _a.locale, cellXfsRegistry = _a.cellXfsRegistry, sharedStringRegistry = _a.sharedStringRegistry, getActiveCell = _a.getActiveCell, getSelections = _a.getSelections, getDependents = _a.getDependents, createHistory = _a.createHistory, enqueueGraphOperation = _a.enqueueGraphOperation, enqueueCalculation = _a.enqueueCalculation, enqueueStructureChange = _a.enqueueStructureChange, onChangeSheetData = _a.onChangeSheetData, onChangeSheets = _a.onChangeSheets, onChangeCitations = _a.onChangeCitations, onChangeTables = _a.onChangeTables, onCommand = _a.onCommand, sheetData = _a.sheetData, sheets = _a.sheets, tables = _a.tables, getArrayRanges = _a.getArrayRanges, getSheetName = _a.getSheetName;
     var canEditCellRange = useCanEditCellRange();
     var canPerformSheetAction = useCanPerformSheetAction();
     var showError = useShowError();
     return useCallback(function (sheetId, activeCell, selections) {
+        var _a;
         if (!canPerformSheetAction(sheetId, "insertRows")) {
             showError({
                 title: SHEET_PROTECTION_ERROR_TITLE,
@@ -19,6 +21,21 @@ export var useOnInsertCellsShiftDown = function (_a) {
             console.debug("This range is protected, users cannot edit this cell range.");
             return;
         }
+        var selection = resolveShiftSelection(activeCell, selections);
+        var refusal = getShiftCellsRefusal({
+            direction: "down",
+            range: selection.range,
+            sheetId: sheetId,
+            rows: sheetData === null || sheetData === void 0 ? void 0 : sheetData[sheetId],
+            rowCount: rowCount,
+            merges: (_a = sheets === null || sheets === void 0 ? void 0 : sheets.find(function (sheet) { return sheet.sheetId === sheetId; })) === null || _a === void 0 ? void 0 : _a.merges,
+            tables: tables,
+            arrayRanges: getArrayRanges === null || getArrayRanges === void 0 ? void 0 : getArrayRanges(sheetId),
+        });
+        if (refusal) {
+            showError({ title: refusal.title, message: refusal.message });
+            return;
+        }
         insertCellsShiftDown({
             rowCount: rowCount,
             columnCount: columnCount,
@@ -35,6 +52,8 @@ export var useOnInsertCellsShiftDown = function (_a) {
             onChangeSheetData: onChangeSheetData,
             onChangeSheets: onChangeSheets,
             onChangeCitations: onChangeCitations,
+            onChangeTables: onChangeTables,
+            getSheetName: getSheetName,
         })(sheetId, activeCell, selections);
         onCommand === null || onCommand === void 0 ? void 0 : onCommand({
             command: "insert-cells-shift-down",
@@ -62,5 +81,11 @@ export var useOnInsertCellsShiftDown = function (_a) {
         canPerformSheetAction,
         showError,
         onCommand,
+        onChangeTables,
+        sheetData,
+        sheets,
+        tables,
+        getArrayRanges,
+        getSheetName,
     ]);
 };

package/dist/cjs/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/cjs/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/cjs/hooks/use-on-insert-cells-shift-right.js

@@ -1,13 +1,15 @@
 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 var useOnInsertCellsShiftRight = function (_a) {
-    var rowCount = _a.rowCount, columnCount = _a.columnCount, locale = _a.locale, cellXfsRegistry = _a.cellXfsRegistry, sharedStringRegistry = _a.sharedStringRegistry, getActiveCell = _a.getActiveCell, getSelections = _a.getSelections, getDependents = _a.getDependents, createHistory = _a.createHistory, enqueueGraphOperation = _a.enqueueGraphOperation, enqueueCalculation = _a.enqueueCalculation, enqueueStructureChange = _a.enqueueStructureChange, onChangeSheetData = _a.onChangeSheetData, onChangeSheets = _a.onChangeSheets, onChangeCitations = _a.onChangeCitations, onCommand = _a.onCommand;
+    var rowCount = _a.rowCount, columnCount = _a.columnCount, locale = _a.locale, cellXfsRegistry = _a.cellXfsRegistry, sharedStringRegistry = _a.sharedStringRegistry, getActiveCell = _a.getActiveCell, getSelections = _a.getSelections, getDependents = _a.getDependents, createHistory = _a.createHistory, enqueueGraphOperation = _a.enqueueGraphOperation, enqueueCalculation = _a.enqueueCalculation, enqueueStructureChange = _a.enqueueStructureChange, onChangeSheetData = _a.onChangeSheetData, onChangeSheets = _a.onChangeSheets, onChangeCitations = _a.onChangeCitations, onChangeTables = _a.onChangeTables, onCommand = _a.onCommand, sheetData = _a.sheetData, sheets = _a.sheets, tables = _a.tables, getArrayRanges = _a.getArrayRanges, getSheetName = _a.getSheetName;
     var canEditCellRange = useCanEditCellRange();
     var canPerformSheetAction = useCanPerformSheetAction();
     var showError = useShowError();
     return useCallback(function (sheetId, activeCell, selections) {
+        var _a;
         if (!canPerformSheetAction(sheetId, "insertColumns")) {
             showError({
                 title: SHEET_PROTECTION_ERROR_TITLE,
@@ -19,6 +21,21 @@ export var useOnInsertCellsShiftRight = function (_a) {
             console.debug("This range is protected, users cannot edit this cell range.");
             return;
         }
+        var selection = resolveShiftSelection(activeCell, selections);
+        var refusal = getShiftCellsRefusal({
+            direction: "right",
+            range: selection.range,
+            sheetId: sheetId,
+            rows: sheetData === null || sheetData === void 0 ? void 0 : sheetData[sheetId],
+            columnCount: columnCount,
+            merges: (_a = sheets === null || sheets === void 0 ? void 0 : sheets.find(function (sheet) { return sheet.sheetId === sheetId; })) === null || _a === void 0 ? void 0 : _a.merges,
+            tables: tables,
+            arrayRanges: getArrayRanges === null || getArrayRanges === void 0 ? void 0 : getArrayRanges(sheetId),
+        });
+        if (refusal) {
+            showError({ title: refusal.title, message: refusal.message });
+            return;
+        }
         insertCellsShiftRight({
             rowCount: rowCount,
             columnCount: columnCount,
@@ -35,6 +52,8 @@ export var useOnInsertCellsShiftRight = function (_a) {
             onChangeSheetData: onChangeSheetData,
             onChangeSheets: onChangeSheets,
             onChangeCitations: onChangeCitations,
+            onChangeTables: onChangeTables,
+            getSheetName: getSheetName,
         })(sheetId, activeCell, selections);
         onCommand === null || onCommand === void 0 ? void 0 : onCommand({
             command: "insert-cells-shift-right",
@@ -62,5 +81,11 @@ export var useOnInsertCellsShiftRight = function (_a) {
         canPerformSheetAction,
         showError,
         onCommand,
+        onChangeTables,
+        sheetData,
+        sheets,
+        tables,
+        getArrayRanges,
+        getSheetName,
     ]);
 };

package/dist/cjs/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/cjs/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":"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"}
+{"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/cjs/hooks/use-on-insert-column.js

@@ -1,10 +1,11 @@
 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 var useOnInsertColumn = function (_a) {
-    var rowCount = _a.rowCount, columnCount = _a.columnCount, locale = _a.locale, tables = _a.tables, maxColumnCount = _a.maxColumnCount, cellXfsRegistry = _a.cellXfsRegistry, sharedStringRegistry = _a.sharedStringRegistry, getDependents = _a.getDependents, getGraphNodes = _a.getGraphNodes, getGraphNodesInSheet = _a.getGraphNodesInSheet, createHistory = _a.createHistory, enqueueGraphOperation = _a.enqueueGraphOperation, enqueueCalculation = _a.enqueueCalculation, enqueueStructureChange = _a.enqueueStructureChange, onChangeSheetData = _a.onChangeSheetData, onChangeSheets = _a.onChangeSheets, onChangeTables = _a.onChangeTables, onChangeConditionalFormats = _a.onChangeConditionalFormats, onChangeDataValidations = _a.onChangeDataValidations, onChangeCitations = _a.onChangeCitations, onChangePivotTables = _a.onChangePivotTables, getActiveCell = _a.getActiveCell, getSelections = _a.getSelections, getSheetName = _a.getSheetName, onCommand = _a.onCommand, generatedNames = _a.generatedNames;
+    var rowCount = _a.rowCount, columnCount = _a.columnCount, locale = _a.locale, tables = _a.tables, maxColumnCount = _a.maxColumnCount, cellXfsRegistry = _a.cellXfsRegistry, sharedStringRegistry = _a.sharedStringRegistry, getDependents = _a.getDependents, getGraphNodes = _a.getGraphNodes, getGraphNodesInSheet = _a.getGraphNodesInSheet, createHistory = _a.createHistory, enqueueGraphOperation = _a.enqueueGraphOperation, enqueueCalculation = _a.enqueueCalculation, enqueueStructureChange = _a.enqueueStructureChange, onChangeSheetData = _a.onChangeSheetData, onChangeSheets = _a.onChangeSheets, onChangeTables = _a.onChangeTables, onChangeConditionalFormats = _a.onChangeConditionalFormats, onChangeDataValidations = _a.onChangeDataValidations, onChangeCitations = _a.onChangeCitations, onChangePivotTables = _a.onChangePivotTables, onChangeNamedRanges = _a.onChangeNamedRanges, onChangeEmbeds = _a.onChangeEmbeds, onChangeCharts = _a.onChangeCharts, onChangeProtectedRanges = _a.onChangeProtectedRanges, getActiveCell = _a.getActiveCell, getSelections = _a.getSelections, getSheetName = _a.getSheetName, onCommand = _a.onCommand, generatedNames = _a.generatedNames, sheetData = _a.sheetData;
     var canEditSheet = useCanEditSheet();
     var canPerformSheetAction = useCanPerformSheetAction();
     var showError = useShowError();
@@ -21,17 +22,33 @@ export var useOnInsertColumn = function (_a) {
             });
             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.
+            var 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: rowCount,
             columnCount: columnCount,
             locale: locale,
+            maxColumnCount: maxColumnCount,
             tables: tables,
             cellXfsRegistry: cellXfsRegistry,
             sharedStringRegistry: sharedStringRegistry,
@@ -49,6 +66,10 @@ export var useOnInsertColumn = function (_a) {
             onChangeDataValidations: onChangeDataValidations,
             onChangeCitations: onChangeCitations,
             onChangePivotTables: onChangePivotTables,
+            onChangeNamedRanges: onChangeNamedRanges,
+            onChangeEmbeds: onChangeEmbeds,
+            onChangeCharts: onChangeCharts,
+            onChangeProtectedRanges: onChangeProtectedRanges,
             getActiveCell: getActiveCell,
             getSelections: getSelections,
             getSheetName: getSheetName,
@@ -84,10 +105,15 @@ export var useOnInsertColumn = function (_a) {
         onChangeConditionalFormats,
         onChangeDataValidations,
         onChangePivotTables,
+        onChangeNamedRanges,
+        onChangeEmbeds,
+        onChangeCharts,
+        onChangeProtectedRanges,
         canEditSheet,
         canPerformSheetAction,
         getSheetName,
         onCommand,
         generatedNames,
+        sheetData,
     ]);
 };

package/dist/cjs/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