@rowsncolumns/spreadsheet-state 28.0.74 → 28.0.76

package/dist/cjs/interface/apply-fill.js

@@ -1,14 +1,15 @@
-import { __awaiter, __generator, __read } from "tslib";
+import { __assign, __awaiter, __generator, __read, __values } from "tslib";
 import { Direction } from "@rowsncolumns/common-types";
 import { selectionFromActiveCell } from "@rowsncolumns/utils";
 import { produceWithPatches } from "immer";
+import { FILL_UNTOUCHED } from "../api/fill";
 import { createSheetCellIdentifier } from "../api/formula";
 import { createSheetDraft } from "../api/immer-utils";
 import { defaultCellCoords, defaultSheetId, SheetCell } from "../sheet-cell";
 import { getFillDirection } from "./../api/selection";
 import { collectDataValidationTarget, extendDataValidationRanges, } from "./data-validation-utils";
 export var applyFill = function (_a) {
-    var locale = _a.locale, cellXfsRegistry = _a.cellXfsRegistry, sharedStringRegistry = _a.sharedStringRegistry, getDataValidationById = _a.getDataValidationById, getCellData = _a.getCellData, getEffectiveValue = _a.getEffectiveValue, getFormattedValue = _a.getFormattedValue, getAutoFillValues = _a.getAutoFillValues, getSheetName = _a.getSheetName, enqueueCalculation = _a.enqueueCalculation, enqueueStructureChange = _a.enqueueStructureChange, onChangeSheetData = _a.onChangeSheetData, createHistory = _a.createHistory, onChangeDataValidations = _a.onChangeDataValidations;
+    var locale = _a.locale, cellXfsRegistry = _a.cellXfsRegistry, sharedStringRegistry = _a.sharedStringRegistry, getDataValidationById = _a.getDataValidationById, getCellData = _a.getCellData, getEffectiveValue = _a.getEffectiveValue, getFormattedValue = _a.getFormattedValue, getAutoFillValues = _a.getAutoFillValues, getSheetName = _a.getSheetName, enqueueCalculation = _a.enqueueCalculation, enqueueStructureChange = _a.enqueueStructureChange, onChangeSheetData = _a.onChangeSheetData, createHistory = _a.createHistory, onChangeDataValidations = _a.onChangeDataValidations, getMerges = _a.getMerges, onFillMerges = _a.onFillMerges;
     return function (
     // Active sheet ID
     sheetId, 
@@ -19,10 +20,13 @@ export var applyFill = function (_a) {
     // Current selections of the user
     selections, fillableSelections, 
     // Fill type - if not specified, will auto-detect
-    fillType) { return __awaiter(void 0, void 0, void 0, function () {
-        var finalSelections, selection, saveHistory, fillBounds, direction, recalcCells, dataValidationTargets, fillValues, sheetCell, getFillValue;
-        return __generator(this, function (_a) {
-            switch (_a.label) {
+    fillType, 
+    // Ctrl/Cmd toggle held on the fill handle and/or Series-dialog parameters
+    options) { return __awaiter(void 0, void 0, void 0, function () {
+        var finalSelections, selection, saveHistory, fillBounds, direction, recalcCells, dataValidationTargets, fillValues, targetBounds, filledArea, sheetCell, getFillValue, writeCell, writeFilledCell, fillMerges;
+        var _a;
+        return __generator(this, function (_b) {
+            switch (_b.label) {
                 case 0:
                     finalSelections = selections.length
                         ? selections
@@ -45,13 +49,47 @@ export var applyFill = function (_a) {
                             locale: locale,
                             cellXfsRegistry: cellXfsRegistry,
                             getDataValidationById: getDataValidationById,
-                            fillType: fillType,
+                            merges: getMerges === null || getMerges === void 0 ? void 0 : getMerges(sheetId),
+                            fillType: fillType !== null && fillType !== void 0 ? fillType : options === null || options === void 0 ? void 0 : options.fillType,
+                            modifier: options === null || options === void 0 ? void 0 : options.modifier,
+                            series: options === null || options === void 0 ? void 0 : options.series,
                         })];
                 case 1:
-                    fillValues = _a.sent();
+                    fillValues = _b.sent();
+                    targetBounds = (_a = fillValues.snappedFillBounds) !== null && _a !== void 0 ? _a : fillBounds;
+                    filledArea = direction === Direction.Down
+                        ? {
+                            startRowIndex: selection.range.endRowIndex + 1,
+                            endRowIndex: targetBounds.endRowIndex,
+                            startColumnIndex: selection.range.startColumnIndex,
+                            endColumnIndex: selection.range.endColumnIndex,
+                        }
+                        : direction === Direction.Up
+                            ? {
+                                startRowIndex: targetBounds.startRowIndex,
+                                endRowIndex: selection.range.startRowIndex - 1,
+                                startColumnIndex: selection.range.startColumnIndex,
+                                endColumnIndex: selection.range.endColumnIndex,
+                            }
+                            : direction === Direction.Right
+                                ? {
+                                    startRowIndex: selection.range.startRowIndex,
+                                    endRowIndex: selection.range.endRowIndex,
+                                    startColumnIndex: selection.range.endColumnIndex + 1,
+                                    endColumnIndex: targetBounds.endColumnIndex,
+                                }
+                                : {
+                                    startRowIndex: selection.range.startRowIndex,
+                                    endRowIndex: selection.range.endRowIndex,
+                                    startColumnIndex: targetBounds.startColumnIndex,
+                                    endColumnIndex: selection.range.startColumnIndex - 1,
+                                };
                     sheetCell = new SheetCell(defaultSheetId, defaultCellCoords, undefined, { locale: locale, cellXfsRegistry: cellXfsRegistry, getDataValidationById: getDataValidationById });
                     getFillValue = function (rowIndex, columnIndex) {
-                        var fillValue = fillValues[rowIndex][columnIndex];
+                        var _a;
+                        var fillValue = (_a = fillValues[rowIndex]) === null || _a === void 0 ? void 0 : _a[columnIndex];
+                        if (fillValue === FILL_UNTOUCHED)
+                            return FILL_UNTOUCHED;
                         if (typeof fillValue !== "object") {
                             sheetCell.setUserEnteredValue(fillValue);
                             sharedStringRegistry === null || sharedStringRegistry === void 0 ? void 0 : sharedStringRegistry.registerCell(sheetCell);
@@ -60,6 +98,28 @@ export var applyFill = function (_a) {
                         }
                         return fillValue;
                     };
+                    writeCell = function (draft, rowIndex, columnIndex, cellData) {
+                        var newSheet = createSheetDraft(draft, sheetId, rowIndex);
+                        newSheet[rowIndex].values[columnIndex] = cellData;
+                        collectDataValidationTarget(dataValidationTargets, sheetId, rowIndex, columnIndex, cellData);
+                        enqueueCalculation({
+                            position: { rowIndex: rowIndex, columnIndex: columnIndex, sheetId: sheetId },
+                            type: "add",
+                            force: true,
+                        });
+                        recalcCells.set(createSheetCellIdentifier(sheetId, rowIndex, columnIndex), {
+                            rowIndex: rowIndex,
+                            columnIndex: columnIndex,
+                            sheetId: sheetId,
+                            force: true,
+                        });
+                    };
+                    writeFilledCell = function (draft, rowIndex, columnIndex, rollingRowIndex, rollingColumnIndex) {
+                        var cellData = getFillValue(rollingRowIndex, rollingColumnIndex);
+                        if (cellData === FILL_UNTOUCHED)
+                            return;
+                        writeCell(draft, rowIndex, columnIndex, cellData);
+                    };
                     // Fill writes through `onChangeSheetData` directly. The calculator
                     // only invalidates `rangeCache` for cells it recomputes, so the
                     // freshly-filled positions stay cached until we tell it otherwise.
@@ -76,10 +136,12 @@ export var applyFill = function (_a) {
                     // Copy sheetdata
                     onChangeSheetData === null || onChangeSheetData === void 0 ? void 0 : onChangeSheetData(function (prevSheetData) {
                         var _a = __read(produceWithPatches(prevSheetData, function (draft) {
+                            var e_1, _a;
+                            var _b;
                             switch (direction) {
                                 case Direction.Down: {
                                     var start = selection.range.endRowIndex + 1;
-                                    var end = fillBounds.endRowIndex;
+                                    var end = targetBounds.endRowIndex;
                                     var counter = 0;
                                     for (var i = start; i <= end; i++) {
                                         var rowIndex = selection.range.startRowIndex + counter;
@@ -90,16 +152,7 @@ export var applyFill = function (_a) {
                                         var rollingRowIndex = i - start;
                                         for (var columnIndex = selection.range.startColumnIndex; columnIndex <= selection.range.endColumnIndex; columnIndex++) {
                                             var rollingColumnIndex = columnIndex - selection.range.startColumnIndex;
-                                            var newSheet = createSheetDraft(draft, sheetId, i);
-                                            var newCellData = getFillValue(rollingRowIndex, rollingColumnIndex);
-                                            newSheet[i].values[columnIndex] = newCellData;
-                                            collectDataValidationTarget(dataValidationTargets, sheetId, i, columnIndex, newCellData);
-                                            enqueueCalculation({
-                                                position: { rowIndex: i, columnIndex: columnIndex, sheetId: sheetId },
-                                                type: "add",
-                                                force: true,
-                                            });
-                                            recalcCells.set(createSheetCellIdentifier(sheetId, i, columnIndex), { rowIndex: i, columnIndex: columnIndex, sheetId: sheetId, force: true });
+                                            writeFilledCell(draft, i, columnIndex, rollingRowIndex, rollingColumnIndex);
                                         }
                                         counter++;
                                     }
@@ -107,20 +160,12 @@ export var applyFill = function (_a) {
                                 }
                                 case Direction.Up: {
                                     var start = selection.range.startRowIndex - 1;
-                                    var end = fillBounds.startRowIndex;
+                                    var end = targetBounds.startRowIndex;
                                     for (var i = start; i >= end; i--) {
-                                        var rollingRowIndex = i - fillBounds.startRowIndex;
+                                        var rollingRowIndex = i - targetBounds.startRowIndex;
                                         for (var columnIndex = selection.range.startColumnIndex; columnIndex <= selection.range.endColumnIndex; columnIndex++) {
                                             var rollingColumnIndex = columnIndex - selection.range.startColumnIndex;
-                                            var newSheet = createSheetDraft(draft, sheetId, i);
-                                            newSheet[i].values[columnIndex] = getFillValue(rollingRowIndex, rollingColumnIndex);
-                                            collectDataValidationTarget(dataValidationTargets, sheetId, i, columnIndex, newSheet[i].values[columnIndex]);
-                                            enqueueCalculation({
-                                                position: { rowIndex: i, columnIndex: columnIndex, sheetId: sheetId },
-                                                type: "add",
-                                                force: true,
-                                            });
-                                            recalcCells.set(createSheetCellIdentifier(sheetId, i, columnIndex), { rowIndex: i, columnIndex: columnIndex, sheetId: sheetId, force: true });
+                                            writeFilledCell(draft, i, columnIndex, rollingRowIndex, rollingColumnIndex);
                                         }
                                     }
                                     break;
@@ -128,7 +173,7 @@ export var applyFill = function (_a) {
                                 case Direction.Right: {
                                     for (var rowIndex = selection.range.startRowIndex; rowIndex <= selection.range.endRowIndex; rowIndex++) {
                                         var start = selection.range.endColumnIndex + 1;
-                                        var end = fillBounds.endColumnIndex;
+                                        var end = targetBounds.endColumnIndex;
                                         var counter = 0;
                                         var rollingRowIndex = rowIndex - selection.range.startRowIndex;
                                         for (var j = start; j <= end; j++) {
@@ -138,15 +183,7 @@ export var applyFill = function (_a) {
                                                 columnIndex = selection.range.startColumnIndex;
                                             }
                                             var rollingColumnIndex = j - start;
-                                            var newSheet = createSheetDraft(draft, sheetId, rowIndex);
-                                            newSheet[rowIndex].values[j] = getFillValue(rollingRowIndex, rollingColumnIndex);
-                                            collectDataValidationTarget(dataValidationTargets, sheetId, rowIndex, j, newSheet[rowIndex].values[j]);
-                                            enqueueCalculation({
-                                                position: { rowIndex: rowIndex, columnIndex: j, sheetId: sheetId },
-                                                type: "add",
-                                                force: true,
-                                            });
-                                            recalcCells.set(createSheetCellIdentifier(sheetId, rowIndex, j), { rowIndex: rowIndex, columnIndex: j, sheetId: sheetId, force: true });
+                                            writeFilledCell(draft, rowIndex, j, rollingRowIndex, rollingColumnIndex);
                                             counter++;
                                         }
                                     }
@@ -155,7 +192,7 @@ export var applyFill = function (_a) {
                                 case Direction.Left: {
                                     for (var rowIndex = selection.range.startRowIndex; rowIndex <= selection.range.endRowIndex; rowIndex++) {
                                         var start = selection.range.startColumnIndex - 1;
-                                        var end = fillBounds.startColumnIndex;
+                                        var end = targetBounds.startColumnIndex;
                                         var rollingRowIndex = rowIndex - selection.range.startRowIndex;
                                         var counter = 0;
                                         for (var j = start; j >= end; j--) {
@@ -164,22 +201,28 @@ export var applyFill = function (_a) {
                                                 counter = 0;
                                                 columnIndex = selection.range.endColumnIndex;
                                             }
-                                            var rollingColumnIndex = j - fillBounds.startColumnIndex;
-                                            var newSheet = createSheetDraft(draft, sheetId, rowIndex);
-                                            newSheet[rowIndex].values[j] = getFillValue(rollingRowIndex, rollingColumnIndex);
-                                            collectDataValidationTarget(dataValidationTargets, sheetId, rowIndex, j, newSheet[rowIndex].values[j]);
-                                            enqueueCalculation({
-                                                position: { rowIndex: rowIndex, columnIndex: j, sheetId: sheetId },
-                                                type: "add",
-                                                force: true,
-                                            });
-                                            recalcCells.set(createSheetCellIdentifier(sheetId, rowIndex, j), { rowIndex: rowIndex, columnIndex: j, sheetId: sheetId, force: true });
+                                            var rollingColumnIndex = j - targetBounds.startColumnIndex;
+                                            writeFilledCell(draft, rowIndex, j, rollingRowIndex, rollingColumnIndex);
                                             counter--;
                                         }
                                     }
                                     break;
                                 }
                             }
+                            try {
+                                // Series-dialog Trend: the seed cells Excel replaces with the fitted values.
+                                for (var _c = __values((_b = fillValues.seedCells) !== null && _b !== void 0 ? _b : []), _d = _c.next(); !_d.done; _d = _c.next()) {
+                                    var seed = _d.value;
+                                    writeCell(draft, seed.rowIndex, seed.columnIndex, seed.cell);
+                                }
+                            }
+                            catch (e_1_1) { e_1 = { error: e_1_1 }; }
+                            finally {
+                                try {
+                                    if (_d && !_d.done && (_a = _c.return)) _a.call(_c);
+                                }
+                                finally { if (e_1) throw e_1.error; }
+                            }
                         }), 3), nextState = _a[0], patches = _a[1], inversePatches = _a[2];
                         // Save history
                         saveHistory({
@@ -189,13 +232,17 @@ export var applyFill = function (_a) {
                             activeCell: { undo: activeCell, redo: activeCell },
                             selections: {
                                 undo: fillableSelections !== null && fillableSelections !== void 0 ? fillableSelections : selections,
-                                redo: [fillSelection],
+                                redo: [__assign(__assign({}, fillSelection), { range: targetBounds })],
                             },
                         });
                         extendDataValidationRanges(dataValidationTargets, onChangeDataValidations, saveHistory);
                         sharedStringRegistry === null || sharedStringRegistry === void 0 ? void 0 : sharedStringRegistry.getPatches(saveHistory);
                         return nextState;
                     });
+                    fillMerges = fillValues.fillMerges;
+                    if (fillMerges === null || fillMerges === void 0 ? void 0 : fillMerges.length) {
+                        onFillMerges === null || onFillMerges === void 0 ? void 0 : onFillMerges(sheetId, activeCell, filledArea, fillMerges, targetBounds);
+                    }
                     return [2 /*return*/];
             }
         });

package/dist/cjs/interface/calculation-interface.d.ts

@@ -60,6 +60,15 @@ export declare class CalculationInterface {
     private ensureWorkerMetadata;
     private isClientOnlyFormula;
     private executeOperations;
+    /**
+     * Mirror a dynamic-array anchor's spill rectangle on the local graph (a
+     * matrix result registers it, a scalar clears it) so structural edits can
+     * find the projected cells of an anchor they delete — the same bookkeeping
+     * the React worker hook does in `handleArrayEvaluation`.
+     */
+    private trackArrayResult;
+    /** The spill rectangle currently anchored at `position`, if it is a dynamic array. */
+    getArrayRange(position: CellCoordinate): CellCoordinateRange | undefined;
     private createDefaultWorker;
     private ensureWorker;
 }

package/dist/cjs/interface/calculation-interface.d.ts.map

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

package/dist/cjs/interface/calculation-interface.js

@@ -1,7 +1,7 @@
-import { __awaiter, __generator } from "tslib";
-import { resolveSheetSpan } from "@rowsncolumns/utils";
+import { __awaiter, __generator, __read, __spreadArray } from "tslib";
 import { CalculationGraph, CalculationWorkerClient, createNamedRangeResolver, createStructuredReferenceResolver, enqueueCalculationOperations, mapOperationToGraphOperation, } from "@rowsncolumns/calculation-worker/server";
 import { FormulaError } from "@rowsncolumns/fast-formula-parser";
+import { resolveSheetSpan } from "@rowsncolumns/utils";
 var isSerializedFormulaError = function (value) {
     return Boolean(value &&
         typeof value === "object" &&
@@ -344,6 +344,7 @@ var CalculationInterface = /** @class */ (function () {
                     case 2:
                         results = _a.sent();
                         expandedResults = results.flatMap(function (result) {
+                            _this.trackArrayResult(result);
                             return expandWorkerResult(result);
                         });
                         if (expandedResults.length) {
@@ -354,6 +355,34 @@ var CalculationInterface = /** @class */ (function () {
             });
         });
     };
+    /**
+     * Mirror a dynamic-array anchor's spill rectangle on the local graph (a
+     * matrix result registers it, a scalar clears it) so structural edits can
+     * find the projected cells of an anchor they delete — the same bookkeeping
+     * the React worker hook does in `handleArrayEvaluation`.
+     */
+    CalculationInterface.prototype.trackArrayResult = function (result) {
+        if (!result.position)
+            return;
+        var position = result.position;
+        var matrix = normalizeMatrixValue(deserializeWorkerValue(result.value));
+        if (!matrix) {
+            this.graph.unregisterArrayFormula(position);
+            return;
+        }
+        var columns = Math.max.apply(Math, __spreadArray([1], __read(matrix.map(function (row) { return row.length; })), false));
+        this.graph.registerArrayFormula(position, {
+            sheetId: position.sheetId,
+            startRowIndex: position.rowIndex,
+            startColumnIndex: position.columnIndex,
+            endRowIndex: position.rowIndex + matrix.length - 1,
+            endColumnIndex: position.columnIndex + columns - 1,
+        });
+    };
+    /** The spill rectangle currently anchored at `position`, if it is a dynamic array. */
+    CalculationInterface.prototype.getArrayRange = function (position) {
+        return this.graph.getArrayRange(position);
+    };
     CalculationInterface.prototype.createDefaultWorker = function () {
         if (typeof require !== "function") {
             throw new Error("createCalculationWorker must be provided outside of Node.js.");

package/dist/cjs/interface/delete-cells-shift-left.d.ts

@@ -1,5 +1,12 @@
 import type { CellInterface, SelectionArea } from "@rowsncolumns/common-types";
 import type { CellData, SelectionAttributes, Sheet } from "@rowsncolumns/spreadsheet";
 import type { UseOnDeleteCellsShiftLeftProps } from "../hooks/use-on-delete-cells-shift-left";
-export declare const deleteCellsShiftLeft: <T extends CellData, S extends Sheet>({ rowCount, columnCount, locale, cellXfsRegistry, sharedStringRegistry, getActiveCell, getSelections, getDependents, createHistory, enqueueGraphOperation, enqueueCalculation, enqueueStructureChange, onChangeSheetData, onChangeSheets, onChangeCitations, }: UseOnDeleteCellsShiftLeftProps<T, S>) => (sheetId: number, activeCell: CellInterface, selections: SelectionArea<SelectionAttributes>[]) => void;
+/**
+ * Delete cells ▸ Shift cells left (SHF-04) — the horizontal twin of `deleteCellsShiftUp`: only the
+ * selection's rows move, the selected block is removed and every cell to its right slides left by
+ * the block's width. A reference to a deleted cell becomes `#REF!`; one to a cell that slid left
+ * follows it; a range entirely inside the block's rows that the block partially covers contracts.
+ * Refusals (torn merge/table/array) are decided by the hook before this runs.
+ */
+export declare const deleteCellsShiftLeft: <T extends CellData, S extends Sheet>({ rowCount, columnCount, locale, cellXfsRegistry, sharedStringRegistry, getActiveCell, getSelections, getDependents, getSheetName, createHistory, enqueueGraphOperation, enqueueCalculation, enqueueStructureChange, onChangeSheetData, onChangeSheets, onChangeTables, onChangeCitations, }: UseOnDeleteCellsShiftLeftProps<T, S>) => (sheetId: number, activeCell: CellInterface, selections: SelectionArea<SelectionAttributes>[]) => void;
 //# sourceMappingURL=delete-cells-shift-left.d.ts.map

package/dist/cjs/interface/delete-cells-shift-left.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"delete-cells-shift-left.d.ts","sourceRoot":"","sources":["../../../interface/delete-cells-shift-left.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,aAAa,EAEb,aAAa,EACd,MAAM,4BAA4B,CAAC;AAEpC,OAAO,KAAK,EACV,QAAQ,EACR,mBAAmB,EACnB,KAAK,EACN,MAAM,2BAA2B,CAAC;AAQnC,OAAO,KAAK,EAAE,8BAA8B,EAAE,MAAM,yCAAyC,CAAC;AAG9F,eAAO,MAAM,oBAAoB,GAAI,CAAC,SAAS,QAAQ,EAAE,CAAC,SAAS,KAAK,EAAE,gQAgBvE,8BAA8B,CAAC,CAAC,EAAE,CAAC,CAAC,MAEnC,SAAS,MAAM,EACf,YAAY,aAAa,EACzB,YAAY,aAAa,CAAC,mBAAmB,CAAC,EAAE,SAkMnD,CAAC"}
+{"version":3,"file":"delete-cells-shift-left.d.ts","sourceRoot":"","sources":["../../../interface/delete-cells-shift-left.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,aAAa,EAEb,aAAa,EACd,MAAM,4BAA4B,CAAC;AACpC,OAAO,KAAK,EACV,QAAQ,EACR,mBAAmB,EACnB,KAAK,EACN,MAAM,2BAA2B,CAAC;AAgBnC,OAAO,KAAK,EAAE,8BAA8B,EAAE,MAAM,yCAAyC,CAAC;AAI9F;;;;;;GAMG;AACH,eAAO,MAAM,oBAAoB,GAAI,CAAC,SAAS,QAAQ,EAAE,CAAC,SAAS,KAAK,EAAE,8RAkBvE,8BAA8B,CAAC,CAAC,EAAE,CAAC,CAAC,MAEnC,SAAS,MAAM,EACf,YAAY,aAAa,EACzB,YAAY,aAAa,CAAC,mBAAmB,CAAC,EAAE,SAqRnD,CAAC"}