@sheetxl/formulas 0.8.0-beta.1 → 0.8.0-beta.3

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

@@ -1,33 +1,107 @@
-import { FormulaError, AcceptError, AcceptRefError, Scalar, IReferenceRange, IRange, Flatten } from '@sheetxl/primitives';
-/**
- * @summary Returns information about the cell.
- * @param {'address' | 'col' | 'contents' | 'row' | 'type'} infoType The type of information to return.
- * @param infoType
- * @param reference
+import { FormulaError, AcceptError, NoLift, ReportType, Scalar, Volatile, IReferenceRange, IRange, Flatten } from '@sheetxl/primitives';
+/**
+ * The information to return about the cell.
+ */
+declare enum CellInfoType {
+    /** Reference of the first cell in the reference, as text. */
+    Address = "address",
+    /** Column number of the cell in the reference. */
+    Col = "col",
+    /**
+     * 1 if the cell is formatted in color for negative values; otherwise 0.
+     * @deprecated Excel desktop only
+     */
+    Color = "color",
+    /** Value of the upper-left cell in the reference; not a formula. */
+    Contents = "contents",
+    /**
+     * Full path of the file that contains the reference, as text.
+     * @deprecated Excel desktop only
+     */
+    Filename = "filename",
+    /**
+     * Text value corresponding to the number format of the cell.
+     * @deprecated Excel desktop only
+     */
+    Format = "format",
+    /**
+     * 1 if the cell is formatted with parentheses for positive or all values; otherwise 0.
+     * @deprecated Excel desktop only
+     */
+    Parentheses = "parentheses",
+    /**
+     * Text value corresponding to the label prefix of the cell.
+     * @deprecated Excel desktop only
+     */
+    Prefix = "prefix",
+    /**
+     * 0 if the cell is not locked; otherwise 1.
+     * @deprecated Excel desktop only
+     */
+    Protect = "protect",
+    /** Row number of the cell in the reference. */
+    Row = "row",
+    /** "b" for a blank cell, "l" for a text constant, "v" for anything else. */
+    Type = "type",
+    /**
+     * Column width of the cell, rounded to an integer.
+     * @deprecated Excel desktop only
+     */
+    Width = "width"
+}
+/**
+ * Returns information about the cell.
+ * @param infoType The type of information to return.
+ * @param reference The cell to report on. Defaults to the cell holding the formula.
  *
  * @remarks
  * This has similar functionality to Excel online but is missing formatting information from Excel desktop.
  * {@link https://support.office.com/client/results?authtype=unknown&lcid=1033&locale=en-us&ns=EXCEL&syslcid=1033&uilcid=1033&version=90&helpid=xlmain11.chm60173}
  */
-export declare function CELL(infoType: string, reference?: AcceptError<IReferenceRange>): Scalar;
+export declare function CELL(infoType: CellInfoType, reference?: IReferenceRange): Volatile<Scalar>;
 /**
+ * Returns a number matching an error value.
  * @name ERROR.TYPE
- * @summary Returns a number matching an error value.
  * @param errorVal is the error value for which you want the identifying number, and can be an actual error value or a reference to a cell containing an error value.
  */
 export declare function ERROR_TYPE(errorVal: AcceptError<Scalar>): Scalar;
-/**
- * @summary Returns information about the current operating system.
- * @param {'DIRECTORY' | 'NUMFILE' | 'ORIGIN' | 'OSVERSION' | 'RECALC' | 'RELEASE' | 'SYSTEM' | 'USER'} typeText The type of information to return.
- */
-export declare function INFO(typeText: string): string;
-/**
- * @summary Checks whether a reference is to an empty cell, and returns TRUE or FALSE.
+/** The information to return about the operating environment. */
+declare enum InfoType {
+    /** Path of the current directory or folder. */
+    Directory = "directory",
+    /** Amount of memory available. Legacy: answers #N/A. */
+    MemAvail = "memavail",
+    /** Amount of memory being used for data. Legacy: answers #N/A. */
+    MemUsed = "memused",
+    /** Number of active worksheets in the open workbooks. */
+    NumFile = "numfile",
+    /** Absolute reference of the top and leftmost visible cell. */
+    Origin = "origin",
+    /** Current operating system version, as text. */
+    OSVersion = "osversion",
+    /** Current recalculation mode; "Automatic" or "Manual". */
+    Recalc = "recalc",
+    /** Version of the application, as text. */
+    Release = "release",
+    /** Name of the operating environment; "pcdos" or "mac". */
+    System = "system",
+    /** Total memory available. Legacy: answers #N/A. */
+    TotMem = "totmem",
+    /** The licensed user. Not part of Excel. */
+    User = "user"
+}
+/**
+ * Returns information about the current operating system.
+ * @param typeText The type of information to return.
+ */
+export declare function INFO(typeText: InfoType): Volatile<Scalar>;
+/**
+ * Checks whether a reference is to an empty cell, and returns TRUE or FALSE.
  * @param value is the cell or a name that refers to the cell you want to test.
  */
 export declare function ISBLANK(value: AcceptError<Scalar>): boolean;
 /**
- * @summary Returns TRUE if the value is a date.
+ * Returns TRUE if the value is a date.
  * @param value The value to check.
  * @category Sheets
  *
@@ -59,108 +133,103 @@ export declare function ISBLANK(value: AcceptError<Scalar>): boolean;
  */
 export declare function ISDATE(value: Scalar): boolean;
 /**
- * @summary Returns TRUE if the value is a valid email address.
+ * Returns TRUE if the value is a valid email address.
  * @param value The value to check.
  * @category Sheets
  */
 export declare function ISEMAIL(value: string): boolean;
 /**
- * @summary Checks whether a value is an error other than #N/A, and returns TRUE or FALSE.
+ * Checks whether a value is an error other than #N/A, and returns TRUE or FALSE.
  * @param value is the value you want to test. Value can refer to a cell, a formula, or a name that refers to a cell, formula, or value.
  */
 export declare function ISERR(value: AcceptError<Scalar>): Scalar;
 /**
- * @summary Checks whether a value is an error, and returns TRUE or FALSE
+ * Checks whether a value is an error, and returns TRUE or FALSE
  * @param value is the value you want to test. Value can refer to a cell, a formula, or a name that refers to a cell, formula, or value
  */
 export declare function ISERROR(value: AcceptError<Scalar>): Scalar;
 /**
- * @summary Returns TRUE if the number is even.
+ * Returns TRUE if the number is even.
  * @param number is the value to test.
- *
- * @remarks
- * We take a range to error if a range.
  */
-export declare function ISEVEN(number: IRange<number>): Scalar;
+export declare function ISEVEN(number: NoLift<Scalar>): Scalar;
 /**
- * @summary Checks whether a reference is to a cell containing a formula, and returns TRUE or FALSE.
+ * Checks whether a reference is to a cell containing a formula, and returns TRUE or FALSE.
  * @param reference is a reference to the cell you want to test.  Reference can be a cell reference, a formula, or name that refers to a cell.
  */
-export declare function ISFORMULA(reference: AcceptError<IReferenceRange>): boolean;
+export declare function ISFORMULA(reference: ReportType<IReferenceRange>): boolean;
 /**
- * @summary Checks whether a value is a logical value (TRUE or FALSE), and returns TRUE or FALSE.
+ * Checks whether a value is a logical value (TRUE or FALSE), and returns TRUE or FALSE.
  * @param value is the value you want to test. Value can refer to a cell, a formula, or a name that refers to a cell, formula, or value.
  */
 export declare function ISLOGICAL(value: AcceptError<Scalar>): boolean;
 /**
- * @summary Checks whether a value is #N/A, and returns TRUE or FALSE.
+ * Checks whether a value is #N/A, and returns TRUE or FALSE.
  * @param value is the value you want to test. Value can refer to a cell, a formula, or a name that refers to a cell, formula, or value.
  */
 export declare function ISNA(value: AcceptError<Scalar>): boolean;
 /**
- * @summary Checks whether a value is not text (blank cells are not text), and returns TRUE or FALSE.
+ * Checks whether a value is not text (blank cells are not text), and returns TRUE or FALSE.
  * @param value is the value you want tested: a cell; a formula; or a name referring to a cell, formula, or value.
  */
 export declare function ISNONTEXT(value: AcceptError<Scalar>): boolean;
 /**
- * @summary Checks whether a value is not text (blank cells are not text), and returns TRUE or FALSE.
+ * Checks whether a value is not text (blank cells are not text), and returns TRUE or FALSE.
  * @param value is the value you want tested: a cell; a formula; or a name referring to a cell, formula, or value.
  */
 export declare function ISNUMBER(value: AcceptError<Scalar>): boolean;
 /**
- * @summary Returns TRUE if the number is odd.
+ * Returns TRUE if the number is odd.
  * @param number is the value to test.
- *
- * @remarks
- * We take a range to error if a range.
  */
-export declare function ISODD(number: IRange<number>): Scalar;
+export declare function ISODD(number: NoLift<Scalar>): Scalar;
 /**
- * @summary Checks whether the value is omitted, and returns TRUE or FALSE.
+ * Checks whether the value is omitted, and returns TRUE or FALSE.
  * @param argument is the value you want to test, such as a LAMBDA parameter.
  */
-export declare function ISOMITTED(argument: AcceptError<Scalar>): boolean;
+export declare function ISOMITTED(argument: AcceptError<any>): boolean;
 /**
- * @summary Returns TRUE if the value is a valid HTTP or HTTPS URL.
+ * Returns TRUE if the value is a valid HTTP or HTTPS URL.
  * @param value The value to check.
  * @category Sheets
  */
 export declare function ISURL(value: string): boolean;
 /**
- * @summary Checks whether a value is a reference, and returns TRUE or FALSE.
+ * Checks whether a value is a reference, and returns TRUE or FALSE.
  * @param value is the value you want to test. Value can refer to a cell, a formula, or a name that refers to a cell, formula, or value.
  */
 export declare function ISREF(value: Flatten<AcceptError<IRange>>): boolean;
 /**
- * @summary Converts a value to text in a specific number format.
+ * Converts a value to text in a specific number format.
  * @param value is a number, a formula that evaluates to a numeric value, or a reference to a cell containing a numeric value.
  */
 export declare function ISTEXT(value: AcceptError<Scalar>): boolean;
 /**
- * @summary Converts non-number value to a number, dates to serial numbers, TRUE to 1, anything else to 0 (zero).
+ * Converts non-number value to a number, dates to serial numbers, TRUE to 1, anything else to 0 (zero).
  * @param value is the value to convert.
  */
-export declare function N(value: AcceptError<Scalar>): Scalar;
+export declare function N(value: IRange | Scalar): Scalar;
 /**
- * @summary Returns the #N/A error value
+ * Returns the #N/A error value
  */
 export declare function NA(): FormulaError.Known;
-/**.
- * @summary Returns the sheet number of the referenced sheet.
+/**
+ * Returns the sheet number of the referenced sheet.
  * @param value is the name of a sheet or a reference that you want the sheet number of. If omitted the number of the sheet containing the function is returned.
  */
-export declare function SHEET(value?: AcceptRefError<IRange>): Scalar;
+export declare function SHEET(value?: ReportType<IRange>): Scalar;
 /**
- * @summary Returns the number of sheets in a reference.
+ * Returns the number of sheets in a reference.
  * @param reference is a reference for which you want to know the number of sheets it contains. If omitted the number of sheets in the workbook containing the function is returned.
  *
  * @remarks
  * A non-reference argument — a number, text, an array, a computed value — returns `#N/A`.
  */
-export declare function SHEETS(reference?: AcceptRefError<IRange>): number | FormulaError.Known;
+export declare function SHEETS(reference?: ReportType<IRange>): number | FormulaError.Known;
 /**
- * @summary Returns an integer representing the data type of a value: number = 1; text = 2; logical value = 4; error value = 16; array = 64; compound data = 128.
+ * Returns an integer representing the data type of a value: number = 1; text = 2; logical value = 4; error value = 16; array = 64; compound data = 128.
  * @param value is the value to check.
  */
 export declare function TYPE(value: AcceptError<IRange>): number;
+export {};
 //# sourceMappingURL=Information.d.ts.map

package/types/src/japanese/Date.d.ts

@@ -1,13 +1,13 @@
 import { Scalar } from '@sheetxl/primitives';
 /**
+ * Converts a standard date code into a localized text string.
  * @hidden Unimplemented Japanese.
- * @summary Converts a standard date code into a localized text string.
  * @param number A numeric value representing a date code.
  */
 export declare function DATESTRING(number: number): Scalar;
 /**
+ * Converts a number into Japanese Kanji words.
  * @hidden Unimplemented Japanese.
- * @summary Converts a number into Japanese Kanji words.
  * @param number A numeric value representing a date code.
  * @param number2 A numeric value representing a date code.
  */

package/types/src/japanese/Text.d.ts

@@ -1,7 +1,7 @@
 import { Scalar, IReferenceRange } from '@sheetxl/primitives';
 /**
+ * Returns the phonetic spelling of a text string.
  * @hidden Unimplemented Japanese.
- * @summary Returns the phonetic spelling of a text string.
  * @param reference Text string or a reference to a single cell or a range of cells that contain a furigana text string.
  */
 export declare function PHONETIC(reference: IReferenceRange): Scalar | undefined;

package/types/src/logical/Logical.d.ts

@@ -1,100 +1,106 @@
-import { IRange, AcceptError, AcceptRefError, IReferenceRange, Scalar, Lambda, Omittable, Repeating } from '@sheetxl/primitives';
+import { IRange, AcceptError, IReferenceRange, Scalar, Lambda, Lazy, Omittable, Repeating } from '@sheetxl/primitives';
 /**
- * @summary Checks whether all arguments are TRUE, and returns TRUE if all arguments are TRUE.
+ * Checks whether all arguments are TRUE, and returns TRUE if all arguments are TRUE.
  * @param logical are 1 to 255 conditions you want to test that can be either TRUE or FALSE and can be logical values, arrays, or references.
  */
-export declare function AND(logical: IRange[]): Scalar;
+export declare function AND(logical: IRange<boolean>[]): Scalar;
 /**
- * @summary Applies a LAMBDA function to each column and returns an array of the results.
+ * Applies a LAMBDA function to each column and returns an array of the results.
  * @param array is an array to be separated by column.
  * @param fn is a LAMBDA that takes a column as its single parameter and returns one result for it.
  */
-export declare function BYCOL(array: AcceptRefError<IRange>, fn?: Lambda<[column: IRange], Scalar>): IRange;
+export declare function BYCOL(array: IRange, fn?: Lambda<[column: IRange], Scalar>): IRange;
 /**
- * @summary Applies a LAMBDA function to each row and returns an array of the results.
+ * Applies a LAMBDA function to each row and returns an array of the results.
  * @param array is an array to be separated by row.
  * @param fn is a LAMBDA that takes a row as its single parameter and returns one result for it.
  */
-export declare function BYROW(array: AcceptRefError<IRange>, fn?: Lambda<[row: IRange], Scalar>): IRange;
+export declare function BYROW(array: IRange, fn?: Lambda<[row: IRange], Scalar>): IRange;
 /**
- * @summary Returns the logical value FALSE.
+ * Returns the logical value FALSE.
  */
 export declare function FALSE(): boolean;
 /**
- * @summary Flattens all the values from one or more ranges into a single column.
+ * Flattens all the values from one or more ranges into a single column.
  * @param ranges One or more ranges or scalar values to flatten.
  * @category Sheets
  */
-export declare function FLATTEN(ranges: AcceptError<IRange>[]): IRange;
+export declare function FLATTEN(ranges: IRange[]): IRange;
 /**
- * @summary Checks whether a condition is met, and returns one value if TRUE, and another value if FALSE.
+ * Checks whether a condition is met, and returns one value if TRUE, and another value if FALSE.
  * @param logicalTest is any value or expression that can be evaluated to TRUE or FALSE.
  * @param valueIfTrue is the value that is returned if logicalTest is TRUE. If omitted, TRUE is returned. You can nest up to seven IF functions.
  * @param valueIfFalse is the value that is returned if logicalTest is FALSE. If omitted, FALSE is returned.
  */
-export declare function IF(logicalTest: boolean, valueIfTrue: AcceptError<any>, valueIfFalse?: AcceptError<any>): any;
+export declare function IF(logicalTest: boolean, valueIfTrue: Lazy<AcceptError<any>>, valueIfFalse: Lazy<AcceptError<any>, false>): any;
 /**
- * @summary Returns valueIfError if expression is an error and the value of the expression itself otherwise.
+ * Returns valueIfError if expression is an error and the value of the expression itself otherwise.
  * @param value is any value or expression or reference.
  * @param valueIfError is any value or expression or reference.
  */
-export declare function IFERROR(value: AcceptError<Scalar>, valueIfError: AcceptError<any>): Scalar;
+export declare function IFERROR(value: AcceptError<Scalar>, valueIfError: Lazy<AcceptError<any>>): Scalar;
 /**
- * @summary Returns the value you specify if the expression resolves to #N/A, otherwise returns the result of the expression.
+ * Returns the value you specify if the expression resolves to #N/A, otherwise returns the result of the expression.
  * @param value is any value or expression or reference.
  * @param valueIfNA is any value or expression or reference.
  */
-export declare function IFNA(value: AcceptError<Scalar>, valueIfNA: AcceptError<any>): Scalar;
+export declare function IFNA(value: AcceptError<Scalar>, valueIfNA: Lazy<AcceptError<any>>): Scalar;
 /**
- * @summary Checks whether one or more conditions are met and returns a value corresponding to the first TRUE condition.
+ * Checks whether one or more conditions are met and returns a value corresponding to the first TRUE condition.
  * @param condition the conditions to test and the values to return for them.
  * @param condition.logicalTest is any value or expression that can be evaluated to TRUE or FALSE.
  * @param condition.logicalTrue is the value returned if logicalTest is TRUE.
+ *
+ * @remarks
+ * The search STOPS at the first TRUE condition, and a condition past it is never read: a
+ * `#DIV/0!` or an uncoercible text there does not surface. A fault reached BEFORE the match is
+ * fatal, which is why the test slot accepts errors and this body decides — the engine's own
+ * left-to-right propagation would refuse the whole call for a condition Excel never evaluates.
  */
-export declare function IFS(condition: Repeating<[logicalTest: boolean, logicalTrue: AcceptError<any>]>): any;
+export declare function IFS(condition: Repeating<[logicalTest: AcceptError<boolean>, logicalTrue: AcceptError<any>], 254>): any;
 /**
- * @summary Creates a function value which can be called within formulas.
+ * Creates a function value which can be called within formulas.
  * @param parameterOrCalculation a parameter or a calculation that returns a value. If a parameter, it must be the last argument.
  */
-export declare function LAMBDA(parameterOrCalculation: AcceptError<IRange>[]): Lambda;
+export declare function LAMBDA(parameterOrCalculation: Repeating<AcceptError<IRange>, 254>): Lambda;
 /**
- * @summary Assigns calculation results to names. Useful for storing intermediate calculations and values by defining names inside a formula. These names only apply within the scope of the LET function.
+ * Assigns calculation results to names. Useful for storing intermediate calculations and values by defining names inside a formula. These names only apply within the scope of the LET function.
  * @param name the name, or a calculation which can make use of all names within the LET. Names must start with a letter, cannot be the output of a formula, or conflict with range syntax.
  * @param nameOrValue the value associated with the name.
  */
-export declare function LET(name: AcceptError<any>, nameOrValue: AcceptError<IRange>, calculationOrName: AcceptError<IRange>, ...rest: AcceptError<IRange>[]): any;
+export declare function LET(name: AcceptError<any>, nameOrValue: AcceptError<IRange>, calculationOrName: AcceptError<IRange>, ...rest: Repeating<AcceptError<IRange>, 254>): any;
 /**
- * @summary Returns a calculated array of a specified row and column size, by applying a LAMBDA function.
+ * Returns a calculated array of a specified row and column size, by applying a LAMBDA function.
  * @param rows is the number of rows in the array. Must be greater than zero.
  * @param columns is the number of columns in the array. Must be greater than zero.
  * @param fn is a LAMBDA that is called to create the array. The LAMBDA takes two parameters, row index and column index.
  */
 export declare function MAKEARRAY(rows: Omittable<number, 1>, columns: Omittable<number, 1>, fn: Lambda<[rowIndex: number, colIndex: number], Scalar>): IRange;
 /**
- * @summary Returns an array formed by 'mapping' each value in the array(s) to a new value by applying a lambda to create a new value.
+ * Returns an array formed by 'mapping' each value in the array(s) to a new value by applying a lambda to create a new value.
  * @param array is an array to be mapped.
  * @param lambdaOrArray is a LAMBDA which must be the last argument and must have a parameter for each array passed, or another array to be mapped.
  */
-export declare function MAP(array: AcceptRefError<IRange>, lambdaOrArray: (any | Lambda<any[], Scalar>)[]): IRange;
+export declare function MAP(array: IRange, lambdaOrArray: AcceptError<any | Lambda<any[], Scalar>>[]): IRange;
 /**
- * @summary Changes FALSE to TRUE, or TRUE to FALSE.
+ * Changes FALSE to TRUE, or TRUE to FALSE.
  * @param logical is a value or expression that can be evaluated to TRUE or FALSE.
  */
 export declare function NOT(logical: boolean): boolean;
 /**
- * @summary Checks whether any of the arguments are TRUE, and returns TRUE or FALSE. Returns FALSE only if all arguments are FALSE.
+ * Checks whether any of the arguments are TRUE, and returns TRUE or FALSE. Returns FALSE only if all arguments are FALSE.
  * @param logical are 1 to 255 conditions that you want to test that can be either TRUE or FALSE.
  */
-export declare function OR(logical: IRange[]): Scalar;
+export declare function OR(logical: IRange<boolean>[]): Scalar;
 /**
- * @summary Reduces an array to an accumulated value by applying a LAMBDA function to each value and returning the total value in the accumulator.
+ * Reduces an array to an accumulated value by applying a LAMBDA function to each value and returning the total value in the accumulator.
  * @param initialValue is the starting value for the accumulator.
  * @param array is an array to be reduced.
  * @param fn is a LAMBDA that is called to reduce the array. The LAMBDA takes two parameters, accumulator and value.
  */
-export declare function REDUCE(initialValue: Omittable<AcceptError<any>>, array: AcceptRefError<IRange>, fn: Lambda<[accumulator: any, value: Scalar], any>): any;
+export declare function REDUCE(initialValue: Omittable<AcceptError<any>>, array: IRange, fn: Lambda<[accumulator: any, value: IRange | Scalar], any>): any;
 /**
- * @summary Reduces the cells specified by a given condition or criteria.
+ * Reduces the cells specified by a given condition or criteria.
  * @param range is the range of cells you want evaluated.
  * @param criteria is the condition or criteria in the form of a number, expression, or text that defines which cells will be reduced.
  * @param reduceRange are the actual cells to reduce. If omitted, the cells in range are used. This can be blank.
@@ -104,30 +110,30 @@ export declare function REDUCE(initialValue: Omittable<AcceptError<any>>, array:
  * @remarks
  * This is a lambda equivalent to SUMIF, COUNTIF, and AVERAGEIF.
  */
-export declare function REDUCEIF(range: AcceptError<IReferenceRange>, criteria: AcceptError<Scalar>, reduceRange: Omittable<AcceptError<IReferenceRange>>, fn: Lambda<[accumulator: Scalar, value: Scalar], Scalar>): Scalar;
+export declare function REDUCEIF(range: IReferenceRange, criteria: AcceptError<Scalar>, reduceRange: Omittable<IReferenceRange>, fn: Lambda<[accumulator: Scalar, value: Scalar], Scalar>): Scalar;
 /**
- * @summary Scans an array by applying a LAMBDA function to each value and returns an array that has each intermediate value.
+ * Scans an array by applying a LAMBDA function to each value and returns an array that has each intermediate value.
  * @param initialValue is the starting value for the accumulator.
  * @param array is an array to be reduced.
  * @param fn is a LAMBDA that is called to reduce the array. The LAMBDA takes two parameters, accumulator and value.
  */
-export declare function SCAN(initialValue: Omittable<Scalar>, array: AcceptRefError<IRange>, fn: Lambda<[accumulator: Scalar, value: Scalar], Scalar>): IRange;
+export declare function SCAN(initialValue: Omittable<AcceptError<any>>, array: IRange, fn: Lambda<[accumulator: any, value: IRange | Scalar], Scalar>): IRange;
 /**
- * @summary Evaluates an expression against a list of values and returns the result corresponding to the first matching value. If there is no match, an optional default value is returned.
+ * Evaluates an expression against a list of values and returns the result corresponding to the first matching value. If there is no match, an optional default value is returned.
  * @param match the values to compare against expression and the results to return for them.
  * @param match.value is a value to compare against expression.
  * @param match.result is a result to be returned if the corresponding value matches expression.
  * @param expression is an expression to be evaluated.
  * @param defaultResult is the result to be returned when no value matches expression.
  */
-export declare function SWITCH(expression: Scalar, match: Repeating<[value: Scalar, result: AcceptError<any>]>, defaultResult?: Omittable<AcceptError<any>, 0>): any;
+export declare function SWITCH(expression: Scalar, match: Repeating<[value: AcceptError<Scalar>, result: AcceptError<any>], 254>, defaultResult?: Omittable<AcceptError<any>, 0>): any;
 /**
- * @summary Returns the logical value TRUE.
+ * Returns the logical value TRUE.
  */
 export declare function TRUE(): boolean;
 /**
- * @summary Returns a logical 'Exclusive Or' of all arguments.
+ * Returns a logical 'Exclusive Or' of all arguments.
  * @param logical are 1 to 254 conditions you want to test that can be either TRUE or FALSE and can be logical values, arrays, or references.
  */
-export declare function XOR(logical: IRange[]): Scalar;
+export declare function XOR(logical: Repeating<IRange<boolean>, 254>): Scalar;
 //# sourceMappingURL=Logical.d.ts.map

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

@@ -1,7 +1,7 @@
-import { IRange, AcceptRefError, Flatten, Omittable, Scalar } from '@sheetxl/primitives';
+import { IRange, Flatten, Omittable, Scalar } from '@sheetxl/primitives';
 /**
- * @hidden Unimplemented TODO
- * @summary Aggregate values by row fields.
+ * Aggregate values by row fields.
+ * @hidden Not yet implemented.
  * @param rowFields The range or array containing the row fields.
  * @param values The range or array containing the values to aggregate.
  * @param fn The function used to do the aggregations.
@@ -11,7 +11,7 @@ import { IRange, AcceptRefError, Flatten, Omittable, Scalar } from '@sheetxl/pri
  * @param filterArray param-534 paramName-535.
  * @param fieldRelationship The relationship of fields when multiple columns are supplied to the rowFields argument.
  */
-export declare function GROUPBY(rowFields: AcceptRefError<IRange>, values: IRange, fn: Flatten<any>, // This can be either a Lamda function or a builtIn.
+export declare function GROUPBY(rowFields: IRange, values: IRange, fn: Flatten<any>, // This can be either a lambda function or a built-in.
 fieldHeaders?: Omittable<number>, // 0-no, 1-yes, 2-no but generate, 3-yes and show
 totalDepth?: number, // 0-no totals, 1-grand totals, 2-grand and subtotals, -1-grand totals at top, -2 grand and sub totals at top
 sortOrder?: Omittable<Flatten<any>>, // <0, >0

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

@@ -1,7 +1,7 @@
-import { IRange, AcceptRefError, Flatten, Omittable, Scalar } from '@sheetxl/primitives';
+import { IRange, Flatten, Omittable, Scalar } from '@sheetxl/primitives';
 /**
- * @hidden Unimplemented TODO
- * @summary Aggregate values by rows and columns.
+ * Aggregate values by rows and columns.
+ * @hidden Not yet implemented.
  * @param rowFields The range or array containing the row fields.
  * @param colFields The range or array containing the column fields.
  * @param values The range or array containing the value fields.
@@ -14,7 +14,7 @@ import { IRange, AcceptRefError, Flatten, Omittable, Scalar } from '@sheetxl/pri
  * @param filterArray An array of boolean where TRUE represents a row to retain.
  * @param relativeTo Defines what PERCENTOF is calculated relative to.
  */
-export declare function PIVOTBY(rowFields: AcceptRefError<IRange>, colFields: AcceptRefError<IRange>, values: Flatten<IRange>, fn: Flatten<IRange>, // Wow, this is a lambda function? No. I don't think so...
+export declare function PIVOTBY(rowFields: IRange, colFields: IRange, values: Flatten<IRange>, fn: Flatten<IRange>, // This can be either a lambda function or a built-in.
 fieldHeaders?: Omittable<number>, // 0-no, 1-yes, 2-no but generate, 3-yes and show
 rowTotalDepth?: number, // 0-no totals, 1-grand totals, 2-grand and subtotals, -1-grand totals at top, -2 grand and sub totals at top
 rowSortOrder?: Omittable<Flatten<any>>, // <0, >0