@rowsncolumns/spreadsheet 10.5.14 → 10.5.15

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

@@ -143,7 +143,11 @@ export const useEditorSubmit = ({ sheetId, onChangeActiveSheet, setActiveCell, o
          * actually changed and a rule with an error alert rejects it.
          */
         if (value !== previousValue && getCommitValidation) {
-            const enforcement = getCommitValidation(editingSheetId, activeCell.rowIndex, activeCell.columnIndex, value, previousValue);
+            // Only a list (`ONE_OF_RANGE`) rule resolves asynchronously; every other
+            // decision stays synchronous so an ordinary commit still lands in the
+            // same tick as the keystroke.
+            const pending = getCommitValidation(editingSheetId, activeCell.rowIndex, activeCell.columnIndex, value, previousValue);
+            const enforcement = pending instanceof Promise ? await pending : pending;
             if (enforcement) {
                 const { decision, alert } = enforcement;
                 const request = {

package/dist/esm/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/esm/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/esm/hooks/use-get-values-from-range.js

@@ -1,13 +1,34 @@
 import { checkIfStringIsReference, iterateCells } from "@rowsncolumns/utils";
 import { useCallback } from "react";
 import { useCallbackRef } from "./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.
+ */
+const LEGACY_CALC_SOURCE = /(OFFSET|INDIRECT|FILTER|UNIQUE|SORT|SEQUENCE)\s*\(/i;
+/** Any function call — `OFFSET(`, `INDEX(`, `_xlfn.XLOOKUP(`, `CHOOSE(` — in a list source. */
+const 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.
+ */
+const conditionValuesFromTexts = (texts) => {
+    const userEnteredValues = new Map();
+    for (const userEnteredValue of texts) {
+        if (userEnteredValue) {
+            userEnteredValues.set(userEnteredValue, { userEnteredValue });
+        }
+    }
+    return [...userEnteredValues.values()];
+};
 /**
  * Get all user entered values from a range
  * used in data validation
  * @param param0
  * @returns
  */
-export const useGetValuesFromRange = ({ sheetId, getFormattedValue, getValidationValue, getSheetId, getSelectionsFromFormula, onRequestCalculate, getValidationSourceValue, }) => {
+export const useGetValuesFromRange = ({ sheetId, getFormattedValue, getValidationValue, getSheetId, getSelectionsFromFormula, onRequestCalculate, getValidationSourceValue, 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`.
@@ -40,64 +61,72 @@ export const useGetValuesFromRange = ({ sheetId, getFormattedValue, getValidatio
     const getEffectiveValuesFromRange = useCallbackRef(useCallback((address) => {
         return [...getValuesFromRange(address, getValidationValue).values()];
     }, [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".
+     */
     const getFormattedValuesFromRangeAsync = useCallbackRef(useCallback(async (address, rowIndex, columnIndex, targetSheetId = sheetId) => {
         const trimmedAddress = address?.trim() ?? "";
+        if (!trimmedAddress) {
+            return [];
+        }
         const isFormula = trimmedAddress.startsWith("=");
         const formulaBody = isFormula ? trimmedAddress.slice(1) : trimmedAddress;
         const hasDirectReference = checkIfStringIsReference(formulaBody);
-        const shouldCalc = isFormula &&
-            /(OFFSET|INDIRECT|FILTER|UNIQUE|SORT|SEQUENCE)\s*\(/i.test(formulaBody);
-        if (!onRequestCalculate || !shouldCalc) {
-            const selections = getSelectionsFromFormula(address);
-            if (hasDirectReference || selections.length) {
-                return [...getValuesFromRange(address, readSourceValue).values()];
-            }
-            return [];
+        const isFunctionCall = FUNCTION_CALL.test(formulaBody);
+        const selections = hasDirectReference
+            ? []
+            : getSelectionsFromFormula(address);
+        if (hasDirectReference || (selections.length && !isFunctionCall)) {
+            return [...getValuesFromRange(address, readSourceValue).values()];
         }
-        const result = await onRequestCalculate(trimmedAddress, targetSheetId, rowIndex, columnIndex, { isArray: true, disablePreview: true });
-        const userEnteredValues = new Map();
-        const pushValue = (value) => {
-            if (value === null || value === undefined) {
-                return;
+        if (resolveValidationSourceValues) {
+            const texts = await resolveValidationSourceValues(trimmedAddress, targetSheetId, rowIndex, columnIndex);
+            if (texts) {
+                return conditionValuesFromTexts(texts);
             }
-            if (Array.isArray(value)) {
-                for (const entry of value) {
-                    pushValue(entry);
+        }
+        if (onRequestCalculate && isFormula && LEGACY_CALC_SOURCE.test(formulaBody)) {
+            const result = await onRequestCalculate(trimmedAddress, targetSheetId, rowIndex, columnIndex, { isArray: true, disablePreview: true });
+            const userEnteredValues = new Map();
+            const pushValue = (value) => {
+                if (value === null || value === undefined) {
+                    return;
                 }
-                return;
-            }
-            const userEnteredValue = value instanceof Date
-                ? value.toISOString()
-                : typeof value === "boolean"
-                    ? value
-                        ? "TRUE"
-                        : "FALSE"
-                    : String(value);
-            userEnteredValues.set(userEnteredValue, { userEnteredValue });
-        };
-        if (Array.isArray(result)) {
-            if (Array.isArray(result[0])) {
-                for (const row of result) {
-                    for (const entry of row) {
+                if (Array.isArray(value)) {
+                    for (const entry of value) {
                         pushValue(entry);
                     }
+                    return;
                 }
-            }
-            else {
-                for (const entry of result) {
-                    pushValue(entry);
-                }
-            }
-        }
-        else {
+                const userEnteredValue = value instanceof Date
+                    ? value.toISOString()
+                    : typeof value === "boolean"
+                        ? value
+                            ? "TRUE"
+                            : "FALSE"
+                        : String(value);
+                userEnteredValues.set(userEnteredValue, { userEnteredValue });
+            };
             pushValue(result);
+            return [...userEnteredValues.values()];
+        }
+        if (selections.length) {
+            return [...getValuesFromRange(address, readSourceValue).values()];
         }
-        return [...userEnteredValues.values()];
+        return [];
     }, [
         readSourceValue,
         getSelectionsFromFormula,
         getValuesFromRange,
         onRequestCalculate,
+        resolveValidationSourceValues,
         sheetId,
     ]));
     return [

package/dist/esm/release-date.js

@@ -1,3 +1,3 @@
 export const releaseDate = 
 // @ts-ignore
-new Date("2026-10-28") ?? new Date("2025-06-18");
+new Date("2026-10-29") ?? new Date("2025-06-18");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rowsncolumns/spreadsheet",
-  "version": "10.5.14",
+  "version": "10.5.15",
   "author": "Vinay M",
   "license": "SEE LICENSE IN LICENSE.md",
   "main": "./dist/cjs/index.js",