@tscircuit/core 0.0.29 → 0.0.31

package/dist/index.js

@@ -10,6 +10,7 @@ __export(components_exports, {
   Board: () => Board,
   Capacitor: () => Capacitor,
   Chip: () => Chip,
+  Constraint: () => Constraint2,
   Footprint: () => Footprint,
   Group: () => Group,
   Jumper: () => Jumper,
@@ -36,13 +37,12 @@ import "react";
 import "react";
 var orderedRenderPhases = [
   "ReactSubtreesRender",
-  // probably going to be removed b/c subtrees should render instantly
+  "InitializePortsFromChildren",
   "CreateNetsFromProps",
   "CreateTracesFromProps",
   "SourceRender",
   "SourceParentAttachment",
   "PortDiscovery",
-  // probably going to be removed b/c port discovery can always be done on prop change
   "PortMatching",
   "SourceTraceRender",
   "SchematicComponentRender",
@@ -50,8 +50,9 @@ var orderedRenderPhases = [
   "SchematicPortRender",
   "SchematicTraceRender",
   "PcbComponentRender",
-  "PcbPortRender",
   "PcbPrimitiveRender",
+  "PcbFootprintLayout",
+  "PcbPortRender",
   "PcbParentAttachment",
   "PcbLayout",
   "PcbTraceRender",
@@ -169,7 +170,6 @@ var PrimitiveComponent = class extends Renderable {
       zodProps: z.object({}).passthrough()
     };
   }
-  project = null;
   props;
   _parsedProps;
   componentName = "";
@@ -183,8 +183,19 @@ 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;
   }
+  /**
+   * A primitive container is a component that contains one or more ports and
+   * primitive components that are designed to interact.
+   *
+   * For example a resistor contains ports and smtpads that interact, so the
+   * resistor is a primitive container. Inside a primitive container, the ports
+   * and pads are likely to reference each other and look for eachother during
+   * the port matching phase.
+   *
+   */
+  isPrimitiveContainer = false;
   source_group_id = null;
   source_component_id = null;
   schematic_component_id = null;
@@ -204,12 +215,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,
@@ -242,14 +247,14 @@ var PrimitiveComponent = class extends Renderable {
    * components, including this component's translation and rotation.
    *
    * This is used to compute this component's position as well as all children
-   * components positions
+   * components positions before layout is applied
    */
-  computePcbGlobalTransform() {
+  _computePcbGlobalTransformBeforeLayout() {
     const { _parsedProps: props } = this;
     const manualPlacement = this.getSubcircuit()._getManualPlacementForComponent(this);
     if (manualPlacement && this.props.pcbX === void 0 && this.props.pcbY === void 0) {
       return compose(
-        this.parent?.computePcbGlobalTransform() ?? identity(),
+        this.parent?._computePcbGlobalTransformBeforeLayout() ?? identity(),
         compose(
           translate(manualPlacement.x, manualPlacement.y),
           rotate((props.pcbRotation ?? 0) * Math.PI / 180)
@@ -257,10 +262,37 @@ var PrimitiveComponent = class extends Renderable {
       );
     }
     return compose(
-      this.parent?.computePcbGlobalTransform() ?? identity(),
+      this.parent?._computePcbGlobalTransformBeforeLayout() ?? identity(),
       this.computePcbPropsTransform()
     );
   }
+  getPrimitiveContainer() {
+    if (this.isPrimitiveContainer) return this;
+    return this.parent?.getPrimitiveContainer?.() ?? null;
+  }
+  /**
+   * Compute the bounds of this component the circuit json elements associated
+   * with it.
+   */
+  _getCircuitJsonBounds() {
+    return {
+      center: { x: 0, y: 0 },
+      bounds: { left: 0, top: 0, right: 0, bottom: 0 },
+      width: 0,
+      height: 0
+    };
+  }
+  /**
+   * Set the position of this component from the layout solver. This method
+   * should operate using CircuitJson associated with this component, like
+   * _getCircuitJsonBounds it can be called multiple times as different
+   * parents apply layout to their children.
+   */
+  _setPositionFromLayout(newCenter) {
+    throw new Error(
+      `_setPositionFromLayout not implemented for ${this.componentName}`
+    );
+  }
   /**
    * Computes a transformation matrix from the props of this component for
    * schematic components
@@ -301,7 +333,7 @@ var PrimitiveComponent = class extends Renderable {
     for (const position of placementConfig.positions) {
       if (isMatchingSelector(component, position.selector)) {
         const center = applyToPoint(
-          this.computePcbGlobalTransform(),
+          this._computePcbGlobalTransformBeforeLayout(),
           position.center
         );
         return center;
@@ -309,15 +341,20 @@ var PrimitiveComponent = class extends Renderable {
     }
     return null;
   }
-  getGlobalPcbPosition() {
-    return applyToPoint(this.computePcbGlobalTransform(), { x: 0, y: 0 });
+  _getGlobalPcbPositionBeforeLayout() {
+    return applyToPoint(this._computePcbGlobalTransformBeforeLayout(), {
+      x: 0,
+      y: 0
+    });
   }
-  getGlobalSchematicPosition() {
+  _getGlobalSchematicPositionBeforeLayout() {
     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
@@ -469,7 +506,125 @@ var PrimitiveComponent = class extends Renderable {
 };
 
 // lib/components/primitive-components/Footprint.ts
+import * as kiwi from "@lume/kiwi";
+import Debug from "debug";
+var debug = Debug("tscircuit:core:footprint");
 var Footprint = class extends PrimitiveComponent {
+  /**
+   * A footprint is a constrainedlayout, the db elements are adjusted according
+   * to any constraints that are defined.
+   */
+  doInitialPcbFootprintLayout() {
+    const constraints = this.children.filter(
+      (child) => child.componentName === "Constraint"
+    );
+    if (constraints.length === 0) return;
+    const involvedComponents = constraints.flatMap(
+      (constraint) => constraint._getAllReferencedComponents().componentsWithSelectors
+    ).map(({ component, selector }) => ({
+      component,
+      selector,
+      bounds: component._getCircuitJsonBounds()
+    }));
+    function getComponentDetails(selector) {
+      return involvedComponents.find(({ selector: s }) => s === selector);
+    }
+    const solver = new kiwi.Solver();
+    const kVars = {};
+    function getKVar(name) {
+      if (!(name in kVars)) {
+        kVars[name] = new kiwi.Variable(name);
+      }
+      return kVars[name];
+    }
+    for (const { selector, bounds } of involvedComponents) {
+      const kvx = getKVar(`${selector}_x`);
+      const kvy = getKVar(`${selector}_y`);
+      solver.addEditVariable(kvx, kiwi.Strength.weak);
+      solver.addEditVariable(kvy, kiwi.Strength.weak);
+      solver.suggestValue(kvx, bounds.center.x);
+      solver.suggestValue(kvy, bounds.center.y);
+    }
+    for (const constraint of constraints) {
+      const props = constraint._parsedProps;
+      if ("xdist" in props) {
+        const { xdist, left, right, edgeToEdge, centerToCenter } = props;
+        const leftVar = getKVar(`${left}_x`);
+        const rightVar = getKVar(`${right}_x`);
+        const leftBounds = getComponentDetails(left)?.bounds;
+        const rightBounds = getComponentDetails(right)?.bounds;
+        if (centerToCenter) {
+          const expr = new kiwi.Expression(rightVar, [-1, leftVar]);
+          solver.addConstraint(
+            new kiwi.Constraint(
+              expr,
+              kiwi.Operator.Eq,
+              props.xdist,
+              kiwi.Strength.required
+            )
+          );
+        } else if (edgeToEdge) {
+          const expr = new kiwi.Expression(
+            rightVar,
+            rightBounds.width / 2,
+            [-1, leftVar],
+            -leftBounds.width / 2
+          );
+          solver.addConstraint(
+            new kiwi.Constraint(
+              expr,
+              kiwi.Operator.Eq,
+              props.xdist,
+              kiwi.Strength.required
+            )
+          );
+        }
+      }
+      solver.updateVariables();
+      if (debug.enabled) {
+        console.log("Solution to layout constraints:");
+        console.table(
+          Object.entries(kVars).map(([key, kvar]) => ({
+            var: key,
+            val: kvar.value()
+          }))
+        );
+      }
+      const bounds = {
+        left: Infinity,
+        right: -Infinity,
+        top: -Infinity,
+        bottom: Infinity
+      };
+      for (const {
+        selector,
+        bounds: { width, height }
+      } of involvedComponents) {
+        const kvx = getKVar(`${selector}_x`);
+        const kvy = getKVar(`${selector}_y`);
+        const newLeft = kvx.value() - width / 2;
+        const newRight = kvx.value() + width / 2;
+        const newTop = kvy.value() + height / 2;
+        const newBottom = kvy.value() - height / 2;
+        bounds.left = Math.min(bounds.left, newLeft);
+        bounds.right = Math.max(bounds.right, newRight);
+        bounds.top = Math.max(bounds.top, newTop);
+        bounds.bottom = Math.min(bounds.bottom, newBottom);
+      }
+      const globalOffset = {
+        x: -(bounds.right + bounds.left) / 2,
+        y: -(bounds.top + bounds.bottom) / 2
+      };
+      for (const { component, selector } of involvedComponents) {
+        const kvx = getKVar(`${selector}_x`);
+        const kvy = getKVar(`${selector}_y`);
+        component._setPositionFromLayout({
+          x: kvx.value() + globalOffset.x,
+          y: kvy.value() + globalOffset.y
+        });
+      }
+    }
+  }
 };
 
 // lib/components/base-components/NormalComponent.ts
@@ -511,16 +666,16 @@ var Port = class extends PrimitiveComponent {
     super(props);
     this.matchedComponents = [];
   }
-  getGlobalPcbPosition() {
+  _getGlobalPcbPositionBeforeLayout() {
     const matchedPcbElm = this.matchedComponents.find((c) => c.isPcbPrimitive);
     if (!matchedPcbElm) {
       throw new Error(
         `Port ${this} has no matched pcb component, can't get global schematic position`
       );
     }
-    return matchedPcbElm?.getGlobalPcbPosition() ?? { x: 0, y: 0 };
+    return matchedPcbElm?._getGlobalPcbPositionBeforeLayout() ?? { x: 0, y: 0 };
   }
-  getGlobalSchematicPosition() {
+  _getGlobalSchematicPositionBeforeLayout() {
     if (!this.schematicSymbolPortDef) {
       return applyToPoint2(this.parent.computeSchematicGlobalTransform(), {
         x: 0,
@@ -581,7 +736,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 +748,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()})`
@@ -604,13 +759,8 @@ var Port = class extends PrimitiveComponent {
     });
     this.source_component_id = this.parent?.source_component_id;
   }
-  /**
-   * For PcbPorts, we use the parent attachment phase to determine where to place
-   * the pcb_port (prior to this phase, the smtpad/platedhole isn't guaranteed
-   * to exist)
-   */
   doInitialPcbPortRender() {
-    const { db } = this.project;
+    const { db } = this.root;
     const { matchedComponents } = this;
     if (!this.parent?.pcb_component_id) {
       throw new Error(
@@ -625,26 +775,26 @@ var Port = class extends PrimitiveComponent {
       );
     }
     const pcbMatch = pcbMatches[0];
-    if ("getGlobalPcbPosition" in pcbMatch) {
+    if ("_getCircuitJsonBounds" in pcbMatch) {
       const pcb_port = db.pcb_port.insert({
         pcb_component_id: this.parent?.pcb_component_id,
         layers: ["top"],
-        ...pcbMatch.getGlobalPcbPosition(),
+        ...pcbMatch._getCircuitJsonBounds().center,
         source_port_id: this.source_port_id
       });
       this.pcb_port_id = pcb_port.pcb_port_id;
     } else {
       throw new Error(
-        `${pcbMatch.getString()} does not have a getGlobalPcbPosition method (needed for pcb_port placement)`
+        `${pcbMatch.getString()} does not have a _getGlobalPcbPositionBeforeLayout method (needed for pcb_port placement)`
       );
     }
   }
   doInitialSchematicPortRender() {
-    const { db } = this.project;
+    const { db } = this.root;
     const { _parsedProps: props } = this;
     if (!this.parent) return;
-    const center = this.getGlobalSchematicPosition();
-    const parentCenter = this.parent?.getGlobalSchematicPosition();
+    const center = this._getGlobalSchematicPositionBeforeLayout();
+    const parentCenter = this.parent?._getGlobalSchematicPositionBeforeLayout();
     this.facingDirection = getRelativeDirection(parentCenter, center);
     const schematic_port = db.schematic_port.insert({
       schematic_component_id: this.parent?.schematic_component_id,
@@ -856,8 +1006,8 @@ var SmtPad = class extends PrimitiveComponent {
     );
   }
   doInitialPortMatching() {
-    const parentPorts = (this.parent?.children ?? []).filter(
-      (c) => c.componentName === "Port"
+    const parentPorts = this.getPrimitiveContainer()?.selectAll(
+      "port"
     );
     if (!this.props.portHints) {
       return;
@@ -871,11 +1021,13 @@ 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();
-    const decomposedMat = decomposeTSR(this.computePcbGlobalTransform());
+    const position = this._getGlobalPcbPositionBeforeLayout();
+    const decomposedMat = decomposeTSR(
+      this._computePcbGlobalTransformBeforeLayout()
+    );
     const isRotated90 = Math.abs(decomposedMat.rotation.angle * (180 / Math.PI) - 90) < 0.01;
     let pcb_smtpad = null;
     if (props.shape === "circle") {
@@ -906,6 +1058,46 @@ var SmtPad = class extends PrimitiveComponent {
       this.pcb_smtpad_id = pcb_smtpad.pcb_smtpad_id;
     }
   }
+  _getCircuitJsonBounds() {
+    const { db } = this.root;
+    const smtpad = db.pcb_smtpad.get(this.pcb_smtpad_id);
+    if (smtpad.shape === "rect") {
+      return {
+        center: { x: smtpad.x, y: smtpad.y },
+        bounds: {
+          left: smtpad.x - smtpad.width / 2,
+          top: smtpad.y - smtpad.height / 2,
+          right: smtpad.x + smtpad.width / 2,
+          bottom: smtpad.y + smtpad.height / 2
+        },
+        width: smtpad.width,
+        height: smtpad.height
+      };
+    }
+    if (smtpad.shape === "circle") {
+      return {
+        center: { x: smtpad.x, y: smtpad.y },
+        bounds: {
+          left: smtpad.x - smtpad.radius,
+          top: smtpad.y - smtpad.radius,
+          right: smtpad.x + smtpad.radius,
+          bottom: smtpad.y + smtpad.radius
+        },
+        width: smtpad.radius * 2,
+        height: smtpad.radius * 2
+      };
+    }
+    throw new Error(
+      `circuitJson bounds calculation not implemented for shape "${smtpad.shape}"`
+    );
+  }
+  _setPositionFromLayout(newCenter) {
+    const { db } = this.root;
+    db.pcb_smtpad.update(this.pcb_smtpad_id, {
+      x: newCenter.x,
+      y: newCenter.y
+    });
+  }
 };
 
 // lib/components/primitive-components/SilkscreenPath.ts
@@ -919,7 +1111,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") {
@@ -927,7 +1119,7 @@ var SilkscreenPath = class extends PrimitiveComponent {
         `Invalid layer "${layer}" for SilkscreenPath. Must be "top" or "bottom".`
       );
     }
-    const transform = this.computePcbGlobalTransform();
+    const transform = this._computePcbGlobalTransformBeforeLayout();
     const pcb_silkscreen_path = db.pcb_silkscreen_path.insert({
       pcb_component_id: this.parent?.pcb_component_id,
       layer,
@@ -987,10 +1179,10 @@ 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();
+    const position = this._getGlobalPcbPositionBeforeLayout();
     if (props.shape === "circle") {
       const plated_hole_input = {
         pcb_component_id: this.parent?.pcb_component_id,
@@ -1085,7 +1277,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 +1326,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
@@ -1158,10 +1350,10 @@ var Net = class extends PrimitiveComponent {
     const islandPairs = pairs(islands);
     for (const [A, B] of islandPairs) {
       const Apositions = A.ports.map(
-        (port) => port.getGlobalPcbPosition()
+        (port) => port._getGlobalPcbPositionBeforeLayout()
       );
       const Bpositions = B.ports.map(
-        (port) => port.getGlobalPcbPosition()
+        (port) => port._getGlobalPcbPositionBeforeLayout()
       );
       let closestDist = Infinity;
       let closestPair = [-1, -1];
@@ -1219,6 +1411,7 @@ var createNetsFromProps = (component, props) => {
 // lib/components/base-components/NormalComponent.ts
 var NormalComponent = class extends PrimitiveComponent {
   reactSubtrees = [];
+  isPrimitiveContainer = true;
   constructor(props) {
     super(props);
     this._addChildrenFromStringFootprint();
@@ -1240,6 +1433,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 +1441,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 +1503,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 +1520,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,10 +1539,10 @@ 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(),
+      center: this._getGlobalPcbPositionBeforeLayout(),
       // width/height are computed in the PcbComponentSizeCalculation phase
       width: 0,
       height: 0,
@@ -1360,7 +1558,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;
@@ -1368,7 +1566,7 @@ var NormalComponent = class extends PrimitiveComponent {
     let maxY = -Infinity;
     for (const child of this.children) {
       if (child.isPcbPrimitive) {
-        const { x, y } = child.getGlobalPcbPosition();
+        const { x, y } = child._getGlobalPcbPositionBeforeLayout();
         const { width: width2, height: height2 } = child.getPcbSize();
         minX = Math.min(minX, x - width2 / 2);
         minY = Math.min(minY, y - height2 / 2);
@@ -1389,6 +1587,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 +1599,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 +1618,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 +1659,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 +1756,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,12 +1769,12 @@ 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;
   }
-  computePcbGlobalTransform() {
+  _computePcbGlobalTransformBeforeLayout() {
     return identity4();
   }
 };
@@ -1685,8 +1915,8 @@ var mergeRoutes = (routes) => {
 
 // lib/utils/getClosest.ts
 var getDistance = (a, b) => {
-  const aPos = "getGlobalPcbPosition" in a ? a.getGlobalPcbPosition() : a;
-  const bPos = "getGlobalPcbPosition" in b ? b.getGlobalPcbPosition() : b;
+  const aPos = "_getGlobalPcbPositionBeforeLayout" in a ? a._getGlobalPcbPositionBeforeLayout() : a;
+  const bPos = "_getGlobalPcbPositionBeforeLayout" in b ? b._getGlobalPcbPositionBeforeLayout() : b;
   return Math.sqrt((aPos.x - bPos.x) ** 2 + (aPos.y - bPos.y) ** 2);
 };
 function getClosest(point, candidates) {
@@ -1707,7 +1937,7 @@ function getClosest(point, candidates) {
 // lib/components/primitive-components/Trace.ts
 import "zod";
 var portToObjective = (port) => {
-  const portPosition = port.getGlobalPcbPosition();
+  const portPosition = port._getGlobalPcbPositionBeforeLayout();
   return {
     ...portPosition,
     layers: port.getAvailablePcbLayers()
@@ -1752,7 +1982,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 +2066,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 +2082,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 +2163,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 +2229,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();
@@ -2023,7 +2253,7 @@ searched component ${targetComponent.getString()}, which has ports: ${targetComp
     for (const { port } of ports) {
       connection.pointsToConnect.push(
         projectPointInDirection(
-          port.getGlobalSchematicPosition(),
+          port._getGlobalSchematicPositionBeforeLayout(),
           port.facingDirection,
           0.1501
         )
@@ -2093,7 +2323,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 +2401,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 +2421,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") {
@@ -2218,7 +2448,7 @@ var TraceHint = class extends PrimitiveComponent {
     const { _parsedProps: props } = this;
     const offsets = props.offset ? [props.offset] : props.offsets;
     if (!offsets) return [];
-    const globalTransform = this.computePcbGlobalTransform();
+    const globalTransform = this._computePcbGlobalTransformBeforeLayout();
     return offsets.map(
       (offset) => ({
         ...applyToPoint4(globalTransform, offset),
@@ -2522,7 +2752,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 +2763,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 +2795,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 +2821,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 +2833,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 +2868,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 },
@@ -2654,18 +2884,58 @@ var Jumper = class extends NormalComponent {
   }
 };
 
+// lib/components/primitive-components/Constraint.ts
+import { constraintProps } from "@tscircuit/props";
+import "zod";
+var Constraint2 = class extends PrimitiveComponent {
+  get config() {
+    return {
+      zodProps: constraintProps
+    };
+  }
+  constructor(props) {
+    super(props);
+    if ("xdist" in props || "ydist" in props) {
+      if (!("edgeToEdge" in props) && !("centerToCenter" in props)) {
+        throw new Error(
+          "edgeToEdge, centerToCenter (or from*/to* props) must be set for xdist or ydist for <constraint />"
+        );
+      }
+    }
+  }
+  _getAllReferencedComponents() {
+    const componentsWithSelectors = [];
+    for (const key of ["left", "right", "top", "bottom"]) {
+      if (key in this._parsedProps) {
+        const selector = this._parsedProps[key];
+        const component = this.getSubcircuit().selectOne(selector);
+        if (component) {
+          componentsWithSelectors.push({
+            selector,
+            component
+          });
+        }
+      }
+    }
+    return { componentsWithSelectors };
+  }
+};
+
 // lib/Project.ts
 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 +2947,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 +2960,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 +2969,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 +2999,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() {
+  _computePcbGlobalTransformBeforeLayout() {
     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;
@@ -2754,6 +3024,7 @@ export {
   Capacitor,
   Chip,
   Circuit,
+  Constraint2 as Constraint,
   Footprint,
   Group,
   Jumper,