@rowsncolumns/spreadsheet 10.2.73 → 10.2.75

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

@@ -16,9 +16,13 @@ import { CF_INITIAL_WINDOW, cfWindowForViewport, isSameCfWindow, } from "../../a
 import { generateSelectionsFromFormula } from "../../api/selections";
 import { SpreadsheetApi } from "../../api/spreadsheet-api";
 import { findActiveTableWithinCell } from "../../api/table";
+import { getDataValidationTooltipContent } from "../../api/validation-tooltip";
+import { resolveGoToSpecial } from "../../api/go-to-special";
+import { checkExcelValidationValue, isFormulaEntry, } from "../../api/excel-validation-kinds";
 import { checkBooleanRule, decideValidationCommit, isCellLockedUnderProtection, isProtectedCell, isProtectedSheet, showValidationDropdownArrow, } from "../../api/validation";
-import { useFormulaModeValue, useSetNoteEditorCell, useSetPinnedTooltip, useShowPasteMenu, useShowValidationAlert, } from "../../atoms";
+import { useFormulaModeValue, useIsEvaluateFormulaDialogMounted, useIsGoToDialogMounted, useIsPasteSpecialDialogMounted, useOpenEvaluateFormulaDialog, useOpenGoToDialog, useOpenPasteSpecialDialog, useSetNoteEditorCell, useSetPinnedTooltip, useShowPasteMenu, useShowValidationAlert, } from "../../atoms";
 import { useActiveEditor } from "../../atoms/active-editor.atom";
+import { useAddWatch, useIsWatchWindowMounted, useSetWatchWindowContext, } from "../../atoms/watch-window.atom";
 import { useEditingCell } from "../../atoms/editing-cell.atom";
 import { useCellEditorInstance, useSetFormulabarEditorValue, useSetFormulaBarTextFormatRuns, } from "../../atoms/formula-bar-editor-value.atom";
 import { useFormulaCanSelectCells, useFormulaSelectionMode, useSetFormulaSelectionState, } from "../../atoms/formula-selection-state.atom";
@@ -60,6 +64,7 @@ import { useKeyboardHandler } from "../../hooks/use-keyboard-handler";
 import { useLicenseKeyValidator } from "../../hooks/use-licensekey-validator";
 import { useMoveColumnsAndRows } from "../../hooks/use-move-columns-rows";
 import { useNavigateToSheetRange } from "../../hooks/use-navigate-sheet-range";
+import { createExpressionEvaluator } from "../../api/evaluate-formula";
 import { useRaf } from "../../hooks/use-raf";
 import { useResizeObserver } from "../../hooks/use-resize-observer";
 import { useScaleListener } from "../../hooks/use-scale-listener";
@@ -99,7 +104,7 @@ import { getNestedPropertyNames } from "./helpers";
  * @returns
  */
 function CanvasGridComponent(props, forwardedRef) {
-    const { licenseKey, sheetId, instanceId, activeCell = DEFAULT_ACTIVE_CELL, selections = DEFAULT_ARRAY, frozenColumnCount = 0, frozenRowCount = 0, rowCount = DEFAULT_ROW_COUNT, columnCount = DEFAULT_COLUMN_COUNT, autoFocus, basicFilter, tables, namedRanges, bandedRanges = DEFAULT_ARRAY, tableBorderColor = "#008000", filterIconColor = "#008000", conditionalFormats, showFilterIcon = true, showCalculatedColumnIcon = true, showHeaders = true, defaultColumnWidth = DEFAULT_COLUMN_WIDTH, defaultRowHeight = DEFAULT_ROW_HEIGHT, columnHeaderHeight = COLUMN_HEADER_HEIGHT, rowHeaderWidth = ROW_HEADER_WIDTH, gridLineColor = GRIDLINE_COLOR, cellBackgroundColor = DEFAULT_CELL_BACKGROUND_COLOR, cellColor = DEFAULT_CELL_COLOR, headerBorderColor = DEFAULT_HEADER_BORDER_COLOR, headerBackgroundColor = DEFAULT_HEADER_BG, headerColor = DEFAULT_HEADER_COLOR, headerActiveBackgroundColor = DEFAULT_HEADER_ACTIVE_BG, headerSelectedBackgroundColor = DEFAULT_HEADER_SELECTED_BG, headerSelectedColor = "white", headerTableBackgroundColor = DEFAULT_HEADER_TABLE_BG, headerTableActiveBackgroundColor = DEFAULT_HEADER_ACTIVE_TABLE_BG, headerTableSelectedBackgroundColor = DEFAULT_HEADER_SELECTED_TABLE_BG, frozenShadowColor = headerBorderColor, frozenShadowThickness = 1, selectionBackgroundColor = SELECTION_BG, selectionBorderColor = SELECTION_BORDER, selectionDragBorderColor = SELECTION_BORDER, chartSelectedColor, chipBackgroundColor = CHIP_COLOR, merges = DEFAULT_ARRAY, borderStyles, protectedRanges, isWorkbookProtected: isWorkbookProtectedProp = false, getSheetProtection, pivotTables, charts, embeds, slicers, rowMetadata = DEFAULT_ARRAY, columnMetadata = DEFAULT_ARRAY, scale = 1, zoomSpeed = 1, overscanCount = 3, enableEditOnEnterKey = true, enableTextOverflow = true, showGridLines: _showGridLines, showFormulas = false, protectFormulas = false, showFrozenSeparator = true, HeaderCell = DefaultHeaderCell, Cell = DefaultCell, SelectionTitleComponent = SelectionTitle, CellEditor = DefaultCellEditor, CellTooltip, ContextMenu = DefaultContextMenu, ContextMenuWrapper = DefaultContextMenuWrapper, FilterBox = DefaultFilterBox, HeaderMoveDragComponent = DefaultHeaderMoveDragComponent, SuggestionsDropdown, stickyEditor = true, scrollSnap = false, scrollThrottleTimeout, preventBrowserDefaultScroll, mouseMoveThrottleTimeout = 60, tooltipIntentInterval = 60, selectionPolicy, users, userId, renderCollaboratorCursor, functionDescriptions, showHeaderMenuButton = true, scrollbarSize = SCROLLBAR_SIZE, theme = defaultSpreadsheetTheme, showNotes = true, showComments = true, locale, agentSuggestions, onReviewSuggestion, onShowFormulas, getDataRowCount, getChartComponent, getEmbedComponent, getSlicerComponent, onChange, onChangeBatch, onExpandCollapse, onPivotDrillDown, onDelete, onChangeEditorValue, onFill, onRequestCalculate, onChangeActiveCell, onChangeActiveSheet, onChangeSelections, getSheetName, getSheetId, getCellData, getNote: getNoteProp, getTextFormatRuns, getDataValidation, getEffectiveFormat, getFormattedValue: getFormattedValueProp, getTooltipContent, errorResolutionComponent, getEffectiveValue: getEffectiveValueProp, getUserEnteredExtendedValue, getEffectiveExtendedValue, getSheetRowCount, getSheetColumnCount, getCellPopoverContent, onScroll, onViewPortChange, windowConditionalFormats = false, engineConditionalFormatResults = false, onResize, onAutoResize, onHideColumn, onHideRow, onShowColumn, onShowRow, onGroupRows, onUngroupRows, onCollapseRowGroup, onExpandRowGroup, onGroupColumns, onUngroupColumns, onCollapseColumnGroup, onExpandColumnGroup, onSetOutlineDepth, onDeleteRow, onDeleteColumn, onInsertRow, onInsertColumn, onInsertCellsShiftDown, onInsertCellsShiftRight, onDeleteCellsShiftLeft, onDeleteCellsShiftUp, onClearContents, onMoveColumns, onMoveRows, onSelectNextSheet, onSelectPreviousSheet, onCreateNewSheet, onKeyDown, onChangeFormatting, onRepeatFormatting, onClearFormatting, onRequestEditProtectedRange, onMoveChart, onResizeChart, onDeleteChart, onMoveEmbed, onResizeEmbed, onDeleteEmbed, onRequestEditEmbed, onMoveSlicer, onResizeSlicer, onDeleteSlicer, onRequestEditSlicer, onFillRange, disableFillRightShortcut, onMoveSelection, onInsertTime, onInsertDate, onInsertDateTime, onInsertAutoSum, onUndo, onRedo, onPaste, onCopy, onCut, onSortColumn, onSortTable, onFilterTable, onFilterPivot, onResizeTable, onRequestEditTable, onRequestEditPivotTable, onRequestDeletePivotTable, onRemoveTable, onCreateTable, onInsertTableColumn, onDeleteTableColumn, onInsertTableRow, onDeleteTableRow, onCreateBasicFilter, onRequestDefineNamedRange, onRequestFormatCells, onRequestConditionalFormat, onRequestDataValidation, onRequestInsertComment, onRequestInsertLink, onFreezeColumn, onFreezeRow, onUpdateNote, onProtectRange, onUnProtectRange, onSortRange, onRequestSearch, onRequestReplace, onRequestResize, getRowHeaderText = getDefaultRowHeader, getColumnHeaderText = getDefaultColumnHeader, getAdditionalCellSpacing, tokenizer: defaultTokenizer = defaultFormulaTokenizer, onChangeScale, onRemoveLink, onSelectLink, onSplitTextToColumns, onRemoveDuplicates, onRequestExpand, cellExpandPredicate, StructuredResult = DefaultStructuredResult, getMentions, getStructuredProperties: getStructuredPropertiesProp, getFunctionParameterSuggestions, shouldFetchFunctionParameters, MentionTagComponent, MentionDropdownItemComponent, showSelectionResizeHandles = true, enableMagicFill, enableQuickEdit = true, MagicFillComponent, MagicFillContent, QuickEdit, PasteMenu, SuggestionAction, HiddenRowMarkers, HiddenColumnMarkers, enableResizerOverflow, className, defaultFontSizePoint = DEFAULT_FONT_SIZE_PT, readonly, isComparing = false, getCellDiff, enableDataBoundaryNavigation, footerHeight, footerComponent, arrowComponents, 
+    const { licenseKey, sheetId, instanceId, activeCell = DEFAULT_ACTIVE_CELL, selections = DEFAULT_ARRAY, frozenColumnCount = 0, frozenRowCount = 0, rowCount = DEFAULT_ROW_COUNT, columnCount = DEFAULT_COLUMN_COUNT, autoFocus, basicFilter, tables, namedRanges, bandedRanges = DEFAULT_ARRAY, tableBorderColor = "#008000", filterIconColor = "#008000", conditionalFormats, showFilterIcon = true, showCalculatedColumnIcon = true, showHeaders = true, defaultColumnWidth = DEFAULT_COLUMN_WIDTH, defaultRowHeight = DEFAULT_ROW_HEIGHT, columnHeaderHeight = COLUMN_HEADER_HEIGHT, rowHeaderWidth = ROW_HEADER_WIDTH, gridLineColor = GRIDLINE_COLOR, cellBackgroundColor = DEFAULT_CELL_BACKGROUND_COLOR, cellColor = DEFAULT_CELL_COLOR, headerBorderColor = DEFAULT_HEADER_BORDER_COLOR, headerBackgroundColor = DEFAULT_HEADER_BG, headerColor = DEFAULT_HEADER_COLOR, headerActiveBackgroundColor = DEFAULT_HEADER_ACTIVE_BG, headerSelectedBackgroundColor = DEFAULT_HEADER_SELECTED_BG, headerSelectedColor = "white", headerTableBackgroundColor = DEFAULT_HEADER_TABLE_BG, headerTableActiveBackgroundColor = DEFAULT_HEADER_ACTIVE_TABLE_BG, headerTableSelectedBackgroundColor = DEFAULT_HEADER_SELECTED_TABLE_BG, frozenShadowColor = headerBorderColor, frozenShadowThickness = 1, selectionBackgroundColor = SELECTION_BG, selectionBorderColor = SELECTION_BORDER, selectionDragBorderColor = SELECTION_BORDER, chartSelectedColor, chipBackgroundColor = CHIP_COLOR, merges = DEFAULT_ARRAY, borderStyles, protectedRanges, isWorkbookProtected: isWorkbookProtectedProp = false, getSheetProtection, pivotTables, charts, embeds, slicers, rowMetadata = DEFAULT_ARRAY, columnMetadata = DEFAULT_ARRAY, scale = 1, zoomSpeed = 1, overscanCount = 3, enableEditOnEnterKey = true, enableTextOverflow = true, showGridLines: _showGridLines, showFormulas = false, protectFormulas = false, showFrozenSeparator = true, HeaderCell = DefaultHeaderCell, Cell = DefaultCell, SelectionTitleComponent = SelectionTitle, CellEditor = DefaultCellEditor, CellTooltip, ContextMenu = DefaultContextMenu, ContextMenuWrapper = DefaultContextMenuWrapper, FilterBox = DefaultFilterBox, HeaderMoveDragComponent = DefaultHeaderMoveDragComponent, SuggestionsDropdown, stickyEditor = true, scrollSnap = false, scrollThrottleTimeout, preventBrowserDefaultScroll, mouseMoveThrottleTimeout = 60, tooltipIntentInterval = 60, selectionPolicy, users, userId, renderCollaboratorCursor, functionDescriptions, showHeaderMenuButton = true, scrollbarSize = SCROLLBAR_SIZE, theme = defaultSpreadsheetTheme, showNotes = true, showComments = true, locale, agentSuggestions, onReviewSuggestion, onShowFormulas, getDataRowCount, getChartComponent, getEmbedComponent, getSlicerComponent, onChange, onChangeBatch, onExpandCollapse, onPivotDrillDown, onDelete, onChangeEditorValue, onFill, onRequestCalculate, onChangeActiveCell, onChangeActiveSheet, onChangeSelections, getSheetName, getSheetId, getCellData, getNote: getNoteProp, getTextFormatRuns, getDataValidation, getEffectiveFormat, getFormattedValue: getFormattedValueProp, getTooltipContent, errorResolutionComponent, getEffectiveValue: getEffectiveValueProp, getUserEnteredExtendedValue, getEffectiveExtendedValue, getSheetRowCount, getSheetColumnCount, getCellPopoverContent, onScroll, onViewPortChange, windowConditionalFormats = false, engineConditionalFormatResults = false, onResize, onAutoResize, onHideColumn, onHideRow, onShowColumn, onShowRow, onGroupRows, onUngroupRows, onCollapseRowGroup, onExpandRowGroup, onGroupColumns, onUngroupColumns, onCollapseColumnGroup, onExpandColumnGroup, onSetOutlineDepth, onDeleteRow, onDeleteColumn, onInsertRow, onInsertColumn, onInsertCellsShiftDown, onInsertCellsShiftRight, onDeleteCellsShiftLeft, onDeleteCellsShiftUp, onClearContents, onMoveColumns, onMoveRows, onSelectNextSheet, onSelectPreviousSheet, onCreateNewSheet, onKeyDown, onChangeFormatting, onRepeatFormatting, onClearFormatting, onRequestEditProtectedRange, onMoveChart, onResizeChart, onDeleteChart, onMoveEmbed, onResizeEmbed, onDeleteEmbed, onRequestEditEmbed, onMoveSlicer, onResizeSlicer, onDeleteSlicer, onRequestEditSlicer, onFillRange, disableFillRightShortcut, keymap, onCalculateNow, onRequestGoTo, onMoveSelection, onInsertTime, onInsertDate, onInsertDateTime, onInsertAutoSum, onUndo, onRedo, onPaste, onCopy, onCut, onSortColumn, onSortTable, onFilterTable, onFilterPivot, onResizeTable, onRequestEditTable, onRequestEditPivotTable, onRequestDeletePivotTable, onRemoveTable, onCreateTable, onInsertTableColumn, onDeleteTableColumn, onInsertTableRow, onDeleteTableRow, onCreateBasicFilter, onRequestDefineNamedRange, onRequestFormatCells, onRequestConditionalFormat, onRequestDataValidation, onRequestInsertComment, onRequestInsertLink, onFreezeColumn, onFreezeRow, onUpdateNote, onProtectRange, onUnProtectRange, onSortRange, onRequestSearch, onRequestReplace, onRequestResize, getRowHeaderText = getDefaultRowHeader, getColumnHeaderText = getDefaultColumnHeader, getAdditionalCellSpacing, tokenizer: defaultTokenizer = defaultFormulaTokenizer, onChangeScale, onRemoveLink, onSelectLink, onSplitTextToColumns, onRemoveDuplicates, onGoalSeek, onSubtotal, onAdvancedFilter, onRequestExpand, cellExpandPredicate, StructuredResult = DefaultStructuredResult, getMentions, getStructuredProperties: getStructuredPropertiesProp, getFunctionParameterSuggestions, shouldFetchFunctionParameters, MentionTagComponent, MentionDropdownItemComponent, showSelectionResizeHandles = true, enableMagicFill, enableQuickEdit = true, MagicFillComponent, MagicFillContent, QuickEdit, PasteMenu, SuggestionAction, HiddenRowMarkers, HiddenColumnMarkers, enableResizerOverflow, className, defaultFontSizePoint = DEFAULT_FONT_SIZE_PT, readonly, isComparing = false, getCellDiff, enableDataBoundaryNavigation, footerHeight, footerComponent, arrowComponents, 
     // Host-driven filter props. `hostHiddenRowRanges`
     // supplies compact [start, end] hidden-row tuples; `getFilterValues` supplies a
     // column's distinct values. Both let a million-row filter render without scanning
@@ -1303,6 +1308,23 @@ function CanvasGridComponent(props, forwardedRef) {
         if (rule.allowBlank && isBlank) {
             return undefined;
         }
+        // A typed formula is validated on its RESULT once the calculator has
+        // run (Excel enters `=5` into a whole-number cell and checks the 5) —
+        // its text can never be decided here, so it stays flag-only.
+        if (isFormulaEntry(value)) {
+            return undefined;
+        }
+        // Excel's Whole number / Time / Text length kinds (authored or imported
+        // with `xlsxSource`) are decided synchronously from the typed text when
+        // their bounds are literals — Excel blocks a decimal in a whole-number
+        // cell at entry, not after a recalc.
+        const excelKindVerdict = checkExcelValidationValue(rule, value);
+        if (excelKindVerdict !== undefined) {
+            const excelDecision = decideValidationCommit(alert, excelKindVerdict);
+            return excelDecision === "proceed"
+                ? undefined
+                : { decision: excelDecision, alert };
+        }
         if (isDataValidationFormulaRule(rule)) {
             // Enforce synchronously only where `checkBooleanRule` can decide the typed
             // value without the calculator: CUSTOM_FORMULA's sync branch is a stub, the
@@ -1840,28 +1862,17 @@ function CanvasGridComponent(props, forwardedRef) {
      * shown in tooltip
      */
     /**
-     * Compose host tooltip content with the data-validation input message.
-     * Host-provided content wins; otherwise, when the cell is not already showing
-     * an error / invalid marker, surface the rule's input message (Excel's
-     * "show input message when cell is selected").
+     * Compose host tooltip content with the data-validation messages. Host-
+     * provided content wins; otherwise the rule's input message (Excel's "show
+     * input message when cell is selected") or, on an Invalid cell, the rule's
+     * custom error alert text — see `getDataValidationTooltipContent`.
      */
     const getTooltipContentWithValidation = useCallback((tooltipSheetId, rowIndex, columnIndex) => {
         const hostContent = getTooltipContent?.(tooltipSheetId, rowIndex, columnIndex);
         if (hostContent != null) {
             return hostContent;
         }
-        const error = getErrorValue(tooltipSheetId, rowIndex, columnIndex);
-        if (error?.type === "Error" || error?.type === "Invalid") {
-            return undefined;
-        }
-        const rule = getDataValidationRule(tooltipSheetId, rowIndex, columnIndex);
-        const inputMessage = rule?.inputMessage;
-        if (!inputMessage || (!inputMessage.title && !inputMessage.message)) {
-            return undefined;
-        }
-        return (React.createElement("div", { className: "bg-rnc-background text-rnc-foreground p-2 shadow-md rounded-md border-l-4 border-solid border-l-blue-700 max-w-[300px] flex flex-col gap-0.5" },
-            inputMessage.title ? (React.createElement("div", { className: "font-bold font-system text-sm" }, inputMessage.title)) : null,
-            inputMessage.message ? (React.createElement("div", { className: "text-xs font-system whitespace-pre-wrap" }, inputMessage.message)) : null));
+        return getDataValidationTooltipContent(getDataValidationRule(tooltipSheetId, rowIndex, columnIndex), getErrorValue(tooltipSheetId, rowIndex, columnIndex));
     }, [getTooltipContent, getErrorValue, getDataValidationRule]);
     const getTooltip = useGetTooltip({
         sheetId,
@@ -1937,6 +1948,90 @@ function CanvasGridComponent(props, forwardedRef) {
         onCopy,
         onCut,
     });
+    /**
+     * Paste Special dialog (context menu → Paste special…, Ctrl+Alt+V). The
+     * dialog is host-mounted (`PasteSpecialDialogHost`); its request routes
+     * back through the same `paste()` the submenu uses. Without a mounted host
+     * the trigger stays undefined so the menu item is not shown and the
+     * shortcut is not claimed (a host that has not adopted the dialog keeps
+     * its previous behaviour instead of a dead action).
+     */
+    const openPasteSpecialDialog = useOpenPasteSpecialDialog();
+    const isPasteSpecialDialogMounted = useIsPasteSpecialDialogMounted();
+    const requestPasteSpecial = useMemo(() => {
+        if (!isPasteSpecialDialogMounted)
+            return undefined;
+        return () => {
+            if (readonly)
+                return;
+            openPasteSpecialDialog({
+                onApply: (options) => {
+                    void paste(options);
+                },
+            });
+        };
+    }, [isPasteSpecialDialogMounted, openPasteSpecialDialog, paste, readonly]);
+    /**
+     * Evaluate Formula dialog (context menu → Evaluate formula) for a formula
+     * cell. Steps are scratch-evaluated through `onRequestCalculate`, the cell
+     * editor's live-preview calculator, so nothing is written to the sheet.
+     * Only offered while an `EvaluateFormulaDialogHost` is mounted.
+     */
+    const openEvaluateFormulaDialog = useOpenEvaluateFormulaDialog();
+    const isEvaluateFormulaDialogMounted = useIsEvaluateFormulaDialogMounted();
+    const requestEvaluateFormula = useMemo(() => {
+        if (!isEvaluateFormulaDialogMounted || !onRequestCalculate)
+            return undefined;
+        return (evaluateSheetId, cell) => {
+            const formula = getFormulaValue(evaluateSheetId, cell.rowIndex, cell.columnIndex);
+            if (!formula)
+                return;
+            openEvaluateFormulaDialog({
+                sheetId: evaluateSheetId,
+                cell,
+                sheetName: getSheetName?.(evaluateSheetId),
+                formula,
+                evaluate: createExpressionEvaluator(onRequestCalculate, evaluateSheetId, cell),
+            });
+        };
+    }, [
+        isEvaluateFormulaDialogMounted,
+        openEvaluateFormulaDialog,
+        getFormulaValue,
+        getSheetName,
+        onRequestCalculate,
+    ]);
+    /**
+     * Watch Window: "Add to Watch Window" is offered only while a
+     * `WatchWindowHost` is mounted; the live getters are published below once
+     * `navigateToSheetRange` exists.
+     */
+    const addWatch = useAddWatch();
+    const isWatchWindowMounted = useIsWatchWindowMounted();
+    const setWatchWindowContext = useSetWatchWindowContext();
+    const requestAddWatch = useMemo(() => {
+        if (!isWatchWindowMounted)
+            return undefined;
+        return (watchSheetId, cell) => addWatch({ sheetId: watchSheetId, ...cell });
+    }, [isWatchWindowMounted, addWatch]);
+    /**
+     * Go To (Ctrl+G / F5). A host `onRequestGoTo` wins; otherwise the built-in
+     * dialog opens — but only while a `GoToDialogHost` is mounted, so a host
+     * without one keeps the browser's own Ctrl+G / F5 (the keyboard handler
+     * claims the keys only when this is defined). The built-in opener needs
+     * `navigateToSheetRange`, which is created further down, so it is reached
+     * through a ref.
+     */
+    const openGoToDialog = useOpenGoToDialog();
+    const isGoToDialogMounted = useIsGoToDialogMounted();
+    const builtInGoToRef = useRef(() => undefined);
+    const requestGoTo = useMemo(() => {
+        if (onRequestGoTo)
+            return onRequestGoTo;
+        if (!isGoToDialogMounted)
+            return undefined;
+        return (goToSheetId, goToActiveCell, goToSelections) => builtInGoToRef.current(goToSheetId, goToActiveCell, goToSelections);
+    }, [onRequestGoTo, isGoToDialogMounted]);
     /**
      * After formula mode
      * Recover old selections
@@ -2093,7 +2188,7 @@ function CanvasGridComponent(props, forwardedRef) {
      * Get context Menu component
      */
     const getContextMenu = useCallback((cell) => {
-        return (React.createElement(ContextMenu, { activeCell: activeCell, selections: selections, sheetId: sheetId, frozenRows: frozenRows, frozenColumns: frozenColumns, onHideColumn: isRestricted ? undefined : onHideColumn, onShowColumn: isRestricted ? undefined : onShowColumn, onShowRow: isRestricted ? undefined : onShowRow, onHideRow: isRestricted ? undefined : onHideRow, onGroupRows: isRestricted ? undefined : onGroupRows, onUngroupRows: isRestricted ? undefined : onUngroupRows, onGroupColumns: isRestricted ? undefined : onGroupColumns, onUngroupColumns: isRestricted ? undefined : onUngroupColumns, isHiddenColumn: isHiddenColumn, isHiddenRow: isHiddenRow, onDeleteColumn: onDeleteColumn, onDeleteRow: onDeleteRow, onInsertRow: onInsertRow, onInsertColumn: onInsertColumn, onInsertCellsShiftDown: onInsertCellsShiftDown, onInsertCellsShiftRight: onInsertCellsShiftRight, onDeleteCellsShiftLeft: onDeleteCellsShiftLeft, onDeleteCellsShiftUp: onDeleteCellsShiftUp, onClearContents: onClearContents, onFreezeColumn: onFreezeColumn, onFreezeRow: onFreezeRow, focusSheet: focusSheet, onSortColumn: onSortColumn, onInsertNote: onInsertNote, onProtectRange: onProtectRange, onUnProtectRange: onUnProtectRange, onSortRange: onSortRange, onRequestDefineNamedRange: onRequestDefineNamedRange, protectedRanges: protectedRanges, isRowHeader: isRowHeader(cell.columnIndex), isColumnHeader: isColumnHeader(cell.rowIndex), selectedRowHeadersIds: selectedRowHeadersIds, selectedColumnHeadersIds: selectedColumnHeadersIds, onCopy: copy, onCut: cut, onPaste: paste, onRequestResize: onRequestResize, isSheetFocused: isSheetFocused, tables: activeTables, pivotTables: pivotTables, basicFilter: basicFilter, onRequestEditTable: onRequestEditTable, onRequestEditPivotTable: onRequestEditPivotTable, onRemoveTable: onRemoveTable, onRequestDeletePivotTable: onRequestDeletePivotTable, onPivotDrillDown: onPivotDrillDown, onRequestFormatCells: onRequestFormatCells, onRequestConditionalFormat: onRequestConditionalFormat, onRequestDataValidation: onRequestDataValidation, onClearFormatting: onClearFormatting, onCreateTable: onCreateTable, onCreateBasicFilter: onCreateBasicFilter, onInsertTableColumn: onInsertTableColumn, onDeleteTableColumn: onDeleteTableColumn, onInsertTableRow: onInsertTableRow, onDeleteTableRow: onDeleteTableRow, onFilterTable: onFilterTable, onSortTable: onSortTable, getFormattedValue: getFormattedValue, getFormattedValuesFromRange: getFormattedValuesFromRange, isTableHeader: isTableHeader, readonly: readonly, onSplitTextToColumns: onSplitTextToColumns, onRemoveDuplicates: onRemoveDuplicates, onAddQuickEdit: onAddQuickEdit, enableMagicFill: enableMagicFill }));
+        return (React.createElement(ContextMenu, { activeCell: activeCell, selections: selections, sheetId: sheetId, frozenRows: frozenRows, frozenColumns: frozenColumns, onHideColumn: isRestricted ? undefined : onHideColumn, onShowColumn: isRestricted ? undefined : onShowColumn, onShowRow: isRestricted ? undefined : onShowRow, onHideRow: isRestricted ? undefined : onHideRow, onGroupRows: isRestricted ? undefined : onGroupRows, onUngroupRows: isRestricted ? undefined : onUngroupRows, onGroupColumns: isRestricted ? undefined : onGroupColumns, onUngroupColumns: isRestricted ? undefined : onUngroupColumns, isHiddenColumn: isHiddenColumn, isHiddenRow: isHiddenRow, onDeleteColumn: onDeleteColumn, onDeleteRow: onDeleteRow, onInsertRow: onInsertRow, onInsertColumn: onInsertColumn, onInsertCellsShiftDown: onInsertCellsShiftDown, onInsertCellsShiftRight: onInsertCellsShiftRight, onDeleteCellsShiftLeft: onDeleteCellsShiftLeft, onDeleteCellsShiftUp: onDeleteCellsShiftUp, onClearContents: onClearContents, onFreezeColumn: onFreezeColumn, onFreezeRow: onFreezeRow, focusSheet: focusSheet, onSortColumn: onSortColumn, onInsertNote: onInsertNote, onProtectRange: onProtectRange, onUnProtectRange: onUnProtectRange, onSortRange: onSortRange, onRequestDefineNamedRange: onRequestDefineNamedRange, protectedRanges: protectedRanges, isRowHeader: isRowHeader(cell.columnIndex), isColumnHeader: isColumnHeader(cell.rowIndex), selectedRowHeadersIds: selectedRowHeadersIds, selectedColumnHeadersIds: selectedColumnHeadersIds, onCopy: copy, onCut: cut, onPaste: paste, onRequestPasteSpecial: requestPasteSpecial, onRequestEvaluateFormula: requestEvaluateFormula, onRequestAddWatch: requestAddWatch, isActiveCellFormula: Boolean(getFormulaValue(sheetId, activeCell.rowIndex, activeCell.columnIndex)), onRequestResize: onRequestResize, isSheetFocused: isSheetFocused, tables: activeTables, pivotTables: pivotTables, basicFilter: basicFilter, onRequestEditTable: onRequestEditTable, onRequestEditPivotTable: onRequestEditPivotTable, onRemoveTable: onRemoveTable, onRequestDeletePivotTable: onRequestDeletePivotTable, onPivotDrillDown: onPivotDrillDown, onRequestFormatCells: onRequestFormatCells, onRequestConditionalFormat: onRequestConditionalFormat, onRequestDataValidation: onRequestDataValidation, onClearFormatting: onClearFormatting, onCreateTable: onCreateTable, onCreateBasicFilter: onCreateBasicFilter, onInsertTableColumn: onInsertTableColumn, onDeleteTableColumn: onDeleteTableColumn, onInsertTableRow: onInsertTableRow, onDeleteTableRow: onDeleteTableRow, onFilterTable: onFilterTable, onSortTable: onSortTable, getFormattedValue: getFormattedValue, getFormattedValuesFromRange: getFormattedValuesFromRange, isTableHeader: isTableHeader, readonly: readonly, onSplitTextToColumns: onSplitTextToColumns, onRemoveDuplicates: onRemoveDuplicates, onGoalSeek: onGoalSeek, onSubtotal: onSubtotal, onAdvancedFilter: onAdvancedFilter, onChange: onChange, getCellData: getCellData, onAddQuickEdit: onAddQuickEdit, enableMagicFill: enableMagicFill }));
     }, [
         isRestricted,
         activeCell,
@@ -2120,6 +2215,9 @@ function CanvasGridComponent(props, forwardedRef) {
         copy,
         paste,
         cut,
+        requestPasteSpecial,
+        requestEvaluateFormula,
+        getFormulaValue,
         onInsertNote,
         onProtectRange,
         onUnProtectRange,
@@ -2158,6 +2256,11 @@ function CanvasGridComponent(props, forwardedRef) {
         enableMagicFill,
         onSplitTextToColumns,
         onRemoveDuplicates,
+        onGoalSeek,
+        onSubtotal,
+        onAdvancedFilter,
+        onChange,
+        getCellData,
         onRequestDeletePivotTable,
         isHiddenColumn,
         isHiddenRow,
@@ -2198,6 +2301,8 @@ function CanvasGridComponent(props, forwardedRef) {
         selections,
         selectedColumns,
         selectedRows,
+        selectedColumnHeadersIds,
+        selectedRowHeadersIds,
         onChangeFormatting,
         onRepeatFormatting,
         onInsertNote,
@@ -2207,6 +2312,13 @@ function CanvasGridComponent(props, forwardedRef) {
         onCreateNewSheet,
         onFillRange,
         disableFillRightShortcut,
+        keymap,
+        onCalculateNow,
+        onRequestGoTo: requestGoTo,
+        onRequestPasteSpecial: requestPasteSpecial,
+        onChangeBatch,
+        getUserEnteredValue: getUserEnteredStringValue,
+        getEffectiveValue,
         onInsertTime,
         onInsertDate,
         onInsertDateTime,
@@ -2976,6 +3088,77 @@ function CanvasGridComponent(props, forwardedRef) {
         setActiveCell,
         flash,
     });
+    // Built-in Go To: resolve against the workbook, then select + scroll. Go
+    // To Special scans the current selection (the whole sheet for a single
+    // cell) through the host's `getCellData`.
+    useIsomorphicLayoutEffect(() => {
+        builtInGoToRef.current = (goToSheetId, goToActiveCell, goToSelections) => {
+            const scanRange = goToSelections?.length && goToSelections[0]
+                ? goToSelections[0].range
+                : {
+                    startRowIndex: 1,
+                    endRowIndex: Math.max(1, sheetRowCount - 1),
+                    startColumnIndex: 1,
+                    endColumnIndex: Math.max(1, sheetColumnCount - 1),
+                };
+            openGoToDialog({
+                sheetId: goToSheetId,
+                activeCell: goToActiveCell,
+                namedRanges,
+                getSheetId,
+                getSheetName,
+                rowCount,
+                columnCount,
+                onNavigate: (range) => {
+                    navigateToSheetRange(range, { enableFlash: false });
+                    focusSheet();
+                },
+                special: getCellData
+                    ? {
+                        resolve: (kind) => resolveGoToSpecial(kind, {
+                            sheetId: goToSheetId,
+                            range: scanRange,
+                            getCellData,
+                            isRowHidden: isHiddenRow,
+                            isColumnHidden: isHiddenColumn,
+                        }),
+                        onSelectRanges: (ranges) => {
+                            const first = ranges[0];
+                            if (!first)
+                                return;
+                            setActiveCell(goToSheetId, {
+                                rowIndex: first.startRowIndex,
+                                columnIndex: first.startColumnIndex,
+                            });
+                            onChangeSelections?.(goToSheetId, ranges.map((range) => ({ range })));
+                            focusSheet();
+                        },
+                    }
+                    : undefined,
+            });
+        };
+    });
+    // Watch Window live getters — republished per render while a host is
+    // mounted so the panel tracks recalculation.
+    useIsomorphicLayoutEffect(() => {
+        if (!isWatchWindowMounted)
+            return;
+        setWatchWindowContext({
+            getSheetName,
+            getFormattedValue,
+            getFormula: getFormulaValue,
+            onNavigate: (cell) => {
+                navigateToSheetRange({
+                    sheetId: cell.sheetId,
+                    startRowIndex: cell.rowIndex,
+                    endRowIndex: cell.rowIndex,
+                    startColumnIndex: cell.columnIndex,
+                    endColumnIndex: cell.columnIndex,
+                }, { enableFlash: false });
+                focusSheet();
+            },
+        });
+    });
     // Dispatch keyboard event
     const dispatchEvent = useCallback((event) => {
         gridRef.current?.container?.dispatchEvent(event);

package/dist/esm/components/canvas-grid/typings.d.ts

@@ -6,14 +6,14 @@ import type { CellDiff } from "@rowsncolumns/version-comparison";
 import type { ElementType } from "react";
 import type React from "react";
 import type { ContextMenuWrapperProps } from "../../hooks/use-context-menu";
-import type { PasteSpecialType } from "../../hooks/use-copy-paste-cut";
+import type { PasteSpecialRequest } from "../../hooks/use-copy-paste-cut";
 import type { MakeEditableOptions } from "../../hooks/use-editable";
 import type { ExportRangeOutput } from "../../hooks/use-export-range";
 import type { useFlash } from "../../hooks/use-flash";
 import type { useNavigateToSheetRange } from "../../hooks/use-navigate-sheet-range";
 import type { UseSelectionOptions } from "../../hooks/use-selection";
 import type { GetCellDimensionsOptions as SizerGetCellDimensionsOptions, useSizer } from "../../hooks/use-sizer";
-import type { AgentSuggestion, BandedDefinition, BandedRange, BorderStyle, CellFormat, Collaborator, Color, ColorFilterCriteria, ConditionType, ConditionValue, DataValidationRule, DataValidationRuleRecord, EmbeddedObject, IconFilterCriteria, Maybe, NamedRange, ParsedToken, PivotTable, ProtectedRange, Sheet, SheetCoordinate, SheetProtection, SheetRange, Slicer, SortOrder, SortSpecs, TableTheme, TableView } from "../../types";
+import type { AgentSuggestion, BandedDefinition, BandedRange, BorderStyle, CellFormat, Collaborator, Color, ColorFilterCriteria, ConditionType, ConditionValue, DataValidationRule, DataValidationRuleRecord, EmbeddedObject, IconFilterCriteria, Maybe, NamedRange, ParsedToken, PivotTable, ProtectedRange, RemoveDuplicatesOptions, AdvancedFilterOptions, AdvancedFilterResult, GoalSeekResult, SplitTextOptions, SubtotalOptions, SubtotalResult, Sheet, SheetCoordinate, SheetProtection, SheetRange, Slicer, SortOrder, SortSpecs, TableTheme, TableView } from "../../types";
 import type { AXIS, CellData, ConditionalFormatRule, EmbeddedChart, FilterView } from "../../types";
 import type { CellProps } from "../cell/typings";
 import type { CellEditorProps } from "../cell-editor";
@@ -33,6 +33,11 @@ import type { SuggestionActionProps } from "../selection/suggestion-action";
 import type { SelectionTitleProps } from "../selection/title";
 import type { BorderLocation } from "../toolbar";
 export type ExtractMentionType<T> = T extends CellData<any, infer M> ? M : Mention;
+/**
+ * Keyboard shortcut flavour for the combos Excel and Google Sheets bind
+ * differently. See `CanvasGridProps["keymap"]`.
+ */
+export type SpreadsheetKeymap = "sheets" | "excel";
 /**
  * Color / icon / custom-list sort options shared by the column-, table-
  * and range-sort callbacks. Mirrors the engine's `DimensionSortSpec`
@@ -1044,6 +1049,45 @@ export type CanvasGridProps<T extends CellData = CellData<any, any>> = {
      * When true, key combo falls through to the browser default.
      */
     disableFillRightShortcut?: boolean;
+    /**
+     * Which product's shortcuts win where Excel and Google Sheets disagree.
+     *
+     * Both keymaps share every non-conflicting binding (Excel's `Ctrl+R`,
+     * `Ctrl+T`, `Ctrl+1`, `Ctrl+5`, `F9`, `Ctrl+'`, `Ctrl+G` are always on,
+     * as are Sheets' `Ctrl+Alt+T`, `Ctrl+Alt+1`, `Ctrl+Alt+9/0`, and the
+     * unhide combos both products share, `Ctrl+Shift+9` / `Ctrl+Shift+0`).
+     * The keymap only decides the combos the two products bind differently:
+     *
+     * | Shortcut         | `"sheets"` (default) | `"excel"`             |
+     * | ---------------- | -------------------- | --------------------- |
+     * | Ctrl+Shift+L     | Align left           | Toggle AutoFilter     |
+     * | Ctrl+9 / Ctrl+0  | (browser)            | Hide rows / columns   |
+     *
+     * Hide / unhide act on the rows / columns selected through their headers
+     * plus the rows / columns of the selected cell ranges (what the context
+     * menu's Hide item uses). With the other axis fully selected there is
+     * nothing to act on and the shortcut is a no-op (Excel would hide every
+     * row / column).
+     */
+    keymap?: SpreadsheetKeymap;
+    /**
+     * Excel `F9` (workbook) / `Shift+F9` (active sheet): recalculate now.
+     * Hosts wire this to `calculateNow` from `useSpreadsheetState` /
+     * `useSpreadsheetEngine`; the shortcut is inert when omitted.
+     * @param sheetId
+     * @param scope
+     */
+    onCalculateNow?(sheetId: number, scope: "workbook" | "sheet"): void | Promise<void>;
+    /**
+     * Excel `Ctrl+G` / `F5`: the user wants the Go To dialog (or the Name
+     * Box focused). When omitted the grid opens its built-in Go To dialog —
+     * mount `<GoToDialogHost />` in the host next to the other editor
+     * dialogs. Provide this to replace it with your own UI.
+     * @param sheetId
+     * @param activeCell
+     * @param selections
+     */
+    onRequestGoTo?(sheetId: number, activeCell: CellInterface, selections: SelectionArea<SelectionAttributes>[]): void;
     /**
      * User is creating a new chart
      * @param sheetId
@@ -1282,9 +1326,9 @@ export type CanvasGridProps<T extends CellData = CellData<any, any>> = {
      */
     onDeleteTableRow?(table: TableView, rowIndexes: number[]): void;
     /**
-     * Create a basic filter
-     * Ctrl+Shift+F
-     * Cmd+Shift+F
+     * Create a basic filter, or remove the sheet's existing one when the
+     * selection touches it (a toggle).
+     * Ctrl+Shift+F / Cmd+Shift+F, and Ctrl+Shift+L under `keymap="excel"`
      * @param sheetId
      * @param activeCell
      * @param selections
@@ -1483,7 +1527,7 @@ export type CanvasGridProps<T extends CellData = CellData<any, any>> = {
      * @param delimiter
      * @returns
      */
-    onSplitTextToColumns?: (sheetId: number, activeCell: CellInterface, selections?: SelectionArea<SelectionAttributes>[], delimiter?: string) => void;
+    onSplitTextToColumns?: (sheetId: number, activeCell: CellInterface, selections?: SelectionArea<SelectionAttributes>[], delimiter?: string, options?: SplitTextOptions) => void;
     /**
      * Remove duplicate rows
      * @param sheetId
@@ -1491,7 +1535,24 @@ export type CanvasGridProps<T extends CellData = CellData<any, any>> = {
      * @param selections
      * @returns
      */
-    onRemoveDuplicates?: (sheetId: number, activeCell: CellInterface, selections?: SelectionArea<SelectionAttributes>[]) => void;
+    onRemoveDuplicates?: (sheetId: number, activeCell: CellInterface, selections?: SelectionArea<SelectionAttributes>[], options?: RemoveDuplicatesOptions) => void;
+    /**
+     * Excel's Goal Seek: find the `changingCell` value that makes the formula in
+     * `setCell` evaluate to `targetValue`, then commit it. Resolves to the
+     * search result (status + value), or `undefined` when the engine reports
+     * no result (the rnc engine iterates natively) or the set cell has no formula.
+     */
+    onGoalSeek?: (sheetId: number, setCell: CellInterface, targetValue: number, changingCell: CellInterface) => Promise<GoalSeekResult | undefined>;
+    /**
+     * Excel's Data → Subtotal: insert "<group> Total" / "Grand Total" rows with
+     * `SUBTOTAL(...)` formulas and outline the groups.
+     */
+    onSubtotal?: (sheetId: number, options: SubtotalOptions) => SubtotalResult | undefined;
+    /**
+     * Excel's Data → Advanced filter: filter a list in place (hide non-matching
+     * rows) or copy the matching records elsewhere, driven by a criteria range.
+     */
+    onAdvancedFilter?: (sheetId: number, options: AdvancedFilterOptions) => AdvancedFilterResult | undefined;
     /**
      * Callback to get effective value of a cell
      * @param sheetId
@@ -1980,10 +2041,12 @@ export type CanvasGridMethods = {
      */
     cut?: () => void;
     /**
-     * Copies current selections
+     * Pastes the clipboard at the active cell. Pass a legacy single mode
+     * (`"Value"`, `"Transposed"`, …) or a full `PasteSpecialOptions` request
+     * (paste what / operation / skip blanks / transpose).
      * @returns
      */
-    paste?: (pasteSpecial?: PasteSpecialType) => void;
+    paste?: (pasteSpecial?: PasteSpecialRequest) => void;
 };
 export type SelectionAttributes = RangeStyle & {
     sheetName?: string;