---

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 (--strict vs normal)
• Whether collisions are real (text-on-rect label patterns are often intentional)

Procedure

1. Run collision detection.
2. Inspect reported collisions by severity.
3. Fix only true problems (especially text-over-text).
4. 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/ or tools/dev/svg-templates/

References

• Tool doc: tools/dev/README.md (svg-collisions section)
• SVG methodology: docs/guides/SVG_CREATION_METHODOLOGY.md