@rowsncolumns/spreadsheet-state 28.0.74 → 28.0.75

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

@@ -1 +1 @@
-{"version":3,"file":"datatype.d.ts","sourceRoot":"","sources":["../../../api/datatype.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,UAAU,EACV,aAAa,EACb,gBAAgB,EACjB,MAAM,2BAA2B,CAAC;AAYnC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAqBlE,MAAM,MAAM,SAAS,GAAG,MAAM,aAAa,CAAC;AAE5C,eAAO,MAAM,eAAe,OAAO,CAAC;AACpC,eAAO,MAAM,uBAAuB,UAAU,CAAC;AAM/C,eAAO,MAAM,gBAAgB,8BAA0B,CAAC;AACxD,eAAO,MAAM,wBAAwB,oCAAgC,CAAC;AACtE,eAAO,MAAM,YAAY,eAAe,CAAC;AACzC,eAAO,MAAM,iBAAiB,aAAa,CAAC;AAC5C,eAAO,MAAM,YAAY,mBAAmB,CAAC;AAC7C,eAAO,MAAM,kBAAkB,eAAe,CAAC;AA6V/C;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,UAAU,GACrB,OAAO,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,GAAG,SAAS,EACnD,SAAS,MAAM,EACf,yBAAsB,YAUvB,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,SAAS,GAAI,OAAO,GAAG,YAKnC,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,YAAY,GACvB,OAAO,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,GAAG,SAAS,EACnD,SAAS,MAAM,EACf,yBAAsB,YAcvB,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,GAC3B,OAAO,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,GAAG,SAAS,GAAG,IAAI,EAC1D,SAAS,MAAM,WAWhB,CAAC;AAEF,eAAO,MAAM,eAAe,GAC1B,MAAM,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,GAAG,SAAS,EAClD,SAAS,MAAM,EACf,yBAAsB,WAMvB,CAAC;AACF;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,GAC5B,OAAO,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,GAAG,SAAS,EACnD,eAAe,gBAAgB,GAAG,SAAS,EAC3C,QAAQ,MAAM,GAAG,SAAS,EAC1B,UAAU,OAAO,EACjB,yBAAsB,uBAiCvB,CAAC;AAEF,eAAO,MAAM,yBAAyB,GACpC,OAAO,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,GAAG,SAAS,GAAG,UAAU,EAChE,UAAU,OAAO,qDAMlB,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,QAAQ,GACnB,OAAO,GAAG,EACV,SAAS,MAAM,EACf,yBAAsB,KACrB,KAAK,IAAI,MASX,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,GACjC,OAAO,GAAG,EACV,QAAQ,MAAM,GAAG,SAAS,EAC1B,yBAAsB,KACrB,gBAAgB,GAAG,SAmBrB,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,yBAAyB,GACpC,OAAO,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,GAAG,SAAS,EACnD,aAAa,MAAM,GAAG,SAAS,EAC/B,MAAM,gBAAgB,GAAG,SAAS,EAClC,QAAQ,MAAM,GAAG,SAAS,EAC1B,UAAU,OAAO,KAChB,MAAM,GAAG,SAyCX,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,eAAe,GAC1B,OAAO,iBAAiB,EACxB,QAAQ,MAAM,GAAG,SAAS,EAC1B,yBAAsB,KACrB,SAkBF,CAAC;AAEF,eAAO,MAAM,yBAAyB,GACpC,OAAO,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,GAAG,SAAS,EACnD,QAAQ,MAAM,GAAG,SAAS,EAC1B,yBAAsB,EACtB,UAAU,OAAO,KAChB,CACD,WAAW,EAAE,MAAM,aAAa,EAChC,aAAa,CAAC,EAAE,gBAAgB,EAChC,WAAW,CAAC,EAAE,MAAM,EACpB,OAAO,CAAC,EAAE,MAAM,CA4GjB,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB,GAC/B,OAAO,iBAAiB,EACxB,WAAW,SAAS,GAAG,SAAS,EAChC,SAAS,MAAM,EACf,SAAS,MAAM,WAOhB,CAAC;AAEF,eAAO,MAAM,oBAAoB,GAC/B,OAAO,iBAAiB,EACxB,WAAW,SAAS,GAAG,SAAS,EAChC,SAAS,MAAM,KACd,MAAM,GAAG,SAMX,CAAC;AAEF,eAAO,MAAM,WAAW,GAAI,KAAK,GAAG,YAEnC,CAAC;AAEF,eAAO,MAAM,iBAAiB,GAAI,KAAK,MAAM,KAAG,OAe/C,CAAC"}
+{"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/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;
+};

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

@@ -3,11 +3,73 @@ import type { GridRange } from "@rowsncolumns/common-types";
 import { Direction } from "@rowsncolumns/common-types";
 import type { SelectionAttributes } from "@rowsncolumns/spreadsheet";
 import type { CellData } from "@rowsncolumns/spreadsheet";
+import type { FillModifier, FillSeriesSpec } from "@rowsncolumns/spreadsheet";
 import type { CanvasGridProps } from "@rowsncolumns/spreadsheet";
 import type { Draft } from "immer";
 import type { CellXfsRegistry } from "../hooks/use-cellxfs-registry";
 import type { useSheetProperties } from "../hooks/use-sheet-properties";
-export type AutoFillType = "FillCopy" | "FillCustomList" | "FillDays" | "FillDefault" | "FillFormats" | "FillMonths" | "FillSeries" | "FillValues" | "FillWeekdays" | "FillYears" | "FlashFill" | "GrowthTrend" | "LinearTrend";
+export type AutoFillType = "FillCopy" | "FillCustomList" | "FillDays" | "FillDefault" | "FillFormats" | "FillHours" | "FillMonths" | "FillSeries" | "FillValues" | "FillWeekdays"
+/** Alias of Excel's `xlFillValues` under the Auto Fill Options label ("Fill Without Formatting"). */
+ | "FillWithoutFormatting" | "FillYears" | "FlashFill" | "GrowthTrend" | "LinearTrend";
+/**
+ * Resolve the Ctrl/Cmd fill-handle toggle the way Excel does — ONE fill type
+ * for the whole drag, decided from what auto-detection would have done per
+ * fill line (each column of a vertical fill / row of a horizontal one).
+ * If ANY line would extend a series (2+ numbers, a date, a list name,
+ * "Item 1"), the toggle means Copy Cells for every line; only when every
+ * line would copy (lone numbers) does it mean Fill Series. Formula lines
+ * never vote (formulas always copy with relative-ref adjustment) and empty
+ * lines are ignored.
+ */
+export declare const resolveToggledFillType: (detectedPerLine: (AutoFillType | undefined)[]) => AutoFillType;
+/**
+ * Excel's Auto Fill Options payload modifiers: "Fill Formatting Only" (`FillFormats`) and
+ * "Fill Without Formatting" (`FillWithoutFormatting`; `FillValues` is the VBA `xlFillValues`
+ * spelling the AI fill tool uses). Neither is a series mode — the series is detected exactly as
+ * for a plain drag; they only change WHAT lands in each target cell.
+ */
+export declare const isFormatsOnlyFillType: (fillType: AutoFillType | undefined) => fillType is "FillFormats";
+export declare const isValuesOnlyFillType: (fillType: AutoFillType | undefined) => fillType is "FillValues" | "FillWithoutFormatting";
+/**
+ * Thrown when a fill source is touched by merges that don't tile it with identically sized
+ * blocks — Excel refuses the fill with this exact message and writes nothing.
+ */
+export declare class MergedFillSizeError extends Error {
+    constructor();
+}
+/**
+ * Marks a target cell the fill leaves exactly as it is: a Series-dialog `stop` value was reached
+ * before the selection's end, and Excel writes nothing into the remaining selected cells.
+ */
+export declare const FILL_UNTOUCHED: unique symbol;
+export type AutoFillCellValue<T extends CellData> = T | string | number | null | undefined | Draft<T> | typeof FILL_UNTOUCHED;
+/** A seed cell rewritten by the fill (absolute coordinates on the sheet). */
+export type AutoFillSeedCell<T extends CellData> = {
+    rowIndex: number;
+    columnIndex: number;
+    cell: T;
+};
+/**
+ * The per-target-cell payload (indexed `[row][column]` relative to the filled area — the target
+ * rectangle beyond the source). A merged seed additionally reports the merge blocks to land and
+ * the fill extent snapped to whole blocks (the area `applyFill` actually writes). A Series-dialog
+ * Trend reports the seed cells it rewrites with the fitted values (Excel replaces the starting
+ * values) in `seedCells`.
+ */
+export type AutoFillResult<T extends CellData> = AutoFillCellValue<T>[][] & {
+    fillMerges?: GridRange[];
+    snappedFillBounds?: GridRange;
+    seedCells?: AutoFillSeedCell<T>[];
+};
+/**
+ * The merged-block geometry of a fill source: `undefined` when no merge touches it, the block
+ * size when identically sized merges tile it exactly (every merge inside the source, on the block
+ * lattice, and together covering it), else a {@link MergedFillSizeError}.
+ */
+export declare const resolveMergedFillBlock: (range: GridRange, merges: GridRange[] | null | undefined) => {
+    rows: number;
+    cols: number;
+} | undefined;
 /**
  * User-defined autofill lists. Each list is an array of strings that
  * the autofill engine treats as a cyclic sequence — e.g. starting from
@@ -36,6 +98,11 @@ export type GetAutoFillValuesProps<T extends CellData> = {
      * Area user is trying to fill
      */
     fillBounds: GridRange;
+    /**
+     * The sheet's merged ranges. A source tiled by identically sized merges fills block by block
+     * (each landed block merged like the seed); omit for plain per-cell fills.
+     */
+    merges?: GridRange[] | null;
     /**
      * Get cell data of a sheet
      */
@@ -61,6 +128,18 @@ export type GetAutoFillValuesProps<T extends CellData> = {
      * Auto fill type - if not specified, will auto-detect
      */
     fillType?: AutoFillType;
+    /**
+     * `"toggle"` when Ctrl/Cmd was held on the fill handle at release. Only
+     * consulted when `fillType` is not set: inverts the auto-detected
+     * copy↔series decision for the whole drag (see `resolveToggledFillType`).
+     */
+    modifier?: FillModifier;
+    /**
+     * Excel Series-dialog parameters. When present (and not `type:
+     * "autofill"`), the values come from the spec's generator — step/stop,
+     * trend, date unit — instead of the fill-type heuristics.
+     */
+    series?: FillSeriesSpec;
     /**
      * User-defined autofill lists. When the selection matches a
      * contiguous slice of one of these lists, the fill cycles through
@@ -72,6 +151,13 @@ export type GetAutoFillValuesProps<T extends CellData> = {
      */
     getDataValidationById?: ReturnType<typeof useSheetProperties>["getDataValidationById"];
 };
+/**
+ * Continue a text+number series ("Item 1" → "Item 2"; "001" → "002" keeps the
+ * zero padding; "1st Period" → "2nd Period" re-derives the ordinal). One seed
+ * steps by ±1 (by fill direction); two or more take the seeds' difference.
+ */
+export declare const generateTextNumberSeries: (values: string[], count: number, descending?: boolean) => string[] | null;
+export declare const generateQuarterSeries: (values: string[], count: number, descending?: boolean) => string[] | null;
 /**
  * Detect the fill type based on selection data
  */
@@ -79,10 +165,16 @@ export declare const detectFillType: (selectionData: (string | number | boolean
 /**
  * Generate fill values based on type and pattern
  */
-export declare const generateFillValues: (sourceValues: any[], fillType: AutoFillType, count: number, locale?: string, customAutofillLists?: CustomAutofillList[]) => any[];
+export declare const generateFillValues: (sourceValues: any[], fillType: AutoFillType, count: number, locale?: string, customAutofillLists?: CustomAutofillList[], 
+/**
+ * The fill walks away from the selection's start (fill up / fill left), so a
+ * single seed continues backwards: "Item 5" → "Item 4", Wednesday → Tuesday.
+ * Multi-seed lines already encode the direction in their reversed order.
+ */
+descending?: boolean) => any[];
 /**
  * Get auto fill values
  * @returns T[][]
  */
-export declare const getAutoFillValues: <T extends CellData>({ sheetId, direction, selection, fillBounds, getCellData, getEffectiveValue, getFormattedValue, getSheetName, getDataValidationById, cellXfsRegistry, locale, fillType, customAutofillLists, }: GetAutoFillValuesProps<T>) => Promise<(T | string | number | null | undefined | Draft<T>)[][]>;
+export declare const getAutoFillValues: <T extends CellData>({ sheetId, direction, selection, fillBounds, getCellData, getEffectiveValue, getFormattedValue, getSheetName, getDataValidationById, cellXfsRegistry, locale, fillType: requestedFillType, modifier, series, customAutofillLists, merges, }: GetAutoFillValuesProps<T>) => Promise<AutoFillResult<T>>;
 //# sourceMappingURL=fill.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"fill.d.ts","sourceRoot":"","sources":["../../../api/fill.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAChE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AAC5D,OAAO,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AACvD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AACrE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AAC1D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAGjE,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,OAAO,CAAC;AAEnC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AACrE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AAGxE,MAAM,MAAM,YAAY,GACpB,UAAU,GACV,gBAAgB,GAChB,UAAU,GACV,aAAa,GACb,aAAa,GACb,YAAY,GACZ,YAAY,GACZ,YAAY,GACZ,cAAc,GACd,WAAW,GACX,WAAW,GACX,aAAa,GACb,aAAa,CAAC;AAElB;;;;;;;;GAQG;AACH,MAAM,MAAM,kBAAkB,GAAG,MAAM,EAAE,CAAC;AAE1C,MAAM,MAAM,sBAAsB,CAAC,CAAC,SAAS,QAAQ,IAAI;IACvD;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAChB;;;OAGG;IACH,SAAS,EAAE,SAAS,CAAC;IACrB;;OAEG;IACH,SAAS,EAAE,aAAa,CAAC,mBAAmB,CAAC,CAAC;IAC9C;;OAEG;IACH,UAAU,EAAE,SAAS,CAAC;IACtB;;OAEG;IACH,WAAW,EAAE,WAAW,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC;IAC5D;;OAEG;IACH,iBAAiB,EAAE,WAAW,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC,CAAC;IACxE;;OAEG;IACH,iBAAiB,EAAE,WAAW,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC,CAAC;IACxE,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC;IACtC;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;OAEG;IACH,eAAe,CAAC,EAAE,eAAe,CAAC;IAClC;;OAEG;IACH,QAAQ,CAAC,EAAE,YAAY,CAAC;IACxB;;;;OAIG;IACH,mBAAmB,CAAC,EAAE,kBAAkB,EAAE,CAAC;IAC3C;;OAEG;IACH,qBAAqB,CAAC,EAAE,UAAU,CAChC,OAAO,kBAAkB,CAC1B,CAAC,uBAAuB,CAAC,CAAC;CAC5B,CAAC;AAqSF;;GAEG;AACH,eAAO,MAAM,cAAc,GACzB,eAAe,CAAC,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,GAAG,SAAS,GAAG,IAAI,CAAC,EAAE,EAAE,EACxE,eAAa,EACb,sBAAsB,kBAAkB,EAAE,KACzC,YA6KF,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,kBAAkB,GAC7B,cAAc,GAAG,EAAE,EACnB,UAAU,YAAY,EACtB,OAAO,MAAM,EACb,SAAS,MAAM,EACf,sBAAsB,kBAAkB,EAAE,KACzC,GAAG,EAqTL,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,iBAAiB,GAAU,CAAC,SAAS,QAAQ,EAAE,gMAczD,sBAAsB,CAAC,CAAC,CAAC,KAAG,OAAO,CACpC,CAAC,CAAC,GAAG,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAyiBxD,CAAC"}
+{"version":3,"file":"fill.d.ts","sourceRoot":"","sources":["../../../api/fill.ts"],"names":[],"mappings":"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"}