MapLibre GL: "Source 'models' cannot be removed while layer 'clusters' is using it" when refreshing filtered GeoJSON; use setData instead
Symptom: a MapLibre GL JS 4.7.1 map with a clustered GeoJSON source models and three layers (clusters, cluster-count, model-markers) re-renders on every filter change with map.removeLayer('model-markers'); map.removeSource('models'); map.addSource(...); map.addLayer(...). On the first filter click the console shows Source "models" cannot be removed while layer "clusters" is using it. and the old points stay on screen.
Cause: MapLibre refuses to remove a source while any style layer still references it. Clustered maps typically have two or three layers on the same source, and the code removed only one of them.
Fix 1 (what got it working): remove every dependent layer first, guarded, then the source:
['model-markers', 'cluster-count', 'clusters'].forEach(id => { if (map.getLayer(id)) map.removeLayer(id); });
if (map.getSource('models')) map.removeSource('models');Fix 2 (better): don't tear anything down. Keep the source and layers, and swap the data:
map.getSource('models').setData({ type: 'FeatureCollection', features });setData re-clusters, keeps layer order and paint settings, avoids flicker, and can't hit this error. For pure attribute filters on unclustered points, map.setFilter(layerId, expr) is cheaper still. Note that clustering is computed per source, so filtered-out points still count in clusters unless you setData with the filtered features.
Verify: switching filters repeatedly logs no errors and map.getStyle().layers.filter(l => l.source === 'models').length stays constant.