# adom-layout-viewer

Interactive **PCB layout viewer**. The picture is your EDA's *own* export — the
real silkscreen, the real trace widths, the real theme colours — and on top of it
sits an invisible, coordinate-aligned interaction layer that knows the netlist.
So you get a board that looks exactly like it does in KiCad, except you can click
a pad and watch its entire net light up.

![A net highlighted in adom-layout-viewer](screenshots/shot.png)

## Why it works this way

A flat SVG export is authentic but dead — no nets, no pads, nothing to click.
A self-drawn render is interactive but never quite looks like your EDA. This app
does both at once:

- **Visual base** — per-layer SVG straight from the EDA (KiCad via the shared
  **service-kicad** container, `POST /kicad/pcb/export/svg?layers=<L>`), one group
  per layer, in KiCad's own theme colours.
- **Interaction overlay** — the `.kicad_pcb` parsed in Rust into pads, traces,
  vias and zones carrying `data-net` / `data-ref`, drawn invisibly in the *same*
  board-mm coordinate system. No Y-flip, no offset, so the two align exactly.

## What you get

- **Net highlighting** — click any pad, via, trace or zone fill; the whole net
  lights in its own copper colour while the rest of the board dims. The net list
  on the right stays in sync (and is clickable itself).
- **Per-pad hover** — pad number, size, shape, side and net, plus live
  **stock, price, wiki page and popularity** for the parent part.

  ![Hovering a pad](screenshots/hover.png)
- **Layer control** — every layer toggles independently, and the Top/Bottom
  switch mirrors the board and brings that side's stack to the front so you can
  select parts on the far side.
- **Embeddable** — `embed` emits one self-contained interactive HTML file with
  no external assets, so any app can drop it in an iframe as a live PCB view.
  (adom-nucleus uses exactly this for its board pane.)

## Install

```
adompkg install adom-layout-viewer
```

## Use

```bash
# one self-contained interactive HTML (what you embed in another app)
adom-layout-viewer embed --file board.kicad_pcb --out board.html

# a composed interactive SVG (+ board.meta.json with --meta)
adom-layout-viewer render --file board.kicad_pcb --out board.svg --meta

# the live app — hover/click, with enrichment served from /enrich
adom-layout-viewer serve --file board.kicad_pcb --port 8790
```

### Embedding in your own app

`embed` inlines the SVG, the metadata and the viewer JS into a single file, so
an iframe is all you need:

```html
<iframe src="/board-view/my-board/pcb" style="border:0;width:100%;height:100%"></iframe>
```

An embed has no server of its own, so its enrichment `fetch("enrich")` is
**relative** — it resolves against whatever serves the page. Host apps can
answer it (`/…/enrich?mpn=&lcsc=`) to give the embedded card live stock and
price; if nothing answers, the card simply shows identity only.

## Enrichment

Hover data comes from sibling Adom CLIs, cached per part and fetched off the
render path (`/enrich` returns `{"pending":true}` and warms in the background,
so hovering never blocks):

- `adom-parts-search search <mpn>` — stock and price
- `adom-wiki discover search --query <mpn> --json` — wiki page and popularity

## Notes

- Requires network access to **service-kicad**; override with `KICAD_SERVICE_API`.
  If it is unreachable the app falls back to its own self-render so you still get
  a usable (if less authentic-looking) board.
- KiCad today; the same overlay architecture is what will carry Altium and
  Fusion exports.

See also: **adom-schematic-viewer** — the same idea for `.kicad_sch`.