@sheetxl/formulas 0.7.26 → 0.7.28-beta.1

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

@@ -0,0 +1,139 @@
+import { AcceptError, Scalar, Flatten, Omittable } from '@sheetxl/primitives';
+/**
+ * @summary Returns the number that represents the date in date-time code.
+ * @param year is a number from 1900 or 1904 (depending on the workbook's date system) to 9999.
+ * @param month is a number from 1 to 12 representing the month of the year.
+ * @param day is a number from 1 to 31 representing the day of the month.
+ */
+export declare function DATE(year: number, month: number, day: number): number;
+/**
+ * @summary Converts a date in the form of text to a number that represents the date as a date-time code.
+ * @param dateText is text that represents a date in date format, between 1/1/1900 or 1/1/1904 (depending on the workbook's date system) and 12/31/9999.
+ */
+export declare function DATEVALUE(dateText: string): number;
+/**
+ * @summary Returns the day of the month, a number from 1 to 31.
+ * @param serialNumber is a number in the date-time code or text in time format, such as 16:48:00 or 4:48:00 PM.
+ */
+export declare function DAY(serialNumber: number): number;
+/**
+ * @summary Returns the number of days between the two dates.
+ * @param endDate startDate and endDate are the two dates between which you want to know the number of days.
+ * @param startDate startDate and endDate are the two dates between which you want to know the number of days.
+ */
+export declare function DAYS(endDate: number, // date
+startDate: number): number;
+/**
+ * @summary Returns the serial number of the date that is the indicated number of months before or after the start date.
+ * @param startDate is a serial date number that represents the start date.
+ * @param months is the number of months before or after startDate.
+ */
+export declare function EDATE(startDate: Scalar, months: Scalar): number;
+/**
+ * @summary Returns the serial number of the last day of the month before or after a specified number of months.
+ * @param startDate is a serial date number that represents the start date.
+ * @param months is the number of months before or after the startDate.
+ */
+export declare function EOMONTH(startDate: Scalar, months: Scalar): number;
+/**
+ * @summary Returns the hour as a number from 0 (12:00 A.M.) to 23 (11:00 P.M.).
+ * @param serialNumber is a number in the date-time code or text in time format, such as 16:48:00 or 4:48:00 PM.
+ */
+export declare function HOUR(serialNumber: number): number;
+/**
+ * @summary Returns the ISO week number in the year for a given date.
+ * @param date is a number in the date-time code or text in time format, such as 16:48:00 or 4:48:00 PM.
+ */
+export declare function ISOWEEKNUM(date: number): number;
+/**
+ * @summary Returns the minute, a number from 0 to 59.
+ * @param serialNumber is a number in the date-time code or text in time format, such as 16:48:00 or 4:48:00 PM.
+ */
+export declare function MINUTE(serialNumber: number): number;
+/**
+ * @summary Returns the month, a number from 1 (January) to 12 (December).
+ * @param serialNumber is a number in the date-time code or text in date format.
+ */
+export declare function MONTH(serialNumber: number): number;
+/**
+ * @summary Returns the number of whole workdays between two dates.
+ * @param startDate is a serial date number that represents the start date.
+ * @param endDate is a serial date number that represents the end date.
+ * @param holidays is an optional set of one or more serial date numbers to exclude from the working calendar, such as state and federal holidays and floating holidays.
+ */
+export declare function NETWORKDAYS(startDate: number, // date
+endDate: number, // date
+holidays?: Omittable<Flatten<Scalar>>): number;
+/**
+ * @name NETWORKDAYS.INTL
+ * @summary Returns the number of whole workdays between two dates with custom weekend parameters.
+ * @param startDate is a serial date number that represents the start date.
+ * @param endDate is a serial date number that represents the end date.
+ * @param weekend is a number or string specifying when weekends occur.
+ * @param holidays is an optional set of one or more serial date numbers to exclude from the working calendar, such as state and federal holidays and floating holidays.
+ */
+export declare function NETWORKDAYS_INTL(startDate: number, // date
+endDate: number, // date
+weekend?: Omittable<AcceptError<Scalar>>, holidays?: Omittable<Flatten<Scalar>>): number;
+/**
+ * @summary Returns the current date and time formatted as a date and time.
+ */
+export declare function NOW(): number;
+/**
+ * @summary Returns the second, a number from 0 to 59.
+ * @param serialNumber is a number in the date-time code or text in time format, such as 16:48:23 or 4:48:47 PM.
+ */
+export declare function SECOND(serialNumber: number): number;
+/**
+ * @summary Converts hours, minutes, and seconds given as numbers to a date code, formatted with a time format.
+ * @param hour is a number from 0 to 23 representing the hour.
+ * @param minute is a number from 0 to 59 representing the minute.
+ * @param second is a number from 0 to 59 representing the second.
+ */
+export declare function TIME(hour: number, minute: number, second: number): number;
+/**
+ * @summary Converts a text time to a date code for a time, a number from 0 (12:00:00 AM) to 0.999988426 (11:59:59 PM). Format the number with a time format after entering the formula.
+ * @param timeText is a text string that gives a time in any one of the time formats (date information in the string is ignored).
+ */
+export declare function TIMEVALUE(timeText: string): number;
+/**
+ * @summary Returns the current date formatted as a date.
+ */
+export declare function TODAY(): number;
+/**
+ * @summary Returns a number from 1 to 7 identifying the day of the week of a date.
+ * @param serialNumber is a number that represents a date.
+ * @param returnType is a number: for Sunday=1 through Saturday=7, use 1; for Monday=1 through Sunday=7, use 2; for Monday=0 through Sunday=6, use 3.
+ */
+export declare function WEEKDAY(serialNumber: number, // date
+returnType?: number): number;
+/**
+ * @summary Returns the week number in the year.
+ * @param serialNumber is the date-time code used for date and time calculation.
+ * @param returnType is a number (1 or 2) that determines the type of the return value.
+ */
+export declare function WEEKNUM(serialNumber: Omittable<Scalar>, returnType?: Omittable<Scalar>): number;
+/**
+ * @summary Returns the serial number of the date before or after a specified number of workdays.
+ * @param startDate is a serial date number that represents the start date.
+ * @param days is the number of nonweekend and non-holiday days before or after startDate.
+ * @param holidays is an optional array of one or more serial date numbers to exclude from the working calendar, such as state and federal holidays and floating holidays.
+ */
+export declare function WORKDAY(startDate: number, // date
+days: number, holidays?: Omittable<Flatten<Scalar>>): number;
+/**
+ * @name WORKDAY.INTL
+ * @summary Returns the serial number of the date before or after a specified number of workdays with custom weekend parameters.
+ * @param startDate is a serial date number that represents the start date.
+ * @param days is the number of nonweekend and non-holiday days before or after startDate.
+ * @param weekend is a number or string specifying when weekends occur.
+ * @param holidays is an optional array of one or more serial date numbers to exclude from the working calendar, such as state and federal holidays and floating holidays.
+ */
+export declare function WORKDAY_INTL(startDate: number, // date
+days: number, weekend?: Omittable<AcceptError<Scalar>>, holidays?: Omittable<Flatten<Scalar>>): number;
+/**
+ * @summary Returns the year of a date, an integer in the range 1900 - 9999.
+ * @param serialNumber is a number in the date-time code used for date and time calculation.
+ */
+export declare function YEAR(serialNumber: number): number;
+//# sourceMappingURL=Date.d.ts.map

package/types/src/engineering/Bessel.d.ts

@@ -0,0 +1,26 @@
+import { Scalar } from '@sheetxl/primitives';
+/**
+ * @summary Returns the modified Bessel function In(x).
+ * @param x is the value at which to evaluate the function.
+ * @param n is the order of the Bessel function.
+ */
+export declare function BESSELI(x: Scalar, n: Scalar): number;
+/**
+ * @summary Returns the Bessel function Jn(x).
+ * @param x is the value at which to evaluate the function.
+ * @param n is the order of the Bessel function.
+ */
+export declare function BESSELJ(x: Scalar, n: Scalar): number;
+/**
+ * @summary Returns the modified Bessel function Kn(x).
+ * @param x is the value at which to evaluate the function.
+ * @param n is the order of the function.
+ */
+export declare function BESSELK(x: Scalar, n: Scalar): number;
+/**
+ * @summary Returns the Bessel function Yn(x).
+ * @param x is the value at which to evaluate the function.
+ * @param n is the order of the function.
+ */
+export declare function BESSELY(x: Scalar, n: Scalar): number;
+//# sourceMappingURL=Bessel.d.ts.map

package/types/src/engineering/Bitwise.d.ts

@@ -0,0 +1,101 @@
+import { AcceptError, Scalar } from '@sheetxl/primitives';
+/**
+ * @summary Converts a binary number to decimal.
+ * @param number is the binary number you want to convert.
+ */
+export declare function BIN2DEC(number: Scalar): number;
+/**
+ * @summary Converts a binary number to hexadecimal.
+ * @param number is the binary number you want to convert.
+ * @param places is the number of characters to use.
+ */
+export declare function BIN2HEX(number: AcceptError<Scalar>, places?: AcceptError<Scalar>): string;
+/**
+ * @summary Converts a binary number to octal.
+ * @param number is the binary number you want to convert.
+ * @param places is the number of characters to use.
+ */
+export declare function BIN2OCT(number: AcceptError<Scalar>, places?: AcceptError<Scalar>): string;
+/**
+ * @summary Returns a bitwise 'And' of two numbers.
+ * @param number1 is the decimal representation of the binary number you want to evaluate.
+ * @param number2 is the decimal representation of the binary number you want to evaluate.
+ */
+export declare function BITAND(number1: Scalar, number2: Scalar): number;
+/**
+ * @summary Returns a number shifted left by shiftAmount bits.
+ * @param number is the decimal representation of the binary number you want to evaluate.
+ * @param shiftAmount is the number of bits that you want to shift Number left by.
+ */
+export declare function BITLSHIFT(number: Scalar, shiftAmount: Scalar): number;
+/**
+ * @summary Returns a bitwise 'Or' of two numbers.
+ * @param number1 is the decimal representation of the binary number you want to evaluate.
+ * @param number2 is the decimal representation of the binary number you want to evaluate.
+ */
+export declare function BITOR(number1: Scalar, number2: Scalar): number;
+/**
+ * @summary Returns a number shifted right by shiftAmount bits.
+ * @param number is the decimal representation of the binary number you want to evaluate.
+ * @param shiftAmount is the number of bits that you want to shift Number left by.
+ */
+export declare function BITRSHIFT(number: Scalar, shiftAmount: Scalar): number;
+/**
+ * @summary Returns a bitwise 'Exclusive Or' of two numbers.
+ * @param number1 is the decimal representation of the binary number you want to evaluate.
+ * @param number2 is the decimal representation of the binary number you want to evaluate.
+ */
+export declare function BITXOR(number1: Scalar, number2: Scalar): number;
+/**
+ * @summary Converts a decimal number to binary.
+ * @param number is the decimal integer you want to convert.
+ * @param places is the number of characters to use.
+ */
+export declare function DEC2BIN(number: AcceptError<Scalar>, places?: AcceptError<Scalar>): string;
+/**
+ * @summary Converts a decimal number to hexadecimal.
+ * @param number is the decimal integer you want to convert.
+ * @param places is the number of characters to use.
+ */
+export declare function DEC2HEX(number: AcceptError<Scalar>, places?: AcceptError<Scalar>): string;
+/**
+ * @summary Converts a decimal number to octal.
+ * @param number is the decimal integer you want to convert.
+ * @param places is the number of characters to use.
+ */
+export declare function DEC2OCT(number: AcceptError<Scalar>, places?: AcceptError<Scalar>): string;
+/**
+ * @summary Converts a Hexadecimal number to binary.
+ * @param number is the hexadecimal number you want to convert.
+ * @param places is the number of characters to use.
+ */
+export declare function HEX2BIN(number: AcceptError<string>, places?: AcceptError<Scalar>): string | number;
+/**
+ * @summary Converts a hexadecimal number to decimal.
+ * @param number is the hexadecimal number you want to convert.
+ */
+export declare function HEX2DEC(number: string): number;
+/**
+ * @summary Converts a hexadecimal number to octal.
+ * @param number is the hexadecimal number you want to convert.
+ * @param places is the number of characters to use.
+ */
+export declare function HEX2OCT(number: AcceptError<string>, places?: AcceptError<Scalar>): string;
+/**
+ * @summary Converts an octal number to binary.
+ * @param number is the octal number you want to convert.
+ * @param places is the number of characters to use.
+ */
+export declare function OCT2BIN(number: AcceptError<string>, places?: AcceptError<Scalar>): string;
+/**
+ * @summary Converts an octal number to decimal.
+ * @param number is the octal number you want to convert.
+ */
+export declare function OCT2DEC(number: string): number;
+/**
+ * @summary Converts an octal number to hexadecimal.
+ * @param number is the octal number you want to convert.
+ * @param places is the number of characters to use.
+ */
+export declare function OCT2HEX(number: AcceptError<string>, places?: AcceptError<Scalar>): string | number;
+//# sourceMappingURL=Bitwise.d.ts.map

package/types/src/engineering/Convert.d.ts

@@ -0,0 +1,9 @@
+import { Scalar } from '@sheetxl/primitives';
+/**
+ * @summary Converts a number from one measurement system to another.
+ * @param number is the value in fromUnit to convert.
+ * @param fromUnit is the units for number.
+ * @param toUnit is the units for the result.
+ */
+export declare function CONVERT(number: Scalar, fromUnit: string, toUnit: string): number;
+//# sourceMappingURL=Convert.d.ts.map

package/types/src/engineering/Engineering.d.ts

@@ -0,0 +1,14 @@
+import { AcceptError, Scalar } from '@sheetxl/primitives';
+/**
+ * @summary Tests whether two numbers are equal.
+ * @param number1 is the first number.
+ * @param number2 is the second number.
+ */
+export declare function DELTA(number1: AcceptError<Scalar>, number2?: AcceptError<Scalar>): number;
+/**
+ * @summary Tests whether a number is greater than a threshold value.
+ * @param number is the value to test against step.
+ * @param step is the threshold value.
+ */
+export declare function GESTEP(number: AcceptError<Scalar>, step?: AcceptError<Scalar>): number;
+//# sourceMappingURL=Engineering.d.ts.map

package/types/src/engineering/Error.d.ts

@@ -0,0 +1,25 @@
+import { Scalar } from '@sheetxl/primitives';
+/**
+ * @summary Returns the error function.
+ * @param lowerLimit is the lower bound for integrating ERF.
+ * @param upperLimit is the upper bound for integrating ERF.
+ */
+export declare function ERF(lowerLimit: Scalar, upperLimit?: Scalar): number;
+/**
+ * @name ERF.PRECISE
+ * @summary Returns the error function.
+ * @param x is the lower bound for integrating ERF.PRECISE.
+ */
+export declare function ERF_PRECISE(x: Scalar): number;
+/**
+ * @summary Returns the complementary error function.
+ * @param x is the lower bound for integrating ERF.
+ */
+export declare function ERFC(x: Scalar): number;
+/**
+ * @name ERFC.PRECISE
+ * @summary Returns the complementary error function.
+ * @param x is the lower bound for integrating ERF.
+ */
+export declare function ERFC_PRECISE(x: Scalar): number;
+//# sourceMappingURL=Error.d.ts.map

package/types/src/engineering/Imaginary.d.ts

@@ -0,0 +1,155 @@
+import { AcceptError, Scalar } from '@sheetxl/primitives';
+/**
+ * @summary Converts real and imaginary coefficients into a complex number.
+ * @param realNum is the real coefficient of the complex number.
+ * @param iNum is the imaginary coefficient of the complex number.
+ * @param suffix is the suffix for the imaginary component of the complex number.
+ */
+export declare function COMPLEX(realNum: AcceptError<Scalar>, iNum: AcceptError<Scalar>, suffix?: AcceptError<string>): Scalar;
+/**
+ * @summary Returns the absolute value (modulus) of a complex number
+ * @param inumber is a complex number for which you want the absolute value
+ */
+export declare function IMABS(inumber: Scalar): number;
+/**
+ * @summary Returns the imaginary coefficient of a complex number
+ * @param inumber is a complex number for which you want the imaginary coefficient
+ */
+export declare function IMAGINARY(inumber: Scalar): number;
+/**
+ * @summary Returns the argument q, an angle expressed in radians
+ * @param inumber is a complex number for which you want the argument
+ */
+export declare function IMARGUMENT(inumber: Scalar): number;
+/**
+ * @summary Returns the complex conjugate of a complex number
+ * @param inumber is a complex number for which you want the conjugate
+ */
+export declare function IMCONJUGATE(inumber: Scalar): Scalar;
+/**
+ * @summary Returns the cosine of a complex number
+ * @param inumber is a complex number for which you want the cosine
+ */
+export declare function IMCOS(inumber: Scalar): Scalar;
+/**
+ * @summary Returns the hyperbolic cosine of a complex number
+ * @param inumber is a complex number for which you want the hyperbolic cosine
+ */
+export declare function IMCOSH(inumber: Scalar): Scalar;
+/**
+ * @summary Returns the cotangent of a complex number
+ * @param inumber is a complex number for which you want the cotangent
+ */
+export declare function IMCOT(inumber: Scalar): Scalar;
+/**
+ * @summary Returns the hyperbolic cotangent of a complex number.
+ * @param inumber is a complex number for which you want the hyperbolic cotangent.
+ * @category Sheets
+ */
+export declare function IMCOTH(inumber: Scalar): Scalar;
+/**
+ * @summary Returns the cosecant of a complex number
+ * @param inumber is a complex number for which you want the cosecant
+ */
+export declare function IMCSC(inumber: Scalar): Scalar;
+/**
+ * @summary Returns the hyperbolic cosecant of a complex number
+ * @param inumber is a complex number for which you want the hyperbolic cosecant
+ */
+export declare function IMCSCH(inumber: Scalar): Scalar;
+/**
+ * @summary Returns the quotient of two complex numbers
+ * @param inumber1 is the complex numerator or dividend
+ * @param inumber2 is the complex denominator or divisor
+ */
+export declare function IMDIV(inumber1: Scalar, inumber2: Scalar): Scalar;
+/**
+ * @summary Returns the exponential of a complex number
+ * @param inumber is a complex number for which you want the exponential
+ */
+export declare function IMEXP(inumber: Scalar): Scalar;
+/**
+ * @summary Returns the exponential of a complex number
+ * @param inumber is a complex number for which you want the exponential
+ */
+export declare function IMLN(inumber: Scalar): Scalar;
+/**
+ * @summary Returns the logarithm of a complex number to a specified base.
+ * @param inumber is a complex number for which you want the logarithm.
+ * @param base is the base of the logarithm. Default is 10.
+ * @category Sheets
+ */
+export declare function IMLOG(inumber: Scalar, base?: number): Scalar;
+/**
+ * @summary Returns the base-10 logarithm of a complex number
+ * @param inumber is a complex number for which you want the common logarithm
+ */
+export declare function IMLOG10(inumber: Scalar): Scalar;
+/**
+ * @summary Returns the base-2 logarithm of a complex number
+ * @param inumber is a complex number for which you want the base-2 logarithm
+ */
+export declare function IMLOG2(inumber: Scalar): Scalar;
+/**
+ * @summary Returns the base-2 logarithm of a complex number
+ * @param inumber is a complex number for which you want the base-2 logarithm
+ */
+export declare function IMPOWER(inumber: Scalar, number: Scalar): Scalar;
+/**
+ * @summary Returns the product of 1 to 255 complex numbers
+ * @param inumber are from 1 to 255 complex numbers to multiply.
+ */
+export declare function IMPRODUCT(inumber: Scalar[]): Scalar;
+/**
+ * @summary Returns the real coefficient of a complex number
+ * @param inumber is a complex number for which you want the real coefficient
+ */
+export declare function IMREAL(inumber: Scalar): number;
+/**
+ * @summary Returns the secant of a complex number
+ * @param inumber is a complex number for which you want the secant
+ */
+export declare function IMSEC(inumber: Scalar): Scalar;
+/**
+ * @summary Returns the hyperbolic secant of a complex number
+ * @param inumber is a complex number for which you want the hyperbolic secant
+ */
+export declare function IMSECH(inumber: Scalar): Scalar;
+/**
+ * @summary Returns the sine of a complex number
+ * @param inumber is a complex number for which you want the sine
+ */
+export declare function IMSIN(inumber: Scalar): Scalar;
+/**
+ * @summary Returns the hyperbolic sine of a complex number
+ * @param inumber is a complex number for which you want the hyperbolic sine
+ */
+export declare function IMSINH(inumber: Scalar): Scalar;
+/**
+ * @summary Returns the square root of a complex number
+ * @param inumber is a complex number for which you want the square root
+ */
+export declare function IMSQRT(inumber: Scalar): Scalar;
+/**
+ * @summary Returns the difference of two complex numbers
+ * @param inumber1 is the complex number from which to subtract inumber2
+ * @param inumber2 is the complex number to subtract from inumber1
+ */
+export declare function IMSUB(inumber1: Scalar, inumber2: Scalar): Scalar;
+/**
+ * @summary Returns the sum of complex numbers
+ * @param inumber are from 1 to 255 complex numbers to add
+ */
+export declare function IMSUM(inumber: Scalar[]): Scalar;
+/**
+ * @summary Returns the tangent of a complex number
+ * @param inumber is a complex number for which you want the tangent
+ */
+export declare function IMTAN(inumber: Scalar): Scalar;
+/**
+ * @summary Returns the hyperbolic tangent of a complex number.
+ * @param inumber is a complex number for which you want the hyperbolic tangent.
+ * @category Sheets
+ */
+export declare function IMTANH(inumber: Scalar): Scalar;
+//# sourceMappingURL=Imaginary.d.ts.map

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

@@ -0,0 +1,166 @@
+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
+ *
+ * @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;
+/**
+ * @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.
+ * @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.
+ * @param value The value to check.
+ * @category Sheets
+ *
+ * @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.
+ *
+ * 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
+ * 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
+ * the referenced cell's NUMBER FORMAT, and that is the parity we cannot reach: a date here is a
+ * number carrying a date format, formats are not exposed to a formula, and the calculation graph
+ * 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.
+ *
+ * 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
+ * both evaluating to a number. That provenance does not survive to a function here either.
+ */
+export declare function ISDATE(value: Scalar): boolean;
+/**
+ * @summary 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.
+ * @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
+ * @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.
+ * @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;
+/**
+ * @summary 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;
+/**
+ * @summary 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.
+ * @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.
+ * @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.
+ * @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.
+ * @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;
+/**
+ * @summary 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;
+/**
+ * @summary 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.
+ * @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.
+ * @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).
+ * @param value is the value to convert.
+ */
+export declare function N(value: AcceptError<Scalar>): Scalar;
+/**
+ * @summary Returns the #N/A error value
+ */
+export declare function NA(): FormulaError.Known;
+/**.
+ * @summary 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;
+/**
+ * @summary 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;
+/**
+ * @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.
+ * @param value is the value to check.
+ */
+export declare function TYPE(value: AcceptError<IRange>): number;
+//# sourceMappingURL=Information.d.ts.map

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

@@ -0,0 +1,15 @@
+import { Scalar } from '@sheetxl/primitives';
+/**
+ * @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;
+/**
+ * @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.
+ */
+export declare function NUMBERSTRING(number: number, number2: number): Scalar;
+//# sourceMappingURL=Date.d.ts.map

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

@@ -0,0 +1,8 @@
+import { Scalar, IReferenceRange } from '@sheetxl/primitives';
+/**
+ * @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;
+//# sourceMappingURL=Text.d.ts.map