@rowsncolumns/spreadsheet-state 28.0.75 → 29.0.0

package/dist/cjs/api/formula.js

@@ -1,5 +1,5 @@
-import { __assign, __values } from "tslib";
-import { isRangeToken, lexify, stripPropertyFromCellRef, tokenVocabulary, } from "@rowsncolumns/calculator";
+import { __assign, __read, __values } from "tslib";
+import { cleanupColumnName, cleanupTableName, isRangeToken, lexify, stripPropertyFromCellRef, tokenVocabulary, } from "@rowsncolumns/calculator";
 import { addressToCell, alpha2number, cellToAddress, desanitizeSheetName, number2Alpha, sanitizeSheetName, } from "@rowsncolumns/utils";
 export { ERROR_CIRCULAR_DEPENDENCY, ERROR_REFERENCE, formulaToRelativeReference, } from "@rowsncolumns/calculator";
 /**
@@ -99,6 +99,145 @@ export var updateColumnName = function (formulaValue, newName, oldName) {
     }
     return detokenize(newTokens);
 };
+/** The column specifier Excel writes for a deleted table column (`Table1[@#REF!]`). */
+export var REF_ERROR_COLUMN = "#REF!";
+var REF_ERROR_TOKEN = "#REF!";
+/**
+ * One `#REF!` token standing in for the run `start … end` (a range's start,
+ * colon and end): it keeps `start`'s position and stretches to `end` so
+ * `detokenize` (which re-inserts a space wherever adjacent tokens' offsets
+ * disagree) prints `SUM(#REF!)`, not `SUM(#REF! )`.
+ */
+var collapseToRefError = function (start, end) {
+    var _a, _b;
+    return (__assign(__assign({}, start), { image: REF_ERROR_TOKEN, tokenType: tokenVocabulary.RefError, endOffset: (_a = end === null || end === void 0 ? void 0 : end.endOffset) !== null && _a !== void 0 ? _a : start.endOffset, endColumn: (_b = end === null || end === void 0 ? void 0 : end.endColumn) !== null && _b !== void 0 ? _b : start.endColumn }));
+};
+var isTableNameToken = function (token) {
+    return (token === null || token === void 0 ? void 0 : token.tokenType.name) === tokenVocabulary.TableName.name;
+};
+var isTableColumnToken = function (token) {
+    return (token === null || token === void 0 ? void 0 : token.tokenType.name) === tokenVocabulary.TableColumnName.name;
+};
+/** Bracket depth change contributed by one token's image (`Table1[` opens, `Qty]` closes). */
+var bracketDelta = function (image) {
+    var e_4, _a;
+    var depth = 0;
+    try {
+        for (var image_1 = __values(image), image_1_1 = image_1.next(); !image_1_1.done; image_1_1 = image_1.next()) {
+            var ch = image_1_1.value;
+            if (ch === "[")
+                depth++;
+            else if (ch === "]")
+                depth--;
+        }
+    }
+    catch (e_4_1) { e_4 = { error: e_4_1 }; }
+    finally {
+        try {
+            if (image_1_1 && !image_1_1.done && (_a = image_1.return)) _a.call(image_1);
+        }
+        finally { if (e_4) throw e_4.error; }
+    }
+    return depth;
+};
+/**
+ * Index just past the last token of the structured reference that starts at
+ * `start` (a TableName token): consume tokens until the bracket the table name
+ * opened is closed again.
+ */
+var structuredReferenceEnd = function (tokens, start) {
+    var depth = 0;
+    var i = start;
+    while (i < tokens.length) {
+        depth += bracketDelta(tokens[i].image);
+        i++;
+        if (depth <= 0)
+            break;
+    }
+    return i;
+};
+/**
+ * Rewrite every structured reference into `tableName` to the `#REF!` token —
+ * Excel's text for a formula whose table was deleted (`=SUM(Table1[Price])`
+ * → `=SUM(#REF!)`), so the cell evaluates to `#REF!` rather than `#NAME?`.
+ * Returns the input unchanged when the formula never names the table.
+ */
+export var breakTableReferencesInFormula = function (formulaValue, tableName) {
+    var _a;
+    if (!formulaValue.includes("["))
+        return formulaValue;
+    var tokens = cloneTokens(lexify(formulaValue).tokens);
+    var newTokens = [];
+    var target = tableName.toLowerCase();
+    var hasChanges = false;
+    for (var i = 0; i < tokens.length; i++) {
+        var token = tokens[i];
+        if (isTableNameToken(token) &&
+            cleanupTableName(token.image).trim().toLowerCase() === target) {
+            var end = structuredReferenceEnd(tokens, i);
+            var last = (_a = tokens[end - 1]) !== null && _a !== void 0 ? _a : token;
+            newTokens.push(__assign(__assign({}, token), { image: REF_ERROR_TOKEN, endOffset: last.endOffset, endColumn: last.endColumn, tokenType: tokenVocabulary.RefError }));
+            i = end - 1;
+            hasChanges = true;
+            continue;
+        }
+        newTokens.push(token);
+    }
+    return hasChanges ? detokenize(newTokens) : formulaValue;
+};
+/**
+ * Rewrite the column specifiers of `columnNames` inside structured references
+ * to `tableName` (or, when `tableName` is undefined, the bare this-row form
+ * `[@Col]` whose table is implied by the formula's own cell) to `#REF!` —
+ * Excel's text for a deleted table column (`=Table1[@Qty]*2` →
+ * `=Table1[@#REF!]*2`). Keeps every other character of the reference as typed.
+ */
+export var breakTableColumnsInFormula = function (formulaValue, tableName, columnNames) {
+    if (!formulaValue.includes("[") || columnNames.length === 0) {
+        return formulaValue;
+    }
+    var targets = new Set(columnNames.map(function (name) { return name.toLowerCase(); }));
+    var target = tableName === null || tableName === void 0 ? void 0 : tableName.toLowerCase();
+    var tokens = cloneTokens(lexify(formulaValue).tokens);
+    var hasChanges = false;
+    var i = 0;
+    while (i < tokens.length) {
+        var token = tokens[i];
+        if (isTableNameToken(token)) {
+            var end = structuredReferenceEnd(tokens, i);
+            var matches = target !== undefined &&
+                cleanupTableName(token.image).trim().toLowerCase() === target;
+            if (matches) {
+                for (var j = i + 1; j < end; j++) {
+                    if (breakColumnToken(tokens[j], targets))
+                        hasChanges = true;
+                }
+            }
+            i = end;
+            continue;
+        }
+        // A bare `[@Col]` / `[Col]` names the table the formula cell sits in.
+        if (target === undefined && isTableColumnToken(token)) {
+            if (breakColumnToken(token, targets))
+                hasChanges = true;
+        }
+        i++;
+    }
+    return hasChanges ? detokenize(tokens) : formulaValue;
+};
+var breakColumnToken = function (token, targets) {
+    if (!token || !isTableColumnToken(token))
+        return false;
+    var name = cleanupColumnName(token.image);
+    if (!name || !targets.has(name.toLowerCase()))
+        return false;
+    var at = token.image.indexOf(name);
+    if (at === -1)
+        return false;
+    token.image =
+        token.image.slice(0, at) + REF_ERROR_COLUMN + token.image.slice(at + name.length);
+    return true;
+};
 /**
  * Converts tokens to string
  * @param tokens
@@ -158,19 +297,34 @@ export var isAbsoluteRowReference = function (formula) {
         return false;
     return /\$\d+/gi.test(formula);
 };
+var isRangeWithinBandSpan = function (startCell, endCell, dimension, bandSpan) {
+    if (!bandSpan)
+        return true;
+    var _a = __read(dimension === "row"
+        ? [startCell.columnIndex, endCell.columnIndex]
+        : [startCell.rowIndex, endCell.rowIndex], 2), start = _a[0], end = _a[1];
+    return (Math.min(start, end) >= bandSpan.startIndex &&
+        Math.max(start, end) <= bandSpan.endIndex);
+};
 /**
  * Expands ranges in a formula when rows or columns are inserted within the range
  * @param formula The formula to process
  * @param insertionIndex The row or column index where insertion happens
  * @param count Number of rows or columns being inserted
  * @param dimension Whether inserting 'row' or 'column'
- * @param activeSheetName Active sheet name to scope range updates
+ * @param activeSheetName Name of the EDITED sheet: only references that resolve
+ *   to it are touched
+ * @param options `includeUnqualifiedReferences` — whether references without a
+ *   sheet qualifier resolve to the edited sheet (true when the formula lives on
+ *   it; false for a formula on another sheet, whose bare `A1:A3` is its own)
  * @returns The formula with expanded ranges, or undefined if no changes
  */
-export var expandRangesInFormula = function (formula, insertionIndex, count, dimension, activeSheetName) {
+export var expandRangesInFormula = function (formula, insertionIndex, count, dimension, activeSheetName, options) {
+    if (options === void 0) { options = {}; }
     if (!formula || count <= 0) {
         return formula;
     }
+    var _a = options.includeUnqualifiedReferences, includeUnqualifiedReferences = _a === void 0 ? true : _a, bandSpan = options.bandSpan;
     var normalizedActiveSheetName = activeSheetName.toLowerCase();
     var tokens = cloneTokens(lexify(formula).tokens);
     var newTokens = [];
@@ -178,7 +332,9 @@ export var expandRangesInFormula = function (formula, insertionIndex, count, dim
     for (var i = 0; i < tokens.length; i++) {
         var token = tokens[i];
         var sheetName = getSheetNameFromToken(tokens[i - 1]);
-        var skipSheet = sheetName && sheetName.toLowerCase() !== normalizedActiveSheetName;
+        var skipSheet = sheetName
+            ? sheetName.toLowerCase() !== normalizedActiveSheetName
+            : !includeUnqualifiedReferences;
         // Handle cell ranges (e.g., A1:A10)
         if (token.tokenType.name === tokenVocabulary.Cell.name) {
             var isRange = isRangeToken(tokens[i + 1]);
@@ -193,7 +349,9 @@ export var expandRangesInFormula = function (formula, insertionIndex, count, dim
             if (isRange && tokens[i + 2]) {
                 var startCell = addressToCell(stripPropertyFromCellRef(token.image));
                 var endCell = addressToCell(stripPropertyFromCellRef(tokens[i + 2].image));
-                if (startCell && endCell) {
+                if (startCell &&
+                    endCell &&
+                    isRangeWithinBandSpan(startCell, endCell, dimension, bandSpan)) {
                     var isAbsoluteEndRow = isAbsoluteRowReference(tokens[i + 2].image);
                     var isAbsoluteEndCol = isAbsoluteColumnReference(tokens[i + 2].image);
                     if (dimension === "row") {
@@ -233,7 +391,7 @@ export var expandRangesInFormula = function (formula, insertionIndex, count, dim
         if (dimension === "column" &&
             token.tokenType.name === tokenVocabulary.Column.name) {
             var isRange = isRangeToken(tokens[i + 1]);
-            if (skipSheet) {
+            if (skipSheet || bandSpan) {
                 if (isRange) {
                     newTokens.push(token, tokens[i + 1], tokens[i + 2]);
                     i += 2;
@@ -260,7 +418,7 @@ export var expandRangesInFormula = function (formula, insertionIndex, count, dim
         if (dimension === "row" &&
             token.tokenType.name === tokenVocabulary.Number.name) {
             var isRange = isRangeToken(tokens[i + 1]);
-            if (skipSheet) {
+            if (skipSheet || bandSpan) {
                 if (isRange) {
                     newTokens.push(token, tokens[i + 1], tokens[i + 2]);
                     i += 2;
@@ -293,22 +451,48 @@ export var expandRangesInFormula = function (formula, insertionIndex, count, dim
  * @param deletionIndex The row or column index where deletion starts
  * @param count Number of rows or columns being deleted
  * @param dimension Whether deleting 'row' or 'column'
- * @param activeSheetName Active sheet name to scope range updates
+ * @param activeSheetName Name of the EDITED sheet: only references that resolve
+ *   to it are touched
+ * @param options `includeUnqualifiedReferences` — see `expandRangesInFormula`
  * @returns The formula with contracted ranges, or undefined if no changes
+ *
+ * Excel semantics for the deleted band: a range whose rows/columns are ALL
+ * deleted becomes the `#REF!` token (`=SUM(A2:A3)` → `=SUM(#REF!)`); a single
+ * cell reference into the band becomes `#REF!` (`=A3+1` → `=#REF!+1`, a spill
+ * reference `=C1#` → `=#REF!#`); a partially covered range shrinks.
  */
-export var contractRangesInFormula = function (formula, deletionIndex, count, dimension, activeSheetName) {
+export var contractRangesInFormula = function (formula, deletionIndex, count, dimension, activeSheetName, options) {
+    if (options === void 0) { options = {}; }
     if (!formula || count <= 0) {
         return formula;
     }
+    var _a = options.includeUnqualifiedReferences, includeUnqualifiedReferences = _a === void 0 ? true : _a, bandSpan = options.bandSpan;
     var normalizedActiveSheetName = activeSheetName.toLowerCase();
     var tokens = cloneTokens(lexify(formula).tokens);
     var newTokens = [];
     var hasChanges = false;
     var deletionEnd = deletionIndex + count - 1;
+    var inDeletedBand = function (cell) {
+        var index = dimension === "row" ? cell.rowIndex : cell.columnIndex;
+        return index >= deletionIndex && index <= deletionEnd;
+    };
+    var overlapsBand = function (start, end) {
+        return deletionIndex <= end && deletionEnd >= start;
+    };
+    // The survivors of a span that overlaps (but is not swallowed by) the band:
+    // whatever lay before the band keeps its start, whatever lay inside starts at
+    // the deletion point; an end past the band moves up by the full count, an
+    // end inside the band stops just before it.
+    var contractSpan = function (start, end) { return ({
+        start: Math.min(start, deletionIndex),
+        end: end > deletionEnd ? end - count : deletionIndex - 1,
+    }); };
     for (var i = 0; i < tokens.length; i++) {
         var token = tokens[i];
         var sheetName = getSheetNameFromToken(tokens[i - 1]);
-        var skipSheet = sheetName && sheetName.toLowerCase() !== normalizedActiveSheetName;
+        var skipSheet = sheetName
+            ? sheetName.toLowerCase() !== normalizedActiveSheetName
+            : !includeUnqualifiedReferences;
         // Handle cell ranges (e.g., A1:A10)
         if (token.tokenType.name === tokenVocabulary.Cell.name) {
             var isRange = isRangeToken(tokens[i + 1]);
@@ -320,10 +504,33 @@ export var contractRangesInFormula = function (formula, deletionIndex, count, di
                 }
                 continue;
             }
+            if (!isRange) {
+                // Single cell: broken when it sits in the deleted band. The trailing
+                // spilled-range operator (`C1#`) stays on the token (`#REF!#`).
+                var spill = token.image.endsWith("#") ? "#" : "";
+                var cell = addressToCell(stripPropertyFromCellRef(spill ? token.image.slice(0, -1) : token.image));
+                if (cell &&
+                    inDeletedBand(cell) &&
+                    isRangeWithinBandSpan(cell, cell, dimension, bandSpan)) {
+                    token.image = "".concat(REF_ERROR_TOKEN).concat(spill);
+                    hasChanges = true;
+                }
+                newTokens.push(token);
+                continue;
+            }
             if (isRange && tokens[i + 2]) {
                 var startCell = addressToCell(stripPropertyFromCellRef(token.image));
                 var endCell = addressToCell(stripPropertyFromCellRef(tokens[i + 2].image));
-                if (startCell && endCell) {
+                if (startCell &&
+                    endCell &&
+                    isRangeWithinBandSpan(startCell, endCell, dimension, bandSpan)) {
+                    // Every row/column of the range deleted → the whole range is #REF!.
+                    if (inDeletedBand(startCell) && inDeletedBand(endCell)) {
+                        newTokens.push(collapseToRefError(token, tokens[i + 2]));
+                        i += 2;
+                        hasChanges = true;
+                        continue;
+                    }
                     var isAbsoluteStartRow = isAbsoluteRowReference(token.image);
                     var isAbsoluteEndRow = isAbsoluteRowReference(tokens[i + 2].image);
                     var isAbsoluteStartCol = isAbsoluteColumnReference(token.image);
@@ -331,18 +538,10 @@ export var contractRangesInFormula = function (formula, deletionIndex, count, di
                     if (dimension === "row") {
                         var rangeStart = startCell.rowIndex;
                         var rangeEnd = endCell.rowIndex;
-                        // Check if deletion overlaps with range
-                        if (deletionIndex <= rangeEnd && deletionEnd >= rangeStart) {
-                            // Calculate how many deleted rows are within the range
-                            var overlapStart = Math.max(deletionIndex, rangeStart);
-                            var overlapEnd = Math.min(deletionEnd, rangeEnd);
-                            var rowsDeletedInRange = overlapEnd - overlapStart + 1;
-                            // Contract the end of the range
-                            endCell.rowIndex -= rowsDeletedInRange;
-                            // If entire range is deleted, result in #REF! (but we'll just contract to minimum)
-                            if (endCell.rowIndex < startCell.rowIndex) {
-                                endCell.rowIndex = startCell.rowIndex;
-                            }
+                        if (overlapsBand(rangeStart, rangeEnd)) {
+                            var survivors = contractSpan(rangeStart, rangeEnd);
+                            startCell.rowIndex = survivors.start;
+                            endCell.rowIndex = survivors.end;
                             var newStartAddress = cellToAddress(startCell, isAbsoluteStartCol, isAbsoluteStartRow);
                             var newEndAddress = cellToAddress(endCell, isAbsoluteEndCol, isAbsoluteEndRow);
                             if (newStartAddress && newEndAddress) {
@@ -356,18 +555,10 @@ export var contractRangesInFormula = function (formula, deletionIndex, count, di
                         // dimension === 'column'
                         var rangeStart = startCell.columnIndex;
                         var rangeEnd = endCell.columnIndex;
-                        // Check if deletion overlaps with range
-                        if (deletionIndex <= rangeEnd && deletionEnd >= rangeStart) {
-                            // Calculate how many deleted columns are within the range
-                            var overlapStart = Math.max(deletionIndex, rangeStart);
-                            var overlapEnd = Math.min(deletionEnd, rangeEnd);
-                            var colsDeletedInRange = overlapEnd - overlapStart + 1;
-                            // Contract the end of the range
-                            endCell.columnIndex -= colsDeletedInRange;
-                            // If entire range is deleted, result in #REF! (but we'll just contract to minimum)
-                            if (endCell.columnIndex < startCell.columnIndex) {
-                                endCell.columnIndex = startCell.columnIndex;
-                            }
+                        if (overlapsBand(rangeStart, rangeEnd)) {
+                            var survivors = contractSpan(rangeStart, rangeEnd);
+                            startCell.columnIndex = survivors.start;
+                            endCell.columnIndex = survivors.end;
                             var newStartAddress = cellToAddress(startCell, isAbsoluteStartCol, isAbsoluteStartRow);
                             var newEndAddress = cellToAddress(endCell, isAbsoluteEndCol, isAbsoluteEndRow);
                             if (newStartAddress && newEndAddress) {
@@ -387,7 +578,7 @@ export var contractRangesInFormula = function (formula, deletionIndex, count, di
         if (dimension === "column" &&
             token.tokenType.name === tokenVocabulary.Column.name) {
             var isRange = isRangeToken(tokens[i + 1]);
-            if (skipSheet) {
+            if (skipSheet || bandSpan) {
                 if (isRange) {
                     newTokens.push(token, tokens[i + 1], tokens[i + 2]);
                     i += 2;
@@ -397,20 +588,19 @@ export var contractRangesInFormula = function (formula, deletionIndex, count, di
             if (isRange && tokens[i + 2]) {
                 var startColumnIndex = alpha2number(token.image);
                 var endColumnIndex = alpha2number(tokens[i + 2].image);
-                // Check if deletion overlaps with range
-                if (deletionIndex <= endColumnIndex &&
-                    deletionEnd >= startColumnIndex) {
-                    // Calculate how many deleted columns are within the range
-                    var overlapStart = Math.max(deletionIndex, startColumnIndex);
-                    var overlapEnd = Math.min(deletionEnd, endColumnIndex);
-                    var colsDeletedInRange = overlapEnd - overlapStart + 1;
-                    // Contract the end column
-                    var newEndColumnIndex = endColumnIndex - colsDeletedInRange;
-                    // If entire range is deleted, keep at minimum
-                    if (newEndColumnIndex >= startColumnIndex) {
-                        tokens[i + 2].image = number2Alpha(newEndColumnIndex - 1);
+                if (overlapsBand(startColumnIndex, endColumnIndex)) {
+                    // Every column deleted → #REF!; otherwise the survivors close up.
+                    if (startColumnIndex >= deletionIndex &&
+                        endColumnIndex <= deletionEnd) {
+                        newTokens.push(collapseToRefError(token, tokens[i + 2]));
+                        i += 2;
                         hasChanges = true;
+                        continue;
                     }
+                    var survivors = contractSpan(startColumnIndex, endColumnIndex);
+                    token.image = number2Alpha(survivors.start - 1);
+                    tokens[i + 2].image = number2Alpha(survivors.end - 1);
+                    hasChanges = true;
                 }
                 newTokens.push(token, tokens[i + 1], tokens[i + 2]);
                 i += 2;
@@ -421,7 +611,7 @@ export var contractRangesInFormula = function (formula, deletionIndex, count, di
         if (dimension === "row" &&
             token.tokenType.name === tokenVocabulary.Number.name) {
             var isRange = isRangeToken(tokens[i + 1]);
-            if (skipSheet) {
+            if (skipSheet || bandSpan) {
                 if (isRange) {
                     newTokens.push(token, tokens[i + 1], tokens[i + 2]);
                     i += 2;
@@ -433,19 +623,18 @@ export var contractRangesInFormula = function (formula, deletionIndex, count, di
                 tokens[i + 2].tokenType.name === tokenVocabulary.Number.name) {
                 var startRowIndex = Number(token.image);
                 var endRowIndex = Number(tokens[i + 2].image);
-                // Check if deletion overlaps with range
-                if (deletionIndex <= endRowIndex && deletionEnd >= startRowIndex) {
-                    // Calculate how many deleted rows are within the range
-                    var overlapStart = Math.max(deletionIndex, startRowIndex);
-                    var overlapEnd = Math.min(deletionEnd, endRowIndex);
-                    var rowsDeletedInRange = overlapEnd - overlapStart + 1;
-                    // Contract the end row
-                    var newEndRowIndex = endRowIndex - rowsDeletedInRange;
-                    // If entire range is deleted, keep at minimum
-                    if (newEndRowIndex >= startRowIndex) {
-                        tokens[i + 2].image = String(newEndRowIndex);
+                if (overlapsBand(startRowIndex, endRowIndex)) {
+                    // Every row deleted → #REF!; otherwise the survivors close up.
+                    if (startRowIndex >= deletionIndex && endRowIndex <= deletionEnd) {
+                        newTokens.push(collapseToRefError(token, tokens[i + 2]));
+                        i += 2;
                         hasChanges = true;
+                        continue;
                     }
+                    var survivors = contractSpan(startRowIndex, endRowIndex);
+                    token.image = String(survivors.start);
+                    tokens[i + 2].image = String(survivors.end);
+                    hasChanges = true;
                 }
                 newTokens.push(token, tokens[i + 1], tokens[i + 2]);
                 i += 2;

package/dist/cjs/api/immer-utils.d.ts

@@ -1,12 +1,22 @@
 import type { RowDataWithValue as SpreadsheetRowDataWithValue, SheetData as SpreadsheetSheetData } from "@rowsncolumns/common-types";
 import type { CellNode, CellRangeNode, StaticNode } from "@rowsncolumns/dag";
-import type { CellData, NumberFormat, NumberFormatType, ParsedToken } from "@rowsncolumns/spreadsheet";
+import type { CellData, DimensionProperties, NumberFormat, NumberFormatType, ParsedToken } from "@rowsncolumns/spreadsheet";
 import { type Draft } from "immer";
 import type { CellXfsRegistry } from "../hooks/use-cellxfs-registry";
 import type { useSheetProperties } from "../hooks/use-sheet-properties";
 type SheetData<T extends CellData> = SpreadsheetSheetData<T>;
 type RowDataWithValue<T extends CellData | null | undefined> = SpreadsheetRowDataWithValue<T>;
 export declare const createSheetDraft: <T extends CellData>(draft: Draft<SheetData<T>>, sheetId: number, rowIndex?: number) => Draft<RowDataWithValue<T | null | undefined>>[];
+/**
+ * Row/column metadata an inserted band inherits — Excel's "Format Same As
+ * Above / Left" (FMT-01 / FMT-02) carries the neighbour's height or width and
+ * hidden state along with its cell formats. The neighbour is the entry just
+ * before `referenceIndex`; an insert at index 1 has none and takes the entry
+ * being pushed away instead. The `collapsed` outline marker and filter-hiding
+ * stay with the original row / column. Returns `undefined` when there is
+ * nothing to inherit.
+ */
+export declare const inheritedDimensionMetadata: (metadata: readonly (DimensionProperties | null | undefined)[], referenceIndex: number) => DimensionProperties | undefined;
 export declare const cloneRowWithFormatting: <T extends CellData>(rowData: Draft<RowDataWithValue<T | null | undefined>> | undefined) => Draft<RowDataWithValue<T | null | undefined>>;
 export declare const cloneCellWithFormatting: <T extends CellData>(celLData: Draft<T> | undefined | null) => Draft<T> | null;
 export declare const getFunctionNamesFromFormula: (formula: string) => string[];

package/dist/cjs/api/immer-utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"immer-utils.d.ts","sourceRoot":"","sources":["../../../api/immer-utils.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"immer-utils.d.ts","sourceRoot":"","sources":["../../../api/immer-utils.ts"],"names":[],"mappings":"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"}

package/dist/cjs/api/immer-utils.js

@@ -1,4 +1,4 @@
-import { __assign, __generator, __read, __values } from "tslib";
+import { __assign, __generator, __read, __rest, __values } from "tslib";
 import { isStaticNode } from "@rowsncolumns/dag";
 import { isCellCoordinate } from "@rowsncolumns/dag";
 import { tokenVocabulary } from "@rowsncolumns/fast-formula-parser";
@@ -20,6 +20,22 @@ export var createSheetDraft = function (draft, sheetId, rowIndex) {
     }
     return sheet;
 };
+/**
+ * Row/column metadata an inserted band inherits — Excel's "Format Same As
+ * Above / Left" (FMT-01 / FMT-02) carries the neighbour's height or width and
+ * hidden state along with its cell formats. The neighbour is the entry just
+ * before `referenceIndex`; an insert at index 1 has none and takes the entry
+ * being pushed away instead. The `collapsed` outline marker and filter-hiding
+ * stay with the original row / column. Returns `undefined` when there is
+ * nothing to inherit.
+ */
+export var inheritedDimensionMetadata = function (metadata, referenceIndex) {
+    var source = metadata[referenceIndex > 1 ? referenceIndex - 1 : referenceIndex];
+    if (!source)
+        return undefined;
+    var _collapsed = source.collapsed, _hiddenByFilter = source.hiddenByFilter, inherited = __rest(source, ["collapsed", "hiddenByFilter"]);
+    return Object.keys(inherited).length ? inherited : undefined;
+};
 // Clone entire row
 export var cloneRowWithFormatting = function (rowData) {
     var _a;

package/dist/cjs/api/insert-cut-cells.d.ts

@@ -0,0 +1,35 @@
+import type { GridRange } from "@rowsncolumns/common-types";
+/** How the destination band opens for an Insert Cut Cells block move. */
+export type InsertCutCellsShift = "down" | "right";
+export type InsertCutCellsPlan = {
+    /**
+     * `"down"` for a vertical move (the block changes rows), `"right"` when it slides along its
+     * own rows — the axis the destination band opens and the vacated source closes along.
+     */
+    shift: InsertCutCellsShift;
+    /**
+     * The source once the destination band has opened: it slides along by the block's size when
+     * it sits in that band (a block dragged UP within its own columns), else it is `from` as is.
+     */
+    shiftedSource: GridRange;
+    /**
+     * The bands the move shifts (each open-ended along `shift`): the destination band from `to`
+     * on, and the source band from the block on. A merge one of them covers only partially would
+     * be torn — Excel refuses the move ("We can't do that to a merged cell.").
+     */
+    bands: GridRange[];
+};
+/**
+ * Excel "Insert Cut Cells" / Shift+drag of a cell block, as the three structural steps the
+ * legacy hooks already own: open the destination band (`insertCells…` at `to`), move the block
+ * into the opening, then close the gap the block left (`deleteCells…` on the vacated source).
+ * The sheet keeps its cell count — Shift+drag A5 to A2 over r1..r6 gives r1 r5 r2 r3 r4 r6, never
+ * a blank — and a forward move within its own lanes lands `size` lines before `to`, Excel's
+ * pre-removal reference (cut A2, drop at row 6 → r1 r3 r4 r5 r2 r6), because the closing shift
+ * pulls the landed block up. `null` when the move is a no-op (the drop is inside the block or
+ * right after it) or cannot land the block whole (destination lanes overlapping the source
+ * lanes only partially — the closing shift would tear the block); the rnc engine's
+ * `move-range { insert }` applies the same rules.
+ */
+export declare const planInsertCutCells: (from: GridRange, to: GridRange) => InsertCutCellsPlan | null;
+//# sourceMappingURL=insert-cut-cells.d.ts.map

package/dist/cjs/api/insert-cut-cells.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"insert-cut-cells.d.ts","sourceRoot":"","sources":["../../../api/insert-cut-cells.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AAG5D,yEAAyE;AACzE,MAAM,MAAM,mBAAmB,GAAG,MAAM,GAAG,OAAO,CAAC;AAEnD,MAAM,MAAM,kBAAkB,GAAG;IAC/B;;;OAGG;IACH,KAAK,EAAE,mBAAmB,CAAC;IAC3B;;;OAGG;IACH,aAAa,EAAE,SAAS,CAAC;IACzB;;;;OAIG;IACH,KAAK,EAAE,SAAS,EAAE,CAAC;CACpB,CAAC;AAIF;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,kBAAkB,GAC7B,MAAM,SAAS,EACf,IAAI,SAAS,KACZ,kBAAkB,GAAG,IAsDvB,CAAC"}

package/dist/cjs/api/insert-cut-cells.js

@@ -0,0 +1,60 @@
+import { __assign, __read } from "tslib";
+import { areaIntersects } from "@rowsncolumns/grid";
+var LAST_INDEX = Number.MAX_SAFE_INTEGER;
+/**
+ * Excel "Insert Cut Cells" / Shift+drag of a cell block, as the three structural steps the
+ * legacy hooks already own: open the destination band (`insertCells…` at `to`), move the block
+ * into the opening, then close the gap the block left (`deleteCells…` on the vacated source).
+ * The sheet keeps its cell count — Shift+drag A5 to A2 over r1..r6 gives r1 r5 r2 r3 r4 r6, never
+ * a blank — and a forward move within its own lanes lands `size` lines before `to`, Excel's
+ * pre-removal reference (cut A2, drop at row 6 → r1 r3 r4 r5 r2 r6), because the closing shift
+ * pulls the landed block up. `null` when the move is a no-op (the drop is inside the block or
+ * right after it) or cannot land the block whole (destination lanes overlapping the source
+ * lanes only partially — the closing shift would tear the block); the rnc engine's
+ * `move-range { insert }` applies the same rules.
+ */
+export var planInsertCutCells = function (from, to) {
+    if (areaIntersects(from, to)) {
+        return null;
+    }
+    var shift = to.startRowIndex === from.startRowIndex ? "right" : "down";
+    var vertical = shift === "down";
+    // (line, lane): the axis the bands shift along, and the perpendicular index.
+    var _a = __read(vertical
+        ? [
+            from.startRowIndex,
+            from.endRowIndex,
+            from.startColumnIndex,
+            from.endColumnIndex,
+            to.startRowIndex,
+            to.startColumnIndex,
+        ]
+        : [
+            from.startColumnIndex,
+            from.endColumnIndex,
+            from.startRowIndex,
+            from.endRowIndex,
+            to.startColumnIndex,
+            to.startRowIndex,
+        ], 6), l1 = _a[0], l2 = _a[1], k1 = _a[2], k2 = _a[3], t = _a[4], tk1 = _a[5];
+    var size = l2 - l1 + 1;
+    var tk2 = tk1 + (k2 - k1);
+    var lanesMeet = tk1 <= k2 && tk2 >= k1;
+    if (lanesMeet && tk1 !== k1) {
+        return null;
+    }
+    if (lanesMeet && t > l1 && t <= l2 + 1) {
+        return null;
+    }
+    // Opening the destination band above the block slides the block along with it.
+    var slides = lanesMeet && t < l1;
+    var shiftedSource = !slides
+        ? from
+        : vertical
+            ? __assign(__assign({}, from), { startRowIndex: from.startRowIndex + size, endRowIndex: from.endRowIndex + size }) : __assign(__assign({}, from), { startColumnIndex: from.startColumnIndex + size, endColumnIndex: from.endColumnIndex + size });
+    var band = function (range) {
+        return vertical
+            ? __assign(__assign({}, range), { endRowIndex: LAST_INDEX }) : __assign(__assign({}, range), { endColumnIndex: LAST_INDEX });
+    };
+    return { shift: shift, shiftedSource: shiftedSource, bands: [band(to), band(from)] };
+};

package/dist/cjs/api/merges.d.ts

@@ -1,7 +1,23 @@
 import type { GridRange } from "@rowsncolumns/common-types";
+/** Excel's refusal when a move / cut-paste / shift would tear a merged cell. */
+export declare const MERGED_CELL_MOVE_ERROR = "We can't do that to a merged cell.";
+/**
+ * The first merge that `range` covers only PARTIALLY (it intersects the range without being
+ * wholly inside it). Excel refuses any move, cut + paste or cell shift whose source or destination
+ * does that ("We can't do that to a merged cell."); merges wholly inside the range travel intact.
+ */
+export declare const findPartiallyCoveredMerge: (range: GridRange, merges: GridRange[] | undefined | null) => GridRange | undefined;
 export declare const moveMergedCells: (mergedCells: GridRange[] | undefined | null, op: "column-insert" | "row-insert" | "column-remove" | "row-remove", referenceIndex: number, count?: number, condition?: (area: GridRange) => boolean) => GridRange[] | null | undefined;
 export declare const shrinkMergesOnRowDelete: (merges: GridRange[], deleteStart: number, deleteCount: number) => GridRange[];
 export declare const shrinkMergesOnColumnDelete: (merges: GridRange[], deleteStart: number, deleteCount: number) => GridRange[];
 export declare const expandMergesOnRowInsert: (merges: GridRange[], insertIndex: number, count: number) => GridRange[];
 export declare const expandMergesOnColumnInsert: (merges: GridRange[], insertIndex: number, count: number) => GridRange[];
+/**
+ * Merges that travel with an insert/delete-cells shift: a merge wholly inside the shifted band
+ * (rows `>= start` in the band's columns for a vertical shift; columns `>= start` in its rows for a
+ * horizontal one) moves by `count`; on a delete, a merge wholly inside the deleted block is dropped
+ * with it. Merges the band only partially covers are refused upstream (`findTornMerge`) — this
+ * helper never tears one, it leaves anything outside the band untouched.
+ */
+export declare const shiftMergesInBand: (merges: GridRange[] | undefined | null, axis: "row" | "column", start: number, count: number, insert: boolean, spanStart: number, spanEnd: number) => GridRange[] | null | undefined;
 //# sourceMappingURL=merges.d.ts.map

package/dist/cjs/api/merges.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"merges.d.ts","sourceRoot":"","sources":["../../../api/merges.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AAY5D,eAAO,MAAM,eAAe,GAC1B,aAAa,SAAS,EAAE,GAAG,SAAS,GAAG,IAAI,EAC3C,IAAI,eAAe,GAAG,YAAY,GAAG,eAAe,GAAG,YAAY,EACnE,gBAAgB,MAAM,EACtB,cAAS,EACT,YAAY,CAAC,IAAI,EAAE,SAAS,KAAK,OAAO,mCA2DzC,CAAC;AAEF,eAAO,MAAM,uBAAuB,GAClC,QAAQ,SAAS,EAAE,EACnB,aAAa,MAAM,EACnB,aAAa,MAAM,gBA8CpB,CAAC;AAEF,eAAO,MAAM,0BAA0B,GACrC,QAAQ,SAAS,EAAE,EACnB,aAAa,MAAM,EACnB,aAAa,MAAM,gBA8CpB,CAAC;AAEF,eAAO,MAAM,uBAAuB,GAClC,QAAQ,SAAS,EAAE,EACnB,aAAa,MAAM,EACnB,OAAO,MAAM,gBAyBd,CAAC;AAEF,eAAO,MAAM,0BAA0B,GACrC,QAAQ,SAAS,EAAE,EACnB,aAAa,MAAM,EACnB,OAAO,MAAM,gBAyBd,CAAC"}
+{"version":3,"file":"merges.d.ts","sourceRoot":"","sources":["../../../api/merges.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AAG5D,gFAAgF;AAChF,eAAO,MAAM,sBAAsB,uCAAuC,CAAC;AAE3E;;;;GAIG;AACH,eAAO,MAAM,yBAAyB,GACpC,OAAO,SAAS,EAChB,QAAQ,SAAS,EAAE,GAAG,SAAS,GAAG,IAAI,KACrC,SAAS,GAAG,SAGZ,CAAC;AAYJ,eAAO,MAAM,eAAe,GAC1B,aAAa,SAAS,EAAE,GAAG,SAAS,GAAG,IAAI,EAC3C,IAAI,eAAe,GAAG,YAAY,GAAG,eAAe,GAAG,YAAY,EACnE,gBAAgB,MAAM,EACtB,cAAS,EACT,YAAY,CAAC,IAAI,EAAE,SAAS,KAAK,OAAO,mCA2DzC,CAAC;AAEF,eAAO,MAAM,uBAAuB,GAClC,QAAQ,SAAS,EAAE,EACnB,aAAa,MAAM,EACnB,aAAa,MAAM,gBA8CpB,CAAC;AAEF,eAAO,MAAM,0BAA0B,GACrC,QAAQ,SAAS,EAAE,EACnB,aAAa,MAAM,EACnB,aAAa,MAAM,gBA8CpB,CAAC;AAEF,eAAO,MAAM,uBAAuB,GAClC,QAAQ,SAAS,EAAE,EACnB,aAAa,MAAM,EACnB,OAAO,MAAM,gBAyBd,CAAC;AAEF,eAAO,MAAM,0BAA0B,GACrC,QAAQ,SAAS,EAAE,EACnB,aAAa,MAAM,EACnB,OAAO,MAAM,gBAyBd,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,iBAAiB,GAC5B,QAAQ,SAAS,EAAE,GAAG,SAAS,GAAG,IAAI,EACtC,MAAM,KAAK,GAAG,QAAQ,EACtB,OAAO,MAAM,EACb,OAAO,MAAM,EACb,QAAQ,OAAO,EACf,WAAW,MAAM,EACjB,SAAS,MAAM,mCAkDhB,CAAC"}