Rbanh/schemeta
1
0
Fork 0
Code Issues 2 Pull Requests Actions Packages Projects Releases Wiki Activity

P8-07: Symbol readability and pin-density standards #43

New Issue
Closed
opened 2026-02-19 19:04:55 -05:00 by Rbanh · 2 comments
Rbanh commented 2026-02-19 19:04:55 -05:00
Owner
Copy Link

Goal:
Prevent unreadable symbols and pin text collisions.

Scope:

  • Enforce minimum pin pitch and min body dimensions from pin count.
  • Auto-spread pins per side with deterministic ordering.
  • Inline symbol diagnostics when pin geometry violates readability.
  • Migration utility for legacy symbols to new spacing defaults.

Acceptance:

  • Symbols with many pins remain readable at default zoom.
  • Pin labels do not overlap at baseline zoom levels.
  • Diagnostics suggest fix actions for invalid geometry.
Goal: Prevent unreadable symbols and pin text collisions. Scope: - Enforce minimum pin pitch and min body dimensions from pin count. - Auto-spread pins per side with deterministic ordering. - Inline symbol diagnostics when pin geometry violates readability. - Migration utility for legacy symbols to new spacing defaults. Acceptance: - Symbols with many pins remain readable at default zoom. - Pin labels do not overlap at baseline zoom levels. - Diagnostics suggest fix actions for invalid geometry.
Rbanh added this to the Phase 8 - React/ELK Core Refactor milestone 2026-02-19 19:05:17 -05:00
Rbanh commented 2026-02-19 23:10:14 -05:00
Author
Owner
Copy Link

Sprint 5 completed and pushed in b8d894f.

Implemented first production pass for symbol readability standards:

  • Added deterministic geometry normalization for generic/template symbols in src/validate.js.
  • Enforces minimum symbol body size and per-side pin pitch.
  • Normalizes per-side pin ordering by offset/name for deterministic placement.
  • Emits warning symbol_geometry_adjusted when normalization is applied.
  • Added deterministic regression test tests/validate.test.js.

Important scope guard:

  • Normalization intentionally applies to generic/template symbols only for now, to avoid mutating curated explicit symbols unexpectedly.

Validation:

  • npm test pass (8/8).
  • npm run test:ui pass.
Sprint 5 completed and pushed in `b8d894f`. Implemented first production pass for symbol readability standards: - Added deterministic geometry normalization for generic/template symbols in `src/validate.js`. - Enforces minimum symbol body size and per-side pin pitch. - Normalizes per-side pin ordering by offset/name for deterministic placement. - Emits warning `symbol_geometry_adjusted` when normalization is applied. - Added deterministic regression test `tests/validate.test.js`. Important scope guard: - Normalization intentionally applies to generic/template symbols only for now, to avoid mutating curated explicit symbols unexpectedly. Validation: - `npm test` pass (8/8). - `npm run test:ui` pass.
Rbanh commented 2026-02-20 01:35:37 -05:00
Author
Owner
Copy Link

Closing as completed. Symbol readability/pin-density standards shipped and later expanded in Phase 9 geometry work (b8d894f, 128c5c6).

Closing as completed. Symbol readability/pin-density standards shipped and later expanded in Phase 9 geometry work (`b8d894f`, `128c5c6`).
Rbanh closed this issue 2026-02-20 01:35:37 -05:00
Sign in to join this conversation.
No Branch/Tag Specified
Branches Tags
Labels
Clear labels
No items
No Label
Milestone
Clear milestone
No items
No Milestone
Phase 8 - React/ELK Core Refactor
Projects
Clear projects
No project
Assignees
Clear assignees
No Assignees
1 Participants
Notifications
Due Date
The due date is invalid or out of range. Please use the format 'yyyy-mm-dd'.

No due date set.

Dependencies

No dependencies set.

Reference: Rbanh/schemeta#43
No description provided.
Delete Branch "%!s()"

Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?