@rowsncolumns/spreadsheet-state 28.0.74 → 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/datatype.d.ts.map

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

package/dist/cjs/api/datatype.js

@@ -605,11 +605,18 @@ export var detectValueTypeAndPattern = function (value, locale, lenientGrouping,
             var percentValue = convertToNumber(value, locale, lenientGrouping) / 100;
             return ["numberValue", "PERCENT", percentValue, pattern];
         }
+        // A JS number carries no typed digits: its decimal expansion is float
+        // noise (0.1 + 0.2, the 5.333333333333333 of a fitted trend), never a
+        // format the user asked for. Excel keeps a computed or programmatic
+        // number General and clips it to General's significant digits, so only
+        // TEXT entry infers a decimal pattern from what was typed.
         return [
             "numberValue",
             "NUMBER",
             convertToNumber(value, locale, lenientGrouping),
-            detectNumberFormatPattern(value, numberValue, "NUMBER", locale),
+            typeof value === "number"
+                ? "General"
+                : detectNumberFormatPattern(value, numberValue, "NUMBER", locale),
         ];
     }
     // Date time (check before date to catch time-only formats like "1:00 AM")

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":"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"}

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/fill-series-spec.d.ts

@@ -0,0 +1,35 @@
+import type { FillSeriesSpec } from "@rowsncolumns/spreadsheet";
+/** One fill line's Series-dialog result (see {@link generateSeriesSpecValues}). */
+export type SeriesSpecLine = {
+    /**
+     * Trend only: the fitted value of every numeric seed as `{ index, value }`
+     * (`index` into the caller's `sourceValues`) — Excel replaces the starting
+     * values with the trend it fitted through them. Empty for every other spec.
+     */
+    seeds: {
+        index: number;
+        value: number;
+    }[];
+    /**
+     * The target values in fill order. SHORTER than the requested count when
+     * `stop` ends the series early — the targets past it are left untouched
+     * (Excel writes nothing there).
+     */
+    values: unknown[];
+};
+/**
+ * Value generator behind Excel's Series dialog (Home > Fill > Series…). The
+ * spec is explicit user intent, so unlike drag auto-fill nothing is detected:
+ * Linear adds `step`, Growth multiplies by `step`, Date advances `step`
+ * `dateUnit`s (weekday skips Sat/Sun, month clamps to month-end). `trend` fits
+ * a least-squares line (Linear) / exponential (Growth) through the seeds and,
+ * as Excel does, REWRITES the seeds with the fitted values before continuing
+ * the fit (a lone seed fits a flat line — the value repeats). A `stop` value
+ * ends the series at the last value that does not pass it: the line comes
+ * back shorter and the remaining selected cells are left alone. Returns
+ * `undefined` when the spec does not apply (AutoFill type, or seeds that are
+ * not numbers/dates) so the caller falls back to the regular fill-type
+ * generator.
+ */
+export declare const generateSeriesSpecValues: (sourceValues: unknown[], spec: FillSeriesSpec, count: number, locale?: string) => SeriesSpecLine | undefined;
+//# sourceMappingURL=fill-series-spec.d.ts.map

package/dist/cjs/api/fill-series-spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fill-series-spec.d.ts","sourceRoot":"","sources":["../../../api/fill-series-spec.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAEhE,mFAAmF;AACnF,MAAM,MAAM,cAAc,GAAG;IAC3B;;;;OAIG;IACH,KAAK,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC1C;;;;OAIG;IACH,MAAM,EAAE,OAAO,EAAE,CAAC;CACnB,CAAC;AAEF;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,wBAAwB,GACnC,cAAc,OAAO,EAAE,EACvB,MAAM,cAAc,EACpB,OAAO,MAAM,EACb,SAAS,MAAM,KACd,cAAc,GAAG,SAqDnB,CAAC"}

package/dist/cjs/api/fill-series-spec.js

@@ -0,0 +1,164 @@
+/**
+ * Value generator behind Excel's Series dialog (Home > Fill > Series…). The
+ * spec is explicit user intent, so unlike drag auto-fill nothing is detected:
+ * Linear adds `step`, Growth multiplies by `step`, Date advances `step`
+ * `dateUnit`s (weekday skips Sat/Sun, month clamps to month-end). `trend` fits
+ * a least-squares line (Linear) / exponential (Growth) through the seeds and,
+ * as Excel does, REWRITES the seeds with the fitted values before continuing
+ * the fit (a lone seed fits a flat line — the value repeats). A `stop` value
+ * ends the series at the last value that does not pass it: the line comes
+ * back shorter and the remaining selected cells are left alone. Returns
+ * `undefined` when the spec does not apply (AutoFill type, or seeds that are
+ * not numbers/dates) so the caller falls back to the regular fill-type
+ * generator.
+ */
+export var generateSeriesSpecValues = function (sourceValues, spec, count, locale) {
+    var _a;
+    if (spec.type === "autofill" || count <= 0)
+        return undefined;
+    if (spec.type === "date") {
+        var values_1 = generateDateSeries(sourceValues, spec, count, locale);
+        return values_1 ? { seeds: [], values: values_1 } : undefined;
+    }
+    var indexed = sourceValues
+        .map(function (v, index) { return ({ index: index, value: toNumber(v) }); })
+        .filter(function (seed) { return Number.isFinite(seed.value); });
+    if (!indexed.length)
+        return undefined;
+    var numbers = indexed.map(function (seed) { return seed.value; });
+    var step = (_a = spec.step) !== null && _a !== void 0 ? _a : 1;
+    var n = numbers.length;
+    if (spec.trend) {
+        // Least-squares trend through the seeds (x = 0..n-1), continued at x = n…
+        // A single seed has no slope: the fit is the flat line through it.
+        var ys_1 = spec.type === "growth"
+            ? numbers.map(function (y) { return (y > 0 ? Math.log(y) : NaN); })
+            : numbers;
+        if (ys_1.some(function (y) { return !Number.isFinite(y); }))
+            return undefined;
+        var xs = ys_1.map(function (_, i) { return i; });
+        var sumX = xs.reduce(function (a, b) { return a + b; }, 0);
+        var sumY = ys_1.reduce(function (a, b) { return a + b; }, 0);
+        var sumXY = xs.reduce(function (a, x, i) { return a + x * ys_1[i]; }, 0);
+        var sumXX = xs.reduce(function (a, x) { return a + x * x; }, 0);
+        var denom = n * sumXX - sumX * sumX;
+        var slope_1 = denom === 0 ? 0 : (n * sumXY - sumX * sumY) / denom;
+        var intercept_1 = (sumY - slope_1 * sumX) / n;
+        var fit_1 = function (x) {
+            var fitted = slope_1 * x + intercept_1;
+            return normalize(spec.type === "growth" ? Math.exp(fitted) : fitted);
+        };
+        return {
+            seeds: indexed.map(function (seed, position) { return ({
+                index: seed.index,
+                value: fit_1(position),
+            }); }),
+            values: Array.from({ length: count }, function (_, i) { return fit_1(n + i); }),
+        };
+    }
+    var values = [];
+    var current = numbers[n - 1];
+    for (var i = 0; i < count; i++) {
+        current =
+            spec.type === "growth" ? current * step : current + step;
+        current = normalize(current);
+        if (passesStop(current, step, spec))
+            break;
+        values.push(current);
+    }
+    return { seeds: [], values: values };
+};
+var toNumber = function (v) {
+    return typeof v === "number"
+        ? v
+        : typeof v === "string" && v.trim() !== "" && !isNaN(Number(v))
+            ? Number(v)
+            : NaN;
+};
+/** Excel's stop rule: the series ends once a value would move past `stop` in the series' direction. */
+var passesStop = function (value, step, spec) {
+    var stop = spec.stop;
+    if (stop === undefined || !Number.isFinite(stop))
+        return false;
+    var ascending = spec.type === "growth" ? Math.abs(step) > 1 === value > 0 : step > 0;
+    return ascending ? value > stop + 1e-9 : value < stop - 1e-9;
+};
+/** Snap float noise (0.1 + 0.2) to a clean decimal. */
+var normalize = function (x) {
+    if (!Number.isFinite(x))
+        return x;
+    var r = Math.round(x * 1e10) / 1e10;
+    return Math.abs(r - Math.round(r)) < 1e-9 ? Math.round(r) : r;
+};
+var toDateValue = function (value) {
+    if (value instanceof Date)
+        return isNaN(value.getTime()) ? null : value;
+    if (typeof value === "string" && value.trim()) {
+        var parsed = new Date(value);
+        return isNaN(parsed.getTime()) ? null : parsed;
+    }
+    return null;
+};
+var generateDateSeries = function (sourceValues, spec, count, locale) {
+    var _a, _b;
+    var dates = sourceValues
+        .map(toDateValue)
+        .filter(function (d) { return d !== null; });
+    if (!dates.length)
+        return undefined;
+    var last = dates[dates.length - 1];
+    var step = Math.trunc((_a = spec.step) !== null && _a !== void 0 ? _a : 1) || 1;
+    var unit = (_b = spec.dateUnit) !== null && _b !== void 0 ? _b : "day";
+    var result = [];
+    var current = new Date(last);
+    var lastDayOfMonth = last.getDate();
+    for (var i = 0; i < count; i++) {
+        switch (unit) {
+            case "day":
+                current.setDate(current.getDate() + step);
+                break;
+            case "weekday": {
+                var dir = step > 0 ? 1 : -1;
+                for (var k = 0; k < Math.abs(step); k++) {
+                    do {
+                        current.setDate(current.getDate() + dir);
+                    } while (current.getDay() === 0 || current.getDay() === 6);
+                }
+                break;
+            }
+            case "month": {
+                // Keep the seed's day-of-month, clamped to the target month's length.
+                var target = new Date(last);
+                target.setDate(1);
+                target.setMonth(last.getMonth() + step * (i + 1));
+                var daysInMonth = new Date(target.getFullYear(), target.getMonth() + 1, 0).getDate();
+                target.setDate(Math.min(lastDayOfMonth, daysInMonth));
+                current.setTime(target.getTime());
+                break;
+            }
+            case "year": {
+                var target = new Date(last);
+                target.setDate(1);
+                target.setFullYear(last.getFullYear() + step * (i + 1));
+                var daysInMonth = new Date(target.getFullYear(), target.getMonth() + 1, 0).getDate();
+                target.setDate(Math.min(lastDayOfMonth, daysInMonth));
+                current.setTime(target.getTime());
+                break;
+            }
+        }
+        if (spec.stop !== undefined && Number.isFinite(spec.stop)) {
+            // Date stop values are Excel serials; compare on whole days since epoch.
+            // Past the stop the line ends — the remaining cells stay untouched.
+            var serial = (current.getTime() - Date.UTC(1899, 11, 30)) / 86400000 +
+                current.getTimezoneOffset() / 1440;
+            var ascending = step > 0;
+            if (ascending ? serial > spec.stop + 1e-6 : serial < spec.stop - 1e-6) {
+                break;
+            }
+        }
+        // Mirrors `generateFillValues`' date cases, which hand back locale date
+        // strings that `SheetCell` re-parses into a date-formatted serial.
+        result.push(new Date(current).toLocaleDateString(locale));
+    }
+    return result;
+};