Create or repair SVG diagrams without overlapping text/shapes. Use when shipping new SVGs, editing WLILO-styled diagrams, or when collision checks report overlaps/clipping.
Whether collisions are real (text-on-rect label patterns are often intentional)
Procedure
Run collision detection.
Inspect reported collisions by severity.
Fix only true problems (especially text-over-text).
Re-run strict mode before shipping.
Validation
Run:
node tools/dev/svg-collisions.js <file> --strict
Anti-Patterns to Avoid
Ignoring Strict Mode: Shipping an SVG that passes default validation but fails strict mode without explicit confirmation that the overlaps are intentional.
Manual Nudging Sandbox: Spending hours manually guessing <g transform="translate(...)"> values instead of generating a clean layout via templates or collision scripts.
Escalation / Research request
Ask for dedicated research if:
strict mode repeatedly reports false positives tied to viewBox scaling
you need a new reusable theme/layout template under data/svg-templates/ or tools/dev/svg-templates/
