@rowsncolumns/spreadsheet 10.2.74 → 10.2.76

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

@@ -1,5 +1,5 @@
 import { tokenize as defaultFormulaTokenizer } from "@rowsncolumns/calculator";
-import { Direction, isAreasEqual } from "@rowsncolumns/grid";
+import { cellToArea, Direction, isAreasEqual } from "@rowsncolumns/grid";
 import { canUseDOM } from "@rowsncolumns/grid";
 import { getBoundedCells, MouseButtonCodes } from "@rowsncolumns/grid";
 import { isCellWithinBounds } from "@rowsncolumns/grid";
@@ -10,15 +10,19 @@ import { cellToAddress, getCellEffectiveFormat, getContrastColor, isConditionalF
 import { useStore } from "jotai";
 import merge from "lodash/merge";
 import throttle from "lodash/throttle";
-import React, { forwardRef, memo, startTransition, useCallback, useMemo, useRef, useState, } from "react";
+import React, { forwardRef, memo, startTransition, useCallback, useEffect, useMemo, useRef, useState, } from "react";
 import { getBandedCells } from "../../api/banded-ranges";
 import { CF_INITIAL_WINDOW, cfWindowForViewport, isSameCfWindow, } from "../../api/cf-window";
 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, useIsEvaluateFormulaDialogMounted, useIsGoToDialogMounted, useIsPasteSpecialDialogMounted, useOpenEvaluateFormulaDialog, useOpenGoToDialog, useOpenPasteSpecialDialog, useSetNoteEditorCell, useSetPinnedTooltip, useShowPasteMenu, useShowValidationAlert, } from "../../atoms";
+import { useFormulaModeValue, useIsEvaluateFormulaDialogMounted, useIsGoToDialogMounted, useIsPasteSpecialDialogMounted, useOpenEvaluateFormulaDialog, useOpenGoToDialog, useOpenPasteSpecialDialog, useSetNoteEditorCell, useSetPinnedTooltip, useFillOptionsState, useOpenFillSeriesDialog, 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";
@@ -65,7 +69,7 @@ import { useRaf } from "../../hooks/use-raf";
 import { useResizeObserver } from "../../hooks/use-resize-observer";
 import { useScaleListener } from "../../hooks/use-scale-listener";
 import { useSelectedRowsColumns } from "../../hooks/use-selected-rows-columns";
-import { useSelection } from "../../hooks/use-selection";
+import { useSelection, } from "../../hooks/use-selection";
 import { useSelectionChange } from "../../hooks/use-selection-change";
 import { useSelectionInterceptors } from "../../hooks/use-selection-interceptors";
 import { useSelectionMove } from "../../hooks/use-selection-move";
@@ -82,6 +86,7 @@ import { useTouch } from "../../hooks/use-touch";
 import { multiInstanceStore } from "../../providers/spreadsheet-provider";
 import { scrollSubscriber } from "../../signals/scroll-subscriber";
 import { getStringifiedColor } from "../../themes";
+import { fillRangeForSeriesSpec, seedRangeForSeriesSpec } from "../../api/fill-series";
 import { Cell as DefaultCell } from "../cell";
 import { CellEditor as DefaultCellEditor } from "../cell-editor";
 import { ContextMenu as DefaultContextMenu } from "../context-menu";
@@ -100,7 +105,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, 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, 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
@@ -188,6 +193,9 @@ function CanvasGridComponent(props, forwardedRef) {
     const cellEditorInstance = useCellEditorInstance();
     // Paste menu
     const [showPasteMenu, setShowPasteMenu] = useShowPasteMenu();
+    // Auto Fill Options smart tag / right-drag fill menu + Series dialog
+    const [fillOptions, setFillOptions] = useFillOptionsState();
+    const openFillSeriesDialog = useOpenFillSeriesDialog();
     // Shared state
     const formulaMode = useFormulaModeValue();
     const formulaSelections = useFormulaSelections();
@@ -1304,6 +1312,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
@@ -1841,28 +1866,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,
@@ -1887,10 +1901,151 @@ function CanvasGridComponent(props, forwardedRef) {
     const dataRegionBoundaries = useMemo(() => tables
         ?.filter((table) => table.sheetId === sheetId)
         .map((table) => table.range), [tables, sheetId]);
+    /**
+     * True when a source cell of a fill is date-formatted — the fill menu then
+     * adds Fill Days / Weekdays / Months / Years (Excel shows them only for
+     * date sources). Reads the cell's own format first, then the effective
+     * (style-plane) format so rnc-backed cells count too.
+     */
+    const sourceHasDates = useCallback((fillSheetId, sources) => {
+        let visited = 0;
+        for (const { range } of sources) {
+            for (let r = range.startRowIndex; r <= range.endRowIndex; r++) {
+                for (let c = range.startColumnIndex; c <= range.endColumnIndex; c++) {
+                    // Bounded scan: a whole-column source would otherwise cost a full walk.
+                    if (++visited > 256)
+                        return false;
+                    const uf = getCellData?.(fillSheetId, r, c)?.userEnteredFormat;
+                    const type = (uf && "numberFormat" in uf ? uf.numberFormat?.type : undefined) ??
+                        getEffectiveFormat?.(fillSheetId, r, c)?.numberFormat?.type;
+                    if (type === "DATE" || type === "DATE_TIME")
+                        return true;
+                }
+            }
+        }
+        return false;
+    }, [getCellData, getEffectiveFormat]);
+    /**
+     * A fill-handle drag ended: park the gesture so the Auto Fill Options smart
+     * tag (left drag — already filled) or the right-drag fill menu (nothing
+     * filled yet) can re-choose the fill type.
+     */
+    const handleFillHandleRelease = useCallback((release) => {
+        if (readonly)
+            return;
+        setFillOptions({
+            sheetId: release.sheetId,
+            activeCell: release.activeCell,
+            fillSelection: release.fillSelection,
+            selections: release.selections,
+            fillType: undefined,
+            hasDates: sourceHasDates(release.sheetId, release.selections.length
+                ? release.selections
+                : [{ range: cellToArea(release.activeCell) }]),
+            mode: release.button === "right" ? "menu" : "smart-tag",
+        });
+    }, [readonly, setFillOptions, sourceHasDates]);
+    /**
+     * An entry of the fill menu was picked: re-issue the fill from the (still
+     * intact) source with the explicit type. The target is simply overwritten
+     * with the new result — no undo round-trip needed because the source
+     * selection is never touched by a fill.
+     */
+    const handleChooseFillType = useCallback((fillType) => {
+        if (!fillOptions)
+            return;
+        onFill?.(fillOptions.sheetId, fillOptions.activeCell, fillOptions.fillSelection, fillOptions.selections, undefined, fillType);
+        setFillOptions({ ...fillOptions, fillType, mode: "smart-tag" });
+        focusSheet();
+    }, [fillOptions, onFill, setFillOptions, focusSheet]);
+    const handleCloseFillOptions = useCallback(() => {
+        // Only the right-drag menu is "cancel on close"; the smart tag stays.
+        if (fillOptions?.mode === "menu")
+            setFillOptions(null);
+    }, [fillOptions, setFillOptions]);
+    /**
+     * Run Excel's Series dialog result: the target range's first row (Series
+     * in Columns) / first column (Rows) is the seed line; `stop` may shrink or
+     * extend the target along the axis from the seed's last value.
+     */
+    const applyFillSeriesSpec = useCallback((fillSheetId, cell, target, spec) => {
+        const seed = seedRangeForSeriesSpec(target.range, spec);
+        const fillRange = fillRangeForSeriesSpec({
+            target: target.range,
+            seed,
+            spec,
+            getSeedValue: (r, c) => {
+                const value = getEffectiveValue(fillSheetId, r, c);
+                return typeof value === "number" ? value : undefined;
+            },
+            rowCount,
+            columnCount,
+        });
+        if (!fillRange)
+            return;
+        const fillType = spec.type === "linear"
+            ? spec.trend
+                ? "LinearTrend"
+                : "FillSeries"
+            : spec.type === "growth"
+                ? "GrowthTrend"
+                : spec.type === "date"
+                    ? spec.dateUnit === "weekday"
+                        ? "FillWeekdays"
+                        : spec.dateUnit === "month"
+                            ? "FillMonths"
+                            : spec.dateUnit === "year"
+                                ? "FillYears"
+                                : "FillDays"
+                    : undefined;
+        onFill?.(fillSheetId, cell, { range: fillRange }, [{ ...target, range: seed }], undefined, fillType, { series: spec });
+        onChangeSelections?.(fillSheetId, [{ ...target, range: fillRange }]);
+    }, [getEffectiveValue, onFill, onChangeSelections, rowCount, columnCount]);
+    /** Open the Series dialog for a range (the current selection by default). */
+    const openFillSeriesDialogFor = useCallback((target, initialIn) => {
+        const selection = target ??
+            selections[selections.length - 1] ??
+            { range: cellToArea(activeCell) };
+        openFillSeriesDialog({
+            sheetId,
+            activeCell,
+            selection,
+            initialIn,
+            onApply: (spec) => applyFillSeriesSpec(sheetId, activeCell, selection, spec),
+        });
+    }, [selections, activeCell, sheetId, openFillSeriesDialog, applyFillSeriesSpec]);
+    /** "Series…" on the right-drag fill menu: the drag's target is the range, its axis the default. */
+    const handleOpenFillSeriesDialog = useCallback(() => {
+        if (!fillOptions)
+            return;
+        const { range } = fillOptions.fillSelection;
+        const source = fillOptions.selections[0]?.range;
+        const initialIn = source &&
+            (range.endRowIndex > source.endRowIndex ||
+                range.startRowIndex < source.startRowIndex)
+            ? "columns"
+            : "rows";
+        setFillOptions(null);
+        openFillSeriesDialogFor({ range }, initialIn);
+    }, [fillOptions, setFillOptions, openFillSeriesDialogFor]);
+    // The smart tag belongs to one fill; moving on (a new active cell) drops it.
+    // Keyed on the cell's coordinates, not the object — a re-created `activeCell`
+    // with the same coordinates must not dismiss it.
+    useEffect(() => {
+        setFillOptions(null);
+    }, [activeCell.rowIndex, activeCell.columnIndex, sheetId, setFillOptions]);
+    /**
+     * Fill handle dragged BACK inside the selection (Excel): the dragged-over cells lose their
+     * contents — formats stay unless Ctrl/Cmd was held — through the same `onDelete` path as the
+     * Delete key, so both engines (legacy `useOnDelete`, rnc `delete-cells`) clear identically.
+     */
+    const handleFillShrink = useCallback((sheetId, activeCell, clearRange, options) => {
+        onDelete?.(sheetId, activeCell, [{ range: clearRange }], options?.modifier === "toggle" ? "all" : "contents");
+    }, [onDelete]);
     /**
      * Handle grid selections
      */
-    const { onMouseDown: onMouseDownSelection, onPointerDown: onPointerDownSelection, onKeyDown: onKeyDownSelection, fillSelection, onFillHandleMouseDown, onFillHandleDoubleClick, isDragging, isFilling, isSelectionInProgress, draggedSelection, onSelectionMouseDown, setActiveCell, initialDraggedSelection, updateSelectionStartEndReference, selectColumn, getContentfulGridRangeAroundCell, newSelection, modifySelection, clearSelections, } = useSelection({
+    const { onMouseDown: onMouseDownSelection, onPointerDown: onPointerDownSelection, onKeyDown: onKeyDownSelection, fillSelection, fillShrink, onFillHandleMouseDown, onFillHandleDoubleClick, isDragging, isFilling, isSelectionInProgress, draggedSelection, onSelectionMouseDown, setActiveCell, initialDraggedSelection, updateSelectionStartEndReference, selectColumn, getContentfulGridRangeAroundCell, newSelection, modifySelection, clearSelections, } = useSelection({
         sheetId,
         getDataRowCount,
         enableDataBoundaryNavigation,
@@ -1918,6 +2073,8 @@ function CanvasGridComponent(props, forwardedRef) {
         scrollToCell,
         isMergedCell,
         onFill,
+        onFillHandleRelease: handleFillHandleRelease,
+        onFillShrink: handleFillShrink,
         onMoveSelection,
         isHiddenColumn,
         isHiddenRow,
@@ -1991,6 +2148,19 @@ function CanvasGridComponent(props, forwardedRef) {
         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
@@ -2077,6 +2247,8 @@ function CanvasGridComponent(props, forwardedRef) {
         onChange,
         getCommitValidation,
         showValidationAlert,
+        selections,
+        onChangeBatch,
     });
     /**
      * User cancels editing the cell
@@ -2165,7 +2337,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, onRequestPasteSpecial: requestPasteSpecial, onRequestEvaluateFormula: requestEvaluateFormula, 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, onChange: onChange, getCellData: getCellData, 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,
@@ -2233,6 +2405,9 @@ function CanvasGridComponent(props, forwardedRef) {
         enableMagicFill,
         onSplitTextToColumns,
         onRemoveDuplicates,
+        onGoalSeek,
+        onSubtotal,
+        onAdvancedFilter,
         onChange,
         getCellData,
         onRequestDeletePivotTable,
@@ -2696,6 +2871,8 @@ function CanvasGridComponent(props, forwardedRef) {
         hideCellPopover();
         // Hide paste mnenu
         setShowPasteMenu(false);
+        // Hide the Auto Fill Options smart tag (its own mousedown never reaches here)
+        setFillOptions(null);
         // Remove pinned tooltip
         onUnpinTooltip();
     }, [
@@ -2707,6 +2884,7 @@ function CanvasGridComponent(props, forwardedRef) {
         setFormulaState,
         hideCellPopover,
         setShowPasteMenu,
+        setFillOptions,
         onUnpinTooltip,
         focusSheet,
     ]);
@@ -2958,9 +3136,12 @@ function CanvasGridComponent(props, forwardedRef) {
     /**
      * Selection Renderer
      */
+    // The drag-back preview reuses the fill overlay geometry but greys the cells about to be cleared.
+    const fillShrinkOverlay = useMemo(() => (fillShrink ? { range: fillShrink.clearRange } : undefined), [fillShrink]);
     const selectionRenderer = useSelectionRenderer({
         sheetId,
         scale,
+        isFillShrink: fillShrink !== undefined,
         onSelectionMouseDown: onSelectionElementMouseDown,
         onMouseDownResizeHandle: onMouseDownResizeHandle,
         onMouseDownMoveSelection: onMouseDownMoveSelection,
@@ -2989,6 +3170,10 @@ function CanvasGridComponent(props, forwardedRef) {
         readonly,
         onSplitTextToColumns,
         showPasteMenu,
+        fillOptions,
+        onChooseFillType: handleChooseFillType,
+        onOpenFillSeriesDialog: handleOpenFillSeriesDialog,
+        onCloseFillOptions: handleCloseFillOptions,
         hoveredCell: delayedHoveredCell,
         onRemoveQuickEdit,
         onAddQuickEdit,
@@ -3062,9 +3247,19 @@ function CanvasGridComponent(props, forwardedRef) {
         setActiveCell,
         flash,
     });
-    // Built-in Go To: resolve against the workbook, then select + scroll.
+    // 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) => {
+        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,
@@ -3077,9 +3272,52 @@ function CanvasGridComponent(props, forwardedRef) {
                     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);
@@ -3246,12 +3484,14 @@ function CanvasGridComponent(props, forwardedRef) {
     });
     // props reference for spreadsheet api
     propsReferenceRef.current = props;
+    const openFillSeriesDialogForRef = useStableRef(openFillSeriesDialogFor);
     // Expose a spreadsheet API
     useIsomorphicLayoutEffect(() => {
         const stableMethods = {
             getUserEnteredValue: getUserEnteredStringValueStable,
             scrollToCell,
             commit,
+            openFillSeriesDialog: () => openFillSeriesDialogForRef.current?.(),
         };
         setSpreadsheetApi(new SpreadsheetApi(propsReferenceRef, stableMethods, store, instanceStore, instanceId));
     }, []);
@@ -3333,7 +3573,7 @@ function CanvasGridComponent(props, forwardedRef) {
         width === 0 || height === 0 ? (React.createElement("div", { className: "flex border-solid border-rnc-border border border-t border-b flex-1 justify-center items-center" },
             React.createElement("div", { className: "space-y-2" },
                 React.createElement(Skeleton, { className: "h-4 w-[250px]" }),
-                React.createElement(Skeleton, { className: "h-4 w-[250px]" })))) : (React.createElement(BaseGrid, { ref: gridRef, overscanCount: overscanCount, rowCount: sheetRowCount, columnCount: sheetColumnCount, rowHeight: rowHeight, columnWidth: columnWidth, itemRenderer: cellRenderer, headerRenderer: headerCellRenderer, selectionRenderer: selectionRenderer, gridLineColor: gridLineColor, gridLineWidth: gridLineWidth, borderStyles: finalBorderStyles, mergedCells: merges, scale: scale, width: width, height: height, frozenColumns: frozenColumns, frozenRows: frozenRows, activeCell: activeCell, selections: formulaMode ? formulaSelections : selections, FillHandle: FillHandle, showFillHandle: showFillHandle, fillHandleSize: fillHandleSize, showGridLines: showGridLines, enableCellOverlay: true, enableCellBackground: true, enableSelectionDrag: enableSelectionDrag, showFrozenColumnShadow: showFrozenSeparator, showFrozenRowShadow: showFrozenSeparator, selectionBorderColor: selectionBorderColor, selectionBackgroundColor: selectionBackgroundColor, fillhandleBorderColor: cellBackgroundColor, isDraggingSelection: isDragging, fillSelection: fillSelection, onPointerDown: handlePointerDown, onPointerUp: handlePointerUp, onMouseDown: handleMouseDown, onDoubleClick: handleDoubleClick, onFillHandleMouseDown: onFillHandleMouseDown, onFillHandleDoubleClick: onFillHandleDoubleClick, 
+                React.createElement(Skeleton, { className: "h-4 w-[250px]" })))) : (React.createElement(BaseGrid, { ref: gridRef, overscanCount: overscanCount, rowCount: sheetRowCount, columnCount: sheetColumnCount, rowHeight: rowHeight, columnWidth: columnWidth, itemRenderer: cellRenderer, headerRenderer: headerCellRenderer, selectionRenderer: selectionRenderer, gridLineColor: gridLineColor, gridLineWidth: gridLineWidth, borderStyles: finalBorderStyles, mergedCells: merges, scale: scale, width: width, height: height, frozenColumns: frozenColumns, frozenRows: frozenRows, activeCell: activeCell, selections: formulaMode ? formulaSelections : selections, FillHandle: FillHandle, showFillHandle: showFillHandle, fillHandleSize: fillHandleSize, showGridLines: showGridLines, enableCellOverlay: true, enableCellBackground: true, enableSelectionDrag: enableSelectionDrag, showFrozenColumnShadow: showFrozenSeparator, showFrozenRowShadow: showFrozenSeparator, selectionBorderColor: selectionBorderColor, selectionBackgroundColor: selectionBackgroundColor, fillhandleBorderColor: cellBackgroundColor, isDraggingSelection: isDragging, fillSelection: fillShrinkOverlay ?? fillSelection, onPointerDown: handlePointerDown, onPointerUp: handlePointerUp, onMouseDown: handleMouseDown, onDoubleClick: handleDoubleClick, onFillHandleMouseDown: onFillHandleMouseDown, onFillHandleDoubleClick: onFillHandleDoubleClick, 
             // Dimension of fill handle
             scrollToCellOffset: 4, scrollbarSize: scrollbarSize, isHiddenCell: isHiddenCell, isHiddenColumn: isHiddenColumn, isHiddenRow: isHiddenRow, visibleRowRanges: visibleRowRanges, isHiddenOverlay: isHiddenOverlay, isHiddenBackground: isHiddenBackground, overlayRenderer: cellOverlayRenderer, backgroundRenderer: cellBackgroundRenderer, shadowSettings: shadowSettings, onScroll: handleScroll, onViewPortChange: handleViewPortChange, autoFocus: autoFocus, snap: scrollSnap, scrollThrottleTimeout: scrollThrottleTimeout, preventBrowserDefaultScroll: preventBrowserDefaultScroll, showHeaders: showHeaders, gridChildren: gridChildren, onTouchStart: onTouchStart, onDimensionsChange: onDimensionsChange, extendScrollSize: isTouchDevice || isFirefox, isTouchDevice: isTouchDevice, frozenShadowThickness: frozenShadowThickness, onAfterScrollToCell: onAfterScrollToCell, estimatedRowHeight: defaultRowHeight, estimatedColumnWidth: defaultColumnWidth, footerHeight: footerHeight, footerComponent: footerComponent, getOverflowBuffer: getOverflowBuffer, getFrozenColumnOverflowCells: getFrozenColumnOverflowCells })),
         tooltipComponent,

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

@@ -13,8 +13,8 @@ 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, RemoveDuplicatesOptions, Sheet, SheetCoordinate, SheetProtection, SheetRange, Slicer, SortOrder, SortSpecs, TableTheme, TableView } from "../../types";
-import type { AXIS, CellData, ConditionalFormatRule, EmbeddedChart, FilterView } 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, AutoFillType, CellData, ConditionalFormatRule, EmbeddedChart, FillOptions, FilterView } from "../../types";
 import type { CellProps } from "../cell/typings";
 import type { CellEditorProps } from "../cell-editor";
 import type { StructuredResultProps } from "../cell-structured/types";
@@ -670,8 +670,11 @@ export type CanvasGridProps<T extends CellData = CellData<any, any>> = {
      * @param sheetId
      * @param cell
      * @param selections
+     * @param clearType what to clear — `"contents"` (default; values/formulas, formats kept),
+     * `"formats"`, or `"all"`. A fill-handle drag-back inside the selection clears `"contents"`
+     * (`"all"` with Ctrl), matching Excel.
      */
-    onDelete?(sheetId: number, cell: CellInterface, selections: SelectionArea<SelectionAttributes>[]): void;
+    onDelete?(sheetId: number, cell: CellInterface, selections: SelectionArea<SelectionAttributes>[], clearType?: "all" | "contents" | "formats"): void;
     /**
      * When user changes editor value
      * @param value
@@ -697,8 +700,14 @@ export type CanvasGridProps<T extends CellData = CellData<any, any>> = {
      * Fill
      * @param cell
      * @param selections
+     * @param fillableSelections Optional pre-drag selections (used for undo
+     * bookkeeping by the state layer); the grid passes `undefined`.
+     * @param fillType Explicit fill type — from the Auto Fill Options / right-drag
+     * menu. Omitted for a plain drag (the engine auto-detects).
+     * @param options Modifier held on the handle (`{ modifier: "toggle" }` for
+     * Ctrl/Cmd+drag) and/or the Series dialog's parameters.
      */
-    onFill?(sheetId: number, cell: CellInterface, fillSelection: SelectionArea<SelectionAttributes>, selections: SelectionArea<SelectionAttributes>[]): void;
+    onFill?(sheetId: number, cell: CellInterface, fillSelection: SelectionArea<SelectionAttributes>, selections: SelectionArea<SelectionAttributes>[], fillableSelections?: SelectionArea<SelectionAttributes>[], fillType?: AutoFillType, options?: FillOptions): void;
     /**
      * Callback when user moves a selection
      * @param from
@@ -1527,7 +1536,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
@@ -1536,6 +1545,23 @@ export type CanvasGridProps<T extends CellData = CellData<any, any>> = {
      * @returns
      */
     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