@equisoft/tax-ca 2021.3.1 → 2021.8.0

package/README.md

@@ -83,6 +83,7 @@ Data relating to federal and provincial income taxes and social charges.
 
 ```
 TAXES
+  |--DividendCredit
   |--EmploymentInsurance
   |--IncomeTax
   |--QuebecParentalInsurancePlan

package/dist/investments/life-income-fund.js

@@ -184,15 +184,15 @@ function getMaxWithdrawalPct(jurisdiction, age) {
         case 'NB':
         case 'NL':
         case 'SK':
-            return exports.province1MaxWithdrawalPct[math_1.clamp(age, 54, 90)];
+            return exports.province1MaxWithdrawalPct[(0, math_1.clamp)(age, 54, 90)];
         case 'QC':
         case 'MB':
         case 'NS':
-            return exports.province2MaxWithdrawalPct[math_1.clamp(age, 54, 89)];
+            return exports.province2MaxWithdrawalPct[(0, math_1.clamp)(age, 54, 89)];
         case 'CA':
-            return exports.federalMaxWithdrawalPct[math_1.clamp(age, 54, 90)];
+            return exports.federalMaxWithdrawalPct[(0, math_1.clamp)(age, 54, 90)];
         default:
-            return exports.othersMaxWithdrawalPct[math_1.clamp(age, 54, 96)];
+            return exports.othersMaxWithdrawalPct[(0, math_1.clamp)(age, 54, 96)];
     }
 }
 exports.getMaxWithdrawalPct = getMaxWithdrawalPct;

package/dist/pension/canada-pension-plan.js

@@ -24,8 +24,10 @@ exports.CPP = {
         PENSIONABLE_EARNINGS: {
             MAX: 61600,
             MIN: 3500,
-            AVG_MAX: 60180,
-            SUP_MAX: 70224,
+            // Average YPE of the last 5 year (including current year)
+            AVG_MAX: 57780,
+            // 114% of AVG_MAX
+            SUP_MAX: 65869,
             SUP_FACTORS: [
                 { FROM: 2019, TO: 2023, FACTOR: 1 },
                 { FROM: 2024, TO: 2024, FACTOR: 1.07 },
@@ -57,14 +59,14 @@ exports.CPP = {
     },
     getRequestDateFactor(birthDate, requestDate, customReferenceDate) {
         const { BONUS, PENALTY } = this.MONTHLY_DELAY;
-        const minRequestDate = date_1.addYearsToDate(birthDate, this.MIN_REQUEST_AGE);
-        const maxRequestDate = date_1.addYearsToDate(birthDate, this.MAX_REQUEST_AGE);
-        const referenceDate = customReferenceDate || date_1.addYearsToDate(birthDate, this.DEFAULT_REFERENCE_AGE);
-        const monthsToToday = date_1.getMonthsDiff(birthDate, date_1.now());
-        const monthsToMinRequestDate = date_1.getMonthsDiff(birthDate, minRequestDate);
-        const monthsToMaxRequestDate = date_1.getMonthsDiff(birthDate, maxRequestDate);
-        const monthsToReferenceDate = date_1.getMonthsDiff(birthDate, referenceDate);
-        const monthsToRequestDate = date_1.getMonthsDiff(birthDate, requestDate);
+        const minRequestDate = (0, date_1.addYearsToDate)(birthDate, this.MIN_REQUEST_AGE);
+        const maxRequestDate = (0, date_1.addYearsToDate)(birthDate, this.MAX_REQUEST_AGE);
+        const referenceDate = customReferenceDate || (0, date_1.addYearsToDate)(birthDate, this.DEFAULT_REFERENCE_AGE);
+        const monthsToToday = (0, date_1.getMonthsDiff)(birthDate, (0, date_1.now)());
+        const monthsToMinRequestDate = (0, date_1.getMonthsDiff)(birthDate, minRequestDate);
+        const monthsToMaxRequestDate = (0, date_1.getMonthsDiff)(birthDate, maxRequestDate);
+        const monthsToReferenceDate = (0, date_1.getMonthsDiff)(birthDate, referenceDate);
+        const monthsToRequestDate = (0, date_1.getMonthsDiff)(birthDate, requestDate);
         const monthsToLastBirthDay = monthsToToday - (monthsToToday % 12);
         // Request date is before minimum request date
         if (monthsToRequestDate < monthsToMinRequestDate) {
@@ -78,13 +80,13 @@ exports.CPP = {
         if (monthsToToday > monthsToReferenceDate && monthsToRequestDate < monthsToLastBirthDay) {
             return 1;
         }
-        let monthsDelta = math_1.clamp(monthsToRequestDate, monthsToMinRequestDate, monthsToMaxRequestDate);
+        let monthsDelta = (0, math_1.clamp)(monthsToRequestDate, monthsToMinRequestDate, monthsToMaxRequestDate);
         monthsDelta -= Math.max(monthsToLastBirthDay, monthsToReferenceDate);
         return 1 + monthsDelta * (monthsDelta >= 0 ? BONUS : PENALTY);
     },
     getAverageIndexationRate() {
         const sum = this.INDEXATION_RATE_REFERENCES.reduce((previous, current) => previous + current[1], 0);
-        return math_1.roundToPrecision(sum / this.INDEXATION_RATE_REFERENCES.length, 3);
+        return (0, math_1.roundToPrecision)(sum / this.INDEXATION_RATE_REFERENCES.length, 3);
     },
     INDEXATION_RATE_REFERENCES: [
         [2007, 0.020],

package/dist/pension/old-age-security.js

@@ -6,7 +6,7 @@ Sources:
     https://www.canada.ca/en/services/benefits/publicpensions/cpp/old-age-security/eligibility.html (delay bonus)
     https://www.canada.ca/en/services/benefits/publicpensions/cpp/old-age-security/payments.html
 
-Revised 2021-05-05
+Revised 2021-11-16
 */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.OAS = void 0;
@@ -14,12 +14,12 @@ const date_1 = require("../utils/date");
 const math_1 = require("../utils/math");
 exports.OAS = {
     getRequestDateFactor(birthDate, requestDate) {
-        const minRequestDate = date_1.addYearsToDate(birthDate, this.MIN_AGE);
-        const maxRequestDate = date_1.addYearsToDate(birthDate, this.MAX_AGE);
-        const monthsToToday = date_1.getMonthsDiff(birthDate, date_1.now());
-        const monthsToMinRequestDate = date_1.getMonthsDiff(birthDate, minRequestDate);
-        const monthsToMaxRequestDate = date_1.getMonthsDiff(birthDate, maxRequestDate);
-        const monthsToRequestDate = date_1.getMonthsDiff(birthDate, requestDate);
+        const minRequestDate = (0, date_1.addYearsToDate)(birthDate, this.MIN_AGE);
+        const maxRequestDate = (0, date_1.addYearsToDate)(birthDate, this.MAX_AGE);
+        const monthsToToday = (0, date_1.getMonthsDiff)(birthDate, (0, date_1.now)());
+        const monthsToMinRequestDate = (0, date_1.getMonthsDiff)(birthDate, minRequestDate);
+        const monthsToMaxRequestDate = (0, date_1.getMonthsDiff)(birthDate, maxRequestDate);
+        const monthsToRequestDate = (0, date_1.getMonthsDiff)(birthDate, requestDate);
         const monthsToLastBirthDay = monthsToToday - (monthsToToday % 12);
         // Request date is before minimum request date
         if (monthsToRequestDate < monthsToMinRequestDate) {
@@ -29,16 +29,16 @@ exports.OAS = {
         if (monthsToMaxRequestDate < monthsToToday || monthsToRequestDate < monthsToLastBirthDay) {
             return 1;
         }
-        let monthsDelta = math_1.clamp(monthsToRequestDate, monthsToMinRequestDate, monthsToMaxRequestDate);
+        let monthsDelta = (0, math_1.clamp)(monthsToRequestDate, monthsToMinRequestDate, monthsToMaxRequestDate);
         monthsDelta -= Math.max(monthsToLastBirthDay, monthsToMinRequestDate);
         return 1 + (monthsDelta * this.MONTHLY_DELAY_BONUS);
     },
     MAX_AGE: 70,
     MIN_AGE: 65,
-    MONTHLY_PAYMENT_MAX: 618.45,
+    MONTHLY_PAYMENT_MAX: 635.26,
     MONTHLY_DELAY_BONUS: 0.006,
     REPAYMENT: {
-        MAX: 128149,
+        MAX: 129757,
         MIN: 79054,
         RATIO: 0.15,
     },

package/dist/pension/quebec-pension-plan.js

@@ -17,8 +17,10 @@ exports.QPP = {
         PENSIONABLE_EARNINGS: {
             MAX: 61600,
             MIN: 3500,
-            AVG_MAX: 60180,
-            SUP_MAX: 70224,
+            // Average YPE of the last 5 year (including current year)
+            AVG_MAX: 57780,
+            // 114% of AVG_MAX
+            SUP_MAX: 65869,
             SUP_FACTORS: [
                 { FROM: 2019, TO: 2023, FACTOR: 1 },
                 { FROM: 2024, TO: 2024, FACTOR: 1.07 },
@@ -50,14 +52,14 @@ exports.QPP = {
     },
     getRequestDateFactor(birthDate, requestDate, customReferenceDate) {
         const { BONUS, PENALTY } = this.MONTHLY_DELAY;
-        const minRequestDate = date_1.addYearsToDate(birthDate, this.MIN_REQUEST_AGE);
-        const maxRequestDate = date_1.addYearsToDate(birthDate, this.MAX_REQUEST_AGE);
-        const referenceDate = customReferenceDate || date_1.addYearsToDate(birthDate, this.DEFAULT_REFERENCE_AGE);
-        const monthsToToday = date_1.getMonthsDiff(birthDate, date_1.now());
-        const monthsToMinRequestDate = date_1.getMonthsDiff(birthDate, minRequestDate);
-        const monthsToMaxRequestDate = date_1.getMonthsDiff(birthDate, maxRequestDate);
-        const monthsToReferenceDate = date_1.getMonthsDiff(birthDate, referenceDate);
-        const monthsToRequestDate = date_1.getMonthsDiff(birthDate, requestDate);
+        const minRequestDate = (0, date_1.addYearsToDate)(birthDate, this.MIN_REQUEST_AGE);
+        const maxRequestDate = (0, date_1.addYearsToDate)(birthDate, this.MAX_REQUEST_AGE);
+        const referenceDate = customReferenceDate || (0, date_1.addYearsToDate)(birthDate, this.DEFAULT_REFERENCE_AGE);
+        const monthsToToday = (0, date_1.getMonthsDiff)(birthDate, (0, date_1.now)());
+        const monthsToMinRequestDate = (0, date_1.getMonthsDiff)(birthDate, minRequestDate);
+        const monthsToMaxRequestDate = (0, date_1.getMonthsDiff)(birthDate, maxRequestDate);
+        const monthsToReferenceDate = (0, date_1.getMonthsDiff)(birthDate, referenceDate);
+        const monthsToRequestDate = (0, date_1.getMonthsDiff)(birthDate, requestDate);
         const monthsToLastBirthDay = monthsToToday - (monthsToToday % 12);
         // Request date is before minimum request date
         if (monthsToRequestDate < monthsToMinRequestDate) {
@@ -71,13 +73,13 @@ exports.QPP = {
         if (monthsToToday > monthsToReferenceDate && monthsToRequestDate < monthsToLastBirthDay) {
             return 1;
         }
-        let monthsDelta = math_1.clamp(monthsToRequestDate, monthsToMinRequestDate, monthsToMaxRequestDate);
+        let monthsDelta = (0, math_1.clamp)(monthsToRequestDate, monthsToMinRequestDate, monthsToMaxRequestDate);
         monthsDelta -= Math.max(monthsToLastBirthDay, monthsToReferenceDate);
         return 1 + monthsDelta * (monthsDelta >= 0 ? BONUS : PENALTY);
     },
     getAverageIndexationRate() {
         const sum = this.INDEXATION_RATE_REFERENCES.reduce((previous, current) => previous + current[1], 0);
-        return math_1.roundToPrecision(sum / this.INDEXATION_RATE_REFERENCES.length, 2);
+        return (0, math_1.roundToPrecision)(sum / this.INDEXATION_RATE_REFERENCES.length, 2);
     },
     INDEXATION_RATE_REFERENCES: [
         [2007, 0.021],

package/dist/taxes/dividend-credit.d.ts

@@ -0,0 +1,8 @@
+import { FederalCode, ProvinceCode } from '../misc';
+export declare type DividendTaxCreditRate = {
+    GROSS_UP: number;
+} & {
+    [key in ProvinceCode | FederalCode]: number;
+};
+export declare const NON_ELIGIBLE_DIVIDEND: DividendTaxCreditRate;
+export declare const ELIGIBLE_DIVIDEND: DividendTaxCreditRate;

package/dist/taxes/dividend-credit.js

@@ -0,0 +1,44 @@
+"use strict";
+/*
+Sources:
+    non-eligible dividends: https://www.taxtips.ca/dtc/non-eligible-dividend-tax-credit.htm
+    eligible dividends: https://www.taxtips.ca/dtc/eligible-dividends/eligible-dividend-tax-credit-rates.htm
+
+Revised 2021-11-02
+*/
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ELIGIBLE_DIVIDEND = exports.NON_ELIGIBLE_DIVIDEND = void 0;
+exports.NON_ELIGIBLE_DIVIDEND = {
+    GROSS_UP: 1.15,
+    CA: 0.090301,
+    AB: 0.0218,
+    BC: 0.0196,
+    MB: 0.007835,
+    NB: 0.0275,
+    NL: 0.035,
+    NS: 0.0299,
+    NT: 0.06,
+    NU: 0.0261,
+    ON: 0.029863,
+    PE: 0.0196,
+    QC: 0.0401,
+    SK: 0.01695,
+    YT: 0.0067,
+};
+exports.ELIGIBLE_DIVIDEND = {
+    GROSS_UP: 1.38,
+    CA: 0.150198,
+    AB: 0.0812,
+    BC: 0.12,
+    MB: 0.08,
+    NB: 0.14,
+    NL: 0.054,
+    NS: 0.0885,
+    NT: 0.115,
+    NU: 0.0551,
+    ON: 0.1,
+    PE: 0.105,
+    QC: 0.117,
+    SK: 0.11,
+    YT: 0.1202,
+};

package/dist/taxes/income-tax.js

@@ -527,27 +527,27 @@ exports.getProvincialBaseCredit = getProvincialBaseCredit;
 function getTotalMarginalRate(provincialCode, grossIncome, inflationRate = 0, yearsToInflate = 0) {
     const provRate = getProvincialMarginalRate(provincialCode, grossIncome, inflationRate, yearsToInflate);
     const fedRate = getFederalMarginalRate(provincialCode, grossIncome, inflationRate, yearsToInflate);
-    return utils_1.roundToPrecision(provRate + fedRate, 4);
+    return (0, utils_1.roundToPrecision)(provRate + fedRate, 4);
 }
 exports.getTotalMarginalRate = getTotalMarginalRate;
 function getMaxProvincialMarginalRate(provincialCode) {
     // tslint:disable-next-line:no-non-null-assertion
-    const marginalRate = collections_1.maxBy(getTaxRates(provincialCode), (bracket) => bracket.TO).RATE;
+    const marginalRate = (0, collections_1.maxBy)(getTaxRates(provincialCode), (bracket) => bracket.TO).RATE;
     // tslint:disable-next-line:no-non-null-assertion
-    const surtaxRate = collections_1.maxBy(getSurtaxRates(provincialCode), bracket => bracket.TO).RATE;
+    const surtaxRate = (0, collections_1.maxBy)(getSurtaxRates(provincialCode), bracket => bracket.TO).RATE;
     return marginalRate + (marginalRate * surtaxRate);
 }
 exports.getMaxProvincialMarginalRate = getMaxProvincialMarginalRate;
 function getMaxFederalMarginalRate(provincialCode) {
     // tslint:disable-next-line:no-non-null-assertion
-    const maxRate = collections_1.maxBy(getTaxRates(code_types_1.FEDERAL_CODE), bracket => bracket.TO).RATE;
+    const maxRate = (0, collections_1.maxBy)(getTaxRates(code_types_1.FEDERAL_CODE), bracket => bracket.TO).RATE;
     return maxRate * (1 - getAbatement(provincialCode));
 }
 exports.getMaxFederalMarginalRate = getMaxFederalMarginalRate;
 function getTotalMaxMarginalRate(provincialCode) {
     const provRate = getMaxProvincialMarginalRate(provincialCode);
     const fedRate = getMaxFederalMarginalRate(provincialCode);
-    return utils_1.roundToPrecision(provRate + fedRate, 4);
+    return (0, utils_1.roundToPrecision)(provRate + fedRate, 4);
 }
 exports.getTotalMaxMarginalRate = getTotalMaxMarginalRate;
 function getTotalTaxAmount(provincialCode, grossIncome, inflationRate = 0, yearsToInflate = 0) {

package/dist/taxes/index.d.ts

@@ -1,3 +1,4 @@
+export * from './dividend-credit';
 export * from './employment-insurance';
 export * from './income-tax';
 export * from './quebec-parental-insurance-plan';

package/dist/taxes/index.js

@@ -10,6 +10,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./dividend-credit"), exports);
 __exportStar(require("./employment-insurance"), exports);
 __exportStar(require("./income-tax"), exports);
 __exportStar(require("./quebec-parental-insurance-plan"), exports);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@equisoft/tax-ca",
-  "version": "2021.3.1",
+  "version": "2021.8.0",
   "description": "Canadian tax data and calculation functions.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -35,13 +35,13 @@
   },
   "devDependencies": {
     "@equisoft/tslint-config": "~0.0.8",
-    "@types/jest": "~26.0.4",
-    "@types/node": "^15.0.1",
+    "@types/jest": "~27.0.1",
+    "@types/node": "^16.0.0",
     "jest": "~24.9.0",
-    "jest-junit": "~12.0.0",
+    "jest-junit": "~13.0.0",
     "ts-jest": "~24.3.0",
     "tslint": "~5.20.0",
-    "typescript": "~4.2.3"
+    "typescript": "~4.5.2"
   },
   "dependencies": {}
 }