@rowsncolumns/fast-formula-parser 6.2.35 → 6.2.36

package/index.d.ts

@@ -109,6 +109,17 @@ declare module "@rowsncolumns/fast-formula-parser" {
       row?: number;
       sheet?: string;
     }) => CellRange | FormulaError | undefined;
+    /**
+     * Resolve a 3-D reference span (`Sheet1:Sheet3!A1`): return every sheet
+     * name between `first` and `last` in tab order (inclusive, regardless of
+     * which endpoint is written first), or a `FormulaError` (`#REF!`) when an
+     * endpoint is not a sheet (`undefined` is treated as `#REF!`). Without the
+     * callback the prefix is looked up as a single sheet name (legacy reading).
+     */
+    onSheetRange?: (
+      first: string,
+      last: string,
+    ) => string[] | FormulaError | undefined;
     /**
      * Report row visibility so SUBTOTAL can exclude hidden rows.
      * Filtered-out rows are excluded for every function_number;
@@ -118,6 +129,16 @@ declare module "@rowsncolumns/fast-formula-parser" {
       sheet?: string;
       row: number;
     }) => { hiddenByFilter?: boolean; hiddenByUser?: boolean } | undefined;
+    /**
+     * Formula text stored in a cell, or undefined for non-formula cells.
+     * SUBTOTAL / AGGREGATE use it to skip nested SUBTOTAL / AGGREGATE
+     * results, as Excel does.
+     */
+    onCellFormula?: (ref: {
+      sheet?: string;
+      row: number;
+      col: number;
+    }) => string | undefined;
     webServiceProvider?: (
       url: string,
     ) =>
@@ -208,7 +229,10 @@ declare module "@rowsncolumns/fast-formula-parser" {
   }
 
   export interface DepParserConfig
-    extends Pick<FormulaParserConfig, "onVariable" | "onStructuredReference"> {}
+    extends Pick<
+      FormulaParserConfig,
+      "onVariable" | "onStructuredReference" | "onSheetRange"
+    > {}
   export class DepParser {
     constructor(config: DepParserConfig);
     parse: (text: string, position: CellCoords) => CellCoords[] | CellRange[];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rowsncolumns/fast-formula-parser",
-  "version": "6.2.35",
+  "version": "6.2.36",
   "description": "fast excel formula parser",
   "main": "./dist/cjs/index.js",
   "module": "./dist/esm/index.js",
@@ -44,7 +44,7 @@
   "author": "Lester(Dishu) Lyu",
   "license": "MIT",
   "dependencies": {
-    "@rowsncolumns/utils": ">=9.2.39",
+    "@rowsncolumns/utils": ">=9.2.40",
     "bahttext": "^2.3.0",
     "bessel": "^1.0.2",
     "chevrotain": "^10.5.0",
@@ -57,7 +57,7 @@
     "@babel/preset-typescript": "^7.29.7",
     "@rollup/plugin-commonjs": "^28.0.3",
     "@rollup/plugin-node-resolve": "^16.0.1",
-    "@rowsncolumns/common-types": ">=5.2.30",
+    "@rowsncolumns/common-types": ">=5.2.31",
     "rollup": "^4.41.1"
   }
 }