@casomoltd/nhs-pay 0.24.1 → 0.25.0
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.
- package/README.md +5 -1
- package/dist/index.d.ts +2 -1
- package/dist/index.js +3 -1
- package/dist/index.js.map +1 -1
- package/dist/scales.d.ts +10 -19
- package/dist/scales.js +13 -23
- package/dist/scales.js.map +1 -1
- package/dist/working-week.d.ts +45 -0
- package/dist/working-week.js +70 -0
- package/dist/working-week.js.map +1 -0
- package/package.json +4 -4
package/README.md
CHANGED
|
@@ -523,7 +523,11 @@ nation's or year's figures.
|
|
|
523
523
|
|
|
524
524
|
## Test fixtures
|
|
525
525
|
|
|
526
|
-
`tests/
|
|
526
|
+
`tests/working-week.test.ts` pins the AfC week and its 365/7 year
|
|
527
|
+
against every hourly rate Scotland's circular prints beside a salary, and
|
|
528
|
+
the Welsh living-wage pair.
|
|
529
|
+
|
|
530
|
+
`tests/fixtures/band-take-home.csv` — golden-value rows
|
|
527
531
|
covering bands 5, 7, 8a across all 4 nations (England,
|
|
528
532
|
Scotland, Wales, NI), both tax years, 3 HCAS zones, and
|
|
529
533
|
part-time (0.6 FTE). Gross figures are derived from
|
package/dist/index.d.ts
CHANGED
|
@@ -72,7 +72,8 @@ export type { AfcRegionId, ResolvedRegion, } from './regions.js';
|
|
|
72
72
|
export { AFC_CURRENT_YEAR, AFC_PREVIOUS_YEAR, getAfcScales, } from './bands.js';
|
|
73
73
|
export type { AfcBandMeta, AfcScaleData, } from './bands.js';
|
|
74
74
|
export { nhsTakeHome } from './take-home.js';
|
|
75
|
+
export { afcWeekInForce, afcWeeklyHours, hoursPerYear } from './working-week.js';
|
|
75
76
|
export type { NhsTakeHomeOptions } from './take-home.js';
|
|
76
77
|
export { fmtMoney, fmtPct, fmtSalary, formatGBP, formatGBPPrecise, formatPct, formatPctPrecise, yearLabel, } from './format.js';
|
|
77
|
-
export { TAX_REGIONS, TAX_YEARS, NATIONS, NATION_KEYS, TakeHomePay, GrossAnnual, PensionBasis, PensionPercent, StudentLoanPlan, nationToTaxRegion, getTaxYearConfig,
|
|
78
|
+
export { TAX_REGIONS, TAX_YEARS, NATIONS, NATION_KEYS, TakeHomePay, GrossAnnual, PensionBasis, PensionPercent, StudentLoanPlan, nationToTaxRegion, getTaxYearConfig, } from '@casomoltd/paye-calc';
|
|
78
79
|
export type { Nation, TaxRegion, TaxYear, PayYear, YearLabel, } from '@casomoltd/paye-calc';
|
package/dist/index.js
CHANGED
|
@@ -75,10 +75,12 @@ export { AFC_REGIONS, ZONE_TO_REGION, afcRegionToHcasZone, afcRegionToNation, is
|
|
|
75
75
|
export { AFC_CURRENT_YEAR, AFC_PREVIOUS_YEAR, getAfcScales, } from './bands.js';
|
|
76
76
|
// ── Take-home ────────────────────────────────────
|
|
77
77
|
export { nhsTakeHome } from './take-home.js';
|
|
78
|
+
// ── Working week ──────────────────────────────
|
|
79
|
+
export { afcWeekInForce, afcWeeklyHours, hoursPerYear } from './working-week.js';
|
|
78
80
|
// ── Format ───────────────────────────────────────
|
|
79
81
|
export { fmtMoney, fmtPct, fmtSalary, formatGBP, formatGBPPrecise, formatPct, formatPctPrecise, yearLabel, } from './format.js';
|
|
80
82
|
// ── Re-exports from paye-calc ────────────────────
|
|
81
83
|
// Types that appear in our public API so consumers
|
|
82
84
|
// don't need a direct paye-calc import for NHS work.
|
|
83
|
-
export { TAX_REGIONS, TAX_YEARS, NATIONS, NATION_KEYS, TakeHomePay, GrossAnnual, PensionBasis, PensionPercent, StudentLoanPlan, nationToTaxRegion, getTaxYearConfig,
|
|
85
|
+
export { TAX_REGIONS, TAX_YEARS, NATIONS, NATION_KEYS, TakeHomePay, GrossAnnual, PensionBasis, PensionPercent, StudentLoanPlan, nationToTaxRegion, getTaxYearConfig, } from '@casomoltd/paye-calc';
|
|
84
86
|
//# sourceMappingURL=index.js.map
|
package/dist/index.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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
|
|
1
|
+
{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
|
package/dist/scales.d.ts
CHANGED
|
@@ -75,32 +75,23 @@ interface AfcScaleYear {
|
|
|
75
75
|
}
|
|
76
76
|
export declare const NLW_HOURLY: Partial<Record<YearLabel, number>>;
|
|
77
77
|
/**
|
|
78
|
-
* Standard AfC working hours per year
|
|
78
|
+
* Standard AfC working hours per year outside Scotland (≈ 1,955.4).
|
|
79
79
|
*
|
|
80
|
-
*
|
|
81
|
-
*
|
|
82
|
-
*
|
|
83
|
-
* publisher prints.
|
|
84
|
-
*
|
|
85
|
-
* @deprecated Use `hoursPerYear(config)` from
|
|
86
|
-
* paye-calc for region-aware hours. This constant
|
|
87
|
-
* assumes rUK 37.5h weeks and is wrong for Scotland
|
|
88
|
-
* from 2026-27.
|
|
80
|
+
* @deprecated Use `hoursPerYear(afcWeeklyHours(year, nation))` from
|
|
81
|
+
* `working-week.ts`. This constant is the rest of the UK's week and is
|
|
82
|
+
* wrong for Scotland.
|
|
89
83
|
*/
|
|
90
84
|
export declare const AFC_HOURS_PER_YEAR: number;
|
|
91
85
|
/**
|
|
92
86
|
* Annualise an hourly rate at given weekly hours.
|
|
93
87
|
*
|
|
94
|
-
* `weeklyHours` is required: the standard week
|
|
95
|
-
*
|
|
96
|
-
*
|
|
97
|
-
*
|
|
98
|
-
* Scottish rate. Pass `config.standardWeeklyHours`.
|
|
88
|
+
* `weeklyHours` is required: the standard week varies by
|
|
89
|
+
* nation and year (`afcWeeklyHours`), so defaulting it
|
|
90
|
+
* would silently return an rUK answer for a Scottish rate.
|
|
91
|
+
* Pass `afcWeeklyHours(year, nation)`.
|
|
99
92
|
*
|
|
100
|
-
* The
|
|
101
|
-
*
|
|
102
|
-
* divisor that disagreed would round-trip a salary to a
|
|
103
|
-
* different number.
|
|
93
|
+
* The inverse of dividing by `hoursPerYear`, which it reads, so the two
|
|
94
|
+
* agree up to the rounding of the hourly rate and of the result.
|
|
104
95
|
*/
|
|
105
96
|
export declare function annualiseHourly(hourly: number, weeklyHours: number): number;
|
|
106
97
|
/** The Welsh living-wage floor for a year, as its pay
|
package/dist/scales.js
CHANGED
|
@@ -58,6 +58,7 @@ import { ScaleUnavailable, invariant } from './errors.js';
|
|
|
58
58
|
import { AFC_ENGLAND_SCALES_2025, AFC_ENGLAND_SCALES_2026, AFC_NI_2025, AFC_SCOTLAND, AFC_W_02_2025, AFC_W_02_2026, } from './sources.js';
|
|
59
59
|
import { NI_SCALES_2025_26, SCOTLAND_SCALES_2025_26, SCOTLAND_SCALES_2026_27, WALES_SCALES_2025_26, WALES_SCALES_2026_27, } from './afc-scales.js';
|
|
60
60
|
import { afcPoint } from './afc-scales.js';
|
|
61
|
+
import { FULL_TIME_WEEK, hoursPerYear } from './working-week.js';
|
|
61
62
|
// The band registry lives in its own module so the translation layer
|
|
62
63
|
// can name a band without importing this one — see `afc-band.ts`.
|
|
63
64
|
export { AFC_BANDS, AFC_BAND_IDS } from './afc-band.js';
|
|
@@ -306,38 +307,27 @@ export const NLW_HOURLY = {
|
|
|
306
307
|
[TAX_YEARS.Y2025_26]: 12.21,
|
|
307
308
|
[TAX_YEARS.Y2026_27]: 12.71,
|
|
308
309
|
};
|
|
309
|
-
/** Standard rUK AfC weekly hours (Scotland differs from 2026-27). */
|
|
310
|
-
const RUK_WEEKLY_HOURS = 37.5;
|
|
311
310
|
/**
|
|
312
|
-
* Standard AfC working hours per year
|
|
311
|
+
* Standard AfC working hours per year outside Scotland (≈ 1,955.4).
|
|
313
312
|
*
|
|
314
|
-
*
|
|
315
|
-
*
|
|
316
|
-
*
|
|
317
|
-
* publisher prints.
|
|
318
|
-
*
|
|
319
|
-
* @deprecated Use `hoursPerYear(config)` from
|
|
320
|
-
* paye-calc for region-aware hours. This constant
|
|
321
|
-
* assumes rUK 37.5h weeks and is wrong for Scotland
|
|
322
|
-
* from 2026-27.
|
|
313
|
+
* @deprecated Use `hoursPerYear(afcWeeklyHours(year, nation))` from
|
|
314
|
+
* `working-week.ts`. This constant is the rest of the UK's week and is
|
|
315
|
+
* wrong for Scotland.
|
|
323
316
|
*/
|
|
324
|
-
export const AFC_HOURS_PER_YEAR = (
|
|
317
|
+
export const AFC_HOURS_PER_YEAR = hoursPerYear(FULL_TIME_WEEK);
|
|
325
318
|
/**
|
|
326
319
|
* Annualise an hourly rate at given weekly hours.
|
|
327
320
|
*
|
|
328
|
-
* `weeklyHours` is required: the standard week
|
|
329
|
-
*
|
|
330
|
-
*
|
|
331
|
-
*
|
|
332
|
-
* Scottish rate. Pass `config.standardWeeklyHours`.
|
|
321
|
+
* `weeklyHours` is required: the standard week varies by
|
|
322
|
+
* nation and year (`afcWeeklyHours`), so defaulting it
|
|
323
|
+
* would silently return an rUK answer for a Scottish rate.
|
|
324
|
+
* Pass `afcWeeklyHours(year, nation)`.
|
|
333
325
|
*
|
|
334
|
-
* The
|
|
335
|
-
*
|
|
336
|
-
* divisor that disagreed would round-trip a salary to a
|
|
337
|
-
* different number.
|
|
326
|
+
* The inverse of dividing by `hoursPerYear`, which it reads, so the two
|
|
327
|
+
* agree up to the rounding of the hourly rate and of the result.
|
|
338
328
|
*/
|
|
339
329
|
export function annualiseHourly(hourly, weeklyHours) {
|
|
340
|
-
return Math.round(
|
|
330
|
+
return Math.round(hourly * hoursPerYear(weeklyHours));
|
|
341
331
|
}
|
|
342
332
|
export const WALES_LIVING_WAGE = {
|
|
343
333
|
[TAX_YEARS.Y2026_27]: { annual: 26300, hourly: 13.45 },
|
package/dist/scales.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"scales.js","sourceRoot":"","sources":["../src/scales.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsDG;AAKH,OAAO,EACL,WAAW,EACX,SAAS,EACT,gBAAgB,GACjB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAC,gBAAgB,EAAE,SAAS,EAAC,MAAM,aAAa,CAAC;AAExD,OAAO,EACL,uBAAuB,EACvB,uBAAuB,EACvB,WAAW,EACX,YAAY,EACZ,aAAa,EACb,aAAa,GACd,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,iBAAiB,EACjB,uBAAuB,EACvB,uBAAuB,EACvB,oBAAoB,EACpB,oBAAoB,GACrB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAC,QAAQ,EAAC,MAAM,iBAAiB,CAAC;
|
|
1
|
+
{"version":3,"file":"scales.js","sourceRoot":"","sources":["../src/scales.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,45 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* The Agenda for Change full-time week, by nation and pay year, and the
|
|
3
|
+
* hours in a year it gives. An hourly rate is an annual salary over these
|
|
4
|
+
* hours, so a Scottish rate read at the rest of the UK's week comes out
|
|
5
|
+
* low by the difference.
|
|
6
|
+
*
|
|
7
|
+
* Sources, by figure:
|
|
8
|
+
* - 37.5 hours, England, Wales and Northern Ireland: "NHS Terms and
|
|
9
|
+
* Conditions of Service Handbook, amendment 62" (#sa-41). The section
|
|
10
|
+
* setting the week has not been re-read for this module.
|
|
11
|
+
* - Scotland, 37 hours in 2025-26: "Scotland, PCS(AFC)2026/1" (#sa-13),
|
|
12
|
+
* Annex B p8, whose hourly rates are printed "Based on a 37 Hour Week".
|
|
13
|
+
* - Scotland, 36 hours from 1 April 2026: the same circular's 2026-27
|
|
14
|
+
* Annex B prints its rates on a 36-hour week, the week
|
|
15
|
+
* `AFC_SCOTLAND_36_HOUR_WEEK` (PCS(AFC)2026/2, in `sources.ts`) sets.
|
|
16
|
+
* Scotland's week before 2025-26 has no archived source, so those years
|
|
17
|
+
* throw rather than serve a figure nobody has checked.
|
|
18
|
+
* See docs/source-archive.md.
|
|
19
|
+
*/
|
|
20
|
+
import type { Nation, PayYear, TaxYear } from '@casomoltd/paye-calc';
|
|
21
|
+
/** The week everywhere but Scotland, every year this library covers. */
|
|
22
|
+
export declare const FULL_TIME_WEEK = 37.5;
|
|
23
|
+
/**
|
|
24
|
+
* The full-time AfC week a pay round's scale is built on: the week its
|
|
25
|
+
* circular divides by. A member paid on last year's round is on last
|
|
26
|
+
* year's week.
|
|
27
|
+
*/
|
|
28
|
+
export declare function afcWeeklyHours(year: PayYear, nation: Nation): number;
|
|
29
|
+
/**
|
|
30
|
+
* The full-time AfC week in force in a tax year, whatever round a nation
|
|
31
|
+
* is paying on: a week changes on 1 April, by the calendar, as Scotland's
|
|
32
|
+
* 36 hours did in 2026. It differs from `afcWeeklyHours` only for a
|
|
33
|
+
* nation still paying an earlier round.
|
|
34
|
+
*/
|
|
35
|
+
export declare function afcWeekInForce(year: TaxYear, nation: Nation): number;
|
|
36
|
+
/**
|
|
37
|
+
* Hours in a year at a given week: the divisor for an hourly rate.
|
|
38
|
+
*
|
|
39
|
+
* Not 52 weeks. A year is 52 weeks and a day, and the circulars this
|
|
40
|
+
* library pins (Scotland's PCS(AFC)2026/1 and the Welsh living-wage
|
|
41
|
+
* letter) divide by the longer year; 52 would give a rate neither
|
|
42
|
+
* prints, about 0.3% high. Leap years are ignored, as those tables
|
|
43
|
+
* ignore them. `tests/working-week.test.ts` pins it.
|
|
44
|
+
*/
|
|
45
|
+
export declare function hoursPerYear(weeklyHours: number): number;
|
|
@@ -0,0 +1,70 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* The Agenda for Change full-time week, by nation and pay year, and the
|
|
3
|
+
* hours in a year it gives. An hourly rate is an annual salary over these
|
|
4
|
+
* hours, so a Scottish rate read at the rest of the UK's week comes out
|
|
5
|
+
* low by the difference.
|
|
6
|
+
*
|
|
7
|
+
* Sources, by figure:
|
|
8
|
+
* - 37.5 hours, England, Wales and Northern Ireland: "NHS Terms and
|
|
9
|
+
* Conditions of Service Handbook, amendment 62" (#sa-41). The section
|
|
10
|
+
* setting the week has not been re-read for this module.
|
|
11
|
+
* - Scotland, 37 hours in 2025-26: "Scotland, PCS(AFC)2026/1" (#sa-13),
|
|
12
|
+
* Annex B p8, whose hourly rates are printed "Based on a 37 Hour Week".
|
|
13
|
+
* - Scotland, 36 hours from 1 April 2026: the same circular's 2026-27
|
|
14
|
+
* Annex B prints its rates on a 36-hour week, the week
|
|
15
|
+
* `AFC_SCOTLAND_36_HOUR_WEEK` (PCS(AFC)2026/2, in `sources.ts`) sets.
|
|
16
|
+
* Scotland's week before 2025-26 has no archived source, so those years
|
|
17
|
+
* throw rather than serve a figure nobody has checked.
|
|
18
|
+
* See docs/source-archive.md.
|
|
19
|
+
*/
|
|
20
|
+
import { NATION_KEYS } from '@casomoltd/paye-calc';
|
|
21
|
+
/** The week everywhere but Scotland, every year this library covers. */
|
|
22
|
+
export const FULL_TIME_WEEK = 37.5;
|
|
23
|
+
/** Scotland's week, for the years a circular sets it. */
|
|
24
|
+
const SCOTLAND_WEEK = {
|
|
25
|
+
'2025-26': 37,
|
|
26
|
+
'2026-27': 36,
|
|
27
|
+
};
|
|
28
|
+
// A year of weeks as payroll counts it: 365 days over 7.
|
|
29
|
+
const DAYS_PER_YEAR = 365;
|
|
30
|
+
const DAYS_PER_WEEK = 7;
|
|
31
|
+
/**
|
|
32
|
+
* The full-time AfC week a pay round's scale is built on: the week its
|
|
33
|
+
* circular divides by. A member paid on last year's round is on last
|
|
34
|
+
* year's week.
|
|
35
|
+
*/
|
|
36
|
+
export function afcWeeklyHours(year, nation) {
|
|
37
|
+
return weekFor(year, nation);
|
|
38
|
+
}
|
|
39
|
+
/**
|
|
40
|
+
* The full-time AfC week in force in a tax year, whatever round a nation
|
|
41
|
+
* is paying on: a week changes on 1 April, by the calendar, as Scotland's
|
|
42
|
+
* 36 hours did in 2026. It differs from `afcWeeklyHours` only for a
|
|
43
|
+
* nation still paying an earlier round.
|
|
44
|
+
*/
|
|
45
|
+
export function afcWeekInForce(year, nation) {
|
|
46
|
+
return weekFor(year, nation);
|
|
47
|
+
}
|
|
48
|
+
/** The week for a year's label, whichever question asks it. */
|
|
49
|
+
function weekFor(label, nation) {
|
|
50
|
+
if (nation !== NATION_KEYS.scotland)
|
|
51
|
+
return FULL_TIME_WEEK;
|
|
52
|
+
const week = SCOTLAND_WEEK[label];
|
|
53
|
+
if (week === undefined) {
|
|
54
|
+
throw new RangeError(`No sourced AfC week for Scotland in ${label}`);
|
|
55
|
+
}
|
|
56
|
+
return week;
|
|
57
|
+
}
|
|
58
|
+
/**
|
|
59
|
+
* Hours in a year at a given week: the divisor for an hourly rate.
|
|
60
|
+
*
|
|
61
|
+
* Not 52 weeks. A year is 52 weeks and a day, and the circulars this
|
|
62
|
+
* library pins (Scotland's PCS(AFC)2026/1 and the Welsh living-wage
|
|
63
|
+
* letter) divide by the longer year; 52 would give a rate neither
|
|
64
|
+
* prints, about 0.3% high. Leap years are ignored, as those tables
|
|
65
|
+
* ignore them. `tests/working-week.test.ts` pins it.
|
|
66
|
+
*/
|
|
67
|
+
export function hoursPerYear(weeklyHours) {
|
|
68
|
+
return (weeklyHours * DAYS_PER_YEAR) / DAYS_PER_WEEK;
|
|
69
|
+
}
|
|
70
|
+
//# sourceMappingURL=working-week.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"working-week.js","sourceRoot":"","sources":["../src/working-week.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,EAAC,WAAW,EAAC,MAAM,sBAAsB,CAAC;AAGjD,wEAAwE;AACxE,MAAM,CAAC,MAAM,cAAc,GAAG,IAAI,CAAC;AAEnC,yDAAyD;AACzD,MAAM,aAAa,GAAuC;IACxD,SAAS,EAAE,EAAE;IACb,SAAS,EAAE,EAAE;CACd,CAAC;AAEF,yDAAyD;AACzD,MAAM,aAAa,GAAG,GAAG,CAAC;AAC1B,MAAM,aAAa,GAAG,CAAC,CAAC;AAExB;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAAC,IAAa,EAAE,MAAc;IAC1D,OAAO,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;AAC/B,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAAC,IAAa,EAAE,MAAc;IAC1D,OAAO,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;AAC/B,CAAC;AAED,+DAA+D;AAC/D,SAAS,OAAO,CAAC,KAAgB,EAAE,MAAc;IAC/C,IAAI,MAAM,KAAK,WAAW,CAAC,QAAQ;QAAE,OAAO,cAAc,CAAC;IAC3D,MAAM,IAAI,GAAG,aAAa,CAAC,KAAK,CAAC,CAAC;IAClC,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;QACvB,MAAM,IAAI,UAAU,CAClB,uCAAuC,KAAK,EAAE,CAC/C,CAAC;IACJ,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,YAAY,CAAC,WAAmB;IAC9C,OAAO,CAAC,WAAW,GAAG,aAAa,CAAC,GAAG,aAAa,CAAC;AACvD,CAAC"}
|
package/package.json
CHANGED
|
@@ -1,8 +1,8 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@casomoltd/nhs-pay",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.25.0",
|
|
4
4
|
"description": "NHS pay scales and take-home pay, and a member's NHS pension across the 1995, 2008 and 2015 Sections",
|
|
5
|
-
"homepage": "https://
|
|
5
|
+
"homepage": "https://casomo.co.uk",
|
|
6
6
|
"bugs": "https://github.com/casomoltd/nhs-pay/issues",
|
|
7
7
|
"type": "module",
|
|
8
8
|
"main": "dist/index.js",
|
|
@@ -67,10 +67,10 @@
|
|
|
67
67
|
"provenance": true
|
|
68
68
|
},
|
|
69
69
|
"peerDependencies": {
|
|
70
|
-
"@casomoltd/paye-calc": ">=0.
|
|
70
|
+
"@casomoltd/paye-calc": ">=0.9.0"
|
|
71
71
|
},
|
|
72
72
|
"devDependencies": {
|
|
73
|
-
"@casomoltd/paye-calc": "^0.
|
|
73
|
+
"@casomoltd/paye-calc": "^0.9.0",
|
|
74
74
|
"@casomoltd/tooling": "^0.37.0",
|
|
75
75
|
"@commitlint/cli": "^20.0.0",
|
|
76
76
|
"@js-temporal/polyfill": "^0.5.1",
|