Serialize keepout excludeRefs as PCB component IDs

[seveibar]

Summary

• consume the merged excludeRefs keepout prop from @tscircuit/props
• resolve selectors such as .ANT1 within the keepout's subcircuit
• serialize the selected components as excluded_pcb_component_ids on the pcb_keepout Circuit JSON element
• leave Simple Route JSON and every autorouter keepout obstacle unchanged

Package responsibilities

Core only resolves TSX selectors and emits stable Circuit JSON IDs. It does not inspect or filter DRC output. The actual keepout exemption is implemented in @tscircuit/checks.

Released dependencies

• circuit-json@^0.0.457, released from Add resolved component exclusions to PCB keepouts circuit-json#670
• @tscircuit/checks@0.0.147, released from Respect PCB keepout component exclusions checks#176

Behavior

<keepout
  shape="rect"
  width="8mm"
  height="6mm"
  excludeRefs={[".ANT1"]}
/>

The resulting keepout contains ANT1's resolved PCB component ID. Autorouters still receive a hard obstacle with an empty connectedTo list. Manually routed traces connected to ANT1 do not produce that keepout-overlap error, while unrelated violations remain visible.

Validation

• focused serialization/autorouter regression and inspected PCB snapshot
• bunx tsc --noEmit
• Biome checks on changed files
• bun run build
• full suite: 1,302 passed, 31 skipped, 0 failed

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
tscircuit-core-benchmarks	Ready	Preview	Aug 1, 2026 3:01am

[tscircuitbot]

---

Thank you for your contribution! 🎉

PR Rating: ⭐⭐⭐
Impact: Major

Track your contributions and see the leaderboard at: tscircuit Contribution Tracker

---