@rowsncolumns/spreadsheet-state 28.0.74 → 28.0.76

package/dist/esm/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/esm/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/esm/api/anchored-objects.js

@@ -0,0 +1,212 @@
+/**
+ * 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 const shiftSpanLikeReference = (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];
+    }
+    const deleteEnd = index + count - 1;
+    if (start > deleteEnd)
+        return [start - count, end - count];
+    if (end < index)
+        return [start, end];
+    const nextStart = start < index ? start : start > deleteEnd ? start - count : index;
+    const 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 const shiftAnchorIndex = (anchorIndex, op, index, count) => {
+    if (count <= 0)
+        return anchorIndex;
+    if (op === "insert") {
+        return anchorIndex >= index ? anchorIndex + count : anchorIndex;
+    }
+    const deleteEnd = index + count - 1;
+    if (anchorIndex > deleteEnd)
+        return anchorIndex - count;
+    if (anchorIndex >= index)
+        return Math.max(1, index);
+    return anchorIndex;
+};
+export const shiftAnchorCell = (anchor, axis, op, index, count) => {
+    if (axis === "row") {
+        const rowIndex = shiftAnchorIndex(anchor.rowIndex, op, index, count);
+        return rowIndex === anchor.rowIndex ? anchor : { ...anchor, rowIndex };
+    }
+    const columnIndex = shiftAnchorIndex(anchor.columnIndex, op, index, count);
+    return columnIndex === anchor.columnIndex
+        ? anchor
+        : { ...anchor, 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 const shiftGridRangeLikeReference = (range, axis, op, index, count) => {
+    const [startKey, endKey] = axis === "row"
+        ? ["startRowIndex", "endRowIndex"]
+        : ["startColumnIndex", "endColumnIndex"];
+    const span = shiftSpanLikeReference(range[startKey], range[endKey], op, index, count);
+    if (!span)
+        return null;
+    const [start, end] = span;
+    if (start === range[startKey] && end === range[endKey])
+        return range;
+    return { ...range, [startKey]: start, [endKey]: end };
+};
+const isSheetRangeLike = (value) => {
+    if (!value || typeof value !== "object" || Array.isArray(value))
+        return false;
+    const 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 const shiftChartSpecRanges = (spec, sheetId, axis, op, index, count) => {
+    let changed = false;
+    const shiftRange = (range) => {
+        if (range.sheetId !== sheetId)
+            return range;
+        const next = shiftGridRangeLikeReference(range, axis, op, index, count);
+        if (next !== range)
+            changed = true;
+        return next;
+    };
+    const walk = (node) => {
+        if (!node || typeof node !== "object")
+            return;
+        if (Array.isArray(node)) {
+            for (let i = node.length - 1; i >= 0; i--) {
+                const item = node[i];
+                if (isSheetRangeLike(item)) {
+                    const next = shiftRange(item);
+                    if (next === null)
+                        node.splice(i, 1);
+                    else if (next !== item)
+                        node[i] = next;
+                }
+                else {
+                    walk(item);
+                }
+            }
+            return;
+        }
+        const obj = node;
+        for (const key of Object.keys(obj)) {
+            const value = obj[key];
+            if (isSheetRangeLike(value)) {
+                const next = shiftRange(value);
+                if (next !== value)
+                    obj[key] = next;
+            }
+            else {
+                walk(value);
+            }
+        }
+    };
+    walk(spec);
+    return changed;
+};
+/** Shift the anchor cell of every embed (picture, shape, text box…) on the edited sheet. */
+export const shiftEmbedsOnStructuralChange = (draft, sheetId, axis, op, index, count) => {
+    for (const embed of draft) {
+        const position = embed.position;
+        if (!position || position.sheetId !== sheetId)
+            continue;
+        const overlay = position.overlayPosition;
+        if (!overlay?.anchorCell)
+            continue;
+        const next = shiftAnchorCell(overlay.anchorCell, axis, op, index, count);
+        if (next !== overlay.anchorCell)
+            overlay.anchorCell = next;
+    }
+};
+/**
+ * Shift every chart on the edited sheet: its anchor cell like a floating
+ * object, and the ranges inside its spec like references.
+ */
+export const shiftChartsOnStructuralChange = (draft, sheetId, axis, op, index, count) => {
+    for (const chart of draft) {
+        const position = chart.position;
+        if (position?.sheetId === sheetId && position.overlayPosition?.anchorCell) {
+            const overlay = position.overlayPosition;
+            const 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);
+    }
+};
+/**
+ * Shift AllowEditRange rectangles. A protected range without a rectangle
+ * (sheet-scoped protection) is untouched; one the delete consumes is removed.
+ */
+export const shiftProtectedRangesOnStructuralChange = (draft, sheetId, axis, op, index, count) => {
+    const [startKey, endKey] = axis === "row"
+        ? ["startRowIndex", "endRowIndex"]
+        : ["startColumnIndex", "endColumnIndex"];
+    for (let i = draft.length - 1; i >= 0; i--) {
+        const protectedRange = draft[i];
+        const range = protectedRange.range;
+        if (range.sheetId !== sheetId)
+            continue;
+        const start = range[startKey];
+        const end = range[endKey];
+        if (typeof start !== "number" || typeof end !== "number")
+            continue;
+        const 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) {
+            const kept = [];
+            let unprotectedChanged = false;
+            for (const unprotected of protectedRange.unprotectedRanges) {
+                if (unprotected.sheetId !== sheetId) {
+                    kept.push(unprotected);
+                    continue;
+                }
+                const next = shiftGridRangeLikeReference(unprotected, axis, op, index, count);
+                if (next !== unprotected)
+                    unprotectedChanged = true;
+                if (next)
+                    kept.push(next);
+            }
+            if (unprotectedChanged)
+                protectedRange.unprotectedRanges = kept;
+        }
+    }
+};

package/dist/esm/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/esm/api/datatype.js

@@ -574,11 +574,18 @@ export const detectValueTypeAndPattern = (value, locale, lenientGrouping = true,
             const 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/esm/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/esm/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/esm/api/dependency.js

@@ -205,7 +205,7 @@ export const collectUniqueDependentsForRange = (params) => {
     return dependentMap;
 };
 // Process a single formula move at a specific position with the specified deltas.
-export const moveFormulaAtPosition = ({ draft, position, destinationSheetId, activeSheetName, enqueueCalculation, enqueueGraphOperation, recalcCells, movedKeys, rowDelta = 0, columnDelta = 0, sourceRange, locale, rowCount, columnCount, cellXfsRegistry, sharedStringRegistry, }) => {
+export const moveFormulaAtPosition = ({ draft, position, destinationSheetId, activeSheetName, enqueueCalculation, enqueueGraphOperation, recalcCells, movedKeys, rowDelta = 0, columnDelta = 0, sourceRange, deletedRange, destinationPosition, locale, rowCount, columnCount, cellXfsRegistry, sharedStringRegistry, }) => {
     const sheetCell = new SheetCell();
     const currentSheet = createSheetDraft(draft, position.sheetId, position.rowIndex);
     const cellData = currentSheet[position.rowIndex]?.values?.[position.columnIndex];
@@ -213,11 +213,17 @@ export const moveFormulaAtPosition = ({ draft, position, destinationSheetId, act
     if (!movedKeys.has(sheetCell.key) && sheetCell.isFormula()) {
         movedKeys.add(sheetCell.key);
         const previousFormula = sheetCell.formula;
-        const newRowIndex = position.rowIndex + rowDelta;
-        const newColumnIndex = position.columnIndex + columnDelta;
+        const newRowIndex = destinationPosition?.rowIndex ?? position.rowIndex + rowDelta;
+        const newColumnIndex = destinationPosition?.columnIndex ?? position.columnIndex + columnDelta;
         const resolvedSheetName = 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,
             rowCount,
             columnCount,
         });

package/dist/esm/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/esm/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/esm/api/fill-series-spec.js

@@ -0,0 +1,160 @@
+/**
+ * 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 const generateSeriesSpecValues = (sourceValues, spec, count, locale) => {
+    if (spec.type === "autofill" || count <= 0)
+        return undefined;
+    if (spec.type === "date") {
+        const values = generateDateSeries(sourceValues, spec, count, locale);
+        return values ? { seeds: [], values } : undefined;
+    }
+    const indexed = sourceValues
+        .map((v, index) => ({ index, value: toNumber(v) }))
+        .filter((seed) => Number.isFinite(seed.value));
+    if (!indexed.length)
+        return undefined;
+    const numbers = indexed.map((seed) => seed.value);
+    const step = spec.step ?? 1;
+    const 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.
+        const ys = spec.type === "growth"
+            ? numbers.map((y) => (y > 0 ? Math.log(y) : NaN))
+            : numbers;
+        if (ys.some((y) => !Number.isFinite(y)))
+            return undefined;
+        const xs = ys.map((_, i) => i);
+        const sumX = xs.reduce((a, b) => a + b, 0);
+        const sumY = ys.reduce((a, b) => a + b, 0);
+        const sumXY = xs.reduce((a, x, i) => a + x * ys[i], 0);
+        const sumXX = xs.reduce((a, x) => a + x * x, 0);
+        const denom = n * sumXX - sumX * sumX;
+        const slope = denom === 0 ? 0 : (n * sumXY - sumX * sumY) / denom;
+        const intercept = (sumY - slope * sumX) / n;
+        const fit = (x) => {
+            const fitted = slope * x + intercept;
+            return normalize(spec.type === "growth" ? Math.exp(fitted) : fitted);
+        };
+        return {
+            seeds: indexed.map((seed, position) => ({
+                index: seed.index,
+                value: fit(position),
+            })),
+            values: Array.from({ length: count }, (_, i) => fit(n + i)),
+        };
+    }
+    const values = [];
+    let current = numbers[n - 1];
+    for (let 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 };
+};
+const toNumber = (v) => 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. */
+const passesStop = (value, step, spec) => {
+    const { stop } = spec;
+    if (stop === undefined || !Number.isFinite(stop))
+        return false;
+    const 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. */
+const normalize = (x) => {
+    if (!Number.isFinite(x))
+        return x;
+    const r = Math.round(x * 1e10) / 1e10;
+    return Math.abs(r - Math.round(r)) < 1e-9 ? Math.round(r) : r;
+};
+const toDateValue = (value) => {
+    if (value instanceof Date)
+        return isNaN(value.getTime()) ? null : value;
+    if (typeof value === "string" && value.trim()) {
+        const parsed = new Date(value);
+        return isNaN(parsed.getTime()) ? null : parsed;
+    }
+    return null;
+};
+const generateDateSeries = (sourceValues, spec, count, locale) => {
+    const dates = sourceValues
+        .map(toDateValue)
+        .filter((d) => d !== null);
+    if (!dates.length)
+        return undefined;
+    const last = dates[dates.length - 1];
+    const step = Math.trunc(spec.step ?? 1) || 1;
+    const unit = spec.dateUnit ?? "day";
+    const result = [];
+    const current = new Date(last);
+    const lastDayOfMonth = last.getDate();
+    for (let i = 0; i < count; i++) {
+        switch (unit) {
+            case "day":
+                current.setDate(current.getDate() + step);
+                break;
+            case "weekday": {
+                const dir = step > 0 ? 1 : -1;
+                for (let 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.
+                const target = new Date(last);
+                target.setDate(1);
+                target.setMonth(last.getMonth() + step * (i + 1));
+                const daysInMonth = new Date(target.getFullYear(), target.getMonth() + 1, 0).getDate();
+                target.setDate(Math.min(lastDayOfMonth, daysInMonth));
+                current.setTime(target.getTime());
+                break;
+            }
+            case "year": {
+                const target = new Date(last);
+                target.setDate(1);
+                target.setFullYear(last.getFullYear() + step * (i + 1));
+                const 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.
+            const serial = (current.getTime() - Date.UTC(1899, 11, 30)) / 86_400_000 +
+                current.getTimezoneOffset() / 1440;
+            const 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;
+};