@sheetxl/formulas 0.8.0-beta.12 → 0.8.0-beta.13

package/node/esm/{BgSZby_sWDnOsdXg.mjs → nHjWvILCaLRUxxa3.mjs}

@@ -1,5 +1,5 @@
 /**
-* @license @sheetxl/formulas - Formulas - TypeScript formulas compatible with Excel built-ins. - v0.8.0-beta.12
+* @license @sheetxl/formulas - Formulas - TypeScript formulas compatible with Excel built-ins. - v0.8.0-beta.13
 *
 * (C) 2026-present SheetXL Inc. & Michael T. Ford
 * License: The license can be found at https://www.sheetxl.com/license.

package/node/esm/{DZpOzJdF5Aq0XKsk.mjs → ndzPa89HgVLoAmDy.mjs}

@@ -1,5 +1,5 @@
 /**
-* @license @sheetxl/formulas - Formulas - TypeScript formulas compatible with Excel built-ins. - v0.8.0-beta.12
+* @license @sheetxl/formulas - Formulas - TypeScript formulas compatible with Excel built-ins. - v0.8.0-beta.13
 *
 * (C) 2026-present SheetXL Inc. & Michael T. Ford
 * License: The license can be found at https://www.sheetxl.com/license.

package/package.json

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

package/types/src/.generated/decl/web/ImportData.decl.d.ts

@@ -0,0 +1,4 @@
+import { MinifiedDeclarations } from '@sheetxl/scripting';
+declare const declarations: MinifiedDeclarations;
+export default declarations;
+//# sourceMappingURL=ImportData.decl.d.ts.map

package/types/src/.generated/desc/web/ImportData.desc.d.ts

@@ -0,0 +1,4 @@
+import { MinifiedDescriptors } from '@sheetxl/scripting';
+declare const descriptors: MinifiedDescriptors;
+export default descriptors;
+//# sourceMappingURL=ImportData.desc.d.ts.map

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

@@ -0,0 +1,23 @@
+/**
+ * Half-width and full-width conversion for `ASC` and `DBCS`.
+ *
+ * @remarks
+ * Follows Windows `LCMapStringEx` with `LCMAP_HALFWIDTH` / `LCMAP_FULLWIDTH`, which answers the same
+ * under every language with two widths — the only languages under which the conversion applies.
+ *
+ * The rules are the Unicode Halfwidth and Fullwidth Forms block. Two departures come from Windows:
+ * the backslash stays as it is in both directions, and the block's halfwidth arrows, box drawing and
+ * shapes (U+FFE8 to U+FFEE) are not converted. Windows also composes any base and combining mark
+ * going to full width (`e` and U+0301 become U+00E9); only kana and Hangul compose here.
+ */
+/**
+ * Converts every character that has a full-width form to it, then composes what the conversion left
+ * side by side: a kana and its voiced mark become one character, and Hangul letters one syllable.
+ */
+export declare const toFullWidth: (text: string) => string;
+/**
+ * Converts every character that has a half-width form to it. A voiced katakana becomes two
+ * characters, so the result can be longer than `text`.
+ */
+export declare const toHalfWidth: (text: string) => string;
+//# sourceMappingURL=CharWidth.d.ts.map

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

@@ -2,7 +2,7 @@ export declare const normalPdf: (x: number, mean: number, std: number) => number
 /**
  * Taken through `erfc` rather than `1 + erf`: below about `-6` standard deviations the latter is
  * one plus a value one ulp short of minus one, so the whole lower tail cancels away to zero
- * where Excel carries it out to 1E-300.
+ * where it should carry out to 1E-300.
  */
 export declare const normalCdf: (x: number, mean: number, std: number) => number;
 export declare const normalInv: (p: number, mean: number, std: number) => number;
@@ -51,7 +51,7 @@ export declare function poissonPdf(k: number, l: number): number;
  * or a silently truncated tail. Where the walk cannot answer, the complementary regularized
  * gamma is the same function in closed form.
  *
- * The ORDER is the one place this differs from the rest of the category, where Excel accumulates
+ * The ORDER is the one place this differs from the rest of the category, which accumulates
  * forward. It is kept because nothing separates the two orders: only nine of the family's rows
  * move at all and they split between them, and a summation order should not be changed on a
  * coin toss.

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

@@ -1,4 +1,4 @@
-import { Scalar } from '@sheetxl/primitives';
+import { FormulaError, IRange, Scalar } from '@sheetxl/primitives';
 /**
  * Wraps a value-aggregating reduce callback (SUMIF / AVERAGEIF / MAXIFS / …) so an error in a
  * MATCHED member becomes the whole result, while a non-matched one stays invisible.
@@ -11,4 +11,18 @@ import { Scalar } from '@sheetxl/primitives';
  * Count flavors do NOT wrap: `COUNTIF(A1:A3,">1")` counts a matched error member.
  */
 export declare function rejectMatchedError(fn: (accumulator: Scalar, value: Scalar) => Scalar): (accumulator: Scalar, value: Scalar) => Scalar;
+/**
+ * The member error a paired statistic answers with: `#NULL!` and `#GETTING_DATA` read as `#NUM!`.
+ *
+ * Shared by the two-array statistics (`CORREL`, `PEARSON`, `RSQ`, `STEYX`, `COVARIANCE.*`, `SLOPE`,
+ * `INTERCEPT`, `FORECAST`, `SUMX2MY2` and its siblings, `PROB`, `CHISQ.TEST`, `F.TEST`, `T.TEST`).
+ * Which member wins is each function's own scan order; only the kind is mapped. `SUMPRODUCT`,
+ * `SUM` and the one-array statistics keep the error as it is.
+ */
+export declare function pairedMemberError<E extends FormulaError.Known>(error: E): E;
+/**
+ * {@link pairedMemberError} of a range's first error, except at a single-cell REFERENCE: that one
+ * reads as a direct argument and keeps its error (`PROB(A2,C1,1)` is `#NULL!` where A2 is).
+ */
+export declare function pairedRangeError(range: IRange): FormulaError.Known;
 //# sourceMappingURL=Errors.d.ts.map

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

@@ -17,7 +17,7 @@ import { IRange, Scalar } from '@sheetxl/primitives';
  */
 export declare const readFirstOrMembers: <T extends Scalar>(container: IRange, read: (value: Scalar) => T, paramIndex?: number) => T;
 /**
- * The one cell a multi-cell REFERENCE reads as at a slot Excel declares a plain VALUE.
+ * The one cell a multi-cell REFERENCE reads as at a slot declared a plain VALUE.
  *
  * @remarks
  * The choice is the call's implicit-intersection MODE: in VALUE

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

@@ -15,7 +15,7 @@
 /**
  * The determinant, as the signed product of the pivots.
  *
- * The product is a multiplication, so it carries the two rules Excel's multiplying operators do:
+ * The product is a multiplication, so it carries the two rules the multiplying operators do:
  * a subnormal flushes to zero (`MDETERM({1E-160,2E-160;3E-160,4E-160})` is 0, not 2E-320) and an
  * overflow is `#NUM!` rather than an infinity, which is what `NaN` means to the caller.
  */

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

@@ -187,9 +187,9 @@ export declare function TODAY(): Volatile<number>;
  * How WEEKDAY numbers the days of the week.
  *
  * @remarks
- * Declared `ReportType`, as every numeric built-in enum is: Excel TRUNCATES this argument (`2.9`
- * is 2) and answers #NUM! outside the set, which an enum's gate does not, so the body keeps the
- * verdict. Members that mean the same thing share Excel's label (2 and 11, 1 and 17), and so share
+ * Declared `ReportType`, as every numeric built-in enum is: the argument is TRUNCATED (`2.9`
+ * is 2) and is #NUM! outside the set, which an enum's gate does not do, so the body keeps
+ * the verdict. Members that mean the same thing share a label (2 and 11, 1 and 17), and so share
  * one descriptor entry.
  */
 declare enum WeekdayType {

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

@@ -55,7 +55,7 @@ export declare function IFNA(value: AcceptError<Scalar>, valueIfNA: Lazy<AcceptE
  * 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.
+ * left-to-right propagation would refuse the whole call for a condition that is never evaluated.
  */
 export declare function IFS(condition: Repeating<[logicalTest: AcceptError<boolean>, logicalTrue: AcceptError<any>], 254>): any;
 /**

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

@@ -53,8 +53,9 @@ export declare function CHOOSEROWS(array: Flatten<IRange>, rowNum: Repeating<num
 /**
  * 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.
+ * @returnKind number
  */
-export declare function COLUMN(reference?: Flatten<IReferenceRange>): number[];
+export declare function COLUMN(reference?: Flatten<IReferenceRange>): number | number[];
 /**
  * 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.
@@ -164,7 +165,7 @@ export declare function IMAGE(source: string, alternateText?: Omittable<string>,
  * @param areaNum selects the area in Array or Reference from which to return a value. If omitted, the first area is used.
  *
  * @remarks
- * Combines both Excel INDEX functions using optional parameters.
+ * Combines the array and reference forms of INDEX using optional parameters.
  */
 export declare function INDEX(array: Flatten<IRange>, rowNum: Omittable<number>, colNum?: Omittable<number | undefined, 0>, areaNum?: Omittable<number, 0>): any;
 /**
@@ -225,7 +226,7 @@ export declare function OFFSET(reference: IReferenceRange, rows: number, cols: n
  * @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?: Flatten<IReferenceRange>): number[] | number[][];
+export declare function ROW(reference?: Flatten<IReferenceRange>): number | number[] | number[][];
 /**
  * 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.
@@ -251,7 +252,7 @@ export declare function SORT(array: IRange | Scalar, sortIndex?: Omittable<IRang
  * 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
+ * Declared `ReportType`, as every numeric built-in enum is: this argument FLOORS (`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>>`.
  */
@@ -286,7 +287,7 @@ export declare function TAKE(array: IRange, rows: Omittable<number>, columns?: O
  * Which values to leave out.
  *
  * @remarks
- * Declared `ReportType`: Excel TRUNCATES this argument on the way in (`TOCOL(a,1.9)` reads 1 and
+ * Declared `ReportType`: this argument TRUNCATES on the way in (`TOCOL(a,1.9)` reads 1 and
  * `3.9` reads 3), which an enum's gate does not, so the body keeps the verdict.
  */
 declare enum IgnoreValues {

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

@@ -8,8 +8,8 @@ export declare function ABS(number: number): number;
  * The calculation AGGREGATE performs.
  *
  * @remarks
- * Declared `ReportType`, as every numeric built-in enum is: Excel TRUNCATES this argument (`9.9`
- * is SUM), which an enum's gate does not, so the body keeps the verdict. Also the
+ * Declared `ReportType`, as every numeric built-in enum is: the argument is TRUNCATED (`9.9`
+ * is SUM), which an enum's gate does not do, so the body keeps the verdict. Also the
  * overload discriminant: 14-19 take a trailing `k`.
  */
 declare enum AggregateFunction {
@@ -113,8 +113,8 @@ declare enum AggregateFunction {
  * What AGGREGATE leaves out.
  *
  * @remarks
- * Declared `ReportType`, as every numeric built-in enum is: Excel TRUNCATES this argument (`6.9`
- * is 6), which an enum's gate does not, so the body keeps the verdict.
+ * Declared `ReportType`, as every numeric built-in enum is: the argument is TRUNCATED (`6.9`
+ * is 6), which an enum's gate does not do, so the body keeps the verdict.
  */
 declare enum AggregateOptions {
     /**
@@ -596,9 +596,9 @@ export declare function SQRTPI(number: NoLift<Omittable<AcceptError<Scalar>>>):
  * The calculation SUBTOTAL performs; 101-111 leave out hidden rows.
  *
  * @remarks
- * Declared `ReportType`, as every numeric built-in enum is: Excel TRUNCATES this argument (`9.9`
- * is SUM), which an enum's gate does not, so the body keeps the verdict. Excel labels
- * 101-111 with the bare function name, as 1-11; a member name keys the descriptor and the
+ * Declared `ReportType`, as every numeric built-in enum is: the argument is TRUNCATED (`9.9`
+ * is SUM), which an enum's gate does not do, so the body keeps the verdict. 101-111 are
+ * labeled with the bare function name, as 1-11 are; a member name keys the descriptor and the
  * language packs, so each must be unique.
  */
 declare enum SubtotalFunction {

package/types/src/web/ImportData.d.ts

@@ -0,0 +1,26 @@
+import { Scalar, Omittable } from '@sheetxl/primitives';
+/**
+ * Imports data at a given url in .csv (comma-separated value) or .tsv (tab-separated value) format.
+ * @param url the url of the .csv or .tsv data, including protocol (e.g. `http://`).
+ * @param delimiter the single character between fields. It may not be a double quote, or whitespace other than a tab. Default is inferred from the file name: comma for CSV, tab for TSV.
+ * @param locale a language and region locale code to use when parsing the data (`"en_US"`). Default is the workbook's locale.
+ *
+ * @example
+ *  =IMPORTDATA("https://api.covidtracking.com/v1/us/daily.csv")
+ *
+ * @remarks
+ * * The cell shows `#BUSY!` until the data arrives, then spills one row per line.
+ * * Each field is read as if it were typed into a cell: numbers, dates and `TRUE`/`FALSE` become
+ *   values, anything else stays text, and an empty field is blank.
+ * * A url that cannot be fetched is `#N/A`.
+ * * In a browser the server must allow cross-origin requests (CORS), or the workbook's fetcher
+ *   must reach it another way. Otherwise the `#N/A` says the site is restricted.
+ * * A recalculation does not ask again; the data is kept while the workbook is open, and a
+ *   workbook opens with the data it was saved with.
+ *   *Refresh All* does.
+ * * `locale` is accepted for compatibility; fields are read with the workbook's locale.
+ *
+ * @category Sheets
+ */
+export declare function IMPORTDATA(url: string, delimiter?: Omittable<string>, locale?: Omittable<string>): Scalar[][];
+//# sourceMappingURL=ImportData.d.ts.map