@casomoltd/nhs-pay 0.34.0 → 0.35.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 (132) hide show
  1. package/README.md +3 -3
  2. package/dist/additional-pension.d.ts +6 -4
  3. package/dist/additional-pension.js +22 -18
  4. package/dist/additional-pension.js.map +1 -1
  5. package/dist/circulars/ni-hsc-afc-06-2025.d.ts +1 -1
  6. package/dist/circulars/ni-hsc-afc-06-2025.js +1 -1
  7. package/dist/dates.d.ts +9 -5
  8. package/dist/dates.js.map +1 -1
  9. package/dist/errors.d.ts +58 -45
  10. package/dist/errors.js +63 -52
  11. package/dist/errors.js.map +1 -1
  12. package/dist/factor-basis.d.ts +95 -106
  13. package/dist/factor-basis.js +97 -108
  14. package/dist/factor-basis.js.map +1 -1
  15. package/dist/gad/additional-pension-0-703-2026-07-08.d.ts +185 -0
  16. package/dist/gad/additional-pension-0-703-2026-07-08.js +89 -0
  17. package/dist/gad/{additional-pension-0-703-2023-10-03.js.map → additional-pension-0-703-2026-07-08.js.map} +1 -1
  18. package/dist/gad/additional-pension-0-712-2026-07-08.d.ts +34 -0
  19. package/dist/gad/additional-pension-0-712-2026-07-08.js +172 -0
  20. package/dist/gad/additional-pension-0-712-2026-07-08.js.map +1 -0
  21. package/dist/gad/additional-pension-0-713-2026-07-08.d.ts +34 -0
  22. package/dist/gad/additional-pension-0-713-2026-07-08.js +175 -0
  23. package/dist/gad/additional-pension-0-713-2026-07-08.js.map +1 -0
  24. package/dist/gad/additional-pension-0-714-2026-07-08.d.ts +34 -0
  25. package/dist/gad/additional-pension-0-714-2026-07-08.js +178 -0
  26. package/dist/gad/additional-pension-0-714-2026-07-08.js.map +1 -0
  27. package/dist/gad/additional-pension-0-715-2026-07-08.d.ts +34 -0
  28. package/dist/gad/additional-pension-0-715-2026-07-08.js +181 -0
  29. package/dist/gad/additional-pension-0-715-2026-07-08.js.map +1 -0
  30. package/dist/gad/additional-pension-0-716-2026-07-08.d.ts +34 -0
  31. package/dist/gad/additional-pension-0-716-2026-07-08.js +172 -0
  32. package/dist/gad/additional-pension-0-716-2026-07-08.js.map +1 -0
  33. package/dist/gad/additional-pension-0-717-2026-07-08.d.ts +34 -0
  34. package/dist/gad/additional-pension-0-717-2026-07-08.js +175 -0
  35. package/dist/gad/additional-pension-0-717-2026-07-08.js.map +1 -0
  36. package/dist/gad/additional-pension-0-718-2026-07-08.d.ts +34 -0
  37. package/dist/gad/additional-pension-0-718-2026-07-08.js +178 -0
  38. package/dist/gad/additional-pension-0-718-2026-07-08.js.map +1 -0
  39. package/dist/gad/additional-pension-0-719-2026-07-08.d.ts +34 -0
  40. package/dist/gad/additional-pension-0-719-2026-07-08.js +181 -0
  41. package/dist/gad/additional-pension-0-719-2026-07-08.js.map +1 -0
  42. package/dist/gad/additional-pension-table.d.ts +4 -11
  43. package/dist/gad/additional-pension-table.js.map +1 -1
  44. package/dist/gad/erf-0-420-2026-07-08.d.ts +51 -0
  45. package/dist/gad/erf-0-420-2026-07-08.js +83 -0
  46. package/dist/gad/erf-0-420-2026-07-08.js.map +1 -0
  47. package/dist/gad/erf-1-401-2026-07-08.d.ts +42 -0
  48. package/dist/gad/erf-1-401-2026-07-08.js +67 -0
  49. package/dist/gad/erf-1-401-2026-07-08.js.map +1 -0
  50. package/dist/gad/erf-1-402-2026-07-08.d.ts +43 -0
  51. package/dist/gad/erf-1-402-2026-07-08.js +78 -0
  52. package/dist/gad/erf-1-402-2026-07-08.js.map +1 -0
  53. package/dist/gad/erf-1-407-2026-07-08.d.ts +42 -0
  54. package/dist/gad/erf-1-407-2026-07-08.js +67 -0
  55. package/dist/gad/erf-1-407-2026-07-08.js.map +1 -0
  56. package/dist/gad/factor-set.d.ts +54 -0
  57. package/dist/gad/factor-set.js +83 -0
  58. package/dist/gad/factor-set.js.map +1 -0
  59. package/dist/gad/factor-table.d.ts +31 -20
  60. package/dist/gad/factor-table.js +67 -37
  61. package/dist/gad/factor-table.js.map +1 -1
  62. package/dist/gad/lrf-0-421-2026-07-08.d.ts +46 -0
  63. package/dist/gad/lrf-0-421-2026-07-08.js +72 -0
  64. package/dist/gad/lrf-0-421-2026-07-08.js.map +1 -0
  65. package/dist/gad/lrf-0-422-2026-07-08.d.ts +43 -0
  66. package/dist/gad/lrf-0-422-2026-07-08.js +69 -0
  67. package/dist/gad/{lrf-0-422-2023-06-30.js.map → lrf-0-422-2026-07-08.js.map} +1 -1
  68. package/dist/gad/lrf-2-416-2026-07-08.d.ts +41 -0
  69. package/dist/gad/lrf-2-416-2026-07-08.js +66 -0
  70. package/dist/gad/lrf-2-416-2026-07-08.js.map +1 -0
  71. package/dist/index.d.ts +5 -3
  72. package/dist/index.js +8 -6
  73. package/dist/index.js.map +1 -1
  74. package/dist/pension-projection.d.ts +30 -44
  75. package/dist/pension-projection.js +37 -61
  76. package/dist/pension-projection.js.map +1 -1
  77. package/dist/sections/section-1995.d.ts +6 -6
  78. package/dist/sections/section-1995.js +34 -27
  79. package/dist/sections/section-1995.js.map +1 -1
  80. package/dist/sections/section-2008.d.ts +4 -4
  81. package/dist/sections/section-2008.js +19 -23
  82. package/dist/sections/section-2008.js.map +1 -1
  83. package/dist/sections/section-2015.d.ts +7 -7
  84. package/dist/sections/section-2015.js +3 -7
  85. package/dist/sections/section-2015.js.map +1 -1
  86. package/package.json +1 -1
  87. package/dist/gad/additional-pension-0-703-2023-10-03.d.ts +0 -180
  88. package/dist/gad/additional-pension-0-703-2023-10-03.js +0 -87
  89. package/dist/gad/additional-pension-0-712-2023-10-03.d.ts +0 -35
  90. package/dist/gad/additional-pension-0-712-2023-10-03.js +0 -170
  91. package/dist/gad/additional-pension-0-712-2023-10-03.js.map +0 -1
  92. package/dist/gad/additional-pension-0-713-2023-10-03.d.ts +0 -35
  93. package/dist/gad/additional-pension-0-713-2023-10-03.js +0 -173
  94. package/dist/gad/additional-pension-0-713-2023-10-03.js.map +0 -1
  95. package/dist/gad/additional-pension-0-714-2023-10-03.d.ts +0 -35
  96. package/dist/gad/additional-pension-0-714-2023-10-03.js +0 -176
  97. package/dist/gad/additional-pension-0-714-2023-10-03.js.map +0 -1
  98. package/dist/gad/additional-pension-0-715-2023-10-03.d.ts +0 -35
  99. package/dist/gad/additional-pension-0-715-2023-10-03.js +0 -179
  100. package/dist/gad/additional-pension-0-715-2023-10-03.js.map +0 -1
  101. package/dist/gad/additional-pension-0-716-2023-10-03.d.ts +0 -35
  102. package/dist/gad/additional-pension-0-716-2023-10-03.js +0 -170
  103. package/dist/gad/additional-pension-0-716-2023-10-03.js.map +0 -1
  104. package/dist/gad/additional-pension-0-717-2023-10-03.d.ts +0 -35
  105. package/dist/gad/additional-pension-0-717-2023-10-03.js +0 -173
  106. package/dist/gad/additional-pension-0-717-2023-10-03.js.map +0 -1
  107. package/dist/gad/additional-pension-0-718-2023-10-03.d.ts +0 -35
  108. package/dist/gad/additional-pension-0-718-2023-10-03.js +0 -176
  109. package/dist/gad/additional-pension-0-718-2023-10-03.js.map +0 -1
  110. package/dist/gad/additional-pension-0-719-2023-10-03.d.ts +0 -35
  111. package/dist/gad/additional-pension-0-719-2023-10-03.js +0 -179
  112. package/dist/gad/additional-pension-0-719-2023-10-03.js.map +0 -1
  113. package/dist/gad/erf-1-401-2023-06-30.d.ts +0 -47
  114. package/dist/gad/erf-1-401-2023-06-30.js +0 -73
  115. package/dist/gad/erf-1-401-2023-06-30.js.map +0 -1
  116. package/dist/gad/erf-1-402-2023-06-30.d.ts +0 -48
  117. package/dist/gad/erf-1-402-2023-06-30.js +0 -84
  118. package/dist/gad/erf-1-402-2023-06-30.js.map +0 -1
  119. package/dist/gad/erf-1-407-2023-06-30.d.ts +0 -47
  120. package/dist/gad/erf-1-407-2023-06-30.js +0 -73
  121. package/dist/gad/erf-1-407-2023-06-30.js.map +0 -1
  122. package/dist/gad/erf-2023-06-30.d.ts +0 -72
  123. package/dist/gad/erf-2023-06-30.js +0 -105
  124. package/dist/gad/erf-2023-06-30.js.map +0 -1
  125. package/dist/gad/lrf-0-422-2023-06-30.d.ts +0 -45
  126. package/dist/gad/lrf-0-422-2023-06-30.js +0 -70
  127. package/dist/gad/lrf-2-416-2023-06-30.d.ts +0 -46
  128. package/dist/gad/lrf-2-416-2023-06-30.js +0 -72
  129. package/dist/gad/lrf-2-416-2023-06-30.js.map +0 -1
  130. package/dist/gad/lrf-2023-06-30.d.ts +0 -72
  131. package/dist/gad/lrf-2023-06-30.js +0 -99
  132. package/dist/gad/lrf-2023-06-30.js.map +0 -1
@@ -0,0 +1 @@
1
+ {"version":3,"file":"lrf-0-421-2026-07-08.js","sourceRoot":"","sources":["../../src/gad/lrf-0-421-2026-07-08.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAGH,OAAO,EAAC,OAAO,EAAC,MAAM,gBAAgB,CAAC;AAEvC,wDAAwD;AACxD,MAAM,CAAC,MAAM,SAAS,GAAG;IACvB,IAAI,EAAE,KAAK;IACX,KAAK,EAAE,EAAC,EAAE,EAAE,QAAQ,EAAC;IACrB,UAAU,EAAE;QACV,QAAQ,EAAE,OAAO;QACjB,KAAK,EAAE,OAAO;QACd,IAAI,EAAE,EAAE;QACR,WAAW,EAAE,MAAM;QACnB,MAAM,EAAE,OAAO,CAAC,YAAY,CAAC;QAC7B,WAAW,EAAE,OAAO,CAAC,YAAY,CAAC;QAClC,SAAS,EAAE,kEAAkE;cACzE,kDAAkD;QACtD,cAAc,EAAE,qCAAqC;cACjD,0CAA0C;KAC/C;IACD,IAAI,EAAE;QACJ,0CAA0C;QAC1C,0CAA0C;QAC1C,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK;YACvC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,EAAE,MAAM;QACnD,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK;YACvC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,EAAE,MAAM;QACnD,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK;YACvC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,EAAE,MAAM;QACnD,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK;YACvC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,EAAE,MAAM;QACnD,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK;YACvC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,EAAE,MAAM;QACnD,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK;YACvC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,EAAE,MAAM;QACnD,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK;YACvC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,EAAE,MAAM;QACnD,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK;YACvC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,EAAE,MAAM;QACnD,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK;YACvC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,EAAE,MAAM;QACnD,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK;YACvC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,EAAE,MAAM;QACnD,CAAC,KAAK,CAAC,EAAE,kBAAkB;KAC5B;CACiC,CAAC"}
@@ -0,0 +1,43 @@
1
+ /**
2
+ * Verbatim transcription — GAD "NHSPS_EW — Consolidated Factor
3
+ * Spreadsheet", table 0-422, factors issued 8 July 2026
4
+ * ("2026 factor review set"), in use from 1 December 2026.
5
+ * Sheet x-422 · PDF p.22.
6
+ *
7
+ * Table 0-422 (LRF2): 2015 scheme late retirement factors for
8
+ * additional pension and pension debits, members retiring from active
9
+ * status. Unisex; period measured as time after NPA, in the same
10
+ * layout as table 0-421 (see lrf-0-421-2026-07-08.ts, which carries the
11
+ * methodology note). Additional pension takes this table, not 0-421:
12
+ * the two agree at the pension age and 0-422 is the larger at every
13
+ * month after it.
14
+ *
15
+ * Sources: "NHSBSA, Early and Late Retirement Factors effective from 1
16
+ * December 2026" (the member-facing extract)
17
+ * and "GAD NHS_EW Consolidated Factors" (the workbook, and the source of
18
+ * record, at `sourceUrl`) — see docs/source-archive.md#gad-factors.
19
+ *
20
+ * To check it: NHSBSA's extract at `page` below, or sheet x-422 of
21
+ * the workbook at `sourceUrl` (docs/source-archive.md#gad-factors).
22
+ *
23
+ * Rows are years late (0–10), columns months (0–11), exactly as
24
+ * printed — the 10yr row prints a single 0-month value.
25
+ */
26
+ /** 2015 scheme LRF for additional pension — Table 0-422, issued 8 Jul 2026. */
27
+ export declare const LRF_0_422: {
28
+ readonly kind: "lrf";
29
+ readonly index: {
30
+ readonly by: "period";
31
+ };
32
+ readonly provenance: {
33
+ readonly tableRef: "0-422";
34
+ readonly sheet: "x-422";
35
+ readonly page: 22;
36
+ readonly guidanceRef: "LRF2";
37
+ readonly issued: import("../iso-date.js").IsoDate;
38
+ readonly implemented: import("../iso-date.js").IsoDate;
39
+ readonly sourceUrl: string;
40
+ readonly methodGuidance: string;
41
+ };
42
+ readonly rows: readonly [readonly [1, 1.005, 1.009, 1.014, 1.019, 1.023, 1.028, 1.033, 1.037, 1.042, 1.047, 1.052], readonly [1.056, 1.061, 1.066, 1.071, 1.076, 1.081, 1.086, 1.091, 1.096, 1.101, 1.106, 1.111], readonly [1.116, 1.122, 1.127, 1.133, 1.139, 1.144, 1.15, 1.155, 1.161, 1.166, 1.172, 1.177], readonly [1.183, 1.189, 1.195, 1.201, 1.207, 1.213, 1.22, 1.226, 1.232, 1.238, 1.244, 1.25], readonly [1.256, 1.263, 1.27, 1.276, 1.283, 1.29, 1.296, 1.303, 1.31, 1.317, 1.323, 1.33], readonly [1.337, 1.344, 1.352, 1.359, 1.366, 1.374, 1.381, 1.389, 1.396, 1.404, 1.411, 1.418], readonly [1.426, 1.434, 1.442, 1.45, 1.458, 1.467, 1.475, 1.483, 1.491, 1.499, 1.507, 1.516], readonly [1.524, 1.532, 1.54, 1.549, 1.557, 1.565, 1.574, 1.582, 1.59, 1.599, 1.607, 1.615], readonly [1.623, 1.632, 1.641, 1.65, 1.659, 1.668, 1.677, 1.686, 1.695, 1.704, 1.713, 1.722], readonly [1.73, 1.74, 1.75, 1.759, 1.769, 1.778, 1.788, 1.797, 1.807, 1.817, 1.826, 1.836], readonly [1.845]];
43
+ };
@@ -0,0 +1,69 @@
1
+ /**
2
+ * Verbatim transcription — GAD "NHSPS_EW — Consolidated Factor
3
+ * Spreadsheet", table 0-422, factors issued 8 July 2026
4
+ * ("2026 factor review set"), in use from 1 December 2026.
5
+ * Sheet x-422 · PDF p.22.
6
+ *
7
+ * Table 0-422 (LRF2): 2015 scheme late retirement factors for
8
+ * additional pension and pension debits, members retiring from active
9
+ * status. Unisex; period measured as time after NPA, in the same
10
+ * layout as table 0-421 (see lrf-0-421-2026-07-08.ts, which carries the
11
+ * methodology note). Additional pension takes this table, not 0-421:
12
+ * the two agree at the pension age and 0-422 is the larger at every
13
+ * month after it.
14
+ *
15
+ * Sources: "NHSBSA, Early and Late Retirement Factors effective from 1
16
+ * December 2026" (the member-facing extract)
17
+ * and "GAD NHS_EW Consolidated Factors" (the workbook, and the source of
18
+ * record, at `sourceUrl`) — see docs/source-archive.md#gad-factors.
19
+ *
20
+ * To check it: NHSBSA's extract at `page` below, or sheet x-422 of
21
+ * the workbook at `sourceUrl` (docs/source-archive.md#gad-factors).
22
+ *
23
+ * Rows are years late (0–10), columns months (0–11), exactly as
24
+ * printed — the 10yr row prints a single 0-month value.
25
+ */
26
+ import { isoDate } from '../iso-date.js';
27
+ /** 2015 scheme LRF for additional pension — Table 0-422, issued 8 Jul 2026. */
28
+ export const LRF_0_422 = {
29
+ kind: 'lrf',
30
+ index: { by: 'period' },
31
+ provenance: {
32
+ tableRef: '0-422',
33
+ sheet: 'x-422',
34
+ page: 22,
35
+ guidanceRef: 'LRF2',
36
+ issued: isoDate('2026-07-08'),
37
+ implemented: isoDate('2026-12-01'),
38
+ sourceUrl: 'https://gadfactorguidancehub.co.uk/download/consolidated_factors'
39
+ + '/NHS_EW/NHS_EW_Consolidated_Factors_2026-04.xlsx',
40
+ methodGuidance: 'GAD NHSPS 2015 E&W — Early and late'
41
+ + ' retirement in normal health, 7 Aug 2019',
42
+ },
43
+ rows: [
44
+ // 0mo 1mo 2mo 3mo 4mo 5mo
45
+ // 6mo 7mo 8mo 9mo 10mo 11mo
46
+ [1.000, 1.005, 1.009, 1.014, 1.019, 1.023,
47
+ 1.028, 1.033, 1.037, 1.042, 1.047, 1.052], // 0yr
48
+ [1.056, 1.061, 1.066, 1.071, 1.076, 1.081,
49
+ 1.086, 1.091, 1.096, 1.101, 1.106, 1.111], // 1yr
50
+ [1.116, 1.122, 1.127, 1.133, 1.139, 1.144,
51
+ 1.150, 1.155, 1.161, 1.166, 1.172, 1.177], // 2yr
52
+ [1.183, 1.189, 1.195, 1.201, 1.207, 1.213,
53
+ 1.220, 1.226, 1.232, 1.238, 1.244, 1.250], // 3yr
54
+ [1.256, 1.263, 1.270, 1.276, 1.283, 1.290,
55
+ 1.296, 1.303, 1.310, 1.317, 1.323, 1.330], // 4yr
56
+ [1.337, 1.344, 1.352, 1.359, 1.366, 1.374,
57
+ 1.381, 1.389, 1.396, 1.404, 1.411, 1.418], // 5yr
58
+ [1.426, 1.434, 1.442, 1.450, 1.458, 1.467,
59
+ 1.475, 1.483, 1.491, 1.499, 1.507, 1.516], // 6yr
60
+ [1.524, 1.532, 1.540, 1.549, 1.557, 1.565,
61
+ 1.574, 1.582, 1.590, 1.599, 1.607, 1.615], // 7yr
62
+ [1.623, 1.632, 1.641, 1.650, 1.659, 1.668,
63
+ 1.677, 1.686, 1.695, 1.704, 1.713, 1.722], // 8yr
64
+ [1.730, 1.740, 1.750, 1.759, 1.769, 1.778,
65
+ 1.788, 1.797, 1.807, 1.817, 1.826, 1.836], // 9yr
66
+ [1.845], // 10yr — 0mo only
67
+ ],
68
+ };
69
+ //# sourceMappingURL=lrf-0-422-2026-07-08.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"lrf-0-422-2023-06-30.js","sourceRoot":"","sources":["../../src/gad/lrf-0-422-2023-06-30.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAGH,OAAO,EAAC,OAAO,EAAC,MAAM,gBAAgB,CAAC;AAEvC;YACY;AACZ,MAAM,CAAC,MAAM,SAAS,GAAG;IACvB,IAAI,EAAE,KAAK;IACX,KAAK,EAAE,EAAC,EAAE,EAAE,QAAQ,EAAC;IACrB,UAAU,EAAE;QACV,QAAQ,EAAE,OAAO;QACjB,KAAK,EAAE,OAAO;QACd,IAAI,EAAE,EAAE;QACR,WAAW,EAAE,MAAM;QACnB,MAAM,EAAE,OAAO,CAAC,YAAY,CAAC;QAC7B,SAAS,EAAE,0CAA0C;cACjD,+CAA+C;cAC/C,gBAAgB;QACpB,cAAc,EAAE,qCAAqC;cACjD,0CAA0C;KAC/C;IACD,IAAI,EAAE;QACJ,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK;YACvC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,EAAE,MAAM;QACnD,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK;YACvC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,EAAE,MAAM;QACnD,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK;YACvC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,EAAE,MAAM;QACnD,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK;YACvC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,EAAE,MAAM;QACnD,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK;YACvC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,EAAE,MAAM;QACnD,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK;YACvC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,EAAE,MAAM;QACnD,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK;YACvC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,EAAE,MAAM;QACnD,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK;YACvC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,EAAE,MAAM;QACnD,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK;YACvC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,EAAE,MAAM;QACnD,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK;YACvC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,EAAE,MAAM;QACnD,CAAC,KAAK,CAAC,EAAsC,kBAAkB;KAChE;CACiC,CAAC"}
1
+ {"version":3,"file":"lrf-0-422-2026-07-08.js","sourceRoot":"","sources":["../../src/gad/lrf-0-422-2026-07-08.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAGH,OAAO,EAAC,OAAO,EAAC,MAAM,gBAAgB,CAAC;AAEvC,+EAA+E;AAC/E,MAAM,CAAC,MAAM,SAAS,GAAG;IACvB,IAAI,EAAE,KAAK;IACX,KAAK,EAAE,EAAC,EAAE,EAAE,QAAQ,EAAC;IACrB,UAAU,EAAE;QACV,QAAQ,EAAE,OAAO;QACjB,KAAK,EAAE,OAAO;QACd,IAAI,EAAE,EAAE;QACR,WAAW,EAAE,MAAM;QACnB,MAAM,EAAE,OAAO,CAAC,YAAY,CAAC;QAC7B,WAAW,EAAE,OAAO,CAAC,YAAY,CAAC;QAClC,SAAS,EAAE,kEAAkE;cACzE,kDAAkD;QACtD,cAAc,EAAE,qCAAqC;cACjD,0CAA0C;KAC/C;IACD,IAAI,EAAE;QACJ,0CAA0C;QAC1C,0CAA0C;QAC1C,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK;YACvC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,EAAE,MAAM;QACnD,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK;YACvC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,EAAE,MAAM;QACnD,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK;YACvC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,EAAE,MAAM;QACnD,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK;YACvC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,EAAE,MAAM;QACnD,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK;YACvC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,EAAE,MAAM;QACnD,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK;YACvC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,EAAE,MAAM;QACnD,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK;YACvC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,EAAE,MAAM;QACnD,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK;YACvC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,EAAE,MAAM;QACnD,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK;YACvC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,EAAE,MAAM;QACnD,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK;YACvC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,EAAE,MAAM;QACnD,CAAC,KAAK,CAAC,EAAE,kBAAkB;KAC5B;CACiC,CAAC"}
@@ -0,0 +1,41 @@
1
+ /**
2
+ * Verbatim transcription — GAD "NHSPS_EW — Consolidated Factor
3
+ * Spreadsheet", table 2-416, factors issued 8 July 2026
4
+ * ("2026 factor review set"), in use from 1 December 2026.
5
+ * Sheet x-416 · PDF p.16.
6
+ *
7
+ * Sources: "NHSBSA, Early and Late Retirement Factors effective from 1
8
+ * December 2026" (the member-facing extract)
9
+ * and "GAD NHS_EW Consolidated Factors" (the workbook, and the source of
10
+ * record, at `sourceUrl`) — see docs/source-archive.md#gad-factors.
11
+ *
12
+ * Table 2-416 (LRF1): 2008 Section late retirement factors, pension,
13
+ * relative to a pension age of 65. Unisex; keyed by AGE "in complete
14
+ * years & months", as the table's own header defines it. Read for
15
+ * the 2008 Section's pension drawn after 65.
16
+ *
17
+ * Rows are ages (65–75), columns months (0–11), exactly as
18
+ * printed; the last row prints a single 0-month value.
19
+ *
20
+ * When it was last checked against the workbook, and how, is in
21
+ * docs/source-archive.md#gad-factors.
22
+ */
23
+ /** LRF — Table 2-416, issued 8 Jul 2026. */
24
+ export declare const LRF_2_416: {
25
+ readonly kind: "lrf";
26
+ readonly index: {
27
+ readonly by: "age";
28
+ readonly firstAge: 65;
29
+ };
30
+ readonly provenance: {
31
+ readonly tableRef: "2-416";
32
+ readonly sheet: "x-416";
33
+ readonly page: 16;
34
+ readonly guidanceRef: "LRF1";
35
+ readonly issued: import("../iso-date.js").IsoDate;
36
+ readonly implemented: import("../iso-date.js").IsoDate;
37
+ readonly sourceUrl: string;
38
+ readonly methodGuidance: string;
39
+ };
40
+ readonly rows: readonly [readonly [1, 1.003, 1.006, 1.009, 1.012, 1.015, 1.018, 1.021, 1.024, 1.027, 1.03, 1.033], readonly [1.036, 1.039, 1.042, 1.045, 1.049, 1.052, 1.055, 1.058, 1.062, 1.065, 1.068, 1.071], readonly [1.075, 1.078, 1.082, 1.085, 1.089, 1.092, 1.096, 1.099, 1.103, 1.106, 1.11, 1.113], readonly [1.117, 1.121, 1.125, 1.128, 1.132, 1.136, 1.14, 1.144, 1.148, 1.152, 1.155, 1.159], readonly [1.163, 1.167, 1.172, 1.176, 1.18, 1.184, 1.188, 1.193, 1.197, 1.201, 1.205, 1.21], readonly [1.214, 1.218, 1.223, 1.228, 1.232, 1.237, 1.242, 1.246, 1.251, 1.256, 1.26, 1.265], readonly [1.269, 1.275, 1.28, 1.285, 1.29, 1.295, 1.3, 1.305, 1.31, 1.315, 1.32, 1.325], readonly [1.33, 1.336, 1.341, 1.347, 1.352, 1.358, 1.363, 1.369, 1.374, 1.38, 1.386, 1.391], readonly [1.397, 1.403, 1.409, 1.415, 1.421, 1.427, 1.433, 1.439, 1.445, 1.451, 1.457, 1.463], readonly [1.469, 1.476, 1.483, 1.489, 1.496, 1.503, 1.509, 1.516, 1.523, 1.529, 1.536, 1.543], readonly [1.549]];
41
+ };
@@ -0,0 +1,66 @@
1
+ /**
2
+ * Verbatim transcription — GAD "NHSPS_EW — Consolidated Factor
3
+ * Spreadsheet", table 2-416, factors issued 8 July 2026
4
+ * ("2026 factor review set"), in use from 1 December 2026.
5
+ * Sheet x-416 · PDF p.16.
6
+ *
7
+ * Sources: "NHSBSA, Early and Late Retirement Factors effective from 1
8
+ * December 2026" (the member-facing extract)
9
+ * and "GAD NHS_EW Consolidated Factors" (the workbook, and the source of
10
+ * record, at `sourceUrl`) — see docs/source-archive.md#gad-factors.
11
+ *
12
+ * Table 2-416 (LRF1): 2008 Section late retirement factors, pension,
13
+ * relative to a pension age of 65. Unisex; keyed by AGE "in complete
14
+ * years & months", as the table's own header defines it. Read for
15
+ * the 2008 Section's pension drawn after 65.
16
+ *
17
+ * Rows are ages (65–75), columns months (0–11), exactly as
18
+ * printed; the last row prints a single 0-month value.
19
+ *
20
+ * When it was last checked against the workbook, and how, is in
21
+ * docs/source-archive.md#gad-factors.
22
+ */
23
+ import { isoDate } from '../iso-date.js';
24
+ /** LRF — Table 2-416, issued 8 Jul 2026. */
25
+ export const LRF_2_416 = {
26
+ kind: 'lrf',
27
+ index: { by: 'age', firstAge: 65 },
28
+ provenance: {
29
+ tableRef: '2-416',
30
+ sheet: 'x-416',
31
+ page: 16,
32
+ guidanceRef: 'LRF1',
33
+ issued: isoDate('2026-07-08'),
34
+ implemented: isoDate('2026-12-01'),
35
+ sourceUrl: 'https://gadfactorguidancehub.co.uk/download/consolidated_factors'
36
+ + '/NHS_EW/NHS_EW_Consolidated_Factors_2026-04.xlsx',
37
+ methodGuidance: 'GAD NHSPS 1995/2008 E&W — Voluntary early and'
38
+ + ' late retirements in normal health, 7 Aug 2019',
39
+ },
40
+ rows: [
41
+ // 0mo 1mo 2mo 3mo 4mo 5mo
42
+ // 6mo 7mo 8mo 9mo 10mo 11mo
43
+ [1.000, 1.003, 1.006, 1.009, 1.012, 1.015,
44
+ 1.018, 1.021, 1.024, 1.027, 1.030, 1.033], // 65
45
+ [1.036, 1.039, 1.042, 1.045, 1.049, 1.052,
46
+ 1.055, 1.058, 1.062, 1.065, 1.068, 1.071], // 66
47
+ [1.075, 1.078, 1.082, 1.085, 1.089, 1.092,
48
+ 1.096, 1.099, 1.103, 1.106, 1.110, 1.113], // 67
49
+ [1.117, 1.121, 1.125, 1.128, 1.132, 1.136,
50
+ 1.140, 1.144, 1.148, 1.152, 1.155, 1.159], // 68
51
+ [1.163, 1.167, 1.172, 1.176, 1.180, 1.184,
52
+ 1.188, 1.193, 1.197, 1.201, 1.205, 1.210], // 69
53
+ [1.214, 1.218, 1.223, 1.228, 1.232, 1.237,
54
+ 1.242, 1.246, 1.251, 1.256, 1.260, 1.265], // 70
55
+ [1.269, 1.275, 1.280, 1.285, 1.290, 1.295,
56
+ 1.300, 1.305, 1.310, 1.315, 1.320, 1.325], // 71
57
+ [1.330, 1.336, 1.341, 1.347, 1.352, 1.358,
58
+ 1.363, 1.369, 1.374, 1.380, 1.386, 1.391], // 72
59
+ [1.397, 1.403, 1.409, 1.415, 1.421, 1.427,
60
+ 1.433, 1.439, 1.445, 1.451, 1.457, 1.463], // 73
61
+ [1.469, 1.476, 1.483, 1.489, 1.496, 1.503,
62
+ 1.509, 1.516, 1.523, 1.529, 1.536, 1.543], // 74
63
+ [1.549], // 75 — 0mo only
64
+ ],
65
+ };
66
+ //# sourceMappingURL=lrf-2-416-2026-07-08.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"lrf-2-416-2026-07-08.js","sourceRoot":"","sources":["../../src/gad/lrf-2-416-2026-07-08.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAGH,OAAO,EAAC,OAAO,EAAC,MAAM,gBAAgB,CAAC;AAEvC,4CAA4C;AAC5C,MAAM,CAAC,MAAM,SAAS,GAAG;IACvB,IAAI,EAAE,KAAK;IACX,KAAK,EAAE,EAAC,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAE,EAAC;IAChC,UAAU,EAAE;QACV,QAAQ,EAAE,OAAO;QACjB,KAAK,EAAE,OAAO;QACd,IAAI,EAAE,EAAE;QACR,WAAW,EAAE,MAAM;QACnB,MAAM,EAAE,OAAO,CAAC,YAAY,CAAC;QAC7B,WAAW,EAAE,OAAO,CAAC,YAAY,CAAC;QAClC,SAAS,EAAE,kEAAkE;cACzE,kDAAkD;QACtD,cAAc,EAAE,+CAA+C;cAC3D,gDAAgD;KACrD;IACD,IAAI,EAAE;QACJ,0CAA0C;QAC1C,0CAA0C;QAC1C,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK;YACvC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,EAAE,KAAK;QAClD,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK;YACvC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,EAAE,KAAK;QAClD,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK;YACvC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,EAAE,KAAK;QAClD,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK;YACvC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,EAAE,KAAK;QAClD,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK;YACvC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,EAAE,KAAK;QAClD,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK;YACvC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,EAAE,KAAK;QAClD,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK;YACvC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,EAAE,KAAK;QAClD,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK;YACvC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,EAAE,KAAK;QAClD,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK;YACvC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,EAAE,KAAK;QAClD,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK;YACvC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,EAAE,KAAK;QAClD,CAAC,KAAK,CAAC,EAAE,gBAAgB;KAC1B;CACiC,CAAC"}
package/dist/index.d.ts CHANGED
@@ -28,7 +28,7 @@ export type { DentalGradeMeta } from './dental-scales.js';
28
28
  export { ADDITIONAL_PENSION_LIMIT, ADDITIONAL_PENSION_PAYMENTS, ADDITIONAL_PENSION_UNIT, additionalPensionCost, additionalPensionToBuy, } from './additional-pension.js';
29
29
  export type { AdditionalPensionPayment, AdditionalPensionPurchase, } from './additional-pension.js';
30
30
  export { ADDITIONAL_PENSION_COVERS } from './gad/additional-pension-table.js';
31
- export type { AdditionalPensionCover, AdditionalPensionProvenance, } from './gad/additional-pension-table.js';
31
+ export type { AdditionalPensionCover, } from './gad/additional-pension-table.js';
32
32
  export { ADDITIONAL_PENSION_REFUSALS, AdditionalPensionUnavailable, AmbiguousScalePoint, AwardUnavailable, BeforeStatement, BenefitNotModelled, isBeforeStatement, NOT_MODELLED, PayPathUnavailable, PensionTiersUnavailable, RetirementFactorOutOfRange, ScaleUnavailable, STATEMENT_READS, } from './errors.js';
33
33
  export type { AdditionalPensionRefusal, NotModelled, StatementRead, } from './errors.js';
34
34
  export { DocumentSource, SOURCE_CURRENCIES } from './document-source.js';
@@ -56,10 +56,12 @@ export type { Applies2015, Factored, FactorOutcome } from './factor-basis.js';
56
56
  export { factor2015 } from './sections/section-2015.js';
57
57
  export { CASH_CHOICES } from './commutation.js';
58
58
  export type { CashChoice } from './commutation.js';
59
- export { ACCRUAL_RATE, erf2015For, factorProvenance, projectPension, retirementFactor, yearlyAccrual, } from './pension-projection.js';
59
+ export { erf2015For, factorProvenance } from './factor-basis.js';
60
+ export type { FactorProvenance, FactorTableKind, GadTableProvenance, } from './gad/factor-table.js';
61
+ export { ACCRUAL_RATE, projectPension, retirementFactor, yearlyAccrual, } from './pension-projection.js';
62
+ export type { RetirementFactor } from './pension-projection.js';
60
63
  export { COMMUTATION_FACTOR, HMRC_LUMP_SUM_CAP_PCT, LUMP_SUM_ALLOWANCE, LUMP_SUM_CAPS, nhsCommutationLimits, VALUATION_FACTOR, commute, } from './commutation.js';
61
64
  export type { CommutationLimits, CommutationResult, DatedAmount, LumpSumCap, LumpSumLimit, LumpSumLimits, } from './commutation.js';
62
- export type { FactorProvenance, FactorTableKind, GadTableProvenance, } from './gad/factor-table.js';
63
65
  export { firstJoinedOf, LEGACY_PENSION_AGES, mayDrawOn, memberMinimumPensionAge, MPA_KEPT_AGE, MPA_RISE_JOINED_AFTER, normalPensionAge, } from './pension/ages.js';
64
66
  export type { JoiningHistory } from './pension/ages.js';
65
67
  export type { PensionEstimationInput, PensionProjectionInput, PensionProjectionResult, PensionStatementInput, } from './pension-projection.js';
package/dist/index.js CHANGED
@@ -49,14 +49,16 @@ export { PAY_MEASURES } from './sections/final-salary.js';
49
49
  export { FACTOR_APPLIES, FACTOR_SOURCES } from './factor-basis.js';
50
50
  export { factor2015 } from './sections/section-2015.js';
51
51
  export { CASH_CHOICES } from './commutation.js';
52
+ // ── Retirement factors ─────────────────────────────
53
+ // Read through the factor door. Factor-table internals stay private —
54
+ // a factor VALUE is reached only through a function that owns GAD's
55
+ // rounding rules; factor PROVENANCE is data (factorProvenance), so
56
+ // consumers cite it, never hand-type it.
57
+ export { erf2015For, factorProvenance } from './factor-basis.js';
52
58
  // ── Pension Projection ─────────────────────────────
53
59
  // The 2015 Section's scenario-level API, plus yearlyAccrual (one
54
- // scheme year's accrual) and the period-keyed ERF. Date plumbing
55
- // and factor-table internals stay private — a factor VALUE is reached
56
- // only through a function that owns GAD's rounding rules; factor
57
- // PROVENANCE is data (factorProvenance), so consumers cite it, never
58
- // hand-type it.
59
- export { ACCRUAL_RATE, erf2015For, factorProvenance, projectPension, retirementFactor, yearlyAccrual, } from './pension-projection.js';
60
+ // scheme year's accrual). Date plumbing stays private.
61
+ export { ACCRUAL_RATE, projectPension, retirementFactor, yearlyAccrual, } from './pension-projection.js';
60
62
  // ── Commutation ──────────────────────────────────────
61
63
  // Its own module: a choice taken AT retirement, on a pension
62
64
  // the projection has already finished producing. Nothing in
package/dist/index.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
@@ -9,12 +9,12 @@
9
9
  *
10
10
  * GAD consolidated factor workbook
11
11
  * → ERF1/LRF1 values: src/gad/ holds the verbatim
12
- * transcriptions, and each carries its own issue, version
13
- * and provenance
12
+ * transcriptions, and each carries its own issue and
13
+ * provenance
14
14
  *
15
15
  * GAD "NHSPS 2015 E&W — Early and late retirement in normal
16
16
  * health — Factors and guidance", 7 August 2019 — methodology
17
- * only (the 2023 workbook names it as its related guidance)
17
+ * only (the workbook names it as its related guidance)
18
18
  * → Rounding rules (§2.3 ERF, §3.4 LRF)
19
19
  * → Order of operations (§1.18)
20
20
  *
@@ -155,9 +155,23 @@ import type { ProjectionMoney } from './pension/money.js';
155
155
  import type { Prices } from './pension/prices.js';
156
156
  import { ACCRUAL_RATE } from './pension/ledger.js';
157
157
  import type { EstimatedHistory } from './pension/history.js';
158
- import type { MemberLedger } from './pension/ledger.js';
158
+ import type { AppliedDrawing, MemberLedger } from './pension/ledger.js';
159
159
  import type { ProjectionPoint } from './pension/curve.js';
160
160
  import type { FactorProvenance, FactorTableKind } from './gad/factor-table.js';
161
+ /** A retirement factor and the table it came from, or 1 with no table
162
+ * for a drawing exactly at the pension age. The shape of the
163
+ * deprecated `retirementFactor` route, which callers read by these
164
+ * names; `memberBenefits` answers in `FactorOutcome`, and this type
165
+ * retires with the route. */
166
+ export type RetirementFactor = {
167
+ readonly factor: 1;
168
+ readonly type: null;
169
+ readonly provenance: null;
170
+ } | {
171
+ readonly factor: number;
172
+ readonly type: FactorTableKind;
173
+ readonly provenance: FactorProvenance;
174
+ };
161
175
  /** Input for statement path */
162
176
  export interface PensionStatementInput {
163
177
  kind: 'statement';
@@ -240,11 +254,11 @@ export interface PensionProjectionResult {
240
254
  accruedNow: ProjectionMoney;
241
255
  /** ERF or LRF factor applied */
242
256
  factor: number;
243
- /** Which factor table `factor` came from, or null where none
244
- * applied. Retiring at NPA is neither early nor late: the
245
- * factor is 1 and there is no table to name, so a consumer
246
- * rendering `factorProvenance` has nothing to render. */
247
- factorType: FactorTableKind | null;
257
+ /** The table `factor` came from and its provenance, as the
258
+ * drawing recorded it, or null where none applied. Retiring at
259
+ * NPA is neither early nor late: the factor is 1 and there is
260
+ * no table to cite. */
261
+ drawnTable: AppliedDrawing['table'];
248
262
  /** Gap between revalued and drawn pension, at retirement */
249
263
  adjustmentAmount: ProjectionMoney;
250
264
  /** One point per scheme year end, in both readings */
@@ -285,24 +299,15 @@ export interface PensionProjectionResult {
285
299
  todaysMoneyLedger: MemberLedger;
286
300
  }
287
301
  export { ACCRUAL_RATE };
288
- /**
289
- * Provenance of the 2015 Section's in-force table behind a factor
290
- * kind — the
291
- * citation facts (table ref, guidance name, issue date, source
292
- * PDF) consumers render instead of hand-typing them, so a page
293
- * showing "GAD factors issued 30 June 2023" updates itself when
294
- * a later issue supersedes the table above.
295
- */
296
- export declare function factorProvenance(kind: FactorTableKind): FactorProvenance;
297
302
  /**
298
303
  * Determine whether ERF or LRF applies and return the
299
- * factor. The rounding rules (ERF up §2.3, LRF down §3.4)
300
- * live on the tables themselves — see FactorTable.
304
+ * factor. The rounding rules (ERF up §2.3, LRF down §3.4) live on the
305
+ * tables themselves — see FactorTable.
301
306
  *
302
- * `type` is null where neither table applies. Retiring exactly
303
- * at NPA is not an early retirement with a factor of 1: naming
304
- * a table there hands a consumer an ERF citation to render at a
305
- * member who took no reduction.
307
+ * `type` and `provenance` are null where neither table applies.
308
+ * Retiring exactly at NPA is not an early retirement with a
309
+ * factor of 1: naming a table there hands a consumer an ERF
310
+ * citation to render at a member who took no reduction.
306
311
  *
307
312
  * A second route to the factor `factor2015` reads through
308
313
  * `factor-basis.ts`, kept because this public signature takes the
@@ -311,26 +316,7 @@ export declare function factorProvenance(kind: FactorTableKind): FactorProvenanc
311
316
  * (https://github.com/casomoltd/nhs-pay/issues/21), and until then
312
317
  * `tests/section-factors.test.ts` holds the two routes equal.
313
318
  */
314
- export declare function retirementFactor(retirementDate: Date, npDate: Date): {
315
- factor: number;
316
- type: FactorTableKind | null;
317
- };
318
- /**
319
- * The **2015 Section's** early retirement factor for drawing a
320
- * whole period before its pension age: {@link retirementFactor} for
321
- * a caller that holds the period rather than the two dates it
322
- * spans. The 1995 and 2008 Sections are keyed by age and are not
323
- * read here. A whole period has no part-month to round, so the
324
- * table is read at exactly that row. Months are 0 to 11; a period
325
- * past the last printed row raises
326
- * {@link RetirementFactorOutOfRange}. It stays when
327
- * `projectPension` retires: a caller holding a period is not a
328
- * projection.
329
- */
330
- export declare function erf2015For(period: {
331
- years: number;
332
- months: number;
333
- }): number;
319
+ export declare function retirementFactor(retirementDate: Date, npDate: Date): RetirementFactor;
334
320
  /** Annual pension accrual for one year of service */
335
321
  export declare function yearlyAccrual(pensionablePay: number): number;
336
322
  /**
@@ -9,12 +9,12 @@
9
9
  *
10
10
  * GAD consolidated factor workbook
11
11
  * → ERF1/LRF1 values: src/gad/ holds the verbatim
12
- * transcriptions, and each carries its own issue, version
13
- * and provenance
12
+ * transcriptions, and each carries its own issue and
13
+ * provenance
14
14
  *
15
15
  * GAD "NHSPS 2015 E&W — Early and late retirement in normal
16
16
  * health — Factors and guidance", 7 August 2019 — methodology
17
- * only (the 2023 workbook names it as its related guidance)
17
+ * only (the workbook names it as its related guidance)
18
18
  * → Rounding rules (§2.3 ERF, §3.4 LRF)
19
19
  * → Order of operations (§1.18)
20
20
  *
@@ -158,41 +158,24 @@ import { estimateHistory } from './pension/history.js';
158
158
  import { buildCurve, walkThrough } from './pension/curve.js';
159
159
  import { schemeYearBefore, schemeYearEndDate } from './pension/scheme-year.js';
160
160
  import { seedFromBalanceAt, seedFromJoinDate } from './pension/seed.js';
161
- import { FACTOR_TABLES, factorTable } from './factor-basis.js';
161
+ import { FACTOR_APPLIES, factorTable, TABLES_2015 } from './factor-basis.js';
162
162
  // ── Constants ───────────────────────────────────────
163
163
  /* The accrual rate is owned by the ledger that applies it and
164
164
  re-exported here, so the record and every figure read off it
165
165
  cannot hold two different 1/54s. */
166
166
  export { ACCRUAL_RATE };
167
- // ── Factor Tables ───────────────────────────────────
168
- // The 2015 Section's two tables, read through the one set every
169
- // factor in the library comes from, so this and `memberBenefits`
170
- // cannot round the same drawing two ways.
171
- const ERF1 = factorTable(FACTOR_TABLES.early2015);
172
- const LRF1 = factorTable(FACTOR_TABLES.late2015);
173
- /**
174
- * Provenance of the 2015 Section's in-force table behind a factor
175
- * kind — the
176
- * citation facts (table ref, guidance name, issue date, source
177
- * PDF) consumers render instead of hand-typing them, so a page
178
- * showing "GAD factors issued 30 June 2023" updates itself when
179
- * a later issue supersedes the table above.
180
- */
181
- export function factorProvenance(kind) {
182
- return kind === 'erf'
183
- ? ERF1.provenance
184
- : LRF1.provenance;
185
- }
186
167
  // ── Retirement Factor ───────────────────────────────
168
+ /** The 2015 Section main pension's tables, as its basis states them. */
169
+ const MAIN_2015 = TABLES_2015[FACTOR_APPLIES.pension];
187
170
  /**
188
171
  * Determine whether ERF or LRF applies and return the
189
- * factor. The rounding rules (ERF up §2.3, LRF down §3.4)
190
- * live on the tables themselves — see FactorTable.
172
+ * factor. The rounding rules (ERF up §2.3, LRF down §3.4) live on the
173
+ * tables themselves — see FactorTable.
191
174
  *
192
- * `type` is null where neither table applies. Retiring exactly
193
- * at NPA is not an early retirement with a factor of 1: naming
194
- * a table there hands a consumer an ERF citation to render at a
195
- * member who took no reduction.
175
+ * `type` and `provenance` are null where neither table applies.
176
+ * Retiring exactly at NPA is not an early retirement with a
177
+ * factor of 1: naming a table there hands a consumer an ERF
178
+ * citation to render at a member who took no reduction.
196
179
  *
197
180
  * A second route to the factor `factor2015` reads through
198
181
  * `factor-basis.ts`, kept because this public signature takes the
@@ -202,33 +185,24 @@ export function factorProvenance(kind) {
202
185
  * `tests/section-factors.test.ts` holds the two routes equal.
203
186
  */
204
187
  export function retirementFactor(retirementDate, npDate) {
205
- if (retirementDate >= npDate) {
206
- // Late or on-time retirement
188
+ const drawnAtOrAfterNpa = retirementDate >= npDate;
189
+ if (drawnAtOrAfterNpa) {
207
190
  const period = periodInYearsMonths(npDate, retirementDate);
208
- if (period.years === 0 && period.months === 0
209
- && period.days === 0) {
210
- return { factor: 1, type: null };
191
+ const drawnAtNpa = period.years === 0 && period.months === 0
192
+ && period.days === 0;
193
+ if (drawnAtNpa) {
194
+ return { factor: 1, type: null, provenance: null };
211
195
  }
212
- return { factor: LRF1.factorFor(period), type: 'lrf' };
196
+ const lrf = factorTable(MAIN_2015.late);
197
+ return {
198
+ factor: lrf.factorFor(period), type: 'lrf', provenance: lrf.provenance,
199
+ };
213
200
  }
214
- // Early retirement
215
201
  const period = periodInYearsMonths(retirementDate, npDate);
216
- return { factor: ERF1.factorFor(period), type: 'erf' };
217
- }
218
- /**
219
- * The **2015 Section's** early retirement factor for drawing a
220
- * whole period before its pension age: {@link retirementFactor} for
221
- * a caller that holds the period rather than the two dates it
222
- * spans. The 1995 and 2008 Sections are keyed by age and are not
223
- * read here. A whole period has no part-month to round, so the
224
- * table is read at exactly that row. Months are 0 to 11; a period
225
- * past the last printed row raises
226
- * {@link RetirementFactorOutOfRange}. It stays when
227
- * `projectPension` retires: a caller holding a period is not a
228
- * projection.
229
- */
230
- export function erf2015For(period) {
231
- return ERF1.factorFor({ ...period, days: 0 });
202
+ const erf = factorTable(MAIN_2015.early);
203
+ return {
204
+ factor: erf.factorFor(period), type: 'erf', provenance: erf.provenance,
205
+ };
232
206
  }
233
207
  // ── Core Calculations ───────────────────────────────
234
208
  /** Annual pension accrual for one year of service */
@@ -275,7 +249,7 @@ export function projectPension(input, today = new Date()) {
275
249
  annualPension: pair(cash.annualPension, todays.annualPension, cash.retirementDate),
276
250
  accruedNow: pair(cash.ledger.atDate(today), todays.ledger.atDate(today), today),
277
251
  factor: cash.factor,
278
- factorType: cash.factorType,
252
+ drawnTable: cash.drawnTable,
279
253
  adjustmentAmount: pair(cash.revaluedAtRetirement - cash.annualPension, todays.revaluedAtRetirement - todays.annualPension, cash.retirementDate),
280
254
  curve: buildCurve(cash, todays),
281
255
  isEstimation: cash.isEstimation,
@@ -289,11 +263,15 @@ export function projectPension(input, today = new Date()) {
289
263
  todaysMoneyLedger: todays.ledger,
290
264
  };
291
265
  }
266
+ // ── Internal Helpers ────────────────────────────────
292
267
  /** The flat-pay walk from `seed` to the drawing, and the factor the
293
268
  * drawing takes. */
294
269
  function walkToDrawing(input, seed, prices) {
295
270
  const { currentSalary, dateOfBirth, exitDate, retirementDate, npa } = input;
296
- const { factor, type: factorType } = retirementFactor(retirementDate, npaDate(dateOfBirth, npa));
271
+ const drawing = retirementFactor(retirementDate, npaDate(dateOfBirth, npa));
272
+ const drawnTable = drawing.type === null
273
+ ? null
274
+ : { kind: drawing.type, provenance: drawing.provenance };
297
275
  const ledger = buildLedger({
298
276
  seed,
299
277
  payIn: flatPay(currentSalary),
@@ -303,13 +281,11 @@ function walkToDrawing(input, seed, prices) {
303
281
  through: walkThrough(retirementDate, npaDate(dateOfBirth, npa)),
304
282
  drawingFor: () => ({
305
283
  on: retirementDate,
306
- factor,
307
- table: factorType === null
308
- ? null
309
- : { kind: factorType, provenance: factorProvenance(factorType) },
284
+ factor: drawing.factor,
285
+ table: drawnTable,
310
286
  }),
311
287
  });
312
- return { ledger, factor, factorType };
288
+ return { ledger, factor: drawing.factor, drawnTable };
313
289
  }
314
290
  function resolveProjection(input, today) {
315
291
  const { dateOfBirth, exitDate, retirementDate, npa, assumedCpi } = input;
@@ -333,7 +309,7 @@ function resolveProjection(input, today) {
333
309
  const seed = isEstimation
334
310
  ? seedFromJoinDate(input.joinDate)
335
311
  : seedFromBalanceAt({ balance: input.accruedPension, asOf: input.statementDate }, exitDate, retirementDate, prices);
336
- const { ledger, factor, factorType } = walkToDrawing(input, seed, prices);
312
+ const { ledger, factor, drawnTable } = walkToDrawing(input, seed, prices);
337
313
  const { revalued, drawn } = atDrawing(ledger, retirementDate, factor);
338
314
  /* Illustration only, and only where a statement leaves a gap:
339
315
  an estimation path already walks from the join date, so
@@ -350,7 +326,7 @@ function resolveProjection(input, today) {
350
326
  : null;
351
327
  return {
352
328
  today, dateOfBirth, exitDate, retirementDate, npa,
353
- ledger, history, isEstimation, factor, factorType, prices,
329
+ ledger, history, isEstimation, factor, drawnTable, prices,
354
330
  /* The earliest date the ledger holds a balance for, which
355
331
  is the seed's own year end — NOT today.
356
332