@rowsncolumns/spreadsheet 10.2.75 → 10.2.76

package/dist/cjs/hooks/use-selection-renderer.js

@@ -9,8 +9,11 @@ var atoms_1 = require("../atoms");
 var formula_mode_atom_1 = require("../atoms/formula-mode.atom");
 var config_1 = require("../config");
 var selection_1 = require("./../components/selection");
+/** Excel greys the cells a fill-handle drag-back is about to clear. */
+var FILL_SHRINK_COLOR = "#808080";
+var FILL_SHRINK_OPACITY = 0.25;
 var useSelectionRenderer = function (_a) {
-    var sheetId = _a.sheetId, selectionCount = _a.selectionCount, selectionBackgroundColor = _a.selectionBackgroundColor, selectionBorderColor = _a.selectionBorderColor, onSelectionMouseDown = _a.onSelectionMouseDown, onChangeActiveCell = _a.onChangeActiveCell, onChangeSelections = _a.onChangeSelections, onRequestEditTable = _a.onRequestEditTable, onRequestEditPivotTable = _a.onRequestEditPivotTable, onMouseDownResizeHandle = _a.onMouseDownResizeHandle, onMouseDownMoveSelection = _a.onMouseDownMoveSelection, isDraggingMoveSelection = _a.isDraggingMoveSelection, onFlashEnd = _a.onFlashEnd, getSheetName = _a.getSheetName, _b = _a.resizeHandleSize, resizeHandleSize = _b === void 0 ? 6 : _b, showSelectionResizeHandles = _a.showSelectionResizeHandles, resizeHandleBorderColor = _a.resizeHandleBorderColor, SelectionTitleComponent = _a.SelectionTitleComponent, isResizingTable = _a.isResizingTable, fillHandleSize = _a.fillHandleSize, showFillHandle = _a.showFillHandle, enableMagicFill = _a.enableMagicFill, MagicFillComponent = _a.MagicFillComponent, MagicFillContent = _a.MagicFillContent, readonly = _a.readonly, showPasteMenu = _a.showPasteMenu, hoveredCell = _a.hoveredCell, onSplitTextToColumns = _a.onSplitTextToColumns, onRemoveQuickEdit = _a.onRemoveQuickEdit, onAddQuickEdit = _a.onAddQuickEdit, QuickEdit = _a.QuickEdit, PasteMenu = _a.PasteMenu, SuggestionAction = _a.SuggestionAction, cachedHoveredSelectionIds = _a.cachedHoveredSelectionIds;
+    var sheetId = _a.sheetId, selectionCount = _a.selectionCount, selectionBackgroundColor = _a.selectionBackgroundColor, selectionBorderColor = _a.selectionBorderColor, onSelectionMouseDown = _a.onSelectionMouseDown, onChangeActiveCell = _a.onChangeActiveCell, onChangeSelections = _a.onChangeSelections, onRequestEditTable = _a.onRequestEditTable, onRequestEditPivotTable = _a.onRequestEditPivotTable, onMouseDownResizeHandle = _a.onMouseDownResizeHandle, onMouseDownMoveSelection = _a.onMouseDownMoveSelection, isDraggingMoveSelection = _a.isDraggingMoveSelection, onFlashEnd = _a.onFlashEnd, getSheetName = _a.getSheetName, _b = _a.resizeHandleSize, resizeHandleSize = _b === void 0 ? 6 : _b, showSelectionResizeHandles = _a.showSelectionResizeHandles, resizeHandleBorderColor = _a.resizeHandleBorderColor, SelectionTitleComponent = _a.SelectionTitleComponent, isResizingTable = _a.isResizingTable, fillHandleSize = _a.fillHandleSize, showFillHandle = _a.showFillHandle, enableMagicFill = _a.enableMagicFill, MagicFillComponent = _a.MagicFillComponent, MagicFillContent = _a.MagicFillContent, readonly = _a.readonly, showPasteMenu = _a.showPasteMenu, fillOptions = _a.fillOptions, onChooseFillType = _a.onChooseFillType, onOpenFillSeriesDialog = _a.onOpenFillSeriesDialog, onCloseFillOptions = _a.onCloseFillOptions, hoveredCell = _a.hoveredCell, onSplitTextToColumns = _a.onSplitTextToColumns, onRemoveQuickEdit = _a.onRemoveQuickEdit, onAddQuickEdit = _a.onAddQuickEdit, QuickEdit = _a.QuickEdit, PasteMenu = _a.PasteMenu, SuggestionAction = _a.SuggestionAction, cachedHoveredSelectionIds = _a.cachedHoveredSelectionIds, _c = _a.isFillShrink, isFillShrink = _c === void 0 ? false : _c;
     var formulaMode = (0, formula_mode_atom_1.useFormulaModeValue)();
     var selectionIndex = (0, atoms_1.useFormulaSelectionIndex)();
     var hoveredCellRef = (0, react_1.useRef)(hoveredCell);
@@ -52,13 +55,17 @@ var useSelectionRenderer = function (_a) {
             : (0, selections_1.getSelectionStrokeWidth)(formulaMode, isFill, isActiveCell, isResizingTable);
         var fillOpacity = isBorder
             ? props.fillOpacity
-            : (0, selections_1.getSelectionFillOpacity)(formulaMode, isFill);
+            : isFill && isFillShrink
+                ? FILL_SHRINK_OPACITY
+                : (0, selections_1.getSelectionFillOpacity)(formulaMode, isFill);
         var stroke = isBorder
             ? props.stroke
             : (0, selections_1.getSelectionStroke)(formulaMode, isFill, isActiveCell, isEmptySelections, inProgress, selectionBorderColor, index);
         var fill = isBorder
             ? props.fill
-            : (0, selections_1.getSelectionFill)(formulaMode, isFill, isActiveCell, selectionBackgroundColor, index, isActiveIndex, isResizingTable);
+            : isFill && isFillShrink
+                ? FILL_SHRINK_COLOR
+                : (0, selections_1.getSelectionFill)(formulaMode, isFill, isActiveCell, selectionBackgroundColor, index, isActiveIndex, isResizingTable);
         return (react_1.default.createElement(selection_1.Selection, tslib_1.__assign({}, props, { key: index, 
             // Overwrite draggable
             draggable: isResizingTable ? false : draggable, 
@@ -91,7 +98,12 @@ var useSelectionRenderer = function (_a) {
                         onSelectionMouseDown === null || onSelectionMouseDown === void 0 ? void 0 : onSelectionMouseDown(e, activeCell, newSelection, 0);
                     }
                 }
-            }, isHovered: isHovered, TitleComponent: SelectionTitleComponent, onRequestEditTable: onRequestEditTable, onRequestEditPivotTable: onRequestEditPivotTable, fillHandleSize: fillHandleSize, showFillHandle: showFillHandle, onFlashEnd: onFlashEnd, duration: duration, enableMagicFill: formulaMode ? false : enableMagicFill, MagicFillComponent: MagicFillComponent, readonly: readonly, showPasteMenu: showPasteMenu, sheetId: sheetId, MagicFillContent: MagicFillContent, QuickEdit: QuickEdit, PasteMenu: PasteMenu, SuggestionAction: SuggestionAction, onSplitTextToColumns: function (delimiter) {
+            }, isHovered: isHovered, TitleComponent: SelectionTitleComponent, onRequestEditTable: onRequestEditTable, onRequestEditPivotTable: onRequestEditPivotTable, fillHandleSize: fillHandleSize, showFillHandle: showFillHandle, onFlashEnd: onFlashEnd, duration: duration, enableMagicFill: formulaMode ? false : enableMagicFill, MagicFillComponent: MagicFillComponent, readonly: readonly, showPasteMenu: showPasteMenu, fillOptions: fillOptions &&
+                range &&
+                fillOptions.sheetId === sheetId &&
+                (0, grid_1.isAreasEqual)(fillOptions.fillSelection.range, range)
+                ? fillOptions
+                : undefined, onChooseFillType: onChooseFillType, onOpenFillSeriesDialog: onOpenFillSeriesDialog, onCloseFillOptions: onCloseFillOptions, sheetId: sheetId, MagicFillContent: MagicFillContent, QuickEdit: QuickEdit, PasteMenu: PasteMenu, SuggestionAction: SuggestionAction, onSplitTextToColumns: function (delimiter) {
                 // Active cell
                 var newActiveCell = range
                     ? {
@@ -132,6 +144,10 @@ var useSelectionRenderer = function (_a) {
         MagicFillComponent,
         readonly,
         showPasteMenu,
+        fillOptions,
+        onChooseFillType,
+        onOpenFillSeriesDialog,
+        onCloseFillOptions,
         onSplitTextToColumns,
         MagicFillContent,
         QuickEdit,
@@ -140,6 +156,7 @@ var useSelectionRenderer = function (_a) {
         onRemoveQuickEdit,
         onAddQuickEdit,
         cachedHoveredSelectionIds,
+        isFillShrink,
     ]);
 };
 exports.useSelectionRenderer = useSelectionRenderer;

package/dist/cjs/hooks/use-selection.d.ts

@@ -2,7 +2,40 @@ import type { AreaStyle, CellInterface, GridRange, HiddenType, OptionalCellInter
 import { Align } from "@rowsncolumns/grid";
 import type React from "react";
 import type { CanvasGridProps } from "../components/canvas-grid/typings";
-import type { SheetRange } from "../types";
+import type { AutoFillType, FillOptions, SheetRange } from "../types";
+/**
+ * What the grid learns when a fill-handle gesture ends. For a left drag the
+ * fill has already been issued (`onFill`) and this lets the grid show Excel's
+ * Auto Fill Options smart tag; for a right-button drag NOTHING has been filled
+ * yet — the grid opens the fill menu and issues `onFill` with the chosen type.
+ */
+export type FillHandleRelease<T extends AreaStyle = AreaStyle> = {
+    sheetId: number;
+    activeCell: CellInterface;
+    /** Target range of the drag (source + filled area). */
+    fillSelection: SelectionArea;
+    /** Source selection the drag started from. */
+    selections: SelectionArea<T>[];
+    /** Ctrl (or Cmd on macOS) held when the handle was released. */
+    toggle: boolean;
+    button: "left" | "right";
+};
+/**
+ * Modifier state of a fill-handle gesture (drag, double-click, drag-back). `"toggle"` = Ctrl
+ * (Cmd on Mac) was held: Excel flips copy↔series for a fill and clears formats too for a
+ * drag-back shrink.
+ */
+export type FillGestureOptions = {
+    modifier?: "toggle";
+};
+/**
+ * A fill-handle drag back INSIDE the selection: `clearRange` = the excluded cells Excel empties on
+ * release (rendered greyed while dragging), `remaining` = the selection that survives.
+ */
+export type FillShrink = {
+    clearRange: GridRange;
+    remaining: GridRange;
+};
 export type UseSelectionOptions<T extends AreaStyle = AreaStyle> = {
     sheetId: number;
     /**
@@ -34,9 +67,25 @@ export type UseSelectionOptions<T extends AreaStyle = AreaStyle> = {
      */
     allowDeselectSelection?: boolean;
     /**
-     * onFill
+     * onFill. `fillType` is only set when the user picked an entry from the
+     * fill menu; `options.modifier` is `"toggle"` when Ctrl/Cmd was held at
+     * release (Excel decides the copy↔series inversion on release, not press) —
+     * for a Ctrl+drag and a Ctrl+double-click of the fill handle alike.
+     */
+    onFill?: (sheetId: number, activeCell: CellInterface, fillSelection: SelectionArea, selections: SelectionArea<T>[], fillableSelections?: SelectionArea<T>[], fillType?: AutoFillType, options?: FillOptions) => void;
+    /**
+     * Dragging the fill handle BACK inside a multi-cell selection (up or left, without passing its
+     * first row/column) excludes the dragged-over cells: Excel clears their contents (formats kept;
+     * Ctrl+drag also clears formats) and shrinks the selection to `remaining`. Called on mouse-up with
+     * the cells to clear; the hook then publishes `remaining` through `onChangeSelections`.
+     */
+    onFillShrink?: (sheetId: number, activeCell: CellInterface, clearRange: GridRange, options?: FillGestureOptions) => void;
+    /**
+     * Fired when a fill-handle drag ends (after `onFill` for a left drag; INSTEAD
+     * of `onFill` for a right-button drag). Lets the grid show the Auto Fill
+     * Options smart tag / right-drag fill menu.
      */
-    onFill?: (sheetId: number, activeCell: CellInterface, fillSelection: SelectionArea, selections: SelectionArea<T>[]) => void;
+    onFillHandleRelease?: (release: FillHandleRelease<T>) => void;
     /**
      * Hidden rows
      */
@@ -150,7 +199,7 @@ export type NewSelectionMode = "clear" | "modify" | "append";
  * Hook to enable selection in datagrid
  * @param initialSelection
  */
-export declare const useSelection: <T extends AreaStyle>({ sheetId, activeCell, onChangeActiveCell, selections, onChangeSelections, columnCount, rowCount, selectionPolicy, newSelectionMode, allowDeselectSelection, onFill, isHiddenRow, isHiddenColumn, alwaysScrollToActiveCell, selectionTopBound, selectionBottomBound, selectionLeftBound, selectionRightBound, mouseDownInterceptor, mouseMoveInterceptor, mergedCells, canSelectionSpanMergedCells, getValue, onMoveSelection, getCellCoordsFromOffset, getCellBounds, getViewPort, focus, scrollToCell, isMergedCell, enableSelectOnEnterKey, formulaMode, isTouchDevice, getDataRowCount, isRowHeader, isColumnHeader, enableDataBoundaryNavigation, }: UseSelectionOptions<T>) => {
+export declare const useSelection: <T extends AreaStyle>({ sheetId, activeCell, onChangeActiveCell, selections, onChangeSelections, columnCount, rowCount, selectionPolicy, newSelectionMode, allowDeselectSelection, onFill, onFillHandleRelease, onFillShrink, isHiddenRow, isHiddenColumn, alwaysScrollToActiveCell, selectionTopBound, selectionBottomBound, selectionLeftBound, selectionRightBound, mouseDownInterceptor, mouseMoveInterceptor, mergedCells, canSelectionSpanMergedCells, getValue, onMoveSelection, getCellCoordsFromOffset, getCellBounds, getViewPort, focus, scrollToCell, isMergedCell, enableSelectOnEnterKey, formulaMode, isTouchDevice, getDataRowCount, isRowHeader, isColumnHeader, enableDataBoundaryNavigation, }: UseSelectionOptions<T>) => {
     isDragging: boolean;
     draggedSelection: SelectionArea<T> | undefined;
     initialDraggedSelection: SelectionArea<T> | undefined;
@@ -164,6 +213,7 @@ export declare const useSelection: <T extends AreaStyle>({ sheetId, activeCell,
     onFillHandleMouseDown: (e: React.MouseEvent<HTMLDivElement>) => void;
     onFillHandleDoubleClick: (e: React.MouseEvent<HTMLDivElement>) => void;
     fillSelection: SelectionArea | undefined;
+    fillShrink: FillShrink | undefined;
     clearLastSelection: () => void;
     modifySelection: (coords: CellInterface, setInProgress?: boolean) => void;
     selectAll: () => void;

package/dist/cjs/hooks/use-selection.d.ts.map

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

package/dist/cjs/hooks/use-selection.js

@@ -11,6 +11,13 @@ var scheduler_1 = require("../api/scheduler");
 var config_1 = require("../config");
 var helpers_1 = require("../helpers");
 var use_callback_ref_1 = require("./use-callback-ref");
+/** Ctrl on every platform; Cmd is accepted as an alias on macOS (Excel for Mac uses Ctrl). */
+var isFillToggleModifier = function (e) {
+    return e.ctrlKey || e.metaKey;
+};
+var fillGestureOptions = function (e) {
+    return e.ctrlKey || e.metaKey ? { modifier: "toggle" } : undefined;
+};
 var defaultIsHidden = function () { return false; };
 var defaultSelectionSpan = function () { return true; };
 var getPossibleActiveCellFromSelections = function (selections) {
@@ -45,23 +52,90 @@ var boundsSubsetOfSelection = function (range, selection) {
         range.startColumnIndex >= selection.startColumnIndex &&
         range.endColumnIndex <= selection.endColumnIndex);
 };
+var cellInRange = function (cell, range) {
+    return cell.rowIndex >= range.startRowIndex &&
+        cell.rowIndex <= range.endRowIndex &&
+        cell.columnIndex >= range.startColumnIndex &&
+        cell.columnIndex <= range.endColumnIndex;
+};
+/**
+ * Resolve a fill-handle drag to a shrink of `selection` (Excel "drag back inside the selection").
+ * `coords` is the cell under the pointer. A shrink needs a multi-cell selection and a pointer that
+ * is inside it but short of its bottom-right corner along at least one axis; the axis with the
+ * larger travel wins (rows first on a tie), mirroring how a fill picks its direction. Returns
+ * `undefined` when the drag is not a shrink (outside the selection, single cell, or still at the
+ * corner) — the caller then treats it as a regular fill.
+ */
+var fillShrinkFor = function (selection, coords) {
+    var isSingleCell = selection.startRowIndex === selection.endRowIndex &&
+        selection.startColumnIndex === selection.endColumnIndex;
+    if (isSingleCell || !cellInRange(coords, selection))
+        return undefined;
+    var rowsExcluded = selection.endRowIndex - coords.rowIndex;
+    var colsExcluded = selection.endColumnIndex - coords.columnIndex;
+    if (rowsExcluded <= 0 && colsExcluded <= 0)
+        return undefined;
+    if (rowsExcluded >= colsExcluded) {
+        return {
+            clearRange: tslib_1.__assign(tslib_1.__assign({}, selection), { startRowIndex: coords.rowIndex + 1 }),
+            remaining: tslib_1.__assign(tslib_1.__assign({}, selection), { endRowIndex: coords.rowIndex }),
+        };
+    }
+    return {
+        clearRange: tslib_1.__assign(tslib_1.__assign({}, selection), { startColumnIndex: coords.columnIndex + 1 }),
+        remaining: tslib_1.__assign(tslib_1.__assign({}, selection), { endColumnIndex: coords.columnIndex }),
+    };
+};
 /**
  * Hook to enable selection in datagrid
  * @param initialSelection
  */
 var useSelection = function (_a) {
-    var sheetId = _a.sheetId, activeCell = _a.activeCell, onChangeActiveCell = _a.onChangeActiveCell, selections = _a.selections, onChangeSelections = _a.onChangeSelections, _b = _a.columnCount, columnCount = _b === void 0 ? 0 : _b, _c = _a.rowCount, rowCount = _c === void 0 ? 0 : _c, _d = _a.selectionPolicy, selectionPolicy = _d === void 0 ? "multiple" : _d, _e = _a.newSelectionMode, newSelectionMode = _e === void 0 ? "clear" : _e, _f = _a.allowDeselectSelection, allowDeselectSelection = _f === void 0 ? true : _f, onFill = _a.onFill, _g = _a.isHiddenRow, isHiddenRow = _g === void 0 ? defaultIsHidden : _g, _h = _a.isHiddenColumn, isHiddenColumn = _h === void 0 ? defaultIsHidden : _h, _j = _a.alwaysScrollToActiveCell, alwaysScrollToActiveCell = _j === void 0 ? true : _j, _k = _a.selectionTopBound, selectionTopBound = _k === void 0 ? 0 : _k, _l = _a.selectionBottomBound, selectionBottomBound = _l === void 0 ? rowCount : _l, _m = _a.selectionLeftBound, selectionLeftBound = _m === void 0 ? 0 : _m, _o = _a.selectionRightBound, selectionRightBound = _o === void 0 ? columnCount : _o, mouseDownInterceptor = _a.mouseDownInterceptor, mouseMoveInterceptor = _a.mouseMoveInterceptor, _p = _a.mergedCells, mergedCells = _p === void 0 ? config_1.DEFAULT_ARRAY : _p, _q = _a.canSelectionSpanMergedCells, canSelectionSpanMergedCells = _q === void 0 ? defaultSelectionSpan : _q, getValue = _a.getValue, onMoveSelection = _a.onMoveSelection, getCellCoordsFromOffset = _a.getCellCoordsFromOffset, getCellBounds = _a.getCellBounds, getViewPort = _a.getViewPort, focus = _a.focus, scrollToCell = _a.scrollToCell, isMergedCell = _a.isMergedCell, enableSelectOnEnterKey = _a.enableSelectOnEnterKey, formulaMode = _a.formulaMode, isTouchDevice = _a.isTouchDevice, getDataRowCount = _a.getDataRowCount, isRowHeader = _a.isRowHeader, isColumnHeader = _a.isColumnHeader, _r = _a.enableDataBoundaryNavigation, enableDataBoundaryNavigation = _r === void 0 ? false : _r;
+    var sheetId = _a.sheetId, activeCell = _a.activeCell, onChangeActiveCell = _a.onChangeActiveCell, selections = _a.selections, onChangeSelections = _a.onChangeSelections, _b = _a.columnCount, columnCount = _b === void 0 ? 0 : _b, _c = _a.rowCount, rowCount = _c === void 0 ? 0 : _c, _d = _a.selectionPolicy, selectionPolicy = _d === void 0 ? "multiple" : _d, _e = _a.newSelectionMode, newSelectionMode = _e === void 0 ? "clear" : _e, _f = _a.allowDeselectSelection, allowDeselectSelection = _f === void 0 ? true : _f, onFill = _a.onFill, onFillHandleRelease = _a.onFillHandleRelease, onFillShrink = _a.onFillShrink, _g = _a.isHiddenRow, isHiddenRow = _g === void 0 ? defaultIsHidden : _g, _h = _a.isHiddenColumn, isHiddenColumn = _h === void 0 ? defaultIsHidden : _h, _j = _a.alwaysScrollToActiveCell, alwaysScrollToActiveCell = _j === void 0 ? true : _j, _k = _a.selectionTopBound, selectionTopBound = _k === void 0 ? 0 : _k, _l = _a.selectionBottomBound, selectionBottomBound = _l === void 0 ? rowCount : _l, _m = _a.selectionLeftBound, selectionLeftBound = _m === void 0 ? 0 : _m, _o = _a.selectionRightBound, selectionRightBound = _o === void 0 ? columnCount : _o, mouseDownInterceptor = _a.mouseDownInterceptor, mouseMoveInterceptor = _a.mouseMoveInterceptor, _p = _a.mergedCells, mergedCells = _p === void 0 ? config_1.DEFAULT_ARRAY : _p, _q = _a.canSelectionSpanMergedCells, canSelectionSpanMergedCells = _q === void 0 ? defaultSelectionSpan : _q, getValue = _a.getValue, onMoveSelection = _a.onMoveSelection, getCellCoordsFromOffset = _a.getCellCoordsFromOffset, getCellBounds = _a.getCellBounds, getViewPort = _a.getViewPort, focus = _a.focus, scrollToCell = _a.scrollToCell, isMergedCell = _a.isMergedCell, enableSelectOnEnterKey = _a.enableSelectOnEnterKey, formulaMode = _a.formulaMode, isTouchDevice = _a.isTouchDevice, getDataRowCount = _a.getDataRowCount, isRowHeader = _a.isRowHeader, isColumnHeader = _a.isColumnHeader, _r = _a.enableDataBoundaryNavigation, enableDataBoundaryNavigation = _r === void 0 ? false : _r;
     var _s = tslib_1.__read((0, react_1.useState)(), 2), fillSelection = _s[0], setFillSelection = _s[1];
+    var _t = tslib_1.__read((0, react_1.useState)(), 2), fillShrink = _t[0], setFillShrink = _t[1];
+    var fillShrinkRef = (0, react_1.useRef)(undefined);
+    // Ctrl/Cmd state of the fill-handle drag, sampled on every mousemove (mouseup carries the
+    // modifier too, but a key released mid-drag should still count — Excel reads it at drop time,
+    // and the last move before the drop is the closest we get to that without a keyup listener).
+    var fillModifierRef = (0, react_1.useRef)(undefined);
     var selectionStart = (0, react_1.useRef)(null);
     var selectionEnd = (0, react_1.useRef)(null);
     var isSelecting = (0, react_1.useRef)(false);
     var isFilling = (0, react_1.useRef)(false);
+    /** Mouse button that grabbed the fill handle (a right-button drag opens the fill menu). */
+    var fillButtonRef = (0, react_1.useRef)("left");
+    /**
+     * One-shot, capture-phase `contextmenu` suppressor for a fill-handle
+     * gesture. Ctrl+click is the macOS context-menu gesture and a right-button
+     * release always fires `contextmenu`; neither may reach the grid's cell
+     * context menu while the user is dragging the fill handle.
+     */
+    var contextMenuSuppressorRef = (0, react_1.useRef)(null);
+    var releaseContextMenuSuppressor = (0, react_1.useCallback)(function () {
+        var handler = contextMenuSuppressorRef.current;
+        if (!handler)
+            return;
+        contextMenuSuppressorRef.current = null;
+        document.removeEventListener("contextmenu", handler, true);
+    }, []);
+    var suppressNextContextMenu = (0, react_1.useCallback)(function () {
+        if (contextMenuSuppressorRef.current)
+            return;
+        var handler = function (e) {
+            e.preventDefault();
+            e.stopPropagation();
+            releaseContextMenuSuppressor();
+        };
+        contextMenuSuppressorRef.current = handler;
+        document.addEventListener("contextmenu", handler, true);
+    }, [releaseContextMenuSuppressor]);
     var selectionsRef = (0, react_1.useRef)([]);
     var fillSelectionRef = (0, react_1.useRef)(undefined);
     var onChangeSelectionsRef = (0, use_callback_ref_1.useCallbackRef)(onChangeSelections);
     /* Drag drop selection */
     // eslint-disable-next-line @typescript-eslint/no-unused-vars
-    var _t = tslib_1.__read((0, react_1.useReducer)(function (s) { return s + 1; }, 0), 2), _ = _t[0], forceRender = _t[1];
+    var _u = tslib_1.__read((0, react_1.useReducer)(function (s) { return s + 1; }, 0), 2), _ = _u[0], forceRender = _u[1];
     var isDragging = (0, react_1.useRef)(false);
     var hasUserMovedSelection = (0, react_1.useRef)(false);
     var initialDraggedSelection = (0, react_1.useRef)(undefined);
@@ -86,6 +160,9 @@ var useSelection = function (_a) {
     (0, grid_3.useIsomorphicLayoutEffect)(function () {
         fillSelectionRef.current = fillSelection;
     }, [fillSelection]);
+    (0, grid_3.useIsomorphicLayoutEffect)(function () {
+        fillShrinkRef.current = fillShrink;
+    }, [fillShrink]);
     /* Check if cell is out of bounds */
     var isCellOutOfBounds = (0, react_1.useCallback)(function (cell) {
         return cell.rowIndex < 0 || cell.columnIndex < 0;
@@ -1060,6 +1137,7 @@ var useSelection = function (_a) {
         var coords = getCellCoordsFromOffset(e.clientX, e.clientY, false);
         if (!coords)
             return;
+        fillModifierRef.current = fillGestureOptions(e);
         var selections = selectionsRef.current;
         var range = selectionFromStartEnd(activeCellRef.current, coords);
         var hasSelections = selections.length > 0;
@@ -1068,6 +1146,22 @@ var useSelection = function (_a) {
             : getCellBounds(activeCellRef.current);
         if (!range)
             return;
+        /**
+         * Drag-back shrink (Excel): the handle sits at the selection's bottom-right corner; dragging
+         * it up or left while staying INSIDE a multi-cell selection excludes the dragged-over rows
+         * (or columns). Those cells are greyed now and cleared on release; the selection shrinks to
+         * the rest. Dragging PAST the first row/column is an ordinary fill in that direction.
+         */
+        var shrink = hasSelections
+            ? fillShrinkFor(activeCellBounds, coords)
+            : undefined;
+        if (shrink) {
+            setFillSelection(undefined);
+            setFillShrink(shrink);
+            scrollToCell(coords);
+            return;
+        }
+        setFillShrink(undefined);
         var direction = range.startRowIndex < activeCellBounds.startRowIndex
             ? grid_4.Direction.Up
             : range.endRowIndex > activeCellBounds.endRowIndex
@@ -1109,24 +1203,59 @@ var useSelection = function (_a) {
         selectionTopBound,
     ]);
     /**
-     * When user releases mouse on the fill handle
+     * When user releases mouse on the fill handle. Excel reads the Ctrl toggle
+     * at RELEASE (the user can press/let go of Ctrl mid-drag), so the modifier
+     * comes from the mouseup event, not the mousedown.
      */
-    var handleFillMouseUp = (0, react_1.useCallback)(function () {
+    var handleFillMouseUp = (0, react_1.useCallback)(function (e) {
+        var _a;
         isFilling.current = false;
+        var toggle = isFillToggleModifier(e);
+        var button = fillButtonRef.current;
         /* Remove listener */
         document.removeEventListener("mousemove", handleFillMouseMove);
         document.removeEventListener("mouseup", handleFillMouseUp);
+        // The right-button (or macOS Ctrl+click) `contextmenu` event follows this
+        // mouseup; keep swallowing it for one tick, then drop the suppressor so a
+        // later, unrelated right-click still opens the cell context menu.
+        setTimeout(releaseContextMenuSuppressor, 0);
         /* Exit early */
         if (!activeCellRef.current) {
             return;
         }
         // Active fill selection
         var fillSelection = fillSelectionRef.current;
+        var shrink = fillShrinkRef.current;
+        // Modifier for a drag-back shrink: the last move's state, else the release's.
+        var gestureOptions = (_a = fillModifierRef.current) !== null && _a !== void 0 ? _a : (toggle ? { modifier: "toggle" } : undefined);
+        fillModifierRef.current = undefined;
         /* Update last selection */
         setFillSelection(undefined);
+        setFillShrink(undefined);
         /* Use ref, as we are binding to document */
         var selections = selectionsRef.current;
         var activeCell = activeCellRef.current;
+        /* Drag-back inside the selection: clear the excluded cells, keep the rest selected */
+        if (activeCell && shrink) {
+            focus();
+            onFillShrink === null || onFillShrink === void 0 ? void 0 : onFillShrink(sheetId, activeCell, shrink.clearRange, gestureOptions);
+            var len_1 = selections.length;
+            var shrunkSelections = len_1
+                ? selections.map(function (sel, i) {
+                    return len_1 - 1 === i ? tslib_1.__assign(tslib_1.__assign({}, sel), { range: shrink.remaining }) : sel;
+                })
+                : [{ range: shrink.remaining }];
+            onChangeSelections === null || onChangeSelections === void 0 ? void 0 : onChangeSelections(shrunkSelections);
+            // The active cell normally anchors the surviving corner; if it fell in the cleared band,
+            // move it to the remaining range's top-left so it never points at a deselected cell.
+            if (!cellInRange(activeCell, shrink.remaining)) {
+                onChangeActiveCell === null || onChangeActiveCell === void 0 ? void 0 : onChangeActiveCell(sheetId, {
+                    rowIndex: shrink.remaining.startRowIndex,
+                    columnIndex: shrink.remaining.startColumnIndex,
+                });
+            }
+            return;
+        }
         if (!activeCell || !fillSelection) {
             return;
         }
@@ -1139,8 +1268,11 @@ var useSelection = function (_a) {
         }
         /* Focus on the grid */
         focus();
-        /* Callback */
-        onFill === null || onFill === void 0 ? void 0 : onFill(sheetId, activeCell, fillSelection, selections);
+        /* Callback — a right-button drag fills nothing yet: the grid opens the
+         * fill menu and issues `onFill` with the entry the user picks. */
+        if (button === "left") {
+            onFill === null || onFill === void 0 ? void 0 : onFill(sheetId, activeCell, fillSelection, selections, undefined, undefined, toggle ? { modifier: "toggle" } : undefined);
+        }
         /* Modify last selection */
         var curSelections = selectionsRef.current;
         var len = curSelections.length;
@@ -1153,14 +1285,40 @@ var useSelection = function (_a) {
             })
             : [{ range: newBounds }];
         onChangeSelections === null || onChangeSelections === void 0 ? void 0 : onChangeSelections(newSelections);
-    }, [focus, handleFillMouseMove, onChangeSelections, onFill, sheetId]);
+        onFillHandleRelease === null || onFillHandleRelease === void 0 ? void 0 : onFillHandleRelease({
+            sheetId: sheetId,
+            activeCell: activeCell,
+            fillSelection: fillSelection,
+            selections: selections,
+            toggle: toggle,
+            button: button,
+        });
+    }, [
+        focus,
+        handleFillMouseMove,
+        onChangeSelections,
+        onChangeActiveCell,
+        onFill,
+        onFillHandleRelease,
+        onFillShrink,
+        releaseContextMenuSuppressor,
+        sheetId,
+    ]);
     var handleFillMouseDown = (0, react_1.useCallback)(function (e) {
         e.stopPropagation();
         e.preventDefault();
+        var isRightButton = e.button === grid_4.MouseButtonCodes.right;
+        fillButtonRef.current = isRightButton ? "right" : "left";
+        // Ctrl+drag on the handle must never become the macOS Ctrl+click
+        // context-menu gesture, and a right-button drag must not open the cell
+        // context menu on release — swallow that gesture's `contextmenu`.
+        if (isRightButton || isFillToggleModifier(e)) {
+            suppressNextContextMenu();
+        }
         isFilling.current = true;
         document.addEventListener("mousemove", handleFillMouseMove);
         document.addEventListener("mouseup", handleFillMouseUp);
-    }, [handleFillMouseMove, handleFillMouseUp]);
+    }, [handleFillMouseMove, handleFillMouseUp, suppressNextContextMenu]);
     /**
      * Remove the last selection from state
      */
@@ -1402,10 +1560,17 @@ var useSelection = function (_a) {
     // Add a ref. makeEditable renders way too often
     var handleKeyDownRef = (0, use_callback_ref_1.useCallbackRef)(handleKeyDown);
     /**
-     * Double-click fill handle - Excel standard behavior:
-     * 1. Look at adjacent column (left first, then right if empty)
-     * 2. Find last row with contiguous data in that column
-     * 3. Fill down to match that extent
+     * Double-click fill handle — Excel's AutoFill rules:
+     * 1. Pick the adjacent column: the one LEFT of the selection when its cell on the selection's top
+     *    row is non-blank, else the one on the RIGHT; neither → nothing happens.
+     * 2. Extent = that column's contiguous data block below the selection (End+Down semantics: a
+     *    blank ends the block; only a blank in the very first row below the selection is skipped,
+     *    and only when the row after it is non-blank).
+     * 3. Never overwrite: the fill halts before the first pre-existing non-blank cell in the fill
+     *    column(s) themselves.
+     * 4. Ctrl (Cmd on Mac) held → the same copy↔series inversion as a Ctrl+drag (`options.modifier`).
+     * Scans are row-by-row through `getValue` and bounded by the sheet's data extent, so the cost is
+     * O(rows of the adjacent block), never O(sheet).
      */
     var handleFillDoubleClick = (0, react_1.useCallback)(function (e) {
         e.stopPropagation();
@@ -1423,33 +1588,60 @@ var useSelection = function (_a) {
         var endRow = currentBounds.endRowIndex;
         var leftCol = currentBounds.startColumnIndex;
         var rightCol = currentBounds.endColumnIndex;
-        // Excel behavior:
-        // 1. Check if there's any data in adjacent columns (left or right)
-        // 2. If yes, fill down to the sheet's overall data extent (last row with any data)
-        var hasAdjacentData = false;
-        // Check for data in left adjacent column
-        if (leftCol > selectionLeftBound) {
-            var leftValue = getValue(sheetId, startRow, leftCol - 1);
-            if (!(0, grid_1.isNull)(leftValue)) {
-                hasAdjacentData = true;
-            }
+        var hasValue = function (rowIndex, columnIndex) {
+            return !(0, grid_1.isNull)(getValue(sheetId, rowIndex, columnIndex));
+        };
+        // 1. Adjacent column: left first, then right — judged on the selection's top row.
+        var adjacentColumn;
+        if (leftCol > selectionLeftBound && hasValue(startRow, leftCol - 1)) {
+            adjacentColumn = leftCol - 1;
         }
-        // Check for data in right adjacent column
-        if (!hasAdjacentData && rightCol < selectionRightBound) {
-            var rightValue = getValue(sheetId, startRow, rightCol + 1);
-            if (!(0, grid_1.isNull)(rightValue)) {
-                hasAdjacentData = true;
-            }
+        else if (rightCol < selectionRightBound &&
+            hasValue(startRow, rightCol + 1)) {
+            adjacentColumn = rightCol + 1;
         }
-        // No adjacent data to reference
-        if (!hasAdjacentData)
+        if (adjacentColumn === undefined)
             return;
-        // Use the sheet's data extent as the target row
-        // This matches Excel behavior where it fills to the last row with any data
+        // The last row that can hold data — bounds every scan below. `getDataRowCount` is the legacy
+        // `sheetData.length` contract (rows are 1-based, so the count is lastDataRow + 1); the rnc
+        // engine's windowed path answers with the same shape (its 1-based `sheet_extents` max_row + 1).
         var dataRowCount = getDataRowCount === null || getDataRowCount === void 0 ? void 0 : getDataRowCount(sheetId);
-        var targetRow = dataRowCount !== undefined
-            ? Math.min(dataRowCount - 1, selectionBottomBound)
-            : endRow;
+        var lastDataRow = Math.min(selectionBottomBound, dataRowCount !== undefined ? dataRowCount - 1 : selectionBottomBound);
+        if (lastDataRow <= endRow)
+            return;
+        // 2. Walk the adjacent column's contiguous block below the selection.
+        var adjacentEnd = endRow;
+        var row = endRow + 1;
+        if (!hasValue(row, adjacentColumn)) {
+            // End+Down: skip exactly one blank directly below the selection when data resumes after it.
+            if (row + 1 <= lastDataRow && hasValue(row + 1, adjacentColumn)) {
+                row += 1;
+            }
+            else {
+                return;
+            }
+        }
+        while (row <= lastDataRow && hasValue(row, adjacentColumn)) {
+            adjacentEnd = row;
+            row += 1;
+        }
+        if (adjacentEnd <= endRow)
+            return;
+        // 3. Stop before the first pre-existing value in the fill column(s) — existing data is kept.
+        var targetRow = adjacentEnd;
+        for (var r = endRow + 1; r <= adjacentEnd; r++) {
+            var occupied = false;
+            for (var c = leftCol; c <= rightCol; c++) {
+                if (hasValue(r, c)) {
+                    occupied = true;
+                    break;
+                }
+            }
+            if (occupied) {
+                targetRow = r - 1;
+                break;
+            }
+        }
         // No additional rows to fill
         if (targetRow <= endRow)
             return;
@@ -1463,8 +1655,10 @@ var useSelection = function (_a) {
         var newFillSelection = { range: fillRange };
         // Focus on the grid
         focus();
-        // Callback to perform the fill
-        onFill === null || onFill === void 0 ? void 0 : onFill(sheetId, activeCell, newFillSelection, selections);
+        // 4. Callback to perform the fill (Ctrl/Cmd on the double-click toggles
+        //    copy↔series exactly like a Ctrl+drag)
+        var toggle = isFillToggleModifier(e);
+        onFill === null || onFill === void 0 ? void 0 : onFill(sheetId, activeCell, newFillSelection, selections, undefined, undefined, toggle ? { modifier: "toggle" } : undefined);
         // Update selection to the new range
         var curSelections = selectionsRef.current;
         var len = curSelections.length;
@@ -1503,6 +1697,7 @@ var useSelection = function (_a) {
         onFillHandleMouseDown: handleFillMouseDown,
         onFillHandleDoubleClick: handleFillDoubleClick,
         fillSelection: fillSelection,
+        fillShrink: fillShrink,
         clearLastSelection: handleClearLastSelection,
         modifySelection: modifySelection,
         selectAll: selectAll,

package/dist/cjs/index.d.ts

@@ -8,6 +8,10 @@ export * from "./components/sheet-status";
 export * from "./components/cell-tooltip";
 export * from "./components/insert-function-dialog";
 export * from "./components/sort-range-dialog";
+export * from "./components/fill-series-dialog";
+export * from "./components/selection/fill-options-menu";
+export * from "./api/fill-series";
+export { type FillHandleRelease } from "./hooks/use-selection";
 export * from "./components/paste-special-dialog";
 export * from "./components/go-to-dialog";
 export * from "./components/evaluate-formula-dialog";

package/dist/cjs/index.d.ts.map

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

package/dist/cjs/index.js

@@ -12,6 +12,9 @@ tslib_1.__exportStar(require("./components/sheet-status"), exports);
 tslib_1.__exportStar(require("./components/cell-tooltip"), exports);
 tslib_1.__exportStar(require("./components/insert-function-dialog"), exports);
 tslib_1.__exportStar(require("./components/sort-range-dialog"), exports);
+tslib_1.__exportStar(require("./components/fill-series-dialog"), exports);
+tslib_1.__exportStar(require("./components/selection/fill-options-menu"), exports);
+tslib_1.__exportStar(require("./api/fill-series"), exports);
 tslib_1.__exportStar(require("./components/paste-special-dialog"), exports);
 tslib_1.__exportStar(require("./components/go-to-dialog"), exports);
 tslib_1.__exportStar(require("./components/evaluate-formula-dialog"), exports);

package/dist/cjs/release-date.js

@@ -4,4 +4,4 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.releaseDate = void 0;
 exports.releaseDate = 
 // @ts-ignore
-(_a = new Date("2026-09-16")) !== null && _a !== void 0 ? _a : new Date("2025-06-18");
+(_a = new Date("2026-09-17")) !== null && _a !== void 0 ? _a : new Date("2025-06-18");