@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/dist/post.js CHANGED
@@ -15,31 +15,11 @@ import { getPensionTiersVO } from './pension.js';
15
15
  import { nhsTakeHome } from './take-home.js';
16
16
  import { awardsFor } from './award.js';
17
17
  import { afcScaleSource } from './scales.js';
18
- import { ScaleUnavailable } from './errors.js';
19
- import { getMedicalScales } from './medical-scales.js';
20
- import { getDentalScales } from './dental-scales.js';
21
- /** A grade's source from a published family table, failing loud where
22
- * the table exists but the grade is not in it — the same contract the
23
- * AfC branch gets from `afcScaleSource`. */
24
- function gradeSource(metas, grade, identity) {
25
- const meta = metas.find((m) => m.grade === grade);
26
- if (!meta) {
27
- throw new ScaleUnavailable(identity.nation, identity.payYear, grade);
28
- }
29
- return meta.source;
30
- }
31
- /** The scale id a role names, or `undefined` for an off-scale post. */
32
- function scaleOf(role) {
33
- switch (role.kind) {
34
- case 'afc':
35
- return role.band;
36
- case 'medical':
37
- case 'dental':
38
- return role.grade;
39
- case 'vsm':
40
- return undefined;
41
- }
42
- }
18
+ import { MEDICAL_FAMILY } from './medical-scales.js';
19
+ import { DENTAL_FAMILY } from './dental-scales.js';
20
+ import { PER_CENT } from './values.js';
21
+ import { afcRegionToNation } from './regions.js';
22
+ import { invariant } from './errors.js';
43
23
  /** The identity adjustments: full-time, no sacrifice/loans/override, in-scheme. */
44
24
  export const NO_ADJUSTMENTS = {
45
25
  fte: 1,
@@ -48,8 +28,6 @@ export const NO_ADJUSTMENTS = {
48
28
  taxCode: null,
49
29
  pensionOptedOut: false,
50
30
  };
51
- /** `pensionRate` is per cent. */
52
- const PER_CENT = 100;
53
31
  export class Post {
54
32
  identity;
55
33
  salary;
@@ -62,31 +40,25 @@ export class Post {
62
40
  this.adjustments = adjustments;
63
41
  }
64
42
  /**
65
- * Build a Post from a gross salary — whatever the member
66
- * is actually paid, already adjusted for HCAS / floors
67
- * by the resolver. `salary` is the fundamental input;
68
- * everything else is derived.
69
- *
70
- * A bare salary is a `vsm` role (an off-scale post); a
71
- * scale-point resolver passes the scale identity instead.
72
- * Personal circumstances are added afterwards with
43
+ * Build a Post from a gross salary — whatever the member is actually
44
+ * paid, already adjusted for HCAS by the resolver — and the scale
45
+ * position it came from. `salary` is the fundamental input; everything
46
+ * else is derived. Personal circumstances are added afterwards with
73
47
  * {@link Post.withAdjustments}.
74
- */
75
- static fromSalary(salary, nation,
76
- /** The year whose SCALE this salary was published on. */
77
- year,
78
- /**
79
- * The year whose tax, NI and pension tiers apply.
80
48
  *
81
- * REQUIRED, and ahead of `role` for that reason: a default to the
82
- * pay year would give a caller who did not think about it the
83
- * salary's own year, pricing a Northern Irish reader's 2025-26 pay
84
- * at 2025-26 deductions in the 2026-27 tax year. A default that is
85
- * right most of the time is worse than none, because the times it
86
- * is wrong are exactly the times nobody is looking.
49
+ * `role` is required: it decides which award and source the Post
50
+ * reports, so leaving it out must not quietly make a post off-scale.
51
+ * {@link Post.offScale} is the named way to build one.
87
52
  */
88
- taxYear, role = { kind: 'vsm' }) {
89
- return new Post({ nation, taxYear, payYear: year }, salary, role);
53
+ static fromSalary(salary, identity, role) {
54
+ const roleNation = nationOf(role);
55
+ invariant(roleNation === undefined || roleNation === identity.nation, `Post.fromSalary: a ${roleNation} role for a post in ${identity.nation}`);
56
+ return new Post(identity, salary, role);
57
+ }
58
+ /** An off-scale Post (a `vsm` role): a bare salary with no published
59
+ * scale, award or source. */
60
+ static offScale(salary, identity) {
61
+ return new Post(identity, salary, { kind: 'vsm' });
90
62
  }
91
63
  /**
92
64
  * Pensionable pay: the pay the NHS pension contribution rate/tier
@@ -103,8 +75,12 @@ export class Post {
103
75
  * cost of being in the Scheme" — see docs/source-archive.md.
104
76
  */
105
77
  get pensionablePay() {
106
- const fteSalary = Math.round(this.salary * this.adjustments.fte);
107
- return Math.max(0, fteSalary - this.adjustments.salarySacrifice);
78
+ return Math.max(0, this.proRataSalary - this.adjustments.salarySacrifice);
79
+ }
80
+ /** The salary for the member's hours (FTE-scaled), before any salary
81
+ * sacrifice. */
82
+ get proRataSalary() {
83
+ return Math.round(this.salary * this.adjustments.fte);
108
84
  }
109
85
  /**
110
86
  * The award covering this post, or `undefined` where its nation has
@@ -156,9 +132,9 @@ export class Post {
156
132
  case 'afc':
157
133
  return afcScaleSource(this.payYear, this.identity.nation);
158
134
  case 'medical':
159
- return gradeSource(getMedicalScales(this.payYear, this.identity.nation), role.grade, { nation: this.identity.nation, payYear: this.payYear });
135
+ return MEDICAL_FAMILY.sourceFor(role.grade, this.payYear, this.identity.nation);
160
136
  case 'dental':
161
- return gradeSource(getDentalScales(this.payYear, this.identity.nation), role.grade, { nation: this.identity.nation, payYear: this.payYear });
137
+ return DENTAL_FAMILY.sourceFor(role.grade, this.payYear, this.identity.nation);
162
138
  // Listed rather than defaulted: an off-scale post genuinely has
163
139
  // no publishing circular, and spelling it out means a new role
164
140
  // kind fails the build here instead of silently citing nothing.
@@ -225,4 +201,29 @@ export class Post {
225
201
  });
226
202
  }
227
203
  }
204
+ /** The scale id a role names, or `undefined` for an off-scale post. */
205
+ function scaleOf(role) {
206
+ switch (role.kind) {
207
+ case 'afc':
208
+ return role.band;
209
+ case 'medical':
210
+ case 'dental':
211
+ return role.grade;
212
+ case 'vsm':
213
+ return undefined;
214
+ }
215
+ }
216
+ /** The nation a role is priced in, or `undefined` for an off-scale post,
217
+ * which carries none of its own. */
218
+ function nationOf(role) {
219
+ switch (role.kind) {
220
+ case 'afc':
221
+ return afcRegionToNation(role.region);
222
+ case 'medical':
223
+ case 'dental':
224
+ return role.nation;
225
+ case 'vsm':
226
+ return undefined;
227
+ }
228
+ }
228
229
  //# sourceMappingURL=post.js.map
package/dist/post.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"post.js","sourceRoot":"","sources":["../src/post.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"post.js","sourceRoot":"","sources":["../src/post.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,72 @@
1
+ /**
2
+ * England's Agenda for Change pay scales, as NHS Employers publishes them.
3
+ *
4
+ * England issues no AfC pay circular, only an NHS Employers web page and a
5
+ * poster, so the tables are transcribed here from the page, cited and
6
+ * pinned to `tests/fixtures/pay-scales.csv`, as the README's AfC pay scales
7
+ * rule for a web table says.
8
+ *
9
+ * Sources, by the names they carry in docs/source-archive.md, which holds
10
+ * every publisher URL and archived copy:
11
+ * - "NHS Employers — AfC pay scales 2025/26" (#sa-25)
12
+ * - "NHS Employers — AfC pay scales 2026/27" (#sa-26; its hourly table has printing
13
+ * errors; these tables read the ANNUAL column, so they cannot reach us —
14
+ * see the manifest)
15
+ * - "NHS Employers, 2026 AfC pay scales poster" (#sa-16) — the same award rendered a
16
+ * second time by the same publisher, which confirms the annual column is
17
+ * untouched by those errors
18
+ * - "Health Careers — AfC pay rates" (#sa-27)
19
+ *
20
+ * Transcribed as the page prints each band: Band 1 as one figure, and
21
+ * every other band as an entry point, the "Years until" interval and a
22
+ * top point, Bands 5 to 9 with an intermediate step between. The point
23
+ * labels are derived from those intervals in `afc-scales.ts`, as every
24
+ * nation's are, so a mis-read interval shows as a wrong label that the
25
+ * fixture fails on.
26
+ */
27
+ /** England's AfC ladder from 1 April 2025, as printed in SA-25. */
28
+ export declare const ENGLAND_AFC_2025_26: {
29
+ readonly flatBands: {
30
+ band: string;
31
+ salary: number;
32
+ note: string;
33
+ }[];
34
+ readonly steppedBands: ({
35
+ band: string;
36
+ entry: number;
37
+ yearsToNext: number;
38
+ top: number;
39
+ intermediate?: undefined;
40
+ yearsToTop?: undefined;
41
+ } | {
42
+ band: string;
43
+ entry: number;
44
+ yearsToNext: number;
45
+ intermediate: number;
46
+ yearsToTop: number;
47
+ top: number;
48
+ })[];
49
+ };
50
+ /** England's AfC ladder from 1 April 2026, as printed in SA-26. */
51
+ export declare const ENGLAND_AFC_2026_27: {
52
+ readonly flatBands: {
53
+ band: string;
54
+ salary: number;
55
+ note: string;
56
+ }[];
57
+ readonly steppedBands: ({
58
+ band: string;
59
+ entry: number;
60
+ yearsToNext: number;
61
+ top: number;
62
+ intermediate?: undefined;
63
+ yearsToTop?: undefined;
64
+ } | {
65
+ band: string;
66
+ entry: number;
67
+ yearsToNext: number;
68
+ intermediate: number;
69
+ yearsToTop: number;
70
+ top: number;
71
+ })[];
72
+ };
@@ -0,0 +1,86 @@
1
+ /**
2
+ * England's Agenda for Change pay scales, as NHS Employers publishes them.
3
+ *
4
+ * England issues no AfC pay circular, only an NHS Employers web page and a
5
+ * poster, so the tables are transcribed here from the page, cited and
6
+ * pinned to `tests/fixtures/pay-scales.csv`, as the README's AfC pay scales
7
+ * rule for a web table says.
8
+ *
9
+ * Sources, by the names they carry in docs/source-archive.md, which holds
10
+ * every publisher URL and archived copy:
11
+ * - "NHS Employers — AfC pay scales 2025/26" (#sa-25)
12
+ * - "NHS Employers — AfC pay scales 2026/27" (#sa-26; its hourly table has printing
13
+ * errors; these tables read the ANNUAL column, so they cannot reach us —
14
+ * see the manifest)
15
+ * - "NHS Employers, 2026 AfC pay scales poster" (#sa-16) — the same award rendered a
16
+ * second time by the same publisher, which confirms the annual column is
17
+ * untouched by those errors
18
+ * - "Health Careers — AfC pay rates" (#sa-27)
19
+ *
20
+ * Transcribed as the page prints each band: Band 1 as one figure, and
21
+ * every other band as an entry point, the "Years until" interval and a
22
+ * top point, Bands 5 to 9 with an intermediate step between. The point
23
+ * labels are derived from those intervals in `afc-scales.ts`, as every
24
+ * nation's are, so a mis-read interval shows as a wrong label that the
25
+ * fixture fails on.
26
+ */
27
+ /** England's AfC ladder from 1 April 2025, as printed in SA-25. */
28
+ export const ENGLAND_AFC_2025_26 = {
29
+ flatBands: [
30
+ { band: 'Band 1', salary: 24465, note: 'closed to new entrants' },
31
+ ],
32
+ // Band 2's entry and top are the same figure: the wage floor has
33
+ // compressed the band, and the page still prints it as a progression,
34
+ // so it is transcribed as printed rather than collapsed to one point.
35
+ // Wales's Band 2 is the same shape.
36
+ steppedBands: [
37
+ { band: 'Band 2', entry: 24465, yearsToNext: 2, top: 24465 },
38
+ { band: 'Band 3', entry: 24937, yearsToNext: 2, top: 26598 },
39
+ { band: 'Band 4', entry: 27485, yearsToNext: 3, top: 30162 },
40
+ { band: 'Band 5', entry: 31049, yearsToNext: 2, intermediate: 33487,
41
+ yearsToTop: 2, top: 37796 },
42
+ { band: 'Band 6', entry: 38682, yearsToNext: 2, intermediate: 40823,
43
+ yearsToTop: 3, top: 46580 },
44
+ { band: 'Band 7', entry: 47810, yearsToNext: 2, intermediate: 50273,
45
+ yearsToTop: 3, top: 54710 },
46
+ { band: 'Band 8a', entry: 55690, yearsToNext: 2, intermediate: 58487,
47
+ yearsToTop: 3, top: 62682 },
48
+ { band: 'Band 8b', entry: 64455, yearsToNext: 2, intermediate: 68631,
49
+ yearsToTop: 3, top: 74896 },
50
+ { band: 'Band 8c', entry: 76965, yearsToNext: 2, intermediate: 81652,
51
+ yearsToTop: 3, top: 88682 },
52
+ { band: 'Band 8d', entry: 91342, yearsToNext: 2, intermediate: 96941,
53
+ yearsToTop: 3, top: 105337 },
54
+ { band: 'Band 9', entry: 109179, yearsToNext: 2, intermediate: 115763,
55
+ yearsToTop: 3, top: 125637 },
56
+ ],
57
+ };
58
+ /** England's AfC ladder from 1 April 2026, as printed in SA-26. */
59
+ export const ENGLAND_AFC_2026_27 = {
60
+ flatBands: [
61
+ { band: 'Band 1', salary: 25272, note: 'closed to new entrants' },
62
+ ],
63
+ // Band 2: the same compressed, printed-as-a-progression shape as 2025-26.
64
+ steppedBands: [
65
+ { band: 'Band 2', entry: 25272, yearsToNext: 2, top: 25272 },
66
+ { band: 'Band 3', entry: 25760, yearsToNext: 2, top: 27476 },
67
+ { band: 'Band 4', entry: 28392, yearsToNext: 3, top: 31157 },
68
+ { band: 'Band 5', entry: 32073, yearsToNext: 2, intermediate: 34592,
69
+ yearsToTop: 2, top: 39043 },
70
+ { band: 'Band 6', entry: 39959, yearsToNext: 2, intermediate: 42170,
71
+ yearsToTop: 3, top: 48117 },
72
+ { band: 'Band 7', entry: 49387, yearsToNext: 2, intermediate: 51932,
73
+ yearsToTop: 3, top: 56515 },
74
+ { band: 'Band 8a', entry: 57528, yearsToNext: 2, intermediate: 60417,
75
+ yearsToTop: 3, top: 64750 },
76
+ { band: 'Band 8b', entry: 66582, yearsToNext: 2, intermediate: 70896,
77
+ yearsToTop: 3, top: 77368 },
78
+ { band: 'Band 8c', entry: 79504, yearsToNext: 2, intermediate: 84346,
79
+ yearsToTop: 3, top: 91609 },
80
+ { band: 'Band 8d', entry: 94356, yearsToNext: 2, intermediate: 100140,
81
+ yearsToTop: 3, top: 108814 },
82
+ { band: 'Band 9', entry: 112782, yearsToNext: 2, intermediate: 119583,
83
+ yearsToTop: 3, top: 129783 },
84
+ ],
85
+ };
86
+ //# sourceMappingURL=england-afc.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"england-afc.js","sourceRoot":"","sources":["../../src/published/england-afc.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,18 @@
1
+ /**
2
+ * The high cost area supplement's zones and their rates, per pay year, as
3
+ * the NHS Terms and Conditions of Service Handbook prints them. HCAS is
4
+ * England's: only its three London regions resolve a zone.
5
+ *
6
+ * The percentages hold from year to year; the cash floor and ceiling do
7
+ * not. NHS Employers uprates them with each pay award and prints one table
8
+ * per year, so a shared table would pay the current year's ceiling on last
9
+ * year's salary, which is why each year has its own.
10
+ *
11
+ * Source: "NHS Terms and Conditions of Service Handbook, amendment 62"
12
+ * (#sa-41, 1 June 2026), Annex 9 "High cost area supplements", Table 1
13
+ * (from 1 April 2026) and Table 2 (from 1 April 2025).
14
+ */
15
+ import type { YearLabel } from '@casomoltd/paye-calc';
16
+ import type { HcasZones } from '../hcas-zone.js';
17
+ /** England's zones by the pay year whose award uprated them. */
18
+ export declare const HCAS_ZONES: Partial<Record<YearLabel, HcasZones>>;
@@ -0,0 +1,46 @@
1
+ /**
2
+ * The high cost area supplement's zones and their rates, per pay year, as
3
+ * the NHS Terms and Conditions of Service Handbook prints them. HCAS is
4
+ * England's: only its three London regions resolve a zone.
5
+ *
6
+ * The percentages hold from year to year; the cash floor and ceiling do
7
+ * not. NHS Employers uprates them with each pay award and prints one table
8
+ * per year, so a shared table would pay the current year's ceiling on last
9
+ * year's salary, which is why each year has its own.
10
+ *
11
+ * Source: "NHS Terms and Conditions of Service Handbook, amendment 62"
12
+ * (#sa-41, 1 June 2026), Annex 9 "High cost area supplements", Table 1
13
+ * (from 1 April 2026) and Table 2 (from 1 April 2025).
14
+ */
15
+ import { YEAR_LABELS } from '@casomoltd/paye-calc';
16
+ import { HCAS_ZONE_IDS } from '../hcas-zone.js';
17
+ /** The zones from 1 April 2025. */
18
+ const HCAS_2025_26 = {
19
+ [HCAS_ZONE_IDS.INNER_LONDON]: {
20
+ rate: 20, min: 5609, max: 8466,
21
+ },
22
+ [HCAS_ZONE_IDS.OUTER_LONDON]: {
23
+ rate: 15, min: 4714, max: 5941,
24
+ },
25
+ [HCAS_ZONE_IDS.FRINGE]: {
26
+ rate: 5, min: 1303, max: 2198,
27
+ },
28
+ };
29
+ /** The zones from 1 April 2026. */
30
+ const HCAS_2026_27 = {
31
+ [HCAS_ZONE_IDS.INNER_LONDON]: {
32
+ rate: 20, min: 5794, max: 8746,
33
+ },
34
+ [HCAS_ZONE_IDS.OUTER_LONDON]: {
35
+ rate: 15, min: 4870, max: 6137,
36
+ },
37
+ [HCAS_ZONE_IDS.FRINGE]: {
38
+ rate: 5, min: 1346, max: 2270,
39
+ },
40
+ };
41
+ /** England's zones by the pay year whose award uprated them. */
42
+ export const HCAS_ZONES = {
43
+ [YEAR_LABELS.Y2025_26]: HCAS_2025_26,
44
+ [YEAR_LABELS.Y2026_27]: HCAS_2026_27,
45
+ };
46
+ //# sourceMappingURL=hcas-zones.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"hcas-zones.js","sourceRoot":"","sources":["../../src/published/hcas-zones.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAGH,OAAO,EAAC,WAAW,EAAC,MAAM,sBAAsB,CAAC;AACjD,OAAO,EAAC,aAAa,EAAC,MAAM,iBAAiB,CAAC;AAG9C,mCAAmC;AACnC,MAAM,YAAY,GAAc;IAC9B,CAAC,aAAa,CAAC,YAAY,CAAC,EAAE;QAC5B,IAAI,EAAE,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE,IAAI;KAC/B;IACD,CAAC,aAAa,CAAC,YAAY,CAAC,EAAE;QAC5B,IAAI,EAAE,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE,IAAI;KAC/B;IACD,CAAC,aAAa,CAAC,MAAM,CAAC,EAAE;QACtB,IAAI,EAAE,CAAC,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE,IAAI;KAC9B;CACF,CAAC;AAEF,mCAAmC;AACnC,MAAM,YAAY,GAAc;IAC9B,CAAC,aAAa,CAAC,YAAY,CAAC,EAAE;QAC5B,IAAI,EAAE,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE,IAAI;KAC/B;IACD,CAAC,aAAa,CAAC,YAAY,CAAC,EAAE;QAC5B,IAAI,EAAE,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE,IAAI;KAC/B;IACD,CAAC,aAAa,CAAC,MAAM,CAAC,EAAE;QACtB,IAAI,EAAE,CAAC,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE,IAAI;KAC9B;CACF,CAAC;AAEF,gEAAgE;AAChE,MAAM,CAAC,MAAM,UAAU,GAA0C;IAC/D,CAAC,WAAW,CAAC,QAAQ,CAAC,EAAE,YAAY;IACpC,CAAC,WAAW,CAAC,QAAQ,CAAC,EAAE,YAAY;CACrC,CAAC"}
@@ -0,0 +1,36 @@
1
+ /**
2
+ * The Welsh living-wage floor.
3
+ *
4
+ * The Welsh Government applies a Living Wage Foundation floor as an advance
5
+ * uplift. Low spine points below it (Band 2, Band 3 entry) are lifted to
6
+ * it.
7
+ *
8
+ * Source: AfC(W) 01/2026 pay letter (#sa-14), 6 Jan 2026 — the hourly in
9
+ * its Action paragraph, the annual in its own spine-point table.
10
+ *
11
+ * Both figures below are published by that letter, and neither derives from
12
+ * the other: it states the annual floor as a set value, not as hourly ×
13
+ * hours. Read the one you mean — `hourly` to name a rate, `annual` to apply
14
+ * the floor.
15
+ *
16
+ * They do reconcile on the publisher's own week-year: £26,300 ÷ (37.5 ×
17
+ * 365/7) = £13.4502, the printed £13.45. That agreement is a useful check
18
+ * on the divisor and NOT a licence to derive one figure from the other,
19
+ * because only the publisher's rounding makes it land.
20
+ *
21
+ * One record, not two maps: they are a single published pair, and separate
22
+ * maps let a year land in one and not the other, or pair a revised floor
23
+ * with a stale rate.
24
+ */
25
+ import type { YearLabel } from '@casomoltd/paye-calc';
26
+ /** The Welsh living-wage floor for a year, as its pay
27
+ * letter states it. */
28
+ export interface WalesLivingWage {
29
+ /** The floor applied to low spine points. */
30
+ readonly annual: number;
31
+ /** The Living Wage Foundation rate the floor is set
32
+ * against — quotable, never a divisor. */
33
+ readonly hourly: number;
34
+ }
35
+ /** The floor by the year its pay letter sets it for. */
36
+ export declare const WALES_LIVING_WAGE: Partial<Record<YearLabel, WalesLivingWage>>;
@@ -0,0 +1,30 @@
1
+ /**
2
+ * The Welsh living-wage floor.
3
+ *
4
+ * The Welsh Government applies a Living Wage Foundation floor as an advance
5
+ * uplift. Low spine points below it (Band 2, Band 3 entry) are lifted to
6
+ * it.
7
+ *
8
+ * Source: AfC(W) 01/2026 pay letter (#sa-14), 6 Jan 2026 — the hourly in
9
+ * its Action paragraph, the annual in its own spine-point table.
10
+ *
11
+ * Both figures below are published by that letter, and neither derives from
12
+ * the other: it states the annual floor as a set value, not as hourly ×
13
+ * hours. Read the one you mean — `hourly` to name a rate, `annual` to apply
14
+ * the floor.
15
+ *
16
+ * They do reconcile on the publisher's own week-year: £26,300 ÷ (37.5 ×
17
+ * 365/7) = £13.4502, the printed £13.45. That agreement is a useful check
18
+ * on the divisor and NOT a licence to derive one figure from the other,
19
+ * because only the publisher's rounding makes it land.
20
+ *
21
+ * One record, not two maps: they are a single published pair, and separate
22
+ * maps let a year land in one and not the other, or pair a revised floor
23
+ * with a stale rate.
24
+ */
25
+ import { YEAR_LABELS } from '@casomoltd/paye-calc';
26
+ /** The floor by the year its pay letter sets it for. */
27
+ export const WALES_LIVING_WAGE = {
28
+ [YEAR_LABELS.Y2026_27]: { annual: 26300, hourly: 13.45 },
29
+ };
30
+ //# sourceMappingURL=wales-living-wage.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"wales-living-wage.js","sourceRoot":"","sources":["../../src/published/wales-living-wage.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAGH,OAAO,EAAC,WAAW,EAAC,MAAM,sBAAsB,CAAC;AAYjD,wDAAwD;AACxD,MAAM,CAAC,MAAM,iBAAiB,GAE1B;IACF,CAAC,WAAW,CAAC,QAAQ,CAAC,EAAE,EAAC,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAC;CACvD,CAAC"}
package/dist/regions.d.ts CHANGED
@@ -1,16 +1,17 @@
1
1
  /**
2
- * AFC region codes — collapse nation + HCAS into
3
- * a single query parameter.
2
+ * AFC region codes: one value that collapses a nation and,
3
+ * in England, an HCAS zone.
4
4
  *
5
5
  * HCAS is England-only and mutually exclusive with
6
- * non-England nations, so one param covers both.
6
+ * non-England nations, so one code covers both. This
7
+ * module owns the mapping both ways: a region's nation and
8
+ * zone, and the region for a nation and zone.
7
9
  *
8
10
  * UI-specific concerns (cookies, URL params, selector
9
11
  * options, zone labels) stay in the consumer.
10
12
  */
11
13
  import type { TaxRegion, Nation } from '@casomoltd/paye-calc';
12
- import type { HcasZones } from './scales.js';
13
- import type { HcasZoneId } from './hcas.js';
14
+ import type { HcasZoneId } from './hcas-zone.js';
14
15
  export declare const AFC_REGIONS: {
15
16
  readonly ENG: "eng";
16
17
  readonly ENG_IL: "eng-il";
@@ -21,22 +22,32 @@ export declare const AFC_REGIONS: {
21
22
  readonly NI: "ni";
22
23
  };
23
24
  export type AfcRegionId = (typeof AFC_REGIONS)[keyof typeof AFC_REGIONS];
24
- /** Type guard for region codes. */
25
- export declare function isAfcRegionId(raw: string): raw is AfcRegionId;
26
25
  export interface ResolvedRegion {
27
26
  id: AfcRegionId;
28
27
  taxRegion: TaxRegion;
29
- /** Key into AfcScaleYear.hcas, if applicable */
30
- hcasProp: keyof HcasZones | null;
31
- isWales: boolean;
28
+ /** The region's HCAS zone, if it has one: England's London regions only. */
29
+ zone: HcasZoneId | null;
32
30
  }
33
- /** Resolve a region code to tax/HCAS/label info. */
31
+ /** Each HCAS zone's region code. Total over the zones by its type, so a
32
+ * zone with no region fails to compile; a region's own zone is read back
33
+ * from it ({@link afcRegionToHcasZone}), so the pairing is stated once. */
34
+ export declare const ZONE_TO_REGION: Readonly<Record<HcasZoneId, AfcRegionId>>;
35
+ /** Type guard for region codes. */
36
+ export declare function isAfcRegionId(raw: string): raw is AfcRegionId;
37
+ /** Resolve a region code to its tax region and HCAS zone. */
34
38
  export declare function resolveRegion(id: AfcRegionId): ResolvedRegion;
35
39
  /** Map an AfC region code to a paye-calc Nation. */
36
40
  export declare function afcRegionToNation(id: AfcRegionId): Nation;
37
- export declare const ZONE_TO_REGION: Record<HcasZoneId, AfcRegionId>;
38
41
  /** Map an AfC region code to its HCAS zone,
39
42
  * or null for non-HCAS regions. */
40
43
  export declare function afcRegionToHcasZone(id: AfcRegionId): HcasZoneId | null;
41
- /** Type guard for paye-calc Nation strings. */
42
- export declare function isNation(raw: string | null | undefined): raw is Nation;
44
+ /** A nation's base AfC region: the one with no HCAS supplement, so its
45
+ * scale is the one the nation publishes. */
46
+ export declare function baseAfcRegion(nation: Nation): AfcRegionId;
47
+ /**
48
+ * The AfC region for a nation and, in England, an HCAS zone. Throws for a
49
+ * zone outside England: HCAS is England's only, so Wales with a fringe
50
+ * zone is a state the caller should not hold, not one to quietly read as
51
+ * England's fringe.
52
+ */
53
+ export declare function afcRegionOf(nation: Nation, zone: HcasZoneId | null): AfcRegionId;