@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.
Files changed (56) hide show
  1. package/README.md +134 -3
  2. package/dist/award.d.ts +32 -0
  3. package/dist/award.js +59 -0
  4. package/dist/award.js.map +1 -0
  5. package/dist/bands.d.ts +8 -8
  6. package/dist/bands.js +6 -8
  7. package/dist/bands.js.map +1 -1
  8. package/dist/circulars/england-md-1-2026r.d.ts +257 -0
  9. package/dist/circulars/england-md-1-2026r.js +302 -0
  10. package/dist/circulars/england-md-1-2026r.js.map +1 -0
  11. package/dist/circulars/ni-hsc-tc8-05-2025.d.ts +166 -0
  12. package/dist/circulars/ni-hsc-tc8-05-2025.js +249 -0
  13. package/dist/circulars/ni-hsc-tc8-05-2025.js.map +1 -0
  14. package/dist/circulars/scotland-pcs-dd-2026-01.d.ts +34 -0
  15. package/dist/circulars/scotland-pcs-dd-2026-01.js +96 -0
  16. package/dist/circulars/scotland-pcs-dd-2026-01.js.map +1 -0
  17. package/dist/circulars/wales-mdw-01-2025.d.ts +130 -0
  18. package/dist/circulars/wales-mdw-01-2025.js +221 -0
  19. package/dist/circulars/wales-mdw-01-2025.js.map +1 -0
  20. package/dist/dental-scales.d.ts +44 -0
  21. package/dist/dental-scales.js +103 -0
  22. package/dist/dental-scales.js.map +1 -0
  23. package/dist/errors.d.ts +33 -5
  24. package/dist/errors.js +44 -6
  25. package/dist/errors.js.map +1 -1
  26. package/dist/index.d.ts +14 -7
  27. package/dist/index.js +8 -3
  28. package/dist/index.js.map +1 -1
  29. package/dist/medical-scales.d.ts +64 -0
  30. package/dist/medical-scales.js +153 -0
  31. package/dist/medical-scales.js.map +1 -0
  32. package/dist/pension.d.ts +18 -15
  33. package/dist/pension.js +99 -25
  34. package/dist/pension.js.map +1 -1
  35. package/dist/post.d.ts +78 -3
  36. package/dist/post.js +59 -6
  37. package/dist/post.js.map +1 -1
  38. package/dist/resolver.d.ts +17 -0
  39. package/dist/resolver.js +61 -0
  40. package/dist/resolver.js.map +1 -1
  41. package/dist/role.d.ts +25 -4
  42. package/dist/role.js +1 -2
  43. package/dist/role.js.map +1 -1
  44. package/dist/scale-point.d.ts +21 -0
  45. package/dist/scale-point.js +2 -0
  46. package/dist/scale-point.js.map +1 -0
  47. package/dist/scale-tables.d.ts +69 -0
  48. package/dist/scale-tables.js +98 -0
  49. package/dist/scale-tables.js.map +1 -0
  50. package/dist/scales.d.ts +2 -5
  51. package/dist/scales.js +1 -1
  52. package/dist/scales.js.map +1 -1
  53. package/dist/take-home.d.ts +36 -7
  54. package/dist/take-home.js +59 -13
  55. package/dist/take-home.js.map +1 -1
  56. 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 pay scales, pension tiers, regions,
4
- HCAS supplements, and take-home calculator. Built on top of
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
@@ -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, ScalePoint, HcasZones } from './scales.js';
12
- import type { PensionTier } from './pension.js';
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
- * a living wage floor to the England/NI base.
31
- * Omit `nation` for backward-compatible England
32
- * figures. */
33
- export declare function getAfcScales(year?: TaxYear, nation?: Nation): AfcScaleData;
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
- * a living wage floor to the England/NI base.
20
- * Omit `nation` for backward-compatible England
21
- * figures. */
22
- export function getAfcScales(year = AFC_CURRENT_YEAR, nation) {
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;AAErB,OAAO,EAAC,eAAe,EAAC,MAAM,cAAc,CAAC;AAiB7C,6CAA6C;AAC7C,MAAM,CAAC,MAAM,gBAAgB,GAAG,SAAS,CAAC,QAAQ,CAAC;AAEnD,8CAA8C;AAC9C,MAAM,CAAC,MAAM,iBAAiB,GAAG,SAAS,CAAC,QAAQ,CAAC;AAEpD;;;;eAIe;AACf,MAAM,UAAU,YAAY,CAC1B,OAAgB,gBAAgB,EAChC,MAAe;IAEf,MAAM,SAAS,GACb,gBAAgB,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACjC,MAAM,YAAY,GAAG,eAAe,CAAC,IAAI,CAAC,CAAC;IAE3C,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;QACpB,YAAY;KACb,CAAC;AACJ,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
+ };