@sheetxl/formulas-extended 0.7.28-beta.3 → 0.8.0-beta.1

package/node/esm/{DEQPjlaWWG7gXPtm.mjs → srpVt74r2zbvm1N0.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.8.0-beta.1
 *
 * (C) 2026-present SheetXL Inc. & Michael T. Ford
 * License: The license can be found at https://www.sheetxl.com/license.

package/{browser/esm/CVd2CtlxuMv1IuIq.mjs → node/esm/vu0NRDeeTbEHPMYS.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.8.0-beta.1
 *
 * (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.8.0-beta.1",
   "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.8.0-beta.1",
+    "@sheetxl/scripting": "^0.8.0-beta.1"
   }
 }

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

@@ -7,8 +7,8 @@ export declare const ColumnOriented: Readonly<{
 export declare const RowOriented: Readonly<{
     axis: "row";
 }>;
-export declare const ColumnOrientedNumbers: Readonly<{
+export declare const RowOrientedNumbers: Readonly<{
     type: "number";
-    axis: "column";
+    axis: "row";
 }>;
 //# sourceMappingURL=Consts.d.ts.map

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

@@ -1,4 +1,4 @@
-import { Scalar, IRange, Flatten } from '@sheetxl/primitives';
+import { Scalar, Omittable, AcceptError, IRange, Flatten } from '@sheetxl/primitives';
 /**
  * @summary Returns the number of days from the beginning of the coupon period to the settlement date.
  * @param settlement is the security's settlement date, expressed as a serial date number.
@@ -17,10 +17,9 @@ frequency: number, basis?: number): number;
  * @param startPeriod is the first period in the calculation.
  * @param endPeriod is the last period in the calculation.
  * @param type is the timing of the payment.
+ * @compat atp
  */
-export declare function CUMIPMT(rate: number, nper: number, pv: number, startPeriod: number, // date
-endPeriod: number, // date
-type: number): number;
+export declare function CUMIPMT(rate: Omittable<Scalar>, nper: Omittable<Scalar>, pv: Omittable<Scalar>, startPeriod: Omittable<Scalar>, endPeriod: Omittable<Scalar>, type: Omittable<Scalar>): number;
 /**
  * @summary Returns the cumulative principal paid on a loan between two periods.
  * @param rate is the interest rate.
@@ -29,10 +28,9 @@ type: number): number;
  * @param startPeriod is the first period in the calculation.
  * @param endPeriod is the last period in the calculation.
  * @param type is the timing of the payment.
+ * @compat atp
  */
-export declare function CUMPRINC(rate: number, nper: number, pv: number, startPeriod: number, // date
-endPeriod: number, // date
-type: number): number;
+export declare function CUMPRINC(rate: Omittable<Scalar>, nper: Omittable<Scalar>, pv: Omittable<Scalar>, startPeriod: Omittable<Scalar>, endPeriod: Omittable<Scalar>, type: Omittable<Scalar>): 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.
@@ -81,8 +79,9 @@ export declare function DOLLARFR(decimalDollar: number, fraction: number): numbe
  * @summary Returns the effective annual interest rate.
  * @param nominalRate is the nominal interest rate.
  * @param npery is the number of compounding periods per year.
+ * @compat atp
  */
-export declare function EFFECT(nominalRate: number, npery: number): number;
+export declare function EFFECT(nominalRate: Omittable<Scalar>, npery: Omittable<Scalar>): number;
 /**
  * @summary Returns the future value of an investment based on periodic, constant payments and a constant interest rate.
  * @param rate is the interest rate.
@@ -96,8 +95,9 @@ export declare function FV(rate: number, nper: number, pmt: number, pv?: number,
  * @summary Returns the future value of an initial principal after applying a series of compound interest rates.
  * @param principal is the present value.
  * @param schedule is an array of interest rates to apply.
+ * @compat atp
  */
-export declare function FVSCHEDULE(principal: number, schedule: IRange): number;
+export declare function FVSCHEDULE(principal: Omittable<Scalar>, schedule: Omittable<AcceptError<IRange>>): number;
 /**
  * @summary Returns the interest payment for a given period for an investment, based on periodic, constant payments and a constant interest rate.
  * @param rate is the interest rate.
@@ -133,8 +133,9 @@ export declare function MIRR(values: Flatten<number>, financeRate: number, reinv
  * @summary Returns the annual nominal interest rate.
  * @param effectiveRate is the effective interest rate.
  * @param npery is the number of compounding periods per year.
+ * @compat atp
  */
-export declare function NOMINAL(effectiveRate: number, npery: number): number;
+export declare function NOMINAL(effectiveRate: Omittable<Scalar>, npery: Omittable<Scalar>): number;
 /**
  * @summary Returns the number of periods for an investment based on periodic, constant payments and a constant interest rate.
  * @param rate is the interest rate per period. For example, use 6%/4 for quarterly payments at 6% APR.
@@ -149,7 +150,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.