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

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

@@ -1,28 +1,28 @@
-import { IRange, AcceptError, AcceptRefError, Scalar, IReferenceRange, IRichData, Repeating, Flatten, Omittable } from '@sheetxl/primitives';
+import { IRange, FormulaError, AcceptError, Scalar, IReferenceRange, IRichData, Repeating, Flatten, Lazy, Omittable, NoLift, ReportType } from '@sheetxl/primitives';
 /**
- * @summary Creates a cell reference as text, given specified row and column numbers.
+ * Creates a cell reference as text, given specified row and column numbers.
  * @param rowNum is the row number to use in the cell reference: Row_number = 1 for row 1.
  * @param columnNum is the column number to use in the cell reference. For example, Column_number = 4 for column D.
  * @param absNum specifies the reference type: absolute = 1; absolute row/relative column = 2; relative row/absolute column = 3; relative = 4.
  * @param a1 is a logical value that specifies the reference style: A1 style = 1 or TRUE; R1C1 style = 0 or FALSE.
  * @param sheetText is text specifying the name of the worksheet to be used as the external reference.
  */
-export declare function ADDRESS(rowNum: number, columnNum: number, absNum?: Omittable<number>, a1?: Omittable<boolean>, sheetText?: string): string;
+export declare function ADDRESS(rowNum: number, columnNum: number, absNum?: Omittable<number>, a1?: Omittable<boolean>, sheetText?: Omittable<string>): string;
 /**
- * @summary Returns the number of areas in a reference. An area is a range of contiguous cells or a single cell.
+ * Returns the number of areas in a reference. An area is a range of contiguous cells or a single cell.
  * @param references is a reference to a cell or range of cells and can refer to multiple areas.
  */
-export declare function AREAS(references: Flatten<AcceptError<IReferenceRange>>): number;
+export declare function AREAS(references: Flatten<IReferenceRange>): number;
 /**
- * @summary Constrains an array result to a specified size.
+ * Constrains an array result to a specified size.
  * @param inputRange The range to constrain.
  * @param numRows The number of rows the result should contain.
  * @param numCols The number of columns the result should contain.
  * @category Sheets
  */
-export declare function ARRAY_CONSTRAIN(inputRange: AcceptError<IRange>, numRows: number, numCols: number): IRange;
+export declare function ARRAY_CONSTRAIN(inputRange: IRange, numRows: number, numCols: number): IRange;
 /**
- * @summary Enables the display of values returned from an array formula into multiple rows and/or columns.
+ * Enables the display of values returned from an array formula into multiple rows and/or columns.
  * @param arrayFormula A range, a mathematical expression over ranges of the same size, or a function that returns a result of more than one cell.
  * @category Sheets
  *
@@ -31,102 +31,95 @@ export declare function ARRAY_CONSTRAIN(inputRange: AcceptError<IRange>, numRows
  * into array evaluation.
  * Here every formula already evaluates as an array and spills, so there for pure sheet compatiblity.
  */
-export declare function ARRAYFORMULA(arrayFormula: AcceptError<IRange>): IRange;
+export declare function ARRAYFORMULA(arrayFormula: IRange): IRange;
 /**
- * @summary Chooses a value or action to perform from a list of values, based on an index number.
+ * Chooses a value or action to perform from a list of values, based on an index number.
  * @param indexNum specifies which value argument is selected. Index_num must be between 1 and 254, or a formula or a reference to a number between 1 and 254.
  * @param value are 1 to 254 numbers, cell references, defined names, formulas, functions, or text arguments from which CHOOSE selects.
  */
-export declare function CHOOSE(indexNum: number, value: AcceptError<any>[]): any;
+export declare function CHOOSE(indexNum: number, value: Lazy<AcceptError<any>>[]): any;
 /**
- * @summary Returns columns from an array or reference.
+ * Returns columns from an array or reference.
  * @param array The array or reference from which to choose columns.
  * @param colNum The number of the column to be returned.
  */
-export declare function CHOOSECOLS(array: AcceptError<IRange>, colNum: number[]): IRange;
+export declare function CHOOSECOLS(array: Flatten<IRange>, colNum: Repeating<number, 254>): IRange;
 /**
- * @summary Returns rows from an array or reference.
+ * Returns rows from an array or reference.
  * @param array The array or reference from which to choose rows.
  * @param rowNum The number of the row to be returned.
  */
-export declare function CHOOSEROWS(array: AcceptError<IRange>, rowNum: number[]): IRange;
+export declare function CHOOSEROWS(array: Flatten<IRange>, rowNum: Repeating<number, 254>): IRange;
 /**
- * @summary Returns the column number of a reference.
+ * Returns the column number of a reference.
  * @param reference is the cell or range of contiguous cells for which you want the column number. If omitted, the cell containing the COLUMN function is used.
  */
-export declare function COLUMN(reference?: AcceptError<IReferenceRange>): number[];
+export declare function COLUMN(reference?: Flatten<IReferenceRange>): number[];
 /**
- * @summary Returns the number of columns in an array or reference.
+ * Returns the number of columns in an array or reference.
  * @param array is an array or array formula, or a reference to a range of cells for which you want the number of columns.
  */
-export declare function COLUMNS(array: AcceptRefError<IRange>): number;
+export declare function COLUMNS(array: Flatten<IRange>): number | FormulaError.Known;
 /**
- * @summary Drops rows or columns from array start or end.
+ * Drops rows or columns from array start or end.
  * @param array The array from which to drop rows or columns.
  * @param row The number of rows to drop. A negative value drops from the end of the array.
  * @param columns The number of columns to drop. A negative value drops from the end of the array.
  */
-export declare function DROP(array: AcceptRefError<IRange>, row: number, columns?: Omittable<number>): IRange;
-/**
- * @summary Expands an array to the specified dimensions.
- * @param array The array to expand.
- * @param row The number of rows in the expanded array. If missing, rows will not be expanded.
- * @param columns The number of columns in the expanded array. If missing, columns will not be expanded.
- * @param padWidth The value with which to pad. The default is #N/A.
- */
-export declare function EXPAND(array: AcceptError<IRange>, row: number, columns?: Omittable<number>, padWidth?: AcceptError<Scalar>): IRange;
+export declare function DROP(array: IRange, row: number, columns?: Omittable<number>): IReferenceRange;
+export declare function EXPAND(array: IRange | Scalar, row: Omittable<number>, columns?: Omittable<number>, padWith?: NoLift<Omittable<AcceptError<Scalar>>>): IRange;
 /**
+ * Extracts a value from a field of a given record.
  * @hidden Unimplemented RichData
- * @summary Extracts a value from a field of a given record.
  * @param value The record from which you want to extract the field.
  * @param fieldName The names of the field or fields that you want to extract.
  */
 export declare function FIELDVALUE(value: IRichData, fieldName: string): Scalar[][];
 /**
- * @summary Filter a range or array.
+ * Filter a range or array.
  * @param array the range or array to filter.
  * @param include an array of booleans where TRUE represents a row or column to retain.
  * @param ifEmpty return if no items are retained.
  */
-export declare function FILTER(array: AcceptError<IRange>, include: AcceptError<IRange<boolean>>, ifEmpty?: AcceptError<IRange>): IRange;
+export declare function FILTER(array: Flatten<IRange>, include: Flatten<IRange<boolean>>, ifEmpty?: Omittable<AcceptError<IRange>>): IRange;
 /**
- * @summary Returns a formula as a string.
+ * Returns a formula as a string.
  * @param reference is a reference to a formula.
  */
-export declare function FORMULATEXT(reference: AcceptError<IReferenceRange>): string;
+export declare function FORMULATEXT(reference: Flatten<IReferenceRange>): string;
 /**
+ * Extracts data stored in a PivotTable.
  * @hidden Unimplemented Pivot
- * @summary Extracts data stored in a PivotTable.
  * @param dataField is the name of the data field to extract data from.
  * @param pivotTable is a reference to a cell or range of cells in the PivotTable that contains the data you want to retrieve.
  * @param fieldItem the field/item pairs to refer to.
  * @param fieldItem.field field to refer to.
  * @param fieldItem.item field item to refer to.
  */
-export declare function GETPIVOTDATA(dataField: string, pivotTable: string, fieldItem?: Repeating<[field: string, item?: AcceptError<IRange>]>): string;
+export declare function GETPIVOTDATA(dataField: string, pivotTable: string, fieldItem?: Repeating<[field: string, item?: IRange]>): string;
 /**
- * @summary Looks for a value in the top row of a table or array of values and returns the value in the same column from a row you specify.
+ * Looks for a value in the top row of a table or array of values and returns the value in the same column from a row you specify.
  * @param lookupValue is the value to be found in the first row of the table and can be a value, a reference, or a text string.
  * @param tableArray is a table of text, numbers, or logical values in which data is looked up. tableArray can be a reference to a range or a range name.
  * @param rowIndexNum is the row number in tableArray from which the matching value should be returned. The first row of values in the table is row 1.
  * @param rangeLookup is a logical value: to find the closest match in the top row (sorted in ascending order) = TRUE; find an exact match = FALSE.
  */
-export declare function HLOOKUP(lookupValue: Scalar, tableArray: AcceptRefError<IRange>, rowIndexNum: number, rangeLookup?: boolean): Scalar;
+export declare function HLOOKUP(lookupValue: Scalar, tableArray: Flatten<IRange>, rowIndexNum: number, rangeLookup?: boolean): Scalar;
 /**
- * @summary Horizontally stacks arrays into one array.
+ * Horizontally stacks arrays into one array.
  * @param array An array or reference to be stacked.
  */
-export declare function HSTACK(array: AcceptError<IRange>[]): IRange;
+export declare function HSTACK(array: Repeating<IRange, 254>): IRange;
 /**
+ * Creates a shortcut or jump that opens a document stored on your hard drive, a network server, or on the Internet.
  * @hidden Unimplemented RichData
- * @summary Creates a shortcut or jump that opens a document stored on your hard drive, a network server, or on the Internet.
  * @param linkLocation is the text giving the path and file name to the document to be opened, a hard drive location, UNC address, or URL path.
  * @param friendlyName is text or a number that is displayed in the cell. If omitted, the cell displays the linkLocation text.
  */
 export declare function HYPERLINK(linkLocation: string, friendlyName?: string): Scalar;
 /**
+ * Returns an image from a given source.
  * @hidden Unimplemented RichData
- * @summary Returns an image from a given source.
  * @param source The path of the source that points to the image.
  * @param alternateText The alternative text that describes the image for accessibility.
  * @param sizing The setting that determines the dimensions in which the image will be rendered in the cell.
@@ -135,7 +128,7 @@ export declare function HYPERLINK(linkLocation: string, friendlyName?: string):
  */
 export declare function IMAGE(source: string, alternateText?: string, sizing?: number, height?: number, width?: number): IRichData;
 /**
- * @summary Returns a value or reference of the cell at the intersection of a particular row and column, in a given range.
+ * Returns a value or reference of the cell at the intersection of a particular row and column, in a given range.
  * @param array is a range of cells or an array constant.
  * @param rowNum selects the row in Array or Reference from which to return a value. If omitted, colNum is required.
  * @param colNum selects the column in Array or Reference from which to return a value. If omitted, rowNum is required.
@@ -144,139 +137,271 @@ export declare function IMAGE(source: string, alternateText?: string, sizing?: n
  * @remarks
  * Combines both Excel INDEX functions using optional parameters.
  */
-export declare function INDEX(array: Flatten<AcceptError<IRange>>, rowNum: Omittable<number>, colNum?: Omittable<number>, areaNum?: Omittable<number, 0>): any;
+export declare function INDEX(array: Flatten<IRange>, rowNum: Omittable<number>, colNum?: Omittable<number | undefined, 0>, areaNum?: Omittable<number, 0>): any;
 /**
- * @summary Returns the reference specified by a text string.
+ * Returns the reference specified by a text string.
  * @param refText is a reference to a cell that contains an A1- or R1C1-style reference, a name defined as a reference, or a reference to a cell as a text string.
  * @param a1 is a logical value that specifies the type of reference in refText: R1C1-style = FALSE; A1-style = TRUE.
  */
 export declare function INDIRECT(refText: string, a1?: boolean): IReferenceRange;
 /**
- * @summary Looks up a value either from a one-row or one-column range or from an array. Provided for backward compatibility.
+ * Looks up a value either from a one-row or one-column range or from an array. Provided for backward compatibility.
  * @param lookupValue is a value that LOOKUP searches for in lookupVector and can be a number, text, a logical value, or a name or reference to a value.
  * @param lookupVector is a range that contains only one row or one column of text, numbers, or logical values, placed in ascending order.
  * @param resultVector is a range that contains only one row or column, the same size as lookupVector.
  */
-export declare function LOOKUP(lookupValue: Scalar, lookupVector: AcceptRefError<IRange>, resultVector?: Omittable<AcceptError<IRange> | null, null>): Scalar;
+export declare function LOOKUP(lookupValue: Scalar, lookupVector: Flatten<IRange>, resultVector?: Omittable<IRange | null, null>): Scalar;
 /**
- * @summary Returns the relative position of an item in an array that matches a specified value in a specified order.
+ * How MATCH compares the lookup value with the values in the array.
+ *
+ * @remarks
+ * Declared `ReportType`, as every numeric built-in enum is: the body keeps the verdict. It reads the
+ * argument by its SIGN; what Excel does with a value outside the set is not measured.
+ */
+declare enum MatchType {
+    /**
+     * The largest value that is less than or equal to the lookup value. The array must be sorted in ascending order.
+     * @name Less than
+     */
+    LessThan = 1,
+    /**
+     * The first value that is exactly equal to the lookup value. The array can be in any order.
+     * @name Exact match
+     */
+    Exact = 0,
+    /**
+     * The smallest value that is greater than or equal to the lookup value. The array must be sorted in descending order.
+     * @name Greater than
+     */
+    GreaterThan = -1
+}
+/**
+ * Returns the relative position of an item in an array that matches a specified value in a specified order.
  * @param lookupValue is the value you use to find the value you want in the array, a number, text, or logical value, or a reference to one of these.
  * @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: Scalar, lookupArray: Flatten<IRange>, matchType?: Omittable<ReportType<MatchType>, 0>): Scalar;
 /**
- * @summary Returns a reference to a range that is a given number of rows and columns from a given reference.
+ * 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.
  * @param rows is the number of rows, up or down, that you want the upper-left cell of the result to refer to.
  * @param cols is the number of columns, to the left or right, that you want the upper-left cell of the result to refer to.
  * @param height is the height, in number of rows, that you want the result to be, the same height as Reference if omitted.
  * @param width is the width, in number of columns, that you want the result to be, the same width as Reference if omitted.
  */
-export declare function OFFSET(reference: AcceptError<IReferenceRange>, rows: number, cols: number, height?: Omittable<number>, width?: Omittable<number>): IReferenceRange;
+export declare function OFFSET(reference: IReferenceRange, rows: number, cols: number, height?: Omittable<number>, width?: Omittable<number>): IReferenceRange;
 /**
- * @summary Returns the row number of a reference.
+ * Returns the row number of a reference.
  * @param reference is the cell or a single range of cells for which you want the row number; if omitted, returns the cell containing the ROW function.
+ * @returnKind number
  */
-export declare function ROW(reference?: AcceptError<IReferenceRange>): number[] | number[][];
+export declare function ROW(reference?: Flatten<IReferenceRange>): number[] | number[][];
 /**
- * @summary Returns the number of rows in a reference or array.
+ * Returns the number of rows in a reference or array.
  * @param array is an array, an array formula, or a reference to a range of cells for which you want the number of rows.
  */
-export declare function ROWS(array: AcceptRefError<IRange>): number;
+export declare function ROWS(array: Flatten<IRange>): number | FormulaError.Known;
 /**
+ * Retrieves the real-time data (RTD) from a program that supports COM automation.
  * @hidden Unimplemented Connectivity
- * @summary Retrieves the real-time data (RTD) from a program that supports COM automation.
  * @param progId is the programmatic identifier (ProgID) of a registered COM automation add-in. Enclose the id in quotation marks.
  * @param server is the name of the server that provides the real-time data. If running locally us an empty string.
  * @param topic are 1 to 38 parameters that specify a piece of data.
  */
 export declare function RTD(progId: string, server: string, topic: string[]): Scalar;
 /**
- * @summary Sorts a range or array.
+ * Sorts a range or array.
  * @param array the range or array to sort.
  * @param sortIndex a number indicating the row or column to sort by.
  * @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: IRange | Scalar, sortIndex?: Omittable<IRange>, sortOrder?: Omittable<IRange<ReportType<SortOrder>>>, byCol?: boolean): IRange;
 /**
- * @summary Sorts a range or array based on the values in a corresponding range or array.
+ * The direction SORT and SORTBY sort a key in.
+ *
+ * @remarks
+ * Declared `ReportType`, as every numeric built-in enum is: Excel FLOORS this argument (`1.5` sorts
+ * ascending, `-1.5` is #VALUE!), which an enum's gate does not, so `_sortOrders` keeps the verdict.
+ * SORT takes an array of orders, one per key, so its slot is `IRange<ReportType<SortOrder>>`.
+ */
+declare enum SortOrder {
+    /**
+     * Smallest to largest.
+     * @name Ascending
+     */
+    Ascending = 1,
+    /**
+     * Largest to smallest.
+     * @name Descending
+     */
+    Descending = -1
+}
+/**
+ * Sorts a range or array based on the values in a corresponding range or array.
  * @param array the range or array to sort.
  * @param by the ranges to sort on and the direction for each.
  * @param by.byArray the range or array to sort on.
  * @param by.sortOrder a number indicating the desired sort order; 1 for ascending order (default), -1 for descending order.
  */
-export declare function SORTBY(array: AcceptError<IRange>, by: Repeating<[byArray: AcceptRefError<IRange>, sortOrder?: Omittable<number>]>): IRange;
+export declare function SORTBY(array: IRange | Scalar, by: Repeating<[byArray: IRange, sortOrder?: Omittable<ReportType<SortOrder>>], 254>): IRange;
 /**
- * @summary Returns rows or columns from array start or end.
+ * Returns rows or columns from array start or end.
  * @param array The array from which to take rows or columns.
  * @param rows The number of rows to take. A negative value takes from the end of the array.
  * @param columns The number of columns to take. A negative value takes from the end of the array.
  */
-export declare function TAKE(array: AcceptError<IRange>, rows: number, columns?: number): IRange;
+export declare function TAKE(array: IRange, rows: Omittable<number>, columns?: Omittable<number>): IReferenceRange;
 /**
- * @summary Returns the array as one column.
+ * Which values to leave out.
+ *
+ * @remarks
+ * Declared `ReportType`: Excel TRUNCATES this argument on the way in (`TOCOL(a,1.9)` reads 1 and
+ * `3.9` reads 3, measured), which an enum's gate does not, so the body keeps the verdict.
+ */
+declare enum IgnoreValues {
+    /**
+     * Keep every value, blanks and errors included.
+     * @name Keep all values
+     */
+    KeepAll = 0,
+    /**
+     * Leave out blank cells.
+     * @name Ignore blanks
+     */
+    Blanks = 1,
+    /**
+     * Leave out error values.
+     * @name Ignore errors
+     */
+    Errors = 2,
+    /**
+     * Leave out blank cells and error values.
+     * @name Ignore blanks and errors
+     */
+    BlanksAndErrors = 3
+}
+/**
+ * Returns the array as one column.
  * @param array The array or reference to return as a column.
- * @param {'0 - Keep all values' | '1 - Ignore Blanks' | '2 - Ignore Errors' | '3 - Ignore Blanks and Errors'} ignore Whether to ignore certain types of values. By default, no values are ignored.
+ * @param ignore Whether to ignore certain types of values. By default, no values are ignored.
  * @param scanByColumn Scan the array by column. By default, the array is scanned by row.
  */
-export declare function TOCOL(array: AcceptError<IRange>, ignore?: number, scanByColumn?: boolean): IRange;
+export declare function TOCOL(array: Flatten<IRange>, ignore?: ReportType<IgnoreValues>, scanByColumn?: boolean): IRange;
 /**
- * @summary Returns the array as one row.
+ * Returns the array as one row.
  * @param array The array or reference to return as a row.
- * @param {'0 - Keep all values' | '1 - Ignore Blanks' | '2 - Ignore Errors' | '3 - Ignore Blanks and Errors'} ignore Whether to ignore certain types of values. By default, no values are ignored.
+ * @param ignore Whether to ignore certain types of values. By default, no values are ignored.
  * @param scanByColumn Scan the array by column. By default, the array is scanned by row.
  */
-export declare function TOROW(array: AcceptError<IRange>, ignore?: number, scanByColumn?: boolean): IRange;
+export declare function TOROW(array: Flatten<IRange>, ignore?: ReportType<IgnoreValues>, scanByColumn?: boolean): IRange;
 /**
- * @summary Converts a vertical range of cells to a horizontal range, or vice versa.
+ * Converts a vertical range of cells to a horizontal range, or vice versa.
  * @param array is a range of cells on a worksheet or an array of values that you want to transpose.
  */
-export declare function TRANSPOSE(array: AcceptError<IRange>): IRange;
+export declare function TRANSPOSE(array: IRange): IRange;
 /**
- * @summary Trims a range to the last used cell in any direction.
+ * Trims a range to the last used cell in any direction.
  * @param range The range to be trimmed.
  * @param rowTrimMode Row trim direction. 0 - none, 1 - leading, 2 - trailing, 3 - both.
  * @param colTrimMode Column trim direction. 0 - none. 1 - leading, 2 - trailing, 3 - both.
  */
-export declare function TRIMRANGE(range: AcceptError<IRange>, rowTrimMode?: Omittable<number>, colTrimMode?: Omittable<number>): IRange;
+export declare function TRIMRANGE(range: IRange, rowTrimMode?: Omittable<number>, colTrimMode?: Omittable<number>): IReferenceRange;
 /**
- * @summary Returns the unique values from a range or array.
+ * Returns the unique values from a range or array.
  * @param array the range or array from which to return unique rows or columns.
  * @param byCol is a logical value: compare rows against each other and return the unique rows = FALSE; compare columns against each other and return the unique columns = TRUE.
  * @param exactlyOnce is a logical value: return rows or columns that occur exactly once from the array = TRUE; return all distinct rows or columns from the array = FALSE.
  */
-export declare function UNIQUE(array: AcceptError<IRange>, byCol?: boolean, exactlyOnce?: boolean): IRange;
+export declare function UNIQUE(array: IRange | Scalar, byCol?: boolean, exactlyOnce?: boolean): IRange;
 /**
- * @summary Looks for a value in the leftmost column of a table, and then returns a value in the same row from a column you specify. By default, the table must be sorted in an ascending order.
+ * Looks for a value in the leftmost column of a table, and then returns a value in the same row from a column you specify. By default, the table must be sorted in an ascending order.
  * @param lookupValue is the value to be found in the first column of the table, and can be a value, a reference, or a text string.
  * @param tableArray is a table of text, numbers, or logical values, in which data is retrieved. tableArray can be a reference to a range or a range name.
  * @param colIndexNum is the column number in tableArray from which the matching value should be returned. The first column of values in the table is column 1.
  * @param rangeLookup is a logical value: to find the closest match in the first column (sorted in ascending order) = TRUE; find an exact match = FALSE.
  */
-export declare function VLOOKUP(lookupValue: Scalar, tableArray: AcceptRefError<IRange>, colIndexNum: number, rangeLookup?: boolean): Scalar;
+export declare function VLOOKUP(lookupValue: Scalar, tableArray: Flatten<IRange>, colIndexNum: number, rangeLookup?: boolean): Scalar;
 /**
- * @summary Vertically stacks arrays into one array.
+ * Vertically stacks arrays into one array.
  * @param array An array or reference to be stacked.
  */
-export declare function VSTACK(array: AcceptError<IRange>[]): IRange;
+export declare function VSTACK(array: Repeating<IRange, 254>): IRange;
 /**
- * @summary Wraps a row or column vector after a specified number of values.
+ * Wraps a row or column vector after a specified number of values.
  * @param vector The vector or reference to wrap.
  * @param wrapCount The maximum number of values per column.
  * @param padWith The value with which to pad. The default is #N/A.
  */
-export declare function WRAPCOLS(vector: AcceptError<IRange>, wrapCount: number, padWith?: Omittable<AcceptError<Scalar>>): IRange;
+export declare function WRAPCOLS(vector: IRange | Scalar, wrapCount: number, padWith?: Omittable<AcceptError<Scalar>>): IRange;
 /**
- * @summary Wraps a row or column vector after a specified number of values.
+ * Wraps a row or column vector after a specified number of values.
  * @param vector The vector or reference to wrap.
  * @param wrapCount The maximum number of values per row.
  * @param padWith The value with which to pad. The default is #N/A.
  */
-export declare function WRAPROWS(vector: AcceptError<IRange>, wrapCount: number, padWith?: Omittable<AcceptError<Scalar>>): IRange;
+export declare function WRAPROWS(vector: IRange | Scalar, wrapCount: number, padWith?: Omittable<AcceptError<Scalar>>): IRange;
 /**
- * @summary Searches a range or an array for a match and returns the corresponding item from a second range or array. By default, an exact match is used.
+ * How XLOOKUP and XMATCH match the lookup value.
+ *
+ * @remarks
+ * Declared `ReportType`, as every numeric built-in enum is: the body keeps the verdict (anything
+ * else is #VALUE!). Excel's out-of-set behavior is not measured.
+ */
+declare enum MatchMode {
+    /**
+     * Only an item equal to the lookup value.
+     * @name Exact match
+     */
+    Exact = 0,
+    /**
+     * An item equal to the lookup value, or else the next smaller item.
+     * @name Exact match or next smaller item
+     */
+    ExactOrSmaller = -1,
+    /**
+     * An item equal to the lookup value, or else the next larger item.
+     * @name Exact match or next larger item
+     */
+    ExactOrLarger = 1,
+    /**
+     * The lookup value may use *, ? and ~ as wildcards.
+     * @name Wildcard character match
+     */
+    Wildcard = 2
+}
+/**
+ * The order in which XLOOKUP and XMATCH search.
+ *
+ * @remarks
+ * Declared `ReportType`, as every numeric built-in enum is: the body keeps the verdict (anything
+ * else is #VALUE!). Excel's out-of-set behavior is not measured.
+ */
+declare enum SearchMode {
+    /**
+     * Search from the first item to the last.
+     * @name Search first-to-last
+     */
+    FirstToLast = 1,
+    /**
+     * Search from the last item to the first.
+     * @name Search last-to-first
+     */
+    LastToFirst = -1,
+    /**
+     * A binary search of items sorted in ascending order.
+     * @name Binary search (sorted ascending order)
+     */
+    BinaryAscending = 2,
+    /**
+     * A binary search of items sorted in descending order.
+     * @name Binary search (sorted descending order)
+     */
+    BinaryDescending = -2
+}
+/**
+ * Searches a range or an array for a match and returns the corresponding item from a second range or array. By default, an exact match is used.
  * @param lookupValue is the value to search for.
  * @param lookupArray is the array or range to search.
  * @param returnArray is the array or range to return.
@@ -284,13 +409,14 @@ 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: Scalar, lookupArray: Flatten<IRange>, returnArray: Flatten<IRange>, ifNotFound?: Omittable<AcceptError<Scalar>>, matchMode?: ReportType<MatchMode>, searchMode?: Omittable<ReportType<SearchMode>>): IReferenceRange;
 /**
- * @summary Returns the relative position of an item in an array. By default, an exact match is required.
+ * 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.
  * @param lookupArray is the array or range to search.
  * @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: Scalar, lookupArray: Flatten<IRange>, matchMode?: ReportType<MatchMode>, searchMode?: Omittable<ReportType<SearchMode>>): Scalar;
+export {};
 //# sourceMappingURL=Reference.d.ts.map