@tscircuit/core 0.0.2146 → 0.0.2147

package/dist/index.d.ts

@@ -4615,6 +4615,8 @@ declare class Port extends PrimitiveComponent<typeof portProps> {
      * but everyone registers themselves as a match with their Port.
      */
     registerMatch(component: PrimitiveComponent): void;
+    /** Physical package ball name; pinNumber remains a schematic layout ordinal. */
+    physicalPinName?: string;
     getNameAndAliases(): string[];
     _getMatchingPinAttributes(): PinAttributeMap[];
     private _shouldIncludeInBoardPinout;
@@ -4737,6 +4739,9 @@ declare class NormalComponent<ZodProps extends z.ZodType = any, PortNames extend
         ignoreSymbolPorts?: boolean;
     }): void;
     _resolvePinLabels(): Record<string, string | string[]> | undefined;
+    private _resolvedPackagePins?;
+    /** Physical package name, separate from the internal schematic ordinal. */
+    _getPhysicalPinName(pinNumber: number): string | undefined;
     _getImpliedFootprintString(): string | null;
     resolveFootprint(): any;
     _addChildrenFromStringFootprint(): void;
@@ -110865,7 +110870,6 @@ declare const pcbViaProps: z.ZodObject<{
     }>]>, "top" | "bottom" | "inner1" | "inner2" | "inner3" | "inner4" | "inner5" | "inner6" | "inner7" | "inner8", "top" | "bottom" | "inner1" | "inner2" | "inner3" | "inner4" | "inner5" | "inner6" | "inner7" | "inner8" | {
         name: "top" | "bottom" | "inner1" | "inner2" | "inner3" | "inner4" | "inner5" | "inner6" | "inner7" | "inner8";
     }>>;
-    name: z.ZodOptional<z.ZodString>;
     fromLayer: z.ZodOptional<z.ZodOptional<z.ZodEffects<z.ZodUnion<[z.ZodEnum<["top", "bottom", "inner1", "inner2", "inner3", "inner4", "inner5", "inner6", "inner7", "inner8"]>, z.ZodObject<{
         name: z.ZodEnum<["top", "bottom", "inner1", "inner2", "inner3", "inner4", "inner5", "inner6", "inner7", "inner8"]>;
     }, "strip", z.ZodTypeAny, {
@@ -110894,6 +110898,7 @@ declare const pcbViaProps: z.ZodObject<{
         name: "top" | "bottom" | "inner1" | "inner2" | "inner3" | "inner4" | "inner5" | "inner6" | "inner7" | "inner8";
     }>, "many">>;
     connectsTo: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString, "many">]>>;
+    name: z.ZodOptional<z.ZodString>;
     holeDiameter: z.ZodOptional<z.ZodEffects<z.ZodUnion<[z.ZodString, z.ZodNumber]>, number, string | number>>;
     netIsAssignable: z.ZodOptional<z.ZodBoolean>;
     footprint: z.ZodOptional<z.ZodType<_tscircuit_props.FootprintProp, z.ZodTypeDef, _tscircuit_props.FootprintProp>>;
@@ -110980,11 +110985,11 @@ declare const pcbViaProps: z.ZodObject<{
 }, "strip", z.ZodTypeAny, {
     symbol?: _tscircuit_props.SymbolProp | undefined;
     layer?: "top" | "bottom" | "inner1" | "inner2" | "inner3" | "inner4" | "inner5" | "inner6" | "inner7" | "inner8" | undefined;
-    name?: string | undefined;
     fromLayer?: "top" | "bottom" | "inner1" | "inner2" | "inner3" | "inner4" | "inner5" | "inner6" | "inner7" | "inner8" | undefined;
     toLayer?: "top" | "bottom" | "inner1" | "inner2" | "inner3" | "inner4" | "inner5" | "inner6" | "inner7" | "inner8" | undefined;
     layers?: ("top" | "bottom" | "inner1" | "inner2" | "inner3" | "inner4" | "inner5" | "inner6" | "inner7" | "inner8")[] | undefined;
     connectsTo?: string | string[] | undefined;
+    name?: string | undefined;
     holeDiameter?: number | undefined;
     netIsAssignable?: boolean | undefined;
     footprint?: _tscircuit_props.FootprintProp | undefined;
@@ -111043,7 +111048,6 @@ declare const pcbViaProps: z.ZodObject<{
     layer?: "top" | "bottom" | "inner1" | "inner2" | "inner3" | "inner4" | "inner5" | "inner6" | "inner7" | "inner8" | {
         name: "top" | "bottom" | "inner1" | "inner2" | "inner3" | "inner4" | "inner5" | "inner6" | "inner7" | "inner8";
     } | undefined;
-    name?: string | undefined;
     fromLayer?: "top" | "bottom" | "inner1" | "inner2" | "inner3" | "inner4" | "inner5" | "inner6" | "inner7" | "inner8" | {
         name: "top" | "bottom" | "inner1" | "inner2" | "inner3" | "inner4" | "inner5" | "inner6" | "inner7" | "inner8";
     } | undefined;
@@ -111054,6 +111058,7 @@ declare const pcbViaProps: z.ZodObject<{
         name: "top" | "bottom" | "inner1" | "inner2" | "inner3" | "inner4" | "inner5" | "inner6" | "inner7" | "inner8";
     })[] | undefined;
     connectsTo?: string | string[] | undefined;
+    name?: string | undefined;
     holeDiameter?: string | number | undefined;
     netIsAssignable?: boolean | undefined;
     footprint?: _tscircuit_props.FootprintProp | undefined;
@@ -111125,7 +111130,6 @@ declare class PcbVia extends PrimitiveComponent<typeof pcbViaProps> {
             }>]>, "top" | "bottom" | "inner1" | "inner2" | "inner3" | "inner4" | "inner5" | "inner6" | "inner7" | "inner8", "top" | "bottom" | "inner1" | "inner2" | "inner3" | "inner4" | "inner5" | "inner6" | "inner7" | "inner8" | {
                 name: "top" | "bottom" | "inner1" | "inner2" | "inner3" | "inner4" | "inner5" | "inner6" | "inner7" | "inner8";
             }>>;
-            name: z.ZodOptional<z.ZodString>;
             fromLayer: z.ZodOptional<z.ZodOptional<z.ZodEffects<z.ZodUnion<[z.ZodEnum<["top", "bottom", "inner1", "inner2", "inner3", "inner4", "inner5", "inner6", "inner7", "inner8"]>, z.ZodObject<{
                 name: z.ZodEnum<["top", "bottom", "inner1", "inner2", "inner3", "inner4", "inner5", "inner6", "inner7", "inner8"]>;
             }, "strip", z.ZodTypeAny, {
@@ -111154,6 +111158,7 @@ declare class PcbVia extends PrimitiveComponent<typeof pcbViaProps> {
                 name: "top" | "bottom" | "inner1" | "inner2" | "inner3" | "inner4" | "inner5" | "inner6" | "inner7" | "inner8";
             }>, "many">>;
             connectsTo: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString, "many">]>>;
+            name: z.ZodOptional<z.ZodString>;
             holeDiameter: z.ZodOptional<z.ZodEffects<z.ZodUnion<[z.ZodString, z.ZodNumber]>, number, string | number>>;
             netIsAssignable: z.ZodOptional<z.ZodBoolean>;
             footprint: z.ZodOptional<z.ZodType<_tscircuit_props.FootprintProp, z.ZodTypeDef, _tscircuit_props.FootprintProp>>;
@@ -111240,11 +111245,11 @@ declare class PcbVia extends PrimitiveComponent<typeof pcbViaProps> {
         }, "strip", z.ZodTypeAny, {
             symbol?: _tscircuit_props.SymbolProp | undefined;
             layer?: "top" | "bottom" | "inner1" | "inner2" | "inner3" | "inner4" | "inner5" | "inner6" | "inner7" | "inner8" | undefined;
-            name?: string | undefined;
             fromLayer?: "top" | "bottom" | "inner1" | "inner2" | "inner3" | "inner4" | "inner5" | "inner6" | "inner7" | "inner8" | undefined;
             toLayer?: "top" | "bottom" | "inner1" | "inner2" | "inner3" | "inner4" | "inner5" | "inner6" | "inner7" | "inner8" | undefined;
             layers?: ("top" | "bottom" | "inner1" | "inner2" | "inner3" | "inner4" | "inner5" | "inner6" | "inner7" | "inner8")[] | undefined;
             connectsTo?: string | string[] | undefined;
+            name?: string | undefined;
             holeDiameter?: number | undefined;
             netIsAssignable?: boolean | undefined;
             footprint?: _tscircuit_props.FootprintProp | undefined;
@@ -111303,7 +111308,6 @@ declare class PcbVia extends PrimitiveComponent<typeof pcbViaProps> {
             layer?: "top" | "bottom" | "inner1" | "inner2" | "inner3" | "inner4" | "inner5" | "inner6" | "inner7" | "inner8" | {
                 name: "top" | "bottom" | "inner1" | "inner2" | "inner3" | "inner4" | "inner5" | "inner6" | "inner7" | "inner8";
             } | undefined;
-            name?: string | undefined;
             fromLayer?: "top" | "bottom" | "inner1" | "inner2" | "inner3" | "inner4" | "inner5" | "inner6" | "inner7" | "inner8" | {
                 name: "top" | "bottom" | "inner1" | "inner2" | "inner3" | "inner4" | "inner5" | "inner6" | "inner7" | "inner8";
             } | undefined;
@@ -111314,6 +111318,7 @@ declare class PcbVia extends PrimitiveComponent<typeof pcbViaProps> {
                 name: "top" | "bottom" | "inner1" | "inner2" | "inner3" | "inner4" | "inner5" | "inner6" | "inner7" | "inner8";
             })[] | undefined;
             connectsTo?: string | string[] | undefined;
+            name?: string | undefined;
             holeDiameter?: string | number | undefined;
             netIsAssignable?: boolean | undefined;
             footprint?: _tscircuit_props.FootprintProp | undefined;

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) => {
@@ -3004,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(
@@ -3016,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;
     }
@@ -5216,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()] : [],
@@ -5313,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,
@@ -9247,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)
@@ -9328,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));
 };
 
@@ -11083,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)
@@ -17507,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)
     );
@@ -17526,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({
@@ -17587,7 +17690,7 @@ function getPrimaryPortsFromPortHintGroups(portHintGroups, opts) {
     }
     opts?.inferredInternallyConnectedPinNames?.push(internallyConnectedPinNames);
   }
-  if (opts?.inferredInternallyConnectedPinNames) {
+  if (opts?.inferredInternallyConnectedPinNames && opts.inferSharedAliases !== false) {
     inferInternallyConnectedPinNamesFromPorts(
       ports,
       opts.inferredInternallyConnectedPinNames
@@ -17667,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).`
             ]
           }
         });
@@ -17734,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();
@@ -17788,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(
@@ -17797,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(
             {
@@ -17818,6 +17922,7 @@ var NormalComponent = class extends PrimitiveComponent2 {
         } else {
           existingPort.externallyAddedAliases.push(primaryLabel, ...otherLabels);
         }
+        existingPort.physicalPinName = physicalPinName;
       }
     }
     if (config.schematicSymbolName && !opts.ignoreSymbolPorts) {
@@ -17949,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
     );
@@ -17961,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 ?? {}
@@ -17969,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;
   }
@@ -18648,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) {
@@ -18658,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
     };
@@ -18910,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,
@@ -110256,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,
@@ -118557,7 +118692,7 @@ var RoutingPhasePreparationError = class extends Error {
 var package_default = {
   name: "@tscircuit/core",
   type: "module",
-  version: "0.0.2145",
+  version: "0.0.2146",
   types: "dist/index.d.ts",
   main: "dist/index.js",
   module: "dist/index.js",

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@tscircuit/core",
   "type": "module",
-  "version": "0.0.2146",
+  "version": "0.0.2147",
   "types": "dist/index.d.ts",
   "main": "dist/index.js",
   "module": "dist/index.js",