"/home/yossef/notes/git/projects/maplibra/modules/Layer Management.md"

path: maplibra/modules/Layer Management.md

- **fileName**: Layer Management
- **Created on**: 2026-06-16 00:48:42

Layer Management

Purpose: Aggregates layer mixins that render indoor geometry, labels, doors, and debug overlays.

Related: ../Home.md, ../Architecture.md, ./Map Rendering.md, ./UI Components.md, ./MVF Loading.md

What It Does

LayerManager (src/layer-manager.js) is the central hub for all map layers. It composes behavior from focused mixins rather than growing into a monolithic class. It handles base layers, debug overlays, theme switching, and visibility toggles.

Layer Mixins

Base Layers (src/layers/base-layers.js)

• addBuildingShell(floors) — Extruded building footprint
• renderFloorData() — Floor-specific geometry, style layers, door features, labels
• addAnnotationNodes() — Entrance annotation markers
• addPreparedLabels() — Precomputed label features from geo-prep worker

Debug Layers (lazy-loaded)

Debug layers are loaded on-demand via dynamic imports to keep the main bundle small:

• addWallNodes() — Wall point visualization
• addStairsNodes() — Staircase connection points
• addElevatorNodes() — Elevator connection points
• addAnnotationNodes() — Entrance markers
• addWalkableNodes() — Walkable grid points
• addWalkableAreas() — Walkable polygon overlays
• addNonwalkableNodes() — Non-walkable points
• addKindsNodes() — Semantic kind points
• addEntranceAestheticNodes() — Entrance aesthetic points
• addLocationMarkers() — POI location markers

Visibility Manager (src/layers/visibility-manager.js)

• updateFloorVisibility(floorId) — Hides layers not on the current floor
• setIndoorVisibility(visible) — Master indoor layer toggle
• Zoom threshold enforcement (MIN_ZOOM_INDOOR)
• Annotation marker DOM visibility (separate from Mapbox layers)

Theme Switching

setTheme() and reapplyThemeColors() update layer colors without recreating sources or layers:

• Background color
• Building shell extrusion color
• Label text and halo colors
• Dynamic style layers (fill-extrusion colors with selected/hover states)

Important Files

• src/layer-manager.js — Main class composing all mixins
• src/layers/base-layers.js — Building shell, floor rendering
• src/layers/visibility-manager.js — Floor filtering, zoom rules
• src/layers/debug-node-layers-part1.js — Wall, stairs, elevator, annotation layers
• src/layers/debug-node-layers-part2.js — Walkable, nonwalkable, kinds, entrance, location layers
• src/layers/debug/*.js — Individual debug layer mixins
• src/legend-toggle-manager.js — Legend panel toggle state and persistence

How It Connects

• LayerManager is created by bootstrapMap() and used by FloorDataManager to render floors

• UIManager tells LayerManager when to update visibility via updateFloorVisibility()

• PathfindingController uses PathRenderer (not LayerManager) for route lines

• Theme changes flow from ThemeController → script.js → LayerManager

• Debug layers are loaded lazily when the developer legend is opened or ?debug=1 is set

  continue:[[]]
  before:[[]]