@tscircuit/core 0.0.19 → 0.0.21

package/dist/index.d.ts

@@ -6,10 +6,10 @@ import { ReactElement } from 'react';
 import { Matrix } from 'transformation-matrix';
 import { SchSymbol, BaseSymbolName } from 'schematic-symbols';
 import * as Props from '@tscircuit/props';
-import { boardProps, footprintProps, smtPadProps, resistorProps, ledProps, traceProps, traceHintProps, groupProps, chipProps, jumperProps, silkscreenPathProps, platedHoleProps } from '@tscircuit/props';
+import { boardProps, footprintProps, smtPadProps, resistorProps, ledProps, capacitorProps, traceProps, traceHintProps, groupProps, chipProps, jumperProps, silkscreenPathProps, platedHoleProps } from '@tscircuit/props';
 import * as _tscircuit_layout from '@tscircuit/layout';
 
-declare class Project {
+declare class Circuit {
     rootComponent: PrimitiveComponent | null;
     children: PrimitiveComponent[];
     db: SoupUtilObjects;
@@ -31,10 +31,13 @@ declare class Project {
     computeGlobalSchematicTransform(): Matrix;
     computeGlobalPcbTransform(): Matrix;
     selectAll(selector: string): PrimitiveComponent[];
-    selectOne(selector: string): PrimitiveComponent | null;
+    selectOne(selector: string, opts: {
+        type?: "component" | "port";
+    }): PrimitiveComponent | null;
 }
+declare const Project: typeof Circuit;
 
-declare const orderedRenderPhases: readonly ["ReactSubtreesRender", "SourceRender", "SourceParentAttachment", "PortDiscovery", "PortMatching", "SourceTraceRender", "SchematicComponentRender", "SchematicLayout", "SchematicPortRender", "SchematicTraceRender", "PcbComponentRender", "PcbPortRender", "PcbPrimitiveRender", "PcbParentAttachment", "PcbLayout", "PcbTraceRender", "CadModelRender", "PcbAnalysis"];
+declare const orderedRenderPhases: readonly ["ReactSubtreesRender", "CreateTracesFromProps", "SourceRender", "SourceParentAttachment", "PortDiscovery", "PortMatching", "SourceTraceRender", "SchematicComponentRender", "SchematicLayout", "SchematicPortRender", "SchematicTraceRender", "PcbComponentRender", "PcbPortRender", "PcbPrimitiveRender", "PcbParentAttachment", "PcbLayout", "PcbTraceRender", "CadModelRender", "PcbAnalysis"];
 type RenderPhase = (typeof orderedRenderPhases)[number];
 type RenderPhaseFn<K extends RenderPhase = RenderPhase> = `doInitial${K}` | `update${K}` | `remove${K}`;
 type RenderPhaseStates = Record<RenderPhase, {
@@ -89,19 +92,26 @@ declare abstract class PrimitiveComponent<ZodProps extends ZodType = any> extend
     children: PrimitiveComponent[];
     childrenPendingRemoval: PrimitiveComponent[];
     get config(): BaseComponentConfig;
-    project: Project | null;
+    project: Circuit | null;
     props: z.input<ZodProps>;
     _parsedProps: z.infer<ZodProps>;
     componentName: string;
     lowercaseComponentName: string;
     externallyAddedAliases: string[];
+    /**
+     * An opaque group is a self-contained subcircuit. All the selectors inside
+     * an opaque group are relative to the group. You can have multiple opaque
+     * groups and their selectors will not interact with each other (even if the
+     * components share the same names) unless you explicitly break out some ports
+     */
+    get isOpaqueGroup(): boolean;
     source_group_id: string | null;
     source_component_id: string | null;
     schematic_component_id: string | null;
     pcb_component_id: string | null;
     cad_component_id: string | null;
     constructor(props: z.input<ZodProps>);
-    setProject(project: Project): void;
+    setProject(project: Circuit): void;
     setProps(props: Partial<z.input<ZodProps>>): void;
     /**
      * Computes a transformation matrix from the props of this component for PCB
@@ -145,10 +155,13 @@ declare abstract class PrimitiveComponent<ZodProps extends ZodType = any> extend
     add(component: PrimitiveComponent): void;
     addAll(components: PrimitiveComponent[]): void;
     remove(component: PrimitiveComponent): void;
+    getOpaqueGroupSelector(): string;
+    getFullPathSelector(): string;
     getNameAndAliases(): string[];
     isMatchingNameOrAlias(name: string): boolean;
     isMatchingAnyOf(aliases: Array<string | number>): boolean;
     doesSelectorMatch(selector: string): boolean;
+    getOpaqueGroup(): PrimitiveComponent;
     selectAll(selector: string): PrimitiveComponent[];
     selectOne(selector: string, options?: {
         type?: string;
@@ -287,6 +300,7 @@ declare class NormalComponent<ZodProps extends ZodType = any, PortNames extends
 
 declare class Board extends NormalComponent<typeof boardProps> {
     pcb_board_id: string | null;
+    get isOpaqueGroup(): boolean;
     get config(): {
         zodProps: z.ZodObject<{
             width: z.ZodOptional<z.ZodEffects<z.ZodUnion<[z.ZodString, z.ZodNumber]>, number, string | number>>;
@@ -428,33 +442,33 @@ type PolarizedPassivePorts = PassivePorts | "anode" | "cathode" | "pos" | "neg";
 declare class Resistor extends NormalComponent<typeof resistorProps, PassivePorts> {
     get config(): {
         schematicSymbolName: BaseSymbolName;
-        zodProps: zod.ZodObject<zod.objectUtil.extendShape<zod.objectUtil.extendShape<zod.objectUtil.extendShape<{
-            pcbX: zod.ZodOptional<zod.ZodEffects<zod.ZodUnion<[zod.ZodString, zod.ZodNumber]>, number, string | number>>;
-            pcbY: zod.ZodOptional<zod.ZodEffects<zod.ZodUnion<[zod.ZodString, zod.ZodNumber]>, number, string | number>>;
-            pcbRotation: zod.ZodOptional<zod.ZodEffects<zod.ZodUnion<[zod.ZodString, zod.ZodNumber]>, number, string | number>>;
-            schX: zod.ZodOptional<zod.ZodEffects<zod.ZodUnion<[zod.ZodString, zod.ZodNumber]>, number, string | number>>;
-            schY: zod.ZodOptional<zod.ZodEffects<zod.ZodUnion<[zod.ZodString, zod.ZodNumber]>, number, string | number>>;
-            schRotation: zod.ZodOptional<zod.ZodEffects<zod.ZodUnion<[zod.ZodString, zod.ZodNumber]>, number, string | number>>;
-            layer: zod.ZodOptional<zod.ZodEffects<zod.ZodUnion<[zod.ZodEnum<["top", "bottom", "inner1", "inner2", "inner3", "inner4", "inner5", "inner6"]>, zod.ZodObject<{
-                name: zod.ZodEnum<["top", "bottom", "inner1", "inner2", "inner3", "inner4", "inner5", "inner6"]>;
-            }, "strip", zod.ZodTypeAny, {
+        zodProps: z.ZodObject<z.objectUtil.extendShape<z.objectUtil.extendShape<z.objectUtil.extendShape<{
+            pcbX: z.ZodOptional<z.ZodEffects<z.ZodUnion<[z.ZodString, z.ZodNumber]>, number, string | number>>;
+            pcbY: z.ZodOptional<z.ZodEffects<z.ZodUnion<[z.ZodString, z.ZodNumber]>, number, string | number>>;
+            pcbRotation: z.ZodOptional<z.ZodEffects<z.ZodUnion<[z.ZodString, z.ZodNumber]>, number, string | number>>;
+            schX: z.ZodOptional<z.ZodEffects<z.ZodUnion<[z.ZodString, z.ZodNumber]>, number, string | number>>;
+            schY: z.ZodOptional<z.ZodEffects<z.ZodUnion<[z.ZodString, z.ZodNumber]>, number, string | number>>;
+            schRotation: z.ZodOptional<z.ZodEffects<z.ZodUnion<[z.ZodString, z.ZodNumber]>, number, string | number>>;
+            layer: z.ZodOptional<z.ZodEffects<z.ZodUnion<[z.ZodEnum<["top", "bottom", "inner1", "inner2", "inner3", "inner4", "inner5", "inner6"]>, z.ZodObject<{
+                name: z.ZodEnum<["top", "bottom", "inner1", "inner2", "inner3", "inner4", "inner5", "inner6"]>;
+            }, "strip", z.ZodTypeAny, {
                 name: "top" | "bottom" | "inner1" | "inner2" | "inner3" | "inner4" | "inner5" | "inner6";
             }, {
                 name: "top" | "bottom" | "inner1" | "inner2" | "inner3" | "inner4" | "inner5" | "inner6";
             }>]>, "top" | "bottom" | "inner1" | "inner2" | "inner3" | "inner4" | "inner5" | "inner6", "top" | "bottom" | "inner1" | "inner2" | "inner3" | "inner4" | "inner5" | "inner6" | {
                 name: "top" | "bottom" | "inner1" | "inner2" | "inner3" | "inner4" | "inner5" | "inner6";
             }>>;
-            footprint: zod.ZodOptional<zod.ZodType<Props.Footprint, zod.ZodTypeDef, Props.Footprint>>;
+            footprint: z.ZodOptional<z.ZodType<Props.Footprint, z.ZodTypeDef, Props.Footprint>>;
         }, {
-            supplierPartNumbers: zod.ZodOptional<zod.ZodRecord<zod.ZodEnum<["jlcpcb", "macrofab", "pcbway", "digikey", "mouser", "lcsc"]>, zod.ZodArray<zod.ZodString, "many">>>;
+            supplierPartNumbers: z.ZodOptional<z.ZodRecord<z.ZodEnum<["jlcpcb", "macrofab", "pcbway", "digikey", "mouser", "lcsc"]>, z.ZodArray<z.ZodString, "many">>>;
         }>, {
-            name: zod.ZodString;
-            cadModel: zod.ZodOptional<zod.ZodUnion<[zod.ZodString, zod.ZodObject<zod.objectUtil.extendShape<{
-                rotationOffset: zod.ZodOptional<zod.ZodUnion<[zod.ZodNumber, zod.ZodObject<{
-                    x: zod.ZodUnion<[zod.ZodNumber, zod.ZodString]>;
-                    y: zod.ZodUnion<[zod.ZodNumber, zod.ZodString]>;
-                    z: zod.ZodUnion<[zod.ZodNumber, zod.ZodString]>;
-                }, "strip", zod.ZodTypeAny, {
+            name: z.ZodString;
+            cadModel: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodObject<z.objectUtil.extendShape<{
+                rotationOffset: z.ZodOptional<z.ZodUnion<[z.ZodNumber, z.ZodObject<{
+                    x: z.ZodUnion<[z.ZodNumber, z.ZodString]>;
+                    y: z.ZodUnion<[z.ZodNumber, z.ZodString]>;
+                    z: z.ZodUnion<[z.ZodNumber, z.ZodString]>;
+                }, "strip", z.ZodTypeAny, {
                     x: string | number;
                     y: string | number;
                     z: string | number;
@@ -463,11 +477,11 @@ declare class Resistor extends NormalComponent<typeof resistorProps, PassivePort
                     y: string | number;
                     z: string | number;
                 }>]>>;
-                positionOffset: zod.ZodOptional<zod.ZodObject<{
-                    x: zod.ZodEffects<zod.ZodUnion<[zod.ZodString, zod.ZodNumber]>, number, string | number>;
-                    y: zod.ZodEffects<zod.ZodUnion<[zod.ZodString, zod.ZodNumber]>, number, string | number>;
-                    z: zod.ZodEffects<zod.ZodUnion<[zod.ZodString, zod.ZodNumber]>, number, string | number>;
-                }, "strip", zod.ZodTypeAny, {
+                positionOffset: z.ZodOptional<z.ZodObject<{
+                    x: z.ZodEffects<z.ZodUnion<[z.ZodString, z.ZodNumber]>, number, string | number>;
+                    y: z.ZodEffects<z.ZodUnion<[z.ZodString, z.ZodNumber]>, number, string | number>;
+                    z: z.ZodEffects<z.ZodUnion<[z.ZodString, z.ZodNumber]>, number, string | number>;
+                }, "strip", z.ZodTypeAny, {
                     x: number;
                     y: number;
                     z: number;
@@ -476,11 +490,11 @@ declare class Resistor extends NormalComponent<typeof resistorProps, PassivePort
                     y: string | number;
                     z: string | number;
                 }>>;
-                size: zod.ZodOptional<zod.ZodObject<{
-                    x: zod.ZodEffects<zod.ZodUnion<[zod.ZodString, zod.ZodNumber]>, number, string | number>;
-                    y: zod.ZodEffects<zod.ZodUnion<[zod.ZodString, zod.ZodNumber]>, number, string | number>;
-                    z: zod.ZodEffects<zod.ZodUnion<[zod.ZodString, zod.ZodNumber]>, number, string | number>;
-                }, "strip", zod.ZodTypeAny, {
+                size: z.ZodOptional<z.ZodObject<{
+                    x: z.ZodEffects<z.ZodUnion<[z.ZodString, z.ZodNumber]>, number, string | number>;
+                    y: z.ZodEffects<z.ZodUnion<[z.ZodString, z.ZodNumber]>, number, string | number>;
+                    z: z.ZodEffects<z.ZodUnion<[z.ZodString, z.ZodNumber]>, number, string | number>;
+                }, "strip", z.ZodTypeAny, {
                     x: number;
                     y: number;
                     z: number;
@@ -490,8 +504,8 @@ declare class Resistor extends NormalComponent<typeof resistorProps, PassivePort
                     z: string | number;
                 }>>;
             }, {
-                stlUrl: zod.ZodString;
-            }>, "strip", zod.ZodTypeAny, {
+                stlUrl: z.ZodString;
+            }>, "strip", z.ZodTypeAny, {
                 stlUrl: string;
                 rotationOffset?: number | {
                     x: string | number;
@@ -525,12 +539,12 @@ declare class Resistor extends NormalComponent<typeof resistorProps, PassivePort
                     y: string | number;
                     z: string | number;
                 } | undefined;
-            }>, zod.ZodObject<zod.objectUtil.extendShape<{
-                rotationOffset: zod.ZodOptional<zod.ZodUnion<[zod.ZodNumber, zod.ZodObject<{
-                    x: zod.ZodUnion<[zod.ZodNumber, zod.ZodString]>;
-                    y: zod.ZodUnion<[zod.ZodNumber, zod.ZodString]>;
-                    z: zod.ZodUnion<[zod.ZodNumber, zod.ZodString]>;
-                }, "strip", zod.ZodTypeAny, {
+            }>, z.ZodObject<z.objectUtil.extendShape<{
+                rotationOffset: z.ZodOptional<z.ZodUnion<[z.ZodNumber, z.ZodObject<{
+                    x: z.ZodUnion<[z.ZodNumber, z.ZodString]>;
+                    y: z.ZodUnion<[z.ZodNumber, z.ZodString]>;
+                    z: z.ZodUnion<[z.ZodNumber, z.ZodString]>;
+                }, "strip", z.ZodTypeAny, {
                     x: string | number;
                     y: string | number;
                     z: string | number;
@@ -539,11 +553,11 @@ declare class Resistor extends NormalComponent<typeof resistorProps, PassivePort
                     y: string | number;
                     z: string | number;
                 }>]>>;
-                positionOffset: zod.ZodOptional<zod.ZodObject<{
-                    x: zod.ZodEffects<zod.ZodUnion<[zod.ZodString, zod.ZodNumber]>, number, string | number>;
-                    y: zod.ZodEffects<zod.ZodUnion<[zod.ZodString, zod.ZodNumber]>, number, string | number>;
-                    z: zod.ZodEffects<zod.ZodUnion<[zod.ZodString, zod.ZodNumber]>, number, string | number>;
-                }, "strip", zod.ZodTypeAny, {
+                positionOffset: z.ZodOptional<z.ZodObject<{
+                    x: z.ZodEffects<z.ZodUnion<[z.ZodString, z.ZodNumber]>, number, string | number>;
+                    y: z.ZodEffects<z.ZodUnion<[z.ZodString, z.ZodNumber]>, number, string | number>;
+                    z: z.ZodEffects<z.ZodUnion<[z.ZodString, z.ZodNumber]>, number, string | number>;
+                }, "strip", z.ZodTypeAny, {
                     x: number;
                     y: number;
                     z: number;
@@ -552,11 +566,11 @@ declare class Resistor extends NormalComponent<typeof resistorProps, PassivePort
                     y: string | number;
                     z: string | number;
                 }>>;
-                size: zod.ZodOptional<zod.ZodObject<{
-                    x: zod.ZodEffects<zod.ZodUnion<[zod.ZodString, zod.ZodNumber]>, number, string | number>;
-                    y: zod.ZodEffects<zod.ZodUnion<[zod.ZodString, zod.ZodNumber]>, number, string | number>;
-                    z: zod.ZodEffects<zod.ZodUnion<[zod.ZodString, zod.ZodNumber]>, number, string | number>;
-                }, "strip", zod.ZodTypeAny, {
+                size: z.ZodOptional<z.ZodObject<{
+                    x: z.ZodEffects<z.ZodUnion<[z.ZodString, z.ZodNumber]>, number, string | number>;
+                    y: z.ZodEffects<z.ZodUnion<[z.ZodString, z.ZodNumber]>, number, string | number>;
+                    z: z.ZodEffects<z.ZodUnion<[z.ZodString, z.ZodNumber]>, number, string | number>;
+                }, "strip", z.ZodTypeAny, {
                     x: number;
                     y: number;
                     z: number;
@@ -566,9 +580,9 @@ declare class Resistor extends NormalComponent<typeof resistorProps, PassivePort
                     z: string | number;
                 }>>;
             }, {
-                objUrl: zod.ZodString;
-                mtlUrl: zod.ZodOptional<zod.ZodString>;
-            }>, "strip", zod.ZodTypeAny, {
+                objUrl: z.ZodString;
+                mtlUrl: z.ZodOptional<z.ZodString>;
+            }>, "strip", z.ZodTypeAny, {
                 objUrl: string;
                 rotationOffset?: number | {
                     x: string | number;
@@ -604,12 +618,12 @@ declare class Resistor extends NormalComponent<typeof resistorProps, PassivePort
                     z: string | number;
                 } | undefined;
                 mtlUrl?: string | undefined;
-            }>, zod.ZodObject<zod.objectUtil.extendShape<{
-                rotationOffset: zod.ZodOptional<zod.ZodUnion<[zod.ZodNumber, zod.ZodObject<{
-                    x: zod.ZodUnion<[zod.ZodNumber, zod.ZodString]>;
-                    y: zod.ZodUnion<[zod.ZodNumber, zod.ZodString]>;
-                    z: zod.ZodUnion<[zod.ZodNumber, zod.ZodString]>;
-                }, "strip", zod.ZodTypeAny, {
+            }>, z.ZodObject<z.objectUtil.extendShape<{
+                rotationOffset: z.ZodOptional<z.ZodUnion<[z.ZodNumber, z.ZodObject<{
+                    x: z.ZodUnion<[z.ZodNumber, z.ZodString]>;
+                    y: z.ZodUnion<[z.ZodNumber, z.ZodString]>;
+                    z: z.ZodUnion<[z.ZodNumber, z.ZodString]>;
+                }, "strip", z.ZodTypeAny, {
                     x: string | number;
                     y: string | number;
                     z: string | number;
@@ -618,11 +632,11 @@ declare class Resistor extends NormalComponent<typeof resistorProps, PassivePort
                     y: string | number;
                     z: string | number;
                 }>]>>;
-                positionOffset: zod.ZodOptional<zod.ZodObject<{
-                    x: zod.ZodEffects<zod.ZodUnion<[zod.ZodString, zod.ZodNumber]>, number, string | number>;
-                    y: zod.ZodEffects<zod.ZodUnion<[zod.ZodString, zod.ZodNumber]>, number, string | number>;
-                    z: zod.ZodEffects<zod.ZodUnion<[zod.ZodString, zod.ZodNumber]>, number, string | number>;
-                }, "strip", zod.ZodTypeAny, {
+                positionOffset: z.ZodOptional<z.ZodObject<{
+                    x: z.ZodEffects<z.ZodUnion<[z.ZodString, z.ZodNumber]>, number, string | number>;
+                    y: z.ZodEffects<z.ZodUnion<[z.ZodString, z.ZodNumber]>, number, string | number>;
+                    z: z.ZodEffects<z.ZodUnion<[z.ZodString, z.ZodNumber]>, number, string | number>;
+                }, "strip", z.ZodTypeAny, {
                     x: number;
                     y: number;
                     z: number;
@@ -631,11 +645,11 @@ declare class Resistor extends NormalComponent<typeof resistorProps, PassivePort
                     y: string | number;
                     z: string | number;
                 }>>;
-                size: zod.ZodOptional<zod.ZodObject<{
-                    x: zod.ZodEffects<zod.ZodUnion<[zod.ZodString, zod.ZodNumber]>, number, string | number>;
-                    y: zod.ZodEffects<zod.ZodUnion<[zod.ZodString, zod.ZodNumber]>, number, string | number>;
-                    z: zod.ZodEffects<zod.ZodUnion<[zod.ZodString, zod.ZodNumber]>, number, string | number>;
-                }, "strip", zod.ZodTypeAny, {
+                size: z.ZodOptional<z.ZodObject<{
+                    x: z.ZodEffects<z.ZodUnion<[z.ZodString, z.ZodNumber]>, number, string | number>;
+                    y: z.ZodEffects<z.ZodUnion<[z.ZodString, z.ZodNumber]>, number, string | number>;
+                    z: z.ZodEffects<z.ZodUnion<[z.ZodString, z.ZodNumber]>, number, string | number>;
+                }, "strip", z.ZodTypeAny, {
                     x: number;
                     y: number;
                     z: number;
@@ -645,8 +659,8 @@ declare class Resistor extends NormalComponent<typeof resistorProps, PassivePort
                     z: string | number;
                 }>>;
             }, {
-                jscad: zod.ZodRecord<zod.ZodString, zod.ZodAny>;
-            }>, "strip", zod.ZodTypeAny, {
+                jscad: z.ZodRecord<z.ZodString, z.ZodAny>;
+            }>, "strip", z.ZodTypeAny, {
                 jscad: Record<string, any>;
                 rotationOffset?: number | {
                     x: string | number;
@@ -681,15 +695,15 @@ declare class Resistor extends NormalComponent<typeof resistorProps, PassivePort
                     z: string | number;
                 } | undefined;
             }>]>>;
-            children: zod.ZodOptional<zod.ZodAny>;
-            symbolName: zod.ZodOptional<zod.ZodString>;
+            children: z.ZodOptional<z.ZodAny>;
+            symbolName: z.ZodOptional<z.ZodString>;
         }>, {
-            resistance: zod.ZodEffects<zod.ZodUnion<[zod.ZodString, zod.ZodNumber]>, number, string | number>;
-            pullupFor: zod.ZodOptional<zod.ZodString>;
-            pullupTo: zod.ZodOptional<zod.ZodString>;
-            pulldownFor: zod.ZodOptional<zod.ZodString>;
-            pulldownTo: zod.ZodOptional<zod.ZodString>;
-        }>, "strip", zod.ZodTypeAny, {
+            resistance: z.ZodEffects<z.ZodUnion<[z.ZodString, z.ZodNumber]>, number, string | number>;
+            pullupFor: z.ZodOptional<z.ZodString>;
+            pullupTo: z.ZodOptional<z.ZodString>;
+            pulldownFor: z.ZodOptional<z.ZodString>;
+            pulldownTo: z.ZodOptional<z.ZodString>;
+        }>, "strip", z.ZodTypeAny, {
             name: string;
             resistance: number;
             pcbX?: number | undefined;
@@ -838,6 +852,7 @@ declare class Resistor extends NormalComponent<typeof resistorProps, PassivePort
     };
     pin1: Port;
     pin2: Port;
+    doInitialCreateTracesFromProps(): void;
     doInitialSourceRender(): void;
 }
 
@@ -1249,7 +1264,7 @@ declare class Led extends NormalComponent<typeof ledProps, PolarizedPassivePorts
 }
 
 type PortNames = "1" | "2" | "pin1" | "pin2" | "left" | "right" | "anode" | "cathode";
-declare class Capacitor extends NormalComponent<typeof ledProps, PortNames> {
+declare class Capacitor extends NormalComponent<typeof capacitorProps, PortNames> {
     get config(): {
         zodProps: zod.ZodObject<zod.objectUtil.extendShape<zod.objectUtil.extendShape<zod.objectUtil.extendShape<{
             pcbX: zod.ZodOptional<zod.ZodEffects<zod.ZodUnion<[zod.ZodString, zod.ZodNumber]>, number, string | number>>;
@@ -1647,6 +1662,10 @@ declare class Capacitor extends NormalComponent<typeof ledProps, PortNames> {
         }>;
         sourceFtype: "simple_capacitor";
     };
+    pin1: Port;
+    pin2: Port;
+    doInitialCreateTracesFromProps(): void;
+    doInitialSourceRender(): void;
 }
 
 declare const netProps: z.ZodObject<{
@@ -3340,4 +3359,4 @@ declare global {
     }
 }
 
-export { Board, Capacitor, Chip, Footprint, Group, type IRenderable, Jumper, Led, Net, NormalComponent, PlatedHole, Port, PrimitiveComponent, Project, Renderable, Resistor, SilkscreenPath, SmtPad, Trace, TraceHint };
+export { Board, Capacitor, Chip, Circuit, Footprint, Group, type IRenderable, Jumper, Led, Net, NormalComponent, PlatedHole, Port, PrimitiveComponent, Project, Renderable, Resistor, SilkscreenPath, SmtPad, Trace, TraceHint };

package/dist/index.js

@@ -37,6 +37,7 @@ import "react";
 var orderedRenderPhases = [
   "ReactSubtreesRender",
   // probably going to be removed b/c subtrees should render instantly
+  "CreateTracesFromProps",
   "SourceRender",
   "SourceParentAttachment",
   "PortDiscovery",
@@ -172,6 +173,16 @@ var PrimitiveComponent = class extends Renderable {
   componentName = "";
   lowercaseComponentName = "";
   externallyAddedAliases;
+  /**
+   * An opaque group is a self-contained subcircuit. All the selectors inside
+   * an opaque group are relative to the group. You can have multiple opaque
+   * groups and their selectors will not interact with each other (even if the
+   * components share the same names) unless you explicitly break out some ports
+   */
+  get isOpaqueGroup() {
+    return Boolean(this.props.opaque) || // Implied opaque group for top-level group
+    this.lowercaseComponentName === "group" && this?.parent?.props?.name === "$root";
+  }
   source_group_id = null;
   source_component_id = null;
   schematic_component_id = null;
@@ -294,6 +305,20 @@ var PrimitiveComponent = class extends Renderable {
     this.childrenPendingRemoval.push(component);
     component.shouldBeRemoved = true;
   }
+  getOpaqueGroupSelector() {
+    const name = this._parsedProps.name;
+    const endPart = name ? `${this.lowercaseComponentName}.${name}` : this.lowercaseComponentName;
+    if (!this.parent) return endPart;
+    if (this.parent.isOpaqueGroup) return endPart;
+    return `${this.parent.getOpaqueGroupSelector()} > ${endPart}`;
+  }
+  getFullPathSelector() {
+    const name = this._parsedProps.name;
+    const endPart = name ? `${this.lowercaseComponentName}.${name}` : this.lowercaseComponentName;
+    const parentSelector = this.parent?.getFullPathSelector?.();
+    if (!parentSelector) return endPart;
+    return `${parentSelector} > ${endPart}`;
+  }
   getNameAndAliases() {
     return [
       this._parsedProps.name,
@@ -322,6 +347,13 @@ var PrimitiveComponent = class extends Renderable {
       return true;
     return false;
   }
+  getOpaqueGroup() {
+    if (this.isOpaqueGroup) return this;
+    const group = this.parent?.getOpaqueGroup();
+    if (!group)
+      throw new Error("Component is not inside an opaque group (no board?)");
+    return group;
+  }
   selectAll(selector) {
     const parts = selector.trim().split(/\s+/);
     let results = [this];
@@ -1210,6 +1242,9 @@ import { boardProps } from "@tscircuit/props";
 import { identity as identity3 } from "transformation-matrix";
 var Board = class extends NormalComponent {
   pcb_board_id = null;
+  get isOpaqueGroup() {
+    return true;
+  }
   get config() {
     return {
       zodProps: boardProps
@@ -1241,82 +1276,7 @@ var Board = class extends NormalComponent {
 
 // lib/components/normal-components/Resistor.ts
 import { resistorProps } from "@tscircuit/props";
-var Resistor = class extends NormalComponent {
-  get config() {
-    return {
-      schematicSymbolName: "boxresistor",
-      zodProps: resistorProps,
-      sourceFtype: "simple_resistor"
-    };
-  }
-  pin1 = this.portMap.pin1;
-  pin2 = this.portMap.pin2;
-  doInitialSourceRender() {
-    const { db } = this.project;
-    const { _parsedProps: props } = this;
-    const source_component = db.source_component.insert({
-      ftype: "simple_resistor",
-      name: props.name,
-      // @ts-ignore
-      manufacturer_part_number: props.manufacturerPartNumber ?? props.mfn,
-      supplier_part_numbers: props.supplierPartNumbers,
-      resistance: props.resistance
-    });
-    this.source_component_id = source_component.source_component_id;
-  }
-};
-
-// lib/components/normal-components/Led.ts
-import { ledProps } from "@tscircuit/props";
-var Led = class extends NormalComponent {
-  get config() {
-    return {
-      schematicSymbolName: "led",
-      zodProps: ledProps,
-      sourceFtype: "simple_diode"
-    };
-  }
-  pos = this.portMap.pin1;
-  pin1 = this.portMap.pin1;
-  anode = this.portMap.pin1;
-  neg = this.portMap.pin2;
-  pin2 = this.portMap.pin2;
-  cathode = this.portMap.pin2;
-};
-
-// lib/components/normal-components/Capacitor.ts
-import { ledProps as ledProps2 } from "@tscircuit/props";
-
-// lib/utils/constants.ts
-var stringProxy = new Proxy(
-  {},
-  {
-    get: (target, prop) => prop
-  }
-);
-var FTYPE = stringProxy;
-
-// lib/components/normal-components/Capacitor.ts
-var Capacitor = class extends NormalComponent {
-  get config() {
-    return {
-      // schematicSymbolName: BASE_SYMBOLS.capacitor,
-      zodProps: ledProps2,
-      sourceFtype: FTYPE.simple_capacitor
-    };
-  }
-};
-
-// lib/components/primitive-components/Net.ts
-import { z as z4 } from "zod";
-var netProps = z4.object({
-  name: z4.string()
-});
-var Net = class extends PrimitiveComponent {
-  getPortSelector() {
-    return `net.${this.props.name}`;
-  }
-};
+import "zod";
 
 // lib/components/primitive-components/Trace.ts
 import { traceProps } from "@tscircuit/props";
@@ -1495,18 +1455,20 @@ var Trace = class extends PrimitiveComponent {
     const portSelectors = this.getTracePortPathSelectors();
     const ports = portSelectors.map((selector) => ({
       selector,
-      port: parent.selectOne(selector, { type: "port" })
+      port: this.getOpaqueGroup().selectOne(selector, { type: "port" }) ?? null
     }));
     for (const { selector, port } of ports) {
       if (!port) {
         const parentSelector = selector.replace(/\>.*$/, "");
-        const targetComponent = parent.selectOne(parentSelector);
+        const targetComponent = this.getOpaqueGroup().selectOne(parentSelector);
         if (!targetComponent) {
           this.renderError(`Could not find port for selector "${selector}"`);
         } else {
           this.renderError(
             `Could not find port for selector "${selector}"
-searched component ${targetComponent.getString()}, which has ports:${targetComponent.children.filter((c) => c.componentName === "Port").map((c) => `  ${c.getString()}`).join("\n")}`
+searched component ${targetComponent.getString()}, which has ports: ${targetComponent.children.filter((c) => c.componentName === "Port").map(
+              (c) => `${c.getString()}(${c.getNameAndAliases().join(",")})`
+            ).join(" & ")}`
           );
         }
       }
@@ -1558,6 +1520,12 @@ searched component ${targetComponent.getString()}, which has ports:${targetCompo
     if (pcbRouteHints.length === 0) {
       const { solution } = autoroute(pcbElements.concat([source_trace]));
       const inputPcbTrace = solution[0];
+      if (!inputPcbTrace) {
+        console.log(
+          `Failed to find route ffrom ${ports[0].port} to ${ports[1].port} render error!`
+        );
+        return;
+      }
       const pcb_trace2 = db.pcb_trace.insert(inputPcbTrace);
       this.pcb_trace_id = pcb_trace2.pcb_trace_id;
       return;
@@ -1692,6 +1660,131 @@ searched component ${targetComponent.getString()}, which has ports:${targetCompo
   }
 };
 
+// lib/components/normal-components/Resistor.ts
+var Resistor = class extends NormalComponent {
+  get config() {
+    return {
+      schematicSymbolName: "boxresistor",
+      zodProps: resistorProps,
+      sourceFtype: "simple_resistor"
+    };
+  }
+  pin1 = this.portMap.pin1;
+  pin2 = this.portMap.pin2;
+  doInitialCreateTracesFromProps() {
+    if (this.props.pullupFor && this.props.pullupTo) {
+      this.add(
+        new Trace({
+          from: `${this.getOpaqueGroupSelector()} > port.1`,
+          to: this.props.pullupFor
+        })
+      );
+      this.add(
+        new Trace({
+          from: `${this.getOpaqueGroupSelector()} > port.2`,
+          to: this.props.pullupTo
+        })
+      );
+    }
+  }
+  doInitialSourceRender() {
+    const { db } = this.project;
+    const { _parsedProps: props } = this;
+    const source_component = db.source_component.insert({
+      ftype: "simple_resistor",
+      name: props.name,
+      // @ts-ignore
+      manufacturer_part_number: props.manufacturerPartNumber ?? props.mfn,
+      supplier_part_numbers: props.supplierPartNumbers,
+      resistance: props.resistance
+    });
+    this.source_component_id = source_component.source_component_id;
+  }
+};
+
+// lib/components/normal-components/Led.ts
+import { ledProps } from "@tscircuit/props";
+var Led = class extends NormalComponent {
+  get config() {
+    return {
+      schematicSymbolName: "led",
+      zodProps: ledProps,
+      sourceFtype: "simple_diode"
+    };
+  }
+  pos = this.portMap.pin1;
+  pin1 = this.portMap.pin1;
+  anode = this.portMap.pin1;
+  neg = this.portMap.pin2;
+  pin2 = this.portMap.pin2;
+  cathode = this.portMap.pin2;
+};
+
+// lib/components/normal-components/Capacitor.ts
+import { ledProps as ledProps2 } from "@tscircuit/props";
+
+// lib/utils/constants.ts
+var stringProxy = new Proxy(
+  {},
+  {
+    get: (target, prop) => prop
+  }
+);
+var FTYPE = stringProxy;
+
+// lib/components/normal-components/Capacitor.ts
+var Capacitor = class extends NormalComponent {
+  get config() {
+    return {
+      // schematicSymbolName: BASE_SYMBOLS.capacitor,
+      zodProps: ledProps2,
+      sourceFtype: FTYPE.simple_capacitor
+    };
+  }
+  pin1 = this.portMap.pin1;
+  pin2 = this.portMap.pin2;
+  doInitialCreateTracesFromProps() {
+    if (this.props.decouplingFor && this.props.decouplingTo) {
+      this.add(
+        new Trace({
+          from: `${this.getOpaqueGroupSelector()} > port.1`,
+          to: this.props.decouplingFor
+        })
+      );
+      this.add(
+        new Trace({
+          from: `${this.getOpaqueGroupSelector()} > port.2`,
+          to: this.props.decouplingTo
+        })
+      );
+    }
+  }
+  doInitialSourceRender() {
+    const { db } = this.project;
+    const { _parsedProps: props } = this;
+    const source_component = db.source_component.insert({
+      ftype: "simple_capacitor",
+      name: props.name,
+      // @ts-ignore
+      manufacturer_part_number: props.manufacturerPartNumber ?? props.mfn,
+      supplier_part_numbers: props.supplierPartNumbers,
+      capacitance: props.capacitance
+    });
+    this.source_component_id = source_component.source_component_id;
+  }
+};
+
+// lib/components/primitive-components/Net.ts
+import { z as z5 } from "zod";
+var netProps = z5.object({
+  name: z5.string()
+});
+var Net = class extends PrimitiveComponent {
+  getPortSelector() {
+    return `net.${this.props.name}`;
+  }
+};
+
 // lib/components/primitive-components/TraceHint.ts
 import "@tscircuit/props";
 import { applyToPoint as applyToPoint4 } from "transformation-matrix";
@@ -2176,7 +2269,7 @@ var Jumper = class extends NormalComponent {
 import { su } from "@tscircuit/soup-util";
 import { isValidElement as isValidElement2 } from "react";
 import { identity as identity5 } from "transformation-matrix";
-var Project = class {
+var Circuit = class {
   rootComponent = null;
   children;
   db;
@@ -2256,10 +2349,11 @@ var Project = class {
   selectAll(selector) {
     return this.rootComponent?.selectAll(selector) ?? [];
   }
-  selectOne(selector) {
-    return this.rootComponent?.selectOne(selector) ?? null;
+  selectOne(selector, opts) {
+    return this.rootComponent?.selectOne(selector, opts) ?? null;
   }
 };
+var Project = Circuit;
 
 // lib/register-catalogue.ts
 extendCatalogue(components_exports);
@@ -2270,6 +2364,7 @@ export {
   Board,
   Capacitor,
   Chip,
+  Circuit,
   Footprint,
   Group,
   Jumper,

package/lib/Project.ts

@@ -6,7 +6,7 @@ import { isValidElement, type ReactElement } from "react"
 import { createInstanceFromReactElement } from "./fiber/create-instance-from-react-element"
 import { identity, type Matrix } from "transformation-matrix"
 
-export class Project {
+export class Circuit {
   rootComponent: PrimitiveComponent | null = null
   children: PrimitiveComponent[]
   db: SoupUtilObjects
@@ -115,7 +115,12 @@ export class Project {
     return this.rootComponent?.selectAll(selector) ?? []
   }
 
-  selectOne(selector: string): PrimitiveComponent | null {
-    return this.rootComponent?.selectOne(selector) ?? null
+  selectOne(
+    selector: string,
+    opts: { type?: "component" | "port" },
+  ): PrimitiveComponent | null {
+    return this.rootComponent?.selectOne(selector, opts) ?? null
   }
 }
+
+export const Project = Circuit

package/lib/components/base-components/PrimitiveComponent.ts

@@ -1,5 +1,5 @@
 import type { AnySoupElement, AnySourceComponent } from "@tscircuit/soup"
-import type { Project } from "../../Project"
+import type { Circuit } from "../../Project"
 import type { ZodType } from "zod"
 import { z } from "zod"
 import { symbols, type SchSymbol, type BaseSymbolName } from "schematic-symbols"
@@ -40,7 +40,7 @@ export abstract class PrimitiveComponent<
     }
   }
 
-  project: Project | null = null
+  project: Circuit | null = null
   props: z.input<ZodProps>
   _parsedProps: z.infer<ZodProps>
 
@@ -49,6 +49,21 @@ export abstract class PrimitiveComponent<
 
   externallyAddedAliases: string[]
 
+  /**
+   * An opaque group is a self-contained subcircuit. All the selectors inside
+   * an opaque group are relative to the group. You can have multiple opaque
+   * groups and their selectors will not interact with each other (even if the
+   * components share the same names) unless you explicitly break out some ports
+   */
+  get isOpaqueGroup() {
+    return (
+      Boolean(this.props.opaque) ||
+      // Implied opaque group for top-level group
+      (this.lowercaseComponentName === "group" &&
+        this?.parent?.props?.name === "$root")
+    )
+  }
+
   source_group_id: string | null = null
   source_component_id: string | null = null
   schematic_component_id: string | null = null
@@ -70,7 +85,7 @@ export abstract class PrimitiveComponent<
     }
   }
 
-  setProject(project: Project) {
+  setProject(project: Circuit) {
     this.project = project
     for (const c of this.children) {
       c.setProject(project)
@@ -197,6 +212,27 @@ export abstract class PrimitiveComponent<
     component.shouldBeRemoved = true
   }
 
+  getOpaqueGroupSelector(): string {
+    const name = this._parsedProps.name
+    const endPart = name
+      ? `${this.lowercaseComponentName}.${name}`
+      : this.lowercaseComponentName
+
+    if (!this.parent) return endPart
+    if (this.parent.isOpaqueGroup) return endPart
+    return `${this.parent.getOpaqueGroupSelector()} > ${endPart}`
+  }
+
+  getFullPathSelector(): string {
+    const name = this._parsedProps.name
+    const endPart = name
+      ? `${this.lowercaseComponentName}.${name}`
+      : this.lowercaseComponentName
+    const parentSelector = this.parent?.getFullPathSelector?.()
+    if (!parentSelector) return endPart
+    return `${parentSelector} > ${endPart}`
+  }
+
   getNameAndAliases(): string[] {
     return [
       this._parsedProps.name,
@@ -230,6 +266,14 @@ export abstract class PrimitiveComponent<
     return false
   }
 
+  getOpaqueGroup(): PrimitiveComponent {
+    if (this.isOpaqueGroup) return this
+    const group = this.parent?.getOpaqueGroup()
+    if (!group)
+      throw new Error("Component is not inside an opaque group (no board?)")
+    return group
+  }
+
   selectAll(selector: string): PrimitiveComponent[] {
     const parts = selector.trim().split(/\s+/)
     let results: PrimitiveComponent[] = [this]

package/lib/components/base-components/Renderable.ts

@@ -3,6 +3,7 @@ import { Component, createElement, type ReactElement } from "react"
 
 export const orderedRenderPhases = [
   "ReactSubtreesRender", // probably going to be removed b/c subtrees should render instantly
+  "CreateTracesFromProps",
   "SourceRender",
   "SourceParentAttachment",
   "PortDiscovery", // probably going to be removed b/c port discovery can always be done on prop change

package/lib/components/normal-components/Board.ts

@@ -6,6 +6,10 @@ import { identity, type Matrix } from "transformation-matrix"
 export class Board extends NormalComponent<typeof boardProps> {
   pcb_board_id: string | null = null
 
+  get isOpaqueGroup() {
+    return true
+  }
+
   get config() {
     return {
       zodProps: boardProps,

package/lib/components/normal-components/Capacitor.ts

@@ -1,7 +1,8 @@
-import { ledProps } from "@tscircuit/props"
-import { PrimitiveComponent } from "../base-components/PrimitiveComponent"
+import { capacitorProps, ledProps } from "@tscircuit/props"
 import { FTYPE, SYMBOL } from "lib/utils/constants"
 import { NormalComponent } from "../base-components/NormalComponent"
+import type { capacitance, SourceSimpleCapacitorInput } from "@tscircuit/soup"
+import { Trace } from "../primitive-components/Trace"
 
 type PortNames =
   | "1"
@@ -13,7 +14,10 @@ type PortNames =
   | "anode"
   | "cathode"
 
-export class Capacitor extends NormalComponent<typeof ledProps, PortNames> {
+export class Capacitor extends NormalComponent<
+  typeof capacitorProps,
+  PortNames
+> {
   get config() {
     return {
       // schematicSymbolName: BASE_SYMBOLS.capacitor,
@@ -21,4 +25,39 @@ export class Capacitor extends NormalComponent<typeof ledProps, PortNames> {
       sourceFtype: FTYPE.simple_capacitor,
     }
   }
+
+  pin1 = this.portMap.pin1
+  pin2 = this.portMap.pin2
+
+  doInitialCreateTracesFromProps() {
+    if (this.props.decouplingFor && this.props.decouplingTo) {
+      this.add(
+        new Trace({
+          from: `${this.getOpaqueGroupSelector()} > port.1`,
+          to: this.props.decouplingFor,
+        }),
+      )
+      this.add(
+        new Trace({
+          from: `${this.getOpaqueGroupSelector()} > port.2`,
+          to: this.props.decouplingTo,
+        }),
+      )
+    }
+  }
+
+  doInitialSourceRender() {
+    const { db } = this.project!
+    const { _parsedProps: props } = this
+    const source_component = db.source_component.insert({
+      ftype: "simple_capacitor",
+      name: props.name,
+      // @ts-ignore
+      manufacturer_part_number: props.manufacturerPartNumber ?? props.mfn,
+      supplier_part_numbers: props.supplierPartNumbers,
+
+      capacitance: props.capacitance,
+    } as SourceSimpleCapacitorInput)
+    this.source_component_id = source_component.source_component_id
+  }
 }

package/lib/components/normal-components/Resistor.ts

@@ -2,6 +2,8 @@ import { resistorProps } from "@tscircuit/props"
 import type { PassivePorts, Ftype, BaseSymbolName } from "lib/utils/constants"
 import { NormalComponent } from "../base-components/NormalComponent"
 import type { SourceSimpleResistorInput } from "@tscircuit/soup"
+import { z } from "zod"
+import { Trace } from "../primitive-components/Trace"
 
 export class Resistor extends NormalComponent<
   typeof resistorProps,
@@ -18,6 +20,22 @@ export class Resistor extends NormalComponent<
   pin1 = this.portMap.pin1
   pin2 = this.portMap.pin2
 
+  doInitialCreateTracesFromProps() {
+    if (this.props.pullupFor && this.props.pullupTo) {
+      this.add(
+        new Trace({
+          from: `${this.getOpaqueGroupSelector()} > port.1`,
+          to: this.props.pullupFor,
+        }),
+      )
+      this.add(
+        new Trace({
+          from: `${this.getOpaqueGroupSelector()} > port.2`,
+          to: this.props.pullupTo,
+        }),
+      )
+    }
+  }
   doInitialSourceRender() {
     const { db } = this.project!
     const { _parsedProps: props } = this

package/lib/components/primitive-components/Trace.ts

@@ -79,21 +79,25 @@ export class Trace extends PrimitiveComponent<typeof traceProps> {
 
     const ports = portSelectors.map((selector) => ({
       selector,
-      port: parent.selectOne(selector, { type: "port" }) as Port,
+      port:
+        (this.getOpaqueGroup().selectOne(selector, { type: "port" }) as Port) ??
+        null,
     }))
 
     for (const { selector, port } of ports) {
       if (!port) {
         const parentSelector = selector.replace(/\>.*$/, "")
-        const targetComponent = parent.selectOne(parentSelector)
+        const targetComponent = this.getOpaqueGroup().selectOne(parentSelector)
         if (!targetComponent) {
           this.renderError(`Could not find port for selector "${selector}"`)
         } else {
           this.renderError(
-            `Could not find port for selector "${selector}"\nsearched component ${targetComponent.getString()}, which has ports:${targetComponent.children
+            `Could not find port for selector "${selector}"\nsearched component ${targetComponent.getString()}, which has ports: ${targetComponent.children
               .filter((c) => c.componentName === "Port")
-              .map((c) => `  ${c.getString()}`)
-              .join("\n")}`,
+              .map(
+                (c) => `${c.getString()}(${c.getNameAndAliases().join(",")})`,
+              )
+              .join(" & ")}`,
           )
         }
       }
@@ -173,6 +177,14 @@ export class Trace extends PrimitiveComponent<typeof traceProps> {
       const { solution } = autoroute(pcbElements.concat([source_trace]))
       // TODO for some reason, the solution gets duplicated inside ijump-astar
       const inputPcbTrace = solution[0]
+
+      if (!inputPcbTrace) {
+        // TODO render error indicating we could not find a route
+        console.log(
+          `Failed to find route ffrom ${ports[0].port} to ${ports[1].port} render error!`,
+        )
+        return
+      }
       const pcb_trace = db.pcb_trace.insert(inputPcbTrace as any)
 
       this.pcb_trace_id = pcb_trace.pcb_trace_id

package/package.json

@@ -2,7 +2,7 @@
   "name": "@tscircuit/core",
   "module": "index.ts",
   "type": "module",
-  "version": "0.0.19",
+  "version": "0.0.21",
   "types": "dist/index.d.ts",
   "main": "dist/index.js",
   "files": [