@tscircuit/core 0.0.1306 → 0.0.1308

package/dist/index.js

@@ -9170,1617 +9170,1647 @@ var SmtPad = class extends PrimitiveComponent2 {
   }
 };
 
-// lib/components/primitive-components/Symbol/Symbol.ts
-import { symbolProps } from "@tscircuit/props";
-import { compose as compose3, translate as translate2, scale } from "transformation-matrix";
-var SymbolComponent = class extends PrimitiveComponent2 {
-  isPrimitiveContainer = true;
-  schematic_symbol_id;
-  userCoordinateToResizedSymbolTransformMat;
-  schematicSymbolBoundsInUserCoordinates;
+// lib/utils/get-relative-direction.ts
+function getRelativeDirection(pointA, pointB) {
+  const dx = pointB.x - pointA.x;
+  const dy = pointB.y - pointA.y;
+  if (Math.abs(dx) > Math.abs(dy)) {
+    return dx >= 0 ? "right" : "left";
+  }
+  return dy >= 0 ? "up" : "down";
+}
+
+// lib/components/primitive-components/Port/Port.ts
+import "schematic-symbols";
+import { applyToPoint as applyToPoint22, compose as compose3, translate as translate2 } from "transformation-matrix";
+import "zod";
+
+// lib/components/primitive-components/Port/getCenterOfPcbPrimitives.ts
+var getCenterOfPcbPrimitives = (pcbPrimitives) => {
+  if (pcbPrimitives.length === 0) {
+    throw new Error("Cannot get center of empty PCB primitives array");
+  }
+  const positions = pcbPrimitives.map((p) => p._getPcbCircuitJsonBounds().center).filter(Boolean);
+  const sumX = positions.reduce((sum, pos) => sum + pos.x, 0);
+  const sumY = positions.reduce((sum, pos) => sum + pos.y, 0);
+  return {
+    x: sumX / positions.length,
+    y: sumY / positions.length
+  };
+};
+
+// lib/components/primitive-components/Port/Port.ts
+import { portProps } from "@tscircuit/props";
+
+// lib/components/primitive-components/Port/apply-pin-attributes-to-source-port.ts
+var applyPinAttributesToSourcePort = (sourcePortProps, attributes) => {
+  if (attributes.mustBeConnected !== void 0) {
+    sourcePortProps.must_be_connected = attributes.mustBeConnected;
+  }
+  if (attributes.providesPower !== void 0) {
+    sourcePortProps.provides_power = attributes.providesPower;
+  }
+  if (attributes.requiresPower !== void 0) {
+    sourcePortProps.requires_power = attributes.requiresPower;
+  }
+  if (attributes.providesGround !== void 0) {
+    sourcePortProps.provides_ground = attributes.providesGround;
+  }
+  if (attributes.requiresGround !== void 0) {
+    sourcePortProps.requires_ground = attributes.requiresGround;
+  }
+  if (attributes.providesVoltage !== void 0) {
+    sourcePortProps.provides_voltage = attributes.providesVoltage;
+  }
+  if (attributes.requiresVoltage !== void 0) {
+    sourcePortProps.requires_voltage = attributes.requiresVoltage;
+  }
+  if (attributes.doNotConnect !== void 0) {
+    sourcePortProps.do_not_connect = attributes.doNotConnect;
+  }
+  if (attributes.includeInBoardPinout !== void 0) {
+    sourcePortProps.include_in_board_pinout = attributes.includeInBoardPinout;
+  }
+  if (attributes.canUseInternalPullup !== void 0) {
+    sourcePortProps.can_use_internal_pullup = attributes.canUseInternalPullup;
+  }
+  if (attributes.isUsingInternalPullup !== void 0) {
+    sourcePortProps.is_using_internal_pullup = attributes.isUsingInternalPullup;
+  }
+  if (attributes.needsExternalPullup !== void 0) {
+    sourcePortProps.needs_external_pullup = attributes.needsExternalPullup;
+  }
+  if (attributes.canUseInternalPulldown !== void 0) {
+    sourcePortProps.can_use_internal_pulldown = attributes.canUseInternalPulldown;
+  }
+  if (attributes.isUsingInternalPulldown !== void 0) {
+    sourcePortProps.is_using_internal_pulldown = attributes.isUsingInternalPulldown;
+  }
+  if (attributes.needsExternalPulldown !== void 0) {
+    sourcePortProps.needs_external_pulldown = attributes.needsExternalPulldown;
+  }
+  if (attributes.canUseOpenDrain !== void 0) {
+    sourcePortProps.can_use_open_drain = attributes.canUseOpenDrain;
+  }
+  if (attributes.isUsingOpenDrain !== void 0) {
+    sourcePortProps.is_using_open_drain = attributes.isUsingOpenDrain;
+  }
+  if (attributes.canUsePushPull !== void 0) {
+    sourcePortProps.can_use_push_pull = attributes.canUsePushPull;
+  }
+  if (attributes.isUsingPushPull !== void 0) {
+    sourcePortProps.is_using_push_pull = attributes.isUsingPushPull;
+  }
+  if (attributes.shouldHaveDecouplingCapacitor !== void 0) {
+    sourcePortProps.should_have_decoupling_capacitor = attributes.shouldHaveDecouplingCapacitor;
+  }
+  if (attributes.recommendedDecouplingCapacitorCapacitance !== void 0) {
+    sourcePortProps.recommended_decoupling_capacitor_capacitance = attributes.recommendedDecouplingCapacitorCapacitance;
+  }
+};
+
+// lib/components/primitive-components/Port/Port.ts
+var Port = class extends PrimitiveComponent2 {
+  source_port_id = null;
+  pcb_port_id = null;
+  schematic_port_id = null;
+  schematic_stem_line_id = null;
+  schematicSymbolPortDef = null;
+  matchedComponents;
+  _isPrimaryPort = true;
+  _primaryPinNumber = null;
+  facingDirection = null;
+  originDescription = null;
   get config() {
     return {
-      componentName: "Symbol",
-      zodProps: symbolProps
+      componentName: "Port",
+      zodProps: portProps
     };
   }
-  hasExplicitSize() {
-    const { _parsedProps: props } = this;
-    return props.width !== void 0 || props.height !== void 0;
+  constructor(props, opts = {}) {
+    if (!props.name && props.pinNumber !== void 0)
+      props.name = `pin${props.pinNumber}`;
+    if (!props.name) {
+      throw new Error("Port must have a name or a pinNumber");
+    }
+    super(props);
+    if (opts.originDescription) {
+      this.originDescription = opts.originDescription;
+    }
+    this.matchedComponents = [];
   }
-  /**
-   * Create the schematic_symbol element in SymbolContainerRender phase.
-   * This runs before SchematicPrimitiveRender, ensuring children can
-   * reference the schematic_symbol_id when they render.
-   */
-  doInitialSymbolContainerRender() {
-    if (this.root?.schematicDisabled) return;
-    const { db } = this.root;
+  isGroupPort() {
+    return this.parent?.componentName === "Group";
+  }
+  isComponentPort() {
+    return !this.isGroupPort();
+  }
+  _getConnectedPortsFromConnectsTo() {
     const { _parsedProps: props } = this;
-    const parentNormal = this.getParentNormalComponent();
-    const kicadSymbolMetadata = parentNormal?._parsedProps?.kicadSymbolMetadata;
-    const schematic_symbol = db.schematic_symbol.insert({
-      name: props.name,
-      metadata: kicadSymbolMetadata ? { kicad_symbol: kicadSymbolMetadata } : void 0
-    });
-    this.schematic_symbol_id = schematic_symbol.schematic_symbol_id;
+    const connectsTo = props.connectsTo;
+    if (!connectsTo) return [];
+    const connectedPorts = [];
+    const connectsToArray = Array.isArray(connectsTo) ? connectsTo : [connectsTo];
+    for (const connection of connectsToArray) {
+      const port = this.getSubcircuit().selectOne(connection, {
+        type: "port"
+      });
+      if (port) {
+        connectedPorts.push(port);
+      }
+    }
+    return connectedPorts;
   }
-  getSchematicSymbolBounds() {
-    if (this.schematicSymbolBoundsInUserCoordinates) {
-      return this.schematicSymbolBoundsInUserCoordinates;
+  _isBoardPinoutFromAttributes() {
+    const parent = this.parent;
+    if (parent?._parsedProps?.pinAttributes) {
+      const pinAttributes = parent._parsedProps.pinAttributes;
+      for (const alias of this.getNameAndAliases()) {
+        if (pinAttributes[alias]?.includeInBoardPinout) {
+          return true;
+        }
+      }
     }
-    this._computeSchematicSymbolBounds();
-    return this.schematicSymbolBoundsInUserCoordinates ?? null;
   }
-  getUserCoordinateToResizedSymbolTransform() {
-    if (!this.hasExplicitSize()) {
-      return null;
+  _getGlobalPcbPositionBeforeLayout() {
+    const matchedPcbElm = this.matchedComponents.find((c) => c.isPcbPrimitive);
+    const parentComponent = this.parent;
+    if (parentComponent && !parentComponent.props.footprint) {
+      throw new Error(
+        `${parentComponent.componentName} "${parentComponent.props.name}" does not have a footprint. Add a footprint prop, e.g. <${parentComponent.componentName.toLowerCase()} footprint="..." />`
+      );
     }
-    if (this.userCoordinateToResizedSymbolTransformMat) {
-      return this.userCoordinateToResizedSymbolTransformMat;
+    if (!matchedPcbElm) {
+      throw new Error(
+        `Port ${this} has no matching PCB primitives. This often means the footprint's pads lack matching port hints.`
+      );
     }
-    this._computeUserCoordinateToResizedSymbolTransform();
-    return this.userCoordinateToResizedSymbolTransformMat ?? null;
+    return matchedPcbElm?._getGlobalPcbPositionBeforeLayout() ?? { x: 0, y: 0 };
   }
-  _computeSchematicSymbolBounds() {
-    if (this.root?.schematicDisabled) return;
+  _getPcbCircuitJsonBounds() {
+    if (!this.pcb_port_id) {
+      return super._getPcbCircuitJsonBounds();
+    }
     const { db } = this.root;
-    const schematicElements = [];
-    for (const child of this.children) {
-      if (child.componentName === "Port") {
-        const portId = child.schematic_port_id;
-        if (portId) {
-          const port = db.schematic_port.get(portId);
-          if (port) schematicElements.push(port);
-        }
-        continue;
+    const pcb_port = db.pcb_port.get(this.pcb_port_id);
+    return {
+      center: { x: pcb_port.x, y: pcb_port.y },
+      bounds: { left: 0, top: 0, right: 0, bottom: 0 },
+      width: 0,
+      height: 0
+    };
+  }
+  _getGlobalPcbPositionAfterLayout() {
+    return this._getPcbCircuitJsonBounds().center;
+  }
+  _getPortsInternallyConnectedToThisPort() {
+    const parent = this.parent;
+    if (!parent || !parent._getInternallyConnectedPins) return [];
+    const internallyConnectedPorts = parent._getInternallyConnectedPins();
+    for (const ports of internallyConnectedPorts) {
+      if (ports.some((port) => port === this)) {
+        return ports;
       }
-      if (!child.isSchematicPrimitive) continue;
-      if (child.componentName === "SchematicLine") {
-        const line = db.schematic_line.get(child.schematic_line_id);
-        if (line) schematicElements.push(line);
-      } else if (child.componentName === "SchematicRect") {
-        const rect = db.schematic_rect.get(child.schematic_rect_id);
-        if (rect) schematicElements.push(rect);
-      } else if (child.componentName === "SchematicCircle") {
-        const circle = db.schematic_circle.get(
-          child.schematic_circle_id
-        );
-        if (circle) schematicElements.push(circle);
-      } else if (child.componentName === "SchematicArc") {
-        const arc = db.schematic_arc.get(child.schematic_arc_id);
-        if (arc) schematicElements.push(arc);
-      } else if (child.componentName === "SchematicText") {
-        const text = db.schematic_text.get(child.schematic_text_id);
-        if (text) schematicElements.push(text);
-      } else if (child.componentName === "SchematicPath") {
-        const pathIds = child.schematic_path_ids;
-        if (pathIds) {
-          for (const pathId of pathIds) {
-            const path = db.schematic_path.get(pathId);
-            if (path) schematicElements.push(path);
-          }
+    }
+    return [];
+  }
+  /**
+   * Return true if this port has a schematic representation and can be rendered
+   * to the schematic.
+   *
+   * Sometimes things like mounting holes don't have a schematic representation
+   * and aren't rendered to the schematic.
+   *
+   * It's common for a schematic symbol to not have a representation for all of
+   * the pins on a footprint, e.g. a pushbutton has 4 pins but is typically
+   * represented by a two-pin symbol. In these cases, it's best to use
+   * internallyConnectedPorts or externallyConnectedPorts to ensure the things
+   * are rendered properly.
+   */
+  _hasSchematicPort() {
+    const { schX, schY } = this._parsedProps;
+    if (schX !== void 0 && schY !== void 0) {
+      return true;
+    }
+    const parentNormalComponent = this.getParentNormalComponent();
+    const symbol = parentNormalComponent?.getSchematicSymbol();
+    if (symbol) {
+      if (this.schematicSymbolPortDef) return true;
+      const portsInternallyConnectedToThisPort = this._getPortsInternallyConnectedToThisPort();
+      if (portsInternallyConnectedToThisPort.some((p) => p.schematicSymbolPortDef))
+        return true;
+      return false;
+    }
+    const parentBoxDim = parentNormalComponent?._getSchematicBoxDimensions();
+    if (parentBoxDim && this._parsedProps.pinNumber !== void 0) {
+      const localPortPosition = parentBoxDim.getPortPositionByPinNumber(
+        this._parsedProps.pinNumber
+      );
+      if (localPortPosition) return true;
+    }
+    return false;
+  }
+  _getGlobalSchematicPositionBeforeLayout() {
+    const { schX, schY } = this._parsedProps;
+    if (schX !== void 0 && schY !== void 0) {
+      return { x: schX, y: schY };
+    }
+    const parentNormalComponent = this.getParentNormalComponent();
+    const symbol = parentNormalComponent?.getSchematicSymbol();
+    if (symbol) {
+      let schematicSymbolPortDef = this.schematicSymbolPortDef;
+      if (!schematicSymbolPortDef) {
+        schematicSymbolPortDef = this._getPortsInternallyConnectedToThisPort().find(
+          (p) => p.schematicSymbolPortDef
+        )?.schematicSymbolPortDef ?? null;
+        if (!schematicSymbolPortDef) {
+          throw new Error(
+            `Couldn't find schematicSymbolPortDef for port ${this.getString()}, searched internally connected ports and none had a schematicSymbolPortDef. Why are we trying to get the schematic position of this port?`
+          );
         }
       }
+      const transform = compose3(
+        parentNormalComponent.computeSchematicGlobalTransform(),
+        translate2(-symbol.center.x, -symbol.center.y)
+      );
+      return applyToPoint22(transform, schematicSymbolPortDef);
+    }
+    const parentBoxDim = parentNormalComponent?._getSchematicBoxDimensions();
+    if (parentBoxDim && this._parsedProps.pinNumber !== void 0) {
+      const localPortPosition = parentBoxDim.getPortPositionByPinNumber(
+        this._parsedProps.pinNumber
+      );
+      if (!localPortPosition) {
+        throw new Error(
+          `Couldn't find position for schematic_port for port ${this.getString()} inside of the schematic box`
+        );
+      }
+      return applyToPoint22(
+        parentNormalComponent.computeSchematicGlobalTransform(),
+        localPortPosition
+      );
     }
-    if (schematicElements.length === 0) return;
-    const bounds = getBoundsForSchematic(schematicElements);
-    this.schematicSymbolBoundsInUserCoordinates = bounds;
-  }
-  _computeUserCoordinateToResizedSymbolTransform() {
-    const bounds = this.getSchematicSymbolBounds();
-    if (!bounds) return;
-    const { _parsedProps: props } = this;
-    const targetWidth = props.width;
-    const targetHeight = props.height;
-    if (targetWidth === void 0 && targetHeight === void 0) return;
-    const currentWidth = bounds.maxX - bounds.minX;
-    const currentHeight = bounds.maxY - bounds.minY;
-    if (currentWidth === 0 && currentHeight === 0) return;
-    const currentCenterX = (bounds.minX + bounds.maxX) / 2;
-    const currentCenterY = (bounds.minY + bounds.maxY) / 2;
-    const scaleX = targetWidth !== void 0 && currentWidth > 0 ? targetWidth / currentWidth : 1;
-    const scaleY = targetHeight !== void 0 && currentHeight > 0 ? targetHeight / currentHeight : 1;
-    const globalPos = this._getGlobalSchematicPositionBeforeLayout();
-    this.userCoordinateToResizedSymbolTransformMat = compose3(
-      translate2(globalPos.x, globalPos.y),
-      scale(scaleX, scaleY),
-      translate2(-currentCenterX, -currentCenterY)
+    throw new Error(
+      `Couldn't find position for schematic_port for port ${this.getString()}`
     );
   }
-};
-
-// lib/utils/createPinrowSilkscreenText.ts
-var createPinrowSilkscreenText = ({
-  elm,
-  pinLabels,
-  layer,
-  readableRotation,
-  anchorAlignment
-}) => {
-  const pinNum = elm.text.replace(/[{}]/g, "").toLowerCase();
-  let label = pinNum;
-  if (Array.isArray(pinLabels)) {
-    const index = parseInt(pinNum.replace(/[^\d]/g, ""), 10) - 1;
-    label = String(pinLabels[index] ?? pinNum);
-  } else if (typeof pinLabels === "object") {
-    label = String(pinLabels[pinNum] ?? pinNum);
-  }
-  const silkscreenText = new SilkscreenText({
-    anchorAlignment: anchorAlignment || "center",
-    text: label ?? pinNum,
-    layer: layer || "top",
-    pcbX: isNaN(elm.anchor_position.x) ? 0 : elm.anchor_position.x,
-    pcbY: elm.anchor_position.y,
-    pcbRotation: readableRotation ?? 0
-  });
-  silkscreenText._footprinterFontSize = elm.font_size + 0.2;
-  return silkscreenText;
-};
-
-// lib/utils/createComponentsFromCircuitJson.ts
-var calculateCcwRotation = (componentRotationStr, elementCcwRotation) => {
-  const componentAngle = parseInt(componentRotationStr || "0", 10);
-  let totalRotation;
-  if (elementCcwRotation !== void 0 && elementCcwRotation !== null) {
-    totalRotation = elementCcwRotation - componentAngle;
-  } else {
-    totalRotation = componentAngle;
+  _getGlobalSchematicPositionAfterLayout() {
+    const { db } = this.root;
+    if (!this.schematic_port_id) {
+      throw new Error(
+        `Can't get schematic port position after layout for "${this.getString()}", no schematic_port_id`
+      );
+    }
+    const schematic_port = db.schematic_port.get(this.schematic_port_id);
+    if (!schematic_port)
+      throw new Error(
+        `Schematic port not found when trying to get post-layout position: ${this.schematic_port_id}`
+      );
+    return schematic_port.center;
   }
-  const normalizedRotation = (totalRotation % 360 + 360) % 360;
-  return normalizedRotation;
-};
-var optional = (value) => value ?? void 0;
-var getFacingDirectionFromSide = (side) => {
-  switch (side) {
-    case "left":
-    case "right":
-      return side;
-    case "top":
-      return "up";
-    case "bottom":
-      return "down";
+  /**
+   * Smtpads and platedholes call this method to register themselves as a match
+   * for this port. All the matching is done by primitives other than the Port,
+   * but everyone registers themselves as a match with their Port.
+   */
+  registerMatch(component) {
+    this.matchedComponents.push(component);
   }
-  return null;
-};
-var schematicPrimitiveTypesWithStrokeWidth = [
-  "schematic_line",
-  "schematic_rect",
-  "schematic_circle",
-  "schematic_arc",
-  "schematic_path"
-];
-var isSchematicPrimitiveWithStrokeWidth = (elm) => schematicPrimitiveTypesWithStrokeWidth.includes(
-  elm.type
-);
-var getSchematicSymbolId = (elm) => {
-  if (!("schematic_symbol_id" in elm)) return void 0;
-  return typeof elm.schematic_symbol_id === "string" ? elm.schematic_symbol_id : void 0;
-};
-var createComponentsFromCircuitJson = ({
-  componentName,
-  componentRotation,
-  footprinterString,
-  pinLabels,
-  pcbPinLabels
-}, circuitJson) => {
-  const components = [];
-  const schematicSymbolsByImportedId = /* @__PURE__ */ new Map();
-  const schematicComponentsByImportedId = /* @__PURE__ */ new Map();
-  const schematicStrokeWidthBySymbolId = /* @__PURE__ */ new Map();
-  for (const elm of circuitJson) {
-    if (elm.type !== "schematic_symbol") continue;
-    const schematicSymbol = new SymbolComponent({
-      name: elm.name
-    });
-    schematicSymbolsByImportedId.set(elm.schematic_symbol_id, schematicSymbol);
-    components.push(schematicSymbol);
+  getNameAndAliases() {
+    const { _parsedProps: props } = this;
+    return Array.from(
+      /* @__PURE__ */ new Set([
+        ...props.name ? [props.name] : [],
+        ...props.aliases ?? [],
+        ...typeof props.pinNumber === "number" ? [`pin${props.pinNumber}`, props.pinNumber.toString()] : [],
+        ...this.externallyAddedAliases ?? []
+      ])
+    );
   }
-  for (const elm of circuitJson) {
-    if (!isSchematicPrimitiveWithStrokeWidth(elm)) continue;
-    const schematicSymbolId = getSchematicSymbolId(elm);
-    const strokeWidth = elm.stroke_width;
-    if (!schematicSymbolId || typeof strokeWidth !== "number" || !Number.isFinite(strokeWidth) || schematicStrokeWidthBySymbolId.has(schematicSymbolId)) {
-      continue;
+  _getMatchingPinAttributes() {
+    const parentProps = this.parent?._parsedProps;
+    const pinAttributes = parentProps?.pinAttributes;
+    const noConnect = parentProps?.noConnect;
+    const matches = [];
+    for (const alias of this.getNameAndAliases()) {
+      if (pinAttributes) {
+        const attributes = pinAttributes[alias];
+        if (attributes) {
+          matches.push(attributes);
+        }
+      }
+      if (noConnect?.includes(alias)) {
+        matches.push({ doNotConnect: true });
+      }
     }
-    schematicStrokeWidthBySymbolId.set(schematicSymbolId, strokeWidth);
+    if (matches.length === 0) {
+      return [];
+    }
+    return matches;
   }
-  for (const elm of circuitJson) {
-    if (elm.type !== "schematic_component") continue;
-    schematicComponentsByImportedId.set(elm.schematic_component_id, elm);
+  _shouldIncludeInBoardPinout() {
+    return this._getMatchingPinAttributes().some(
+      (attributes) => attributes.includeInBoardPinout === true
+    );
   }
-  const addSchematicPrimitive = (elm, primitive) => {
-    const schematicSymbolId = getSchematicSymbolId(elm);
-    const parentSymbol = schematicSymbolId ? schematicSymbolsByImportedId.get(schematicSymbolId) : void 0;
-    if (parentSymbol) {
-      parentSymbol.add(primitive);
-    } else {
-      components.push(primitive);
+  isMatchingPort(port) {
+    return this.isMatchingAnyOf(port.getNameAndAliases());
+  }
+  getPortSelector() {
+    const parentComponent = this.getParentNormalComponent() ?? this.parent;
+    return `.${parentComponent?.props.name} > port.${this.props.name}`;
+  }
+  getAvailablePcbLayers() {
+    const { layer, layers } = this._parsedProps;
+    if (layers) return layers;
+    if (layer) return [layer];
+    return Array.from(
+      new Set(this.matchedComponents.flatMap((c) => c.getAvailablePcbLayers()))
+    );
+  }
+  /**
+   * Return traces that are explicitly connected to this port (not via a net)
+   */
+  _getDirectlyConnectedTraces() {
+    const allSubcircuitTraces = this.getSubcircuit().selectAll(
+      "trace"
+    );
+    const connectedTraces = allSubcircuitTraces.filter((trace) => !trace._couldNotFindPort).filter((trace) => trace._isExplicitlyConnectedToPort(this));
+    return connectedTraces;
+  }
+  doInitialSourceRender() {
+    const { db } = this.root;
+    const { _parsedProps: props } = this;
+    const port_hints = this.getNameAndAliases();
+    const parentNormalComponent = this.getParentNormalComponent();
+    const parentWithSourceId = this.parent?.source_component_id ? this.parent : parentNormalComponent;
+    const source_component_id = parentWithSourceId?.source_component_id ?? null;
+    const pinAttributes = this._getMatchingPinAttributes();
+    const portAttributesFromParent = {};
+    for (const attributes of pinAttributes) {
+      applyPinAttributesToSourcePort(portAttributesFromParent, attributes);
     }
-  };
-  for (const elm of circuitJson) {
-    if (elm.type === "pcb_smtpad" && elm.shape === "rect") {
-      components.push(
-        new SmtPad({
-          pcbX: elm.x,
-          pcbY: elm.y,
-          layer: elm.layer,
-          shape: "rect",
-          height: elm.height,
-          width: elm.width,
-          portHints: elm.port_hints,
-          rectBorderRadius: elm.rect_border_radius
-        })
-      );
-    } else if (elm.type === "pcb_smtpad" && elm.shape === "circle") {
-      components.push(
-        new SmtPad({
-          pcbX: elm.x,
-          pcbY: elm.y,
-          layer: elm.layer,
-          shape: "circle",
-          radius: elm.radius,
-          portHints: elm.port_hints
-        })
-      );
-    } else if (elm.type === "pcb_smtpad" && elm.shape === "pill") {
-      components.push(
-        new SmtPad({
-          shape: "pill",
-          height: elm.height,
-          width: elm.width,
-          radius: elm.radius,
-          portHints: elm.port_hints,
-          pcbX: elm.x,
-          pcbY: elm.y,
-          layer: elm.layer
-        })
-      );
-    } else if (elm.type === "pcb_smtpad" && elm.shape === "polygon") {
-      components.push(
-        new SmtPad({
-          shape: "polygon",
-          points: elm.points,
-          portHints: elm.port_hints,
-          layer: elm.layer
-        })
-      );
-    } else if (elm.type === "pcb_silkscreen_path") {
-      components.push(
-        new SilkscreenPath({
-          layer: elm.layer,
-          route: elm.route,
-          strokeWidth: elm.stroke_width
-        })
+    const source_port = db.source_port.insert({
+      name: props.name,
+      pin_number: props.pinNumber,
+      port_hints,
+      source_component_id,
+      subcircuit_id: this.getSubcircuit()?.subcircuit_id,
+      ...portAttributesFromParent
+    });
+    this.source_port_id = source_port.source_port_id;
+  }
+  doInitialSourceParentAttachment() {
+    const { db } = this.root;
+    const parentNormalComponent = this.getParentNormalComponent();
+    const parentWithSourceId = this.parent?.source_component_id ? this.parent : parentNormalComponent;
+    if (this.isGroupPort()) {
+      db.source_port.update(this.source_port_id, {
+        source_component_id: null,
+        subcircuit_id: this.getSubcircuit()?.subcircuit_id
+      });
+      return;
+    }
+    if (!parentWithSourceId?.source_component_id) {
+      throw new Error(
+        `${this.getString()} has no parent source component (parent: ${this.parent?.getString()})`
       );
-    } else if (elm.type === "pcb_copper_text") {
-      components.push(
-        new CopperText({
-          text: elm.text,
-          pcbX: elm.anchor_position.x,
-          pcbY: elm.anchor_position.y,
-          pcbRotation: elm.ccw_rotation,
-          anchorAlignment: elm.anchor_alignment,
-          fontSize: elm.font_size,
-          layer: elm.layer,
-          mirrored: elm.is_mirrored,
-          knockout: elm.is_knockout
-        })
+    }
+    db.source_port.update(this.source_port_id, {
+      source_component_id: parentWithSourceId.source_component_id,
+      subcircuit_id: this.getSubcircuit()?.subcircuit_id
+    });
+    this.source_component_id = parentWithSourceId.source_component_id;
+  }
+  doInitialPcbPortRender() {
+    if (this.root?.pcbDisabled) return;
+    const { db } = this.root;
+    const { matchedComponents } = this;
+    if (this.isGroupPort()) {
+      const connectedPorts = this._getConnectedPortsFromConnectsTo();
+      if (connectedPorts.length === 0) {
+        return;
+      }
+      const connectedPort = connectedPorts[0];
+      if (!connectedPort.pcb_port_id) {
+        return;
+      }
+      const connectedPcbPort = db.pcb_port.get(connectedPort.pcb_port_id);
+      const matchCenter2 = { x: connectedPcbPort.x, y: connectedPcbPort.y };
+      const subcircuit = this.getSubcircuit();
+      const pcb_port = db.pcb_port.insert({
+        pcb_component_id: void 0,
+        layers: connectedPort.getAvailablePcbLayers(),
+        subcircuit_id: subcircuit?.subcircuit_id ?? void 0,
+        pcb_group_id: this.getGroup()?.pcb_group_id ?? void 0,
+        ...matchCenter2,
+        source_port_id: this.source_port_id,
+        is_board_pinout: false
+      });
+      this.pcb_port_id = pcb_port.pcb_port_id;
+      return;
+    }
+    const parentNormalComponent = this.getParentNormalComponent();
+    const parentWithPcbComponentId = this.parent?.pcb_component_id ? this.parent : parentNormalComponent;
+    if (!parentWithPcbComponentId?.pcb_component_id) {
+      throw new Error(
+        `${this.getString()} has no parent pcb component, cannot render pcb_port (parent: ${this.parent?.getString()}, parentNormalComponent: ${parentNormalComponent?.getString()})`
       );
-    } else if (elm.type === "pcb_plated_hole") {
-      if (elm.shape === "circle") {
-        components.push(
-          new PlatedHole({
-            pcbX: elm.x,
-            pcbY: elm.y,
-            shape: "circle",
-            holeDiameter: elm.hole_diameter,
-            outerDiameter: elm.outer_diameter,
-            portHints: elm.port_hints
-          })
-        );
-      } else if (elm.shape === "circular_hole_with_rect_pad") {
-        components.push(
-          new PlatedHole({
-            pcbX: elm.x,
-            pcbY: elm.y,
-            shape: "circular_hole_with_rect_pad",
-            holeDiameter: elm.hole_diameter,
-            rectPadHeight: elm.rect_pad_height,
-            rectPadWidth: elm.rect_pad_width,
-            portHints: elm.port_hints,
-            rectBorderRadius: elm.rect_border_radius,
-            holeOffsetX: elm.hole_offset_x,
-            holeOffsetY: elm.hole_offset_y
-          })
-        );
-      } else if (elm.shape === "pill" || elm.shape === "oval") {
-        components.push(
-          new PlatedHole({
-            pcbX: elm.x,
-            pcbY: elm.y,
-            shape: elm.shape,
-            holeWidth: elm.hole_width,
-            holeHeight: elm.hole_height,
-            outerWidth: elm.outer_width,
-            outerHeight: elm.outer_height,
-            portHints: elm.port_hints
-          })
-        );
-      } else if (elm.shape === "pill_hole_with_rect_pad") {
-        components.push(
-          new PlatedHole({
-            pcbX: elm.x,
-            pcbY: elm.y,
-            shape: "pill_hole_with_rect_pad",
-            holeShape: "pill",
-            padShape: "rect",
-            holeWidth: elm.hole_width,
-            holeHeight: elm.hole_height,
-            rectPadWidth: elm.rect_pad_width,
-            rectPadHeight: elm.rect_pad_height,
-            rectBorderRadius: elm.rect_border_radius,
-            portHints: elm.port_hints,
-            holeOffsetX: elm.hole_offset_x,
-            holeOffsetY: elm.hole_offset_y
-          })
+    }
+    const pcbMatches = matchedComponents.filter((c) => c.isPcbPrimitive);
+    if (pcbMatches.length === 0) return;
+    let matchCenter = null;
+    if (pcbMatches.length === 1) {
+      matchCenter = pcbMatches[0]._getPcbCircuitJsonBounds().center;
+    }
+    if (pcbMatches.length > 1) {
+      if (!areAllPcbPrimitivesOverlapping(pcbMatches)) {
+        const portName = this.props.name;
+        const componentName = this.getParentNormalComponent()?.props.name ?? "unknown";
+        const altAliases = this.getNameAndAliases().filter(
+          (h) => h !== portName
         );
-      } else if (elm.shape === "rotated_pill_hole_with_rect_pad") {
-        components.push(
-          new PlatedHole({
-            pcbX: elm.x,
-            pcbY: elm.y,
-            shape: "pill_hole_with_rect_pad",
-            holeShape: "pill",
-            padShape: "rect",
-            holeWidth: elm.hole_width,
-            holeHeight: elm.hole_height,
-            rectPadWidth: elm.rect_pad_width,
-            rectPadHeight: elm.rect_pad_height,
-            rectBorderRadius: elm.rect_border_radius,
-            portHints: elm.port_hints,
-            holeOffsetX: elm.hole_offset_x,
-            holeOffsetY: elm.hole_offset_y,
-            pcbRotation: elm.hole_ccw_rotation
-          })
-        );
-      } else if (elm.shape === "hole_with_polygon_pad") {
-        components.push(
-          new PlatedHole({
-            pcbX: elm.x,
-            pcbY: elm.y,
-            shape: "hole_with_polygon_pad",
-            holeShape: elm.hole_shape || "circle",
-            holeDiameter: elm.hole_diameter,
-            holeWidth: elm.hole_width,
-            holeHeight: elm.hole_height,
-            padOutline: elm.pad_outline || [],
-            holeOffsetX: elm.hole_offset_x,
-            holeOffsetY: elm.hole_offset_y,
-            portHints: elm.port_hints
-          })
-        );
-      }
-    } else if (elm.type === "pcb_keepout" && elm.shape === "circle") {
-      components.push(
-        new Keepout({
-          pcbX: elm.center.x,
-          pcbY: elm.center.y,
-          shape: "circle",
-          radius: elm.radius
-        })
-      );
-    } else if (elm.type === "pcb_keepout" && elm.shape === "rect") {
-      components.push(
-        new Keepout({
-          pcbX: elm.center.x,
-          pcbY: elm.center.y,
-          shape: "rect",
-          width: elm.width,
-          height: elm.height
-        })
-      );
-    } else if (elm.type === "pcb_hole" && elm.hole_shape === "circle") {
-      components.push(
-        new Hole({
-          pcbX: elm.x,
-          pcbY: elm.y,
-          diameter: elm.hole_diameter
-        })
-      );
-    } else if (elm.type === "pcb_hole" && elm.hole_shape === "rect") {
-      components.push(
-        new Hole({
-          pcbX: elm.x,
-          pcbY: elm.y,
-          shape: "rect",
-          width: elm.hole_width,
-          height: elm.hole_height
-        })
-      );
-    } else if (elm.type === "pcb_hole" && elm.hole_shape === "pill") {
-      components.push(
-        new Hole({
-          pcbX: elm.x,
-          pcbY: elm.y,
-          shape: "pill",
-          width: elm.hole_width,
-          height: elm.hole_height
-        })
-      );
-    } else if (elm.type === "pcb_hole" && elm.hole_shape === "oval") {
-      components.push(
-        new Hole({
-          pcbX: elm.x,
-          pcbY: elm.y,
-          shape: "oval",
-          width: elm.hole_width,
-          height: elm.hole_height
-        })
-      );
-    } else if (elm.type === "pcb_hole" && elm.hole_shape === "rotated_pill") {
-      components.push(
-        new Hole({
-          pcbX: elm.x,
-          pcbY: elm.y,
-          shape: "pill",
-          width: elm.hole_width,
-          height: elm.hole_height,
-          pcbRotation: elm.ccw_rotation
-        })
-      );
-    } else if (elm.type === "pcb_cutout") {
-      if (elm.shape === "rect") {
-        components.push(
-          new Cutout({
-            pcbX: elm.center.x,
-            pcbY: elm.center.y,
-            shape: "rect",
-            width: elm.width,
-            height: elm.height
-          })
-        );
-      } else if (elm.shape === "circle") {
-        components.push(
-          new Cutout({
-            pcbX: elm.center.x,
-            pcbY: elm.center.y,
-            shape: "circle",
-            radius: elm.radius
-          })
-        );
-      } else if (elm.shape === "polygon") {
-        components.push(
-          new Cutout({
-            shape: "polygon",
-            points: elm.points
-          })
-        );
-      }
-    } else if (elm.type === "pcb_silkscreen_text") {
-      const ccwRotation = calculateCcwRotation(
-        componentRotation,
-        elm.ccw_rotation
-      );
-      if (footprinterString?.includes("pinrow") && elm.text.includes("PIN")) {
-        components.push(
-          createPinrowSilkscreenText({
-            elm,
-            pinLabels: pcbPinLabels ?? pinLabels ?? {},
-            layer: elm.layer,
-            readableRotation: ccwRotation,
-            anchorAlignment: elm.anchor_alignment
-          })
-        );
-      } else {
-        const silkscreenText = new SilkscreenText({
-          anchorAlignment: elm.anchor_alignment || "center",
-          text: componentName || elm.text,
-          pcbX: Number.isNaN(elm.anchor_position.x) ? 0 : elm.anchor_position.x,
-          pcbY: elm.anchor_position.y,
-          pcbRotation: ccwRotation ?? 0
+        const altMsg = altAliases.length > 0 ? ` (consider using alternate aliases: ${altAliases.join(", ")})` : "";
+        db.source_ambiguous_port_reference.insert({
+          error_type: "source_ambiguous_port_reference",
+          message: `${componentName}.${portName} is ambiguous: ${componentName}.${portName} references multiple non-overlapping pads: ${pcbMatches.map((c) => c.getString()).join(", ")}${altMsg}`,
+          source_port_id: this.source_port_id ?? void 0,
+          source_component_id: this.getParentNormalComponent()?.source_component_id ?? void 0
         });
-        silkscreenText._footprinterFontSize = elm.font_size + 0.2;
-        components.push(silkscreenText);
+        return;
       }
-    } else if (elm.type === "pcb_trace") {
-      components.push(
-        new PcbTrace({
-          route: elm.route
-        })
-      );
-    } else if (elm.type === "pcb_via") {
-      const layers = elm.layers ?? [];
-      const pcbVia = new PcbVia({
-        pcbX: elm.x,
-        pcbY: elm.y,
-        holeDiameter: elm.hole_diameter,
-        outerDiameter: elm.outer_diameter,
-        fromLayer: elm.from_layer ?? layers[0],
-        toLayer: elm.to_layer ?? layers[layers.length - 1],
-        layers,
-        netIsAssignable: elm.net_is_assignable,
-        isTented: elm.is_tented
+      matchCenter = getCenterOfPcbPrimitives(pcbMatches);
+    }
+    if (matchCenter) {
+      const subcircuit = this.getSubcircuit();
+      const isBoardPinout = this._shouldIncludeInBoardPinout();
+      const pcb_port = db.pcb_port.insert({
+        pcb_component_id: parentWithPcbComponentId.pcb_component_id,
+        layers: this.getAvailablePcbLayers(),
+        subcircuit_id: subcircuit?.subcircuit_id ?? void 0,
+        pcb_group_id: this.getGroup()?.pcb_group_id ?? void 0,
+        ...isBoardPinout ? { is_board_pinout: true } : {},
+        ...matchCenter,
+        source_port_id: this.source_port_id,
+        is_board_pinout: this._isBoardPinoutFromAttributes()
       });
-      pcbVia._importedPcbTraceId = elm.pcb_trace_id;
-      components.push(pcbVia);
-    } else if (elm.type === "pcb_silkscreen_rect") {
-      components.push(
-        new SilkscreenRect({
-          pcbX: elm.center.x,
-          pcbY: elm.center.y,
-          width: elm.width,
-          height: elm.height,
-          layer: elm.layer,
-          strokeWidth: elm.stroke_width,
-          filled: elm.is_filled,
-          cornerRadius: elm.corner_radius
-        })
-      );
-    } else if (elm.type === "pcb_silkscreen_circle") {
-      components.push(
-        new SilkscreenCircle({
-          pcbX: elm.center.x,
-          pcbY: elm.center.y,
-          radius: elm.radius,
-          layer: elm.layer,
-          strokeWidth: elm.stroke_width
-        })
-      );
-    } else if (elm.type === "pcb_silkscreen_line") {
-      components.push(
-        new SilkscreenLine({
-          x1: elm.x1,
-          y1: elm.y1,
-          x2: elm.x2,
-          y2: elm.y2,
-          layer: elm.layer,
-          strokeWidth: elm.stroke_width
-        })
-      );
-    } else if (elm.type === "pcb_fabrication_note_text") {
-      components.push(
-        new FabricationNoteText({
-          pcbX: elm.anchor_position.x,
-          pcbY: elm.anchor_position.y,
-          text: elm.text,
-          fontSize: elm.font_size,
-          anchorAlignment: elm.anchor_alignment,
-          color: elm.color,
-          font: elm.font
-        })
-      );
-    } else if (elm.type === "pcb_fabrication_note_path") {
-      components.push(
-        new FabricationNotePath({
-          route: elm.route,
-          strokeWidth: elm.stroke_width,
-          color: elm.color,
-          layer: elm.layer
-        })
-      );
-    } else if (elm.type === "pcb_fabrication_note_rect") {
-      components.push(
-        new FabricationNoteRect({
-          pcbX: elm.center.x,
-          pcbY: elm.center.y,
-          width: elm.width,
-          height: elm.height,
-          strokeWidth: elm.stroke_width,
-          isFilled: elm.is_filled,
-          color: elm.color,
-          layer: elm.layer,
-          cornerRadius: elm.corner_radius,
-          hasStroke: elm.has_stroke,
-          isStrokeDashed: elm.is_stroke_dashed
-        })
+      this.pcb_port_id = pcb_port.pcb_port_id;
+    } else {
+      const pcbMatch = pcbMatches[0];
+      throw new Error(
+        `${pcbMatch.getString()} does not have a center or _getGlobalPcbPositionBeforeLayout method (needed for pcb_port placement)`
       );
-    } else if (elm.type === "pcb_note_text") {
-      components.push(
-        new PcbNoteText({
-          pcbX: elm.anchor_position.x,
-          pcbY: elm.anchor_position.y,
-          text: elm.text ?? "",
-          fontSize: elm.font_size,
-          anchorAlignment: elm.anchor_alignment,
-          color: elm.color,
-          font: elm.font
-        })
-      );
-    } else if (elm.type === "pcb_note_rect") {
-      components.push(
-        new PcbNoteRect({
-          pcbX: elm.center.x,
-          pcbY: elm.center.y,
-          width: elm.width,
-          height: elm.height,
-          strokeWidth: elm.stroke_width,
-          isFilled: elm.is_filled,
-          color: elm.color,
-          cornerRadius: elm.corner_radius,
-          hasStroke: elm.has_stroke,
-          isStrokeDashed: elm.is_stroke_dashed
-        })
-      );
-    } else if (elm.type === "pcb_note_path") {
-      components.push(
-        new PcbNotePath({
-          route: elm.route,
-          strokeWidth: elm.stroke_width,
-          color: elm.color
-        })
-      );
-    } else if (elm.type === "pcb_note_line") {
-      components.push(
-        new PcbNoteLine({
-          x1: elm.x1,
-          y1: elm.y1,
-          x2: elm.x2,
-          y2: elm.y2,
-          strokeWidth: elm.stroke_width,
-          color: elm.color,
-          isDashed: elm.is_dashed
-        })
-      );
-    } else if (elm.type === "pcb_courtyard_rect") {
-      components.push(
-        new CourtyardRect({
-          pcbX: elm.center.x,
-          pcbY: elm.center.y,
-          width: elm.width,
-          height: elm.height,
-          layer: elm.layer
-        })
-      );
-    } else if (elm.type === "pcb_courtyard_circle") {
-      components.push(
-        new CourtyardCircle({
-          pcbX: elm.center.x,
-          pcbY: elm.center.y,
-          radius: elm.radius,
-          layer: elm.layer
-        })
-      );
-    } else if (elm.type === "pcb_courtyard_outline") {
-      components.push(
-        new CourtyardOutline({
-          outline: elm.outline,
-          layer: elm.layer
-        })
-      );
-    } else if (elm.type === "schematic_line") {
-      addSchematicPrimitive(
-        elm,
-        new SchematicLine({
-          x1: elm.x1,
-          y1: elm.y1,
-          x2: elm.x2,
-          y2: elm.y2,
-          strokeWidth: optional(elm.stroke_width),
-          color: elm.color,
-          isDashed: elm.is_dashed
-        })
-      );
-    } else if (elm.type === "schematic_rect") {
-      addSchematicPrimitive(
-        elm,
-        new SchematicRect({
-          schX: elm.center.x,
-          schY: elm.center.y,
-          width: elm.width,
-          height: elm.height,
-          rotation: elm.rotation,
-          strokeWidth: optional(elm.stroke_width),
-          color: elm.color,
-          isFilled: elm.is_filled,
-          fillColor: elm.fill_color,
-          isDashed: elm.is_dashed
-        })
-      );
-    } else if (elm.type === "schematic_circle") {
-      addSchematicPrimitive(
-        elm,
-        new SchematicCircle({
-          center: elm.center,
-          radius: elm.radius,
-          strokeWidth: optional(elm.stroke_width),
-          color: elm.color,
-          isFilled: elm.is_filled,
-          fillColor: elm.fill_color,
-          isDashed: elm.is_dashed
-        })
-      );
-    } else if (elm.type === "schematic_arc") {
-      addSchematicPrimitive(
-        elm,
-        new SchematicArc({
-          center: elm.center,
-          radius: elm.radius,
-          startAngleDegrees: elm.start_angle_degrees,
-          endAngleDegrees: elm.end_angle_degrees,
-          direction: elm.direction,
-          strokeWidth: optional(elm.stroke_width),
-          color: elm.color,
-          isDashed: elm.is_dashed
-        })
-      );
-    } else if (elm.type === "schematic_text") {
-      addSchematicPrimitive(
-        elm,
-        new SchematicText({
-          schX: elm.position.x,
-          schY: elm.position.y,
-          text: elm.text,
-          fontSize: elm.font_size,
-          anchor: elm.anchor,
-          color: elm.color,
-          schRotation: elm.rotation
-        })
-      );
-    } else if (elm.type === "schematic_path") {
-      addSchematicPrimitive(
-        elm,
-        new SchematicPath({
-          points: elm.points,
-          strokeWidth: optional(elm.stroke_width),
-          strokeColor: elm.stroke_color,
-          dashLength: elm.dash_length,
-          dashGap: elm.dash_gap,
-          isFilled: elm.is_filled,
-          fillColor: elm.fill_color
-        })
-      );
-    } else if (elm.type === "schematic_port") {
-      const schematicComponentId = elm.schematic_component_id;
-      if (typeof schematicComponentId !== "string") continue;
-      const schematicComponent = schematicComponentsByImportedId.get(schematicComponentId);
-      const schematicSymbolId = schematicComponent?.schematic_symbol_id;
-      const parentSymbol = typeof schematicSymbolId === "string" ? schematicSymbolsByImportedId.get(schematicSymbolId) : void 0;
-      if (parentSymbol && schematicComponent?.is_box_with_pins === true && elm.center && elm.side_of_component) {
-        const distance19 = elm.distance_from_component_edge;
-        const facingDirection = getFacingDirectionFromSide(
-          elm.side_of_component
-        );
-        if (!facingDirection) continue;
-        const directionVector = getUnitVectorFromDirection2(facingDirection);
-        const stemDirection = elm.facing_direction === facingDirection ? 1 : -1;
-        const portCenter = {
-          x: elm.center.x + directionVector.x * distance19 * stemDirection,
-          y: elm.center.y + directionVector.y * distance19 * stemDirection
-        };
-        parentSymbol.add(
-          new SchematicLine({
-            x1: elm.center.x,
-            y1: elm.center.y,
-            x2: portCenter.x,
-            y2: portCenter.y,
-            strokeWidth: typeof schematicSymbolId === "string" ? optional(
-              schematicStrokeWidthBySymbolId.get(schematicSymbolId)
-            ) : void 0,
-            isDashed: false
-          })
-        );
-      }
     }
   }
-  return components;
-};
-
-// lib/utils/filterPinLabels.ts
-import { chipProps } from "@tscircuit/props";
-function filterPinLabels(pinLabels) {
-  if (!pinLabels)
-    return {
-      validPinLabels: pinLabels,
-      invalidPinLabelsMessages: []
-    };
-  const validPinLabels = {};
-  const invalidPinLabelsMessages = [];
-  for (const [pin, labelOrLabels] of Object.entries(pinLabels)) {
-    const labels = Array.isArray(labelOrLabels) ? labelOrLabels.slice() : [labelOrLabels];
-    const validLabels = [];
-    for (const label of labels) {
-      if (isValidPinLabel(pin, label)) {
-        validLabels.push(label);
-      } else {
-        invalidPinLabelsMessages.push(
-          `Invalid pin label: ${pin} = '${label}' - excluding from component. Pin labels can only contain letters, numbers and underscores.`
-        );
-      }
+  updatePcbPortRender() {
+    if (this.root?.pcbDisabled) return;
+    const { db } = this.root;
+    if (this.pcb_port_id) return;
+    if (this.isGroupPort()) {
+      const connectedPorts = this._getConnectedPortsFromConnectsTo();
+      if (connectedPorts.length === 0) return;
+      const connectedPort = connectedPorts[0];
+      if (!connectedPort.pcb_port_id) return;
+      const connectedPcbPort = db.pcb_port.get(connectedPort.pcb_port_id);
+      const matchCenter2 = { x: connectedPcbPort.x, y: connectedPcbPort.y };
+      const subcircuit2 = this.getSubcircuit();
+      const pcb_port2 = db.pcb_port.insert({
+        pcb_component_id: void 0,
+        layers: connectedPort.getAvailablePcbLayers(),
+        subcircuit_id: subcircuit2?.subcircuit_id ?? void 0,
+        pcb_group_id: this.getGroup()?.pcb_group_id ?? void 0,
+        ...matchCenter2,
+        source_port_id: this.source_port_id,
+        is_board_pinout: false
+      });
+      this.pcb_port_id = pcb_port2.pcb_port_id;
+      return;
     }
-    if (validLabels.length > 0) {
-      validPinLabels[pin] = Array.isArray(labelOrLabels) ? validLabels : validLabels[0];
+    const pcbMatches = this.matchedComponents.filter((c) => c.isPcbPrimitive);
+    if (pcbMatches.length === 0) return;
+    let matchCenter = null;
+    if (pcbMatches.length === 1) {
+      matchCenter = pcbMatches[0]._getPcbCircuitJsonBounds().center;
     }
-  }
-  return {
-    validPinLabels: Object.keys(validPinLabels).length > 0 ? validPinLabels : void 0,
-    invalidPinLabelsMessages
-  };
-}
-function isValidPinLabel(pin, label) {
-  try {
-    const testProps = {
-      name: "test",
-      footprint: "test",
-      pinLabels: { [pin]: label }
-    };
-    const result = chipProps.safeParse(testProps);
-    return result.success;
-  } catch (error) {
-    return false;
-  }
-}
-
-// lib/utils/get-bounds-of-pcb-components.ts
-var NON_PHYSICAL_PCB_PRIMITIVE_PREFIXES = [
-  "Silkscreen",
-  "PcbNote",
-  "Courtyard",
-  "FabricationNote"
-];
-function getBoundsOfPcbComponents(components) {
-  let minX = Infinity;
-  let minY = Infinity;
-  let maxX = -Infinity;
-  let maxY = -Infinity;
-  let hasValidComponents = false;
-  for (const child of components) {
-    if (child.isPcbPrimitive && !NON_PHYSICAL_PCB_PRIMITIVE_PREFIXES.some(
-      (prefix) => child.componentName.startsWith(prefix)
-    )) {
-      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);
-      maxX = Math.max(maxX, x + width2 / 2);
-      maxY = Math.max(maxY, y + height2 / 2);
-      hasValidComponents = true;
-    } else if (child.children.length > 0) {
-      const childBounds = getBoundsOfPcbComponents(child.children);
-      if (childBounds.width > 0 || childBounds.height > 0) {
-        minX = Math.min(minX, childBounds.minX);
-        minY = Math.min(minY, childBounds.minY);
-        maxX = Math.max(maxX, childBounds.maxX);
-        maxY = Math.max(maxY, childBounds.maxY);
-        hasValidComponents = true;
+    if (pcbMatches.length > 1) {
+      try {
+        if (areAllPcbPrimitivesOverlapping(pcbMatches)) {
+          matchCenter = getCenterOfPcbPrimitives(pcbMatches);
+        }
+      } catch {
       }
     }
+    if (!matchCenter) return;
+    const parentNormalComponent = this.getParentNormalComponent();
+    const parentWithPcbComponentId = this.parent?.pcb_component_id ? this.parent : parentNormalComponent;
+    const subcircuit = this.getSubcircuit();
+    const isBoardPinout = this._shouldIncludeInBoardPinout();
+    const pcb_port = db.pcb_port.insert({
+      pcb_component_id: parentWithPcbComponentId?.pcb_component_id,
+      layers: this.getAvailablePcbLayers(),
+      subcircuit_id: subcircuit?.subcircuit_id ?? void 0,
+      pcb_group_id: this.getGroup()?.pcb_group_id ?? void 0,
+      ...isBoardPinout ? { is_board_pinout: true } : {},
+      ...matchCenter,
+      source_port_id: this.source_port_id,
+      is_board_pinout: this._isBoardPinoutFromAttributes()
+    });
+    this.pcb_port_id = pcb_port.pcb_port_id;
   }
-  if (!hasValidComponents) {
-    return {
-      minX: 0,
-      minY: 0,
-      maxX: 0,
-      maxY: 0,
-      width: 0,
-      height: 0
-    };
-  }
-  let width = maxX - minX;
-  let height = maxY - minY;
-  if (width < 0) width = 0;
-  if (height < 0) height = 0;
-  return {
-    minX,
-    minY,
-    maxX,
-    maxY,
-    width,
-    height
-  };
-}
-
-// lib/utils/get-relative-direction.ts
-function getRelativeDirection(pointA, pointB) {
-  const dx = pointB.x - pointA.x;
-  const dy = pointB.y - pointA.y;
-  if (Math.abs(dx) > Math.abs(dy)) {
-    return dx >= 0 ? "right" : "left";
-  }
-  return dy >= 0 ? "up" : "down";
-}
-
-// lib/components/primitive-components/Port/Port.ts
-import "schematic-symbols";
-import { applyToPoint as applyToPoint22, compose as compose4, translate as translate3 } from "transformation-matrix";
-import "zod";
-
-// lib/components/primitive-components/Port/getCenterOfPcbPrimitives.ts
-var getCenterOfPcbPrimitives = (pcbPrimitives) => {
-  if (pcbPrimitives.length === 0) {
-    throw new Error("Cannot get center of empty PCB primitives array");
-  }
-  const positions = pcbPrimitives.map((p) => p._getPcbCircuitJsonBounds().center).filter(Boolean);
-  const sumX = positions.reduce((sum, pos) => sum + pos.x, 0);
-  const sumY = positions.reduce((sum, pos) => sum + pos.y, 0);
-  return {
-    x: sumX / positions.length,
-    y: sumY / positions.length
-  };
-};
-
-// lib/components/primitive-components/Port/Port.ts
-import { portProps } from "@tscircuit/props";
-
-// lib/components/primitive-components/Port/apply-pin-attributes-to-source-port.ts
-var applyPinAttributesToSourcePort = (sourcePortProps, attributes) => {
-  if (attributes.mustBeConnected !== void 0) {
-    sourcePortProps.must_be_connected = attributes.mustBeConnected;
-  }
-  if (attributes.providesPower !== void 0) {
-    sourcePortProps.provides_power = attributes.providesPower;
-  }
-  if (attributes.requiresPower !== void 0) {
-    sourcePortProps.requires_power = attributes.requiresPower;
-  }
-  if (attributes.providesGround !== void 0) {
-    sourcePortProps.provides_ground = attributes.providesGround;
-  }
-  if (attributes.requiresGround !== void 0) {
-    sourcePortProps.requires_ground = attributes.requiresGround;
-  }
-  if (attributes.providesVoltage !== void 0) {
-    sourcePortProps.provides_voltage = attributes.providesVoltage;
-  }
-  if (attributes.requiresVoltage !== void 0) {
-    sourcePortProps.requires_voltage = attributes.requiresVoltage;
-  }
-  if (attributes.doNotConnect !== void 0) {
-    sourcePortProps.do_not_connect = attributes.doNotConnect;
-  }
-  if (attributes.includeInBoardPinout !== void 0) {
-    sourcePortProps.include_in_board_pinout = attributes.includeInBoardPinout;
-  }
-  if (attributes.canUseInternalPullup !== void 0) {
-    sourcePortProps.can_use_internal_pullup = attributes.canUseInternalPullup;
-  }
-  if (attributes.isUsingInternalPullup !== void 0) {
-    sourcePortProps.is_using_internal_pullup = attributes.isUsingInternalPullup;
-  }
-  if (attributes.needsExternalPullup !== void 0) {
-    sourcePortProps.needs_external_pullup = attributes.needsExternalPullup;
-  }
-  if (attributes.canUseInternalPulldown !== void 0) {
-    sourcePortProps.can_use_internal_pulldown = attributes.canUseInternalPulldown;
-  }
-  if (attributes.isUsingInternalPulldown !== void 0) {
-    sourcePortProps.is_using_internal_pulldown = attributes.isUsingInternalPulldown;
-  }
-  if (attributes.needsExternalPulldown !== void 0) {
-    sourcePortProps.needs_external_pulldown = attributes.needsExternalPulldown;
-  }
-  if (attributes.canUseOpenDrain !== void 0) {
-    sourcePortProps.can_use_open_drain = attributes.canUseOpenDrain;
-  }
-  if (attributes.isUsingOpenDrain !== void 0) {
-    sourcePortProps.is_using_open_drain = attributes.isUsingOpenDrain;
-  }
-  if (attributes.canUsePushPull !== void 0) {
-    sourcePortProps.can_use_push_pull = attributes.canUsePushPull;
-  }
-  if (attributes.isUsingPushPull !== void 0) {
-    sourcePortProps.is_using_push_pull = attributes.isUsingPushPull;
-  }
-  if (attributes.shouldHaveDecouplingCapacitor !== void 0) {
-    sourcePortProps.should_have_decoupling_capacitor = attributes.shouldHaveDecouplingCapacitor;
-  }
-  if (attributes.recommendedDecouplingCapacitorCapacitance !== void 0) {
-    sourcePortProps.recommended_decoupling_capacitor_capacitance = attributes.recommendedDecouplingCapacitorCapacitance;
-  }
-};
-
-// lib/components/primitive-components/Port/Port.ts
-var Port = class extends PrimitiveComponent2 {
-  source_port_id = null;
-  pcb_port_id = null;
-  schematic_port_id = null;
-  schematic_stem_line_id = null;
-  schematicSymbolPortDef = null;
-  matchedComponents;
-  _isPrimaryPort = true;
-  _primaryPinNumber = null;
-  facingDirection = null;
-  originDescription = null;
-  get config() {
-    return {
-      componentName: "Port",
-      zodProps: portProps
-    };
-  }
-  constructor(props, opts = {}) {
-    if (!props.name && props.pinNumber !== void 0)
-      props.name = `pin${props.pinNumber}`;
-    if (!props.name) {
-      throw new Error("Port must have a name or a pinNumber");
+  /**
+   * Get the best display label for this port based on port_hints
+   * Filters out generic patterns and applies showPinAliases logic
+   */
+  _getBestDisplayPinLabel() {
+    const { db } = this.root;
+    const sourcePort = db.source_port.get(this.source_port_id);
+    const labelHints = [];
+    for (const portHint of sourcePort?.port_hints ?? []) {
+      if (portHint.match(/^(pin)?\d+$/)) continue;
+      if (portHint.match(/^(left|right)/) && !sourcePort?.name.match(/^(left|right)/))
+        continue;
+      labelHints.push(portHint);
     }
-    super(props);
-    if (opts.originDescription) {
-      this.originDescription = opts.originDescription;
+    const parentNormalComponent = this.getParentNormalComponent();
+    const showPinAliases = parentNormalComponent?.props?.showPinAliases;
+    if (showPinAliases && labelHints.length > 0) {
+      return labelHints.join("/");
+    } else if (labelHints.length > 0) {
+      return labelHints[0];
     }
-    this.matchedComponents = [];
-  }
-  isGroupPort() {
-    return this.parent?.componentName === "Group";
-  }
-  isComponentPort() {
-    return !this.isGroupPort();
+    return void 0;
   }
-  _getConnectedPortsFromConnectsTo() {
+  doInitialSchematicPortRender() {
+    const collapsedAncestor = this.getCollapsedSchematicBoxAncestor();
+    if (collapsedAncestor && this.parent !== collapsedAncestor) return;
+    const { db } = this.root;
     const { _parsedProps: props } = this;
-    const connectsTo = props.connectsTo;
-    if (!connectsTo) return [];
-    const connectedPorts = [];
-    const connectsToArray = Array.isArray(connectsTo) ? connectsTo : [connectsTo];
-    for (const connection of connectsToArray) {
-      const port = this.getSubcircuit().selectOne(connection, {
-        type: "port"
-      });
-      if (port) {
-        connectedPorts.push(port);
-      }
-    }
-    return connectedPorts;
-  }
-  _isBoardPinoutFromAttributes() {
-    const parent = this.parent;
-    if (parent?._parsedProps?.pinAttributes) {
-      const pinAttributes = parent._parsedProps.pinAttributes;
-      for (const alias of this.getNameAndAliases()) {
-        if (pinAttributes[alias]?.includeInBoardPinout) {
-          return true;
-        }
-      }
-    }
-  }
-  _getGlobalPcbPositionBeforeLayout() {
-    const matchedPcbElm = this.matchedComponents.find((c) => c.isPcbPrimitive);
-    const parentComponent = this.parent;
-    if (parentComponent && !parentComponent.props.footprint) {
-      throw new Error(
-        `${parentComponent.componentName} "${parentComponent.props.name}" does not have a footprint. Add a footprint prop, e.g. <${parentComponent.componentName.toLowerCase()} footprint="..." />`
-      );
+    const { schX, schY } = props;
+    const container = schX !== void 0 && schY !== void 0 ? this.getParentNormalComponent() : this.getPrimitiveContainer();
+    if (!container) return;
+    if (!this._hasSchematicPort()) return;
+    const containerCenter = container._getGlobalSchematicPositionBeforeLayout();
+    const portCenter = this._getGlobalSchematicPositionBeforeLayout();
+    let localPortInfo = null;
+    const containerDims = container._getSchematicBoxDimensions();
+    if (containerDims && props.pinNumber !== void 0) {
+      localPortInfo = containerDims.getPortPositionByPinNumber(props.pinNumber);
     }
-    if (!matchedPcbElm) {
-      throw new Error(
-        `Port ${this} has no matching PCB primitives. This often means the footprint's pads lack matching port hints.`
-      );
+    if (this.getSubcircuit().props._schDebugObjectsEnabled) {
+      db.schematic_debug_object.insert({
+        shape: "rect",
+        center: portCenter,
+        size: {
+          width: 0.1,
+          height: 0.1
+        },
+        label: "obstacle"
+      });
     }
-    return matchedPcbElm?._getGlobalPcbPositionBeforeLayout() ?? { x: 0, y: 0 };
-  }
-  _getPcbCircuitJsonBounds() {
-    if (!this.pcb_port_id) {
-      return super._getPcbCircuitJsonBounds();
+    if (!localPortInfo?.side) {
+      this.facingDirection = getRelativeDirection(containerCenter, portCenter);
+    } else {
+      this.facingDirection = {
+        left: "left",
+        right: "right",
+        top: "up",
+        bottom: "down"
+      }[localPortInfo.side];
     }
-    const { db } = this.root;
-    const pcb_port = db.pcb_port.get(this.pcb_port_id);
-    return {
-      center: { x: pcb_port.x, y: pcb_port.y },
-      bounds: { left: 0, top: 0, right: 0, bottom: 0 },
-      width: 0,
-      height: 0
+    const bestDisplayPinLabel = this._getBestDisplayPinLabel();
+    const parentNormalComponent = this.getParentNormalComponent();
+    const sideOfComponent = localPortInfo?.side ?? (props.direction === "up" ? "top" : props.direction === "down" ? "bottom" : props.direction);
+    const schematicPortInsertProps = {
+      type: "schematic_port",
+      schematic_component_id: parentNormalComponent?.schematic_component_id,
+      center: portCenter,
+      source_port_id: this.source_port_id,
+      facing_direction: this.facingDirection,
+      distance_from_component_edge: props.schStemLength ?? 0.4,
+      side_of_component: sideOfComponent,
+      pin_number: props.pinNumber,
+      true_ccw_index: localPortInfo?.trueIndex,
+      display_pin_label: bestDisplayPinLabel,
+      is_connected: false
     };
-  }
-  _getGlobalPcbPositionAfterLayout() {
-    return this._getPcbCircuitJsonBounds().center;
-  }
-  _getPortsInternallyConnectedToThisPort() {
-    const parent = this.parent;
-    if (!parent || !parent._getInternallyConnectedPins) return [];
-    const internallyConnectedPorts = parent._getInternallyConnectedPins();
-    for (const ports of internallyConnectedPorts) {
-      if (ports.some((port) => port === this)) {
-        return ports;
+    for (const attributes of this._getMatchingPinAttributes()) {
+      if (attributes.requiresPower) {
+        schematicPortInsertProps.has_input_arrow = true;
+      }
+      if (attributes.providesPower) {
+        schematicPortInsertProps.has_output_arrow = true;
       }
     }
-    return [];
-  }
-  /**
-   * Return true if this port has a schematic representation and can be rendered
-   * to the schematic.
-   *
-   * Sometimes things like mounting holes don't have a schematic representation
-   * and aren't rendered to the schematic.
-   *
-   * It's common for a schematic symbol to not have a representation for all of
-   * the pins on a footprint, e.g. a pushbutton has 4 pins but is typically
-   * represented by a two-pin symbol. In these cases, it's best to use
-   * internallyConnectedPorts or externallyConnectedPorts to ensure the things
-   * are rendered properly.
-   */
-  _hasSchematicPort() {
-    const { schX, schY } = this._parsedProps;
-    if (schX !== void 0 && schY !== void 0) {
-      return true;
-    }
-    const parentNormalComponent = this.getParentNormalComponent();
-    const symbol = parentNormalComponent?.getSchematicSymbol();
-    if (symbol) {
-      if (this.schematicSymbolPortDef) return true;
-      const portsInternallyConnectedToThisPort = this._getPortsInternallyConnectedToThisPort();
-      if (portsInternallyConnectedToThisPort.some((p) => p.schematicSymbolPortDef))
-        return true;
-      return false;
-    }
-    const parentBoxDim = parentNormalComponent?._getSchematicBoxDimensions();
-    if (parentBoxDim && this._parsedProps.pinNumber !== void 0) {
-      const localPortPosition = parentBoxDim.getPortPositionByPinNumber(
-        this._parsedProps.pinNumber
-      );
-      if (localPortPosition) return true;
+    const schematic_port = db.schematic_port.insert(schematicPortInsertProps);
+    this.schematic_port_id = schematic_port.schematic_port_id;
+    if (props.schStemLength !== void 0 && props.schStemLength !== 0) {
+      const { schStemLength, direction } = props;
+      let x2 = portCenter.x;
+      let y2 = portCenter.y;
+      if (direction === "right") x2 -= schStemLength;
+      else if (direction === "left") x2 += schStemLength;
+      else if (direction === "up") y2 -= schStemLength;
+      else if (direction === "down") y2 += schStemLength;
+      const stemLine = db.schematic_line.insert({
+        schematic_component_id: parentNormalComponent?.schematic_component_id,
+        x1: portCenter.x,
+        y1: portCenter.y,
+        x2,
+        y2,
+        stroke_width: 0.02,
+        color: SCHEMATIC_COMPONENT_OUTLINE_COLOR,
+        is_dashed: false
+      });
+      this.schematic_stem_line_id = stemLine.schematic_line_id;
     }
-    return false;
   }
-  _getGlobalSchematicPositionBeforeLayout() {
-    const { schX, schY } = this._parsedProps;
-    if (schX !== void 0 && schY !== void 0) {
-      return { x: schX, y: schY };
-    }
-    const parentNormalComponent = this.getParentNormalComponent();
-    const symbol = parentNormalComponent?.getSchematicSymbol();
-    if (symbol) {
-      let schematicSymbolPortDef = this.schematicSymbolPortDef;
-      if (!schematicSymbolPortDef) {
-        schematicSymbolPortDef = this._getPortsInternallyConnectedToThisPort().find(
-          (p) => p.schematicSymbolPortDef
-        )?.schematicSymbolPortDef ?? null;
-        if (!schematicSymbolPortDef) {
-          throw new Error(
-            `Couldn't find schematicSymbolPortDef for port ${this.getString()}, searched internally connected ports and none had a schematicSymbolPortDef. Why are we trying to get the schematic position of this port?`
+  doInitialSchematicSymbolResize() {
+    if (this.root?.schematicDisabled) return;
+    if (!this.schematic_port_id) return;
+    const symbol = this._getSymbolAncestor();
+    const transform = symbol?.getUserCoordinateToResizedSymbolTransform();
+    if (!transform) return;
+    const { db } = this.root;
+    const schPort = db.schematic_port.get(this.schematic_port_id);
+    if (schPort) {
+      const newCenter = applyToPoint22(transform, schPort.center);
+      db.schematic_port.update(this.schematic_port_id, {
+        center: newCenter
+      });
+      if (this.schematic_stem_line_id) {
+        const line = db.schematic_line.get(this.schematic_stem_line_id);
+        if (line) {
+          const p1 = applyToPoint22(transform, { x: line.x1, y: line.y1 });
+          const p2 = applyToPoint22(transform, { x: line.x2, y: line.y2 });
+          db.schematic_line.update(this.schematic_stem_line_id, {
+            x1: p1.x,
+            y1: p1.y,
+            x2: p2.x,
+            y2: p2.y
+          });
+          const scaledStemLength = Math.sqrt(
+            (p1.x - p2.x) ** 2 + (p1.y - p2.y) ** 2
           );
+          db.schematic_port.update(this.schematic_port_id, {
+            distance_from_component_edge: scaledStemLength
+          });
         }
       }
-      const transform = compose4(
-        parentNormalComponent.computeSchematicGlobalTransform(),
-        translate3(-symbol.center.x, -symbol.center.y)
-      );
-      return applyToPoint22(transform, schematicSymbolPortDef);
-    }
-    const parentBoxDim = parentNormalComponent?._getSchematicBoxDimensions();
-    if (parentBoxDim && this._parsedProps.pinNumber !== void 0) {
-      const localPortPosition = parentBoxDim.getPortPositionByPinNumber(
-        this._parsedProps.pinNumber
-      );
-      if (!localPortPosition) {
-        throw new Error(
-          `Couldn't find position for schematic_port for port ${this.getString()} inside of the schematic box`
-        );
-      }
-      return applyToPoint22(
-        parentNormalComponent.computeSchematicGlobalTransform(),
-        localPortPosition
-      );
     }
-    throw new Error(
-      `Couldn't find position for schematic_port for port ${this.getString()}`
-    );
   }
-  _getGlobalSchematicPositionAfterLayout() {
+  _getSubcircuitConnectivityKey() {
+    return this.root?.db.source_port.get(this.source_port_id)?.subcircuit_connectivity_map_key;
+  }
+  _setPositionFromLayout(newCenter) {
     const { db } = this.root;
-    if (!this.schematic_port_id) {
-      throw new Error(
-        `Can't get schematic port position after layout for "${this.getString()}", no schematic_port_id`
-      );
-    }
-    const schematic_port = db.schematic_port.get(this.schematic_port_id);
-    if (!schematic_port)
-      throw new Error(
-        `Schematic port not found when trying to get post-layout position: ${this.schematic_port_id}`
-      );
-    return schematic_port.center;
+    if (!this.pcb_port_id) return;
+    db.pcb_port.update(this.pcb_port_id, {
+      x: newCenter.x,
+      y: newCenter.y
+    });
+  }
+  _hasMatchedPcbPrimitive() {
+    return this.matchedComponents.some((c) => c.isPcbPrimitive);
   }
   /**
-   * Smtpads and platedholes call this method to register themselves as a match
-   * for this port. All the matching is done by primitives other than the Port,
-   * but everyone registers themselves as a match with their Port.
+   * Return the text that should be used for the net label for this port if a
+   * trace can't be drawn. This net label text usually doesn't appear at this
+   * port, but appears at the port it connects to.
    */
-  registerMatch(component) {
-    this.matchedComponents.push(component);
+  _getNetLabelText() {
+    return `${this.parent?.props.name}_${this.props.name}`;
   }
-  getNameAndAliases() {
-    const { _parsedProps: props } = this;
-    return Array.from(
-      /* @__PURE__ */ new Set([
-        ...props.name ? [props.name] : [],
-        ...props.aliases ?? [],
-        ...typeof props.pinNumber === "number" ? [`pin${props.pinNumber}`, props.pinNumber.toString()] : [],
-        ...this.externallyAddedAliases ?? []
-      ])
-    );
-  }
-  _getMatchingPinAttributes() {
-    const parentProps = this.parent?._parsedProps;
-    const pinAttributes = parentProps?.pinAttributes;
-    const noConnect = parentProps?.noConnect;
-    const matches = [];
-    for (const alias of this.getNameAndAliases()) {
-      if (pinAttributes) {
-        const attributes = pinAttributes[alias];
-        if (attributes) {
-          matches.push(attributes);
-        }
-      }
-      if (noConnect?.includes(alias)) {
-        matches.push({ doNotConnect: true });
-      }
-    }
-    if (matches.length === 0) {
-      return [];
-    }
-    return matches;
-  }
-  _shouldIncludeInBoardPinout() {
-    return this._getMatchingPinAttributes().some(
-      (attributes) => attributes.includeInBoardPinout === true
-    );
-  }
-  isMatchingPort(port) {
-    return this.isMatchingAnyOf(port.getNameAndAliases());
-  }
-  getPortSelector() {
-    const parentComponent = this.getParentNormalComponent() ?? this.parent;
-    return `.${parentComponent?.props.name} > port.${this.props.name}`;
+};
+
+// lib/components/primitive-components/Symbol/Symbol.ts
+import { symbolProps } from "@tscircuit/props";
+import { compose as compose4, translate as translate3, scale } from "transformation-matrix";
+var SymbolComponent = class extends PrimitiveComponent2 {
+  isPrimitiveContainer = true;
+  schematic_symbol_id;
+  userCoordinateToResizedSymbolTransformMat;
+  schematicSymbolBoundsInUserCoordinates;
+  get config() {
+    return {
+      componentName: "Symbol",
+      zodProps: symbolProps
+    };
   }
-  getAvailablePcbLayers() {
-    const { layer, layers } = this._parsedProps;
-    if (layers) return layers;
-    if (layer) return [layer];
-    return Array.from(
-      new Set(this.matchedComponents.flatMap((c) => c.getAvailablePcbLayers()))
-    );
+  hasExplicitSize() {
+    const { _parsedProps: props } = this;
+    return props.width !== void 0 || props.height !== void 0;
   }
   /**
-   * Return traces that are explicitly connected to this port (not via a net)
+   * Create the schematic_symbol element in SymbolContainerRender phase.
+   * This runs before SchematicPrimitiveRender, ensuring children can
+   * reference the schematic_symbol_id when they render.
    */
-  _getDirectlyConnectedTraces() {
-    const allSubcircuitTraces = this.getSubcircuit().selectAll(
-      "trace"
-    );
-    const connectedTraces = allSubcircuitTraces.filter((trace) => !trace._couldNotFindPort).filter((trace) => trace._isExplicitlyConnectedToPort(this));
-    return connectedTraces;
-  }
-  doInitialSourceRender() {
+  doInitialSymbolContainerRender() {
+    if (this.root?.schematicDisabled) return;
     const { db } = this.root;
     const { _parsedProps: props } = this;
-    const port_hints = this.getNameAndAliases();
-    const parentNormalComponent = this.getParentNormalComponent();
-    const parentWithSourceId = this.parent?.source_component_id ? this.parent : parentNormalComponent;
-    const source_component_id = parentWithSourceId?.source_component_id ?? null;
-    const pinAttributes = this._getMatchingPinAttributes();
-    const portAttributesFromParent = {};
-    for (const attributes of pinAttributes) {
-      applyPinAttributesToSourcePort(portAttributesFromParent, attributes);
-    }
-    const source_port = db.source_port.insert({
+    const parentNormal = this.getParentNormalComponent();
+    const kicadSymbolMetadata = parentNormal?._parsedProps?.kicadSymbolMetadata;
+    const schematic_symbol = db.schematic_symbol.insert({
       name: props.name,
-      pin_number: props.pinNumber,
-      port_hints,
-      source_component_id,
-      subcircuit_id: this.getSubcircuit()?.subcircuit_id,
-      ...portAttributesFromParent
+      metadata: kicadSymbolMetadata ? { kicad_symbol: kicadSymbolMetadata } : void 0
     });
-    this.source_port_id = source_port.source_port_id;
+    this.schematic_symbol_id = schematic_symbol.schematic_symbol_id;
   }
-  doInitialSourceParentAttachment() {
-    const { db } = this.root;
-    const parentNormalComponent = this.getParentNormalComponent();
-    const parentWithSourceId = this.parent?.source_component_id ? this.parent : parentNormalComponent;
-    if (this.isGroupPort()) {
-      db.source_port.update(this.source_port_id, {
-        source_component_id: null,
-        subcircuit_id: this.getSubcircuit()?.subcircuit_id
-      });
-      return;
+  getSchematicSymbolBounds() {
+    if (this.schematicSymbolBoundsInUserCoordinates) {
+      return this.schematicSymbolBoundsInUserCoordinates;
     }
-    if (!parentWithSourceId?.source_component_id) {
-      throw new Error(
-        `${this.getString()} has no parent source component (parent: ${this.parent?.getString()})`
-      );
+    this._computeSchematicSymbolBounds();
+    return this.schematicSymbolBoundsInUserCoordinates ?? null;
+  }
+  getUserCoordinateToResizedSymbolTransform() {
+    if (!this.hasExplicitSize()) {
+      return null;
     }
-    db.source_port.update(this.source_port_id, {
-      source_component_id: parentWithSourceId.source_component_id,
-      subcircuit_id: this.getSubcircuit()?.subcircuit_id
-    });
-    this.source_component_id = parentWithSourceId.source_component_id;
+    if (this.userCoordinateToResizedSymbolTransformMat) {
+      return this.userCoordinateToResizedSymbolTransformMat;
+    }
+    this._computeUserCoordinateToResizedSymbolTransform();
+    return this.userCoordinateToResizedSymbolTransformMat ?? null;
   }
-  doInitialPcbPortRender() {
-    if (this.root?.pcbDisabled) return;
+  _computeSchematicSymbolBounds() {
+    if (this.root?.schematicDisabled) return;
     const { db } = this.root;
-    const { matchedComponents } = this;
-    if (this.isGroupPort()) {
-      const connectedPorts = this._getConnectedPortsFromConnectsTo();
-      if (connectedPorts.length === 0) {
-        return;
-      }
-      const connectedPort = connectedPorts[0];
-      if (!connectedPort.pcb_port_id) {
-        return;
+    const schematicElements = [];
+    for (const child of this.children) {
+      if (child.componentName === "Port") {
+        const portId = child.schematic_port_id;
+        if (portId) {
+          const port = db.schematic_port.get(portId);
+          if (port) schematicElements.push(port);
+        }
+        continue;
       }
-      const connectedPcbPort = db.pcb_port.get(connectedPort.pcb_port_id);
-      const matchCenter2 = { x: connectedPcbPort.x, y: connectedPcbPort.y };
-      const subcircuit = this.getSubcircuit();
-      const pcb_port = db.pcb_port.insert({
-        pcb_component_id: void 0,
-        layers: connectedPort.getAvailablePcbLayers(),
-        subcircuit_id: subcircuit?.subcircuit_id ?? void 0,
-        pcb_group_id: this.getGroup()?.pcb_group_id ?? void 0,
-        ...matchCenter2,
-        source_port_id: this.source_port_id,
-        is_board_pinout: false
-      });
-      this.pcb_port_id = pcb_port.pcb_port_id;
-      return;
-    }
-    const parentNormalComponent = this.getParentNormalComponent();
-    const parentWithPcbComponentId = this.parent?.pcb_component_id ? this.parent : parentNormalComponent;
-    if (!parentWithPcbComponentId?.pcb_component_id) {
-      throw new Error(
-        `${this.getString()} has no parent pcb component, cannot render pcb_port (parent: ${this.parent?.getString()}, parentNormalComponent: ${parentNormalComponent?.getString()})`
-      );
-    }
-    const pcbMatches = matchedComponents.filter((c) => c.isPcbPrimitive);
-    if (pcbMatches.length === 0) return;
-    let matchCenter = null;
-    if (pcbMatches.length === 1) {
-      matchCenter = pcbMatches[0]._getPcbCircuitJsonBounds().center;
-    }
-    if (pcbMatches.length > 1) {
-      if (!areAllPcbPrimitivesOverlapping(pcbMatches)) {
-        const portName = this.props.name;
-        const componentName = this.getParentNormalComponent()?.props.name ?? "unknown";
-        const altAliases = this.getNameAndAliases().filter(
-          (h) => h !== portName
+      if (!child.isSchematicPrimitive) continue;
+      if (child.componentName === "SchematicLine") {
+        const line = db.schematic_line.get(child.schematic_line_id);
+        if (line) schematicElements.push(line);
+      } else if (child.componentName === "SchematicRect") {
+        const rect = db.schematic_rect.get(child.schematic_rect_id);
+        if (rect) schematicElements.push(rect);
+      } else if (child.componentName === "SchematicCircle") {
+        const circle = db.schematic_circle.get(
+          child.schematic_circle_id
         );
-        const altMsg = altAliases.length > 0 ? ` (consider using alternate aliases: ${altAliases.join(", ")})` : "";
-        db.source_ambiguous_port_reference.insert({
-          error_type: "source_ambiguous_port_reference",
-          message: `${componentName}.${portName} is ambiguous: ${componentName}.${portName} references multiple non-overlapping pads: ${pcbMatches.map((c) => c.getString()).join(", ")}${altMsg}`,
-          source_port_id: this.source_port_id ?? void 0,
-          source_component_id: this.getParentNormalComponent()?.source_component_id ?? void 0
-        });
-        return;
+        if (circle) schematicElements.push(circle);
+      } else if (child.componentName === "SchematicArc") {
+        const arc = db.schematic_arc.get(child.schematic_arc_id);
+        if (arc) schematicElements.push(arc);
+      } else if (child.componentName === "SchematicText") {
+        const text = db.schematic_text.get(child.schematic_text_id);
+        if (text) schematicElements.push(text);
+      } else if (child.componentName === "SchematicPath") {
+        const pathIds = child.schematic_path_ids;
+        if (pathIds) {
+          for (const pathId of pathIds) {
+            const path = db.schematic_path.get(pathId);
+            if (path) schematicElements.push(path);
+          }
+        }
       }
-      matchCenter = getCenterOfPcbPrimitives(pcbMatches);
-    }
-    if (matchCenter) {
-      const subcircuit = this.getSubcircuit();
-      const isBoardPinout = this._shouldIncludeInBoardPinout();
-      const pcb_port = db.pcb_port.insert({
-        pcb_component_id: parentWithPcbComponentId.pcb_component_id,
-        layers: this.getAvailablePcbLayers(),
-        subcircuit_id: subcircuit?.subcircuit_id ?? void 0,
-        pcb_group_id: this.getGroup()?.pcb_group_id ?? void 0,
-        ...isBoardPinout ? { is_board_pinout: true } : {},
-        ...matchCenter,
-        source_port_id: this.source_port_id,
-        is_board_pinout: this._isBoardPinoutFromAttributes()
-      });
-      this.pcb_port_id = pcb_port.pcb_port_id;
-    } else {
-      const pcbMatch = pcbMatches[0];
-      throw new Error(
-        `${pcbMatch.getString()} does not have a center or _getGlobalPcbPositionBeforeLayout method (needed for pcb_port placement)`
-      );
     }
+    if (schematicElements.length === 0) return;
+    const bounds = getBoundsForSchematic(schematicElements);
+    this.schematicSymbolBoundsInUserCoordinates = bounds;
   }
-  updatePcbPortRender() {
-    if (this.root?.pcbDisabled) return;
-    const { db } = this.root;
-    if (this.pcb_port_id) return;
-    if (this.isGroupPort()) {
-      const connectedPorts = this._getConnectedPortsFromConnectsTo();
-      if (connectedPorts.length === 0) return;
-      const connectedPort = connectedPorts[0];
-      if (!connectedPort.pcb_port_id) return;
-      const connectedPcbPort = db.pcb_port.get(connectedPort.pcb_port_id);
-      const matchCenter2 = { x: connectedPcbPort.x, y: connectedPcbPort.y };
-      const subcircuit2 = this.getSubcircuit();
-      const pcb_port2 = db.pcb_port.insert({
-        pcb_component_id: void 0,
-        layers: connectedPort.getAvailablePcbLayers(),
-        subcircuit_id: subcircuit2?.subcircuit_id ?? void 0,
-        pcb_group_id: this.getGroup()?.pcb_group_id ?? void 0,
-        ...matchCenter2,
-        source_port_id: this.source_port_id,
-        is_board_pinout: false
-      });
-      this.pcb_port_id = pcb_port2.pcb_port_id;
-      return;
-    }
-    const pcbMatches = this.matchedComponents.filter((c) => c.isPcbPrimitive);
-    if (pcbMatches.length === 0) return;
-    let matchCenter = null;
-    if (pcbMatches.length === 1) {
-      matchCenter = pcbMatches[0]._getPcbCircuitJsonBounds().center;
-    }
-    if (pcbMatches.length > 1) {
-      try {
-        if (areAllPcbPrimitivesOverlapping(pcbMatches)) {
-          matchCenter = getCenterOfPcbPrimitives(pcbMatches);
-        }
-      } catch {
-      }
+  _computeUserCoordinateToResizedSymbolTransform() {
+    const bounds = this.getSchematicSymbolBounds();
+    if (!bounds) return;
+    const { _parsedProps: props } = this;
+    const targetWidth = props.width;
+    const targetHeight = props.height;
+    if (targetWidth === void 0 && targetHeight === void 0) return;
+    const currentWidth = bounds.maxX - bounds.minX;
+    const currentHeight = bounds.maxY - bounds.minY;
+    if (currentWidth === 0 && currentHeight === 0) return;
+    const currentCenterX = (bounds.minX + bounds.maxX) / 2;
+    const currentCenterY = (bounds.minY + bounds.maxY) / 2;
+    const scaleX = targetWidth !== void 0 && currentWidth > 0 ? targetWidth / currentWidth : 1;
+    const scaleY = targetHeight !== void 0 && currentHeight > 0 ? targetHeight / currentHeight : 1;
+    const globalPos = this._getGlobalSchematicPositionBeforeLayout();
+    this.userCoordinateToResizedSymbolTransformMat = compose4(
+      translate3(globalPos.x, globalPos.y),
+      scale(scaleX, scaleY),
+      translate3(-currentCenterX, -currentCenterY)
+    );
+  }
+};
+
+// lib/utils/createPinrowSilkscreenText.ts
+var createPinrowSilkscreenText = ({
+  elm,
+  pinLabels,
+  layer,
+  readableRotation,
+  anchorAlignment
+}) => {
+  const pinNum = elm.text.replace(/[{}]/g, "").toLowerCase();
+  let label = pinNum;
+  if (Array.isArray(pinLabels)) {
+    const index = parseInt(pinNum.replace(/[^\d]/g, ""), 10) - 1;
+    label = String(pinLabels[index] ?? pinNum);
+  } else if (typeof pinLabels === "object") {
+    label = String(pinLabels[pinNum] ?? pinNum);
+  }
+  const silkscreenText = new SilkscreenText({
+    anchorAlignment: anchorAlignment || "center",
+    text: label ?? pinNum,
+    layer: layer || "top",
+    pcbX: isNaN(elm.anchor_position.x) ? 0 : elm.anchor_position.x,
+    pcbY: elm.anchor_position.y,
+    pcbRotation: readableRotation ?? 0
+  });
+  silkscreenText._footprinterFontSize = elm.font_size + 0.2;
+  return silkscreenText;
+};
+
+// lib/utils/createComponentsFromCircuitJson.ts
+var calculateCcwRotation = (componentRotationStr, elementCcwRotation) => {
+  const componentAngle = parseInt(componentRotationStr || "0", 10);
+  let totalRotation;
+  if (elementCcwRotation !== void 0 && elementCcwRotation !== null) {
+    totalRotation = elementCcwRotation - componentAngle;
+  } else {
+    totalRotation = componentAngle;
+  }
+  const normalizedRotation = (totalRotation % 360 + 360) % 360;
+  return normalizedRotation;
+};
+var optional = (value) => value ?? void 0;
+var getFacingDirectionFromSide = (side) => {
+  switch (side) {
+    case "left":
+    case "right":
+      return side;
+    case "top":
+      return "up";
+    case "bottom":
+      return "down";
+  }
+  return null;
+};
+var schematicPrimitiveTypesWithStrokeWidth = [
+  "schematic_line",
+  "schematic_rect",
+  "schematic_circle",
+  "schematic_arc",
+  "schematic_path"
+];
+var isSchematicPrimitiveWithStrokeWidth = (elm) => schematicPrimitiveTypesWithStrokeWidth.includes(
+  elm.type
+);
+var getSchematicSymbolId = (elm) => {
+  if (!("schematic_symbol_id" in elm)) return void 0;
+  return typeof elm.schematic_symbol_id === "string" ? elm.schematic_symbol_id : void 0;
+};
+var createComponentsFromCircuitJson = ({
+  componentName,
+  componentRotation,
+  footprinterString,
+  pinLabels,
+  pcbPinLabels
+}, circuitJson) => {
+  const components = [];
+  const schematicSymbolsByImportedId = /* @__PURE__ */ new Map();
+  const schematicComponentsByImportedId = /* @__PURE__ */ new Map();
+  const sourcePortsByImportedId = /* @__PURE__ */ new Map();
+  const schematicStrokeWidthBySymbolId = /* @__PURE__ */ new Map();
+  for (const elm of circuitJson) {
+    if (elm.type === "source_port") {
+      sourcePortsByImportedId.set(elm.source_port_id, elm);
     }
-    if (!matchCenter) return;
-    const parentNormalComponent = this.getParentNormalComponent();
-    const parentWithPcbComponentId = this.parent?.pcb_component_id ? this.parent : parentNormalComponent;
-    const subcircuit = this.getSubcircuit();
-    const isBoardPinout = this._shouldIncludeInBoardPinout();
-    const pcb_port = db.pcb_port.insert({
-      pcb_component_id: parentWithPcbComponentId?.pcb_component_id,
-      layers: this.getAvailablePcbLayers(),
-      subcircuit_id: subcircuit?.subcircuit_id ?? void 0,
-      pcb_group_id: this.getGroup()?.pcb_group_id ?? void 0,
-      ...isBoardPinout ? { is_board_pinout: true } : {},
-      ...matchCenter,
-      source_port_id: this.source_port_id,
-      is_board_pinout: this._isBoardPinoutFromAttributes()
+  }
+  for (const elm of circuitJson) {
+    if (elm.type !== "schematic_symbol") continue;
+    const schematicSymbol = new SymbolComponent({
+      name: elm.name
     });
-    this.pcb_port_id = pcb_port.pcb_port_id;
+    schematicSymbolsByImportedId.set(elm.schematic_symbol_id, schematicSymbol);
+    components.push(schematicSymbol);
   }
-  /**
-   * Get the best display label for this port based on port_hints
-   * Filters out generic patterns and applies showPinAliases logic
-   */
-  _getBestDisplayPinLabel() {
-    const { db } = this.root;
-    const sourcePort = db.source_port.get(this.source_port_id);
-    const labelHints = [];
-    for (const portHint of sourcePort?.port_hints ?? []) {
-      if (portHint.match(/^(pin)?\d+$/)) continue;
-      if (portHint.match(/^(left|right)/) && !sourcePort?.name.match(/^(left|right)/))
-        continue;
-      labelHints.push(portHint);
+  for (const elm of circuitJson) {
+    if (!isSchematicPrimitiveWithStrokeWidth(elm)) continue;
+    const schematicSymbolId = getSchematicSymbolId(elm);
+    const strokeWidth = elm.stroke_width;
+    if (!schematicSymbolId || typeof strokeWidth !== "number" || !Number.isFinite(strokeWidth) || schematicStrokeWidthBySymbolId.has(schematicSymbolId)) {
+      continue;
     }
-    const parentNormalComponent = this.getParentNormalComponent();
-    const showPinAliases = parentNormalComponent?.props?.showPinAliases;
-    if (showPinAliases && labelHints.length > 0) {
-      return labelHints.join("/");
-    } else if (labelHints.length > 0) {
-      return labelHints[0];
+    schematicStrokeWidthBySymbolId.set(schematicSymbolId, strokeWidth);
+  }
+  for (const elm of circuitJson) {
+    if (elm.type !== "schematic_component") continue;
+    schematicComponentsByImportedId.set(elm.schematic_component_id, elm);
+  }
+  const addSchematicPrimitive = (elm, primitive) => {
+    const schematicSymbolId = getSchematicSymbolId(elm);
+    const parentSymbol = schematicSymbolId ? schematicSymbolsByImportedId.get(schematicSymbolId) : void 0;
+    if (parentSymbol) {
+      parentSymbol.add(primitive);
+    } else {
+      components.push(primitive);
+    }
+  };
+  for (const elm of circuitJson) {
+    if (elm.type === "pcb_smtpad" && elm.shape === "rect") {
+      components.push(
+        new SmtPad({
+          pcbX: elm.x,
+          pcbY: elm.y,
+          layer: elm.layer,
+          shape: "rect",
+          height: elm.height,
+          width: elm.width,
+          portHints: elm.port_hints,
+          rectBorderRadius: elm.rect_border_radius
+        })
+      );
+    } else if (elm.type === "pcb_smtpad" && elm.shape === "circle") {
+      components.push(
+        new SmtPad({
+          pcbX: elm.x,
+          pcbY: elm.y,
+          layer: elm.layer,
+          shape: "circle",
+          radius: elm.radius,
+          portHints: elm.port_hints
+        })
+      );
+    } else if (elm.type === "pcb_smtpad" && elm.shape === "pill") {
+      components.push(
+        new SmtPad({
+          shape: "pill",
+          height: elm.height,
+          width: elm.width,
+          radius: elm.radius,
+          portHints: elm.port_hints,
+          pcbX: elm.x,
+          pcbY: elm.y,
+          layer: elm.layer
+        })
+      );
+    } else if (elm.type === "pcb_smtpad" && elm.shape === "polygon") {
+      components.push(
+        new SmtPad({
+          shape: "polygon",
+          points: elm.points,
+          portHints: elm.port_hints,
+          layer: elm.layer
+        })
+      );
+    } else if (elm.type === "pcb_silkscreen_path") {
+      components.push(
+        new SilkscreenPath({
+          layer: elm.layer,
+          route: elm.route,
+          strokeWidth: elm.stroke_width
+        })
+      );
+    } else if (elm.type === "pcb_copper_text") {
+      components.push(
+        new CopperText({
+          text: elm.text,
+          pcbX: elm.anchor_position.x,
+          pcbY: elm.anchor_position.y,
+          pcbRotation: elm.ccw_rotation,
+          anchorAlignment: elm.anchor_alignment,
+          fontSize: elm.font_size,
+          layer: elm.layer,
+          mirrored: elm.is_mirrored,
+          knockout: elm.is_knockout
+        })
+      );
+    } else if (elm.type === "pcb_plated_hole") {
+      if (elm.shape === "circle") {
+        components.push(
+          new PlatedHole({
+            pcbX: elm.x,
+            pcbY: elm.y,
+            shape: "circle",
+            holeDiameter: elm.hole_diameter,
+            outerDiameter: elm.outer_diameter,
+            portHints: elm.port_hints
+          })
+        );
+      } else if (elm.shape === "circular_hole_with_rect_pad") {
+        components.push(
+          new PlatedHole({
+            pcbX: elm.x,
+            pcbY: elm.y,
+            shape: "circular_hole_with_rect_pad",
+            holeDiameter: elm.hole_diameter,
+            rectPadHeight: elm.rect_pad_height,
+            rectPadWidth: elm.rect_pad_width,
+            portHints: elm.port_hints,
+            rectBorderRadius: elm.rect_border_radius,
+            holeOffsetX: elm.hole_offset_x,
+            holeOffsetY: elm.hole_offset_y
+          })
+        );
+      } else if (elm.shape === "pill" || elm.shape === "oval") {
+        components.push(
+          new PlatedHole({
+            pcbX: elm.x,
+            pcbY: elm.y,
+            shape: elm.shape,
+            holeWidth: elm.hole_width,
+            holeHeight: elm.hole_height,
+            outerWidth: elm.outer_width,
+            outerHeight: elm.outer_height,
+            portHints: elm.port_hints
+          })
+        );
+      } else if (elm.shape === "pill_hole_with_rect_pad") {
+        components.push(
+          new PlatedHole({
+            pcbX: elm.x,
+            pcbY: elm.y,
+            shape: "pill_hole_with_rect_pad",
+            holeShape: "pill",
+            padShape: "rect",
+            holeWidth: elm.hole_width,
+            holeHeight: elm.hole_height,
+            rectPadWidth: elm.rect_pad_width,
+            rectPadHeight: elm.rect_pad_height,
+            rectBorderRadius: elm.rect_border_radius,
+            portHints: elm.port_hints,
+            holeOffsetX: elm.hole_offset_x,
+            holeOffsetY: elm.hole_offset_y
+          })
+        );
+      } else if (elm.shape === "rotated_pill_hole_with_rect_pad") {
+        components.push(
+          new PlatedHole({
+            pcbX: elm.x,
+            pcbY: elm.y,
+            shape: "pill_hole_with_rect_pad",
+            holeShape: "pill",
+            padShape: "rect",
+            holeWidth: elm.hole_width,
+            holeHeight: elm.hole_height,
+            rectPadWidth: elm.rect_pad_width,
+            rectPadHeight: elm.rect_pad_height,
+            rectBorderRadius: elm.rect_border_radius,
+            portHints: elm.port_hints,
+            holeOffsetX: elm.hole_offset_x,
+            holeOffsetY: elm.hole_offset_y,
+            pcbRotation: elm.hole_ccw_rotation
+          })
+        );
+      } else if (elm.shape === "hole_with_polygon_pad") {
+        components.push(
+          new PlatedHole({
+            pcbX: elm.x,
+            pcbY: elm.y,
+            shape: "hole_with_polygon_pad",
+            holeShape: elm.hole_shape || "circle",
+            holeDiameter: elm.hole_diameter,
+            holeWidth: elm.hole_width,
+            holeHeight: elm.hole_height,
+            padOutline: elm.pad_outline || [],
+            holeOffsetX: elm.hole_offset_x,
+            holeOffsetY: elm.hole_offset_y,
+            portHints: elm.port_hints
+          })
+        );
+      }
+    } else if (elm.type === "pcb_keepout" && elm.shape === "circle") {
+      components.push(
+        new Keepout({
+          pcbX: elm.center.x,
+          pcbY: elm.center.y,
+          shape: "circle",
+          radius: elm.radius
+        })
+      );
+    } else if (elm.type === "pcb_keepout" && elm.shape === "rect") {
+      components.push(
+        new Keepout({
+          pcbX: elm.center.x,
+          pcbY: elm.center.y,
+          shape: "rect",
+          width: elm.width,
+          height: elm.height
+        })
+      );
+    } else if (elm.type === "pcb_hole" && elm.hole_shape === "circle") {
+      components.push(
+        new Hole({
+          pcbX: elm.x,
+          pcbY: elm.y,
+          diameter: elm.hole_diameter
+        })
+      );
+    } else if (elm.type === "pcb_hole" && elm.hole_shape === "rect") {
+      components.push(
+        new Hole({
+          pcbX: elm.x,
+          pcbY: elm.y,
+          shape: "rect",
+          width: elm.hole_width,
+          height: elm.hole_height
+        })
+      );
+    } else if (elm.type === "pcb_hole" && elm.hole_shape === "pill") {
+      components.push(
+        new Hole({
+          pcbX: elm.x,
+          pcbY: elm.y,
+          shape: "pill",
+          width: elm.hole_width,
+          height: elm.hole_height
+        })
+      );
+    } else if (elm.type === "pcb_hole" && elm.hole_shape === "oval") {
+      components.push(
+        new Hole({
+          pcbX: elm.x,
+          pcbY: elm.y,
+          shape: "oval",
+          width: elm.hole_width,
+          height: elm.hole_height
+        })
+      );
+    } else if (elm.type === "pcb_hole" && elm.hole_shape === "rotated_pill") {
+      components.push(
+        new Hole({
+          pcbX: elm.x,
+          pcbY: elm.y,
+          shape: "pill",
+          width: elm.hole_width,
+          height: elm.hole_height,
+          pcbRotation: elm.ccw_rotation
+        })
+      );
+    } else if (elm.type === "pcb_cutout") {
+      if (elm.shape === "rect") {
+        components.push(
+          new Cutout({
+            pcbX: elm.center.x,
+            pcbY: elm.center.y,
+            shape: "rect",
+            width: elm.width,
+            height: elm.height
+          })
+        );
+      } else if (elm.shape === "circle") {
+        components.push(
+          new Cutout({
+            pcbX: elm.center.x,
+            pcbY: elm.center.y,
+            shape: "circle",
+            radius: elm.radius
+          })
+        );
+      } else if (elm.shape === "polygon") {
+        components.push(
+          new Cutout({
+            shape: "polygon",
+            points: elm.points
+          })
+        );
+      }
+    } else if (elm.type === "pcb_silkscreen_text") {
+      const ccwRotation = calculateCcwRotation(
+        componentRotation,
+        elm.ccw_rotation
+      );
+      if (footprinterString?.includes("pinrow") && elm.text.includes("PIN")) {
+        components.push(
+          createPinrowSilkscreenText({
+            elm,
+            pinLabels: pcbPinLabels ?? pinLabels ?? {},
+            layer: elm.layer,
+            readableRotation: ccwRotation,
+            anchorAlignment: elm.anchor_alignment
+          })
+        );
+      } else {
+        const silkscreenText = new SilkscreenText({
+          anchorAlignment: elm.anchor_alignment || "center",
+          text: componentName || elm.text,
+          pcbX: Number.isNaN(elm.anchor_position.x) ? 0 : elm.anchor_position.x,
+          pcbY: elm.anchor_position.y,
+          pcbRotation: ccwRotation ?? 0
+        });
+        silkscreenText._footprinterFontSize = elm.font_size + 0.2;
+        components.push(silkscreenText);
+      }
+    } else if (elm.type === "pcb_trace") {
+      components.push(
+        new PcbTrace({
+          route: elm.route
+        })
+      );
+    } else if (elm.type === "pcb_via") {
+      const layers = elm.layers ?? [];
+      const pcbVia = new PcbVia({
+        pcbX: elm.x,
+        pcbY: elm.y,
+        holeDiameter: elm.hole_diameter,
+        outerDiameter: elm.outer_diameter,
+        fromLayer: elm.from_layer ?? layers[0],
+        toLayer: elm.to_layer ?? layers[layers.length - 1],
+        layers,
+        netIsAssignable: elm.net_is_assignable,
+        isTented: elm.is_tented
+      });
+      pcbVia._importedPcbTraceId = elm.pcb_trace_id;
+      components.push(pcbVia);
+    } else if (elm.type === "pcb_silkscreen_rect") {
+      components.push(
+        new SilkscreenRect({
+          pcbX: elm.center.x,
+          pcbY: elm.center.y,
+          width: elm.width,
+          height: elm.height,
+          layer: elm.layer,
+          strokeWidth: elm.stroke_width,
+          filled: elm.is_filled,
+          cornerRadius: elm.corner_radius
+        })
+      );
+    } else if (elm.type === "pcb_silkscreen_circle") {
+      components.push(
+        new SilkscreenCircle({
+          pcbX: elm.center.x,
+          pcbY: elm.center.y,
+          radius: elm.radius,
+          layer: elm.layer,
+          strokeWidth: elm.stroke_width
+        })
+      );
+    } else if (elm.type === "pcb_silkscreen_line") {
+      components.push(
+        new SilkscreenLine({
+          x1: elm.x1,
+          y1: elm.y1,
+          x2: elm.x2,
+          y2: elm.y2,
+          layer: elm.layer,
+          strokeWidth: elm.stroke_width
+        })
+      );
+    } else if (elm.type === "pcb_fabrication_note_text") {
+      components.push(
+        new FabricationNoteText({
+          pcbX: elm.anchor_position.x,
+          pcbY: elm.anchor_position.y,
+          text: elm.text,
+          fontSize: elm.font_size,
+          anchorAlignment: elm.anchor_alignment,
+          color: elm.color,
+          font: elm.font
+        })
+      );
+    } else if (elm.type === "pcb_fabrication_note_path") {
+      components.push(
+        new FabricationNotePath({
+          route: elm.route,
+          strokeWidth: elm.stroke_width,
+          color: elm.color,
+          layer: elm.layer
+        })
+      );
+    } else if (elm.type === "pcb_fabrication_note_rect") {
+      components.push(
+        new FabricationNoteRect({
+          pcbX: elm.center.x,
+          pcbY: elm.center.y,
+          width: elm.width,
+          height: elm.height,
+          strokeWidth: elm.stroke_width,
+          isFilled: elm.is_filled,
+          color: elm.color,
+          layer: elm.layer,
+          cornerRadius: elm.corner_radius,
+          hasStroke: elm.has_stroke,
+          isStrokeDashed: elm.is_stroke_dashed
+        })
+      );
+    } else if (elm.type === "pcb_note_text") {
+      components.push(
+        new PcbNoteText({
+          pcbX: elm.anchor_position.x,
+          pcbY: elm.anchor_position.y,
+          text: elm.text ?? "",
+          fontSize: elm.font_size,
+          anchorAlignment: elm.anchor_alignment,
+          color: elm.color,
+          font: elm.font
+        })
+      );
+    } else if (elm.type === "pcb_note_rect") {
+      components.push(
+        new PcbNoteRect({
+          pcbX: elm.center.x,
+          pcbY: elm.center.y,
+          width: elm.width,
+          height: elm.height,
+          strokeWidth: elm.stroke_width,
+          isFilled: elm.is_filled,
+          color: elm.color,
+          cornerRadius: elm.corner_radius,
+          hasStroke: elm.has_stroke,
+          isStrokeDashed: elm.is_stroke_dashed
+        })
+      );
+    } else if (elm.type === "pcb_note_path") {
+      components.push(
+        new PcbNotePath({
+          route: elm.route,
+          strokeWidth: elm.stroke_width,
+          color: elm.color
+        })
+      );
+    } else if (elm.type === "pcb_note_line") {
+      components.push(
+        new PcbNoteLine({
+          x1: elm.x1,
+          y1: elm.y1,
+          x2: elm.x2,
+          y2: elm.y2,
+          strokeWidth: elm.stroke_width,
+          color: elm.color,
+          isDashed: elm.is_dashed
+        })
+      );
+    } else if (elm.type === "pcb_courtyard_rect") {
+      components.push(
+        new CourtyardRect({
+          pcbX: elm.center.x,
+          pcbY: elm.center.y,
+          width: elm.width,
+          height: elm.height,
+          layer: elm.layer
+        })
+      );
+    } else if (elm.type === "pcb_courtyard_circle") {
+      components.push(
+        new CourtyardCircle({
+          pcbX: elm.center.x,
+          pcbY: elm.center.y,
+          radius: elm.radius,
+          layer: elm.layer
+        })
+      );
+    } else if (elm.type === "pcb_courtyard_outline") {
+      components.push(
+        new CourtyardOutline({
+          outline: elm.outline,
+          layer: elm.layer
+        })
+      );
+    } else if (elm.type === "schematic_line") {
+      addSchematicPrimitive(
+        elm,
+        new SchematicLine({
+          x1: elm.x1,
+          y1: elm.y1,
+          x2: elm.x2,
+          y2: elm.y2,
+          strokeWidth: optional(elm.stroke_width),
+          color: elm.color,
+          isDashed: elm.is_dashed
+        })
+      );
+    } else if (elm.type === "schematic_rect") {
+      addSchematicPrimitive(
+        elm,
+        new SchematicRect({
+          schX: elm.center.x,
+          schY: elm.center.y,
+          width: elm.width,
+          height: elm.height,
+          rotation: elm.rotation,
+          strokeWidth: optional(elm.stroke_width),
+          color: elm.color,
+          isFilled: elm.is_filled,
+          fillColor: elm.fill_color,
+          isDashed: elm.is_dashed
+        })
+      );
+    } else if (elm.type === "schematic_circle") {
+      addSchematicPrimitive(
+        elm,
+        new SchematicCircle({
+          center: elm.center,
+          radius: elm.radius,
+          strokeWidth: optional(elm.stroke_width),
+          color: elm.color,
+          isFilled: elm.is_filled,
+          fillColor: elm.fill_color,
+          isDashed: elm.is_dashed
+        })
+      );
+    } else if (elm.type === "schematic_arc") {
+      addSchematicPrimitive(
+        elm,
+        new SchematicArc({
+          center: elm.center,
+          radius: elm.radius,
+          startAngleDegrees: elm.start_angle_degrees,
+          endAngleDegrees: elm.end_angle_degrees,
+          direction: elm.direction,
+          strokeWidth: optional(elm.stroke_width),
+          color: elm.color,
+          isDashed: elm.is_dashed
+        })
+      );
+    } else if (elm.type === "schematic_text") {
+      addSchematicPrimitive(
+        elm,
+        new SchematicText({
+          schX: elm.position.x,
+          schY: elm.position.y,
+          text: elm.text,
+          fontSize: elm.font_size,
+          anchor: elm.anchor,
+          color: elm.color,
+          schRotation: elm.rotation
+        })
+      );
+    } else if (elm.type === "schematic_path") {
+      addSchematicPrimitive(
+        elm,
+        new SchematicPath({
+          points: elm.points,
+          strokeWidth: optional(elm.stroke_width),
+          strokeColor: elm.stroke_color,
+          dashLength: elm.dash_length,
+          dashGap: elm.dash_gap,
+          isFilled: elm.is_filled,
+          fillColor: elm.fill_color
+        })
+      );
+    } else if (elm.type === "schematic_port") {
+      const schematicComponentId = elm.schematic_component_id;
+      if (typeof schematicComponentId !== "string") continue;
+      const schematicComponent = schematicComponentsByImportedId.get(schematicComponentId);
+      const schematicSymbolId = schematicComponent?.schematic_symbol_id;
+      const parentSymbol = typeof schematicSymbolId === "string" ? schematicSymbolsByImportedId.get(schematicSymbolId) : void 0;
+      if (parentSymbol && schematicComponent?.is_box_with_pins === true && elm.center && elm.side_of_component) {
+        const distance19 = elm.distance_from_component_edge;
+        const facingDirection = getFacingDirectionFromSide(
+          elm.side_of_component
+        );
+        if (!facingDirection) continue;
+        const directionVector = getUnitVectorFromDirection2(facingDirection);
+        const stemDirection = elm.facing_direction === facingDirection ? 1 : -1;
+        const portCenter = {
+          x: elm.center.x + directionVector.x * distance19 * stemDirection,
+          y: elm.center.y + directionVector.y * distance19 * stemDirection
+        };
+        const sourcePort = sourcePortsByImportedId.get(elm.source_port_id);
+        const aliases = Array.from(
+          new Set(
+            [
+              elm.display_pin_label,
+              sourcePort?.name,
+              ...sourcePort?.port_hints ?? []
+            ].filter(
+              (alias) => typeof alias === "string" && alias.length > 0
+            )
+          )
+        );
+        const fallbackPortName = elm.pin_number ? `pin${elm.pin_number}` : elm.schematic_port_id;
+        const portName = aliases[0] ?? elm.source_port_id ?? fallbackPortName;
+        parentSymbol.add(
+          new Port({
+            pinNumber: elm.pin_number,
+            name: portName,
+            aliases,
+            schX: elm.center.x,
+            schY: elm.center.y,
+            direction: facingDirection
+          })
+        );
+        parentSymbol.add(
+          new SchematicLine({
+            x1: elm.center.x,
+            y1: elm.center.y,
+            x2: portCenter.x,
+            y2: portCenter.y,
+            strokeWidth: typeof schematicSymbolId === "string" ? optional(
+              schematicStrokeWidthBySymbolId.get(schematicSymbolId)
+            ) : void 0,
+            isDashed: false
+          })
+        );
+      }
     }
-    return void 0;
   }
-  doInitialSchematicPortRender() {
-    const collapsedAncestor = this.getCollapsedSchematicBoxAncestor();
-    if (collapsedAncestor && this.parent !== collapsedAncestor) return;
-    const { db } = this.root;
-    const { _parsedProps: props } = this;
-    const { schX, schY } = props;
-    const container = schX !== void 0 && schY !== void 0 ? this.getParentNormalComponent() : this.getPrimitiveContainer();
-    if (!container) return;
-    if (!this._hasSchematicPort()) return;
-    const containerCenter = container._getGlobalSchematicPositionBeforeLayout();
-    const portCenter = this._getGlobalSchematicPositionBeforeLayout();
-    let localPortInfo = null;
-    const containerDims = container._getSchematicBoxDimensions();
-    if (containerDims && props.pinNumber !== void 0) {
-      localPortInfo = containerDims.getPortPositionByPinNumber(props.pinNumber);
-    }
-    if (this.getSubcircuit().props._schDebugObjectsEnabled) {
-      db.schematic_debug_object.insert({
-        shape: "rect",
-        center: portCenter,
-        size: {
-          width: 0.1,
-          height: 0.1
-        },
-        label: "obstacle"
-      });
-    }
-    if (!localPortInfo?.side) {
-      this.facingDirection = getRelativeDirection(containerCenter, portCenter);
-    } else {
-      this.facingDirection = {
-        left: "left",
-        right: "right",
-        top: "up",
-        bottom: "down"
-      }[localPortInfo.side];
-    }
-    const bestDisplayPinLabel = this._getBestDisplayPinLabel();
-    const parentNormalComponent = this.getParentNormalComponent();
-    const sideOfComponent = localPortInfo?.side ?? (props.direction === "up" ? "top" : props.direction === "down" ? "bottom" : props.direction);
-    const schematicPortInsertProps = {
-      type: "schematic_port",
-      schematic_component_id: parentNormalComponent?.schematic_component_id,
-      center: portCenter,
-      source_port_id: this.source_port_id,
-      facing_direction: this.facingDirection,
-      distance_from_component_edge: props.schStemLength ?? 0.4,
-      side_of_component: sideOfComponent,
-      pin_number: props.pinNumber,
-      true_ccw_index: localPortInfo?.trueIndex,
-      display_pin_label: bestDisplayPinLabel,
-      is_connected: false
+  return components;
+};
+
+// lib/utils/filterPinLabels.ts
+import { chipProps } from "@tscircuit/props";
+function filterPinLabels(pinLabels) {
+  if (!pinLabels)
+    return {
+      validPinLabels: pinLabels,
+      invalidPinLabelsMessages: []
     };
-    for (const attributes of this._getMatchingPinAttributes()) {
-      if (attributes.requiresPower) {
-        schematicPortInsertProps.has_input_arrow = true;
-      }
-      if (attributes.providesPower) {
-        schematicPortInsertProps.has_output_arrow = true;
+  const validPinLabels = {};
+  const invalidPinLabelsMessages = [];
+  for (const [pin, labelOrLabels] of Object.entries(pinLabels)) {
+    const labels = Array.isArray(labelOrLabels) ? labelOrLabels.slice() : [labelOrLabels];
+    const validLabels = [];
+    for (const label of labels) {
+      if (isValidPinLabel(pin, label)) {
+        validLabels.push(label);
+      } else {
+        invalidPinLabelsMessages.push(
+          `Invalid pin label: ${pin} = '${label}' - excluding from component. Pin labels can only contain letters, numbers and underscores.`
+        );
       }
     }
-    const schematic_port = db.schematic_port.insert(schematicPortInsertProps);
-    this.schematic_port_id = schematic_port.schematic_port_id;
-    if (props.schStemLength !== void 0 && props.schStemLength !== 0) {
-      const { schStemLength, direction } = props;
-      let x2 = portCenter.x;
-      let y2 = portCenter.y;
-      if (direction === "right") x2 -= schStemLength;
-      else if (direction === "left") x2 += schStemLength;
-      else if (direction === "up") y2 -= schStemLength;
-      else if (direction === "down") y2 += schStemLength;
-      const stemLine = db.schematic_line.insert({
-        schematic_component_id: parentNormalComponent?.schematic_component_id,
-        x1: portCenter.x,
-        y1: portCenter.y,
-        x2,
-        y2,
-        stroke_width: 0.02,
-        color: SCHEMATIC_COMPONENT_OUTLINE_COLOR,
-        is_dashed: false
-      });
-      this.schematic_stem_line_id = stemLine.schematic_line_id;
+    if (validLabels.length > 0) {
+      validPinLabels[pin] = Array.isArray(labelOrLabels) ? validLabels : validLabels[0];
     }
   }
-  doInitialSchematicSymbolResize() {
-    if (this.root?.schematicDisabled) return;
-    if (!this.schematic_port_id) return;
-    const symbol = this._getSymbolAncestor();
-    const transform = symbol?.getUserCoordinateToResizedSymbolTransform();
-    if (!transform) return;
-    const { db } = this.root;
-    const schPort = db.schematic_port.get(this.schematic_port_id);
-    if (schPort) {
-      const newCenter = applyToPoint22(transform, schPort.center);
-      db.schematic_port.update(this.schematic_port_id, {
-        center: newCenter
-      });
-      if (this.schematic_stem_line_id) {
-        const line = db.schematic_line.get(this.schematic_stem_line_id);
-        if (line) {
-          const p1 = applyToPoint22(transform, { x: line.x1, y: line.y1 });
-          const p2 = applyToPoint22(transform, { x: line.x2, y: line.y2 });
-          db.schematic_line.update(this.schematic_stem_line_id, {
-            x1: p1.x,
-            y1: p1.y,
-            x2: p2.x,
-            y2: p2.y
-          });
-          const scaledStemLength = Math.sqrt(
-            (p1.x - p2.x) ** 2 + (p1.y - p2.y) ** 2
-          );
-          db.schematic_port.update(this.schematic_port_id, {
-            distance_from_component_edge: scaledStemLength
-          });
-        }
+  return {
+    validPinLabels: Object.keys(validPinLabels).length > 0 ? validPinLabels : void 0,
+    invalidPinLabelsMessages
+  };
+}
+function isValidPinLabel(pin, label) {
+  try {
+    const testProps = {
+      name: "test",
+      footprint: "test",
+      pinLabels: { [pin]: label }
+    };
+    const result = chipProps.safeParse(testProps);
+    return result.success;
+  } catch (error) {
+    return false;
+  }
+}
+
+// lib/utils/get-bounds-of-pcb-components.ts
+var NON_PHYSICAL_PCB_PRIMITIVE_PREFIXES = [
+  "Silkscreen",
+  "PcbNote",
+  "Courtyard",
+  "FabricationNote"
+];
+function getBoundsOfPcbComponents(components) {
+  let minX = Infinity;
+  let minY = Infinity;
+  let maxX = -Infinity;
+  let maxY = -Infinity;
+  let hasValidComponents = false;
+  for (const child of components) {
+    if (child.isPcbPrimitive && !NON_PHYSICAL_PCB_PRIMITIVE_PREFIXES.some(
+      (prefix) => child.componentName.startsWith(prefix)
+    )) {
+      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);
+      maxX = Math.max(maxX, x + width2 / 2);
+      maxY = Math.max(maxY, y + height2 / 2);
+      hasValidComponents = true;
+    } else if (child.children.length > 0) {
+      const childBounds = getBoundsOfPcbComponents(child.children);
+      if (childBounds.width > 0 || childBounds.height > 0) {
+        minX = Math.min(minX, childBounds.minX);
+        minY = Math.min(minY, childBounds.minY);
+        maxX = Math.max(maxX, childBounds.maxX);
+        maxY = Math.max(maxY, childBounds.maxY);
+        hasValidComponents = true;
       }
     }
   }
-  _getSubcircuitConnectivityKey() {
-    return this.root?.db.source_port.get(this.source_port_id)?.subcircuit_connectivity_map_key;
-  }
-  _setPositionFromLayout(newCenter) {
-    const { db } = this.root;
-    if (!this.pcb_port_id) return;
-    db.pcb_port.update(this.pcb_port_id, {
-      x: newCenter.x,
-      y: newCenter.y
-    });
-  }
-  _hasMatchedPcbPrimitive() {
-    return this.matchedComponents.some((c) => c.isPcbPrimitive);
-  }
-  /**
-   * Return the text that should be used for the net label for this port if a
-   * trace can't be drawn. This net label text usually doesn't appear at this
-   * port, but appears at the port it connects to.
-   */
-  _getNetLabelText() {
-    return `${this.parent?.props.name}_${this.props.name}`;
+  if (!hasValidComponents) {
+    return {
+      minX: 0,
+      minY: 0,
+      maxX: 0,
+      maxY: 0,
+      width: 0,
+      height: 0
+    };
   }
-};
+  let width = maxX - minX;
+  let height = maxY - minY;
+  if (width < 0) width = 0;
+  if (height < 0) height = 0;
+  return {
+    minX,
+    minY,
+    maxX,
+    maxY,
+    width,
+    height
+  };
+}
 
 // lib/utils/getPortFromHints.ts
 var getPinNumberFromLabels = (labels) => {
@@ -18960,11 +18990,7 @@ function createSchematicTraceSolverInputProblem(group) {
   const directConnections = [];
   const connectedPairKeys = /* @__PURE__ */ new Set();
   const connKeysWithExplicitPortNetTraces = /* @__PURE__ */ new Set();
-  for (const trace of traces) {
-    if (trace.parent !== group) continue;
-    const sourceTraceId = trace.source_trace_id;
-    if (!sourceTraceId) continue;
-    const sourceTrace = db.source_trace.get(sourceTraceId);
+  for (const sourceTrace of tracesInScope) {
     if (sourceTrace?.subcircuit_connectivity_map_key && (sourceTrace.connected_source_port_ids?.length ?? 0) > 0 && (sourceTrace.connected_source_net_ids?.length ?? 0) > 0) {
       connKeysWithExplicitPortNetTraces.add(
         sourceTrace.subcircuit_connectivity_map_key
@@ -23456,7 +23482,7 @@ import { identity as identity5 } from "transformation-matrix";
 var package_default = {
   name: "@tscircuit/core",
   type: "module",
-  version: "0.0.1305",
+  version: "0.0.1307",
   types: "dist/index.d.ts",
   main: "dist/index.js",
   module: "dist/index.js",