Add controlled PCB component focus requests

[0hmX]

Summary

Adds the PCB-viewer side of schematic-to-PCB component navigation.

• adds the optional controlled pcbComponentFocusRequest API
• resolves bounds for the complete component footprint with 1.75 mm padding
• smoothly animates the current transform to a bounded target zoom
• supports repeat requests for the same component via monotonically increasing request IDs
• waits for non-zero viewport dimensions and prevents initial board centering from overwriting focus
• selects the bottom layer for bottom-side components
• safely ignores invalid or stale component IDs
• reuses the existing bounds-transform and animation machinery

PR chain

Part 2 of 3 — follows tscircuit/schematic-viewer#262.

1. tscircuit/schematic-viewer#262 — navigation callback
2. This PR: PCB component focus request
3. tscircuit/runframe#4668 — tab and focus integration

The runframe integration should consume released versions from parts 1 and 2.

Validation

• bun test — 47 passed
• formatting check
• TypeScript check
• package build

[vercel]

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

Project	Deployment	Actions	Updated (UTC)
pcb-viewer	Ready	Preview	Aug 20, 2026 3:09pm