@rowsncolumns/spreadsheet 10.2.72 → 10.2.74

package/dist/cjs/api/evaluate-formula.d.ts

@@ -0,0 +1,17 @@
+import type { EvaluationValue } from "@rowsncolumns/calculator";
+import type { CellInterface } from "@rowsncolumns/grid";
+import type { CanvasGridProps } from "../components/canvas-grid/typings";
+/** `ERROR.TYPE` result → Excel error literal. */
+export declare const ERROR_TYPE_CODES: Record<number, string>;
+/**
+ * Build the Evaluate Formula stepper's `evaluate` from the grid's
+ * `onRequestCalculate` (the cell editor's live-preview calculator — a
+ * read-only scratch evaluation in both engines). A string result is
+ * re-typed through the engine (see `retypeDisplayText`); a `FormulaError`
+ * instance (unwrapped reference calculator) becomes the error literal; the
+ * wrapped calculators report a formula error as an empty result, so a blank
+ * answer is re-asked as `ERROR.TYPE(expression)` to recover the error
+ * literal and a genuine blank stays `null`.
+ */
+export declare const createExpressionEvaluator: (onRequestCalculate: NonNullable<CanvasGridProps["onRequestCalculate"]>, sheetId: number, cell: CellInterface) => (expression: string) => Promise<EvaluationValue>;
+//# sourceMappingURL=evaluate-formula.d.ts.map

package/dist/cjs/api/evaluate-formula.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"evaluate-formula.d.ts","sourceRoot":"","sources":["../../../api/evaluate-formula.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAChE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAExD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mCAAmC,CAAC;AAEzE,iDAAiD;AACjD,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CASnD,CAAC;AAiFF;;;;;;;;;GASG;AACH,eAAO,MAAM,yBAAyB,GACpC,oBAAoB,WAAW,CAAC,eAAe,CAAC,oBAAoB,CAAC,CAAC,EACtE,SAAS,MAAM,EACf,MAAM,aAAa,MAIL,YAAY,MAAM,KAAG,OAAO,CAAC,eAAe,CAkB3D,CAAC"}

package/dist/cjs/api/evaluate-formula.js

@@ -0,0 +1,141 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createExpressionEvaluator = exports.ERROR_TYPE_CODES = void 0;
+var tslib_1 = require("tslib");
+/** `ERROR.TYPE` result → Excel error literal. */
+exports.ERROR_TYPE_CODES = {
+    1: "#NULL!",
+    2: "#DIV/0!",
+    3: "#VALUE!",
+    4: "#REF!",
+    5: "#NAME?",
+    6: "#NUM!",
+    7: "#N/A",
+    8: "#GETTING_DATA",
+};
+/**
+ * The error code of a `FormulaError`-shaped result (the unwrapped reference
+ * `useCalculation().onRequestCalculate` returns the error instance rather
+ * than throwing; the wrapped calculators return `undefined`). Duck-typed like
+ * the wrapper's `isFormulaErrorLike` so no parser import is needed here.
+ */
+var formulaErrorCode = function (value) {
+    if (!(value instanceof Error))
+        return undefined;
+    var code = value.error;
+    return typeof code === "string" && code.startsWith("#") ? code : undefined;
+};
+var toEvaluationValue = function (result) {
+    var error = formulaErrorCode(result);
+    if (error)
+        return { error: error };
+    if (Array.isArray(result)) {
+        return result.map(function (row) {
+            return Array.isArray(row)
+                ? row.map(function (cell) { return toEvaluationValue(cell); })
+                : [toEvaluationValue(row)];
+        });
+    }
+    if (result === null ||
+        result === undefined ||
+        typeof result === "string" ||
+        typeof result === "number" ||
+        typeof result === "boolean" ||
+        result instanceof Date) {
+        return result;
+    }
+    return String(result);
+};
+/**
+ * `onRequestCalculate` is the cell editor's live preview, so it reports
+ * DISPLAY text: the rnc engine stringifies numbers and booleans, the
+ * reference wrapper returns the formatted value (`1,234.50`, `$5.00`,
+ * `TRUE`). Substituting that text verbatim would turn `=A1=15` into
+ * `"15"=15` (FALSE) or `"1,234.50"*2` (#VALUE!), so the text is re-typed
+ * through the engine itself: `TYPE(expression)` says number / text /
+ * boolean, and a number is re-read as General text (`&""` keeps both probes
+ * clear of the cell's number format) so it parses back to a number.
+ */
+var retypeDisplayText = function (text, expression, calculate) { return tslib_1.__awaiter(void 0, void 0, void 0, function () {
+    var typeCode, _a, direct, general, parsed, upper, numeric;
+    return tslib_1.__generator(this, function (_b) {
+        switch (_b.label) {
+            case 0: return [4 /*yield*/, calculate("=TYPE(".concat(expression, ")&\"\""))];
+            case 1:
+                typeCode = _b.sent();
+                _a = typeof typeCode === "string" ? typeCode.trim() : typeCode;
+                switch (_a) {
+                    case "1": return [3 /*break*/, 2];
+                    case 1: return [3 /*break*/, 2];
+                    case "4": return [3 /*break*/, 4];
+                    case 4: return [3 /*break*/, 4];
+                }
+                return [3 /*break*/, 6];
+            case 2:
+                direct = Number(text);
+                if (Number.isFinite(direct) && text.trim() !== "")
+                    return [2 /*return*/, direct];
+                return [4 /*yield*/, calculate("=(".concat(expression, ")&\"\""))];
+            case 3:
+                general = _b.sent();
+                parsed = Number(typeof general === "string" ? general : NaN);
+                return [2 /*return*/, Number.isFinite(parsed) ? parsed : text];
+            case 4:
+                upper = text.trim().toUpperCase();
+                if (upper === "TRUE")
+                    return [2 /*return*/, true];
+                if (upper === "FALSE")
+                    return [2 /*return*/, false];
+                return [4 /*yield*/, calculate("=--(".concat(expression, ")&\"\""))];
+            case 5:
+                numeric = _b.sent();
+                return [2 /*return*/, typeof numeric === "string" ? numeric.trim() === "1" : text];
+            case 6: return [2 /*return*/, text];
+        }
+    });
+}); };
+/**
+ * Build the Evaluate Formula stepper's `evaluate` from the grid's
+ * `onRequestCalculate` (the cell editor's live-preview calculator — a
+ * read-only scratch evaluation in both engines). A string result is
+ * re-typed through the engine (see `retypeDisplayText`); a `FormulaError`
+ * instance (unwrapped reference calculator) becomes the error literal; the
+ * wrapped calculators report a formula error as an empty result, so a blank
+ * answer is re-asked as `ERROR.TYPE(expression)` to recover the error
+ * literal and a genuine blank stays `null`.
+ */
+var createExpressionEvaluator = function (onRequestCalculate, sheetId, cell) {
+    var calculate = function (formula) {
+        return onRequestCalculate(formula, sheetId, cell.rowIndex, cell.columnIndex);
+    };
+    return function (expression) { return tslib_1.__awaiter(void 0, void 0, void 0, function () {
+        var value, _a, errorType, code;
+        return tslib_1.__generator(this, function (_b) {
+            switch (_b.label) {
+                case 0:
+                    _a = toEvaluationValue;
+                    return [4 /*yield*/, calculate("=".concat(expression))];
+                case 1:
+                    value = _a.apply(void 0, [_b.sent()]);
+                    if (typeof value === "string") {
+                        return [2 /*return*/, retypeDisplayText(value, expression, calculate)];
+                    }
+                    if (value !== null && value !== undefined)
+                        return [2 /*return*/, value];
+                    return [4 /*yield*/, calculate("=ERROR.TYPE(".concat(expression, ")&\"\""))];
+                case 2:
+                    errorType = _b.sent();
+                    code = typeof errorType === "number"
+                        ? errorType
+                        : typeof errorType === "string"
+                            ? Number(errorType)
+                            : NaN;
+                    if (exports.ERROR_TYPE_CODES[code]) {
+                        return [2 /*return*/, { error: exports.ERROR_TYPE_CODES[code] }];
+                    }
+                    return [2 /*return*/, null];
+            }
+        });
+    }); };
+};
+exports.createExpressionEvaluator = createExpressionEvaluator;

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/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,36 @@
+import type { CellInterface } from "@rowsncolumns/grid";
+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;
+};
+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,MAAM,oBAAoB,CAAC;AAIxD,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;CACzC,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/index.d.ts

@@ -15,4 +15,8 @@ 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";
 //# 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"}

package/dist/cjs/atoms/index.js

@@ -20,3 +20,7 @@ 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);

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"}

package/dist/cjs/atoms/paste-special-dialog.atom.js

@@ -0,0 +1,34 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useOpenPasteSpecialDialog = exports.useRegisterPasteSpecialDialogHost = exports.useIsPasteSpecialDialogMounted = exports.pasteSpecialDialogHostCountAtom = exports.usePasteSpecialDialogState = exports.pasteSpecialDialogAtom = void 0;
+var jotai_1 = require("jotai");
+var react_1 = require("react");
+exports.pasteSpecialDialogAtom = (0, jotai_1.atom)(null);
+var usePasteSpecialDialogState = function () { return (0, jotai_1.useAtom)(exports.pasteSpecialDialogAtom); };
+exports.usePasteSpecialDialogState = usePasteSpecialDialogState;
+/**
+ * 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.
+ */
+exports.pasteSpecialDialogHostCountAtom = (0, jotai_1.atom)(0);
+/** True when at least one `PasteSpecialDialogHost` is mounted. */
+var useIsPasteSpecialDialogMounted = function () {
+    return (0, jotai_1.useAtomValue)(exports.pasteSpecialDialogHostCountAtom) > 0;
+};
+exports.useIsPasteSpecialDialogMounted = useIsPasteSpecialDialogMounted;
+/** Registers the calling component as a dialog host for its lifetime. */
+var useRegisterPasteSpecialDialogHost = function () {
+    var setCount = (0, jotai_1.useSetAtom)(exports.pasteSpecialDialogHostCountAtom);
+    (0, react_1.useEffect)(function () {
+        setCount(function (count) { return count + 1; });
+        return function () { return setCount(function (count) { return count - 1; }); };
+    }, [setCount]);
+};
+exports.useRegisterPasteSpecialDialogHost = useRegisterPasteSpecialDialogHost;
+/** Returns a function that opens the host-mounted Paste Special dialog. */
+var useOpenPasteSpecialDialog = function () {
+    var setRequest = (0, jotai_1.useSetAtom)(exports.pasteSpecialDialogAtom);
+    return (0, react_1.useCallback)(function (request) { return setRequest(request); }, [setRequest]);
+};
+exports.useOpenPasteSpecialDialog = useOpenPasteSpecialDialog;

package/dist/cjs/atoms/remove-duplicates-dialog.atom.d.ts

@@ -0,0 +1,45 @@
+import type { RemoveDuplicatesOptions } from "../types";
+/**
+ * One column of the range being de-duplicated.
+ */
+export type RemoveDuplicatesDialogColumn = {
+    /** Absolute sheet column index. */
+    columnIndex: number;
+    /** Positional label, e.g. "Column B". */
+    label: string;
+    /** Text of the first row, shown instead of `label` when "My data has headers" is on. */
+    header?: string;
+};
+/**
+ * Open-state + payload for the Remove Duplicates dialog. The context menu
+ * (which unmounts when it closes) opens the dialog by setting this atom; the
+ * dialog itself is host-mounted so it survives the menu closing. Mirrors the
+ * Sort dialog atom pattern.
+ */
+export type RemoveDuplicatesDialogRequest = {
+    columns: RemoveDuplicatesDialogColumn[];
+    /** Initial state of "My data has headers". */
+    hasHeader: boolean;
+    /** Routed to `onRemoveDuplicates` by the opener. */
+    onApply: (options: RemoveDuplicatesOptions) => void;
+};
+export declare const removeDuplicatesDialogAtom: import("jotai").PrimitiveAtom<RemoveDuplicatesDialogRequest | null> & {
+    init: RemoveDuplicatesDialogRequest | null;
+};
+/**
+ * Number of mounted `RemoveDuplicatesDialogHost`s. Openers fall back to an
+ * immediate de-dupe when no host is mounted, so a host that has not adopted
+ * the dialog keeps the previous one-click behaviour instead of a dead menu
+ * item.
+ */
+export declare const removeDuplicatesDialogHostCountAtom: import("jotai").PrimitiveAtom<number> & {
+    init: number;
+};
+export declare const useRemoveDuplicatesDialogState: () => [RemoveDuplicatesDialogRequest | null, (args_0: RemoveDuplicatesDialogRequest | ((prev: RemoveDuplicatesDialogRequest | null) => RemoveDuplicatesDialogRequest | null) | null) => void];
+/** Returns a function that opens the host-mounted Remove Duplicates dialog. */
+export declare const useOpenRemoveDuplicatesDialog: () => (request: RemoveDuplicatesDialogRequest) => void;
+/** True when at least one `RemoveDuplicatesDialogHost` is mounted. */
+export declare const useIsRemoveDuplicatesDialogMounted: () => boolean;
+/** Registers the calling component as a dialog host for its lifetime. */
+export declare const useRegisterRemoveDuplicatesDialogHost: () => void;
+//# sourceMappingURL=remove-duplicates-dialog.atom.d.ts.map

package/dist/cjs/atoms/remove-duplicates-dialog.atom.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"remove-duplicates-dialog.atom.d.ts","sourceRoot":"","sources":["../../../atoms/remove-duplicates-dialog.atom.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,UAAU,CAAC;AAExD;;GAEG;AACH,MAAM,MAAM,4BAA4B,GAAG;IACzC,mCAAmC;IACnC,WAAW,EAAE,MAAM,CAAC;IACpB,yCAAyC;IACzC,KAAK,EAAE,MAAM,CAAC;IACd,wFAAwF;IACxF,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF;;;;;GAKG;AACH,MAAM,MAAM,6BAA6B,GAAG;IAC1C,OAAO,EAAE,4BAA4B,EAAE,CAAC;IACxC,8CAA8C;IAC9C,SAAS,EAAE,OAAO,CAAC;IACnB,oDAAoD;IACpD,OAAO,EAAE,CAAC,OAAO,EAAE,uBAAuB,KAAK,IAAI,CAAC;CACrD,CAAC;AAEF,eAAO,MAAM,0BAA0B;;CACW,CAAC;AAEnD;;;;;GAKG;AACH,eAAO,MAAM,mCAAmC;;CAAU,CAAC;AAE3D,eAAO,MAAM,8BAA8B,+LACN,CAAC;AAEtC,+EAA+E;AAC/E,eAAO,MAAM,6BAA6B,kBAG5B,6BAA6B,SAG1C,CAAC;AAEF,sEAAsE;AACtE,eAAO,MAAM,kCAAkC,eACQ,CAAC;AAExD,yEAAyE;AACzE,eAAO,MAAM,qCAAqC,YAMjD,CAAC"}

package/dist/cjs/atoms/remove-duplicates-dialog.atom.js

@@ -0,0 +1,37 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useRegisterRemoveDuplicatesDialogHost = exports.useIsRemoveDuplicatesDialogMounted = exports.useOpenRemoveDuplicatesDialog = exports.useRemoveDuplicatesDialogState = exports.removeDuplicatesDialogHostCountAtom = exports.removeDuplicatesDialogAtom = void 0;
+var jotai_1 = require("jotai");
+var react_1 = require("react");
+exports.removeDuplicatesDialogAtom = (0, jotai_1.atom)(null);
+/**
+ * Number of mounted `RemoveDuplicatesDialogHost`s. Openers fall back to an
+ * immediate de-dupe when no host is mounted, so a host that has not adopted
+ * the dialog keeps the previous one-click behaviour instead of a dead menu
+ * item.
+ */
+exports.removeDuplicatesDialogHostCountAtom = (0, jotai_1.atom)(0);
+var useRemoveDuplicatesDialogState = function () {
+    return (0, jotai_1.useAtom)(exports.removeDuplicatesDialogAtom);
+};
+exports.useRemoveDuplicatesDialogState = useRemoveDuplicatesDialogState;
+/** Returns a function that opens the host-mounted Remove Duplicates dialog. */
+var useOpenRemoveDuplicatesDialog = function () {
+    var setRequest = (0, jotai_1.useSetAtom)(exports.removeDuplicatesDialogAtom);
+    return (0, react_1.useCallback)(function (request) { return setRequest(request); }, [setRequest]);
+};
+exports.useOpenRemoveDuplicatesDialog = useOpenRemoveDuplicatesDialog;
+/** True when at least one `RemoveDuplicatesDialogHost` is mounted. */
+var useIsRemoveDuplicatesDialogMounted = function () {
+    return (0, jotai_1.useAtomValue)(exports.removeDuplicatesDialogHostCountAtom) > 0;
+};
+exports.useIsRemoveDuplicatesDialogMounted = useIsRemoveDuplicatesDialogMounted;
+/** Registers the calling component as a dialog host for its lifetime. */
+var useRegisterRemoveDuplicatesDialogHost = function () {
+    var setCount = (0, jotai_1.useSetAtom)(exports.removeDuplicatesDialogHostCountAtom);
+    (0, react_1.useEffect)(function () {
+        setCount(function (count) { return count + 1; });
+        return function () { return setCount(function (count) { return count - 1; }); };
+    }, [setCount]);
+};
+exports.useRegisterRemoveDuplicatesDialogHost = useRegisterRemoveDuplicatesDialogHost;

package/dist/cjs/components/canvas-grid/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../components/canvas-grid/index.tsx"],"names":[],"mappings":"AA2CA,OAAO,KASN,MAAM,OAAO,CAAC;AAoKf,OAAO,KAAK,EAEV,QAAQ,EAST,MAAM,aAAa,CAAC;AAarB,OAAO,KAAK,EACV,wBAAwB,EACxB,iBAAiB,EACjB,eAAe,EAEhB,MAAM,WAAW,CAAC;AAipJnB,eAAO,MAAM,UAAU,EAA4C,CACjE,CAAC,SAAS,QAAQ,CAAC,GAAG,CAAC,EAEvB,KAAK,EAAE,eAAe,CAAC,CAAC,CAAC,GACvB,wBAAwB,GAAG;IAAE,GAAG,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAA;CAAE,KAChE,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../components/canvas-grid/index.tsx"],"names":[],"mappings":"AA2CA,OAAO,KASN,MAAM,OAAO,CAAC;AA2Kf,OAAO,KAAK,EAEV,QAAQ,EAST,MAAM,aAAa,CAAC;AAarB,OAAO,KAAK,EACV,wBAAwB,EACxB,iBAAiB,EACjB,eAAe,EAEhB,MAAM,WAAW,CAAC;AA2wJnB,eAAO,MAAM,UAAU,EAA4C,CACjE,CAAC,SAAS,QAAQ,CAAC,GAAG,CAAC,EAEvB,KAAK,EAAE,eAAe,CAAC,CAAC,CAAC,GACvB,wBAAwB,GAAG;IAAE,GAAG,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAA;CAAE,KAChE,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC"}