@rowsncolumns/spreadsheet 10.2.75 → 10.2.76

package/dist/cjs/components/canvas-grid/index.js

@@ -90,6 +90,7 @@ var use_touch_1 = require("../../hooks/use-touch");
 var spreadsheet_provider_1 = require("../../providers/spreadsheet-provider");
 var scroll_subscriber_1 = require("../../signals/scroll-subscriber");
 var themes_1 = require("../../themes");
+var fill_series_1 = require("../../api/fill-series");
 var cell_1 = require("../cell");
 var cell_editor_1 = require("../cell-editor");
 var context_menu_1 = require("../context-menu");
@@ -229,10 +230,13 @@ function CanvasGridComponent(props, forwardedRef) {
     var cellEditorInstance = (0, formula_bar_editor_value_atom_1.useCellEditorInstance)();
     // Paste menu
     var _50 = tslib_1.__read((0, atoms_1.useShowPasteMenu)(), 2), showPasteMenu = _50[0], setShowPasteMenu = _50[1];
+    // Auto Fill Options smart tag / right-drag fill menu + Series dialog
+    var _51 = tslib_1.__read((0, atoms_1.useFillOptionsState)(), 2), fillOptions = _51[0], setFillOptions = _51[1];
+    var openFillSeriesDialog = (0, atoms_1.useOpenFillSeriesDialog)();
     // Shared state
     var formulaMode = (0, atoms_1.useFormulaModeValue)();
     var formulaSelections = (0, formula_selections_atom_1.useFormulaSelections)();
-    var _51 = tslib_1.__read((0, editing_cell_atom_1.useEditingCell)(), 2), editingCellCoordinate = _51[0], setEditingCellCoordinate = _51[1];
+    var _52 = tslib_1.__read((0, editing_cell_atom_1.useEditingCell)(), 2), editingCellCoordinate = _52[0], setEditingCellCoordinate = _52[1];
     var setFormulabarEditorValue = (0, formula_bar_editor_value_atom_1.useSetFormulabarEditorValue)();
     var setFormulaBarTextFormatRuns = (0, formula_bar_editor_value_atom_1.useSetFormulaBarTextFormatRuns)();
     var canSelectCells = (0, formula_selection_state_atom_1.useFormulaCanSelectCells)();
@@ -240,7 +244,7 @@ function CanvasGridComponent(props, forwardedRef) {
     var setFormulaState = (0, formula_selection_state_atom_1.useSetFormulaSelectionState)();
     var activeEditor = (0, active_editor_atom_1.useActiveEditor)();
     // Magic fill state
-    var _52 = tslib_1.__read((0, magic_fill_state_atom_1.useQuickEditState)(), 2), quickEditValues = _52[0], setQuickEditState = _52[1];
+    var _53 = tslib_1.__read((0, magic_fill_state_atom_1.useQuickEditState)(), 2), quickEditValues = _53[0], setQuickEditState = _53[1];
     var setNoteEditorCell = (0, atoms_1.useSetNoteEditorCell)();
     var setPinnedTooltip = (0, atoms_1.useSetPinnedTooltip)();
     var setSpreadsheetApi = (0, spreadsheet_api_atom_1.useSetSpreadsheetApi)();
@@ -251,7 +255,7 @@ function CanvasGridComponent(props, forwardedRef) {
     var instanceStore = (0, jotai_1.useStore)({ store: spreadsheet_provider_1.multiInstanceStore });
     // To access closures
     var hoveredCellRef = (0, use_stable_ref_1.useStableRef)(hoveredCell);
-    var _53 = tslib_1.__read((0, use_resize_observer_1.useResizeObserver)(), 2), gridContainerRef = _53[0], _54 = _53[1], width = _54.width, height = _54.height;
+    var _54 = tslib_1.__read((0, use_resize_observer_1.useResizeObserver)(), 2), gridContainerRef = _54[0], _55 = _54[1], width = _55.width, height = _55.height;
     var defaultFrozenDims = showHeaders ? 1 : 0;
     var frozenRows = Math.max(defaultFrozenDims, (frozenRowCount !== null && frozenRowCount !== void 0 ? frozenRowCount : 0) + defaultFrozenDims);
     var frozenColumns = Math.max(defaultFrozenDims, (frozenColumnCount !== null && frozenColumnCount !== void 0 ? frozenColumnCount : 0) + defaultFrozenDims);
@@ -263,9 +267,9 @@ function CanvasGridComponent(props, forwardedRef) {
     var sheetRowCount = Math.min(config_1.MAX_ROW_COUNT + 1, rowCount + 1);
     var sheetColumnCount = Math.min(config_1.MAX_COLUMN_COUNT + 1, columnCount + 1);
     // License key validator
-    var _55 = tslib_1.__read((0, use_licensekey_validator_1.useLicenseKeyValidator)({
+    var _56 = tslib_1.__read((0, use_licensekey_validator_1.useLicenseKeyValidator)({
         licenseKey: licenseKey,
-    }), 3), _ = _55[0], licenseType = _55[1], validatorResult = _55[2];
+    }), 3), _ = _56[0], licenseType = _56[1], validatorResult = _56[2];
     var isRestricted = licenseType === "solo";
     // Grid line width
     var gridLineWidth = 1 * scale;
@@ -1081,11 +1085,11 @@ function CanvasGridComponent(props, forwardedRef) {
      * Touch support
      * Mainly for scrolling
      */
-    var _56 = (0, use_touch_1.useTouch)({
+    var _57 = (0, use_touch_1.useTouch)({
         scrollTo: scrollTo,
         scale: scale,
         onChangeScale: onChangeScale,
-    }), onTouchStart = _56.onTouchStart, onDimensionsChange = _56.onDimensionsChange, scrollToTouchDevice = _56.scrollToTouchDevice, onAfterScrollToCell = _56.onAfterScrollToCell;
+    }), onTouchStart = _57.onTouchStart, onDimensionsChange = _57.onDimensionsChange, scrollToTouchDevice = _57.scrollToTouchDevice, onAfterScrollToCell = _57.onAfterScrollToCell;
     /**
      * Conditional-formatting evaluation window: the padded, tile-quantized
      * viewport. The raw viewport lives in a ref (no render per scroll frame);
@@ -1093,7 +1097,7 @@ function CanvasGridComponent(props, forwardedRef) {
      * `startTransition` so the CF recompute is low-priority and interruptible —
      * scrolling never blocks on it.
      */
-    var _57 = tslib_1.__read((0, react_1.useState)(cf_window_1.CF_INITIAL_WINDOW), 2), cfWindow = _57[0], setCfWindow = _57[1];
+    var _58 = tslib_1.__read((0, react_1.useState)(cf_window_1.CF_INITIAL_WINDOW), 2), cfWindow = _58[0], setCfWindow = _58[1];
     var cfWindowRef = (0, react_1.useRef)(null);
     var handleViewPortChange = (0, react_1.useCallback)(function (viewport) {
         onViewPortChange === null || onViewPortChange === void 0 ? void 0 : onViewPortChange(viewport);
@@ -1325,14 +1329,14 @@ function CanvasGridComponent(props, forwardedRef) {
         tokenizer: defaultTokenizer,
     });
     // Helper function to convert a selection to readable selection address
-    var _58 = tslib_1.__read((0, use_create_address_from_selection_1.useCreateAddressFromSelection)({
+    var _59 = tslib_1.__read((0, use_create_address_from_selection_1.useCreateAddressFromSelection)({
         sheetId: sheetId,
         rowCount: rowCount,
         columnCount: columnCount,
         tables: tables !== null && tables !== void 0 ? tables : undefined,
         namedRanges: namedRanges !== null && namedRanges !== void 0 ? namedRanges : undefined,
         merges: merges,
-    }), 2), getAddressFromSelection = _58[0], getR1C1AddressFromSelection = _58[1];
+    }), 2), getAddressFromSelection = _59[0], getR1C1AddressFromSelection = _59[1];
     /**
      * Exports a data region as image
      */
@@ -1378,7 +1382,7 @@ function CanvasGridComponent(props, forwardedRef) {
      * Get user entered value from a range
      * of cells
      */
-    var _59 = tslib_1.__read((0, use_get_values_from_range_1.useGetValuesFromRange)({
+    var _60 = tslib_1.__read((0, use_get_values_from_range_1.useGetValuesFromRange)({
         sheetId: sheetId,
         getSelectionsFromFormula: getSelectionsFromFormula,
         getFormattedValue: getFormattedValue,
@@ -1386,7 +1390,7 @@ function CanvasGridComponent(props, forwardedRef) {
         getSheetId: getSheetId,
         onRequestCalculate: onRequestCalculate,
         getValidationSourceValue: getValidationSourceValue,
-    }), 3), getFormattedValuesFromAddress = _59[0], getEffectiveValuesFromRange = _59[1], getFormattedValuesFromAddressAsync = _59[2];
+    }), 3), getFormattedValuesFromAddress = _60[0], getEffectiveValuesFromRange = _60[1], getFormattedValuesFromAddressAsync = _60[2];
     /**
      * Get all formatted values from range as a single 1d array
      */
@@ -1723,7 +1727,7 @@ function CanvasGridComponent(props, forwardedRef) {
      * O(n)
      * Reduces Space Complexity by using `all`
      */
-    var _60 = tslib_1.__read((0, use_selected_rows_columns_1.useSelectedRowsColumns)({
+    var _61 = tslib_1.__read((0, use_selected_rows_columns_1.useSelectedRowsColumns)({
         activeCell: activeCell,
         selections: selections,
         selectionLeftBound: selectionLeftBound,
@@ -1731,7 +1735,7 @@ function CanvasGridComponent(props, forwardedRef) {
         rowCount: rowCount,
         columnCount: columnCount,
         getCellBounds: getCellBounds,
-    }), 6), selectedRows = _60[0], selectedColumns = _60[1], selectedRowHeaders = _60[2], selectedColumnHeaders = _60[3], selectedRowHeadersIds = _60[4], selectedColumnHeadersIds = _60[5];
+    }), 6), selectedRows = _61[0], selectedColumns = _61[1], selectedRowHeaders = _61[2], selectedColumnHeaders = _61[3], selectedRowHeadersIds = _61[4], selectedColumnHeadersIds = _61[5];
     // Named ranges for editor dropdown
     var getNamedRanges = (0, use_callback_ref_1.useCallbackRef)((0, react_1.useCallback)(function () {
         return namedRanges === null || namedRanges === void 0 ? void 0 : namedRanges.map(function (range) { return ({
@@ -1801,7 +1805,7 @@ function CanvasGridComponent(props, forwardedRef) {
      * user can select entire column or row when selecting
      * header cells
      */
-    var _61 = (0, use_selection_interceptors_1.useSelectionInterceptors)({
+    var _62 = (0, use_selection_interceptors_1.useSelectionInterceptors)({
         sheetId: sheetId,
         rowCount: rowCount,
         columnCount: columnCount,
@@ -1817,7 +1821,7 @@ function CanvasGridComponent(props, forwardedRef) {
         onChangeActiveCell: onChangeActiveCell,
         scrollToCell: scrollToCell,
         isMergedCell: isMergedCell,
-    }), onMouseDownInterceptor = _61.onMouseDownInterceptor, onMouseMoveInterceptor = _61.onMouseMoveInterceptor;
+    }), onMouseDownInterceptor = _62.onMouseDownInterceptor, onMouseMoveInterceptor = _62.onMouseMoveInterceptor;
     /**
      * When user selections full rows
      * or columns, we have to ignore
@@ -1905,7 +1909,7 @@ function CanvasGridComponent(props, forwardedRef) {
      * Enables auto resizing
      * rows and columns
      */
-    var _62 = (0, use_sizer_1.useSizer)({
+    var _63 = (0, use_sizer_1.useSizer)({
         frozenRows: frozenRows,
         frozenColumns: frozenColumns,
         scale: scale,
@@ -1928,7 +1932,7 @@ function CanvasGridComponent(props, forwardedRef) {
         getDataRowCount: getDataRowCount,
         fontSize: defaultFontSizePoint,
         resizeStrategy: "full",
-    }), getColumnWidth = _62.getColumnWidth, getRowHeight = _62.getRowHeight, getCellDimensions = _62.getCellDimensions, getCellDimensionsStable = _62.getCellDimensionsStable, getTextDimension = _62.getTextDimension;
+    }), getColumnWidth = _63.getColumnWidth, getRowHeight = _63.getRowHeight, getCellDimensions = _63.getCellDimensions, getCellDimensionsStable = _63.getCellDimensionsStable, getTextDimension = _63.getTextDimension;
     /**
      * Called when user tries to
      * autofit a column or row
@@ -2001,7 +2005,7 @@ function CanvasGridComponent(props, forwardedRef) {
     /**
      * Popover cell
      */
-    var _63 = (0, use_cell_popover_1.useCellPopover)({
+    var _64 = (0, use_cell_popover_1.useCellPopover)({
         sheetId: sheetId,
         getCellPopoverContent: getCellPopoverContent !== null && getCellPopoverContent !== void 0 ? getCellPopoverContent : getFormattedValue,
         getCellOffsetFromCoords: getCellOffsetFromCoords,
@@ -2009,7 +2013,7 @@ function CanvasGridComponent(props, forwardedRef) {
         isFrozenColumn: isFrozenColumn,
         isFrozenRow: isFrozenRow,
         onChangeActiveSheet: onChangeActiveSheet,
-    }), popoverComponent = _63.popoverComponent, popoverRange = _63.popoverRange, showCellPopover = _63.showCellPopover, hideCellPopover = _63.hideCellPopover;
+    }), popoverComponent = _64.popoverComponent, popoverRange = _64.popoverRange, showCellPopover = _64.showCellPopover, hideCellPopover = _64.hideCellPopover;
     /**
      * Get tooltip component of a cell
      * Only error, invalid values are
@@ -2051,10 +2055,164 @@ function CanvasGridComponent(props, forwardedRef) {
     var dataRegionBoundaries = (0, react_1.useMemo)(function () {
         return tables === null || tables === void 0 ? void 0 : tables.filter(function (table) { return table.sheetId === sheetId; }).map(function (table) { return table.range; });
     }, [tables, sheetId]);
+    /**
+     * True when a source cell of a fill is date-formatted — the fill menu then
+     * adds Fill Days / Weekdays / Months / Years (Excel shows them only for
+     * date sources). Reads the cell's own format first, then the effective
+     * (style-plane) format so rnc-backed cells count too.
+     */
+    var sourceHasDates = (0, react_1.useCallback)(function (fillSheetId, sources) {
+        var e_11, _a;
+        var _b, _c, _d, _e, _f;
+        var visited = 0;
+        try {
+            for (var sources_1 = tslib_1.__values(sources), sources_1_1 = sources_1.next(); !sources_1_1.done; sources_1_1 = sources_1.next()) {
+                var range = sources_1_1.value.range;
+                for (var r = range.startRowIndex; r <= range.endRowIndex; r++) {
+                    for (var c = range.startColumnIndex; c <= range.endColumnIndex; c++) {
+                        // Bounded scan: a whole-column source would otherwise cost a full walk.
+                        if (++visited > 256)
+                            return false;
+                        var uf = (_b = getCellData === null || getCellData === void 0 ? void 0 : getCellData(fillSheetId, r, c)) === null || _b === void 0 ? void 0 : _b.userEnteredFormat;
+                        var type = (_d = (uf && "numberFormat" in uf ? (_c = uf.numberFormat) === null || _c === void 0 ? void 0 : _c.type : undefined)) !== null && _d !== void 0 ? _d : (_f = (_e = getEffectiveFormat === null || getEffectiveFormat === void 0 ? void 0 : getEffectiveFormat(fillSheetId, r, c)) === null || _e === void 0 ? void 0 : _e.numberFormat) === null || _f === void 0 ? void 0 : _f.type;
+                        if (type === "DATE" || type === "DATE_TIME")
+                            return true;
+                    }
+                }
+            }
+        }
+        catch (e_11_1) { e_11 = { error: e_11_1 }; }
+        finally {
+            try {
+                if (sources_1_1 && !sources_1_1.done && (_a = sources_1.return)) _a.call(sources_1);
+            }
+            finally { if (e_11) throw e_11.error; }
+        }
+        return false;
+    }, [getCellData, getEffectiveFormat]);
+    /**
+     * A fill-handle drag ended: park the gesture so the Auto Fill Options smart
+     * tag (left drag — already filled) or the right-drag fill menu (nothing
+     * filled yet) can re-choose the fill type.
+     */
+    var handleFillHandleRelease = (0, react_1.useCallback)(function (release) {
+        if (readonly)
+            return;
+        setFillOptions({
+            sheetId: release.sheetId,
+            activeCell: release.activeCell,
+            fillSelection: release.fillSelection,
+            selections: release.selections,
+            fillType: undefined,
+            hasDates: sourceHasDates(release.sheetId, release.selections.length
+                ? release.selections
+                : [{ range: (0, grid_1.cellToArea)(release.activeCell) }]),
+            mode: release.button === "right" ? "menu" : "smart-tag",
+        });
+    }, [readonly, setFillOptions, sourceHasDates]);
+    /**
+     * An entry of the fill menu was picked: re-issue the fill from the (still
+     * intact) source with the explicit type. The target is simply overwritten
+     * with the new result — no undo round-trip needed because the source
+     * selection is never touched by a fill.
+     */
+    var handleChooseFillType = (0, react_1.useCallback)(function (fillType) {
+        if (!fillOptions)
+            return;
+        onFill === null || onFill === void 0 ? void 0 : onFill(fillOptions.sheetId, fillOptions.activeCell, fillOptions.fillSelection, fillOptions.selections, undefined, fillType);
+        setFillOptions(tslib_1.__assign(tslib_1.__assign({}, fillOptions), { fillType: fillType, mode: "smart-tag" }));
+        focusSheet();
+    }, [fillOptions, onFill, setFillOptions, focusSheet]);
+    var handleCloseFillOptions = (0, react_1.useCallback)(function () {
+        // Only the right-drag menu is "cancel on close"; the smart tag stays.
+        if ((fillOptions === null || fillOptions === void 0 ? void 0 : fillOptions.mode) === "menu")
+            setFillOptions(null);
+    }, [fillOptions, setFillOptions]);
+    /**
+     * Run Excel's Series dialog result: the target range's first row (Series
+     * in Columns) / first column (Rows) is the seed line; `stop` may shrink or
+     * extend the target along the axis from the seed's last value.
+     */
+    var applyFillSeriesSpec = (0, react_1.useCallback)(function (fillSheetId, cell, target, spec) {
+        var seed = (0, fill_series_1.seedRangeForSeriesSpec)(target.range, spec);
+        var fillRange = (0, fill_series_1.fillRangeForSeriesSpec)({
+            target: target.range,
+            seed: seed,
+            spec: spec,
+            getSeedValue: function (r, c) {
+                var value = getEffectiveValue(fillSheetId, r, c);
+                return typeof value === "number" ? value : undefined;
+            },
+            rowCount: rowCount,
+            columnCount: columnCount,
+        });
+        if (!fillRange)
+            return;
+        var fillType = spec.type === "linear"
+            ? spec.trend
+                ? "LinearTrend"
+                : "FillSeries"
+            : spec.type === "growth"
+                ? "GrowthTrend"
+                : spec.type === "date"
+                    ? spec.dateUnit === "weekday"
+                        ? "FillWeekdays"
+                        : spec.dateUnit === "month"
+                            ? "FillMonths"
+                            : spec.dateUnit === "year"
+                                ? "FillYears"
+                                : "FillDays"
+                    : undefined;
+        onFill === null || onFill === void 0 ? void 0 : onFill(fillSheetId, cell, { range: fillRange }, [tslib_1.__assign(tslib_1.__assign({}, target), { range: seed })], undefined, fillType, { series: spec });
+        onChangeSelections === null || onChangeSelections === void 0 ? void 0 : onChangeSelections(fillSheetId, [tslib_1.__assign(tslib_1.__assign({}, target), { range: fillRange })]);
+    }, [getEffectiveValue, onFill, onChangeSelections, rowCount, columnCount]);
+    /** Open the Series dialog for a range (the current selection by default). */
+    var openFillSeriesDialogFor = (0, react_1.useCallback)(function (target, initialIn) {
+        var _a;
+        var selection = (_a = target !== null && target !== void 0 ? target : selections[selections.length - 1]) !== null && _a !== void 0 ? _a : { range: (0, grid_1.cellToArea)(activeCell) };
+        openFillSeriesDialog({
+            sheetId: sheetId,
+            activeCell: activeCell,
+            selection: selection,
+            initialIn: initialIn,
+            onApply: function (spec) {
+                return applyFillSeriesSpec(sheetId, activeCell, selection, spec);
+            },
+        });
+    }, [selections, activeCell, sheetId, openFillSeriesDialog, applyFillSeriesSpec]);
+    /** "Series…" on the right-drag fill menu: the drag's target is the range, its axis the default. */
+    var handleOpenFillSeriesDialog = (0, react_1.useCallback)(function () {
+        var _a;
+        if (!fillOptions)
+            return;
+        var range = fillOptions.fillSelection.range;
+        var source = (_a = fillOptions.selections[0]) === null || _a === void 0 ? void 0 : _a.range;
+        var initialIn = source &&
+            (range.endRowIndex > source.endRowIndex ||
+                range.startRowIndex < source.startRowIndex)
+            ? "columns"
+            : "rows";
+        setFillOptions(null);
+        openFillSeriesDialogFor({ range: range }, initialIn);
+    }, [fillOptions, setFillOptions, openFillSeriesDialogFor]);
+    // The smart tag belongs to one fill; moving on (a new active cell) drops it.
+    // Keyed on the cell's coordinates, not the object — a re-created `activeCell`
+    // with the same coordinates must not dismiss it.
+    (0, react_1.useEffect)(function () {
+        setFillOptions(null);
+    }, [activeCell.rowIndex, activeCell.columnIndex, sheetId, setFillOptions]);
+    /**
+     * Fill handle dragged BACK inside the selection (Excel): the dragged-over cells lose their
+     * contents — formats stay unless Ctrl/Cmd was held — through the same `onDelete` path as the
+     * Delete key, so both engines (legacy `useOnDelete`, rnc `delete-cells`) clear identically.
+     */
+    var handleFillShrink = (0, react_1.useCallback)(function (sheetId, activeCell, clearRange, options) {
+        onDelete === null || onDelete === void 0 ? void 0 : onDelete(sheetId, activeCell, [{ range: clearRange }], (options === null || options === void 0 ? void 0 : options.modifier) === "toggle" ? "all" : "contents");
+    }, [onDelete]);
     /**
      * Handle grid selections
      */
-    var _64 = (0, use_selection_1.useSelection)({
+    var _65 = (0, use_selection_1.useSelection)({
         sheetId: sheetId,
         getDataRowCount: getDataRowCount,
         enableDataBoundaryNavigation: enableDataBoundaryNavigation,
@@ -2082,6 +2240,8 @@ function CanvasGridComponent(props, forwardedRef) {
         scrollToCell: scrollToCell,
         isMergedCell: isMergedCell,
         onFill: onFill,
+        onFillHandleRelease: handleFillHandleRelease,
+        onFillShrink: handleFillShrink,
         onMoveSelection: onMoveSelection,
         isHiddenColumn: isHiddenColumn,
         isHiddenRow: isHiddenRow,
@@ -2089,11 +2249,11 @@ function CanvasGridComponent(props, forwardedRef) {
         isColumnHeader: isColumnHeader,
         isTouchDevice: helpers_1.isTouchDevice,
         dataRegionBoundaries: dataRegionBoundaries,
-    }), onMouseDownSelection = _64.onMouseDown, onPointerDownSelection = _64.onPointerDown, onKeyDownSelection = _64.onKeyDown, fillSelection = _64.fillSelection, onFillHandleMouseDown = _64.onFillHandleMouseDown, onFillHandleDoubleClick = _64.onFillHandleDoubleClick, isDragging = _64.isDragging, isFilling = _64.isFilling, isSelectionInProgress = _64.isSelectionInProgress, draggedSelection = _64.draggedSelection, onSelectionMouseDown = _64.onSelectionMouseDown, setActiveCell = _64.setActiveCell, initialDraggedSelection = _64.initialDraggedSelection, updateSelectionStartEndReference = _64.updateSelectionStartEndReference, selectColumn = _64.selectColumn, getContentfulGridRangeAroundCell = _64.getContentfulGridRangeAroundCell, newSelection = _64.newSelection, modifySelection = _64.modifySelection, clearSelections = _64.clearSelections;
+    }), onMouseDownSelection = _65.onMouseDown, onPointerDownSelection = _65.onPointerDown, onKeyDownSelection = _65.onKeyDown, fillSelection = _65.fillSelection, fillShrink = _65.fillShrink, onFillHandleMouseDown = _65.onFillHandleMouseDown, onFillHandleDoubleClick = _65.onFillHandleDoubleClick, isDragging = _65.isDragging, isFilling = _65.isFilling, isSelectionInProgress = _65.isSelectionInProgress, draggedSelection = _65.draggedSelection, onSelectionMouseDown = _65.onSelectionMouseDown, setActiveCell = _65.setActiveCell, initialDraggedSelection = _65.initialDraggedSelection, updateSelectionStartEndReference = _65.updateSelectionStartEndReference, selectColumn = _65.selectColumn, getContentfulGridRangeAroundCell = _65.getContentfulGridRangeAroundCell, newSelection = _65.newSelection, modifySelection = _65.modifySelection, clearSelections = _65.clearSelections;
     /**
      * Copy, Paste and Cut hook
      */
-    var _65 = (0, use_copy_paste_cut_1.useCopyPasteCut)({
+    var _66 = (0, use_copy_paste_cut_1.useCopyPasteCut)({
         activeCell: activeCell,
         selections: selections,
         sheetId: sheetId,
@@ -2101,7 +2261,7 @@ function CanvasGridComponent(props, forwardedRef) {
         onPaste: onPaste,
         onCopy: onCopy,
         onCut: onCut,
-    }), copiedSelections = _65.copiedSelections, clearCopiedSelections = _65.clearCopiedSelections, copy = _65.copy, cut = _65.cut, paste = _65.paste, onInternalCopy = _65.onInternalCopy, onInternalCut = _65.onInternalCut, onInternalPaste = _65.onInternalPaste;
+    }), copiedSelections = _66.copiedSelections, clearCopiedSelections = _66.clearCopiedSelections, copy = _66.copy, cut = _66.cut, paste = _66.paste, onInternalCopy = _66.onInternalCopy, onInternalCut = _66.onInternalCut, onInternalPaste = _66.onInternalPaste;
     /**
      * Paste Special dialog (context menu → Paste special…, Ctrl+Alt+V). The
      * dialog is host-mounted (`PasteSpecialDialogHost`); its request routes
@@ -2259,6 +2419,8 @@ function CanvasGridComponent(props, forwardedRef) {
         onChange: onChange,
         getCommitValidation: getCommitValidation,
         showValidationAlert: showValidationAlert,
+        selections: selections,
+        onChangeBatch: onChangeBatch,
     });
     /**
      * User cancels editing the cell
@@ -2426,7 +2588,7 @@ function CanvasGridComponent(props, forwardedRef) {
      * Displays Context menu when user right clicks
      * the grid
      */
-    var _66 = (0, use_context_menu_1.useContextMenu)({
+    var _67 = (0, use_context_menu_1.useContextMenu)({
         getCellCoordsFromOffset: getCellCoordsFromOffset,
         getRelativePositionFromOffset: getRelativePositionFromOffset,
         isRowHeader: isRowHeader,
@@ -2435,7 +2597,7 @@ function CanvasGridComponent(props, forwardedRef) {
         getCellOffsetFromCoords: getCellOffsetFromCoords,
         getScrollPosition: getScrollPosition,
         ContextMenuWrapper: ContextMenuWrapper,
-    }), onContextMenu = _66.onContextMenu, contextMenuComponent = _66.contextMenuComponent, onRequestCloseContextMenu = _66.onRequestClose, showContextMenu = _66.showContextMenu;
+    }), onContextMenu = _67.onContextMenu, contextMenuComponent = _67.contextMenuComponent, onRequestCloseContextMenu = _67.onRequestClose, showContextMenu = _67.showContextMenu;
     /**
      * Shortcut handlers for formatting
      * TODO: Decide on the output
@@ -2515,7 +2677,7 @@ function CanvasGridComponent(props, forwardedRef) {
     /**
      * Allow grid to be ediable
      */
-    var _67 = (0, use_editable_1.useEditable)({
+    var _68 = (0, use_editable_1.useEditable)({
         sheetId: sheetId,
         enableEditOnEnterKey: enableEditOnEnterKey,
         canEdit: canEditCell,
@@ -2564,11 +2726,11 @@ function CanvasGridComponent(props, forwardedRef) {
         onCopy: onInternalCopy,
         onPaste: onInternalPaste,
         onCut: onInternalCut,
-    }), onMouseDownEditable = _67.onMouseDown, onDoubleClickEditable = _67.onDoubleClick, editorComponent = _67.editorComponent, isEditInProgress = _67.isEditInProgress, makeEditable = _67.makeEditable, editCell = _67.editCell, setEditorValue = _67.setEditorValue, hideEditor = _67.hideEditor, getNextFocusableCell = _67.getNextFocusableCell, submitEditor = _67.submitEditor, cancelEditor = _67.cancelEditor, commit = _67.commit;
+    }), onMouseDownEditable = _68.onMouseDown, onDoubleClickEditable = _68.onDoubleClick, editorComponent = _68.editorComponent, isEditInProgress = _68.isEditInProgress, makeEditable = _68.makeEditable, editCell = _68.editCell, setEditorValue = _68.setEditorValue, hideEditor = _68.hideEditor, getNextFocusableCell = _68.getNextFocusableCell, submitEditor = _68.submitEditor, cancelEditor = _68.cancelEditor, commit = _68.commit;
     /**
      * Move rows and columns
      */
-    var _68 = (0, use_move_columns_rows_1.useMoveColumnsAndRows)({
+    var _69 = (0, use_move_columns_rows_1.useMoveColumnsAndRows)({
         getCellOffsetFromCoords: getCellOffsetFromCoords,
         getCellCoordsFromOffset: getCellCoordsFromOffset,
         getRelativePositionFromOffset: getRelativePositionFromOffset,
@@ -2591,11 +2753,11 @@ function CanvasGridComponent(props, forwardedRef) {
         sheetId: sheetId,
         disabled: isRestricted,
         HeaderMoveDragComponent: HeaderMoveDragComponent,
-    }), draggableColumns = _68.draggableColumns, draggableRows = _68.draggableRows, isDraggingRowsAndColumns = _68.isDragging;
+    }), draggableColumns = _69.draggableColumns, draggableRows = _69.draggableRows, isDraggingRowsAndColumns = _69.isDragging;
     /**
      * Header actions
      */
-    var _69 = (0, use_header_actions_1.useHeaderActions)({
+    var _70 = (0, use_header_actions_1.useHeaderActions)({
         activeCell: isSelectionInProgress || isFilling || isDragging ? null : hoveredCell,
         getScrollPosition: getScrollPosition,
         getCellOffsetFromCoords: getCellOffsetFromCoords,
@@ -2622,7 +2784,7 @@ function CanvasGridComponent(props, forwardedRef) {
         selectedRowHeadersIds: selectedRowHeadersIds,
         selectedColumnHeadersIds: selectedColumnHeadersIds,
         enableResizerOverflow: enableResizerOverflow,
-    }), headerMenuComponent = _69.headerMenuComponent, isHeaderMenuInFrozenColumn = _69.isHeaderMenuInFrozenColumn, headerResizer = _69.headerResizer, isDraggingHeader = _69.isDragging;
+    }), headerMenuComponent = _70.headerMenuComponent, isHeaderMenuInFrozenColumn = _70.isHeaderMenuInFrozenColumn, headerResizer = _70.headerResizer, isDraggingHeader = _70.isDragging;
     /**
      * Close tooltip
      */
@@ -2664,7 +2826,7 @@ function CanvasGridComponent(props, forwardedRef) {
     /**
      * Show basicFilter panels
      */
-    var _70 = (0, use_filter_1.useFilter)({
+    var _71 = (0, use_filter_1.useFilter)({
         sheetId: sheetId,
         scale: scale,
         theme: theme,
@@ -2689,9 +2851,9 @@ function CanvasGridComponent(props, forwardedRef) {
         // Live filter state so the open popup tracks Auto-apply spec changes.
         basicFilter: basicFilter,
         tables: activeTables,
-    }), showFilter = _70.showFilter, hideFilter = _70.hideFilter, filterComponent = _70.filterComponent;
+    }), showFilter = _71.showFilter, hideFilter = _71.hideFilter, filterComponent = _71.filterComponent;
     // Table resize
-    var _71 = (0, use_table_resizer_1.useTableResizer)({
+    var _72 = (0, use_table_resizer_1.useTableResizer)({
         sheetId: sheetId,
         tables: tables !== null && tables !== void 0 ? tables : undefined,
         theme: theme,
@@ -2702,11 +2864,11 @@ function CanvasGridComponent(props, forwardedRef) {
         scrollToCell: scrollToCell,
         onResizeTable: onResizeTable,
         focusSheet: focusSheet,
-    }), tableResizers = _71.tableResizers, isResizingTable = _71.isResizingTable;
+    }), tableResizers = _72.tableResizers, isResizingTable = _72.isResizingTable;
     /**
      * Displays resizable/draggable charts
      */
-    var _72 = (0, use_embeds_charts_1.useEmbedsCharts)({
+    var _73 = (0, use_embeds_charts_1.useEmbedsCharts)({
         charts: charts,
         embeds: embeds,
         slicers: slicers,
@@ -2743,7 +2905,7 @@ function CanvasGridComponent(props, forwardedRef) {
         backgroundColor: cellBackgroundColor,
         disabled: isRestricted,
         readonly: readonly,
-    }), chartComponents = _72.chartComponents, embedComponents = _72.embedComponents, slicerComponents = _72.slicerComponents, onMouseDownCharts = _72.onMouseDown;
+    }), chartComponents = _73.chartComponents, embedComponents = _73.embedComponents, slicerComponents = _73.slicerComponents, onMouseDownCharts = _73.onMouseDown;
     /**
      * Callback when user clicks Filter icon
      * Show Filter dropdown here
@@ -2873,6 +3035,8 @@ function CanvasGridComponent(props, forwardedRef) {
         hideCellPopover();
         // Hide paste mnenu
         setShowPasteMenu(false);
+        // Hide the Auto Fill Options smart tag (its own mousedown never reaches here)
+        setFillOptions(null);
         // Remove pinned tooltip
         onUnpinTooltip();
     }, [
@@ -2884,6 +3048,7 @@ function CanvasGridComponent(props, forwardedRef) {
         setFormulaState,
         hideCellPopover,
         setShowPasteMenu,
+        setFillOptions,
         onUnpinTooltip,
         focusSheet,
     ]);
@@ -2998,7 +3163,7 @@ function CanvasGridComponent(props, forwardedRef) {
     /**
      * Render Cells in the grid
      */
-    var _73 = tslib_1.__read((0, use_cell_renderer_1.useCellRenderer)({
+    var _74 = tslib_1.__read((0, use_cell_renderer_1.useCellRenderer)({
         sheetId: sheetId,
         showGridLines: showGridLines,
         scale: scale,
@@ -3064,7 +3229,7 @@ function CanvasGridComponent(props, forwardedRef) {
         onOverflow: handleOverflow,
         isComparing: isComparing,
         getCellDiff: getCellDiff,
-    }), 4), cellBackgroundRenderer = _73[0], cellRenderer = _73[1], cellOverlayRenderer = _73[2], headerCellRenderer = _73[3];
+    }), 4), cellBackgroundRenderer = _74[0], cellRenderer = _74[1], cellOverlayRenderer = _74[2], headerCellRenderer = _74[3];
     /**
      * When user selects a selection for moving
      * If its a table, we select the entire column
@@ -3100,11 +3265,11 @@ function CanvasGridComponent(props, forwardedRef) {
         tokenizer: tokenizer,
     });
     // Selection move: drag a formula reference via its border covers
-    var _74 = (0, use_selection_move_1.useSelectionMove)({
+    var _75 = (0, use_selection_move_1.useSelectionMove)({
         getCellCoordsFromOffset: getCellCoordsFromOffset,
         scrollToCell: scrollToCell,
         tokenizer: tokenizer,
-    }), onMouseDownMoveSelection = _74.onMouseDownMoveSelection, isDraggingMoveSelection = _74.isDragging;
+    }), onMouseDownMoveSelection = _75.onMouseDownMoveSelection, isDraggingMoveSelection = _75.isDragging;
     /**
      * Hide fill handle
      * 1. When user is in edit mode
@@ -3117,9 +3282,9 @@ function CanvasGridComponent(props, forwardedRef) {
     /**
      * Flashing
      */
-    var _75 = (0, use_flash_1.useFlash)({
+    var _76 = (0, use_flash_1.useFlash)({
         theme: theme,
-    }), flash = _75.flash, mark = _75.mark, unmark = _75.unmark, onFlashEnd = _75.onFlashEnd, flashingBorders = _75.flashingBorders;
+    }), flash = _76.flash, mark = _76.mark, unmark = _76.unmark, onFlashEnd = _76.onFlashEnd, flashingBorders = _76.flashingBorders;
     // Cache hover ids
     var cachedHoveredSelectionIds = (0, use_hovered_selection_ids_1.useHoveredSelectionIds)({
         selections: selections,
@@ -3129,9 +3294,12 @@ function CanvasGridComponent(props, forwardedRef) {
     /**
      * Selection Renderer
      */
+    // The drag-back preview reuses the fill overlay geometry but greys the cells about to be cleared.
+    var fillShrinkOverlay = (0, react_1.useMemo)(function () { return (fillShrink ? { range: fillShrink.clearRange } : undefined); }, [fillShrink]);
     var selectionRenderer = (0, use_selection_renderer_1.useSelectionRenderer)({
         sheetId: sheetId,
         scale: scale,
+        isFillShrink: fillShrink !== undefined,
         onSelectionMouseDown: onSelectionElementMouseDown,
         onMouseDownResizeHandle: onMouseDownResizeHandle,
         onMouseDownMoveSelection: onMouseDownMoveSelection,
@@ -3160,6 +3328,10 @@ function CanvasGridComponent(props, forwardedRef) {
         readonly: readonly,
         onSplitTextToColumns: onSplitTextToColumns,
         showPasteMenu: showPasteMenu,
+        fillOptions: fillOptions,
+        onChooseFillType: handleChooseFillType,
+        onOpenFillSeriesDialog: handleOpenFillSeriesDialog,
+        onCloseFillOptions: handleCloseFillOptions,
         hoveredCell: delayedHoveredCell,
         onRemoveQuickEdit: onRemoveQuickEdit,
         onAddQuickEdit: onAddQuickEdit,
@@ -3195,7 +3367,7 @@ function CanvasGridComponent(props, forwardedRef) {
         quickEditValues: quickEditValues,
     });
     // Hidden column markers
-    var _76 = tslib_1.__read((0, use_hidden_dimension_markers_1.useHiddenDimensionMarkers)({
+    var _77 = tslib_1.__read((0, use_hidden_dimension_markers_1.useHiddenDimensionMarkers)({
         sheetId: sheetId,
         columnMetadata: columnMetadata,
         rowMetadata: rowMetadata,
@@ -3208,7 +3380,7 @@ function CanvasGridComponent(props, forwardedRef) {
         columnCount: columnCount,
         HiddenRowMarkers: HiddenRowMarkers,
         HiddenColumnMarkers: HiddenColumnMarkers,
-    }), 4), hiddenColumnMarkers = _76[0], frozenHiddenColumnMarkers = _76[1], hiddenRowMarkers = _76[2], frozenHiddenRowMarkers = _76[3];
+    }), 4), hiddenColumnMarkers = _77[0], frozenHiddenColumnMarkers = _77[1], hiddenRowMarkers = _77[2], frozenHiddenRowMarkers = _77[3];
     // Zoom lister
     var onMouseWheel = (0, use_scale_listener_1.useScaleListener)({
         zoomSpeed: zoomSpeed,
@@ -3388,7 +3560,7 @@ function CanvasGridComponent(props, forwardedRef) {
     });
     // Pivot placeholders
     var pivotPlaceholders = (0, react_1.useMemo)(function () {
-        var e_11, _a;
+        var e_12, _a;
         var _b, _c;
         var placeholders = [];
         var displayIdx = 0;
@@ -3404,12 +3576,12 @@ function CanvasGridComponent(props, forwardedRef) {
                 }
             }
         }
-        catch (e_11_1) { e_11 = { error: e_11_1 }; }
+        catch (e_12_1) { e_12 = { error: e_12_1 }; }
         finally {
             try {
                 if (_e && !_e.done && (_a = _d.return)) _a.call(_d);
             }
-            finally { if (e_11) throw e_11.error; }
+            finally { if (e_12) throw e_12.error; }
         }
         return placeholders;
     }, [pivotTables, sheetId, onRequestEditPivotTable, getCellOffsetFromCoords]);
@@ -3486,12 +3658,14 @@ function CanvasGridComponent(props, forwardedRef) {
     });
     // props reference for spreadsheet api
     propsReferenceRef.current = props;
+    var openFillSeriesDialogForRef = (0, use_stable_ref_1.useStableRef)(openFillSeriesDialogFor);
     // Expose a spreadsheet API
     (0, use_isomorphic_layout_effect_1.useIsomorphicLayoutEffect)(function () {
         var stableMethods = {
             getUserEnteredValue: getUserEnteredStringValueStable,
             scrollToCell: scrollToCell,
             commit: commit,
+            openFillSeriesDialog: function () { var _a; return (_a = openFillSeriesDialogForRef.current) === null || _a === void 0 ? void 0 : _a.call(openFillSeriesDialogForRef); },
         };
         setSpreadsheetApi(new spreadsheet_api_1.SpreadsheetApi(propsReferenceRef, stableMethods, store, instanceStore, instanceId));
     }, []);
@@ -3573,7 +3747,7 @@ function CanvasGridComponent(props, forwardedRef) {
         width === 0 || height === 0 ? (react_1.default.createElement("div", { className: "flex border-solid border-rnc-border border border-t border-b flex-1 justify-center items-center" },
             react_1.default.createElement("div", { className: "space-y-2" },
                 react_1.default.createElement(ui_1.Skeleton, { className: "h-4 w-[250px]" }),
-                react_1.default.createElement(ui_1.Skeleton, { className: "h-4 w-[250px]" })))) : (react_1.default.createElement(grid_5.Grid, { ref: gridRef, overscanCount: overscanCount, rowCount: sheetRowCount, columnCount: sheetColumnCount, rowHeight: rowHeight, columnWidth: columnWidth, itemRenderer: cellRenderer, headerRenderer: headerCellRenderer, selectionRenderer: selectionRenderer, gridLineColor: gridLineColor, gridLineWidth: gridLineWidth, borderStyles: finalBorderStyles, mergedCells: merges, scale: scale, width: width, height: height, frozenColumns: frozenColumns, frozenRows: frozenRows, activeCell: activeCell, selections: formulaMode ? formulaSelections : selections, FillHandle: fill_handle_1.FillHandle, showFillHandle: showFillHandle, fillHandleSize: fillHandleSize, showGridLines: showGridLines, enableCellOverlay: true, enableCellBackground: true, enableSelectionDrag: enableSelectionDrag, showFrozenColumnShadow: showFrozenSeparator, showFrozenRowShadow: showFrozenSeparator, selectionBorderColor: selectionBorderColor, selectionBackgroundColor: selectionBackgroundColor, fillhandleBorderColor: cellBackgroundColor, isDraggingSelection: isDragging, fillSelection: fillSelection, onPointerDown: handlePointerDown, onPointerUp: handlePointerUp, onMouseDown: handleMouseDown, onDoubleClick: handleDoubleClick, onFillHandleMouseDown: onFillHandleMouseDown, onFillHandleDoubleClick: onFillHandleDoubleClick, 
+                react_1.default.createElement(ui_1.Skeleton, { className: "h-4 w-[250px]" })))) : (react_1.default.createElement(grid_5.Grid, { ref: gridRef, overscanCount: overscanCount, rowCount: sheetRowCount, columnCount: sheetColumnCount, rowHeight: rowHeight, columnWidth: columnWidth, itemRenderer: cellRenderer, headerRenderer: headerCellRenderer, selectionRenderer: selectionRenderer, gridLineColor: gridLineColor, gridLineWidth: gridLineWidth, borderStyles: finalBorderStyles, mergedCells: merges, scale: scale, width: width, height: height, frozenColumns: frozenColumns, frozenRows: frozenRows, activeCell: activeCell, selections: formulaMode ? formulaSelections : selections, FillHandle: fill_handle_1.FillHandle, showFillHandle: showFillHandle, fillHandleSize: fillHandleSize, showGridLines: showGridLines, enableCellOverlay: true, enableCellBackground: true, enableSelectionDrag: enableSelectionDrag, showFrozenColumnShadow: showFrozenSeparator, showFrozenRowShadow: showFrozenSeparator, selectionBorderColor: selectionBorderColor, selectionBackgroundColor: selectionBackgroundColor, fillhandleBorderColor: cellBackgroundColor, isDraggingSelection: isDragging, fillSelection: fillShrinkOverlay !== null && fillShrinkOverlay !== void 0 ? fillShrinkOverlay : fillSelection, onPointerDown: handlePointerDown, onPointerUp: handlePointerUp, onMouseDown: handleMouseDown, onDoubleClick: handleDoubleClick, onFillHandleMouseDown: onFillHandleMouseDown, onFillHandleDoubleClick: onFillHandleDoubleClick, 
             // Dimension of fill handle
             scrollToCellOffset: 4, scrollbarSize: scrollbarSize, isHiddenCell: isHiddenCell, isHiddenColumn: isHiddenColumn, isHiddenRow: isHiddenRow, visibleRowRanges: visibleRowRanges, isHiddenOverlay: isHiddenOverlay, isHiddenBackground: isHiddenBackground, overlayRenderer: cellOverlayRenderer, backgroundRenderer: cellBackgroundRenderer, shadowSettings: shadowSettings, onScroll: handleScroll, onViewPortChange: handleViewPortChange, autoFocus: autoFocus, snap: scrollSnap, scrollThrottleTimeout: scrollThrottleTimeout, preventBrowserDefaultScroll: preventBrowserDefaultScroll, showHeaders: showHeaders, gridChildren: gridChildren, onTouchStart: onTouchStart, onDimensionsChange: onDimensionsChange, extendScrollSize: helpers_1.isTouchDevice || helpers_1.isFirefox, isTouchDevice: helpers_1.isTouchDevice, frozenShadowThickness: frozenShadowThickness, onAfterScrollToCell: onAfterScrollToCell, estimatedRowHeight: defaultRowHeight, estimatedColumnWidth: defaultColumnWidth, footerHeight: footerHeight, footerComponent: footerComponent, getOverflowBuffer: getOverflowBuffer, getFrozenColumnOverflowCells: getFrozenColumnOverflowCells })),
         tooltipComponent,