[anth-volk]

Fixes #1446

Stacked on #1436 (which is stacked on #1433). Like the rest of the UK clean-up, it waits to merge until after the UK Budget on 28 October.

What changes

Local-area breakdowns (breakdown=local_areas) come from .py with disclosure control, and an area whose estimate fails the disclosure rules is absent from the result. Until now the v2 and v3 hex maps drew only the areas in the result, so a withheld area left a gap.

For a level from a breakdown, the v3 "Local areas" hex map and the four v2 hex charts (absolute and relative change, by constituency and by local authority) now draw every area of the report's region:

• all 650 constituencies and 361 local authorities for a UK-wide report;
• the nation's areas for a nation's report.

An area the result leaves out:

• is drawn in its place, hatched with grey stripes on the map's background and edged in grey, where a valued hexagon's edge is the background colour, so no colour on the scale resembles it;
• reads "name: Not reported" in its tooltip;
• has no value, so it takes no part in the colour range, isn't in v3's rankings or area finder, and can't be selected.

The note under the maps now reads "N of M constituencies are not reported" (or local authorities), and the geographic maps' tooltip for a withheld boundary reads "Not reported", so the map, its tooltips and the note use the same term. The note is one component (UKAreaDisclosureNotes), shown under v3's maps (with or without areas) and under each of the four v2 charts.

Unchanged

• A saved level (results from before .py 6.10.0, which aren't disclosure-controlled) draws only its own areas.
• A result in which any area has no code, or a code outside the region's layout (such as a pre-2023 local authority), can't be matched to the layout, so its hex map draws only its own areas, as before.

Geographic map

UKAreaChoroplethMap already drew every boundary: a withheld one was solid gray[300] with "Not published" in its tooltip. It now reads "Not reported". v3 also used that text on a saved level whenever the other level came from a breakdown. It now uses it only on the breakdown's level, as the hex map does, and a saved level's boundary without a result reads "No data". The fill is unchanged. gray[300] sits between two stops on the scale's grey side, so a later change could hatch it as the hex map now does.

How

• HexagonalMap takes missingAreas (areas it places without a value) and missingAreaText. It hatches them with an SVG pattern sized to the hexagons, with stripes never closer than 4 SVG units (pixels at full width) so they don't blend into a flat grey, gives them a grey edge, and fits its frame to them as well as to the valued areas.
• withheldUKHexAreas(level, points, region) in ukHexLayout.ts lists the region's layout codes that the result lacks, each at its layout position. It returns none when the result can't be matched, or when the region is neither the UK nor a nation.
• The withheld areas are named from two new files beside the layouts, constituency_names_2024.json and local_authority_names_2023.json, built from the boundary files' PCON24NM and LAD23NM. ukBoundaryFiles.test.ts checks them against the boundary files. They add about 34 KB, before compression, to the bundle that already holds the layouts.

Commits

Each commit was done red-green: its tests were written first and seen failing for the expected reason, then the code was written and committed with them.

1. Say "not reported" for UK areas disclosure control withholds: the note and the geographic tooltips, with new note and tooltip tests for the three v2 charts that had none.
2. Draw areas without a value on the hex map, hatched (HexagonalMap).
3. List the areas of a report's region that a UK result leaves out (withheldUKHexAreas and the name files).
4. Draw UK areas disclosure control withheld on the hex maps, in v3 and the four v2 charts. The v2 constituency and local authority tab tests now expect 649 and 360 withheld hexagons beside the computed area.
5. Read "Not reported" only on a breakdown level's v3 geographic map.
6. Keep a withheld hexagon's hatching distinct on the dense UK map (review fix): on the UK-wide constituency map the stripes were 2.3 pixels apart and blended into a grey on the scale's grey side.
7. Say in the hex map's docs that a withheld hexagon has a grey edge.
8. Merge chore/remove-uk-area-xy, which drops Remove the app's handling of x and y on UK area results #1436's note on areas the layout can't place. The conflicts were imports in the v2 chart tests, and v3's test of an uncoded breakdown area no longer checks that note. The "not reported" note stays.

Testing

• Focused vitest runs on Node 26 for the changed and related suites, plus make format, make lint and make typecheck.
• Two review-code rounds: the first found the blended stripes (fixed red-green in commit 6), and the second found no bugs.
• Not checked in a browser: how the hatching and edge look at UK-wide and nation scale, while zoomed, and in a downloaded image. On a v2 chart narrower than 600 pixels, its fixed 600-unit drawing area puts the stripes under 4 pixels apart; the grey edge still marks the hexagon.

🤖 Generated with Claude Code

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated
policyengine-calculator-next	Ready	Preview	Oct 27, 2026 4:22pm UTC
policyengine-website	Ready	Preview	Oct 27, 2026 4:22pm UTC

[anth-volk]

Superseded by #1448, which is based on main instead of #1436. It carries this PR's commits cherry-picked with -x, adapted to a base where areas still carry x and y (withheld areas are drawn only when every area of the result is in the layout), together with #1433's v2 layout placement.