@cj-tech-master/excelts 9.3.1 → 9.4.0

package/dist/cjs/modules/formula/functions/financial.js

@@ -23,23 +23,23 @@ function toDate(serial) {
 // Financial Functions
 // ============================================================================
 const fnPMT = args => {
-    const rate = (0, values_1.toNumberRV)(args[0]);
+    const rate = (0, values_1.toNumberRV)((0, values_1.topLeft)(args[0]));
     if ((0, values_1.isError)(rate)) {
         return rate;
     }
-    const nper = (0, values_1.toNumberRV)(args[1]);
+    const nper = (0, values_1.toNumberRV)((0, values_1.topLeft)(args[1]));
     if ((0, values_1.isError)(nper)) {
         return nper;
     }
-    const pv = (0, values_1.toNumberRV)(args[2]);
+    const pv = (0, values_1.toNumberRV)((0, values_1.topLeft)(args[2]));
     if ((0, values_1.isError)(pv)) {
         return pv;
     }
-    const fv = args.length > 3 ? (0, values_1.toNumberRV)(args[3]) : (0, values_1.rvNumber)(0);
+    const fv = args.length > 3 ? (0, values_1.toNumberRV)((0, values_1.topLeft)(args[3])) : (0, values_1.rvNumber)(0);
     if ((0, values_1.isError)(fv)) {
         return fv;
     }
-    const type = args.length > 4 ? (0, values_1.toNumberRV)(args[4]) : (0, values_1.rvNumber)(0);
+    const type = args.length > 4 ? (0, values_1.toNumberRV)((0, values_1.topLeft)(args[4])) : (0, values_1.rvNumber)(0);
     if ((0, values_1.isError)(type)) {
         return type;
     }
@@ -66,23 +66,23 @@ const fnPMT = args => {
 };
 exports.fnPMT = fnPMT;
 const fnFV = args => {
-    const rate = (0, values_1.toNumberRV)(args[0]);
+    const rate = (0, values_1.toNumberRV)((0, values_1.topLeft)(args[0]));
     if ((0, values_1.isError)(rate)) {
         return rate;
     }
-    const nper = (0, values_1.toNumberRV)(args[1]);
+    const nper = (0, values_1.toNumberRV)((0, values_1.topLeft)(args[1]));
     if ((0, values_1.isError)(nper)) {
         return nper;
     }
-    const pmt = (0, values_1.toNumberRV)(args[2]);
+    const pmt = (0, values_1.toNumberRV)((0, values_1.topLeft)(args[2]));
     if ((0, values_1.isError)(pmt)) {
         return pmt;
     }
-    const pv = args.length > 3 ? (0, values_1.toNumberRV)(args[3]) : (0, values_1.rvNumber)(0);
+    const pv = args.length > 3 ? (0, values_1.toNumberRV)((0, values_1.topLeft)(args[3])) : (0, values_1.rvNumber)(0);
     if ((0, values_1.isError)(pv)) {
         return pv;
     }
-    const type = args.length > 4 ? (0, values_1.toNumberRV)(args[4]) : (0, values_1.rvNumber)(0);
+    const type = args.length > 4 ? (0, values_1.toNumberRV)((0, values_1.topLeft)(args[4])) : (0, values_1.rvNumber)(0);
     if ((0, values_1.isError)(type)) {
         return type;
     }
@@ -102,23 +102,23 @@ const fnFV = args => {
 };
 exports.fnFV = fnFV;
 const fnPV = args => {
-    const rate = (0, values_1.toNumberRV)(args[0]);
+    const rate = (0, values_1.toNumberRV)((0, values_1.topLeft)(args[0]));
     if ((0, values_1.isError)(rate)) {
         return rate;
     }
-    const nper = (0, values_1.toNumberRV)(args[1]);
+    const nper = (0, values_1.toNumberRV)((0, values_1.topLeft)(args[1]));
     if ((0, values_1.isError)(nper)) {
         return nper;
     }
-    const pmt = (0, values_1.toNumberRV)(args[2]);
+    const pmt = (0, values_1.toNumberRV)((0, values_1.topLeft)(args[2]));
     if ((0, values_1.isError)(pmt)) {
         return pmt;
     }
-    const fv = args.length > 3 ? (0, values_1.toNumberRV)(args[3]) : (0, values_1.rvNumber)(0);
+    const fv = args.length > 3 ? (0, values_1.toNumberRV)((0, values_1.topLeft)(args[3])) : (0, values_1.rvNumber)(0);
     if ((0, values_1.isError)(fv)) {
         return fv;
     }
-    const type = args.length > 4 ? (0, values_1.toNumberRV)(args[4]) : (0, values_1.rvNumber)(0);
+    const type = args.length > 4 ? (0, values_1.toNumberRV)((0, values_1.topLeft)(args[4])) : (0, values_1.rvNumber)(0);
     if ((0, values_1.isError)(type)) {
         return type;
     }
@@ -137,7 +137,7 @@ const fnPV = args => {
 };
 exports.fnPV = fnPV;
 const fnNPV = args => {
-    const rate = (0, values_1.toNumberRV)(args[0]);
+    const rate = (0, values_1.toNumberRV)((0, values_1.topLeft)(args[0]));
     if ((0, values_1.isError)(rate)) {
         return rate;
     }
@@ -154,6 +154,12 @@ const fnNPV = args => {
         if ((0, values_1.isArray)(a)) {
             for (const row of a.rows) {
                 for (const cell of row) {
+                    // Propagate errors encountered inside the cash-flow range —
+                    // previously silently filtered, hiding `#N/A` / `#DIV/0!`
+                    // that should surface as the NPV result.
+                    if (cell.kind === 4 /* RVKind.Error */) {
+                        return cell;
+                    }
                     if (cell.kind === 1 /* RVKind.Number */) {
                         values.push(cell.value);
                     }
@@ -213,7 +219,13 @@ const fnIRR = args => {
     if (!hasPos || !hasNeg) {
         return values_1.ERRORS.NUM;
     }
-    const guessRV = args.length > 1 ? (0, values_1.toNumberRV)(args[1]) : (0, values_1.rvNumber)(0.1);
+    // Excel's `guess` argument defaults to 0.1 when omitted. A user-supplied
+    // BLANK (e.g. `IRR(B2:B6, )` with an empty second slot) should also fall
+    // back to 0.1 — without this the Newton scan starts at `g = 0`, which
+    // sits exactly at the discount-factor singularity of several cash-flow
+    // shapes and can fail to converge. Genuine numeric guesses (including 0
+    // explicitly supplied as a number) are honoured as given.
+    const guessRV = args.length > 1 && args[1].kind !== 0 /* RVKind.Blank */ ? (0, values_1.toNumberRV)((0, values_1.topLeft)(args[1])) : (0, values_1.rvNumber)(0.1);
     if ((0, values_1.isError)(guessRV)) {
         return guessRV;
     }
@@ -291,23 +303,23 @@ const fnIRR = args => {
 };
 exports.fnIRR = fnIRR;
 const fnNPER = args => {
-    const rate = (0, values_1.toNumberRV)(args[0]);
+    const rate = (0, values_1.toNumberRV)((0, values_1.topLeft)(args[0]));
     if ((0, values_1.isError)(rate)) {
         return rate;
     }
-    const pmt = (0, values_1.toNumberRV)(args[1]);
+    const pmt = (0, values_1.toNumberRV)((0, values_1.topLeft)(args[1]));
     if ((0, values_1.isError)(pmt)) {
         return pmt;
     }
-    const pv = (0, values_1.toNumberRV)(args[2]);
+    const pv = (0, values_1.toNumberRV)((0, values_1.topLeft)(args[2]));
     if ((0, values_1.isError)(pv)) {
         return pv;
     }
-    const fv = args.length > 3 ? (0, values_1.toNumberRV)(args[3]) : (0, values_1.rvNumber)(0);
+    const fv = args.length > 3 ? (0, values_1.toNumberRV)((0, values_1.topLeft)(args[3])) : (0, values_1.rvNumber)(0);
     if ((0, values_1.isError)(fv)) {
         return fv;
     }
-    const type = args.length > 4 ? (0, values_1.toNumberRV)(args[4]) : (0, values_1.rvNumber)(0);
+    const type = args.length > 4 ? (0, values_1.toNumberRV)((0, values_1.topLeft)(args[4])) : (0, values_1.rvNumber)(0);
     if ((0, values_1.isError)(type)) {
         return type;
     }
@@ -338,27 +350,30 @@ const fnNPER = args => {
 };
 exports.fnNPER = fnNPER;
 const fnRATE = args => {
-    const nper = (0, values_1.toNumberRV)(args[0]);
+    const nper = (0, values_1.toNumberRV)((0, values_1.topLeft)(args[0]));
     if ((0, values_1.isError)(nper)) {
         return nper;
     }
-    const pmt = (0, values_1.toNumberRV)(args[1]);
+    const pmt = (0, values_1.toNumberRV)((0, values_1.topLeft)(args[1]));
     if ((0, values_1.isError)(pmt)) {
         return pmt;
     }
-    const pv = (0, values_1.toNumberRV)(args[2]);
+    const pv = (0, values_1.toNumberRV)((0, values_1.topLeft)(args[2]));
     if ((0, values_1.isError)(pv)) {
         return pv;
     }
-    const fv = args.length > 3 ? (0, values_1.toNumberRV)(args[3]) : (0, values_1.rvNumber)(0);
+    const fv = args.length > 3 ? (0, values_1.toNumberRV)((0, values_1.topLeft)(args[3])) : (0, values_1.rvNumber)(0);
     if ((0, values_1.isError)(fv)) {
         return fv;
     }
-    const type = args.length > 4 ? (0, values_1.toNumberRV)(args[4]) : (0, values_1.rvNumber)(0);
+    const type = args.length > 4 ? (0, values_1.toNumberRV)((0, values_1.topLeft)(args[4])) : (0, values_1.rvNumber)(0);
     if ((0, values_1.isError)(type)) {
         return type;
     }
-    const guess = args.length > 5 ? (0, values_1.toNumberRV)(args[5]) : (0, values_1.rvNumber)(0.1);
+    // Blank → default 0.1 (see IRR / XIRR for rationale). For `fv` and
+    // `type` a blank coerces to 0 via `toNumberRV`, which matches Excel's
+    // documented defaults, so those are left as-is.
+    const guess = args.length > 5 && args[5].kind !== 0 /* RVKind.Blank */ ? (0, values_1.toNumberRV)((0, values_1.topLeft)(args[5])) : (0, values_1.rvNumber)(0.1);
     if ((0, values_1.isError)(guess)) {
         return guess;
     }
@@ -424,15 +439,15 @@ const fnRATE = args => {
 };
 exports.fnRATE = fnRATE;
 const fnSLN = args => {
-    const cost = (0, values_1.toNumberRV)(args[0]);
+    const cost = (0, values_1.toNumberRV)((0, values_1.topLeft)(args[0]));
     if ((0, values_1.isError)(cost)) {
         return cost;
     }
-    const salvage = (0, values_1.toNumberRV)(args[1]);
+    const salvage = (0, values_1.toNumberRV)((0, values_1.topLeft)(args[1]));
     if ((0, values_1.isError)(salvage)) {
         return salvage;
     }
-    const life = (0, values_1.toNumberRV)(args[2]);
+    const life = (0, values_1.toNumberRV)((0, values_1.topLeft)(args[2]));
     if ((0, values_1.isError)(life)) {
         return life;
     }
@@ -452,19 +467,19 @@ exports.fnSLN = fnSLN;
  * Excel rejects `life = 0` and period outside [1, life] with #NUM!.
  */
 const fnSYD = args => {
-    const cost = (0, values_1.toNumberRV)(args[0]);
+    const cost = (0, values_1.toNumberRV)((0, values_1.topLeft)(args[0]));
     if ((0, values_1.isError)(cost)) {
         return cost;
     }
-    const salvage = (0, values_1.toNumberRV)(args[1]);
+    const salvage = (0, values_1.toNumberRV)((0, values_1.topLeft)(args[1]));
     if ((0, values_1.isError)(salvage)) {
         return salvage;
     }
-    const life = (0, values_1.toNumberRV)(args[2]);
+    const life = (0, values_1.toNumberRV)((0, values_1.topLeft)(args[2]));
     if ((0, values_1.isError)(life)) {
         return life;
     }
-    const per = (0, values_1.toNumberRV)(args[3]);
+    const per = (0, values_1.toNumberRV)((0, values_1.topLeft)(args[3]));
     if ((0, values_1.isError)(per)) {
         return per;
     }
@@ -488,31 +503,33 @@ exports.fnSYD = fnSYD;
  * periods.
  */
 const fnVDB = args => {
-    const cost = (0, values_1.toNumberRV)(args[0]);
+    const cost = (0, values_1.toNumberRV)((0, values_1.topLeft)(args[0]));
     if ((0, values_1.isError)(cost)) {
         return cost;
     }
-    const salvage = (0, values_1.toNumberRV)(args[1]);
+    const salvage = (0, values_1.toNumberRV)((0, values_1.topLeft)(args[1]));
     if ((0, values_1.isError)(salvage)) {
         return salvage;
     }
-    const life = (0, values_1.toNumberRV)(args[2]);
+    const life = (0, values_1.toNumberRV)((0, values_1.topLeft)(args[2]));
     if ((0, values_1.isError)(life)) {
         return life;
     }
-    const start = (0, values_1.toNumberRV)(args[3]);
+    const start = (0, values_1.toNumberRV)((0, values_1.topLeft)(args[3]));
     if ((0, values_1.isError)(start)) {
         return start;
     }
-    const end = (0, values_1.toNumberRV)(args[4]);
+    const end = (0, values_1.toNumberRV)((0, values_1.topLeft)(args[4]));
     if ((0, values_1.isError)(end)) {
         return end;
     }
-    const factorRV = args.length > 5 ? (0, values_1.toNumberRV)(args[5]) : (0, values_1.rvNumber)(2);
+    const factorRV = args.length > 5 && args[5].kind !== 0 /* RVKind.Blank */ ? (0, values_1.toNumberRV)((0, values_1.topLeft)(args[5])) : (0, values_1.rvNumber)(2);
     if ((0, values_1.isError)(factorRV)) {
         return factorRV;
     }
-    const noSwitchRV = args.length > 6 ? (0, values_1.toBooleanRV)(args[6]) : (0, values_1.rvBoolean)(false);
+    const noSwitchRV = args.length > 6 && args[6].kind !== 0 /* RVKind.Blank */
+        ? (0, values_1.toBooleanRV)((0, values_1.topLeft)(args[6]))
+        : (0, values_1.rvBoolean)(false);
     if ((0, values_1.isError)(noSwitchRV)) {
         return noSwitchRV;
     }
@@ -577,23 +594,27 @@ const fnVDB = args => {
 };
 exports.fnVDB = fnVDB;
 const fnDB = args => {
-    const cost = (0, values_1.toNumberRV)(args[0]);
+    const cost = (0, values_1.toNumberRV)((0, values_1.topLeft)(args[0]));
     if ((0, values_1.isError)(cost)) {
         return cost;
     }
-    const salvage = (0, values_1.toNumberRV)(args[1]);
+    const salvage = (0, values_1.toNumberRV)((0, values_1.topLeft)(args[1]));
     if ((0, values_1.isError)(salvage)) {
         return salvage;
     }
-    const life = (0, values_1.toNumberRV)(args[2]);
+    const life = (0, values_1.toNumberRV)((0, values_1.topLeft)(args[2]));
     if ((0, values_1.isError)(life)) {
         return life;
     }
-    const period = (0, values_1.toNumberRV)(args[3]);
+    const period = (0, values_1.toNumberRV)((0, values_1.topLeft)(args[3]));
     if ((0, values_1.isError)(period)) {
         return period;
     }
-    const month = args.length > 4 ? (0, values_1.toNumberRV)(args[4]) : (0, values_1.rvNumber)(12);
+    // Blank `month` → Excel default 12 (full first year). Without the
+    // blank guard, `toNumberRV(BLANK)` coerces to 0 which then trips the
+    // `month < 1` validation below, silently surfacing #NUM! for
+    // `DB(cost, salvage, life, period, )`.
+    const month = args.length > 4 && args[4].kind !== 0 /* RVKind.Blank */ ? (0, values_1.toNumberRV)((0, values_1.topLeft)(args[4])) : (0, values_1.rvNumber)(12);
     if ((0, values_1.isError)(month)) {
         return month;
     }
@@ -637,23 +658,25 @@ const fnDB = args => {
 };
 exports.fnDB = fnDB;
 const fnDDB = args => {
-    const cost = (0, values_1.toNumberRV)(args[0]);
+    const cost = (0, values_1.toNumberRV)((0, values_1.topLeft)(args[0]));
     if ((0, values_1.isError)(cost)) {
         return cost;
     }
-    const salvage = (0, values_1.toNumberRV)(args[1]);
+    const salvage = (0, values_1.toNumberRV)((0, values_1.topLeft)(args[1]));
     if ((0, values_1.isError)(salvage)) {
         return salvage;
     }
-    const life = (0, values_1.toNumberRV)(args[2]);
+    const life = (0, values_1.toNumberRV)((0, values_1.topLeft)(args[2]));
     if ((0, values_1.isError)(life)) {
         return life;
     }
-    const period = (0, values_1.toNumberRV)(args[3]);
+    const period = (0, values_1.toNumberRV)((0, values_1.topLeft)(args[3]));
     if ((0, values_1.isError)(period)) {
         return period;
     }
-    const factor = args.length > 4 ? (0, values_1.toNumberRV)(args[4]) : (0, values_1.rvNumber)(2);
+    // Blank `factor` → Excel default 2 (double declining). See DB/IRR for
+    // why blank must be distinguished from an explicit 0.
+    const factor = args.length > 4 && args[4].kind !== 0 /* RVKind.Blank */ ? (0, values_1.toNumberRV)((0, values_1.topLeft)(args[4])) : (0, values_1.rvNumber)(2);
     if ((0, values_1.isError)(factor)) {
         return factor;
     }
@@ -712,27 +735,27 @@ function ipmtRaw(rate, per, nper, pv, fv, type) {
     return type === 1 ? ipmt / (1 + rate) : ipmt;
 }
 const fnIPMT = args => {
-    const rate = (0, values_1.toNumberRV)(args[0]);
+    const rate = (0, values_1.toNumberRV)((0, values_1.topLeft)(args[0]));
     if ((0, values_1.isError)(rate)) {
         return rate;
     }
-    const per = (0, values_1.toNumberRV)(args[1]);
+    const per = (0, values_1.toNumberRV)((0, values_1.topLeft)(args[1]));
     if ((0, values_1.isError)(per)) {
         return per;
     }
-    const nper = (0, values_1.toNumberRV)(args[2]);
+    const nper = (0, values_1.toNumberRV)((0, values_1.topLeft)(args[2]));
     if ((0, values_1.isError)(nper)) {
         return nper;
     }
-    const pv = (0, values_1.toNumberRV)(args[3]);
+    const pv = (0, values_1.toNumberRV)((0, values_1.topLeft)(args[3]));
     if ((0, values_1.isError)(pv)) {
         return pv;
     }
-    const fv = args.length > 4 ? (0, values_1.toNumberRV)(args[4]) : (0, values_1.rvNumber)(0);
+    const fv = args.length > 4 ? (0, values_1.toNumberRV)((0, values_1.topLeft)(args[4])) : (0, values_1.rvNumber)(0);
     if ((0, values_1.isError)(fv)) {
         return fv;
     }
-    const type = args.length > 5 ? (0, values_1.toNumberRV)(args[5]) : (0, values_1.rvNumber)(0);
+    const type = args.length > 5 ? (0, values_1.toNumberRV)((0, values_1.topLeft)(args[5])) : (0, values_1.rvNumber)(0);
     if ((0, values_1.isError)(type)) {
         return type;
     }
@@ -740,27 +763,27 @@ const fnIPMT = args => {
 };
 exports.fnIPMT = fnIPMT;
 const fnPPMT = args => {
-    const rate = (0, values_1.toNumberRV)(args[0]);
+    const rate = (0, values_1.toNumberRV)((0, values_1.topLeft)(args[0]));
     if ((0, values_1.isError)(rate)) {
         return rate;
     }
-    const per = (0, values_1.toNumberRV)(args[1]);
+    const per = (0, values_1.toNumberRV)((0, values_1.topLeft)(args[1]));
     if ((0, values_1.isError)(per)) {
         return per;
     }
-    const nper = (0, values_1.toNumberRV)(args[2]);
+    const nper = (0, values_1.toNumberRV)((0, values_1.topLeft)(args[2]));
     if ((0, values_1.isError)(nper)) {
         return nper;
     }
-    const pv = (0, values_1.toNumberRV)(args[3]);
+    const pv = (0, values_1.toNumberRV)((0, values_1.topLeft)(args[3]));
     if ((0, values_1.isError)(pv)) {
         return pv;
     }
-    const fv = args.length > 4 ? (0, values_1.toNumberRV)(args[4]) : (0, values_1.rvNumber)(0);
+    const fv = args.length > 4 ? (0, values_1.toNumberRV)((0, values_1.topLeft)(args[4])) : (0, values_1.rvNumber)(0);
     if ((0, values_1.isError)(fv)) {
         return fv;
     }
-    const type = args.length > 5 ? (0, values_1.toNumberRV)(args[5]) : (0, values_1.rvNumber)(0);
+    const type = args.length > 5 ? (0, values_1.toNumberRV)((0, values_1.topLeft)(args[5])) : (0, values_1.rvNumber)(0);
     if ((0, values_1.isError)(type)) {
         return type;
     }
@@ -781,7 +804,7 @@ exports.fnPPMT = fnPPMT;
  * propagates any error it encounters. Text values produce #VALUE!.
  */
 const fnFVSCHEDULE = args => {
-    const principal = (0, values_1.toNumberRV)(args[0]);
+    const principal = (0, values_1.toNumberRV)((0, values_1.topLeft)(args[0]));
     if ((0, values_1.isError)(principal)) {
         return principal;
     }
@@ -833,15 +856,15 @@ exports.fnFVSCHEDULE = fnFVSCHEDULE;
  * Excel requires `rate > 0` and `pv, fv > 0`.
  */
 const fnPDURATION = args => {
-    const rate = (0, values_1.toNumberRV)(args[0]);
+    const rate = (0, values_1.toNumberRV)((0, values_1.topLeft)(args[0]));
     if ((0, values_1.isError)(rate)) {
         return rate;
     }
-    const pv = (0, values_1.toNumberRV)(args[1]);
+    const pv = (0, values_1.toNumberRV)((0, values_1.topLeft)(args[1]));
     if ((0, values_1.isError)(pv)) {
         return pv;
     }
-    const fv = (0, values_1.toNumberRV)(args[2]);
+    const fv = (0, values_1.toNumberRV)((0, values_1.topLeft)(args[2]));
     if ((0, values_1.isError)(fv)) {
         return fv;
     }
@@ -859,15 +882,15 @@ exports.fnPDURATION = fnPDURATION;
  * Excel requires `nper > 0`, `pv > 0`, `fv >= 0`.
  */
 const fnRRI = args => {
-    const nper = (0, values_1.toNumberRV)(args[0]);
+    const nper = (0, values_1.toNumberRV)((0, values_1.topLeft)(args[0]));
     if ((0, values_1.isError)(nper)) {
         return nper;
     }
-    const pv = (0, values_1.toNumberRV)(args[1]);
+    const pv = (0, values_1.toNumberRV)((0, values_1.topLeft)(args[1]));
     if ((0, values_1.isError)(pv)) {
         return pv;
     }
-    const fv = (0, values_1.toNumberRV)(args[2]);
+    const fv = (0, values_1.toNumberRV)((0, values_1.topLeft)(args[2]));
     if ((0, values_1.isError)(fv)) {
         return fv;
     }
@@ -878,11 +901,11 @@ const fnRRI = args => {
 };
 exports.fnRRI = fnRRI;
 const fnEFFECT = args => {
-    const nomRate = (0, values_1.toNumberRV)(args[0]);
+    const nomRate = (0, values_1.toNumberRV)((0, values_1.topLeft)(args[0]));
     if ((0, values_1.isError)(nomRate)) {
         return nomRate;
     }
-    const npery = (0, values_1.toNumberRV)(args[1]);
+    const npery = (0, values_1.toNumberRV)((0, values_1.topLeft)(args[1]));
     if ((0, values_1.isError)(npery)) {
         return npery;
     }
@@ -893,11 +916,11 @@ const fnEFFECT = args => {
 };
 exports.fnEFFECT = fnEFFECT;
 const fnNOMINAL = args => {
-    const effRate = (0, values_1.toNumberRV)(args[0]);
+    const effRate = (0, values_1.toNumberRV)((0, values_1.topLeft)(args[0]));
     if ((0, values_1.isError)(effRate)) {
         return effRate;
     }
-    const npery = (0, values_1.toNumberRV)(args[1]);
+    const npery = (0, values_1.toNumberRV)((0, values_1.topLeft)(args[1]));
     if ((0, values_1.isError)(npery)) {
         return npery;
     }
@@ -909,7 +932,7 @@ const fnNOMINAL = args => {
 };
 exports.fnNOMINAL = fnNOMINAL;
 const fnXNPV = args => {
-    const rate = (0, values_1.toNumberRV)(args[0]);
+    const rate = (0, values_1.toNumberRV)((0, values_1.topLeft)(args[0]));
     if ((0, values_1.isError)(rate)) {
         return rate;
     }
@@ -980,7 +1003,8 @@ const fnXIRR = args => {
     if (!xHasPos || !xHasNeg) {
         return values_1.ERRORS.NUM;
     }
-    const guessRV = args.length > 2 ? (0, values_1.toNumberRV)(args[2]) : (0, values_1.rvNumber)(0.1);
+    // Blank third slot → default 0.1, same rationale as IRR above.
+    const guessRV = args.length > 2 && args[2].kind !== 0 /* RVKind.Blank */ ? (0, values_1.toNumberRV)((0, values_1.topLeft)(args[2])) : (0, values_1.rvNumber)(0.1);
     if ((0, values_1.isError)(guessRV)) {
         return guessRV;
     }
@@ -1067,11 +1091,11 @@ const fnMIRR = args => {
         return valuesErr;
     }
     const values = rawValues.map(n => n.value);
-    const financeRate = (0, values_1.toNumberRV)(args[1]);
+    const financeRate = (0, values_1.toNumberRV)((0, values_1.topLeft)(args[1]));
     if ((0, values_1.isError)(financeRate)) {
         return financeRate;
     }
-    const reinvestRate = (0, values_1.toNumberRV)(args[2]);
+    const reinvestRate = (0, values_1.toNumberRV)((0, values_1.topLeft)(args[2]));
     if ((0, values_1.isError)(reinvestRate)) {
         return reinvestRate;
     }
@@ -1101,19 +1125,19 @@ const fnMIRR = args => {
 };
 exports.fnMIRR = fnMIRR;
 const fnISPMT = args => {
-    const rate = (0, values_1.toNumberRV)(args[0]);
+    const rate = (0, values_1.toNumberRV)((0, values_1.topLeft)(args[0]));
     if ((0, values_1.isError)(rate)) {
         return rate;
     }
-    const per = (0, values_1.toNumberRV)(args[1]);
+    const per = (0, values_1.toNumberRV)((0, values_1.topLeft)(args[1]));
     if ((0, values_1.isError)(per)) {
         return per;
     }
-    const nper = (0, values_1.toNumberRV)(args[2]);
+    const nper = (0, values_1.toNumberRV)((0, values_1.topLeft)(args[2]));
     if ((0, values_1.isError)(nper)) {
         return nper;
     }
-    const pv = (0, values_1.toNumberRV)(args[3]);
+    const pv = (0, values_1.toNumberRV)((0, values_1.topLeft)(args[3]));
     if ((0, values_1.isError)(pv)) {
         return pv;
     }
@@ -1126,27 +1150,27 @@ const fnISPMT = args => {
 };
 exports.fnISPMT = fnISPMT;
 const fnCUMPRINC = args => {
-    const rate = (0, values_1.toNumberRV)(args[0]);
+    const rate = (0, values_1.toNumberRV)((0, values_1.topLeft)(args[0]));
     if ((0, values_1.isError)(rate)) {
         return rate;
     }
-    const nper = (0, values_1.toNumberRV)(args[1]);
+    const nper = (0, values_1.toNumberRV)((0, values_1.topLeft)(args[1]));
     if ((0, values_1.isError)(nper)) {
         return nper;
     }
-    const pv = (0, values_1.toNumberRV)(args[2]);
+    const pv = (0, values_1.toNumberRV)((0, values_1.topLeft)(args[2]));
     if ((0, values_1.isError)(pv)) {
         return pv;
     }
-    const startPeriod = (0, values_1.toNumberRV)(args[3]);
+    const startPeriod = (0, values_1.toNumberRV)((0, values_1.topLeft)(args[3]));
     if ((0, values_1.isError)(startPeriod)) {
         return startPeriod;
     }
-    const endPeriod = (0, values_1.toNumberRV)(args[4]);
+    const endPeriod = (0, values_1.toNumberRV)((0, values_1.topLeft)(args[4]));
     if ((0, values_1.isError)(endPeriod)) {
         return endPeriod;
     }
-    const type = (0, values_1.toNumberRV)(args[5]);
+    const type = (0, values_1.toNumberRV)((0, values_1.topLeft)(args[5]));
     if ((0, values_1.isError)(type)) {
         return type;
     }
@@ -1164,8 +1188,10 @@ const fnCUMPRINC = args => {
         return values_1.ERRORS.NUM;
     }
     let cumPrinc = 0;
+    // PMT is constant across all periods — hoist it out of the loop
+    // rather than recomputing the same value `e - s + 1` times.
+    const pmtVal = pmtRaw(rate.value, nper.value, pv.value, 0, type.value);
     for (let p = s; p <= e; p++) {
-        const pmtVal = pmtRaw(rate.value, nper.value, pv.value, 0, type.value);
         const ipmtVal = ipmtRaw(rate.value, p, nper.value, pv.value, 0, type.value);
         cumPrinc += pmtVal - ipmtVal;
     }
@@ -1173,27 +1199,27 @@ const fnCUMPRINC = args => {
 };
 exports.fnCUMPRINC = fnCUMPRINC;
 const fnCUMIPMT = args => {
-    const rate = (0, values_1.toNumberRV)(args[0]);
+    const rate = (0, values_1.toNumberRV)((0, values_1.topLeft)(args[0]));
     if ((0, values_1.isError)(rate)) {
         return rate;
     }
-    const nper = (0, values_1.toNumberRV)(args[1]);
+    const nper = (0, values_1.toNumberRV)((0, values_1.topLeft)(args[1]));
     if ((0, values_1.isError)(nper)) {
         return nper;
     }
-    const pv = (0, values_1.toNumberRV)(args[2]);
+    const pv = (0, values_1.toNumberRV)((0, values_1.topLeft)(args[2]));
     if ((0, values_1.isError)(pv)) {
         return pv;
     }
-    const startPeriod = (0, values_1.toNumberRV)(args[3]);
+    const startPeriod = (0, values_1.toNumberRV)((0, values_1.topLeft)(args[3]));
     if ((0, values_1.isError)(startPeriod)) {
         return startPeriod;
     }
-    const endPeriod = (0, values_1.toNumberRV)(args[4]);
+    const endPeriod = (0, values_1.toNumberRV)((0, values_1.topLeft)(args[4]));
     if ((0, values_1.isError)(endPeriod)) {
         return endPeriod;
     }
-    const type = (0, values_1.toNumberRV)(args[5]);
+    const type = (0, values_1.toNumberRV)((0, values_1.topLeft)(args[5]));
     if ((0, values_1.isError)(type)) {
         return type;
     }
@@ -1217,11 +1243,11 @@ const fnCUMIPMT = args => {
 };
 exports.fnCUMIPMT = fnCUMIPMT;
 const fnDOLLARDE = args => {
-    const fractionalDollar = (0, values_1.toNumberRV)(args[0]);
+    const fractionalDollar = (0, values_1.toNumberRV)((0, values_1.topLeft)(args[0]));
     if ((0, values_1.isError)(fractionalDollar)) {
         return fractionalDollar;
     }
-    const fraction = (0, values_1.toNumberRV)(args[1]);
+    const fraction = (0, values_1.toNumberRV)((0, values_1.topLeft)(args[1]));
     if ((0, values_1.isError)(fraction)) {
         return fraction;
     }
@@ -1245,11 +1271,11 @@ const fnDOLLARDE = args => {
 };
 exports.fnDOLLARDE = fnDOLLARDE;
 const fnDOLLARFR = args => {
-    const decimalDollar = (0, values_1.toNumberRV)(args[0]);
+    const decimalDollar = (0, values_1.toNumberRV)((0, values_1.topLeft)(args[0]));
     if ((0, values_1.isError)(decimalDollar)) {
         return decimalDollar;
     }
-    const fraction = (0, values_1.toNumberRV)(args[1]);
+    const fraction = (0, values_1.toNumberRV)((0, values_1.topLeft)(args[1]));
     if ((0, values_1.isError)(fraction)) {
         return fraction;
     }
@@ -1286,23 +1312,23 @@ function validateBasis(basis) {
     return null;
 }
 const fnDISC = args => {
-    const settlement = (0, values_1.toNumberRV)(args[0]);
+    const settlement = (0, values_1.toNumberRV)((0, values_1.topLeft)(args[0]));
     if ((0, values_1.isError)(settlement)) {
         return settlement;
     }
-    const maturity = (0, values_1.toNumberRV)(args[1]);
+    const maturity = (0, values_1.toNumberRV)((0, values_1.topLeft)(args[1]));
     if ((0, values_1.isError)(maturity)) {
         return maturity;
     }
-    const pr = (0, values_1.toNumberRV)(args[2]);
+    const pr = (0, values_1.toNumberRV)((0, values_1.topLeft)(args[2]));
     if ((0, values_1.isError)(pr)) {
         return pr;
     }
-    const redemption = (0, values_1.toNumberRV)(args[3]);
+    const redemption = (0, values_1.toNumberRV)((0, values_1.topLeft)(args[3]));
     if ((0, values_1.isError)(redemption)) {
         return redemption;
     }
-    const basis = args.length > 4 ? (0, values_1.toNumberRV)(args[4]) : (0, values_1.rvNumber)(0);
+    const basis = args.length > 4 ? (0, values_1.toNumberRV)((0, values_1.topLeft)(args[4])) : (0, values_1.rvNumber)(0);
     if ((0, values_1.isError)(basis)) {
         return basis;
     }
@@ -1324,23 +1350,23 @@ const fnDISC = args => {
 };
 exports.fnDISC = fnDISC;
 const fnPRICEDISC = args => {
-    const settlement = (0, values_1.toNumberRV)(args[0]);
+    const settlement = (0, values_1.toNumberRV)((0, values_1.topLeft)(args[0]));
     if ((0, values_1.isError)(settlement)) {
         return settlement;
     }
-    const maturity = (0, values_1.toNumberRV)(args[1]);
+    const maturity = (0, values_1.toNumberRV)((0, values_1.topLeft)(args[1]));
     if ((0, values_1.isError)(maturity)) {
         return maturity;
     }
-    const disc = (0, values_1.toNumberRV)(args[2]);
+    const disc = (0, values_1.toNumberRV)((0, values_1.topLeft)(args[2]));
     if ((0, values_1.isError)(disc)) {
         return disc;
     }
-    const redemption = (0, values_1.toNumberRV)(args[3]);
+    const redemption = (0, values_1.toNumberRV)((0, values_1.topLeft)(args[3]));
     if ((0, values_1.isError)(redemption)) {
         return redemption;
     }
-    const basis = args.length > 4 ? (0, values_1.toNumberRV)(args[4]) : (0, values_1.rvNumber)(0);
+    const basis = args.length > 4 ? (0, values_1.toNumberRV)((0, values_1.topLeft)(args[4])) : (0, values_1.rvNumber)(0);
     if ((0, values_1.isError)(basis)) {
         return basis;
     }
@@ -1356,23 +1382,23 @@ const fnPRICEDISC = args => {
 };
 exports.fnPRICEDISC = fnPRICEDISC;
 const fnYIELDDISC = args => {
-    const settlement = (0, values_1.toNumberRV)(args[0]);
+    const settlement = (0, values_1.toNumberRV)((0, values_1.topLeft)(args[0]));
     if ((0, values_1.isError)(settlement)) {
         return settlement;
     }
-    const maturity = (0, values_1.toNumberRV)(args[1]);
+    const maturity = (0, values_1.toNumberRV)((0, values_1.topLeft)(args[1]));
     if ((0, values_1.isError)(maturity)) {
         return maturity;
     }
-    const pr = (0, values_1.toNumberRV)(args[2]);
+    const pr = (0, values_1.toNumberRV)((0, values_1.topLeft)(args[2]));
     if ((0, values_1.isError)(pr)) {
         return pr;
     }
-    const redemption = (0, values_1.toNumberRV)(args[3]);
+    const redemption = (0, values_1.toNumberRV)((0, values_1.topLeft)(args[3]));
     if ((0, values_1.isError)(redemption)) {
         return redemption;
     }
-    const basis = args.length > 4 ? (0, values_1.toNumberRV)(args[4]) : (0, values_1.rvNumber)(0);
+    const basis = args.length > 4 ? (0, values_1.toNumberRV)((0, values_1.topLeft)(args[4])) : (0, values_1.rvNumber)(0);
     if ((0, values_1.isError)(basis)) {
         return basis;
     }
@@ -1391,23 +1417,23 @@ const fnYIELDDISC = args => {
 };
 exports.fnYIELDDISC = fnYIELDDISC;
 const fnRECEIVED = args => {
-    const settlement = (0, values_1.toNumberRV)(args[0]);
+    const settlement = (0, values_1.toNumberRV)((0, values_1.topLeft)(args[0]));
     if ((0, values_1.isError)(settlement)) {
         return settlement;
     }
-    const maturity = (0, values_1.toNumberRV)(args[1]);
+    const maturity = (0, values_1.toNumberRV)((0, values_1.topLeft)(args[1]));
     if ((0, values_1.isError)(maturity)) {
         return maturity;
     }
-    const investment = (0, values_1.toNumberRV)(args[2]);
+    const investment = (0, values_1.toNumberRV)((0, values_1.topLeft)(args[2]));
     if ((0, values_1.isError)(investment)) {
         return investment;
     }
-    const disc = (0, values_1.toNumberRV)(args[3]);
+    const disc = (0, values_1.toNumberRV)((0, values_1.topLeft)(args[3]));
     if ((0, values_1.isError)(disc)) {
         return disc;
     }
-    const basis = args.length > 4 ? (0, values_1.toNumberRV)(args[4]) : (0, values_1.rvNumber)(0);
+    const basis = args.length > 4 ? (0, values_1.toNumberRV)((0, values_1.topLeft)(args[4])) : (0, values_1.rvNumber)(0);
     if ((0, values_1.isError)(basis)) {
         return basis;
     }
@@ -1427,23 +1453,23 @@ const fnRECEIVED = args => {
 };
 exports.fnRECEIVED = fnRECEIVED;
 const fnINTRATE = args => {
-    const settlement = (0, values_1.toNumberRV)(args[0]);
+    const settlement = (0, values_1.toNumberRV)((0, values_1.topLeft)(args[0]));
     if ((0, values_1.isError)(settlement)) {
         return settlement;
     }
-    const maturity = (0, values_1.toNumberRV)(args[1]);
+    const maturity = (0, values_1.toNumberRV)((0, values_1.topLeft)(args[1]));
     if ((0, values_1.isError)(maturity)) {
         return maturity;
     }
-    const investment = (0, values_1.toNumberRV)(args[2]);
+    const investment = (0, values_1.toNumberRV)((0, values_1.topLeft)(args[2]));
     if ((0, values_1.isError)(investment)) {
         return investment;
     }
-    const redemption = (0, values_1.toNumberRV)(args[3]);
+    const redemption = (0, values_1.toNumberRV)((0, values_1.topLeft)(args[3]));
     if ((0, values_1.isError)(redemption)) {
         return redemption;
     }
-    const basis = args.length > 4 ? (0, values_1.toNumberRV)(args[4]) : (0, values_1.rvNumber)(0);
+    const basis = args.length > 4 ? (0, values_1.toNumberRV)((0, values_1.topLeft)(args[4])) : (0, values_1.rvNumber)(0);
     if ((0, values_1.isError)(basis)) {
         return basis;
     }
@@ -1661,31 +1687,31 @@ function validateBondBasis(frequency, basis) {
  *   A   = days from beginning of coupon period to settlement
  */
 const fnPRICE = args => {
-    const settlementRV = (0, values_1.toNumberRV)(args[0]);
+    const settlementRV = (0, values_1.toNumberRV)((0, values_1.topLeft)(args[0]));
     if ((0, values_1.isError)(settlementRV)) {
         return settlementRV;
     }
-    const maturityRV = (0, values_1.toNumberRV)(args[1]);
+    const maturityRV = (0, values_1.toNumberRV)((0, values_1.topLeft)(args[1]));
     if ((0, values_1.isError)(maturityRV)) {
         return maturityRV;
     }
-    const rateRV = (0, values_1.toNumberRV)(args[2]);
+    const rateRV = (0, values_1.toNumberRV)((0, values_1.topLeft)(args[2]));
     if ((0, values_1.isError)(rateRV)) {
         return rateRV;
     }
-    const yieldRV = (0, values_1.toNumberRV)(args[3]);
+    const yieldRV = (0, values_1.toNumberRV)((0, values_1.topLeft)(args[3]));
     if ((0, values_1.isError)(yieldRV)) {
         return yieldRV;
     }
-    const redemptionRV = (0, values_1.toNumberRV)(args[4]);
+    const redemptionRV = (0, values_1.toNumberRV)((0, values_1.topLeft)(args[4]));
     if ((0, values_1.isError)(redemptionRV)) {
         return redemptionRV;
     }
-    const frequencyRV = (0, values_1.toNumberRV)(args[5]);
+    const frequencyRV = (0, values_1.toNumberRV)((0, values_1.topLeft)(args[5]));
     if ((0, values_1.isError)(frequencyRV)) {
         return frequencyRV;
     }
-    const basisRV = args.length > 6 ? (0, values_1.toNumberRV)(args[6]) : (0, values_1.rvNumber)(0);
+    const basisRV = args.length > 6 ? (0, values_1.toNumberRV)((0, values_1.topLeft)(args[6])) : (0, values_1.rvNumber)(0);
     if ((0, values_1.isError)(basisRV)) {
         return basisRV;
     }
@@ -1736,31 +1762,31 @@ exports.fnPRICE = fnPRICE;
  * realistic bond scenarios) followed by a light Newton polish.
  */
 const fnYIELD = args => {
-    const settlementRV = (0, values_1.toNumberRV)(args[0]);
+    const settlementRV = (0, values_1.toNumberRV)((0, values_1.topLeft)(args[0]));
     if ((0, values_1.isError)(settlementRV)) {
         return settlementRV;
     }
-    const maturityRV = (0, values_1.toNumberRV)(args[1]);
+    const maturityRV = (0, values_1.toNumberRV)((0, values_1.topLeft)(args[1]));
     if ((0, values_1.isError)(maturityRV)) {
         return maturityRV;
     }
-    const rateRV = (0, values_1.toNumberRV)(args[2]);
+    const rateRV = (0, values_1.toNumberRV)((0, values_1.topLeft)(args[2]));
     if ((0, values_1.isError)(rateRV)) {
         return rateRV;
     }
-    const prRV = (0, values_1.toNumberRV)(args[3]);
+    const prRV = (0, values_1.toNumberRV)((0, values_1.topLeft)(args[3]));
     if ((0, values_1.isError)(prRV)) {
         return prRV;
     }
-    const redemptionRV = (0, values_1.toNumberRV)(args[4]);
+    const redemptionRV = (0, values_1.toNumberRV)((0, values_1.topLeft)(args[4]));
     if ((0, values_1.isError)(redemptionRV)) {
         return redemptionRV;
     }
-    const frequencyRV = (0, values_1.toNumberRV)(args[5]);
+    const frequencyRV = (0, values_1.toNumberRV)((0, values_1.topLeft)(args[5]));
     if ((0, values_1.isError)(frequencyRV)) {
         return frequencyRV;
     }
-    const basisRV = args.length > 6 ? (0, values_1.toNumberRV)(args[6]) : (0, values_1.rvNumber)(0);
+    const basisRV = args.length > 6 ? (0, values_1.toNumberRV)((0, values_1.topLeft)(args[6])) : (0, values_1.rvNumber)(0);
     if ((0, values_1.isError)(basisRV)) {
         return basisRV;
     }
@@ -1824,27 +1850,27 @@ exports.fnYIELD = fnYIELD;
  * weighted by present value. Expressed in years.
  */
 const fnDURATION = args => {
-    const settlementRV = (0, values_1.toNumberRV)(args[0]);
+    const settlementRV = (0, values_1.toNumberRV)((0, values_1.topLeft)(args[0]));
     if ((0, values_1.isError)(settlementRV)) {
         return settlementRV;
     }
-    const maturityRV = (0, values_1.toNumberRV)(args[1]);
+    const maturityRV = (0, values_1.toNumberRV)((0, values_1.topLeft)(args[1]));
     if ((0, values_1.isError)(maturityRV)) {
         return maturityRV;
     }
-    const couponRV = (0, values_1.toNumberRV)(args[2]);
+    const couponRV = (0, values_1.toNumberRV)((0, values_1.topLeft)(args[2]));
     if ((0, values_1.isError)(couponRV)) {
         return couponRV;
     }
-    const yieldRV = (0, values_1.toNumberRV)(args[3]);
+    const yieldRV = (0, values_1.toNumberRV)((0, values_1.topLeft)(args[3]));
     if ((0, values_1.isError)(yieldRV)) {
         return yieldRV;
     }
-    const frequencyRV = (0, values_1.toNumberRV)(args[4]);
+    const frequencyRV = (0, values_1.toNumberRV)((0, values_1.topLeft)(args[4]));
     if ((0, values_1.isError)(frequencyRV)) {
         return frequencyRV;
     }
-    const basisRV = args.length > 5 ? (0, values_1.toNumberRV)(args[5]) : (0, values_1.rvNumber)(0);
+    const basisRV = args.length > 5 ? (0, values_1.toNumberRV)((0, values_1.topLeft)(args[5])) : (0, values_1.rvNumber)(0);
     if ((0, values_1.isError)(basisRV)) {
         return basisRV;
     }
@@ -1892,11 +1918,11 @@ const fnMDURATION = args => {
     if (dur.kind !== 1 /* RVKind.Number */) {
         return dur;
     }
-    const yieldRV = (0, values_1.toNumberRV)(args[3]);
+    const yieldRV = (0, values_1.toNumberRV)((0, values_1.topLeft)(args[3]));
     if ((0, values_1.isError)(yieldRV)) {
         return yieldRV;
     }
-    const frequencyRV = (0, values_1.toNumberRV)(args[4]);
+    const frequencyRV = (0, values_1.toNumberRV)((0, values_1.topLeft)(args[4]));
     if ((0, values_1.isError)(frequencyRV)) {
         return frequencyRV;
     }
@@ -1911,28 +1937,28 @@ exports.fnMDURATION = fnMDURATION;
  * accrued interest from issue to settlement as par * rate * dcf(issue, settlement, basis).
  */
 const fnACCRINT = args => {
-    const issueRV = (0, values_1.toNumberRV)(args[0]);
+    const issueRV = (0, values_1.toNumberRV)((0, values_1.topLeft)(args[0]));
     if ((0, values_1.isError)(issueRV)) {
         return issueRV;
     }
     // first_interest (args[1]) is unused in the simplified implementation.
-    const settlementRV = (0, values_1.toNumberRV)(args[2]);
+    const settlementRV = (0, values_1.toNumberRV)((0, values_1.topLeft)(args[2]));
     if ((0, values_1.isError)(settlementRV)) {
         return settlementRV;
     }
-    const rateRV = (0, values_1.toNumberRV)(args[3]);
+    const rateRV = (0, values_1.toNumberRV)((0, values_1.topLeft)(args[3]));
     if ((0, values_1.isError)(rateRV)) {
         return rateRV;
     }
-    const parRV = (0, values_1.toNumberRV)(args[4]);
+    const parRV = (0, values_1.toNumberRV)((0, values_1.topLeft)(args[4]));
     if ((0, values_1.isError)(parRV)) {
         return parRV;
     }
-    const frequencyRV = (0, values_1.toNumberRV)(args[5]);
+    const frequencyRV = (0, values_1.toNumberRV)((0, values_1.topLeft)(args[5]));
     if ((0, values_1.isError)(frequencyRV)) {
         return frequencyRV;
     }
-    const basisRV = args.length > 6 ? (0, values_1.toNumberRV)(args[6]) : (0, values_1.rvNumber)(0);
+    const basisRV = args.length > 6 ? (0, values_1.toNumberRV)((0, values_1.topLeft)(args[6])) : (0, values_1.rvNumber)(0);
     if ((0, values_1.isError)(basisRV)) {
         return basisRV;
     }
@@ -1959,23 +1985,23 @@ exports.fnACCRINT = fnACCRINT;
  *   result = par × rate × dayCountFraction(issue, settlement, basis)
  */
 const fnACCRINTM = args => {
-    const issueRV = (0, values_1.toNumberRV)(args[0]);
+    const issueRV = (0, values_1.toNumberRV)((0, values_1.topLeft)(args[0]));
     if ((0, values_1.isError)(issueRV)) {
         return issueRV;
     }
-    const settlementRV = (0, values_1.toNumberRV)(args[1]);
+    const settlementRV = (0, values_1.toNumberRV)((0, values_1.topLeft)(args[1]));
     if ((0, values_1.isError)(settlementRV)) {
         return settlementRV;
     }
-    const rateRV = (0, values_1.toNumberRV)(args[2]);
+    const rateRV = (0, values_1.toNumberRV)((0, values_1.topLeft)(args[2]));
     if ((0, values_1.isError)(rateRV)) {
         return rateRV;
     }
-    const parRV = (0, values_1.toNumberRV)(args[3]);
+    const parRV = (0, values_1.toNumberRV)((0, values_1.topLeft)(args[3]));
     if ((0, values_1.isError)(parRV)) {
         return parRV;
     }
-    const basisRV = args.length > 4 ? (0, values_1.toNumberRV)(args[4]) : (0, values_1.rvNumber)(0);
+    const basisRV = args.length > 4 ? (0, values_1.toNumberRV)((0, values_1.topLeft)(args[4])) : (0, values_1.rvNumber)(0);
     if ((0, values_1.isError)(basisRV)) {
         return basisRV;
     }
@@ -1998,15 +2024,15 @@ exports.fnACCRINTM = fnACCRINTM;
  * where DSM is days from settlement to maturity.
  */
 const fnTBILLPRICE = args => {
-    const settlementRV = (0, values_1.toNumberRV)(args[0]);
+    const settlementRV = (0, values_1.toNumberRV)((0, values_1.topLeft)(args[0]));
     if ((0, values_1.isError)(settlementRV)) {
         return settlementRV;
     }
-    const maturityRV = (0, values_1.toNumberRV)(args[1]);
+    const maturityRV = (0, values_1.toNumberRV)((0, values_1.topLeft)(args[1]));
     if ((0, values_1.isError)(maturityRV)) {
         return maturityRV;
     }
-    const discountRV = (0, values_1.toNumberRV)(args[2]);
+    const discountRV = (0, values_1.toNumberRV)((0, values_1.topLeft)(args[2]));
     if ((0, values_1.isError)(discountRV)) {
         return discountRV;
     }
@@ -2033,15 +2059,15 @@ exports.fnTBILLPRICE = fnTBILLPRICE;
  *   yield = (100 - pr) / pr × (360 / DSM)
  */
 const fnTBILLYIELD = args => {
-    const settlementRV = (0, values_1.toNumberRV)(args[0]);
+    const settlementRV = (0, values_1.toNumberRV)((0, values_1.topLeft)(args[0]));
     if ((0, values_1.isError)(settlementRV)) {
         return settlementRV;
     }
-    const maturityRV = (0, values_1.toNumberRV)(args[1]);
+    const maturityRV = (0, values_1.toNumberRV)((0, values_1.topLeft)(args[1]));
     if ((0, values_1.isError)(maturityRV)) {
         return maturityRV;
     }
-    const prRV = (0, values_1.toNumberRV)(args[2]);
+    const prRV = (0, values_1.toNumberRV)((0, values_1.topLeft)(args[2]));
     if ((0, values_1.isError)(prRV)) {
         return prRV;
     }
@@ -2063,15 +2089,15 @@ exports.fnTBILLYIELD = fnTBILLYIELD;
  *   TBILLEQ = (365 × discount) / (360 - discount × DSM)
  */
 const fnTBILLEQ = args => {
-    const settlementRV = (0, values_1.toNumberRV)(args[0]);
+    const settlementRV = (0, values_1.toNumberRV)((0, values_1.topLeft)(args[0]));
     if ((0, values_1.isError)(settlementRV)) {
         return settlementRV;
     }
-    const maturityRV = (0, values_1.toNumberRV)(args[1]);
+    const maturityRV = (0, values_1.toNumberRV)((0, values_1.topLeft)(args[1]));
     if ((0, values_1.isError)(maturityRV)) {
         return maturityRV;
     }
-    const discountRV = (0, values_1.toNumberRV)(args[2]);
+    const discountRV = (0, values_1.toNumberRV)((0, values_1.topLeft)(args[2]));
     if ((0, values_1.isError)(discountRV)) {
         return discountRV;
     }
@@ -2102,27 +2128,27 @@ exports.fnTBILLEQ = fnTBILLEQ;
  *   price = (100 + DIM × rate × 100) / (1 + DSM × yld) - A × rate × 100
  */
 const fnPRICEMAT = args => {
-    const settlementRV = (0, values_1.toNumberRV)(args[0]);
+    const settlementRV = (0, values_1.toNumberRV)((0, values_1.topLeft)(args[0]));
     if ((0, values_1.isError)(settlementRV)) {
         return settlementRV;
     }
-    const maturityRV = (0, values_1.toNumberRV)(args[1]);
+    const maturityRV = (0, values_1.toNumberRV)((0, values_1.topLeft)(args[1]));
     if ((0, values_1.isError)(maturityRV)) {
         return maturityRV;
     }
-    const issueRV = (0, values_1.toNumberRV)(args[2]);
+    const issueRV = (0, values_1.toNumberRV)((0, values_1.topLeft)(args[2]));
     if ((0, values_1.isError)(issueRV)) {
         return issueRV;
     }
-    const rateRV = (0, values_1.toNumberRV)(args[3]);
+    const rateRV = (0, values_1.toNumberRV)((0, values_1.topLeft)(args[3]));
     if ((0, values_1.isError)(rateRV)) {
         return rateRV;
     }
-    const yldRV = (0, values_1.toNumberRV)(args[4]);
+    const yldRV = (0, values_1.toNumberRV)((0, values_1.topLeft)(args[4]));
     if ((0, values_1.isError)(yldRV)) {
         return yldRV;
     }
-    const basisRV = args.length > 5 ? (0, values_1.toNumberRV)(args[5]) : (0, values_1.rvNumber)(0);
+    const basisRV = args.length > 5 ? (0, values_1.toNumberRV)((0, values_1.topLeft)(args[5])) : (0, values_1.rvNumber)(0);
     if ((0, values_1.isError)(basisRV)) {
         return basisRV;
     }
@@ -2159,27 +2185,27 @@ exports.fnPRICEMAT = fnPRICEMAT;
  *   yield = ((1 + DIM × rate) / (pr/100 + A × rate) - 1) / DSM
  */
 const fnYIELDMAT = args => {
-    const settlementRV = (0, values_1.toNumberRV)(args[0]);
+    const settlementRV = (0, values_1.toNumberRV)((0, values_1.topLeft)(args[0]));
     if ((0, values_1.isError)(settlementRV)) {
         return settlementRV;
     }
-    const maturityRV = (0, values_1.toNumberRV)(args[1]);
+    const maturityRV = (0, values_1.toNumberRV)((0, values_1.topLeft)(args[1]));
     if ((0, values_1.isError)(maturityRV)) {
         return maturityRV;
     }
-    const issueRV = (0, values_1.toNumberRV)(args[2]);
+    const issueRV = (0, values_1.toNumberRV)((0, values_1.topLeft)(args[2]));
     if ((0, values_1.isError)(issueRV)) {
         return issueRV;
     }
-    const rateRV = (0, values_1.toNumberRV)(args[3]);
+    const rateRV = (0, values_1.toNumberRV)((0, values_1.topLeft)(args[3]));
     if ((0, values_1.isError)(rateRV)) {
         return rateRV;
     }
-    const prRV = (0, values_1.toNumberRV)(args[4]);
+    const prRV = (0, values_1.toNumberRV)((0, values_1.topLeft)(args[4]));
     if ((0, values_1.isError)(prRV)) {
         return prRV;
     }
-    const basisRV = args.length > 5 ? (0, values_1.toNumberRV)(args[5]) : (0, values_1.rvNumber)(0);
+    const basisRV = args.length > 5 ? (0, values_1.toNumberRV)((0, values_1.topLeft)(args[5])) : (0, values_1.rvNumber)(0);
     if ((0, values_1.isError)(basisRV)) {
         return basisRV;
     }
@@ -2220,19 +2246,19 @@ exports.fnYIELDMAT = fnYIELDMAT;
  * settlement/maturity/frequency/basis values, or an error.
  */
 function parseCoupArgs(args) {
-    const settlementRV = (0, values_1.toNumberRV)(args[0]);
+    const settlementRV = (0, values_1.toNumberRV)((0, values_1.topLeft)(args[0]));
     if ((0, values_1.isError)(settlementRV)) {
         return settlementRV;
     }
-    const maturityRV = (0, values_1.toNumberRV)(args[1]);
+    const maturityRV = (0, values_1.toNumberRV)((0, values_1.topLeft)(args[1]));
     if ((0, values_1.isError)(maturityRV)) {
         return maturityRV;
     }
-    const frequencyRV = (0, values_1.toNumberRV)(args[2]);
+    const frequencyRV = (0, values_1.toNumberRV)((0, values_1.topLeft)(args[2]));
     if ((0, values_1.isError)(frequencyRV)) {
         return frequencyRV;
     }
-    const basisRV = args.length > 3 ? (0, values_1.toNumberRV)(args[3]) : (0, values_1.rvNumber)(0);
+    const basisRV = args.length > 3 ? (0, values_1.toNumberRV)((0, values_1.topLeft)(args[3])) : (0, values_1.rvNumber)(0);
     if ((0, values_1.isError)(basisRV)) {
         return basisRV;
     }