@rowsncolumns/spreadsheet 10.2.74 → 10.2.76

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

@@ -1,15 +1,19 @@
 import { Direction, isCellWithinBounds, selectionFromActiveCell, } from "@rowsncolumns/grid";
 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 { number2Alpha } from "@rowsncolumns/utils";
+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";
 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, 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, onChange, getCellData, isHiddenColumn, isHiddenRow, onShowColumn, onShowRow, tables, pivotTables, protectedRanges, sheetId, frozenRows, frozenColumns, selectedRowHeadersIds, selectedColumnHeadersIds, readonly = false, onAddQuickEdit, enableMagicFill, }) => {
+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");
@@ -39,6 +43,114 @@ 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.
@@ -654,7 +766,14 @@ export const ContextMenu = ({ isRowHeader, isColumnHeader, activeCell, selection
                     } },
                     React.createElement(DropdownLeftSlot, null,
                         React.createElement(CodeIcon, null)),
-                    "Evaluate formula")) : 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: handleRemoveDuplicates, disabled: readonly },
                 React.createElement(DropdownLeftSlot, null,
@@ -672,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/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/fill-series-dialog/index.d.ts

@@ -0,0 +1,29 @@
+import React from "react";
+import type { FillSeriesSpec } from "../../types";
+export type FillSeriesDialogProps = {
+    /** Controls visibility. */
+    open: boolean;
+    onOpenChange(open: boolean): void;
+    /** Pre-selected axis (a right-drag seeds it from its direction). */
+    initialIn?: FillSeriesSpec["in"];
+    onApply(spec: FillSeriesSpec): void;
+};
+/**
+ * Excel's Series dialog (Home > Fill > Series…). Series in Rows/Columns, Type
+ * Linear/Growth/Date/AutoFill, Date unit (Type = Date only), Trend
+ * (Linear/Growth only — disables Step/Stop), Step value (default 1, may be
+ * negative or fractional) and Stop value. UI-only: the opener turns the spec
+ * into a fill.
+ */
+export declare const FillSeriesDialog: React.MemoExoticComponent<({ open, onOpenChange, initialIn, onApply }: FillSeriesDialogProps) => React.JSX.Element>;
+/**
+ * Host-mounted, atom-driven wrapper around {@link FillSeriesDialog}. Mount it
+ * once alongside the other editor dialogs; the grid opens it via
+ * `useOpenFillSeriesDialog` (right-drag menu "Series…", or
+ * `SpreadsheetApi.openFillSeriesDialog()` from a Fill toolbar/menu).
+ */
+export declare const FillSeriesDialogHost: {
+    (): React.JSX.Element;
+    displayName: string;
+};
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/components/fill-series-dialog/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../components/fill-series-dialog/index.tsx"],"names":[],"mappings":"AAUA,OAAO,KAAiD,MAAM,OAAO,CAAC;AAGtE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAElD,MAAM,MAAM,qBAAqB,GAAG;IAClC,2BAA2B;IAC3B,IAAI,EAAE,OAAO,CAAC;IACd,YAAY,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,CAAC;IAClC,oEAAoE;IACpE,SAAS,CAAC,EAAE,cAAc,CAAC,IAAI,CAAC,CAAC;IACjC,OAAO,CAAC,IAAI,EAAE,cAAc,GAAG,IAAI,CAAC;CACrC,CAAC;AA0BF;;;;;;GAMG;AACH,eAAO,MAAM,gBAAgB,yEACkB,qBAAqB,uBA4MnE,CAAC;AAIF;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB;;;CAahC,CAAC"}

package/dist/esm/components/fill-series-dialog/index.js

@@ -0,0 +1,151 @@
+import { Button, Dialog, DialogBody, DialogCloseButton, DialogContent, DialogTitle, Input, Separator, } from "@rowsncolumns/ui";
+import React, { memo, useCallback, useEffect, useState } from "react";
+import { useFillSeriesDialogState } from "../../atoms/fill-series-dialog.atom";
+const SERIES_TYPES = [
+    { value: "linear", label: "Linear" },
+    { value: "growth", label: "Growth" },
+    { value: "date", label: "Date" },
+    { value: "autofill", label: "AutoFill" },
+];
+const DATE_UNITS = [
+    { value: "day", label: "Day" },
+    { value: "weekday", label: "Weekday" },
+    { value: "month", label: "Month" },
+    { value: "year", label: "Year" },
+];
+const parseNumber = (text) => {
+    const trimmed = text.trim();
+    if (!trimmed)
+        return undefined;
+    const n = Number(trimmed);
+    return Number.isFinite(n) ? n : undefined;
+};
+/**
+ * Excel's Series dialog (Home > Fill > Series…). Series in Rows/Columns, Type
+ * Linear/Growth/Date/AutoFill, Date unit (Type = Date only), Trend
+ * (Linear/Growth only — disables Step/Stop), Step value (default 1, may be
+ * negative or fractional) and Stop value. UI-only: the opener turns the spec
+ * into a fill.
+ */
+export const FillSeriesDialog = memo(({ open, onOpenChange, initialIn, onApply }) => {
+    const [axis, setAxis] = useState(initialIn ?? "columns");
+    const [type, setType] = useState("linear");
+    const [dateUnit, setDateUnit] = useState("day");
+    const [trend, setTrend] = useState(false);
+    const [step, setStep] = useState("1");
+    const [stop, setStop] = useState("");
+    const [error, setError] = useState(undefined);
+    // Re-seed on every open (the request decides the default axis).
+    useEffect(() => {
+        if (open) {
+            setAxis(initialIn ?? "columns");
+            setType("linear");
+            setDateUnit("day");
+            setTrend(false);
+            setStep("1");
+            setStop("");
+            setError(undefined);
+        }
+    }, [open, initialIn]);
+    const trendAllowed = type === "linear" || type === "growth";
+    const stepStopDisabled = trendAllowed && trend;
+    const apply = useCallback(() => {
+        const stepValue = parseNumber(step);
+        if (!stepStopDisabled && step.trim() && stepValue === undefined) {
+            setError("Step value must be a number.");
+            return;
+        }
+        const stopValue = parseNumber(stop);
+        if (!stepStopDisabled && stop.trim() && stopValue === undefined) {
+            setError("Stop value must be a number.");
+            return;
+        }
+        const spec = {
+            in: axis,
+            type,
+            ...(type === "date" ? { dateUnit } : {}),
+            ...(trendAllowed && trend ? { trend: true } : {}),
+            ...(!stepStopDisabled && stepValue !== undefined
+                ? { step: stepValue }
+                : {}),
+            ...(!stepStopDisabled && stopValue !== undefined
+                ? { stop: stopValue }
+                : {}),
+        };
+        onApply(spec);
+        onOpenChange(false);
+    }, [
+        axis,
+        type,
+        dateUnit,
+        trend,
+        trendAllowed,
+        step,
+        stop,
+        stepStopDisabled,
+        onApply,
+        onOpenChange,
+    ]);
+    return (React.createElement(Dialog, { open: open, onOpenChange: onOpenChange, modal: true },
+        React.createElement(DialogContent, { className: "w-[420px] max-w-[92vw] pointer-events-auto" },
+            React.createElement(DialogTitle, null, "Series"),
+            React.createElement(DialogCloseButton, null),
+            React.createElement(DialogBody, { className: "flex flex-col gap-3" },
+                React.createElement("form", { className: "flex flex-col gap-3", onSubmit: (e) => {
+                        e.preventDefault();
+                        apply();
+                    } },
+                    React.createElement("div", { className: "grid grid-cols-3 gap-3" },
+                        React.createElement("fieldset", { className: "flex flex-col gap-1 border-0 p-0 m-0" },
+                            React.createElement("legend", { className: "text-xs font-medium pb-1" }, "Series in"),
+                            ["rows", "columns"].map((value) => (React.createElement("label", { key: value, className: "flex items-center gap-2 text-xs cursor-pointer" },
+                                React.createElement("input", { type: "radio", name: "fillSeriesIn", value: value, checked: axis === value, onChange: () => setAxis(value) }),
+                                value === "rows" ? "Rows" : "Columns")))),
+                        React.createElement("fieldset", { className: "flex flex-col gap-1 border-0 p-0 m-0" },
+                            React.createElement("legend", { className: "text-xs font-medium pb-1" }, "Type"),
+                            SERIES_TYPES.map(({ value, label }) => (React.createElement("label", { key: value, className: "flex items-center gap-2 text-xs cursor-pointer" },
+                                React.createElement("input", { type: "radio", name: "fillSeriesType", value: value, checked: type === value, onChange: () => setType(value) }),
+                                label)))),
+                        React.createElement("fieldset", { className: "flex flex-col gap-1 border-0 p-0 m-0", disabled: type !== "date" },
+                            React.createElement("legend", { className: "text-xs font-medium pb-1" }, "Date unit"),
+                            DATE_UNITS.map(({ value, label }) => (React.createElement("label", { key: value, className: "flex items-center gap-2 text-xs cursor-pointer disabled:opacity-50" },
+                                React.createElement("input", { type: "radio", name: "fillSeriesDateUnit", value: value, checked: dateUnit === value, onChange: () => setDateUnit(value), disabled: type !== "date" }),
+                                React.createElement("span", { className: type !== "date" ? "opacity-50" : "" }, label)))))),
+                    React.createElement("label", { className: "flex items-center gap-2 text-xs cursor-pointer" },
+                        React.createElement("input", { type: "checkbox", name: "fillSeriesTrend", checked: trendAllowed && trend, disabled: !trendAllowed, onChange: (e) => setTrend(e.target.checked) }),
+                        React.createElement("span", { className: !trendAllowed ? "opacity-50" : "" }, "Trend")),
+                    React.createElement("div", { className: "grid grid-cols-2 gap-3" },
+                        React.createElement("label", { className: "flex flex-col gap-1 text-xs" },
+                            "Step value",
+                            React.createElement(Input, { name: "fillSeriesStep", value: step, disabled: stepStopDisabled, onChange: (e) => {
+                                    setStep(e.target.value);
+                                    setError(undefined);
+                                }, inputMode: "decimal" })),
+                        React.createElement("label", { className: "flex flex-col gap-1 text-xs" },
+                            "Stop value",
+                            React.createElement(Input, { name: "fillSeriesStop", value: stop, disabled: stepStopDisabled, onChange: (e) => {
+                                    setStop(e.target.value);
+                                    setError(undefined);
+                                }, inputMode: "decimal" }))),
+                    error ? (React.createElement("div", { role: "alert", className: "text-xs text-rnc-destructive" }, error)) : null,
+                    React.createElement(Separator, null),
+                    React.createElement("div", { className: "flex justify-end gap-2" },
+                        React.createElement(Button, { type: "button", variant: "ghost", size: "sm", onClick: () => onOpenChange(false) }, "Cancel"),
+                        React.createElement(Button, { type: "submit", size: "sm" }, "OK")))))));
+});
+FillSeriesDialog.displayName = "FillSeriesDialog";
+/**
+ * Host-mounted, atom-driven wrapper around {@link FillSeriesDialog}. Mount it
+ * once alongside the other editor dialogs; the grid opens it via
+ * `useOpenFillSeriesDialog` (right-drag menu "Series…", or
+ * `SpreadsheetApi.openFillSeriesDialog()` from a Fill toolbar/menu).
+ */
+export const FillSeriesDialogHost = () => {
+    const [request, setRequest] = useFillSeriesDialogState();
+    const close = useCallback(() => setRequest(null), [setRequest]);
+    return (React.createElement(FillSeriesDialog, { open: request != null, onOpenChange: (open) => {
+            if (!open)
+                close();
+        }, initialIn: request?.initialIn, onApply: (spec) => request?.onApply(spec) }));
+};
+FillSeriesDialogHost.displayName = "FillSeriesDialogHost";

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

@@ -1,4 +1,6 @@
+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. */
@@ -15,6 +17,14 @@ export type GoToDialogProps = {
     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,
@@ -22,7 +32,7 @@ export type GoToDialogProps = {
  * 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, }: GoToDialogProps) => React.JSX.Element>;
+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

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../components/go-to-dialog/index.tsx"],"names":[],"mappings":"AAYA,OAAO,KAAsC,MAAM,OAAO,CAAC;AAQ3D,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;CACrC,CAAC;AAIF;;;;;GAKG;AACH,eAAO,MAAM,UAAU,wGAQlB,eAAe,uBA4GnB,CAAC;AAUF;;;;GAIG;AACH,eAAO,MAAM,cAAc;;;CA8B1B,CAAC"}
+{"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"}

package/dist/esm/components/go-to-dialog/index.js

@@ -2,17 +2,32 @@ import { Button, cn, Dialog, DialogBody, DialogCloseButton, DialogContent, Dialo
 import { cellToAddress } from "@rowsncolumns/utils";
 import React, { memo, useCallback, useState } from "react";
 import { resolveGoToReference } from "../../api/go-to";
+import { GO_TO_SPECIAL_OPTIONS, } from "../../api/go-to-special";
 import { useGoToDialogState, useRegisterGoToDialogHost, } from "../../atoms/go-to-dialog.atom";
 const INVALID_REFERENCE = "Reference is not valid.";
+const NO_CELLS_FOUND = "No cells were found.";
 /**
  * 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 const GoToDialog = memo(({ open, onOpenChange, namedRanges, currentAddress, resolve, onNavigate, }) => {
+export const GoToDialog = memo(({ open, onOpenChange, namedRanges, currentAddress, resolve, onNavigate, special, }) => {
     const [reference, setReference] = useState("");
     const [error, setError] = useState(undefined);
+    const [showSpecial, setShowSpecial] = useState(false);
+    const [specialKind, setSpecialKind] = useState("blanks");
+    const selectSpecial = useCallback(() => {
+        if (!special)
+            return;
+        const ranges = special.resolve(specialKind);
+        if (!ranges.length) {
+            setError(NO_CELLS_FOUND);
+            return;
+        }
+        special.onSelectRanges(ranges);
+        onOpenChange(false);
+    }, [special, specialKind, onOpenChange]);
     const navigate = useCallback((text) => {
         const range = resolve(text);
         if (!range) {
@@ -25,30 +40,55 @@ export const GoToDialog = memo(({ open, onOpenChange, namedRanges, currentAddres
     const names = (namedRanges ?? []).filter((range) => range.range && !range.hidden);
     return (React.createElement(Dialog, { open: open, onOpenChange: onOpenChange, modal: true },
         React.createElement(DialogContent, { className: "w-[360px] max-w-[92vw] pointer-events-auto" },
-            React.createElement(DialogTitle, null, "Go To"),
+            React.createElement(DialogTitle, null, showSpecial ? "Go To Special" : "Go To"),
             React.createElement(DialogCloseButton, null),
-            React.createElement(DialogBody, { className: "flex flex-col gap-3" },
-                React.createElement("form", { className: "flex flex-col gap-3", onSubmit: (e) => {
-                        e.preventDefault();
-                        navigate(reference);
-                    } },
-                    React.createElement("div", { className: "flex flex-col gap-1" },
-                        React.createElement("span", { className: "text-xs font-medium" }, "Go to:"),
-                        React.createElement("div", { role: "listbox", "aria-label": "Defined names", className: "h-[140px] overflow-auto rounded border border-rnc-border text-xs" }, names.length === 0 ? (React.createElement("div", { className: "px-2 py-1.5 text-rnc-foreground/60" }, "No defined names")) : (names.map((range) => (React.createElement("div", { key: String(range.namedRangeId), role: "option", "aria-selected": reference === range.name, className: cn("px-2 py-1 cursor-default select-none hover:bg-rnc-accent", reference === range.name && "bg-rnc-accent"), onClick: () => {
-                                setReference(range.name);
-                                setError(undefined);
-                            }, onDoubleClick: () => navigate(range.name) }, range.name)))))),
-                    React.createElement("label", { className: "flex flex-col gap-1 text-xs font-medium" },
-                        "Reference:",
-                        React.createElement(Input, { autoFocus: true, value: reference, placeholder: currentAddress, "aria-invalid": error ? true : undefined, onChange: (e) => {
-                                setReference(e.target.value);
+            React.createElement(DialogBody, { className: "flex flex-col gap-3" }, showSpecial && special ? (React.createElement("form", { className: "flex flex-col gap-3", onSubmit: (e) => {
+                    e.preventDefault();
+                    selectSpecial();
+                } },
+                React.createElement("fieldset", { className: "flex flex-col gap-1 border-0 p-0 m-0" },
+                    React.createElement("legend", { className: "text-xs font-medium pb-1" }, "Select"),
+                    GO_TO_SPECIAL_OPTIONS.map(({ kind, label }) => (React.createElement("label", { key: kind, className: "flex items-center gap-2 text-xs cursor-pointer" },
+                        React.createElement("input", { type: "radio", name: "goToSpecial", value: kind, checked: specialKind === kind, onChange: () => {
+                                setSpecialKind(kind);
                                 setError(undefined);
-                            } })),
-                    error ? (React.createElement("div", { role: "alert", className: "text-xs text-rnc-destructive" }, error)) : null,
-                    React.createElement(Separator, null),
-                    React.createElement("div", { className: "flex justify-end gap-2" },
+                            } }),
+                        label)))),
+                error ? (React.createElement("div", { role: "alert", className: "text-xs text-rnc-destructive" }, error)) : null,
+                React.createElement(Separator, null),
+                React.createElement("div", { className: "flex justify-between gap-2" },
+                    React.createElement(Button, { type: "button", variant: "ghost", size: "sm", onClick: () => {
+                            setShowSpecial(false);
+                            setError(undefined);
+                        } }, "Back"),
+                    React.createElement("div", { className: "flex gap-2" },
+                        React.createElement(Button, { type: "button", variant: "outline", size: "sm", onClick: () => onOpenChange(false) }, "Cancel"),
+                        React.createElement(Button, { type: "submit", size: "sm" }, "OK"))))) : (React.createElement("form", { className: "flex flex-col gap-3", onSubmit: (e) => {
+                    e.preventDefault();
+                    navigate(reference);
+                } },
+                React.createElement("div", { className: "flex flex-col gap-1" },
+                    React.createElement("span", { className: "text-xs font-medium" }, "Go to:"),
+                    React.createElement("div", { role: "listbox", "aria-label": "Defined names", className: "h-[140px] overflow-auto rounded border border-rnc-border text-xs" }, names.length === 0 ? (React.createElement("div", { className: "px-2 py-1.5 text-rnc-foreground/60" }, "No defined names")) : (names.map((range) => (React.createElement("div", { key: String(range.namedRangeId), role: "option", "aria-selected": reference === range.name, className: cn("px-2 py-1 cursor-default select-none hover:bg-rnc-accent", reference === range.name && "bg-rnc-accent"), onClick: () => {
+                            setReference(range.name);
+                            setError(undefined);
+                        }, onDoubleClick: () => navigate(range.name) }, range.name)))))),
+                React.createElement("label", { className: "flex flex-col gap-1 text-xs font-medium" },
+                    "Reference:",
+                    React.createElement(Input, { autoFocus: true, value: reference, placeholder: currentAddress, "aria-invalid": error ? true : undefined, onChange: (e) => {
+                            setReference(e.target.value);
+                            setError(undefined);
+                        } })),
+                error ? (React.createElement("div", { role: "alert", className: "text-xs text-rnc-destructive" }, error)) : null,
+                React.createElement(Separator, null),
+                React.createElement("div", { className: "flex justify-between gap-2" },
+                    special ? (React.createElement(Button, { type: "button", variant: "ghost", size: "sm", onClick: () => {
+                            setShowSpecial(true);
+                            setError(undefined);
+                        } }, "Special\u2026")) : (React.createElement("span", null)),
+                    React.createElement("div", { className: "flex gap-2" },
                         React.createElement(Button, { type: "button", variant: "outline", size: "sm", onClick: () => onOpenChange(false) }, "Cancel"),
-                        React.createElement(Button, { type: "submit", size: "sm", disabled: !reference.trim() }, "OK")))))));
+                        React.createElement(Button, { type: "submit", size: "sm", disabled: !reference.trim() }, "OK")))))))));
 });
 GoToDialog.displayName = "GoToDialog";
 const currentAddressOf = (request) => {
@@ -79,6 +119,6 @@ export const GoToDialogHost = () => {
     return (React.createElement(GoToDialog, { open: true, onOpenChange: (open) => {
             if (!open)
                 close();
-        }, namedRanges: request.namedRanges, currentAddress: currentAddressOf(request), resolve: resolve, onNavigate: request.onNavigate }));
+        }, namedRanges: request.namedRanges, currentAddress: currentAddressOf(request), resolve: resolve, onNavigate: request.onNavigate, special: request.special }));
 };
 GoToDialogHost.displayName = "GoToDialogHost";

package/dist/esm/components/goal-seek-dialog/index.d.ts

@@ -0,0 +1,32 @@
+import React from "react";
+import type { GoalSeekResult } from "../../types";
+export type GoalSeekDialogProps = {
+    /** Controls visibility. */
+    open: boolean;
+    onOpenChange(open: boolean): void;
+    /** Default "Set cell" (A1 reference of the active cell). */
+    initialSetCell: string;
+    /**
+     * Runs the search with the three fields (A1 references + the numeric
+     * target). Resolves to the result, or `undefined` when the engine reports
+     * none (the rnc engine iterates natively and streams the cells back).
+     */
+    onApply(setCell: string, targetValue: number, changingCell: string): Promise<GoalSeekResult | undefined>;
+};
+/** Excel's status sentence for a finished search. */
+export declare const goalSeekStatusText: (setCell: string, result: GoalSeekResult | undefined) => string;
+/**
+ * Excel's Goal Seek dialog: Set cell / To value / By changing cell, then the
+ * Goal Seek Status sentence with target and current value.
+ */
+export declare const GoalSeekDialog: React.MemoExoticComponent<({ open, onOpenChange, initialSetCell, onApply }: GoalSeekDialogProps) => React.JSX.Element>;
+/**
+ * Host-mounted, atom-driven wrapper around {@link GoalSeekDialog}. Mount
+ * once in the host; the context menu opens it via `useOpenGoalSeekDialog`
+ * and only offers the item while a host is mounted.
+ */
+export declare const GoalSeekDialogHost: {
+    (): React.JSX.Element;
+    displayName: string;
+};
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/components/goal-seek-dialog/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../components/goal-seek-dialog/index.tsx"],"names":[],"mappings":"AAaA,OAAO,KAAiD,MAAM,OAAO,CAAC;AAMtE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAElD,MAAM,MAAM,mBAAmB,GAAG;IAChC,2BAA2B;IAC3B,IAAI,EAAE,OAAO,CAAC;IACd,YAAY,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,CAAC;IAClC,4DAA4D;IAC5D,cAAc,EAAE,MAAM,CAAC;IACvB;;;;OAIG;IACH,OAAO,CACL,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,cAAc,GAAG,SAAS,CAAC,CAAC;CACxC,CAAC;AAKF,qDAAqD;AACrD,eAAO,MAAM,kBAAkB,GAC7B,SAAS,MAAM,EACf,QAAQ,cAAc,GAAG,SAAS,KACjC,MAKF,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,cAAc,8EACyB,mBAAmB,uBAyJtE,CAAC;AAIF;;;;GAIG;AACH,eAAO,MAAM,kBAAkB;;;CAkB9B,CAAC"}