Wrap long feeder names at substation extremities (Issue 1)

[marota]

Summary

Extends the feeder-label wrapping system to handle all long equipment names at substation extremities — not just relabelled branches, but also generators, loads, and unmatched branches whose far-end VL is unnamed. This prevents the label pile-up that survived Issue 1's branch-only relabelling on dense VLs.

Key Changes

• Enhanced wrapFeederLabel() to break long single words on separators

  • Added breakLongWord() helper that splits identifiers like virtual_relation_8423568_a_0-225 on _, -, . boundaries within a character budget
  • Preserves every character and prefers natural separators over hard cuts
  • Allows long raw IIDM ids to wrap across multiple lines instead of running off-screen

• New applyFeederLabelWrap() function

  • Wraps every long feeder NAME label inside feeder cells (.sld-extern-cell, .sld-intern-cell, .sld-shunt-cell)
  • Skips numeric P/Q flow labels, already-relabelled feeders (which wrap themselves), and highlight clones
  • Idempotent via data-feeder-wrap / data-feeder-wrap-orig attributes
  • Restores original text on subsequent calls with no active SVG

• VL name-box interactivity

  • Extended vlInteractions.ts to resolve clicks on VL name boxes (.nad-label-box) in addition to disk clicks
  • Single-click on name box opens the SLD directly (no double-click window)
  • Single-click on disk selects the VL (existing behavior)
  • Added fallback to document.elementsFromPoint when a branch is drawn on top of a disk, so the disk remains interactive across its whole area
  • Updated metadata index to map text-node svgIds to their VL NodeMeta via textNodesBySvgId

• Integration in useSldFeederRelabel hook

  • Calls applyFeederLabelWrap() right after applyFeederRelabels()
  • Runs BEFORE injection-name buttons so they size their bounding box to the wrapped, multi-line name
  • Self-gate tracks both relabel and wrap state to detect reconciliation drops

Implementation Details

• breakLongWord() scans backward from the character budget to find a separator, ensuring pieces rejoin exactly into the original word
• wrapFeederLabel() now handles both space-separated words and long single words, applying the two-level splitting strategy
• The elementsFromPoint fallback in vlInteractions.ts only runs on discrete pointer events (mousedown/hover), never per frame, preserving the performance contract
• Text-node metadata resolution falls back to equipmentId when vlNode link is absent, maintaining compatibility with older metadata formats
• All wrapping is reversible: data-feeder-wrap-orig stores the original text for restoration on subsequent calls

Tests

• Updated wrapFeederLabel tests to verify long single-word breaking behavior
• Added comprehensive applyFeederLabelWrap test suite covering long names, short names, numeric labels, relabelled feeders, highlight clones, and restoration
• Added vlInteractions tests for paint-stack resolution and name-box click handling
• Added metadataIndex tests for text-node mapping with vlNode links and fallbacks

https://claude.ai/code/session_014aLzZJp3MP3qYBr1WKGRC6