@rowsncolumns/spreadsheet 10.2.73 → 10.2.75

package/dist/esm/components/context-menu/index.js

@@ -1,13 +1,19 @@
 import { Direction, isCellWithinBounds, selectionFromActiveCell, } from "@rowsncolumns/grid";
-import { ArrowLeftIcon, ArrowRightIcon, ChevronRightIcon, ClipboardIcon, CopyIcon, Cross1Icon, DotsVerticalIcon, EyeNoneIcon, EyeOpenIcon, FunnelIcon, MdBrush, MdOutlineFactCheck, PaintBrush, PlusIcon, ReaderIcon, RemoveDuplicatesIcon, ScissorsIcon, SizeIcon, SortDownIcon, SortUpIcon, SpaceBetweenHorizontallyIcon, TableIcon, TrashIcon, ViewGridIcon, WandIcon, } from "@rowsncolumns/icons";
-import { DropdownLeftSlot, DropdownMenuContent, DropdownMenuItem, DropdownMenuPortal, DropdownMenuSeparator, DropdownMenuSub, DropdownMenuSubContent, DropdownMenuSubTrigger, DropdownRightSlot, } from "@rowsncolumns/ui";
-import { number2Alpha } from "@rowsncolumns/utils";
+import { ArrowLeftIcon, ArrowRightIcon, CheckIcon, ChevronRightIcon, ClipboardIcon, CodeIcon, CopyIcon, Cross1Icon, DotsVerticalIcon, EyeNoneIcon, EyeOpenIcon, FunnelIcon, MdBrush, MdOutlineFactCheck, PaintBrush, PlusIcon, ReaderIcon, RemoveDuplicatesIcon, ScissorsIcon, SizeIcon, SortDownIcon, SortUpIcon, SpaceBetweenHorizontallyIcon, TableIcon, TrashIcon, ViewGridIcon, WandIcon, } from "@rowsncolumns/icons";
+import { DropdownLeftSlot, DropdownMenuCheckboxItem, DropdownMenuContent, DropdownMenuItem, DropdownMenuItemIndicator, DropdownMenuPortal, DropdownMenuSeparator, DropdownMenuSub, DropdownMenuSubContent, DropdownMenuSubTrigger, DropdownRightSlot, } from "@rowsncolumns/ui";
+import { addressToCell, cellToAddress, number2Alpha } from "@rowsncolumns/utils";
 import React, { useCallback, useMemo, useRef } from "react";
 import { getProtectedRange, isProtectedRange } from "../../api/validation";
 import { useGetContentfulRangeAroundCell } from "../../atoms";
+import { useIsAdvancedFilterDialogMounted, useOpenAdvancedFilterDialog, } from "../../atoms/advanced-filter-dialog.atom";
+import { useIsGoalSeekDialogMounted, useOpenGoalSeekDialog, } from "../../atoms/goal-seek-dialog.atom";
+import { useIsRemoveDuplicatesDialogMounted, useOpenRemoveDuplicatesDialog, } from "../../atoms/remove-duplicates-dialog.atom";
+import { useIsSubtotalDialogMounted, useOpenSubtotalDialog, } from "../../atoms/subtotal-dialog.atom";
+import { useIsTextToColumnsDialogMounted, useOpenTextToColumnsDialog, } from "../../atoms/text-to-columns-dialog.atom";
 import { BLANK_LABEL } from "../../config";
 import { createArrayRange, generateMultiDimTitle } from "../../helpers";
-export const ContextMenu = ({ isRowHeader, isColumnHeader, activeCell, selections, basicFilter, isTableHeader, onClearContents, onHideColumn, onHideRow, onGroupRows, onUngroupRows, onGroupColumns, onUngroupColumns, onDeleteRow, onDeleteColumn, onInsertColumn, onInsertRow, onInsertCellsShiftDown, onInsertCellsShiftRight, onDeleteCellsShiftLeft, onDeleteCellsShiftUp, onFreezeRow, onFreezeColumn, onCopy, onCut, onPaste, onInsertNote, onProtectRange, onUnProtectRange, onSortRange, onSortColumn, onRequestDefineNamedRange, onRequestResize, onRequestEditTable, onRequestEditPivotTable, onRequestDeletePivotTable, onPivotDrillDown, onRequestFormatCells, onRequestConditionalFormat, onRequestDataValidation, onRemoveTable, onClearFormatting, onCreateTable, onCreateBasicFilter, onFilterTable, onSortTable, getFormattedValuesFromRange, focusSheet, isSheetFocused, getFormattedValue, onInsertTableColumn, onDeleteTableColumn, onInsertTableRow, onDeleteTableRow, onSplitTextToColumns, onRemoveDuplicates, isHiddenColumn, isHiddenRow, onShowColumn, onShowRow, tables, pivotTables, protectedRanges, sheetId, frozenRows, frozenColumns, selectedRowHeadersIds, selectedColumnHeadersIds, readonly = false, onAddQuickEdit, enableMagicFill, }) => {
+import { getTotalRowFunctionFormula, getTotalRowFunctionFromFormula, TOTAL_ROW_FUNCTIONS, } from "./total-row-functions";
+export const ContextMenu = ({ isRowHeader, isColumnHeader, activeCell, selections, basicFilter, isTableHeader, onClearContents, onHideColumn, onHideRow, onGroupRows, onUngroupRows, onGroupColumns, onUngroupColumns, onDeleteRow, onDeleteColumn, onInsertColumn, onInsertRow, onInsertCellsShiftDown, onInsertCellsShiftRight, onDeleteCellsShiftLeft, onDeleteCellsShiftUp, onFreezeRow, onFreezeColumn, onCopy, onCut, onPaste, onRequestPasteSpecial, onRequestEvaluateFormula, onRequestAddWatch, isActiveCellFormula, onInsertNote, onProtectRange, onUnProtectRange, onSortRange, onSortColumn, onRequestDefineNamedRange, onRequestResize, onRequestEditTable, onRequestEditPivotTable, onRequestDeletePivotTable, onPivotDrillDown, onRequestFormatCells, onRequestConditionalFormat, onRequestDataValidation, onRemoveTable, onClearFormatting, onCreateTable, onCreateBasicFilter, onFilterTable, onSortTable, getFormattedValuesFromRange, focusSheet, isSheetFocused, getFormattedValue, onInsertTableColumn, onDeleteTableColumn, onInsertTableRow, onDeleteTableRow, onSplitTextToColumns, onRemoveDuplicates, onGoalSeek, onSubtotal, onAdvancedFilter, onChange, getCellData, isHiddenColumn, isHiddenRow, onShowColumn, onShowRow, tables, pivotTables, protectedRanges, sheetId, frozenRows, frozenColumns, selectedRowHeadersIds, selectedColumnHeadersIds, readonly = false, onAddQuickEdit, enableMagicFill, }) => {
     const isHeader = isColumnHeader || isRowHeader;
     const shouldFocusSheetRef = useRef(true);
     const multiColumnTitle = generateMultiDimTitle(selectedColumnHeadersIds, "y");
@@ -37,6 +43,184 @@ export const ContextMenu = ({ isRowHeader, isColumnHeader, activeCell, selection
     const lastSelectedRowIndex = selectedRowHeadersIds.reduce((m, v) => (v > m ? v : m), -Infinity);
     // Get contentful range
     const getContentfulRangeAroundCell = useGetContentfulRangeAroundCell();
+    // The data block the data tools act on: a table's own rows, the selection,
+    // or (from a lone cell) the contentful region around it — like Excel.
+    const dataRangeAroundSelection = useCallback(() => {
+        if (activeTable) {
+            return {
+                ...activeTable.range,
+                endRowIndex: activeTable.range.endRowIndex - (activeTable.totalRow ? 1 : 0),
+            };
+        }
+        if (selections.length) {
+            return selection.range;
+        }
+        return getContentfulRangeAroundCell?.(sheetId, activeCell) ?? selection.range;
+    }, [activeTable, selections.length, selection.range, getContentfulRangeAroundCell, sheetId, activeCell]);
+    // Excel pre-ticks "my data has headers" when the first row reads as labels:
+    // every cell filled and none of them a number.
+    const headerColumnsOf = useCallback((range) => {
+        const columns = [];
+        for (let columnIndex = range.startColumnIndex; columnIndex <= range.endColumnIndex; columnIndex++) {
+            const header = activeTable?.columns?.[columnIndex - activeTable.range.startColumnIndex]
+                ?.name ?? getFormattedValue(sheetId, range.startRowIndex, columnIndex);
+            columns.push({
+                columnIndex,
+                label: `Column ${number2Alpha(columnIndex - 1)}`,
+                header: header || undefined,
+            });
+        }
+        const hasHeader = activeTable
+            ? (activeTable.headerRow ?? true)
+            : range.endRowIndex > range.startRowIndex &&
+                columns.every((column) => !!column.header && Number.isNaN(Number(column.header)));
+        return { columns, hasHeader };
+    }, [activeTable, getFormattedValue, sheetId]);
+    const rangeAddress = (range) => `${cellToAddress({ rowIndex: range.startRowIndex, columnIndex: range.startColumnIndex })}:${cellToAddress({ rowIndex: range.endRowIndex, columnIndex: range.endColumnIndex })}`;
+    // Text to Columns → Fixed width (dialog with a ruler over the selected column).
+    const isTextToColumnsDialogMounted = useIsTextToColumnsDialogMounted();
+    const openTextToColumnsDialog = useOpenTextToColumnsDialog();
+    const handleTextToColumnsDialog = useCallback(() => {
+        const range = selections.length ? selection.range : dataRangeAroundSelection();
+        const columnIndex = selections.length ? range.startColumnIndex : activeCell.columnIndex;
+        const preview = [];
+        const firstRow = selections.length ? range.startRowIndex : activeCell.rowIndex;
+        const lastRow = selections.length ? range.endRowIndex : range.endRowIndex;
+        for (let rowIndex = firstRow; rowIndex <= lastRow && preview.length < 8; rowIndex++) {
+            preview.push(getFormattedValue(sheetId, rowIndex, columnIndex) ?? "");
+        }
+        const target = selections.length
+            ? selections
+            : [
+                {
+                    range: {
+                        startRowIndex: activeCell.rowIndex,
+                        endRowIndex: range.endRowIndex,
+                        startColumnIndex: columnIndex,
+                        endColumnIndex: columnIndex,
+                    },
+                },
+            ];
+        openTextToColumnsDialog({
+            preview,
+            onApply: ({ delimiter, columnBreaks }) => onSplitTextToColumns?.(sheetId, activeCell, target, delimiter, { columnBreaks }),
+        });
+    }, [
+        selections,
+        selection.range,
+        dataRangeAroundSelection,
+        activeCell,
+        getFormattedValue,
+        sheetId,
+        openTextToColumnsDialog,
+        onSplitTextToColumns,
+    ]);
+    // Data → Subtotal.
+    const isSubtotalDialogMounted = useIsSubtotalDialogMounted();
+    const openSubtotalDialog = useOpenSubtotalDialog();
+    const handleSubtotal = useCallback(() => {
+        const range = dataRangeAroundSelection();
+        const { columns, hasHeader } = headerColumnsOf(range);
+        openSubtotalDialog({
+            columns,
+            hasHeader,
+            onApply: (choices) => onSubtotal?.(sheetId, { range, ...choices }),
+        });
+    }, [dataRangeAroundSelection, headerColumnsOf, openSubtotalDialog, onSubtotal, sheetId]);
+    // Data → Advanced filter.
+    const isAdvancedFilterDialogMounted = useIsAdvancedFilterDialogMounted();
+    const openAdvancedFilterDialog = useOpenAdvancedFilterDialog();
+    const handleAdvancedFilter = useCallback(() => {
+        openAdvancedFilterDialog({
+            listRange: rangeAddress(dataRangeAroundSelection()),
+            onApply: (options) => onAdvancedFilter?.(sheetId, options),
+        });
+    }, [openAdvancedFilterDialog, dataRangeAroundSelection, onAdvancedFilter, sheetId]);
+    // Data → What-If Analysis → Goal Seek.
+    const isGoalSeekDialogMounted = useIsGoalSeekDialogMounted();
+    const openGoalSeekDialog = useOpenGoalSeekDialog();
+    const handleGoalSeek = useCallback(() => {
+        openGoalSeekDialog({
+            setCell: cellToAddress(activeCell) ?? "",
+            onApply: async (setCellAddress, targetValue, changingCellAddress) => {
+                const setCell = addressToCell(setCellAddress);
+                const changingCell = addressToCell(changingCellAddress);
+                if (!setCell || !changingCell || !onGoalSeek)
+                    return undefined;
+                return onGoalSeek(sheetId, setCell, targetValue, changingCell);
+            },
+        });
+    }, [openGoalSeekDialog, activeCell, onGoalSeek, sheetId]);
+    // Remove duplicates — Excel's dialog (column checklist + "my data has
+    // headers") when a host mounts `RemoveDuplicatesDialogHost`, otherwise the
+    // one-click de-dupe over the selection.
+    const isRemoveDuplicatesDialogMounted = useIsRemoveDuplicatesDialogMounted();
+    const openRemoveDuplicatesDialog = useOpenRemoveDuplicatesDialog();
+    const handleRemoveDuplicates = useCallback(() => {
+        if (!isRemoveDuplicatesDialogMounted) {
+            onRemoveDuplicates?.(sheetId, activeCell, selections);
+            return;
+        }
+        // A table de-dupes its own rows; a lone cell expands to the data region
+        // around it, like Excel.
+        let range;
+        if (activeTable) {
+            range = {
+                ...activeTable.range,
+                endRowIndex: activeTable.range.endRowIndex - (activeTable.totalRow ? 1 : 0),
+            };
+        }
+        else if (selections.length) {
+            range = selection.range;
+        }
+        else {
+            range = getContentfulRangeAroundCell?.(sheetId, activeCell) ?? selection.range;
+        }
+        const columns = [];
+        for (let columnIndex = range.startColumnIndex; columnIndex <= range.endColumnIndex; columnIndex++) {
+            const header = activeTable?.columns?.[columnIndex - activeTable.range.startColumnIndex]
+                ?.name ?? getFormattedValue(sheetId, range.startRowIndex, columnIndex);
+            columns.push({
+                columnIndex,
+                label: `Column ${number2Alpha(columnIndex - 1)}`,
+                header: header || undefined,
+            });
+        }
+        // Excel pre-ticks "my data has headers" when the first row reads as
+        // labels: every cell filled and none of them a number.
+        const hasHeader = activeTable
+            ? (activeTable.headerRow ?? true)
+            : range.endRowIndex > range.startRowIndex &&
+                columns.every((column) => !!column.header && Number.isNaN(Number(column.header)));
+        const target = range;
+        openRemoveDuplicatesDialog({
+            columns,
+            hasHeader,
+            onApply: (options) => onRemoveDuplicates?.(sheetId, activeCell, [{ range: target }], options),
+        });
+    }, [
+        isRemoveDuplicatesDialogMounted,
+        openRemoveDuplicatesDialog,
+        onRemoveDuplicates,
+        sheetId,
+        activeCell,
+        selections,
+        selection,
+        activeTable,
+        getContentfulRangeAroundCell,
+        getFormattedValue,
+    ]);
+    // Totals-row function picker: the active cell sits on a table's totals row.
+    const isActiveCellTableTotal = !!activeTable?.totalRow &&
+        activeCell.rowIndex === activeTable.range.endRowIndex;
+    const activeTotalRowFunction = useMemo(() => {
+        if (!isActiveCellTableTotal) {
+            return "none";
+        }
+        const cellData = getCellData?.(sheetId, activeCell.rowIndex, activeCell.columnIndex);
+        const ue = cellData?.ue ?? cellData?.userEnteredValue;
+        return getTotalRowFunctionFromFormula(ue?.fv ?? ue?.formulaValue);
+    }, [isActiveCellTableTotal, getCellData, sheetId, activeCell]);
     // Sort table or filter
     const onSortTableOrFilterView = useCallback((direction) => {
         // Found a table
@@ -157,7 +341,16 @@ export const ContextMenu = ({ isRowHeader, isColumnHeader, activeCell, selection
                     React.createElement(DropdownMenuItem, { onClick: () => onPaste?.("Formatting") }, "Formatting only"),
                     React.createElement(DropdownMenuItem, { onClick: () => onPaste?.("Formula") }, "Formula"),
                     React.createElement(DropdownMenuSeparator, null),
-                    React.createElement(DropdownMenuItem, { onClick: () => onPaste?.("Transposed") }, "Transposed"))),
+                    React.createElement(DropdownMenuItem, { onClick: () => onPaste?.("Transposed") }, "Transposed"),
+                    onRequestPasteSpecial ? (React.createElement(React.Fragment, null,
+                        React.createElement(DropdownMenuSeparator, null),
+                        React.createElement(DropdownMenuItem, { onClick: () => {
+                                // Focus moves to the dialog, not back to the sheet
+                                shouldFocusSheetRef.current = false;
+                                onRequestPasteSpecial();
+                            } },
+                            "Paste special\u2026",
+                            React.createElement(DropdownRightSlot, null, "\u2318\u2325V")))) : null)),
             enableMagicFill ? (React.createElement(React.Fragment, null,
                 React.createElement(DropdownMenuSeparator, null),
                 React.createElement(DropdownMenuItem, { onClick: () => onAddQuickEdit({
@@ -443,7 +636,26 @@ export const ContextMenu = ({ isRowHeader, isColumnHeader, activeCell, selection
                             React.createElement(ChevronRightIcon, null))),
                     React.createElement(DropdownMenuSubContent, { sideOffset: 2, alignOffset: -5 },
                         React.createElement(DropdownMenuItem, { onClick: () => onRemoveTable?.(activeTable), disabled: readonly }, "Convert to range"),
-                        React.createElement(DropdownMenuItem, { onClick: () => onRequestEditTable?.(activeTable), disabled: readonly }, "Edit table")))) : null,
+                        React.createElement(DropdownMenuItem, { onClick: () => onRequestEditTable?.(activeTable), disabled: readonly }, "Edit table"),
+                        isActiveCellTableTotal ? (React.createElement(DropdownMenuSub, null,
+                            React.createElement(DropdownMenuSubTrigger, { disabled: readonly },
+                                "Total row function",
+                                React.createElement(DropdownRightSlot, null,
+                                    React.createElement(ChevronRightIcon, null))),
+                            React.createElement(DropdownMenuSubContent, { sideOffset: 2, alignOffset: -5 }, TOTAL_ROW_FUNCTIONS.map((option) => (React.createElement(DropdownMenuCheckboxItem, { key: option.id, checked: activeTotalRowFunction === option.id, disabled: readonly, onSelect: () => {
+                                    const formula = getTotalRowFunctionFormula(option.id, activeTable, activeCell.columnIndex);
+                                    if (formula === undefined) {
+                                        return;
+                                    }
+                                    if (formula === "") {
+                                        onClearContents?.(sheetId, activeCell, selectionFromActiveCell(activeCell));
+                                        return;
+                                    }
+                                    onChange?.(sheetId, activeCell, formula, null);
+                                } },
+                                React.createElement(DropdownMenuItemIndicator, null,
+                                    React.createElement(CheckIcon, null)),
+                                option.label)))))) : null))) : null,
                 activePivotTable ? (React.createElement(DropdownMenuSub, null,
                     React.createElement(DropdownMenuSubTrigger, { disabled: readonly },
                         React.createElement(DropdownLeftSlot, null,
@@ -547,9 +759,23 @@ export const ContextMenu = ({ isRowHeader, isColumnHeader, activeCell, selection
                     }, disabled: readonly },
                     React.createElement(DropdownLeftSlot, null,
                         React.createElement(PlusIcon, null)),
-                    "Define named range"))),
+                    "Define named range"),
+                onRequestEvaluateFormula && isActiveCellFormula ? (React.createElement(DropdownMenuItem, { onClick: () => {
+                        shouldFocusSheetRef.current = false;
+                        onRequestEvaluateFormula(sheetId, activeCell);
+                    } },
+                    React.createElement(DropdownLeftSlot, null,
+                        React.createElement(CodeIcon, null)),
+                    "Evaluate formula")) : null,
+                onRequestAddWatch ? (React.createElement(DropdownMenuItem, { onClick: () => {
+                        shouldFocusSheetRef.current = false;
+                        onRequestAddWatch(sheetId, activeCell);
+                    } },
+                    React.createElement(DropdownLeftSlot, null,
+                        React.createElement(EyeOpenIcon, null)),
+                    "Add to Watch Window")) : null)),
             React.createElement(DropdownMenuSeparator, null),
-            React.createElement(DropdownMenuItem, { onClick: () => onRemoveDuplicates?.(sheetId, activeCell, selections), disabled: readonly },
+            React.createElement(DropdownMenuItem, { onClick: handleRemoveDuplicates, disabled: readonly },
                 React.createElement(DropdownLeftSlot, null,
                     React.createElement(RemoveDuplicatesIcon, null)),
                 "Remove duplicates"),
@@ -565,7 +791,23 @@ export const ContextMenu = ({ isRowHeader, isColumnHeader, activeCell, selection
                     React.createElement(DropdownMenuItem, { onClick: () => onSplitTextToColumns?.(sheetId, activeCell, selections, ";") }, "Semicolon"),
                     React.createElement(DropdownMenuItem, { onClick: () => onSplitTextToColumns?.(sheetId, activeCell, selections, ".") }, "Period"),
                     React.createElement(DropdownMenuItem, { onClick: () => onSplitTextToColumns?.(sheetId, activeCell, selections, " ") }, "Space"),
-                    React.createElement(DropdownMenuItem, { onClick: () => onSplitTextToColumns?.(sheetId, activeCell, selections, "|") }, "Pipe"))),
+                    React.createElement(DropdownMenuItem, { onClick: () => onSplitTextToColumns?.(sheetId, activeCell, selections, "|") }, "Pipe"),
+                    isTextToColumnsDialogMounted ? (React.createElement(React.Fragment, null,
+                        React.createElement(DropdownMenuSeparator, null),
+                        React.createElement(DropdownMenuItem, { onClick: handleTextToColumnsDialog }, "Fixed width\u2026"))) : null)),
+            (isSubtotalDialogMounted && onSubtotal) ||
+                (isAdvancedFilterDialogMounted && onAdvancedFilter) ||
+                (isGoalSeekDialogMounted && onGoalSeek) ? (React.createElement(DropdownMenuSub, null,
+                React.createElement(DropdownMenuSubTrigger, { disabled: readonly },
+                    React.createElement(DropdownLeftSlot, null,
+                        React.createElement(SpaceBetweenHorizontallyIcon, null)),
+                    "Data tools",
+                    React.createElement(DropdownRightSlot, null,
+                        React.createElement(ChevronRightIcon, null))),
+                React.createElement(DropdownMenuSubContent, { sideOffset: 2, alignOffset: -5 },
+                    isSubtotalDialogMounted && onSubtotal ? (React.createElement(DropdownMenuItem, { onClick: handleSubtotal }, "Subtotal\u2026")) : null,
+                    isAdvancedFilterDialogMounted && onAdvancedFilter ? (React.createElement(DropdownMenuItem, { onClick: handleAdvancedFilter }, "Advanced filter\u2026")) : null,
+                    isGoalSeekDialogMounted && onGoalSeek ? (React.createElement(DropdownMenuItem, { onClick: handleGoalSeek }, "Goal seek\u2026")) : null))) : null,
             React.createElement(DropdownMenuSub, null,
                 React.createElement(DropdownMenuSubTrigger, { disabled: readonly },
                     React.createElement(DropdownLeftSlot, null,

package/dist/esm/components/context-menu/total-row-functions.d.ts

@@ -0,0 +1,32 @@
+import type { TableView } from "../../types";
+/**
+ * The aggregations Excel offers in a table's totals-row dropdown, each backed
+ * by the `SUBTOTAL` function number that ignores hidden (filtered) rows.
+ */
+export type TotalRowFunction = "none" | "average" | "count" | "countNumbers" | "max" | "min" | "sum" | "stdDev" | "var";
+export type TotalRowFunctionOption = {
+    id: TotalRowFunction;
+    label: string;
+    /** `SUBTOTAL` function number (101–111 = ignore hidden rows). */
+    subtotal?: number;
+};
+export declare const TOTAL_ROW_FUNCTIONS: TotalRowFunctionOption[];
+/**
+ * Escape a column name for use inside a structured reference: `[`, `]`, `#`
+ * and `'` are prefixed with `'`, as Excel does.
+ */
+export declare const escapeStructuredColumnName: (name: string) => string;
+/**
+ * Formula for a totals-row cell, e.g. `=SUBTOTAL(109,Table1[Amount])`.
+ * Qualified with the table name so it evaluates from any engine and matches
+ * what Excel writes for a totals row. Returns `""` for "none" (clear the
+ * cell) and `undefined` when the column has no name to reference.
+ */
+export declare const getTotalRowFunctionFormula: (fn: TotalRowFunction, table: Pick<TableView, "title" | "columns" | "range">, columnIndex: number) => string | undefined;
+/**
+ * Recognise the aggregation a totals-row formula uses, so the picker can show
+ * the active choice. Both the hidden-row-aware (1xx) and plain (1–11)
+ * `SUBTOTAL` numbers map to the same option; anything else is "none".
+ */
+export declare const getTotalRowFunctionFromFormula: (formula: string | null | undefined) => TotalRowFunction;
+//# sourceMappingURL=total-row-functions.d.ts.map

package/dist/esm/components/context-menu/total-row-functions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"total-row-functions.d.ts","sourceRoot":"","sources":["../../../../components/context-menu/total-row-functions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE7C;;;GAGG;AACH,MAAM,MAAM,gBAAgB,GACxB,MAAM,GACN,SAAS,GACT,OAAO,GACP,cAAc,GACd,KAAK,GACL,KAAK,GACL,KAAK,GACL,QAAQ,GACR,KAAK,CAAC;AAEV,MAAM,MAAM,sBAAsB,GAAG;IACnC,EAAE,EAAE,gBAAgB,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,iEAAiE;IACjE,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,eAAO,MAAM,mBAAmB,EAAE,sBAAsB,EAUvD,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,0BAA0B,GAAI,MAAM,MAAM,WACnB,CAAC;AAErC;;;;;GAKG;AACH,eAAO,MAAM,0BAA0B,GACrC,IAAI,gBAAgB,EACpB,OAAO,IAAI,CAAC,SAAS,EAAE,OAAO,GAAG,SAAS,GAAG,OAAO,CAAC,EACrD,aAAa,MAAM,KAClB,MAAM,GAAG,SAaX,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,8BAA8B,GACzC,SAAS,MAAM,GAAG,IAAI,GAAG,SAAS,KACjC,gBAgBF,CAAC"}

package/dist/esm/components/context-menu/total-row-functions.js

@@ -0,0 +1,50 @@
+export const TOTAL_ROW_FUNCTIONS = [
+    { id: "none", label: "None" },
+    { id: "average", label: "Average", subtotal: 101 },
+    { id: "count", label: "Count", subtotal: 103 },
+    { id: "countNumbers", label: "Count Numbers", subtotal: 102 },
+    { id: "max", label: "Max", subtotal: 104 },
+    { id: "min", label: "Min", subtotal: 105 },
+    { id: "sum", label: "Sum", subtotal: 109 },
+    { id: "stdDev", label: "StdDev", subtotal: 107 },
+    { id: "var", label: "Var", subtotal: 110 },
+];
+/**
+ * Escape a column name for use inside a structured reference: `[`, `]`, `#`
+ * and `'` are prefixed with `'`, as Excel does.
+ */
+export const escapeStructuredColumnName = (name) => name.replace(/(['\[\]#])/g, "'$1");
+/**
+ * Formula for a totals-row cell, e.g. `=SUBTOTAL(109,Table1[Amount])`.
+ * Qualified with the table name so it evaluates from any engine and matches
+ * what Excel writes for a totals row. Returns `""` for "none" (clear the
+ * cell) and `undefined` when the column has no name to reference.
+ */
+export const getTotalRowFunctionFormula = (fn, table, columnIndex) => {
+    if (fn === "none") {
+        return "";
+    }
+    const option = TOTAL_ROW_FUNCTIONS.find((item) => item.id === fn);
+    const columnName = table.columns?.[columnIndex - table.range.startColumnIndex]?.name;
+    if (!option?.subtotal || !columnName || !table.title) {
+        return undefined;
+    }
+    return `=SUBTOTAL(${option.subtotal},${table.title}[${escapeStructuredColumnName(columnName)}])`;
+};
+/**
+ * Recognise the aggregation a totals-row formula uses, so the picker can show
+ * the active choice. Both the hidden-row-aware (1xx) and plain (1–11)
+ * `SUBTOTAL` numbers map to the same option; anything else is "none".
+ */
+export const getTotalRowFunctionFromFormula = (formula) => {
+    if (!formula) {
+        return "none";
+    }
+    const match = /^\s*=\s*SUBTOTAL\s*\(\s*(\d{1,3})\s*,/i.exec(formula);
+    if (!match) {
+        return "none";
+    }
+    const number = Number(match[1]);
+    const normalized = number > 100 ? number - 100 : number;
+    return (TOTAL_ROW_FUNCTIONS.find((item) => item.subtotal !== undefined && item.subtotal - 100 === normalized)?.id ?? "none");
+};

package/dist/esm/components/embeds/embed-component.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"embed-component.d.ts","sourceRoot":"","sources":["../../../../components/embeds/embed-component.tsx"],"names":[],"mappings":"AASA,OAAO,KAAe,MAAM,OAAO,CAAC;AAEpC,OAAO,KAAK,EACV,cAAc,EAIf,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAIhF,MAAM,MAAM,mBAAmB,GAAG;IAChC,KAAK,EAAE,cAAc,CAAC;IACtB,KAAK,EAAE,gBAAgB,CAAC;IACxB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,OAAO,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,aAAa,EAAE,eAAe,CAAC,eAAe,CAAC,CAAC;IAChD,kBAAkB,EAAE,eAAe,CAAC,oBAAoB,CAAC,CAAC;CAC3D,CAAC;AAEF,eAAO,MAAM,cAAc,wHAUtB,mBAAmB,uBA+LvB,CAAC"}
+{"version":3,"file":"embed-component.d.ts","sourceRoot":"","sources":["../../../../components/embeds/embed-component.tsx"],"names":[],"mappings":"AASA,OAAO,KAAe,MAAM,OAAO,CAAC;AAEpC,OAAO,KAAK,EACV,cAAc,EAKf,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAKhF,MAAM,MAAM,mBAAmB,GAAG;IAChC,KAAK,EAAE,cAAc,CAAC;IACtB,KAAK,EAAE,gBAAgB,CAAC;IACxB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,OAAO,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,aAAa,EAAE,eAAe,CAAC,eAAe,CAAC,CAAC;IAChD,kBAAkB,EAAE,eAAe,CAAC,oBAAoB,CAAC,CAAC;CAC3D,CAAC;AAEF,eAAO,MAAM,cAAc,wHAUtB,mBAAmB,uBA4NvB,CAAC"}

package/dist/esm/components/embeds/embed-component.js

@@ -2,6 +2,7 @@ import { DotsVerticalIcon } from "@rowsncolumns/icons";
 import { DropdownMenu, DropdownMenuContent, DropdownMenuItem, DropdownMenuPortal, DropdownMenuTrigger, IconButton, } from "@rowsncolumns/ui";
 import React, { memo } from "react";
 import { getStringifiedColor } from "../../themes";
+import { resolveCanvasTextAlign } from "../cell/alignment";
 import { ShapeSvg } from "./shape-svg";
 export const EmbedComponent = memo(({ embed, width, height, readonly, isSelected, onDeleteEmbed, onRequestEditEmbed, theme, }) => {
     const renderTextBox = (spec) => {
@@ -39,7 +40,9 @@ export const EmbedComponent = memo(({ embed, width, height, readonly, isSelected
             height: "100%",
             backgroundColor,
             padding: spec.padding ? `${spec.padding}px` : "4px",
-            textAlign: spec.horizontalAlignment || undefined,
+            textAlign: spec.horizontalAlignment
+                ? resolveCanvasTextAlign(spec.horizontalAlignment)
+                : undefined,
             display: "flex",
             flexDirection: "column",
             justifyContent: spec.verticalAlignment === "top"
@@ -110,6 +113,19 @@ export const EmbedComponent = memo(({ embed, width, height, readonly, isSelected
                 type: "textbox",
                 ...embed.spec.textBody,
             }))) : null)) : null,
+        embed?.spec.type === "formControl" ? (
+        // Excel form controls round-trip but are not interactive here: draw
+        // the caption in a control-shaped placeholder so the layout reads.
+        React.createElement("div", { className: "flex h-full w-full items-center gap-1 overflow-hidden whitespace-nowrap px-1 text-xs", title: embed.spec.name ?? undefined },
+            embed.spec.objectType === "CheckBox" ||
+                embed.spec.objectType === "Radio" ? (React.createElement("span", { className: "inline-block h-3 w-3 shrink-0 border border-current", style: {
+                    borderRadius: embed.spec.objectType === "Radio"
+                        ? "50%"
+                        : 2,
+                } })) : null,
+            React.createElement("span", { className: "truncate" }, embed.spec.text ??
+                embed.spec.name ??
+                embed.spec.objectType))) : null,
         readonly || !isSelected ? null : (React.createElement(DropdownMenu, null,
             React.createElement(DropdownMenuTrigger, { asChild: true, className: "print:hidden" },
                 React.createElement(IconButton, { className: "absolute right-1 top-1 z-10" },

package/dist/esm/components/evaluate-formula-dialog/index.d.ts

@@ -0,0 +1,34 @@
+import { type EvaluationValue } from "@rowsncolumns/calculator";
+import React from "react";
+export type EvaluateFormulaDialogProps = {
+    /** Controls visibility. */
+    open: boolean;
+    onOpenChange(open: boolean): void;
+    /** Display label of the evaluated cell, e.g. `Sheet1!$A$1`. */
+    reference: string;
+    /** The cell's formula, including the leading `=`. */
+    formula: string;
+    /**
+     * Scratch-evaluates one sub-expression (no leading `=`) in the cell's
+     * context. Errors come back as `{ error: "#DIV/0!" }`, blanks as `null`.
+     */
+    evaluate(expression: string): Promise<EvaluationValue>;
+};
+/**
+ * Excel's Evaluate Formula dialog: a read-only stepper that underlines the
+ * next sub-expression the calculator would resolve and, on Evaluate,
+ * replaces it with its value until only the result remains. Nothing is
+ * written to the sheet.
+ */
+export declare const EvaluateFormulaDialog: React.MemoExoticComponent<({ open, onOpenChange, reference, formula, evaluate, }: EvaluateFormulaDialogProps) => React.JSX.Element>;
+/**
+ * Host-mounted, atom-driven wrapper around {@link EvaluateFormulaDialog}.
+ * Mount it once in the host alongside the other editor dialogs; the grid
+ * opens it from the context menu ("Evaluate formula…") for a formula cell.
+ * Keyed per request so each opening restarts from the cell's formula.
+ */
+export declare const EvaluateFormulaDialogHost: {
+    (): React.JSX.Element | null;
+    displayName: string;
+};
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/components/evaluate-formula-dialog/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../components/evaluate-formula-dialog/index.tsx"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,eAAe,EAErB,MAAM,0BAA0B,CAAC;AAWlC,OAAO,KAAsC,MAAM,OAAO,CAAC;AAQ3D,MAAM,MAAM,0BAA0B,GAAG;IACvC,2BAA2B;IAC3B,IAAI,EAAE,OAAO,CAAC;IACd,YAAY,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,CAAC;IAClC,+DAA+D;IAC/D,SAAS,EAAE,MAAM,CAAC;IAClB,qDAAqD;IACrD,OAAO,EAAE,MAAM,CAAC;IAChB;;;OAGG;IACH,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;CACxD,CAAC;AAKF;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB,oFAO7B,0BAA0B,uBAiG9B,CAAC;AAUF;;;;;GAKG;AACH,eAAO,MAAM,yBAAyB;;;CAiBrC,CAAC"}

package/dist/esm/components/evaluate-formula-dialog/index.js

@@ -0,0 +1,86 @@
+import { advanceFormulaEvaluation, createFormulaEvaluation, } from "@rowsncolumns/calculator";
+import { Button, Dialog, DialogBody, DialogCloseButton, DialogContent, DialogTitle, Separator, } from "@rowsncolumns/ui";
+import { cellToAddress, sanitizeSheetName } from "@rowsncolumns/utils";
+import React, { memo, useCallback, useState } from "react";
+import { useEvaluateFormulaDialogState, useRegisterEvaluateFormulaDialogHost, } from "../../atoms/evaluate-formula-dialog.atom";
+const CANNOT_EVALUATE = "This formula cannot be stepped through. Check it for syntax errors.";
+/**
+ * Excel's Evaluate Formula dialog: a read-only stepper that underlines the
+ * next sub-expression the calculator would resolve and, on Evaluate,
+ * replaces it with its value until only the result remains. Nothing is
+ * written to the sheet.
+ */
+export const EvaluateFormulaDialog = memo(({ open, onOpenChange, reference, formula, evaluate, }) => {
+    const [state, setState] = useState(() => createFormulaEvaluation(formula));
+    const [busy, setBusy] = useState(false);
+    const [failure, setFailure] = useState(undefined);
+    const step = useCallback(async () => {
+        if (!state || state.done || busy)
+            return;
+        setBusy(true);
+        try {
+            setState(await advanceFormulaEvaluation(state, evaluate));
+            setFailure(undefined);
+        }
+        catch (err) {
+            setFailure(err instanceof Error ? err.message : "The expression could not be evaluated.");
+        }
+        finally {
+            setBusy(false);
+        }
+    }, [state, busy, evaluate]);
+    const restart = useCallback(() => {
+        setState(createFormulaEvaluation(formula));
+        setFailure(undefined);
+    }, [formula]);
+    const target = state?.target;
+    const before = state && target ? state.text.slice(0, target.start) : "";
+    const underlined = state && target ? state.text.slice(target.start, target.end + 1) : "";
+    const after = state && target ? state.text.slice(target.end + 1) : "";
+    return (React.createElement(Dialog, { open: open, onOpenChange: onOpenChange, modal: true },
+        React.createElement(DialogContent, { className: "w-[520px] max-w-[92vw] pointer-events-auto" },
+            React.createElement(DialogTitle, null, "Evaluate Formula"),
+            React.createElement(DialogCloseButton, null),
+            React.createElement(DialogBody, { className: "flex flex-col gap-3" },
+                React.createElement("div", { className: "grid grid-cols-[auto_1fr] gap-x-4 gap-y-1 text-xs" },
+                    React.createElement("span", { className: "font-medium" }, "Reference:"),
+                    React.createElement("span", { className: "font-mono" }, reference),
+                    React.createElement("span", { className: "font-medium" }, "Evaluation:"),
+                    React.createElement("div", { "data-testid": "evaluate-formula-expression", className: "font-mono whitespace-pre-wrap break-all rounded border border-rnc-border px-2 py-1.5 min-h-[64px]" }, state ? (state.done ? (React.createElement("span", { className: "italic" },
+                        "= ",
+                        state.text)) : (React.createElement(React.Fragment, null,
+                        "= ",
+                        before,
+                        React.createElement("u", { "data-testid": "evaluate-formula-target" }, underlined),
+                        after))) : (React.createElement("span", { className: "text-rnc-destructive" }, CANNOT_EVALUATE)))),
+                failure ? (React.createElement("div", { role: "alert", className: "text-xs text-rnc-destructive" }, failure)) : null,
+                React.createElement("p", { className: "text-xs text-rnc-foreground/70" }, "To show the result of the underlined expression, click Evaluate. The final result appears italicized."),
+                React.createElement(Separator, null),
+                React.createElement("div", { className: "flex justify-end gap-2" },
+                    React.createElement(Button, { variant: "outline", size: "sm", onClick: () => onOpenChange(false) }, "Close"),
+                    state?.done ? (React.createElement(Button, { size: "sm", onClick: restart }, "Restart")) : (React.createElement(Button, { size: "sm", onClick: step, disabled: !state || busy }, "Evaluate")))))));
+});
+EvaluateFormulaDialog.displayName = "EvaluateFormulaDialog";
+const referenceOf = (request) => {
+    const address = cellToAddress(request.cell, true, true) ?? "";
+    const sheetName = sanitizeSheetName(request.sheetName);
+    return sheetName ? `${sheetName}!${address}` : address;
+};
+/**
+ * Host-mounted, atom-driven wrapper around {@link EvaluateFormulaDialog}.
+ * Mount it once in the host alongside the other editor dialogs; the grid
+ * opens it from the context menu ("Evaluate formula…") for a formula cell.
+ * Keyed per request so each opening restarts from the cell's formula.
+ */
+export const EvaluateFormulaDialogHost = () => {
+    useRegisterEvaluateFormulaDialogHost();
+    const [request, setRequest] = useEvaluateFormulaDialogState();
+    const close = useCallback(() => setRequest(null), [setRequest]);
+    if (!request)
+        return null;
+    return (React.createElement(EvaluateFormulaDialog, { key: `${request.sheetId}:${request.cell.rowIndex}:${request.cell.columnIndex}:${request.formula}`, open: true, onOpenChange: (open) => {
+            if (!open)
+                close();
+        }, reference: referenceOf(request), formula: request.formula, evaluate: request.evaluate }));
+};
+EvaluateFormulaDialogHost.displayName = "EvaluateFormulaDialogHost";

package/dist/esm/components/go-to-dialog/index.d.ts

@@ -0,0 +1,45 @@
+import type { GridRange } from "@rowsncolumns/grid";
+import React from "react";
+import { type GoToSpecialKind } from "../../api/go-to-special";
+import type { NamedRange, SheetRange } from "../../types";
+export type GoToDialogProps = {
+    /** Controls visibility. */
+    open: boolean;
+    onOpenChange(open: boolean): void;
+    /** Defined names listed in the "Go to" box; picking one fills the reference. */
+    namedRanges?: NamedRange[] | null;
+    /** Shown as the placeholder of the reference box (the current location). */
+    currentAddress?: string;
+    /**
+     * Resolves the typed text to a range, or `undefined` when it is not a
+     * valid reference / name (the dialog then shows Excel's error).
+     */
+    resolve(reference: string): SheetRange | undefined;
+    /** Receives the resolved range; the host selects and scrolls to it. */
+    onNavigate(range: SheetRange): void;
+    /**
+     * Go To Special. `resolve` returns the matching cell runs for a category;
+     * `onSelectRanges` receives them. Omit to hide the "Special…" panel.
+     */
+    special?: {
+        resolve(kind: GoToSpecialKind): GridRange[];
+        onSelectRanges(ranges: GridRange[]): void;
+    };
+};
+/**
+ * Excel's Go To dialog (`Ctrl+G` / `F5`): type a cell or range reference,
+ * optionally sheet-qualified, or pick a defined name, and the selection
+ * jumps there. Resolution is delegated to `resolve` so the dialog stays
+ * UI-only.
+ */
+export declare const GoToDialog: React.MemoExoticComponent<({ open, onOpenChange, namedRanges, currentAddress, resolve, onNavigate, special, }: GoToDialogProps) => React.JSX.Element>;
+/**
+ * Host-mounted, atom-driven wrapper around {@link GoToDialog}. Mount it once
+ * in the host alongside the other editor dialogs; the grid opens it on
+ * `Ctrl+G` / `F5` (unless the host handles `onRequestGoTo` itself).
+ */
+export declare const GoToDialogHost: {
+    (): React.JSX.Element | null;
+    displayName: string;
+};
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/components/go-to-dialog/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../components/go-to-dialog/index.tsx"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAEpD,OAAO,KAAsC,MAAM,OAAO,CAAC;AAG3D,OAAO,EAEL,KAAK,eAAe,EACrB,MAAM,yBAAyB,CAAC;AAMjC,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE1D,MAAM,MAAM,eAAe,GAAG;IAC5B,2BAA2B;IAC3B,IAAI,EAAE,OAAO,CAAC;IACd,YAAY,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,CAAC;IAClC,gFAAgF;IAChF,WAAW,CAAC,EAAE,UAAU,EAAE,GAAG,IAAI,CAAC;IAClC,4EAA4E;IAC5E,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB;;;OAGG;IACH,OAAO,CAAC,SAAS,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS,CAAC;IACnD,uEAAuE;IACvE,UAAU,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI,CAAC;IACpC;;;OAGG;IACH,OAAO,CAAC,EAAE;QACR,OAAO,CAAC,IAAI,EAAE,eAAe,GAAG,SAAS,EAAE,CAAC;QAC5C,cAAc,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,IAAI,CAAC;KAC3C,CAAC;CACH,CAAC;AAKF;;;;;GAKG;AACH,eAAO,MAAM,UAAU,iHASlB,eAAe,uBA0MnB,CAAC;AAUF;;;;GAIG;AACH,eAAO,MAAM,cAAc;;;CA+B1B,CAAC"}