@rowsncolumns/spreadsheet 10.6.4 → 10.7.0

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

@@ -2,16 +2,25 @@ import { findLastContentfulCell, isCellWithinBounds, isNull, } from "@rowsncolum
 import { cellToArea } from "@rowsncolumns/grid";
 import { getOwnerDocument, useIsomorphicLayoutEffect } from "@rowsncolumns/grid";
 import { Align, cellIdentifier, cellRangeToBounds, clampCellCoords, clampIndex, Direction, findNextCellInDataRegion, findNextCellWithinBounds, getBoundedCells, isAreasEqual, isEqualCells, MouseButtonCodes, newSelectionFromDrag, selectionSpansCells, } from "@rowsncolumns/grid";
-import { useCallback, useReducer, useRef, useState } from "react";
+import { useCallback, useMemo, useReducer, useRef, useState } from "react";
 import { scheduleImmediatePriorityCallback, scheduleNormalPriorityCallback, } from "../api/scheduler";
-import { MOVE_OVERWRITE_PROMPT, needsOverwritePrompt } from "../api/move-overwrite";
+import { MOVE_OVERWRITE_PROMPT, needsCopyOverwritePrompt, needsOverwritePrompt, } from "../api/move-overwrite";
 import { findActiveTableWithinCell, getNextCellInTable, getTableColumnSelectRange, getTableRowSelectRange, getTableSelectAllRange, } from "../api/table";
+import { getEnterKeyDirection, } from "../components/cell-editor/helpers";
 import { DEFAULT_ARRAY } from "../config";
 import { isMac } from "../helpers";
+import { isMacPlatform } from "../platform";
 import { useCallbackRef } from "./use-callback-ref";
+/**
+ * The copy modifier of a selection-border drag, read at release like Excel: Ctrl on
+ * Windows / Linux, Option (⌥) on macOS (Excel for Mac; ⌃-click is the Mac context menu).
+ */
+export const isSelectionCopyModifier = (e) => (isMacPlatform() ? e.altKey : e.ctrlKey);
 /** Ctrl on every platform; Cmd is accepted as an alias on macOS (Excel for Mac uses Ctrl). */
 const isFillToggleModifier = (e) => e.ctrlKey || e.metaKey;
 const fillGestureOptions = (e) => e.ctrlKey || e.metaKey ? { modifier: "toggle" } : undefined;
+/** How far an arrow key looks past unselectable cells for the next selectable one. */
+const SELECTABLE_SEARCH_LIMIT = 10_000;
 const defaultIsHidden = () => false;
 const defaultSelectionSpan = () => true;
 const getPossibleActiveCellFromSelections = (selections) => {
@@ -86,7 +95,41 @@ const fillShrinkFor = (selection, coords) => {
 const defaultConfirmMoveOverwrite = (message) => typeof window === "undefined" || typeof window.confirm !== "function"
     ? true
     : window.confirm(message);
-export const useSelection = ({ sheetId, activeCell, onChangeActiveCell, selections, onChangeSelections, columnCount = 0, rowCount = 0, selectionPolicy = "multiple", newSelectionMode = "clear", allowDeselectSelection = true, onFill, onFillHandleRelease, onFillShrink, onInsertCutCells, confirmMoveOverwrite = defaultConfirmMoveOverwrite, isHiddenRow = defaultIsHidden, isHiddenColumn = defaultIsHidden, alwaysScrollToActiveCell = true, selectionTopBound = 0, selectionBottomBound = rowCount, selectionLeftBound = 0, selectionRightBound = columnCount, mouseDownInterceptor, mouseMoveInterceptor, mergedCells = DEFAULT_ARRAY, canSelectionSpanMergedCells = defaultSelectionSpan, getValue, onMoveSelection, getCellCoordsFromOffset, getCellBounds, getViewPort, focus, scrollToCell, isMergedCell, enableSelectOnEnterKey, formulaMode, isTouchDevice, getDataRowCount, getDataRegion, isRowHeader, isColumnHeader, enableDataBoundaryNavigation = false, tables, onInsertTableRow, }) => {
+export const useSelection = ({ sheetId, activeCell, onChangeActiveCell: onChangeActiveCellProp, selections, onChangeSelections: onChangeSelectionsProp, columnCount = 0, rowCount = 0, selectionPolicy = "multiple", newSelectionMode = "clear", allowDeselectSelection = true, onFill, onFillHandleRelease, onFillShrink, onInsertCutCells, onCopySelection, onInsertCopiedCells, onSelectionDragMenu, confirmMoveOverwrite = defaultConfirmMoveOverwrite, isHiddenRow = defaultIsHidden, isHiddenColumn = defaultIsHidden, alwaysScrollToActiveCell = true, selectionTopBound = 0, selectionBottomBound = rowCount, selectionLeftBound = 0, selectionRightBound = columnCount, mouseDownInterceptor, mouseMoveInterceptor, mergedCells = DEFAULT_ARRAY, canSelectionSpanMergedCells = defaultSelectionSpan, getValue, onMoveSelection, getCellCoordsFromOffset, getCellBounds, getViewPort, focus, scrollToCell, isMergedCell, enableSelectOnEnterKey, enterKeyDirection = "down", formulaMode, isTouchDevice, getDataRowCount, getDataRegion, isRowHeader, isColumnHeader, enableDataBoundaryNavigation = false, tables, onInsertTableRow, isRangeSelectable: isRangeSelectableProp, }) => {
+    /**
+     * Selectability gate (Excel's Select locked / unlocked cells). Every
+     * gesture checks it before it moves anything, and the two emitters below
+     * refuse an active cell or a selection that covers an unselectable range —
+     * the backstop for row / column / select-all paths that emit directly.
+     */
+    const isRangeSelectableRef = useRef(isRangeSelectableProp);
+    isRangeSelectableRef.current = isRangeSelectableProp;
+    const isSelectable = useCallback((range) => {
+        const predicate = isRangeSelectableRef.current;
+        return !predicate || !range || predicate(range);
+    }, []);
+    const isCellSelectable = useCallback((cell) => !cell ||
+        isSelectable({
+            startRowIndex: cell.rowIndex,
+            endRowIndex: cell.rowIndex,
+            startColumnIndex: cell.columnIndex,
+            endColumnIndex: cell.columnIndex,
+        }), [isSelectable]);
+    const onChangeActiveCell = useMemo(() => onChangeActiveCellProp
+        ? (...args) => {
+            if (!isCellSelectable(args[1]))
+                return;
+            onChangeActiveCellProp(...args);
+        }
+        : undefined, [onChangeActiveCellProp, isCellSelectable]);
+    const onChangeSelections = useMemo(() => onChangeSelectionsProp
+        ? (...args) => {
+            if (args[0]?.some((selection) => !isSelectable(selection.range))) {
+                return;
+            }
+            onChangeSelectionsProp(...args);
+        }
+        : undefined, [onChangeSelectionsProp, isSelectable]);
     const [fillSelection, setFillSelection] = useState();
     const [fillShrink, setFillShrink] = useState();
     const fillShrinkRef = useRef(undefined);
@@ -124,10 +167,10 @@ export const useSelection = ({ sheetId, activeCell, onChangeActiveCell, selectio
         contextMenuSuppressorRef.current = null;
         suppressor.ownerDocument.removeEventListener("contextmenu", suppressor.handler, true);
     }, []);
-    const suppressNextContextMenu = useCallback(() => {
+    const suppressNextContextMenu = useCallback((target) => {
         if (contextMenuSuppressorRef.current)
             return;
-        const ownerDocument = fillDocumentRef.current ?? document;
+        const ownerDocument = target ?? fillDocumentRef.current ?? document;
         const handler = (e) => {
             e.preventDefault();
             e.stopPropagation();
@@ -148,6 +191,12 @@ export const useSelection = ({ sheetId, activeCell, onChangeActiveCell, selectio
     const initialDraggedCell = useRef(undefined);
     const draggedSelection = useRef(undefined);
     const draggedSelectionIndex = useRef(undefined);
+    /** Mouse button that grabbed the selection border (right = Excel's drop menu on release). */
+    const dragButtonRef = useRef("left");
+    /** Border element the gesture started on: a right-click that never moved re-opens the context menu there. */
+    const dragTargetRef = useRef(null);
+    /** Copy modifier held during the drag (Ctrl / ⌥) — drives the copy cursor; the drop re-reads it. */
+    const [isDragCopy, setIsDragCopy] = useState(false);
     /**
      * Need to store in ref because on mousemove and mouseup event that are
      * registered in document
@@ -257,6 +306,9 @@ export const useSelection = ({ sheetId, activeCell, onChangeActiveCell, selectio
         ) {
             return;
         }
+        if (!isSelectable(selectionFromStartEnd(selectionStart.current, coords))) {
+            return;
+        }
         selectionEnd.current = coords;
         // If user is navigation to the same cell
         // lets clear all selections
@@ -300,6 +352,7 @@ export const useSelection = ({ sheetId, activeCell, onChangeActiveCell, selectio
         selectionPolicy,
         formulaMode,
         clearSelections,
+        isSelectable,
     ]);
     /* Adds a new selection, CMD key */
     const appendSelection = useCallback((start, end = start) => {
@@ -308,12 +361,12 @@ export const useSelection = ({ sheetId, activeCell, onChangeActiveCell, selectio
             isCellOutOfBounds(start)) {
             return;
         }
-        selectionStart.current = start;
-        selectionEnd.current = end;
         const range = selectionFromStartEnd(start, end);
-        if (!range) {
+        if (!range || !isSelectable(range)) {
             return;
         }
+        selectionStart.current = start;
+        selectionEnd.current = end;
         emitActiveCell(sheetId, {
             rowIndex: range.startRowIndex,
             columnIndex: range.startColumnIndex,
@@ -328,6 +381,7 @@ export const useSelection = ({ sheetId, activeCell, onChangeActiveCell, selectio
         selectionFromStartEnd,
         isCellOutOfBounds,
         selectionPolicy,
+        isSelectable,
     ]);
     const removeSelectionByIndex = useCallback((index) => {
         const newSelection = selections.filter((_, idx) => idx !== index);
@@ -340,11 +394,11 @@ export const useSelection = ({ sheetId, activeCell, onChangeActiveCell, selectio
         if (isCellOutOfBounds(start)) {
             return;
         }
-        selectionStart.current = start;
-        selectionEnd.current = end;
         const bounds = selectionFromStartEnd(start, end);
-        if (!bounds)
+        if (!bounds || !isSelectable(bounds))
             return;
+        selectionStart.current = start;
+        selectionEnd.current = end;
         const coords = {
             rowIndex: bounds.startRowIndex,
             columnIndex: bounds.startColumnIndex,
@@ -369,6 +423,7 @@ export const useSelection = ({ sheetId, activeCell, onChangeActiveCell, selectio
         emitActiveCell,
         selectionFromStartEnd,
         isCellOutOfBounds,
+        isSelectable,
     ]);
     /**
      * Mousemove handler
@@ -552,10 +607,48 @@ export const useSelection = ({ sheetId, activeCell, onChangeActiveCell, selectio
                 }
                 break;
         }
-        const newBounds = getCellBounds({
+        let newBounds = getCellBounds({
             rowIndex,
             columnIndex,
         });
+        // Protection makes the target unselectable: Shift+Arrow does not extend
+        // onto it, and a plain move keeps going the same way until it reaches a
+        // selectable cell — or stays put when there is none (Excel).
+        if (!isCellSelectable({ rowIndex, columnIndex })) {
+            if (modify)
+                return;
+            const vertical = direction === Direction.Up || direction === Direction.Down;
+            const step = direction === Direction.Up || direction === Direction.Left ? -1 : 1;
+            const lower = vertical ? selectionTopBound : selectionLeftBound;
+            const upper = vertical ? selectionBottomBound : selectionRightBound;
+            const isHidden = vertical ? isHiddenRow : isHiddenColumn;
+            let index = vertical ? rowIndex : columnIndex;
+            let found = false;
+            for (let tries = 0; tries < SELECTABLE_SEARCH_LIMIT; tries++) {
+                const edge = step > 0 ? newBounds.endRowIndex : newBounds.startRowIndex;
+                const edgeColumn = step > 0 ? newBounds.endColumnIndex : newBounds.startColumnIndex;
+                index = (vertical ? edge : edgeColumn) + step;
+                while (index >= lower && index <= upper && isHidden(index)) {
+                    index += step;
+                }
+                if (index < lower || index > upper)
+                    break;
+                if (vertical)
+                    rowIndex = index;
+                else
+                    columnIndex = index;
+                newBounds = getCellBounds({ rowIndex, columnIndex });
+                if (isCellSelectable({
+                    rowIndex: newBounds.startRowIndex,
+                    columnIndex: newBounds.startColumnIndex,
+                })) {
+                    found = true;
+                    break;
+                }
+            }
+            if (!found)
+                return;
+        }
         const coords = {
             rowIndex: newBounds.startRowIndex,
             columnIndex: newBounds.startColumnIndex,
@@ -590,6 +683,7 @@ export const useSelection = ({ sheetId, activeCell, onChangeActiveCell, selectio
         modifySelection,
         newSelection,
         selectionBottomBound,
+        isCellSelectable,
         selectionRightBound,
         isMergedCell,
         getDataRowCount,
@@ -1026,6 +1120,13 @@ export const useSelection = ({ sheetId, activeCell, onChangeActiveCell, selectio
         const coords = getCellCoordsFromOffset(e.clientX, e.clientY, true);
         if (!coords)
             return;
+        // A press on a cell the protection makes unselectable does nothing, and
+        // starts no drag that could extend the old selection onto it.
+        if (!isCellSelectable(coords) &&
+            !isRowHeader(coords.columnIndex) &&
+            !isColumnHeader(coords.rowIndex)) {
+            return;
+        }
         /* Check if its context menu click */
         const isContextMenuClick = e.button === MouseButtonCodes.right ||
             (e.button == MouseButtonCodes.left && e.ctrlKey && isMac);
@@ -1160,6 +1261,7 @@ export const useSelection = ({ sheetId, activeCell, onChangeActiveCell, selectio
         scrollToCell,
         selectAll,
         formulaMode,
+        isCellSelectable,
     ]);
     // Keydown handler
     const handleKeyDown = useCallback((e) => {
@@ -1230,11 +1332,14 @@ export const useSelection = ({ sheetId, activeCell, onChangeActiveCell, selectio
                 }
                 break;
             // Add support for cycling multiple selections
-            case "Enter":
+            case "Enter": {
+                const direction = getEnterKeyDirection(isShiftKey, enterKeyDirection);
+                if (!direction) {
+                    break;
+                }
                 if (selections.length && activeCell) {
                     const { range } = selections[selections.length - 1];
                     const activeCellBounds = getCellBounds(activeCell);
-                    const direction = isShiftKey ? Direction.Up : Direction.Down;
                     const nextCell = findNextCellWithinBounds(activeCellBounds, range, direction);
                     if (nextCell) {
                         emitActiveCell(sheetId, nextCell);
@@ -1242,14 +1347,10 @@ export const useSelection = ({ sheetId, activeCell, onChangeActiveCell, selectio
                     }
                 }
                 else if (enableSelectOnEnterKey) {
-                    if (isShiftKey) {
-                        keyNavigate(Direction.Up);
-                    }
-                    else {
-                        keyNavigate(Direction.Down);
-                    }
+                    keyNavigate(direction);
                 }
                 break;
+            }
             case "Tab":
                 /* Cycle through the selections if selections.length > 0 */
                 if (selections.length && activeCell) {
@@ -1325,6 +1426,7 @@ export const useSelection = ({ sheetId, activeCell, onChangeActiveCell, selectio
         selectFirstCellInSheet,
         selectLastCellInSheet,
         enableSelectOnEnterKey,
+        enterKeyDirection,
         newSelection,
         isHiddenRow,
         isHiddenColumn,
@@ -1558,6 +1660,7 @@ export const useSelection = ({ sheetId, activeCell, onChangeActiveCell, selectio
      * Ond drag move
      */
     const handleSelectionMouseMove = useCallback((e) => {
+        setIsDragCopy(dragButtonRef.current === "left" && isSelectionCopyModifier(e));
         const coords = getCellCoordsFromOffset(e.clientX, e.clientY, false);
         if (!coords) {
             return;
@@ -1600,15 +1703,70 @@ export const useSelection = ({ sheetId, activeCell, onChangeActiveCell, selectio
     const handleSelectionMouseUp = useCallback((e) => {
         const fromSelection = initialDraggedSelection.current;
         const toSelection = draggedSelection.current;
-        // Excel reads the modifier at RELEASE: Shift → insert between existing cells (I-beam),
-        // no modifier → overwrite (after the data prompt).
+        const button = dragButtonRef.current;
+        const borderTarget = dragTargetRef.current;
+        const moved = !!fromSelection &&
+            !!toSelection &&
+            !isAreasEqual(toSelection.range, fromSelection.range);
+        /* Remove event handlers from the document the gesture started on */
+        const ownerDocument = dragSelectionDocumentRef.current ?? document;
+        const resetGesture = () => {
+            isDragging.current = false;
+            draggedSelection.current = void 0;
+            draggedSelectionIndex.current = void 0;
+            hasUserMovedSelection.current = false;
+            dragButtonRef.current = "left";
+            dragTargetRef.current = null;
+            setIsDragCopy(false);
+            dragSelectionDocumentRef.current = null;
+            ownerDocument.removeEventListener("mouseup", handleSelectionMouseUp);
+            ownerDocument.removeEventListener("pointerup", handleSelectionMouseUp);
+            ownerDocument.removeEventListener("mousemove", handleSelectionMouseMove);
+            ownerDocument.removeEventListener("pointermove", handleSelectionMouseMove);
+        };
+        if (button === "right") {
+            // Right-button drag (Excel): nothing changes on release — the grid opens the drop
+            // menu and runs the entry the user picks. The right-button `contextmenu` follows this
+            // release on Windows (on macOS it fired at press); keep swallowing it for one tick.
+            // A right-click that never left the source is an ordinary right-click: the context
+            // menu the press swallowed opens at the release point instead.
+            const { clientX, clientY } = e;
+            setTimeout(() => {
+                releaseContextMenuSuppressor();
+                if (!moved && borderTarget && "dispatchEvent" in borderTarget) {
+                    borderTarget.dispatchEvent(new MouseEvent("contextmenu", {
+                        bubbles: true,
+                        cancelable: true,
+                        clientX,
+                        clientY,
+                        button: MouseButtonCodes.right,
+                    }));
+                }
+            }, 0);
+            if (moved && fromSelection && toSelection) {
+                onSelectionDragMenu?.({
+                    sheetId,
+                    from: fromSelection,
+                    to: toSelection,
+                    clientX,
+                    clientY,
+                });
+            }
+            resetGesture();
+            forceRender();
+            return;
+        }
+        // Excel reads the modifiers at RELEASE: Shift → insert between existing cells (I-beam),
+        // Ctrl (⌥ on macOS) → copy instead of move, both → insert a copy; none → move
+        // (overwriting after the data prompt).
         const insertMode = e.shiftKey;
+        const copyMode = isSelectionCopyModifier(e);
+        // Snapshot before the selection follows the drop, so a refusal / Cancel can restore it.
+        const previousSelections = selectionsRef.current;
         /**
          * If the from and to selection area
          */
-        if (toSelection &&
-            fromSelection &&
-            !isAreasEqual(toSelection.range, fromSelection.range)) {
+        if (moved && toSelection) {
             /* Select the first cell in the selection area */
             const coords = {
                 rowIndex: toSelection.range.startRowIndex,
@@ -1634,31 +1792,58 @@ export const useSelection = ({ sheetId, activeCell, onChangeActiveCell, selectio
                 };
             }
         }
+        // Put the selection back on the source (Cancel, or a gesture the host can't run).
+        const restoreSource = (source, dropped) => {
+            emitActiveCell(sheetId, {
+                rowIndex: source.range.startRowIndex,
+                columnIndex: source.range.startColumnIndex,
+            });
+            onChangeSelections?.(selectionSpansCells(source.range)
+                ? previousSelections.map((cur) => isAreasEqual(cur.range, dropped.range) ? source : cur)
+                : previousSelections.filter((cur) => !isAreasEqual(cur.range, dropped.range)));
+            focus();
+        };
+        const hasValue = (rowIndex, columnIndex) => !isNull(getValue(sheetId, rowIndex, columnIndex));
         // Callback
-        if (fromSelection &&
-            toSelection &&
-            !isAreasEqual(fromSelection.range, toSelection.range)) {
-            if (insertMode && onInsertCutCells) {
+        if (moved && fromSelection && toSelection) {
+            if (copyMode && insertMode) {
+                // Ctrl+Shift+drag inserts a copy (destination band shifts) — Excel shows no prompt.
+                if (!onInsertCopiedCells ||
+                    onInsertCopiedCells(sheetId, fromSelection, toSelection) === false) {
+                    restoreSource(fromSelection, toSelection);
+                }
+            }
+            else if (copyMode) {
+                if (!onCopySelection) {
+                    restoreSource(fromSelection, toSelection);
+                }
+                else if (needsCopyOverwritePrompt(toSelection.range, hasValue)) {
+                    // The copy would replace data: Excel asks first, Cancel puts the selection back.
+                    Promise.resolve(confirmMoveOverwrite(MOVE_OVERWRITE_PROMPT)).then((replace) => {
+                        if (replace &&
+                            onCopySelection(sheetId, fromSelection, toSelection) !== false) {
+                            return;
+                        }
+                        restoreSource(fromSelection, toSelection);
+                    });
+                }
+                else if (onCopySelection(sheetId, fromSelection, toSelection) === false) {
+                    restoreSource(fromSelection, toSelection);
+                }
+            }
+            else if (insertMode && onInsertCutCells) {
                 // Shift+drag inserts (displaces the destination band) — Excel shows no prompt.
                 onInsertCutCells(sheetId, fromSelection, toSelection);
             }
-            else if (needsOverwritePrompt(fromSelection.range, toSelection.range, (rowIndex, columnIndex) => !isNull(getValue(sheetId, rowIndex, columnIndex)))) {
+            else if (needsOverwritePrompt(fromSelection.range, toSelection.range, hasValue)) {
                 // The destination holds data the block would overwrite: Excel asks first. The
                 // selection has already followed the drop; Cancel puts it back on the source.
-                const previousSelections = selectionsRef.current;
                 Promise.resolve(confirmMoveOverwrite(MOVE_OVERWRITE_PROMPT)).then((replace) => {
                     if (replace) {
                         onMoveSelection?.(sheetId, fromSelection, toSelection);
                         return;
                     }
-                    emitActiveCell(sheetId, {
-                        rowIndex: fromSelection.range.startRowIndex,
-                        columnIndex: fromSelection.range.startColumnIndex,
-                    });
-                    onChangeSelections?.(selectionSpansCells(fromSelection.range)
-                        ? previousSelections.map((cur) => isAreasEqual(cur.range, toSelection.range) ? fromSelection : cur)
-                        : previousSelections.filter((cur) => !isAreasEqual(cur.range, toSelection.range)));
-                    focus();
+                    restoreSource(fromSelection, toSelection);
                 });
             }
             else {
@@ -1668,29 +1853,23 @@ export const useSelection = ({ sheetId, activeCell, onChangeActiveCell, selectio
         /* Focus on the grid */
         focus();
         /* Reset all references */
-        isDragging.current = false;
-        draggedSelection.current = void 0;
-        draggedSelectionIndex.current = void 0;
-        hasUserMovedSelection.current = false;
-        /* Remove event handlers from the document the gesture started on */
-        const ownerDocument = dragSelectionDocumentRef.current ?? document;
-        dragSelectionDocumentRef.current = null;
-        ownerDocument.removeEventListener("mouseup", handleSelectionMouseUp);
-        ownerDocument.removeEventListener("pointerup", handleSelectionMouseUp);
-        ownerDocument.removeEventListener("mousemove", handleSelectionMouseMove);
-        ownerDocument.removeEventListener("pointermove", handleSelectionMouseMove);
+        resetGesture();
         /* Force render */
         forceRender();
     }, [
         sheetId,
         onMoveSelection,
         onInsertCutCells,
+        onCopySelection,
+        onInsertCopiedCells,
+        onSelectionDragMenu,
         confirmMoveOverwrite,
         getValue,
         handleSelectionMouseMove,
         focus,
         emitActiveCell,
         onChangeSelections,
+        releaseContextMenuSuppressor,
     ]);
     /**
      * When user mouse downs on selection
@@ -1699,8 +1878,10 @@ export const useSelection = ({ sheetId, activeCell, onChangeActiveCell, selectio
         if (e.isDefaultPrevented()) {
             return;
         }
-        const isContextMenu = e.button === MouseButtonCodes.right || e.ctrlKey;
-        if (isContextMenu) {
+        // ⌃-click is the macOS context-menu gesture; on Windows Ctrl+drag copies (read at
+        // release). A right-button drag opens Excel's drop menu when the host offers one.
+        const isRightButton = e.button === MouseButtonCodes.right;
+        if (isRightButton ? !onSelectionDragMenu : e.ctrlKey && isMacPlatform()) {
             return;
         }
         // Keep keyboard focus in the grid. The selection border is rendered OUTSIDE the tabIndex=0
@@ -1733,6 +1914,9 @@ export const useSelection = ({ sheetId, activeCell, onChangeActiveCell, selectio
         }
         /* Set dragging flag */
         isDragging.current = true;
+        dragButtonRef.current = isRightButton ? "right" : "left";
+        dragTargetRef.current = e.currentTarget ?? null;
+        setIsDragCopy(!isRightButton && isSelectionCopyModifier(e));
         /* Listen on the document the gesture started on. The border cover starts
          * the gesture from `pointerdown`, and the preventDefault above cancels it —
          * a browser then withholds the compatibility mouse events (mousemove /
@@ -1742,6 +1926,11 @@ export const useSelection = ({ sheetId, activeCell, onChangeActiveCell, selectio
          * four, so the release runs once. */
         const ownerDocument = getOwnerDocument(e.currentTarget) ?? document;
         dragSelectionDocumentRef.current = ownerDocument;
+        if (isRightButton) {
+            // The right-button `contextmenu` (at press on macOS, at release on Windows) must not
+            // open the cell context menu over the drag; the release decides what opens.
+            suppressNextContextMenu(ownerDocument);
+        }
         ownerDocument.addEventListener("mouseup", handleSelectionMouseUp);
         ownerDocument.addEventListener("pointerup", handleSelectionMouseUp);
         ownerDocument.addEventListener("mousemove", handleSelectionMouseMove);
@@ -1753,6 +1942,8 @@ export const useSelection = ({ sheetId, activeCell, onChangeActiveCell, selectio
         getCellBounds,
         handleSelectionMouseMove,
         handleSelectionMouseUp,
+        onSelectionDragMenu,
+        suppressNextContextMenu,
     ]);
     /**
      * Set selection start and end reference
@@ -1974,6 +2165,8 @@ export const useSelection = ({ sheetId, activeCell, onChangeActiveCell, selectio
     ]);
     return {
         isDragging: isDragging.current,
+        /** True while a selection-border drag would copy on release (Ctrl / ⌥ held). */
+        isDragCopy,
         draggedSelection: draggedSelection.current,
         initialDraggedSelection: initialDraggedSelection.current,
         isFilling: isFilling.current,

package/dist/esm/index.d.ts

@@ -30,6 +30,10 @@ export * from "./components/remove-duplicates-dialog";
 export * from "./components/text-to-columns-dialog";
 export * from "./components/subtotal-dialog";
 export * from "./components/goal-seek-dialog";
+export * from "./components/data-table-dialog";
+export * from "./components/scenario-manager-dialog";
+export * from "./components/solver-dialog";
+export * from "./components/forecast-sheet-dialog";
 export * from "./components/advanced-filter-dialog";
 export * from "./components/validation-alert-dialog";
 export * from "./components/insert-cells-dialog";
@@ -73,6 +77,7 @@ export * from "./api/cf-overlays";
 export * from "./api/cf-icons";
 export * from "./api/cf-engine";
 export * from "./api/cf-priority";
+export * from "./api/error-checking";
 export * from "./api/fill-patterns";
 export type { AvailableIcon } from "./components/filter-box";
 export * from "./hooks";
@@ -92,7 +97,7 @@ export { type ContextMenuWrapperProps } from "./hooks/use-context-menu";
 export * from "./api/scheduler";
 export * from "./themes";
 export * from "./signals/scroll-subscriber";
-export type { PasteSpecialOperation, PasteSpecialOptions, PasteSpecialRequest, PasteSpecialType, } from "./hooks/use-copy-paste-cut";
+export type { PasteSpecialMode, PasteSpecialOperation, PasteSpecialOptions, PasteSpecialRequest, PasteSpecialType, } from "./hooks/use-copy-paste-cut";
 export { CHART_CLIPBOARD_MIME, CHART_PASTE_OFFSET_PIXELS, type UseChartClipboardProps, useChartClipboard, } from "./hooks/use-chart-clipboard";
 export * from "./hooks/use-formula-range-helpers";
 export * from "./utils/z-order";

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

@@ -29,6 +29,10 @@ export * from "./components/remove-duplicates-dialog";
 export * from "./components/text-to-columns-dialog";
 export * from "./components/subtotal-dialog";
 export * from "./components/goal-seek-dialog";
+export * from "./components/data-table-dialog";
+export * from "./components/scenario-manager-dialog";
+export * from "./components/solver-dialog";
+export * from "./components/forecast-sheet-dialog";
 export * from "./components/advanced-filter-dialog";
 export * from "./components/validation-alert-dialog";
 export * from "./components/insert-cells-dialog";
@@ -72,6 +76,7 @@ export * from "./api/cf-overlays";
 export * from "./api/cf-icons";
 export * from "./api/cf-engine";
 export * from "./api/cf-priority";
+export * from "./api/error-checking";
 export * from "./api/fill-patterns";
 export * from "./hooks";
 export * from "./components/cell/typings";

package/dist/esm/release-date.js

@@ -1,3 +1,3 @@
 export const releaseDate = 
 // @ts-ignore
-new Date("2026-11-02") ?? new Date("2025-06-18");
+new Date("2026-11-03") ?? new Date("2025-06-18");