@rowsncolumns/spreadsheet 10.3.0 → 10.4.0

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

@@ -1,11 +1,10 @@
 import { tokenize as defaultFormulaTokenizer } from "@rowsncolumns/calculator";
 import { cellToArea, Direction, isAreasEqual } from "@rowsncolumns/grid";
-import { canUseDOM } from "@rowsncolumns/grid";
+import { canUseDOM, getOwnerDocument } from "@rowsncolumns/grid";
 import { getBoundedCells, MouseButtonCodes } from "@rowsncolumns/grid";
 import { isCellWithinBounds } from "@rowsncolumns/grid";
 import { cellIdentifier, Grid as BaseGrid, isEqualCells, } from "@rowsncolumns/grid";
-import { defaultCellCoords } from "@rowsncolumns/spreadsheet-state";
-import { cn, Skeleton, tryParseRichText } from "@rowsncolumns/ui";
+import { cn, DropdownMenuContent, DropdownMenuPortal, Skeleton, tryParseRichText, } from "@rowsncolumns/ui";
 import { cellToAddress, getCellEffectiveFormat, getContrastColor, getFormulaLocale, isConditionalFormatFormulaRule, isDataValidationFormulaRule, isNil, isNilOrBlank, iterateCellsInRange, localizeCellInput, localizeFormula, localizeFunctionDescriptions, log, resolveDefaultHorizontalAlignment, ssfFormatColor, uuid, } from "@rowsncolumns/utils";
 import { useStore } from "jotai";
 import merge from "lodash/merge";
@@ -13,6 +12,8 @@ import throttle from "lodash/throttle";
 import React, { forwardRef, memo, startTransition, useCallback, useEffect, useMemo, useRef, useState, } from "react";
 import { getBandedCells } from "../../api/banded-ranges";
 import { clearRangeForInsertedBand, formatsForInsertOption, insertedBandHasValues, } from "../../api/insert-options";
+import { keepsCalculatedColumnTag, } from "../../api/calculated-column-fill";
+import { keepsTableAutoExpansionTag, } from "../../api/table-auto-expansion";
 import { CF_INITIAL_WINDOW, cfWindowForViewport, isSameCfWindow, } from "../../api/cf-window";
 import { generateSelectionsFromFormula } from "../../api/selections";
 import { SpreadsheetApi } from "../../api/spreadsheet-api";
@@ -21,7 +22,7 @@ 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, useIsMoveOverwriteConfirmMounted, useIsPasteSpecialDialogMounted, useOpenEvaluateFormulaDialog, useOpenGoToDialog, useOpenMoveOverwriteConfirm, useOpenPasteSpecialDialog, useSetNoteEditorCell, useSetPinnedTooltip, useFillOptionsState, useInsertOptionsState, useOpenFillSeriesDialog, useShowPasteMenu, useShowValidationAlert, } from "../../atoms";
+import { useFormulaModeValue, useIsEvaluateFormulaDialogMounted, useIsGoToDialogMounted, useIsMoveOverwriteConfirmMounted, useIsPasteSpecialDialogMounted, useOpenEvaluateFormulaDialog, useOpenGoToDialog, useOpenMoveOverwriteConfirm, useOpenPasteSpecialDialog, useSetNoteEditorCell, useSetPinnedTooltip, useFillOptionsState, useInsertOptionsState, useTableAutoExpansionState, useCalculatedColumnFillState, 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";
@@ -37,9 +38,12 @@ import { useBorderStyles } from "../../hooks/use-border-styles";
 import { useCallbackRef } from "../../hooks/use-callback-ref";
 import { useCellPopover } from "../../hooks/use-cell-popover";
 import { useCellRenderer } from "../../hooks/use-cell-renderer";
+import { useChartSourceRanges } from "../../hooks/use-chart-source-ranges";
 import { useConditionalFormatting } from "../../hooks/use-conditional-formatting";
 import { DefaultContextMenuWrapper, useContextMenu, } from "../../hooks/use-context-menu";
 import { useContextSetter } from "../../hooks/use-context-setter";
+import { useRevealChartEmbed } from "../../hooks/use-reveal-chart-embed";
+import { useChartClipboard } from "../../hooks/use-chart-clipboard";
 import { useCopyPasteCut } from "../../hooks/use-copy-paste-cut";
 import { useCreateAddressFromSelection } from "../../hooks/use-create-address-from-selection";
 import { useCreateFormulaTokenizer } from "../../hooks/use-create-formula-tokenizer";
@@ -49,6 +53,7 @@ import { useEditorChange } from "../../hooks/use-editor-change";
 import { useEditorKeydown } from "../../hooks/use-editor-keydown";
 import { useEditorSubmit } from "../../hooks/use-editor-submit";
 import { useEmbedsCharts } from "../../hooks/use-embeds-charts";
+import { ChartSheetView } from "../chart-sheet-view";
 import { useExpandCell } from "../../hooks/use-expand-cell";
 import { useExportRange } from "../../hooks/use-export-range";
 import { useFilter } from "../../hooks/use-filter";
@@ -80,6 +85,7 @@ import { useSheetChangeHandler } from "../../hooks/use-sheet-change-handler";
 import { useSizer } from "../../hooks/use-sizer";
 import { useStableRef } from "../../hooks/use-stable-ref";
 import { useOnStructuredReferenceSelection } from "../../hooks/use-structured-reference-selection";
+import { useTableHitZones } from "../../hooks/use-table-hit-zones";
 import { useTableResizer } from "../../hooks/use-table-resizer";
 import { useDelayedValue } from "../../hooks/use-delayed-value";
 import { useTooltip } from "../../hooks/use-tooltip";
@@ -91,6 +97,9 @@ import { fillRangeForSeriesSpec, seedRangeForSeriesSpec } from "../../api/fill-s
 import { Cell as DefaultCell } from "../cell";
 import { CellEditor as DefaultCellEditor } from "../cell-editor";
 import { ContextMenu as DefaultContextMenu } from "../context-menu";
+import { ContextMenuDropdown } from "../context-menu/menu";
+import { StyledContextMenuWrapper } from "../context-menu/style";
+import { TotalRowFunctionMenuItems } from "../context-menu/total-row-function-menu";
 import { FillHandle } from "../fill-handle";
 import { FilterBox as DefaultFilterBox } from "../filter-box";
 import { HeaderCell as DefaultHeaderCell } from "../header-cell";
@@ -105,8 +114,10 @@ import { getNestedPropertyNames } from "./helpers";
  * @param CanvasGridMethods
  * @returns
  */
+/** Where the grid focuses when no cell is given (A1); mirrors spreadsheet-state's `defaultCellCoords` without importing it — that package depends on this one. */
+const defaultCellCoords = { rowIndex: 1, columnIndex: 1 };
 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, formulaLocale: formulaLocaleProp, 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, onInsertCutCells, 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, 
+    const { licenseKey, sheetId, sheetType, ChartSheetView: ChartSheetViewComponent = ChartSheetView, 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, onUpdateChart, onChangeZOrder, 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, formulaLocale: formulaLocaleProp, 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, getSparklineGroup, 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, onChangeAutoExpandTables, onChangeAutoCalculatedColumns, onInsertCellsShiftDown, onInsertCellsShiftRight, onDeleteCellsShiftLeft, onDeleteCellsShiftUp, onClearContents, onMoveColumns, onMoveRows, onSelectNextSheet, onSelectPreviousSheet, onCreateNewSheet, onKeyDown, onChangeFormatting, onRepeatFormatting, onClearFormatting, onRequestEditProtectedRange, onMoveChart, onResizeChart, onDeleteChart, onCutChart, onCopyChart, onMoveEmbed, onResizeEmbed, onDeleteEmbed, onRequestEditEmbed, onMoveSlicer, onResizeSlicer, onDeleteSlicer, onRequestEditSlicer, onFillRange, disableFillRightShortcut, keymap, onCalculateNow, onRequestGoTo, onMoveSelection, onInsertCutCells, onInsertTime, onInsertDate, onInsertDateTime, onInsertAutoSum, onUndo, onRedo, onPaste, onCopy, onCut, onSortColumn, onSortTable, onFilterTable, onFilterPivot, onResizeTable, onUndoTableAutoExpansion, onUndoCalculatedColumn, onOverwriteCalculatedColumn, onRequestEditTable, onRequestEditPivotTable, onRequestDeletePivotTable, onRequestCreatePivotChart, onRemoveTable, onCreateTable, onRequestCreateTable, onInsertTableColumn, onDeleteTableColumn, onInsertTableRow, onDeleteTableRow, onUpdateTable, onRequestResizeTable, onRequestInsertSlicer, 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
@@ -197,6 +208,8 @@ function CanvasGridComponent(props, forwardedRef) {
     // Auto Fill Options smart tag / right-drag fill menu + Series dialog
     const [fillOptions, setFillOptions] = useFillOptionsState();
     const [insertOptions, setInsertOptions] = useInsertOptionsState();
+    const [tableAutoExpansion, setTableAutoExpansion] = useTableAutoExpansionState();
+    const [calculatedColumnFill, setCalculatedColumnFill] = useCalculatedColumnFillState();
     const openFillSeriesDialog = useOpenFillSeriesDialog();
     // Shared state
     const formulaMode = useFormulaModeValue();
@@ -502,6 +515,11 @@ function CanvasGridComponent(props, forwardedRef) {
     const tableHeaderCells = useMemo(() => {
         return getTableHeaderCells(activeTables, basicFilter);
     }, [activeTables, basicFilter]);
+    /** A cell on a table's totals row (its in-cell arrow opens the function picker). */
+    const isTableTotalsCell = useCallback((rowIndex, columnIndex) => !!activeTables?.some((table) => table.totalRow &&
+        rowIndex === table.range.endRowIndex &&
+        columnIndex >= table.range.startColumnIndex &&
+        columnIndex <= table.range.endColumnIndex), [activeTables]);
     /**
      * Retrieve banded cells
      */
@@ -528,6 +546,13 @@ function CanvasGridComponent(props, forwardedRef) {
         lastScheduledScrollRef.current = Date.now();
         gridRef.current?.scrollToCell(cell, align);
     }, []);
+    // Excel scrolls to a chart / picture it has just inserted or restored.
+    const scrollToChart = useRevealChartEmbed({
+        charts,
+        embeds,
+        sheetId,
+        scrollToCell,
+    });
     /**
      * Scroll to bottom of the sheet
      */
@@ -660,10 +685,13 @@ function CanvasGridComponent(props, forwardedRef) {
         // user gesture on the grid focuses the tabIndex=0 container first, so
         // this only suppresses render-driven refocus; a null container ref
         // (mid mount/unmount) falls through to the original focus behavior.
-        const activeElement = canUseDOM ? document.activeElement : null;
+        // The grid may render into a popout window: read focus from its own
+        // document, never from the bundle's global one.
+        const ownerDocument = getOwnerDocument(gridContainerRef.current);
+        const activeElement = ownerDocument?.activeElement ?? null;
         const gridContainer = gridContainerRef.current;
         if (activeElement &&
-            activeElement !== document.body &&
+            activeElement !== ownerDocument?.body &&
             gridContainer &&
             !gridContainer.contains(activeElement)) {
             return;
@@ -689,7 +717,13 @@ function CanvasGridComponent(props, forwardedRef) {
      * position offset
      */
     const getRelativePositionFromOffset = useCallback((x, y) => {
-        return gridRef.current?.getRelativePositionFromOffset(x, y);
+        const grid = gridRef.current;
+        if (grid) {
+            return grid.getRelativePositionFromOffset(x, y);
+        }
+        // A chartsheet mounts no grid; overlays position against the wrapper itself.
+        const rect = gridContainerRef.current?.getBoundingClientRect();
+        return rect ? { x: x - rect.left, y: y - rect.top } : undefined;
     }, []);
     /**
      * Get scroll position
@@ -1112,10 +1146,11 @@ function CanvasGridComponent(props, forwardedRef) {
         // time — `uf.textFormat.underline` is merged on top below, so a user
         // who explicitly sets underline=false still wins.
         const defaultTextFormat = {
-            bold: isTableHeader(rowIndex, columnIndex) &&
-                isTableHeaderThemed(rowIndex, columnIndex)
-                ? true
-                : undefined,
+            bold: bandedCellFormat?.textFormat?.bold ??
+                (isTableHeader(rowIndex, columnIndex) &&
+                    isTableHeaderThemed(rowIndex, columnIndex)
+                    ? true
+                    : undefined),
             fontFamily: theme.primaryFontFamily,
             color: isHyperlink
                 ? theme.themeColors.hyperlink
@@ -1736,7 +1771,8 @@ function CanvasGridComponent(props, forwardedRef) {
         /* Data validation arrow */
         const dataValidation = getDataValidationRule(sheetId, rowIndex, columnIndex);
         const additionalCellSpacing = getAdditionalCellSpacing?.(sheetId, rowIndex, columnIndex) ?? 0;
-        const showArrow = showValidationDropdownArrow(dataValidation);
+        const showArrow = showValidationDropdownArrow(dataValidation) ||
+            isTableTotalsCell(rowIndex, columnIndex);
         const showChip = getCellMetaType(sheetId, rowIndex, columnIndex) === "people";
         const [expandable] = getCellGroupingInfo(sheetId, rowIndex, columnIndex);
         const iconSpacing = DEFAULT_CELL_SPACING;
@@ -1786,6 +1822,7 @@ function CanvasGridComponent(props, forwardedRef) {
         getCellGroupingInfo,
         getAdditionalCellSpacing,
         getEffectiveCellFormat,
+        isTableTotalsCell,
     ]);
     /**
      * Column resizer
@@ -1834,7 +1871,13 @@ function CanvasGridComponent(props, forwardedRef) {
         sheetId,
     ]);
     /* Check if sheet is focused */
-    const isSheetFocused = useCallback(() => canUseDOM ? document.activeElement === cellEditorInstance?.el() : false, [cellEditorInstance]);
+    const isSheetFocused = useCallback(() => {
+        const editorElement = cellEditorInstance?.el();
+        if (!editorElement) {
+            return false;
+        }
+        return getOwnerDocument(editorElement)?.activeElement === editorElement;
+    }, [cellEditorInstance]);
     /**
      * Get Cell Editor
      */
@@ -2112,6 +2155,101 @@ function CanvasGridComponent(props, forwardedRef) {
     useEffect(() => {
         setInsertOptions(null);
     }, [activeCell.rowIndex, activeCell.columnIndex, sheetId, setInsertOptions]);
+    /**
+     * Excel's AutoCorrect smart tag after a table auto-expanded. "Undo Table
+     * AutoExpansion" resizes the table back to its pre-growth range and clears
+     * what the growth wrote (calculated-column formulas, generated headers,
+     * inherited formats) in one undo step — the user's own value stays, like
+     * Excel; "Stop Automatically Expanding Tables" hands the option to the host.
+     */
+    const handleChooseTableAutoExpansionOption = useCallback((option) => {
+        if (!tableAutoExpansion)
+            return;
+        if (option === "undo") {
+            if (onUndoTableAutoExpansion) {
+                onUndoTableAutoExpansion(tableAutoExpansion);
+            }
+            else {
+                const table = tables?.find((candidate) => candidate.id === tableAutoExpansion.tableId &&
+                    candidate.sheetId === tableAutoExpansion.sheetId);
+                if (table) {
+                    onResizeTable?.(tableAutoExpansion.sheetId, table, tableAutoExpansion.previousRange);
+                }
+            }
+        }
+        else {
+            onChangeAutoExpandTables?.(false);
+        }
+        setTableAutoExpansion(null);
+        focusSheet();
+    }, [
+        tableAutoExpansion,
+        tables,
+        onResizeTable,
+        onUndoTableAutoExpansion,
+        onChangeAutoExpandTables,
+        setTableAutoExpansion,
+        focusSheet,
+    ]);
+    // The tag survives the commit's own cursor advance (Enter / Tab) and any cell
+    // of the grown table; moving anywhere else, or switching sheet, drops it.
+    useEffect(() => {
+        if (tableAutoExpansion &&
+            !keepsTableAutoExpansionTag(tableAutoExpansion, sheetId, activeCell)) {
+            setTableAutoExpansion(null);
+        }
+    }, [
+        tableAutoExpansion,
+        activeCell.rowIndex,
+        activeCell.columnIndex,
+        activeCell,
+        sheetId,
+        setTableAutoExpansion,
+    ]);
+    /**
+     * Excel's AutoCorrect smart tag after a formula typed into a table column.
+     * "Undo Calculated Column" reverts the fill alone (the typed cell keeps its
+     * formula); "Overwrite all cells in this column with this formula" fills the
+     * column over the cells that kept it from filling; "Stop automatically
+     * creating calculated columns" hands the option to the host.
+     */
+    const handleChooseCalculatedColumnOption = useCallback((option) => {
+        if (!calculatedColumnFill)
+            return;
+        if (option === "undo") {
+            onUndoCalculatedColumn?.(calculatedColumnFill);
+        }
+        else if (option === "overwrite") {
+            onOverwriteCalculatedColumn?.(calculatedColumnFill);
+        }
+        else {
+            onChangeAutoCalculatedColumns?.(false);
+        }
+        setCalculatedColumnFill(null);
+        focusSheet();
+    }, [
+        calculatedColumnFill,
+        onUndoCalculatedColumn,
+        onOverwriteCalculatedColumn,
+        onChangeAutoCalculatedColumns,
+        setCalculatedColumnFill,
+        focusSheet,
+    ]);
+    // The tag survives the commit's own cursor advance and any cell of the
+    // column; moving anywhere else, or switching sheet, drops it.
+    useEffect(() => {
+        if (calculatedColumnFill &&
+            !keepsCalculatedColumnTag(calculatedColumnFill, sheetId, activeCell)) {
+            setCalculatedColumnFill(null);
+        }
+    }, [
+        calculatedColumnFill,
+        activeCell.rowIndex,
+        activeCell.columnIndex,
+        activeCell,
+        sheetId,
+        setCalculatedColumnFill,
+    ]);
     /**
      * 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
@@ -2241,6 +2379,8 @@ function CanvasGridComponent(props, forwardedRef) {
         isColumnHeader,
         isTouchDevice,
         dataRegionBoundaries,
+        tables,
+        onInsertTableRow,
     });
     /**
      * Copy, Paste and Cut hook
@@ -2254,6 +2394,37 @@ function CanvasGridComponent(props, forwardedRef) {
         onCopy,
         onCut,
     });
+    /**
+     * Ctrl+C / Ctrl+X / Ctrl+V / Ctrl+D on a selected chart. The focused chart is
+     * the target of those events (see `EmbedDraggable`); a paste that lands in the
+     * cell editor while a chart is on the clipboard is claimed here first.
+     */
+    const chartClipboard = useChartClipboard({
+        sheetId,
+        activeCell,
+        charts,
+        readonly,
+        onCreateChart,
+        onDeleteChart,
+        onCopyChart,
+        onCutChart,
+        focusSheet,
+    });
+    const { copyChart, cutChart, pasteChart, duplicateChart, clearChartClipboard } = chartClipboard;
+    const handleEditorCopy = useCallback((e) => {
+        clearChartClipboard();
+        onInternalCopy(e);
+    }, [clearChartClipboard, onInternalCopy]);
+    const handleEditorCut = useCallback((e) => {
+        clearChartClipboard();
+        onInternalCut(e);
+    }, [clearChartClipboard, onInternalCut]);
+    const handleEditorPaste = useCallback((e) => {
+        if (pasteChart(e)) {
+            return;
+        }
+        onInternalPaste(e);
+    }, [pasteChart, onInternalPaste]);
     /**
      * Context menu "Insert Cut Cells" (Excel: Ctrl+X, right-click the destination). A cut of
      * whole rows / columns dropped on a row / column header inserts them BEFORE the clicked
@@ -2490,14 +2661,18 @@ function CanvasGridComponent(props, forwardedRef) {
     });
     /**
      * Get bounds of chart overlay
-     * Within the grid body
+     * Within the grid body: from the first cell's top-left corner to the last
+     * row's bottom edge and last column's right edge, so an object can never be
+     * dragged or resized past the sheet (Excel snaps it back inside).
      */
     const getChartBounds = useCallback(() => {
         return {
             left: getColumnOffset(1),
             top: getRowOffset(1),
+            right: getColumnOffset(columnCount + 1),
+            bottom: getRowOffset(rowCount + 1),
         };
-    }, [getRowOffset, getColumnOffset]);
+    }, [getRowOffset, getColumnOffset, rowCount, columnCount]);
     // Show notes editor
     const onInsertNote = useCallback((sheetId, cell) => {
         setNoteEditorCell({
@@ -2542,11 +2717,38 @@ function CanvasGridComponent(props, forwardedRef) {
         });
         focusSheet();
     }, [setQuickEditState, enableQuickEdit, focusSheet]);
+    /**
+     * Opens the cell editor pre-filled (the totals row's "More Functions…").
+     * `editCell` comes from `useEditable` below; this stable wrapper lets the
+     * context menu reach it.
+     */
+    const requestEditCell = useCallbackRef((targetSheetId, cell, initialValue) => editCell(targetSheetId, cell, initialValue));
+    /**
+     * The context menu's table Select items: replace the selection with a
+     * range and park the active cell at its top-left, without scrolling.
+     */
+    const selectRangeFromMenu = useCallback((targetSheetId, range) => {
+        setActiveCell(targetSheetId, { rowIndex: range.startRowIndex, columnIndex: range.startColumnIndex }, false);
+        onChangeSelections?.(targetSheetId, [{ range }]);
+    }, [setActiveCell, onChangeSelections]);
+    // Excel's table hit zones (header top edge / corner / row left edge).
+    const { cursor: tableHitCursor, onMouseMove: onMouseMoveTableHitZones, onMouseDown: onMouseDownTableHitZones, clearHitZone: clearTableHitZone, } = useTableHitZones({
+        sheetId,
+        tables: activeTables,
+        selections,
+        frozenRows,
+        frozenColumns,
+        getCellCoordsFromOffset,
+        getRelativePositionFromOffset,
+        getCellOffsetFromCoords,
+        getScrollPosition,
+        onSelectRange: selectRangeFromMenu,
+    });
     /**
      * 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: insertRowWithOptions, onInsertColumn: insertColumnWithOptions, rowCount: rowCount, columnCount: columnCount, 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, hasCutSelection: isCutPending && copiedSheetId === sheetId, onInsertCutCells: insertCutCellsFromMenu, 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 }));
+        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: insertRowWithOptions, onInsertColumn: insertColumnWithOptions, rowCount: rowCount, columnCount: columnCount, 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, hasCutSelection: isCutPending && copiedSheetId === sheetId, onInsertCutCells: insertCutCellsFromMenu, 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, onRequestResizeTable: onRequestResizeTable, onRequestInsertSlicer: onRequestInsertSlicer, onRequestEditPivotTable: onRequestEditPivotTable, onRemoveTable: onRemoveTable, onRequestDeletePivotTable: onRequestDeletePivotTable, onRequestCreatePivotChart: onRequestCreatePivotChart, onPivotDrillDown: onPivotDrillDown, onRequestFormatCells: onRequestFormatCells, onRequestConditionalFormat: onRequestConditionalFormat, onRequestDataValidation: onRequestDataValidation, onClearFormatting: onClearFormatting, onCreateTable: onCreateTable, onRequestCreateTable: onRequestCreateTable, onCreateBasicFilter: onCreateBasicFilter, onInsertTableColumn: onInsertTableColumn, onDeleteTableColumn: onDeleteTableColumn, onInsertTableRow: onInsertTableRow, onDeleteTableRow: onDeleteTableRow, onUpdateTable: onUpdateTable, onRequestEditCell: requestEditCell, onSelectRange: selectRangeFromMenu, 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,
@@ -2597,6 +2799,8 @@ function CanvasGridComponent(props, forwardedRef) {
         onFilterTable,
         onSortTable,
         onRequestEditTable,
+        onRequestResizeTable,
+        onRequestInsertSlicer,
         onRequestEditPivotTable,
         onRemoveTable,
         onRequestFormatCells,
@@ -2605,8 +2809,12 @@ function CanvasGridComponent(props, forwardedRef) {
         onRequestDataValidation,
         onCreateBasicFilter,
         onCreateTable,
+        onRequestCreateTable,
         onDeleteTableColumn,
         onInsertTableRow,
+        onUpdateTable,
+        requestEditCell,
+        selectRangeFromMenu,
         getFormattedValue,
         getFormattedValuesFromRange,
         onInsertTableColumn,
@@ -2622,6 +2830,7 @@ function CanvasGridComponent(props, forwardedRef) {
         onChange,
         getCellData,
         onRequestDeletePivotTable,
+        onRequestCreatePivotChart,
         isHiddenColumn,
         isHiddenRow,
         onShowColumn,
@@ -2685,6 +2894,7 @@ function CanvasGridComponent(props, forwardedRef) {
         onUndo,
         onRedo,
         onCreateTable,
+        onRequestCreateTable,
         onCreateBasicFilter,
         clearCopiedSelections,
         onRequestSearch,
@@ -2771,9 +2981,11 @@ function CanvasGridComponent(props, forwardedRef) {
         scrollToCell,
         containerWidth: width,
         containerHeight: height,
-        onCopy: onInternalCopy,
-        onPaste: onInternalPaste,
-        onCut: onInternalCut,
+        onCopy: handleEditorCopy,
+        onPaste: handleEditorPaste,
+        onCut: handleEditorCut,
+        tables,
+        onInsertTableRow,
     });
     /**
      * Move rows and columns
@@ -2916,7 +3128,7 @@ function CanvasGridComponent(props, forwardedRef) {
     /**
      * Displays resizable/draggable charts
      */
-    const { chartComponents, embedComponents, slicerComponents, onMouseDown: onMouseDownCharts, } = useEmbedsCharts({
+    const { chartComponents, embedComponents, slicerComponents, contextMenuComponent: embedContextMenuComponent, onMouseDown: onMouseDownCharts, requestChartContextMenu, } = useEmbedsCharts({
         charts,
         embeds,
         slicers,
@@ -2927,14 +3139,20 @@ function CanvasGridComponent(props, forwardedRef) {
         getCellOffsetFromCoords,
         getAbsolutePositionFromOffset,
         getCellCoordsFromOffset,
+        getRelativePositionFromOffset,
         getScrollPosition,
+        ContextMenuWrapper,
+        focusSheet,
         selectedColor: chartSelectedColor,
         onMoveChart,
         onResizeChart,
+        chartClipboard,
         onMoveEmbed,
         onResizeEmbed,
         onDeleteEmbed,
         onDeleteChart,
+        onUpdateChart,
+        onChangeZOrder,
         onRequestEditEmbed,
         onMoveSlicer,
         onResizeSlicer,
@@ -3004,6 +3222,55 @@ function CanvasGridComponent(props, forwardedRef) {
             onExpandCollapse?.(sheetId, cell, groupKeys, newExpandedState, childrenCount);
         }
     }, [onExpandCollapse, getCellGroupKeys, getChildrenCount]);
+    /**
+     * The totals-function picker a totals cell's in-cell arrow opens (Excel):
+     * anchored at the cell's bottom-right corner like the filter dropdown.
+     */
+    const [totalsPicker, setTotalsPicker] = useState(null);
+    const closeTotalsPicker = useCallback(() => setTotalsPicker(null), []);
+    const handleTotalsArrowClick = useCallback((cell) => {
+        const table = activeTables?.find((candidate) => candidate.totalRow &&
+            cell.rowIndex === candidate.range.endRowIndex &&
+            isCellWithinBounds(cell, candidate.range));
+        const cellPosition = getCellOffsetFromCoords(cell);
+        const scrollPosition = getScrollPosition();
+        if (!table || !cellPosition) {
+            return;
+        }
+        const { x = 0, y = 0, width = 0, height = 0 } = cellPosition;
+        const scrollX = isFrozenColumn(cell.columnIndex)
+            ? 0
+            : scrollPosition.scrollLeft;
+        const scrollY = isFrozenRow(cell.rowIndex) ? 0 : scrollPosition.scrollTop;
+        setActiveCell(sheetId, cell, false);
+        setTotalsPicker({
+            table,
+            cell,
+            left: x + width - scrollX,
+            top: y + height - scrollY,
+        });
+    }, [
+        activeTables,
+        getCellOffsetFromCoords,
+        getScrollPosition,
+        isFrozenColumn,
+        isFrozenRow,
+        setActiveCell,
+        sheetId,
+    ]);
+    const totalsPickerComponent = totalsPicker ? (React.createElement(StyledContextMenuWrapper, { style: {
+            transform: `translate3d(${totalsPicker.left}px, ${totalsPicker.top}px, 0)`,
+        } },
+        React.createElement(ContextMenuDropdown, { isOpen: true, onOpenChange: (open) => {
+                if (!open)
+                    closeTotalsPicker();
+            } },
+            React.createElement(DropdownMenuPortal, null,
+                React.createElement(DropdownMenuContent, { align: "end", sideOffset: 0, onCloseAutoFocus: (event) => {
+                        event.preventDefault();
+                        focusSheet();
+                    }, onMouseMove: (e) => e.stopPropagation() },
+                    React.createElement(TotalRowFunctionMenuItems, { sheetId: sheetId, table: totalsPicker.table, cell: totalsPicker.cell, readonly: readonly, getCellData: getCellData, onChange: onChange, onClearContents: onClearContents, onUpdateTable: onUpdateTable, onRequestEditCell: requestEditCell })))))) : null;
     /**
      * Capture mouse move events
      */
@@ -3014,8 +3281,10 @@ function CanvasGridComponent(props, forwardedRef) {
             isDraggingHeader ||
             isSelectionInProgress ||
             isFilling) {
+            clearTableHitZone();
             return;
         }
+        onMouseMoveTableHitZones(e);
         const coords = getCellCoordsFromOffset(e.clientX, e.clientY);
         if (!coords || isEqualCells(hoveredCellRef.current, coords)) {
             return;
@@ -3029,6 +3298,8 @@ function CanvasGridComponent(props, forwardedRef) {
         isSelectionInProgress,
         isFilling,
         hoveredCellRef,
+        onMouseMoveTableHitZones,
+        clearTableHitZone,
     ]);
     // Mouse move throttler
     const mouseMoveThrottler = useCallbackRef(throttle(handleMouseMove, mouseMoveThrottleTimeout, {
@@ -3065,8 +3336,12 @@ function CanvasGridComponent(props, forwardedRef) {
                 selectionMode: "append",
             }));
         }
-        // Pass it on to use selection hook
-        onMouseDownSelection(e);
+        // A table hit zone (header edge / corner / row edge) selects the table
+        // part instead of starting a cell selection.
+        if (!onMouseDownTableHitZones(e)) {
+            // Pass it on to use selection hook
+            onMouseDownSelection(e);
+        }
         // Charts
         onMouseDownCharts?.();
         /**
@@ -3078,6 +3353,7 @@ function CanvasGridComponent(props, forwardedRef) {
         }
         // Hide filter
         hideFilter();
+        closeTotalsPicker();
         // Hide popover
         hideCellPopover();
         // Hide paste mnenu
@@ -3088,8 +3364,10 @@ function CanvasGridComponent(props, forwardedRef) {
         onUnpinTooltip();
     }, [
         onMouseDownSelection,
+        onMouseDownTableHitZones,
         onRequestCloseContextMenu,
         hideFilter,
+        closeTotalsPicker,
         onMouseDownCharts,
         formulaMode,
         setFormulaState,
@@ -3215,6 +3493,8 @@ function CanvasGridComponent(props, forwardedRef) {
      */
     const [cellBackgroundRenderer, cellRenderer, cellOverlayRenderer, headerCellRenderer,] = useCellRenderer({
         sheetId,
+        isTableTotalsCell,
+        onTotalsArrowClick: handleTotalsArrowClick,
         formulaLocale,
         showGridLines,
         scale,
@@ -3253,6 +3533,7 @@ function CanvasGridComponent(props, forwardedRef) {
         getNote,
         getComment,
         getEffectiveValue,
+        getSparklineGroup,
         getFormattedValue,
         getCellImageUrl,
         getEffectiveCellFormat,
@@ -3324,6 +3605,20 @@ function CanvasGridComponent(props, forwardedRef) {
         scrollToCell,
         tokenizer: localeTokenizer,
     });
+    /**
+     * Selected chart: outline its source ranges on this sheet and re-bind
+     * them when a corner handle is dragged (Excel's chart data highlight).
+     */
+    const { chartSourceBorderStyles, onMouseDownChartSourceResizeHandle } = useChartSourceRanges({
+        charts,
+        sheetId,
+        getSheetName,
+        readonly,
+        onUpdateChart,
+        getCellBounds,
+        getCellCoordsFromOffset,
+        scrollToCell,
+    });
     /**
      * Hide fill handle
      * 1. When user is in edit mode
@@ -3356,6 +3651,7 @@ function CanvasGridComponent(props, forwardedRef) {
         isFillShrink: fillShrink !== undefined,
         onSelectionMouseDown: onSelectionElementMouseDown,
         onMouseDownResizeHandle: onMouseDownResizeHandle,
+        onMouseDownChartSourceResizeHandle,
         onMouseDownMoveSelection: onMouseDownMoveSelection,
         isDraggingMoveSelection: isDraggingMoveSelection,
         onChangeActiveCell,
@@ -3388,6 +3684,12 @@ function CanvasGridComponent(props, forwardedRef) {
         onCloseFillOptions: handleCloseFillOptions,
         insertOptions,
         onChooseInsertOption: handleChooseInsertOption,
+        tableAutoExpansion,
+        canStopAutoExpandingTables: !!onChangeAutoExpandTables,
+        onChooseTableAutoExpansionOption: handleChooseTableAutoExpansionOption,
+        calculatedColumnFill,
+        canStopAutoCalculatedColumns: !!onChangeAutoCalculatedColumns,
+        onChooseCalculatedColumnOption: handleChooseCalculatedColumnOption,
         hoveredCell: delayedHoveredCell,
         onRemoveQuickEdit,
         onAddQuickEdit,
@@ -3422,6 +3724,10 @@ function CanvasGridComponent(props, forwardedRef) {
         agentSuggestions,
         quickEditValues,
     });
+    // A selected chart's source outlines draw on top of the other range borders.
+    const gridBorderStyles = useMemo(() => chartSourceBorderStyles.length
+        ? [...finalBorderStyles, ...chartSourceBorderStyles]
+        : finalBorderStyles, [finalBorderStyles, chartSourceBorderStyles]);
     // Hidden column markers
     const [hiddenColumnMarkers, frozenHiddenColumnMarkers, hiddenRowMarkers, frozenHiddenRowMarkers,] = useHiddenDimensionMarkers({
         sheetId,
@@ -3549,6 +3855,7 @@ function CanvasGridComponent(props, forwardedRef) {
         getNextFocusableCell,
         onEditorKeyDown,
         scrollToCell,
+        scrollToChart,
         scrollToBottom,
         focusSheet,
         canEditCell,
@@ -3692,7 +3999,7 @@ function CanvasGridComponent(props, forwardedRef) {
                 // Keep focus back on sheet
                 // Check if user is focused on the context menu
                 if (canUseDOM &&
-                    document.activeElement?.getAttribute("role") !== "menu") {
+                    getOwnerDocument(gridContainerRef.current)?.activeElement?.getAttribute("role") !== "menu") {
                     focusSheet();
                 }
             }
@@ -3708,6 +4015,10 @@ function CanvasGridComponent(props, forwardedRef) {
             scrollToCell,
             commit,
             openFillSeriesDialog: () => openFillSeriesDialogForRef.current?.(),
+            copyChart,
+            cutChart,
+            pasteChart,
+            duplicateChart,
         };
         setSpreadsheetApi(new SpreadsheetApi(propsReferenceRef, stableMethods, store, instanceStore, instanceId));
     }, []);
@@ -3772,6 +4083,13 @@ function CanvasGridComponent(props, forwardedRef) {
      * in formula mode
      */
     const enableSelectionDrag = !isSelectionInProgress && !isEditInProgress && !formulaMode;
+    // A chartsheet IS its chart: no grid, headers, editor or cell menus — only the chart and its
+    // context menu (Excel).
+    if (sheetType === "chartsheet") {
+        return (React.createElement("div", { className: cn("rnc-canvas-wrapper after:box-border before:box-border [&_*]:box-border flex min-h-0 min-w-0 relative z-[1] flex-1 bg-rnc-background", className), ref: gridContainerRef, role: "application", "aria-label": "Chart sheet", ...rest },
+            React.createElement(ChartSheetViewComponent, { sheetId: sheetId, chart: charts?.find((chart) => chart.position?.sheetId === sheetId), width: width, height: height, theme: theme, backgroundColor: cellBackgroundColor, readonly: readonly, getChartComponent: getChartComponent, onDeleteChart: onDeleteChart, onUpdateChart: onUpdateChart, onRequestContextMenu: requestChartContextMenu }),
+            embedContextMenuComponent));
+    }
     return (React.createElement("div", { className: cn("rnc-canvas-wrapper after:box-border before:box-border [&_*]:box-border flex min-h-0 min-w-0 relative z-[1] flex-1 bg-rnc-background", className), ref: gridContainerRef, 
         // The grid paints to <canvas>, so there is no per-cell DOM for a screen
         // reader to traverse. role="application" passes keystrokes through to our
@@ -3786,11 +4104,11 @@ function CanvasGridComponent(props, forwardedRef) {
         // Bind to outer container, so it always takes
         // priority over other components
         // generated by hooks
-        onMouseMove: mouseMoveThrottler, onWheel: onMouseWheel, ...rest },
+        onMouseMove: mouseMoveThrottler, onWheel: onMouseWheel, ...rest, style: tableHitCursor ? { ...rest.style, cursor: tableHitCursor } : rest.style },
         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: fillShrinkOverlay ?? 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: gridBorderStyles, 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,
@@ -3798,7 +4116,9 @@ function CanvasGridComponent(props, forwardedRef) {
         draggableColumns,
         draggableRows,
         contextMenuComponent,
+        embedContextMenuComponent,
         filterComponent,
+        totalsPickerComponent,
         headerResizer,
         validatorResult,
         React.createElement("div", { "aria-live": "polite", "aria-atomic": "true", style: {