Net/value/pin labels can still overlap or duplicate in dense sections, reducing readability and teaching quality.
Goal
Make text rendering reliably legible at default zoom.
Scope
Global label collision resolver (pin labels, net labels, value labels, annotations).
Avoid duplicate nearby labels for same net.
Prioritize labels near relevant stubs/pins with deterministic fallback anchors.
Add label density controls by mode/zoom.
Acceptance Criteria
No label-over-pin overlaps in default sample scenes.
Reduced duplicate labels per net while preserving clarity.
Label placement remains deterministic for unchanged JSON.
## Problem
Net/value/pin labels can still overlap or duplicate in dense sections, reducing readability and teaching quality.
## Goal
Make text rendering reliably legible at default zoom.
## Scope
- Global label collision resolver (pin labels, net labels, value labels, annotations).
- Avoid duplicate nearby labels for same net.
- Prioritize labels near relevant stubs/pins with deterministic fallback anchors.
- Add label density controls by mode/zoom.
## Acceptance Criteria
- No label-over-pin overlaps in default sample scenes.
- Reduced duplicate labels per net while preserving clarity.
- Label placement remains deterministic for unchanged JSON.
Rbanh
added this to the Phase 2 - Production Polish milestone 2026-02-16 21:47:21 -05:00
Replace heuristic DOM-side hiding with deterministic layout-time label placement where practical.
Add explicit user controls for label density mode.
Add regression scenes/assertions for specific collision-heavy circuits.
Implemented first readability slice for Issue #5 in commit `f938c6d`.
### Shipped
- Added label metadata attributes on component labels (`data-ref-label`, `data-value-label`) to enable unified readability processing.
- Added client-side label collision resolver:
- suppresses overlapping lower-priority labels
- de-duplicates nearby labels for the same net
- Added zoom-based label density control:
- hide pin labels at lower zoom
- hide value/ref labels at very low zoom
- Integrated readability pass into transform/render/update flows so it stays consistent while zooming and panning.
### Validation
- Syntax checks pass.
- Existing tests pass.
### Remaining for Issue #5
- Replace heuristic DOM-side hiding with deterministic layout-time label placement where practical.
- Add explicit user controls for label density mode.
- Add regression scenes/assertions for specific collision-heavy circuits.
Label readability engine includes collision suppression, duplicate-net label suppression, and zoom-density controls.
Pin/value/ref/net label visibility now adapts by zoom and priority.
Deterministic placement behavior retained for unchanged JSON.
Key commits include f938c6d and follow-up readability tuning.
Final closure summary:
- Label readability engine includes collision suppression, duplicate-net label suppression, and zoom-density controls.
- Pin/value/ref/net label visibility now adapts by zoom and priority.
- Deterministic placement behavior retained for unchanged JSON.
Key commits include `f938c6d` and follow-up readability tuning.
Blocking a user prevents them from interacting with repositories, such as opening or commenting on pull requests or issues. Learn more about blocking a user.
Problem
Net/value/pin labels can still overlap or duplicate in dense sections, reducing readability and teaching quality.
Goal
Make text rendering reliably legible at default zoom.
Scope
Acceptance Criteria
Implemented first readability slice for Issue #5 in commit
f938c6d.Shipped
data-ref-label,data-value-label) to enable unified readability processing.Validation
Remaining for Issue #5
Final closure summary:
Key commits include
f938c6dand follow-up readability tuning.