@rowsncolumns/spreadsheet 10.2.73 → 10.2.75

package/dist/cjs/api/go-to-special.js

@@ -0,0 +1,111 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveGoToSpecial = exports.GO_TO_SPECIAL_MAX_CELLS = exports.GO_TO_SPECIAL_OPTIONS = void 0;
+exports.GO_TO_SPECIAL_OPTIONS = [
+    { kind: "notes", label: "Notes" },
+    { kind: "constants", label: "Constants" },
+    { kind: "formulas", label: "Formulas" },
+    { kind: "errors", label: "Errors" },
+    { kind: "blanks", label: "Blanks" },
+    { kind: "visible", label: "Visible cells only" },
+];
+/** Cells scanned before the search gives up (returns what it found so far). */
+exports.GO_TO_SPECIAL_MAX_CELLS = 250000;
+var hasContent = function (cell) {
+    var _a;
+    var ue = (_a = cell === null || cell === void 0 ? void 0 : cell.ue) !== null && _a !== void 0 ? _a : cell === null || cell === void 0 ? void 0 : cell.userEnteredValue;
+    if (!ue)
+        return false;
+    return (ue.fv != null ||
+        ue.formulaValue != null ||
+        ue.sv != null ||
+        ue.stringValue != null ||
+        ue.nv != null ||
+        ue.numberValue != null ||
+        ue.bv != null ||
+        ue.boolValue != null);
+};
+var isFormula = function (cell) {
+    var _a, _b;
+    var ue = (_a = cell === null || cell === void 0 ? void 0 : cell.ue) !== null && _a !== void 0 ? _a : cell === null || cell === void 0 ? void 0 : cell.userEnteredValue;
+    return typeof ((_b = ue === null || ue === void 0 ? void 0 : ue.fv) !== null && _b !== void 0 ? _b : ue === null || ue === void 0 ? void 0 : ue.formulaValue) === "string";
+};
+var isError = function (cell) {
+    var _a, _b;
+    var ev = (_a = cell === null || cell === void 0 ? void 0 : cell.ev) !== null && _a !== void 0 ? _a : cell === null || cell === void 0 ? void 0 : cell.effectiveValue;
+    var error = (_b = ev === null || ev === void 0 ? void 0 : ev.ev) !== null && _b !== void 0 ? _b : ev === null || ev === void 0 ? void 0 : ev.errorValue;
+    return !!error && error.type === "Error";
+};
+var hasNote = function (cell) {
+    return typeof (cell === null || cell === void 0 ? void 0 : cell.note) === "string" && cell.note.trim().length > 0;
+};
+var matches = function (kind, cell) {
+    switch (kind) {
+        case "blanks":
+            return !hasContent(cell);
+        case "constants":
+            return hasContent(cell) && !isFormula(cell);
+        case "formulas":
+            return isFormula(cell);
+        case "errors":
+            return isError(cell);
+        case "notes":
+            return hasNote(cell);
+        case "visible":
+            return true;
+    }
+};
+/**
+ * Resolve a Go To Special category to the matching cells of `range`, packed
+ * into per-row runs of adjacent columns (what the selection layer paints).
+ * Hidden rows / columns are skipped for every kind — Excel never selects
+ * into a hidden cell from Go To Special. Returns `[]` when nothing matches.
+ */
+var resolveGoToSpecial = function (kind, context) {
+    var _a;
+    var sheetId = context.sheetId, range = context.range, getCellData = context.getCellData, isRowHidden = context.isRowHidden, isColumnHidden = context.isColumnHidden;
+    var maxCells = (_a = context.maxCells) !== null && _a !== void 0 ? _a : exports.GO_TO_SPECIAL_MAX_CELLS;
+    var runs = [];
+    var scanned = 0;
+    var _loop_1 = function (row) {
+        if (isRowHidden === null || isRowHidden === void 0 ? void 0 : isRowHidden(row))
+            return "continue";
+        var runStart;
+        var flush = function (endColumn) {
+            if (runStart === undefined)
+                return;
+            runs.push({
+                startRowIndex: row,
+                endRowIndex: row,
+                startColumnIndex: runStart,
+                endColumnIndex: endColumn,
+            });
+            runStart = undefined;
+        };
+        for (var col = range.startColumnIndex; col <= range.endColumnIndex; col++) {
+            if (++scanned > maxCells) {
+                flush(col - 1);
+                return { value: runs };
+            }
+            if (isColumnHidden === null || isColumnHidden === void 0 ? void 0 : isColumnHidden(col)) {
+                flush(col - 1);
+                continue;
+            }
+            if (matches(kind, getCellData(sheetId, row, col))) {
+                if (runStart === undefined)
+                    runStart = col;
+            }
+            else {
+                flush(col - 1);
+            }
+        }
+        flush(range.endColumnIndex);
+    };
+    for (var row = range.startRowIndex; row <= range.endRowIndex; row++) {
+        var state_1 = _loop_1(row);
+        if (typeof state_1 === "object")
+            return state_1.value;
+    }
+    return runs;
+};
+exports.resolveGoToSpecial = resolveGoToSpecial;

package/dist/cjs/api/go-to.d.ts

@@ -0,0 +1,19 @@
+import type { NamedRange, SheetRange } from "../types";
+export type GoToResolverContext = {
+    /** The sheet an unqualified reference (`A1`, `B2:C4`) is resolved against. */
+    sheetId: number;
+    namedRanges?: NamedRange[] | null;
+    /** Resolves `Sheet2!A1` / `'My Sheet'!A1`. Sheet-qualified input fails without it. */
+    getSheetId?: (sheetName: string) => number | undefined;
+    rowCount?: number;
+    columnCount?: number;
+};
+/**
+ * Resolve what the user typed into Excel's Go To box: a defined name (case
+ * insensitive), an A1 reference (`A1`, `$B$2:C4`, `A:A`, `3:3`) or a
+ * sheet-qualified reference (`Sheet2!A1`, `'My Sheet'!B2:C3`). A leading `=`
+ * is tolerated. Returns `undefined` when nothing matches — the dialog shows
+ * Excel's "Reference is not valid." then.
+ */
+export declare const resolveGoToReference: (input: string, context: GoToResolverContext) => SheetRange | undefined;
+//# sourceMappingURL=go-to.d.ts.map

package/dist/cjs/api/go-to.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"go-to.d.ts","sourceRoot":"","sources":["../../../api/go-to.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAEvD,MAAM,MAAM,mBAAmB,GAAG;IAChC,8EAA8E;IAC9E,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,UAAU,EAAE,GAAG,IAAI,CAAC;IAClC,sFAAsF;IACtF,UAAU,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAC;IACvD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC;AAiBF;;;;;;GAMG;AACH,eAAO,MAAM,oBAAoB,GAC/B,OAAO,MAAM,EACb,SAAS,mBAAmB,KAC3B,UAAU,GAAG,SA6Bf,CAAC"}

package/dist/cjs/api/go-to.js

@@ -0,0 +1,49 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveGoToReference = void 0;
+var tslib_1 = require("tslib");
+var utils_1 = require("@rowsncolumns/utils");
+// Rows are 1-based: `A0` / `0:0` are "Reference is not valid." in Excel (on
+// this grid row 0 is the column header).
+var CELL = "\\$?[A-Za-z]{1,3}\\$?[1-9]\\d*";
+var COLUMN = "\\$?[A-Za-z]{1,3}";
+var ROW = "\\$?[1-9]\\d*";
+var A1_REFERENCE = new RegExp("^(?:".concat(CELL, "(?::").concat(CELL, ")?|").concat(COLUMN, ":").concat(COLUMN, "|").concat(ROW, ":").concat(ROW, ")$"));
+/** `'My Sheet'` → `My Sheet` (doubled quotes unescaped); bare names pass through. */
+var unquoteSheetName = function (name) {
+    return name.startsWith("'") && name.endsWith("'") && name.length >= 2
+        ? name.slice(1, -1).replace(/''/g, "'")
+        : name;
+};
+/**
+ * Resolve what the user typed into Excel's Go To box: a defined name (case
+ * insensitive), an A1 reference (`A1`, `$B$2:C4`, `A:A`, `3:3`) or a
+ * sheet-qualified reference (`Sheet2!A1`, `'My Sheet'!B2:C3`). A leading `=`
+ * is tolerated. Returns `undefined` when nothing matches — the dialog shows
+ * Excel's "Reference is not valid." then.
+ */
+var resolveGoToReference = function (input, context) {
+    var _a, _b;
+    var text = input.trim().replace(/^=/, "").trim();
+    if (!text)
+        return undefined;
+    var named = (_a = context.namedRanges) === null || _a === void 0 ? void 0 : _a.find(function (range) { return range.name.toLowerCase() === text.toLowerCase(); });
+    if (named === null || named === void 0 ? void 0 : named.range) {
+        return tslib_1.__assign({}, named.range);
+    }
+    var sheetId = context.sheetId;
+    var reference = text;
+    var bang = text.lastIndexOf("!");
+    if (bang !== -1) {
+        var sheetName = unquoteSheetName(text.slice(0, bang).trim());
+        reference = text.slice(bang + 1).trim();
+        var resolved = (_b = context.getSheetId) === null || _b === void 0 ? void 0 : _b.call(context, sheetName);
+        if (resolved === undefined)
+            return undefined;
+        sheetId = resolved;
+    }
+    if (!A1_REFERENCE.test(reference))
+        return undefined;
+    return (0, utils_1.addressToSheetRange)(reference.toUpperCase(), sheetId, context.rowCount, context.columnCount);
+};
+exports.resolveGoToReference = resolveGoToReference;

package/dist/cjs/api/validation-tooltip.d.ts

@@ -0,0 +1,17 @@
+import type { ReactNode } from "react";
+import type { DataValidationRule, ErrorValue } from "../types";
+/**
+ * The data-validation part of a cell tooltip (both engines share it):
+ *
+ * - a cell flagged **Invalid** shows the rule's own error alert title/body
+ *   (Excel's custom error message, #131) — the generic "violates its
+ *   validation rule" text is only the fallback when the rule has none;
+ * - a formula **Error** keeps its own tooltip (nothing here);
+ * - otherwise the rule's input message (Excel's "show input message when
+ *   cell is selected", surfaced on hover here — #130).
+ *
+ * Returns `undefined` when the rule contributes nothing, so the host's own
+ * tooltip content / the generic markers apply.
+ */
+export declare const getDataValidationTooltipContent: (rule: DataValidationRule | null | undefined, error: ErrorValue | null | undefined) => ReactNode | undefined;
+//# sourceMappingURL=validation-tooltip.d.ts.map

package/dist/cjs/api/validation-tooltip.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation-tooltip.d.ts","sourceRoot":"","sources":["../../../api/validation-tooltip.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAGvC,OAAO,KAAK,EAAE,kBAAkB,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAsB/D;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,+BAA+B,GAC1C,MAAM,kBAAkB,GAAG,IAAI,GAAG,SAAS,EAC3C,OAAO,UAAU,GAAG,IAAI,GAAG,SAAS,KACnC,SAAS,GAAG,SAad,CAAC"}

package/dist/cjs/api/validation-tooltip.js

@@ -0,0 +1,42 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getDataValidationTooltipContent = void 0;
+var tslib_1 = require("tslib");
+var react_1 = tslib_1.__importDefault(require("react"));
+var hasText = function (message) {
+    return Boolean(message && (message.title || message.message));
+};
+var renderMessage = function (message, accentClass) { return (react_1.default.createElement("div", { className: "bg-rnc-background text-rnc-foreground p-2 shadow-md rounded-md border-l-4 border-solid ".concat(accentClass, " max-w-[300px] flex flex-col gap-0.5") },
+    message.title ? (react_1.default.createElement("div", { className: "font-bold font-system text-sm" }, message.title)) : null,
+    message.message ? (react_1.default.createElement("div", { className: "text-xs font-system whitespace-pre-wrap" }, message.message)) : null)); };
+/**
+ * The data-validation part of a cell tooltip (both engines share it):
+ *
+ * - a cell flagged **Invalid** shows the rule's own error alert title/body
+ *   (Excel's custom error message, #131) — the generic "violates its
+ *   validation rule" text is only the fallback when the rule has none;
+ * - a formula **Error** keeps its own tooltip (nothing here);
+ * - otherwise the rule's input message (Excel's "show input message when
+ *   cell is selected", surfaced on hover here — #130).
+ *
+ * Returns `undefined` when the rule contributes nothing, so the host's own
+ * tooltip content / the generic markers apply.
+ */
+var getDataValidationTooltipContent = function (rule, error) {
+    var _a;
+    if (!rule)
+        return undefined;
+    if ((error === null || error === void 0 ? void 0 : error.type) === "Error")
+        return undefined;
+    if ((error === null || error === void 0 ? void 0 : error.type) === "Invalid") {
+        var alertMessage = (_a = rule.alert) === null || _a === void 0 ? void 0 : _a.message;
+        return hasText(alertMessage)
+            ? renderMessage(alertMessage, "border-l-rnc-destructive")
+            : undefined;
+    }
+    var inputMessage = rule.inputMessage;
+    return hasText(inputMessage)
+        ? renderMessage(inputMessage, "border-l-blue-700")
+        : undefined;
+};
+exports.getDataValidationTooltipContent = getDataValidationTooltipContent;

package/dist/cjs/atoms/advanced-filter-dialog.atom.d.ts

@@ -0,0 +1,28 @@
+import type { AdvancedFilterOptions } from "../types";
+/**
+ * Open-state + payload for the Advanced Filter dialog (Excel's Data → Sort &
+ * Filter → Advanced). The context menu opens it with the list range around
+ * the active cell (A1 text); the host-mounted dialog resolves the typed
+ * references and routes the options back through `onApply`.
+ */
+export type AdvancedFilterDialogRequest = {
+    /** A1 reference of the default "List range". */
+    listRange: string;
+    /** Routed to `onAdvancedFilter` by the opener. */
+    onApply: (options: AdvancedFilterOptions) => void;
+};
+export declare const advancedFilterDialogAtom: import("jotai").PrimitiveAtom<AdvancedFilterDialogRequest | null> & {
+    init: AdvancedFilterDialogRequest | null;
+};
+export declare const useAdvancedFilterDialogState: () => [AdvancedFilterDialogRequest | null, (args_0: AdvancedFilterDialogRequest | ((prev: AdvancedFilterDialogRequest | null) => AdvancedFilterDialogRequest | null) | null) => void];
+/** Number of mounted `AdvancedFilterDialogHost`s — the menu item is offered only while > 0. */
+export declare const advancedFilterDialogHostCountAtom: import("jotai").PrimitiveAtom<number> & {
+    init: number;
+};
+/** True when at least one `AdvancedFilterDialogHost` is mounted. */
+export declare const useIsAdvancedFilterDialogMounted: () => boolean;
+/** Registers the calling component as a dialog host for its lifetime. */
+export declare const useRegisterAdvancedFilterDialogHost: () => void;
+/** Returns a function that opens the host-mounted Advanced Filter dialog. */
+export declare const useOpenAdvancedFilterDialog: () => (request: AdvancedFilterDialogRequest) => void;
+//# sourceMappingURL=advanced-filter-dialog.atom.d.ts.map

package/dist/cjs/atoms/advanced-filter-dialog.atom.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"advanced-filter-dialog.atom.d.ts","sourceRoot":"","sources":["../../../atoms/advanced-filter-dialog.atom.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,UAAU,CAAC;AAEtD;;;;;GAKG;AACH,MAAM,MAAM,2BAA2B,GAAG;IACxC,gDAAgD;IAChD,SAAS,EAAE,MAAM,CAAC;IAClB,kDAAkD;IAClD,OAAO,EAAE,CAAC,OAAO,EAAE,qBAAqB,KAAK,IAAI,CAAC;CACnD,CAAC;AAEF,eAAO,MAAM,wBAAwB;;CAEpC,CAAC;AAEF,eAAO,MAAM,4BAA4B,uLACN,CAAC;AAEpC,+FAA+F;AAC/F,eAAO,MAAM,iCAAiC;;CAAU,CAAC;AAEzD,oEAAoE;AACpE,eAAO,MAAM,gCAAgC,eACQ,CAAC;AAEtD,yEAAyE;AACzE,eAAO,MAAM,mCAAmC,YAM/C,CAAC;AAEF,6EAA6E;AAC7E,eAAO,MAAM,2BAA2B,kBAG1B,2BAA2B,SAGxC,CAAC"}

package/dist/cjs/atoms/advanced-filter-dialog.atom.js

@@ -0,0 +1,32 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useOpenAdvancedFilterDialog = exports.useRegisterAdvancedFilterDialogHost = exports.useIsAdvancedFilterDialogMounted = exports.advancedFilterDialogHostCountAtom = exports.useAdvancedFilterDialogState = exports.advancedFilterDialogAtom = void 0;
+var jotai_1 = require("jotai");
+var react_1 = require("react");
+exports.advancedFilterDialogAtom = (0, jotai_1.atom)(null);
+var useAdvancedFilterDialogState = function () {
+    return (0, jotai_1.useAtom)(exports.advancedFilterDialogAtom);
+};
+exports.useAdvancedFilterDialogState = useAdvancedFilterDialogState;
+/** Number of mounted `AdvancedFilterDialogHost`s — the menu item is offered only while > 0. */
+exports.advancedFilterDialogHostCountAtom = (0, jotai_1.atom)(0);
+/** True when at least one `AdvancedFilterDialogHost` is mounted. */
+var useIsAdvancedFilterDialogMounted = function () {
+    return (0, jotai_1.useAtomValue)(exports.advancedFilterDialogHostCountAtom) > 0;
+};
+exports.useIsAdvancedFilterDialogMounted = useIsAdvancedFilterDialogMounted;
+/** Registers the calling component as a dialog host for its lifetime. */
+var useRegisterAdvancedFilterDialogHost = function () {
+    var setCount = (0, jotai_1.useSetAtom)(exports.advancedFilterDialogHostCountAtom);
+    (0, react_1.useEffect)(function () {
+        setCount(function (count) { return count + 1; });
+        return function () { return setCount(function (count) { return count - 1; }); };
+    }, [setCount]);
+};
+exports.useRegisterAdvancedFilterDialogHost = useRegisterAdvancedFilterDialogHost;
+/** Returns a function that opens the host-mounted Advanced Filter dialog. */
+var useOpenAdvancedFilterDialog = function () {
+    var setRequest = (0, jotai_1.useSetAtom)(exports.advancedFilterDialogAtom);
+    return (0, react_1.useCallback)(function (request) { return setRequest(request); }, [setRequest]);
+};
+exports.useOpenAdvancedFilterDialog = useOpenAdvancedFilterDialog;

package/dist/cjs/atoms/evaluate-formula-dialog.atom.d.ts

@@ -0,0 +1,36 @@
+import type { EvaluationValue } from "@rowsncolumns/calculator";
+import type { CellInterface } from "@rowsncolumns/grid";
+/**
+ * Open-state + payload for the Evaluate Formula dialog (Excel → Formulas →
+ * Evaluate Formula). The grid opens it for the active cell with a read-only
+ * `evaluate` that scratch-evaluates a sub-expression through the host's
+ * calculator (`onRequestCalculate`); nothing is written back.
+ */
+export type EvaluateFormulaDialogRequest = {
+    sheetId: number;
+    cell: CellInterface;
+    sheetName?: string;
+    /** The cell's formula, including the leading `=`. */
+    formula: string;
+    /** Evaluates `expression` (no leading `=`) in the cell's context. */
+    evaluate: (expression: string) => Promise<EvaluationValue>;
+};
+export declare const evaluateFormulaDialogAtom: import("jotai").PrimitiveAtom<EvaluateFormulaDialogRequest | null> & {
+    init: EvaluateFormulaDialogRequest | null;
+};
+export declare const useEvaluateFormulaDialogState: () => [EvaluateFormulaDialogRequest | null, (args_0: EvaluateFormulaDialogRequest | ((prev: EvaluateFormulaDialogRequest | null) => EvaluateFormulaDialogRequest | null) | null) => void];
+/**
+ * Number of mounted `EvaluateFormulaDialogHost`s. The grid only claims the trigger
+ * (shortcut / context-menu item) while a host is mounted, so a host that has
+ * not adopted the dialog keeps the browser default instead of a dead action.
+ */
+export declare const evaluateFormulaDialogHostCountAtom: import("jotai").PrimitiveAtom<number> & {
+    init: number;
+};
+/** True when at least one `EvaluateFormulaDialogHost` is mounted. */
+export declare const useIsEvaluateFormulaDialogMounted: () => boolean;
+/** Registers the calling component as a dialog host for its lifetime. */
+export declare const useRegisterEvaluateFormulaDialogHost: () => void;
+/** Returns a function that opens the host-mounted Evaluate Formula dialog. */
+export declare const useOpenEvaluateFormulaDialog: () => (request: EvaluateFormulaDialogRequest) => void;
+//# sourceMappingURL=evaluate-formula-dialog.atom.d.ts.map

package/dist/cjs/atoms/evaluate-formula-dialog.atom.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"evaluate-formula-dialog.atom.d.ts","sourceRoot":"","sources":["../../../atoms/evaluate-formula-dialog.atom.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAChE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAIxD;;;;;GAKG;AACH,MAAM,MAAM,4BAA4B,GAAG;IACzC,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,aAAa,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,qDAAqD;IACrD,OAAO,EAAE,MAAM,CAAC;IAChB,qEAAqE;IACrE,QAAQ,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,OAAO,CAAC,eAAe,CAAC,CAAC;CAC5D,CAAC;AAEF,eAAO,MAAM,yBAAyB;;CACW,CAAC;AAElD,eAAO,MAAM,6BAA6B,2LACN,CAAC;AAErC;;;;GAIG;AACH,eAAO,MAAM,kCAAkC;;CAAU,CAAC;AAE1D,qEAAqE;AACrE,eAAO,MAAM,iCAAiC,eACQ,CAAC;AAEvD,yEAAyE;AACzE,eAAO,MAAM,oCAAoC,YAMhD,CAAC;AAEF,8EAA8E;AAC9E,eAAO,MAAM,4BAA4B,kBAG3B,4BAA4B,SAGzC,CAAC"}

package/dist/cjs/atoms/evaluate-formula-dialog.atom.js

@@ -0,0 +1,36 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useOpenEvaluateFormulaDialog = exports.useRegisterEvaluateFormulaDialogHost = exports.useIsEvaluateFormulaDialogMounted = exports.evaluateFormulaDialogHostCountAtom = exports.useEvaluateFormulaDialogState = exports.evaluateFormulaDialogAtom = void 0;
+var jotai_1 = require("jotai");
+var react_1 = require("react");
+exports.evaluateFormulaDialogAtom = (0, jotai_1.atom)(null);
+var useEvaluateFormulaDialogState = function () {
+    return (0, jotai_1.useAtom)(exports.evaluateFormulaDialogAtom);
+};
+exports.useEvaluateFormulaDialogState = useEvaluateFormulaDialogState;
+/**
+ * Number of mounted `EvaluateFormulaDialogHost`s. The grid only claims the trigger
+ * (shortcut / context-menu item) while a host is mounted, so a host that has
+ * not adopted the dialog keeps the browser default instead of a dead action.
+ */
+exports.evaluateFormulaDialogHostCountAtom = (0, jotai_1.atom)(0);
+/** True when at least one `EvaluateFormulaDialogHost` is mounted. */
+var useIsEvaluateFormulaDialogMounted = function () {
+    return (0, jotai_1.useAtomValue)(exports.evaluateFormulaDialogHostCountAtom) > 0;
+};
+exports.useIsEvaluateFormulaDialogMounted = useIsEvaluateFormulaDialogMounted;
+/** Registers the calling component as a dialog host for its lifetime. */
+var useRegisterEvaluateFormulaDialogHost = function () {
+    var setCount = (0, jotai_1.useSetAtom)(exports.evaluateFormulaDialogHostCountAtom);
+    (0, react_1.useEffect)(function () {
+        setCount(function (count) { return count + 1; });
+        return function () { return setCount(function (count) { return count - 1; }); };
+    }, [setCount]);
+};
+exports.useRegisterEvaluateFormulaDialogHost = useRegisterEvaluateFormulaDialogHost;
+/** Returns a function that opens the host-mounted Evaluate Formula dialog. */
+var useOpenEvaluateFormulaDialog = function () {
+    var setRequest = (0, jotai_1.useSetAtom)(exports.evaluateFormulaDialogAtom);
+    return (0, react_1.useCallback)(function (request) { return setRequest(request); }, [setRequest]);
+};
+exports.useOpenEvaluateFormulaDialog = useOpenEvaluateFormulaDialog;

package/dist/cjs/atoms/go-to-dialog.atom.d.ts

@@ -0,0 +1,46 @@
+import type { CellInterface, GridRange } from "@rowsncolumns/grid";
+import type { GoToSpecialKind } from "../api/go-to-special";
+import type { NamedRange, SheetRange } from "../types";
+/**
+ * Open-state + payload for the Go To dialog (Excel `Ctrl+G` / `F5`). The grid
+ * opens it with everything needed to resolve a reference against the
+ * workbook; the host-mounted dialog hands the resolved range to `onNavigate`.
+ */
+export type GoToDialogRequest = {
+    sheetId: number;
+    activeCell: CellInterface;
+    namedRanges?: NamedRange[] | null;
+    getSheetId?: (sheetName: string) => number | undefined;
+    getSheetName?: (sheetId: number) => string | undefined;
+    rowCount?: number;
+    columnCount?: number;
+    onNavigate: (range: SheetRange) => void;
+    /**
+     * Go To Special: resolves a category against the current selection (or
+     * the sheet) and selects the resulting runs. Absent when the grid cannot
+     * read cell data, in which case the dialog hides the "Special…" panel.
+     */
+    special?: {
+        resolve: (kind: GoToSpecialKind) => GridRange[];
+        onSelectRanges: (ranges: GridRange[]) => void;
+    };
+};
+export declare const goToDialogAtom: import("jotai").PrimitiveAtom<GoToDialogRequest | null> & {
+    init: GoToDialogRequest | null;
+};
+export declare const useGoToDialogState: () => [GoToDialogRequest | null, (args_0: GoToDialogRequest | ((prev: GoToDialogRequest | null) => GoToDialogRequest | null) | null) => void];
+/**
+ * Number of mounted `GoToDialogHost`s. The grid only claims the trigger
+ * (shortcut / context-menu item) while a host is mounted, so a host that has
+ * not adopted the dialog keeps the browser default instead of a dead action.
+ */
+export declare const goToDialogHostCountAtom: import("jotai").PrimitiveAtom<number> & {
+    init: number;
+};
+/** True when at least one `GoToDialogHost` is mounted. */
+export declare const useIsGoToDialogMounted: () => boolean;
+/** Registers the calling component as a dialog host for its lifetime. */
+export declare const useRegisterGoToDialogHost: () => void;
+/** Returns a function that opens the host-mounted Go To dialog. */
+export declare const useOpenGoToDialog: () => (request: GoToDialogRequest) => void;
+//# sourceMappingURL=go-to-dialog.atom.d.ts.map

package/dist/cjs/atoms/go-to-dialog.atom.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"go-to-dialog.atom.d.ts","sourceRoot":"","sources":["../../../atoms/go-to-dialog.atom.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAInE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAEvD;;;;GAIG;AACH,MAAM,MAAM,iBAAiB,GAAG;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,aAAa,CAAC;IAC1B,WAAW,CAAC,EAAE,UAAU,EAAE,GAAG,IAAI,CAAC;IAClC,UAAU,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAC;IACvD,YAAY,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAC;IACvD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,CAAC;IACxC;;;;OAIG;IACH,OAAO,CAAC,EAAE;QACR,OAAO,EAAE,CAAC,IAAI,EAAE,eAAe,KAAK,SAAS,EAAE,CAAC;QAChD,cAAc,EAAE,CAAC,MAAM,EAAE,SAAS,EAAE,KAAK,IAAI,CAAC;KAC/C,CAAC;CACH,CAAC;AAEF,eAAO,MAAM,cAAc;;CAAuC,CAAC;AAEnE,eAAO,MAAM,kBAAkB,+IAAgC,CAAC;AAEhE;;;;GAIG;AACH,eAAO,MAAM,uBAAuB;;CAAU,CAAC;AAE/C,0DAA0D;AAC1D,eAAO,MAAM,sBAAsB,eACQ,CAAC;AAE5C,yEAAyE;AACzE,eAAO,MAAM,yBAAyB,YAMrC,CAAC;AAEF,mEAAmE;AACnE,eAAO,MAAM,iBAAiB,kBAGhB,iBAAiB,SAG9B,CAAC"}

package/dist/cjs/atoms/go-to-dialog.atom.js

@@ -0,0 +1,34 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useOpenGoToDialog = exports.useRegisterGoToDialogHost = exports.useIsGoToDialogMounted = exports.goToDialogHostCountAtom = exports.useGoToDialogState = exports.goToDialogAtom = void 0;
+var jotai_1 = require("jotai");
+var react_1 = require("react");
+exports.goToDialogAtom = (0, jotai_1.atom)(null);
+var useGoToDialogState = function () { return (0, jotai_1.useAtom)(exports.goToDialogAtom); };
+exports.useGoToDialogState = useGoToDialogState;
+/**
+ * Number of mounted `GoToDialogHost`s. The grid only claims the trigger
+ * (shortcut / context-menu item) while a host is mounted, so a host that has
+ * not adopted the dialog keeps the browser default instead of a dead action.
+ */
+exports.goToDialogHostCountAtom = (0, jotai_1.atom)(0);
+/** True when at least one `GoToDialogHost` is mounted. */
+var useIsGoToDialogMounted = function () {
+    return (0, jotai_1.useAtomValue)(exports.goToDialogHostCountAtom) > 0;
+};
+exports.useIsGoToDialogMounted = useIsGoToDialogMounted;
+/** Registers the calling component as a dialog host for its lifetime. */
+var useRegisterGoToDialogHost = function () {
+    var setCount = (0, jotai_1.useSetAtom)(exports.goToDialogHostCountAtom);
+    (0, react_1.useEffect)(function () {
+        setCount(function (count) { return count + 1; });
+        return function () { return setCount(function (count) { return count - 1; }); };
+    }, [setCount]);
+};
+exports.useRegisterGoToDialogHost = useRegisterGoToDialogHost;
+/** Returns a function that opens the host-mounted Go To dialog. */
+var useOpenGoToDialog = function () {
+    var setRequest = (0, jotai_1.useSetAtom)(exports.goToDialogAtom);
+    return (0, react_1.useCallback)(function (request) { return setRequest(request); }, [setRequest]);
+};
+exports.useOpenGoToDialog = useOpenGoToDialog;

package/dist/cjs/atoms/goal-seek-dialog.atom.d.ts

@@ -0,0 +1,29 @@
+import type { GoalSeekResult } from "../types";
+/**
+ * Open-state + payload for the Goal Seek dialog (Excel's Data → What-If
+ * Analysis → Goal Seek). The context menu opens it with the active cell as
+ * the "Set cell"; the host-mounted dialog routes the three fields (as A1
+ * references) back through `onApply` and shows the search status it
+ * resolves to.
+ */
+export type GoalSeekDialogRequest = {
+    /** A1 reference of the active cell — the default "Set cell". */
+    setCell: string;
+    /** Runs the search; resolves to the result, or `undefined` when the engine reports none. */
+    onApply: (setCell: string, targetValue: number, changingCell: string) => Promise<GoalSeekResult | undefined>;
+};
+export declare const goalSeekDialogAtom: import("jotai").PrimitiveAtom<GoalSeekDialogRequest | null> & {
+    init: GoalSeekDialogRequest | null;
+};
+export declare const useGoalSeekDialogState: () => [GoalSeekDialogRequest | null, (args_0: GoalSeekDialogRequest | ((prev: GoalSeekDialogRequest | null) => GoalSeekDialogRequest | null) | null) => void];
+/** Number of mounted `GoalSeekDialogHost`s — the menu item is offered only while > 0. */
+export declare const goalSeekDialogHostCountAtom: import("jotai").PrimitiveAtom<number> & {
+    init: number;
+};
+/** True when at least one `GoalSeekDialogHost` is mounted. */
+export declare const useIsGoalSeekDialogMounted: () => boolean;
+/** Registers the calling component as a dialog host for its lifetime. */
+export declare const useRegisterGoalSeekDialogHost: () => void;
+/** Returns a function that opens the host-mounted Goal Seek dialog. */
+export declare const useOpenGoalSeekDialog: () => (request: GoalSeekDialogRequest) => void;
+//# sourceMappingURL=goal-seek-dialog.atom.d.ts.map

package/dist/cjs/atoms/goal-seek-dialog.atom.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"goal-seek-dialog.atom.d.ts","sourceRoot":"","sources":["../../../atoms/goal-seek-dialog.atom.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAE/C;;;;;;GAMG;AACH,MAAM,MAAM,qBAAqB,GAAG;IAClC,gEAAgE;IAChE,OAAO,EAAE,MAAM,CAAC;IAChB,4FAA4F;IAC5F,OAAO,EAAE,CACP,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,MAAM,KACjB,OAAO,CAAC,cAAc,GAAG,SAAS,CAAC,CAAC;CAC1C,CAAC;AAEF,eAAO,MAAM,kBAAkB;;CAA2C,CAAC;AAE3E,eAAO,MAAM,sBAAsB,+JAAoC,CAAC;AAExE,yFAAyF;AACzF,eAAO,MAAM,2BAA2B;;CAAU,CAAC;AAEnD,8DAA8D;AAC9D,eAAO,MAAM,0BAA0B,eACQ,CAAC;AAEhD,yEAAyE;AACzE,eAAO,MAAM,6BAA6B,YAMzC,CAAC;AAEF,uEAAuE;AACvE,eAAO,MAAM,qBAAqB,kBAGpB,qBAAqB,SAGlC,CAAC"}

package/dist/cjs/atoms/goal-seek-dialog.atom.js

@@ -0,0 +1,30 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useOpenGoalSeekDialog = exports.useRegisterGoalSeekDialogHost = exports.useIsGoalSeekDialogMounted = exports.goalSeekDialogHostCountAtom = exports.useGoalSeekDialogState = exports.goalSeekDialogAtom = void 0;
+var jotai_1 = require("jotai");
+var react_1 = require("react");
+exports.goalSeekDialogAtom = (0, jotai_1.atom)(null);
+var useGoalSeekDialogState = function () { return (0, jotai_1.useAtom)(exports.goalSeekDialogAtom); };
+exports.useGoalSeekDialogState = useGoalSeekDialogState;
+/** Number of mounted `GoalSeekDialogHost`s — the menu item is offered only while > 0. */
+exports.goalSeekDialogHostCountAtom = (0, jotai_1.atom)(0);
+/** True when at least one `GoalSeekDialogHost` is mounted. */
+var useIsGoalSeekDialogMounted = function () {
+    return (0, jotai_1.useAtomValue)(exports.goalSeekDialogHostCountAtom) > 0;
+};
+exports.useIsGoalSeekDialogMounted = useIsGoalSeekDialogMounted;
+/** Registers the calling component as a dialog host for its lifetime. */
+var useRegisterGoalSeekDialogHost = function () {
+    var setCount = (0, jotai_1.useSetAtom)(exports.goalSeekDialogHostCountAtom);
+    (0, react_1.useEffect)(function () {
+        setCount(function (count) { return count + 1; });
+        return function () { return setCount(function (count) { return count - 1; }); };
+    }, [setCount]);
+};
+exports.useRegisterGoalSeekDialogHost = useRegisterGoalSeekDialogHost;
+/** Returns a function that opens the host-mounted Goal Seek dialog. */
+var useOpenGoalSeekDialog = function () {
+    var setRequest = (0, jotai_1.useSetAtom)(exports.goalSeekDialogAtom);
+    return (0, react_1.useCallback)(function (request) { return setRequest(request); }, [setRequest]);
+};
+exports.useOpenGoalSeekDialog = useOpenGoalSeekDialog;

package/dist/cjs/atoms/index.d.ts

@@ -15,4 +15,9 @@ export * from "./paste-menu.atom";
 export * from "./magic-fill-state.atom";
 export * from "./validation-alert.atom";
 export * from "./sort-dialog.atom";
+export * from "./paste-special-dialog.atom";
+export * from "./go-to-dialog.atom";
+export * from "./evaluate-formula-dialog.atom";
+export * from "./remove-duplicates-dialog.atom";
+export * from "./watch-window.atom";
 //# sourceMappingURL=index.d.ts.map

package/dist/cjs/atoms/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../atoms/index.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAC;AACrC,cAAc,qBAAqB,CAAC;AACpC,cAAc,iCAAiC,CAAC;AAChD,cAAc,qBAAqB,CAAC;AACpC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,sBAAsB,CAAC;AACrC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,wBAAwB,CAAC;AACvC,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC/D,cAAc,6BAA6B,CAAC;AAC5C,cAAc,gBAAgB,CAAC;AAC/B,cAAc,mBAAmB,CAAC;AAClC,cAAc,yBAAyB,CAAC;AACxC,cAAc,yBAAyB,CAAC;AACxC,cAAc,oBAAoB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../atoms/index.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAC;AACrC,cAAc,qBAAqB,CAAC;AACpC,cAAc,iCAAiC,CAAC;AAChD,cAAc,qBAAqB,CAAC;AACpC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,sBAAsB,CAAC;AACrC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,wBAAwB,CAAC;AACvC,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC/D,cAAc,6BAA6B,CAAC;AAC5C,cAAc,gBAAgB,CAAC;AAC/B,cAAc,mBAAmB,CAAC;AAClC,cAAc,yBAAyB,CAAC;AACxC,cAAc,yBAAyB,CAAC;AACxC,cAAc,oBAAoB,CAAC;AACnC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,qBAAqB,CAAC;AACpC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,iCAAiC,CAAC;AAChD,cAAc,qBAAqB,CAAC"}

package/dist/cjs/atoms/index.js

@@ -20,3 +20,8 @@ tslib_1.__exportStar(require("./paste-menu.atom"), exports);
 tslib_1.__exportStar(require("./magic-fill-state.atom"), exports);
 tslib_1.__exportStar(require("./validation-alert.atom"), exports);
 tslib_1.__exportStar(require("./sort-dialog.atom"), exports);
+tslib_1.__exportStar(require("./paste-special-dialog.atom"), exports);
+tslib_1.__exportStar(require("./go-to-dialog.atom"), exports);
+tslib_1.__exportStar(require("./evaluate-formula-dialog.atom"), exports);
+tslib_1.__exportStar(require("./remove-duplicates-dialog.atom"), exports);
+tslib_1.__exportStar(require("./watch-window.atom"), exports);

package/dist/cjs/atoms/paste-special-dialog.atom.d.ts

@@ -0,0 +1,29 @@
+import type { PasteSpecialOptions } from "../hooks/use-copy-paste-cut";
+/**
+ * Open-state + payload for the Paste Special dialog (Excel `Ctrl+Alt+V` /
+ * context menu → Paste special…). The grid opens it with the paste callback
+ * of the current sheet; the host-mounted dialog routes the chosen options
+ * back through `onApply`.
+ */
+export type PasteSpecialDialogRequest = {
+    onApply: (options: PasteSpecialOptions) => void;
+};
+export declare const pasteSpecialDialogAtom: import("jotai").PrimitiveAtom<PasteSpecialDialogRequest | null> & {
+    init: PasteSpecialDialogRequest | null;
+};
+export declare const usePasteSpecialDialogState: () => [PasteSpecialDialogRequest | null, (args_0: PasteSpecialDialogRequest | ((prev: PasteSpecialDialogRequest | null) => PasteSpecialDialogRequest | null) | null) => void];
+/**
+ * Number of mounted `PasteSpecialDialogHost`s. The grid only claims the trigger
+ * (shortcut / context-menu item) while a host is mounted, so a host that has
+ * not adopted the dialog keeps the browser default instead of a dead action.
+ */
+export declare const pasteSpecialDialogHostCountAtom: import("jotai").PrimitiveAtom<number> & {
+    init: number;
+};
+/** True when at least one `PasteSpecialDialogHost` is mounted. */
+export declare const useIsPasteSpecialDialogMounted: () => boolean;
+/** Registers the calling component as a dialog host for its lifetime. */
+export declare const useRegisterPasteSpecialDialogHost: () => void;
+/** Returns a function that opens the host-mounted Paste Special dialog. */
+export declare const useOpenPasteSpecialDialog: () => (request: PasteSpecialDialogRequest) => void;
+//# sourceMappingURL=paste-special-dialog.atom.d.ts.map

package/dist/cjs/atoms/paste-special-dialog.atom.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paste-special-dialog.atom.d.ts","sourceRoot":"","sources":["../../../atoms/paste-special-dialog.atom.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAEvE;;;;;GAKG;AACH,MAAM,MAAM,yBAAyB,GAAG;IACtC,OAAO,EAAE,CAAC,OAAO,EAAE,mBAAmB,KAAK,IAAI,CAAC;CACjD,CAAC;AAEF,eAAO,MAAM,sBAAsB;;CAElC,CAAC;AAEF,eAAO,MAAM,0BAA0B,+KAAwC,CAAC;AAEhF;;;;GAIG;AACH,eAAO,MAAM,+BAA+B;;CAAU,CAAC;AAEvD,kEAAkE;AAClE,eAAO,MAAM,8BAA8B,eACQ,CAAC;AAEpD,yEAAyE;AACzE,eAAO,MAAM,iCAAiC,YAM7C,CAAC;AAEF,2EAA2E;AAC3E,eAAO,MAAM,yBAAyB,kBAGxB,yBAAyB,SAGtC,CAAC"}