@rowsncolumns/spreadsheet 10.2.76 → 10.3.0

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

@@ -6,12 +6,13 @@ 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 { cellToAddress, getCellEffectiveFormat, getContrastColor, isConditionalFormatFormulaRule, isDataValidationFormulaRule, isNil, isNilOrBlank, iterateCellsInRange, log, resolveDefaultHorizontalAlignment, ssfFormatColor, uuid, } from "@rowsncolumns/utils";
+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";
 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 { CF_INITIAL_WINDOW, cfWindowForViewport, isSameCfWindow, } from "../../api/cf-window";
 import { generateSelectionsFromFormula } from "../../api/selections";
 import { SpreadsheetApi } from "../../api/spreadsheet-api";
@@ -20,7 +21,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, useIsPasteSpecialDialogMounted, useOpenEvaluateFormulaDialog, useOpenGoToDialog, useOpenPasteSpecialDialog, useSetNoteEditorCell, useSetPinnedTooltip, useFillOptionsState, useOpenFillSeriesDialog, useShowPasteMenu, useShowValidationAlert, } from "../../atoms";
+import { useFormulaModeValue, useIsEvaluateFormulaDialogMounted, useIsGoToDialogMounted, useIsMoveOverwriteConfirmMounted, useIsPasteSpecialDialogMounted, useOpenEvaluateFormulaDialog, useOpenGoToDialog, useOpenMoveOverwriteConfirm, useOpenPasteSpecialDialog, useSetNoteEditorCell, useSetPinnedTooltip, useFillOptionsState, useInsertOptionsState, 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";
@@ -105,7 +106,7 @@ import { getNestedPropertyNames } from "./helpers";
  * @returns
  */
 function CanvasGridComponent(props, forwardedRef) {
-    const { licenseKey, sheetId, instanceId, activeCell = DEFAULT_ACTIVE_CELL, selections = DEFAULT_ARRAY, frozenColumnCount = 0, frozenRowCount = 0, rowCount = DEFAULT_ROW_COUNT, columnCount = DEFAULT_COLUMN_COUNT, autoFocus, basicFilter, tables, namedRanges, bandedRanges = DEFAULT_ARRAY, tableBorderColor = "#008000", filterIconColor = "#008000", conditionalFormats, showFilterIcon = true, showCalculatedColumnIcon = true, showHeaders = true, defaultColumnWidth = DEFAULT_COLUMN_WIDTH, defaultRowHeight = DEFAULT_ROW_HEIGHT, columnHeaderHeight = COLUMN_HEADER_HEIGHT, rowHeaderWidth = ROW_HEADER_WIDTH, gridLineColor = GRIDLINE_COLOR, cellBackgroundColor = DEFAULT_CELL_BACKGROUND_COLOR, cellColor = DEFAULT_CELL_COLOR, headerBorderColor = DEFAULT_HEADER_BORDER_COLOR, headerBackgroundColor = DEFAULT_HEADER_BG, headerColor = DEFAULT_HEADER_COLOR, headerActiveBackgroundColor = DEFAULT_HEADER_ACTIVE_BG, headerSelectedBackgroundColor = DEFAULT_HEADER_SELECTED_BG, headerSelectedColor = "white", headerTableBackgroundColor = DEFAULT_HEADER_TABLE_BG, headerTableActiveBackgroundColor = DEFAULT_HEADER_ACTIVE_TABLE_BG, headerTableSelectedBackgroundColor = DEFAULT_HEADER_SELECTED_TABLE_BG, frozenShadowColor = headerBorderColor, frozenShadowThickness = 1, selectionBackgroundColor = SELECTION_BG, selectionBorderColor = SELECTION_BORDER, selectionDragBorderColor = SELECTION_BORDER, chartSelectedColor, chipBackgroundColor = CHIP_COLOR, merges = DEFAULT_ARRAY, borderStyles, protectedRanges, isWorkbookProtected: isWorkbookProtectedProp = false, getSheetProtection, pivotTables, charts, embeds, slicers, rowMetadata = DEFAULT_ARRAY, columnMetadata = DEFAULT_ARRAY, scale = 1, zoomSpeed = 1, overscanCount = 3, enableEditOnEnterKey = true, enableTextOverflow = true, showGridLines: _showGridLines, showFormulas = false, protectFormulas = false, showFrozenSeparator = true, HeaderCell = DefaultHeaderCell, Cell = DefaultCell, SelectionTitleComponent = SelectionTitle, CellEditor = DefaultCellEditor, CellTooltip, ContextMenu = DefaultContextMenu, ContextMenuWrapper = DefaultContextMenuWrapper, FilterBox = DefaultFilterBox, HeaderMoveDragComponent = DefaultHeaderMoveDragComponent, SuggestionsDropdown, stickyEditor = true, scrollSnap = false, scrollThrottleTimeout, preventBrowserDefaultScroll, mouseMoveThrottleTimeout = 60, tooltipIntentInterval = 60, selectionPolicy, users, userId, renderCollaboratorCursor, functionDescriptions, showHeaderMenuButton = true, scrollbarSize = SCROLLBAR_SIZE, theme = defaultSpreadsheetTheme, showNotes = true, showComments = true, locale, agentSuggestions, onReviewSuggestion, onShowFormulas, getDataRowCount, getChartComponent, getEmbedComponent, getSlicerComponent, onChange, onChangeBatch, onExpandCollapse, onPivotDrillDown, onDelete, onChangeEditorValue, onFill, onRequestCalculate, onChangeActiveCell, onChangeActiveSheet, onChangeSelections, getSheetName, getSheetId, getCellData, getNote: getNoteProp, getTextFormatRuns, getDataValidation, getEffectiveFormat, getFormattedValue: getFormattedValueProp, getTooltipContent, errorResolutionComponent, getEffectiveValue: getEffectiveValueProp, getUserEnteredExtendedValue, getEffectiveExtendedValue, getSheetRowCount, getSheetColumnCount, getCellPopoverContent, onScroll, onViewPortChange, windowConditionalFormats = false, engineConditionalFormatResults = false, onResize, onAutoResize, onHideColumn, onHideRow, onShowColumn, onShowRow, onGroupRows, onUngroupRows, onCollapseRowGroup, onExpandRowGroup, onGroupColumns, onUngroupColumns, onCollapseColumnGroup, onExpandColumnGroup, onSetOutlineDepth, onDeleteRow, onDeleteColumn, onInsertRow, onInsertColumn, onInsertCellsShiftDown, onInsertCellsShiftRight, onDeleteCellsShiftLeft, onDeleteCellsShiftUp, onClearContents, onMoveColumns, onMoveRows, onSelectNextSheet, onSelectPreviousSheet, onCreateNewSheet, onKeyDown, onChangeFormatting, onRepeatFormatting, onClearFormatting, onRequestEditProtectedRange, onMoveChart, onResizeChart, onDeleteChart, onMoveEmbed, onResizeEmbed, onDeleteEmbed, onRequestEditEmbed, onMoveSlicer, onResizeSlicer, onDeleteSlicer, onRequestEditSlicer, onFillRange, disableFillRightShortcut, keymap, onCalculateNow, onRequestGoTo, onMoveSelection, onInsertTime, onInsertDate, onInsertDateTime, onInsertAutoSum, onUndo, onRedo, onPaste, onCopy, onCut, onSortColumn, onSortTable, onFilterTable, onFilterPivot, onResizeTable, onRequestEditTable, onRequestEditPivotTable, onRequestDeletePivotTable, onRemoveTable, onCreateTable, onInsertTableColumn, onDeleteTableColumn, onInsertTableRow, onDeleteTableRow, onCreateBasicFilter, onRequestDefineNamedRange, onRequestFormatCells, onRequestConditionalFormat, onRequestDataValidation, onRequestInsertComment, onRequestInsertLink, onFreezeColumn, onFreezeRow, onUpdateNote, onProtectRange, onUnProtectRange, onSortRange, onRequestSearch, onRequestReplace, onRequestResize, getRowHeaderText = getDefaultRowHeader, getColumnHeaderText = getDefaultColumnHeader, getAdditionalCellSpacing, tokenizer: defaultTokenizer = defaultFormulaTokenizer, onChangeScale, onRemoveLink, onSelectLink, onSplitTextToColumns, onRemoveDuplicates, 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, 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, 
     // 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
@@ -195,12 +196,21 @@ function CanvasGridComponent(props, forwardedRef) {
     const [showPasteMenu, setShowPasteMenu] = useShowPasteMenu();
     // Auto Fill Options smart tag / right-drag fill menu + Series dialog
     const [fillOptions, setFillOptions] = useFillOptionsState();
+    const [insertOptions, setInsertOptions] = useInsertOptionsState();
     const openFillSeriesDialog = useOpenFillSeriesDialog();
     // Shared state
     const formulaMode = useFormulaModeValue();
     const formulaSelections = useFormulaSelections();
     const [editingCellCoordinate, setEditingCellCoordinate] = useEditingCell();
     const setFormulabarEditorValue = useSetFormulabarEditorValue();
+    /**
+     * The formula SYNTAX the editor / formula bar speak (rowsncolumns/spreadsheet#655): Excel follows
+     * the user's language, so it defaults to `locale`. Everything that crosses the grid boundary stays
+     * canonical — see `formulaLocale` on `CanvasGridProps`.
+     */
+    const formulaLocale = useMemo(() => getFormulaLocale(formulaLocaleProp ?? locale), [formulaLocaleProp, locale]);
+    // Autocomplete + argument hints show the locale's function names and syntax.
+    const localizedFunctionDescriptions = useMemo(() => localizeFunctionDescriptions(functionDescriptions ?? undefined, formulaLocale), [functionDescriptions, formulaLocale]);
     const setFormulaBarTextFormatRuns = useSetFormulaBarTextFormatRuns();
     const canSelectCells = useFormulaCanSelectCells();
     const selectionMode = useFormulaSelectionMode();
@@ -782,7 +792,8 @@ function CanvasGridComponent(props, forwardedRef) {
         if (showFormulas && !protectFormulas) {
             const formulaValue = getFormulaValue(sheetId, rowIndex, columnIndex);
             if (formulaValue) {
-                return formulaValue;
+                // "Show Formulas" paints the formula the way the editor would show it.
+                return localizeFormula(formulaValue, formulaLocale);
             }
         }
         const formattedValue = getFormattedValueProp
@@ -803,6 +814,7 @@ function CanvasGridComponent(props, forwardedRef) {
         isColumnHeader,
         getRowHeaderText,
         getColumnHeaderText,
+        formulaLocale,
     ]);
     /**
      * Get information about cell grouping
@@ -943,6 +955,15 @@ function CanvasGridComponent(props, forwardedRef) {
     ]);
     // Add a stable reference to get userEnteredString value
     const getUserEnteredStringValueStable = useCallbackRef(getUserEnteredStringValue);
+    /**
+     * What the cell editor / formula bar open with: the stored (canonical) entry rendered in the
+     * grid's formula locale — `=SUM(1.5,A1)` shows as `=СУММ(1,5;A1)` in ru-RU, a stored `#VALUE!`
+     * as `#ЗНАЧ!`. `useEditorSubmit` canonicalizes the text again on commit.
+     */
+    const getEditorDisplayValue = useCallback((sheetId, rowIndex, columnIndex) => {
+        const value = getUserEnteredStringValue(sheetId, rowIndex, columnIndex);
+        return isNil(value) ? value : localizeCellInput(value, formulaLocale);
+    }, [getUserEnteredStringValue, formulaLocale]);
     /**
      * Get cell value used for validations
      */
@@ -1216,6 +1237,20 @@ function CanvasGridComponent(props, forwardedRef) {
         activeCell,
         tokenizer: defaultTokenizer,
     });
+    /**
+     * The editor's text is in the formula locale's syntax; this tokenizer reads it as such (token
+     * TYPES stay canonical, positions and images are the localized text's). The canonical
+     * `tokenizer` above is what the state hooks and the public context keep using for stored formulas.
+     */
+    const localeTokenizerBase = useCallback((value, sheetName) => defaultTokenizer(value, sheetName, formulaLocale), [defaultTokenizer, formulaLocale]);
+    const localeTokenizer = useCreateFormulaTokenizer({
+        getSelectionFromNamedRange,
+        getSelectionFromTable,
+        editingCellCoordinate,
+        sheetId,
+        activeCell,
+        tokenizer: formulaLocale.isCanonical ? defaultTokenizer : localeTokenizerBase,
+    });
     // Helper function to convert a selection to readable selection address
     const [getAddressFromSelection, getR1C1AddressFromSelection] = useCreateAddressFromSelection({
         sheetId,
@@ -1254,12 +1289,12 @@ function CanvasGridComponent(props, forwardedRef) {
     const getSelectionsFromFormula = useCallbackRef(useCallback((value, cell) => {
         const editingSheetName = getSheetName?.(editingCellCoordinate?.sheetId ?? sheetId);
         const editingSheetId = editingCellCoordinate?.sheetId ?? sheetId;
-        return generateSelectionsFromFormula(value, editingSheetId, editingSheetName, cell, rowCount, columnCount, tokenizer, getSelectionFromTable, getSelectionFromNamedRange);
+        return generateSelectionsFromFormula(value, editingSheetId, editingSheetName, cell, rowCount, columnCount, localeTokenizer, getSelectionFromTable, getSelectionFromNamedRange);
     }, [
         rowCount,
         columnCount,
         editingCellCoordinate,
-        tokenizer,
+        localeTokenizer,
         getSelectionFromTable,
         getSheetName,
         getSelectionFromNamedRange,
@@ -1815,7 +1850,7 @@ function CanvasGridComponent(props, forwardedRef) {
         const editingSheetName = getSheetName?.(editingSheetId);
         const effectiveValue = getEffectiveValue(editingSheetId, rowIndex, columnIndex);
         const horizontalAlignment = getEditorHorizontalAlignment(editingSheetId, rowIndex, columnIndex);
-        return (React.createElement(CellEditor, { ...props, locale: locale, effectiveValue: effectiveValue, format: cellFormat, dataValidation: dataValidation, getRangeValues: getFormattedValuesFromAddress, getRangeValuesAsync: getFormattedValuesFromAddressAsync, scale: scale, sheetName: sheetName, editingSheetId: editingSheetId, sheetId: sheetId, editingSheetName: editingSheetName, address: address, theme: theme, tokenizer: tokenizer, horizontalAlignment: horizontalAlignment, defaultBackgroundColor: cellBackgroundColor, defaultTextColor: getStringifiedColor(cellColor, theme), functionDescriptions: functionDescriptions ?? undefined, getNamedRanges: getNamedRanges, getTableNames: getTableNames, getStructuredProperties: getStructuredProperties, getTableColumnNames: getTableColumnNames, showFormulaHelp: showFormulaHelp, onHideFormulaHelp: onHideFormulaHelp, onShowFormulaHelp: onShowFormulaHelp, onRequestCalculate: onRequestCalculate, SuggestionsDropdown: SuggestionsDropdown, stickyEditor: stickyEditor, defaultFontSizePoint: defaultFontSizePoint, getMentions: getMentions, getFunctionParameterSuggestions: getFunctionParameterSuggestions, shouldFetchFunctionParameters: shouldFetchFunctionParameters, MentionTagComponent: MentionTagComponent, MentionDropdownItemComponent: MentionDropdownItemComponent }));
+        return (React.createElement(CellEditor, { ...props, locale: locale, effectiveValue: effectiveValue, format: cellFormat, dataValidation: dataValidation, getRangeValues: getFormattedValuesFromAddress, getRangeValuesAsync: getFormattedValuesFromAddressAsync, scale: scale, sheetName: sheetName, editingSheetId: editingSheetId, sheetId: sheetId, editingSheetName: editingSheetName, address: address, theme: theme, tokenizer: localeTokenizer, formulaLocale: formulaLocale, horizontalAlignment: horizontalAlignment, defaultBackgroundColor: cellBackgroundColor, defaultTextColor: getStringifiedColor(cellColor, theme), functionDescriptions: localizedFunctionDescriptions, getNamedRanges: getNamedRanges, getTableNames: getTableNames, getStructuredProperties: getStructuredProperties, getTableColumnNames: getTableColumnNames, showFormulaHelp: showFormulaHelp, onHideFormulaHelp: onHideFormulaHelp, onShowFormulaHelp: onShowFormulaHelp, onRequestCalculate: onRequestCalculate, SuggestionsDropdown: SuggestionsDropdown, stickyEditor: stickyEditor, defaultFontSizePoint: defaultFontSizePoint, getMentions: getMentions, getFunctionParameterSuggestions: getFunctionParameterSuggestions, shouldFetchFunctionParameters: shouldFetchFunctionParameters, MentionTagComponent: MentionTagComponent, MentionDropdownItemComponent: MentionDropdownItemComponent }));
     }, [
         scale,
         getEffectiveCellFormat,
@@ -1826,10 +1861,11 @@ function CanvasGridComponent(props, forwardedRef) {
         showFormulaHelp,
         onHideFormulaHelp,
         onShowFormulaHelp,
-        tokenizer,
+        localeTokenizer,
+        formulaLocale,
         cellBackgroundColor,
         cellColor,
-        functionDescriptions,
+        localizedFunctionDescriptions,
         getNamedRanges,
         getTableNames,
         getStructuredProperties,
@@ -1963,6 +1999,119 @@ function CanvasGridComponent(props, forwardedRef) {
         if (fillOptions?.mode === "menu")
             setFillOptions(null);
     }, [fillOptions, setFillOptions]);
+    /**
+     * Row / column inserts driven from this grid (context menu, Insert dialog,
+     * Ctrl+Shift+=) also arm Excel's Insert Options smart tag on the new band.
+     * The engine already applied "Format Same As Above / Left" (#647 FMT-01/02);
+     * the tag lets the user switch to the other neighbour or clear.
+     */
+    const insertRowWithOptions = useCallback((targetSheetId, rowIndex, numRows) => {
+        if (!onInsertRow)
+            return;
+        onInsertRow(targetSheetId, rowIndex, numRows);
+        if (numRows > 0) {
+            setInsertOptions({
+                sheetId: targetSheetId,
+                axis: "row",
+                start: rowIndex,
+                count: numRows,
+                option: "before",
+            });
+        }
+    }, [onInsertRow, setInsertOptions]);
+    const insertColumnWithOptions = useCallback((targetSheetId, columnIndex, numColumns) => {
+        if (!onInsertColumn)
+            return;
+        onInsertColumn(targetSheetId, columnIndex, numColumns);
+        if (numColumns > 0) {
+            setInsertOptions({
+                sheetId: targetSheetId,
+                axis: "column",
+                start: columnIndex,
+                count: numColumns,
+                option: "before",
+            });
+        }
+    }, [onInsertColumn, setInsertOptions]);
+    /**
+     * User-entered format of a cell for the Insert Options re-format. A legacy
+     * `StyleReference` (xlsx-imported style id) cannot be copied verbatim, so
+     * it resolves through `getEffectiveFormat` instead.
+     */
+    const readInsertFormat = useCallback((rowIndex, columnIndex) => {
+        const uf = getCellData?.(sheetId, rowIndex, columnIndex)?.uf;
+        if (!uf)
+            return undefined;
+        const isStyleReference = "sid" in uf || "styleId" in uf;
+        return isStyleReference
+            ? getEffectiveFormat?.(sheetId, rowIndex, columnIndex)
+            : uf;
+    }, [getCellData, getEffectiveFormat, sheetId]);
+    /**
+     * Insert Options smart tag choice. "Same As Above / Below" (Left / Right)
+     * re-paints the band with the neighbour's per-cell formats through the same
+     * paint-format path both engines share (`onChangeFormatting` with a format
+     * grid + `replace`), so the earlier choice does not linger; "Clear
+     * Formatting" wipes the band. A band that already holds values was not
+     * (or is no longer) a fresh insert — the refused-insert case — so the tag
+     * just goes away instead of re-formatting live data.
+     */
+    const handleChooseInsertOption = useCallback((option) => {
+        if (!insertOptions || insertOptions.sheetId !== sheetId)
+            return;
+        const band = {
+            axis: insertOptions.axis,
+            start: insertOptions.start,
+            count: insertOptions.count,
+        };
+        const limit = band.axis === "row" ? columnCount : rowCount;
+        const hasValue = (rowIndex, columnIndex) => {
+            const cell = getCellData?.(sheetId, rowIndex, columnIndex);
+            return !isNil(cell?.ue ?? cell?.userEnteredValue);
+        };
+        if (insertedBandHasValues(band, hasValue, limit)) {
+            setInsertOptions(null);
+            return;
+        }
+        const clearBand = () => {
+            const range = clearRangeForInsertedBand(band, readInsertFormat, limit);
+            if (range)
+                onClearFormatting?.(sheetId, activeCell, [{ range }]);
+        };
+        if (option === "clear") {
+            clearBand();
+        }
+        else {
+            const plan = formatsForInsertOption(band, option, readInsertFormat, limit);
+            if (plan) {
+                // Both engines accept the paint-format shape (format grid + replace);
+                // the grid prop type only names the key/value overload.
+                onChangeFormatting?.(sheetId, activeCell, plan.selections, plan.formats, { replace: true });
+            }
+            else {
+                clearBand();
+            }
+        }
+        setInsertOptions({ ...insertOptions, option });
+        focusSheet();
+    }, [
+        insertOptions,
+        sheetId,
+        columnCount,
+        rowCount,
+        getCellData,
+        readInsertFormat,
+        onClearFormatting,
+        onChangeFormatting,
+        activeCell,
+        setInsertOptions,
+        focusSheet,
+    ]);
+    // The smart tag belongs to one insert; moving on (a new active cell or
+    // sheet) drops it. Keyed on coordinates like the fill-options tag.
+    useEffect(() => {
+        setInsertOptions(null);
+    }, [activeCell.rowIndex, activeCell.columnIndex, sheetId, setInsertOptions]);
     /**
      * 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
@@ -2034,6 +2183,14 @@ function CanvasGridComponent(props, forwardedRef) {
     useEffect(() => {
         setFillOptions(null);
     }, [activeCell.rowIndex, activeCell.columnIndex, sheetId, setFillOptions]);
+    /**
+     * Drag-move overwrite prompt ("There's already data here. Do you want to replace it?").
+     * Routed to the host-mounted `MoveOverwriteConfirmDialogHost` when there is one; the
+     * selection hook falls back to `window.confirm` otherwise.
+     */
+    const openMoveOverwriteConfirm = useOpenMoveOverwriteConfirm();
+    const isMoveOverwriteConfirmMounted = useIsMoveOverwriteConfirmMounted();
+    const confirmMoveOverwrite = useMemo(() => (isMoveOverwriteConfirmMounted ? openMoveOverwriteConfirm : undefined), [isMoveOverwriteConfirmMounted, openMoveOverwriteConfirm]);
     /**
      * Fill handle dragged BACK inside the selection (Excel): the dragged-over cells lose their
      * contents — formats stay unless Ctrl/Cmd was held — through the same `onDelete` path as the
@@ -2076,6 +2233,8 @@ function CanvasGridComponent(props, forwardedRef) {
         onFillHandleRelease: handleFillHandleRelease,
         onFillShrink: handleFillShrink,
         onMoveSelection,
+        onInsertCutCells,
+        confirmMoveOverwrite,
         isHiddenColumn,
         isHiddenRow,
         isRowHeader,
@@ -2086,7 +2245,7 @@ function CanvasGridComponent(props, forwardedRef) {
     /**
      * Copy, Paste and Cut hook
      */
-    const { copiedSelections, clearCopiedSelections, copy, cut, paste, onInternalCopy, onInternalCut, onInternalPaste, } = useCopyPasteCut({
+    const { copiedSelections, isCutPending, copiedSheetId, cancelCut, clearCopiedSelections, copy, cut, paste, onInternalCopy, onInternalCut, onInternalPaste, } = useCopyPasteCut({
         activeCell,
         selections,
         sheetId,
@@ -2095,6 +2254,54 @@ function CanvasGridComponent(props, forwardedRef) {
         onCopy,
         onCut,
     });
+    /**
+     * 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
+     * header in pre-removal numbering (`insertBefore`); anything else inserts the cut block at
+     * the active cell, displacing the cells there (`onInsertCutCells`). Consumes the cut.
+     */
+    const insertCutCellsFromMenu = useCallback((target) => {
+        const from = copiedSelections[0];
+        if (!from || !isCutPending)
+            return;
+        const { range } = from;
+        const wholeRows = range.startColumnIndex <= 1 && range.endColumnIndex >= columnCount;
+        const wholeColumns = range.startRowIndex <= 1 && range.endRowIndex >= rowCount;
+        const span = (start, end) => Array.from({ length: end - start + 1 }, (_, i) => start + i);
+        if (target === "rows" && wholeRows) {
+            onMoveRows?.(sheetId, span(range.startRowIndex, range.endRowIndex), activeCell.rowIndex, {
+                insertBefore: true,
+            });
+        }
+        else if (target === "columns" && wholeColumns) {
+            onMoveColumns?.(sheetId, span(range.startColumnIndex, range.endColumnIndex), activeCell.columnIndex, { insertBefore: true });
+        }
+        else {
+            const to = {
+                range: {
+                    startRowIndex: activeCell.rowIndex,
+                    startColumnIndex: activeCell.columnIndex,
+                    endRowIndex: activeCell.rowIndex + (range.endRowIndex - range.startRowIndex),
+                    endColumnIndex: activeCell.columnIndex + (range.endColumnIndex - range.startColumnIndex),
+                },
+            };
+            onInsertCutCells?.(sheetId, from, to);
+        }
+        cancelCut();
+        focusSheet();
+    }, [
+        copiedSelections,
+        isCutPending,
+        columnCount,
+        rowCount,
+        sheetId,
+        activeCell,
+        onMoveRows,
+        onMoveColumns,
+        onInsertCutCells,
+        cancelCut,
+        focusSheet,
+    ]);
     /**
      * Paste Special dialog (context menu → Paste special…, Ctrl+Alt+V). The
      * dialog is host-mounted (`PasteSpecialDialogHost`); its request routes
@@ -2205,6 +2412,7 @@ function CanvasGridComponent(props, forwardedRef) {
         onChangeSelections,
         getSelectionsFromFormula,
         onChangeEditorValue,
+        formulaLocale,
     });
     // Get final row height to expand to based on value of a cell
     const getFinalRowHeight = useCallbackRef(useCallback((sheetId, rowIndex, columnIndex, options) => {
@@ -2249,6 +2457,7 @@ function CanvasGridComponent(props, forwardedRef) {
         showValidationAlert,
         selections,
         onChangeBatch,
+        formulaLocale,
     });
     /**
      * User cancels editing the cell
@@ -2337,7 +2546,7 @@ function CanvasGridComponent(props, forwardedRef) {
      * Get context Menu component
      */
     const getContextMenu = useCallback((cell) => {
-        return (React.createElement(ContextMenu, { activeCell: activeCell, selections: selections, sheetId: sheetId, frozenRows: frozenRows, frozenColumns: frozenColumns, onHideColumn: isRestricted ? undefined : onHideColumn, onShowColumn: isRestricted ? undefined : onShowColumn, onShowRow: isRestricted ? undefined : onShowRow, onHideRow: isRestricted ? undefined : onHideRow, onGroupRows: isRestricted ? undefined : onGroupRows, onUngroupRows: isRestricted ? undefined : onUngroupRows, onGroupColumns: isRestricted ? undefined : onGroupColumns, onUngroupColumns: isRestricted ? undefined : onUngroupColumns, isHiddenColumn: isHiddenColumn, isHiddenRow: isHiddenRow, onDeleteColumn: onDeleteColumn, onDeleteRow: onDeleteRow, onInsertRow: onInsertRow, onInsertColumn: onInsertColumn, onInsertCellsShiftDown: onInsertCellsShiftDown, onInsertCellsShiftRight: onInsertCellsShiftRight, onDeleteCellsShiftLeft: onDeleteCellsShiftLeft, onDeleteCellsShiftUp: onDeleteCellsShiftUp, onClearContents: onClearContents, onFreezeColumn: onFreezeColumn, onFreezeRow: onFreezeRow, focusSheet: focusSheet, onSortColumn: onSortColumn, onInsertNote: onInsertNote, onProtectRange: onProtectRange, onUnProtectRange: onUnProtectRange, onSortRange: onSortRange, onRequestDefineNamedRange: onRequestDefineNamedRange, protectedRanges: protectedRanges, isRowHeader: isRowHeader(cell.columnIndex), isColumnHeader: isColumnHeader(cell.rowIndex), selectedRowHeadersIds: selectedRowHeadersIds, selectedColumnHeadersIds: selectedColumnHeadersIds, onCopy: copy, onCut: cut, onPaste: paste, onRequestPasteSpecial: requestPasteSpecial, onRequestEvaluateFormula: requestEvaluateFormula, 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, onRequestEditPivotTable: onRequestEditPivotTable, onRemoveTable: onRemoveTable, onRequestDeletePivotTable: onRequestDeletePivotTable, onPivotDrillDown: onPivotDrillDown, onRequestFormatCells: onRequestFormatCells, onRequestConditionalFormat: onRequestConditionalFormat, onRequestDataValidation: onRequestDataValidation, onClearFormatting: onClearFormatting, onCreateTable: onCreateTable, onCreateBasicFilter: onCreateBasicFilter, onInsertTableColumn: onInsertTableColumn, onDeleteTableColumn: onDeleteTableColumn, onInsertTableRow: onInsertTableRow, onDeleteTableRow: onDeleteTableRow, onFilterTable: onFilterTable, onSortTable: onSortTable, getFormattedValue: getFormattedValue, getFormattedValuesFromRange: getFormattedValuesFromRange, isTableHeader: isTableHeader, readonly: readonly, onSplitTextToColumns: onSplitTextToColumns, onRemoveDuplicates: onRemoveDuplicates, onGoalSeek: onGoalSeek, onSubtotal: onSubtotal, onAdvancedFilter: onAdvancedFilter, onChange: onChange, getCellData: getCellData, onAddQuickEdit: onAddQuickEdit, enableMagicFill: enableMagicFill }));
     }, [
         isRestricted,
         activeCell,
@@ -2350,8 +2559,10 @@ function CanvasGridComponent(props, forwardedRef) {
         onHideRow,
         onDeleteColumn,
         onDeleteRow,
-        onInsertColumn,
-        onInsertRow,
+        insertColumnWithOptions,
+        insertRowWithOptions,
+        rowCount,
+        columnCount,
         onInsertCellsShiftDown,
         onInsertCellsShiftRight,
         onDeleteCellsShiftLeft,
@@ -2489,7 +2700,7 @@ function CanvasGridComponent(props, forwardedRef) {
         onGroupColumns,
         onUngroupColumns,
         onDeleteRow,
-        onInsertRow,
+        onInsertRow: insertRowWithOptions,
         onInsertAutoSum,
         onShowColumn,
         onShowRow,
@@ -2531,7 +2742,7 @@ function CanvasGridComponent(props, forwardedRef) {
         selections,
         getSheetColumnCount,
         getSheetRowCount,
-        getValue: getUserEnteredStringValue,
+        getValue: getEditorDisplayValue,
         getTextFormatRuns,
         getBooleanValue,
         getDataValidation: getDataValidationRule,
@@ -3004,6 +3215,7 @@ function CanvasGridComponent(props, forwardedRef) {
      */
     const [cellBackgroundRenderer, cellRenderer, cellOverlayRenderer, headerCellRenderer,] = useCellRenderer({
         sheetId,
+        formulaLocale,
         showGridLines,
         scale,
         enableTextOverflow,
@@ -3104,13 +3316,13 @@ function CanvasGridComponent(props, forwardedRef) {
         getCellBounds,
         getCellCoordsFromOffset,
         scrollToCell,
-        tokenizer,
+        tokenizer: localeTokenizer,
     });
     // Selection move: drag a formula reference via its border covers
     const { onMouseDownMoveSelection, isDragging: isDraggingMoveSelection } = useSelectionMove({
         getCellCoordsFromOffset,
         scrollToCell,
-        tokenizer,
+        tokenizer: localeTokenizer,
     });
     /**
      * Hide fill handle
@@ -3174,6 +3386,8 @@ function CanvasGridComponent(props, forwardedRef) {
         onChooseFillType: handleChooseFillType,
         onOpenFillSeriesDialog: handleOpenFillSeriesDialog,
         onCloseFillOptions: handleCloseFillOptions,
+        insertOptions,
+        onChooseInsertOption: handleChooseInsertOption,
         hoveredCell: delayedHoveredCell,
         onRemoveQuickEdit,
         onAddQuickEdit,
@@ -3345,6 +3559,8 @@ function CanvasGridComponent(props, forwardedRef) {
         getAddressFromSelection,
         getR1C1AddressFromSelection,
         tokenizer,
+        localeTokenizer,
+        formulaLocale,
         setEditorValue,
         getCellBounds,
         getNamedRanges,
@@ -3509,8 +3725,8 @@ function CanvasGridComponent(props, forwardedRef) {
         const { rowIndex, columnIndex } = activeCell;
         const value = getUserEnteredStringValue(sheetId, rowIndex, columnIndex);
         const textFormatRuns = getTextFormatRuns?.(sheetId, rowIndex, columnIndex);
-        // Update formula bar input
-        setFormulabarEditorValue(value ?? "");
+        // Update formula bar input (in the grid's formula locale, like the cell editor)
+        setFormulabarEditorValue(localizeCellInput(value ?? "", formulaLocale));
         setFormulaBarTextFormatRuns(textFormatRuns);
     }, [
         activeCell,
@@ -3518,6 +3734,7 @@ function CanvasGridComponent(props, forwardedRef) {
         sheetId,
         editingCellCoordinate,
         getUserEnteredStringValue,
+        formulaLocale,
         setFormulabarEditorValue,
         setFormulaBarTextFormatRuns,
     ]);

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

@@ -1,5 +1,6 @@
 import type { CalculatorFunction } from "@rowsncolumns/common-types";
 import type { FormulaResult } from "@rowsncolumns/fast-formula-parser";
+import type { FormulaLocale, FormulaLocaleInput } from "@rowsncolumns/utils";
 import type { Align, AreaStyle, CellInterface, CellPosition, Direction, GridProps, GridRange, GridRef, OptionalCellInterface, ScrollCoords, SelectionArea, Style, ViewPortProps } from "@rowsncolumns/grid";
 import type { Mention, MentionTagComponentProps, OptionItem, ProseMirrorEditorProps, TextFormatRun } from "@rowsncolumns/ui";
 import type { CellDiff } from "@rowsncolumns/version-comparison";
@@ -440,6 +441,20 @@ export type CanvasGridProps<T extends CellData = CellData<any, any>> = {
      * Locale of the spreadsheet
      */
     locale?: string;
+    /**
+     * Formula SYNTAX locale for the cell editor, formula bar, autocomplete, argument hints, syntax
+     * highlighting and error display (rowsncolumns/spreadsheet#655) — Excel's behaviour: decimal and
+     * argument separators, function names and error values follow the user's language
+     * (`=СУММ(1,5;A1)` in ru-RU, `=SUMME(1,5;A1)` in de-DE) while every value that leaves the grid
+     * (`onChange`, `onChangeEditorValue`, `onRequestCalculate`, the stored cell) stays canonical
+     * (`=SUM(1.5,A1)`), so collaborators in different locales share one document.
+     *
+     * Accepts a BCP-47 tag, a resolved `FormulaLocale`, or an inline `FormulaLocaleDefinition`
+     * (`{ extends: "de", functions: { SUM: "SUMMEX" } }`); applications extend or override the
+     * built-in dictionaries globally with `registerFormulaLocale` from `@rowsncolumns/utils`.
+     * Defaults to `locale`; pass `"en"` to keep English syntax under a non-English `locale`.
+     */
+    formulaLocale?: FormulaLocaleInput;
     /**
      * Enable row and column resizer to overflow outside the container
      */
@@ -714,6 +729,16 @@ export type CanvasGridProps<T extends CellData = CellData<any, any>> = {
      * @param to
      */
     onMoveSelection?(sheetId: number, from: SelectionArea<SelectionAttributes>, to: SelectionArea<SelectionAttributes>): void;
+    /**
+     * Excel "Insert Cut Cells" / Shift+drag of a cell range: the destination band
+     * opens (down for a vertical move, right for a horizontal one), the block is
+     * inserted there and the gap it left closes — nothing is overwritten and no
+     * blank is left behind. Plain drags call `onMoveSelection` (overwrite, after
+     * the data prompt) instead.
+     * @param from
+     * @param to
+     */
+    onInsertCutCells?(sheetId: number, from: SelectionArea<SelectionAttributes>, to: SelectionArea<SelectionAttributes>): void;
     /**
      * Callback when active cell changes
      */
@@ -884,13 +909,19 @@ export type CanvasGridProps<T extends CellData = CellData<any, any>> = {
      * @param dims
      * @param toColumn
      */
-    onMoveColumns?(sheetId: number, dims: number[], toColumn: number): void;
+    onMoveColumns?(sheetId: number, dims: number[], toColumn: number, options?: {
+        insertBefore?: boolean;
+    }): void;
     /**
-     * Callback when rows are moved
+     * Callback when rows are moved. `toRow` is the block's final index; with
+     * `insertBefore` (context-menu "Insert Cut Cells") it is instead the row the
+     * block is inserted before in pre-removal numbering, as Excel counts it.
      * @param dims
      * @param toRow
      */
-    onMoveRows?(sheetId: number, dims: number[], toRow: number): void;
+    onMoveRows?(sheetId: number, dims: number[], toRow: number, options?: {
+        insertBefore?: boolean;
+    }): void;
     /**
      * User pressed a key to select previous sheet
      */
@@ -1429,7 +1460,9 @@ export type CanvasGridProps<T extends CellData = CellData<any, any>> = {
      * Parses a text value to return tokens
      * @param value
      */
-    tokenizer?(value: string | undefined, sheetName?: string): ParsedToken[];
+    tokenizer?(value: string | undefined, sheetName?: string, 
+    /** The formula locale the text is written in; canonical syntax when omitted. */
+    formulaLocale?: FormulaLocaleInput | null): ParsedToken[];
     /**
      * User is requesting to search a sheet
      */
@@ -1893,10 +1926,19 @@ export type CanvasGridMethods = {
      */
     updateSelectionStartEndReference?(cell: CellInterface | undefined, selections?: SelectionArea<SelectionAttributes>[] | undefined): void;
     /**
-     * Tokenize string
+     * Tokenize string (canonical formula syntax — what the state hooks and stored cells use)
      * @param str
      */
     tokenizer(str: string): ParsedToken[];
+    /**
+     * Tokenize text written in the grid's formula locale (what the cell editor / formula bar hold).
+     * @param str
+     */
+    localeTokenizer?(str: string): ParsedToken[];
+    /**
+     * The grid's resolved formula locale (see `CanvasGridProps.formulaLocale`).
+     */
+    formulaLocale?: FormulaLocale;
     /**
      * Get dimensions of a cell
      */