@rowsncolumns/spreadsheet 10.2.73 → 10.2.75

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

@@ -0,0 +1,106 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EvaluateFormulaDialogHost = exports.EvaluateFormulaDialog = void 0;
+var tslib_1 = require("tslib");
+var calculator_1 = require("@rowsncolumns/calculator");
+var ui_1 = require("@rowsncolumns/ui");
+var utils_1 = require("@rowsncolumns/utils");
+var react_1 = tslib_1.__importStar(require("react"));
+var evaluate_formula_dialog_atom_1 = require("../../atoms/evaluate-formula-dialog.atom");
+var 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.
+ */
+exports.EvaluateFormulaDialog = (0, react_1.memo)(function (_a) {
+    var open = _a.open, onOpenChange = _a.onOpenChange, reference = _a.reference, formula = _a.formula, evaluate = _a.evaluate;
+    var _b = tslib_1.__read((0, react_1.useState)(function () { return (0, calculator_1.createFormulaEvaluation)(formula); }), 2), state = _b[0], setState = _b[1];
+    var _c = tslib_1.__read((0, react_1.useState)(false), 2), busy = _c[0], setBusy = _c[1];
+    var _d = tslib_1.__read((0, react_1.useState)(undefined), 2), failure = _d[0], setFailure = _d[1];
+    var step = (0, react_1.useCallback)(function () { return tslib_1.__awaiter(void 0, void 0, void 0, function () {
+        var _a, err_1;
+        return tslib_1.__generator(this, function (_b) {
+            switch (_b.label) {
+                case 0:
+                    if (!state || state.done || busy)
+                        return [2 /*return*/];
+                    setBusy(true);
+                    _b.label = 1;
+                case 1:
+                    _b.trys.push([1, 3, 4, 5]);
+                    _a = setState;
+                    return [4 /*yield*/, (0, calculator_1.advanceFormulaEvaluation)(state, evaluate)];
+                case 2:
+                    _a.apply(void 0, [_b.sent()]);
+                    setFailure(undefined);
+                    return [3 /*break*/, 5];
+                case 3:
+                    err_1 = _b.sent();
+                    setFailure(err_1 instanceof Error ? err_1.message : "The expression could not be evaluated.");
+                    return [3 /*break*/, 5];
+                case 4:
+                    setBusy(false);
+                    return [7 /*endfinally*/];
+                case 5: return [2 /*return*/];
+            }
+        });
+    }); }, [state, busy, evaluate]);
+    var restart = (0, react_1.useCallback)(function () {
+        setState((0, calculator_1.createFormulaEvaluation)(formula));
+        setFailure(undefined);
+    }, [formula]);
+    var target = state === null || state === void 0 ? void 0 : state.target;
+    var before = state && target ? state.text.slice(0, target.start) : "";
+    var underlined = state && target ? state.text.slice(target.start, target.end + 1) : "";
+    var after = state && target ? state.text.slice(target.end + 1) : "";
+    return (react_1.default.createElement(ui_1.Dialog, { open: open, onOpenChange: onOpenChange, modal: true },
+        react_1.default.createElement(ui_1.DialogContent, { className: "w-[520px] max-w-[92vw] pointer-events-auto" },
+            react_1.default.createElement(ui_1.DialogTitle, null, "Evaluate Formula"),
+            react_1.default.createElement(ui_1.DialogCloseButton, null),
+            react_1.default.createElement(ui_1.DialogBody, { className: "flex flex-col gap-3" },
+                react_1.default.createElement("div", { className: "grid grid-cols-[auto_1fr] gap-x-4 gap-y-1 text-xs" },
+                    react_1.default.createElement("span", { className: "font-medium" }, "Reference:"),
+                    react_1.default.createElement("span", { className: "font-mono" }, reference),
+                    react_1.default.createElement("span", { className: "font-medium" }, "Evaluation:"),
+                    react_1.default.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_1.default.createElement("span", { className: "italic" },
+                        "= ",
+                        state.text)) : (react_1.default.createElement(react_1.default.Fragment, null,
+                        "= ",
+                        before,
+                        react_1.default.createElement("u", { "data-testid": "evaluate-formula-target" }, underlined),
+                        after))) : (react_1.default.createElement("span", { className: "text-rnc-destructive" }, CANNOT_EVALUATE)))),
+                failure ? (react_1.default.createElement("div", { role: "alert", className: "text-xs text-rnc-destructive" }, failure)) : null,
+                react_1.default.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_1.default.createElement(ui_1.Separator, null),
+                react_1.default.createElement("div", { className: "flex justify-end gap-2" },
+                    react_1.default.createElement(ui_1.Button, { variant: "outline", size: "sm", onClick: function () { return onOpenChange(false); } }, "Close"),
+                    (state === null || state === void 0 ? void 0 : state.done) ? (react_1.default.createElement(ui_1.Button, { size: "sm", onClick: restart }, "Restart")) : (react_1.default.createElement(ui_1.Button, { size: "sm", onClick: step, disabled: !state || busy }, "Evaluate")))))));
+});
+exports.EvaluateFormulaDialog.displayName = "EvaluateFormulaDialog";
+var referenceOf = function (request) {
+    var _a;
+    var address = (_a = (0, utils_1.cellToAddress)(request.cell, true, true)) !== null && _a !== void 0 ? _a : "";
+    var sheetName = (0, utils_1.sanitizeSheetName)(request.sheetName);
+    return sheetName ? "".concat(sheetName, "!").concat(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.
+ */
+var EvaluateFormulaDialogHost = function () {
+    (0, evaluate_formula_dialog_atom_1.useRegisterEvaluateFormulaDialogHost)();
+    var _a = tslib_1.__read((0, evaluate_formula_dialog_atom_1.useEvaluateFormulaDialogState)(), 2), request = _a[0], setRequest = _a[1];
+    var close = (0, react_1.useCallback)(function () { return setRequest(null); }, [setRequest]);
+    if (!request)
+        return null;
+    return (react_1.default.createElement(exports.EvaluateFormulaDialog, { key: "".concat(request.sheetId, ":").concat(request.cell.rowIndex, ":").concat(request.cell.columnIndex, ":").concat(request.formula), open: true, onOpenChange: function (open) {
+            if (!open)
+                close();
+        }, reference: referenceOf(request), formula: request.formula, evaluate: request.evaluate }));
+};
+exports.EvaluateFormulaDialogHost = EvaluateFormulaDialogHost;
+exports.EvaluateFormulaDialogHost.displayName = "EvaluateFormulaDialogHost";

package/dist/cjs/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/cjs/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"}

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

@@ -0,0 +1,136 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GoToDialogHost = exports.GoToDialog = void 0;
+var tslib_1 = require("tslib");
+var ui_1 = require("@rowsncolumns/ui");
+var utils_1 = require("@rowsncolumns/utils");
+var react_1 = tslib_1.__importStar(require("react"));
+var go_to_1 = require("../../api/go-to");
+var go_to_special_1 = require("../../api/go-to-special");
+var go_to_dialog_atom_1 = require("../../atoms/go-to-dialog.atom");
+var INVALID_REFERENCE = "Reference is not valid.";
+var 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.
+ */
+exports.GoToDialog = (0, react_1.memo)(function (_a) {
+    var open = _a.open, onOpenChange = _a.onOpenChange, namedRanges = _a.namedRanges, currentAddress = _a.currentAddress, resolve = _a.resolve, onNavigate = _a.onNavigate, special = _a.special;
+    var _b = tslib_1.__read((0, react_1.useState)(""), 2), reference = _b[0], setReference = _b[1];
+    var _c = tslib_1.__read((0, react_1.useState)(undefined), 2), error = _c[0], setError = _c[1];
+    var _d = tslib_1.__read((0, react_1.useState)(false), 2), showSpecial = _d[0], setShowSpecial = _d[1];
+    var _e = tslib_1.__read((0, react_1.useState)("blanks"), 2), specialKind = _e[0], setSpecialKind = _e[1];
+    var selectSpecial = (0, react_1.useCallback)(function () {
+        if (!special)
+            return;
+        var ranges = special.resolve(specialKind);
+        if (!ranges.length) {
+            setError(NO_CELLS_FOUND);
+            return;
+        }
+        special.onSelectRanges(ranges);
+        onOpenChange(false);
+    }, [special, specialKind, onOpenChange]);
+    var navigate = (0, react_1.useCallback)(function (text) {
+        var range = resolve(text);
+        if (!range) {
+            setError(INVALID_REFERENCE);
+            return;
+        }
+        onNavigate(range);
+        onOpenChange(false);
+    }, [resolve, onNavigate, onOpenChange]);
+    var names = (namedRanges !== null && namedRanges !== void 0 ? namedRanges : []).filter(function (range) { return range.range && !range.hidden; });
+    return (react_1.default.createElement(ui_1.Dialog, { open: open, onOpenChange: onOpenChange, modal: true },
+        react_1.default.createElement(ui_1.DialogContent, { className: "w-[360px] max-w-[92vw] pointer-events-auto" },
+            react_1.default.createElement(ui_1.DialogTitle, null, showSpecial ? "Go To Special" : "Go To"),
+            react_1.default.createElement(ui_1.DialogCloseButton, null),
+            react_1.default.createElement(ui_1.DialogBody, { className: "flex flex-col gap-3" }, showSpecial && special ? (react_1.default.createElement("form", { className: "flex flex-col gap-3", onSubmit: function (e) {
+                    e.preventDefault();
+                    selectSpecial();
+                } },
+                react_1.default.createElement("fieldset", { className: "flex flex-col gap-1 border-0 p-0 m-0" },
+                    react_1.default.createElement("legend", { className: "text-xs font-medium pb-1" }, "Select"),
+                    go_to_special_1.GO_TO_SPECIAL_OPTIONS.map(function (_a) {
+                        var kind = _a.kind, label = _a.label;
+                        return (react_1.default.createElement("label", { key: kind, className: "flex items-center gap-2 text-xs cursor-pointer" },
+                            react_1.default.createElement("input", { type: "radio", name: "goToSpecial", value: kind, checked: specialKind === kind, onChange: function () {
+                                    setSpecialKind(kind);
+                                    setError(undefined);
+                                } }),
+                            label));
+                    })),
+                error ? (react_1.default.createElement("div", { role: "alert", className: "text-xs text-rnc-destructive" }, error)) : null,
+                react_1.default.createElement(ui_1.Separator, null),
+                react_1.default.createElement("div", { className: "flex justify-between gap-2" },
+                    react_1.default.createElement(ui_1.Button, { type: "button", variant: "ghost", size: "sm", onClick: function () {
+                            setShowSpecial(false);
+                            setError(undefined);
+                        } }, "Back"),
+                    react_1.default.createElement("div", { className: "flex gap-2" },
+                        react_1.default.createElement(ui_1.Button, { type: "button", variant: "outline", size: "sm", onClick: function () { return onOpenChange(false); } }, "Cancel"),
+                        react_1.default.createElement(ui_1.Button, { type: "submit", size: "sm" }, "OK"))))) : (react_1.default.createElement("form", { className: "flex flex-col gap-3", onSubmit: function (e) {
+                    e.preventDefault();
+                    navigate(reference);
+                } },
+                react_1.default.createElement("div", { className: "flex flex-col gap-1" },
+                    react_1.default.createElement("span", { className: "text-xs font-medium" }, "Go to:"),
+                    react_1.default.createElement("div", { role: "listbox", "aria-label": "Defined names", className: "h-[140px] overflow-auto rounded border border-rnc-border text-xs" }, names.length === 0 ? (react_1.default.createElement("div", { className: "px-2 py-1.5 text-rnc-foreground/60" }, "No defined names")) : (names.map(function (range) { return (react_1.default.createElement("div", { key: String(range.namedRangeId), role: "option", "aria-selected": reference === range.name, className: (0, ui_1.cn)("px-2 py-1 cursor-default select-none hover:bg-rnc-accent", reference === range.name && "bg-rnc-accent"), onClick: function () {
+                            setReference(range.name);
+                            setError(undefined);
+                        }, onDoubleClick: function () { return navigate(range.name); } }, range.name)); })))),
+                react_1.default.createElement("label", { className: "flex flex-col gap-1 text-xs font-medium" },
+                    "Reference:",
+                    react_1.default.createElement(ui_1.Input, { autoFocus: true, value: reference, placeholder: currentAddress, "aria-invalid": error ? true : undefined, onChange: function (e) {
+                            setReference(e.target.value);
+                            setError(undefined);
+                        } })),
+                error ? (react_1.default.createElement("div", { role: "alert", className: "text-xs text-rnc-destructive" }, error)) : null,
+                react_1.default.createElement(ui_1.Separator, null),
+                react_1.default.createElement("div", { className: "flex justify-between gap-2" },
+                    special ? (react_1.default.createElement(ui_1.Button, { type: "button", variant: "ghost", size: "sm", onClick: function () {
+                            setShowSpecial(true);
+                            setError(undefined);
+                        } }, "Special\u2026")) : (react_1.default.createElement("span", null)),
+                    react_1.default.createElement("div", { className: "flex gap-2" },
+                        react_1.default.createElement(ui_1.Button, { type: "button", variant: "outline", size: "sm", onClick: function () { return onOpenChange(false); } }, "Cancel"),
+                        react_1.default.createElement(ui_1.Button, { type: "submit", size: "sm", disabled: !reference.trim() }, "OK")))))))));
+});
+exports.GoToDialog.displayName = "GoToDialog";
+var currentAddressOf = function (request) {
+    var _a, _b;
+    var address = (_a = (0, utils_1.cellToAddress)(request.activeCell)) !== null && _a !== void 0 ? _a : "";
+    var sheetName = (_b = request.getSheetName) === null || _b === void 0 ? void 0 : _b.call(request, request.sheetId);
+    return sheetName ? "".concat(sheetName, "!").concat(address) : address;
+};
+/**
+ * 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).
+ */
+var GoToDialogHost = function () {
+    (0, go_to_dialog_atom_1.useRegisterGoToDialogHost)();
+    var _a = tslib_1.__read((0, go_to_dialog_atom_1.useGoToDialogState)(), 2), request = _a[0], setRequest = _a[1];
+    var close = (0, react_1.useCallback)(function () { return setRequest(null); }, [setRequest]);
+    var resolve = (0, react_1.useCallback)(function (reference) {
+        return request
+            ? (0, go_to_1.resolveGoToReference)(reference, {
+                sheetId: request.sheetId,
+                namedRanges: request.namedRanges,
+                getSheetId: request.getSheetId,
+                rowCount: request.rowCount,
+                columnCount: request.columnCount,
+            })
+            : undefined;
+    }, [request]);
+    if (!request)
+        return null;
+    return (react_1.default.createElement(exports.GoToDialog, { open: true, onOpenChange: function (open) {
+            if (!open)
+                close();
+        }, namedRanges: request.namedRanges, currentAddress: currentAddressOf(request), resolve: resolve, onNavigate: request.onNavigate, special: request.special }));
+};
+exports.GoToDialogHost = GoToDialogHost;
+exports.GoToDialogHost.displayName = "GoToDialogHost";

package/dist/cjs/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/cjs/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"}

package/dist/cjs/components/goal-seek-dialog/index.js

@@ -0,0 +1,149 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GoalSeekDialogHost = exports.GoalSeekDialog = exports.goalSeekStatusText = void 0;
+var tslib_1 = require("tslib");
+var icons_1 = require("@rowsncolumns/icons");
+var ui_1 = require("@rowsncolumns/ui");
+var utils_1 = require("@rowsncolumns/utils");
+var react_1 = tslib_1.__importStar(require("react"));
+var goal_seek_dialog_atom_1 = require("../../atoms/goal-seek-dialog.atom");
+var isCellReference = function (text) {
+    return /^\$?[A-Za-z]{1,3}\$?\d+$/.test(text.trim()) && (0, utils_1.addressToCell)(text.trim()) != null;
+};
+/** Excel's status sentence for a finished search. */
+var goalSeekStatusText = function (setCell, result) {
+    if (!result)
+        return "Goal Seeking with Cell ".concat(setCell, " finished.");
+    return result.status === "found"
+        ? "Goal Seeking with Cell ".concat(setCell, " found a solution.")
+        : "Goal Seeking with Cell ".concat(setCell, " may not have found a solution.");
+};
+exports.goalSeekStatusText = goalSeekStatusText;
+/**
+ * Excel's Goal Seek dialog: Set cell / To value / By changing cell, then the
+ * Goal Seek Status sentence with target and current value.
+ */
+exports.GoalSeekDialog = (0, react_1.memo)(function (_a) {
+    var open = _a.open, onOpenChange = _a.onOpenChange, initialSetCell = _a.initialSetCell, onApply = _a.onApply;
+    var _b = tslib_1.__read((0, react_1.useState)(initialSetCell), 2), setCell = _b[0], setSetCell = _b[1];
+    var _c = tslib_1.__read((0, react_1.useState)(""), 2), target = _c[0], setTarget = _c[1];
+    var _d = tslib_1.__read((0, react_1.useState)(""), 2), changingCell = _d[0], setChangingCell = _d[1];
+    var _e = tslib_1.__read((0, react_1.useState)(undefined), 2), error = _e[0], setError = _e[1];
+    var _f = tslib_1.__read((0, react_1.useState)(false), 2), busy = _f[0], setBusy = _f[1];
+    var _g = tslib_1.__read((0, react_1.useState)(undefined), 2), result = _g[0], setResult = _g[1];
+    (0, react_1.useEffect)(function () {
+        if (open) {
+            setSetCell(initialSetCell);
+            setTarget("");
+            setChangingCell("");
+            setError(undefined);
+            setBusy(false);
+            setResult(undefined);
+        }
+        // Only reset on open transitions.
+        // eslint-disable-next-line react-hooks/exhaustive-deps
+    }, [open]);
+    var submit = (0, react_1.useCallback)(function (event) { return tslib_1.__awaiter(void 0, void 0, void 0, function () {
+        var targetValue, outcome, err_1;
+        return tslib_1.__generator(this, function (_a) {
+            switch (_a.label) {
+                case 0:
+                    event.preventDefault();
+                    targetValue = Number(target.trim());
+                    if (!isCellReference(setCell)) {
+                        setError("Set cell must be a single cell reference, e.g. B4.");
+                        return [2 /*return*/];
+                    }
+                    if (target.trim() === "" || !Number.isFinite(targetValue)) {
+                        setError("To value must be a number.");
+                        return [2 /*return*/];
+                    }
+                    if (!isCellReference(changingCell)) {
+                        setError("By changing cell must be a single cell reference, e.g. A1.");
+                        return [2 /*return*/];
+                    }
+                    setError(undefined);
+                    setBusy(true);
+                    _a.label = 1;
+                case 1:
+                    _a.trys.push([1, 3, 4, 5]);
+                    return [4 /*yield*/, onApply(setCell.trim().toUpperCase(), targetValue, changingCell.trim().toUpperCase())];
+                case 2:
+                    outcome = _a.sent();
+                    setResult({ setCell: setCell.trim().toUpperCase(), result: outcome });
+                    return [3 /*break*/, 5];
+                case 3:
+                    err_1 = _a.sent();
+                    setError(err_1 instanceof Error ? err_1.message : "Goal Seek failed.");
+                    return [3 /*break*/, 5];
+                case 4:
+                    setBusy(false);
+                    return [7 /*endfinally*/];
+                case 5: return [2 /*return*/];
+            }
+        });
+    }); }, [setCell, target, changingCell, onApply]);
+    return (react_1.default.createElement(ui_1.Dialog, { open: open, onOpenChange: onOpenChange },
+        react_1.default.createElement(ui_1.DialogContent, { className: "w-[360px] max-w-[92vw] pointer-events-auto" },
+            react_1.default.createElement(ui_1.DialogTitle, null, result ? "Goal Seek Status" : "Goal Seek"),
+            react_1.default.createElement(ui_1.DialogDescription, null, "Find the input value that makes a formula reach a target."),
+            react_1.default.createElement(ui_1.DialogCloseButton, { onClick: function () { return onOpenChange(false); } },
+                react_1.default.createElement(icons_1.Cross1Icon, null)),
+            react_1.default.createElement(ui_1.DialogBody, { className: "flex flex-col gap-3 font-system text-sm" }, result ? (react_1.default.createElement("div", { className: "flex flex-col gap-2", role: "status" },
+                react_1.default.createElement("div", null, (0, exports.goalSeekStatusText)(result.setCell, result.result)),
+                result.result ? (react_1.default.createElement("dl", { className: "grid grid-cols-2 gap-1 text-xs" },
+                    react_1.default.createElement("dt", { className: "text-rnc-foreground/70" }, "Target value:"),
+                    react_1.default.createElement("dd", null, result.result.targetValue),
+                    react_1.default.createElement("dt", { className: "text-rnc-foreground/70" }, "Current value:"),
+                    react_1.default.createElement("dd", null, result.result.currentValue === undefined
+                        ? "—"
+                        : String(result.result.currentValue)))) : null,
+                react_1.default.createElement(ui_1.Separator, null),
+                react_1.default.createElement("div", { className: "flex justify-end gap-2" },
+                    react_1.default.createElement(ui_1.Button, { size: "sm", type: "button", onClick: function () { return onOpenChange(false); } }, "OK")))) : (react_1.default.createElement("form", { className: "flex flex-col gap-3", onSubmit: submit },
+                react_1.default.createElement("label", { className: "flex flex-col gap-1 text-xs font-medium" },
+                    "Set cell:",
+                    react_1.default.createElement(ui_1.Input, { autoFocus: true, value: setCell, "aria-label": "Set cell", onChange: function (e) {
+                            setSetCell(e.target.value);
+                            setError(undefined);
+                        } })),
+                react_1.default.createElement("label", { className: "flex flex-col gap-1 text-xs font-medium" },
+                    "To value:",
+                    react_1.default.createElement(ui_1.Input, { value: target, "aria-label": "To value", inputMode: "decimal", onChange: function (e) {
+                            setTarget(e.target.value);
+                            setError(undefined);
+                        } })),
+                react_1.default.createElement("label", { className: "flex flex-col gap-1 text-xs font-medium" },
+                    "By changing cell:",
+                    react_1.default.createElement(ui_1.Input, { value: changingCell, "aria-label": "By changing cell", onChange: function (e) {
+                            setChangingCell(e.target.value);
+                            setError(undefined);
+                        } })),
+                error ? (react_1.default.createElement("div", { role: "alert", className: "text-xs text-rnc-destructive" }, error)) : null,
+                react_1.default.createElement(ui_1.Separator, null),
+                react_1.default.createElement("div", { className: "flex justify-end gap-2" },
+                    react_1.default.createElement(ui_1.Button, { type: "button", variant: "outline", size: "sm", onClick: function () { return onOpenChange(false); } }, "Cancel"),
+                    react_1.default.createElement(ui_1.Button, { type: "submit", size: "sm", disabled: busy }, busy ? "Seeking…" : "OK"))))))));
+});
+exports.GoalSeekDialog.displayName = "GoalSeekDialog";
+/**
+ * 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.
+ */
+var GoalSeekDialogHost = function () {
+    var _a;
+    (0, goal_seek_dialog_atom_1.useRegisterGoalSeekDialogHost)();
+    var _b = tslib_1.__read((0, goal_seek_dialog_atom_1.useGoalSeekDialogState)(), 2), request = _b[0], setRequest = _b[1];
+    var close = (0, react_1.useCallback)(function () { return setRequest(null); }, [setRequest]);
+    return (react_1.default.createElement(exports.GoalSeekDialog, { open: request != null, onOpenChange: function (open) {
+            if (!open)
+                close();
+        }, initialSetCell: (_a = request === null || request === void 0 ? void 0 : request.setCell) !== null && _a !== void 0 ? _a : "", onApply: function (setCell, targetValue, changingCell) {
+            return request
+                ? request.onApply(setCell, targetValue, changingCell)
+                : Promise.resolve(undefined);
+        } }));
+};
+exports.GoalSeekDialogHost = GoalSeekDialogHost;
+exports.GoalSeekDialogHost.displayName = "GoalSeekDialogHost";

package/dist/cjs/components/paste-special-dialog/index.d.ts

@@ -0,0 +1,29 @@
+import React from "react";
+import type { PasteSpecialOptions } from "../../hooks/use-copy-paste-cut";
+export type PasteSpecialDialogProps = {
+    /** Controls visibility. */
+    open: boolean;
+    onOpenChange(open: boolean): void;
+    /**
+     * Emits the assembled request. The host routes it to the grid's
+     * `paste(options)`; the dialog never touches the clipboard itself.
+     */
+    onApply(options: PasteSpecialOptions): void;
+};
+/**
+ * Excel's Paste Special dialog: what to paste (all / formulas / values /
+ * formats), an arithmetic operation against the destination, skip blanks and
+ * transpose. Every choice composes into one `PasteSpecialOptions` request.
+ */
+export declare const PasteSpecialDialog: React.MemoExoticComponent<({ open, onOpenChange, onApply }: PasteSpecialDialogProps) => React.JSX.Element>;
+/**
+ * Host-mounted, atom-driven wrapper around {@link PasteSpecialDialog}. Mount
+ * it once in the host alongside the other editor dialogs; the grid opens it
+ * from the context menu ("Paste special…") and `Ctrl+Alt+V`. Remounted per
+ * request so each opening starts from Excel's defaults.
+ */
+export declare const PasteSpecialDialogHost: {
+    (): React.JSX.Element | null;
+    displayName: string;
+};
+//# sourceMappingURL=index.d.ts.map

package/dist/cjs/components/paste-special-dialog/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../components/paste-special-dialog/index.tsx"],"names":[],"mappings":"AASA,OAAO,KAAsC,MAAM,OAAO,CAAC;AAM3D,OAAO,KAAK,EAEV,mBAAmB,EACpB,MAAM,gCAAgC,CAAC;AAoBxC,MAAM,MAAM,uBAAuB,GAAG;IACpC,2BAA2B;IAC3B,IAAI,EAAE,OAAO,CAAC;IACd,YAAY,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,CAAC;IAClC;;;OAGG;IACH,OAAO,CAAC,OAAO,EAAE,mBAAmB,GAAG,IAAI,CAAC;CAC7C,CAAC;AAyCF;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,8DACK,uBAAuB,uBA2F1D,CAAC;AAIF;;;;;GAKG;AACH,eAAO,MAAM,sBAAsB;;;CAclC,CAAC"}

package/dist/cjs/components/paste-special-dialog/index.js

@@ -0,0 +1,99 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PasteSpecialDialogHost = exports.PasteSpecialDialog = void 0;
+var tslib_1 = require("tslib");
+var ui_1 = require("@rowsncolumns/ui");
+var react_1 = tslib_1.__importStar(require("react"));
+var paste_special_dialog_atom_1 = require("../../atoms/paste-special-dialog.atom");
+var PASTE_MODES = [
+    { value: "all", label: "All" },
+    { value: "formulas", label: "Formulas" },
+    { value: "values", label: "Values" },
+    { value: "formats", label: "Formats" },
+];
+var OPERATIONS = [
+    { value: "none", label: "None" },
+    { value: "add", label: "Add" },
+    { value: "subtract", label: "Subtract" },
+    { value: "multiply", label: "Multiply" },
+    { value: "divide", label: "Divide" },
+];
+var RadioGroup = function (_a) {
+    var name = _a.name, legend = _a.legend, value = _a.value, options = _a.options, onChange = _a.onChange, disabled = _a.disabled;
+    return (react_1.default.createElement("fieldset", { className: "flex flex-col gap-1 min-w-0 disabled:opacity-50", disabled: disabled },
+        react_1.default.createElement("legend", { className: "text-xs font-medium mb-1" }, legend),
+        options.map(function (option) { return (react_1.default.createElement("label", { key: option.value, className: "flex items-center gap-2 text-xs py-0.5 cursor-pointer" },
+            react_1.default.createElement("input", { type: "radio", name: name, value: option.value, checked: value === option.value, disabled: disabled, onChange: function () { return onChange(option.value); } }),
+            option.label)); })));
+};
+/**
+ * Excel's Paste Special dialog: what to paste (all / formulas / values /
+ * formats), an arithmetic operation against the destination, skip blanks and
+ * transpose. Every choice composes into one `PasteSpecialOptions` request.
+ */
+exports.PasteSpecialDialog = (0, react_1.memo)(function (_a) {
+    var open = _a.open, onOpenChange = _a.onOpenChange, onApply = _a.onApply;
+    var _b = tslib_1.__read((0, react_1.useState)("all"), 2), paste = _b[0], setPaste = _b[1];
+    var _c = tslib_1.__read((0, react_1.useState)("none"), 2), operation = _c[0], setOperation = _c[1];
+    var _d = tslib_1.__read((0, react_1.useState)(false), 2), skipBlanks = _d[0], setSkipBlanks = _d[1];
+    var _e = tslib_1.__read((0, react_1.useState)(false), 2), transpose = _e[0], setTranspose = _e[1];
+    // Excel greys Operation out under Paste → Formats (a formats paste never
+    // changes destination values); the choice is kept but not applied.
+    var operationDisabled = paste === "formats";
+    var commit = (0, react_1.useCallback)(function () {
+        onApply({
+            paste: paste,
+            operation: operation === "none" || operationDisabled ? undefined : operation,
+            skipBlanks: skipBlanks,
+            transpose: transpose,
+        });
+        onOpenChange(false);
+    }, [
+        onApply,
+        onOpenChange,
+        paste,
+        operation,
+        operationDisabled,
+        skipBlanks,
+        transpose,
+    ]);
+    return (react_1.default.createElement(ui_1.Dialog, { open: open, onOpenChange: onOpenChange, modal: true },
+        react_1.default.createElement(ui_1.DialogContent, { className: "w-[380px] max-w-[92vw] pointer-events-auto" },
+            react_1.default.createElement(ui_1.DialogTitle, null, "Paste Special"),
+            react_1.default.createElement(ui_1.DialogCloseButton, null),
+            react_1.default.createElement(ui_1.DialogBody, { className: "flex flex-col gap-4" },
+                react_1.default.createElement("div", { className: "grid grid-cols-2 gap-4" },
+                    react_1.default.createElement(RadioGroup, { name: "paste-special-paste", legend: "Paste", value: paste, options: PASTE_MODES, onChange: setPaste }),
+                    react_1.default.createElement(RadioGroup, { name: "paste-special-operation", legend: "Operation", value: operation, options: OPERATIONS, onChange: setOperation, disabled: operationDisabled })),
+                react_1.default.createElement("div", { className: "flex flex-col gap-1" },
+                    react_1.default.createElement("label", { className: "flex items-center gap-2 text-xs py-0.5 cursor-pointer" },
+                        react_1.default.createElement("input", { type: "checkbox", checked: skipBlanks, onChange: function (e) { return setSkipBlanks(e.target.checked); } }),
+                        "Skip blanks"),
+                    react_1.default.createElement("label", { className: "flex items-center gap-2 text-xs py-0.5 cursor-pointer" },
+                        react_1.default.createElement("input", { type: "checkbox", checked: transpose, onChange: function (e) { return setTranspose(e.target.checked); } }),
+                        "Transpose")),
+                react_1.default.createElement(ui_1.Separator, null),
+                react_1.default.createElement("div", { className: "flex justify-end gap-2" },
+                    react_1.default.createElement(ui_1.Button, { variant: "outline", size: "sm", onClick: function () { return onOpenChange(false); } }, "Cancel"),
+                    react_1.default.createElement(ui_1.Button, { size: "sm", onClick: commit }, "OK"))))));
+});
+exports.PasteSpecialDialog.displayName = "PasteSpecialDialog";
+/**
+ * Host-mounted, atom-driven wrapper around {@link PasteSpecialDialog}. Mount
+ * it once in the host alongside the other editor dialogs; the grid opens it
+ * from the context menu ("Paste special…") and `Ctrl+Alt+V`. Remounted per
+ * request so each opening starts from Excel's defaults.
+ */
+var PasteSpecialDialogHost = function () {
+    (0, paste_special_dialog_atom_1.useRegisterPasteSpecialDialogHost)();
+    var _a = tslib_1.__read((0, paste_special_dialog_atom_1.usePasteSpecialDialogState)(), 2), request = _a[0], setRequest = _a[1];
+    var close = (0, react_1.useCallback)(function () { return setRequest(null); }, [setRequest]);
+    if (!request)
+        return null;
+    return (react_1.default.createElement(exports.PasteSpecialDialog, { open: true, onOpenChange: function (open) {
+            if (!open)
+                close();
+        }, onApply: request.onApply }));
+};
+exports.PasteSpecialDialogHost = PasteSpecialDialogHost;
+exports.PasteSpecialDialogHost.displayName = "PasteSpecialDialogHost";