@rowsncolumns/spreadsheet-state 28.0.75 → 28.0.76

package/dist/cjs/interface/delete-row.js

@@ -1,14 +1,17 @@
-import { __assign, __read, __spreadArray, __values } from "tslib";
+import { __assign, __read, __spreadArray } from "tslib";
 import { Direction } from "@rowsncolumns/common-types";
 import { produceWithPatches } from "immer";
+import { shiftChartsOnStructuralChange, shiftEmbedsOnStructuralChange, shiftProtectedRangesOnStructuralChange, } from "../api/anchored-objects";
 import { shrinkMergesOnRowDelete } from "../api/merges";
+import { updateNamedRangesOnStructuralChange, updatePrintSettingsOnStructuralChange, } from "../api/named-range-structural";
 import { shiftPivotsOnDelete } from "../api/pivot-range";
-import { updateRangedRulesOnStructuralChange } from "../api/range-rule-helpers";
 import { updateSheetRangeOnDelete } from "../api/range";
+import { updateRangedRulesOnStructuralChange } from "../api/range-rule-helpers";
 import { moveFilterView } from "../api/selection";
 import { updateFormulasForStructuralChange } from "../api/structural-formula-update";
+import { breakStructuredRefsForRemovedTableParts, collectRemovedTableParts, removeSpillsOfDeletedAnchors, } from "../api/structural-table-refs";
 export var deleteRow = function (_a) {
-    var rowCount = _a.rowCount, columnCount = _a.columnCount, locale = _a.locale, cellXfsRegistry = _a.cellXfsRegistry, sharedStringRegistry = _a.sharedStringRegistry, getSheetName = _a.getSheetName, 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;
+    var rowCount = _a.rowCount, columnCount = _a.columnCount, locale = _a.locale, cellXfsRegistry = _a.cellXfsRegistry, sharedStringRegistry = _a.sharedStringRegistry, getSheetName = _a.getSheetName, 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, tables = _a.tables, getArrayRange = _a.getArrayRange, onChangeNamedRanges = _a.onChangeNamedRanges, onChangeEmbeds = _a.onChangeEmbeds, onChangeCharts = _a.onChangeCharts, onChangeProtectedRanges = _a.onChangeProtectedRanges;
     return function (sheetId, rowIndexes) {
         if (!rowIndexes.length)
             return;
@@ -84,7 +87,7 @@ export var deleteRow = function (_a) {
         // Data validations
         onChangeDataValidations === null || onChangeDataValidations === void 0 ? void 0 : onChangeDataValidations(function (prevValidations) {
             var _a = __read(produceWithPatches(prevValidations, function (draft) {
-                updateRangedRulesOnStructuralChange(draft, "delete", "row", minRowIndex, count, sheetId);
+                updateRangedRulesOnStructuralChange(draft, "delete", "row", minRowIndex, count, sheetId, { getSheetName: getSheetName });
             }), 3), nextState = _a[0], patches = _a[1], inversePatches = _a[2];
             saveHistory({ dataValidations: { patches: patches, inversePatches: inversePatches } });
             return nextState;
@@ -92,11 +95,20 @@ export var deleteRow = function (_a) {
         // Conditional formats
         onChangeConditionalFormats === null || onChangeConditionalFormats === void 0 ? void 0 : onChangeConditionalFormats(function (prevConditionalFormats) {
             var _a = __read(produceWithPatches(prevConditionalFormats, function (draft) {
-                updateRangedRulesOnStructuralChange(draft, "delete", "row", minRowIndex, count, sheetId);
+                updateRangedRulesOnStructuralChange(draft, "delete", "row", minRowIndex, count, sheetId, { getSheetName: getSheetName });
             }), 3), nextState = _a[0], patches = _a[1], inversePatches = _a[2];
             saveHistory({ conditionalFormats: { patches: patches, inversePatches: inversePatches } });
             return nextState;
         });
+        // Defined names: shift back / shrink; a name whose whole range is
+        // deleted is kept as `#REF!` so its users evaluate `#REF!`, like Excel.
+        onChangeNamedRanges === null || onChangeNamedRanges === void 0 ? void 0 : onChangeNamedRanges(function (prevNamedRanges) {
+            var _a = __read(produceWithPatches(prevNamedRanges, function (draft) {
+                updateNamedRangesOnStructuralChange(draft, "row", "delete", minRowIndex, count, sheetId);
+            }), 3), nextState = _a[0], patches = _a[1], inversePatches = _a[2];
+            saveHistory({ namedRanges: { patches: patches, inversePatches: inversePatches } });
+            return nextState;
+        });
         // Shift pivot tables: ranges shrink/shift; targetPosition anchors to
         // the start of the deletion when its row falls inside the deletion.
         onChangePivotTables === null || onChangePivotTables === void 0 ? void 0 : onChangePivotTables(function (prevPivots) {
@@ -129,11 +141,35 @@ export var deleteRow = function (_a) {
             saveHistory({ citations: { patches: patches, inversePatches: inversePatches } });
             return nextState;
         });
+        // Anchored objects (Excel ANC rules): floating charts / embeds move with
+        // their anchor cell, chart series ranges and AllowEditRange rectangles
+        // shift like references. Frozen panes are a positional viewport split
+        // and are deliberately NOT touched here.
+        onChangeEmbeds === null || onChangeEmbeds === void 0 ? void 0 : onChangeEmbeds(function (prevEmbeds) {
+            var _a = __read(produceWithPatches(prevEmbeds, function (draft) {
+                shiftEmbedsOnStructuralChange(draft, sheetId, "row", "delete", minRowIndex, count);
+            }), 3), nextState = _a[0], patches = _a[1], inversePatches = _a[2];
+            saveHistory({ embeds: { patches: patches, inversePatches: inversePatches } });
+            return nextState;
+        });
+        onChangeCharts === null || onChangeCharts === void 0 ? void 0 : onChangeCharts(function (prevCharts) {
+            var _a = __read(produceWithPatches(prevCharts, function (draft) {
+                shiftChartsOnStructuralChange(draft, sheetId, "row", "delete", minRowIndex, count);
+            }), 3), nextState = _a[0], patches = _a[1], inversePatches = _a[2];
+            saveHistory({ charts: { patches: patches, inversePatches: inversePatches } });
+            return nextState;
+        });
+        onChangeProtectedRanges === null || onChangeProtectedRanges === void 0 ? void 0 : onChangeProtectedRanges(function (prevProtectedRanges) {
+            var _a = __read(produceWithPatches(prevProtectedRanges, function (draft) {
+                shiftProtectedRangesOnStructuralChange(draft, sheetId, "row", "delete", minRowIndex, count);
+            }), 3), nextState = _a[0], patches = _a[1], inversePatches = _a[2];
+            saveHistory({ protectedRanges: { patches: patches, inversePatches: inversePatches } });
+            return nextState;
+        });
         // Sheet metadata
         onChangeSheets === null || onChangeSheets === void 0 ? void 0 : onChangeSheets(function (prevSheets) {
             var _a = __read(produceWithPatches(prevSheets, function (draft) {
-                var e_1, _a;
-                var _b;
+                var _a;
                 var sheet = draft.find(function (sheet) { return sheet.sheetId === sheetId; });
                 if (!sheet)
                     return;
@@ -141,7 +177,7 @@ export var deleteRow = function (_a) {
                     sheet.rowMetadata.splice(minRowIndex, count);
                 }
                 if (sheet.basicFilter) {
-                    var _c = sheet.basicFilter.range, startRowIndex = _c.startRowIndex, endRowIndex = _c.endRowIndex;
+                    var _b = sheet.basicFilter.range, startRowIndex = _b.startRowIndex, endRowIndex = _b.endRowIndex;
                     if (minRowIndex < startRowIndex) {
                         moveFilterView(sheet.basicFilter, count, Direction.Up);
                     }
@@ -154,35 +190,58 @@ export var deleteRow = function (_a) {
                         delete sheet.basicFilter;
                     }
                 }
-                if (sheet.frozenRowCount) {
-                    try {
-                        for (var sortedRowIndexes_1 = __values(sortedRowIndexes), sortedRowIndexes_1_1 = sortedRowIndexes_1.next(); !sortedRowIndexes_1_1.done; sortedRowIndexes_1_1 = sortedRowIndexes_1.next()) {
-                            var rowIndex = sortedRowIndexes_1_1.value;
-                            if (rowIndex <= sheet.frozenRowCount) {
-                                sheet.frozenRowCount--;
-                            }
-                        }
-                    }
-                    catch (e_1_1) { e_1 = { error: e_1_1 }; }
-                    finally {
-                        try {
-                            if (sortedRowIndexes_1_1 && !sortedRowIndexes_1_1.done && (_a = sortedRowIndexes_1.return)) _a.call(sortedRowIndexes_1);
-                        }
-                        finally { if (e_1) throw e_1.error; }
-                    }
-                }
                 if (sheet.merges) {
                     sheet.merges = shrinkMergesOnRowDelete(sheet.merges, minRowIndex, count);
                 }
-                sheet.rowCount = Math.max(1, ((_b = sheet.rowCount) !== null && _b !== void 0 ? _b : rowCount) - count);
+                // `_xlnm.Print_Area` / `_xlnm.Print_Titles` follow the defined-name rule.
+                if (sheet.printSettings) {
+                    updatePrintSettingsOnStructuralChange(sheet.printSettings, "row", "delete", minRowIndex, count);
+                }
+                sheet.rowCount = Math.max(1, ((_a = sheet.rowCount) !== null && _a !== void 0 ? _a : rowCount) - count);
+                // Frozen panes are positional: the split stays where it is, only
+                // clamped so the freeze never exceeds the shrunk sheet.
+                if (sheet.frozenRowCount && sheet.frozenRowCount > sheet.rowCount) {
+                    sheet.frozenRowCount = sheet.rowCount;
+                }
             }), 3), nextState = _a[0], patches = _a[1], inversePatches = _a[2];
             saveHistory({ sheets: { patches: patches, inversePatches: inversePatches } });
             return nextState;
         });
+        // Tables whose header row goes (dropped above): their structured refs
+        // break to `#REF!`, computed from the PRE-edit definitions.
+        var removedTableParts = collectRemovedTableParts(tables, sheetId, "row", minRowIndex, maxRowIndex);
         // Sheet data: three-pass formula update, then splice the rows out.
         onChangeSheetData === null || onChangeSheetData === void 0 ? void 0 : onChangeSheetData(function (prevSheetData) {
             var _a = __read(produceWithPatches(prevSheetData, function (draft) {
                 var _a;
+                // A dynamic array whose anchor row is deleted takes its spill with
+                // it — drop the projected cells before the rows close up.
+                removeSpillsOfDeletedAnchors({
+                    draft: draft,
+                    sheetId: sheetId,
+                    axis: "row",
+                    minIndex: minRowIndex,
+                    maxIndex: maxRowIndex,
+                    getArrayRange: getArrayRange,
+                    locale: locale,
+                    cellXfsRegistry: cellXfsRegistry,
+                    sharedStringRegistry: sharedStringRegistry,
+                });
+                breakStructuredRefsForRemovedTableParts({
+                    draft: draft,
+                    sheetId: sheetId,
+                    axis: "row",
+                    referenceIndex: minRowIndex,
+                    count: count,
+                    removed: removedTableParts,
+                    getGraphNodes: getGraphNodes,
+                    enqueueCalculation: enqueueCalculation,
+                    enqueueGraphOperation: enqueueGraphOperation,
+                    recalcCells: recalcCells,
+                    locale: locale,
+                    cellXfsRegistry: cellXfsRegistry,
+                    sharedStringRegistry: sharedStringRegistry,
+                });
                 updateFormulasForStructuralChange({
                     draft: draft,
                     axis: "row",

package/dist/cjs/interface/insert-cells-shift-down.d.ts

@@ -1,5 +1,14 @@
 import type { CellData, CellInterface, SelectionArea } from "@rowsncolumns/common-types";
 import type { SelectionAttributes, Sheet } from "@rowsncolumns/spreadsheet";
 import type { UseOnInsertCellsShiftDown } from "../hooks/use-on-insert-cells-shift-down";
-export declare const insertCellsShiftDown: <T extends CellData, S extends Sheet>({ rowCount, columnCount, locale, cellXfsRegistry, sharedStringRegistry, getActiveCell, getSelections, getDependents, createHistory, enqueueGraphOperation, enqueueCalculation, enqueueStructureChange, onChangeSheetData, onChangeSheets, onChangeCitations, }: UseOnInsertCellsShiftDown<T, S>) => (sheetId: number, activeCell: CellInterface, selections: SelectionArea<SelectionAttributes>[]) => void;
+/**
+ * Insert cells ▸ Shift cells down (SHF-01, SHF-06, SHF-07, SHF-08, FMT-03). Only the selection's
+ * columns move: every cell at or below the selection's first row slides down by the selection's
+ * height. References that target a shifted cell follow it; a range that lies entirely inside the
+ * shifted columns and straddles the insertion row grows by the inserted height (SHF-08); a wider
+ * range keeps its address (SHF-07). The vacated cells take the formatting of the cell above the
+ * insertion (FMT-03). Refusals (torn merge/table/array, off-sheet push) are decided by the hook via
+ * `getShiftCellsRefusal` before this runs.
+ */
+export declare const insertCellsShiftDown: <T extends CellData, S extends Sheet>({ rowCount, columnCount, locale, cellXfsRegistry, sharedStringRegistry, getActiveCell, getSelections, getDependents, getSheetName, createHistory, enqueueGraphOperation, enqueueCalculation, enqueueStructureChange, onChangeSheetData, onChangeSheets, onChangeTables, onChangeCitations, }: UseOnInsertCellsShiftDown<T, S>) => (sheetId: number, activeCell: CellInterface, selections: SelectionArea<SelectionAttributes>[]) => void;
 //# sourceMappingURL=insert-cells-shift-down.d.ts.map

package/dist/cjs/interface/insert-cells-shift-down.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"insert-cells-shift-down.d.ts","sourceRoot":"","sources":["../../../interface/insert-cells-shift-down.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,QAAQ,EACR,aAAa,EAEb,aAAa,EACd,MAAM,4BAA4B,CAAC;AAEpC,OAAO,KAAK,EAAE,mBAAmB,EAAE,KAAK,EAAE,MAAM,2BAA2B,CAAC;AAM5E,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,yCAAyC,CAAC;AAGzF,eAAO,MAAM,oBAAoB,GAAI,CAAC,SAAS,QAAQ,EAAE,CAAC,SAAS,KAAK,EAAE,gQAgBvE,yBAAyB,CAAC,CAAC,EAAE,CAAC,CAAC,MAE9B,SAAS,MAAM,EACf,YAAY,aAAa,EACzB,YAAY,aAAa,CAAC,mBAAmB,CAAC,EAAE,SAoMnD,CAAC"}
+{"version":3,"file":"insert-cells-shift-down.d.ts","sourceRoot":"","sources":["../../../interface/insert-cells-shift-down.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,QAAQ,EACR,aAAa,EAEb,aAAa,EACd,MAAM,4BAA4B,CAAC;AACpC,OAAO,KAAK,EAAE,mBAAmB,EAAE,KAAK,EAAE,MAAM,2BAA2B,CAAC;AAe5E,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,yCAAyC,CAAC;AAIzF;;;;;;;;GAQG;AACH,eAAO,MAAM,oBAAoB,GAAI,CAAC,SAAS,QAAQ,EAAE,CAAC,SAAS,KAAK,EAAE,8RAkBvE,yBAAyB,CAAC,CAAC,EAAE,CAAC,CAAC,MAE9B,SAAS,MAAM,EACf,YAAY,aAAa,EACzB,YAAY,aAAa,CAAC,mBAAmB,CAAC,EAAE,SAoQnD,CAAC"}

package/dist/cjs/interface/insert-cells-shift-down.js

@@ -1,39 +1,47 @@
-import { __assign, __read, __spreadArray, __values } from "tslib";
-import { selectionFromActiveCell } from "@rowsncolumns/utils";
+import { __read, __spreadArray, __values } from "tslib";
 import { produceWithPatches } from "immer";
-import { processSideEffectDependentCells } from "../api/dependency";
+import { collectUniqueDependentsForRange, processSideEffectDependentCells, } from "../api/dependency";
+import { createSheetCellIdentifier, expandRangesInFormula } from "../api/formula";
 import { cloneCellWithFormatting, createSheetDraft } from "../api/immer-utils";
-import { moveMergedCells } from "../api/merges";
+import { shiftMergesInBand } from "../api/merges";
+import { isRangeInsideBand, resolveShiftSelection, shiftBand, } from "../api/structural-guards";
+import { SheetCell } from "../sheet-cell";
+/**
+ * Insert cells ▸ Shift cells down (SHF-01, SHF-06, SHF-07, SHF-08, FMT-03). Only the selection's
+ * columns move: every cell at or below the selection's first row slides down by the selection's
+ * height. References that target a shifted cell follow it; a range that lies entirely inside the
+ * shifted columns and straddles the insertion row grows by the inserted height (SHF-08); a wider
+ * range keeps its address (SHF-07). The vacated cells take the formatting of the cell above the
+ * insertion (FMT-03). Refusals (torn merge/table/array, off-sheet push) are decided by the hook via
+ * `getShiftCellsRefusal` before this runs.
+ */
 export var insertCellsShiftDown = 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;
+    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, getSheetName = _a.getSheetName, createHistory = _a.createHistory, enqueueGraphOperation = _a.enqueueGraphOperation, enqueueCalculation = _a.enqueueCalculation, enqueueStructureChange = _a.enqueueStructureChange, onChangeSheetData = _a.onChangeSheetData, onChangeSheets = _a.onChangeSheets, onChangeTables = _a.onChangeTables, onChangeCitations = _a.onChangeCitations;
     return function (sheetId, activeCell, selections) {
+        var _a;
         var saveHistory = createHistory();
         // We need to track this for history. Precedent cells
         var recalcCells = new Map();
-        // Count
-        var finalSelections = selections.length
-            ? selections
-            : selectionFromActiveCell(activeCell);
-        // Last selection
-        var selection = finalSelections[finalSelections.length - 1];
-        var count = selection.range.endRowIndex - selection.range.startRowIndex + 1;
+        var selection = resolveShiftSelection(activeCell, selections);
+        var _b = selection.range, r1 = _b.startRowIndex, r2 = _b.endRowIndex, c1 = _b.startColumnIndex, c2 = _b.endColumnIndex;
+        var count = r2 - r1 + 1;
+        var band = shiftBand("down", selection.range);
+        var sheetName = (_a = getSheetName === null || getSheetName === void 0 ? void 0 : getSheetName(sheetId)) !== null && _a !== void 0 ? _a : "";
         enqueueStructureChange === null || enqueueStructureChange === void 0 ? void 0 : enqueueStructureChange({
             kind: "insert-cells-shift-down",
             sheetId: sheetId,
-            startRowIndex: selection.range.startRowIndex,
-            endRowIndex: selection.range.endRowIndex,
-            startColumnIndex: selection.range.startColumnIndex,
-            endColumnIndex: selection.range.endColumnIndex,
+            startRowIndex: r1,
+            endRowIndex: r2,
+            startColumnIndex: c1,
+            endColumnIndex: c2,
             rowCount: rowCount,
         });
-        // Update sheets
+        // Update sheets — merges wholly inside the shifted columns ride down with their cells.
         onChangeSheets === null || onChangeSheets === void 0 ? void 0 : onChangeSheets(function (prevSheets) {
             var _a = __read(produceWithPatches(prevSheets, function (draft) {
                 var sheet = draft.find(function (sheet) { return sheet.sheetId === sheetId; });
-                if (sheet) {
-                    for (var rowIndex = selection.range.startRowIndex; rowIndex <= selection.range.endRowIndex; rowIndex++) {
-                        sheet.merges = moveMergedCells(sheet.merges, "row-insert", rowIndex);
-                    }
+                if (sheet === null || sheet === void 0 ? void 0 : sheet.merges) {
+                    sheet.merges = shiftMergesInBand(sheet.merges, "row", r1, count, true, c1, c2);
                 }
             }), 3), nextState = _a[0], patches = _a[1], inversePatches = _a[2];
             // Save history
@@ -42,40 +50,61 @@ export var insertCellsShiftDown = function (_a) {
             });
             return nextState;
         });
+        // Tables whose columns the band covers entirely move with it (a partial cover was refused).
+        onChangeTables === null || onChangeTables === void 0 ? void 0 : onChangeTables(function (prevTables) {
+            var _a = __read(produceWithPatches(prevTables, function (draft) {
+                var e_1, _a;
+                try {
+                    for (var draft_1 = __values(draft), draft_1_1 = draft_1.next(); !draft_1_1.done; draft_1_1 = draft_1.next()) {
+                        var table = draft_1_1.value;
+                        if (table.sheetId !== sheetId ||
+                            !isRangeInsideBand(table.range, band)) {
+                            continue;
+                        }
+                        table.range.startRowIndex += count;
+                        table.range.endRowIndex += count;
+                    }
+                }
+                catch (e_1_1) { e_1 = { error: e_1_1 }; }
+                finally {
+                    try {
+                        if (draft_1_1 && !draft_1_1.done && (_a = draft_1.return)) _a.call(draft_1);
+                    }
+                    finally { if (e_1) throw e_1.error; }
+                }
+            }), 3), nextState = _a[0], patches = _a[1], inversePatches = _a[2];
+            saveHistory({ tables: { patches: patches, inversePatches: inversePatches } });
+            return nextState;
+        });
         // Update citations - shift if in affected columns and after insertion row
         onChangeCitations === null || onChangeCitations === void 0 ? void 0 : onChangeCitations(function (prevCitations) {
             var _a = __read(produceWithPatches(prevCitations, function (draft) {
-                var e_1, _a;
-                var affectedColStart = selection.range.startColumnIndex;
-                var affectedColEnd = selection.range.endColumnIndex;
-                var insertRowStart = selection.range.startRowIndex;
-                var shiftAmount = selection.range.endRowIndex - selection.range.startRowIndex + 1;
+                var e_2, _a;
                 try {
-                    for (var draft_1 = __values(draft), draft_1_1 = draft_1.next(); !draft_1_1.done; draft_1_1 = draft_1.next()) {
-                        var citation = draft_1_1.value;
+                    for (var draft_2 = __values(draft), draft_2_1 = draft_2.next(); !draft_2_1.done; draft_2_1 = draft_2.next()) {
+                        var citation = draft_2_1.value;
                         // Skip citations on other sheets
                         if (citation.range.sheetId !== sheetId) {
                             continue;
                         }
                         // Check if citation overlaps with affected columns
-                        var citationColStart = citation.range.startColumnIndex;
-                        var citationColEnd = citation.range.endColumnIndex;
-                        var colsOverlap = !(citationColEnd < affectedColStart || citationColStart > affectedColEnd);
+                        var colsOverlap = !(citation.range.endColumnIndex < c1 ||
+                            citation.range.startColumnIndex > c2);
                         if (colsOverlap) {
                             // If citation starts at or after the insertion row, shift it down
-                            if (citation.range.startRowIndex >= insertRowStart) {
-                                citation.range.startRowIndex += shiftAmount;
-                                citation.range.endRowIndex += shiftAmount;
+                            if (citation.range.startRowIndex >= r1) {
+                                citation.range.startRowIndex += count;
+                                citation.range.endRowIndex += count;
                             }
                         }
                     }
                 }
-                catch (e_1_1) { e_1 = { error: e_1_1 }; }
+                catch (e_2_1) { e_2 = { error: e_2_1 }; }
                 finally {
                     try {
-                        if (draft_1_1 && !draft_1_1.done && (_a = draft_1.return)) _a.call(draft_1);
+                        if (draft_2_1 && !draft_2_1.done && (_a = draft_2.return)) _a.call(draft_2);
                     }
-                    finally { if (e_1) throw e_1.error; }
+                    finally { if (e_2) throw e_2.error; }
                 }
             }), 3), nextState = _a[0], patches = _a[1], inversePatches = _a[2];
             saveHistory({
@@ -86,15 +115,34 @@ export var insertCellsShiftDown = function (_a) {
         // Sheet data
         onChangeSheetData === null || onChangeSheetData === void 0 ? void 0 : onChangeSheetData(function (prevSheetData) {
             var _a = __read(produceWithPatches(prevSheetData, function (draft) {
-                var _a, _b, _c, _d;
+                var e_3, _a;
+                var _b, _c, _d, _e, _f, _g, _h, _j;
                 var movedKeys = new Set();
-                var totalRows = (_b = (_a = draft[sheetId]) === null || _a === void 0 ? void 0 : _a.length) !== null && _b !== void 0 ? _b : rowCount;
-                for (var rowIndex = totalRows; rowIndex > 0; rowIndex--) {
+                var totalRows = Math.max((_c = (_b = draft[sheetId]) === null || _b === void 0 ? void 0 : _b.length) !== null && _c !== void 0 ? _c : 0, r2 + 1);
+                // Everything at or below the insertion row in the band's columns moves down by `count`.
+                var sourceRange = {
+                    startRowIndex: r1,
+                    endRowIndex: totalRows + count,
+                    startColumnIndex: c1,
+                    endColumnIndex: c2,
+                };
+                // Formulas that read a moving cell — captured before the graph goes stale.
+                var dependents = collectUniqueDependentsForRange({
+                    draft: draft,
+                    sheetId: sheetId,
+                    sourceRange: {
+                        startRowIndex: r1,
+                        endRowIndex: totalRows,
+                        startColumnIndex: c1,
+                        endColumnIndex: c2,
+                    },
+                    getDependents: getDependents,
+                });
+                for (var rowIndex = totalRows; rowIndex >= r1; rowIndex--) {
                     // We have a for loop
                     // to cater for table expansion
                     // which will push multiple columns down
-                    for (var columnIndex = selection.range.startColumnIndex; columnIndex <= selection.range.endColumnIndex; columnIndex++) {
-                        var sourceRange = __assign(__assign({}, selection.range), { endRowIndex: selection.range.endRowIndex + count });
+                    for (var columnIndex = c1; columnIndex <= c2; columnIndex++) {
                         // Process dependents
                         processSideEffectDependentCells({
                             draft: draft,
@@ -105,6 +153,7 @@ export var insertCellsShiftDown = function (_a) {
                             enqueueGraphOperation: enqueueGraphOperation,
                             enqueueCalculation: enqueueCalculation,
                             getDependents: getDependents,
+                            getSheetName: getSheetName,
                             recalcCells: recalcCells,
                             rowDelta: count,
                             sourceRange: sourceRange,
@@ -115,26 +164,72 @@ export var insertCellsShiftDown = function (_a) {
                             cellXfsRegistry: cellXfsRegistry,
                             sharedStringRegistry: sharedStringRegistry,
                         });
-                        // Skip unaffected cells
-                        if (rowIndex < selection.range.startRowIndex) {
+                    }
+                }
+                // SHF-08: a range living entirely inside the band's columns that straddles the insertion
+                // row grows by the inserted height (Excel's "insert inside a range expands it"). Runs on
+                // the pre-shift positions; the value shift below carries in-band dependents down.
+                var sheetCell = new SheetCell();
+                try {
+                    for (var _k = __values(dependents.values()), _l = _k.next(); !_l.done; _l = _k.next()) {
+                        var pos = _l.value;
+                        if (pos.sheetId !== sheetId)
                             continue;
-                        }
+                        var currentSheet = createSheetDraft(draft, sheetId, pos.rowIndex);
+                        var cellData = (_e = (_d = currentSheet[pos.rowIndex]) === null || _d === void 0 ? void 0 : _d.values) === null || _e === void 0 ? void 0 : _e[pos.columnIndex];
+                        sheetCell.assign(sheetId, { rowIndex: pos.rowIndex, columnIndex: pos.columnIndex }, cellData, { locale: locale, cellXfsRegistry: cellXfsRegistry, sharedStringRegistry: sharedStringRegistry });
+                        var formulaValue = sheetCell.formula;
+                        if (!formulaValue)
+                            continue;
+                        var expanded = expandRangesInFormula(formulaValue, r1, count, "row", sheetName, { bandSpan: { startIndex: c1, endIndex: c2 } });
+                        if (!expanded || expanded === formulaValue)
+                            continue;
+                        sheetCell.setFormulaValue(expanded, false);
+                        currentSheet[pos.rowIndex].values[pos.columnIndex] =
+                            sheetCell.getCellData();
+                        var movesWithBand = pos.rowIndex >= r1 && pos.columnIndex >= c1 && pos.columnIndex <= c2;
+                        var finalPosition = {
+                            sheetId: sheetId,
+                            rowIndex: movesWithBand ? pos.rowIndex + count : pos.rowIndex,
+                            columnIndex: pos.columnIndex,
+                        };
+                        var enqueueOperation = sheetCell.ephemeral()
+                            ? enqueueCalculation
+                            : enqueueGraphOperation;
+                        enqueueOperation === null || enqueueOperation === void 0 ? void 0 : enqueueOperation({ type: "add", position: finalPosition });
+                        enqueueCalculation === null || enqueueCalculation === void 0 ? void 0 : enqueueCalculation({
+                            type: "dirty",
+                            position: finalPosition,
+                            force: true,
+                        });
+                        recalcCells.set(createSheetCellIdentifier(sheetId, finalPosition.rowIndex, finalPosition.columnIndex), finalPosition);
+                    }
+                }
+                catch (e_3_1) { e_3 = { error: e_3_1 }; }
+                finally {
+                    try {
+                        if (_l && !_l.done && (_a = _k.return)) _a.call(_k);
                     }
+                    finally { if (e_3) throw e_3.error; }
                 }
                 // Update values
-                for (var rowIndex = totalRows + count; rowIndex > selection.range.startRowIndex; rowIndex--) {
+                for (var rowIndex = totalRows + count; rowIndex > r1; rowIndex--) {
                     var currentSheet = createSheetDraft(draft, sheetId, rowIndex);
-                    for (var columnIndex = selection.range.endColumnIndex; columnIndex >= selection.range.startColumnIndex; columnIndex--) {
-                        var previousValue = (_d = (_c = currentSheet[rowIndex - count]) === null || _c === void 0 ? void 0 : _c.values) === null || _d === void 0 ? void 0 : _d[columnIndex];
+                    for (var columnIndex = c2; columnIndex >= c1; columnIndex--) {
+                        var previousValue = (_g = (_f = currentSheet[rowIndex - count]) === null || _f === void 0 ? void 0 : _f.values) === null || _g === void 0 ? void 0 : _g[columnIndex];
                         currentSheet[rowIndex].values[columnIndex] = previousValue;
                     }
                 }
-                // Update inserts cells
-                for (var rowIndex = selection.range.startRowIndex; rowIndex <= selection.range.endRowIndex; rowIndex++) {
+                // FMT-03: the inserted cells take the formatting of the cell directly ABOVE the
+                // insertion; at row 1 there is none, so they keep the displaced cell's formatting.
+                for (var rowIndex = r1; rowIndex <= r2; rowIndex++) {
                     var currentSheet = createSheetDraft(draft, sheetId, rowIndex);
-                    for (var columnIndex = selection.range.endColumnIndex; columnIndex >= selection.range.startColumnIndex; columnIndex--) {
+                    for (var columnIndex = c2; columnIndex >= c1; columnIndex--) {
+                        var formatSource = r1 > 1
+                            ? (_j = (_h = currentSheet[r1 - 1]) === null || _h === void 0 ? void 0 : _h.values) === null || _j === void 0 ? void 0 : _j[columnIndex]
+                            : currentSheet[rowIndex].values[columnIndex];
                         currentSheet[rowIndex].values[columnIndex] =
-                            cloneCellWithFormatting(currentSheet[rowIndex].values[columnIndex]);
+                            cloneCellWithFormatting(formatSource);
                     }
                 }
             }), 3), nextState = _a[0], patches = _a[1], inversePatches = _a[2];

package/dist/cjs/interface/insert-cells-shift-right.d.ts

@@ -1,5 +1,14 @@
 import type { CellData, CellInterface, SelectionArea } from "@rowsncolumns/common-types";
 import type { SelectionAttributes, Sheet } from "@rowsncolumns/spreadsheet";
 import type { UseOnInsertCellsShiftRight } from "../hooks/use-on-insert-cells-shift-right";
-export declare const insertCellsShiftRight: <T extends CellData, S extends Sheet>({ rowCount, columnCount, locale, cellXfsRegistry, sharedStringRegistry, getActiveCell, getSelections, getDependents, createHistory, enqueueGraphOperation, enqueueCalculation, enqueueStructureChange, onChangeSheetData, onChangeSheets, onChangeCitations, }: UseOnInsertCellsShiftRight<T, S>) => (sheetId: number, activeCell: CellInterface, selections: SelectionArea<SelectionAttributes>[]) => void;
+/**
+ * Insert cells ▸ Shift cells right (SHF-02, FMT-04) — the horizontal twin of
+ * `insertCellsShiftDown`: only the selection's rows move, every cell at or right of the selection's
+ * first column slides right by the selection's width. References follow shifted cells; a range
+ * entirely inside the shifted rows that straddles the insertion column widens (SHF-08 analog);
+ * the vacated cells take the formatting of the cell to the LEFT of the insertion (FMT-04). Refusals
+ * (torn merge/table/array, a non-blank cell pushed past `columnCount` — SHF-10) are decided by the
+ * hook before this runs.
+ */
+export declare const insertCellsShiftRight: <T extends CellData, S extends Sheet>({ rowCount, columnCount, locale, cellXfsRegistry, sharedStringRegistry, getActiveCell, getSelections, getDependents, getSheetName, createHistory, enqueueGraphOperation, enqueueCalculation, enqueueStructureChange, onChangeSheetData, onChangeSheets, onChangeTables, onChangeCitations, }: UseOnInsertCellsShiftRight<T, S>) => (sheetId: number, activeCell: CellInterface, selections: SelectionArea<SelectionAttributes>[]) => void;
 //# sourceMappingURL=insert-cells-shift-right.d.ts.map

package/dist/cjs/interface/insert-cells-shift-right.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"insert-cells-shift-right.d.ts","sourceRoot":"","sources":["../../../interface/insert-cells-shift-right.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,QAAQ,EACR,aAAa,EAEb,aAAa,EACd,MAAM,4BAA4B,CAAC;AAEpC,OAAO,KAAK,EAAE,mBAAmB,EAAE,KAAK,EAAE,MAAM,2BAA2B,CAAC;AAM5E,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,0CAA0C,CAAC;AAG3F,eAAO,MAAM,qBAAqB,GAAI,CAAC,SAAS,QAAQ,EAAE,CAAC,SAAS,KAAK,EAAE,gQAgBxE,0BAA0B,CAAC,CAAC,EAAE,CAAC,CAAC,MAE/B,SAAS,MAAM,EACf,YAAY,aAAa,EACzB,YAAY,aAAa,CAAC,mBAAmB,CAAC,EAAE,SA2LnD,CAAC"}
+{"version":3,"file":"insert-cells-shift-right.d.ts","sourceRoot":"","sources":["../../../interface/insert-cells-shift-right.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,QAAQ,EACR,aAAa,EAEb,aAAa,EACd,MAAM,4BAA4B,CAAC;AACpC,OAAO,KAAK,EAAE,mBAAmB,EAAE,KAAK,EAAE,MAAM,2BAA2B,CAAC;AAgB5E,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,0CAA0C,CAAC;AAI3F;;;;;;;;GAQG;AACH,eAAO,MAAM,qBAAqB,GAAI,CAAC,SAAS,QAAQ,EAAE,CAAC,SAAS,KAAK,EAAE,8RAkBxE,0BAA0B,CAAC,CAAC,EAAE,CAAC,CAAC,MAE/B,SAAS,MAAM,EACf,YAAY,aAAa,EACzB,YAAY,aAAa,CAAC,mBAAmB,CAAC,EAAE,SAqQnD,CAAC"}