@rowsncolumns/spreadsheet-state 28.0.76 → 29.1.0

package/dist/esm/hooks/use-spreadsheet-state.js

@@ -4,15 +4,20 @@ import { createNewSheet, DEFAULT_COLUMN_COUNT, DEFAULT_ROW_COUNT, useGetCellDime
 import { useFonts } from "@rowsncolumns/spreadsheet";
 import { getBandedCells } from "@rowsncolumns/spreadsheet";
 import { defaultSpreadsheetTheme, useCallbackRef, useSpreadsheetTheme, } from "@rowsncolumns/spreadsheet";
-import { findMatchingBandProperty, getCurrentLocale, isNil, setDefaultEnableAtFormula, uuid, } from "@rowsncolumns/utils";
+import { findMatchingBandProperty, getCurrentLocale, getFormulaLocale, isNil, setDefaultEnableAtFormula, uuid, } from "@rowsncolumns/utils";
 import { enableMapSet, enablePatches, setUseStrictShallowCopy } from "immer";
-import { useCallback, useEffect, useMemo, useRef } from "react";
+import { useCallback, useEffect, useMemo, useRef, useState } from "react";
 import { getAutoFillValues as defaultGetAutoFillValues } from "../api/fill";
+import { planInsertCutCells } from "../api/insert-cut-cells";
+import { getMoveRangeRefusal } from "../api/structural-guards";
+import { findPartiallyCoveredMerge, MERGED_CELL_MOVE_ERROR } from "../api/merges";
+import { useShowError } from "../atoms/error-state.atom";
 import { getGeneratedSheetName } from "../generated-names";
 import { SheetCell } from "../sheet-cell";
 import { useCalculation } from "./use-calculation";
 import { useCalculationInitialize } from "./use-calculation-initialize";
 import { useCalculationWorker } from "./use-calculation-worker";
+import { SHEET_PROTECTION_ERROR_TITLE, useCanEditCellRange, useCanPerformSheetAction, } from "./use-can-edit-cellrange";
 import { useCellXfsRegistry } from "./use-cellxfs-registry";
 import { useCitations } from "./use-citations";
 import { useComments } from "./use-comments";
@@ -31,6 +36,7 @@ import { useOnChangeBatchStream } from "./use-on-change-batch-stream";
 import { useOnChangeDecimals } from "./use-on-change-decimals";
 import { useOnChangeFormatting } from "./use-on-change-formatting";
 import { useOnChangeSheetTabcolor } from "./use-on-change-sheet-tabcolor";
+import { useOnChangeTableColumn } from "./use-on-change-table-column";
 import { useOnChangeTheme } from "./use-on-change-theme";
 import { useOnClearFormatting } from "./use-on-clear-formatting";
 import { useOnCollapseColumnGroup } from "./use-on-collapse-column-group";
@@ -49,6 +55,7 @@ import { useOnDeleteTableRow } from "./use-on-delete-table-row";
 import { useOnDragnDrop } from "./use-on-drag-n-drop";
 import { useOnDuplicateSheet } from "./use-on-duplicate-sheet";
 import { useOnEmbeds } from "./use-on-embeds";
+import { useSparklineGroups } from "./use-sparkline-groups";
 import { useOnExpandColumnGroup } from "./use-on-expand-column-group";
 import { useOnExpandRowGroup } from "./use-on-expand-row-group";
 import { useOnFill } from "./use-on-fill";
@@ -85,16 +92,20 @@ import { useOnMoveRows } from "./use-on-move-rows";
 import { useOnMoveSelection } from "./use-on-move-selection";
 import { useOnMoveSheet } from "./use-on-move-sheet";
 import { useOnPaste } from "./use-on-paste";
+import { useOnCreateCustomTableStyle } from "./use-on-create-custom-table-style";
 import { useOnProtectRange } from "./use-on-protect-range";
 import { useOnProtectSheet } from "./use-on-protect-sheet";
 import { useOnRemoveDuplicates } from "./use-on-remove-duplicates";
 import { useOnRenameSheet } from "./use-on-rename-sheet";
 import { useOnRequestCalculateWrapper } from "./use-on-request-calculate-wrapper";
 import { useOnRequestConditionalFormat } from "./use-on-request-conditional-format";
+import { useOnRequestCreateTable } from "./use-on-request-create-table";
 import { useOnRequestDataValidation } from "./use-on-request-data-validation";
 import { useOnRequestDefineNamedRange } from "./use-on-request-define-named-range";
 import { useOnRequestDeleteSheet } from "./use-on-request-delete-sheet";
 import { useOnRequestEditTable } from "./use-on-request-edit-table";
+import { useOnRequestInsertSlicer } from "./use-on-request-insert-slicer";
+import { useOnRequestResizeTable } from "./use-on-request-resize-table";
 import { useOnRequestFormatCells } from "./use-on-request-format-cells";
 import { useOnRequestInsertImage } from "./use-on-request-insert-image";
 import { useOnRequestInsertLink } from "./use-on-request-insert-link";
@@ -102,6 +113,9 @@ import { useOnRequestResize } from "./use-on-request-resize";
 import { useOnRequestUpdateNamedRange } from "./use-on-request-update-named-range";
 import { useOnResize } from "./use-on-resize";
 import { useOnResizeTable } from "./use-on-resize-table";
+import { useOnUndoTableAutoExpansion } from "./use-on-undo-table-auto-expansion";
+import { useOnUndoCalculatedColumn } from "./use-on-undo-calculated-column";
+import { useOnChangeCalculatedColumn } from "./use-on-change-calculated-column";
 import { useOnSetOutlineDepth } from "./use-on-set-outline-depth";
 import { useOnShowColumn } from "./use-on-show-column";
 import { useOnShowRow } from "./use-on-show-row";
@@ -154,13 +168,20 @@ export const deriveBuiltInTableBanding = (table) => {
         return undefined;
     }
     if (!showRowStripes && banded.rowProperties) {
-        const { headerColor, headerBorder, totalRowColor, totalRowBorder } = banded.rowProperties;
-        if (headerColor || headerBorder || totalRowColor || totalRowBorder) {
+        const { headerColor, headerBorder, totalRowColor, totalRowBorder, firstColumnColor, lastColumnColor, } = banded.rowProperties;
+        if (headerColor ||
+            headerBorder ||
+            totalRowColor ||
+            totalRowBorder ||
+            firstColumnColor ||
+            lastColumnColor) {
             banded.rowProperties = {
                 headerColor,
                 headerBorder,
                 totalRowColor,
                 totalRowBorder,
+                firstColumnColor,
+                lastColumnColor,
             };
         }
         else {
@@ -175,6 +196,15 @@ export const deriveBuiltInTableBanding = (table) => {
     }
     return banded;
 };
+/**
+ * `table` as the gallery's hovered style would leave it: the preview's theme and banding replace
+ * the table's own (a preview with neither paints it unstyled — the "None" style).
+ */
+export const previewTableStyle = (table, preview) => ({
+    ...table,
+    theme: preview.theme ?? undefined,
+    bandedRange: preview.bandedRange ?? undefined,
+});
 /**
  * Use Spreadsheet Hook
  * @param param0
@@ -206,7 +236,7 @@ onChangeHistory,
 // Semantic command stream
 onCommand: onCommandProp, 
 // Theme
-onChangeTheme, namedCellStyles, onChangeNamedCellStyles, 
+onChangeTheme, namedCellStyles, onChangeNamedCellStyles, customTableStyles, onChangeCustomTableStyles, 
 // error handler
 onError, 
 // Get auto fill values
@@ -223,11 +253,11 @@ colorMode,
 // on-demand
 fonts, 
 // Drag and drop
-enableDragnDrop = true, 
+enableDragnDrop = true, autoExpandTables = true, autoCalculatedColumns = true, 
 // Enable undo/redo functionality
 enabledUndoRedo = true, 
 // Current locale
-locale = getCurrentLocale(), 
+locale = getCurrentLocale(), formulaLocale: formulaLocaleProp, 
 // Templates for auto-generated names (sheets, tables, table columns)
 generatedNames: generatedNamesProp, enableAtFormula = false, 
 // Preserve data formatting like color, font style on paste
@@ -368,17 +398,28 @@ sanitizeHtml, }) => {
      * built-in table styles persist only the name, and the grid paints tables
      * exclusively from bandedRange, so without the fallback they render unstyled.
      */
+    const [tableStylePreview, setTableStylePreview] = useState(null);
+    // The gallery's hovered style paints over the table's own while the pointer rests on the
+    // swatch — UI state only, never written to the table or its history.
+    const onPreviewTableStyle = useCallback((preview) => setTableStylePreview(preview), []);
     const bandedRanges = useMemo(() => {
         return tables
             ?.filter(({ sheetId }) => sheetId === activeSheetId)
             .map((table) => {
-            const banded = table.bandedRange ??
-                deriveBuiltInTableBanding(table);
+            const previewed = tableStylePreview?.sheetId === table.sheetId &&
+                tableStylePreview.tableId === table.id
+                ? previewTableStyle(table, tableStylePreview)
+                : table;
+            const banded = previewed.bandedRange ??
+                deriveBuiltInTableBanding(previewed);
             if (isNil(banded)) {
                 return undefined;
             }
             return {
-                bandedRangeId: `${table.id}-${table.theme}`,
+                bandedRangeId: `${table.id}-${previewed.theme}`,
+                showFirstColumn: table.showFirstColumn,
+                showLastColumn: table.showLastColumn,
+                totalRow: table.totalRow ?? false,
                 // Add sheet Id to range
                 range: {
                     ...table.range,
@@ -388,7 +429,7 @@ sanitizeHtml, }) => {
             };
         })
             .filter((band) => !isNil(band));
-    }, [tables, activeSheetId]);
+    }, [tables, activeSheetId, tableStylePreview]);
     const getCellDimensions = useGetCellDimensions();
     const getCurrentRowHeight = useGetRowHeight();
     const getContentfulRangeAroundCell = useGetContentfulRangeAroundCell();
@@ -400,7 +441,7 @@ sanitizeHtml, }) => {
     const getPrecedentsRef = useRef(undefined);
     const getPrecedentsForward = useCallback((cell) => getPrecedentsRef.current?.(cell) ?? [], []);
     // Sheet properties
-    const { getDataRowCount, getNonEmptyRowCount, getNonEmptyColumnCount, getDataColumnCount, getSheetId, getSheetName, getSheetCount, getSheetIndex, getSheetNames, getSheetProperties, getCellData, getMentionsFromCell, getTextFormatRuns, getEffectiveValue, getEffectiveValueForCalculation, getUserEnteredValue, getUserEnteredValueStable, getConditionalFormatFormula, getDataValidationFormula, getDataValidation, getDefaultHorizontalAlignment, getDataValidationById, getActiveSheetId, getUserEnteredFormat, getEffectiveFormat, getFormattedValue, getFormulaValue, getSeriesValuesFromRange, getFormattingFromRange, getUserEnteredValuesFromRange, getFormulasFromRange, getDomainValuesFromRange, getColumnarDataFromRange, isColumnHidden, isHiddenRow, isHiddenByFilterRow, getRowOutlineLevel, getSheetRowCount, getSheetColumnCount, getColumnWidth, getRowHeight, getEffectiveExtendedValue, getUserEnteredExtendedValue, getFrozenRowCount, getErrorValue, } = useSheetProperties({
+    const { getDataRowCount, getNonEmptyRowCount, getNonEmptyColumnCount, getDataColumnCount, getSheetId, getSheetName, getSheetCount, getSheetIndex, getSheetNames, getSheetProperties, getCellData, getMentionsFromCell, getTextFormatRuns, getEffectiveValue, getEffectiveValueForCalculation, getUserEnteredValue, getUserEnteredValueStable, getConditionalFormatFormula, getDataValidationFormula, getDataValidation, getDefaultHorizontalAlignment, getDataValidationById, getActiveSheetId, getUserEnteredFormat, getEffectiveFormat, getFormattedValue, getFormulaValue, getSeriesValuesFromRange, getFormattingFromRange, getUserEnteredValuesFromRange, getFormulasFromRange, getDomainValuesFromRange, getColumnarDataFromRange, isColumnHidden, isHiddenRow, isHiddenByFilterRow, isManuallyHiddenRow, getRowOutlineLevel, getSheetRowCount, getSheetColumnCount, getColumnWidth, getRowHeight, getEffectiveExtendedValue, getUserEnteredExtendedValue, getFrozenRowCount, getErrorValue, } = useSheetProperties({
         getEffectiveStructuredValue,
         conditionalFormats,
         sheetData,
@@ -596,6 +637,7 @@ sanitizeHtml, }) => {
         onChangeConditionalFormats,
         onChangeDataValidations,
         onChangeProtectedRanges,
+        onChangeCustomTableStyles,
         onChangePivotTables,
         onChangeCellXfs,
         onChangeTheme,
@@ -606,7 +648,7 @@ sanitizeHtml, }) => {
         clearRangeCache,
     });
     // Undo manager
-    const { createHistory, createHistoryWithoutPointer, onRedo, onUndo, canUndo, canRedo, onClearHistory, } = useUndoRedo({
+    const { createHistory, createHistoryWithoutPointer, batchHistory, onRedo, onUndo, canUndo, canRedo, onClearHistory, } = useUndoRedo({
         isEnabled: enabledUndoRedo,
         onUndoAction,
         onRedoAction,
@@ -643,6 +685,14 @@ sanitizeHtml, }) => {
         createHistory,
         onChangeSheetData,
         onChangeSheets,
+        onChangeCharts,
+        onChangeEmbeds,
+        onChangeSlicers,
+        onChangeTables,
+        onChangeConditionalFormats,
+        onChangeDataValidations,
+        onChangeNamedRanges,
+        onChangeProtectedRanges,
         onChangeActiveSheet,
         enqueueGraphOperation,
         onCommand,
@@ -816,16 +866,22 @@ sanitizeHtml, }) => {
         isMergedCell,
         onChangeSheetData,
         onChangeTables,
+        onChangeCharts,
         onChangeSheets,
         enqueueCalculation,
         enqueueGraphOperation,
         createHistory,
+        batchHistory,
+        autoExpandTables,
+        autoCalculatedColumns,
         getDependents,
+        getGraphNodes,
         getUserEnteredValue: getUserEnteredValueStable,
         getTextFormatRuns,
         getSheetName,
         onCommand,
         generatedNames,
+        onRequestCalculate: onRequestCalculateWithoutFormatting,
     });
     // onChange batch
     const onChangeBatch = useOnChangeBatch({
@@ -841,12 +897,16 @@ sanitizeHtml, }) => {
         onChangeSheetData,
         onChangeSheets,
         onChangeTables,
+        onChangeCharts,
         getFormattedValue,
         getCellDimensions,
         getRowHeight: getCurrentRowHeight,
         isMergedCell,
         tables,
         createHistory,
+        batchHistory,
+        autoExpandTables,
+        autoCalculatedColumns,
         onChangeCitations,
         onCommand,
         generatedNames,
@@ -870,8 +930,17 @@ sanitizeHtml, }) => {
         onChangeActiveCell,
         isArrayFormula,
         getRowHeight: getCurrentRowHeight,
+        tables,
+        generatedNames,
         onCommand,
     });
+    // Excel sparkline groups (runs of =SPARKLINE() cells sharing one option set)
+    const { getSparklineGroup, getSparklineAt, onCreateSparklineGroup, onUpdateSparklineGroup, onDeleteSparklineGroup, onClearSparklines, onGroupSparklines, } = useSparklineGroups({
+        onChangeBatch,
+        onDelete,
+        batchHistory,
+        getUserEnteredValue: getUserEnteredValueStable,
+    });
     // Formatting change
     const { onChangeFormatting, onChangeBorder, onRepeatFormatting } = useOnChangeFormatting({
         locale,
@@ -891,6 +960,7 @@ sanitizeHtml, }) => {
     const { onMergeCells, onUnMergeCells } = useOnMergeUnMergeCells({
         locale,
         merges,
+        tables,
         cellXfsRegistry,
         sharedStringRegistry,
         onChangeSelections,
@@ -915,6 +985,9 @@ sanitizeHtml, }) => {
                 continue;
             bands.push({
                 bandedRangeId: `${table.id}-${table.theme}`,
+                showFirstColumn: table.showFirstColumn,
+                showLastColumn: table.showLastColumn,
+                totalRow: table.totalRow ?? false,
                 range: { ...table.range, sheetId },
                 ...banded,
             });
@@ -960,6 +1033,8 @@ sanitizeHtml, }) => {
         onCommand,
     });
     // Locale change - regenerate formatted values and normalize validation rules
+    // The formula syntax the editors speak — Excel follows the user's language, so `locale` by default.
+    const formulaLocale = useMemo(() => getFormulaLocale(formulaLocaleProp ?? locale), [formulaLocaleProp, locale]);
     const onChangeLocale = useOnLocaleChange({
         cellXfsRegistry,
         sharedStringRegistry,
@@ -1008,6 +1083,21 @@ sanitizeHtml, }) => {
         // `onMergeCells` clears the selection; the filled range stays selected like Excel.
         onChangeSelections?.(sheetId, [{ range: selectRange }]);
     }, [onUnMergeCells, onMergeCells, onChangeSelections]);
+    // The expansion the fill handle triggers when dragged past a table's edge (T-11).
+    const onFillChangeTableColumn = useOnChangeTableColumn({
+        locale,
+        cellXfsRegistry,
+        sharedStringRegistry,
+        onChangeSheetData,
+        onChangeTables,
+        getDependents,
+        enqueueCalculation: enqueueGraphOperation,
+        enqueueGraphOperation,
+        createHistory,
+        onCommand,
+        generatedNames,
+        tables,
+    });
     const onFill = useOnFill({
         locale,
         cellXfsRegistry,
@@ -1026,6 +1116,11 @@ sanitizeHtml, }) => {
         onCommand,
         getMerges: getPaintMerges,
         onFillMerges,
+        tables,
+        getUserEnteredValue: getUserEnteredValueStable,
+        onChangeTableColumn: onFillChangeTableColumn,
+        batchHistory,
+        autoExpandTables,
     });
     // Delete row
     const onDeleteRow = useOnDeleteRow({
@@ -1054,6 +1149,7 @@ sanitizeHtml, }) => {
         onChangePivotTables,
         onChangeNamedRanges,
         onChangeEmbeds,
+        onChangeSlicers,
         onChangeCharts,
         onChangeProtectedRanges,
         getSheetName,
@@ -1088,6 +1184,7 @@ sanitizeHtml, }) => {
         onChangePivotTables,
         onChangeNamedRanges,
         onChangeEmbeds,
+        onChangeSlicers,
         onChangeCharts,
         onChangeProtectedRanges,
         getSheetName,
@@ -1114,6 +1211,7 @@ sanitizeHtml, }) => {
         onChangeSheetData,
         onChangeTables,
         onChangeCitations,
+        onChangeCharts,
         onCommand,
         sheetData,
         sheets,
@@ -1138,6 +1236,7 @@ sanitizeHtml, }) => {
         onChangeSheetData,
         onChangeTables,
         onChangeCitations,
+        onChangeCharts,
         onCommand,
         sheetData,
         sheets,
@@ -1162,6 +1261,7 @@ sanitizeHtml, }) => {
         onChangeSheetData,
         onChangeTables,
         onChangeCitations,
+        onChangeCharts,
         onCommand,
         sheetData,
         sheets,
@@ -1186,6 +1286,7 @@ sanitizeHtml, }) => {
         onChangeSheetData,
         onChangeTables,
         onChangeCitations,
+        onChangeCharts,
         onCommand,
         sheetData,
         sheets,
@@ -1216,6 +1317,7 @@ sanitizeHtml, }) => {
         onChangePivotTables,
         onChangeNamedRanges,
         onChangeEmbeds,
+        onChangeSlicers,
         onChangeCharts,
         onChangeProtectedRanges,
         onChangeTables,
@@ -1248,6 +1350,7 @@ sanitizeHtml, }) => {
         onChangePivotTables,
         onChangeNamedRanges,
         onChangeEmbeds,
+        onChangeSlicers,
         onChangeCharts,
         onChangeProtectedRanges,
         getActiveCell,
@@ -1271,6 +1374,7 @@ sanitizeHtml, }) => {
         onChangeSheetData,
         onChangeConditionalFormats,
         onChangeDataValidations,
+        onChangeCharts,
         getDependents,
         getDataRowCount,
         onCommand,
@@ -1289,6 +1393,7 @@ sanitizeHtml, }) => {
         onChangeSheetData,
         onChangeTables,
         onChangeNamedRanges,
+        onChangeCharts,
         onChangeConditionalFormats,
         onChangeDataValidations,
         getDependents,
@@ -1299,6 +1404,7 @@ sanitizeHtml, }) => {
     const onMoveSelection = useOnMoveSelection({
         rowCount,
         columnCount,
+        getSheetMerges: getPaintMerges,
         enqueueGraphOperation,
         enqueueCalculation,
         enqueueStructureChange,
@@ -1307,6 +1413,7 @@ sanitizeHtml, }) => {
         onChangeSheets,
         onChangeTables,
         onChangeNamedRanges,
+        onChangeCharts,
         onChangeDataValidations,
         onChangeConditionalFormats,
         onChangePivotTables,
@@ -1319,6 +1426,86 @@ sanitizeHtml, }) => {
         sharedStringRegistry,
         onCommand,
     });
+    // Excel "Insert Cut Cells" / Shift+drag for a cell range, as the three structural steps the
+    // hooks above own (`planInsertCutCells`): open the destination band, move the block into the
+    // opening, close the gap it left — so Shift+drag A5 to A2 over r1..r6 gives r1 r5 r2 r3 r4 r6 and
+    // a forward move lands before Excel's pre-removal reference row. The refusals are decided up
+    // front — a merge the block or a shifted band covers only partially, a protected range — so a
+    // refused move never leaves the band opened. The three steps record ONE undo entry.
+    const showError = useShowError();
+    const canEditCellRange = useCanEditCellRange();
+    const canPerformSheetAction = useCanPerformSheetAction();
+    const onInsertCutCells = useCallback((sheetId, from, to) => {
+        const plan = planInsertCutCells(from.range, to.range);
+        if (!plan) {
+            return;
+        }
+        const merges = getPaintMerges(sheetId);
+        if ([from.range, to.range, ...plan.bands].some((range) => findPartiallyCoveredMerge(range, merges))) {
+            showError({ message: MERGED_CELL_MOVE_ERROR });
+            return;
+        }
+        // A block covering part of a table never moves (T-46) — refused before the band opens.
+        const tableRefusal = getMoveRangeRefusal({
+            sheetId,
+            from: from.range,
+            to: to.range,
+            tables,
+        });
+        if (tableRefusal) {
+            showError({ title: tableRefusal.title, message: tableRefusal.message });
+            return;
+        }
+        const vertical = plan.shift === "down";
+        if (!canEditCellRange(sheetId, from.range) ||
+            !canEditCellRange(sheetId, to.range) ||
+            !canPerformSheetAction(sheetId, vertical ? "insertRows" : "insertColumns") ||
+            !canPerformSheetAction(sheetId, vertical ? "deleteRows" : "deleteColumns")) {
+            showError({
+                title: SHEET_PROTECTION_ERROR_TITLE,
+                message: "You can't move cells on a protected sheet.",
+            });
+            return;
+        }
+        const target = {
+            rowIndex: to.range.startRowIndex,
+            columnIndex: to.range.startColumnIndex,
+        };
+        const source = {
+            ...from,
+            range: plan.shiftedSource,
+        };
+        const vacated = {
+            rowIndex: plan.shiftedSource.startRowIndex,
+            columnIndex: plan.shiftedSource.startColumnIndex,
+        };
+        batchHistory(() => {
+            if (vertical) {
+                onInsertCellsShiftDown(sheetId, target, [to]);
+            }
+            else {
+                onInsertCellsShiftRight(sheetId, target, [to]);
+            }
+            onMoveSelection(sheetId, source, to);
+            if (vertical) {
+                onDeleteCellsShiftUp(sheetId, vacated, [source]);
+            }
+            else {
+                onDeleteCellsShiftLeft(sheetId, vacated, [source]);
+            }
+        });
+    }, [
+        batchHistory,
+        getPaintMerges,
+        showError,
+        canEditCellRange,
+        canPerformSheetAction,
+        onInsertCellsShiftDown,
+        onInsertCellsShiftRight,
+        onDeleteCellsShiftUp,
+        onDeleteCellsShiftLeft,
+        onMoveSelection,
+    ]);
     // Sort column
     const onSortColumn = useOnSortColumn({
         rowCount,
@@ -1326,11 +1513,15 @@ sanitizeHtml, }) => {
         locale,
         sharedStringRegistry,
         onChangeSheetData,
+        onChangeSheets,
         enqueueCalculation,
         enqueueStructureChange,
         enqueueGraphOperation,
         createHistory,
+        getCellData,
+        getDataRowCount,
         isHiddenRow,
+        isManuallyHiddenRow,
         getDependents,
         getFrozenRowCount,
         getSheetName,
@@ -1346,12 +1537,14 @@ sanitizeHtml, }) => {
         enqueueGraphOperation,
         enqueueCalculation,
         enqueueStructureChange,
+        getCellData,
         getDependents,
         createHistory,
         onChangeTables,
         onChangeSheets,
         getActiveCell,
         isHiddenRow,
+        isManuallyHiddenRow,
         getFrozenRowCount,
         getSheetName,
         getEffectiveFormat,
@@ -1380,18 +1573,64 @@ sanitizeHtml, }) => {
         columnCount,
         locale,
         tables,
+        merges,
         basicFilter,
         getActiveCell,
         createHistory,
         onChangeTables,
         onChangeSheetData,
+        onChangeCharts,
         enqueueCalculation,
         enqueueGraphOperation,
         getFormattedValue,
         getDependents,
+        getSheetName,
         onCommand,
         generatedNames,
     });
+    // The AutoCorrect smart tag's "Undo Table AutoExpansion"
+    const onUndoTableAutoExpansion = useOnUndoTableAutoExpansion({
+        locale,
+        cellXfsRegistry,
+        tables,
+        createHistory,
+        batchHistory,
+        onResizeTable,
+        onChangeSheetData,
+        enqueueCalculation,
+        onCommand,
+    });
+    // The AutoCorrect smart tag's "Undo Calculated Column" / "Overwrite all cells in this column
+    // with this formula"
+    const onUndoCalculatedColumn = useOnUndoCalculatedColumn({
+        tables,
+        createHistory,
+        batchHistory,
+        onChangeSheetData,
+        onChangeTables,
+        enqueueCalculation,
+        onCommand,
+    });
+    const onFillCalculatedColumn = useOnChangeCalculatedColumn({
+        locale,
+        cellXfsRegistry,
+        sharedStringRegistry,
+        onChangeTables,
+        onChangeSheetData,
+        getUserEnteredValue: getUserEnteredValueStable,
+        getSheetName,
+        createHistory,
+        enqueueCalculation,
+        onCommand,
+    });
+    const onOverwriteCalculatedColumn = useCallback((fill) => {
+        const table = tables?.find((candidate) => candidate.id === fill.tableId && candidate.sheetId === fill.sheetId);
+        if (!table)
+            return;
+        batchHistory(() => {
+            onFillCalculatedColumn(fill.sheetId, fill.anchor, fill.formula, table, { force: true });
+        });
+    }, [tables, batchHistory, onFillCalculatedColumn]);
     // Copy
     const onCopy = useOnCopy({
         theme,
@@ -1414,6 +1653,9 @@ sanitizeHtml, }) => {
         columnCount,
         locale,
         sheetData,
+        onChangeNamedRanges,
+        onChangeCharts,
+        getSheetMerges: getPaintMerges,
         getDataValidationById,
         preserveFormatting: preserveFormattingOnPaste,
         maxColumnCount,
@@ -1431,6 +1673,9 @@ sanitizeHtml, }) => {
         enqueueStructureChange,
         enqueueGraphOperation,
         createHistory,
+        batchHistory,
+        autoExpandTables,
+        autoCalculatedColumns,
         onChangeSheetData,
         onChangeSheets,
         onChangeSelections,
@@ -1452,7 +1697,15 @@ sanitizeHtml, }) => {
         rowCount,
         columnCount,
         tables,
+        namedRanges,
         basicFilter,
+        sheetData,
+        sheets,
+        batchHistory,
+        getActiveCell,
+        getSelections,
+        onChangeCitations,
+        onChangeCharts,
         cellXfsRegistry,
         sharedStringRegistry,
         theme,
@@ -1467,11 +1720,15 @@ sanitizeHtml, }) => {
         getEffectiveValue,
         onRequestCalculate,
         getDependents,
+        getGraphNodes,
+        getBandedCells: getPaintBandedCells,
         enqueueGraphOperation,
         getContentfulRangeAroundCell,
         getSheetName,
         onCommand,
         generatedNames,
+        onChangeDataValidations,
+        onChangeConditionalFormats,
     });
     // Insert table row
     const onInsertTableRow = useOnInsertTableRow({
@@ -1488,10 +1745,12 @@ sanitizeHtml, }) => {
         onChangeSheetData,
         onChangeSheets,
         onChangeTables,
+        onChangeCharts,
         onChangeConditionalFormats,
         onChangeDataValidations,
         getSheetName,
         onCommand,
+        tables,
     });
     // Delete table row
     const onDeleteTableRow = useOnDeleteTableRow({
@@ -1507,18 +1766,21 @@ sanitizeHtml, }) => {
         onChangeSheetData,
         onChangeSheets,
         onChangeTables,
+        onChangeCharts,
         onChangeConditionalFormats,
         onChangeDataValidations,
         getSheetName,
         onCommand,
+        tables,
     });
     // Fill range
     const onFillRange = useOnFillRange({
         onFill,
     });
     // Embeds
-    const { onDeleteEmbed, onMoveEmbed, onResizeEmbed, onCreateEmbed, onRequestEditEmbed, } = useOnEmbeds({
+    const { onDeleteEmbed, onMoveEmbed, onResizeEmbed, onCreateEmbed, onUpdateEmbed, onRequestEditEmbed, onChangeZOrder, } = useOnEmbeds({
         onChangeEmbeds,
+        onChangeCharts,
         createHistory,
         onCommand,
     });
@@ -1530,6 +1792,14 @@ sanitizeHtml, }) => {
     });
     // Show modal dialog for table editor
     const onRequestEditTable = useOnRequestEditTable();
+    // Show the Resize Table dialog (Table Design → Resize Table)
+    const onRequestResizeTable = useOnRequestResizeTable();
+    // Show the Insert Slicers dialog (Table Design → Insert Slicer)
+    const onRequestInsertSlicer = useOnRequestInsertSlicer();
+    // Show the Create Table dialog (Ctrl+T / Insert → Table / Format as Table)
+    const onRequestCreateTable = useOnRequestCreateTable({
+        getEffectiveExtendedValue,
+    });
     // Show modal dialog for table editor
     const onRequestDefineNamedRange = useOnRequestDefineNamedRange({
         namedRanges,
@@ -1539,6 +1809,7 @@ sanitizeHtml, }) => {
     // Update named range
     const onUpdateNamedRange = useOnUpdateNamedRange({
         locale,
+        tables,
         getDependents,
         getActiveCell,
         enqueueCalculation,
@@ -1549,6 +1820,7 @@ sanitizeHtml, }) => {
     });
     // Update named range
     const onCreateNamedRange = useOnCreateNamedRange({
+        tables,
         enqueueCalculation,
         createHistory,
         onChangeNamedRanges,
@@ -1628,8 +1900,11 @@ sanitizeHtml, }) => {
         enqueueStructureChange,
         enqueueGraphOperation,
         onChangeSheetData,
+        onChangeSheets,
+        getCellData,
         getDependents,
         isHiddenRow,
+        isManuallyHiddenRow,
         getFrozenRowCount,
         getSheetName,
         getEffectiveFormat,
@@ -1642,6 +1917,12 @@ sanitizeHtml, }) => {
         onChangeProtectedRanges,
         onCommand,
     });
+    // Custom table styles (Excel's New Table Style)
+    const onCreateCustomTableStyle = useOnCreateCustomTableStyle({
+        createHistory,
+        onChangeCustomTableStyles,
+        onCommand,
+    });
     // Indent
     const { onIncreaseIndent, onDecreaseIndent, onChangeIndent } = useIndent({
         locale,
@@ -1758,6 +2039,7 @@ sanitizeHtml, }) => {
         onCreateDataValidationRule,
         onChangeTheme,
         onChangeNamedCellStyles,
+        onChangeCustomTableStyles,
         onClearHistory,
         evaluateConditionalFormatting,
         evaluateDataValidations,
@@ -1838,11 +2120,13 @@ sanitizeHtml, }) => {
         createHistory,
         enqueueCalculation,
         onChangeSheetData,
+        onChangeTables,
         locale,
         cellXfsRegistry,
         sharedStringRegistry,
         getFormattedValue,
         onCommand,
+        tables,
     });
     // Goal Seek — scratch-evaluates through the calculator, commits via onChange
     const onGoalSeek = useOnGoalSeek({
@@ -1863,6 +2147,7 @@ sanitizeHtml, }) => {
         onChangeBatch,
         onGroupRows,
         onUngroupRows,
+        batchHistory,
     });
     // Data → Advanced filter (criteria range) over the hide/show/write callbacks
     const onAdvancedFilter = useOnAdvancedFilter({
@@ -1892,6 +2177,8 @@ sanitizeHtml, }) => {
     });
     return {
         namedCellStyles,
+        customTableStyles,
+        onCreateCustomTableStyle,
         activeCellBySheetId,
         selectionsBySheetId,
         activeCell,
@@ -1908,6 +2195,7 @@ sanitizeHtml, }) => {
         columnMetadata,
         merges,
         bandedRanges,
+        onPreviewTableStyle,
         basicFilter,
         spreadsheetColors,
         isDarkMode,
@@ -1934,6 +2222,7 @@ sanitizeHtml, }) => {
         getUserEnteredValue,
         getFormattedValue,
         createHistory,
+        batchHistory,
         onRequestCalculate,
         enqueueCalculation,
         enqueueGraphOperation,
@@ -1994,13 +2283,22 @@ sanitizeHtml, }) => {
         onResizeEmbed,
         onDeleteEmbed,
         onCreateEmbed,
+        onUpdateEmbed,
         onRequestEditEmbed,
+        onChangeZOrder,
         onMoveSlicer,
         onResizeSlicer,
         onDeleteSlicer,
         onCreateSlicer,
         onUpdateSlicer,
         onRequestEditSlicer,
+        getSparklineGroup,
+        getSparklineAt,
+        onCreateSparklineGroup,
+        onUpdateSparklineGroup,
+        onDeleteSparklineGroup,
+        onClearSparklines,
+        onGroupSparklines,
         onDeleteRow,
         onDeleteColumn,
         onDeleteCellsShiftUp,
@@ -2012,11 +2310,15 @@ sanitizeHtml, }) => {
         onMoveColumns,
         onMoveRows,
         onMoveSelection,
+        onInsertCutCells,
         onSortColumn,
         onSortTable,
         onFilterTable,
         onDeleteFilter,
         onResizeTable,
+        onUndoTableAutoExpansion,
+        onUndoCalculatedColumn,
+        onOverwriteCalculatedColumn,
         onInsertTableColumn,
         onInsertTableRow,
         onDeleteTableColumn,
@@ -2025,8 +2327,11 @@ sanitizeHtml, }) => {
         onPaste,
         onCreateBasicFilter,
         onCreateTable,
+        onRequestCreateTable,
         onRemoveTable,
         onRequestEditTable,
+        onRequestResizeTable,
+        onRequestInsertSlicer,
         onUpdateTable,
         onRequestDefineNamedRange,
         onRequestUpdateNamedRange,
@@ -2129,6 +2434,8 @@ sanitizeHtml, }) => {
         onClearHistory,
         // Locale change
         onChangeLocale,
+        // Resolved formula syntax locale (see the `formulaLocale` option)
+        formulaLocale,
         // Comments
         onInsertComment,
         onRemoveComment,