@tscircuit/core 0.0.2145 → 0.0.2147

package/dist/index.js

@@ -137,6 +137,68 @@ __export(components_exports, {
   VoltageSource: () => VoltageSource
 });
 
+// lib/utils/schematic/getPinNumberFromPinLabelsKey.ts
+var PIN_LABELS_KEY_RE = /^(?:pin)?(\d+)$/;
+var getPinNumberFromPinLabelsKey = (pinKey) => {
+  const match = pinKey.match(PIN_LABELS_KEY_RE);
+  if (!match) return null;
+  return Number.parseInt(match[1], 10);
+};
+
+// lib/utils/schematic/resolvePinLabels.ts
+var isPhysicalPinName = (name) => /^[A-Z]+[1-9]\d*$/.test(name);
+function resolvePinLabels(pinLabels) {
+  const usedPinNumbers = new Set(
+    Object.keys(pinLabels).flatMap((key) => {
+      const pinNumber = getPinNumberFromPinLabelsKey(key);
+      return pinNumber === null ? [] : [pinNumber];
+    })
+  );
+  const physicalNames = Object.keys(pinLabels).filter(isPhysicalPinName).sort((a2, b2) => {
+    const [, rowA, columnA] = a2.match(/^([A-Z]+)(\d+)$/);
+    const [, rowB, columnB] = b2.match(/^([A-Z]+)(\d+)$/);
+    return rowA.length - rowB.length || (rowA < rowB ? -1 : rowA > rowB ? 1 : 0) || Number(columnA) - Number(columnB);
+  });
+  const physicalPins = [];
+  let nextPinNumber = 1;
+  for (const name of physicalNames) {
+    while (usedPinNumbers.has(nextPinNumber)) nextPinNumber++;
+    physicalPins.push({ physicalPinName: name, pinNumber: nextPinNumber++ });
+  }
+  return Object.entries(pinLabels).map(([key, labels]) => {
+    const numericPinNumber = getPinNumberFromPinLabelsKey(key);
+    const pinNumber = numericPinNumber ?? physicalPins.find((pin) => pin.physicalPinName === key)?.pinNumber;
+    if (pinNumber === void 0) {
+      throw new Error(
+        `Invalid pinLabels key "${key}". Expected a numeric pin (e.g. pin1) or physical ball name (e.g. A1).`
+      );
+    }
+    return {
+      pinNumber,
+      physicalPinName: numericPinNumber === null ? key : void 0,
+      labels: typeof labels === "string" ? [labels] : [...labels]
+    };
+  });
+}
+function getNumericPinLabels(pinLabels) {
+  if (!Object.keys(pinLabels).some(isPhysicalPinName)) {
+    return Object.fromEntries(
+      Object.entries(pinLabels).map(([key, labels]) => [
+        key,
+        typeof labels === "string" ? labels : [...labels]
+      ])
+    );
+  }
+  return Object.fromEntries(
+    resolvePinLabels(pinLabels).map(
+      ({ pinNumber, physicalPinName, labels }) => [
+        `pin${pinNumber}`,
+        physicalPinName ? [...labels, physicalPinName] : labels
+      ]
+    )
+  );
+}
+
 // lib/components/base-components/NormalComponent/NormalComponent.ts
 import { resolveManufacturerPartNumber as resolveManufacturerPartNumber2 } from "@tscircuit/props";
 
@@ -937,6 +999,18 @@ var mergeRoutes = (routes) => {
 // lib/components/primitive-components/Net.ts
 import { netProps } from "@tscircuit/props";
 
+// lib/components/primitive-components/Port/assertUnambiguousPhysicalPortSelection.ts
+function assertUnambiguousPhysicalPortSelection(ports, selector) {
+  if (ports.length < 2 || !ports.some((port) => port.physicalPinName)) return;
+  const names = ports.map((port) => {
+    const componentName = port.getParentNormalComponent()?.name ?? "unnamed component";
+    return `${componentName}.${port.physicalPinName ?? port.name}`;
+  });
+  throw new Error(
+    `Ambiguous port "${selector}"; use a physical ball name: ${names.join(", ")}.`
+  );
+}
+
 // lib/components/base-components/PrimitiveComponent/get-construction-props-schema.ts
 var constructionSchemas = /* @__PURE__ */ new WeakMap();
 var getConstructionPropsSchema = (schema) => {
@@ -2431,6 +2505,11 @@ var PrimitiveComponent2 = class extends Renderable {
     if (this.isPrimitiveContainer) return this;
     return this.parent?.getPrimitiveContainer?.() ?? null;
   }
+  /** Resolve mounting intent from the container owning this primitive. */
+  _getIsSmt() {
+    const container = this.getPrimitiveContainer();
+    return container && container !== this ? container._getIsSmt() : true;
+  }
   /**
    * Get the Symbol ancestor if this component is inside a Symbol primitive container.
    * Used by schematic primitives to access the symbol's resize transform.
@@ -2999,9 +3078,16 @@ var PrimitiveComponent2 = class extends Renderable {
         this,
         cssSelectOptionsInsideSubcircuit
       );
-      result = allMatching.find(
+      const matchingComponents = allMatching.filter(
         (n2) => n2.lowercaseComponentName === options.type
       );
+      if (options.type === "port") {
+        assertUnambiguousPhysicalPortSelection(
+          matchingComponents,
+          selectorRaw
+        );
+      }
+      result = matchingComponents[0] ?? null;
     }
     if (!options?.type) {
       result ??= selectOne(
@@ -3011,6 +3097,14 @@ var PrimitiveComponent2 = class extends Renderable {
       );
     }
     if (result) {
+      if (!options?.type && result.componentName === "Port") {
+        assertUnambiguousPhysicalPortSelection(
+          this.selectAll(selectorRaw).filter(
+            (component) => component.componentName === "Port"
+          ),
+          selectorRaw
+        );
+      }
       this._cachedSelectOneQueries.set(selectorRaw, result);
       return result;
     }
@@ -5211,10 +5305,13 @@ var Port = class extends PrimitiveComponent2 {
   registerMatch(component) {
     this.matchedComponents.push(component);
   }
+  /** Physical package ball name; pinNumber remains a schematic layout ordinal. */
+  physicalPinName;
   getNameAndAliases() {
     const { _parsedProps: props } = this;
     return Array.from(
       /* @__PURE__ */ new Set([
+        ...this.physicalPinName ? [this.physicalPinName] : [],
         ...props.name ? [props.name] : [],
         ...props.aliases ?? [],
         ...typeof props.pinNumber === "number" ? [`pin${props.pinNumber}`, props.pinNumber.toString()] : [],
@@ -5308,8 +5405,10 @@ var Port = class extends PrimitiveComponent2 {
     const source_component_id = parentWithSourceId?.source_component_id ?? null;
     const portAttributesFromParent = resolvePortSourcePinAttributes(this);
     const source_port = db2.source_port.insert({
-      name: props.name,
-      pin_number: props.pinNumber,
+      name: this.physicalPinName ?? props.name,
+      // Physical balls have a string package identity. Keep their numeric
+      // layout ordinal on schematic_port, not the physical source pin number.
+      pin_number: this.physicalPinName ? void 0 : props.pinNumber,
       port_hints,
       source_component_id,
       subcircuit_id: this.getSubcircuit()?.subcircuit_id,
@@ -9242,14 +9341,6 @@ var createInstanceFromReactElement = (reactElm) => {
 import "circuit-json";
 import "zod";
 
-// lib/utils/schematic/getPinNumberFromPinLabelsKey.ts
-var PIN_LABELS_KEY_RE = /^(?:pin)?(\d+)$/;
-var getPinNumberFromPinLabelsKey = (pinKey) => {
-  const match = pinKey.match(PIN_LABELS_KEY_RE);
-  if (!match) return null;
-  return Number.parseInt(match[1], 10);
-};
-
 // lib/utils/filterPinLabels.ts
 function filterPinLabels(pinLabels) {
   if (!pinLabels)
@@ -9323,18 +9414,20 @@ var parsePinNumberFromLabelsOrThrow = (pinNumberOrLabel, pinLabels) => {
   if (!pinLabels) {
     throw new Error(getInvalidPinLabelMessage(pinNumberOrLabel));
   }
-  for (const pinNumberKey in pinLabels) {
-    const aliases = Array.isArray(pinLabels[pinNumberKey]) ? pinLabels[pinNumberKey] : [pinLabels[pinNumberKey]];
-    if (aliases.includes(pinNumberOrLabel)) {
-      const pinNumber = getPinNumberFromPinLabelsKey(pinNumberKey);
-      if (pinNumber === null) {
-        throw new Error(
-          `Invalid pinLabels key "${pinNumberKey}". Expected "pin\${number}" (e.g. pin1, pin2).`
-        );
-      }
-      return pinNumber;
-    }
+  const resolvedPins = resolvePinLabels(pinLabels);
+  const physicalPin = resolvedPins.find(
+    (pin) => pin.physicalPinName === pinNumberOrLabel
+  );
+  if (physicalPin) return physicalPin.pinNumber;
+  const matches = resolvedPins.filter(
+    (pin) => pin.labels.includes(pinNumberOrLabel)
+  );
+  if (matches.length > 1 && matches.some((pin) => pin.physicalPinName)) {
+    throw new Error(
+      `Ambiguous pin label "${pinNumberOrLabel}"; use a physical ball name: ${matches.map((pin) => pin.physicalPinName ?? `pin${pin.pinNumber}`).join(", ")}.`
+    );
   }
+  if (matches.length > 0) return matches[0].pinNumber;
   throw new Error(getInvalidPinLabelMessage(pinNumberOrLabel));
 };
 
@@ -11078,10 +11171,15 @@ function selectPortForPcbPrimitive(ports, primitive, hints) {
   const pinNumber = getPinNumberFromHints(hints);
   const matchingPorts = ports.filter((port) => port.isMatchingAnyOf(hints));
   if (matchingPorts.length === 0) return null;
+  const physicalCandidates = matchingPorts.filter(
+    (port) => port.physicalPinName && hints.includes(port.physicalPinName)
+  );
+  if (physicalCandidates.length === 1) return physicalCandidates[0];
   const pinMatchedPorts = pinNumber === null ? matchingPorts : matchingPorts.filter(
     (port) => port._parsedProps.pinNumber === pinNumber || port._primaryPinNumber === pinNumber
   );
   const candidates = pinMatchedPorts.length > 0 ? pinMatchedPorts : matchingPorts;
+  assertUnambiguousPhysicalPortSelection(candidates, hints.join(", "));
   const overlappingPort = candidates.find(
     (port) => port.matchedComponents.some(
       (component) => component.isPcbPrimitive && doPcbPrimitivesOverlapBeforeRender(component, primitive)
@@ -11191,6 +11289,7 @@ var PlatedHole = class extends PrimitiveComponent2 {
     const position = this._getGlobalPcbPositionBeforeLayout();
     const pcb_component_id = this.parent?.pcb_component_id ?? this.getPrimitiveContainer()?.pcb_component_id;
     const subcircuit = this.getSubcircuit();
+    const shouldCreateSolderPaste = this._getIsSmt();
     const platedHoleLayers = this.getAvailablePcbLayers();
     const soldermaskMargin = props.solderMaskMargin;
     const isCoveredWithSolderMask = props.coveredWithSolderMask ?? false;
@@ -11219,26 +11318,28 @@ var PlatedHole = class extends PrimitiveComponent2 {
         pcb_group_id: this.getGroup()?.pcb_group_id ?? void 0
       });
       this.pcb_plated_hole_id = pcb_plated_hole.pcb_plated_hole_id;
-      db2.pcb_solder_paste.insert({
-        layer: "top",
-        shape: "circle",
-        // @ts-ignore: no idea why this is triggering
-        radius: props.outerDiameter / 2,
-        x: position.x,
-        y: position.y,
-        subcircuit_id: subcircuit?.subcircuit_id ?? void 0,
-        pcb_group_id: this.getGroup()?.pcb_group_id ?? void 0
-      });
-      db2.pcb_solder_paste.insert({
-        layer: "bottom",
-        shape: "circle",
-        // @ts-ignore: no idea why this is triggering
-        radius: props.outerDiameter / 2,
-        x: position.x,
-        y: position.y,
-        subcircuit_id: subcircuit?.subcircuit_id ?? void 0,
-        pcb_group_id: this.getGroup()?.pcb_group_id ?? void 0
-      });
+      if (shouldCreateSolderPaste) {
+        db2.pcb_solder_paste.insert({
+          layer: "top",
+          shape: "circle",
+          // @ts-ignore: no idea why this is triggering
+          radius: props.outerDiameter / 2,
+          x: position.x,
+          y: position.y,
+          subcircuit_id: subcircuit?.subcircuit_id ?? void 0,
+          pcb_group_id: this.getGroup()?.pcb_group_id ?? void 0
+        });
+        db2.pcb_solder_paste.insert({
+          layer: "bottom",
+          shape: "circle",
+          // @ts-ignore: no idea why this is triggering
+          radius: props.outerDiameter / 2,
+          x: position.x,
+          y: position.y,
+          subcircuit_id: subcircuit?.subcircuit_id ?? void 0,
+          pcb_group_id: this.getGroup()?.pcb_group_id ?? void 0
+        });
+      }
     } else if (props.shape === "pill" && props.rectPad) {
       const pcb_plated_hole = db2.pcb_plated_hole.insert({
         pcb_component_id,
@@ -11288,7 +11389,7 @@ var PlatedHole = class extends PrimitiveComponent2 {
         // NOTE: currently PcbPlatedHoleOval erroneously includes both the shape "pill" and "oval"
       });
       this.pcb_plated_hole_id = pcb_plated_hole.pcb_plated_hole_id;
-      if (props.shape === "pill") {
+      if (props.shape === "pill" && shouldCreateSolderPaste) {
         db2.pcb_solder_paste.insert({
           layer: "top",
           shape: "rotated_pill",
@@ -11313,7 +11414,7 @@ var PlatedHole = class extends PrimitiveComponent2 {
           subcircuit_id: subcircuit?.subcircuit_id ?? void 0,
           pcb_group_id: this.getGroup()?.pcb_group_id ?? void 0
         });
-      } else if (props.shape === "oval") {
+      } else if (props.shape === "oval" && shouldCreateSolderPaste) {
         db2.pcb_solder_paste.insert({
           layer: "top",
           shape: "oval",
@@ -12667,7 +12768,7 @@ var SmtPad = class extends PrimitiveComponent2 {
     const { db: db2 } = this.root;
     const { _parsedProps: props } = this;
     const isCoveredWithSolderMask = props.coveredWithSolderMask ?? false;
-    const shouldCreateSolderPaste = !isCoveredWithSolderMask;
+    const shouldCreateSolderPaste = !isCoveredWithSolderMask && this._getIsSmt();
     const soldermaskMargin = props.solderMaskMargin;
     const solderPasteMargin = props.solderPasteMargin;
     const getSolderPasteSize = (padSize2, marginScale = 2) => solderPasteMargin !== void 0 ? Math.max(padSize2 + marginScale * solderPasteMargin, 0) : padSize2 * 0.7;
@@ -17499,6 +17600,15 @@ function getPrimaryPortsFromPortHintGroups(portHintGroups, opts) {
     );
     if (filteredPortHints.length === 0) continue;
     let portHintsList = filteredPortHints;
+    const physicalPinNumber = portHintsList.map((hint) => opts?.implicitPinNumberByHint?.get(hint)).find(
+      (pinNumber2) => pinNumber2 !== void 0 && portHintsList.includes(opts?.getPhysicalPinName?.(pinNumber2) ?? "")
+    );
+    if (physicalPinNumber !== void 0) {
+      portHintsList = [
+        ...portHintsList.filter((hint) => !/^(?:pin)?\d+$/.test(hint)),
+        `pin${physicalPinNumber}`
+      ];
+    }
     const hasPinIdentifier = portHintsList.some(
       (hint) => hint.startsWith("pin") || /^(?:pin)?\d+$/.test(hint)
     );
@@ -17518,6 +17628,7 @@ function getPrimaryPortsFromPortHintGroups(portHintGroups, opts) {
     newPort.originDescription = portHintGroup.originDescription;
     const pinNumber = newPort._parsedProps.pinNumber;
     if (pinNumber === void 0) continue;
+    newPort.physicalPinName = opts?.getPhysicalPinName?.(pinNumber);
     if (!entriesByPinNumber.has(pinNumber))
       entriesByPinNumber.set(pinNumber, []);
     entriesByPinNumber.get(pinNumber).push({
@@ -17579,7 +17690,7 @@ function getPrimaryPortsFromPortHintGroups(portHintGroups, opts) {
     }
     opts?.inferredInternallyConnectedPinNames?.push(internallyConnectedPinNames);
   }
-  if (opts?.inferredInternallyConnectedPinNames) {
+  if (opts?.inferredInternallyConnectedPinNames && opts.inferSharedAliases !== false) {
     inferInternallyConnectedPinNamesFromPorts(
       ports,
       opts.inferredInternallyConnectedPinNames
@@ -17603,6 +17714,12 @@ var NormalComponent = class extends PrimitiveComponent2 {
   _resolvedPcbCalcOffsetY;
   isPrimitiveContainer = true;
   _isNormalComponent = true;
+  _getIsSmt() {
+    if (this._parsedProps.isSmt !== void 0) return this._parsedProps.isSmt;
+    return this.selectAll("smtpad").some(
+      (pad) => pad.getPrimitiveContainer() === this
+    );
+  }
   // Mapping from camelCase attribute names to their lowercase equivalents
   // This is used by the CSS selector adapter for fast attribute lookups
   // Reverse mapping from lowercase to camelCase for O(1) lookups
@@ -17653,14 +17770,14 @@ var NormalComponent = class extends PrimitiveComponent2 {
     super(filteredProps);
     if (filteredProps.pinLabels && !Array.isArray(filteredProps.pinLabels)) {
       const invalidPinKey = Object.keys(filteredProps.pinLabels).find(
-        (pinKey) => getPinNumberFromPinLabelsKey(pinKey) === null
+        (pinKey) => getPinNumberFromPinLabelsKey(pinKey) === null && !isPhysicalPinName(pinKey)
       );
       if (invalidPinKey) {
         throw new InvalidProps(this.lowercaseComponentName, this.props, {
           _errors: [],
           pinLabels: {
             _errors: [
-              `Invalid pinLabels key "${invalidPinKey}". Expected "pin\${number}" (e.g. pin1, pin2).`
+              `Invalid pinLabels key "${invalidPinKey}". Expected "pin\${number}" (e.g. pin1, pin2) or a physical ball name (e.g. A1).`
             ]
           }
         });
@@ -17720,7 +17837,7 @@ var NormalComponent = class extends PrimitiveComponent2 {
     const propsPinLabels = this._parsedProps.pinLabels;
     const pinLabelsFromProps = propsPinLabels && Array.isArray(propsPinLabels) ? Object.fromEntries(
       propsPinLabels.map((label, index2) => [`pin${index2 + 1}`, label])
-    ) : propsPinLabels;
+    ) : propsPinLabels ? getNumericPinLabels(propsPinLabels) : void 0;
     const existingChildPorts = this._getAllPortsFromChildren();
     const hasExistingOrQueuedPortWithPinNumber = (pinNumber) => existingChildPorts.some((p2) => p2._parsedProps.pinNumber === pinNumber) || portsToCreate.some((p2) => p2._parsedProps.pinNumber === pinNumber);
     const schPortArrangement = this._getSchematicPortArrangement();
@@ -17774,7 +17891,7 @@ var NormalComponent = class extends PrimitiveComponent2 {
         const pinNumber = getPinNumberFromPinLabelsKey(pinKey);
         if (pinNumber === null) {
           throw new Error(
-            `Invalid pinLabels key "${pinKey}". Expected "pin\${number}" (e.g. pin1, pin2).`
+            `Invalid pinLabels key "${pinKey}". Expected "pin\${number}" (e.g. pin1, pin2) or a physical ball name (e.g. A1).`
           );
         }
         let existingPort = existingChildPorts.find(
@@ -17783,8 +17900,9 @@ var NormalComponent = class extends PrimitiveComponent2 {
         const labelList = Array.isArray(label) ? label : [label];
         const propLabel = pinLabelsFromProps?.[pinKey];
         const hasPropLabel = propLabel !== void 0;
-        const primaryLabel = hasPropLabel ? labelList[0] : `pin${pinNumber}`;
-        const otherLabels = hasPropLabel ? labelList.slice(1) : labelList;
+        const physicalPinName = this._getPhysicalPinName(pinNumber);
+        const primaryLabel = physicalPinName ?? (hasPropLabel ? labelList[0] : `pin${pinNumber}`);
+        const otherLabels = physicalPinName ? labelList : hasPropLabel ? labelList.slice(1) : labelList;
         if (!existingPort) {
           existingPort = new Port(
             {
@@ -17804,6 +17922,7 @@ var NormalComponent = class extends PrimitiveComponent2 {
         } else {
           existingPort.externallyAddedAliases.push(primaryLabel, ...otherLabels);
         }
+        existingPort.physicalPinName = physicalPinName;
       }
     }
     if (config.schematicSymbolName && !opts.ignoreSymbolPorts) {
@@ -17935,7 +18054,11 @@ var NormalComponent = class extends PrimitiveComponent2 {
     }
     inferInternallyConnectedPinNamesFromPorts(
       Array.from(
-        /* @__PURE__ */ new Set([...this._getAllPortsFromChildren(), ...portsToCreate])
+        new Set(
+          [...this._getAllPortsFromChildren(), ...portsToCreate].filter(
+            (port) => !port.physicalPinName
+          )
+        )
       ),
       this._inferredInternallyConnectedPinNames
     );
@@ -17947,7 +18070,7 @@ var NormalComponent = class extends PrimitiveComponent2 {
     const pinLabels = this._parsedProps.pinLabels;
     const parsedPinLabels = pinLabels && Array.isArray(pinLabels) ? Object.fromEntries(
       pinLabels.map((label, index2) => [`pin${index2 + 1}`, label])
-    ) : pinLabels;
+    ) : pinLabels ? getNumericPinLabels(pinLabels) : void 0;
     const resolvedPinLabels = {
       ...this._impliedFootprintPinLabels ?? {},
       ...parsedPinLabels ?? {}
@@ -17955,6 +18078,14 @@ var NormalComponent = class extends PrimitiveComponent2 {
     if (Object.keys(resolvedPinLabels).length === 0) return void 0;
     return resolvedPinLabels;
   }
+  _resolvedPackagePins;
+  /** Physical package name, separate from the internal schematic ordinal. */
+  _getPhysicalPinName(pinNumber) {
+    const pinLabels = this._parsedProps?.pinLabels ?? this.props.pinLabels;
+    if (!pinLabels || Array.isArray(pinLabels)) return void 0;
+    this._resolvedPackagePins ??= resolvePinLabels(pinLabels);
+    return this._resolvedPackagePins.find((pin) => pin.pinNumber === pinNumber)?.physicalPinName;
+  }
   _getImpliedFootprintString() {
     return null;
   }
@@ -18634,8 +18765,12 @@ var NormalComponent = class extends PrimitiveComponent2 {
     if (opts?.collectInferredInternallyConnectedPins) {
       inferredInternallyConnectedPinNames = this._inferredInternallyConnectedPinNames;
     }
+    const physicalPinLabels = this._parsedProps?.pinLabels ?? this.props.pinLabels;
+    const hasPhysicalPins = physicalPinLabels && !Array.isArray(physicalPinLabels) && Object.keys(physicalPinLabels).some(isPhysicalPinName);
     const implicitPinNumberByHint = /* @__PURE__ */ new Map();
-    const explicitPinLabels = this._parsedProps?.pinLabels ?? this.props.pinLabels;
+    const ambiguousHints = /* @__PURE__ */ new Set();
+    const rawExplicitPinLabels = this._parsedProps?.pinLabels ?? this.props.pinLabels;
+    const explicitPinLabels = rawExplicitPinLabels && !Array.isArray(rawExplicitPinLabels) ? getNumericPinLabels(rawExplicitPinLabels) : rawExplicitPinLabels;
     if (explicitPinLabels) {
       const pinLabelEntries = Array.isArray(explicitPinLabels) ? explicitPinLabels.map((label, index2) => [`pin${index2 + 1}`, label]) : Object.entries(explicitPinLabels);
       for (const [pinKey, labelOrLabels] of pinLabelEntries) {
@@ -18644,13 +18779,20 @@ var NormalComponent = class extends PrimitiveComponent2 {
         const labels = Array.isArray(labelOrLabels) ? labelOrLabels : [labelOrLabels];
         for (const label of labels) {
           if (typeof label === "string" && label.length > 0) {
+            const previousPinNumber = implicitPinNumberByHint.get(label);
+            if (hasPhysicalPins && previousPinNumber !== void 0 && previousPinNumber !== pinNumber) {
+              ambiguousHints.add(label);
+            }
             implicitPinNumberByHint.set(label, pinNumber);
           }
         }
       }
     }
+    for (const hint of ambiguousHints) implicitPinNumberByHint.delete(hint);
     const primaryPortOpts = {
       ...opts,
+      inferSharedAliases: !hasPhysicalPins,
+      getPhysicalPinName: (pinNumber) => this._getPhysicalPinName(pinNumber),
       inferredInternallyConnectedPinNames,
       implicitPinNumberByHint
     };
@@ -18896,19 +19038,24 @@ var NormalComponent = class extends PrimitiveComponent2 {
         `pin${pinIndex + 1}`,
         label
       ])
-    ) : props.pinLabels;
+    ) : props.pinLabels ? getNumericPinLabels(props.pinLabels) : void 0;
     const allPinLabels = {
       ...pinLabelsFromPorts,
       ...pinLabelsFromProps
     };
     const schPortArrangement = this._getSchematicPortArrangement() ?? this._getImplicitSparseSchematicPortArrangement(pinCount);
+    if (props.pinLabels && !Array.isArray(props.pinLabels) && Object.keys(props.pinLabels).some(isPhysicalPinName) && schPortArrangement) {
+      for (const pin of getPinsFromPortArrangement(schPortArrangement)) {
+        parsePinNumberFromLabelsOrThrow(pin, props.pinLabels);
+      }
+    }
     return getAllDimensionsForSchematicBox({
       schWidth: props.schWidth,
       schHeight: props.schHeight,
       schPinSpacing: pinSpacing,
       numericSchPinStyle: getNumericSchPinStyle(
         props.schPinStyle,
-        allPinLabels
+        !Array.isArray(props.pinLabels) ? props.pinLabels ?? allPinLabels : allPinLabels
       ),
       pinCount,
       schPortArrangement,
@@ -110242,20 +110389,22 @@ function getTitleAnchorAndPosition({
 // lib/components/primitive-components/SchematicBox/SchematicBox_doInitialSchematicComponentRender.ts
 var getSchematicBoxPinLabels = (pinLabels) => {
   if (!pinLabels) return [];
-  return Object.entries(pinLabels).map(([pinKey, pinLabel]) => {
-    const pinNumber = getPinNumberFromPinLabelsKey(pinKey);
-    if (pinNumber === null) {
-      throw new Error(
-        `Invalid schematicbox pinLabels key "${pinKey}". Expected pin<number>.`
-      );
+  return Object.entries(getNumericPinLabels(pinLabels)).map(
+    ([pinKey, pinLabel]) => {
+      const pinNumber = getPinNumberFromPinLabelsKey(pinKey);
+      if (pinNumber === null) {
+        throw new Error(
+          `Invalid schematicbox pinLabels key "${pinKey}". Expected pin<number>.`
+        );
+      }
+      const pinAliases = typeof pinLabel === "string" ? [pinLabel] : [...pinLabel];
+      return {
+        pinNumber,
+        displayPinLabel: pinAliases[0] ?? pinKey,
+        pinAliases
+      };
     }
-    const pinAliases = typeof pinLabel === "string" ? [pinLabel] : [...pinLabel];
-    return {
-      pinNumber,
-      displayPinLabel: pinAliases[0] ?? pinKey,
-      pinAliases
-    };
-  });
+  );
 };
 var getSchematicBoxPinStyleFromReferencedChip = ({
   referencedChip,
@@ -118543,7 +118692,7 @@ var RoutingPhasePreparationError = class extends Error {
 var package_default = {
   name: "@tscircuit/core",
   type: "module",
-  version: "0.0.2144",
+  version: "0.0.2146",
   types: "dist/index.d.ts",
   main: "dist/index.js",
   module: "dist/index.js",
@@ -118602,7 +118751,7 @@ var package_default = {
     "@tscircuit/miniflex": "^0.0.4",
     "@tscircuit/modelprinter": "^0.0.18",
     "@tscircuit/ngspice-spice-engine": "^0.0.20",
-    "@tscircuit/props": "^0.0.700",
+    "@tscircuit/props": "^0.0.701",
     "@tscircuit/schematic-match-adapt": "^0.0.18",
     "@tscircuit/schematic-trace-solver": "https://jscdn.tscircuit.com/@tscircuit/schematic-trace-solver/0.0.230.tgz",
     "@tscircuit/solver-utils": "^0.0.16",
@@ -118686,7 +118835,7 @@ var package_default = {
   },
   overrides: {
     "@tscircuit/circuit-json-util": "^0.0.121",
-    "@tscircuit/props": "^0.0.700",
+    "@tscircuit/props": "^0.0.701",
     "circuit-json": "^0.0.525",
     "@tscircuit/cableprinter": "^0.0.6"
   }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@tscircuit/core",
   "type": "module",
-  "version": "0.0.2145",
+  "version": "0.0.2147",
   "types": "dist/index.d.ts",
   "main": "dist/index.js",
   "module": "dist/index.js",
@@ -60,7 +60,7 @@
     "@tscircuit/miniflex": "^0.0.4",
     "@tscircuit/modelprinter": "^0.0.18",
     "@tscircuit/ngspice-spice-engine": "^0.0.20",
-    "@tscircuit/props": "^0.0.700",
+    "@tscircuit/props": "^0.0.701",
     "@tscircuit/schematic-match-adapt": "^0.0.18",
     "@tscircuit/schematic-trace-solver": "https://jscdn.tscircuit.com/@tscircuit/schematic-trace-solver/0.0.230.tgz",
     "@tscircuit/solver-utils": "^0.0.16",
@@ -144,7 +144,7 @@
   },
   "overrides": {
     "@tscircuit/circuit-json-util": "^0.0.121",
-    "@tscircuit/props": "^0.0.700",
+    "@tscircuit/props": "^0.0.701",
     "circuit-json": "^0.0.525",
     "@tscircuit/cableprinter": "^0.0.6"
   }