@rowsncolumns/spreadsheet 10.5.14 → 10.5.16

package/dist/cjs/hooks/use-editor-submit.js

@@ -101,10 +101,10 @@ var useEditorSubmit = function (_a) {
     var selectionsRef = (0, react_1.useRef)(selections);
     selectionsRef.current = selections;
     return (0, react_1.useCallback)(function (value, textFormatRuns, previousValue, editingSheetId, activeCell, nextActiveCell, isDirty, options) { return tslib_1.__awaiter(void 0, void 0, void 0, function () {
-        var resetEditorState, commit, enforcement, decision, alert_1, request, proceed, _a;
-        var _b, _c;
-        return tslib_1.__generator(this, function (_d) {
-            switch (_d.label) {
+        var resetEditorState, commit, pending_1, enforcement, _a, decision, alert_1, request, proceed, _b;
+        var _c, _d;
+        return tslib_1.__generator(this, function (_e) {
+            switch (_e.label) {
                 case 0:
                     /* Balance parentheses */
                     if (formulaMode && typeof value !== "boolean") {
@@ -178,14 +178,24 @@ var useEditorSubmit = function (_a) {
                         }
                         resetEditorState();
                     };
-                    if (!(value !== previousValue && getCommitValidation)) return [3 /*break*/, 4];
-                    enforcement = getCommitValidation(editingSheetId, activeCell.rowIndex, activeCell.columnIndex, value, previousValue);
-                    if (!enforcement) return [3 /*break*/, 4];
+                    if (!(value !== previousValue && getCommitValidation)) return [3 /*break*/, 7];
+                    pending_1 = getCommitValidation(editingSheetId, activeCell.rowIndex, activeCell.columnIndex, value, previousValue);
+                    if (!(pending_1 instanceof Promise)) return [3 /*break*/, 2];
+                    return [4 /*yield*/, pending_1];
+                case 1:
+                    _a = _e.sent();
+                    return [3 /*break*/, 3];
+                case 2:
+                    _a = pending_1;
+                    _e.label = 3;
+                case 3:
+                    enforcement = _a;
+                    if (!enforcement) return [3 /*break*/, 7];
                     decision = enforcement.decision, alert_1 = enforcement.alert;
                     request = {
                         style: alert_1.style,
-                        title: (_b = alert_1.message) === null || _b === void 0 ? void 0 : _b.title,
-                        message: (_c = alert_1.message) === null || _c === void 0 ? void 0 : _c.message,
+                        title: (_c = alert_1.message) === null || _c === void 0 ? void 0 : _c.title,
+                        message: (_d = alert_1.message) === null || _d === void 0 ? void 0 : _d.message,
                         confirm: decision === "confirm",
                     };
                     if (decision === "block") {
@@ -194,22 +204,22 @@ var useEditorSubmit = function (_a) {
                         void (showValidationAlert === null || showValidationAlert === void 0 ? void 0 : showValidationAlert(request));
                         return [2 /*return*/];
                     }
-                    if (!showValidationAlert) return [3 /*break*/, 2];
+                    if (!showValidationAlert) return [3 /*break*/, 5];
                     return [4 /*yield*/, showValidationAlert(request)];
-                case 1:
-                    _a = _d.sent();
-                    return [3 /*break*/, 3];
-                case 2:
-                    _a = true;
-                    _d.label = 3;
-                case 3:
-                    proceed = _a;
+                case 4:
+                    _b = _e.sent();
+                    return [3 /*break*/, 6];
+                case 5:
+                    _b = true;
+                    _e.label = 6;
+                case 6:
+                    proceed = _b;
                     if (!proceed) {
                         resetEditorState();
                         return [2 /*return*/];
                     }
-                    _d.label = 4;
-                case 4:
+                    _e.label = 7;
+                case 7:
                     commit();
                     return [2 /*return*/];
             }

package/dist/cjs/hooks/use-get-values-from-range.d.ts

@@ -32,6 +32,11 @@ type UseGetValuesFromRangeProps<T extends CellData> = {
      * `CanvasGridProps["getValidationSourceValue"]`. Defaults to `getFormattedValue`.
      */
     getValidationSourceValue?: CanvasGridProps["getValidationSourceValue"];
+    /**
+     * Optional engine-side resolver for the list sources the tokenizer cannot resolve — see
+     * `CanvasGridProps["resolveValidationSourceValues"]`.
+     */
+    resolveValidationSourceValues?: CanvasGridProps["resolveValidationSourceValues"];
 };
 /**
  * Get all user entered values from a range
@@ -39,6 +44,6 @@ type UseGetValuesFromRangeProps<T extends CellData> = {
  * @param param0
  * @returns
  */
-export declare const useGetValuesFromRange: <T extends CellData>({ sheetId, getFormattedValue, getValidationValue, getSheetId, getSelectionsFromFormula, onRequestCalculate, getValidationSourceValue, }: UseGetValuesFromRangeProps<T>) => readonly [(address: string) => ConditionValue[], (address: string) => ConditionValue[], (address: string, rowIndex: number, columnIndex: number, targetSheetId?: number) => Promise<ConditionValue[]>];
+export declare const useGetValuesFromRange: <T extends CellData>({ sheetId, getFormattedValue, getValidationValue, getSheetId, getSelectionsFromFormula, onRequestCalculate, getValidationSourceValue, resolveValidationSourceValues, }: UseGetValuesFromRangeProps<T>) => readonly [(address: string) => ConditionValue[], (address: string) => ConditionValue[], (address: string, rowIndex: number, columnIndex: number, targetSheetId?: number) => Promise<ConditionValue[]>];
 export {};
 //# sourceMappingURL=use-get-values-from-range.d.ts.map

package/dist/cjs/hooks/use-get-values-from-range.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-get-values-from-range.d.ts","sourceRoot":"","sources":["../../../hooks/use-get-values-from-range.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAIxD,OAAO,KAAK,EACV,eAAe,EACf,mBAAmB,EACpB,MAAM,mCAAmC,CAAC;AAC3C,OAAO,KAAK,EACV,QAAQ,EACR,qBAAqB,EACrB,cAAc,EACd,mBAAmB,EACpB,MAAM,UAAU,CAAC;AAGlB,KAAK,0BAA0B,CAAC,CAAC,SAAS,QAAQ,IAAI;IACpD,OAAO,EAAE,MAAM,CAAC;IAChB;;;;OAIG;IACH,iBAAiB,CACf,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,MAAM,GAClB,MAAM,GAAG,SAAS,CAAC;IACtB;;;;;;OAMG;IACH,kBAAkB,EAAE,CAClB,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,MAAM,EACnB,IAAI,CAAC,EAAE,qBAAqB,KACzB,mBAAmB,CAAC;IACzB;;;OAGG;IACH,wBAAwB,CACtB,OAAO,EAAE,MAAM,GACd,aAAa,CAAC,mBAAmB,CAAC,EAAE,CAAC;IACxC;;OAEG;IACH,UAAU,EAAE,eAAe,CAAC,YAAY,CAAC,CAAC;IAC1C,kBAAkB,CAAC,EAAE,eAAe,CAAC,oBAAoB,CAAC,CAAC;IAC3D;;;OAGG;IACH,wBAAwB,CAAC,EAAE,eAAe,CAAC,0BAA0B,CAAC,CAAC;CACxE,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB,GAAI,CAAC,SAAS,QAAQ,EAAE,yIAQvD,0BAA0B,CAAC,CAAC,CAAC,yBAqDhB,MAAM,KAAG,cAAc,EAAE,YASzB,MAAM,KAAG,cAAc,EAAE,YAUxB,MAAM,YACL,MAAM,eACH,MAAM,kBACJ,MAAM,KACpB,OAAO,CAAC,cAAc,EAAE,CAAC,CA4EjC,CAAC"}
+{"version":3,"file":"use-get-values-from-range.d.ts","sourceRoot":"","sources":["../../../hooks/use-get-values-from-range.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAIxD,OAAO,KAAK,EACV,eAAe,EACf,mBAAmB,EACpB,MAAM,mCAAmC,CAAC;AAC3C,OAAO,KAAK,EACV,QAAQ,EACR,qBAAqB,EACrB,cAAc,EACd,mBAAmB,EACpB,MAAM,UAAU,CAAC;AAGlB,KAAK,0BAA0B,CAAC,CAAC,SAAS,QAAQ,IAAI;IACpD,OAAO,EAAE,MAAM,CAAC;IAChB;;;;OAIG;IACH,iBAAiB,CACf,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,MAAM,GAClB,MAAM,GAAG,SAAS,CAAC;IACtB;;;;;;OAMG;IACH,kBAAkB,EAAE,CAClB,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,MAAM,EACnB,IAAI,CAAC,EAAE,qBAAqB,KACzB,mBAAmB,CAAC;IACzB;;;OAGG;IACH,wBAAwB,CACtB,OAAO,EAAE,MAAM,GACd,aAAa,CAAC,mBAAmB,CAAC,EAAE,CAAC;IACxC;;OAEG;IACH,UAAU,EAAE,eAAe,CAAC,YAAY,CAAC,CAAC;IAC1C,kBAAkB,CAAC,EAAE,eAAe,CAAC,oBAAoB,CAAC,CAAC;IAC3D;;;OAGG;IACH,wBAAwB,CAAC,EAAE,eAAe,CAAC,0BAA0B,CAAC,CAAC;IACvE;;;OAGG;IACH,6BAA6B,CAAC,EAAE,eAAe,CAAC,+BAA+B,CAAC,CAAC;CAClF,CAAC;AA0BF;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB,GAAI,CAAC,SAAS,QAAQ,EAAE,wKASvD,0BAA0B,CAAC,CAAC,CAAC,yBAqDhB,MAAM,KAAG,cAAc,EAAE,YASzB,MAAM,KAAG,cAAc,EAAE,YAoBxB,MAAM,YACL,MAAM,eACH,MAAM,kBACJ,MAAM,KACpB,OAAO,CAAC,cAAc,EAAE,CAAC,CAkFjC,CAAC"}

package/dist/cjs/hooks/use-get-values-from-range.js

@@ -5,6 +5,38 @@ var tslib_1 = require("tslib");
 var utils_1 = require("@rowsncolumns/utils");
 var react_1 = require("react");
 var use_callback_ref_1 = require("./use-callback-ref");
+/**
+ * The reference / array functions the LEGACY calculator previews as an array through
+ * `onRequestCalculate(…, { isArray: true })` — the only sources it can resolve beyond plain
+ * ranges. The engine resolver (`resolveValidationSourceValues`) takes any function call.
+ */
+var LEGACY_CALC_SOURCE = /(OFFSET|INDIRECT|FILTER|UNIQUE|SORT|SEQUENCE)\s*\(/i;
+/** Any function call — `OFFSET(`, `INDEX(`, `_xlfn.XLOOKUP(`, `CHOOSE(` — in a list source. */
+var FUNCTION_CALL = /[A-Z_\\][A-Z0-9_.]*\s*\(/i;
+/**
+ * Dropdown options from a resolver's display texts: blanks dropped, duplicates collapsed,
+ * first-seen order kept — the same shape `getValuesFromRange` builds from cells.
+ */
+var conditionValuesFromTexts = function (texts) {
+    var e_1, _a;
+    var userEnteredValues = new Map();
+    try {
+        for (var texts_1 = tslib_1.__values(texts), texts_1_1 = texts_1.next(); !texts_1_1.done; texts_1_1 = texts_1.next()) {
+            var userEnteredValue = texts_1_1.value;
+            if (userEnteredValue) {
+                userEnteredValues.set(userEnteredValue, { userEnteredValue: userEnteredValue });
+            }
+        }
+    }
+    catch (e_1_1) { e_1 = { error: e_1_1 }; }
+    finally {
+        try {
+            if (texts_1_1 && !texts_1_1.done && (_a = texts_1.return)) _a.call(texts_1);
+        }
+        finally { if (e_1) throw e_1.error; }
+    }
+    return tslib_1.__spreadArray([], tslib_1.__read(userEnteredValues.values()), false);
+};
 /**
  * Get all user entered values from a range
  * used in data validation
@@ -12,13 +44,13 @@ var use_callback_ref_1 = require("./use-callback-ref");
  * @returns
  */
 var useGetValuesFromRange = function (_a) {
-    var sheetId = _a.sheetId, getFormattedValue = _a.getFormattedValue, getValidationValue = _a.getValidationValue, getSheetId = _a.getSheetId, getSelectionsFromFormula = _a.getSelectionsFromFormula, onRequestCalculate = _a.onRequestCalculate, getValidationSourceValue = _a.getValidationSourceValue;
+    var sheetId = _a.sheetId, getFormattedValue = _a.getFormattedValue, getValidationValue = _a.getValidationValue, getSheetId = _a.getSheetId, getSelectionsFromFormula = _a.getSelectionsFromFormula, onRequestCalculate = _a.onRequestCalculate, getValidationSourceValue = _a.getValidationSourceValue, resolveValidationSourceValues = _a.resolveValidationSourceValues;
     // Windowed hosts supply an off-window-safe reader for validation source ranges
     // (dropdown options + commit checks) — the plain `getFormattedValue` only sees the
     // loaded viewport there. Defaults to `getFormattedValue`.
     var readSourceValue = getValidationSourceValue !== null && getValidationSourceValue !== void 0 ? getValidationSourceValue : getFormattedValue;
     var getValuesFromRange = (0, react_1.useCallback)(function (address, callback) {
-        var e_1, _a, e_2, _b;
+        var e_2, _a, e_3, _b;
         var _c;
         var selections = getSelectionsFromFormula(address);
         var userEnteredValues = new Map();
@@ -30,7 +62,7 @@ var useGetValuesFromRange = function (_a) {
                     ? (_c = getSheetId === null || getSheetId === void 0 ? void 0 : getSheetId(sheetName)) !== null && _c !== void 0 ? _c : sheetId
                     : sheetId;
                 try {
-                    for (var _e = (e_2 = void 0, tslib_1.__values((0, utils_1.iterateCells)(startRowIndex, endColumnIndex, endRowIndex, startColumnIndex))), _f = _e.next(); !_f.done; _f = _e.next()) {
+                    for (var _e = (e_3 = void 0, tslib_1.__values((0, utils_1.iterateCells)(startRowIndex, endColumnIndex, endRowIndex, startColumnIndex))), _f = _e.next(); !_f.done; _f = _e.next()) {
                         var _g = tslib_1.__read(_f.value, 2), rowIndex = _g[0], columnIndex = _g[1];
                         var userEnteredValue = callback(selectedSheetId, rowIndex, columnIndex);
                         if (userEnteredValue) {
@@ -40,21 +72,21 @@ var useGetValuesFromRange = function (_a) {
                         }
                     }
                 }
-                catch (e_2_1) { e_2 = { error: e_2_1 }; }
+                catch (e_3_1) { e_3 = { error: e_3_1 }; }
                 finally {
                     try {
                         if (_f && !_f.done && (_b = _e.return)) _b.call(_e);
                     }
-                    finally { if (e_2) throw e_2.error; }
+                    finally { if (e_3) throw e_3.error; }
                 }
             }
         }
-        catch (e_1_1) { e_1 = { error: e_1_1 }; }
+        catch (e_2_1) { e_2 = { error: e_2_1 }; }
         finally {
             try {
                 if (selections_1_1 && !selections_1_1.done && (_a = selections_1.return)) _a.call(selections_1);
             }
-            finally { if (e_1) throw e_1.error; }
+            finally { if (e_2) throw e_2.error; }
         }
         return userEnteredValues;
     }, [getSelectionsFromFormula, getSheetId, sheetId]);
@@ -67,38 +99,58 @@ var useGetValuesFromRange = function (_a) {
     var getEffectiveValuesFromRange = (0, use_callback_ref_1.useCallbackRef)((0, react_1.useCallback)(function (address) {
         return tslib_1.__spreadArray([], tslib_1.__read(getValuesFromRange(address, getValidationValue).values()), false);
     }, [getValidationValue, getValuesFromRange]));
+    /**
+     * The options a list (`ONE_OF_RANGE`) source denotes at a cell — the dropdown's items and
+     * the commit gate's accept list. A plain or sheet-qualified range, a range-type name and a
+     * structured reference resolve locally from the tokenizer's selections (off-window-safe
+     * through `readSourceValue`). Anything else — a formula-valued name (`=RegionList` defined
+     * as `=Table1[Region]` / `=OFFSET(…,COUNTA(…),1)`), any function call, a source the
+     * tokenizer found nothing in — goes through the engine resolver when the host supplies
+     * one; the legacy calculator previews its reference/array functions as an array; the
+     * tokenizer's selections are the last resort. An empty list means "nothing resolvable".
+     */
     var getFormattedValuesFromRangeAsync = (0, use_callback_ref_1.useCallbackRef)((0, react_1.useCallback)(function (address_1, rowIndex_1, columnIndex_1) {
         var args_1 = [];
         for (var _i = 3; _i < arguments.length; _i++) {
             args_1[_i - 3] = arguments[_i];
         }
         return tslib_1.__awaiter(void 0, tslib_1.__spreadArray([address_1, rowIndex_1, columnIndex_1], tslib_1.__read(args_1), false), void 0, function (address, rowIndex, columnIndex, targetSheetId) {
-            var trimmedAddress, isFormula, formulaBody, hasDirectReference, shouldCalc, selections, result, userEnteredValues, pushValue, result_1, result_1_1, row, row_1, row_1_1, entry, result_2, result_2_1, entry;
-            var e_3, _a, e_4, _b, e_5, _c;
-            var _d;
+            var trimmedAddress, isFormula, formulaBody, hasDirectReference, isFunctionCall, selections, texts, result, userEnteredValues_1, pushValue_1;
+            var _a;
             if (targetSheetId === void 0) { targetSheetId = sheetId; }
-            return tslib_1.__generator(this, function (_e) {
-                switch (_e.label) {
+            return tslib_1.__generator(this, function (_b) {
+                switch (_b.label) {
                     case 0:
-                        trimmedAddress = (_d = address === null || address === void 0 ? void 0 : address.trim()) !== null && _d !== void 0 ? _d : "";
+                        trimmedAddress = (_a = address === null || address === void 0 ? void 0 : address.trim()) !== null && _a !== void 0 ? _a : "";
+                        if (!trimmedAddress) {
+                            return [2 /*return*/, []];
+                        }
                         isFormula = trimmedAddress.startsWith("=");
                         formulaBody = isFormula ? trimmedAddress.slice(1) : trimmedAddress;
                         hasDirectReference = (0, utils_1.checkIfStringIsReference)(formulaBody);
-                        shouldCalc = isFormula &&
-                            /(OFFSET|INDIRECT|FILTER|UNIQUE|SORT|SEQUENCE)\s*\(/i.test(formulaBody);
-                        if (!onRequestCalculate || !shouldCalc) {
-                            selections = getSelectionsFromFormula(address);
-                            if (hasDirectReference || selections.length) {
-                                return [2 /*return*/, tslib_1.__spreadArray([], tslib_1.__read(getValuesFromRange(address, readSourceValue).values()), false)];
-                            }
-                            return [2 /*return*/, []];
+                        isFunctionCall = FUNCTION_CALL.test(formulaBody);
+                        selections = hasDirectReference
+                            ? []
+                            : getSelectionsFromFormula(address);
+                        if (hasDirectReference || (selections.length && !isFunctionCall)) {
+                            return [2 /*return*/, tslib_1.__spreadArray([], tslib_1.__read(getValuesFromRange(address, readSourceValue).values()), false)];
                         }
-                        return [4 /*yield*/, onRequestCalculate(trimmedAddress, targetSheetId, rowIndex, columnIndex, { isArray: true, disablePreview: true })];
+                        if (!resolveValidationSourceValues) return [3 /*break*/, 2];
+                        return [4 /*yield*/, resolveValidationSourceValues(trimmedAddress, targetSheetId, rowIndex, columnIndex)];
                     case 1:
-                        result = _e.sent();
-                        userEnteredValues = new Map();
-                        pushValue = function (value) {
-                            var e_6, _a;
+                        texts = _b.sent();
+                        if (texts) {
+                            return [2 /*return*/, conditionValuesFromTexts(texts)];
+                        }
+                        _b.label = 2;
+                    case 2:
+                        if (!(onRequestCalculate && isFormula && LEGACY_CALC_SOURCE.test(formulaBody))) return [3 /*break*/, 4];
+                        return [4 /*yield*/, onRequestCalculate(trimmedAddress, targetSheetId, rowIndex, columnIndex, { isArray: true, disablePreview: true })];
+                    case 3:
+                        result = _b.sent();
+                        userEnteredValues_1 = new Map();
+                        pushValue_1 = function (value) {
+                            var e_4, _a;
                             if (value === null || value === undefined) {
                                 return;
                             }
@@ -106,15 +158,15 @@ var useGetValuesFromRange = function (_a) {
                                 try {
                                     for (var value_1 = tslib_1.__values(value), value_1_1 = value_1.next(); !value_1_1.done; value_1_1 = value_1.next()) {
                                         var entry = value_1_1.value;
-                                        pushValue(entry);
+                                        pushValue_1(entry);
                                     }
                                 }
-                                catch (e_6_1) { e_6 = { error: e_6_1 }; }
+                                catch (e_4_1) { e_4 = { error: e_4_1 }; }
                                 finally {
                                     try {
                                         if (value_1_1 && !value_1_1.done && (_a = value_1.return)) _a.call(value_1);
                                     }
-                                    finally { if (e_6) throw e_6.error; }
+                                    finally { if (e_4) throw e_4.error; }
                                 }
                                 return;
                             }
@@ -125,56 +177,15 @@ var useGetValuesFromRange = function (_a) {
                                         ? "TRUE"
                                         : "FALSE"
                                     : String(value);
-                            userEnteredValues.set(userEnteredValue, { userEnteredValue: userEnteredValue });
+                            userEnteredValues_1.set(userEnteredValue, { userEnteredValue: userEnteredValue });
                         };
-                        if (Array.isArray(result)) {
-                            if (Array.isArray(result[0])) {
-                                try {
-                                    for (result_1 = tslib_1.__values(result), result_1_1 = result_1.next(); !result_1_1.done; result_1_1 = result_1.next()) {
-                                        row = result_1_1.value;
-                                        try {
-                                            for (row_1 = (e_4 = void 0, tslib_1.__values(row)), row_1_1 = row_1.next(); !row_1_1.done; row_1_1 = row_1.next()) {
-                                                entry = row_1_1.value;
-                                                pushValue(entry);
-                                            }
-                                        }
-                                        catch (e_4_1) { e_4 = { error: e_4_1 }; }
-                                        finally {
-                                            try {
-                                                if (row_1_1 && !row_1_1.done && (_b = row_1.return)) _b.call(row_1);
-                                            }
-                                            finally { if (e_4) throw e_4.error; }
-                                        }
-                                    }
-                                }
-                                catch (e_3_1) { e_3 = { error: e_3_1 }; }
-                                finally {
-                                    try {
-                                        if (result_1_1 && !result_1_1.done && (_a = result_1.return)) _a.call(result_1);
-                                    }
-                                    finally { if (e_3) throw e_3.error; }
-                                }
-                            }
-                            else {
-                                try {
-                                    for (result_2 = tslib_1.__values(result), result_2_1 = result_2.next(); !result_2_1.done; result_2_1 = result_2.next()) {
-                                        entry = result_2_1.value;
-                                        pushValue(entry);
-                                    }
-                                }
-                                catch (e_5_1) { e_5 = { error: e_5_1 }; }
-                                finally {
-                                    try {
-                                        if (result_2_1 && !result_2_1.done && (_c = result_2.return)) _c.call(result_2);
-                                    }
-                                    finally { if (e_5) throw e_5.error; }
-                                }
-                            }
-                        }
-                        else {
-                            pushValue(result);
+                        pushValue_1(result);
+                        return [2 /*return*/, tslib_1.__spreadArray([], tslib_1.__read(userEnteredValues_1.values()), false)];
+                    case 4:
+                        if (selections.length) {
+                            return [2 /*return*/, tslib_1.__spreadArray([], tslib_1.__read(getValuesFromRange(address, readSourceValue).values()), false)];
                         }
-                        return [2 /*return*/, tslib_1.__spreadArray([], tslib_1.__read(userEnteredValues.values()), false)];
+                        return [2 /*return*/, []];
                 }
             });
         });
@@ -183,6 +194,7 @@ var useGetValuesFromRange = function (_a) {
         getSelectionsFromFormula,
         getValuesFromRange,
         onRequestCalculate,
+        resolveValidationSourceValues,
         sheetId,
     ]));
     return [

package/dist/cjs/release-date.js

@@ -4,4 +4,4 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.releaseDate = void 0;
 exports.releaseDate = 
 // @ts-ignore
-(_a = new Date("2026-10-28")) !== null && _a !== void 0 ? _a : new Date("2025-06-18");
+(_a = new Date("2026-10-29")) !== null && _a !== void 0 ? _a : new Date("2025-06-18");

package/dist/esm/api/validation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../../api/validation.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../../api/validation.ts"],"names":[],"mappings":"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"}

package/dist/esm/api/validation.js

@@ -1,7 +1,7 @@
 import { isCellWithinBounds } from "@rowsncolumns/grid";
-import { escapeCharacters, isNil, matchesWildcardPattern, toDate, toSerial, } from "@rowsncolumns/utils";
+import { escapeCharacters, getDataValidationListReference, isNil, matchesWildcardPattern, toDate, toSerial, } from "@rowsncolumns/utils";
 import { EMAIL_REGEX, URL_REGEX } from "../config";
-import { checkIfStringIsReference, splitDataValidationListValues, } from "../helpers";
+import { splitDataValidationListValues } from "../helpers";
 /**
  * Parse a number value with locale awareness
  * Handles common decimal separators like comma (e.g., "6,5" in German)
@@ -265,9 +265,14 @@ export const checkBooleanRule = (rule, value, previousValue, getRangeValues, opt
                 return true;
             }
             const firstValue = valuesArray[0].userEnteredValue;
-            const isAddress = type === "ONE_OF_RANGE" ? true : checkIfStringIsReference(firstValue);
-            const finalValues = isAddress
-                ? getRangeValues?.(firstValue)
+            // A ONE_OF_LIST whose value is a source formula (`=RegionList`) or an A1
+            // reference reads its options from that source, like ONE_OF_RANGE.
+            const listReference = getDataValidationListReference({
+                type,
+                values: valuesArray,
+            });
+            const finalValues = listReference !== undefined
+                ? getRangeValues?.(listReference)
                 : splitDataValidationListValues(firstValue);
             // A cell storing the lone text-prefix apostrophe (`'`) is Excel's
             // "empty text" — it satisfies the list exactly like a blank cell does,

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../components/canvas-grid/index.tsx"],"names":[],"mappings":"AAoDA,OAAO,KASN,MAAM,OAAO,CAAC;AAqNf,OAAO,KAAK,EAGV,QAAQ,EAWT,MAAM,aAAa,CAAC;AAoBrB,OAAO,KAAK,EACV,wBAAwB,EACxB,iBAAiB,EACjB,eAAe,EAEhB,MAAM,WAAW,CAAC;AAy/LnB,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":"AAqDA,OAAO,KASN,MAAM,OAAO,CAAC;AAyNf,OAAO,KAAK,EAGV,QAAQ,EAWT,MAAM,aAAa,CAAC;AAoBrB,OAAO,KAAK,EACV,wBAAwB,EACxB,iBAAiB,EACjB,eAAe,EAEhB,MAAM,WAAW,CAAC;AAgjMnB,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"}

package/dist/esm/components/canvas-grid/index.js

@@ -5,7 +5,7 @@ import { getBoundedCells, MouseButtonCodes } from "@rowsncolumns/grid";
 import { isCellWithinBounds } from "@rowsncolumns/grid";
 import { cellIdentifier, Grid as BaseGrid, isEqualCells, } from "@rowsncolumns/grid";
 import { cn, DropdownMenuContent, DropdownMenuPortal, Skeleton, tryParseRichText, } from "@rowsncolumns/ui";
-import { cellToAddress, getCellEffectiveFormat, getContrastColor, getFormulaLocale, isConditionalFormatFormulaRule, isDataValidationFormulaRule, isNil, isNilOrBlank, iterateCellsInRange, localizeCellInput, localizeFormula, localizeFunctionDescriptions, log, resolveDefaultHorizontalAlignment, ssfFormatColor, uuid, } from "@rowsncolumns/utils";
+import { cellToAddress, getCellEffectiveFormat, getContrastColor, getFormulaLocale, getEffectiveDataValidationConditionType, isConditionalFormatFormulaRule, isDataValidationFormulaRule, isNil, isNilOrBlank, iterateCellsInRange, localizeCellInput, localizeFormula, localizeFunctionDescriptions, log, resolveDefaultHorizontalAlignment, ssfFormatColor, uuid, } from "@rowsncolumns/utils";
 import { useStore } from "jotai";
 import merge from "lodash/merge";
 import throttle from "lodash/throttle";
@@ -33,7 +33,7 @@ import { useQuickEditState } from "../../atoms/magic-fill-state.atom";
 import { useOnHideFormulaHelp, useOnShowFormulaHelp, useShowFormulaHelpValue, } from "../../atoms/show-formula-help.atom";
 import { useSetSpreadsheetApi } from "../../atoms/spreadsheet-api.atom";
 import { ARROW_DOWN_WIDTH, CALCULATED_ICON_WIDTH, CELL_HORIZONTAL_ALIGNMENT, CF_ICON_SPACING, CF_ICON_WIDTH, CHIP_COLOR, CHIP_SPACING, COLUMN_HEADER_HEIGHT, DEFAULT_ACTIVE_CELL, DEFAULT_ARRAY, DEFAULT_CELL_BACKGROUND_COLOR, DEFAULT_CELL_COLOR, DEFAULT_CELL_SPACING, DEFAULT_COLUMN_COUNT, DEFAULT_COLUMN_WIDTH, DEFAULT_FONT_SIZE_PT, DEFAULT_HEADER_ACTIVE_BG, DEFAULT_HEADER_ACTIVE_TABLE_BG, DEFAULT_HEADER_BG, DEFAULT_HEADER_BORDER_COLOR, DEFAULT_HEADER_COLOR, DEFAULT_HEADER_SELECTED_BG, DEFAULT_HEADER_SELECTED_TABLE_BG, DEFAULT_HEADER_TABLE_BG, DEFAULT_ROW_COUNT, DEFAULT_ROW_HEIGHT, DEFAULT_SCROLL_POSITION, defaultSpreadsheetTheme, EXPAND_COLLAPSE_ICON_WIDTH, FILTER_ICON_WIDTH, GRIDLINE_COLOR, HEADER_TEXT_FORMAT, INDENT_SPACING, MAX_COLUMN_COUNT, MAX_ROW_COUNT, MIN_COLUMN_WIDTH, ROW_HEADER_WIDTH, SCROLLBAR_SIZE, SELECTION_BG, SELECTION_BORDER, } from "../../config";
-import { definedProps, getCellEffectiveValue, getCellFormattedValue, getCellUserEnteredValue, getDefaultColumnHeader, getDefaultRowHeader, getExtendedValueBool, getExtendedValueError, getExtendedValueFormula, getExtendedValueNumber, getExtendedValueString, getTableHeaderCells, isFirefox, isStyleReference, isTouchDevice, } from "../../helpers";
+import { definedProps, getCellEffectiveValue, getCellFormattedValue, getCellUserEnteredValue, getDefaultColumnHeader, getDefaultRowHeader, getExtendedValueBool, getExtendedValueError, getExtendedValueFormula, getExtendedValueNumber, getExtendedValueString, getTableHeaderCells, isFirefox, isStyleReference, isTouchDevice, toEditorRangeValuesAsync, } from "../../helpers";
 import { useBorderStyles } from "../../hooks/use-border-styles";
 import { useCallbackRef } from "../../hooks/use-callback-ref";
 import { useCellPopover } from "../../hooks/use-cell-popover";
@@ -51,7 +51,7 @@ import { useEditable } from "../../hooks/use-editable";
 import { useEditorCancel } from "../../hooks/use-editor-cancel";
 import { useEditorChange } from "../../hooks/use-editor-change";
 import { useEditorKeydown } from "../../hooks/use-editor-keydown";
-import { useEditorSubmit } from "../../hooks/use-editor-submit";
+import { useEditorSubmit, } from "../../hooks/use-editor-submit";
 import { useEmbedsCharts } from "../../hooks/use-embeds-charts";
 import { ChartSheetView } from "../chart-sheet-view";
 import { useExpandCell } from "../../hooks/use-expand-cell";
@@ -138,6 +138,9 @@ function CanvasGridComponent(props, forwardedRef) {
     // options + commit-time checks). Windowed hosts supply an off-window-safe reader;
     // defaults to `getFormattedValue` inside `useGetValuesFromRange`.
     getValidationSourceValue, 
+    // Optional engine-side resolver for the list sources the tokenizer cannot resolve
+    // (formula-valued names, structured references, OFFSET/INDIRECT/FILTER/UNIQUE).
+    resolveValidationSourceValues, 
     // Unused props only for api
     getDataColumnCount, onDeleteNamedRange, onChangeBorder, onDuplicateSheet, onCreateConditionalFormattingRule, onDeleteConditionalFormattingRule, onUpdateConditionalFormattingRule, onCreateDataValidationRule, onUpdateDataValidationRule, onDeleteDataValidationRule, onCreateChart, onDeleteSheet, onCreateEmbed, onDecreaseIndent, onIncreaseIndent, onChangeTheme, onChangeDecimals, onUpdateSheet, onChangeBatchStream, onBlur, ...rest } = props;
     // Enter on a cell opens the editor in Google Sheets and moves down in
@@ -1411,7 +1414,12 @@ function CanvasGridComponent(props, forwardedRef) {
         getSheetId,
         onRequestCalculate,
         getValidationSourceValue,
+        resolveValidationSourceValues,
     });
+    /**
+     * The cell editor's dropdown options: same resolver, editor argument order.
+     */
+    const getEditorRangeValuesAsync = useMemo(() => toEditorRangeValuesAsync(getFormattedValuesFromAddressAsync), [getFormattedValuesFromAddressAsync]);
     /**
      * Get all formatted values from range as a single 1d array
      */
@@ -1432,7 +1440,8 @@ function CanvasGridComponent(props, forwardedRef) {
      * Returns the alert + decision when the value is invalid and the rule has an
      * error alert; otherwise `undefined` (no enforcement — the cell still gets the
      * flag-only red marker via `SheetCell.validate`). Formula-backed rules resolve
-     * asynchronously through the calculator, so they fall back to flag-only here.
+     * asynchronously through the calculator, so they fall back to flag-only here;
+     * a list (`ONE_OF_RANGE`) rule resolves its source asynchronously and decides.
      */
     const getCommitValidation = useCallback((validationSheetId, rowIndex, columnIndex, value, previousValue) => {
         const rule = getDataValidationRule(validationSheetId, rowIndex, columnIndex);
@@ -1463,6 +1472,29 @@ function CanvasGridComponent(props, forwardedRef) {
                 ? undefined
                 : { decision: excelDecision, alert };
         }
+        // A list source resolves through the same path as the dropdown
+        // (`getFormattedValuesFromAddressAsync`): a plain range locally, a
+        // formula-valued name / structured reference / OFFSET source through the
+        // engine resolver. A source the UI cannot resolve yields NO list — fail
+        // OPEN rather than block valid input behind a Stop alert: the engine's
+        // compiled `COUNTIF(source, cell)>0` rule still paints the red marker.
+        // A ONE_OF_LIST whose value is a source formula (`=RegionList`, Excel's
+        // List source typed into "Dropdown") is the same list.
+        if (getEffectiveDataValidationConditionType(rule.condition) ===
+            "ONE_OF_RANGE") {
+            const source = rule.condition?.values?.[0]?.userEnteredValue;
+            if (typeof source !== "string" || !source.trim()) {
+                return undefined;
+            }
+            return getFormattedValuesFromAddressAsync(source, rowIndex, columnIndex, validationSheetId).then((listValues) => {
+                if (!listValues.length) {
+                    return undefined;
+                }
+                const isValid = checkBooleanRule(rule, value, previousValue ?? undefined, () => listValues, { locale });
+                const decision = decideValidationCommit(alert, Boolean(isValid));
+                return decision === "proceed" ? undefined : { decision, alert };
+            });
+        }
         if (isDataValidationFormulaRule(rule)) {
             // Enforce synchronously only where `checkBooleanRule` can decide the typed
             // value without the calculator: CUSTOM_FORMULA's sync branch is a stub, the
@@ -1477,7 +1509,7 @@ function CanvasGridComponent(props, forwardedRef) {
                 entry.userEnteredValue.trim().startsWith("="));
             const syncEnforceable = conditionType !== "CUSTOM_FORMULA" &&
                 !conditionType?.startsWith("DATE_") &&
-                (conditionType === "ONE_OF_RANGE" || !hasFormulaBound);
+                !hasFormulaBound;
             if (!syncEnforceable) {
                 return undefined;
             }
@@ -1488,7 +1520,12 @@ function CanvasGridComponent(props, forwardedRef) {
             return undefined;
         }
         return { decision, alert };
-    }, [getDataValidationRule, getFormattedValuesFromAddress, locale]);
+    }, [
+        getDataValidationRule,
+        getFormattedValuesFromAddress,
+        getFormattedValuesFromAddressAsync,
+        locale,
+    ]);
     /**
      * Opens the blocking data-validation alert dialog (Excel error alert).
      */
@@ -1955,12 +1992,13 @@ function CanvasGridComponent(props, forwardedRef) {
         const editingSheetName = getSheetName?.(editingSheetId);
         const effectiveValue = getEffectiveValue(editingSheetId, rowIndex, columnIndex);
         const horizontalAlignment = getEditorHorizontalAlignment(editingSheetId, rowIndex, columnIndex);
-        return (React.createElement(CellEditor, { ...props, locale: locale, effectiveValue: effectiveValue, format: cellFormat, dataValidation: dataValidation, getRangeValues: getFormattedValuesFromAddress, getRangeValuesAsync: getFormattedValuesFromAddressAsync, scale: scale, sheetName: sheetName, editingSheetId: editingSheetId, sheetId: sheetId, editingSheetName: editingSheetName, address: address, theme: theme, tokenizer: localeTokenizer, formulaLocale: formulaLocale, horizontalAlignment: horizontalAlignment, defaultBackgroundColor: cellBackgroundColor, defaultTextColor: getStringifiedColor(cellColor, theme), functionDescriptions: localizedFunctionDescriptions, getNamedRanges: getNamedRanges, getTableNames: getTableNames, getStructuredProperties: getStructuredProperties, getTableColumnNames: getTableColumnNames, showFormulaHelp: showFormulaHelp, onHideFormulaHelp: onHideFormulaHelp, onShowFormulaHelp: onShowFormulaHelp, onRequestCalculate: onRequestCalculate, SuggestionsDropdown: SuggestionsDropdown, stickyEditor: stickyEditor, defaultFontSizePoint: defaultFontSize, getMentions: getMentions, getFunctionParameterSuggestions: getFunctionParameterSuggestions, shouldFetchFunctionParameters: shouldFetchFunctionParameters, MentionTagComponent: MentionTagComponent, MentionDropdownItemComponent: MentionDropdownItemComponent }));
+        return (React.createElement(CellEditor, { ...props, locale: locale, effectiveValue: effectiveValue, format: cellFormat, dataValidation: dataValidation, getRangeValues: getFormattedValuesFromAddress, getRangeValuesAsync: getEditorRangeValuesAsync, scale: scale, sheetName: sheetName, editingSheetId: editingSheetId, sheetId: sheetId, editingSheetName: editingSheetName, address: address, theme: theme, tokenizer: localeTokenizer, formulaLocale: formulaLocale, horizontalAlignment: horizontalAlignment, defaultBackgroundColor: cellBackgroundColor, defaultTextColor: getStringifiedColor(cellColor, theme), functionDescriptions: localizedFunctionDescriptions, getNamedRanges: getNamedRanges, getTableNames: getTableNames, getStructuredProperties: getStructuredProperties, getTableColumnNames: getTableColumnNames, showFormulaHelp: showFormulaHelp, onHideFormulaHelp: onHideFormulaHelp, onShowFormulaHelp: onShowFormulaHelp, onRequestCalculate: onRequestCalculate, SuggestionsDropdown: SuggestionsDropdown, stickyEditor: stickyEditor, defaultFontSizePoint: defaultFontSize, getMentions: getMentions, getFunctionParameterSuggestions: getFunctionParameterSuggestions, shouldFetchFunctionParameters: shouldFetchFunctionParameters, MentionTagComponent: MentionTagComponent, MentionDropdownItemComponent: MentionDropdownItemComponent }));
     }, [
         scale,
         getEffectiveCellFormat,
         getDataValidationRule,
         getFormattedValuesFromAddress,
+        getEditorRangeValuesAsync,
         CellEditor,
         getSheetName,
         showFormulaHelp,

package/dist/esm/components/canvas-grid/typings.d.ts

@@ -1808,6 +1808,17 @@ export type CanvasGridProps<T extends CellData = CellData<any, any>> = {
      * off-window-safe reader here; defaults to `getFormattedValue`.
      */
     getValidationSourceValue?(sheetId: number, rowIndex: number, columnIndex: number): Maybe<string>;
+    /**
+     * Optional engine-side resolver for a data-validation LIST source (`ONE_OF_RANGE`) the
+     * grid cannot resolve from its own tokenizer: a formula-valued defined name
+     * (`=RegionList` defined as `=Table1[Region]` or `=OFFSET(…,COUNTA(…),1)`), a
+     * structured reference, `INDIRECT` / `FILTER` / `UNIQUE`. Called with the rule's source
+     * text and the validated cell (for relative references and `[@Col]`); returns the display
+     * texts of the source's cells (row-major) or `undefined` when it cannot be resolved — the
+     * dropdown then lists nothing and the commit gate fails OPEN (the engine's own validity
+     * rule keeps the red marker). Plain ranges and range-type names never reach it.
+     */
+    resolveValidationSourceValues?(source: string, sheetId: number, rowIndex: number, columnIndex: number): Maybe<string[]> | Promise<Maybe<string[]>>;
     /**
      * Callback to get custom tooltip content for a cell
      * @param sheetId