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

package/README.md

@@ -32,7 +32,7 @@ volatility tracking, and full UI integration:
 
 ```ts
 /**
- * @summary Returns an array of random numbers.
+ * Returns an array of random numbers.
  * @param rows the number of rows in the returned array.
  * @param columns the number of columns in the returned array.
  * @param min the minimum number you would like returned.
@@ -40,29 +40,22 @@ volatility tracking, and full UI integration:
  * @param integer return an integer or a decimal value. TRUE for an integer, FALSE for a decimal number.
  */
 export function RANDARRAY(
-  rows: number=1,
-  columns: number=1,
-  min: number=0,
-  max: number=1,
-  integer: boolean=false
-): IRange {
-  if (rows === 0 || columns === 0) throw FormulaError.BuiltIn.Calc;
-  if (rows < 0 || columns < 0) throw FormulaError.BuiltIn.Value;
-  if (min > max) throw FormulaError.BuiltIn.NA;
-  const entireCoords = FormulaContext.getEntireCoords();
-  if (rows + 1 > entireCoords.rowEnd || columns + 1 > entireCoords.colEnd) throw FormulaError.BuiltIn.Value;
-
-  FormulaContext.markVolatile();
+  rows: Omittable<number>=1,
+  columns: Omittable<number>=1,
+  min: Omittable<number>=0,
+  max: Omittable<number>=1,
+  integer: Omittable<boolean>=false
+): Volatile<IRange> {
+  if (min > max) return FormulaError.BuiltIn.Value!;
+  const whole = integer === true;
+  if (whole && (min !== Math.trunc(min) || max !== Math.trunc(max))) return FormulaError.BuiltIn.Value!;
 
   return FormulaContext.createRange(rows, columns, (): number => {
-    let randomValue = min + Math.random() * (max - min);
-    // if integer is requested, round the value
-    if (integer) {
-      randomValue = Math.floor(randomValue);
-      // ensure we can actually reach max value (Math.random() is [0,1))
-      if (randomValue > max) randomValue = max;
-    }
-    return randomValue;
+    // the draw is the runtime's, so a host can seed it; never `Math.random`
+    if (!whole) return min + FormulaContext.getRandom() * (max - min);
+    // both ends are inclusive here, and the draw never reaches 1
+    const value = min + Math.floor(FormulaContext.getRandom() * (max - min + 1));
+    return value > max ? max : value;
   });
 };
 ```

package/browser/esm/{BM1YhvA2ppUZ3QLB.mjs → BAu7VttBhgl5A9Ux.mjs}

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

package/{node/esm/CG1Fn8D-2DrQZoD5.mjs → browser/esm/BL3CLO1ngbZPNUSj.mjs}

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

package/{node/esm/-f-RKKojiLg94hp9.mjs → browser/esm/BL5O9xv74605fjZ0.mjs}

@@ -1,5 +1,5 @@
 /**
-* @license @sheetxl/formulas - Formulas - TypeScript formulas compatible with Excel built-ins. - v0.8.0-beta.1
+* @license @sheetxl/formulas - Formulas - TypeScript formulas compatible with Excel built-ins. - v0.8.0-beta.11
 *
 * (C) 2026-present SheetXL Inc. & Michael T. Ford
 * License: The license can be found at https://www.sheetxl.com/license.
@@ -70,15 +70,12 @@ var e = {
 			columns: { d: "The number of columns to drop. A negative value drops from the end of the array." }
 		}
 	},
-	EXPAND: {
-		s: "Expands an array to the specified dimensions.",
-		p: {
-			array: { d: "The array to expand." },
-			row: { d: "The number of rows in the expanded array. If missing, rows will not be expanded." },
-			columns: { d: "The number of columns in the expanded array. If missing, columns will not be expanded." },
-			padWidth: { d: "The value with which to pad. The default is #N/A." }
-		}
-	},
+	EXPAND: { p: {
+		array: {},
+		row: {},
+		columns: {},
+		padWith: {}
+	} },
 	FIELDVALUE: {
 		s: "Extracts a value from a field of a given record.",
 		p: {
@@ -312,5 +309,48 @@ var e = {
 			searchMode: { d: "1=first→last (default), -1=last→first, 2=binary asc, -2=binary desc" }
 		}
 	}
+}, t = {
+	MatchType: {
+		s: "How MATCH compares the lookup value with the values in the array.",
+		m: {
+			"Less than": { d: "The largest value that is less than or equal to the lookup value. The array must be sorted in ascending order." },
+			"Exact match": { d: "The first value that is exactly equal to the lookup value. The array can be in any order." },
+			"Greater than": { d: "The smallest value that is greater than or equal to the lookup value. The array must be sorted in descending order." }
+		}
+	},
+	SortOrder: {
+		s: "The direction SORT and SORTBY sort a key in.",
+		m: {
+			Ascending: { d: "Smallest to largest." },
+			Descending: { d: "Largest to smallest." }
+		}
+	},
+	IgnoreValues: {
+		s: "Which values to leave out.",
+		m: {
+			"Keep all values": { d: "Keep every value, blanks and errors included." },
+			"Ignore blanks": { d: "Leave out blank cells." },
+			"Ignore errors": { d: "Leave out error values." },
+			"Ignore blanks and errors": { d: "Leave out blank cells and error values." }
+		}
+	},
+	MatchMode: {
+		s: "How XLOOKUP and XMATCH match the lookup value.",
+		m: {
+			"Exact match": { d: "Only an item equal to the lookup value." },
+			"Exact match or next smaller item": { d: "An item equal to the lookup value, or else the next smaller item." },
+			"Exact match or next larger item": { d: "An item equal to the lookup value, or else the next larger item." },
+			"Wildcard character match": { d: "The lookup value may use *, ? and ~ as wildcards." }
+		}
+	},
+	SearchMode: {
+		s: "The order in which XLOOKUP and XMATCH search.",
+		m: {
+			"Search first-to-last": { d: "Search from the first item to the last." },
+			"Search last-to-first": { d: "Search from the last item to the first." },
+			"Binary search (sorted ascending order)": { d: "A binary search of items sorted in ascending order." },
+			"Binary search (sorted descending order)": { d: "A binary search of items sorted in descending order." }
+		}
+	}
 };
-export { e as default };
+export { e as default, t as enums };

package/browser/esm/{CVv3DuciDQrnFFeu.mjs → BTOiKBFUYxECGgpN.mjs}

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