@rowsncolumns/spreadsheet-state 28.0.73 → 28.0.75

package/dist/cjs/components/editors/data-validation-rule-editor.js

@@ -1,12 +1,12 @@
 import { __assign, __read, __spreadArray } from "tslib";
 import { CrossCircledIcon } from "@rowsncolumns/icons";
-import { CONDITION_NONE, FormulaInput, shouldShowFromValue, shouldShowToValue, useFormulaInputState, useGetNamedRanges, VALIDATION_CONDITION_LABELS, } from "@rowsncolumns/spreadsheet";
+import { buildExcelValidationRule, CONDITION_NONE, EXCEL_VALIDATION_KIND_LABELS, EXCEL_VALIDATION_OPERATOR_LABELS, FormulaInput, getValidationAnchor, isTwoSidedOperator, readExcelValidationSpec, shouldShowFromValue, shouldShowToValue, useFormulaInputState, useGetNamedRanges, VALIDATION_CONDITION_LABELS, } from "@rowsncolumns/spreadsheet";
 import { Button, IconButton, Input, Select, SelectContent, SelectItem, SelectPortal, SelectTrigger, SelectValue, Stack, useIsomorphicLayoutEffect, } from "@rowsncolumns/ui";
 import { uuid } from "@rowsncolumns/utils";
 import { useFormik } from "formik";
 import React, { useMemo, useState } from "react";
 export var DataValidationRuleEditor = function (_a) {
-    var _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o, _p, _q, _r, _s, _t, _u, _v, _w, _x, _y, _z, _0;
+    var _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o, _p, _q, _r, _s, _t, _u, _v, _w, _x, _y, _z, _0, _1, _2;
     var sheetId = _a.sheetId, dataValidationRule = _a.dataValidationRule, functionDescriptions = _a.functionDescriptions, idCreationStrategy = _a.idCreationStrategy, onCancel = _a.onCancel, onSubmit = _a.onSubmit;
     var ensureFormula = function (value) {
         if (!value)
@@ -17,19 +17,30 @@ export var DataValidationRuleEditor = function (_a) {
         return trimmed.startsWith("=") ? trimmed : "=".concat(trimmed);
     };
     var getNamedRanges = useGetNamedRanges();
-    var _1 = useFormik({
+    // Excel's Whole number / Time / Text length kinds live outside the
+    // ConditionType union; the select shows them as `EXCEL_KIND_*` entries and
+    // the rule is composed on save (see `buildExcelValidationRule`).
+    var _3 = __read(useState(function () { return readExcelValidationSpec(dataValidationRule); }), 2), excelSpec = _3[0], setExcelSpec = _3[1];
+    var _4 = useFormik({
         initialValues: dataValidationRule,
         onSubmit: function (values) {
+            if (excelSpec) {
+                var composed = buildExcelValidationRule(excelSpec, getValidationAnchor(values.ranges[0]));
+                if (!composed)
+                    return;
+                onSubmit === null || onSubmit === void 0 ? void 0 : onSubmit(__assign(__assign({}, values), composed), dataValidationRule);
+                return;
+            }
             onSubmit === null || onSubmit === void 0 ? void 0 : onSubmit(values, dataValidationRule);
         },
-    }), values = _1.values, handleSubmit = _1.handleSubmit, resetForm = _1.resetForm, setFieldValue = _1.setFieldValue;
+    }), values = _4.values, handleSubmit = _4.handleSubmit, resetForm = _4.resetForm, setFieldValue = _4.setFieldValue;
     // Cancel
     var onCancelForm = function () {
         onCancel === null || onCancel === void 0 ? void 0 : onCancel();
         resetForm();
     };
-    var _2 = __read(useState(function () { var _a, _b; return shouldShowToValue((_b = (_a = values.condition) === null || _a === void 0 ? void 0 : _a.type) !== null && _b !== void 0 ? _b : undefined); }), 2), showToValue = _2[0], setShowToValue = _2[1];
-    var _3 = __read(useState(function () { var _a, _b; return shouldShowFromValue((_b = (_a = values === null || values === void 0 ? void 0 : values.condition) === null || _a === void 0 ? void 0 : _a.type) !== null && _b !== void 0 ? _b : undefined); }), 2), showFromValue = _3[0], setShowFromValue = _3[1];
+    var _5 = __read(useState(function () { var _a, _b; return shouldShowToValue((_b = (_a = values.condition) === null || _a === void 0 ? void 0 : _a.type) !== null && _b !== void 0 ? _b : undefined); }), 2), showToValue = _5[0], setShowToValue = _5[1];
+    var _6 = __read(useState(function () { var _a, _b; return shouldShowFromValue((_b = (_a = values === null || values === void 0 ? void 0 : values.condition) === null || _a === void 0 ? void 0 : _a.type) !== null && _b !== void 0 ? _b : undefined); }), 2), showFromValue = _6[0], setShowFromValue = _6[1];
     var fromValue = (_d = (_c = (_b = values === null || values === void 0 ? void 0 : values.condition) === null || _b === void 0 ? void 0 : _b.values) === null || _c === void 0 ? void 0 : _c[0]) === null || _d === void 0 ? void 0 : _d.userEnteredValue;
     var toValue = (_g = (_f = (_e = values === null || values === void 0 ? void 0 : values.condition) === null || _e === void 0 ? void 0 : _e.values) === null || _f === void 0 ? void 0 : _f[1]) === null || _g === void 0 ? void 0 : _g.userEnteredValue;
     var updateDataValidationInputs = function (nextFromValue, nextToValue, nextType, includeToValue, includeFromValue) {
@@ -38,6 +49,11 @@ export var DataValidationRuleEditor = function (_a) {
         if (includeToValue === void 0) { includeToValue = showToValue; }
         if (includeFromValue === void 0) { includeFromValue = showFromValue; }
         var shouldIncludeFrom = includeFromValue && nextFromValue !== undefined;
+        // The condition no longer matches the imported Excel description — drop
+        // it so the exporter synthesizes from `condition` instead of replaying
+        // the stale source rule.
+        if (values.xlsxSource)
+            setFieldValue("xlsxSource", undefined);
         if (nextType === "CUSTOM_FORMULA") {
             setFieldValue("condition.values", __spreadArray([], __read((shouldIncludeFrom
                 ? [{ userEnteredValue: (_b = ensureFormula(nextFromValue)) !== null && _b !== void 0 ? _b : "" }]
@@ -101,8 +117,24 @@ export var DataValidationRuleEditor = function (_a) {
                     }, type: "button", className: "cursor-pointer" }, "Add range"))),
         React.createElement(Stack, { direction: "vertical", className: "gap-1 pb-1" },
             React.createElement("label", { className: "font-system text-sm" }, "Format rules"),
-            React.createElement(Select, { value: (_k = (_j = values === null || values === void 0 ? void 0 : values.condition) === null || _j === void 0 ? void 0 : _j.type) !== null && _k !== void 0 ? _k : CONDITION_NONE, onValueChange: function (value) {
+            React.createElement(Select, { value: excelSpec
+                    ? "".concat(EXCEL_KIND_PREFIX).concat(excelSpec.kind)
+                    : (_k = (_j = values === null || values === void 0 ? void 0 : values.condition) === null || _j === void 0 ? void 0 : _j.type) !== null && _k !== void 0 ? _k : CONDITION_NONE, onValueChange: function (value) {
                     var _a, _b, _c, _d;
+                    if (value.startsWith(EXCEL_KIND_PREFIX)) {
+                        var kind_1 = value.slice(EXCEL_KIND_PREFIX.length);
+                        setExcelSpec(function (prev) {
+                            var _a;
+                            return ({
+                                kind: kind_1,
+                                operator: (_a = prev === null || prev === void 0 ? void 0 : prev.operator) !== null && _a !== void 0 ? _a : "between",
+                                formula1: (prev === null || prev === void 0 ? void 0 : prev.kind) === kind_1 ? prev.formula1 : undefined,
+                                formula2: (prev === null || prev === void 0 ? void 0 : prev.kind) === kind_1 ? prev.formula2 : undefined,
+                            });
+                        });
+                        return;
+                    }
+                    setExcelSpec(undefined);
                     var nextShowTo = shouldShowToValue(value);
                     var nextShowFrom = shouldShowFromValue(value);
                     setFieldValue("condition.type", value);
@@ -118,23 +150,56 @@ export var DataValidationRuleEditor = function (_a) {
                 React.createElement(SelectPortal, null,
                     React.createElement(SelectContent, null,
                         React.createElement(SelectItem, { value: CONDITION_NONE }, "None"),
+                        EXCEL_VALIDATION_KIND_LABELS.map(function (_a) {
+                            var kind = _a.kind, label = _a.label;
+                            return (React.createElement(SelectItem, { key: kind, value: "".concat(EXCEL_KIND_PREFIX).concat(kind) }, label));
+                        }),
                         VALIDATION_CONDITION_LABELS.map(function (_a) {
                             var condition = _a.condition, label = _a.label;
                             return (React.createElement(SelectItem, { key: condition, value: condition }, label));
                         }))))),
+        excelSpec ? (React.createElement(Stack, { direction: "vertical", className: "gap-1 pb-3" },
+            React.createElement(Select, { value: excelSpec.operator, onValueChange: function (operator) {
+                    return setExcelSpec(function (prev) { return (prev ? __assign(__assign({}, prev), { operator: operator }) : prev); });
+                } },
+                React.createElement(SelectTrigger, { className: "mb-1 text-sm", "aria-label": "Data" },
+                    React.createElement(SelectValue, { placeholder: "between" })),
+                React.createElement(SelectPortal, null,
+                    React.createElement(SelectContent, null, EXCEL_VALIDATION_OPERATOR_LABELS.map(function (_a) {
+                        var operator = _a.operator, label = _a.label;
+                        return (React.createElement(SelectItem, { key: operator, value: operator }, label));
+                    })))),
+            React.createElement(Input, { value: (_l = excelSpec.formula1) !== null && _l !== void 0 ? _l : "", type: "text", name: "excelFormula1", onChange: function (e) {
+                    return setExcelSpec(function (prev) {
+                        return prev ? __assign(__assign({}, prev), { formula1: e.target.value }) : prev;
+                    });
+                }, className: "text-xs", placeholder: isTwoSidedOperator(excelSpec.operator)
+                    ? excelSpec.kind === "time"
+                        ? "Start time"
+                        : "Minimum"
+                    : excelSpec.kind === "time"
+                        ? "Time"
+                        : excelSpec.kind === "textLength"
+                            ? "Length"
+                            : "Value" }),
+            isTwoSidedOperator(excelSpec.operator) ? (React.createElement(Input, { value: (_m = excelSpec.formula2) !== null && _m !== void 0 ? _m : "", type: "text", name: "excelFormula2", onChange: function (e) {
+                    return setExcelSpec(function (prev) {
+                        return prev ? __assign(__assign({}, prev), { formula2: e.target.value }) : prev;
+                    });
+                }, className: "text-xs", placeholder: excelSpec.kind === "time" ? "End time" : "Maximum" })) : null)) : null,
         React.createElement(Stack, { direction: "vertical", className: "gap-1  pb-3" },
-            showFromValue ? (((_l = values.condition) === null || _l === void 0 ? void 0 : _l.type) === "CUSTOM_FORMULA" ||
-                ((_m = values.condition) === null || _m === void 0 ? void 0 : _m.type) === "ONE_OF_RANGE" ? (React.createElement(FormulaInput, { onChange: function (value) {
+            !excelSpec && showFromValue ? (((_o = values.condition) === null || _o === void 0 ? void 0 : _o.type) === "CUSTOM_FORMULA" ||
+                ((_p = values.condition) === null || _p === void 0 ? void 0 : _p.type) === "ONE_OF_RANGE" ? (React.createElement(FormulaInput, { onChange: function (value) {
                     var _a, _b;
                     return updateDataValidationInputs(value, undefined, (_b = (_a = values.condition) === null || _a === void 0 ? void 0 : _a.type) !== null && _b !== void 0 ? _b : undefined, false, true);
                 }, value: fromValue !== null && fromValue !== void 0 ? fromValue : "=", required: true, placeholder: "Enter a formula", autoFocus: true, functionDescriptions: functionDescriptions, getNamedRanges: getNamedRanges })) : (React.createElement(Input, { value: fromValue, type: "text", name: "fromValue", onChange: function (e) {
                     return updateDataValidationInputs(e.target.value, toValue);
                 }, className: "text-xs", placeholder: "Value or formula" }))) : null,
-            showToValue ? (React.createElement(Input, { value: toValue, type: "text", name: "toValue", onChange: function (e) {
+            !excelSpec && showToValue ? (React.createElement(Input, { value: toValue, type: "text", name: "toValue", onChange: function (e) {
                     return updateDataValidationInputs(fromValue, e.target.value);
                 }, className: "text-xs", placeholder: "Value or formula" })) : null),
         React.createElement(Stack, { direction: "vertical", className: "gap-1 pb-1 flex-row" },
-            React.createElement("input", { type: "checkbox", checked: (_o = values.allowBlank) !== null && _o !== void 0 ? _o : undefined, onChange: function (e) {
+            React.createElement("input", { type: "checkbox", checked: (_q = values.allowBlank) !== null && _q !== void 0 ? _q : undefined, onChange: function (e) {
                     setFieldValue("allowBlank", e.target.checked);
                 }, id: "validationAllowBlank" }),
             React.createElement("label", { htmlFor: "validationAllowBlank", className: "font-system text-sm" }, "Allow blank")),
@@ -145,10 +210,10 @@ export var DataValidationRuleEditor = function (_a) {
                 }, id: "validationShowInputMessage" }),
             React.createElement("label", { htmlFor: "validationShowInputMessage", className: "font-system text-sm" }, "Show input message when cell is selected")),
         values.inputMessage ? (React.createElement(Stack, { direction: "vertical", className: "gap-1 pb-3" },
-            React.createElement(Input, { value: (_q = (_p = values.inputMessage) === null || _p === void 0 ? void 0 : _p.title) !== null && _q !== void 0 ? _q : "", type: "text", name: "inputMessageTitle", onChange: function (e) {
+            React.createElement(Input, { value: (_s = (_r = values.inputMessage) === null || _r === void 0 ? void 0 : _r.title) !== null && _s !== void 0 ? _s : "", type: "text", name: "inputMessageTitle", onChange: function (e) {
                     return setFieldValue("inputMessage.title", e.target.value);
                 }, className: "text-xs", placeholder: "Title" }),
-            React.createElement(Input, { value: (_s = (_r = values.inputMessage) === null || _r === void 0 ? void 0 : _r.message) !== null && _s !== void 0 ? _s : "", type: "text", name: "inputMessageBody", onChange: function (e) {
+            React.createElement(Input, { value: (_u = (_t = values.inputMessage) === null || _t === void 0 ? void 0 : _t.message) !== null && _u !== void 0 ? _u : "", type: "text", name: "inputMessageBody", onChange: function (e) {
                     return setFieldValue("inputMessage.message", e.target.value);
                 }, className: "text-xs", placeholder: "Input message" }))) : null,
         React.createElement(Stack, { direction: "vertical", className: "gap-1 pb-1 flex-row" },
@@ -158,7 +223,7 @@ export var DataValidationRuleEditor = function (_a) {
                 }, id: "validationShowErrorAlert" }),
             React.createElement("label", { htmlFor: "validationShowErrorAlert", className: "font-system text-sm" }, "Show error alert after invalid data is entered")),
         values.alert ? (React.createElement(Stack, { direction: "vertical", className: "gap-1 pb-3" },
-            React.createElement(Select, { value: (_u = (_t = values.alert) === null || _t === void 0 ? void 0 : _t.style) !== null && _u !== void 0 ? _u : "stop", onValueChange: function (value) {
+            React.createElement(Select, { value: (_w = (_v = values.alert) === null || _v === void 0 ? void 0 : _v.style) !== null && _w !== void 0 ? _w : "stop", onValueChange: function (value) {
                     return setFieldValue("alert.style", value);
                 } },
                 React.createElement(SelectTrigger, { className: "mb-1 text-sm" },
@@ -168,14 +233,16 @@ export var DataValidationRuleEditor = function (_a) {
                         React.createElement(SelectItem, { value: "stop" }, "Stop"),
                         React.createElement(SelectItem, { value: "warning" }, "Warning"),
                         React.createElement(SelectItem, { value: "information" }, "Information")))),
-            React.createElement(Input, { value: (_x = (_w = (_v = values.alert) === null || _v === void 0 ? void 0 : _v.message) === null || _w === void 0 ? void 0 : _w.title) !== null && _x !== void 0 ? _x : "", type: "text", name: "alertTitle", onChange: function (e) { return setFieldValue("alert.message.title", e.target.value); }, className: "text-xs", placeholder: "Title" }),
-            React.createElement(Input, { value: (_0 = (_z = (_y = values.alert) === null || _y === void 0 ? void 0 : _y.message) === null || _z === void 0 ? void 0 : _z.message) !== null && _0 !== void 0 ? _0 : "", type: "text", name: "alertBody", onChange: function (e) {
+            React.createElement(Input, { value: (_z = (_y = (_x = values.alert) === null || _x === void 0 ? void 0 : _x.message) === null || _y === void 0 ? void 0 : _y.title) !== null && _z !== void 0 ? _z : "", type: "text", name: "alertTitle", onChange: function (e) { return setFieldValue("alert.message.title", e.target.value); }, className: "text-xs", placeholder: "Title" }),
+            React.createElement(Input, { value: (_2 = (_1 = (_0 = values.alert) === null || _0 === void 0 ? void 0 : _0.message) === null || _1 === void 0 ? void 0 : _1.message) !== null && _2 !== void 0 ? _2 : "", type: "text", name: "alertBody", onChange: function (e) {
                     return setFieldValue("alert.message.message", e.target.value);
                 }, className: "text-xs", placeholder: "Error message" }))) : null,
         React.createElement("div", { className: "flex gap-1 py-2" },
             React.createElement(Button, { type: "submit", variant: "primary", size: "xs" }, "Save"),
             React.createElement(Button, { size: "xs", onClick: onCancelForm, type: "button" }, "Cancel"))));
 };
+/** Select values for the Excel kinds (kept out of the ConditionType union). */
+var EXCEL_KIND_PREFIX = "EXCEL_KIND_";
 var DataValidationRangeInput = function (_a) {
     var sheetId = _a.sheetId, range = _a.range, autoFocus = _a.autoFocus, onValidRange = _a.onValidRange;
     var formulaInput = useFormulaInputState(sheetId, range);

package/dist/cjs/hooks/use-calculation-worker.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-calculation-worker.d.ts","sourceRoot":"","sources":["../../../hooks/use-calculation-worker.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,8BAA8B,EAQ9B,mBAAmB,EACpB,MAAM,kCAAkC,CAAC;AAU1C,OAAO,KAAK,EACV,2BAA2B,EAE5B,MAAM,4BAA4B,CAAC;AAmBpC,OAAO,KAAK,EAEV,UAAU,EACV,SAAS,EACV,MAAM,2BAA2B,CAAC;AAgBnC,OAAO,KAAK,EAKV,mBAAmB,EACpB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAGxD,KAAK,wBAAwB,GAAG,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC;AAElE,MAAM,MAAM,gBAAgB,GAAG;IAC7B,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;CACvB,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,IAAI,EAAE,cAAc,CAAC;IACrB,KAAK,EACD,OAAO,GACP,YAAY,GACZ,iBAAiB,GACjB,iBAAiB,GACjB,yBAAyB,GACzB,cAAc,GACd,UAAU,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAyEF,MAAM,MAAM,yBAAyB,GAAG,mBAAmB,GAAG;IAC5D,MAAM,EAAE,mBAAmB,EAAE,CAAC;IAC9B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,MAAM,CAAC;IAC5B,YAAY,CAAC,EAAE,8BAA8B,CAAC,QAAQ,CAAC,CAAC;IACxD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,MAAM,CAAC,EAAE,SAAS,EAAE,CAAC;IACrB,WAAW,CAAC,EAAE,UAAU,EAAE,CAAC;IAC3B,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,oBAAoB,CAAC,EAAE,2BAA2B,CAAC;IACnD,kBAAkB,CAAC,CAAC,KAAK,EAAE,eAAe,GAAG,IAAI,CAAC;IAClD,wBAAwB,CAAC,EAAE,OAAO,CAAC;CACpC,CAAC;AA8KF,eAAO,MAAM,oBAAoB,GAC/B,OAAO,yBAAyB,KAC/B,wBA8/DF,CAAC"}
+{"version":3,"file":"use-calculation-worker.d.ts","sourceRoot":"","sources":["../../../hooks/use-calculation-worker.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,8BAA8B,EAQ9B,mBAAmB,EACpB,MAAM,kCAAkC,CAAC;AAU1C,OAAO,KAAK,EACV,2BAA2B,EAE5B,MAAM,4BAA4B,CAAC;AAmBpC,OAAO,KAAK,EAEV,UAAU,EACV,SAAS,EACV,MAAM,2BAA2B,CAAC;AAgBnC,OAAO,KAAK,EAKV,mBAAmB,EACpB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAGxD,KAAK,wBAAwB,GAAG,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC;AAElE,MAAM,MAAM,gBAAgB,GAAG;IAC7B,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;CACvB,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,IAAI,EAAE,cAAc,CAAC;IACrB,KAAK,EACD,OAAO,GACP,YAAY,GACZ,iBAAiB,GACjB,iBAAiB,GACjB,yBAAyB,GACzB,cAAc,GACd,UAAU,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAyEF,MAAM,MAAM,yBAAyB,GAAG,mBAAmB,GAAG;IAC5D,MAAM,EAAE,mBAAmB,EAAE,CAAC;IAC9B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,MAAM,CAAC;IAC5B,YAAY,CAAC,EAAE,8BAA8B,CAAC,QAAQ,CAAC,CAAC;IACxD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,MAAM,CAAC,EAAE,SAAS,EAAE,CAAC;IACrB,WAAW,CAAC,EAAE,UAAU,EAAE,CAAC;IAC3B,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,oBAAoB,CAAC,EAAE,2BAA2B,CAAC;IACnD,kBAAkB,CAAC,CAAC,KAAK,EAAE,eAAe,GAAG,IAAI,CAAC;IAClD,wBAAwB,CAAC,EAAE,OAAO,CAAC;CACpC,CAAC;AA8KF,eAAO,MAAM,oBAAoB,GAC/B,OAAO,yBAAyB,KAC/B,wBA+/DF,CAAC"}

package/dist/cjs/hooks/use-calculation-worker.js

@@ -1813,6 +1813,7 @@ export var useCalculationWorker = function (props) {
                                 position: position,
                                 formula: formula,
                                 precedents: dependencies,
+                                cellFormulas: graph.collectCellFormulas(formula, dependencies),
                                 isPreview: !disablePreview,
                             },
                         ],

package/dist/cjs/hooks/use-calculation.d.ts

@@ -148,7 +148,7 @@ export declare const useCalculation: ({ locale, functions, iterativeCalculation,
         disablePreview?: boolean;
         overrides?: CalculationOverrides;
         skipOnDemand?: boolean;
-    }) => Promise<string | number | boolean | StructuredResult | Date | FormulaError | FormulaResultArray | import("@rowsncolumns/fast-formula-parser").RecursiveFormula | DataSource | null | undefined>;
+    }) => Promise<string | number | boolean | Date | StructuredResult | FormulaError | FormulaResultArray | import("@rowsncolumns/fast-formula-parser").RecursiveFormula | DataSource | null | undefined>;
     getGraphNodes: () => Map<string, CellNode | StaticNode | CellRangeNode>;
     getGraphNodesInSheet: (sheetId: number) => ReadonlyMap<string, CellNode | CellRangeNode> | undefined;
     addStaticReference: (source: StaticReference, sourcePosition: CellCoordinate | CellCoordinateRange) => Calculator<any>;

package/dist/cjs/hooks/use-on-advanced-filter.d.ts

@@ -0,0 +1,21 @@
+import type { GridRange } from "@rowsncolumns/common-types";
+import { type AdvancedFilterOptions, type AdvancedFilterPlan, type AdvancedFilterPlanExecutor } from "../api/advanced-filter";
+import type { useSheetProperties } from "./use-sheet-properties";
+export type { AdvancedFilterOptions, AdvancedFilterPlan };
+export type UseOnAdvancedFilterProps = {
+    getEffectiveValue: ReturnType<typeof useSheetProperties>["getEffectiveValue"];
+    getFormattedValue: ReturnType<typeof useSheetProperties>["getFormattedValue"];
+    onHideRow: AdvancedFilterPlanExecutor["onHideRow"];
+    onShowRow: AdvancedFilterPlanExecutor["onShowRow"];
+    onChangeBatch: (sheetId: number, ranges: GridRange, values: (string | number | boolean | null)[][]) => void;
+};
+/**
+ * Excel's Data → Sort & Filter → Advanced, composed over the existing
+ * hide/show-row and batch-write callbacks so both engines execute it through
+ * the same streamed commands. Records are compared by their effective value
+ * (numbers stay numeric) and fall back to the displayed text. Returns the
+ * applied plan, or `undefined` when the list has no records, the copy
+ * destination is missing / protected, or the sheet cannot be edited.
+ */
+export declare const useOnAdvancedFilter: ({ getEffectiveValue, getFormattedValue, onHideRow, onShowRow, onChangeBatch, }: UseOnAdvancedFilterProps) => (sheetId: number, options: AdvancedFilterOptions) => AdvancedFilterPlan | undefined;
+//# sourceMappingURL=use-on-advanced-filter.d.ts.map

package/dist/cjs/hooks/use-on-advanced-filter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-on-advanced-filter.d.ts","sourceRoot":"","sources":["../../../hooks/use-on-advanced-filter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AAG5D,OAAO,EACL,KAAK,qBAAqB,EAC1B,KAAK,kBAAkB,EACvB,KAAK,0BAA0B,EAGhC,MAAM,wBAAwB,CAAC;AAEhC,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAEjE,YAAY,EAAE,qBAAqB,EAAE,kBAAkB,EAAE,CAAC;AAE1D,MAAM,MAAM,wBAAwB,GAAG;IACrC,iBAAiB,EAAE,UAAU,CAAC,OAAO,kBAAkB,CAAC,CAAC,mBAAmB,CAAC,CAAC;IAC9E,iBAAiB,EAAE,UAAU,CAAC,OAAO,kBAAkB,CAAC,CAAC,mBAAmB,CAAC,CAAC;IAC9E,SAAS,EAAE,0BAA0B,CAAC,WAAW,CAAC,CAAC;IACnD,SAAS,EAAE,0BAA0B,CAAC,WAAW,CAAC,CAAC;IACnD,aAAa,EAAE,CACb,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,SAAS,EACjB,MAAM,EAAE,CAAC,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,CAAC,EAAE,EAAE,KAC3C,IAAI,CAAC;CACX,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,mBAAmB,GAAI,gFAMjC,wBAAwB,eAKb,MAAM,WAAW,qBAAqB,KAAG,kBAAkB,GAAG,SA2B3E,CAAC"}

package/dist/cjs/hooks/use-on-advanced-filter.js

@@ -0,0 +1,42 @@
+import { useCallback } from "react";
+import { applyAdvancedFilterPlan, planAdvancedFilter, } from "../api/advanced-filter";
+import { useCanEditCellRange, useCanEditSheet } from "./use-can-edit-cellrange";
+/**
+ * Excel's Data → Sort & Filter → Advanced, composed over the existing
+ * hide/show-row and batch-write callbacks so both engines execute it through
+ * the same streamed commands. Records are compared by their effective value
+ * (numbers stay numeric) and fall back to the displayed text. Returns the
+ * applied plan, or `undefined` when the list has no records, the copy
+ * destination is missing / protected, or the sheet cannot be edited.
+ */
+export var useOnAdvancedFilter = function (_a) {
+    var getEffectiveValue = _a.getEffectiveValue, getFormattedValue = _a.getFormattedValue, onHideRow = _a.onHideRow, onShowRow = _a.onShowRow, onChangeBatch = _a.onChangeBatch;
+    var canEditCellRange = useCanEditCellRange();
+    var canEditSheet = useCanEditSheet();
+    return useCallback(function (sheetId, options) {
+        if (!canEditSheet(sheetId)) {
+            console.debug("This sheet is protected, users cannot filter it.");
+            return undefined;
+        }
+        var plan = planAdvancedFilter(options, function (rowIndex, columnIndex) {
+            var value = getEffectiveValue(sheetId, rowIndex, columnIndex);
+            return value !== null && value !== void 0 ? value : getFormattedValue(sheetId, rowIndex, columnIndex);
+        });
+        if (!plan)
+            return undefined;
+        if (plan.copy && !canEditCellRange(sheetId, plan.copy.range)) {
+            console.debug("This range is protected, users cannot edit this cell range.");
+            return undefined;
+        }
+        applyAdvancedFilterPlan(sheetId, plan, { onHideRow: onHideRow, onShowRow: onShowRow, onChangeBatch: onChangeBatch });
+        return plan;
+    }, [
+        canEditSheet,
+        canEditCellRange,
+        getEffectiveValue,
+        getFormattedValue,
+        onHideRow,
+        onShowRow,
+        onChangeBatch,
+    ]);
+};

package/dist/cjs/hooks/use-on-fill.d.ts

@@ -1,6 +1,6 @@
-import type { CellInterface, SelectionArea } from "@rowsncolumns/common-types";
-import { type CellData, type SelectionAttributes, type Sheet } from "@rowsncolumns/spreadsheet";
-import type { AutoFillType } from "../api/fill";
+import type { CellInterface, GridRange, SelectionArea } from "@rowsncolumns/common-types";
+import { type CellData, type FillOptions, type SelectionAttributes, type Sheet } from "@rowsncolumns/spreadsheet";
+import { type AutoFillType } from "../api/fill";
 import type { OnCommand } from "../commands";
 import type { CalculationOperation, useCalculation } from "./use-calculation";
 import type { CellXfsRegistry } from "./use-cellxfs-registry";
@@ -24,6 +24,15 @@ export type UseOnFillProps<T extends CellData, S extends Sheet> = {
     getAutoFillValues: NonNullable<UseSpreadsheetProps<T, S>["getAutoFillValues"]>;
     getSheetName(sheetId: number): string;
     onCommand?: OnCommand;
+    /**
+     * The sheet's merged ranges — a source tiled by identically sized merges fills block by block.
+     */
+    getMerges?(sheetId: number): GridRange[] | null | undefined;
+    /**
+     * Land the merge blocks a merged-seed fill produced: the target's own merges in `clearRange`
+     * give way, `merges` are created, and `selectRange` (the snapped fill extent) is re-selected.
+     */
+    onFillMerges?(sheetId: number, activeCell: CellInterface, clearRange: GridRange, merges: GridRange[], selectRange: GridRange): void;
 };
-export declare const useOnFill: <T extends CellData, S extends Sheet>({ locale, cellXfsRegistry, sharedStringRegistry, getCellData, getDataValidationById, getEffectiveValue, getFormattedValue, getAutoFillValues, getSheetName, enqueueCalculation, enqueueStructureChange, onChangeSheetData, onChangeDataValidations, createHistory, onCommand, }: UseOnFillProps<T, S>) => (sheetId: number, activeCell: CellInterface, fillSelection: SelectionArea, selections: SelectionArea<SelectionAttributes>[], fillableSelections?: SelectionArea<SelectionAttributes>[], fillType?: AutoFillType) => Promise<void>;
+export declare const useOnFill: <T extends CellData, S extends Sheet>({ locale, cellXfsRegistry, sharedStringRegistry, getCellData, getDataValidationById, getEffectiveValue, getFormattedValue, getAutoFillValues, getSheetName, enqueueCalculation, enqueueStructureChange, onChangeSheetData, onChangeDataValidations, createHistory, onCommand, getMerges, onFillMerges, }: UseOnFillProps<T, S>) => (sheetId: number, activeCell: CellInterface, fillSelection: SelectionArea, selections: SelectionArea<SelectionAttributes>[], fillableSelections?: SelectionArea<SelectionAttributes>[], fillType?: AutoFillType, options?: FillOptions) => Promise<void>;
 //# sourceMappingURL=use-on-fill.d.ts.map

package/dist/cjs/hooks/use-on-fill.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-on-fill.d.ts","sourceRoot":"","sources":["../../../hooks/use-on-fill.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC/E,OAAO,EACL,KAAK,QAAQ,EACb,KAAK,mBAAmB,EACxB,KAAK,KAAK,EAEX,MAAM,2BAA2B,CAAC;AAGnC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE7C,OAAO,KAAK,EAAE,oBAAoB,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAE9E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AACjE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AACnE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAC9D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAExD,MAAM,MAAM,cAAc,CAAC,CAAC,SAAS,QAAQ,EAAE,CAAC,SAAS,KAAK,IAAI;IAChE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,eAAe,CAAC,EAAE,eAAe,CAAC;IAClC,oBAAoB,CAAC,EAAE,oBAAoB,CAAC;IAC5C,WAAW,EAAE,UAAU,CAAC,OAAO,kBAAkB,CAAC,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC;IACrE,qBAAqB,CAAC,EAAE,UAAU,CAChC,OAAO,kBAAkB,CAAC,CAAC,CAAC,CAC7B,CAAC,uBAAuB,CAAC,CAAC;IAC3B,iBAAiB,EAAE,UAAU,CAC3B,OAAO,kBAAkB,CAAC,CAAC,CAAC,CAC7B,CAAC,mBAAmB,CAAC,CAAC;IACvB,iBAAiB,EAAE,UAAU,CAC3B,OAAO,kBAAkB,CAAC,CAAC,CAAC,CAC7B,CAAC,mBAAmB,CAAC,CAAC;IACvB,kBAAkB,CAAC,SAAS,EAAE,oBAAoB,GAAG,IAAI,CAAC;IAC1D,sBAAsB,CAAC,EAAE,UAAU,CACjC,OAAO,cAAc,CACtB,CAAC,wBAAwB,CAAC,CAAC;IAC5B,iBAAiB,EAAE,mBAAmB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC;IAClE,uBAAuB,CAAC,EAAE,mBAAmB,CAC3C,CAAC,EACD,CAAC,CACF,CAAC,yBAAyB,CAAC,CAAC;IAC7B,aAAa,IAAI,CAAC,OAAO,EAAE,gBAAgB,KAAK,IAAI,CAAC;IACrD,iBAAiB,EAAE,WAAW,CAC5B,mBAAmB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAC/C,CAAC;IACF,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC;IACtC,SAAS,CAAC,EAAE,SAAS,CAAC;CACvB,CAAC;AAEF,eAAO,MAAM,SAAS,GAAI,CAAC,SAAS,QAAQ,EAAE,CAAC,SAAS,KAAK,EAAE,iRAgB5D,cAAc,CAAC,CAAC,EAAE,CAAC,CAAC,eAKR,MAAM,cACH,aAAa,iBACV,aAAa,cAChB,aAAa,CAAC,mBAAmB,CAAC,EAAE,uBAC3B,aAAa,CAAC,mBAAmB,CAAC,EAAE,aAC9C,YAAY,kBAwE5B,CAAC"}
+{"version":3,"file":"use-on-fill.d.ts","sourceRoot":"","sources":["../../../hooks/use-on-fill.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,aAAa,EACb,SAAS,EACT,aAAa,EACd,MAAM,4BAA4B,CAAC;AACpC,OAAO,EACL,KAAK,QAAQ,EACb,KAAK,WAAW,EAChB,KAAK,mBAAmB,EACxB,KAAK,KAAK,EAEX,MAAM,2BAA2B,CAAC;AAInC,OAAO,EAAE,KAAK,YAAY,EAAuB,MAAM,aAAa,CAAC;AACrE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE7C,OAAO,KAAK,EAAE,oBAAoB,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAE9E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AACjE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AACnE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAC9D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAExD,MAAM,MAAM,cAAc,CAAC,CAAC,SAAS,QAAQ,EAAE,CAAC,SAAS,KAAK,IAAI;IAChE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,eAAe,CAAC,EAAE,eAAe,CAAC;IAClC,oBAAoB,CAAC,EAAE,oBAAoB,CAAC;IAC5C,WAAW,EAAE,UAAU,CAAC,OAAO,kBAAkB,CAAC,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC;IACrE,qBAAqB,CAAC,EAAE,UAAU,CAChC,OAAO,kBAAkB,CAAC,CAAC,CAAC,CAC7B,CAAC,uBAAuB,CAAC,CAAC;IAC3B,iBAAiB,EAAE,UAAU,CAC3B,OAAO,kBAAkB,CAAC,CAAC,CAAC,CAC7B,CAAC,mBAAmB,CAAC,CAAC;IACvB,iBAAiB,EAAE,UAAU,CAC3B,OAAO,kBAAkB,CAAC,CAAC,CAAC,CAC7B,CAAC,mBAAmB,CAAC,CAAC;IACvB,kBAAkB,CAAC,SAAS,EAAE,oBAAoB,GAAG,IAAI,CAAC;IAC1D,sBAAsB,CAAC,EAAE,UAAU,CACjC,OAAO,cAAc,CACtB,CAAC,wBAAwB,CAAC,CAAC;IAC5B,iBAAiB,EAAE,mBAAmB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC;IAClE,uBAAuB,CAAC,EAAE,mBAAmB,CAC3C,CAAC,EACD,CAAC,CACF,CAAC,yBAAyB,CAAC,CAAC;IAC7B,aAAa,IAAI,CAAC,OAAO,EAAE,gBAAgB,KAAK,IAAI,CAAC;IACrD,iBAAiB,EAAE,WAAW,CAC5B,mBAAmB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAC/C,CAAC;IACF,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC;IACtC,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB;;OAEG;IACH,SAAS,CAAC,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,EAAE,GAAG,IAAI,GAAG,SAAS,CAAC;IAC5D;;;OAGG;IACH,YAAY,CAAC,CACX,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,aAAa,EACzB,UAAU,EAAE,SAAS,EACrB,MAAM,EAAE,SAAS,EAAE,EACnB,WAAW,EAAE,SAAS,GACrB,IAAI,CAAC;CACT,CAAC;AAEF,eAAO,MAAM,SAAS,GAAI,CAAC,SAAS,QAAQ,EAAE,CAAC,SAAS,KAAK,EAAE,0SAkB5D,cAAc,CAAC,CAAC,EAAE,CAAC,CAAC,eAKR,MAAM,cACH,aAAa,iBACV,aAAa,cAChB,aAAa,CAAC,mBAAmB,CAAC,EAAE,uBAC3B,aAAa,CAAC,mBAAmB,CAAC,EAAE,aAC9C,YAAY,YAGb,WAAW,kBAuF1B,CAAC"}

package/dist/cjs/hooks/use-on-fill.js

@@ -1,16 +1,23 @@
 import { __awaiter, __generator, __read } from "tslib";
 import { useLoadingIndicator, } from "@rowsncolumns/spreadsheet";
+import { error } from "@rowsncolumns/utils";
 import { useCallback } from "react";
+import { MergedFillSizeError } from "../api/fill";
 import { applyFill } from "../interface/apply-fill";
 import { useCanEditCellRange } from "./use-can-edit-cellrange";
 export var useOnFill = function (_a) {
-    var locale = _a.locale, cellXfsRegistry = _a.cellXfsRegistry, sharedStringRegistry = _a.sharedStringRegistry, getCellData = _a.getCellData, getDataValidationById = _a.getDataValidationById, getEffectiveValue = _a.getEffectiveValue, getFormattedValue = _a.getFormattedValue, getAutoFillValues = _a.getAutoFillValues, getSheetName = _a.getSheetName, enqueueCalculation = _a.enqueueCalculation, enqueueStructureChange = _a.enqueueStructureChange, onChangeSheetData = _a.onChangeSheetData, onChangeDataValidations = _a.onChangeDataValidations, createHistory = _a.createHistory, onCommand = _a.onCommand;
+    var locale = _a.locale, cellXfsRegistry = _a.cellXfsRegistry, sharedStringRegistry = _a.sharedStringRegistry, getCellData = _a.getCellData, getDataValidationById = _a.getDataValidationById, getEffectiveValue = _a.getEffectiveValue, getFormattedValue = _a.getFormattedValue, getAutoFillValues = _a.getAutoFillValues, getSheetName = _a.getSheetName, enqueueCalculation = _a.enqueueCalculation, enqueueStructureChange = _a.enqueueStructureChange, onChangeSheetData = _a.onChangeSheetData, onChangeDataValidations = _a.onChangeDataValidations, createHistory = _a.createHistory, onCommand = _a.onCommand, getMerges = _a.getMerges, onFillMerges = _a.onFillMerges;
     var canEditCellRange = useCanEditCellRange();
     var _b = __read(useLoadingIndicator(), 2), showLoader = _b[0], hideLoader = _b[1];
-    return useCallback(function (sheetId, activeCell, fillSelection, selections, fillableSelections, fillType) { return __awaiter(void 0, void 0, void 0, function () {
+    return useCallback(function (sheetId, activeCell, fillSelection, selections, fillableSelections, fillType, 
+    // Modifier held on the fill handle / Series-dialog parameters. The
+    // positional `fillType` keeps working; `options.fillType` is a fallback.
+    options) { return __awaiter(void 0, void 0, void 0, function () {
+        var resolvedFillType, err_1;
         return __generator(this, function (_a) {
             switch (_a.label) {
                 case 0:
+                    resolvedFillType = fillType !== null && fillType !== void 0 ? fillType : options === null || options === void 0 ? void 0 : options.fillType;
                     if (!canEditCellRange(sheetId, fillSelection.range)) {
                         console.debug("This range is protected, users cannot edit this cell range.");
                         return [2 /*return*/];
@@ -19,7 +26,7 @@ export var useOnFill = function (_a) {
                     showLoader();
                     _a.label = 1;
                 case 1:
-                    _a.trys.push([1, , 3, 4]);
+                    _a.trys.push([1, 3, 4, 5]);
                     return [4 /*yield*/, applyFill({
                             locale: locale,
                             cellXfsRegistry: cellXfsRegistry,
@@ -35,14 +42,24 @@ export var useOnFill = function (_a) {
                             onChangeSheetData: onChangeSheetData,
                             onChangeDataValidations: onChangeDataValidations,
                             createHistory: createHistory,
-                        })(sheetId, activeCell, fillSelection, selections, fillableSelections, fillType)];
+                            getMerges: getMerges,
+                            onFillMerges: onFillMerges,
+                        })(sheetId, activeCell, fillSelection, selections, fillableSelections, resolvedFillType, options)];
                 case 2:
                     _a.sent();
-                    return [3 /*break*/, 4];
+                    return [3 /*break*/, 5];
                 case 3:
+                    err_1 = _a.sent();
+                    // Excel refuses a fill whose source mixes unequal merged blocks; nothing was written.
+                    if (err_1 instanceof MergedFillSizeError) {
+                        error(err_1.message);
+                        return [2 /*return*/];
+                    }
+                    throw err_1;
+                case 4:
                     hideLoader();
                     return [7 /*endfinally*/];
-                case 4:
+                case 5:
                     onCommand === null || onCommand === void 0 ? void 0 : onCommand({
                         command: "fill",
                         sheetId: sheetId,
@@ -50,7 +67,9 @@ export var useOnFill = function (_a) {
                         fillSelection: fillSelection,
                         selections: selections,
                         fillableSelections: fillableSelections,
-                        fillType: fillType,
+                        fillType: resolvedFillType,
+                        modifier: options === null || options === void 0 ? void 0 : options.modifier,
+                        series: options === null || options === void 0 ? void 0 : options.series,
                     });
                     return [2 /*return*/];
             }
@@ -74,5 +93,7 @@ export var useOnFill = function (_a) {
         onChangeDataValidations,
         getSheetName,
         onCommand,
+        getMerges,
+        onFillMerges,
     ]);
 };

package/dist/cjs/hooks/use-on-goal-seek.d.ts

@@ -0,0 +1,30 @@
+import type { CellInterface } from "@rowsncolumns/common-types";
+import { type GoalSeekResult } from "../api/goal-seek";
+import type { useCalculation } from "./use-calculation";
+import type { useOnChange } from "./use-on-change";
+import type { useSheetProperties } from "./use-sheet-properties";
+export type { GoalSeekResult };
+export type UseOnGoalSeekProps = {
+    getFormulaValue: ReturnType<typeof useSheetProperties>["getFormulaValue"];
+    getEffectiveValue: ReturnType<typeof useSheetProperties>["getEffectiveValue"];
+    /** The calculator's scratch evaluation (UNFORMATTED results). */
+    onRequestCalculate: ReturnType<typeof useCalculation>["onRequestCalculate"];
+    getDependents: ReturnType<typeof useCalculation>["getDependents"];
+    onChange: ReturnType<typeof useOnChange>;
+};
+/**
+ * Excel's Goal Seek (Data → What-If Analysis): find the value of
+ * `changingCell` that makes the formula in `setCell` evaluate to
+ * `targetValue`. Every trial is a scratch evaluation — the changing cell is
+ * pinned through the calculator's override map and the formula cells between
+ * it and the set cell (its transitive dependents, in dependency order) are
+ * re-evaluated into the same map, so nothing is written until the search
+ * ends. The final value is committed through `onChange` (one undo step,
+ * streamed to any engine consumer like a typed edit).
+ *
+ * Resolves to `undefined` when the set cell holds no formula or the changing
+ * cell is protected; otherwise the {@link GoalSeekResult} — Excel reports
+ * "found a solution" / "may not have found a solution" from `status`.
+ */
+export declare const useOnGoalSeek: ({ getFormulaValue, getEffectiveValue, onRequestCalculate, getDependents, onChange, }: UseOnGoalSeekProps) => (sheetId: number, setCell: CellInterface, targetValue: number, changingCell: CellInterface) => Promise<GoalSeekResult | undefined>;
+//# sourceMappingURL=use-on-goal-seek.d.ts.map

package/dist/cjs/hooks/use-on-goal-seek.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-on-goal-seek.d.ts","sourceRoot":"","sources":["../../../hooks/use-on-goal-seek.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAIhE,OAAO,EAAY,KAAK,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACjE,OAAO,KAAK,EAGV,cAAc,EACf,MAAM,mBAAmB,CAAC;AAE3B,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAEjE,YAAY,EAAE,cAAc,EAAE,CAAC;AAE/B,MAAM,MAAM,kBAAkB,GAAG;IAC/B,eAAe,EAAE,UAAU,CAAC,OAAO,kBAAkB,CAAC,CAAC,iBAAiB,CAAC,CAAC;IAC1E,iBAAiB,EAAE,UAAU,CAAC,OAAO,kBAAkB,CAAC,CAAC,mBAAmB,CAAC,CAAC;IAC9E,iEAAiE;IACjE,kBAAkB,EAAE,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC,oBAAoB,CAAC,CAAC;IAC5E,aAAa,EAAE,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC,eAAe,CAAC,CAAC;IAClE,QAAQ,EAAE,UAAU,CAAC,OAAO,WAAW,CAAC,CAAC;CAC1C,CAAC;AAUF;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,aAAa,GAAI,sFAM3B,kBAAkB,eAKN,MAAM,WACN,aAAa,eACT,MAAM,gBACL,aAAa,KAC1B,OAAO,CAAC,cAAc,GAAG,SAAS,CA+DxC,CAAC"}

package/dist/cjs/hooks/use-on-goal-seek.js

@@ -0,0 +1,140 @@
+import { __assign, __awaiter, __generator, __values } from "tslib";
+import { isCellNode, makeKey } from "@rowsncolumns/dag";
+import { useCallback } from "react";
+import { goalSeek } from "../api/goal-seek";
+import { useCanEditCellRange } from "./use-can-edit-cellrange";
+/** Cap on the formula chain re-evaluated per trial (a runaway dependency fan-out). */
+var MAX_AFFECTED_CELLS = 2000;
+var sameCell = function (a, sheetId, b) {
+    var _a;
+    return ((_a = a.sheetId) !== null && _a !== void 0 ? _a : sheetId) === sheetId &&
+        a.rowIndex === b.rowIndex &&
+        a.columnIndex === b.columnIndex;
+};
+/**
+ * Excel's Goal Seek (Data → What-If Analysis): find the value of
+ * `changingCell` that makes the formula in `setCell` evaluate to
+ * `targetValue`. Every trial is a scratch evaluation — the changing cell is
+ * pinned through the calculator's override map and the formula cells between
+ * it and the set cell (its transitive dependents, in dependency order) are
+ * re-evaluated into the same map, so nothing is written until the search
+ * ends. The final value is committed through `onChange` (one undo step,
+ * streamed to any engine consumer like a typed edit).
+ *
+ * Resolves to `undefined` when the set cell holds no formula or the changing
+ * cell is protected; otherwise the {@link GoalSeekResult} — Excel reports
+ * "found a solution" / "may not have found a solution" from `status`.
+ */
+export var useOnGoalSeek = function (_a) {
+    var getFormulaValue = _a.getFormulaValue, getEffectiveValue = _a.getEffectiveValue, onRequestCalculate = _a.onRequestCalculate, getDependents = _a.getDependents, onChange = _a.onChange;
+    var canEditCellRange = useCanEditCellRange();
+    return useCallback(function (sheetId, setCell, targetValue, changingCell) { return __awaiter(void 0, void 0, void 0, function () {
+        var formula, changingPosition, affected, _a, _b, node, position, evaluate, current, initialValue, result;
+        var e_1, _c;
+        return __generator(this, function (_d) {
+            switch (_d.label) {
+                case 0:
+                    if (!Number.isFinite(targetValue))
+                        return [2 /*return*/, undefined];
+                    if (!canEditCellRange(sheetId, changingCell)) {
+                        console.debug("This range is protected, users cannot edit this cell range.");
+                        return [2 /*return*/, undefined];
+                    }
+                    formula = getFormulaValue(sheetId, setCell.rowIndex, setCell.columnIndex);
+                    if (!formula)
+                        return [2 /*return*/, undefined];
+                    if (sameCell(setCell, sheetId, changingCell))
+                        return [2 /*return*/, undefined];
+                    changingPosition = __assign({ sheetId: sheetId }, changingCell);
+                    affected = [];
+                    try {
+                        for (_a = __values(getDependents(changingPosition)), _b = _a.next(); !_b.done; _b = _a.next()) {
+                            node = _b.value;
+                            if (!isCellNode(node))
+                                continue;
+                            position = node.position;
+                            if (sameCell(position, sheetId, setCell) && position.sheetId === sheetId)
+                                continue;
+                            if (position.conditionalFormatId != null || position.dataValidationId != null)
+                                continue;
+                            affected.push(position);
+                            if (affected.length >= MAX_AFFECTED_CELLS)
+                                break;
+                        }
+                    }
+                    catch (e_1_1) { e_1 = { error: e_1_1 }; }
+                    finally {
+                        try {
+                            if (_b && !_b.done && (_c = _a.return)) _c.call(_a);
+                        }
+                        finally { if (e_1) throw e_1.error; }
+                    }
+                    evaluate = function (trial) { return __awaiter(void 0, void 0, void 0, function () {
+                        var overrides, scratch, affected_1, affected_1_1, position, cellFormula, value, e_2_1, result;
+                        var e_2, _a;
+                        return __generator(this, function (_b) {
+                            switch (_b.label) {
+                                case 0:
+                                    overrides = new Map([[makeKey(changingPosition), trial]]);
+                                    scratch = function (text, position) { return __awaiter(void 0, void 0, void 0, function () {
+                                        return __generator(this, function (_a) {
+                                            return [2 /*return*/, onRequestCalculate(text, position.sheetId, position.rowIndex, position.columnIndex, {
+                                                    overrides: overrides,
+                                                    disablePreview: true,
+                                                })];
+                                        });
+                                    }); };
+                                    _b.label = 1;
+                                case 1:
+                                    _b.trys.push([1, 6, 7, 8]);
+                                    affected_1 = __values(affected), affected_1_1 = affected_1.next();
+                                    _b.label = 2;
+                                case 2:
+                                    if (!!affected_1_1.done) return [3 /*break*/, 5];
+                                    position = affected_1_1.value;
+                                    cellFormula = getFormulaValue(position.sheetId, position.rowIndex, position.columnIndex);
+                                    if (!cellFormula)
+                                        return [3 /*break*/, 4];
+                                    return [4 /*yield*/, scratch(cellFormula, position)];
+                                case 3:
+                                    value = _b.sent();
+                                    // An errored intermediate reads as an error in the set cell too,
+                                    // which the solver treats as an unusable trial.
+                                    overrides.set(makeKey(position), value instanceof Error ? undefined : value);
+                                    _b.label = 4;
+                                case 4:
+                                    affected_1_1 = affected_1.next();
+                                    return [3 /*break*/, 2];
+                                case 5: return [3 /*break*/, 8];
+                                case 6:
+                                    e_2_1 = _b.sent();
+                                    e_2 = { error: e_2_1 };
+                                    return [3 /*break*/, 8];
+                                case 7:
+                                    try {
+                                        if (affected_1_1 && !affected_1_1.done && (_a = affected_1.return)) _a.call(affected_1);
+                                    }
+                                    finally { if (e_2) throw e_2.error; }
+                                    return [7 /*endfinally*/];
+                                case 8: return [4 /*yield*/, scratch(formula, __assign({ sheetId: sheetId }, setCell))];
+                                case 9:
+                                    result = _b.sent();
+                                    return [2 /*return*/, typeof result === "number" && Number.isFinite(result) ? result : undefined];
+                            }
+                        });
+                    }); };
+                    current = getEffectiveValue(sheetId, changingCell.rowIndex, changingCell.columnIndex);
+                    initialValue = typeof current === "number"
+                        ? current
+                        : typeof current === "string" && current.trim() !== "" && Number.isFinite(Number(current))
+                            ? Number(current)
+                            : 0;
+                    return [4 /*yield*/, goalSeek({ evaluate: evaluate, targetValue: targetValue, initialValue: initialValue })];
+                case 1:
+                    result = _d.sent();
+                    onChange(sheetId, changingCell, String(result.value), undefined);
+                    return [2 /*return*/, result];
+            }
+        });
+    }); }, [canEditCellRange, getFormulaValue, getEffectiveValue, onRequestCalculate, getDependents, onChange]);
+};