@tscircuit/pcb-viewer 1.11.406 → 1.11.408

package/README.md

@@ -76,6 +76,7 @@ The PCBViewer component accepts these props:
 - `editEvents`: Array of edit events to apply
 - `onEditEventsChanged`: Callback when edit events change
 - `onBoundsSelected`: Callback when the Bounds tool completes a rectangle selection. Receives `{ minX, minY, maxX, maxY }`.
+- `onViewSchematicComponent`: Optional callback for the pad context menu action `↗︎ U1 on Schematic`. Receives `{ source_component_id, pcb_component_id, refdes }`. Omit it when the host schematic tab is disabled.
 - `initialState`: Initial state for the viewer
 
 ### Features
@@ -123,3 +124,25 @@ The WebGPU renderer is installed as a bundled devDependency from
 `https://jscdn.tscircuit.com/@tscircuit/circuit-json-webgpu/0.0.3.tgz`.
 The renderer repository includes a TypeScript local render command and 597
 SVG-left/WebGPU-right feature snapshot tests.
+
+### Navigate from a pad to a schematic
+
+Click or right-click an SMT pad or plated hole to see its component's manufacturer
+part number in a disabled row at the bottom of the context menu, when available.
+Passing `onViewSchematicComponent` also enables the schematic action:
+
+```tsx
+<PCBViewer
+  circuitJson={circuitJson}
+  onViewSchematicComponent={schematicTabEnabled ? ({ source_component_id }) => {
+    // The host switches tabs and focuses the matching schematic component.
+    showSchematicComponent(source_component_id)
+  } : undefined}
+/>
+```
+
+The callback uses the source component ID so hosts can resolve the corresponding
+schematic component even when reference designators repeat across subcircuits.
+RunFrame and CircuitJsonViewer can forward this callback from their shared PCB
+preview when the schematic tab is enabled. Tab switching and schematic zooming
+are implemented by the host; PCBViewer does not require schematic elements.

package/dist/index.d.ts

@@ -4,6 +4,13 @@ import { GraphicsObject } from 'graphics-debug';
 import { ManualEditEvent } from '@tscircuit/props';
 import { Matrix } from 'transformation-matrix';
 
+/** Stable identity for hosts to locate the component in their schematic. */
+interface ViewSchematicComponentEvent {
+    source_component_id: string;
+    pcb_component_id: string;
+    refdes: string;
+}
+
 interface State {
     hidden_layer_opacity: number;
     setHiddenLayerOpacity: (opacity: number) => void;
@@ -81,13 +88,15 @@ type Props = {
     editEvents?: ManualEditEvent[];
     initialState?: Partial<StateProps>;
     onEditEventsChanged?: (editEvents: ManualEditEvent[]) => void;
+    /** Omit when the host has no enabled schematic tab. */
+    onViewSchematicComponent?: (event: ViewSchematicComponentEvent) => void;
     onBoundsSelected?: (bounds: BoundsSelection) => void;
     focusOnHover?: boolean;
     clickToInteractEnabled?: boolean;
     debugGraphics?: GraphicsObject | null;
     disablePcbGroups?: boolean;
 };
-declare const PCBViewer: ({ circuitJson, debugGraphics, height, renderer, initialState, allowEditing, editEvents: editEventsProp, onEditEventsChanged, onBoundsSelected, focusOnHover, clickToInteractEnabled, disablePcbGroups, }: Props) => react_jsx_runtime.JSX.Element;
+declare const PCBViewer: ({ circuitJson, debugGraphics, height, renderer, initialState, allowEditing, editEvents: editEventsProp, onEditEventsChanged, onBoundsSelected, onViewSchematicComponent, focusOnHover, clickToInteractEnabled, disablePcbGroups, }: Props) => react_jsx_runtime.JSX.Element;
 
 interface CanvasElementsRendererProps {
     elements: AnyCircuitElement[];
@@ -100,6 +109,7 @@ interface CanvasElementsRendererProps {
     grid?: GridConfig;
     allowEditing: boolean;
     focusOnHover?: boolean;
+    onViewSchematicComponent?: (event: ViewSchematicComponentEvent) => void;
     onBoundsSelected?: (bounds: BoundsSelection) => void;
     onContextMenuOpenChange?: (open: boolean) => void;
     cancelPanDrag: () => void;
@@ -108,4 +118,4 @@ interface CanvasElementsRendererProps {
 }
 declare const CanvasElementsRenderer: (props: CanvasElementsRendererProps) => react_jsx_runtime.JSX.Element;
 
-export { CanvasElementsRenderer, PCBViewer };
+export { CanvasElementsRenderer, PCBViewer, type ViewSchematicComponentEvent };