@rcpch/imd-map 0.2.0 → 0.2.1

package/CHANGELOG.md

@@ -14,7 +14,7 @@ This project adheres to [Semantic Versioning](https://semver.org/).
 
 - Switched local authority boundary overlay to zoom-tiered pg_tileserv tables (`public.la_tiles_z0_4`, `public.la_tiles_z5_7`, `public.la_tiles_z8_10`, `public.la_tiles_z11_14`) with tier-matched layer zoom windows.
 - Switched health boundary overlays to zoom-tiered pg_tileserv tables for NHS England regions (`public.nhser_tiles_2021_*`), ICBs (`public.icb_tiles_2023_*`), and Welsh LHBs (`public.lhb_tiles_2022_*`).
-- Corrected overlay `source-layer` usage to match pg_tileserv behavior (table name without `public.` schema prefix).
+- Corrected overlay `source-layer` usage to match deployed overlay vector tiles by using schema-qualified layer names (for example `public.la_tiles_z5_7`) and keeping `source-layer` equal to the URL table id.
 - Updated overlay visibility handling so hide/show applies across all zoom-tier boundary layers.
 
 ### Added

package/README.md

@@ -201,6 +201,17 @@ Tile URL resolution precedence:
 
 The library source contains **no hardcoded tile URLs**.
 
+### Overlay boundary tile contract
+
+Boundary overlays (local authority, NHSER, ICB, LHB) are requested from schema-qualified table ids and rendered with the same schema-qualified `source-layer` name. Example:
+
+- URL table id: `public.la_tiles_z5_7`
+- `source-layer`: `public.la_tiles_z5_7`
+
+If you self-host boundary tiles, ensure each overlay PBF exposes the exact same layer name string as the table id used in the URL path.
+
+Bring your own overlay configuration (custom overlay table/layer names via library options) could be enabled in a future release. If you need this, please open a GitHub issue so contributors can prioritise and scope it.
+
 ---
 
 ## Nation and era rules

package/dist/index.esm.js

@@ -882,6 +882,14 @@ function normalizeLeadCentreInput(data) {
     properties: { label }
   };
 }
+
+// src/overlays/mvtLayerName.ts
+var DEFAULT_TILES_SCHEMA = "public";
+function buildMvtLayerName(baseName, tier, schema = DEFAULT_TILES_SCHEMA) {
+  return `${schema}.${baseName}_${tier}`;
+}
+
+// src/overlays/localAuthority.ts
 var LOCAL_AUTHORITY_SOURCE_ID = "rcpch-imd-la-overlay";
 var LOCAL_AUTHORITY_LAYER_ID = "rcpch-imd-la-overlay-line";
 var LOCAL_AUTHORITY_TABLE_PREFIX = "la_tiles";
@@ -895,8 +903,8 @@ function addOrUpdateLocalAuthorityOverlay(map, tilesBaseUrl, style) {
   for (const { tier, minzoom, maxzoom } of ZOOM_TIERS) {
     const sourceId = localAuthoritySourceId(tier);
     const layerId = localAuthorityLayerId(tier);
-    const fullTableName = `public.${LOCAL_AUTHORITY_TABLE_PREFIX}_${tier}`;
-    const sourceLayer = `${LOCAL_AUTHORITY_TABLE_PREFIX}_${tier}`;
+    const fullTableName = buildMvtLayerName(LOCAL_AUTHORITY_TABLE_PREFIX, tier);
+    const sourceLayer = fullTableName;
     const tileUrl = buildTileUrl(tilesBaseUrl, fullTableName);
     const existing = map.getSource(sourceId);
     if (existing instanceof VectorTileSource) {
@@ -968,8 +976,8 @@ function addOrUpdateBoundaryOverlay(map, tilesBaseUrl, input) {
   for (const { tier, minzoom, maxzoom } of ZOOM_TIERS) {
     const sourceId = overlaySourceId(input.sourceId, tier);
     const layerId = overlayLayerId(input.layerId, tier);
-    const fullTableName = `public.${input.tablePrefix}_${tier}`;
-    const sourceLayer = `${input.tablePrefix}_${tier}`;
+    const fullTableName = buildMvtLayerName(input.tablePrefix, tier);
+    const sourceLayer = fullTableName;
     const tileUrl = buildTileUrl(tilesBaseUrl, fullTableName);
     const existing = map.getSource(sourceId);
     if (existing instanceof VectorTileSource) {