moneyfunx 3.0.4 → 3.0.8

package/build/tests/debt/sorting.test.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=sorting.test.d.ts.map

package/build/tests/debt/sorting.test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"sorting.test.d.ts","sourceRoot":"","sources":["../../../tests/debt/sorting.test.ts"],"names":[],"mappings":""}

package/build/tests/debt/sorting.test.js

@@ -1,43 +0,0 @@
-var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
-    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
-    return new (P || (P = Promise))(function (resolve, reject) {
-        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
-        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
-        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
-        step((generator = generator.apply(thisArg, _arguments || [])).next());
-    });
-};
-import { describe, expect, it } from 'vitest';
-import { Loan } from '@/lib/debt/loan';
-import * as sorting from '@/lib/shared/sorting';
-const Loans = () => [
-    new Loan(7500, 0.068, 12, 10, 'uno'),
-    new Loan(4500, 0.0429, 12, 10, 'dos'),
-    new Loan(7500, 0.0368, 12, 10, 'tres'),
-];
-describe('sorting module', () => {
-    const loans = Loans();
-    const [loan2, loan3, loan1] = loans;
-    it('avalanche compares loans correctly', () => __awaiter(void 0, void 0, void 0, function* () {
-        expect(sorting.avalanche(loan2, loan1)).toBeCloseTo(-0.031200, 5);
-        expect(sorting.avalanche(loan3, loan1)).toBeCloseTo(-0.006100, 5);
-    }));
-    it('snowball compares loans correctly', () => __awaiter(void 0, void 0, void 0, function* () {
-        expect(sorting.snowball(loan2, loan3)).toBe(3000);
-        expect(sorting.snowball(loan2, loan1)).toBe(0);
-    }));
-    it('orders loans correctly using avalanche sorting', () => __awaiter(void 0, void 0, void 0, function* () {
-        expect(sorting.sortWith(loans, sorting.avalanche)).toStrictEqual([
-            loan2,
-            loan3,
-            loan1,
-        ]);
-    }));
-    it('orders loans correctly using snowball sorting', () => __awaiter(void 0, void 0, void 0, function* () {
-        expect(sorting.sortWith(loans, sorting.snowball)).toStrictEqual([
-            loan3,
-            loan2,
-            loan1,
-        ]);
-    }));
-});

package/build/tests/index.test.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=index.test.d.ts.map

package/build/tests/index.test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.test.d.ts","sourceRoot":"","sources":["../../tests/index.test.ts"],"names":[],"mappings":""}

package/build/tests/index.test.js

@@ -1,66 +0,0 @@
-var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
-    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
-    return new (P || (P = Promise))(function (resolve, reject) {
-        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
-        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
-        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
-        step((generator = generator.apply(thisArg, _arguments || [])).next());
-    });
-};
-import { describe, expect, it } from 'vitest';
-import * as moneyfunx from '@/index';
-/**
- * Ensures all intended public members are exported from the library.
- * This test acts as a safeguard against accidental omission of core functionality
- * during refactors or version bumps.
- */
-describe('moneyfunx module', () => {
-    it('exports expected members matching the new descriptive naming standard', () => __awaiter(void 0, void 0, void 0, function* () {
-        const expectedExports = [
-            // Constants
-            'MAX_DURATION_YEARS',
-            'TOTALS',
-            // Debt / Loans
-            'ILoan',
-            'Loan',
-            'determineExtraPayment',
-            'amortizePayments',
-            'payLoans',
-            'LoansPaymentSchedule',
-            'LoanPrincipals',
-            'PaymentSchedule',
-            'PaymentRecord',
-            // Investment / Accumulation
-            'IInstrument',
-            'Instrument',
-            'amortizeContributions',
-            'contributeInstruments',
-            'determineExtraContribution',
-            'ContributionRecord',
-            'ContributionSchedule',
-            'InstrumentsContributionSchedule',
-            // Drawdown / Distribution
-            'calculateAmortizedWithdrawal',
-            'drawdownInstruments',
-            'WithdrawalRecord',
-            'WithdrawalSchedule',
-            'InstrumentsWithdrawalSchedule',
-            'performWaterfallDrawdown',
-            // Shared Math Primitives
-            'calculatePeriodicAmount',
-            'calculateBalanceRemaining',
-            'calculatePeriodsToZero',
-            'calculateInterestOverPeriods',
-            // Errors
-            'NegativeContributionError',
-            'PaymentTooLowError',
-            'NegativeWithdrawalError',
-            // Shared Utilities
-            'HasRateAndBalance',
-            'snowball',
-            'avalanche',
-            'sortWith',
-        ].sort();
-        expect(Object.keys(moneyfunx).sort()).toStrictEqual(expectedExports);
-    }));
-});

package/build/tests/investment/contributions.test.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=contributions.test.d.ts.map

package/build/tests/investment/contributions.test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"contributions.test.d.ts","sourceRoot":"","sources":["../../../tests/investment/contributions.test.ts"],"names":[],"mappings":""}

package/build/tests/investment/contributions.test.js

@@ -1,113 +0,0 @@
-var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
-    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
-    return new (P || (P = Promise))(function (resolve, reject) {
-        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
-        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
-        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
-        step((generator = generator.apply(thisArg, _arguments || [])).next());
-    });
-};
-import { describe, expect, it } from 'vitest';
-import * as constants from '@/lib/constants';
-import { Instrument } from '@/lib/investment/instrument';
-import * as contributions from '@/lib/investment/contributions';
-const Instruments = () => [
-    new Instrument(10000, 0.11, 12, 'IRA', 6500),
-    new Instrument(45000, 0.085, 12, '401(K)', 23500),
-    new Instrument(0, 0.042666667, 12, 'ABC'),
-];
-describe('contributions module', () => {
-    const instruments = Instruments();
-    const [inst1, inst2, inst3] = instruments;
-    it('amortizes a single instrument', () => __awaiter(void 0, void 0, void 0, function* () {
-        const iraAmortizationSchedulePre = contributions.amortizeContributions(inst1, inst1.currentBalance, inst1.periodicContribution(), 60, 0, true);
-        expect(iraAmortizationSchedulePre.length).toBe(60);
-        expect(iraAmortizationSchedulePre[3].period).toBe(4);
-        expect(iraAmortizationSchedulePre[3].contribution).toBeCloseTo(541.666666, 5);
-        expect(iraAmortizationSchedulePre[3].growth).toBeCloseTo(109.243473, 5);
-        expect(iraAmortizationSchedulePre[3].currentBalance).toBeCloseTo(12568.380024, 5);
-        expect(iraAmortizationSchedulePre[44].period).toBe(45);
-        expect(iraAmortizationSchedulePre[44].contribution).toBeCloseTo(541.666666, 5);
-        expect(iraAmortizationSchedulePre[44].growth).toBeCloseTo(404.570099, 5);
-        expect(iraAmortizationSchedulePre[44].currentBalance).toBeCloseTo(45081.156667, 5);
-        const iraAmortizationSchedulePost = contributions.amortizeContributions(inst1, inst1.currentBalance, inst1.periodicContribution(), 60, 0, false);
-        expect(iraAmortizationSchedulePost.length).toBe(60);
-        expect(iraAmortizationSchedulePost[3].period).toBe(4);
-        expect(iraAmortizationSchedulePost[3].contribution).toBeCloseTo(541.666666, 5);
-        expect(iraAmortizationSchedulePost[3].growth).toBeCloseTo(114.346552, 5);
-        expect(iraAmortizationSchedulePost[3].currentBalance).toBeCloseTo(12588.515898, 5);
-        expect(iraAmortizationSchedulePost[44].period).toBe(45);
-        expect(iraAmortizationSchedulePost[44].contribution).toBeCloseTo(541.666666, 5);
-        expect(iraAmortizationSchedulePost[44].growth).toBeCloseTo(411.988512, 5);
-        expect(iraAmortizationSchedulePost[44].currentBalance).toBeCloseTo(45356.189858, 5);
-    }));
-    it('uses annualLimits on instruments', () => __awaiter(void 0, void 0, void 0, function* () {
-        const workAcctAmortizationSchedule = contributions.amortizeContributions(inst2, inst2.currentBalance, 2000, 24);
-        expect(workAcctAmortizationSchedule.length).toBe(24);
-        expect(workAcctAmortizationSchedule[3].period).toBe(4);
-        expect(workAcctAmortizationSchedule[3].contribution).toBe(23500 / 12);
-        expect(workAcctAmortizationSchedule[3].growth).toBeCloseTo(367.481578, 5);
-        expect(workAcctAmortizationSchedule[3].currentBalance).toBeCloseTo(54205.567182, 5);
-        expect(workAcctAmortizationSchedule[23].period).toBe(24);
-        expect(workAcctAmortizationSchedule[23].contribution).toBe(23500 / 12);
-        expect(workAcctAmortizationSchedule[23].growth).toBeCloseTo(720.115315, 5);
-        expect(workAcctAmortizationSchedule[23].currentBalance).toBeCloseTo(104341.787377, 5);
-    }));
-    it('determines extra contributions', () => __awaiter(void 0, void 0, void 0, function* () {
-        expect(contributions.determineExtraContribution(instruments, 2250)).toBe(0);
-        expect(contributions.determineExtraContribution(instruments, 3000)).toBe(500);
-    }));
-    it('amortizes contributions for multiple instruments', () => __awaiter(void 0, void 0, void 0, function* () {
-        const instrumentsContributionSummary = contributions.contributeInstruments(instruments, 2250, 300);
-        expect(Object.keys(instrumentsContributionSummary).length).toBe(4);
-        expect(instrumentsContributionSummary[inst1.id].lifetimeContribution).toBeCloseTo(162499.999999, 5);
-        expect(instrumentsContributionSummary[inst1.id].lifetimeGrowth).toBeCloseTo(835717.757059, 5);
-        expect(instrumentsContributionSummary[inst1.id].amortizationSchedule.length).toBe(300);
-        // correct below given current code
-        // but need to write ways to default/spread a single contribution across instruments
-        expect(instrumentsContributionSummary[inst3.id].lifetimeContribution).toBe(0);
-        expect(instrumentsContributionSummary[inst3.id].lifetimeGrowth).toBe(0);
-        expect(instrumentsContributionSummary[inst3.id].amortizationSchedule.length).toBe(300);
-        expect(instrumentsContributionSummary[constants.TOTALS].lifetimeContribution).toBeCloseTo(674999.999999, 5);
-        expect(instrumentsContributionSummary[constants.TOTALS].lifetimeGrowth).toBeCloseTo(2415285.956132, 5);
-        expect(instrumentsContributionSummary[constants.TOTALS].amortizationSchedule.length).toBe(300);
-        // period 28
-        expect(instrumentsContributionSummary[inst1.id].amortizationSchedule[27].period).toBe(28);
-        expect(instrumentsContributionSummary[inst1.id].amortizationSchedule[27].contribution).toBeCloseTo(541.666666, 5);
-        expect(instrumentsContributionSummary[inst1.id].amortizationSchedule[27].growth).toBeCloseTo(268.604841, 5);
-        expect(instrumentsContributionSummary[inst1.id].amortizationSchedule[27].currentBalance).toBeCloseTo(30112.617826, 5);
-        expect(instrumentsContributionSummary[inst2.id].amortizationSchedule[27].period).toBe(28);
-        expect(instrumentsContributionSummary[inst2.id].amortizationSchedule[27].contribution).toBeCloseTo(1708.333333, 5);
-        expect(instrumentsContributionSummary[inst2.id].amortizationSchedule[27].growth).toBeCloseTo(744.328300, 5);
-        expect(instrumentsContributionSummary[inst2.id].amortizationSchedule[27].currentBalance).toBeCloseTo(107534.304119, 5);
-        // correct below given current code
-        // but need to write ways to default/spread a single contribution across instruments
-        expect(instrumentsContributionSummary[inst3.id].amortizationSchedule[27].period).toBe(28);
-        expect(instrumentsContributionSummary[inst3.id].amortizationSchedule[27].contribution).toBe(0);
-        expect(instrumentsContributionSummary[inst3.id].amortizationSchedule[27].growth).toBe(0);
-        expect(instrumentsContributionSummary[inst3.id].amortizationSchedule[27].currentBalance).toBe(0);
-        expect(instrumentsContributionSummary[constants.TOTALS].amortizationSchedule[27].period).toBe(28);
-        expect(instrumentsContributionSummary[constants.TOTALS].amortizationSchedule[27].contribution).toBe(2250);
-        expect(instrumentsContributionSummary[constants.TOTALS].amortizationSchedule[27].growth).toBeCloseTo(1012.933142, 5);
-        expect(instrumentsContributionSummary[constants.TOTALS].amortizationSchedule[27].currentBalance).toBeCloseTo(137646.921945, 5);
-        // period 272
-        expect(instrumentsContributionSummary[inst1.id].amortizationSchedule[271].period).toBe(272);
-        expect(instrumentsContributionSummary[inst1.id].amortizationSchedule[271].contribution).toBeCloseTo(541.666666, 5);
-        expect(instrumentsContributionSummary[inst1.id].amortizationSchedule[271].growth).toBeCloseTo(6967.253017, 5);
-        expect(instrumentsContributionSummary[inst1.id].amortizationSchedule[271].currentBalance).toBeCloseTo(767572.885191, 5);
-        expect(instrumentsContributionSummary[inst2.id].amortizationSchedule[271].period).toBe(272);
-        expect(instrumentsContributionSummary[inst2.id].amortizationSchedule[271].contribution).toBeCloseTo(1708.333333, 5);
-        expect(instrumentsContributionSummary[inst2.id].amortizationSchedule[271].growth).toBeCloseTo(12019.353385, 5);
-        expect(instrumentsContributionSummary[inst2.id].amortizationSchedule[271].currentBalance).toBeCloseTo(1710577.576386, 5);
-        // correct below given current code
-        // but need to write ways to default/spread a single contribution across instruments
-        expect(instrumentsContributionSummary[inst3.id].amortizationSchedule[271].period).toBe(272);
-        expect(instrumentsContributionSummary[inst3.id].amortizationSchedule[271].contribution).toBe(0);
-        expect(instrumentsContributionSummary[inst3.id].amortizationSchedule[271].growth).toBe(0);
-        expect(instrumentsContributionSummary[inst3.id].amortizationSchedule[271].currentBalance).toBe(0);
-        expect(instrumentsContributionSummary[constants.TOTALS].amortizationSchedule[271].period).toBe(272);
-        expect(instrumentsContributionSummary[constants.TOTALS].amortizationSchedule[271].contribution).toBe(2250);
-        expect(instrumentsContributionSummary[constants.TOTALS].amortizationSchedule[271].growth).toBeCloseTo(18986.606402, 5);
-        expect(instrumentsContributionSummary[constants.TOTALS].amortizationSchedule[271].currentBalance).toBeCloseTo(2478150.461577, 5);
-    }));
-});

package/build/tests/investment/instrument.test.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=instrument.test.d.ts.map

package/build/tests/investment/instrument.test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"instrument.test.d.ts","sourceRoot":"","sources":["../../../tests/investment/instrument.test.ts"],"names":[],"mappings":""}

package/build/tests/investment/instrument.test.js

@@ -1,57 +0,0 @@
-var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
-    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
-    return new (P || (P = Promise))(function (resolve, reject) {
-        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
-        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
-        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
-        step((generator = generator.apply(thisArg, _arguments || [])).next());
-    });
-};
-import { describe, expect, it } from 'vitest';
-import { Instrument } from '@/lib/investment/instrument';
-const Instruments = () => [
-    new Instrument(10000, 0.11, 12, 'IRA', 6500),
-    new Instrument(45000, 0.085, 12, '401(K)', 23500),
-    new Instrument(0, 0.042666667, 12, 'ABC'),
-];
-describe('instrument module', () => {
-    const [inst1, inst2, inst3] = Instruments();
-    it('creates an Instrument with proper attributes', () => __awaiter(void 0, void 0, void 0, function* () {
-        expect(inst1.name).toBe('IRA');
-        expect(inst1.currentBalance).toBe(10000);
-        expect(inst1.annualRate).toBe(0.11);
-        expect(inst1.periodicRate).toBeCloseTo(0.009166, 5);
-        expect(inst1.periodicContribution()).toBeCloseTo(541.666666, 5);
-        expect(inst1.annualLimit).toBe(6500);
-    }));
-    it('defaults attributes appropriately', () => __awaiter(void 0, void 0, void 0, function* () {
-        expect(inst3.annualLimit).toBe(0);
-        expect(inst3.periodicContribution()).toBe(0);
-    }));
-    it('validates contributions', () => __awaiter(void 0, void 0, void 0, function* () {
-        const negativeContribution = -177;
-        expect(inst2.validateContribution(2000, 22400)).toBe(1100);
-        expect(inst3.validateContribution(2000, 22400)).toBe(2000);
-        expect(inst2.validateContribution(2000, 24400)).toBe(0);
-        expect(() => inst1.validateContribution(negativeContribution, 2000)).toThrow(`contribution of ${negativeContribution} must be greater than/equal to zero`);
-    }));
-    it('accrues interest', () => __awaiter(void 0, void 0, void 0, function* () {
-        expect(inst2.accrueInterest()).toBe(318.75);
-        expect(inst2.accrueInterest(1000)).toBeCloseTo(7.083333, 5);
-        expect(inst3.accrueInterest()).toBe(0);
-        expect(inst3.accrueInterest(200)).toBeCloseTo(0.711111, 5);
-    }));
-    describe('instrument module - drawdown methods', () => {
-        const testInstrument = new Instrument(10000, 0.06, 12, 'Test Acc');
-        it('calculates periods to zero (numWithdrawalsToZero)', () => {
-            // Covers instrument.ts lines 87-95
-            const periods = testInstrument.numWithdrawalsToZero(500);
-            expect(periods).toBe(22);
-        });
-        it('calculates maximum sustainable withdrawal (calculateMaxWithdrawal)', () => {
-            // Covers instrument.ts lines 105-113
-            const maxWithdrawal = testInstrument.calculateMaxWithdrawal(12);
-            expect(maxWithdrawal).toBeCloseTo(860.66, 2);
-        });
-    });
-});

package/build/tests/investment/strategies.test.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=strategies.test.d.ts.map

package/build/tests/investment/strategies.test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"strategies.test.d.ts","sourceRoot":"","sources":["../../../tests/investment/strategies.test.ts"],"names":[],"mappings":""}

package/build/tests/investment/strategies.test.js

@@ -1,15 +0,0 @@
-import { describe, expect, it } from 'vitest';
-import { Instrument } from '@/lib/investment/instrument';
-import { performWaterfallDrawdown } from '@/lib/investment/strategies';
-import * as constants from '@/lib/constants';
-describe('strategies module', () => {
-    it('executes a waterfall drawdown and handles depletion', () => {
-        const smallAccount = new Instrument(1000, 0.05, 12, 'Small');
-        const largeAccount = new Instrument(100000, 0.05, 12, 'Large');
-        // Request more than Small has in one period
-        const results = performWaterfallDrawdown([smallAccount, largeAccount], 5000, 1, 0);
-        expect(results[smallAccount.id].amortizationSchedule[0].currentBalance).toBe(0);
-        expect(results[largeAccount.id].amortizationSchedule[0].withdrawal).toBeGreaterThan(0);
-        expect(results[constants.TOTALS].lifetimeWithdrawal).toBe(5000);
-    });
-});

package/build/tests/investment/withdrawals.test.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=withdrawals.test.d.ts.map

package/build/tests/investment/withdrawals.test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"withdrawals.test.d.ts","sourceRoot":"","sources":["../../../tests/investment/withdrawals.test.ts"],"names":[],"mappings":""}

package/build/tests/investment/withdrawals.test.js

@@ -1,66 +0,0 @@
-var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
-    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
-    return new (P || (P = Promise))(function (resolve, reject) {
-        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
-        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
-        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
-        step((generator = generator.apply(thisArg, _arguments || [])).next());
-    });
-};
-import { describe, expect, it } from 'vitest';
-import * as constants from '@/lib/constants';
-import { Instrument } from '@/lib/investment/instrument';
-import { calculateAmortizedWithdrawal, drawdownInstruments } from '@/lib/investment/withdrawals';
-const Instruments = () => [
-    new Instrument(50000, 0.06, 12, 'Taxable Account'),
-    new Instrument(100000, 0.08, 12, 'IRA Account'),
-];
-describe('withdrawals module', () => {
-    const [taxableAccount, iraAccount] = Instruments();
-    it('calculates a single period amortized withdrawal (Accrue Before)', () => __awaiter(void 0, void 0, void 0, function* () {
-        const record = calculateAmortizedWithdrawal(taxableAccount, 50000, 2000, 0, 0.15, true);
-        // 50,000 * (0.06/12) = 250 growth
-        // 50,250 - 2000 withdrawal = 48,250
-        expect(record.growth).toBe(250);
-        expect(record.currentBalance).toBe(48250);
-        expect(record.netAmount).toBe(2000 * 0.85);
-    }));
-    it('calculates a single period amortized withdrawal (Withdraw Before)', () => __awaiter(void 0, void 0, void 0, function* () {
-        // This covers withdrawals.ts lines 51-63
-        const record = calculateAmortizedWithdrawal(taxableAccount, 50000, 2000, 0, 0.15, false);
-        // 50,000 - 2000 = 48,000
-        // 48,000 * (0.06/12) = 240 growth
-        // 48,000 + 240 = 48,240
-        expect(record.growth).toBe(240);
-        expect(record.currentBalance).toBe(48240);
-        expect(record.netAmount).toBe(1700);
-    }));
-    it('draws down multiple instruments and validates comprehensive schedules', () => __awaiter(void 0, void 0, void 0, function* () {
-        const targetNetIncome = 3000;
-        const simulationDuration = 36;
-        const taxRate = 0.10;
-        const summary = drawdownInstruments([taxableAccount, iraAccount], targetNetIncome, simulationDuration, taxRate);
-        // Verify lifetime totals match the sum of individual schedules (style of payments.test.ts)
-        for (const instrument of [taxableAccount, iraAccount]) {
-            const computedLifetimeGrowth = summary[instrument.id].amortizationSchedule
-                .reduce((sum, record) => sum + record.growth, 0);
-            expect(summary[instrument.id].lifetimeGrowth).toBeCloseTo(computedLifetimeGrowth, 5);
-        }
-        // Verify global totals structure
-        expect(Object.keys(summary).length).toBe(3); // 2 instruments + TOTALS
-        expect(summary[constants.TOTALS].amortizationSchedule.length).toBe(36);
-        // Check final period balance
-        const lastRecord = summary[constants.TOTALS].amortizationSchedule[35];
-        expect(lastRecord.period).toBe(36);
-        expect(lastRecord.currentBalance).toBeLessThan(150000);
-    }));
-    describe('withdrawals module - validation', () => {
-        const testAccount = new Instrument(10000, 0.05, 12, 'Test Account');
-        it('throws a NegativeWithdrawalError when the withdrawal amount is less than zero', () => {
-            const negativeWithdrawalAmount = -500;
-            expect(() => {
-                calculateAmortizedWithdrawal(testAccount, testAccount.currentBalance, negativeWithdrawalAmount, 0, 0.15);
-            }).toThrow(`withdrawal of ${negativeWithdrawalAmount} must be greater than/equal to zero`);
-        });
-    });
-});

package/build/tests/shared/primitives.test.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=primitives.test.d.ts.map

package/build/tests/shared/primitives.test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"primitives.test.d.ts","sourceRoot":"","sources":["../../../tests/shared/primitives.test.ts"],"names":[],"mappings":""}

package/build/tests/shared/primitives.test.js

@@ -1,76 +0,0 @@
-import { describe, expect, it } from 'vitest';
-import * as sharedFinancialPrimitives from '@/lib/shared/primitives';
-/**
- * Unit tests for shared financial primitives.
- * These tests ensure the core mathematical engine for the library is accurate
- * across various interest rates and durations.
- */
-describe('shared financial primitives', () => {
-    // Shared test constants for consistency across test cases
-    const initialPrincipalBalance = 10000;
-    const annualInterestRate = 0.05;
-    const periodicInterestRate = annualInterestRate / 12;
-    const totalLoanPeriods = 120; // 10 years in months
-    describe('calculatePeriodicAmount (PMT)', () => {
-        it('should calculate the standard amortization payment correctly', () => {
-            const calculatedPeriodicAmount = sharedFinancialPrimitives.calculatePeriodicAmount(initialPrincipalBalance, periodicInterestRate, totalLoanPeriods);
-            // Expected: $10,000 at 5% for 120 periods is ~$106.0655
-            expect(calculatedPeriodicAmount).toBeCloseTo(106.0655, 4);
-        });
-        it('should handle zero percent interest rates via simple division', () => {
-            const simplePrincipalBalance = 12000;
-            const zeroInterestRate = 0;
-            const twelveMonths = 12;
-            const calculatedPeriodicAmount = sharedFinancialPrimitives.calculatePeriodicAmount(simplePrincipalBalance, zeroInterestRate, twelveMonths);
-            expect(calculatedPeriodicAmount).toBe(1000);
-        });
-    });
-    describe('calculateBalanceRemaining (FV)', () => {
-        it('should calculate the correct remaining balance after a specific number of periods', () => {
-            const fixedPeriodicPayment = 150;
-            const periodsElapsed = 12;
-            const remainingBalance = sharedFinancialPrimitives.calculateBalanceRemaining(initialPrincipalBalance, fixedPeriodicPayment, periodicInterestRate, periodsElapsed);
-            // Corrected math expectation for 1 year of $150 payments at 5%
-            expect(remainingBalance).toBeCloseTo(8669.7907, 4);
-        });
-        it('should return zero if the balance is overpaid within the specified periods', () => {
-            const smallInitialBalance = 1000;
-            const largePeriodicPayment = 1200;
-            const singlePeriod = 1;
-            const remainingBalance = sharedFinancialPrimitives.calculateBalanceRemaining(smallInitialBalance, largePeriodicPayment, periodicInterestRate, singlePeriod);
-            expect(remainingBalance).toBe(0);
-        });
-        it('should calculate the correct remaining balance for zero percent interest scenarios', () => {
-            const zeroInterestRate = 0;
-            const fixedPeriodicPayment = 100;
-            const fivePeriodsElapsed = 5;
-            const remainingBalance = sharedFinancialPrimitives.calculateBalanceRemaining(1000, fixedPeriodicPayment, zeroInterestRate, fivePeriodsElapsed);
-            expect(remainingBalance).toBe(500);
-        });
-    });
-    describe('calculatePeriodsToZero (NPER)', () => {
-        it('should calculate the total number of periods required to reach a zero balance', () => {
-            const fixedPeriodicPayment = 200;
-            const totalPeriodsRequired = sharedFinancialPrimitives.calculatePeriodsToZero(initialPrincipalBalance, fixedPeriodicPayment, periodicInterestRate);
-            // $10,000 at 5% with $200 payments rounds up to 57 months
-            expect(totalPeriodsRequired).toBe(57);
-        });
-    });
-    describe('calculateInterestOverPeriods', () => {
-        it('should calculate the total interest paid during a set duration', () => {
-            // Using a slightly more precise payment to match amortization curve
-            const fixedPeriodicPayment = 106.07;
-            const oneYearInMonths = 12;
-            const totalInterestPaid = sharedFinancialPrimitives.calculateInterestOverPeriods(initialPrincipalBalance, fixedPeriodicPayment, periodicInterestRate, oneYearInMonths);
-            // Total interest for the first year should be approximately $482.04
-            expect(totalInterestPaid).toBeCloseTo(482.04, 2);
-        });
-        it('should return zero interest for loans with a zero percent interest rate', () => {
-            const zeroInterestRate = 0;
-            const fixedPeriodicPayment = 100;
-            const fivePeriods = 5;
-            const totalInterestPaid = sharedFinancialPrimitives.calculateInterestOverPeriods(1000, fixedPeriodicPayment, zeroInterestRate, fivePeriods);
-            expect(totalInterestPaid).toBe(0);
-        });
-    });
-});