feat: Row-engine board renderer as a Dioxus component (M2) by Yona-Appletree · Pull Request #231 · light-player/lightplayer

Yona-Appletree · 2026-07-31T21:29:57Z

Plan: lp2025/2026-07-31-1002-hardware-board-selection
Path: ~/.photomancer/planning/lp2025/2026-07-31-1002-hardware-board-selection/m2-row-engine-renderer.md

M2 of the hardware/board-selection roadmap: the approved UX spike's SVG row-engine renderer (spikes/hardware-boards/index.html, rev 5, PR #222) ported into lpa-boards as a reusable BoardDiagram Dioxus component consuming the M1 display sidecars. Retargeted to main after #228 merged.

What landed

lpa-boards/src/geometry.rs — the row layout engine. Every drawn coordinate derives from the pin-pitch unit u (pad 0.62u×0.45u, cell 0.78u, font 0.5u, gap 0.22u) and the module is the single home for those constants. BoardLayout is public and deterministic: stories compute anatomy-callout anchors from the same layout the renderer draws.
lpa-boards/src/diagram.rs — BoardDiagram (modes plain | caps | wired | swatch, labels inside the board, band rows + leader lines for terminals, negative-y buttons, role-colored pads), behind a diagram cargo feature so lp-cli stays Dioxus-free.
docs/design/board-diagrams.md — the design language, ported from the spike's DESIGN-LANGUAGE.md.
lpb-* CSS block in the studio stylesheet: cell families mapped onto studio status colors — conn = bound violet, adc = good, touch = attention, dac = live, pwr = error — with spike-tuned literals for hues the palette lacks (spi/i2c/uart/amber/silk).
13 stories (studio/board-diagram/*): every mode at u=12/13, smallest (XIAO C6) + largest (DevKitC v4) boards, QuinLED band/leader case, discovery swatches incl. bound-violet confirmed state, catalog thumbnail strip, annotated anatomy.

Deviations from the spike

Smallest board is the XIAO ESP32-C6 (M1 landed no M5Stamp sidecar).
rsvd role (new in M1) renders with the input-only pad fill + IO-prefixed names.
Anatomy anchors computed from the geometry module (plan's sanctioned fallback for DOM measurement); label-center uses the same char-count width heuristic cells use.
Spike's hover brightness dropped — static component; interactivity arrives with M3/M6.

Validation

just check green; just test running locally; studio-web view tests 215 green; lpa-boards 17 tests incl. 7 geometry invariants; wasm32 check green.
Story baselines: CI-canonical capture expected to auto-commit on this PR.

Status

At the M2 visual gate — PR stays draft until the gate passes (density vs spike rev 5, studio-palette cell colors, anatomy doc-quality).

🤖 Generated with Claude Code

Port the spike's SVG row layout engine (spikes/hardware-boards, rev 5) into lpa-boards: geometry.rs computes the full deterministic layout (rails, band rows, leaders, viewBox) from the pin-pitch unit u, and diagram.rs walks it as a BoardDiagram component behind a new 'diagram' feature so data-only consumers (lp-cli) stay Dioxus-free. Plan: 2026-07-31-1002-hardware-board-selection (M2) Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

DESIGN-LANGUAGE.md (spike rev 5) lands as docs/design/board-diagrams.md; crate README gains BoardDiagram usage; stale spike pointers updated. Plan: 2026-07-31-1002-hardware-board-selection (M2) Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

Thirteen stories cover the M2 gate: every mode at u=12/13, smallest (XIAO C6) and largest (DevKitC v4) boards, the QuinLED band/leader case, discovery swatches with a bound-violet confirmed state, and the annotated-anatomy figure whose callout anchors come from the shared geometry module rather than hand positioning. The lpb-* CSS block maps cell families onto studio status colors (conn = bound violet, adc = good, touch = attention, dac = live, pwr = error) with spike-tuned literals for hues the palette lacks. Plan: 2026-07-31-1002-hardware-board-selection (M2) Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

…renderer-m2

The BoardDrawing doc comment feeds the schemars description; pointing it at docs/design/board-diagrams.md changed the generated schema. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

Captured in the pinned CI environment by run: https://github.com/light-player/lightplayer/actions/runs/30668807859

github-actions · 2026-07-31T22:13:40Z

CI refreshed the story baselines on this branch

The validate-stories job detected drift and committed the fresh set: 4 changed, 3 added
in b372ae3.

Review every PNG in the PR's Files changed view (swipe / onion-skin).
Your local branch is now behind — git pull before pushing again.

Story	Before	After
`studio__board-diagram__catalog-thumbnails__lg.png`
`studio__board-diagram__catalog-thumbnails__md.png`
`studio__board-diagram__catalog-thumbnails__sm.png`
`studio__node__node__dirty-unsaved-surface-tint__sm.png`
`studio__board-diagram__wired-domraem-4ch__lg.png`	—
`studio__board-diagram__wired-domraem-4ch__md.png`	—
`studio__board-diagram__wired-domraem-4ch__sm.png`	—

The Ethernet WLED-class 4-channel controller (Amazon B0GH7LPNQV), authored from its silkscreen: WROOM-32E-N4, four fused data channels (IO18/16/14/2), IO13 aux, screw-terminal rails both sides, stacked OPT/RST buttons drawn vertically adjacent (the 2D compromise). Display- only per the classic-ESP32 allowlist; price is an approximate street figure pending correction. Plan: 2026-07-31-1002-hardware-board-selection (M2 follow-up) Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

Captured in the pinned CI environment by run: https://github.com/light-player/lightplayer/actions/runs/30674979720

…ds elsewhere domraem/dom-z-102's runtime manifest arrives with the classic bring-up roadmap while its display sidecar + catalog entry are authored on PR #231 (board catalog work) — the first runtime-first board, so the drift gate gains the mirror of DISPLAY_ONLY, strict the same way: once #231 merges, the entry must be removed or the gate fails. Also refreshed the two stale DISPLAY_ONLY reasons ('no HardwareTarget yet' — HardwareTarget::Esp32 landed with this branch). Plan: 2026-07-31-1444-classic-esp32-bringup (M2 P5 follow-through) Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

The runtime manifest (PR #239) deliberately omits /gpio/13 — its function is unverified — so the display pin must be non-output-eligible or the drift gate's Rule 2 fails the moment both files share a branch. rsvd keeps the terminal drawn (it exists on the silkscreen) but muted and never claimable; both files upgrade together if IO13 is verified usable. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

Yona-Appletree · 2026-08-01T01:42:19Z

Coordination with #239 (classic ESP32 bring-up), which adds domraem/dom-z-102.json (runtime manifest):

Whichever of feat: Row-engine board renderer as a Dioxus component (M2) #231/feat: Classic ESP32 (LX6) bring-up — the 4-output WLED-class deployment target #239 merges second must, when syncing main, delete BOTH allowlist entries for domraem/dom-z-102 — the DISPLAY_ONLY entry in this PR's lp-app/lpa-boards/tests/manifest_drift.rs and the RUNTIME_ONLY entry feat: Classic ESP32 (LX6) bring-up — the 4-output WLED-class deployment target #239 added. Both gates are strict and their failure messages say exactly this.
IO13 now presents as rsvd (9fd5ef4) so drift Rule 2 passes when both files coexist — the runtime manifest deliberately omits /gpio/13 (function unverified).

🤖 Generated with Claude Code

…2, not LED1-4) Cross-checked with the board-catalog session's silkscreen read (PR #231): terminals are printed IO18/IO16/IO14/IO2, and an unverified IO13 terminal exists (omitted here, drawn non-claimable in their sidecar). Description now states which facts are silkscreen-verified vs standard-wiring inference. Plan: 2026-07-31-1444-classic-esp32-bringup (M2 P5 follow-through) Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

…rift exemptions Semantic cross-PR drift the textual merge couldn't see: PR #231 (main) landed the display sidecar with a DISPLAY_ONLY exemption waiting on this branch's runtime manifest, while this branch carried the RUNTIME_ONLY exemption waiting on #231. Merging main satisfied both conditions at once, and the drift test correctly demanded both entries be removed. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

Brings the spike branch up to date with main (225 commits) so the frozen UX-spike artifacts under spikes/hardware-boards/ can land beside the implementation they produced (lp-app/lpa-boards, PRs #228/#231/#236). Clean merge: the branch adds only new files in a directory that does not exist on main. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>

Yona-Appletree changed the base branch from claude/board-display-metadata-m1 to main July 31, 2026 21:31

Yona-Appletree and others added 6 commits July 31, 2026 14:31

style: rustfmt board diagram modules

d90e589

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

Merge remote-tracking branch 'origin/main' into claude/board-diagram-…

ca8c414

…renderer-m2

chore(schemas): regenerate board-display schema for doc-pointer change

89816c7

The BoardDrawing doc comment feeds the schemars description; pointing it at docs/design/board-diagrams.md changed the generated schema. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

chore(studio): auto-refresh story baselines [validate-stories]

e6255bb

Captured in the pinned CI environment by run: https://github.com/light-player/lightplayer/actions/runs/30668807859

Yona-Appletree marked this pull request as ready for review August 1, 2026 00:05

Yona-Appletree and others added 2 commits July 31, 2026 17:13

chore(studio): auto-refresh story baselines [validate-stories]

b372ae3

Captured in the pinned CI environment by run: https://github.com/light-player/lightplayer/actions/runs/30674979720

Yona-Appletree mentioned this pull request Aug 1, 2026

feat: #/boards catalog page + usb_bridge driver guidance (M3) #236

Merged

Yona-Appletree mentioned this pull request Aug 1, 2026

feat: Classic ESP32 (LX6) bring-up — the 4-output WLED-class deployment target #239

Draft

Yona-Appletree merged commit 573eb09 into main Aug 1, 2026
10 checks passed

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

feat: Row-engine board renderer as a Dioxus component (M2) - #231

feat: Row-engine board renderer as a Dioxus component (M2)#231
Yona-Appletree merged 10 commits into
mainfrom
claude/board-diagram-renderer-m2

Yona-Appletree commented Jul 31, 2026 •

edited

Loading

Uh oh!

github-actions Bot commented Jul 31, 2026 •

edited

Loading

Uh oh!

Yona-Appletree commented Aug 1, 2026

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

1 participant

Uh oh!

Conversation

Yona-Appletree commented Jul 31, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

What landed

Deviations from the spike

Validation

Status

Uh oh!

github-actions Bot commented Jul 31, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

CI refreshed the story baselines on this branch

Uh oh!

Yona-Appletree commented Aug 1, 2026

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

1 participant

Yona-Appletree commented Jul 31, 2026 •

edited

Loading

github-actions Bot commented Jul 31, 2026 •

edited

Loading