@casomoltd/nhs-pay 0.32.0 → 0.34.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.
Files changed (125) hide show
  1. package/README.md +24 -22
  2. package/dist/afc-band.d.ts +4 -4
  3. package/dist/afc-band.js +4 -4
  4. package/dist/afc-scales.d.ts +89 -60
  5. package/dist/afc-scales.js +166 -182
  6. package/dist/afc-scales.js.map +1 -1
  7. package/dist/allowances.js +11 -11
  8. package/dist/allowances.js.map +1 -1
  9. package/dist/award.d.ts +3 -3
  10. package/dist/award.js +21 -21
  11. package/dist/award.js.map +1 -1
  12. package/dist/circulars/afc-shapes.d.ts +41 -21
  13. package/dist/circulars/afc-shapes.js +9 -8
  14. package/dist/circulars/afc-shapes.js.map +1 -1
  15. package/dist/circulars/england-md-1-2026-r2.d.ts +13 -0
  16. package/dist/circulars/england-md-1-2026-r2.js +13 -0
  17. package/dist/circulars/england-md-1-2026-r2.js.map +1 -1
  18. package/dist/circulars/ni-hsc-afc-06-2025.d.ts +3 -2
  19. package/dist/circulars/ni-hsc-afc-06-2025.js +3 -2
  20. package/dist/circulars/ni-hsc-afc-06-2025.js.map +1 -1
  21. package/dist/circulars/ni-hsc-tc8-05-2025.d.ts +22 -0
  22. package/dist/circulars/ni-hsc-tc8-05-2025.js +22 -0
  23. package/dist/circulars/ni-hsc-tc8-05-2025.js.map +1 -1
  24. package/dist/circulars/scotland-pcs-dd-2025-01.d.ts +20 -0
  25. package/dist/circulars/scotland-pcs-dd-2025-01.js +20 -0
  26. package/dist/circulars/scotland-pcs-dd-2025-01.js.map +1 -1
  27. package/dist/circulars/scotland-pcs-dd-2026-01.d.ts +19 -0
  28. package/dist/circulars/scotland-pcs-dd-2026-01.js +30 -10
  29. package/dist/circulars/scotland-pcs-dd-2026-01.js.map +1 -1
  30. package/dist/circulars/scotland-pcs-dd-2026-02.d.ts +10 -0
  31. package/dist/circulars/scotland-pcs-dd-2026-02.js +10 -0
  32. package/dist/circulars/scotland-pcs-dd-2026-02.js.map +1 -1
  33. package/dist/circulars/wales-mdw-01-2025.d.ts +17 -0
  34. package/dist/circulars/wales-mdw-01-2025.js +17 -0
  35. package/dist/circulars/wales-mdw-01-2025.js.map +1 -1
  36. package/dist/circulars/wales-mdw-01-2026.d.ts +20 -0
  37. package/dist/circulars/wales-mdw-01-2026.js +20 -0
  38. package/dist/circulars/wales-mdw-01-2026.js.map +1 -1
  39. package/dist/commutation.js +3 -2
  40. package/dist/commutation.js.map +1 -1
  41. package/dist/dental-grades.d.ts +25 -0
  42. package/dist/dental-grades.js +25 -0
  43. package/dist/dental-grades.js.map +1 -0
  44. package/dist/dental-scales.d.ts +5 -21
  45. package/dist/dental-scales.js +73 -72
  46. package/dist/dental-scales.js.map +1 -1
  47. package/dist/format.js +3 -2
  48. package/dist/format.js.map +1 -1
  49. package/dist/hcas-pcts.d.ts +1 -1
  50. package/dist/hcas-pcts.js +1 -1
  51. package/dist/hcas-pcts.js.map +1 -1
  52. package/dist/hcas-zone.d.ts +23 -0
  53. package/dist/hcas-zone.js +17 -0
  54. package/dist/hcas-zone.js.map +1 -0
  55. package/dist/hcas.d.ts +26 -18
  56. package/dist/hcas.js +45 -24
  57. package/dist/hcas.js.map +1 -1
  58. package/dist/index.d.ts +25 -16
  59. package/dist/index.js +14 -10
  60. package/dist/index.js.map +1 -1
  61. package/dist/medical-grades.d.ts +33 -0
  62. package/dist/medical-grades.js +33 -0
  63. package/dist/medical-grades.js.map +1 -0
  64. package/dist/medical-scales.d.ts +10 -33
  65. package/dist/medical-scales.js +104 -158
  66. package/dist/medical-scales.js.map +1 -1
  67. package/dist/member/input-period.d.ts +18 -5
  68. package/dist/member/input-period.js +24 -13
  69. package/dist/member/input-period.js.map +1 -1
  70. package/dist/pay-round.js +3 -3
  71. package/dist/pay-round.js.map +1 -1
  72. package/dist/pay-year.d.ts +17 -0
  73. package/dist/pay-year.js +20 -0
  74. package/dist/pay-year.js.map +1 -0
  75. package/dist/pension/ledger.d.ts +7 -0
  76. package/dist/pension/ledger.js +18 -11
  77. package/dist/pension/ledger.js.map +1 -1
  78. package/dist/pension.js +2 -1
  79. package/dist/pension.js.map +1 -1
  80. package/dist/post.d.ts +20 -21
  81. package/dist/post.js +54 -53
  82. package/dist/post.js.map +1 -1
  83. package/dist/published/england-afc.d.ts +72 -0
  84. package/dist/published/england-afc.js +86 -0
  85. package/dist/published/england-afc.js.map +1 -0
  86. package/dist/published/hcas-zones.d.ts +18 -0
  87. package/dist/published/hcas-zones.js +46 -0
  88. package/dist/published/hcas-zones.js.map +1 -0
  89. package/dist/published/wales-living-wage.d.ts +36 -0
  90. package/dist/published/wales-living-wage.js +30 -0
  91. package/dist/published/wales-living-wage.js.map +1 -0
  92. package/dist/regions.d.ts +25 -14
  93. package/dist/regions.js +61 -71
  94. package/dist/regions.js.map +1 -1
  95. package/dist/resolver.d.ts +46 -41
  96. package/dist/resolver.js +70 -142
  97. package/dist/resolver.js.map +1 -1
  98. package/dist/role.d.ts +3 -3
  99. package/dist/scale-point.d.ts +11 -7
  100. package/dist/scale-point.js +29 -1
  101. package/dist/scale-point.js.map +1 -1
  102. package/dist/scale-tables.d.ts +42 -60
  103. package/dist/scale-tables.js +65 -105
  104. package/dist/scale-tables.js.map +1 -1
  105. package/dist/scale-translators.d.ts +90 -0
  106. package/dist/scale-translators.js +97 -0
  107. package/dist/scale-translators.js.map +1 -0
  108. package/dist/scales.d.ts +164 -102
  109. package/dist/scales.js +242 -462
  110. package/dist/scales.js.map +1 -1
  111. package/dist/sources.d.ts +8 -12
  112. package/dist/sources.js +9 -15
  113. package/dist/sources.js.map +1 -1
  114. package/dist/take-home.js +1 -2
  115. package/dist/take-home.js.map +1 -1
  116. package/dist/values.d.ts +10 -3
  117. package/dist/values.js +11 -4
  118. package/dist/values.js.map +1 -1
  119. package/dist/working-week.d.ts +23 -8
  120. package/dist/working-week.js +55 -25
  121. package/dist/working-week.js.map +1 -1
  122. package/package.json +3 -3
  123. package/dist/bands.d.ts +0 -63
  124. package/dist/bands.js +0 -78
  125. package/dist/bands.js.map +0 -1
package/README.md CHANGED
@@ -31,7 +31,7 @@ Requires `@casomoltd/paye-calc` as a peer dependency; the range it accepts is `p
31
31
  import {AFC_CURRENT_YEAR, getAfcScales} from '@casomoltd/nhs-pay';
32
32
 
33
33
  // A scale belongs to a pay year and a nation; neither has a default.
34
- const {bands} = getAfcScales(AFC_CURRENT_YEAR, 'england');
34
+ const bands = getAfcScales(AFC_CURRENT_YEAR, 'england');
35
35
  const band5 = bands.find((b) => b.band === '5')!;
36
36
  console.log(band5.salary.min); // entry salary
37
37
  console.log(band5.salary.max); // top of band
@@ -52,7 +52,7 @@ import {
52
52
  import {taxYear} from '@casomoltd/paye-calc';
53
53
 
54
54
  const year = AFC_CURRENT_YEAR;
55
- const {bands} = getAfcScales(year, 'england');
55
+ const bands = getAfcScales(year, 'england');
56
56
  const band5 = bands.find((b) => b.band === '5')!;
57
57
  const salary = band5.salary.min;
58
58
  // The contribution tiers are their own dataset, fetched by year and nation.
@@ -76,15 +76,14 @@ console.log(thp.pensionDeduction); // annual pension
76
76
  import {
77
77
  AFC_CURRENT_YEAR,
78
78
  getAfcScales,
79
- calculateHcasSupplement,
79
+ grossSalary,
80
80
  } from '@casomoltd/nhs-pay';
81
81
 
82
- const {bands, hcas} = getAfcScales(AFC_CURRENT_YEAR, 'england');
82
+ // HCAS is England's: grossSalary reads England's zones for the year, and
83
+ // pays a region outside them its base.
84
+ const bands = getAfcScales(AFC_CURRENT_YEAR, 'england');
83
85
  const base = bands[0].salary.min;
84
- const supplement = calculateHcasSupplement(
85
- base, hcas.innerLondon,
86
- );
87
- console.log(base + supplement); // London-adjusted
86
+ console.log(grossSalary(base, 'eng-il', AFC_CURRENT_YEAR)); // London-adjusted
88
87
  ```
89
88
 
90
89
  ### Format salary for display
@@ -107,16 +106,18 @@ const grades = getMedicalScales('2026-27', 'england');
107
106
  const consultant = grades.find((g) => g.grade === 'consultant')!;
108
107
  const top = consultant.points.at(-1)!;
109
108
 
110
- const post = medicalResolver.fromPoint(
111
- 'consultant', top, 'england', '2026-27',
112
- );
109
+ const post = medicalResolver.fromPoint({
110
+ grade: 'consultant', point: top, nation: 'england',
111
+ payYear: '2026-27', // the pay year whose scale `top` came from
112
+ taxYear: '2026-27', // the tax year whose deductions apply
113
+ });
113
114
  console.log(post.salary); // basic pay
114
115
  console.log(post.pensionRate); // member contribution %
115
116
  console.log(post.takeHome.net); // annual net after tax + NI + pension
116
117
  console.log(consultant.source.reference); // the circular it came from
117
118
  ```
118
119
 
119
- `fromPoint` takes the point itself. There is also `fromScalePoint(grade, label, …)` for a caller holding only a label, but a label does not identify a point on every scale — England's consultant scale is 20 payroll steps over 5 threshold labels, so `'Threshold 4'` names six of them and that call throws `AmbiguousScalePoint` rather than picking one.
120
+ `fromPoint` takes the point itself. There is also `fromScalePoint({grade, pointLabel, …})` for a caller holding only a label, but a label does not identify a point on every scale — England's consultant scale is 20 payroll steps over 5 threshold labels, so `'Threshold 4'` names six of them and that call throws `AmbiguousScalePoint` rather than picking one.
120
121
 
121
122
  `getDentalScales` / `dentalResolver` mirror this for salaried dental grades. Both fail loud (`ScaleUnavailable`) for an unpublished nation/year or grade rather than defaulting.
122
123
 
@@ -254,12 +255,14 @@ Without a statement figure, `kind: 'estimation'` accrues from a `joinDate` inste
254
255
 
255
256
  ### AfC pay scales
256
257
 
257
- | Year | Nations | Source |
258
- | ------- | -------------------- | ------ |
259
- | 2025-26 | England, NI, Wales | [NHS Employers pay scales 2025/26][scales-2526] |
260
- | 2026-27 | England, NI | [NHS Employers pay scales 2026/27][scales-2627] |
258
+ **Which data gets a circular file:** where the publisher issues a circular, it is transcribed verbatim in `src/circulars/`; where it publishes a web table, the table is transcribed in `src/published/`, cited and pinned with fixtures. Scotland, Wales and Northern Ireland publish AfC circulars (see [Scotland](#scotland), [Wales](#wales) and [`docs/source-archive.md`](docs/source-archive.md)). England does not: its scales are an NHS Employers web page and a poster, transcribed from the page, as the table below lists. There is no pseudo-circular file for England, which would assert a document that does not exist.
259
+
260
+ | Year | Nation | Source |
261
+ | ------- | ------- | ------ |
262
+ | 2025-26 | England | [NHS Employers pay scales 2025/26][scales-2526] |
263
+ | 2026-27 | England | [NHS Employers pay scales 2026/27][scales-2627] |
261
264
 
262
- Cross-checked against [NHSPRB 39th Report (2026)][nhsprb-39], Table A25 (AfC 2025/26 data for England, NI, Wales).
265
+ Cross-checked for England against [NHSPRB 39th Report (2026)][nhsprb-39], Table A25 (AfC 2025/26 data for England, NI, Wales).
263
266
 
264
267
  [scales-2526]: https://www.nhsemployers.org/articles/pay-scales-202526
265
268
  [scales-2627]: https://www.nhsemployers.org/articles/pay-scales-202627
@@ -297,7 +300,7 @@ That promise is exact for a statement handed over **with its date**. Passing the
297
300
 
298
301
  ### Scotland
299
302
 
300
- Scotland negotiates its own AfC award independently and has completely different base salaries from England. Separate scale tables are stored for each tax year — `getAfcScales(year, 'scotland')` returns Scotland figures directly. Scotland also has structural differences: Band 2 has 2 points (vs 1 in England) and Bands 8a–9 have 2 points each (vs 3).
303
+ Scotland negotiates its own AfC award independently and has completely different base salaries from England. Separate scale tables are stored for each pay year — `getAfcScales(year, 'scotland')` returns Scotland figures directly. Scotland also has structural differences: Bands 8a–9 have 2 points each (vs 3 in England).
301
304
 
302
305
  Source: [PCS(AFC)2026/1][scot-circular] — Scottish Health Workforce Directorate circular (23 Jan 2026). Annex B holds both years' rate tables; Annex C sets them out increment by increment and corroborates Annex B point for point.
303
306
 
@@ -309,7 +312,7 @@ Scotland's 2025-26 settlement was 4.25%, but carried an inflation guarantee —
309
312
 
310
313
  Wales runs its own pay ladder and both years are transcribed from it: [AfC(W) 02/2025][wales-2025] (29 May 2025) and [AfC(W) 02/2026][wales-2026] (12 Feb 2026), Annex 1 of each.
311
314
 
312
- Wales is **not** England's table with a floor applied. The two ladders differ at every band from 4 upward, where no floor reaches: Band 9 tops out at £131,732 in Wales against £129,783 in England. A floor lifts the bottom of a ladder and cannot raise its top. Wales also carries two Band 2 points where England has one.
315
+ Wales is **not** England's table with a floor applied. The two ladders differ at every band from 4 upward, where no floor reaches: Band 9 tops out at £131,732 in Wales against £129,783 in England. A floor lifts the bottom of a ladder and cannot raise its top. Wales carries two Band 2 points, as England does; Northern Ireland's has one.
313
316
 
314
317
  Point labels come from each circular's own "years until eligible for pay progression" column, so they are stated by the Welsh source rather than borrowed from England's table, and they do not always agree with England's for the same band.
315
318
 
@@ -329,11 +332,10 @@ Both Welsh years were transcribed during an outage of the NHS Wales web estate (
329
332
  | ---------------------- | ------ |
330
333
  | Pension contribution rates 2025/26 | [NHSBSA contribution rates][pension-2526] |
331
334
  | Income tax / NI rates | gov.uk (via paye-calc) |
332
- | National Living Wage | [gov.uk NLW rates][nlw] |
333
- | HCAS PCT zones | NHS Employers Annex 8 Table 12 |
335
+ | National Living Wage | paye-calc (`nationalLivingWageHourly`) |
336
+ | HCAS PCT zones | NHS Employers Annex 8, Tables 12 to 14 |
334
337
 
335
338
  [pension-2526]: https://www.nhsbsa.nhs.uk/nhs-pensions-contribution-rates-202526
336
- [nlw]: https://www.gov.uk/national-minimum-wage-rates
337
339
 
338
340
  ## Medical & dental pay scales
339
341
 
@@ -4,10 +4,10 @@
4
4
  *
5
5
  * Its own module because a band id is more primitive than the scale
6
6
  * data: `scales.ts` holds the canonical tables and `afc-scales.ts`
7
- * translates the circulars into them, and both need to name a band. If
8
- * the registry lived with either, the other would import it and the
9
- * two would form a cycle that fails at module load, when the
10
- * translation runs.
7
+ * translates the circulars and England's page into them, and both need
8
+ * to name a band. If the registry lived with either, the other would
9
+ * import it and the two would form a cycle that fails at module load,
10
+ * when the translation runs.
11
11
  *
12
12
  * **Band 1 is absent, deliberately.** Every AfC circular still prints
13
13
  * it. It is closed to new entrants in England, Wales and Northern
package/dist/afc-band.js CHANGED
@@ -4,10 +4,10 @@
4
4
  *
5
5
  * Its own module because a band id is more primitive than the scale
6
6
  * data: `scales.ts` holds the canonical tables and `afc-scales.ts`
7
- * translates the circulars into them, and both need to name a band. If
8
- * the registry lived with either, the other would import it and the
9
- * two would form a cycle that fails at module load, when the
10
- * translation runs.
7
+ * translates the circulars and England's page into them, and both need
8
+ * to name a band. If the registry lived with either, the other would
9
+ * import it and the two would form a cycle that fails at module load,
10
+ * when the translation runs.
11
11
  *
12
12
  * **Band 1 is absent, deliberately.** Every AfC circular still prints
13
13
  * it. It is closed to new entrants in England, Wales and Northern
@@ -1,19 +1,14 @@
1
1
  /**
2
- * Translation layer: AfC circulars → canonical scale points.
2
+ * Translation layer: AfC tables as printed → canonical scale points.
3
3
  *
4
4
  * The counterpart to `medical-scales.ts` for Agenda for Change. The
5
- * verbatim transcriptions in `src/circulars/*` hold each publisher's
6
- * own table shape; this module maps them to the uniform
7
- * `Record<AfcBandId, SteppedPoint[]>` the rest of the library speaks.
8
- *
9
- * **England is a deliberate exception and stays in `scales.ts`.** It
10
- * publishes no AfC circular — its scales are an NHS Employers web page
11
- * plus a poster — so there is nothing to transcribe. The rule this
12
- * layer follows is: *where the publisher issues a circular, transcribe
13
- * it verbatim; where it publishes a web table, cite it and pin it with
14
- * fixtures.* Inventing a pseudo-circular file for England to make the
15
- * four shapes match would assert a document that does not exist, which
16
- * is worse than the asymmetry.
5
+ * verbatim transcriptions hold each publisher's own table shape: the
6
+ * devolved nations' circulars in `src/circulars/*`, and England's NHS
7
+ * Employers page in `published/england-afc.ts`, since England publishes
8
+ * no AfC circular (the README's AfC pay scales rule). This module maps
9
+ * them to the uniform `Record<AfcBandId, SteppedPoint[]>` the rest of the
10
+ * library speaks, and reads each one's Band 1 beside it. `scales.ts`
11
+ * pairs each result with its source.
17
12
  *
18
13
  * ── Point labels are DERIVED here, not authored ──
19
14
  *
@@ -30,69 +25,93 @@
30
25
  * nothing to catch it; computed from the transcribed interval, a
31
26
  * mis-read interval produces a wrong label that a fixture row fails on.
32
27
  */
33
- import type { Nation, PayYear } from '@casomoltd/paye-calc';
34
- import type { DocumentSource } from './document-source.js';
35
28
  import type { AfcBandId } from './afc-band.js';
36
29
  import type { SteppedPoint } from './scale-point.js';
37
- /** Band 1 as a nation publishes it, for the one nation still paying it
38
- * to new entrants. */
39
- export interface AfcBand1 {
40
- readonly year: PayYear;
30
+ /** Band 1 as a publisher prints it, before `scales.ts` attaches the year
31
+ * and source it is held under. */
32
+ export interface PrintedBand1 {
41
33
  readonly salary: number;
42
- /** What the circular says about the band's status, verbatim, where it
43
- * says anything — "closed to new entrants" for the three nations
44
- * that print it. Absent for Scotland, whose PCS(AFC)2026/1 carries no
45
- * closure statement and gives Band 1 a full Annex C pay journey, so
46
- * it is a band people are still hired onto. Carried with the figure
47
- * so a consumer stops typing the closure list by hand. */
34
+ /** The publisher's words for the band's status where it gives any:
35
+ * "closed to new entrants" in England, Wales and Northern Ireland,
36
+ * each of which footnotes it so. Absent for Scotland, whose
37
+ * PCS(AFC)2026/1 carries no closure statement and gives Band 1 a full
38
+ * Annex C pay journey, so it is a band people are still hired onto. */
48
39
  readonly note?: string;
49
- readonly source: DocumentSource;
50
40
  }
51
- /** A band's nation, attached from the key it is stored under rather
52
- * than stored beside it — one fact, one producer. */
53
- export interface AfcBand1Published extends AfcBand1 {
54
- readonly nation: Nation;
41
+ /** One nation-year's tables, translated: its ladder, and its Band 1. */
42
+ export interface AfcTables {
43
+ readonly scales: Record<AfcBandId, SteppedPoint[]>;
44
+ readonly band1: PrintedBand1;
55
45
  }
56
46
  /**
57
- * Band 1 for a nation and pay year, or `undefined` where that nation
58
- * publishes none we hold.
59
- *
60
- * Deliberately NOT part of `AFC_BANDS` or the scale list. Band 1 joining
61
- * either shifts every index that reads the list by position, and this
62
- * needs to shift nothing — it is a lookup beside the ladder, not a rung
63
- * added to it.
47
+ * England's tables, read from the NHS Employers pay-scales pages,
48
+ * "NHS Employers — AfC pay scales 2025/26" (#sa-25) and "… 2026/27"
49
+ * (#sa-26), transcribed in `published/england-afc.ts`.
64
50
  */
65
- export declare function afcBand1(year: PayYear, nation: Nation): AfcBand1Published | undefined;
51
+ export declare const ENGLAND_TABLES_2025_26: AfcTables;
52
+ export declare const ENGLAND_TABLES_2026_27: AfcTables;
66
53
  /**
67
- * An Agenda for Change point from the year of service it is first
68
- * reached in: the label every nation's scale prints, and the same year
69
- * as a number, so a reader that needs the timing never has to parse it
70
- * back out of the label. The one producer of both, for all four nations.
54
+ * Wales's own tables, read from Annex 1 of "Wales, AfC(W) 02/2025"
55
+ * (#sa-44) and "Wales, AfC(W) 02/2026" (#sa-45). They differ from
56
+ * England's at every band from 4 upward, so England's figures plus a
57
+ * living-wage floor reproduce neither year: the floor lifts the bottom of
58
+ * a ladder and cannot raise its top. Band 2 carries two points, as
59
+ * England's does.
71
60
  */
72
- export declare function afcPoint(year: number, isTop: boolean, salary: number): SteppedPoint;
73
- export declare const WALES_SCALES_2025_26: Record<AfcBandId, SteppedPoint[]>;
74
- export declare const WALES_SCALES_2026_27: Record<AfcBandId, SteppedPoint[]>;
75
- export declare const NI_SCALES_2025_26: Record<AfcBandId, SteppedPoint[]>;
61
+ export declare const WALES_TABLES_2025_26: AfcTables;
62
+ export declare const WALES_TABLES_2026_27: AfcTables;
76
63
  /**
77
- * Scotland 2026-27, from Annex C.
64
+ * Northern Ireland's tables, from HSC (AfC) 06/2025 (3 December 2025,
65
+ * effective 1 April 2025). One year only: the circular's header says why
66
+ * NI has no 2026-27 round.
78
67
  *
79
- * Annex C rather than Annex B because only Annex C carries the year of
80
- * service. Annex B gives the same salaries against a bare point
81
- * number, which cannot produce a label — `scotlandAnnexB` below exists
82
- * so a fixture can check the two annexes agree.
68
+ * The figures are England's for every band, because NI's circular prints
69
+ * the same numbers. They are read from NI's circular, not England's table,
70
+ * so they coincide as a fact about the two documents and NI can diverge
71
+ * without a code change. Its Basic Pay block prints Bands 1 and 2 as
72
+ * single flat figures and starts its entry/interval/top table at Band 3,
73
+ * so Band 2 is ONE point where England's is two.
74
+ *
75
+ * All 29 values are pinned against the circular in
76
+ * `tests/fixtures/pay-scales.csv`.
83
77
  */
84
- export declare const SCOTLAND_SCALES_2026_27: Record<AfcBandId, SteppedPoint[]>;
78
+ export declare const NI_TABLES_2025_26: AfcTables;
85
79
  /**
86
- * Annex B's salaries for a year, keyed by band, in printed order.
80
+ * Scotland's Annex B by year: the salaries against bare point numbers.
81
+ * It gives each year's Band 1, and 2025-26's salaries; only Annex C
82
+ * carries the year of service a label needs.
83
+ */
84
+ declare const SCOTLAND_ANNEX_B: {
85
+ readonly "2025-26": {
86
+ band: string;
87
+ point: number;
88
+ salary: number;
89
+ hourly: number;
90
+ }[];
91
+ readonly "2026-27": {
92
+ band: string;
93
+ point: number;
94
+ salary: number;
95
+ hourly: number;
96
+ }[];
97
+ };
98
+ /**
99
+ * Scotland 2026-27, from Annex C: 3.75% on the revised 2025-26 base, so
100
+ * the inflation guarantee reaches this year too. Source: "Scotland,
101
+ * PCS(AFC)2026/1" (#sa-13), effective 1 April 2026.
87
102
  *
88
- * Exposed so a test can assert that the annex a label came from and
89
- * the annex the salaries were published in agree. Two annexes of one
90
- * circular disagreeing would mean a transcription error in one of
91
- * them, and nothing else would notice.
103
+ * Annex C rather than Annex B because only Annex C carries the year of
104
+ * service. Annex B gives the same salaries against a bare point number,
105
+ * which cannot produce a label — `scotlandAnnexB` exists so a fixture
106
+ * can check the two annexes agree.
92
107
  */
93
- export declare function scotlandAnnexB(year: '2025-26' | '2026-27'): Map<AfcBandId, number[]>;
108
+ export declare const SCOTLAND_TABLES_2026_27: AfcTables;
94
109
  /**
95
- * Scotland 2025-26.
110
+ * Scotland 2025-26. Scotland negotiates its own award: the 2025-26
111
+ * settlement was 4.25% with an inflation guarantee of at least one point
112
+ * above the calendar year's average CPI. 2025 CPI confirmed at 3.4%, so
113
+ * the rate became 4.4%, backdated to 1 April 2025. Source: "Scotland,
114
+ * PCS(AFC)2026/1" (#sa-13), Annex B, the revised 4.4% column.
96
115
  *
97
116
  * Built from the 2026-27 journey's SHAPE with Annex B's 2025-26
98
117
  * salaries: the circular prints an identical increment structure for
@@ -102,4 +121,14 @@ export declare function scotlandAnnexB(year: '2025-26' | '2026-27'): Map<AfcBand
102
121
  * publishes twice is faithful; re-typing the same increments would
103
122
  * only add a second place to mistype them.
104
123
  */
105
- export declare const SCOTLAND_SCALES_2025_26: Record<AfcBandId, SteppedPoint[]>;
124
+ export declare const SCOTLAND_TABLES_2025_26: AfcTables;
125
+ /**
126
+ * Annex B's salaries for a year, keyed by band, in printed order.
127
+ *
128
+ * Exposed so a test can assert that the annex a label came from and
129
+ * the annex the salaries were published in agree. Two annexes of one
130
+ * circular disagreeing would mean a transcription error in one of
131
+ * them, and nothing else would notice.
132
+ */
133
+ export declare function scotlandAnnexB(year: keyof typeof SCOTLAND_ANNEX_B): Map<AfcBandId, number[]>;
134
+ export {};