@sheetxl/formulas-extended 0.7.28-beta.3 → 0.7.28-beta.4

package/node/esm/{BfPVZqcuHtLRxqLI.mjs → v9tvQuvQYcFQ0zOs.mjs}

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

package/node/esm/{v_larpTXJns5MbG8.mjs → y9VKeU12ARR9HmtI.mjs}

@@ -1,5 +1,5 @@
 /**
-* @license @sheetxl/formulas-extended - Formulas Enterprise - TypeScript formulas compatible with Excel built-ins. - v0.7.28-beta.3
+* @license @sheetxl/formulas-extended - Formulas Enterprise - TypeScript formulas compatible with Excel built-ins. - v0.7.28-beta.4
 *
 * (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-extended",
   "description": "Formulas Enterprise - TypeScript formulas compatible with Excel built-ins.",
-  "version": "0.7.28-beta.3",
+  "version": "0.7.28-beta.4",
   "license": "SEE LICENSE IN <LICENSE>",
   "type": "module",
   "exports": {
@@ -37,7 +37,7 @@
     "formulas"
   ],
   "dependencies": {
-    "@sheetxl/primitives": "^0.7.28-beta.3",
-    "@sheetxl/scripting": "^0.7.28-beta.3"
+    "@sheetxl/primitives": "^0.7.28-beta.4",
+    "@sheetxl/scripting": "^0.7.28-beta.4"
   }
 }

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

@@ -1,3 +1,20 @@
 import { IRuntime } from '@sheetxl/primitives';
 export declare const defaultCurrencyFormat: (runtime: IRuntime) => string;
+/**
+ * `base ^ exponent` as Excel evaluates it (the `^` operator, POWER, and the powers inside the
+ * time-value-of-money functions all agree — measured 2026-08-26, Excel 16.0 build 20326).
+ *
+ * For an INTEGER exponent of magnitude up to 4294967294 (2^32 − 2) Excel does not call a
+ * correctly rounded pow: it multiplies — right-to-left binary exponentiation, a negative exponent
+ * as the reciprocal of the positive power — and the rounding of every intermediate product is
+ * carried into the result. That is invisible at the 15th digit of `(1+r)^n` itself, but a caller
+ * that divides `(1+r)^n − 1` by a small `r` amplifies the last bits: `FV(1E-9,360,-100,-1000)`
+ * agrees with Excel to 8 digits on `Math.pow` and is bit-exact on this form. From 2^32 − 1 up, and
+ * for every non-integer exponent, Excel is `exp(y · ln x)` in double — closer to it than libm pow
+ * on the sensitive rows (`FV(1E-15,12.5,…)` is 2 digits on `Math.pow`, exact here), and equal to
+ * it everywhere else measured.
+ *
+ * A zero base follows the `^` operator: `0^0` is #NUM! and `0^negative` is #DIV/0!.
+ */
+export declare const excelPow: (base: number, exponent: number) => number;
 //# sourceMappingURL=FinanceUtils.d.ts.map

package/types/src/financial/Financial.d.ts

@@ -18,9 +18,7 @@ frequency: number, basis?: number): number;
  * @param endPeriod is the last period in the calculation.
  * @param type is the timing of the payment.
  */
-export declare function CUMIPMT(rate: number, nper: number, pv: number, startPeriod: number, // date
-endPeriod: number, // date
-type: number): number;
+export declare function CUMIPMT(rate: number, nper: number, pv: number, startPeriod: number, endPeriod: number, type: number): number;
 /**
  * @summary Returns the cumulative principal paid on a loan between two periods.
  * @param rate is the interest rate.
@@ -30,9 +28,7 @@ type: number): number;
  * @param endPeriod is the last period in the calculation.
  * @param type is the timing of the payment.
  */
-export declare function CUMPRINC(rate: number, nper: number, pv: number, startPeriod: number, // date
-endPeriod: number, // date
-type: number): number;
+export declare function CUMPRINC(rate: number, nper: number, pv: number, startPeriod: number, endPeriod: number, type: number): number;
 /**
  * @summary Returns the depreciation of an asset for a specified period using the fixed-declining balance method.
  * @param cost is the initial cost of the asset.
@@ -149,7 +145,7 @@ export declare function NPER(rate: number, pmt: number, pv: number, fv?: number,
  * @param rate is the rate of discount over the length of one period.
  * @param value are 1 to 254 payments and income, equally spaced in time and occurring at the end of each period.
  */
-export declare function NPV(rate: number, value: number[]): number;
+export declare function NPV(rate: number, value: IRange<number>[]): number;
 /**
  * @summary Returns the number of periods required by an investment to reach a specified value.
  * @param rate is the interest rate.