@rowsncolumns/fast-formula-parser 6.2.35 → 6.2.37

package/index.d.ts

@@ -4,6 +4,12 @@ declare module "@rowsncolumns/fast-formula-parser" {
 
   /** Set of all implemented function names for O(1) lookup */
   export const implementedFunctionNames: Set<string>;
+  /**
+   * Is `formula` a SUBTOTAL / AGGREGATE call (the cells SUBTOTAL and
+   * AGGREGATE skip inside their ranges)? Hosts use it to decide which cell
+   * formulas to hand to `onCellFormula`.
+   */
+  export function isNestedAggregateFormula(formula: unknown): boolean;
   export type CellCoords = {
     sheet?: string;
     row: number;
@@ -109,6 +115,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 +135,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,
     ) =>
@@ -156,6 +183,12 @@ declare module "@rowsncolumns/fast-formula-parser" {
   export default class FormulaParser<T extends unknown = any> {
     constructor(config: FormulaParserConfig);
     locale?: string;
+    /**
+     * When true, `checkFormulaResult` hands back an un-invoked LAMBDA value
+     * instead of Excel's #CALC! — used while evaluating a defined name's
+     * formula so `=name(args)` can apply it later.
+     */
+    keepLambdaResult: boolean;
     parseAsync: (
       text: string,
       position: CellCoords,
@@ -208,7 +241,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.37",
   "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.41",
     "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.32",
     "rollup": "^4.41.1"
   }
 }