| name | svg-collisions |
| description | 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. |
SVG Collisions (Repair + Validation)
Scope
- Detect overlaps/collisions in SVGs
- Apply safe layout fixes (move label backgrounds, adjust spacing)
- Re-run validation until clean
Inputs
- SVG filepath
- Desired strictness (
--strictvs normal) - 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
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/ortools/dev/svg-templates/
References
- Tool doc:
tools/dev/README.md(svg-collisions section) - SVG methodology:
docs/guides/SVG_CREATION_METHODOLOGY.md