pakdatakit 2.3.0 → 2.5.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (96) hide show
  1. package/DATA.md +212 -3
  2. package/LICENSE +1 -1
  3. package/NOTICE +14 -0
  4. package/README.md +426 -207
  5. package/dist/address.cjs +5 -4
  6. package/dist/address.js +3 -2
  7. package/dist/bills.cjs +19 -0
  8. package/dist/bills.d.cts +63 -0
  9. package/dist/bills.d.ts +63 -0
  10. package/dist/bills.js +2 -0
  11. package/dist/{chunk-OKMBYX3F.cjs → chunk-33GOK7EE.cjs} +2 -910
  12. package/dist/chunk-34U2ZMHR.js +194 -0
  13. package/dist/chunk-4GSBHJX6.js +165 -0
  14. package/dist/chunk-5DDHO5Z7.cjs +565 -0
  15. package/dist/chunk-5EY5DQS7.js +51 -0
  16. package/dist/chunk-5RGX4DWF.js +559 -0
  17. package/dist/chunk-5UCRHVI4.cjs +302 -0
  18. package/dist/{chunk-TQP2T33V.js → chunk-B7DOQ5QF.js} +2 -1
  19. package/dist/chunk-CF6AMRBU.cjs +198 -0
  20. package/dist/chunk-CZOZB4K3.js +61 -0
  21. package/dist/chunk-E2XU6NOW.js +909 -0
  22. package/dist/chunk-E6GWBOKV.cjs +911 -0
  23. package/dist/chunk-EA3SIHYT.js +313 -0
  24. package/dist/{chunk-YTSMFGTW.js → chunk-IDTRFOQW.js} +8 -3
  25. package/dist/chunk-OTI7HY55.js +297 -0
  26. package/dist/{chunk-J5ARB4TE.cjs → chunk-QFPEFD67.cjs} +5 -4
  27. package/dist/chunk-SF4ECUZ6.cjs +56 -0
  28. package/dist/chunk-UYFTXD4P.js +168 -0
  29. package/dist/{chunk-TBTWZC74.cjs → chunk-XCFZKCV2.cjs} +8 -3
  30. package/dist/{chunk-N4S22XX3.js → chunk-XOTCIXY6.js} +2 -909
  31. package/dist/chunk-XVEG53NN.cjs +322 -0
  32. package/dist/chunk-YDUXIENX.cjs +172 -0
  33. package/dist/chunk-YPAWNWFD.cjs +168 -0
  34. package/dist/chunk-YQFI7W3I.cjs +65 -0
  35. package/dist/class-validator.cjs +16 -8
  36. package/dist/class-validator.d.cts +7 -1
  37. package/dist/class-validator.d.ts +7 -1
  38. package/dist/class-validator.js +15 -8
  39. package/dist/cli.js +1 -1
  40. package/dist/courier.cjs +16 -0
  41. package/dist/courier.d.cts +51 -0
  42. package/dist/courier.d.ts +51 -0
  43. package/dist/courier.js +3 -0
  44. package/dist/fbr-invoice.cjs +25 -0
  45. package/dist/fbr-invoice.d.cts +170 -0
  46. package/dist/fbr-invoice.d.ts +170 -0
  47. package/dist/fbr-invoice.js +4 -0
  48. package/dist/geo.cjs +11 -10
  49. package/dist/geo.js +2 -1
  50. package/dist/incometax.cjs +27 -0
  51. package/dist/incometax.d.cts +91 -0
  52. package/dist/incometax.d.ts +91 -0
  53. package/dist/incometax.js +2 -0
  54. package/dist/index.cjs +227 -123
  55. package/dist/index.d.cts +8 -2
  56. package/dist/index.d.ts +8 -2
  57. package/dist/index.js +21 -13
  58. package/dist/input.cjs +8 -8
  59. package/dist/input.js +2 -2
  60. package/dist/joi.cjs +14 -8
  61. package/dist/joi.d.cts +1 -0
  62. package/dist/joi.d.ts +1 -0
  63. package/dist/joi.js +13 -7
  64. package/dist/quality.cjs +25 -0
  65. package/dist/quality.d.cts +62 -0
  66. package/dist/quality.d.ts +62 -0
  67. package/dist/quality.js +8 -0
  68. package/dist/salestax.cjs +20 -0
  69. package/dist/salestax.d.cts +106 -0
  70. package/dist/salestax.d.ts +106 -0
  71. package/dist/salestax.js +3 -0
  72. package/dist/superstruct.cjs +14 -8
  73. package/dist/superstruct.d.cts +1 -0
  74. package/dist/superstruct.d.ts +1 -0
  75. package/dist/superstruct.js +13 -7
  76. package/dist/text.cjs +21 -5
  77. package/dist/text.d.cts +90 -1
  78. package/dist/text.d.ts +90 -1
  79. package/dist/text.js +1 -1
  80. package/dist/valibot.cjs +14 -8
  81. package/dist/valibot.d.cts +1 -0
  82. package/dist/valibot.d.ts +1 -0
  83. package/dist/valibot.js +13 -7
  84. package/dist/yup.cjs +14 -8
  85. package/dist/yup.d.cts +1 -0
  86. package/dist/yup.d.ts +1 -0
  87. package/dist/yup.js +13 -7
  88. package/dist/zod.cjs +14 -8
  89. package/dist/zod.d.cts +1 -0
  90. package/dist/zod.d.ts +1 -0
  91. package/dist/zod.js +13 -7
  92. package/package.json +74 -11
  93. package/dist/chunk-JKE4AMSZ.js +0 -47
  94. package/dist/chunk-KEHCTYLO.cjs +0 -52
  95. package/dist/{chunk-A3HBEBXY.js → chunk-7DY26QPN.js} +1 -1
  96. package/dist/{chunk-FRBPAGEJ.cjs → chunk-TVL6RDAU.cjs} +1 -1
@@ -0,0 +1,559 @@
1
+ import { isoDate, toUnits, divideHalfUp, fromPaisa } from './chunk-5EY5DQS7.js';
2
+
3
+ // data/income-tax-slabs.json
4
+ var income_tax_slabs_default = [
5
+ {
6
+ taxYear: 2020,
7
+ from: "2019-07-01",
8
+ to: "2020-06-30",
9
+ law: "Income Tax Ordinance 2001, First Schedule, Part I, Division I, clause (2), as substituted by the Finance Act 2019",
10
+ source: "https://download1.fbr.gov.pk/Docs/20199191692232848IncomeTaxOrdinance,2001amendedupto30-06-2019.pdf",
11
+ slabs: [
12
+ {
13
+ over: 0,
14
+ upTo: 6e5,
15
+ fixed: 0,
16
+ rate: 0
17
+ },
18
+ {
19
+ over: 6e5,
20
+ upTo: 12e5,
21
+ fixed: 0,
22
+ rate: 5
23
+ },
24
+ {
25
+ over: 12e5,
26
+ upTo: 18e5,
27
+ fixed: 3e4,
28
+ rate: 10
29
+ },
30
+ {
31
+ over: 18e5,
32
+ upTo: 25e5,
33
+ fixed: 9e4,
34
+ rate: 15
35
+ },
36
+ {
37
+ over: 25e5,
38
+ upTo: 35e5,
39
+ fixed: 195e3,
40
+ rate: 17.5
41
+ },
42
+ {
43
+ over: 35e5,
44
+ upTo: 5e6,
45
+ fixed: 37e4,
46
+ rate: 20
47
+ },
48
+ {
49
+ over: 5e6,
50
+ upTo: 8e6,
51
+ fixed: 67e4,
52
+ rate: 22.5
53
+ },
54
+ {
55
+ over: 8e6,
56
+ upTo: 12e6,
57
+ fixed: 1345e3,
58
+ rate: 25
59
+ },
60
+ {
61
+ over: 12e6,
62
+ upTo: 3e7,
63
+ fixed: 2345e3,
64
+ rate: 27.5
65
+ },
66
+ {
67
+ over: 3e7,
68
+ upTo: 5e7,
69
+ fixed: 7295e3,
70
+ rate: 30
71
+ },
72
+ {
73
+ over: 5e7,
74
+ upTo: 75e6,
75
+ fixed: 13295e3,
76
+ rate: 32.5
77
+ },
78
+ {
79
+ over: 75e6,
80
+ upTo: null,
81
+ fixed: 2142e4,
82
+ rate: 35
83
+ }
84
+ ]
85
+ },
86
+ {
87
+ taxYear: 2021,
88
+ from: "2020-07-01",
89
+ to: "2021-06-30",
90
+ law: "Income Tax Ordinance 2001, First Schedule, Part I, Division I, clause (2), as substituted by the Finance Act 2019 (unchanged by the Finance Act 2020)",
91
+ source: "https://download1.fbr.gov.pk/Docs/202011414113915861I.T.OrdinanceAmendedupto(30-06-2020).pdf",
92
+ slabs: [
93
+ {
94
+ over: 0,
95
+ upTo: 6e5,
96
+ fixed: 0,
97
+ rate: 0
98
+ },
99
+ {
100
+ over: 6e5,
101
+ upTo: 12e5,
102
+ fixed: 0,
103
+ rate: 5
104
+ },
105
+ {
106
+ over: 12e5,
107
+ upTo: 18e5,
108
+ fixed: 3e4,
109
+ rate: 10
110
+ },
111
+ {
112
+ over: 18e5,
113
+ upTo: 25e5,
114
+ fixed: 9e4,
115
+ rate: 15
116
+ },
117
+ {
118
+ over: 25e5,
119
+ upTo: 35e5,
120
+ fixed: 195e3,
121
+ rate: 17.5
122
+ },
123
+ {
124
+ over: 35e5,
125
+ upTo: 5e6,
126
+ fixed: 37e4,
127
+ rate: 20
128
+ },
129
+ {
130
+ over: 5e6,
131
+ upTo: 8e6,
132
+ fixed: 67e4,
133
+ rate: 22.5
134
+ },
135
+ {
136
+ over: 8e6,
137
+ upTo: 12e6,
138
+ fixed: 1345e3,
139
+ rate: 25
140
+ },
141
+ {
142
+ over: 12e6,
143
+ upTo: 3e7,
144
+ fixed: 2345e3,
145
+ rate: 27.5
146
+ },
147
+ {
148
+ over: 3e7,
149
+ upTo: 5e7,
150
+ fixed: 7295e3,
151
+ rate: 30
152
+ },
153
+ {
154
+ over: 5e7,
155
+ upTo: 75e6,
156
+ fixed: 13295e3,
157
+ rate: 32.5
158
+ },
159
+ {
160
+ over: 75e6,
161
+ upTo: null,
162
+ fixed: 2142e4,
163
+ rate: 35
164
+ }
165
+ ]
166
+ },
167
+ {
168
+ taxYear: 2022,
169
+ from: "2021-07-01",
170
+ to: "2022-06-30",
171
+ law: "Income Tax Ordinance 2001, First Schedule, Part I, Division I, clause (2), as substituted by the Finance Act 2019 (unchanged by the Finance Act 2021)",
172
+ source: "https://download1.fbr.gov.pk/Docs/20217141672549772IncomeTaxOrdinanceAmendedupto30.06.2021.pdf",
173
+ slabs: [
174
+ {
175
+ over: 0,
176
+ upTo: 6e5,
177
+ fixed: 0,
178
+ rate: 0
179
+ },
180
+ {
181
+ over: 6e5,
182
+ upTo: 12e5,
183
+ fixed: 0,
184
+ rate: 5
185
+ },
186
+ {
187
+ over: 12e5,
188
+ upTo: 18e5,
189
+ fixed: 3e4,
190
+ rate: 10
191
+ },
192
+ {
193
+ over: 18e5,
194
+ upTo: 25e5,
195
+ fixed: 9e4,
196
+ rate: 15
197
+ },
198
+ {
199
+ over: 25e5,
200
+ upTo: 35e5,
201
+ fixed: 195e3,
202
+ rate: 17.5
203
+ },
204
+ {
205
+ over: 35e5,
206
+ upTo: 5e6,
207
+ fixed: 37e4,
208
+ rate: 20
209
+ },
210
+ {
211
+ over: 5e6,
212
+ upTo: 8e6,
213
+ fixed: 67e4,
214
+ rate: 22.5
215
+ },
216
+ {
217
+ over: 8e6,
218
+ upTo: 12e6,
219
+ fixed: 1345e3,
220
+ rate: 25
221
+ },
222
+ {
223
+ over: 12e6,
224
+ upTo: 3e7,
225
+ fixed: 2345e3,
226
+ rate: 27.5
227
+ },
228
+ {
229
+ over: 3e7,
230
+ upTo: 5e7,
231
+ fixed: 7295e3,
232
+ rate: 30
233
+ },
234
+ {
235
+ over: 5e7,
236
+ upTo: 75e6,
237
+ fixed: 13295e3,
238
+ rate: 32.5
239
+ },
240
+ {
241
+ over: 75e6,
242
+ upTo: null,
243
+ fixed: 2142e4,
244
+ rate: 35
245
+ }
246
+ ]
247
+ },
248
+ {
249
+ taxYear: 2023,
250
+ from: "2022-07-01",
251
+ to: "2023-06-30",
252
+ law: "Income Tax Ordinance 2001, First Schedule, Part I, Division I, clause (2), as substituted by the Finance Act 2022",
253
+ source: "https://download1.fbr.gov.pk/Docs/202412215123222278IncomeTaxOrdinanceAmendedupto30.06.2022.pdf",
254
+ slabs: [
255
+ {
256
+ over: 0,
257
+ upTo: 6e5,
258
+ fixed: 0,
259
+ rate: 0
260
+ },
261
+ {
262
+ over: 6e5,
263
+ upTo: 12e5,
264
+ fixed: 0,
265
+ rate: 2.5
266
+ },
267
+ {
268
+ over: 12e5,
269
+ upTo: 24e5,
270
+ fixed: 15e3,
271
+ rate: 12.5
272
+ },
273
+ {
274
+ over: 24e5,
275
+ upTo: 36e5,
276
+ fixed: 165e3,
277
+ rate: 20
278
+ },
279
+ {
280
+ over: 36e5,
281
+ upTo: 6e6,
282
+ fixed: 405e3,
283
+ rate: 25
284
+ },
285
+ {
286
+ over: 6e6,
287
+ upTo: 12e6,
288
+ fixed: 1005e3,
289
+ rate: 32.5
290
+ },
291
+ {
292
+ over: 12e6,
293
+ upTo: null,
294
+ fixed: 2955e3,
295
+ rate: 35
296
+ }
297
+ ]
298
+ },
299
+ {
300
+ taxYear: 2024,
301
+ from: "2023-07-01",
302
+ to: "2024-06-30",
303
+ law: "Income Tax Ordinance 2001, First Schedule, Part I, Division I, clause (2), as substituted by the Finance Act 2023",
304
+ source: "https://download1.fbr.gov.pk/Docs/202412215122448762IncomeTaxOrdinance,2001Amendedupto30.06.2023.pdf",
305
+ slabs: [
306
+ {
307
+ over: 0,
308
+ upTo: 6e5,
309
+ fixed: 0,
310
+ rate: 0
311
+ },
312
+ {
313
+ over: 6e5,
314
+ upTo: 12e5,
315
+ fixed: 0,
316
+ rate: 2.5
317
+ },
318
+ {
319
+ over: 12e5,
320
+ upTo: 24e5,
321
+ fixed: 15e3,
322
+ rate: 12.5
323
+ },
324
+ {
325
+ over: 24e5,
326
+ upTo: 36e5,
327
+ fixed: 165e3,
328
+ rate: 22.5
329
+ },
330
+ {
331
+ over: 36e5,
332
+ upTo: 6e6,
333
+ fixed: 435e3,
334
+ rate: 27.5
335
+ },
336
+ {
337
+ over: 6e6,
338
+ upTo: null,
339
+ fixed: 1095e3,
340
+ rate: 35
341
+ }
342
+ ]
343
+ },
344
+ {
345
+ taxYear: 2025,
346
+ from: "2024-07-01",
347
+ to: "2025-06-30",
348
+ law: "Income Tax Ordinance 2001, First Schedule, Part I, Division I, clause (2), as substituted by the Finance Act 2024",
349
+ source: "https://download1.fbr.gov.pk/Docs/2024751675120641IncomeTaxOrdinance,2001-amended-upto30.06.2024.pdf",
350
+ slabs: [
351
+ {
352
+ over: 0,
353
+ upTo: 6e5,
354
+ fixed: 0,
355
+ rate: 0
356
+ },
357
+ {
358
+ over: 6e5,
359
+ upTo: 12e5,
360
+ fixed: 0,
361
+ rate: 5
362
+ },
363
+ {
364
+ over: 12e5,
365
+ upTo: 22e5,
366
+ fixed: 3e4,
367
+ rate: 15
368
+ },
369
+ {
370
+ over: 22e5,
371
+ upTo: 32e5,
372
+ fixed: 18e4,
373
+ rate: 25
374
+ },
375
+ {
376
+ over: 32e5,
377
+ upTo: 41e5,
378
+ fixed: 43e4,
379
+ rate: 30
380
+ },
381
+ {
382
+ over: 41e5,
383
+ upTo: null,
384
+ fixed: 7e5,
385
+ rate: 35
386
+ }
387
+ ]
388
+ },
389
+ {
390
+ taxYear: 2026,
391
+ from: "2025-07-01",
392
+ to: "2026-06-30",
393
+ law: "Income Tax Ordinance 2001, First Schedule, Part I, Division I, clause (2), as substituted by the Finance Act 2025",
394
+ source: "https://download1.fbr.gov.pk/Docs/2025881983148210Income-Tax-Ordinance,-2001-Amended-upto-31.07.2025.pdf",
395
+ slabs: [
396
+ {
397
+ over: 0,
398
+ upTo: 6e5,
399
+ fixed: 0,
400
+ rate: 0
401
+ },
402
+ {
403
+ over: 6e5,
404
+ upTo: 12e5,
405
+ fixed: 0,
406
+ rate: 1
407
+ },
408
+ {
409
+ over: 12e5,
410
+ upTo: 22e5,
411
+ fixed: 6e3,
412
+ rate: 11
413
+ },
414
+ {
415
+ over: 22e5,
416
+ upTo: 32e5,
417
+ fixed: 116e3,
418
+ rate: 23
419
+ },
420
+ {
421
+ over: 32e5,
422
+ upTo: 41e5,
423
+ fixed: 346e3,
424
+ rate: 30
425
+ },
426
+ {
427
+ over: 41e5,
428
+ upTo: null,
429
+ fixed: 616e3,
430
+ rate: 35
431
+ }
432
+ ]
433
+ },
434
+ {
435
+ taxYear: 2027,
436
+ from: "2026-07-01",
437
+ to: "2027-06-30",
438
+ law: "Income Tax Ordinance 2001, First Schedule, Part I, Division I, clause (2), as substituted by the Finance Act 2026",
439
+ source: "https://download1.fbr.gov.pk/Docs/20266291261044366FinanceAct2026.pdf",
440
+ slabs: [
441
+ {
442
+ over: 0,
443
+ upTo: 6e5,
444
+ fixed: 0,
445
+ rate: 0
446
+ },
447
+ {
448
+ over: 6e5,
449
+ upTo: 12e5,
450
+ fixed: 0,
451
+ rate: 1
452
+ },
453
+ {
454
+ over: 12e5,
455
+ upTo: 22e5,
456
+ fixed: 6e3,
457
+ rate: 11
458
+ },
459
+ {
460
+ over: 22e5,
461
+ upTo: 32e5,
462
+ fixed: 116e3,
463
+ rate: 20
464
+ },
465
+ {
466
+ over: 32e5,
467
+ upTo: 41e5,
468
+ fixed: 316e3,
469
+ rate: 25
470
+ },
471
+ {
472
+ over: 41e5,
473
+ upTo: 56e5,
474
+ fixed: 541e3,
475
+ rate: 29
476
+ },
477
+ {
478
+ over: 56e5,
479
+ upTo: 7e6,
480
+ fixed: 976e3,
481
+ rate: 32
482
+ },
483
+ {
484
+ over: 7e6,
485
+ upTo: null,
486
+ fixed: 1424e3,
487
+ rate: 35
488
+ }
489
+ ]
490
+ }
491
+ ];
492
+
493
+ // src/incometax.ts
494
+ var YEARS = income_tax_slabs_default;
495
+ function getTaxYear(date) {
496
+ const iso = date === void 0 ? isoDate(/* @__PURE__ */ new Date()) : isoDate(date);
497
+ if (iso === null) return null;
498
+ const year = Number(iso.slice(0, 4));
499
+ return Number(iso.slice(5, 7)) >= 7 ? year + 1 : year;
500
+ }
501
+ function findYear(options) {
502
+ let taxYear;
503
+ if (options === void 0 || options === null) {
504
+ taxYear = getTaxYear();
505
+ } else if (typeof options !== "object") {
506
+ return null;
507
+ } else {
508
+ const { taxYear: given, date } = options;
509
+ if (given !== void 0 && given !== null) {
510
+ if (typeof given !== "number" || !Number.isInteger(given)) return null;
511
+ taxYear = given;
512
+ } else {
513
+ taxYear = date === void 0 || date === null ? getTaxYear() : getTaxYear(date);
514
+ }
515
+ }
516
+ return YEARS.find((y) => y.taxYear === taxYear) ?? null;
517
+ }
518
+ var copyYear = (year) => ({
519
+ ...year,
520
+ slabs: year.slabs.map((slab) => ({ ...slab }))
521
+ });
522
+ function getSalaryTaxSlabs(taxYear) {
523
+ const year = findYear(taxYear === void 0 ? void 0 : { taxYear });
524
+ return year ? copyYear(year) : null;
525
+ }
526
+ function getSalaryTaxYears() {
527
+ return YEARS.map((y) => y.taxYear);
528
+ }
529
+ function compute(incomePaisa, year) {
530
+ const slabs = year.slabs;
531
+ let slab = slabs[0];
532
+ for (const candidate of slabs) {
533
+ if (incomePaisa > candidate.over * 100) slab = candidate;
534
+ }
535
+ const rateBp = Math.round(slab.rate * 100);
536
+ const above = BigInt(incomePaisa - slab.over * 100);
537
+ const taxPaisa = incomePaisa > slab.over * 100 ? slab.fixed * 100 + divideHalfUp(above * BigInt(rateBp), 10000n) : slab.fixed * 100;
538
+ return {
539
+ tax: fromPaisa(taxPaisa),
540
+ monthly: fromPaisa(divideHalfUp(BigInt(taxPaisa), 12n)),
541
+ effectiveRate: incomePaisa === 0 ? 0 : divideHalfUp(BigInt(taxPaisa) * 10000n, BigInt(incomePaisa)) / 100,
542
+ slab: { ...slab },
543
+ taxYear: year.taxYear
544
+ };
545
+ }
546
+ function calculateSalaryTax(annualIncome, options) {
547
+ const paisa = toUnits(annualIncome, 2);
548
+ if (paisa === null) return null;
549
+ const year = findYear(options);
550
+ return year ? compute(paisa, year) : null;
551
+ }
552
+ function calculateMonthlySalaryTax(monthlySalary, options) {
553
+ const paisa = toUnits(monthlySalary, 2);
554
+ if (paisa === null) return null;
555
+ const year = findYear(options);
556
+ return year ? compute(paisa * 12, year) : null;
557
+ }
558
+
559
+ export { calculateMonthlySalaryTax, calculateSalaryTax, getSalaryTaxSlabs, getSalaryTaxYears, getTaxYear };