Troubleshooting

The map is gray

Verify that data keys use the official zero-padded code for the rendered level. Missing values intentionally use fillDefault.

A regional map remains in its loading state during SSR

Effects do not run during server rendering. Import the regional JSON explicitly and pass it through topology.

A translated label does not appear in callbacks

This is intentional. featureLabel changes accessible and tooltip presentation text; callbacks preserve the canonical BCN name. Use the feature code to resolve the active locale in application UI.

A development warning mentions unknown codes

The map ignores those entries, but finite values still participate in the shared scale domain. Filter data before calling scaleFromData if the legend should represent only the rendered topology.

TypeScript rejects a region value

Use a zero-padded RegionCode, such as "05", not 5 or "5".