@rowsncolumns/spreadsheet-state 28.0.75 → 28.0.76

package/dist/cjs/api/structural-table-refs.js

@@ -0,0 +1,313 @@
+import { __assign, __read, __values } from "tslib";
+import { isCellNode } from "@rowsncolumns/dag";
+import { addressToCell, getCellUserEnteredValue, getExtendedValueFormula, } from "@rowsncolumns/utils";
+import { SheetCell } from "../sheet-cell";
+import { breakTableColumnsInFormula, breakTableReferencesInFormula, createSheetCellIdentifier, } from "./formula";
+import { createSheetDraft } from "./immer-utils";
+/**
+ * Which tables / table columns `deleteRow` (a table goes with its header row)
+ * or `deleteColumn` (a table goes when every column is deleted; otherwise the
+ * covered columns are spliced out) removes for the band
+ * `[minIndex, maxIndex]` on `sheetId`. Mirrors the table updates those
+ * interfaces apply to `tables`.
+ */
+export var collectRemovedTableParts = function (tables, sheetId, axis, minIndex, maxIndex) {
+    var e_1, _a;
+    var _b, _c;
+    var removed = { tables: [], columns: [] };
+    try {
+        for (var _d = __values(tables !== null && tables !== void 0 ? tables : []), _e = _d.next(); !_e.done; _e = _d.next()) {
+            var table = _e.value;
+            if (table.sheetId !== sheetId || !table.title)
+                continue;
+            if (axis === "row") {
+                var startRowIndex = table.range.startRowIndex;
+                if (startRowIndex >= minIndex && startRowIndex <= maxIndex) {
+                    removed.tables.push(table.title);
+                }
+                continue;
+            }
+            var _f = table.range, startColumnIndex = _f.startColumnIndex, endColumnIndex = _f.endColumnIndex;
+            if (maxIndex < startColumnIndex || minIndex > endColumnIndex)
+                continue;
+            if (minIndex <= startColumnIndex && maxIndex >= endColumnIndex) {
+                removed.tables.push(table.title);
+                continue;
+            }
+            var overlapStart = Math.max(minIndex, startColumnIndex);
+            var overlapEnd = Math.min(maxIndex, endColumnIndex);
+            var names = [];
+            for (var column = overlapStart; column <= overlapEnd; column++) {
+                var name_1 = (_c = (_b = table.columns) === null || _b === void 0 ? void 0 : _b[column - startColumnIndex]) === null || _c === void 0 ? void 0 : _c.name;
+                if (name_1)
+                    names.push(name_1);
+            }
+            if (names.length) {
+                removed.columns.push({
+                    table: table.title,
+                    sheetId: sheetId,
+                    range: table.range,
+                    columns: names,
+                });
+            }
+        }
+    }
+    catch (e_1_1) { e_1 = { error: e_1_1 }; }
+    finally {
+        try {
+            if (_e && !_e.done && (_a = _d.return)) _a.call(_d);
+        }
+        finally { if (e_1) throw e_1.error; }
+    }
+    return removed;
+};
+var isEmptyRemoval = function (removed) {
+    return removed.tables.length === 0 && removed.columns.length === 0;
+};
+var isWithinRange = function (range, rowIndex, columnIndex) {
+    return rowIndex >= range.startRowIndex &&
+        rowIndex <= range.endRowIndex &&
+        columnIndex >= range.startColumnIndex &&
+        columnIndex <= range.endColumnIndex;
+};
+/**
+ * Rewrite, across every sheet, the structured references that point at the
+ * table parts a delete removes (see `RemovedTableParts`). Runs BEFORE the
+ * splice, so bare `[@Col]` references are attributed to the table by the
+ * formula's pre-edit position. Formula cells come from the dependency graph
+ * when it is available (cost O(formula cells)); without one the draft is swept.
+ */
+export var breakStructuredRefsForRemovedTableParts = function (_a) {
+    var e_2, _b, e_3, _c, e_4, _d;
+    var _e, _f;
+    var draft = _a.draft, sheetId = _a.sheetId, axis = _a.axis, referenceIndex = _a.referenceIndex, count = _a.count, removed = _a.removed, getGraphNodes = _a.getGraphNodes, enqueueCalculation = _a.enqueueCalculation, enqueueGraphOperation = _a.enqueueGraphOperation, recalcCells = _a.recalcCells, locale = _a.locale, cellXfsRegistry = _a.cellXfsRegistry, sharedStringRegistry = _a.sharedStringRegistry;
+    if (isEmptyRemoval(removed))
+        return;
+    var sheetCell = new SheetCell();
+    var isRow = axis === "row";
+    var afterBand = referenceIndex + count;
+    try {
+        for (var _g = __values(collectFormulaPositions(draft, getGraphNodes)), _h = _g.next(); !_h.done; _h = _g.next()) {
+            var pos = _h.value;
+            var currentSheet = createSheetDraft(draft, pos.sheetId, pos.rowIndex);
+            var cellData = (_f = (_e = currentSheet[pos.rowIndex]) === null || _e === void 0 ? void 0 : _e.values) === null || _f === void 0 ? void 0 : _f[pos.columnIndex];
+            var formula = getExtendedValueFormula(getCellUserEnteredValue(cellData));
+            if (!formula || !formula.includes("["))
+                continue;
+            var updated = formula;
+            try {
+                for (var _j = (e_3 = void 0, __values(removed.tables)), _k = _j.next(); !_k.done; _k = _j.next()) {
+                    var table = _k.value;
+                    updated = breakTableReferencesInFormula(updated, table);
+                }
+            }
+            catch (e_3_1) { e_3 = { error: e_3_1 }; }
+            finally {
+                try {
+                    if (_k && !_k.done && (_c = _j.return)) _c.call(_j);
+                }
+                finally { if (e_3) throw e_3.error; }
+            }
+            try {
+                for (var _l = (e_4 = void 0, __values(removed.columns)), _m = _l.next(); !_m.done; _m = _l.next()) {
+                    var entry = _m.value;
+                    updated = breakTableColumnsInFormula(updated, entry.table, entry.columns);
+                    // A bare `[@Col]` belongs to the table the formula cell sits in.
+                    if (pos.sheetId === entry.sheetId &&
+                        isWithinRange(entry.range, pos.rowIndex, pos.columnIndex)) {
+                        updated = breakTableColumnsInFormula(updated, undefined, entry.columns);
+                    }
+                }
+            }
+            catch (e_4_1) { e_4 = { error: e_4_1 }; }
+            finally {
+                try {
+                    if (_m && !_m.done && (_d = _l.return)) _d.call(_l);
+                }
+                finally { if (e_4) throw e_4.error; }
+            }
+            if (updated === formula)
+                continue;
+            sheetCell.assign(pos.sheetId, { rowIndex: pos.rowIndex, columnIndex: pos.columnIndex }, cellData, { locale: locale, cellXfsRegistry: cellXfsRegistry, sharedStringRegistry: sharedStringRegistry });
+            sheetCell.setFormulaValue(updated, false);
+            currentSheet[pos.rowIndex].values[pos.columnIndex] =
+                sheetCell.getCellData();
+            // Where the cell ends up after the splice that follows (cells strictly
+            // after the deleted band on the edited sheet close up by `count`).
+            var shifts = pos.sheetId === sheetId &&
+                (isRow ? pos.rowIndex : pos.columnIndex) >= afterBand;
+            var nextPosition = {
+                sheetId: pos.sheetId,
+                rowIndex: pos.rowIndex - (shifts && isRow ? count : 0),
+                columnIndex: pos.columnIndex - (shifts && !isRow ? count : 0),
+            };
+            var enqueueOperation = sheetCell.ephemeral()
+                ? enqueueCalculation
+                : enqueueGraphOperation;
+            enqueueOperation === null || enqueueOperation === void 0 ? void 0 : enqueueOperation({ type: "remove", position: pos });
+            enqueueOperation === null || enqueueOperation === void 0 ? void 0 : enqueueOperation({ type: "add", position: nextPosition, force: true });
+            recalcCells.set(createSheetCellIdentifier(nextPosition.sheetId, nextPosition.rowIndex, nextPosition.columnIndex), __assign(__assign({}, nextPosition), { force: true }));
+        }
+    }
+    catch (e_2_1) { e_2 = { error: e_2_1 }; }
+    finally {
+        try {
+            if (_h && !_h.done && (_b = _g.return)) _b.call(_g);
+        }
+        finally { if (e_2) throw e_2.error; }
+    }
+};
+var collectFormulaPositions = function (draft, getGraphNodes) {
+    var e_5, _a, e_6, _b;
+    if (getGraphNodes) {
+        var graphNodes = void 0;
+        try {
+            graphNodes = getGraphNodes();
+        }
+        catch (_c) {
+            graphNodes = undefined;
+        }
+        if (graphNodes && typeof graphNodes.values === "function") {
+            var positions_1 = [];
+            var sawNode = false;
+            try {
+                for (var _d = __values(graphNodes.values()), _e = _d.next(); !_e.done; _e = _d.next()) {
+                    var node = _e.value;
+                    if (!isCellNode(node))
+                        continue;
+                    sawNode = true;
+                    positions_1.push(__assign({}, node.position));
+                }
+            }
+            catch (e_5_1) { e_5 = { error: e_5_1 }; }
+            finally {
+                try {
+                    if (_e && !_e.done && (_a = _d.return)) _a.call(_d);
+                }
+                finally { if (e_5) throw e_5.error; }
+            }
+            if (sawNode)
+                return positions_1;
+        }
+    }
+    // Fallback sweep (no graph, or an empty one): every formula cell in the draft.
+    var positions = [];
+    var _loop_1 = function (key) {
+        var sheetId = Number(key);
+        var rows = draft[sheetId];
+        if (!rows)
+            return "continue";
+        rows.forEach(function (row, rowIndex) {
+            var _a;
+            (_a = row === null || row === void 0 ? void 0 : row.values) === null || _a === void 0 ? void 0 : _a.forEach(function (cellData, columnIndex) {
+                if (getExtendedValueFormula(getCellUserEnteredValue(cellData))) {
+                    positions.push({ sheetId: sheetId, rowIndex: rowIndex, columnIndex: columnIndex });
+                }
+            });
+        });
+    };
+    try {
+        for (var _f = __values(Object.keys(draft)), _g = _f.next(); !_g.done; _g = _f.next()) {
+            var key = _g.value;
+            _loop_1(key);
+        }
+    }
+    catch (e_6_1) { e_6 = { error: e_6_1 }; }
+    finally {
+        try {
+            if (_g && !_g.done && (_b = _f.return)) _b.call(_f);
+        }
+        finally { if (e_6) throw e_6.error; }
+    }
+    return positions;
+};
+export var removeSpillsOfDeletedAnchors = function (_a) {
+    var e_7, _b;
+    var _c, _d, _e;
+    var draft = _a.draft, sheetId = _a.sheetId, axis = _a.axis, minIndex = _a.minIndex, maxIndex = _a.maxIndex, getArrayRange = _a.getArrayRange, locale = _a.locale, cellXfsRegistry = _a.cellXfsRegistry, sharedStringRegistry = _a.sharedStringRegistry;
+    var sheetRows = draft[sheetId];
+    if (!sheetRows)
+        return;
+    var sheetCell = new SheetCell();
+    var anchors = [];
+    var collect = function (rowIndex, columnIndex) {
+        var _a, _b;
+        var cellData = (_b = (_a = sheetRows[rowIndex]) === null || _a === void 0 ? void 0 : _a.values) === null || _b === void 0 ? void 0 : _b[columnIndex];
+        if (!cellData)
+            return;
+        // The calculator knows the current spill; the persisted `af` (written on
+        // calc success by hosts that track it) is the fallback.
+        var live = getExtendedValueFormula(getCellUserEnteredValue(cellData)) !== undefined
+            ? getArrayRange === null || getArrayRange === void 0 ? void 0 : getArrayRange({ sheetId: sheetId, rowIndex: rowIndex, columnIndex: columnIndex })
+            : undefined;
+        var range = live !== null && live !== void 0 ? live : spillRangeFromRef(cellData.af);
+        if (range)
+            anchors.push({ rowIndex: rowIndex, columnIndex: columnIndex, range: range });
+    };
+    if (axis === "row") {
+        var _loop_2 = function (rowIndex) {
+            (_d = (_c = sheetRows[rowIndex]) === null || _c === void 0 ? void 0 : _c.values) === null || _d === void 0 ? void 0 : _d.forEach(function (_cell, columnIndex) {
+                return collect(rowIndex, columnIndex);
+            });
+        };
+        for (var rowIndex = minIndex; rowIndex <= maxIndex; rowIndex++) {
+            _loop_2(rowIndex);
+        }
+    }
+    else {
+        sheetRows.forEach(function (row, rowIndex) {
+            if (!(row === null || row === void 0 ? void 0 : row.values))
+                return;
+            for (var columnIndex = minIndex; columnIndex <= maxIndex; columnIndex++) {
+                collect(rowIndex, columnIndex);
+            }
+        });
+    }
+    try {
+        for (var anchors_1 = __values(anchors), anchors_1_1 = anchors_1.next(); !anchors_1_1.done; anchors_1_1 = anchors_1.next()) {
+            var anchor = anchors_1_1.value;
+            var range = anchor.range;
+            for (var rowIndex = range.startRowIndex; rowIndex <= range.endRowIndex; rowIndex++) {
+                var rowValues = (_e = sheetRows[rowIndex]) === null || _e === void 0 ? void 0 : _e.values;
+                if (!rowValues)
+                    continue;
+                for (var columnIndex = range.startColumnIndex; columnIndex <= range.endColumnIndex; columnIndex++) {
+                    if (rowIndex === anchor.rowIndex &&
+                        columnIndex === anchor.columnIndex) {
+                        continue;
+                    }
+                    var cellData = rowValues[columnIndex];
+                    if (!cellData || getCellUserEnteredValue(cellData) !== undefined) {
+                        continue;
+                    }
+                    sheetCell.assign(sheetId, { rowIndex: rowIndex, columnIndex: columnIndex }, cellData, { locale: locale, cellXfsRegistry: cellXfsRegistry, sharedStringRegistry: sharedStringRegistry });
+                    sheetCell.deleteContents();
+                    rowValues[columnIndex] = sheetCell.getCellData();
+                }
+            }
+        }
+    }
+    catch (e_7_1) { e_7 = { error: e_7_1 }; }
+    finally {
+        try {
+            if (anchors_1_1 && !anchors_1_1.done && (_b = anchors_1.return)) _b.call(anchors_1);
+        }
+        finally { if (e_7) throw e_7.error; }
+    }
+};
+/** `C1:C3` (the anchor's persisted `af`) → its rectangle; `undefined` when absent/unparseable. */
+var spillRangeFromRef = function (ref) {
+    if (!ref)
+        return undefined;
+    var _a = __read(ref.split(":"), 2), startAddress = _a[0], endAddress = _a[1];
+    var start = addressToCell(startAddress);
+    var end = addressToCell(endAddress !== null && endAddress !== void 0 ? endAddress : startAddress);
+    if (!start || !end)
+        return undefined;
+    return {
+        startRowIndex: start.rowIndex,
+        startColumnIndex: start.columnIndex,
+        endRowIndex: end.rowIndex,
+        endColumnIndex: end.columnIndex,
+    };
+};

package/dist/cjs/constants.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Excel's refusal messages for structural edits (insert/delete cells with shift, whole row/column
+ * insert, move/cut). The engines refuse the edit and leave the document untouched; the UI shows the
+ * message. Shared by the legacy JS hooks (`api/structural-guards.ts`) and the rnc engine's
+ * `CommitResult.rejected` channel (`libs/rnc-engine`), so both surfaces speak the same words.
+ */
+export declare const STRUCTURAL_REFUSAL_TITLE = "Microsoft Excel";
+/** INS-06 / INS-09 / SHF-10 — a non-blank (or formatted) cell would be pushed past the last row/column. */
+export declare const OFF_SHEET_PUSH_MESSAGE = "Microsoft Excel can't insert new cells because it would push non-empty cells off the end of the worksheet. These non-empty cells might appear empty but have blank values, some formatting, or a formula. Delete enough rows or columns to make room for what you want to insert and then try again.";
+/** SHF-05 / MRG-07 — the shifted band covers only part of a merged cell. */
+export declare const MERGED_CELL_REFUSAL_MESSAGE = "We can't do that to a merged cell.";
+/** TBL-05 — the shifted band would tear a table apart. */
+export declare const TABLE_SHIFT_REFUSAL_MESSAGE = "This won't work because it would move cells in a table on your worksheet.";
+/** ANC-14 — the shifted band covers only part of a CSE / dynamic array. */
+export declare const ARRAY_REFUSAL_MESSAGE = "You can't change part of an array.";
+/** Machine-readable refusal codes — the rnc engine's `CommitResult.rejected.code` uses the same set. */
+export type StructuralRefusalCode = "off-sheet-push" | "torn-merge" | "torn-table" | "torn-array";
+export type StructuralRefusal = {
+    code: StructuralRefusalCode;
+    title: string;
+    message: string;
+};
+export declare const STRUCTURAL_REFUSAL_MESSAGES: Record<StructuralRefusalCode, string>;
+export declare const structuralRefusal: (code: StructuralRefusalCode) => StructuralRefusal;
+//# sourceMappingURL=constants.d.ts.map

package/dist/cjs/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../constants.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,eAAO,MAAM,wBAAwB,oBAAoB,CAAC;AAE1D,2GAA2G;AAC3G,eAAO,MAAM,sBAAsB,ySACqQ,CAAC;AAEzS,4EAA4E;AAC5E,eAAO,MAAM,2BAA2B,uCAAuC,CAAC;AAEhF,0DAA0D;AAC1D,eAAO,MAAM,2BAA2B,8EACqC,CAAC;AAE9E,2EAA2E;AAC3E,eAAO,MAAM,qBAAqB,uCAAuC,CAAC;AAE1E,wGAAwG;AACxG,MAAM,MAAM,qBAAqB,GAC7B,gBAAgB,GAChB,YAAY,GACZ,YAAY,GACZ,YAAY,CAAC;AAEjB,MAAM,MAAM,iBAAiB,GAAG;IAC9B,IAAI,EAAE,qBAAqB,CAAC;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,eAAO,MAAM,2BAA2B,EAAE,MAAM,CAAC,qBAAqB,EAAE,MAAM,CAK7E,CAAC;AAEF,eAAO,MAAM,iBAAiB,GAC5B,MAAM,qBAAqB,KAC1B,iBAID,CAAC"}

package/dist/cjs/constants.js

@@ -0,0 +1,26 @@
+/**
+ * Excel's refusal messages for structural edits (insert/delete cells with shift, whole row/column
+ * insert, move/cut). The engines refuse the edit and leave the document untouched; the UI shows the
+ * message. Shared by the legacy JS hooks (`api/structural-guards.ts`) and the rnc engine's
+ * `CommitResult.rejected` channel (`libs/rnc-engine`), so both surfaces speak the same words.
+ */
+export var STRUCTURAL_REFUSAL_TITLE = "Microsoft Excel";
+/** INS-06 / INS-09 / SHF-10 — a non-blank (or formatted) cell would be pushed past the last row/column. */
+export var OFF_SHEET_PUSH_MESSAGE = "Microsoft Excel can't insert new cells because it would push non-empty cells off the end of the worksheet. These non-empty cells might appear empty but have blank values, some formatting, or a formula. Delete enough rows or columns to make room for what you want to insert and then try again.";
+/** SHF-05 / MRG-07 — the shifted band covers only part of a merged cell. */
+export var MERGED_CELL_REFUSAL_MESSAGE = "We can't do that to a merged cell.";
+/** TBL-05 — the shifted band would tear a table apart. */
+export var TABLE_SHIFT_REFUSAL_MESSAGE = "This won't work because it would move cells in a table on your worksheet.";
+/** ANC-14 — the shifted band covers only part of a CSE / dynamic array. */
+export var ARRAY_REFUSAL_MESSAGE = "You can't change part of an array.";
+export var STRUCTURAL_REFUSAL_MESSAGES = {
+    "off-sheet-push": OFF_SHEET_PUSH_MESSAGE,
+    "torn-merge": MERGED_CELL_REFUSAL_MESSAGE,
+    "torn-table": TABLE_SHIFT_REFUSAL_MESSAGE,
+    "torn-array": ARRAY_REFUSAL_MESSAGE,
+};
+export var structuralRefusal = function (code) { return ({
+    code: code,
+    title: STRUCTURAL_REFUSAL_TITLE,
+    message: STRUCTURAL_REFUSAL_MESSAGES[code],
+}); };

package/dist/cjs/hooks/use-calculation-worker.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-calculation-worker.d.ts","sourceRoot":"","sources":["../../../hooks/use-calculation-worker.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,8BAA8B,EAQ9B,mBAAmB,EACpB,MAAM,kCAAkC,CAAC;AAU1C,OAAO,KAAK,EACV,2BAA2B,EAE5B,MAAM,4BAA4B,CAAC;AAmBpC,OAAO,KAAK,EAEV,UAAU,EACV,SAAS,EACV,MAAM,2BAA2B,CAAC;AAgBnC,OAAO,KAAK,EAKV,mBAAmB,EACpB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAGxD,KAAK,wBAAwB,GAAG,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC;AAElE,MAAM,MAAM,gBAAgB,GAAG;IAC7B,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;CACvB,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,IAAI,EAAE,cAAc,CAAC;IACrB,KAAK,EACD,OAAO,GACP,YAAY,GACZ,iBAAiB,GACjB,iBAAiB,GACjB,yBAAyB,GACzB,cAAc,GACd,UAAU,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAyEF,MAAM,MAAM,yBAAyB,GAAG,mBAAmB,GAAG;IAC5D,MAAM,EAAE,mBAAmB,EAAE,CAAC;IAC9B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,MAAM,CAAC;IAC5B,YAAY,CAAC,EAAE,8BAA8B,CAAC,QAAQ,CAAC,CAAC;IACxD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,MAAM,CAAC,EAAE,SAAS,EAAE,CAAC;IACrB,WAAW,CAAC,EAAE,UAAU,EAAE,CAAC;IAC3B,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,oBAAoB,CAAC,EAAE,2BAA2B,CAAC;IACnD,kBAAkB,CAAC,CAAC,KAAK,EAAE,eAAe,GAAG,IAAI,CAAC;IAClD,wBAAwB,CAAC,EAAE,OAAO,CAAC;CACpC,CAAC;AA8KF,eAAO,MAAM,oBAAoB,GAC/B,OAAO,yBAAyB,KAC/B,wBA+/DF,CAAC"}
+{"version":3,"file":"use-calculation-worker.d.ts","sourceRoot":"","sources":["../../../hooks/use-calculation-worker.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,8BAA8B,EAQ9B,mBAAmB,EACpB,MAAM,kCAAkC,CAAC;AAU1C,OAAO,KAAK,EACV,2BAA2B,EAE5B,MAAM,4BAA4B,CAAC;AAmBpC,OAAO,KAAK,EAEV,UAAU,EACV,SAAS,EACV,MAAM,2BAA2B,CAAC;AAgBnC,OAAO,KAAK,EAKV,mBAAmB,EACpB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAGxD,KAAK,wBAAwB,GAAG,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC;AAElE,MAAM,MAAM,gBAAgB,GAAG;IAC7B,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;CACvB,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,IAAI,EAAE,cAAc,CAAC;IACrB,KAAK,EACD,OAAO,GACP,YAAY,GACZ,iBAAiB,GACjB,iBAAiB,GACjB,yBAAyB,GACzB,cAAc,GACd,UAAU,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAyEF,MAAM,MAAM,yBAAyB,GAAG,mBAAmB,GAAG;IAC5D,MAAM,EAAE,mBAAmB,EAAE,CAAC;IAC9B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,MAAM,CAAC;IAC5B,YAAY,CAAC,EAAE,8BAA8B,CAAC,QAAQ,CAAC,CAAC;IACxD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,MAAM,CAAC,EAAE,SAAS,EAAE,CAAC;IACrB,WAAW,CAAC,EAAE,UAAU,EAAE,CAAC;IAC3B,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,oBAAoB,CAAC,EAAE,2BAA2B,CAAC;IACnD,kBAAkB,CAAC,CAAC,KAAK,EAAE,eAAe,GAAG,IAAI,CAAC;IAClD,wBAAwB,CAAC,EAAE,OAAO,CAAC;CACpC,CAAC;AAsLF,eAAO,MAAM,oBAAoB,GAC/B,OAAO,yBAAyB,KAC/B,wBA4iEF,CAAC"}

package/dist/cjs/hooks/use-calculation-worker.js

@@ -130,6 +130,14 @@ var VOLATILE_FUNCTIONS = new Set([
     "INDIRECT",
 ]);
 var MAX_BUFFERED_RESULTS = 2000;
+/**
+ * True when an operation carries the user's new cell value and that value is
+ * not a formula — the cell is leaving the dependency graph.
+ */
+var isStaticOperationValue = function (value) {
+    return value !== undefined &&
+        (typeof value !== "string" || !value.trim().startsWith("="));
+};
 var mergePendingOperation = function (current, incoming) {
     if (!current) {
         return incoming;
@@ -1452,6 +1460,27 @@ export var useCalculationWorker = function (props) {
                         console.error("Calculation error: ", error);
                     })
                         .finally(function () {
+                        var e_11, _a;
+                        try {
+                            // The recorded static edits are only needed while the host's
+                            // state may lag behind the edit; drop them once the batch that
+                            // consumed them completes, unless the cell was edited again
+                            // meanwhile — that operation's pass owns the entry.
+                            for (var evaluationOperations_1 = (e_11 = void 0, __values(evaluationOperations)), evaluationOperations_1_1 = evaluationOperations_1.next(); !evaluationOperations_1_1.done; evaluationOperations_1_1 = evaluationOperations_1.next()) {
+                                var operation = evaluationOperations_1_1.value;
+                                var key = makeKey(operation.position);
+                                if (!pendingOperationMapRef.current.has(key)) {
+                                    pendingUserValueEditsRef.current.delete(key);
+                                }
+                            }
+                        }
+                        catch (e_11_1) { e_11 = { error: e_11_1 }; }
+                        finally {
+                            try {
+                                if (evaluationOperations_1_1 && !evaluationOperations_1_1.done && (_a = evaluationOperations_1.return)) _a.call(evaluationOperations_1);
+                            }
+                            finally { if (e_11) throw e_11.error; }
+                        }
                         activeExecutionsRef.current--;
                         if (activeExecutionsRef.current === 0) {
                             onAfterCalculation();
@@ -1618,7 +1647,7 @@ export var useCalculationWorker = function (props) {
         };
     }, []);
     var prepareArrayOperation = useCallback(function (operation) {
-        var e_11, _a;
+        var e_12, _a;
         var _b, _c, _d;
         if (operation.type === "dirty") {
             return;
@@ -1663,12 +1692,12 @@ export var useCalculationWorker = function (props) {
                     queueAnchorDirty(entry.anchor);
                 }
             }
-            catch (e_11_1) { e_11 = { error: e_11_1 }; }
+            catch (e_12_1) { e_12 = { error: e_12_1 }; }
             finally {
                 try {
                     if (_f && !_f.done && (_a = _e.return)) _a.call(_e);
                 }
-                finally { if (e_11) throw e_11.error; }
+                finally { if (e_12) throw e_12.error; }
             }
         }
     }, [clearArrayValues, findCachedArrayAnchor, graph, queueAnchorDirty]);
@@ -1679,6 +1708,19 @@ export var useCalculationWorker = function (props) {
             if (anchor) {
                 collisionAnchorsRef.current.delete(makeKey(anchor));
             }
+            // Remember a static value that replaces the cell's formula. The
+            // processing pass runs after paint, when the host's
+            // getUserEnteredValue may still return the replaced formula; every
+            // formula lookup for the cell (operation mapping, the graph's plan
+            // build, volatile tracking) goes through getFinalUserEnteredValue,
+            // which prefers this entry. Any later operation on the cell
+            // supersedes it.
+            var key = makeKey(operation.position);
+            pendingUserValueEditsRef.current.delete(key);
+            if (operation.type === "add" &&
+                isStaticOperationValue(operation.value)) {
+                pendingUserValueEditsRef.current.set(key, operation.value);
+            }
         }
         scheduleVolatileTracking(operation.position);
         prepareArrayOperation(operation);
@@ -1691,6 +1733,20 @@ export var useCalculationWorker = function (props) {
                 requestAnimationFrame(flushGraphOperations);
         }
     });
+    // The spill rectangle anchored at `position` (mirror graph first, then the
+    // last range this hook registered for the anchor).
+    var getArrayRange = useCallbackRef(function (position) {
+        var _a, _b;
+        var range = (_a = graph.getArrayRange(position)) !== null && _a !== void 0 ? _a : (_b = arrayRangeCacheRef.current.get(makeKey(position))) === null || _b === void 0 ? void 0 : _b.range;
+        if (!range)
+            return undefined;
+        return {
+            startRowIndex: range.startRowIndex,
+            startColumnIndex: range.startColumnIndex,
+            endRowIndex: range.endRowIndex,
+            endColumnIndex: range.endColumnIndex,
+        };
+    });
     var isArrayFormula = useCallbackRef(function (position) {
         return graph.isArrayFormula(position) || graph.isInArrayRange(position);
     });
@@ -1745,7 +1801,7 @@ export var useCalculationWorker = function (props) {
     }, [graph]);
     var onRequestCalculate = useCallback(function (value, sheetId, rowIndex, columnIndex, options) { return __awaiter(void 0, void 0, void 0, function () {
         var disablePreview, skipOnDemand, formula, position, dependencies, isCircular, scope, _a, _b, _c, key, value_1, plan, _d, result, resultValue;
-        var e_12, _e;
+        var e_13, _e;
         var _f, _g, _h;
         return __generator(this, function (_j) {
             switch (_j.label) {
@@ -1796,12 +1852,12 @@ export var useCalculationWorker = function (props) {
                                 scope[key] = value_1;
                             }
                         }
-                        catch (e_12_1) { e_12 = { error: e_12_1 }; }
+                        catch (e_13_1) { e_13 = { error: e_13_1 }; }
                         finally {
                             try {
                                 if (_b && !_b.done && (_e = _a.return)) _e.call(_a);
                             }
-                            finally { if (e_12) throw e_12.error; }
+                            finally { if (e_13) throw e_13.error; }
                         }
                     }
                     plan = {
@@ -1899,6 +1955,7 @@ export var useCalculationWorker = function (props) {
             getDependencyGraph: function () { return "[]"; },
             updateDependencyGraph: function () { },
             isArrayFormula: function () { return false; },
+            getArrayRange: function () { return undefined; },
             applyNamedRanges: function (_list) { },
             stats$: statsSubjectRef.current.asObservable(),
         });
@@ -1922,6 +1979,7 @@ export var useCalculationWorker = function (props) {
         getDependencyGraph: getDependencyGraph,
         updateDependencyGraph: updateDependencyGraph,
         isArrayFormula: isArrayFormula,
+        getArrayRange: getArrayRange,
         // Worker re-inits on namedRanges change (sent via WorkerInit
         // payload), so there's no host-side calculator to apply to.
         // No-op to satisfy the shared API contract.

package/dist/cjs/hooks/use-calculation.d.ts

@@ -158,6 +158,12 @@ export declare const useCalculation: ({ locale, functions, iterativeCalculation,
     getDependencyGraph: () => string;
     updateDependencyGraph: (nodes: string) => void;
     isArrayFormula: (position: CellCoordinate) => boolean;
+    getArrayRange: (position: CellCoordinate) => {
+        startRowIndex: number;
+        startColumnIndex: number;
+        endRowIndex: number;
+        endColumnIndex: number;
+    } | undefined;
     applyNamedRanges: (list: import("@rowsncolumns/spreadsheet").NamedRange[] | undefined) => void;
 } | {
     enqueueCalculation: () => void;
@@ -178,6 +184,7 @@ export declare const useCalculation: ({ locale, functions, iterativeCalculation,
     getDependencyGraph: () => "[]";
     updateDependencyGraph: () => void;
     isArrayFormula: () => false;
+    getArrayRange: () => undefined;
     applyNamedRanges: (_list: import("@rowsncolumns/spreadsheet").NamedRange[] | undefined) => void;
 };
 //# sourceMappingURL=use-calculation.d.ts.map

package/dist/cjs/hooks/use-calculation.d.ts.map

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

package/dist/cjs/hooks/use-calculation.js

@@ -2415,6 +2415,19 @@ export var useCalculation = function (_a) {
         return (getCalculator().isArray(position) ||
             getCalculator().isInArrayRange(position));
     }, []));
+    // The spill rectangle anchored at `position` (a dynamic array's projected
+    // cells), or undefined when the cell is not a spilling anchor.
+    var getArrayRange = useCallbackRef(useCallback(function (position) {
+        var range = getCalculator().getArrayRange(position);
+        if (!range)
+            return undefined;
+        return {
+            startRowIndex: range.from.row,
+            startColumnIndex: range.from.col,
+            endRowIndex: range.to.row,
+            endColumnIndex: range.to.col,
+        };
+    }, []));
     // Get all dependents of a cell. Returns a mixed list — narrow with
     // the `isCellNode`/`isStaticNode` helpers at call sites (NOT
     // `instanceof`, which breaks across bundler module instances).
@@ -2793,6 +2806,7 @@ export var useCalculation = function (_a) {
         getDependencyGraph: function () { return "[]"; },
         updateDependencyGraph: function () { },
         isArrayFormula: function () { return false; },
+        getArrayRange: function () { return undefined; },
         applyNamedRanges: function (_list) { },
     }); }, []);
     var api = {
@@ -2814,6 +2828,7 @@ export var useCalculation = function (_a) {
         getDependencyGraph: getDependencyGraph,
         updateDependencyGraph: updateDependencyGraph,
         isArrayFormula: isArrayFormula,
+        getArrayRange: getArrayRange,
         // Phase 9 — exposed so `useCalculationInitialize` can guarantee
         // named ranges are registered BEFORE cell formulas are parsed
         // (otherwise cells using a named range would form no DAG edge

package/dist/cjs/hooks/use-on-calculation-success.d.ts

@@ -7,6 +7,13 @@ import type { useSheetProperties } from "./use-sheet-properties";
 import type { UseSpreadsheetProps } from "./use-spreadsheet-state";
 import type { SharedStringRegistry } from "./use-ss-registry";
 import type { useUndoRedo } from "./use-undo-redo";
+/**
+ * The A1 spill range (`C1:C3`) a dynamic-array result anchored at
+ * `(rowIndex, columnIndex)` covers — persisted on the anchor as `af` so xlsx
+ * export can write `<f t="array" ref=…>` and structural edits can find the
+ * projected cells of a deleted anchor.
+ */
+export declare const arrayResultToA1Ref: (rowIndex: number, columnIndex: number, result: unknown[][]) => string | undefined;
 type UseOnCalculationSuccessProps<T extends CellData> = {
     locale?: string;
     cellXfsRegistry?: CellXfsRegistry;

package/dist/cjs/hooks/use-on-calculation-success.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-on-calculation-success.d.ts","sourceRoot":"","sources":["../../../hooks/use-on-calculation-success.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAC7D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AAe1D,OAAO,KAAK,EACV,iBAAiB,EACjB,yBAAyB,EACzB,cAAc,EACf,MAAM,mBAAmB,CAAC;AAC3B,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AACjE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AACnE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAC9D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAyBnD,KAAK,4BAA4B,CAAC,CAAC,SAAS,QAAQ,IAAI;IACtD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,eAAe,CAAC,EAAE,eAAe,CAAC;IAClC,oBAAoB,CAAC,EAAE,oBAAoB,CAAC;IAC5C,qBAAqB,EAAE,UAAU,CAC/B,OAAO,kBAAkB,CAC1B,CAAC,uBAAuB,CAAC,CAAC;IAC3B,iBAAiB,EAAE,mBAAmB,CAAC,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC;IAC/D,aAAa,EAAE,UAAU,CAAC,OAAO,WAAW,CAAC,CAAC,6BAA6B,CAAC,CAAC;IAC7E,aAAa,EAAE,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC,eAAe,CAAC,CAAC;IAClE,UAAU,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,MAAM,CAAC;CAC3C,CAAC;AAEF,eAAO,MAAM,uBAAuB,GAAI,CAAC,SAAS,QAAQ,GAAG,QAAQ,EAAE,wIASpE,4BAA4B,CAAC,CAAC,CAAC,eAMxB,KAAK,CAAC,CAAC,cAAc,EAAE,iBAAiB,EAAE,UAAU,CAAC,EAAE,UAAU,CAAC,CAAC,GACnE,gBAAgB,CACd,CAAC,cAAc,EAAE,iBAAiB,EAAE,UAAU,CAAC,EAAE,UAAU,CAAC,CAC7D,iBACU,OAAO,aACX,yBAAyB,SAqMzC,CAAC"}
+{"version":3,"file":"use-on-calculation-success.d.ts","sourceRoot":"","sources":["../../../hooks/use-on-calculation-success.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAC7D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AAe1D,OAAO,KAAK,EACV,iBAAiB,EACjB,yBAAyB,EACzB,cAAc,EACf,MAAM,mBAAmB,CAAC;AAC3B,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AACjE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AACnE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAC9D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAEnD;;;;;GAKG;AACH,eAAO,MAAM,kBAAkB,GAC7B,UAAU,MAAM,EAChB,aAAa,MAAM,EACnB,QAAQ,OAAO,EAAE,EAAE,KAClB,MAAM,GAAG,SAiBX,CAAC;AAEF,KAAK,4BAA4B,CAAC,CAAC,SAAS,QAAQ,IAAI;IACtD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,eAAe,CAAC,EAAE,eAAe,CAAC;IAClC,oBAAoB,CAAC,EAAE,oBAAoB,CAAC;IAC5C,qBAAqB,EAAE,UAAU,CAC/B,OAAO,kBAAkB,CAC1B,CAAC,uBAAuB,CAAC,CAAC;IAC3B,iBAAiB,EAAE,mBAAmB,CAAC,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC;IAC/D,aAAa,EAAE,UAAU,CAAC,OAAO,WAAW,CAAC,CAAC,6BAA6B,CAAC,CAAC;IAC7E,aAAa,EAAE,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC,eAAe,CAAC,CAAC;IAClE,UAAU,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,MAAM,CAAC;CAC3C,CAAC;AAEF,eAAO,MAAM,uBAAuB,GAAI,CAAC,SAAS,QAAQ,GAAG,QAAQ,EAAE,wIASpE,4BAA4B,CAAC,CAAC,CAAC,eAMxB,KAAK,CAAC,CAAC,cAAc,EAAE,iBAAiB,EAAE,UAAU,CAAC,EAAE,UAAU,CAAC,CAAC,GACnE,gBAAgB,CACd,CAAC,cAAc,EAAE,iBAAiB,EAAE,UAAU,CAAC,EAAE,UAAU,CAAC,CAC7D,iBACU,OAAO,aACX,yBAAyB,SAqMzC,CAAC"}

package/dist/cjs/hooks/use-on-calculation-success.js

@@ -7,7 +7,13 @@ import { useCallback } from "react";
 import { createSheetDraft, deriveCellFromPrecedents, peekIterable, } from "./../api/immer-utils";
 import { AWAITING_CALCULATION } from "./../helpers";
 import { LOADING_VALUE, SheetCell } from "./../sheet-cell";
-var arrayResultToA1Ref = function (rowIndex, columnIndex, result) {
+/**
+ * The A1 spill range (`C1:C3`) a dynamic-array result anchored at
+ * `(rowIndex, columnIndex)` covers — persisted on the anchor as `af` so xlsx
+ * export can write `<f t="array" ref=…>` and structural edits can find the
+ * projected cells of a deleted anchor.
+ */
+export var arrayResultToA1Ref = function (rowIndex, columnIndex, result) {
     var _a, _b;
     var numRows = result.length;
     var numCols = (_b = (_a = result[0]) === null || _a === void 0 ? void 0 : _a.length) !== null && _b !== void 0 ? _b : 0;