@rowsncolumns/spreadsheet-state 28.0.75 → 29.0.0

package/dist/esm/api/formula.js

@@ -1,4 +1,4 @@
-import { isRangeToken, lexify, stripPropertyFromCellRef, tokenVocabulary, } from "@rowsncolumns/calculator";
+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";
 /**
@@ -65,6 +65,138 @@ export const updateColumnName = (formulaValue, newName, oldName) => {
     }
     return detokenize(newTokens);
 };
+/** The column specifier Excel writes for a deleted table column (`Table1[@#REF!]`). */
+export const REF_ERROR_COLUMN = "#REF!";
+const 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! )`.
+ */
+const collapseToRefError = (start, end) => ({
+    ...start,
+    image: REF_ERROR_TOKEN,
+    tokenType: tokenVocabulary.RefError,
+    endOffset: end?.endOffset ?? start.endOffset,
+    endColumn: end?.endColumn ?? start.endColumn,
+});
+const isTableNameToken = (token) => token?.tokenType.name === tokenVocabulary.TableName.name;
+const isTableColumnToken = (token) => token?.tokenType.name === tokenVocabulary.TableColumnName.name;
+/** Bracket depth change contributed by one token's image (`Table1[` opens, `Qty]` closes). */
+const bracketDelta = (image) => {
+    let depth = 0;
+    for (const ch of image) {
+        if (ch === "[")
+            depth++;
+        else if (ch === "]")
+            depth--;
+    }
+    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.
+ */
+const structuredReferenceEnd = (tokens, start) => {
+    let depth = 0;
+    let 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 const breakTableReferencesInFormula = (formulaValue, tableName) => {
+    if (!formulaValue.includes("["))
+        return formulaValue;
+    const tokens = cloneTokens(lexify(formulaValue).tokens);
+    const newTokens = [];
+    const target = tableName.toLowerCase();
+    let hasChanges = false;
+    for (let i = 0; i < tokens.length; i++) {
+        const token = tokens[i];
+        if (isTableNameToken(token) &&
+            cleanupTableName(token.image).trim().toLowerCase() === target) {
+            const end = structuredReferenceEnd(tokens, i);
+            const last = tokens[end - 1] ?? token;
+            newTokens.push({
+                ...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 const breakTableColumnsInFormula = (formulaValue, tableName, columnNames) => {
+    if (!formulaValue.includes("[") || columnNames.length === 0) {
+        return formulaValue;
+    }
+    const targets = new Set(columnNames.map((name) => name.toLowerCase()));
+    const target = tableName?.toLowerCase();
+    const tokens = cloneTokens(lexify(formulaValue).tokens);
+    let hasChanges = false;
+    let i = 0;
+    while (i < tokens.length) {
+        const token = tokens[i];
+        if (isTableNameToken(token)) {
+            const end = structuredReferenceEnd(tokens, i);
+            const matches = target !== undefined &&
+                cleanupTableName(token.image).trim().toLowerCase() === target;
+            if (matches) {
+                for (let 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;
+};
+const breakColumnToken = (token, targets) => {
+    if (!token || !isTableColumnToken(token))
+        return false;
+    const name = cleanupColumnName(token.image);
+    if (!name || !targets.has(name.toLowerCase()))
+        return false;
+    const 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
@@ -122,19 +254,33 @@ export const isAbsoluteRowReference = (formula) => {
         return false;
     return /\$\d+/gi.test(formula);
 };
+const isRangeWithinBandSpan = (startCell, endCell, dimension, bandSpan) => {
+    if (!bandSpan)
+        return true;
+    const [start, end] = dimension === "row"
+        ? [startCell.columnIndex, endCell.columnIndex]
+        : [startCell.rowIndex, endCell.rowIndex];
+    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 const expandRangesInFormula = (formula, insertionIndex, count, dimension, activeSheetName) => {
+export const expandRangesInFormula = (formula, insertionIndex, count, dimension, activeSheetName, options = {}) => {
     if (!formula || count <= 0) {
         return formula;
     }
+    const { includeUnqualifiedReferences = true, bandSpan } = options;
     const normalizedActiveSheetName = activeSheetName.toLowerCase();
     const tokens = cloneTokens(lexify(formula).tokens);
     const newTokens = [];
@@ -142,7 +288,9 @@ export const expandRangesInFormula = (formula, insertionIndex, count, dimension,
     for (let i = 0; i < tokens.length; i++) {
         const token = tokens[i];
         const sheetName = getSheetNameFromToken(tokens[i - 1]);
-        const skipSheet = sheetName && sheetName.toLowerCase() !== normalizedActiveSheetName;
+        const skipSheet = sheetName
+            ? sheetName.toLowerCase() !== normalizedActiveSheetName
+            : !includeUnqualifiedReferences;
         // Handle cell ranges (e.g., A1:A10)
         if (token.tokenType.name === tokenVocabulary.Cell.name) {
             const isRange = isRangeToken(tokens[i + 1]);
@@ -157,7 +305,9 @@ export const expandRangesInFormula = (formula, insertionIndex, count, dimension,
             if (isRange && tokens[i + 2]) {
                 const startCell = addressToCell(stripPropertyFromCellRef(token.image));
                 const endCell = addressToCell(stripPropertyFromCellRef(tokens[i + 2].image));
-                if (startCell && endCell) {
+                if (startCell &&
+                    endCell &&
+                    isRangeWithinBandSpan(startCell, endCell, dimension, bandSpan)) {
                     const isAbsoluteEndRow = isAbsoluteRowReference(tokens[i + 2].image);
                     const isAbsoluteEndCol = isAbsoluteColumnReference(tokens[i + 2].image);
                     if (dimension === "row") {
@@ -197,7 +347,7 @@ export const expandRangesInFormula = (formula, insertionIndex, count, dimension,
         if (dimension === "column" &&
             token.tokenType.name === tokenVocabulary.Column.name) {
             const isRange = isRangeToken(tokens[i + 1]);
-            if (skipSheet) {
+            if (skipSheet || bandSpan) {
                 if (isRange) {
                     newTokens.push(token, tokens[i + 1], tokens[i + 2]);
                     i += 2;
@@ -224,7 +374,7 @@ export const expandRangesInFormula = (formula, insertionIndex, count, dimension,
         if (dimension === "row" &&
             token.tokenType.name === tokenVocabulary.Number.name) {
             const isRange = isRangeToken(tokens[i + 1]);
-            if (skipSheet) {
+            if (skipSheet || bandSpan) {
                 if (isRange) {
                     newTokens.push(token, tokens[i + 1], tokens[i + 2]);
                     i += 2;
@@ -257,22 +407,45 @@ export const expandRangesInFormula = (formula, insertionIndex, count, dimension,
  * @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 const contractRangesInFormula = (formula, deletionIndex, count, dimension, activeSheetName) => {
+export const contractRangesInFormula = (formula, deletionIndex, count, dimension, activeSheetName, options = {}) => {
     if (!formula || count <= 0) {
         return formula;
     }
+    const { includeUnqualifiedReferences = true, bandSpan } = options;
     const normalizedActiveSheetName = activeSheetName.toLowerCase();
     const tokens = cloneTokens(lexify(formula).tokens);
     const newTokens = [];
     let hasChanges = false;
     const deletionEnd = deletionIndex + count - 1;
+    const inDeletedBand = (cell) => {
+        const index = dimension === "row" ? cell.rowIndex : cell.columnIndex;
+        return index >= deletionIndex && index <= deletionEnd;
+    };
+    const overlapsBand = (start, end) => 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.
+    const contractSpan = (start, end) => ({
+        start: Math.min(start, deletionIndex),
+        end: end > deletionEnd ? end - count : deletionIndex - 1,
+    });
     for (let i = 0; i < tokens.length; i++) {
         const token = tokens[i];
         const sheetName = getSheetNameFromToken(tokens[i - 1]);
-        const skipSheet = sheetName && sheetName.toLowerCase() !== normalizedActiveSheetName;
+        const skipSheet = sheetName
+            ? sheetName.toLowerCase() !== normalizedActiveSheetName
+            : !includeUnqualifiedReferences;
         // Handle cell ranges (e.g., A1:A10)
         if (token.tokenType.name === tokenVocabulary.Cell.name) {
             const isRange = isRangeToken(tokens[i + 1]);
@@ -284,10 +457,33 @@ export const contractRangesInFormula = (formula, deletionIndex, count, dimension
                 }
                 continue;
             }
+            if (!isRange) {
+                // Single cell: broken when it sits in the deleted band. The trailing
+                // spilled-range operator (`C1#`) stays on the token (`#REF!#`).
+                const spill = token.image.endsWith("#") ? "#" : "";
+                const cell = addressToCell(stripPropertyFromCellRef(spill ? token.image.slice(0, -1) : token.image));
+                if (cell &&
+                    inDeletedBand(cell) &&
+                    isRangeWithinBandSpan(cell, cell, dimension, bandSpan)) {
+                    token.image = `${REF_ERROR_TOKEN}${spill}`;
+                    hasChanges = true;
+                }
+                newTokens.push(token);
+                continue;
+            }
             if (isRange && tokens[i + 2]) {
                 const startCell = addressToCell(stripPropertyFromCellRef(token.image));
                 const 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;
+                    }
                     const isAbsoluteStartRow = isAbsoluteRowReference(token.image);
                     const isAbsoluteEndRow = isAbsoluteRowReference(tokens[i + 2].image);
                     const isAbsoluteStartCol = isAbsoluteColumnReference(token.image);
@@ -295,18 +491,10 @@ export const contractRangesInFormula = (formula, deletionIndex, count, dimension
                     if (dimension === "row") {
                         const rangeStart = startCell.rowIndex;
                         const rangeEnd = endCell.rowIndex;
-                        // Check if deletion overlaps with range
-                        if (deletionIndex <= rangeEnd && deletionEnd >= rangeStart) {
-                            // Calculate how many deleted rows are within the range
-                            const overlapStart = Math.max(deletionIndex, rangeStart);
-                            const overlapEnd = Math.min(deletionEnd, rangeEnd);
-                            const 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)) {
+                            const survivors = contractSpan(rangeStart, rangeEnd);
+                            startCell.rowIndex = survivors.start;
+                            endCell.rowIndex = survivors.end;
                             const newStartAddress = cellToAddress(startCell, isAbsoluteStartCol, isAbsoluteStartRow);
                             const newEndAddress = cellToAddress(endCell, isAbsoluteEndCol, isAbsoluteEndRow);
                             if (newStartAddress && newEndAddress) {
@@ -320,18 +508,10 @@ export const contractRangesInFormula = (formula, deletionIndex, count, dimension
                         // dimension === 'column'
                         const rangeStart = startCell.columnIndex;
                         const rangeEnd = endCell.columnIndex;
-                        // Check if deletion overlaps with range
-                        if (deletionIndex <= rangeEnd && deletionEnd >= rangeStart) {
-                            // Calculate how many deleted columns are within the range
-                            const overlapStart = Math.max(deletionIndex, rangeStart);
-                            const overlapEnd = Math.min(deletionEnd, rangeEnd);
-                            const 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)) {
+                            const survivors = contractSpan(rangeStart, rangeEnd);
+                            startCell.columnIndex = survivors.start;
+                            endCell.columnIndex = survivors.end;
                             const newStartAddress = cellToAddress(startCell, isAbsoluteStartCol, isAbsoluteStartRow);
                             const newEndAddress = cellToAddress(endCell, isAbsoluteEndCol, isAbsoluteEndRow);
                             if (newStartAddress && newEndAddress) {
@@ -351,7 +531,7 @@ export const contractRangesInFormula = (formula, deletionIndex, count, dimension
         if (dimension === "column" &&
             token.tokenType.name === tokenVocabulary.Column.name) {
             const isRange = isRangeToken(tokens[i + 1]);
-            if (skipSheet) {
+            if (skipSheet || bandSpan) {
                 if (isRange) {
                     newTokens.push(token, tokens[i + 1], tokens[i + 2]);
                     i += 2;
@@ -361,20 +541,19 @@ export const contractRangesInFormula = (formula, deletionIndex, count, dimension
             if (isRange && tokens[i + 2]) {
                 const startColumnIndex = alpha2number(token.image);
                 const 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
-                    const overlapStart = Math.max(deletionIndex, startColumnIndex);
-                    const overlapEnd = Math.min(deletionEnd, endColumnIndex);
-                    const colsDeletedInRange = overlapEnd - overlapStart + 1;
-                    // Contract the end column
-                    const 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;
                     }
+                    const 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;
@@ -385,7 +564,7 @@ export const contractRangesInFormula = (formula, deletionIndex, count, dimension
         if (dimension === "row" &&
             token.tokenType.name === tokenVocabulary.Number.name) {
             const isRange = isRangeToken(tokens[i + 1]);
-            if (skipSheet) {
+            if (skipSheet || bandSpan) {
                 if (isRange) {
                     newTokens.push(token, tokens[i + 1], tokens[i + 2]);
                     i += 2;
@@ -397,19 +576,18 @@ export const contractRangesInFormula = (formula, deletionIndex, count, dimension
                 tokens[i + 2].tokenType.name === tokenVocabulary.Number.name) {
                 const startRowIndex = Number(token.image);
                 const 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
-                    const overlapStart = Math.max(deletionIndex, startRowIndex);
-                    const overlapEnd = Math.min(deletionEnd, endRowIndex);
-                    const rowsDeletedInRange = overlapEnd - overlapStart + 1;
-                    // Contract the end row
-                    const 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;
                     }
+                    const 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/esm/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/esm/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/esm/api/immer-utils.js

@@ -18,6 +18,22 @@ export const createSheetDraft = (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 const inheritedDimensionMetadata = (metadata, referenceIndex) => {
+    const source = metadata[referenceIndex > 1 ? referenceIndex - 1 : referenceIndex];
+    if (!source)
+        return undefined;
+    const { collapsed: _collapsed, hiddenByFilter: _hiddenByFilter, ...inherited } = source;
+    return Object.keys(inherited).length ? inherited : undefined;
+};
 // Clone entire row
 export const cloneRowWithFormatting = (rowData) => {
     if (!rowData) {

package/dist/esm/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/esm/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/esm/api/insert-cut-cells.js

@@ -0,0 +1,67 @@
+import { areaIntersects } from "@rowsncolumns/grid";
+const 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 const planInsertCutCells = (from, to) => {
+    if (areaIntersects(from, to)) {
+        return null;
+    }
+    const shift = to.startRowIndex === from.startRowIndex ? "right" : "down";
+    const vertical = shift === "down";
+    // (line, lane): the axis the bands shift along, and the perpendicular index.
+    const [l1, l2, k1, k2, t, tk1] = 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,
+        ];
+    const size = l2 - l1 + 1;
+    const tk2 = tk1 + (k2 - k1);
+    const 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.
+    const slides = lanesMeet && t < l1;
+    const shiftedSource = !slides
+        ? from
+        : vertical
+            ? {
+                ...from,
+                startRowIndex: from.startRowIndex + size,
+                endRowIndex: from.endRowIndex + size,
+            }
+            : {
+                ...from,
+                startColumnIndex: from.startColumnIndex + size,
+                endColumnIndex: from.endColumnIndex + size,
+            };
+    const band = (range) => vertical
+        ? { ...range, endRowIndex: LAST_INDEX }
+        : { ...range, endColumnIndex: LAST_INDEX };
+    return { shift, shiftedSource, bands: [band(to), band(from)] };
+};

package/dist/esm/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/esm/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"}