salario-pt 1.0.0

package/README.md

@@ -0,0 +1,84 @@
+# salario
+
+Node.js package to calculate Portuguese net salary from gross salary, using official IRS tax tables.
+
+## Install
+
+```bash
+npm install
+```
+
+## CLI
+
+```bash
+node cli.js <salary> [situation] [numDependents] [year]
+```
+
+Only salary is required. Defaults: `NotMarried`, `0` dependents, `2025`.
+
+```bash
+node cli.js 1500
+# Gross: 1500€ | Net: 1148.9€ | IRS: 186.1€ | SS: 165€
+
+node cli.js 2000 MarriedOneHolder 1 2025
+# Gross: 2000€ | Net: 1637.69€ | IRS: 142.31€ | SS: 220€
+```
+
+## Programmatic Usage
+
+```js
+const { calculateSalary } = require('./index');
+```
+
+### calculateSalary(options)
+
+Calculates the full salary breakdown for a given gross salary.
+
+```js
+const result = calculateSalary({
+  situation: 'NotMarried',
+  numDependents: 0,
+  year: '2026',
+  salary: 1500
+});
+
+console.log(result);
+/*
+  { 
+    grossSalary: 1500, 
+    netSalary: 1166.8, 
+    ssDiscount: 168.17, 
+    irsDiscount: 165, 
+    companyMonthlyCost: 2165.63, 
+    companyAnnualCost 25987.5
+  }
+*/
+```
+
+
+**Parameters:**
+
+| Field | Type | Description |
+|-------|------|-------------|
+| `situation` | string | `'NotMarried'`, `'MarriedOneHolder'`, or `'MarriedTwoHolders'` |
+| `numDependents` | number | Number of dependents (0-5+) |
+| `year` | string | Tax year: `'2026'`, `'2025'`, `'2024_03'`, `'2024_02'`, `'2024'`, or `'2023'` |
+| `salary` | number | Gross monthly salary in euros |
+
+**Returns:** `{ grossSalary, netSalary, ssDiscount, irsDiscount, companyMonthlyCost, companyAnnualCost }`
+
+## Test
+
+```bash
+npm test
+```
+
+## How it works
+
+1. Loads CSV tax tables from `data/` (parsed with papaparse, cached after first load)
+2. Determines the tax type based on situation, dependents, and year
+3. Finds the matching tax bracket for the gross salary
+4. Calculates:
+   - **IRS discount** = (gross x tax rate) - parcela a abater - (adicional x dependents), minimum 0
+   - **SS discount** = gross x 11%
+   - **Net salary** = gross - IRS discount - SS discount

package/cli.js

@@ -0,0 +1,30 @@
+#!/usr/bin/env node
+
+const { calculateSalary } = require('./index');
+
+const args = process.argv.slice(2);
+
+if (args.length < 1) {
+  console.log('Usage: node cli.js <salary> [situation] [numDependents] [year]');
+  console.log('');
+  console.log('  salary          Gross monthly salary in euros');
+  console.log('  situation       NotMarried (default), MarriedOneHolder, MarriedTwoHolders');
+  console.log('  numDependents   Number of dependents, 0-5+ (default: 0)');
+  console.log('  year            2026 (default), 2024_03, 2024_02, 2024, 2023');
+  console.log('');
+  console.log('Examples:');
+  console.log('  node cli.js 1500');
+  console.log('  node cli.js 1500 MarriedOneHolder 1 2025');
+  process.exit(1);
+}
+
+const salary = parseFloat(args[0]);
+const situation = args[1] || 'NotMarried';
+const numDependents = parseInt(args[2] || '0', 10);
+const year = args[3] || '2026';
+
+const result = calculateSalary({ salary, situation, numDependents, year });
+
+console.log(`Gross: ${result.grossSalary}€ | Net: ${result.netSalary}€ | IRS: ${result.irsDiscount}€ | SS: ${result.ssDiscount}€`);
+console.log(`Company Monthly Cost: ${result.companyMonthlyCost}€`)
+console.log(`Company Annual Cost: ${result.companyAnnualCost}€`)

package/data/taxas_continente_2023.csv

@@ -0,0 +1,114 @@
+tipo;sinal;limite;maximo;parcela_abater;var1;var2;adicional;var3
+SOLD;max;762;0,00%;0;0;0;0;0
+SOLD;max;886,57;14,50%;14,50%;2,3;1114,71;34,29;2,1
+SOLD;max;932,14;21,00%;21,00%;1,3;1376,37;34,29;4,3
+SOLD;max;999,14;21,00%;121,28;0;0;34,29;5,4
+SOLD;max;1106,93;26,50%;176,23;0;0;34,29;7,5
+SOLD;max;1600,36;28,50%;198,37;0;0;34,29;14
+SOLD;max;1961,36;35,00%;302,39;0;0;34,29;17,8
+SOLD;max;2529,05;37,00%;341,62;0;0;34,29;22,1
+SOLD;max;3694,46;38,72%;384,99;0;0;34,29;27,4
+SOLD;max;5469,9;40,05%;434,32;0;0;34,29;31,5
+SOLD;max;6420,55;42,72%;580,36;0;0;34,29;33,1
+SOLD;max;20064,21;44,95%;723,22;0;0;34,29;41,2
+SOLD;min;20064,21;47,17%;1169,65;0;0;34,29;-1
+SOLCAS2;max;762;0,00%;0;0;0;0;0
+SOLCAS2;max;886,57;14,50%;14,50%;2,3;1093,31;0;6,7
+SOLCAS2;max;932,14;21,00%;21,00%;1,3;1350,22;0;8,8
+SOLCAS2;max;999,14;21,00%;114,14;0;0;0;9,6
+SOLCAS2;max;1106,93;26,50%;169,09;0;0;0;11,2
+SOLCAS2;max;1600,36;28,50%;191,23;0;0;0;16,6
+SOLCAS2;max;1961,36;35,00%;295,26;0;0;0;19,9
+SOLCAS2;max;2529,05;37,00%;334,48;0;0;0;23,8
+SOLCAS2;max;3694,46;38,72%;377,86;0;0;0;28,5
+SOLCAS2;max;5469,9;40,05%;427,18;0;0;0;32,2
+SOLCAS2;max;6420,55;42,72%;573,22;0;0;0;33,8
+SOLCAS2;max;20064,21;44,95%;716,08;0;0;0;41,4
+SOLCAS2;min;20064,21;47,17%;1162,51;0;0;0;-1
+CAS2D;max;762;0,00%;0;0;0;0;0
+CAS2D;max;886,57;14,50%;14,50%;2,3;1093,3;21,43;4,3
+CAS2D;max;932,14;21,00%;21,00%;1,3;1350,21;21,43;6,5
+CAS2D;max;999,14;21,00%;114,14;0;0;21,43;7,4
+CAS2D;max;1106,93;26,50%;169,09;0;0;21,43;9,3
+CAS2D;max;1600,36;28,50%;191,23;0;0;21,43;15,2
+CAS2D;max;1961,36;35,00%;295,25;0;0;21,43;18,9
+CAS2D;max;2529,05;37,00%;334,48;0;0;21,43;22,9
+CAS2D;max;3694,46;38,72%;377,85;0;0;21,43;27,9
+CAS2D;max;5469,9;40,05%;427,18;0;0;21,43;31,8
+CAS2D;max;6420,55;42,72%;573,22;0;0;21,43;33,5
+CAS2D;max;20064,21;44,95%;716,08;0;0;21,43;41,3
+CAS2D;min;20064,21;47,17%;1162,51;0;0;21,43;-1
+CAS1;max;762;0,00%;0;0;0;0;0
+CAS1;max;886,57;14,50%;14,50%;2,3;1153,28;0;4,5
+CAS1;max;932,14;14,50%;14,50%;1,883;1212,39;0;6,3
+CAS1;max;999,14;14,50%;76,51;0;0;0;7,1
+CAS1;max;1106,93;15,93%;91,2;0;0;0;8,8
+CAS1;max;1600,36;21,00%;156,03;0;0;0;11,8
+CAS1;max;1961,36;24,68%;218,66;0;0;0;13,5
+CAS1;max;2529,05;27,58%;275,52;0;0;0;16,7
+CAS1;max;3694,46;29,80%;331,54;0;0;0;20,8
+CAS1;max;5469,9;33,11%;453,94;0;0;0;25,9
+CAS1;max;6420,55;38,72%;808,52;0;0;0;26,1
+CAS1;max;20064,21;42,51%;1052,4;0;0;0;37,3
+CAS1;min;20064,21;47,17%;1986,71;0;0;0;-1
+CAS1D;max;762;0,00%;0;0;0;0;0
+CAS1D;max;886,57;14,50%;14,50%;2,3;1146,84;42,86;0
+CAS1D;max;932,14;14,50%;14,50%;1,883;1204,55;42,86;1,9
+CAS1D;max;999,14;14,50%;74,37;0;0;42,86;2,8
+CAS1D;max;1106,93;15,93%;88,64;0;0;42,86;4,1
+CAS1D;max;1600,36;21,00%;144,78;0;0;42,86;9,3
+CAS1D;max;1961,36;24,68%;203,73;0;0;42,86;12,1
+CAS1D;max;2529,05;27,58%;260,59;0;0;42,86;15,6
+CAS1D;max;3694,46;29,80%;316,61;0;0;42,86;20,1
+CAS1D;max;5469,9;33,11%;439,01;0;0;42,86;24,3
+CAS1D;max;6420,55;38,72%;745,55;0;0;42,86;26,4
+CAS1D;max;20064,21;42,51%;989,43;0;0;42,86;37,4
+CAS1D;min;20064,21;47,17%;1923,74;0;0;42,86;-1
+SOLCAS2+DEF;max;1519,41;0,00%;0;0;0;0;0
+SOLCAS2+DEF;max;1971,21;26,50%;402,64;0;0;0;6,1
+SOLCAS2+DEF;max;2093,21;28,50%;442,07;0;0;0;7,4
+SOLCAS2+DEF;max;2354,21;35,00%;578,13;0;0;0;10,4
+SOLCAS2+DEF;max;4015,41;37,00%;625,21;0;0;0;21,4
+SOLCAS2+DEF;max;4252,25;38,72%;694,08;0;0;0;22,4
+SOLCAS2+DEF;max;6527,69;40,05%;750,84;0;0;0;28,5
+SOLCAS2+DEF;max;6621,19;42,72%;925,13;0;0;0;28,7
+SOLCAS2+DEF;max;20264,85;44,95%;1072,45;0;0;0;39,7
+SOLCAS2+DEF;min;20264,85;47,17%;1523,35;0;0;0;-1
+SOLD+DEF;max;1677,09;0,00%;0;0;0;0;0
+SOLD+DEF;max;2042,64;26,50%;401,57;0;0;42,86;4,7
+SOLD+DEF;max;2307,5;28,50%;442,42;0;0;42,86;7,5
+SOLD+DEF;max;2425,64;35,00%;592,41;0;0;42,86;8,8
+SOLD+DEF;max;3743,98;37,00%;640,92;0;0;42,86;18,7
+SOLD+DEF;max;4252,25;38,72%;705,13;0;0;42,86;21,1
+SOLD+DEF;max;6527,69;40,05%;761,9;0;0;42,86;27,7
+SOLD+DEF;max;6621,19;42,72%;936,19;0;0;42,86;27,9
+SOLD+DEF;max;20264,85;44,95%;1083,51;0;0;42,86;39,4
+SOLD+DEF;min;20264,85;47,17%;1534,4;0;0;42,86;-1
+CAS2D+DEF;max;1574,66;0,00%;0;0;0;0;0
+CAS2D+DEF;max;2185,5;26,50%;395,86;0;0;21,43;7,4
+CAS2D+DEF;max;2307,5;28,50%;439,57;0;0;21,43;8,5
+CAS2D+DEF;max;2354,21;35,00%;589,55;0;0;21,43;9
+CAS2D+DEF;max;3301,12;37,00%;636,64;0;0;21,43;17,1
+CAS2D+DEF;max;4252,25;38,72%;693,25;0;0;21,43;21,9
+CAS2D+DEF;max;6527,69;40,05%;750,02;0;0;21,43;28,2
+CAS2D+DEF;max;6621,19;42,72%;924,31;0;0;21,43;28,4
+CAS2D+DEF;max;20264,85;44,95%;1071,63;0;0;21,43;39,6
+CAS2D+DEF;min;20264,85;47,17%;1522,52;0;0;21,43;-1
+CAS1+DEF;max;1779,19;0,00%;0;0;0;0;0
+CAS1+DEF;max;2664,64;21,00%;373,63;0;0;0;7
+CAS1+DEF;max;2818,5;24,68%;471,79;0;0;0;7,9
+CAS1+DEF;max;3051,12;27,58%;553,49;0;0;0;9,4
+CAS1+DEF;max;3395,1;29,80%;621,08;0;0;0;11,5
+CAS1+DEF;max;6527,69;33,11%;733,56;0;0;0;21,9
+CAS1+DEF;max;6621,19;38,72%;1099,39;0;0;0;22,1
+CAS1+DEF;max;20264,85;42,51%;1350,89;0;0;0;35,8
+CAS1+DEF;min;20264,85;47,17%;2294,54;0;0;0;-1
+CAS1D+DEF;max;1881,23;0,00%;0;0;0;0;0
+CAS1D+DEF;max;2664,64;21,00%;352,2;0;0;42,86;6,2
+CAS1D+DEF;max;2818,5;24,68%;450,36;0;0;42,86;7,2
+CAS1D+DEF;max;3051,12;27,58%;532,06;0;0;42,86;8,7
+CAS1D+DEF;max;3395,1;29,80%;599,65;0;0;42,86;10,9
+CAS1D+DEF;max;6527,69;33,11%;712,13;0;0;42,86;21,5
+CAS1D+DEF;max;6621,19;38,72%;1077,96;0;0;42,86;21,8
+CAS1D+DEF;min;20264,85;42,51%;1329,46;0;0;42,86;35,7
+CAS1D+DEF;min;20264,85;47,17%;2273,11;0;0;42,86;-1

package/data/taxas_continente_2024.csv

@@ -0,0 +1,70 @@
+tipo;sinal;limite;maximo;parcela_abater;var1;var2;adicional;var3
+SOLD;max;820,00;0,00%;0;0;0;0;0
+SOLD;max;935,00;13,25%;13,25%;2,6;1135,39;34,29;2,2
+SOLD;max;1001,00;18,00%;18,00%;1,4;1385,2;34,29;4,9
+SOLD;max;1123,00;18,00%;96,82;0;0;34,29;6,3
+SOLD;max;1765,00;26,00%;186,66;0;0;34,29;13,5
+SOLD;max;2057,00;32,75%;305,80;0;0;34,29;16,2
+SOLD;max;2664,00;37,00%;393,23;0;0;34,29;21
+SOLD;max;3193,00;38,72%;439,05;0;0;34,29;23,9
+SOLD;max;4173,00;40,05%;481,52;0;0;34,29;27,7
+SOLD;max;5470,00;41,00%;521,17;0;0;34,29;30,8
+SOLD;max;6540,00;42,70%;614,16;0;0;34,29;32,8
+SOLD;max;20067,00;44,95%;761,31;0;0;34,29;41
+SOLD;min;20067,00;47,17%;1206,80;0;0;34,29;-1
+SOLCAS2;max;820,00;0,00%;0;0;0;0;0
+SOLCAS2;max;935,00;13,25%;13,25%;2,6;1135,39;21,43;5,9
+SOLCAS2;max;1001,00;18,00%;18,00%;1,4;1385,2;21,43;8,3
+SOLCAS2;max;1123,00;18,00%;96,82;0;0;21,43;9,4
+SOLCAS2;max;1765,00;26,00%;186,66;0;0;21,43;15,4
+SOLCAS2;max;2057,00;32,75%;305,80;0;0;21,43;17,9
+SOLCAS2;max;2664,00;37,00%;393,23;0;0;21,43;22,2
+SOLCAS2;max;3193,00;38,72%;439,05;0;0;21,43;25
+SOLCAS2;max;4173,00;40,05%;481,52;0;0;21,43;28,5
+SOLCAS2;max;5470,00;41,00%;521,17;0;0;21,43;31,5
+SOLCAS2;max;6540,00;42,70%;614,16;0;0;21,43;33,3
+SOLCAS2;max;20067,00;44,95%;761,31;0;0;21,43;41,2
+SOLCAS2;min;20067,00;47,17%;1206,80;0;0;21,43;-1
+CAS1;max;857,00;0,00%;0;0;0;0;0
+CAS1;max;935,00;13,25%;13,25%;2,6;1186,62;42,86;4
+CAS1;max;1001,00;13,25%;13,25%;1,4;1402,3;42,86;5,8
+CAS1;max;1393,00;13,25%;74,44;0;0;42,86;7,9
+CAS1;max;1900,00;18,50%;147,57;0;0;42,86;10,7
+CAS1;max;2801,00;26,00%;290,07;0;0;42,86;15,6
+CAS1;max;3423,00;28,00%;346,09;0;0;42,86;17,9
+CAS1;max;4099,00;29,15%;385,46;0;0;42,86;19,7
+CAS1;max;5800,00;32,50%;522,78;0;0;42,86;23,5
+CAS1;max;6422,00;36,00%;725,78;0;0;42,86;24,7
+CAS1;max;20064,21;42,50%;1143,21;0;0;42,86;36,8
+CAS1;min;20064,21;47,17%;2080,2;0;0;42,86;-1
+SOLCAS2+DEF;max;1519,41;0,00%;0;0;0;0;0
+SOLCAS2+DEF;max;1648,29;13,25%;201,32;0;0;0;1,0
+SOLCAS2+DEF;max;1994,61;23,00%;362,03;0;0;0;4,8
+SOLCAS2+DEF;max;2410,71;32,75%;556,51;0;0;0;9,7
+SOLCAS2+DEF;max;4373,75;37,00%;658,97;0;0;0;21,9
+SOLCAS2+DEF;max;6621,18;40,05%;792,37;0;0;0;28,1
+SOLCAS2+DEF;max;6717,41;42,28%;940,03;0;0;0;28,3
+SOLCAS2+DEF;max;20264,85;44,95%;1119,39;0;0;0;39,4
+SOLCAS2+DEF;min;20264,85;47,17%;1569,27;0;0;0;-1
+SOLD+DEF;max;1677,09;0,00%;0;0;0;0;0
+SOLD+DEF;max;1994,61;23,00%;385,73;0;0;42,86;1,5
+SOLD+DEF;max;2410,71;32,75%;580,21;0;0;42,86;6,9
+SOLD+DEF;max;4373,75;37,00%;682,67;0;0;42,86;20,4
+SOLD+DEF;max;6621,18;40,05%;816,07;0;0;42,86;27,1
+SOLD+DEF;max;6717,41;42,28%;963,73;0;0;42,86;27,3
+SOLD+DEF;max;20264,85;44,95%;1143,09;0;0;42,86;39,1
+SOLD+DEF;min;20264,85;47,17%;1592,97;0;0;42,86;-1
+CAS2D+DEF;max;1574,66;0,00%;0;0;0;0;0
+CAS2D+DEF;max;1648,29;13,25%;208,64;0;0;21,43;0
+CAS2D+DEF;max;1994,61;23,00%;369,35;0;0;21,43;2,4
+CAS2D+DEF;max;2410,71;32,75%;563,83;0;0;21,43;8,5
+CAS2D+DEF;max;4373,75;37,00%;666,29;0;0;21,43;21,3
+CAS2D+DEF;max;6621,18;40,05%;799,69;0;0;21,43;27,6
+CAS2D+DEF;max;6717,41;42,28%;947,35;0;0;21,43;27,9
+CAS2D+DEF;max;20264,85;44,95%;1126,71;0;0;21,43;39,3
+CAS2D+DEF;min;20264,85;47,17%;1576,59;0;0;21,43;-1
+CAS1+DEF;max;2105,51;0,00%;0;0;0;0;0
+CAS1+DEF;max;3622,95;31,60%;719,35;0;0;42,86;11,7
+CAS1+DEF;max;6587,01;33,00%;770,07;0;0;42,86;21,3
+CAS1+DEF;max;20264,85;42,50%;1395,84;0;0;42,86;35,6
+CAS1+DEF;min;20264,85;47,17%;2342,21;0;0;42,86;-1

package/data/taxas_continente_2024_02.csv

@@ -0,0 +1,68 @@
+tipo;sinal;limite;maximo;parcela_abater;var1;var2;adicional;var3
+SOLD;max;820;0,00%;0;0;0;0;0
+SOLD;max;935;0,00%;0,00%;0;0;34,29;0
+SOLD;max;989;0,00%;0,00%;0;0;34,29;0
+SOLD;max;1125;0,00%;0;0;0;34,29;0
+SOLD;max;1175;0,00%;0;0;0;34,29;0
+SOLD;max;1769;3,75%;44,07;0;0;34,29;1,3
+SOLD;max;2057;8,00%;119,25;0;0;34,29;2,2
+SOLD;max;2408;10,65%;173,76;0;0;34,29;3,4
+SOLD;max;3201;19,36%;383,44;0;0;34,29;7,4
+SOLD;max;5492;40,05%;1045,8;0;0;34,29;21
+SOLD;max;20021;44,95%;1314,64;0;0;34,29;38,4
+SOLD;min;20021;47,17%;1760,1;0;0;34,29;-1
+SOLCAS2;max;820;0,00%;0;0;0;0;0
+SOLCAS2;max;935;0,00%;0,00%;0;0;21,43;0
+SOLCAS2;max;989;0,00%;0,00%;0;0;21,43;0
+SOLCAS2;max;1125;0,00%;0;0;0;21,43;0
+SOLCAS2;max;1175;0,00%;0;0;0;21,43;0
+SOLCAS2;max;1769;3,75%;44,07;0;0;21,43;1,3
+SOLCAS2;max;2057;8,00%;119,25;0;0;21,43;2,2
+SOLCAS2;max;2408;10,65%;173,76;0;0;21,43;3,4
+SOLCAS2;max;3201;19,36%;383,44;0;0;21,43;7,4
+SOLCAS2;max;5492;40,05%;1045,8;0;0;21,43;21
+SOLCAS2;max;20021;44,95%;1314,64;0;0;21,43;38,4
+SOLCAS2;min;20021;47,17%;1760,1;0;0;21,43;-1
+CAS1;max;904;0,00%;0;0;0;0;0
+CAS1;max;935;0,00%;0,00%;0;0;42,86;0
+CAS1;max;989;0,00%;0,00%;0;0;42,86;0
+CAS1;max;1070;0,00%;0;0;0;42,86;0
+CAS1;max;1394;0,00%;0;0;0;42,86;0
+CAS1;max;1912;1,65%;23,01;0;0;42,86;0,4
+CAS1;max;2178;5,05%;87,95;0;0;42,86;1
+CAS1;max;2671;5,91%;106,69;0;0;42,86;1,9
+CAS1;max;3284;12,97%;295,33;0;0;42,86;4
+CAS1;max;5906;30,72%;878,33;0;0;42,86;15,8
+CAS1;max;20064;38,72%;1350,25;0;0;42,86;32
+CAS1;min;20064;47,17%;3046,68;0;0;42,86;-1
+SOLCAS2+DEF;max;1677;0,00%;0;0;0;0;0
+SOLCAS2+DEF;max;2012;5,00%;83,83;0;0;0;0,8
+SOLCAS2+DEF;max;2428;8,00%;144,2;0;0;0;2,1
+SOLCAS2+DEF;max;4376;10,65%;208,55;0;0;0;5,9
+SOLCAS2+DEF;max;4634;19,36%;589,61;0;0;0;6,6
+SOLCAS2+DEF;max;6621;40,05%;1548,47;0;0;0;16,7
+SOLCAS2+DEF;max;20265;44,95%;1872,58;0;0;0;35,7
+SOLCAS2+DEF;min;20265;47,17%;2323,47;0;0;0;-1
+SOLD+DEF;max;1919;0,00%;0;0;0;0;0
+SOLD+DEF;max;2012;5,53%;106,1;0;0;42,86;0,3
+SOLD+DEF;max;2785;8,00%;155,82;0;0;42,86;2,4
+SOLD+DEF;max;4394;17,75%;427,41;0;0;42,86;8
+SOLD+DEF;max;6687;34,84%;1178,52;0;0;42,86;17,2
+SOLD+DEF;max;6978;40,05%;1526,7;0;0;42,86;18,2
+SOLD+DEF;max;20265;44,95%;1868,29;0;0;42,86;35,7
+SOLD+DEF;min;20265;47,17%;2319,18;0;0;42,86;-1
+CAS2D+DEF;max;1651;0,00%;0;0;0;0;0
+CAS2D+DEF;max;2023;5,50%;90,81;0;0;21,43;1
+CAS2D+DEF;max;2441;6,25%;105,98;0;0;21,43;1,9
+CAS2D+DEF;max;3037;9,60%;187,75;0;0;21,43;3,4
+CAS2D+DEF;max;4394;17,75%;435,26;0;0;21,43;7,8
+CAS2D+DEF;max;6687;34,84%;1186,37;0;0;21,43;17,1
+CAS2D+DEF;max;6978;40,05%;1534,55;0;0;21,43;18,1
+CAS2D+DEF;max;20265;44,95%;1876,14;0;0;21,43;35,7
+CAS2D+DEF;min;20265;47,17%;2327,03;0;0;21,43;-1
+CAS1+DEF;max;2302;0,00%;0;0;0;0;0
+CAS1+DEF;max;3394;7,09%;163,15;0;0;42,86;2,3
+CAS1+DEF;max;3652;12,97%;362,8;0;0;42,86;3
+CAS1+DEF;max;6621;27,65%;898,97;0;0;42,86;14,1
+CAS1+DEF;max;20265;42,44%;1878,34;0;0;42,86;33,2
+CAS1+DEF;min;20265;47,17%;2836,1;0;0;42,86;-1

package/data/taxas_continente_2024_03.csv

@@ -0,0 +1,68 @@
+tipo;sinal;limite;maximo;parcela_abater;var1;var2;adicional;var3
+SOLD;max;820;0,00%;0;0;0;0;0
+SOLD;max;935;13,00%;13,00%;2,6;1135,39;34,29;5,8
+SOLD;max;989;16,50%;16,50%;1,35;1386,11;34,29;7,6
+SOLD;max;1125;16,50%;88,39;0;0;34,29;9
+SOLD;max;1175;22,00%;150,26;0;0;34,29;9,2
+SOLD;max;1769;25,00%;185,5;0;0;34,29;14,5
+SOLD;max;2057;32,00%;309,36;0;0;34,29;17
+SOLD;max;2408;35,50%;381,35;0;0;34,29;19,7
+SOLD;max;3201;38,72%;458,76;0;0;34,29;24,4
+SOLD;max;5492;40,05%;501,49;0;0;34,29;30,9
+SOLD;max;20021;44,95%;770,33;0;0;34,29;41,1
+SOLD;min;20021;47,17%;1215,8;0;0;34,29;-1
+SOLCAS2;max;820;0,00%;0;0;0;0;0
+SOLCAS2;max;935;13,00%;13,00%;2,6;1135,39;21,43;5,8
+SOLCAS2;max;989;16,50%;16,50%;1,35;1386,11;21,43;7,6
+SOLCAS2;max;1125;16,50%;88,39;0;0;21,43;8,6
+SOLCAS2;max;1175;22,00%;150,26;0;0;21,43;9,2
+SOLCAS2;max;1769;25,00%;185,5;0;0;21,43;14,5
+SOLCAS2;max;2057;32,00%;309,36;0;0;21,43;17
+SOLCAS2;max;2408;35,50%;381,35;0;0;21,43;19,7
+SOLCAS2;max;3201;38,72%;458,76;0;0;21,43;24,4
+SOLCAS2;max;5492;40,05%;501,49;0;0;21,43;30,9
+SOLCAS2;max;20021;44,95%;770,33;0;0;21,43;41,1
+SOLCAS2;min;20021;47,17%;1215,8;0;0;21,43;-1
+CAS1;max;904;0,00%;0;0;0;0;0
+CAS1;max;935;13,00%;13,00%;2,6;1251,62;42,86;1,6
+CAS1;max;989;13,00%;13,00%;1,35;1545,09;42,86;3,1
+CAS1;max;1070;13,00%;97,54;0;0;42,86;3,9
+CAS1;max;1394;13,20%;99,68;0;0;42,86;6
+CAS1;max;1912;16,50%;145,69;0;0;42,86;8,9
+CAS1;max;2178;20,18%;216,11;0;0;42,86;10,3
+CAS1;max;2671;23,62%;291,09;0;0;42,86;12,7
+CAS1;max;3284;25,94%;352,9;0;0;42,86;15,2
+CAS1;max;5906;30,72%;510,04;0;0;42,86;22,1
+CAS1;max;20064;38,72%;981,97;0;0;42,86;33,8
+CAS1;min;20064;47,17%;2678,4;0;0;42,86;-1
+SOLCAS2+DEF;max;1677;0,00%;0;0;0;0;0
+SOLCAS2+DEF;max;2012;22,00%;368,86;0;0;0;3,7
+SOLCAS2+DEF;max;2428;32,00%;570,08;0;0;0;8,5
+SOLCAS2+DEF;max;4376;35,50%;655,08;0;0;0;20,05
+SOLCAS2+DEF;max;4634;38,72%;795,77;0;0;0;21,5
+SOLCAS2+DEF;max;6621;40,05%;857,63;0;0;0;27,1
+SOLCAS2+DEF;max;20265;44,95%;1181,74;0;0;0;39,1
+SOLCAS2+DEF;min;20265;47,17%;1632,63;0;0;0;-1
+SOLD+DEF;max;1919;0,00%;0;0;0;0;0
+SOLD+DEF;max;2012;22,12%;424,35;0;0;42,86;1
+SOLD+DEF;max;2785;32,00%;623,26;0;0;42,86;9,6
+SOLD+DEF;max;4394;35,50%;720,75;0;0;42,86;19,1
+SOLD+DEF;max;6687;38,72%;862,02;0;0;42,86;25,8
+SOLD+DEF;max;6978;40,05%;951,3;0;0;42,86;26,4
+SOLD+DEF;max;20265;44,95%;1292,88;0;0;42,86;38,6
+SOLD+DEF;min;20265;47,17%;1743,78;0;0;42,86;-1
+CAS2D+DEF;max;1651;0,00%;0;0;0;0;0
+CAS2D+DEF;max;2023;22,00%;363,15;0;0;21,43;4
+CAS2D+DEF;max;2441;25,00%;423,84;0;0;21,43;7,6
+CAS2D+DEF;max;3037;32,00%;594,69;0;0;21,43;12,4
+CAS2D+DEF;max;4394;35,50%;700,99;0;0;21,43;19,5
+CAS2D+DEF;max;6687;38,72%;842,26;0;0;21,43;26,1
+CAS2D+DEF;max;6978;40,05%;931,54;0;0;21,43;26,7
+CAS2D+DEF;max;20265;44,95%;1273,12;0;0;21,43;38,7
+CAS2D+DEF;min;20265;47,17%;1724,02;0;0;21,43;-1
+CAS1+DEF;max;2302;0,00%;0;0;0;0;0
+CAS1+DEF;max;3394;23,62%;543,85;0;0;42,86;7,6
+CAS1+DEF;max;3652;25,94%;622,41;0;0;42,86;8,9
+CAS1+DEF;max;6621;30,72%;797,17;0;0;42,86;18,7
+CAS1+DEF;max;20265;42,44%;1573,11;0;0;42,86;34,7
+CAS1+DEF;min;20265;47,17%;2530,87;0;0;42,86;-1

package/data/taxas_continente_2025.csv

@@ -0,0 +1,68 @@
+tipo;sinal;limite;maximo;parcela_abater;var1;var2;adicional;var3
+SOLD;max;870;0,00%;0;0;0;0;0
+SOLD;max;992;13,00%;13,00%;2,6;1208,32;34,29;5,6
+SOLD;max;1070;16,50%;16,50%;1,35;1477,67;34,29;8
+SOLD;max;1136;16,50%;90,81;0;0;34,29;8,5
+SOLD;max;1187;22,00%;153,29;0;0;34,29;9,1
+SOLD;max;1787;25,00%;188,90;0;0;34,29;14,4
+SOLD;max;2078;32,00%;313,99;0;0;34,29;16,9
+SOLD;max;2432;35,50%;386,72;0;0;34,29;19,6
+SOLD;max;3233;38,72%;465,03;0;0;34,29;24,3
+SOLD;max;5547;40,05%;508,03;0;0;34,29;30,9
+SOLD;max;20221;44,95%;779,83;0;0;34,29;41,1
+SOLD;min;20221;47,17%;1228,74;0;0;34,29;-1
+SOLCAS2;max;870;0,00%;0;0;0;0;0
+SOLCAS2;max;992;13,00%;13,00%;2,6;1208,32;21,43;5,6
+SOLCAS2;max;1070;16,50%;16,50%;1,35;1477,67;21,43;8
+SOLCAS2;max;1136;16,50%;90,81;0;0;21,43;8,5
+SOLCAS2;max;1187;22,00%;153,29;0;0;21,43;9,1
+SOLCAS2;max;1787;25,00%;188,90;0;0;21,43;14,4
+SOLCAS2;max;2078;32,00%;313,99;0;0;21,43;16,9
+SOLCAS2;max;2432;35,50%;386,72;0;0;21,43;19,6
+SOLCAS2;max;3233;38,72%;465,03;0;0;21,43;24,3
+SOLCAS2;max;5547;40,05%;508,03;0;0;21,43;30,9
+SOLCAS2;max;20221;44,95%;779,83;0;0;21,43;41,1
+SOLCAS2;min;20221;47,71%;1228,74;0;0;21,43;-1
+CAS1;max;957;0,00%;0;0;0;0;0
+CAS1;max;992;13,00%;13,00%;2,6;1324,55;42,86;1,7
+CAS1;max;1070;13,00%;13,00%;1,35;1632,65;42,86;3,8
+CAS1;max;1081;13,00%;98,75;0;0;42,86;3,9
+CAS1;max;1408;13,20%;100,91;0;0;42,86;6
+CAS1;max;1931;16,50%;147,37;0;0;42,86;8,9
+CAS1;max;2200;20,18%;218,43;0;0;42,86;10,3
+CAS1;max;2698;23,62%;294,11;0;0;42,86;12,7
+CAS1;max;3317;25,94%;356,70;0;0;42,86;15,2
+CAS1;max;5965;30,72%;515,25;0;0;42,86;22,1
+CAS1;max;20265;38,72%;992,45;0;0;42,86;33,8
+CAS1;min;20265;47,17%;2704,84;0;0;42,86;-1
+SOLCAS2+DEF;max;1694;0,00%;0;0;0;0;0
+SOLCAS2+DEF;max;2032;22,00%;372,68;0;0;0;3,7
+SOLCAS2+DEF;max;2452;32,00%;575,88;0;0;0;8,5
+SOLCAS2+DEF;max;4220;35,50%;661,7;0;0;0;20,05
+SOLCAS2+DEF;max;4680;38,72%;804,02;0;0;0;21,5
+SOLCAS2+DEF;max;6867;40.05%;866,26;0;0;0;27,1
+SOLCAS2+DEF;max;20468;44,95%;1193,92;0;0;0;39,1
+SOLCAS2+DEF;min;20468;47,17%;1648,31;0;0;0;-1
+SOLD+DEF;max;1938;0,00%;0;0;0;0;0
+SOLD+DEF;max;2032;22,12%;428,69;0;0;42,86;1
+SOLD+DEF;max;2813;32,00%;629,45;0;0;42,86;9,6
+SOLD+DEF;max;4438;35,50%;727,91;0;0;42,86;19,1
+SOLD+DEF;max;6754;38,72%;870,81;0;0;42,86;25,8
+SOLD+DEF;max;7048;40,05%;960,64;0;0;42,86;26,4
+SOLD+DEF;max;20468;44,95%;1305,99;0;0;42,86;38,6
+SOLD+DEF;min;20468;47,17%;1760,38;0;0;42,86;-1
+CAS2D+DEF;max;1668;0,00%;0;0;0;0;0
+CAS2D+DEF;max;2043;22,00%;366,96;0;0;21,43;4
+CAS2D+DEF;max;2465;25,00%;428,25;0;0;21,43;7,6
+CAS2D+DEF;max;3067;32,00%;600,8;0;0;21,43;12,4
+CAS2D+DEF;max;4438;35,50%;708,15;0;0;21,43;19,5
+CAS2D+DEF;max;6754;38,72%;851,05;0;0;21,43;26,1
+CAS2D+DEF;max;7048;40,05%;940,88;0;0;21,43;26,7
+CAS2D+DEF;max;20468;44,95%;1286,23;0;0;21,43;38,7
+CAS2D+DEF;min;20468;47,17%;1740,62;0;0;21,43;-1
+CAS1+DEF;max;2325;0,00%;0;0;0;0;0
+CAS1+DEF;max;3428;23,62%;549,17;0;0;42,86;7,6
+CAS1+DEF;max;3689;25,94%;628,7;0;0;42,86;8,9
+CAS1+DEF;max;6687;30,72%;805,03;0;0;42,86;18,7
+CAS1+DEF;max;20468;42,44%;1588,75;0;0;42,86;34,7
+CAS1+DEF;min;20468;47,17%;2556,89;0;0;42,86;-1

package/data/taxas_continente_2026.csv

@@ -0,0 +1,68 @@
+tipo;sinal;limite;maximo;parcela_abater;var1;var2;adicional;var3
+SOLD;max;920;0,00%;0;0;0;0;0
+SOLD;max;1042;12,50%;12,50%;2,6;1273,85;34,29;5,3
+SOLD;max;1108;15,70%;15,70%;1,35;1554,83;34,29;7,2
+SOLD;max;1154;15,70%;94,71;0;0;34,29;7,5
+SOLD;max;1212;21,20%;158,18;0;0;34,29;8,1
+SOLD;max;1819;24,10%;193,33;0;0;34,29;13,5
+SOLD;max;2119;31,10%;320,66;0;0;34,29;16
+SOLD;max;2499;34,90%;401,19;0;0;34,29;18,8
+SOLD;max;3305;38,36%;487,66;0;0;34,29;23,6
+SOLD;max;5547;39,69%;531,62;0;0;34,29;30,1
+SOLD;max;20221;44,95%;823,4;0;0;34,29;40,9
+SOLD;min;20221;47,17%;1272,31;0;0;34,29;-1
+SOLCAS2;max;920;0,00%;0;0;0;0;0
+SOLCAS2;max;1042;12,50%;12,50%;2,6;1273,85;21,43;5,3
+SOLCAS2;max;1108;15,70%;15,70%;1,35;1554,83;21,43;7,2
+SOLCAS2;max;1154;15,70%;94,71;0;0;21,43;7,5
+SOLCAS2;max;1212;21,20%;158,18;0;0;21,43;8,1
+SOLCAS2;max;1819;24,10%;193,33;0;0;21,43;13,5
+SOLCAS2;max;2119;31,10%;320,66;0;0;21,43;16
+SOLCAS2;max;2499;34,90%;401,19;0;0;21,43;18,8
+SOLCAS2;max;3305;38,36%;487,66;0;0;21,43;23,6
+SOLCAS2;max;5547;39,69%;531,62;0;0;21,43;30,1
+SOLCAS2;max;20221;44,95%;823,4;0;0;21,43;40,9
+SOLCAS2;min;20221;47,17%;1272,31;0;0;21,43;-1
+CAS1;max;991;0,00%;0;0;0;0;0
+CAS1;max;1042;12,50%;12,50%;2,6;1372,15;42,86;2,2
+CAS1;max;1108;12,50%;12,50%;1,35;1677,85;42,86;3,8
+CAS1;max;1119;12,50%;96,17;0;0;42,86;3,9
+CAS1;max;1432;12,72%;98,64;0;0;42,86;5,8
+CAS1;max;1962;15,70%;141,32;0;0;42,86;8,5
+CAS1;max;2240;19,38%;213,53;0;0;42,86;9,8
+CAS1;max;2773;22,77%;289,47;0;0;42,86;12,3
+CAS1;max;3389;25,70%;370,72;0;0;42,86;14,8
+CAS1;max;5965;28,81%;476,12;0;0;42,86;20,8
+CAS1;max;20265;38,43%;1049,96;0;0;42,86;33,2
+CAS1;min;20265;47,17%;2821,13;0;0;42,86;-1
+SOLCAS2+DEF;max;1694;0,00%;0;0;0;0;0
+SOLCAS2+DEF;max;2063;21,20%;359,13;0;0;0;3,8
+SOLCAS2+DEF;max;2492;31,10%;563,37;0;0;0;8,5
+SOLCAS2+DEF;max;4487;34,90%;658,07;0;0;0;20,2
+SOLCAS2+DEF;max;4753;38,36%;813,33;0;0;0;21,2
+SOLCAS2+DEF;max;6687;39,69%;876,55;0;0;0;26,6
+SOLCAS2+DEF;max;20468;44,95%;1228,29;0;0;0;38,9
+SOLCAS2+DEF;min;20468;47,17%;1682,68;0;0;0;-1
+SOLD+DEF;max;1938;0,00%;0;0;0;0;0
+SOLD+DEF;max;2063;21,32%;413,19;0;0;42,86;1,3
+SOLD+DEF;max;2854;31,10%;614,96;0;0;42,86;9,6
+SOLD+DEF;max;4504;34,90%;723,42;0;0;42,86;18,8
+SOLD+DEF;max;6826;38,36%;879,26;0;0;42,86;25,5
+SOLD+DEF;max;7048;39,69%;970,05;0;0;42,86;25,9
+SOLD+DEF;max;20468;44,95%;1340,78;0;0;42,86;38,4
+SOLD+DEF;min;20468;47,17%;1795,17;0;0;42,86;-1
+CAS2D+DEF;max;1668;0,00%;0;0;0;0;0
+CAS2D+DEF;max;2068;20,49%;341,78;0;0;21,43;4
+CAS2D+DEF;max;2497;24,10%;416,44;0;0;21,43;7,4
+CAS2D+DEF;max;3107;31,10%;591,23;0;0;21,43;12,1
+CAS2D+DEF;max;4504;34,90%;709,3;0;0;21,43;19,2
+CAS2D+DEF;max;6826;38,36%;865,14;0;0;21,43;25,7
+CAS2D+DEF;max;7048;39,69%;955,93;0;0;21,43;26,1
+CAS2D+DEF;max;20468;44,95%;1326,66;0;0;21,43;38,5
+CAS2D+DEF;min;20468;47,17%;1781,05;0;0;21,43;-1
+CAS1+DEF;max;2325;0,00%;0;0;0;0;0
+CAS1+DEF;max;3494;22,77%;529,41;0;0;42,86;7,6
+CAS1+DEF;max;3761;25,70%;631,79;0;0;42,86;8,9
+CAS1+DEF;max;6687;28,81%;748,76;0;0;42,86;17,6
+CAS1+DEF;max;20468;42,44%;1660,2;0;0;42,86;34,3
+CAS1+DEF;min;20468;47,17%;2628,34;0;0;42,86;-1

package/index.js

@@ -0,0 +1,22 @@
+const { loadTables } = require('./src/tables');
+const { calculate } = require('./src/calculate');
+
+function calculateSalary({ situation = 'NotMarried', numDependents = 0, year = '2026', salary }) {
+
+  const csvJsons = loadTables();
+  const csvJson = csvJsons[year];
+
+  if (!csvJson) {
+    throw new Error(`Unknown year: ${year}. Available: ${Object.keys(csvJsons).join(', ')}`);
+  }
+
+  const result = calculate(salary, situation, numDependents, year, csvJson);
+
+  if (result === null) {
+    throw new Error(`Could not calculate salary for the given parameters`);
+  }
+
+  return result;
+}
+
+module.exports = { calculateSalary };

package/package.json

@@ -0,0 +1,30 @@
+{
+  "name": "salario-pt",
+  "version": "1.0.0",
+  "description": "Portuguese salary calculator - calculates net salary from gross",
+  "main": "index.js",
+  "bin": {
+    "salario-pt": "./cli.js"
+  },
+  "scripts": {
+    "test": "node --test test.js"
+  },
+  "keywords": [
+    "salary",
+    "portugal",
+    "irs",
+    "tax",
+    "calculator",
+    "net-salary"
+  ],
+  "author": "Adriano <adrianojlt@gmail.com>",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/adrianojlt/salario.git"
+  },
+  "dependencies": {
+    "papaparse": "^5.4.1",
+    "salario-pt": "file:salario-pt-1.0.0.tgz"
+  }
+}

package/src/calculate.js

@@ -0,0 +1,86 @@
+const Situation = {
+  NotMarried: '0',
+  MarriedOneHolder: '1',
+  MarriedTwoHolders: '2'
+};
+
+const TSU = "1.2375";
+
+const SITUATION_MAP = {
+  'NotMarried': '0',
+  'MarriedOneHolder': '1',
+  'MarriedTwoHolders': '2'
+};
+
+function getType(situation, dependents, year) {
+  if (year === "2023") {
+    if (situation === Situation.NotMarried) {
+      if (dependents === 0) return "SOLCAS2";
+      return "SOLD";
+    }
+    if (situation === Situation.MarriedOneHolder) {
+      if (dependents === 0) return "CAS1";
+      return "CAS1D";
+    }
+    if (situation === Situation.MarriedTwoHolders) {
+      if (dependents === 0) return "SOLCAS2";
+      return "CAS2D";
+    }
+  }
+
+  if (year.startsWith("2024") || year.startsWith("2025") || year.startsWith("2026")) {
+    if (situation === Situation.NotMarried) {
+      if (dependents === 0) return "SOLCAS2";
+      return "SOLD";
+    }
+    if (situation === Situation.MarriedOneHolder) {
+      return "CAS1";
+    }
+    if (situation === Situation.MarriedTwoHolders) {
+      return "SOLCAS2";
+    }
+  }
+}
+
+function calculate(grossSalary, situation, numDependents, year, csvJson) {
+
+  const internalSituation = SITUATION_MAP[situation] || situation;
+
+  const type = getType(internalSituation, numDependents, year);
+
+  const inMaxRange = (x) => grossSalary < parseFloat(x.limite.replace(',', '.')) && x.sinal === 'max';
+  const inMinRange = (x) => grossSalary >= parseFloat(x.limite.replace(',', '.')) && x.sinal === 'min';
+
+  const values = csvJson.filter(x => x.tipo === type && (inMaxRange(x) || inMinRange(x)));
+
+  if (!values[0]) return null; 
+
+  const row = values[0];
+
+  const part = parseFloat(row.parcela_abater.replace(',', '.'));
+  const percentage = parseFloat(row.maximo.replace(/%/g, '').replace(',', '.')) / 100;
+  const salaryWithTax = parseFloat((grossSalary * percentage).toFixed(2));
+  const dependentsPart = parseFloat(parseFloat(row.adicional.replace(',', '.')).toFixed(2));
+  const additionalPart = dependentsPart * numDependents;
+
+  let irsDiscount = salaryWithTax - part - additionalPart;
+  let ssDiscount = grossSalary * 0.11;
+
+  if (irsDiscount < 0) irsDiscount = 0;
+
+  const netSalary = grossSalary - (irsDiscount + ssDiscount);
+
+  const companyMonthlyCost = ((grossSalary * parseFloat(TSU)) * 14) / 12;
+  const companyAnnualCost = companyMonthlyCost * 12;
+
+  return {
+    grossSalary,
+    netSalary: parseFloat(netSalary.toFixed(2)),
+    ssDiscount: parseFloat(ssDiscount.toFixed(2)),
+    irsDiscount: parseFloat(irsDiscount.toFixed(2)),
+    companyMonthlyCost: parseFloat(companyMonthlyCost.toFixed(2)),
+    companyAnnualCost: parseFloat(companyAnnualCost.toFixed(2))
+  };
+}
+
+module.exports = { calculate };

package/src/tables.js

@@ -0,0 +1,35 @@
+const fs = require('fs');
+const path = require('path');
+const Papa = require('papaparse');
+
+let cachedTables = null;
+
+const YEARS = ['2026', '2025', '2024_03', '2024_02', '2024', '2023'];
+
+function getDataPath() {
+  const packageRoot = path.join(__dirname, '..');
+  const dataPath = path.join(packageRoot, 'data');
+  if (fs.existsSync(path.join(dataPath, 'taxas_continente_2026.csv'))) {
+    return dataPath;
+  }
+  return path.join(__dirname, '..', '..', '..', 'data');
+}
+
+function loadTables() {
+  if (cachedTables) return cachedTables;
+
+  cachedTables = {};
+
+  const dataPath = getDataPath();
+
+  for (const year of YEARS) {
+    const filePath = path.join(dataPath, `taxas_continente_${year}.csv`);
+    const csv = fs.readFileSync(filePath, 'utf-8');
+    const results = Papa.parse(csv, { header: true, delimiter: ';' });
+    cachedTables[year] = results.data;
+  }
+
+  return cachedTables;
+}
+
+module.exports = { loadTables };