@tscircuit/core 0.0.29 → 0.0.30

package/dist/index.d.ts

@@ -9,9 +9,11 @@ import * as Props from '@tscircuit/props';
 import { traceProps, groupProps, boardProps, footprintProps, smtPadProps, resistorProps, ledProps, capacitorProps, traceHintProps, chipProps, jumperProps, silkscreenPathProps, platedHoleProps } from '@tscircuit/props';
 
 declare class Circuit {
-    rootComponent: PrimitiveComponent | null;
+    firstChild: PrimitiveComponent | null;
     children: PrimitiveComponent[];
     db: SoupUtilObjects;
+    root: Circuit | null;
+    isRoot: boolean;
     _hasRenderedAtleastOnce: boolean;
     constructor();
     add(componentOrElm: PrimitiveComponent | ReactElement): void;
@@ -27,8 +29,8 @@ declare class Circuit {
         previewName: string;
         tscircuitApiKey?: string;
     }): Promise<void>;
-    computeGlobalSchematicTransform(): Matrix;
-    computeGlobalPcbTransform(): Matrix;
+    computeSchematicGlobalTransform(): Matrix;
+    computePcbGlobalTransform(): Matrix;
     selectAll(selector: string): PrimitiveComponent[];
     selectOne(selector: string, opts?: {
         type?: "component" | "port";
@@ -36,7 +38,7 @@ declare class Circuit {
 }
 declare const Project: typeof Circuit;
 
-declare const orderedRenderPhases: readonly ["ReactSubtreesRender", "CreateNetsFromProps", "CreateTracesFromProps", "SourceRender", "SourceParentAttachment", "PortDiscovery", "PortMatching", "SourceTraceRender", "SchematicComponentRender", "SchematicLayout", "SchematicPortRender", "SchematicTraceRender", "PcbComponentRender", "PcbPortRender", "PcbPrimitiveRender", "PcbParentAttachment", "PcbLayout", "PcbTraceRender", "PcbRouteNetIslands", "PcbComponentSizeCalculation", "CadModelRender"];
+declare const orderedRenderPhases: readonly ["ReactSubtreesRender", "InitializePortsFromChildren", "CreateNetsFromProps", "CreateTracesFromProps", "SourceRender", "SourceParentAttachment", "PortDiscovery", "PortMatching", "SourceTraceRender", "SchematicComponentRender", "SchematicLayout", "SchematicPortRender", "SchematicTraceRender", "PcbComponentRender", "PcbPortRender", "PcbPrimitiveRender", "PcbParentAttachment", "PcbLayout", "PcbTraceRender", "PcbRouteNetIslands", "PcbComponentSizeCalculation", "CadModelRender"];
 type RenderPhase = (typeof orderedRenderPhases)[number];
 type RenderPhaseFn<K extends RenderPhase = RenderPhase> = `doInitial${K}` | `update${K}` | `remove${K}`;
 type RenderPhaseStates = Record<RenderPhase, {
@@ -91,7 +93,6 @@ declare abstract class PrimitiveComponent<ZodProps extends ZodType = any> extend
     children: PrimitiveComponent[];
     childrenPendingRemoval: PrimitiveComponent[];
     get config(): BaseComponentConfig;
-    project: Circuit | null;
     props: z.input<ZodProps>;
     _parsedProps: z.infer<ZodProps>;
     componentName: string;
@@ -103,14 +104,13 @@ declare abstract class PrimitiveComponent<ZodProps extends ZodType = any> extend
      * subcircuits 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 isSubcircuit(): boolean;
+    get isSubcircuit(): any;
     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: Circuit): void;
     setProps(props: Partial<z.input<ZodProps>>): void;
     /**
      * Computes a transformation matrix from the props of this component for PCB
@@ -152,6 +152,7 @@ declare abstract class PrimitiveComponent<ZodProps extends ZodType = any> extend
         x: number;
         y: number;
     };
+    get root(): Circuit | null;
     onAddToParent(parent: PrimitiveComponent): void;
     /**
      * Called whenever the props change
@@ -558,7 +559,9 @@ declare class NormalComponent<ZodProps extends ZodType = any, PortNames extends
      */
     doInitialPcbComponentSizeCalculation(): void;
     _renderReactSubtree(element: ReactElement): ReactSubtree;
+    doInitialInitializePortsFromChildren(): void;
     doInitialReactSubtreesRender(): void;
+    _hasExistingPortExactly(port1: Port): boolean;
     add(componentOrElm: PrimitiveComponent | ReactElement): void;
     getPortsFromFootprint(): Port[];
     getPortsFromSchematicSymbol(): Port[];

package/dist/index.js

@@ -37,6 +37,7 @@ import "react";
 var orderedRenderPhases = [
   "ReactSubtreesRender",
   // probably going to be removed b/c subtrees should render instantly
+  "InitializePortsFromChildren",
   "CreateNetsFromProps",
   "CreateTracesFromProps",
   "SourceRender",
@@ -169,7 +170,6 @@ var PrimitiveComponent = class extends Renderable {
       zodProps: z.object({}).passthrough()
     };
   }
-  project = null;
   props;
   _parsedProps;
   componentName = "";
@@ -183,7 +183,7 @@ var PrimitiveComponent = class extends Renderable {
    */
   get isSubcircuit() {
     return Boolean(this.props.subcircuit) || // Implied opaque group for top-level group
-    this.lowercaseComponentName === "group" && this?.parent?.props?.name === "$root";
+    this.lowercaseComponentName === "group" && this?.parent?.isRoot;
   }
   source_group_id = null;
   source_component_id = null;
@@ -204,12 +204,6 @@ var PrimitiveComponent = class extends Renderable {
       this.lowercaseComponentName = this.componentName.toLowerCase();
     }
   }
-  setProject(project) {
-    this.project = project;
-    for (const c of this.children) {
-      c.setProject(project);
-    }
-  }
   setProps(props) {
     const newProps = this.config.zodProps.parse({
       ...this.props,
@@ -315,9 +309,11 @@ var PrimitiveComponent = class extends Renderable {
   getGlobalSchematicPosition() {
     return applyToPoint(this.computeSchematicGlobalTransform(), { x: 0, y: 0 });
   }
+  get root() {
+    return this.parent?.root ?? null;
+  }
   onAddToParent(parent) {
     this.parent = parent;
-    this.project = parent.project;
   }
   /**
    * Called whenever the props change
@@ -581,7 +577,7 @@ var Port = class extends PrimitiveComponent {
     return connectedTraces;
   }
   doInitialSourceRender() {
-    const { db } = this.project;
+    const { db } = this.root;
     const { _parsedProps: props } = this;
     const port_hints = this.getNameAndAliases();
     const source_port = db.source_port.insert({
@@ -593,7 +589,7 @@ var Port = class extends PrimitiveComponent {
     this.source_port_id = source_port.source_port_id;
   }
   doInitialSourceParentAttachment() {
-    const { db } = this.project;
+    const { db } = this.root;
     if (!this.parent?.source_component_id) {
       throw new Error(
         `${this.getString()} has no parent source component (parent: ${this.parent?.getString()})`
@@ -610,7 +606,7 @@ var Port = class extends PrimitiveComponent {
    * to exist)
    */
   doInitialPcbPortRender() {
-    const { db } = this.project;
+    const { db } = this.root;
     const { matchedComponents } = this;
     if (!this.parent?.pcb_component_id) {
       throw new Error(
@@ -640,7 +636,7 @@ var Port = class extends PrimitiveComponent {
     }
   }
   doInitialSchematicPortRender() {
-    const { db } = this.project;
+    const { db } = this.root;
     const { _parsedProps: props } = this;
     if (!this.parent) return;
     const center = this.getGlobalSchematicPosition();
@@ -871,7 +867,7 @@ var SmtPad = class extends PrimitiveComponent {
     }
   }
   doInitialPcbPrimitiveRender() {
-    const { db } = this.project;
+    const { db } = this.root;
     const { _parsedProps: props } = this;
     if (!props.portHints) return;
     const position = this.getGlobalPcbPosition();
@@ -919,7 +915,7 @@ var SilkscreenPath = class extends PrimitiveComponent {
     };
   }
   doInitialPcbPrimitiveRender() {
-    const { db } = this.project;
+    const { db } = this.root;
     const { _parsedProps: props } = this;
     const layer = props.layer ?? "top";
     if (layer !== "top" && layer !== "bottom") {
@@ -987,7 +983,7 @@ var PlatedHole = class extends PrimitiveComponent {
     }
   }
   doInitialPcbPrimitiveRender() {
-    const { db } = this.project;
+    const { db } = this.root;
     const { _parsedProps: props } = this;
     if (!props.portHints) return;
     const position = this.getGlobalPcbPosition();
@@ -1085,7 +1081,7 @@ var Net = class extends PrimitiveComponent {
     return `net.${this.props.name}`;
   }
   doInitialSourceComponentRender() {
-    const { db } = this.project;
+    const { db } = this.root;
     const { _parsedProps: props } = this;
     const net = db.source_net.insert({
       name: props.name,
@@ -1134,7 +1130,7 @@ var Net = class extends PrimitiveComponent {
    * such that the nets are fully connected
    */
   doInitialPcbRouteNetIslands() {
-    const { db } = this.project;
+    const { db } = this.root;
     const { _parsedProps: props } = this;
     const traces = this._getAllDirectlyConnectedTraces().filter(
       (trace) => (trace._portsRoutedOnPcb?.length ?? 0) > 0
@@ -1240,6 +1236,7 @@ var NormalComponent = class extends PrimitiveComponent {
    */
   initPorts() {
     const { config } = this;
+    const portsToCreate = [];
     if (config.schematicSymbolName) {
       const sym = symbols3[`${config.schematicSymbolName}_horz`];
       if (!sym) return;
@@ -1247,27 +1244,31 @@ var NormalComponent = class extends PrimitiveComponent {
         const port = getPortFromHints(symPort.labels);
         if (port) {
           port.schematicSymbolPortDef = symPort;
-          this.add(port);
+          portsToCreate.push(port);
         }
       }
+      this.addAll(portsToCreate);
       return;
     }
     const portsFromFootprint = this.getPortsFromFootprint();
-    this.addAll(portsFromFootprint);
+    portsToCreate.push(...portsFromFootprint);
     const pinLabels = this._parsedProps.pinLabels;
     if (pinLabels) {
       for (let [pinNumber, label] of Object.entries(pinLabels)) {
         pinNumber = pinNumber.replace("pin", "");
-        const port = this.selectOne(`port[pinNumber='${pinNumber}']`);
-        if (!port) {
+        const existingPort = portsToCreate.find(
+          (p) => p._parsedProps.pinNumber === Number(pinNumber)
+        );
+        if (!existingPort) {
           throw new Error(
             `Could not find port for pin number ${pinNumber} in chip ${this.getString()}`
           );
         }
-        port.externallyAddedAliases.push(label);
-        port.props.name = label;
+        existingPort.externallyAddedAliases.push(label);
+        existingPort.props.name = label;
       }
     }
+    this.addAll(portsToCreate);
   }
   _addChildrenFromStringFootprint() {
     const { footprint } = this.props;
@@ -1305,7 +1306,7 @@ var NormalComponent = class extends PrimitiveComponent {
   doInitialSourceRender() {
     const ftype = this.config.sourceFtype;
     if (!ftype) return;
-    const { db } = this.project;
+    const { db } = this.root;
     const { _parsedProps: props } = this;
     const source_component = db.source_component.insert({
       ftype,
@@ -1322,7 +1323,7 @@ var NormalComponent = class extends PrimitiveComponent {
    * You can override this method to do more complicated things.
    */
   doInitialSchematicComponentRender() {
-    const { db } = this.project;
+    const { db } = this.root;
     const { schematicSymbolName } = this.config;
     if (!schematicSymbolName) return;
     const symbol_name = `${this.config.schematicSymbolName}_horz`;
@@ -1341,7 +1342,7 @@ var NormalComponent = class extends PrimitiveComponent {
     this.schematic_component_id = schematic_component2.schematic_component_id;
   }
   doInitialPcbComponentRender() {
-    const { db } = this.project;
+    const { db } = this.root;
     const { _parsedProps: props } = this;
     const pcb_component = db.pcb_component.insert({
       center: this.getGlobalPcbPosition(),
@@ -1360,7 +1361,7 @@ var NormalComponent = class extends PrimitiveComponent {
    */
   doInitialPcbComponentSizeCalculation() {
     if (!this.pcb_component_id) return;
-    const { db } = this.project;
+    const { db } = this.root;
     const { _parsedProps: props } = this;
     let minX = Infinity;
     let minY = Infinity;
@@ -1389,6 +1390,9 @@ var NormalComponent = class extends PrimitiveComponent {
       component: createInstanceFromReactElement(element)
     };
   }
+  doInitialInitializePortsFromChildren() {
+    this.initPorts();
+  }
   doInitialReactSubtreesRender() {
     if (isReactElement2(this.props.footprint)) {
       if (this.reactSubtrees.some((rs) => rs.element === this.props.footprint))
@@ -1398,6 +1402,16 @@ var NormalComponent = class extends PrimitiveComponent {
       this.add(subtree.component);
     }
   }
+  _hasExistingPortExactly(port1) {
+    const existingPorts = this.children.filter(
+      (c) => c.componentName === "Port"
+    );
+    return existingPorts.some((port2) => {
+      const aliases1 = port1.getNameAndAliases();
+      const aliases2 = port2.getNameAndAliases();
+      return aliases1.length === aliases2.length && aliases1.every((alias) => aliases2.includes(alias));
+    });
+  }
   add(componentOrElm) {
     let component;
     if (isReactElement2(componentOrElm)) {
@@ -1407,6 +1421,20 @@ var NormalComponent = class extends PrimitiveComponent {
     } else {
       component = componentOrElm;
     }
+    if (component.componentName === "Port") {
+      if (this._hasExistingPortExactly(component)) return;
+      const existingPorts = this.children.filter(
+        (c) => c.componentName === "Port"
+      );
+      const conflictingPort = existingPorts.find(
+        (p) => p.isMatchingAnyOf(component.getNameAndAliases())
+      );
+      if (conflictingPort) {
+        throw new Error(
+          `Conflicting ports added. Port 1: ${conflictingPort}, Port 2: ${component}`
+        );
+      }
+    }
     super.add(component);
   }
   getPortsFromFootprint() {
@@ -1434,6 +1462,11 @@ var NormalComponent = class extends PrimitiveComponent {
         if (!newPort) continue;
         newPorts2.push(newPort);
       }
+      if (newPorts2.length === 0) {
+        throw new Error(
+          `No ports found in chip ${this} (define a schPortArrangement, a footprint or add portHints to elements of the footprint)`
+        );
+      }
       return newPorts2;
     }
     const newPorts = [];
@@ -1526,7 +1559,7 @@ var Board = class extends Group {
     };
   }
   doInitialPcbComponentRender() {
-    const { db } = this.project;
+    const { db } = this.root;
     const { _parsedProps: props } = this;
     if (!props.width || !props.height) {
       throw new Error("Board width and height or an outline are required");
@@ -1539,7 +1572,7 @@ var Board = class extends Group {
     this.pcb_board_id = pcb_board.pcb_board_id;
   }
   removePcbComponentRender() {
-    const { db } = this.project;
+    const { db } = this.root;
     if (!this.pcb_board_id) return;
     db.pcb_board.delete(this.pcb_board_id);
     this.pcb_board_id = null;
@@ -1752,7 +1785,7 @@ var Trace = class extends PrimitiveComponent {
     );
   }
   _findConnectedPorts() {
-    const { db } = this.project;
+    const { db } = this.root;
     const { _parsedProps: props, parent } = this;
     if (!parent) throw new Error("Trace has no parent");
     const portSelectors = this.getTracePortPathSelectors();
@@ -1836,7 +1869,7 @@ searched component ${targetComponent.getString()}, which has ports: ${targetComp
     createNetsFromProps(this, this.getTracePathNetSelectors());
   }
   doInitialSourceTraceRender() {
-    const { db } = this.project;
+    const { db } = this.root;
     const { _parsedProps: props, parent } = this;
     if (!parent) {
       this.renderError("Trace has no parent");
@@ -1852,7 +1885,7 @@ searched component ${targetComponent.getString()}, which has ports: ${targetComp
     this.source_trace_id = trace.source_trace_id;
   }
   doInitialPcbTraceRender() {
-    const { db } = this.project;
+    const { db } = this.root;
     const { _parsedProps: props, parent } = this;
     if (!parent) throw new Error("Trace has no parent");
     const { allPortsFound, ports } = this._findConnectedPorts();
@@ -1933,7 +1966,7 @@ searched component ${targetComponent.getString()}, which has ports: ${targetComp
         `Could not find a common layer (using hints) for trace ${this.getString()}`
       );
     }
-    const obstacles = getObstaclesFromSoup(this.project.db.toArray());
+    const obstacles = getObstaclesFromSoup(this.root.db.toArray());
     markObstaclesAsConnected(
       obstacles,
       orderedRouteObjectives,
@@ -1999,7 +2032,7 @@ searched component ${targetComponent.getString()}, which has ports: ${targetComp
     this.pcb_trace_id = pcb_trace.pcb_trace_id;
   }
   doInitialSchematicTraceRender() {
-    const { db } = this.project;
+    const { db } = this.root;
     const { _parsedProps: props, parent } = this;
     if (!parent) throw new Error("Trace has no parent");
     const { allPortsFound, portsWithSelectors: ports } = this._findConnectedPorts();
@@ -2093,7 +2126,7 @@ var Resistor = class extends NormalComponent {
     }
   }
   doInitialSourceRender() {
-    const { db } = this.project;
+    const { db } = this.root;
     const { _parsedProps: props } = this;
     const source_component = db.source_component.insert({
       ftype: "simple_resistor",
@@ -2171,7 +2204,7 @@ var Capacitor = class extends NormalComponent {
     }
   }
   doInitialSourceRender() {
-    const { db } = this.project;
+    const { db } = this.root;
     const { _parsedProps: props } = this;
     const source_component = db.source_component.insert({
       ftype: "simple_capacitor",
@@ -2191,7 +2224,7 @@ import { applyToPoint as applyToPoint4 } from "transformation-matrix";
 var TraceHint = class extends PrimitiveComponent {
   matchedPort = null;
   doInitialPortMatching() {
-    const { db } = this.project;
+    const { db } = this.root;
     const { _parsedProps: props, parent } = this;
     if (!parent) return;
     if (parent.componentName === "Trace") {
@@ -2522,7 +2555,7 @@ var Chip = class extends NormalComponent {
     };
   }
   doInitialSourceRender() {
-    const { db } = this.project;
+    const { db } = this.root;
     const { _parsedProps: props } = this;
     const source_component = db.source_component.insert({
       ftype: "simple_chip",
@@ -2533,7 +2566,7 @@ var Chip = class extends NormalComponent {
     this.source_component_id = source_component.source_component_id;
   }
   doInitialSchematicComponentRender() {
-    const { db } = this.project;
+    const { db } = this.root;
     const { _parsedProps: props } = this;
     const ports = this.children.filter((child) => child instanceof Port);
     const pinSpacing = props.schPinSpacing ?? 0.2;
@@ -2565,7 +2598,7 @@ var Chip = class extends NormalComponent {
     this.schematic_component_id = schematic_component2.schematic_component_id;
   }
   doInitialPcbComponentRender() {
-    const { db } = this.project;
+    const { db } = this.root;
     const { _parsedProps: props } = this;
     const pcb_component = db.pcb_component.insert({
       center: { x: props.pcbX ?? 0, y: props.pcbY ?? 0 },
@@ -2591,7 +2624,7 @@ var Jumper = class extends NormalComponent {
     };
   }
   doInitialSourceRender() {
-    const { db } = this.project;
+    const { db } = this.root;
     const { _parsedProps: props } = this;
     const source_component = db.source_component.insert({
       ftype: "simple_chip",
@@ -2603,7 +2636,7 @@ var Jumper = class extends NormalComponent {
     this.source_component_id = source_component.source_component_id;
   }
   doInitialSchematicComponentRender() {
-    const { db } = this.project;
+    const { db } = this.root;
     const { _parsedProps: props } = this;
     const ports = this.children.filter((child) => child instanceof Port);
     const pinSpacing = props.schPinSpacing ?? 0.2;
@@ -2638,7 +2671,7 @@ var Jumper = class extends NormalComponent {
     this.schematic_component_id = schematic_component2.schematic_component_id;
   }
   doInitialPcbComponentRender() {
-    const { db } = this.project;
+    const { db } = this.root;
     const { _parsedProps: props } = this;
     const pcb_component = db.pcb_component.insert({
       center: { x: props.pcbX ?? 0, y: props.pcbY ?? 0 },
@@ -2659,13 +2692,16 @@ import { su } from "@tscircuit/soup-util";
 import { isValidElement as isValidElement2 } from "react";
 import { identity as identity5 } from "transformation-matrix";
 var Circuit = class {
-  rootComponent = null;
+  firstChild = null;
   children;
   db;
+  root = null;
+  isRoot = true;
   _hasRenderedAtleastOnce = false;
   constructor() {
     this.children = [];
     this.db = su([]);
+    this.root = this;
   }
   add(componentOrElm) {
     let component;
@@ -2677,9 +2713,9 @@ var Circuit = class {
     this.children.push(component);
   }
   _guessRootComponent() {
-    if (this.rootComponent) return;
+    if (this.firstChild) return;
     if (this.children.length === 1) {
-      this.rootComponent = this.children[0];
+      this.firstChild = this.children[0];
       return;
     }
     if (this.children.length === 0) {
@@ -2690,7 +2726,7 @@ var Circuit = class {
     if (this.children.length > 0) {
       const board = this.children.find((c) => c.componentName === "Board") ?? null;
       if (board) {
-        this.rootComponent = board;
+        this.firstChild = board;
         return;
       }
     }
@@ -2699,13 +2735,13 @@ var Circuit = class {
     );
   }
   render() {
-    if (!this.rootComponent) {
+    if (!this.firstChild) {
       this._guessRootComponent();
     }
-    const { rootComponent, db } = this;
-    if (!rootComponent) throw new Error("Project has no root component");
-    rootComponent.setProject(this);
-    rootComponent.runRenderCycle();
+    const { firstChild, db } = this;
+    if (!firstChild) throw new Error("Project has no root component");
+    firstChild.parent = this;
+    firstChild.runRenderCycle();
     this._hasRenderedAtleastOnce = true;
   }
   getSoup() {
@@ -2729,17 +2765,17 @@ var Circuit = class {
     const previewOpts = typeof previewNameOrOpts === "object" ? previewNameOrOpts : { previewName: previewNameOrOpts };
     throw new Error("project.preview is not yet implemented");
   }
-  computeGlobalSchematicTransform() {
+  computeSchematicGlobalTransform() {
     return identity5();
   }
-  computeGlobalPcbTransform() {
+  computePcbGlobalTransform() {
     return identity5();
   }
   selectAll(selector) {
-    return this.rootComponent?.selectAll(selector) ?? [];
+    return this.firstChild?.selectAll(selector) ?? [];
   }
   selectOne(selector, opts) {
-    return this.rootComponent?.selectOne(selector, opts) ?? null;
+    return this.firstChild?.selectOne(selector, opts) ?? null;
   }
 };
 var Project = Circuit;

package/lib/Project.ts

@@ -7,15 +7,18 @@ import { createInstanceFromReactElement } from "./fiber/create-instance-from-rea
 import { identity, type Matrix } from "transformation-matrix"
 
 export class Circuit {
-  rootComponent: PrimitiveComponent | null = null
+  firstChild: PrimitiveComponent | null = null
   children: PrimitiveComponent[]
   db: SoupUtilObjects
+  root: Circuit | null = null
+  isRoot = true
 
   _hasRenderedAtleastOnce = false
 
   constructor() {
     this.children = []
     this.db = su([])
+    this.root = this
   }
 
   add(componentOrElm: PrimitiveComponent | ReactElement) {
@@ -30,9 +33,9 @@ export class Circuit {
   }
 
   _guessRootComponent() {
-    if (this.rootComponent) return
+    if (this.firstChild) return
     if (this.children.length === 1) {
-      this.rootComponent = this.children[0]
+      this.firstChild = this.children[0]
       return
     }
     if (this.children.length === 0) {
@@ -46,7 +49,7 @@ export class Circuit {
         this.children.find((c) => c.componentName === "Board") ?? null
 
       if (board) {
-        this.rootComponent = board
+        this.firstChild = board
         return
       }
     }
@@ -56,16 +59,14 @@ export class Circuit {
   }
 
   render() {
-    if (!this.rootComponent) {
+    if (!this.firstChild) {
       this._guessRootComponent()
     }
-    const { rootComponent, db } = this
+    const { firstChild, db } = this
 
-    if (!rootComponent) throw new Error("Project has no root component")
-
-    rootComponent.setProject(this)
-
-    rootComponent.runRenderCycle()
+    if (!firstChild) throw new Error("Project has no root component")
+    firstChild.parent = this as any
+    firstChild.runRenderCycle()
     this._hasRenderedAtleastOnce = true
   }
 
@@ -103,23 +104,23 @@ export class Circuit {
     throw new Error("project.preview is not yet implemented")
   }
 
-  computeGlobalSchematicTransform(): Matrix {
+  computeSchematicGlobalTransform(): Matrix {
     return identity()
   }
 
-  computeGlobalPcbTransform(): Matrix {
+  computePcbGlobalTransform(): Matrix {
     return identity()
   }
 
   selectAll(selector: string): PrimitiveComponent[] {
-    return this.rootComponent?.selectAll(selector) ?? []
+    return this.firstChild?.selectAll(selector) ?? []
   }
 
   selectOne(
     selector: string,
     opts?: { type?: "component" | "port" },
   ): PrimitiveComponent | null {
-    return this.rootComponent?.selectOne(selector, opts) ?? null
+    return this.firstChild?.selectOne(selector, opts) ?? null
   }
 }
 

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

@@ -68,6 +68,7 @@ export class NormalComponent<
    */
   initPorts() {
     const { config } = this
+    const portsToCreate: Port[] = []
     if (config.schematicSymbolName) {
       const sym = symbols[
         `${config.schematicSymbolName}_horz` as keyof typeof symbols
@@ -79,32 +80,36 @@ export class NormalComponent<
 
         if (port) {
           port.schematicSymbolPortDef = symPort
-          this.add(port)
+          portsToCreate.push(port)
         }
       }
 
+      this.addAll(portsToCreate)
       return
     }
 
     const portsFromFootprint = this.getPortsFromFootprint()
-
-    this.addAll(portsFromFootprint)
+    portsToCreate.push(...portsFromFootprint)
 
     const pinLabels: Record<string, string> | undefined =
       this._parsedProps.pinLabels
     if (pinLabels) {
       for (let [pinNumber, label] of Object.entries(pinLabels)) {
         pinNumber = pinNumber.replace("pin", "")
-        const port = this.selectOne(`port[pinNumber='${pinNumber}']`)
-        if (!port) {
+        const existingPort = portsToCreate.find(
+          (p) => p._parsedProps.pinNumber === Number(pinNumber),
+        )
+        if (!existingPort) {
           throw new Error(
             `Could not find port for pin number ${pinNumber} in chip ${this.getString()}`,
           )
         }
-        port.externallyAddedAliases.push(label)
-        port.props.name = label
+        existingPort.externallyAddedAliases.push(label)
+        existingPort.props.name = label
       }
     }
+
+    this.addAll(portsToCreate)
   }
 
   _addChildrenFromStringFootprint() {
@@ -148,7 +153,7 @@ export class NormalComponent<
   doInitialSourceRender() {
     const ftype = this.config.sourceFtype
     if (!ftype) return
-    const { db } = this.project!
+    const { db } = this.root!
     const { _parsedProps: props } = this
     const source_component = db.source_component.insert({
       ftype,
@@ -166,7 +171,7 @@ export class NormalComponent<
    * You can override this method to do more complicated things.
    */
   doInitialSchematicComponentRender() {
-    const { db } = this.project!
+    const { db } = this.root!
     const { schematicSymbolName } = this.config
     if (!schematicSymbolName) return
     // TODO switch between horizontal and vertical based on schRotation
@@ -191,7 +196,7 @@ export class NormalComponent<
   }
 
   doInitialPcbComponentRender() {
-    const { db } = this.project!
+    const { db } = this.root!
     const { _parsedProps: props } = this
     const pcb_component = db.pcb_component.insert({
       center: this.getGlobalPcbPosition(),
@@ -211,7 +216,7 @@ export class NormalComponent<
    */
   doInitialPcbComponentSizeCalculation(): void {
     if (!this.pcb_component_id) return
-    const { db } = this.project!
+    const { db } = this.root!
     const { _parsedProps: props } = this
 
     let minX = Infinity
@@ -246,6 +251,10 @@ export class NormalComponent<
     }
   }
 
+  doInitialInitializePortsFromChildren(): void {
+    this.initPorts()
+  }
+
   doInitialReactSubtreesRender(): void {
     if (isReactElement(this.props.footprint)) {
       if (this.reactSubtrees.some((rs) => rs.element === this.props.footprint))
@@ -256,6 +265,20 @@ export class NormalComponent<
     }
   }
 
+  _hasExistingPortExactly(port1: Port): boolean {
+    const existingPorts = this.children.filter(
+      (c) => c.componentName === "Port",
+    ) as Port[]
+    return existingPorts.some((port2) => {
+      const aliases1 = port1.getNameAndAliases()
+      const aliases2 = port2.getNameAndAliases()
+      return (
+        aliases1.length === aliases2.length &&
+        aliases1.every((alias) => aliases2.includes(alias))
+      )
+    })
+  }
+
   add(componentOrElm: PrimitiveComponent | ReactElement) {
     let component: PrimitiveComponent
     if (isReactElement(componentOrElm)) {
@@ -266,6 +289,23 @@ export class NormalComponent<
       component = componentOrElm as PrimitiveComponent
     }
 
+    if (component.componentName === "Port") {
+      if (this._hasExistingPortExactly(component as Port)) return
+      // Check if this port is already contained in the children, skip if it's
+      // already defined
+      const existingPorts = this.children.filter(
+        (c) => c.componentName === "Port",
+      ) as Port[]
+      const conflictingPort = existingPorts.find((p) =>
+        p.isMatchingAnyOf(component.getNameAndAliases()),
+      )
+      if (conflictingPort) {
+        throw new Error(
+          `Conflicting ports added. Port 1: ${conflictingPort}, Port 2: ${component}`,
+        )
+      }
+    }
+
     super.add(component)
   }
 
@@ -304,6 +344,12 @@ export class NormalComponent<
         newPorts.push(newPort)
       }
 
+      if (newPorts.length === 0) {
+        throw new Error(
+          `No ports found in chip ${this} (define a schPortArrangement, a footprint or add portHints to elements of the footprint)`,
+        )
+      }
+
       return newPorts
     }
 

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

@@ -41,7 +41,6 @@ export abstract class PrimitiveComponent<
     }
   }
 
-  project: Circuit | null = null
   props: z.input<ZodProps>
   _parsedProps: z.infer<ZodProps>
 
@@ -60,8 +59,7 @@ export abstract class PrimitiveComponent<
     return (
       Boolean(this.props.subcircuit) ||
       // Implied opaque group for top-level group
-      (this.lowercaseComponentName === "group" &&
-        this?.parent?.props?.name === "$root")
+      (this.lowercaseComponentName === "group" && (this?.parent as any)?.isRoot)
     )
   }
 
@@ -86,13 +84,6 @@ export abstract class PrimitiveComponent<
     }
   }
 
-  setProject(project: Circuit) {
-    this.project = project
-    for (const c of this.children) {
-      c.setProject(project)
-    }
-  }
-
   setProps(props: Partial<z.input<ZodProps>>) {
     const newProps = this.config.zodProps.parse({
       ...this.props,
@@ -227,9 +218,12 @@ export abstract class PrimitiveComponent<
     return applyToPoint(this.computeSchematicGlobalTransform(), { x: 0, y: 0 })
   }
 
+  get root(): Circuit | null {
+    return this.parent?.root ?? null
+  }
+
   onAddToParent(parent: PrimitiveComponent) {
     this.parent = parent
-    this.project = parent.project
   }
 
   /**

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
+  "InitializePortsFromChildren",
   "CreateNetsFromProps",
   "CreateTracesFromProps",
   "SourceRender",

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

@@ -18,7 +18,7 @@ export class Board extends Group<typeof boardProps> {
   }
 
   doInitialPcbComponentRender(): void {
-    const { db } = this.project!
+    const { db } = this.root!
     const { _parsedProps: props } = this
 
     if (!props.width || !props.height) {
@@ -36,7 +36,7 @@ export class Board extends Group<typeof boardProps> {
   }
 
   removePcbComponentRender(): void {
-    const { db } = this.project!
+    const { db } = this.root!
     if (!this.pcb_board_id) return
     db.pcb_board.delete(this.pcb_board_id!)
     this.pcb_board_id = null

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

@@ -54,7 +54,7 @@ export class Capacitor extends NormalComponent<
   }
 
   doInitialSourceRender() {
-    const { db } = this.project!
+    const { db } = this.root!
     const { _parsedProps: props } = this
     const source_component = db.source_component.insert({
       ftype: "simple_capacitor",

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

@@ -22,7 +22,7 @@ export class Chip<PinLabels extends string = never> extends NormalComponent<
   }
 
   doInitialSourceRender(): void {
-    const { db } = this.project!
+    const { db } = this.root!
     const { _parsedProps: props } = this
 
     const source_component = db.source_component.insert({
@@ -36,7 +36,7 @@ export class Chip<PinLabels extends string = never> extends NormalComponent<
   }
 
   doInitialSchematicComponentRender() {
-    const { db } = this.project!
+    const { db } = this.root!
     const { _parsedProps: props } = this
 
     const ports = this.children.filter((child) => child instanceof Port)
@@ -81,7 +81,7 @@ export class Chip<PinLabels extends string = never> extends NormalComponent<
   }
 
   doInitialPcbComponentRender() {
-    const { db } = this.project!
+    const { db } = this.root!
     const { _parsedProps: props } = this
 
     const pcb_component = db.pcb_component.insert({

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

@@ -22,7 +22,7 @@ export class Jumper<PinLabels extends string = never> extends NormalComponent<
   }
 
   doInitialSourceRender(): void {
-    const { db } = this.project!
+    const { db } = this.root!
     const { _parsedProps: props } = this
 
     const source_component = db.source_component.insert({
@@ -36,7 +36,7 @@ export class Jumper<PinLabels extends string = never> extends NormalComponent<
   }
 
   doInitialSchematicComponentRender() {
-    const { db } = this.project!
+    const { db } = this.root!
     const { _parsedProps: props } = this
 
     const ports = this.children.filter((child) => child instanceof Port)
@@ -84,7 +84,7 @@ export class Jumper<PinLabels extends string = never> extends NormalComponent<
   }
 
   doInitialPcbComponentRender() {
-    const { db } = this.project!
+    const { db } = this.root!
     const { _parsedProps: props } = this
 
     const pcb_component = db.pcb_component.insert({

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

@@ -43,7 +43,7 @@ export class Resistor extends NormalComponent<
   }
 
   doInitialSourceRender() {
-    const { db } = this.project!
+    const { db } = this.root!
     const { _parsedProps: props } = this
     const source_component = db.source_component.insert({
       ftype: "simple_resistor",

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

@@ -18,7 +18,7 @@ export class Net extends PrimitiveComponent<typeof netProps> {
   }
 
   doInitialSourceComponentRender(): void {
-    const { db } = this.project!
+    const { db } = this.root!
     const { _parsedProps: props } = this
 
     const net = db.source_net.insert({
@@ -77,7 +77,7 @@ export class Net extends PrimitiveComponent<typeof netProps> {
    * such that the nets are fully connected
    */
   doInitialPcbRouteNetIslands(): void {
-    const { db } = this.project!
+    const { db } = this.root!
     const { _parsedProps: props } = this
 
     const traces = this._getAllDirectlyConnectedTraces().filter(

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

@@ -46,7 +46,7 @@ export class PlatedHole extends PrimitiveComponent<typeof platedHoleProps> {
   }
 
   doInitialPcbPrimitiveRender(): void {
-    const { db } = this.project!
+    const { db } = this.root!
     const { _parsedProps: props } = this
     if (!props.portHints) return
     const position = this.getGlobalPcbPosition()

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

@@ -116,7 +116,7 @@ export class Port extends PrimitiveComponent<typeof portProps> {
   }
 
   doInitialSourceRender(): void {
-    const { db } = this.project!
+    const { db } = this.root!
     const { _parsedProps: props } = this
 
     const port_hints = this.getNameAndAliases()
@@ -132,7 +132,7 @@ export class Port extends PrimitiveComponent<typeof portProps> {
   }
 
   doInitialSourceParentAttachment(): void {
-    const { db } = this.project!
+    const { db } = this.root!
     if (!this.parent?.source_component_id) {
       throw new Error(
         `${this.getString()} has no parent source component (parent: ${this.parent?.getString()})`,
@@ -152,7 +152,7 @@ export class Port extends PrimitiveComponent<typeof portProps> {
    * to exist)
    */
   doInitialPcbPortRender(): void {
-    const { db } = this.project!
+    const { db } = this.root!
     const { matchedComponents } = this
 
     if (!this.parent?.pcb_component_id) {
@@ -191,7 +191,7 @@ export class Port extends PrimitiveComponent<typeof portProps> {
   }
 
   doInitialSchematicPortRender(): void {
-    const { db } = this.project!
+    const { db } = this.root!
     const { _parsedProps: props } = this
 
     if (!this.parent) return

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

@@ -14,7 +14,7 @@ export class SilkscreenPath extends PrimitiveComponent<
   }
 
   doInitialPcbPrimitiveRender(): void {
-    const { db } = this.project!
+    const { db } = this.root!
     const { _parsedProps: props } = this
 
     const layer = props.layer ?? "top"

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

@@ -50,7 +50,7 @@ export class SmtPad extends PrimitiveComponent<typeof smtPadProps> {
   }
 
   doInitialPcbPrimitiveRender(): void {
-    const { db } = this.project!
+    const { db } = this.root!
     const { _parsedProps: props } = this
     if (!props.portHints) return
     const position = this.getGlobalPcbPosition()

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

@@ -104,7 +104,7 @@ export class Trace extends PrimitiveComponent<typeof traceProps> {
         ports?: undefined
         portsWithSelectors?: undefined
       } {
-    const { db } = this.project!
+    const { db } = this.root!
     const { _parsedProps: props, parent } = this
 
     if (!parent) throw new Error("Trace has no parent")
@@ -215,7 +215,7 @@ export class Trace extends PrimitiveComponent<typeof traceProps> {
   }
 
   doInitialSourceTraceRender(): void {
-    const { db } = this.project!
+    const { db } = this.root!
     const { _parsedProps: props, parent } = this
 
     if (!parent) {
@@ -238,7 +238,7 @@ export class Trace extends PrimitiveComponent<typeof traceProps> {
   }
 
   doInitialPcbTraceRender(): void {
-    const { db } = this.project!
+    const { db } = this.root!
     const { _parsedProps: props, parent } = this
 
     if (!parent) throw new Error("Trace has no parent")
@@ -365,7 +365,7 @@ export class Trace extends PrimitiveComponent<typeof traceProps> {
 
     // Cache the PCB obstacles, they'll be needed for each segment between
     // ports/hints
-    const obstacles = getObstaclesFromSoup(this.project!.db.toArray())
+    const obstacles = getObstaclesFromSoup(this.root!.db.toArray())
     markObstaclesAsConnected(
       obstacles,
       orderedRouteObjectives,
@@ -445,7 +445,7 @@ export class Trace extends PrimitiveComponent<typeof traceProps> {
   }
 
   doInitialSchematicTraceRender(): void {
-    const { db } = this.project!
+    const { db } = this.root!
     const { _parsedProps: props, parent } = this
 
     if (!parent) throw new Error("Trace has no parent")

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

@@ -8,7 +8,7 @@ export class TraceHint extends PrimitiveComponent<typeof traceHintProps> {
   matchedPort: Port | null = null
 
   doInitialPortMatching(): void {
-    const { db } = this.project!
+    const { db } = this.root!
     const { _parsedProps: props, parent } = this
 
     if (!parent) return

package/package.json

@@ -2,7 +2,7 @@
   "name": "@tscircuit/core",
   "module": "index.ts",
   "type": "module",
-  "version": "0.0.29",
+  "version": "0.0.30",
   "types": "dist/index.d.ts",
   "main": "dist/index.js",
   "files": [
@@ -32,7 +32,7 @@
   },
   "dependencies": {
     "@tscircuit/infgrid-ijump-astar": "^0.0.6",
-    "@tscircuit/props": "^0.0.51",
+    "@tscircuit/props": "^0.0.52",
     "@tscircuit/soup": "^0.0.58",
     "@tscircuit/soup-util": "0.0.18",
     "footprinter": "^0.0.44",