Add excludeRefs to PCB keepout props

[seveibar]

Summary

• add an optional excludeRefs: string[] prop to circular and rectangular PCB keepouts
• accept component selectors such as ".ANT1" and preserve them unchanged in parsed props
• add tests covering both keepout shapes
• regenerate the repository's required documentation artifacts

Why

Keepouts need a way to identify selected components that may occupy the keepout region, such as allowing an antenna component inside its own RF keepout.

This PR adds the props-layer contract only. @tscircuit/core will need a follow-up change to resolve the selectors and apply the exclusions while rendering routing obstacles.

API behavior

• accepted input: an optional array of selector strings
• canonical parsed output: the same string array
• default: omitted / undefined
• aliases or conflicts: none
• migration: fully additive and backward compatible

Generated documentation note

Running the generators required by AGENTS.md also synchronized pre-existing generated documentation drift for BusProps.routingPhaseIndex.

Validation

• bun test — 400 passing
• bun run typecheck
• bun run format:check
• bun run build
• bun run check-circular-deps
• git diff --check

[graphite-app]

A *.test.ts file may have AT MOST one test(...) call. This file already contains a prior test(...) block (ending at line 32), and the newly added test("should parse keepout excludeRefs selectors", ...) (lines 34–49) is a second test in the same file. Per the style guide, once a file has one test, any additional tests must be split into separate, numbered files — e.g., pcb-keepout1.test.ts and pcb-keepout2.test.ts. Please move the new test to its own file.

Spotted by Graphite (based on custom rule: Custom rule)



Is this helpful? React 👍 or 👎 to let us know.

[tscircuitbot]

---

Thank you for your contribution! 🎉

PR Rating: ⭐
Impact: Tiny

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

---