@casomoltd/nhs-pay 0.4.7
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/LICENSE +165 -0
- package/README.md +267 -0
- package/dist/bands.d.ts +42 -0
- package/dist/bands.js +161 -0
- package/dist/bands.js.map +1 -0
- package/dist/format.d.ts +20 -0
- package/dist/format.js +56 -0
- package/dist/format.js.map +1 -0
- package/dist/hcas-pcts.d.ts +19 -0
- package/dist/hcas-pcts.js +97 -0
- package/dist/hcas-pcts.js.map +1 -0
- package/dist/hcas.d.ts +28 -0
- package/dist/hcas.js +39 -0
- package/dist/hcas.js.map +1 -0
- package/dist/index.d.ts +18 -0
- package/dist/index.js +23 -0
- package/dist/index.js.map +1 -0
- package/dist/pension-projection.d.ts +149 -0
- package/dist/pension-projection.js +352 -0
- package/dist/pension-projection.js.map +1 -0
- package/dist/pension.d.ts +64 -0
- package/dist/pension.js +96 -0
- package/dist/pension.js.map +1 -0
- package/dist/regions.d.ts +47 -0
- package/dist/regions.js +122 -0
- package/dist/regions.js.map +1 -0
- package/dist/scales.d.ts +79 -0
- package/dist/scales.js +329 -0
- package/dist/scales.js.map +1 -0
- package/dist/take-home.d.ts +12 -0
- package/dist/take-home.js +19 -0
- package/dist/take-home.js.map +1 -0
- package/package.json +72 -0
package/dist/regions.js
ADDED
|
@@ -0,0 +1,122 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* AFC region codes — collapse nation + HCAS into
|
|
3
|
+
* a single query parameter.
|
|
4
|
+
*
|
|
5
|
+
* HCAS is England-only and mutually exclusive with
|
|
6
|
+
* non-England nations, so one param covers both.
|
|
7
|
+
*
|
|
8
|
+
* UI-specific concerns (cookies, URL params, selector
|
|
9
|
+
* options, zone labels) stay in hub-site.
|
|
10
|
+
*/
|
|
11
|
+
import { TAX_REGIONS, NATIONS, } from '@casomoltd/paye-calc';
|
|
12
|
+
// ── Region codes ────────────────────────────────
|
|
13
|
+
export const AFC_REGIONS = {
|
|
14
|
+
ENG: 'eng',
|
|
15
|
+
ENG_IL: 'eng-il',
|
|
16
|
+
ENG_OL: 'eng-ol',
|
|
17
|
+
ENG_FR: 'eng-fr',
|
|
18
|
+
WAL: 'wal',
|
|
19
|
+
SCO: 'sco',
|
|
20
|
+
NI: 'ni',
|
|
21
|
+
};
|
|
22
|
+
const AFC_REGION_ID_LIST = Object.values(AFC_REGIONS);
|
|
23
|
+
/** Type guard for region codes. */
|
|
24
|
+
export function isAfcRegionId(raw) {
|
|
25
|
+
return AFC_REGION_ID_LIST.includes(raw);
|
|
26
|
+
}
|
|
27
|
+
const REGION_INFO = {
|
|
28
|
+
[AFC_REGIONS.ENG]: {
|
|
29
|
+
taxRegion: TAX_REGIONS.rUK,
|
|
30
|
+
hcasProp: null,
|
|
31
|
+
label: 'England',
|
|
32
|
+
taxNote: 'England and Wales tax rates',
|
|
33
|
+
isWales: false,
|
|
34
|
+
},
|
|
35
|
+
[AFC_REGIONS.ENG_IL]: {
|
|
36
|
+
taxRegion: TAX_REGIONS.rUK,
|
|
37
|
+
hcasProp: 'innerLondon',
|
|
38
|
+
label: 'England \u2014 Inner London HCAS',
|
|
39
|
+
taxNote: 'England and Wales tax rates',
|
|
40
|
+
isWales: false,
|
|
41
|
+
},
|
|
42
|
+
[AFC_REGIONS.ENG_OL]: {
|
|
43
|
+
taxRegion: TAX_REGIONS.rUK,
|
|
44
|
+
hcasProp: 'outerLondon',
|
|
45
|
+
label: 'England \u2014 Outer London HCAS',
|
|
46
|
+
taxNote: 'England and Wales tax rates',
|
|
47
|
+
isWales: false,
|
|
48
|
+
},
|
|
49
|
+
[AFC_REGIONS.ENG_FR]: {
|
|
50
|
+
taxRegion: TAX_REGIONS.rUK,
|
|
51
|
+
hcasProp: 'fringe',
|
|
52
|
+
label: 'England \u2014 Fringe HCAS',
|
|
53
|
+
taxNote: 'England and Wales tax rates',
|
|
54
|
+
isWales: false,
|
|
55
|
+
},
|
|
56
|
+
[AFC_REGIONS.WAL]: {
|
|
57
|
+
taxRegion: TAX_REGIONS.rUK,
|
|
58
|
+
hcasProp: null,
|
|
59
|
+
label: 'Wales',
|
|
60
|
+
taxNote: 'England and Wales tax rates',
|
|
61
|
+
isWales: true,
|
|
62
|
+
},
|
|
63
|
+
[AFC_REGIONS.SCO]: {
|
|
64
|
+
taxRegion: TAX_REGIONS.scotland,
|
|
65
|
+
hcasProp: null,
|
|
66
|
+
label: 'Scotland',
|
|
67
|
+
taxNote: 'Scottish income tax rates',
|
|
68
|
+
isWales: false,
|
|
69
|
+
},
|
|
70
|
+
[AFC_REGIONS.NI]: {
|
|
71
|
+
taxRegion: TAX_REGIONS.rUK,
|
|
72
|
+
hcasProp: null,
|
|
73
|
+
label: 'Northern Ireland',
|
|
74
|
+
taxNote: 'England and Wales tax rates',
|
|
75
|
+
isWales: false,
|
|
76
|
+
},
|
|
77
|
+
};
|
|
78
|
+
/** Resolve a region code to tax/HCAS/label info. */
|
|
79
|
+
export function resolveRegion(id) {
|
|
80
|
+
return { id, ...REGION_INFO[id] };
|
|
81
|
+
}
|
|
82
|
+
// ── Region → Nation mapping ────────────────
|
|
83
|
+
const REGION_TO_NATION = {
|
|
84
|
+
[AFC_REGIONS.ENG]: 'england',
|
|
85
|
+
[AFC_REGIONS.ENG_IL]: 'england',
|
|
86
|
+
[AFC_REGIONS.ENG_OL]: 'england',
|
|
87
|
+
[AFC_REGIONS.ENG_FR]: 'england',
|
|
88
|
+
[AFC_REGIONS.WAL]: 'wales',
|
|
89
|
+
[AFC_REGIONS.SCO]: 'scotland',
|
|
90
|
+
[AFC_REGIONS.NI]: 'northern-ireland',
|
|
91
|
+
};
|
|
92
|
+
/** Map an AfC region code to a paye-calc Nation. */
|
|
93
|
+
export function afcRegionToNation(id) {
|
|
94
|
+
return REGION_TO_NATION[id];
|
|
95
|
+
}
|
|
96
|
+
// ── Zone → Region mapping ─────────────────
|
|
97
|
+
export const ZONE_TO_REGION = {
|
|
98
|
+
'inner-london': AFC_REGIONS.ENG_IL,
|
|
99
|
+
'outer-london': AFC_REGIONS.ENG_OL,
|
|
100
|
+
fringe: AFC_REGIONS.ENG_FR,
|
|
101
|
+
};
|
|
102
|
+
// ── Region → Zone mapping ─────────────────
|
|
103
|
+
const REGION_TO_ZONE = Object.fromEntries(Object.entries(ZONE_TO_REGION)
|
|
104
|
+
.map(([z, r]) => [r, z]));
|
|
105
|
+
/** Map an AfC region code to its HCAS zone,
|
|
106
|
+
* or null for non-HCAS regions. */
|
|
107
|
+
export function afcRegionToHcasZone(id) {
|
|
108
|
+
return REGION_TO_ZONE[id] ?? null;
|
|
109
|
+
}
|
|
110
|
+
export const ZONE_LABELS = {
|
|
111
|
+
'inner-london': 'Inner London',
|
|
112
|
+
'outer-london': 'Outer London',
|
|
113
|
+
fringe: 'Fringe',
|
|
114
|
+
};
|
|
115
|
+
// ── Nation type guard ──────────────────────
|
|
116
|
+
const NATION_SET = new Set(Object.keys(NATIONS));
|
|
117
|
+
/** Type guard for paye-calc Nation strings. */
|
|
118
|
+
export function isNation(raw) {
|
|
119
|
+
return typeof raw === 'string'
|
|
120
|
+
&& NATION_SET.has(raw);
|
|
121
|
+
}
|
|
122
|
+
//# sourceMappingURL=regions.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"regions.js","sourceRoot":"","sources":["../src/regions.ts"],"names":[],"mappings":"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"}
|
package/dist/scales.d.ts
ADDED
|
@@ -0,0 +1,79 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* NHS Agenda for Change pay scales by tax year.
|
|
3
|
+
*
|
|
4
|
+
* Pure salary data — no metadata (labels, slugs, role
|
|
5
|
+
* descriptions). Static band info lives in bands.ts.
|
|
6
|
+
*
|
|
7
|
+
* Sources:
|
|
8
|
+
* - https://www.nhsemployers.org/articles/pay-scales-202526
|
|
9
|
+
* - https://www.nhsemployers.org/articles/pay-scales-202627
|
|
10
|
+
* - https://www.healthcareers.nhs.uk/working-health/working-nhs/nhs-pay-and-benefits/agenda-change-pay-rates
|
|
11
|
+
* - NLW: https://www.gov.uk/national-minimum-wage-rates
|
|
12
|
+
* - Wales floor: https://www.nhs.wales/files/pc-resources/2026-afc-1-2026-living-wage-pdf-pdf/
|
|
13
|
+
* - HCAS: NHS Staff Council Framework Agreement (Annex R)
|
|
14
|
+
* - Scotland 2025-26: PCS(AFC)2026/1 circular
|
|
15
|
+
* - Scotland 2026-27: MSG Scotland AfC pay scales
|
|
16
|
+
*/
|
|
17
|
+
import type { TaxYear } from '@casomoltd/paye-calc';
|
|
18
|
+
export declare const AFC_BANDS: {
|
|
19
|
+
readonly B2: "2";
|
|
20
|
+
readonly B3: "3";
|
|
21
|
+
readonly B4: "4";
|
|
22
|
+
readonly B5: "5";
|
|
23
|
+
readonly B6: "6";
|
|
24
|
+
readonly B7: "7";
|
|
25
|
+
readonly B8a: "8a";
|
|
26
|
+
readonly B8b: "8b";
|
|
27
|
+
readonly B8c: "8c";
|
|
28
|
+
readonly B8d: "8d";
|
|
29
|
+
readonly B9: "9";
|
|
30
|
+
};
|
|
31
|
+
export type AfcBandId = (typeof AFC_BANDS)[keyof typeof AFC_BANDS];
|
|
32
|
+
/** Ordered band IDs — use for iteration. */
|
|
33
|
+
export declare const AFC_BAND_IDS: AfcBandId[];
|
|
34
|
+
export interface ScalePoint {
|
|
35
|
+
label: string;
|
|
36
|
+
salary: number;
|
|
37
|
+
}
|
|
38
|
+
export interface HcasZone {
|
|
39
|
+
rate: number;
|
|
40
|
+
min: number;
|
|
41
|
+
max: number;
|
|
42
|
+
}
|
|
43
|
+
export interface HcasZones {
|
|
44
|
+
innerLondon: HcasZone;
|
|
45
|
+
outerLondon: HcasZone;
|
|
46
|
+
fringe: HcasZone;
|
|
47
|
+
}
|
|
48
|
+
interface AfcScaleYear {
|
|
49
|
+
hcas: HcasZones;
|
|
50
|
+
scales: Record<AfcBandId, ScalePoint[]>;
|
|
51
|
+
}
|
|
52
|
+
export declare const NLW_HOURLY: Partial<Record<TaxYear, number>>;
|
|
53
|
+
/**
|
|
54
|
+
* Standard AfC working hours per year (37.5 × 52).
|
|
55
|
+
* @deprecated Use `hoursPerYear(config)` from
|
|
56
|
+
* paye-calc for region-aware hours. This constant
|
|
57
|
+
* assumes rUK 37.5h weeks and is wrong for Scotland
|
|
58
|
+
* from 2026-27.
|
|
59
|
+
*/
|
|
60
|
+
export declare const AFC_HOURS_PER_YEAR: number;
|
|
61
|
+
/**
|
|
62
|
+
* Annualise an hourly rate at given weekly hours.
|
|
63
|
+
* Defaults to 37.5 (rUK standard) for backward
|
|
64
|
+
* compatibility. Pass config.standardWeeklyHours
|
|
65
|
+
* for region-aware conversion.
|
|
66
|
+
*/
|
|
67
|
+
export declare function annualiseHourly(hourly: number, weeklyHours?: number): number;
|
|
68
|
+
export declare const WALES_LW_FLOOR: Partial<Record<TaxYear, number>>;
|
|
69
|
+
/** Apply the Wales living wage floor to a salary.
|
|
70
|
+
* Returns the original salary if no floor exists
|
|
71
|
+
* for the given tax year. */
|
|
72
|
+
export declare function applyWalesFloor(salary: number, year: TaxYear): number;
|
|
73
|
+
/** Tax years that have AFC scale data. */
|
|
74
|
+
export declare const AFC_TAX_YEARS: TaxYear[];
|
|
75
|
+
/** Get scales for a tax year and nation.
|
|
76
|
+
* Scotland has its own tables; all other nations
|
|
77
|
+
* share the England/Wales/NI base. */
|
|
78
|
+
export declare function getScalesForYear(year?: TaxYear, nation?: string): AfcScaleYear;
|
|
79
|
+
export {};
|
package/dist/scales.js
ADDED
|
@@ -0,0 +1,329 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* NHS Agenda for Change pay scales by tax year.
|
|
3
|
+
*
|
|
4
|
+
* Pure salary data — no metadata (labels, slugs, role
|
|
5
|
+
* descriptions). Static band info lives in bands.ts.
|
|
6
|
+
*
|
|
7
|
+
* Sources:
|
|
8
|
+
* - https://www.nhsemployers.org/articles/pay-scales-202526
|
|
9
|
+
* - https://www.nhsemployers.org/articles/pay-scales-202627
|
|
10
|
+
* - https://www.healthcareers.nhs.uk/working-health/working-nhs/nhs-pay-and-benefits/agenda-change-pay-rates
|
|
11
|
+
* - NLW: https://www.gov.uk/national-minimum-wage-rates
|
|
12
|
+
* - Wales floor: https://www.nhs.wales/files/pc-resources/2026-afc-1-2026-living-wage-pdf-pdf/
|
|
13
|
+
* - HCAS: NHS Staff Council Framework Agreement (Annex R)
|
|
14
|
+
* - Scotland 2025-26: PCS(AFC)2026/1 circular
|
|
15
|
+
* - Scotland 2026-27: MSG Scotland AfC pay scales
|
|
16
|
+
*/
|
|
17
|
+
import { TAX_YEARS } from '@casomoltd/paye-calc';
|
|
18
|
+
export const AFC_BANDS = {
|
|
19
|
+
B2: '2',
|
|
20
|
+
B3: '3',
|
|
21
|
+
B4: '4',
|
|
22
|
+
B5: '5',
|
|
23
|
+
B6: '6',
|
|
24
|
+
B7: '7',
|
|
25
|
+
B8a: '8a',
|
|
26
|
+
B8b: '8b',
|
|
27
|
+
B8c: '8c',
|
|
28
|
+
B8d: '8d',
|
|
29
|
+
B9: '9',
|
|
30
|
+
};
|
|
31
|
+
/** Ordered band IDs — use for iteration. */
|
|
32
|
+
export const AFC_BAND_IDS = Object.values(AFC_BANDS);
|
|
33
|
+
// ── Shared HCAS zone rates ──────────────────────
|
|
34
|
+
// Unchanged between 2025-26 and 2026-27.
|
|
35
|
+
const HCAS_2025_ONWARDS = {
|
|
36
|
+
innerLondon: {
|
|
37
|
+
rate: 20, min: 5794, max: 8746,
|
|
38
|
+
},
|
|
39
|
+
outerLondon: {
|
|
40
|
+
rate: 15, min: 4870, max: 6137,
|
|
41
|
+
},
|
|
42
|
+
fringe: {
|
|
43
|
+
rate: 5, min: 1346, max: 2270,
|
|
44
|
+
},
|
|
45
|
+
};
|
|
46
|
+
// ── 2025-26 ─────────────────────────────────────
|
|
47
|
+
const AFC_SCALES_2025_26 = {
|
|
48
|
+
hcas: HCAS_2025_ONWARDS,
|
|
49
|
+
scales: {
|
|
50
|
+
'2': [{ label: 'Entry', salary: 24465 }],
|
|
51
|
+
'3': [
|
|
52
|
+
{ label: 'Year 1', salary: 24937 },
|
|
53
|
+
{ label: 'Year 2+', salary: 26598 },
|
|
54
|
+
],
|
|
55
|
+
'4': [
|
|
56
|
+
{ label: 'Year 1', salary: 27485 },
|
|
57
|
+
{ label: 'Year 3+', salary: 30162 },
|
|
58
|
+
],
|
|
59
|
+
'5': [
|
|
60
|
+
{ label: 'Year 1', salary: 31049 },
|
|
61
|
+
{ label: 'Year 2', salary: 33487 },
|
|
62
|
+
{ label: 'Year 4+', salary: 37796 },
|
|
63
|
+
],
|
|
64
|
+
'6': [
|
|
65
|
+
{ label: 'Year 1', salary: 38682 },
|
|
66
|
+
{ label: 'Year 2', salary: 40823 },
|
|
67
|
+
{ label: 'Year 5+', salary: 46580 },
|
|
68
|
+
],
|
|
69
|
+
'7': [
|
|
70
|
+
{ label: 'Year 1', salary: 47810 },
|
|
71
|
+
{ label: 'Year 2', salary: 50273 },
|
|
72
|
+
{ label: 'Year 5+', salary: 54710 },
|
|
73
|
+
],
|
|
74
|
+
'8a': [
|
|
75
|
+
{ label: 'Year 1', salary: 55690 },
|
|
76
|
+
{ label: 'Year 2', salary: 58487 },
|
|
77
|
+
{ label: 'Year 5+', salary: 62682 },
|
|
78
|
+
],
|
|
79
|
+
'8b': [
|
|
80
|
+
{ label: 'Year 1', salary: 64455 },
|
|
81
|
+
{ label: 'Year 2', salary: 68631 },
|
|
82
|
+
{ label: 'Year 5+', salary: 74896 },
|
|
83
|
+
],
|
|
84
|
+
'8c': [
|
|
85
|
+
{ label: 'Year 1', salary: 76965 },
|
|
86
|
+
{ label: 'Year 2', salary: 81652 },
|
|
87
|
+
{ label: 'Year 5+', salary: 88682 },
|
|
88
|
+
],
|
|
89
|
+
'8d': [
|
|
90
|
+
{ label: 'Year 1', salary: 91342 },
|
|
91
|
+
{ label: 'Year 2', salary: 96941 },
|
|
92
|
+
{ label: 'Year 5+', salary: 105337 },
|
|
93
|
+
],
|
|
94
|
+
'9': [
|
|
95
|
+
{ label: 'Year 1', salary: 109179 },
|
|
96
|
+
{ label: 'Year 2', salary: 115763 },
|
|
97
|
+
{ label: 'Year 5+', salary: 125637 },
|
|
98
|
+
],
|
|
99
|
+
},
|
|
100
|
+
};
|
|
101
|
+
// ── 2026-27 ─────────────────────────────────────
|
|
102
|
+
const AFC_SCALES_2026_27 = {
|
|
103
|
+
hcas: HCAS_2025_ONWARDS,
|
|
104
|
+
scales: {
|
|
105
|
+
'2': [{ label: 'Entry', salary: 25272 }],
|
|
106
|
+
'3': [
|
|
107
|
+
{ label: 'Year 1', salary: 25760 },
|
|
108
|
+
{ label: 'Year 2+', salary: 27476 },
|
|
109
|
+
],
|
|
110
|
+
'4': [
|
|
111
|
+
{ label: 'Year 1', salary: 28392 },
|
|
112
|
+
{ label: 'Year 3+', salary: 31157 },
|
|
113
|
+
],
|
|
114
|
+
'5': [
|
|
115
|
+
{ label: 'Year 1', salary: 32073 },
|
|
116
|
+
{ label: 'Year 2', salary: 34592 },
|
|
117
|
+
{ label: 'Year 4+', salary: 39043 },
|
|
118
|
+
],
|
|
119
|
+
'6': [
|
|
120
|
+
{ label: 'Year 1', salary: 39959 },
|
|
121
|
+
{ label: 'Year 2', salary: 42170 },
|
|
122
|
+
{ label: 'Year 5+', salary: 48117 },
|
|
123
|
+
],
|
|
124
|
+
'7': [
|
|
125
|
+
{ label: 'Year 1', salary: 49387 },
|
|
126
|
+
{ label: 'Year 2', salary: 51932 },
|
|
127
|
+
{ label: 'Year 5+', salary: 56515 },
|
|
128
|
+
],
|
|
129
|
+
'8a': [
|
|
130
|
+
{ label: 'Year 1', salary: 57528 },
|
|
131
|
+
{ label: 'Year 2', salary: 60417 },
|
|
132
|
+
{ label: 'Year 5+', salary: 64750 },
|
|
133
|
+
],
|
|
134
|
+
'8b': [
|
|
135
|
+
{ label: 'Year 1', salary: 66582 },
|
|
136
|
+
{ label: 'Year 2', salary: 70896 },
|
|
137
|
+
{ label: 'Year 5+', salary: 77368 },
|
|
138
|
+
],
|
|
139
|
+
'8c': [
|
|
140
|
+
{ label: 'Year 1', salary: 79504 },
|
|
141
|
+
{ label: 'Year 2', salary: 84346 },
|
|
142
|
+
{ label: 'Year 5+', salary: 91609 },
|
|
143
|
+
],
|
|
144
|
+
'8d': [
|
|
145
|
+
{ label: 'Year 1', salary: 94356 },
|
|
146
|
+
{ label: 'Year 2', salary: 100140 },
|
|
147
|
+
{ label: 'Year 5+', salary: 108814 },
|
|
148
|
+
],
|
|
149
|
+
'9': [
|
|
150
|
+
{ label: 'Year 1', salary: 112782 },
|
|
151
|
+
{ label: 'Year 2', salary: 119583 },
|
|
152
|
+
{ label: 'Year 5+', salary: 129783 },
|
|
153
|
+
],
|
|
154
|
+
},
|
|
155
|
+
};
|
|
156
|
+
// ── Scotland 2025-26 ─────────────────────────────
|
|
157
|
+
// Scotland negotiates its own AfC award. Band
|
|
158
|
+
// structures differ from England (Band 2 has 2 points,
|
|
159
|
+
// Bands 8a–9 have 2 points each).
|
|
160
|
+
// Source: PCS(AFC)2026/1 circular (23 Jan 2026).
|
|
161
|
+
const AFC_SCALES_2025_26_SCOTLAND = {
|
|
162
|
+
hcas: HCAS_2025_ONWARDS,
|
|
163
|
+
scales: {
|
|
164
|
+
'2': [
|
|
165
|
+
{ label: 'Year 1', salary: 25731 },
|
|
166
|
+
{ label: 'Year 2+', salary: 27941 },
|
|
167
|
+
],
|
|
168
|
+
'3': [
|
|
169
|
+
{ label: 'Year 1', salary: 28051 },
|
|
170
|
+
{ label: 'Year 2+', salary: 30274 },
|
|
171
|
+
],
|
|
172
|
+
'4': [
|
|
173
|
+
{ label: 'Year 1', salary: 30397 },
|
|
174
|
+
{ label: 'Year 3+', salary: 33063 },
|
|
175
|
+
],
|
|
176
|
+
'5': [
|
|
177
|
+
{ label: 'Year 1', salary: 33295 },
|
|
178
|
+
{ label: 'Year 2', salary: 35576 },
|
|
179
|
+
{ label: 'Year 4+', salary: 41483 },
|
|
180
|
+
],
|
|
181
|
+
'6': [
|
|
182
|
+
{ label: 'Year 1', salary: 41668 },
|
|
183
|
+
{ label: 'Year 2', salary: 43503 },
|
|
184
|
+
{ label: 'Year 5+', salary: 50775 },
|
|
185
|
+
],
|
|
186
|
+
'7': [
|
|
187
|
+
{ label: 'Year 1', salary: 50935 },
|
|
188
|
+
{ label: 'Year 2', salary: 52880 },
|
|
189
|
+
{ label: 'Year 5+', salary: 59244 },
|
|
190
|
+
],
|
|
191
|
+
'8a': [
|
|
192
|
+
{ label: 'Year 1', salary: 62772 },
|
|
193
|
+
{ label: 'Year 2+', salary: 67762 },
|
|
194
|
+
],
|
|
195
|
+
'8b': [
|
|
196
|
+
{ label: 'Year 1', salary: 74109 },
|
|
197
|
+
{ label: 'Year 2+', salary: 79278 },
|
|
198
|
+
],
|
|
199
|
+
'8c': [
|
|
200
|
+
{ label: 'Year 1', salary: 87526 },
|
|
201
|
+
{ label: 'Year 2+', salary: 93820 },
|
|
202
|
+
],
|
|
203
|
+
'8d': [
|
|
204
|
+
{ label: 'Year 1', salary: 103913 },
|
|
205
|
+
{ label: 'Year 2+', salary: 108362 },
|
|
206
|
+
],
|
|
207
|
+
'9': [
|
|
208
|
+
{ label: 'Year 1', salary: 122912 },
|
|
209
|
+
{ label: 'Year 2+', salary: 128236 },
|
|
210
|
+
],
|
|
211
|
+
},
|
|
212
|
+
};
|
|
213
|
+
// ── Scotland 2026-27 ─────────────────────────────
|
|
214
|
+
// 3.75% uplift on Scotland 2025-26 base.
|
|
215
|
+
// Source: MSG Scotland AfC pay scales 2026-27.
|
|
216
|
+
const AFC_SCALES_2026_27_SCOTLAND = {
|
|
217
|
+
hcas: HCAS_2025_ONWARDS,
|
|
218
|
+
scales: {
|
|
219
|
+
'2': [
|
|
220
|
+
{ label: 'Year 1', salary: 26696 },
|
|
221
|
+
{ label: 'Year 2+', salary: 28988 },
|
|
222
|
+
],
|
|
223
|
+
'3': [
|
|
224
|
+
{ label: 'Year 1', salary: 29103 },
|
|
225
|
+
{ label: 'Year 2+', salary: 31409 },
|
|
226
|
+
],
|
|
227
|
+
'4': [
|
|
228
|
+
{ label: 'Year 1', salary: 31537 },
|
|
229
|
+
{ label: 'Year 3+', salary: 34303 },
|
|
230
|
+
],
|
|
231
|
+
'5': [
|
|
232
|
+
{ label: 'Year 1', salary: 34544 },
|
|
233
|
+
{ label: 'Year 2', salary: 36911 },
|
|
234
|
+
{ label: 'Year 4+', salary: 43039 },
|
|
235
|
+
],
|
|
236
|
+
'6': [
|
|
237
|
+
{ label: 'Year 1', salary: 43231 },
|
|
238
|
+
{ label: 'Year 2', salary: 45135 },
|
|
239
|
+
{ label: 'Year 5+', salary: 52679 },
|
|
240
|
+
],
|
|
241
|
+
'7': [
|
|
242
|
+
{ label: 'Year 1', salary: 52845 },
|
|
243
|
+
{ label: 'Year 2', salary: 54863 },
|
|
244
|
+
{ label: 'Year 5+', salary: 61466 },
|
|
245
|
+
],
|
|
246
|
+
'8a': [
|
|
247
|
+
{ label: 'Year 1', salary: 65125 },
|
|
248
|
+
{ label: 'Year 2+', salary: 70303 },
|
|
249
|
+
],
|
|
250
|
+
'8b': [
|
|
251
|
+
{ label: 'Year 1', salary: 76888 },
|
|
252
|
+
{ label: 'Year 2+', salary: 82251 },
|
|
253
|
+
],
|
|
254
|
+
'8c': [
|
|
255
|
+
{ label: 'Year 1', salary: 90808 },
|
|
256
|
+
{ label: 'Year 2+', salary: 97338 },
|
|
257
|
+
],
|
|
258
|
+
'8d': [
|
|
259
|
+
{ label: 'Year 1', salary: 107810 },
|
|
260
|
+
{ label: 'Year 2+', salary: 112426 },
|
|
261
|
+
],
|
|
262
|
+
'9': [
|
|
263
|
+
{ label: 'Year 1', salary: 127521 },
|
|
264
|
+
{ label: 'Year 2+', salary: 133044 },
|
|
265
|
+
],
|
|
266
|
+
},
|
|
267
|
+
};
|
|
268
|
+
// ── National Living Wage (statutory, 21+) ────────
|
|
269
|
+
//
|
|
270
|
+
// Hourly rate set by the Low Pay Commission.
|
|
271
|
+
// Source: gov.uk/national-minimum-wage-rates
|
|
272
|
+
export const NLW_HOURLY = {
|
|
273
|
+
[TAX_YEARS.Y2026_27]: 12.21,
|
|
274
|
+
};
|
|
275
|
+
/**
|
|
276
|
+
* Standard AfC working hours per year (37.5 × 52).
|
|
277
|
+
* @deprecated Use `hoursPerYear(config)` from
|
|
278
|
+
* paye-calc for region-aware hours. This constant
|
|
279
|
+
* assumes rUK 37.5h weeks and is wrong for Scotland
|
|
280
|
+
* from 2026-27.
|
|
281
|
+
*/
|
|
282
|
+
export const AFC_HOURS_PER_YEAR = 37.5 * 52;
|
|
283
|
+
/**
|
|
284
|
+
* Annualise an hourly rate at given weekly hours.
|
|
285
|
+
* Defaults to 37.5 (rUK standard) for backward
|
|
286
|
+
* compatibility. Pass config.standardWeeklyHours
|
|
287
|
+
* for region-aware conversion.
|
|
288
|
+
*/
|
|
289
|
+
export function annualiseHourly(hourly, weeklyHours = 37.5) {
|
|
290
|
+
return Math.round(hourly * weeklyHours * 52);
|
|
291
|
+
}
|
|
292
|
+
// ── Wales living wage floor ─────────────────────
|
|
293
|
+
//
|
|
294
|
+
// The Welsh Government applies a Living Wage
|
|
295
|
+
// Foundation floor as an advance uplift. Affected
|
|
296
|
+
// spine points are lifted to this annual salary.
|
|
297
|
+
// Source: AfC(W) 01/2026 pay letter (6 Jan 2026).
|
|
298
|
+
export const WALES_LW_FLOOR = {
|
|
299
|
+
[TAX_YEARS.Y2026_27]: 26300,
|
|
300
|
+
};
|
|
301
|
+
/** Apply the Wales living wage floor to a salary.
|
|
302
|
+
* Returns the original salary if no floor exists
|
|
303
|
+
* for the given tax year. */
|
|
304
|
+
export function applyWalesFloor(salary, year) {
|
|
305
|
+
const floor = WALES_LW_FLOOR[year];
|
|
306
|
+
return floor ? Math.max(salary, floor) : salary;
|
|
307
|
+
}
|
|
308
|
+
// ── Lookup by tax year ──────────────────────────
|
|
309
|
+
const AFC_SCALES = {
|
|
310
|
+
[TAX_YEARS.Y2025_26]: AFC_SCALES_2025_26,
|
|
311
|
+
[TAX_YEARS.Y2026_27]: AFC_SCALES_2026_27,
|
|
312
|
+
};
|
|
313
|
+
const AFC_SCALES_SCOTLAND = {
|
|
314
|
+
[TAX_YEARS.Y2025_26]: AFC_SCALES_2025_26_SCOTLAND,
|
|
315
|
+
[TAX_YEARS.Y2026_27]: AFC_SCALES_2026_27_SCOTLAND,
|
|
316
|
+
};
|
|
317
|
+
/** Tax years that have AFC scale data. */
|
|
318
|
+
export const AFC_TAX_YEARS = Object.keys(AFC_SCALES);
|
|
319
|
+
/** Get scales for a tax year and nation.
|
|
320
|
+
* Scotland has its own tables; all other nations
|
|
321
|
+
* share the England/Wales/NI base. */
|
|
322
|
+
export function getScalesForYear(year = TAX_YEARS.Y2025_26, nation) {
|
|
323
|
+
if (nation === 'scotland') {
|
|
324
|
+
return AFC_SCALES_SCOTLAND[year]
|
|
325
|
+
?? AFC_SCALES_2025_26_SCOTLAND;
|
|
326
|
+
}
|
|
327
|
+
return AFC_SCALES[year] ?? AFC_SCALES_2025_26;
|
|
328
|
+
}
|
|
329
|
+
//# sourceMappingURL=scales.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"scales.js","sourceRoot":"","sources":["../src/scales.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,12 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Pre-configured TakeHomePay for NHS AfC staff.
|
|
3
|
+
* Uses NET pay arrangement (pension deducted before
|
|
4
|
+
* tax) which matches the NHS Pension Scheme.
|
|
5
|
+
*/
|
|
6
|
+
import { TakeHomePay } from '@casomoltd/paye-calc';
|
|
7
|
+
import type { TaxYear, TaxRegion } from '@casomoltd/paye-calc';
|
|
8
|
+
/**
|
|
9
|
+
* @param salary Gross annual salary
|
|
10
|
+
* @param pensionRate Decimal fraction (e.g. 0.098)
|
|
11
|
+
*/
|
|
12
|
+
export declare function nhsTakeHome(salary: number, pensionRate: number, taxYear?: TaxYear, taxRegion?: TaxRegion): TakeHomePay;
|
|
@@ -0,0 +1,19 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Pre-configured TakeHomePay for NHS AfC staff.
|
|
3
|
+
* Uses NET pay arrangement (pension deducted before
|
|
4
|
+
* tax) which matches the NHS Pension Scheme.
|
|
5
|
+
*/
|
|
6
|
+
import { TakeHomePay, GrossAnnual, PensionBasis, PensionPercent, TAX_REGIONS, } from '@casomoltd/paye-calc';
|
|
7
|
+
import { AFC_CURRENT_YEAR } from './bands.js';
|
|
8
|
+
/**
|
|
9
|
+
* @param salary Gross annual salary
|
|
10
|
+
* @param pensionRate Decimal fraction (e.g. 0.098)
|
|
11
|
+
*/
|
|
12
|
+
export function nhsTakeHome(salary, pensionRate, taxYear = AFC_CURRENT_YEAR, taxRegion = TAX_REGIONS.rUK) {
|
|
13
|
+
const thp = new TakeHomePay(taxYear, taxRegion);
|
|
14
|
+
thp.setSalary(GrossAnnual(salary));
|
|
15
|
+
thp.setPensionBasis(PensionBasis.Employer);
|
|
16
|
+
thp.setPension(PensionPercent(pensionRate * 100));
|
|
17
|
+
return thp;
|
|
18
|
+
}
|
|
19
|
+
//# sourceMappingURL=take-home.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"take-home.js","sourceRoot":"","sources":["../src/take-home.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,WAAW,EACX,WAAW,EACX,YAAY,EACZ,cAAc,EACd,WAAW,GACZ,MAAM,sBAAsB,CAAC;AAK9B,OAAO,EAAC,gBAAgB,EAAC,MAAM,YAAY,CAAC;AAE5C;;;GAGG;AACH,MAAM,UAAU,WAAW,CACzB,MAAc,EACd,WAAmB,EACnB,UAAmB,gBAAgB,EACnC,YAAuB,WAAW,CAAC,GAAG;IAEtC,MAAM,GAAG,GAAG,IAAI,WAAW,CACzB,OAAO,EAAE,SAAS,CACnB,CAAC;IACF,GAAG,CAAC,SAAS,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC;IACnC,GAAG,CAAC,eAAe,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC;IAC3C,GAAG,CAAC,UAAU,CACZ,cAAc,CAAC,WAAW,GAAG,GAAG,CAAC,CAClC,CAAC;IACF,OAAO,GAAG,CAAC;AACb,CAAC"}
|
package/package.json
ADDED
|
@@ -0,0 +1,72 @@
|
|
|
1
|
+
{
|
|
2
|
+
"name": "@casomoltd/nhs-pay",
|
|
3
|
+
"version": "0.4.7",
|
|
4
|
+
"description": "NHS Agenda for Change pay scales, pension tiers, regions, and take-home calculator",
|
|
5
|
+
"homepage": "https://github.com/casomoltd/nhs-pay#readme",
|
|
6
|
+
"bugs": "https://github.com/casomoltd/nhs-pay/issues",
|
|
7
|
+
"type": "module",
|
|
8
|
+
"main": "dist/index.js",
|
|
9
|
+
"types": "dist/index.d.ts",
|
|
10
|
+
"exports": {
|
|
11
|
+
".": {
|
|
12
|
+
"import": "./dist/index.js",
|
|
13
|
+
"types": "./dist/index.d.ts"
|
|
14
|
+
}
|
|
15
|
+
},
|
|
16
|
+
"files": [
|
|
17
|
+
"dist"
|
|
18
|
+
],
|
|
19
|
+
"scripts": {
|
|
20
|
+
"build": "tsc -p tsconfig.build.json",
|
|
21
|
+
"lint": "eslint .",
|
|
22
|
+
"lint:fix": "eslint . --fix",
|
|
23
|
+
"typecheck": "tsc --noEmit",
|
|
24
|
+
"test": "vitest run",
|
|
25
|
+
"test:watch": "vitest",
|
|
26
|
+
"knip": "knip",
|
|
27
|
+
"jscpd": "jscpd ./src",
|
|
28
|
+
"check": "npm run lint && npm run typecheck && npm run knip && npm run jscpd && npm run test",
|
|
29
|
+
"prepare": "husky"
|
|
30
|
+
},
|
|
31
|
+
"repository": {
|
|
32
|
+
"type": "git",
|
|
33
|
+
"url": "https://github.com/casomoltd/nhs-pay.git"
|
|
34
|
+
},
|
|
35
|
+
"keywords": [
|
|
36
|
+
"nhs",
|
|
37
|
+
"afc",
|
|
38
|
+
"agenda-for-change",
|
|
39
|
+
"pay-scales",
|
|
40
|
+
"pension",
|
|
41
|
+
"take-home",
|
|
42
|
+
"hcas"
|
|
43
|
+
],
|
|
44
|
+
"author": "Casomo Ltd",
|
|
45
|
+
"license": "LGPL-3.0-only",
|
|
46
|
+
"engines": {
|
|
47
|
+
"node": ">=22"
|
|
48
|
+
},
|
|
49
|
+
"publishConfig": {
|
|
50
|
+
"registry": "https://registry.npmjs.org",
|
|
51
|
+
"access": "public",
|
|
52
|
+
"provenance": true
|
|
53
|
+
},
|
|
54
|
+
"peerDependencies": {
|
|
55
|
+
"@casomoltd/paye-calc": ">=0.5.0"
|
|
56
|
+
},
|
|
57
|
+
"devDependencies": {
|
|
58
|
+
"@casomoltd/paye-calc": "^0.5.6",
|
|
59
|
+
"@casomoltd/tooling": "git+https://github.com/casomoltd/tooling.git#semver:^0.10.0",
|
|
60
|
+
"@commitlint/cli": "^20.0.0",
|
|
61
|
+
"@types/node": "^25.5.0",
|
|
62
|
+
"csv-parse": "^6.2.1",
|
|
63
|
+
"eslint": "^9.0.0",
|
|
64
|
+
"eslint-plugin-sonarjs": "^3.0.0",
|
|
65
|
+
"husky": "^9.0.0",
|
|
66
|
+
"jscpd": "^4.0.0",
|
|
67
|
+
"knip": "^5.0.0",
|
|
68
|
+
"typescript": "~5.9.2",
|
|
69
|
+
"typescript-eslint": "^8.0.0",
|
|
70
|
+
"vitest": "^3.0.0"
|
|
71
|
+
}
|
|
72
|
+
}
|