"/home/yossef/notes/git/projects/maplibra/risks/Debug Layers and Node Overlays.md"

path: maplibra/risks/Debug Layers and Node Overlays.md

- **fileName**: Debug Layers and Node Overlays
- **Created on**: 2026-06-16 00:48:42

Debug Layers and Node Overlays

Migrated from: obs_vault

Parent: ../modules/Layer Management.md

This note covers developer-only overlays for walkable nodes, entrances, stairs, elevators, and other debugging aids.

Main Source Files

• src/layers/debug-node-layers-part1.js
• src/layers/debug-node-layers-part2.js
• src/layers/debug/**
• src/layers/base/debug.js

What It Does

• Part 1 registers wall, stair, elevator, and annotation node overlays.
• Part 2 registers walkable-area, walkable-node, nonwalkable-node, kind, entrance, and location-marker overlays.
• base/debug turns selected geometry into clickable point markers and popup content.

Why It Matters

• These overlays are what you inspect when a routing or geometry bug looks impossible.

Risks

• Debug popups use HTML content, so the data path needs to stay trusted.
• Developer overlays can make startup heavier if they are created too early.

See Also

• ../modules/Layer Management.md

• ./Layer Visibility Risks.md

• ./Debug Routing.md

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