@casomoltd/nhs-pay 0.5.0 → 0.7.2
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 +134 -3
- package/dist/award.d.ts +32 -0
- package/dist/award.js +59 -0
- package/dist/award.js.map +1 -0
- package/dist/bands.d.ts +8 -8
- package/dist/bands.js +6 -8
- package/dist/bands.js.map +1 -1
- package/dist/circulars/england-md-1-2026r.d.ts +257 -0
- package/dist/circulars/england-md-1-2026r.js +302 -0
- package/dist/circulars/england-md-1-2026r.js.map +1 -0
- package/dist/circulars/ni-hsc-tc8-05-2025.d.ts +166 -0
- package/dist/circulars/ni-hsc-tc8-05-2025.js +249 -0
- package/dist/circulars/ni-hsc-tc8-05-2025.js.map +1 -0
- package/dist/circulars/scotland-pcs-dd-2026-01.d.ts +34 -0
- package/dist/circulars/scotland-pcs-dd-2026-01.js +96 -0
- package/dist/circulars/scotland-pcs-dd-2026-01.js.map +1 -0
- package/dist/circulars/wales-mdw-01-2025.d.ts +130 -0
- package/dist/circulars/wales-mdw-01-2025.js +221 -0
- package/dist/circulars/wales-mdw-01-2025.js.map +1 -0
- package/dist/dental-scales.d.ts +44 -0
- package/dist/dental-scales.js +103 -0
- package/dist/dental-scales.js.map +1 -0
- package/dist/errors.d.ts +33 -5
- package/dist/errors.js +44 -6
- package/dist/errors.js.map +1 -1
- package/dist/index.d.ts +14 -7
- package/dist/index.js +8 -3
- package/dist/index.js.map +1 -1
- package/dist/medical-scales.d.ts +64 -0
- package/dist/medical-scales.js +153 -0
- package/dist/medical-scales.js.map +1 -0
- package/dist/pension.d.ts +18 -15
- package/dist/pension.js +99 -25
- package/dist/pension.js.map +1 -1
- package/dist/post.d.ts +78 -3
- package/dist/post.js +59 -6
- package/dist/post.js.map +1 -1
- package/dist/resolver.d.ts +17 -0
- package/dist/resolver.js +61 -0
- package/dist/resolver.js.map +1 -1
- package/dist/role.d.ts +25 -4
- package/dist/role.js +1 -2
- package/dist/role.js.map +1 -1
- package/dist/scale-point.d.ts +21 -0
- package/dist/scale-point.js +2 -0
- package/dist/scale-point.js.map +1 -0
- package/dist/scale-tables.d.ts +69 -0
- package/dist/scale-tables.js +98 -0
- package/dist/scale-tables.js.map +1 -0
- package/dist/scales.d.ts +2 -5
- package/dist/scales.js +1 -1
- package/dist/scales.js.map +1 -1
- package/dist/take-home.d.ts +36 -7
- package/dist/take-home.js +59 -13
- package/dist/take-home.js.map +1 -1
- package/package.json +2 -2
package/README.md
CHANGED
|
@@ -1,8 +1,24 @@
|
|
|
1
1
|
# @casomoltd/nhs-pay
|
|
2
2
|
|
|
3
|
-
NHS Agenda for Change
|
|
4
|
-
HCAS supplements, and take-home
|
|
5
|
-
`@casomoltd/paye-calc`.
|
|
3
|
+
NHS pay scales — Agenda for Change plus medical & dental —
|
|
4
|
+
with pension tiers, regions, HCAS supplements, and a take-home
|
|
5
|
+
calculator. Built on top of `@casomoltd/paye-calc`.
|
|
6
|
+
|
|
7
|
+
## About Casomo
|
|
8
|
+
|
|
9
|
+
Casomo is a [registered UK limited company][companies-house]
|
|
10
|
+
founded and directed by
|
|
11
|
+
[David Mohamad](https://github.com/dkmohamad). It builds focused
|
|
12
|
+
software tools and offers engineering consulting. This library
|
|
13
|
+
powers the NHS pay calculators and explainers on
|
|
14
|
+
[casomo.co.uk](https://casomo.co.uk) — where the differentiator is
|
|
15
|
+
showing **take-home** pay (after tax, NI and pension), not just the
|
|
16
|
+
gross figures most published sources stop at.
|
|
17
|
+
|
|
18
|
+
- **Portfolio** — [casomo.co.uk](https://casomo.co.uk)
|
|
19
|
+
- **Consulting** — [casomoltd.com](https://casomoltd.com)
|
|
20
|
+
|
|
21
|
+
[companies-house]: https://find-and-update.company-information.service.gov.uk/company/15030496
|
|
6
22
|
|
|
7
23
|
## Install
|
|
8
24
|
|
|
@@ -75,6 +91,32 @@ fmtSalary(31049); // '£31,049'
|
|
|
75
91
|
fmtPct(8.3); // '8.3%'
|
|
76
92
|
```
|
|
77
93
|
|
|
94
|
+
### Take-home for a doctor or dentist
|
|
95
|
+
|
|
96
|
+
Medical and dental grades resolve the same way as AfC, via a
|
|
97
|
+
per-family resolver. `getMedicalScales(year, nation)` lists the
|
|
98
|
+
grades published for a nation and year; `fromScalePoint` builds a
|
|
99
|
+
`Post` (gross, pension tier, tax, NI, take-home) from one point.
|
|
100
|
+
|
|
101
|
+
```ts
|
|
102
|
+
import {getMedicalScales, medicalResolver} from '@casomoltd/nhs-pay';
|
|
103
|
+
|
|
104
|
+
const grades = getMedicalScales('2026-27', 'england');
|
|
105
|
+
const consultant = grades.find((g) => g.grade === 'consultant')!;
|
|
106
|
+
const top = consultant.points.at(-1)!; // 'Threshold 4 · 19y'
|
|
107
|
+
|
|
108
|
+
const post = medicalResolver.fromScalePoint(
|
|
109
|
+
'consultant', top.label, 'england', '2026-27',
|
|
110
|
+
);
|
|
111
|
+
console.log(post.salary); // basic pay
|
|
112
|
+
console.log(post.pensionRate); // member contribution %
|
|
113
|
+
console.log(post.takeHome.net); // annual net after tax + NI + pension
|
|
114
|
+
```
|
|
115
|
+
|
|
116
|
+
`getDentalScales` / `dentalResolver` mirror this for salaried
|
|
117
|
+
dental grades. Both fail loud (`ScaleUnavailable`) for an
|
|
118
|
+
unpublished nation/year or grade rather than defaulting.
|
|
119
|
+
|
|
78
120
|
## API reference
|
|
79
121
|
|
|
80
122
|
### Scales (`scales.ts`)
|
|
@@ -154,6 +196,25 @@ fmtPct(8.3); // '8.3%'
|
|
|
154
196
|
| -------------- | ------------------------------------- |
|
|
155
197
|
| `nhsTakeHome` | Pre-configured TakeHomePay for NHS |
|
|
156
198
|
|
|
199
|
+
### Medical & dental (`medical-scales.ts`, `dental-scales.ts`, `resolver.ts`)
|
|
200
|
+
|
|
201
|
+
| Export | Description |
|
|
202
|
+
| ------------------ | --------------------------------------------- |
|
|
203
|
+
| `getMedicalScales` | Doctor grades for a nation/year, with points |
|
|
204
|
+
| `getDentalScales` | Salaried dental grades for a nation/year |
|
|
205
|
+
| `medicalResolver` | Build a `Post` from a doctor grade + point |
|
|
206
|
+
| `dentalResolver` | Build a `Post` from a dental grade + point |
|
|
207
|
+
|
|
208
|
+
Each resolver exposes `fromScalePoint(grade, pointLabel, nation,
|
|
209
|
+
year)`, `fromSalary`, `availableGrades(nation, year)` and
|
|
210
|
+
`latestYearFor(grade, nation)`. See
|
|
211
|
+
[Medical & dental pay scales](#medical--dental-pay-scales) for how
|
|
212
|
+
the data is sourced and modelled.
|
|
213
|
+
|
|
214
|
+
**Types:** `MedicalGradeId`, `DentalGradeId`, `MedicalGradeMeta`,
|
|
215
|
+
`DentalGradeMeta`, `MedicalRole`, `DentalRole`, `Role`, `Post`,
|
|
216
|
+
`GradeMeta`
|
|
217
|
+
|
|
157
218
|
### Format (`format.ts`)
|
|
158
219
|
|
|
159
220
|
| Export | Description |
|
|
@@ -227,6 +288,70 @@ pay letter (6 Jan 2026).
|
|
|
227
288
|
[pension-2526]: https://www.nhsbsa.nhs.uk/nhs-pensions-contribution-rates-202526
|
|
228
289
|
[nlw]: https://www.gov.uk/national-minimum-wage-rates
|
|
229
290
|
|
|
291
|
+
## Medical & dental pay scales
|
|
292
|
+
|
|
293
|
+
Doctors and dentists are paid on a separate set of pay circulars —
|
|
294
|
+
one per nation — from Agenda for Change. This library encodes them
|
|
295
|
+
so it can render **take-home** (not just gross) for medical and
|
|
296
|
+
dental grades, which is what most published sources omit.
|
|
297
|
+
|
|
298
|
+
| Nation | Circular | Year | Source |
|
|
299
|
+
| ------ | -------- | ---- | ------ |
|
|
300
|
+
| England | M&D 1/2026R | 2026/27 | [NHS Employers][md-eng] |
|
|
301
|
+
| Scotland | PCS(DD)2026/01 | 2026/27 (training grades only) | [NHS Scotland][md-sco] |
|
|
302
|
+
| Wales | M&D(W) 01/2025 | 2025/26 | [NHS Wales][md-wal] |
|
|
303
|
+
| Northern Ireland | HSC(TC8) 05/2025 | 2025/26 | [DoH NI][md-ni] |
|
|
304
|
+
|
|
305
|
+
[md-eng]: https://www.nhsemployers.org/articles/pay-and-conditions-circulars-medical-and-dental-staff
|
|
306
|
+
[md-sco]: https://www.publications.scot.nhs.uk/files/pcs-dd-2026-01.pdf
|
|
307
|
+
[md-wal]: https://www.nhs.wales/hpb/nhs-pay-and-conditions/
|
|
308
|
+
[md-ni]: https://www.health-ni.gov.uk/publications/hsc-tc8-052025
|
|
309
|
+
|
|
310
|
+
NI 2025/26 pension member tiers (HSC — distinct thresholds *and*
|
|
311
|
+
rates from NHSBSA) are sourced from [HSC Pensions][hsc-pension].
|
|
312
|
+
|
|
313
|
+
[hsc-pension]: https://hscpensions.hscni.net/
|
|
314
|
+
|
|
315
|
+
### How the data is modelled
|
|
316
|
+
|
|
317
|
+
The circulars vary widely in structure (nodal training points,
|
|
318
|
+
consultant thresholds, SAS experience bands, GP ranges, dental
|
|
319
|
+
spines), so the data is built in three layers that decouple
|
|
320
|
+
transcription fidelity from the uniform domain model:
|
|
321
|
+
|
|
322
|
+
1. **Verbatim circular** (`src/circulars/*.ts`) — one file per PDF,
|
|
323
|
+
each table transcribed 1:1 in source order with a row shape that
|
|
324
|
+
mirrors that table's own columns, under a comment citing the
|
|
325
|
+
Annex / section / page. Every table in the circular is either
|
|
326
|
+
transcribed or **recorded with a reason** for skipping it, so
|
|
327
|
+
nothing is silently dropped and each file diffs against the PDF
|
|
328
|
+
top-to-bottom.
|
|
329
|
+
2. **Translation layer** (`src/medical-scales.ts`,
|
|
330
|
+
`src/dental-scales.ts`) — selects which scales feed the
|
|
331
|
+
calculator and maps each verbatim row to a canonical scale point.
|
|
332
|
+
Inclusive by default: closed-to-new-entrant grades, devolved
|
|
333
|
+
training variants, GP registrars and the Community Dental Service
|
|
334
|
+
are all wired.
|
|
335
|
+
3. **Canonical domain** (`getMedicalScales` / `getDentalScales` +
|
|
336
|
+
`medicalResolver` / `dentalResolver`) — a uniform
|
|
337
|
+
`(grade, nation, year) → scale points` view, identical in shape
|
|
338
|
+
to the AfC resolver.
|
|
339
|
+
|
|
340
|
+
**Scope.** *(a)* every basic-pay salary scale, including
|
|
341
|
+
closed-to-new-entrant grades still paid to incumbents, plus *(b)*
|
|
342
|
+
earnings-affecting supplements expressed as an annual £ (Clinical
|
|
343
|
+
Impact / Excellence awards, DPH and intensity supplements). Pure
|
|
344
|
+
expense tables (mileage, fees) and self-employed GDS/UDA dentist
|
|
345
|
+
contract income are out of scope.
|
|
346
|
+
|
|
347
|
+
**Year mismatch is honest.** England and Scotland have published
|
|
348
|
+
2026/27; Wales and NI's latest M&D circulars are 2025/26. Each grade
|
|
349
|
+
resolves at its own cited year and `latestYearFor(grade, nation)`
|
|
350
|
+
reports it — figures are never silently carried forward. Scotland's
|
|
351
|
+
2026/27 circular covers training grades only (consultant / SAS / GP
|
|
352
|
+
scales are promulgated in a separate addendum), so those grades fail
|
|
353
|
+
loud until the addendum is transcribed.
|
|
354
|
+
|
|
230
355
|
## Test fixtures
|
|
231
356
|
|
|
232
357
|
`tests/fixtures/band-take-home.csv` — 90 golden-value rows
|
|
@@ -246,6 +371,8 @@ Pension, tax, NI and net values are computed by
|
|
|
246
371
|
|
|
247
372
|
## Tax years
|
|
248
373
|
|
|
374
|
+
AfC scale + pension coverage (all four nations):
|
|
375
|
+
|
|
249
376
|
| Year | Scales | Pension |
|
|
250
377
|
| ------- | ------ | ------- |
|
|
251
378
|
| 2023-24 | Yes | Yes |
|
|
@@ -253,6 +380,10 @@ Pension, tax, NI and net values are computed by
|
|
|
253
380
|
| 2025-26 | Yes | Yes |
|
|
254
381
|
| 2026-27 | Yes | Yes |
|
|
255
382
|
|
|
383
|
+
Medical & dental coverage is per-nation (England/Scotland 2026/27,
|
|
384
|
+
Wales/NI 2025/26) — see
|
|
385
|
+
[Medical & dental pay scales](#medical--dental-pay-scales).
|
|
386
|
+
|
|
256
387
|
## Development
|
|
257
388
|
|
|
258
389
|
```bash
|
package/dist/award.d.ts
ADDED
|
@@ -0,0 +1,32 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Agenda for Change headline pay awards (consolidated % uplift) by
|
|
3
|
+
* nation and year.
|
|
4
|
+
*
|
|
5
|
+
* The negotiated award is published data, NOT derivable from the
|
|
6
|
+
* scale points: per-point rounding diverges from the headline (e.g.
|
|
7
|
+
* Scotland's 3.75% award computes as ~3.8% from a single band's
|
|
8
|
+
* min-point delta), and staged awards have no single scale ratio. So
|
|
9
|
+
* the award lives here as a cited constant, one per (nation, year),
|
|
10
|
+
* each nation recorded independently because the four nations
|
|
11
|
+
* negotiate separately.
|
|
12
|
+
*
|
|
13
|
+
* Sources (also pinned per-row in tests/fixtures/afc-awards.csv):
|
|
14
|
+
* - England & Wales: NHS Employers pay circulars —
|
|
15
|
+
* 2025/26 https://www.nhsemployers.org/articles/pay-scales-202526
|
|
16
|
+
* 2026/27 https://www.nhsemployers.org/articles/pay-scales-202627
|
|
17
|
+
* - Scotland: NHS Scotland circular PCS(AFC)2026/1 — 4.25% for
|
|
18
|
+
* 2025-26 (average 4.4% after the inflation guarantee) and 3.75%
|
|
19
|
+
* for 2026-27:
|
|
20
|
+
* https://www.publications.scot.nhs.uk/files/pcs2026-afc-01.pdf
|
|
21
|
+
* - Northern Ireland: Department of Health (NI) accepted the UK PRB
|
|
22
|
+
* award, aligned with England (3.6% / 3.3%); 2026/27 subject to
|
|
23
|
+
* local implementation.
|
|
24
|
+
*/
|
|
25
|
+
import type { Nation, TaxYear } from '@casomoltd/paye-calc';
|
|
26
|
+
/**
|
|
27
|
+
* The AfC headline pay award for a nation and year, as a percentage
|
|
28
|
+
* (e.g. `3.75` for 3.75%). Throws {@link AwardUnavailable} for an
|
|
29
|
+
* unrecorded combination rather than defaulting — the caller must
|
|
30
|
+
* name the nation (no silent fallback).
|
|
31
|
+
*/
|
|
32
|
+
export declare function afcAward(year: TaxYear, nation: Nation): number;
|
package/dist/award.js
ADDED
|
@@ -0,0 +1,59 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Agenda for Change headline pay awards (consolidated % uplift) by
|
|
3
|
+
* nation and year.
|
|
4
|
+
*
|
|
5
|
+
* The negotiated award is published data, NOT derivable from the
|
|
6
|
+
* scale points: per-point rounding diverges from the headline (e.g.
|
|
7
|
+
* Scotland's 3.75% award computes as ~3.8% from a single band's
|
|
8
|
+
* min-point delta), and staged awards have no single scale ratio. So
|
|
9
|
+
* the award lives here as a cited constant, one per (nation, year),
|
|
10
|
+
* each nation recorded independently because the four nations
|
|
11
|
+
* negotiate separately.
|
|
12
|
+
*
|
|
13
|
+
* Sources (also pinned per-row in tests/fixtures/afc-awards.csv):
|
|
14
|
+
* - England & Wales: NHS Employers pay circulars —
|
|
15
|
+
* 2025/26 https://www.nhsemployers.org/articles/pay-scales-202526
|
|
16
|
+
* 2026/27 https://www.nhsemployers.org/articles/pay-scales-202627
|
|
17
|
+
* - Scotland: NHS Scotland circular PCS(AFC)2026/1 — 4.25% for
|
|
18
|
+
* 2025-26 (average 4.4% after the inflation guarantee) and 3.75%
|
|
19
|
+
* for 2026-27:
|
|
20
|
+
* https://www.publications.scot.nhs.uk/files/pcs2026-afc-01.pdf
|
|
21
|
+
* - Northern Ireland: Department of Health (NI) accepted the UK PRB
|
|
22
|
+
* award, aligned with England (3.6% / 3.3%); 2026/27 subject to
|
|
23
|
+
* local implementation.
|
|
24
|
+
*/
|
|
25
|
+
import { NATION_KEYS, TAX_YEARS } from '@casomoltd/paye-calc';
|
|
26
|
+
import { AwardUnavailable } from './errors.js';
|
|
27
|
+
/** Headline consolidated AfC uplift (%), by nation and year. */
|
|
28
|
+
const AFC_AWARDS = {
|
|
29
|
+
[NATION_KEYS.england]: {
|
|
30
|
+
[TAX_YEARS.Y2025_26]: 3.6,
|
|
31
|
+
[TAX_YEARS.Y2026_27]: 3.3,
|
|
32
|
+
},
|
|
33
|
+
[NATION_KEYS.wales]: {
|
|
34
|
+
[TAX_YEARS.Y2025_26]: 3.6,
|
|
35
|
+
[TAX_YEARS.Y2026_27]: 3.3,
|
|
36
|
+
},
|
|
37
|
+
[NATION_KEYS.scotland]: {
|
|
38
|
+
[TAX_YEARS.Y2025_26]: 4.25,
|
|
39
|
+
[TAX_YEARS.Y2026_27]: 3.75,
|
|
40
|
+
},
|
|
41
|
+
[NATION_KEYS.northernIreland]: {
|
|
42
|
+
[TAX_YEARS.Y2025_26]: 3.6,
|
|
43
|
+
[TAX_YEARS.Y2026_27]: 3.3,
|
|
44
|
+
},
|
|
45
|
+
};
|
|
46
|
+
/**
|
|
47
|
+
* The AfC headline pay award for a nation and year, as a percentage
|
|
48
|
+
* (e.g. `3.75` for 3.75%). Throws {@link AwardUnavailable} for an
|
|
49
|
+
* unrecorded combination rather than defaulting — the caller must
|
|
50
|
+
* name the nation (no silent fallback).
|
|
51
|
+
*/
|
|
52
|
+
export function afcAward(year, nation) {
|
|
53
|
+
const pct = AFC_AWARDS[nation][year];
|
|
54
|
+
if (pct === undefined) {
|
|
55
|
+
throw new AwardUnavailable(year, nation);
|
|
56
|
+
}
|
|
57
|
+
return pct;
|
|
58
|
+
}
|
|
59
|
+
//# sourceMappingURL=award.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"award.js","sourceRoot":"","sources":["../src/award.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAGH,OAAO,EAAC,WAAW,EAAE,SAAS,EAAC,MAAM,sBAAsB,CAAC;AAC5D,OAAO,EAAC,gBAAgB,EAAC,MAAM,aAAa,CAAC;AAE7C,gEAAgE;AAChE,MAAM,UAAU,GAGZ;IACF,CAAC,WAAW,CAAC,OAAO,CAAC,EAAE;QACrB,CAAC,SAAS,CAAC,QAAQ,CAAC,EAAE,GAAG;QACzB,CAAC,SAAS,CAAC,QAAQ,CAAC,EAAE,GAAG;KAC1B;IACD,CAAC,WAAW,CAAC,KAAK,CAAC,EAAE;QACnB,CAAC,SAAS,CAAC,QAAQ,CAAC,EAAE,GAAG;QACzB,CAAC,SAAS,CAAC,QAAQ,CAAC,EAAE,GAAG;KAC1B;IACD,CAAC,WAAW,CAAC,QAAQ,CAAC,EAAE;QACtB,CAAC,SAAS,CAAC,QAAQ,CAAC,EAAE,IAAI;QAC1B,CAAC,SAAS,CAAC,QAAQ,CAAC,EAAE,IAAI;KAC3B;IACD,CAAC,WAAW,CAAC,eAAe,CAAC,EAAE;QAC7B,CAAC,SAAS,CAAC,QAAQ,CAAC,EAAE,GAAG;QACzB,CAAC,SAAS,CAAC,QAAQ,CAAC,EAAE,GAAG;KAC1B;CACF,CAAC;AAEF;;;;;GAKG;AACH,MAAM,UAAU,QAAQ,CAAC,IAAa,EAAE,MAAc;IACpD,MAAM,GAAG,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC;IACrC,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;QACtB,MAAM,IAAI,gBAAgB,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IAC3C,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC"}
|
package/dist/bands.d.ts
CHANGED
|
@@ -8,8 +8,8 @@
|
|
|
8
8
|
* domain library.
|
|
9
9
|
*/
|
|
10
10
|
import type { TaxYear, Nation } from '@casomoltd/paye-calc';
|
|
11
|
-
import type { AfcBandId,
|
|
12
|
-
import type {
|
|
11
|
+
import type { AfcBandId, HcasZones } from './scales.js';
|
|
12
|
+
import type { ScalePoint } from './scale-point.js';
|
|
13
13
|
import type { SalaryRange } from './values.js';
|
|
14
14
|
export interface AfcBandMeta {
|
|
15
15
|
band: AfcBandId;
|
|
@@ -19,15 +19,15 @@ export interface AfcBandMeta {
|
|
|
19
19
|
export interface AfcScaleData {
|
|
20
20
|
bands: AfcBandMeta[];
|
|
21
21
|
hcas: HcasZones;
|
|
22
|
-
pensionTiers: PensionTier[];
|
|
23
22
|
}
|
|
24
23
|
/** Current financial year for band pages. */
|
|
25
24
|
export declare const AFC_CURRENT_YEAR: "2026-27";
|
|
26
25
|
/** Previous financial year for comparison. */
|
|
27
26
|
export declare const AFC_PREVIOUS_YEAR: "2025-26";
|
|
28
27
|
/** Load AFC scale data — synchronous, no file I/O.
|
|
29
|
-
* Scotland has its own scale tables; Wales applies
|
|
30
|
-
*
|
|
31
|
-
*
|
|
32
|
-
* figures
|
|
33
|
-
|
|
28
|
+
* Scotland has its own scale tables; Wales applies a living wage
|
|
29
|
+
* floor to the England/NI base. `year` and `nation` are both
|
|
30
|
+
* required — the accessor never defaults a locale, since a
|
|
31
|
+
* forgotten `nation` would silently return England figures for
|
|
32
|
+
* every region (the exact bug this signature prevents). */
|
|
33
|
+
export declare function getAfcScales(year: TaxYear, nation: Nation): AfcScaleData;
|
package/dist/bands.js
CHANGED
|
@@ -9,19 +9,18 @@
|
|
|
9
9
|
*/
|
|
10
10
|
import { TAX_YEARS } from '@casomoltd/paye-calc';
|
|
11
11
|
import { AFC_BAND_IDS, getScalesForYear, } from './scales.js';
|
|
12
|
-
import { getPensionTiers } from './pension.js';
|
|
13
12
|
/** Current financial year for band pages. */
|
|
14
13
|
export const AFC_CURRENT_YEAR = TAX_YEARS.Y2026_27;
|
|
15
14
|
/** Previous financial year for comparison. */
|
|
16
15
|
export const AFC_PREVIOUS_YEAR = TAX_YEARS.Y2025_26;
|
|
17
16
|
/** Load AFC scale data — synchronous, no file I/O.
|
|
18
|
-
* Scotland has its own scale tables; Wales applies
|
|
19
|
-
*
|
|
20
|
-
*
|
|
21
|
-
* figures
|
|
22
|
-
|
|
17
|
+
* Scotland has its own scale tables; Wales applies a living wage
|
|
18
|
+
* floor to the England/NI base. `year` and `nation` are both
|
|
19
|
+
* required — the accessor never defaults a locale, since a
|
|
20
|
+
* forgotten `nation` would silently return England figures for
|
|
21
|
+
* every region (the exact bug this signature prevents). */
|
|
22
|
+
export function getAfcScales(year, nation) {
|
|
23
23
|
const scaleYear = getScalesForYear(year, nation);
|
|
24
|
-
const pensionTiers = getPensionTiers(year);
|
|
25
24
|
const bands = AFC_BAND_IDS.map((band) => {
|
|
26
25
|
const points = scaleYear.scales[band];
|
|
27
26
|
const salaries = points.map((p) => p.salary);
|
|
@@ -37,7 +36,6 @@ export function getAfcScales(year = AFC_CURRENT_YEAR, nation) {
|
|
|
37
36
|
return {
|
|
38
37
|
bands,
|
|
39
38
|
hcas: scaleYear.hcas,
|
|
40
|
-
pensionTiers,
|
|
41
39
|
};
|
|
42
40
|
}
|
|
43
41
|
//# sourceMappingURL=bands.js.map
|
package/dist/bands.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"bands.js","sourceRoot":"","sources":["../src/bands.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAKH,OAAO,EAAC,SAAS,EAAC,MAAM,sBAAsB,CAAC;AAM/C,OAAO,EACL,YAAY,EACZ,gBAAgB,GACjB,MAAM,aAAa,CAAC;
|
|
1
|
+
{"version":3,"file":"bands.js","sourceRoot":"","sources":["../src/bands.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAKH,OAAO,EAAC,SAAS,EAAC,MAAM,sBAAsB,CAAC;AAM/C,OAAO,EACL,YAAY,EACZ,gBAAgB,GACjB,MAAM,aAAa,CAAC;AAoBrB,6CAA6C;AAC7C,MAAM,CAAC,MAAM,gBAAgB,GAAG,SAAS,CAAC,QAAQ,CAAC;AAEnD,8CAA8C;AAC9C,MAAM,CAAC,MAAM,iBAAiB,GAAG,SAAS,CAAC,QAAQ,CAAC;AAEpD;;;;;4DAK4D;AAC5D,MAAM,UAAU,YAAY,CAC1B,IAAa,EACb,MAAc;IAEd,MAAM,SAAS,GAAG,gBAAgB,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IAEjD,MAAM,KAAK,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;QACtC,MAAM,MAAM,GAAG,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QACtC,MAAM,QAAQ,GAAG,MAAM,CAAC,GAAG,CACzB,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAChB,CAAC;QACF,OAAO;YACL,IAAI;YACJ,MAAM;YACN,MAAM,EAAE;gBACN,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,QAAQ,CAAC;gBAC1B,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,QAAQ,CAAC;aAC3B;SACF,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,OAAO;QACL,KAAK;QACL,IAAI,EAAE,SAAS,CAAC,IAAI;KACrB,CAAC;AACJ,CAAC"}
|
|
@@ -0,0 +1,257 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Verbatim transcription of NHS Employers Pay & Conditions Circular
|
|
3
|
+
* (M&D) 1/2026R — "Pay award for hospital medical and dental staff,
|
|
4
|
+
* doctors and dentists in public health, the community health service
|
|
5
|
+
* and salaried primary dental care (England)". Republished 30 June
|
|
6
|
+
* 2026 (first published 11 May 2026); rates effective 1 April 2026.
|
|
7
|
+
*
|
|
8
|
+
* This mirrors the circular's Annex A section by section, so it can be
|
|
9
|
+
* diffed against the PDF top-to-bottom. Scope captured (per the agreed
|
|
10
|
+
* policy):
|
|
11
|
+
* (a) every basic-pay SALARY SCALE — all grades, all steps, incl.
|
|
12
|
+
* closed-to-new-entrant grades (still paid to incumbents);
|
|
13
|
+
* (b) earnings-affecting supplements/awards expressed as an annual £
|
|
14
|
+
* tied to a grade/threshold (on-call availability, Clinical
|
|
15
|
+
* Impact Awards, DPH supplement, intensity supplements, dental
|
|
16
|
+
* training supplement).
|
|
17
|
+
* Every other table is RECORDED below with a note on why it is not
|
|
18
|
+
* transcribed — nothing is silently dropped. The translation layer
|
|
19
|
+
* (not this file) decides which of these feed the calculator domain.
|
|
20
|
+
*
|
|
21
|
+
* Public source: NHS Employers — Pay & Conditions Circular (M&D) 1/2026R,
|
|
22
|
+
* https://www.nhsemployers.org/articles/pay-and-conditions-circulars-medical-and-dental-staff
|
|
23
|
+
*/
|
|
24
|
+
export declare const ENGLAND_MD_1_2026R: {
|
|
25
|
+
readonly circular: "NHS Employers PC(M&D) 1/2026R";
|
|
26
|
+
readonly nation: "england";
|
|
27
|
+
readonly effectiveFrom: "2026-04-01";
|
|
28
|
+
readonly doctorsInTraining: {
|
|
29
|
+
stage: string;
|
|
30
|
+
code: string;
|
|
31
|
+
nodalPoint: number;
|
|
32
|
+
salary: number;
|
|
33
|
+
}[];
|
|
34
|
+
readonly dentistsInTraining: {
|
|
35
|
+
stage: string;
|
|
36
|
+
code: string;
|
|
37
|
+
nodalPoint: number;
|
|
38
|
+
salary: number;
|
|
39
|
+
}[];
|
|
40
|
+
readonly locallyEmployedDoctors: {
|
|
41
|
+
code: string;
|
|
42
|
+
nodalPoint: number;
|
|
43
|
+
salary: number;
|
|
44
|
+
}[];
|
|
45
|
+
readonly onCallAvailabilityAllowance: readonly [{
|
|
46
|
+
readonly nodalPoint: 1;
|
|
47
|
+
readonly salary: 3216;
|
|
48
|
+
}, {
|
|
49
|
+
readonly nodalPoint: 2;
|
|
50
|
+
readonly salary: 3680;
|
|
51
|
+
}, {
|
|
52
|
+
readonly nodalPoint: 3;
|
|
53
|
+
readonly salary: 4360;
|
|
54
|
+
}, {
|
|
55
|
+
readonly nodalPoint: 4;
|
|
56
|
+
readonly salary: 5386;
|
|
57
|
+
}, {
|
|
58
|
+
readonly nodalPoint: 5;
|
|
59
|
+
readonly salary: 6127;
|
|
60
|
+
}];
|
|
61
|
+
readonly consultant: {
|
|
62
|
+
threshold: string;
|
|
63
|
+
yearCompleted: number;
|
|
64
|
+
salary: number;
|
|
65
|
+
substantiveCode: string;
|
|
66
|
+
locumCode: string;
|
|
67
|
+
}[];
|
|
68
|
+
readonly nationalClinicalImpactAwards: readonly [{
|
|
69
|
+
readonly level: 1;
|
|
70
|
+
readonly salary: 21000;
|
|
71
|
+
}, {
|
|
72
|
+
readonly level: 2;
|
|
73
|
+
readonly salary: 31500;
|
|
74
|
+
}, {
|
|
75
|
+
readonly level: 3;
|
|
76
|
+
readonly salary: 42000;
|
|
77
|
+
}];
|
|
78
|
+
readonly dphSupplement: readonly [{
|
|
79
|
+
readonly band: "A";
|
|
80
|
+
readonly min: 19380;
|
|
81
|
+
readonly max: 28133;
|
|
82
|
+
readonly exceptionalMax: 0;
|
|
83
|
+
}, {
|
|
84
|
+
readonly band: "B";
|
|
85
|
+
readonly min: 7504;
|
|
86
|
+
readonly max: 15025;
|
|
87
|
+
readonly exceptionalMax: 19380;
|
|
88
|
+
}, {
|
|
89
|
+
readonly band: "C";
|
|
90
|
+
readonly min: 6274;
|
|
91
|
+
readonly max: 12504;
|
|
92
|
+
readonly exceptionalMax: 15025;
|
|
93
|
+
}, {
|
|
94
|
+
readonly band: "D";
|
|
95
|
+
readonly min: 5002;
|
|
96
|
+
readonly max: 10001;
|
|
97
|
+
readonly exceptionalMax: 12504;
|
|
98
|
+
}];
|
|
99
|
+
readonly intensitySupplements: readonly [{
|
|
100
|
+
readonly description: "Daytime intensity";
|
|
101
|
+
readonly salary: 1810;
|
|
102
|
+
}, {
|
|
103
|
+
readonly description: "Out of hours Band 1 (low)";
|
|
104
|
+
readonly salary: 1363;
|
|
105
|
+
}, {
|
|
106
|
+
readonly description: "Out of hours Band 2 (medium)";
|
|
107
|
+
readonly salary: 2717;
|
|
108
|
+
}, {
|
|
109
|
+
readonly description: "Out of hours Band 3 (high)";
|
|
110
|
+
readonly salary: 4062;
|
|
111
|
+
}];
|
|
112
|
+
readonly specialtyDoctor: {
|
|
113
|
+
code: string;
|
|
114
|
+
yearsExperience: number;
|
|
115
|
+
salary: number;
|
|
116
|
+
}[];
|
|
117
|
+
readonly specialist: {
|
|
118
|
+
code: string;
|
|
119
|
+
yearsExperience: number;
|
|
120
|
+
salary: number;
|
|
121
|
+
}[];
|
|
122
|
+
readonly salariedGpRange: {
|
|
123
|
+
readonly min: 78699;
|
|
124
|
+
readonly max: 118759;
|
|
125
|
+
};
|
|
126
|
+
readonly gpEducators: {
|
|
127
|
+
point: string;
|
|
128
|
+
code: string;
|
|
129
|
+
salary: number;
|
|
130
|
+
}[];
|
|
131
|
+
readonly salariedDentalSpine: {
|
|
132
|
+
code: string;
|
|
133
|
+
point: number;
|
|
134
|
+
salary: number;
|
|
135
|
+
}[];
|
|
136
|
+
readonly dentalTrainingSupplement: 2843;
|
|
137
|
+
readonly dentalEducators: {
|
|
138
|
+
point: string;
|
|
139
|
+
code: string;
|
|
140
|
+
salary: number;
|
|
141
|
+
}[];
|
|
142
|
+
readonly closedGrades: {
|
|
143
|
+
grade: string;
|
|
144
|
+
code: string;
|
|
145
|
+
salaries: number[];
|
|
146
|
+
}[];
|
|
147
|
+
readonly specialtyDoctor2008: readonly [{
|
|
148
|
+
readonly code: "MC46-01";
|
|
149
|
+
readonly salary: 55176;
|
|
150
|
+
}, {
|
|
151
|
+
readonly code: "MC46-02";
|
|
152
|
+
readonly salary: 59757;
|
|
153
|
+
}, {
|
|
154
|
+
readonly code: "MC46-03";
|
|
155
|
+
readonly salary: 65713;
|
|
156
|
+
}, {
|
|
157
|
+
readonly code: "MC46-04";
|
|
158
|
+
readonly salary: 68905;
|
|
159
|
+
}, {
|
|
160
|
+
readonly code: "MC46-05";
|
|
161
|
+
readonly salary: 73504;
|
|
162
|
+
}, {
|
|
163
|
+
readonly code: "MC46-06";
|
|
164
|
+
readonly salary: 78085;
|
|
165
|
+
}, {
|
|
166
|
+
readonly code: "MC46-07";
|
|
167
|
+
readonly salary: 78085;
|
|
168
|
+
}, {
|
|
169
|
+
readonly code: "MC46-08";
|
|
170
|
+
readonly salary: 82769;
|
|
171
|
+
}, {
|
|
172
|
+
readonly code: "MC46-09";
|
|
173
|
+
readonly salary: 82769;
|
|
174
|
+
}, {
|
|
175
|
+
readonly code: "MC46-10";
|
|
176
|
+
readonly salary: 87455;
|
|
177
|
+
}, {
|
|
178
|
+
readonly code: "MC46-11";
|
|
179
|
+
readonly salary: 87455;
|
|
180
|
+
}, {
|
|
181
|
+
readonly code: "MC46-12";
|
|
182
|
+
readonly salary: 92141;
|
|
183
|
+
}, {
|
|
184
|
+
readonly code: "MC46-13";
|
|
185
|
+
readonly salary: 92141;
|
|
186
|
+
}, {
|
|
187
|
+
readonly code: "MC46-14";
|
|
188
|
+
readonly salary: 92141;
|
|
189
|
+
}, {
|
|
190
|
+
readonly code: "MC46-15";
|
|
191
|
+
readonly salary: 96825;
|
|
192
|
+
}, {
|
|
193
|
+
readonly code: "MC46-16";
|
|
194
|
+
readonly salary: 96825;
|
|
195
|
+
}, {
|
|
196
|
+
readonly code: "MC46-17";
|
|
197
|
+
readonly salary: 96825;
|
|
198
|
+
}, {
|
|
199
|
+
readonly code: "MC46-18";
|
|
200
|
+
readonly salary: 101511;
|
|
201
|
+
}];
|
|
202
|
+
readonly associateSpecialist2008: readonly [{
|
|
203
|
+
readonly code: "MC41-01";
|
|
204
|
+
readonly salary: 76717;
|
|
205
|
+
}, {
|
|
206
|
+
readonly code: "MC41-02";
|
|
207
|
+
readonly salary: 82756;
|
|
208
|
+
}, {
|
|
209
|
+
readonly code: "MC41-03";
|
|
210
|
+
readonly salary: 88792;
|
|
211
|
+
}, {
|
|
212
|
+
readonly code: "MC41-04";
|
|
213
|
+
readonly salary: 96765;
|
|
214
|
+
}, {
|
|
215
|
+
readonly code: "MC41-05";
|
|
216
|
+
readonly salary: 103676;
|
|
217
|
+
}, {
|
|
218
|
+
readonly code: "MC41-06";
|
|
219
|
+
readonly salary: 106543;
|
|
220
|
+
}, {
|
|
221
|
+
readonly code: "MC41-07";
|
|
222
|
+
readonly salary: 106543;
|
|
223
|
+
}, {
|
|
224
|
+
readonly code: "MC41-08";
|
|
225
|
+
readonly salary: 110284;
|
|
226
|
+
}, {
|
|
227
|
+
readonly code: "MC41-09";
|
|
228
|
+
readonly salary: 110284;
|
|
229
|
+
}, {
|
|
230
|
+
readonly code: "MC41-10";
|
|
231
|
+
readonly salary: 114025;
|
|
232
|
+
}, {
|
|
233
|
+
readonly code: "MC41-11";
|
|
234
|
+
readonly salary: 114025;
|
|
235
|
+
}, {
|
|
236
|
+
readonly code: "MC41-12";
|
|
237
|
+
readonly salary: 117766;
|
|
238
|
+
}, {
|
|
239
|
+
readonly code: "MC41-13";
|
|
240
|
+
readonly salary: 117766;
|
|
241
|
+
}, {
|
|
242
|
+
readonly code: "MC41-14";
|
|
243
|
+
readonly salary: 117766;
|
|
244
|
+
}, {
|
|
245
|
+
readonly code: "MC41-15";
|
|
246
|
+
readonly salary: 121507;
|
|
247
|
+
}, {
|
|
248
|
+
readonly code: "MC41-16";
|
|
249
|
+
readonly salary: 121507;
|
|
250
|
+
}, {
|
|
251
|
+
readonly code: "MC41-17";
|
|
252
|
+
readonly salary: 121507;
|
|
253
|
+
}, {
|
|
254
|
+
readonly code: "MC41-18";
|
|
255
|
+
readonly salary: 125251;
|
|
256
|
+
}];
|
|
257
|
+
};
|