@rowsncolumns/spreadsheet-state 28.0.75 → 28.0.76

package/dist/cjs/api/anchored-objects.d.ts

@@ -0,0 +1,66 @@
+import type { CellInterface, GridRange } from "@rowsncolumns/common-types";
+import type { EmbeddedChart, EmbeddedObject, ProtectedRange } from "@rowsncolumns/spreadsheet";
+import type { Draft } from "immer";
+/**
+ * Structural (whole row / whole column insert or delete) relocation of the
+ * objects Excel anchors to cells rather than storing inside them: floating
+ * objects (charts, pictures / embeds), the ranges a chart reads, and
+ * AllowEditRange (protected range) rectangles.
+ *
+ * Excel rules (Sheets agree on every one):
+ * - A floating object's anchor cell shifts like any cell: pushed down/right by
+ *   an insert at or before it, pulled up/left by a delete before it. When the
+ *   anchor row/column itself is deleted the object snaps to the first
+ *   surviving cell at the deletion index (Move-and-size / Move-don't-size both
+ *   move; only absolute anchors stay put). Size never changes.
+ * - A range (chart series, AllowEditRange) shifts like a formula reference:
+ *   insert at/before the start moves it, insert strictly inside grows it,
+ *   delete inside shrinks it, delete of the whole span removes it (`#REF!`).
+ *
+ * The span rule here mirrors `shift_facet_span` in `rnc-store` exactly so both
+ * engines relocate identically.
+ */
+export type StructuralAxis = "row" | "column";
+export type StructuralOp = "insert" | "delete";
+/**
+ * Shift the `[start, end]` span of a range along the edited axis. Returns the
+ * new span, or `null` when a delete consumes it entirely.
+ */
+export declare const shiftSpanLikeReference: (start: number, end: number, op: StructuralOp, index: number, count: number) => [number, number] | null;
+/**
+ * Shift a single row/column index the way a cell (and everything anchored to
+ * it) moves: pushed by an insert at or before it, pulled back by a delete
+ * before it, snapped to the deletion index when its own row/column is
+ * removed.
+ */
+export declare const shiftAnchorIndex: (anchorIndex: number, op: StructuralOp, index: number, count: number) => number;
+export declare const shiftAnchorCell: (anchor: CellInterface, axis: StructuralAxis, op: StructuralOp, index: number, count: number) => CellInterface;
+/**
+ * Shift a grid rectangle with the reference rule along one axis. Returns the
+ * same object when nothing moved, a new one when it did, `null` when a delete
+ * consumed the whole span.
+ */
+export declare const shiftGridRangeLikeReference: <R extends GridRange>(range: R, axis: StructuralAxis, op: StructuralOp, index: number, count: number) => R | null;
+/**
+ * Walk a chart spec and rewrite every `SheetRange` it holds on `sheetId` —
+ * `dataRange`, per-series / per-domain `sources`, error-bar `plusRange` /
+ * `minusRange`, and any future range-valued key — with the reference rule.
+ * A range the delete consumes entirely is removed: spliced out of arrays
+ * (`sources`), nulled on properties (`dataRange`) — the chart's `#REF!`.
+ * Unknown keys are left untouched. Mutates in place; returns whether anything
+ * changed.
+ */
+export declare const shiftChartSpecRanges: (spec: unknown, sheetId: number, axis: StructuralAxis, op: StructuralOp, index: number, count: number) => boolean;
+/** Shift the anchor cell of every embed (picture, shape, text box…) on the edited sheet. */
+export declare const shiftEmbedsOnStructuralChange: (draft: Draft<EmbeddedObject>[], sheetId: number, axis: StructuralAxis, op: StructuralOp, index: number, count: number) => void;
+/**
+ * Shift every chart on the edited sheet: its anchor cell like a floating
+ * object, and the ranges inside its spec like references.
+ */
+export declare const shiftChartsOnStructuralChange: (draft: Draft<EmbeddedChart>[], sheetId: number, axis: StructuralAxis, op: StructuralOp, index: number, count: number) => void;
+/**
+ * Shift AllowEditRange rectangles. A protected range without a rectangle
+ * (sheet-scoped protection) is untouched; one the delete consumes is removed.
+ */
+export declare const shiftProtectedRangesOnStructuralChange: (draft: Draft<ProtectedRange>[], sheetId: number, axis: StructuralAxis, op: StructuralOp, index: number, count: number) => void;
+//# sourceMappingURL=anchored-objects.d.ts.map

package/dist/cjs/api/anchored-objects.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"anchored-objects.d.ts","sourceRoot":"","sources":["../../../api/anchored-objects.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,aAAa,EACb,SAAS,EAEV,MAAM,4BAA4B,CAAC;AACpC,OAAO,KAAK,EACV,aAAa,EACb,cAAc,EACd,cAAc,EACf,MAAM,2BAA2B,CAAC;AACnC,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,OAAO,CAAC;AAEnC;;;;;;;;;;;;;;;;;;GAkBG;AAEH,MAAM,MAAM,cAAc,GAAG,KAAK,GAAG,QAAQ,CAAC;AAC9C,MAAM,MAAM,YAAY,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAE/C;;;GAGG;AACH,eAAO,MAAM,sBAAsB,GACjC,OAAO,MAAM,EACb,KAAK,MAAM,EACX,IAAI,YAAY,EAChB,OAAO,MAAM,EACb,OAAO,MAAM,KACZ,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAerB,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB,GAC3B,aAAa,MAAM,EACnB,IAAI,YAAY,EAChB,OAAO,MAAM,EACb,OAAO,MAAM,KACZ,MASF,CAAC;AAEF,eAAO,MAAM,eAAe,GAC1B,QAAQ,aAAa,EACrB,MAAM,cAAc,EACpB,IAAI,YAAY,EAChB,OAAO,MAAM,EACb,OAAO,MAAM,KACZ,aASF,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,2BAA2B,GAAI,CAAC,SAAS,SAAS,EAC7D,OAAO,CAAC,EACR,MAAM,cAAc,EACpB,IAAI,YAAY,EAChB,OAAO,MAAM,EACb,OAAO,MAAM,KACZ,CAAC,GAAG,IAgBN,CAAC;AAgBF;;;;;;;;GAQG;AACH,eAAO,MAAM,oBAAoB,GAC/B,MAAM,OAAO,EACb,SAAS,MAAM,EACf,MAAM,cAAc,EACpB,IAAI,YAAY,EAChB,OAAO,MAAM,EACb,OAAO,MAAM,KACZ,OAoCF,CAAC;AAEF,4FAA4F;AAC5F,eAAO,MAAM,6BAA6B,GACxC,OAAO,KAAK,CAAC,cAAc,CAAC,EAAE,EAC9B,SAAS,MAAM,EACf,MAAM,cAAc,EACpB,IAAI,YAAY,EAChB,OAAO,MAAM,EACb,OAAO,MAAM,SAUd,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,6BAA6B,GACxC,OAAO,KAAK,CAAC,aAAa,CAAC,EAAE,EAC7B,SAAS,MAAM,EACf,MAAM,cAAc,EACpB,IAAI,YAAY,EAChB,OAAO,MAAM,EACb,OAAO,MAAM,SAad,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,sCAAsC,GACjD,OAAO,KAAK,CAAC,cAAc,CAAC,EAAE,EAC9B,SAAS,MAAM,EACf,MAAM,cAAc,EACpB,IAAI,YAAY,EAChB,OAAO,MAAM,EACb,OAAO,MAAM,SAyCd,CAAC"}

package/dist/cjs/api/anchored-objects.js

@@ -0,0 +1,259 @@
+import { __assign, __read, __values } from "tslib";
+/**
+ * Shift the `[start, end]` span of a range along the edited axis. Returns the
+ * new span, or `null` when a delete consumes it entirely.
+ */
+export var shiftSpanLikeReference = function (start, end, op, index, count) {
+    if (count <= 0)
+        return [start, end];
+    if (op === "insert") {
+        if (index <= start)
+            return [start + count, end + count];
+        if (index <= end)
+            return [start, end + count];
+        return [start, end];
+    }
+    var deleteEnd = index + count - 1;
+    if (start > deleteEnd)
+        return [start - count, end - count];
+    if (end < index)
+        return [start, end];
+    var nextStart = start < index ? start : start > deleteEnd ? start - count : index;
+    var nextEnd = end < index ? end : end > deleteEnd ? end - count : index - 1;
+    if (nextStart > nextEnd)
+        return null;
+    return [nextStart, nextEnd];
+};
+/**
+ * Shift a single row/column index the way a cell (and everything anchored to
+ * it) moves: pushed by an insert at or before it, pulled back by a delete
+ * before it, snapped to the deletion index when its own row/column is
+ * removed.
+ */
+export var shiftAnchorIndex = function (anchorIndex, op, index, count) {
+    if (count <= 0)
+        return anchorIndex;
+    if (op === "insert") {
+        return anchorIndex >= index ? anchorIndex + count : anchorIndex;
+    }
+    var deleteEnd = index + count - 1;
+    if (anchorIndex > deleteEnd)
+        return anchorIndex - count;
+    if (anchorIndex >= index)
+        return Math.max(1, index);
+    return anchorIndex;
+};
+export var shiftAnchorCell = function (anchor, axis, op, index, count) {
+    if (axis === "row") {
+        var rowIndex = shiftAnchorIndex(anchor.rowIndex, op, index, count);
+        return rowIndex === anchor.rowIndex ? anchor : __assign(__assign({}, anchor), { rowIndex: rowIndex });
+    }
+    var columnIndex = shiftAnchorIndex(anchor.columnIndex, op, index, count);
+    return columnIndex === anchor.columnIndex
+        ? anchor
+        : __assign(__assign({}, anchor), { columnIndex: columnIndex });
+};
+/**
+ * Shift a grid rectangle with the reference rule along one axis. Returns the
+ * same object when nothing moved, a new one when it did, `null` when a delete
+ * consumed the whole span.
+ */
+export var shiftGridRangeLikeReference = function (range, axis, op, index, count) {
+    var _a;
+    var _b = __read(axis === "row"
+        ? ["startRowIndex", "endRowIndex"]
+        : ["startColumnIndex", "endColumnIndex"], 2), startKey = _b[0], endKey = _b[1];
+    var span = shiftSpanLikeReference(range[startKey], range[endKey], op, index, count);
+    if (!span)
+        return null;
+    var _c = __read(span, 2), start = _c[0], end = _c[1];
+    if (start === range[startKey] && end === range[endKey])
+        return range;
+    return __assign(__assign({}, range), (_a = {}, _a[startKey] = start, _a[endKey] = end, _a));
+};
+var isSheetRangeLike = function (value) {
+    if (!value || typeof value !== "object" || Array.isArray(value))
+        return false;
+    var v = value;
+    return (typeof v.sheetId === "number" &&
+        typeof v.startRowIndex === "number" &&
+        typeof v.endRowIndex === "number" &&
+        typeof v.startColumnIndex === "number" &&
+        typeof v.endColumnIndex === "number");
+};
+/**
+ * Walk a chart spec and rewrite every `SheetRange` it holds on `sheetId` —
+ * `dataRange`, per-series / per-domain `sources`, error-bar `plusRange` /
+ * `minusRange`, and any future range-valued key — with the reference rule.
+ * A range the delete consumes entirely is removed: spliced out of arrays
+ * (`sources`), nulled on properties (`dataRange`) — the chart's `#REF!`.
+ * Unknown keys are left untouched. Mutates in place; returns whether anything
+ * changed.
+ */
+export var shiftChartSpecRanges = function (spec, sheetId, axis, op, index, count) {
+    var changed = false;
+    var shiftRange = function (range) {
+        if (range.sheetId !== sheetId)
+            return range;
+        var next = shiftGridRangeLikeReference(range, axis, op, index, count);
+        if (next !== range)
+            changed = true;
+        return next;
+    };
+    var walk = function (node) {
+        var e_1, _a;
+        if (!node || typeof node !== "object")
+            return;
+        if (Array.isArray(node)) {
+            for (var i = node.length - 1; i >= 0; i--) {
+                var item = node[i];
+                if (isSheetRangeLike(item)) {
+                    var next = shiftRange(item);
+                    if (next === null)
+                        node.splice(i, 1);
+                    else if (next !== item)
+                        node[i] = next;
+                }
+                else {
+                    walk(item);
+                }
+            }
+            return;
+        }
+        var obj = node;
+        try {
+            for (var _b = __values(Object.keys(obj)), _c = _b.next(); !_c.done; _c = _b.next()) {
+                var key = _c.value;
+                var value = obj[key];
+                if (isSheetRangeLike(value)) {
+                    var next = shiftRange(value);
+                    if (next !== value)
+                        obj[key] = next;
+                }
+                else {
+                    walk(value);
+                }
+            }
+        }
+        catch (e_1_1) { e_1 = { error: e_1_1 }; }
+        finally {
+            try {
+                if (_c && !_c.done && (_a = _b.return)) _a.call(_b);
+            }
+            finally { if (e_1) throw e_1.error; }
+        }
+    };
+    walk(spec);
+    return changed;
+};
+/** Shift the anchor cell of every embed (picture, shape, text box…) on the edited sheet. */
+export var shiftEmbedsOnStructuralChange = function (draft, sheetId, axis, op, index, count) {
+    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 embed = draft_1_1.value;
+            var position = embed.position;
+            if (!position || position.sheetId !== sheetId)
+                continue;
+            var overlay = position.overlayPosition;
+            if (!(overlay === null || overlay === void 0 ? void 0 : overlay.anchorCell))
+                continue;
+            var next = shiftAnchorCell(overlay.anchorCell, axis, op, index, count);
+            if (next !== overlay.anchorCell)
+                overlay.anchorCell = next;
+        }
+    }
+    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);
+        }
+        finally { if (e_2) throw e_2.error; }
+    }
+};
+/**
+ * Shift every chart on the edited sheet: its anchor cell like a floating
+ * object, and the ranges inside its spec like references.
+ */
+export var shiftChartsOnStructuralChange = function (draft, sheetId, axis, op, index, count) {
+    var e_3, _a;
+    var _b;
+    try {
+        for (var draft_2 = __values(draft), draft_2_1 = draft_2.next(); !draft_2_1.done; draft_2_1 = draft_2.next()) {
+            var chart = draft_2_1.value;
+            var position = chart.position;
+            if ((position === null || position === void 0 ? void 0 : position.sheetId) === sheetId && ((_b = position.overlayPosition) === null || _b === void 0 ? void 0 : _b.anchorCell)) {
+                var overlay = position.overlayPosition;
+                var next = shiftAnchorCell(overlay.anchorCell, axis, op, index, count);
+                if (next !== overlay.anchorCell)
+                    overlay.anchorCell = next;
+            }
+            // Series ranges may point at ANY sheet, so the spec walk is not gated on
+            // the chart's own sheet.
+            shiftChartSpecRanges(chart.spec, sheetId, axis, op, index, count);
+        }
+    }
+    catch (e_3_1) { e_3 = { error: e_3_1 }; }
+    finally {
+        try {
+            if (draft_2_1 && !draft_2_1.done && (_a = draft_2.return)) _a.call(draft_2);
+        }
+        finally { if (e_3) throw e_3.error; }
+    }
+};
+/**
+ * Shift AllowEditRange rectangles. A protected range without a rectangle
+ * (sheet-scoped protection) is untouched; one the delete consumes is removed.
+ */
+export var shiftProtectedRangesOnStructuralChange = function (draft, sheetId, axis, op, index, count) {
+    var e_4, _a;
+    var _b = __read(axis === "row"
+        ? ["startRowIndex", "endRowIndex"]
+        : ["startColumnIndex", "endColumnIndex"], 2), startKey = _b[0], endKey = _b[1];
+    for (var i = draft.length - 1; i >= 0; i--) {
+        var protectedRange = draft[i];
+        var range = protectedRange.range;
+        if (range.sheetId !== sheetId)
+            continue;
+        var start = range[startKey];
+        var end = range[endKey];
+        if (typeof start !== "number" || typeof end !== "number")
+            continue;
+        var span = shiftSpanLikeReference(start, end, op, index, count);
+        if (!span) {
+            draft.splice(i, 1);
+            continue;
+        }
+        if (span[0] !== start)
+            range[startKey] = span[0];
+        if (span[1] !== end)
+            range[endKey] = span[1];
+        if (protectedRange.unprotectedRanges) {
+            var kept = [];
+            var unprotectedChanged = false;
+            try {
+                for (var _c = (e_4 = void 0, __values(protectedRange.unprotectedRanges)), _d = _c.next(); !_d.done; _d = _c.next()) {
+                    var unprotected = _d.value;
+                    if (unprotected.sheetId !== sheetId) {
+                        kept.push(unprotected);
+                        continue;
+                    }
+                    var next = shiftGridRangeLikeReference(unprotected, axis, op, index, count);
+                    if (next !== unprotected)
+                        unprotectedChanged = true;
+                    if (next)
+                        kept.push(next);
+                }
+            }
+            catch (e_4_1) { e_4 = { error: e_4_1 }; }
+            finally {
+                try {
+                    if (_d && !_d.done && (_a = _c.return)) _a.call(_c);
+                }
+                finally { if (e_4) throw e_4.error; }
+            }
+            if (unprotectedChanged)
+                protectedRange.unprotectedRanges = kept;
+        }
+    }
+};

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

@@ -3,8 +3,8 @@ import type { CellData } from "@rowsncolumns/spreadsheet";
 import type { Draft } from "immer";
 import type { useCalculation } from "../hooks/use-calculation";
 import type { CellXfsRegistry } from "../hooks/use-cellxfs-registry";
-import type { SharedStringRegistry } from "../hooks/use-ss-registry";
 import type { SheetData } from "../hooks/use-spreadsheet-state";
+import type { SharedStringRegistry } from "../hooks/use-ss-registry";
 import type { RecalcCellCoordinate } from "../types";
 type ProcessDependentCellsProps<T extends CellData> = {
     rowIndex: number;
@@ -38,7 +38,7 @@ export declare const collectUniqueDependentsForRange: <T extends CellData>(param
     rowIndex: number;
     columnIndex: number;
 }>;
-export declare const moveFormulaAtPosition: <T extends CellData>({ draft, position, destinationSheetId, activeSheetName, enqueueCalculation, enqueueGraphOperation, recalcCells, movedKeys, rowDelta, columnDelta, sourceRange, locale, rowCount, columnCount, cellXfsRegistry, sharedStringRegistry, }: {
+export declare const moveFormulaAtPosition: <T extends CellData>({ draft, position, destinationSheetId, activeSheetName, enqueueCalculation, enqueueGraphOperation, recalcCells, movedKeys, rowDelta, columnDelta, sourceRange, deletedRange, destinationPosition, locale, rowCount, columnCount, cellXfsRegistry, sharedStringRegistry, }: {
     draft: Draft<SheetData<T>>;
     position: {
         sheetId: number;
@@ -54,6 +54,17 @@ export declare const moveFormulaAtPosition: <T extends CellData>({ draft, positi
     rowDelta?: number;
     columnDelta?: number;
     sourceRange?: GridRange;
+    /** Cells removed by a delete-cells shift — references into it become `#REF!` (SHF-09). */
+    deletedRange?: GridRange;
+    /**
+     * Where the formula cell itself ends up. Defaults to `position + delta` (the cell moves with the
+     * shift). A dependent OUTSIDE the shifted band keeps its place while its references into the
+     * band still move by the delta — pass its own position here so the graph is re-keyed correctly.
+     */
+    destinationPosition?: {
+        rowIndex: number;
+        columnIndex: number;
+    };
     locale?: string;
     rowCount?: number;
     columnCount?: number;

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

@@ -1 +1 @@
-{"version":3,"file":"dependency.d.ts","sourceRoot":"","sources":["../../../api/dependency.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"dependency.d.ts","sourceRoot":"","sources":["../../../api/dependency.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AAE5D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AAE1D,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,OAAO,CAAC;AAEnC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AACrE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gCAAgC,CAAC;AAChE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAErE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAC;AAIrD,KAAK,0BAA0B,CAAC,CAAC,SAAS,QAAQ,IAAI;IACpD,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,KAAK,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC;IAC3B,aAAa,EAAE,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC,eAAe,CAAC,CAAC;IAClE,YAAY,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,MAAM,CAAC;IAC3C,kBAAkB,CAAC,EAAE,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC,oBAAoB,CAAC,CAAC;IAC7E,qBAAqB,CAAC,EAAE,UAAU,CAChC,OAAO,cAAc,CACtB,CAAC,uBAAuB,CAAC,CAAC;IAC3B,QAAQ,CAAC,EAAE,MAAM,GAAG,CAAC,CAAC,QAAQ,EAAE,MAAM,KAAK,MAAM,CAAC,CAAC;IACnD,WAAW,CAAC,EAAE,MAAM,GAAG,CAAC,CAAC,WAAW,EAAE,MAAM,KAAK,MAAM,CAAC,CAAC;IACzD,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE,oBAAoB,CAAC,CAAC;IAC/C,WAAW,CAAC,EAAE,SAAS,CAAC;IACxB,SAAS,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,eAAe,CAAC,EAAE,eAAe,CAAC;IAClC,oBAAoB,CAAC,EAAE,oBAAoB,CAAC;CAC7C,CAAC;AAEF,eAAO,MAAM,+BAA+B,GAAI,CAAC,SAAS,QAAQ,EAAE,0QAoBjE,0BAA0B,CAAC,CAAC,CAAC,SAwO/B,CAAC;AAIF,eAAO,MAAM,+BAA+B,GAAI,CAAC,SAAS,QAAQ,EAAE,QAAQ;IAC1E,KAAK,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,SAAS,CAAC;IACvB,aAAa,EAAE,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC,eAAe,CAAC,CAAC;CACnE;aAIc,MAAM;cAAY,MAAM;iBAAe,MAAM;EAsC3D,CAAC;AAGF,eAAO,MAAM,qBAAqB,GAAI,CAAC,SAAS,QAAQ,EAAE,2QAmBvD;IACD,KAAK,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC;IAC3B,QAAQ,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC;IACrE,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,kBAAkB,CAAC,EAAE,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC,oBAAoB,CAAC,CAAC;IAC7E,qBAAqB,CAAC,EAAE,UAAU,CAChC,OAAO,cAAc,CACtB,CAAC,uBAAuB,CAAC,CAAC;IAC3B,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE,oBAAoB,CAAC,CAAC;IAC/C,SAAS,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,SAAS,CAAC;IACxB,0FAA0F;IAC1F,YAAY,CAAC,EAAE,SAAS,CAAC;IACzB;;;;OAIG;IACH,mBAAmB,CAAC,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC;IAChE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,eAAe,CAAC,EAAE,eAAe,CAAC;IAClC,oBAAoB,CAAC,EAAE,oBAAoB,CAAC;CAC7C,SAwFA,CAAC"}

package/dist/cjs/api/dependency.js

@@ -232,8 +232,8 @@ export var collectUniqueDependentsForRange = function (params) {
 };
 // Process a single formula move at a specific position with the specified deltas.
 export var moveFormulaAtPosition = function (_a) {
-    var _b, _c;
-    var draft = _a.draft, position = _a.position, destinationSheetId = _a.destinationSheetId, activeSheetName = _a.activeSheetName, enqueueCalculation = _a.enqueueCalculation, enqueueGraphOperation = _a.enqueueGraphOperation, recalcCells = _a.recalcCells, movedKeys = _a.movedKeys, _d = _a.rowDelta, rowDelta = _d === void 0 ? 0 : _d, _e = _a.columnDelta, columnDelta = _e === void 0 ? 0 : _e, sourceRange = _a.sourceRange, locale = _a.locale, rowCount = _a.rowCount, columnCount = _a.columnCount, cellXfsRegistry = _a.cellXfsRegistry, sharedStringRegistry = _a.sharedStringRegistry;
+    var _b, _c, _d, _e;
+    var draft = _a.draft, position = _a.position, destinationSheetId = _a.destinationSheetId, activeSheetName = _a.activeSheetName, enqueueCalculation = _a.enqueueCalculation, enqueueGraphOperation = _a.enqueueGraphOperation, recalcCells = _a.recalcCells, movedKeys = _a.movedKeys, _f = _a.rowDelta, rowDelta = _f === void 0 ? 0 : _f, _g = _a.columnDelta, columnDelta = _g === void 0 ? 0 : _g, sourceRange = _a.sourceRange, deletedRange = _a.deletedRange, destinationPosition = _a.destinationPosition, locale = _a.locale, rowCount = _a.rowCount, columnCount = _a.columnCount, cellXfsRegistry = _a.cellXfsRegistry, sharedStringRegistry = _a.sharedStringRegistry;
     var sheetCell = new SheetCell();
     var currentSheet = createSheetDraft(draft, position.sheetId, position.rowIndex);
     var cellData = (_c = (_b = currentSheet[position.rowIndex]) === null || _b === void 0 ? void 0 : _b.values) === null || _c === void 0 ? void 0 : _c[position.columnIndex];
@@ -241,11 +241,17 @@ export var moveFormulaAtPosition = function (_a) {
     if (!movedKeys.has(sheetCell.key) && sheetCell.isFormula()) {
         movedKeys.add(sheetCell.key);
         var previousFormula = sheetCell.formula;
-        var newRowIndex = position.rowIndex + rowDelta;
-        var newColumnIndex = position.columnIndex + columnDelta;
+        var newRowIndex = (_d = destinationPosition === null || destinationPosition === void 0 ? void 0 : destinationPosition.rowIndex) !== null && _d !== void 0 ? _d : position.rowIndex + rowDelta;
+        var newColumnIndex = (_e = destinationPosition === null || destinationPosition === void 0 ? void 0 : destinationPosition.columnIndex) !== null && _e !== void 0 ? _e : position.columnIndex + columnDelta;
         var resolvedSheetName = activeSheetName !== null && activeSheetName !== void 0 ? activeSheetName : "";
-        sheetCell.moveFormula({ rowIndex: position.rowIndex, columnIndex: position.columnIndex }, { rowIndex: newRowIndex, columnIndex: newColumnIndex }, resolvedSheetName, {
+        // The delta is applied to the references inside `sourceRange`; the formula cell's own
+        // destination (for the graph re-key) may differ when it does not move itself.
+        sheetCell.moveFormula({ rowIndex: position.rowIndex, columnIndex: position.columnIndex }, {
+            rowIndex: position.rowIndex + rowDelta,
+            columnIndex: position.columnIndex + columnDelta,
+        }, resolvedSheetName, {
             exclusionRange: sourceRange,
+            deletedRange: deletedRange,
             rowCount: rowCount,
             columnCount: columnCount,
         });

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

@@ -22,6 +22,23 @@ export declare const updateNamedRangeName: (formulaValue: string, newName: strin
  * @param newName
  */
 export declare const updateColumnName: (formulaValue: string, newName: string, oldName: string) => string;
+/** The column specifier Excel writes for a deleted table column (`Table1[@#REF!]`). */
+export declare const REF_ERROR_COLUMN = "#REF!";
+/**
+ * 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 declare const breakTableReferencesInFormula: (formulaValue: string, tableName: string) => string;
+/**
+ * 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 declare const breakTableColumnsInFormula: (formulaValue: string, tableName: string | undefined, columnNames: string[]) => string;
 /**
  * Converts tokens to string
  * @param tokens
@@ -46,24 +63,64 @@ export declare const isAbsoluteColumnReference: (formula: string | undefined) =>
  * @param formula
  */
 export declare const isAbsoluteRowReference: (formula: string | undefined) => boolean;
+export type StructuralRangeRewriteOptions = {
+    /**
+     * Whether references WITHOUT a sheet qualifier resolve to the edited sheet.
+     * True for a formula that lives on the edited sheet; false for a formula on
+     * another sheet, whose bare `A1:A3` is its own sheet's range and must not
+     * move when the edited sheet changes shape.
+     */
+    includeUnqualifiedReferences?: boolean;
+    /**
+     * Restrict the rewrite to ranges whose PERPENDICULAR span lies inside this
+     * band — an insert/delete-cells shift of columns `B:C` only touches ranges
+     * that live entirely inside columns B..C (SHF-08); a wider range keeps its
+     * address (SHF-07). Whole-column and whole-row references span the entire
+     * sheet, so they never fall inside a band.
+     */
+    bandSpan?: RangeBandSpan;
+};
+/** Alias kept for callers that import the scope options under this name. */
+export type StructuralFormulaScopeOptions = StructuralRangeRewriteOptions;
+/**
+ * Restricts `expandRangesInFormula` / `contractRangesInFormula` to ranges whose PERPENDICULAR span
+ * lies within a band — an insert/delete-cells shift of columns `B:C` only expands ranges that live
+ * entirely inside columns B..C (SHF-08); a wider range keeps its address (SHF-07). Whole-column and
+ * whole-row references span the entire sheet, so they never fall inside a band.
+ */
+export type RangeBandSpan = {
+    startIndex: number;
+    endIndex: number;
+};
 /**
  * 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 declare const expandRangesInFormula: (formula: string | undefined, insertionIndex: number, count: number, dimension: "row" | "column", activeSheetName: string) => string | undefined;
+export declare const expandRangesInFormula: (formula: string | undefined, insertionIndex: number, count: number, dimension: "row" | "column", activeSheetName: string, options?: StructuralRangeRewriteOptions) => string | undefined;
 /**
  * Contracts ranges in a formula when rows or columns are deleted within the range
  * @param formula The formula to process
  * @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 declare const contractRangesInFormula: (formula: string | undefined, deletionIndex: number, count: number, dimension: "row" | "column", activeSheetName: string) => string | undefined;
+export declare const contractRangesInFormula: (formula: string | undefined, deletionIndex: number, count: number, dimension: "row" | "column", activeSheetName: string, options?: StructuralRangeRewriteOptions) => string | undefined;
 //# sourceMappingURL=formula.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"formula.d.ts","sourceRoot":"","sources":["../../../api/formula.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,WAAW,EAAS,MAAM,2BAA2B,CAAC;AAUpE,OAAO,EACL,yBAAyB,EACzB,eAAe,EACf,0BAA0B,GAC3B,MAAM,0BAA0B,CAAC;AAClC,YAAY,EAAE,iCAAiC,EAAE,MAAM,0BAA0B,CAAC;AAElF;;;;;GAKG;AACH,eAAO,MAAM,eAAe,GAC1B,cAAc,MAAM,EACpB,SAAS,MAAM,EACf,SAAS,MAAM,WA4BhB,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB,GAC/B,cAAc,MAAM,EACpB,SAAS,MAAM,EACf,SAAS,MAAM,WAehB,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB,GAC3B,cAAc,MAAM,EACpB,SAAS,MAAM,EACf,SAAS,MAAM,WAYhB,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,UAAU,GAAI,QAAQ,WAAW,EAAE,WAU/C,CAAC;AAiBF;;;;;GAKG;AACH,eAAO,MAAM,yBAAyB,GACpC,SAAS,MAAM,EACf,UAAU,MAAM,EAChB,aAAa,MAAM,WAGpB,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,yBAAyB,GAAI,SAAS,MAAM,GAAG,SAAS,YAGpE,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,GAAI,SAAS,MAAM,GAAG,SAAS,YAGjE,CAAC;AAEF;;;;;;;;GAQG;AACH,eAAO,MAAM,qBAAqB,GAChC,SAAS,MAAM,GAAG,SAAS,EAC3B,gBAAgB,MAAM,EACtB,OAAO,MAAM,EACb,WAAW,KAAK,GAAG,QAAQ,EAC3B,iBAAiB,MAAM,KACtB,MAAM,GAAG,SAmKX,CAAC;AAEF;;;;;;;;GAQG;AACH,eAAO,MAAM,uBAAuB,GAClC,SAAS,MAAM,GAAG,SAAS,EAC3B,eAAe,MAAM,EACrB,OAAO,MAAM,EACb,WAAW,KAAK,GAAG,QAAQ,EAC3B,iBAAiB,MAAM,KACtB,MAAM,GAAG,SA6NX,CAAC"}
+{"version":3,"file":"formula.d.ts","sourceRoot":"","sources":["../../../api/formula.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,WAAW,EAAS,MAAM,2BAA2B,CAAC;AAUpE,OAAO,EACL,yBAAyB,EACzB,eAAe,EACf,0BAA0B,GAC3B,MAAM,0BAA0B,CAAC;AAClC,YAAY,EAAE,iCAAiC,EAAE,MAAM,0BAA0B,CAAC;AAElF;;;;;GAKG;AACH,eAAO,MAAM,eAAe,GAC1B,cAAc,MAAM,EACpB,SAAS,MAAM,EACf,SAAS,MAAM,WA4BhB,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB,GAC/B,cAAc,MAAM,EACpB,SAAS,MAAM,EACf,SAAS,MAAM,WAehB,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB,GAC3B,cAAc,MAAM,EACpB,SAAS,MAAM,EACf,SAAS,MAAM,WAYhB,CAAC;AAEF,uFAAuF;AACvF,eAAO,MAAM,gBAAgB,UAAU,CAAC;AAgDxC;;;;;GAKG;AACH,eAAO,MAAM,6BAA6B,GACxC,cAAc,MAAM,EACpB,WAAW,MAAM,KAChB,MA4BF,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,0BAA0B,GACrC,cAAc,MAAM,EACpB,WAAW,MAAM,GAAG,SAAS,EAC7B,aAAa,MAAM,EAAE,KACpB,MA+BF,CAAC;AAaF;;;GAGG;AACH,eAAO,MAAM,UAAU,GAAI,QAAQ,WAAW,EAAE,WAU/C,CAAC;AAiBF;;;;;GAKG;AACH,eAAO,MAAM,yBAAyB,GACpC,SAAS,MAAM,EACf,UAAU,MAAM,EAChB,aAAa,MAAM,WAGpB,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,yBAAyB,GAAI,SAAS,MAAM,GAAG,SAAS,YAGpE,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,GAAI,SAAS,MAAM,GAAG,SAAS,YAGjE,CAAC;AAEF,MAAM,MAAM,6BAA6B,GAAG;IAC1C;;;;;OAKG;IACH,4BAA4B,CAAC,EAAE,OAAO,CAAC;IACvC;;;;;;OAMG;IACH,QAAQ,CAAC,EAAE,aAAa,CAAC;CAC1B,CAAC;AAEF,4EAA4E;AAC5E,MAAM,MAAM,6BAA6B,GAAG,6BAA6B,CAAC;AAE1E;;;;;GAKG;AACH,MAAM,MAAM,aAAa,GAAG;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC;AAmBrE;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,qBAAqB,GAChC,SAAS,MAAM,GAAG,SAAS,EAC3B,gBAAgB,MAAM,EACtB,OAAO,MAAM,EACb,WAAW,KAAK,GAAG,QAAQ,EAC3B,iBAAiB,MAAM,EACvB,UAAS,6BAAkC,KAC1C,MAAM,GAAG,SAyKX,CAAC;AAEF;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,uBAAuB,GAClC,SAAS,MAAM,GAAG,SAAS,EAC3B,eAAe,MAAM,EACrB,OAAO,MAAM,EACb,WAAW,KAAK,GAAG,QAAQ,EAC3B,iBAAiB,MAAM,EACvB,UAAS,6BAAkC,KAC1C,MAAM,GAAG,SAkPX,CAAC"}