@sheetxl/formulas 0.7.28-beta.4 → 0.8.0-beta.1

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@sheetxl/formulas",
   "description": "Formulas - TypeScript formulas compatible with Excel built-ins.",
-  "version": "0.7.28-beta.4",
+  "version": "0.8.0-beta.1",
   "license": "SEE LICENSE IN <LICENSE>",
   "type": "module",
   "exports": {
@@ -37,8 +37,8 @@
     "formulas"
   ],
   "dependencies": {
-    "@sheetxl/primitives": "^0.7.28-beta.4",
-    "@sheetxl/scripting": "^0.7.28-beta.4",
+    "@sheetxl/primitives": "^0.8.0-beta.1",
+    "@sheetxl/scripting": "^0.8.0-beta.1",
     "bahttext": "^2.4.0",
     "bessel": "^1.0.2",
     "jstat": "^1.9.6"

package/types/src/_utils/AggregateIFS.d.ts

@@ -31,9 +31,9 @@ import { IRange, IFormulaContext, IReferenceRange, Scalar } from '@sheetxl/primi
  *
  * Blanks keep their meaning through `emptyFold`: whether a blank matches is a constant per
  * criteria (`evaluator(null)`), so the blank positions contribute one term stated once rather
- * than a million evaluations. Measured, `COUNTIFS(A:A,"<>10")` is 1,048,576 and
+ * than a million evaluations. `COUNTIFS(A:A,"<>10")` is 1,048,576 and
  * `COUNTIFS(A:A,"<>10",B:B,">0")` is the handful B has members at — the second pair rejects
- * blanks, so the blank term drops out on its own (probe-criteria-blank.ps1).
+ * blanks, so the blank term drops out on its own.
  */
 export declare function aggregateIFS(context: IFormulaContext, pairs: readonly [criteriaRange: IReferenceRange | IRange, criteria: Scalar][], aggregateFn: (accumulator: Scalar, value: Scalar) => Scalar, aggRange: IRange | undefined, noMatchDefault: Scalar, emptyFold: ((accumulator: Scalar, count: number) => Scalar) | null): Scalar;
 //# sourceMappingURL=AggregateIFS.d.ts.map

package/types/src/_utils/Errors.d.ts

@@ -4,7 +4,7 @@ import { IRange, Scalar } from '@sheetxl/primitives';
  * for functions that cannot use the engine's reject default. Call it once per range, in
  * ARGUMENT order, where a function takes several.
  *
- * Three reasons a function ends up here, all measured:
+ * Three reasons a function ends up here:
  * * its policy depends on a runtime argument (SUBTOTAL/AGGREGATE options),
  * * or on which rows matched (the database family),
  * * or one of its own verdicts OUTRANKS a member error, so the scan has to run after that check

package/types/src/information/Information.d.ts

@@ -33,16 +33,16 @@ export declare function ISBLANK(value: AcceptError<Scalar>): boolean;
  *
  * @remarks
  * A TEXT predicate, despite the name — it asks whether text spells a date, not whether a value
- * is one. Measured in Sheets 2026-08-19: every number is FALSE at every serial, `0`, `1`,
- * `2958465` and `-1` alike, and so is `DATEVALUE("1/1/2020")`, whose declared return is a
- * number. Booleans and blanks are FALSE; errors propagate with their identity. Text is TRUE
- * when the parser accepts the WHOLE string — a bare `"July"` and `"2/30/2020"` are FALSE.
+ * is one. In Sheets every number is FALSE at every serial, `0`, `1`, `2958465` and `-1` alike,
+ * and so is `DATEVALUE("1/1/2020")`, whose declared return is a number. Booleans and blanks are
+ * FALSE; errors propagate with their identity. Text is TRUE when the parser accepts the WHOLE
+ * string — a bare `"July"` and `"2/30/2020"` are FALSE.
  *
  * Where Sheets and Excel disagree on a SPELLING, Excel wins here: `ISDATE("July 20 1969")` is
  * FALSE (Excel wants the comma in month-day-year order), `ISDATE("Feb 30")` is TRUE (Excel
  * reads a number that cannot be a day as a 2-digit year — Feb 1930), and `ISDATE("1969-20-07")`
  * is FALSE (year-first is year-month-day with a four-digit year; Sheets takes year-day-month,
- * Excel does not). All measured, all the opposite of Sheets, and all inherited rather than
+ * Excel does not). All three are the opposite of Sheets, and all are inherited rather than
  * decided here: this shares the `DATEVALUE` parser, and that parser answers to Excel.
  *
  * **`ISDATE(A1)` on a date cell is FALSE here and TRUE in Sheets — deliberately.** Sheets reads
@@ -51,7 +51,7 @@ export declare function ISBLANK(value: AcceptError<Scalar>): boolean;
  * does not treat a format edit as a change that dirties anything — so a format-reading `ISDATE`
  * would answer correctly once and then go stale on the next reformat. Reading the value instead
  * (any serial-range number is a date) was the alternative, and it was rejected: it would have
- * contradicted six measured results to buy back one, and called `ISDATE(42)` a date.
+ * contradicted six of the Sheets results above to buy back one, and called `ISDATE(42)` a date.
  *
  * Sheets also answers TRUE for `ISDATE(TODAY())` and `ISDATE(TIME(13,0,0))` — there the
  * argument's static type is a date, which is why `DATEVALUE` differs from `TODAY` there despite

package/types/src/lookupReference/Reference.d.ts

@@ -164,7 +164,7 @@ export declare function LOOKUP(lookupValue: Scalar, lookupVector: AcceptRefError
  * @param lookupArray is a contiguous range of cells containing possible lookup values, an array of values, or a reference to an array.
  * @param matchType is a number 1, 0, or -1 indicating which value to return.
  */
-export declare function MATCH(lookupValue: AcceptError<IRange>, lookupArray: AcceptRefError<IRange>, matchType?: Omittable<number, 0>): Scalar;
+export declare function MATCH(lookupValue: AcceptError<Scalar>, lookupArray: AcceptRefError<IRange>, matchType?: Omittable<number, 0>): Scalar;
 /**
  * @summary Returns a reference to a range that is a given number of rows and columns from a given reference.
  * @param reference is the reference from which you want to base the offset, a reference to a cell or range of adjacent cells.
@@ -199,7 +199,7 @@ export declare function RTD(progId: string, server: string, topic: string[]): Sc
  * @param sortOrder a number indicating the desired sort order; 1 for ascending order (default), -1 for descending order.
  * @param byCol a logical value indicating the desired sort direction: FALSE to sort by row (default), TRUE to sort by column.
  */
-export declare function SORT(array: AcceptError<IRange>, sortIndex?: Omittable<Flatten<number>>, sortOrder?: Omittable<Flatten<number>>, byCol?: boolean): IRange;
+export declare function SORT(array: AcceptError<IRange>, sortIndex?: Omittable<AcceptRefError<IRange>>, sortOrder?: Omittable<AcceptRefError<IRange>>, byCol?: boolean): IRange;
 /**
  * @summary Sorts a range or array based on the values in a corresponding range or array.
  * @param array the range or array to sort.
@@ -284,7 +284,7 @@ export declare function WRAPROWS(vector: AcceptError<IRange>, wrapCount: number,
  * @param matchMode 0=exact (default), -1=exact/next-smaller, 1=exact/next-larger, 2=wildcard
  * @param searchMode 1=first→last (default), -1=last→first, 2=binary asc, -2=binary desc
  */
-export declare function XLOOKUP(lookupValue: AcceptError<IRange>, lookupArray: AcceptRefError<IRange>, returnArray: AcceptError<IRange>, ifNotFound?: Omittable<AcceptError<Scalar>>, matchMode?: number, searchMode?: Omittable<number>): IReferenceRange;
+export declare function XLOOKUP(lookupValue: AcceptError<Scalar>, lookupArray: AcceptRefError<IRange>, returnArray: AcceptError<IRange>, ifNotFound?: Omittable<AcceptError<Scalar>>, matchMode?: number, searchMode?: Omittable<number>): IReferenceRange;
 /**
  * @summary Returns the relative position of an item in an array. By default, an exact match is required.
  * @param lookupValue is the value to search for.
@@ -292,5 +292,5 @@ export declare function XLOOKUP(lookupValue: AcceptError<IRange>, lookupArray: A
  * @param matchMode 0=exact (default), -1=exact/next-smaller, 1=exact/next-larger, 2=wildcard
  * @param searchMode 1=first→last (default), -1=last→first, 2=binary asc, -2=binary desc
  */
-export declare function XMATCH(lookupValue: AcceptError<IRange>, lookupArray: AcceptRefError<IRange>, matchMode?: number, searchMode?: Omittable<number>): Scalar;
+export declare function XMATCH(lookupValue: AcceptError<Scalar>, lookupArray: AcceptRefError<IRange>, matchMode?: number, searchMode?: Omittable<number>): Scalar;
 //# sourceMappingURL=Reference.d.ts.map

package/types/src/mathTrig/Math.d.ts

@@ -161,8 +161,9 @@ export declare function FLOOR_PRECISE(number: number, significance?: Omittable<n
 /**
  * @summary Returns the greatest common divisor.
  * @param number are 1 to 255 values.
+ * @compat atp
  */
-export declare function GCD(number: Scalar[]): number;
+export declare function GCD(number: number[]): number;
 /**
  * @summary Rounds a number down to the nearest integer.
  * @param number is the real number you want to round down to an integer.
@@ -179,8 +180,9 @@ export declare function ISO_CEILING(number: number, significance?: number): numb
 /**
  * @summary Returns the least common multiple.
  * @param number are 1 to 255 values for which you want the least common multiple.
+ * @compat atp
  */
-export declare function LCM(number: Scalar[]): number;
+export declare function LCM(number: number[]): number;
 /**
  * @summary Returns the natural logarithm of a number.
  * @param number is the positive real number for which you want the natural logarithm.
@@ -228,6 +230,7 @@ export declare function MROUND(number: number, multiple: number): number;
 /**
  * @summary Returns the multinomial of a set of numbers.
  * @param number are 1 to 255 values for which you want the multinomial.
+ * @compat atp
  */
 export declare function MULTINOMIAL(number: number[]): number;
 /**
@@ -330,7 +333,7 @@ export declare function SEQUENCE(rows: Omittable<number>, columns?: Omittable<nu
  * @param m is the step by which to increase n for each term in the series.
  * @param coefficients is a set of coefficients by which each successive power of x is multiplied.
  */
-export declare function SERIESSUM(x: number, n: number, m: number, coefficients: IRange<number>): number;
+export declare function SERIESSUM(x: number, n: number, m: number, coefficients: IRange): number;
 /**
  * @summary Returns the sign of a number: 1 if the number is positive, zero if the number is zero, or -1 if the number is negative.
  * @param number is any real number.