@tscircuit/core 0.0.172 → 0.0.173

package/dist/index.d.ts

@@ -711,6 +711,7 @@ declare class NormalComponent<ZodProps extends ZodType = any, PortNames extends
     _impliedFootprint?: string | undefined;
     isPrimitiveContainer: boolean;
     _asyncSupplierPartNumbers?: SupplierPartNumbers;
+    pcb_missing_footprint_error_id?: string;
     constructor(props: z.input<ZodProps>);
     /**
      * Override this method for better control over the auto-discovery of ports.
@@ -6126,6 +6127,7 @@ declare class PinHeader extends NormalComponent<typeof pinHeaderProps> {
             holeDiameter: zod.ZodOptional<zod.ZodEffects<zod.ZodUnion<[zod.ZodString, zod.ZodNumber]>, number, string | number>>;
             platedDiameter: zod.ZodOptional<zod.ZodEffects<zod.ZodUnion<[zod.ZodString, zod.ZodNumber]>, number, string | number>>;
             pinLabels: zod.ZodOptional<zod.ZodArray<zod.ZodString, "many">>;
+            facingDirection: zod.ZodOptional<zod.ZodEnum<["left", "right"]>>;
         }>, "strip", zod.ZodTypeAny, {
             name: string;
             pinCount: number;
@@ -6201,6 +6203,7 @@ declare class PinHeader extends NormalComponent<typeof pinHeaderProps> {
             showSilkscreenPinLabels?: boolean | undefined;
             doubleRow?: boolean | undefined;
             platedDiameter?: number | undefined;
+            facingDirection?: "left" | "right" | undefined;
         }, {
             name: string;
             pinCount: number;
@@ -6278,6 +6281,7 @@ declare class PinHeader extends NormalComponent<typeof pinHeaderProps> {
             showSilkscreenPinLabels?: boolean | undefined;
             doubleRow?: boolean | undefined;
             platedDiameter?: string | number | undefined;
+            facingDirection?: "left" | "right" | undefined;
         }>;
         shouldRenderAsSchematicBox: boolean;
     };

package/dist/index.js

@@ -1947,6 +1947,31 @@ var getSizeOfSidesFromPortArrangement = (pa) => {
   return { leftSize, rightSize, topSize, bottomSize };
 };
 
+// lib/utils/schematic/parsePinNumberFromLabelsOrThrow.ts
+var parsePinNumberFromLabelsOrThrow = (pinNumberOrLabel, pinLabels) => {
+  if (typeof pinNumberOrLabel === "number") {
+    return pinNumberOrLabel;
+  }
+  if (pinNumberOrLabel.startsWith("pin")) {
+    const pinNumber = Number(pinNumberOrLabel.slice(3));
+    return pinNumber;
+  }
+  if (!pinLabels) {
+    throw new Error(
+      `No pin labels provided and pin number or label is not a number: "${pinNumberOrLabel}"`
+    );
+  }
+  for (const pinNumberKey in pinLabels) {
+    const aliases = Array.isArray(pinLabels[pinNumberKey]) ? pinLabels[pinNumberKey] : [pinLabels[pinNumberKey]];
+    if (aliases.includes(pinNumberOrLabel)) {
+      return Number(pinNumberKey.replace("pin", ""));
+    }
+  }
+  throw new Error(
+    `No pin labels provided and pin number or label is not a number: "${pinNumberOrLabel}"`
+  );
+};
+
 // lib/utils/schematic/getAllDimensionsForSchematicBox.ts
 function isExplicitPinMappingArrangement(arrangement) {
   return arrangement.leftSide !== void 0;
@@ -1985,11 +2010,40 @@ var getAllDimensionsForSchematicBox = (params) => {
       bottomSize: 0
     };
   }
+  const getPinNumberUsingSideIndex = ({
+    side,
+    sideIndex,
+    truePinIndex: truePinIndex2
+  }) => {
+    if (!params.schPortArrangement) return truePinIndex2 + 1;
+    if (!isExplicitPinMappingArrangement(params.schPortArrangement))
+      return truePinIndex2 + 1;
+    const normalCcwDirection = {
+      left: "top-to-bottom",
+      bottom: "left-to-right",
+      right: "bottom-to-top",
+      top: "right-to-left"
+    }[side];
+    const directionAlongSide = params.schPortArrangement?.[`${side}Side`]?.direction ?? normalCcwDirection;
+    const pinsDefinitionForSide = params.schPortArrangement?.[`${side}Side`]?.pins;
+    let sideIndexWithDirectionCorrection = sideIndex;
+    if (directionAlongSide !== normalCcwDirection) {
+      sideIndexWithDirectionCorrection = pinsDefinitionForSide.length - sideIndex - 1;
+    }
+    return parsePinNumberFromLabelsOrThrow(
+      pinsDefinitionForSide[sideIndexWithDirectionCorrection],
+      params.pinLabels
+    );
+  };
   const orderedTruePorts = [];
   let currentDistanceFromEdge = 0;
   let truePinIndex = 0;
   for (let sideIndex = 0; sideIndex < sidePinCounts.leftSize; sideIndex++) {
-    const pinNumber = params.schPortArrangement && isExplicitPinMappingArrangement(params.schPortArrangement) ? params.schPortArrangement?.leftSide?.pins[sideIndex] : truePinIndex + 1;
+    const pinNumber = getPinNumberUsingSideIndex({
+      side: "left",
+      sideIndex,
+      truePinIndex
+    });
     const pinStyle = params.schPinStyle?.[`pin${pinNumber}`] ?? params.schPinStyle?.[pinNumber];
     if (pinStyle?.topMargin) {
       currentDistanceFromEdge += pinStyle.topMargin;
@@ -2013,7 +2067,11 @@ var getAllDimensionsForSchematicBox = (params) => {
   }
   currentDistanceFromEdge = 0;
   for (let sideIndex = 0; sideIndex < sidePinCounts.bottomSize; sideIndex++) {
-    const pinNumber = params.schPortArrangement && isExplicitPinMappingArrangement(params.schPortArrangement) ? params.schPortArrangement.bottomSide?.pins[sideIndex] : truePinIndex + 1;
+    const pinNumber = getPinNumberUsingSideIndex({
+      side: "bottom",
+      sideIndex,
+      truePinIndex
+    });
     const pinStyle = params.schPinStyle?.[`pin${pinNumber}`] ?? params.schPinStyle?.[pinNumber];
     if (pinStyle?.leftMargin) {
       currentDistanceFromEdge += pinStyle.leftMargin;
@@ -2037,7 +2095,11 @@ var getAllDimensionsForSchematicBox = (params) => {
   }
   currentDistanceFromEdge = 0;
   for (let sideIndex = 0; sideIndex < sidePinCounts.rightSize; sideIndex++) {
-    const pinNumber = params.schPortArrangement && isExplicitPinMappingArrangement(params.schPortArrangement) ? params.schPortArrangement.rightSide?.pins[sideIndex] : truePinIndex + 1;
+    const pinNumber = getPinNumberUsingSideIndex({
+      side: "right",
+      sideIndex,
+      truePinIndex
+    });
     const pinStyle = params.schPinStyle?.[`pin${pinNumber}`] ?? params.schPinStyle?.[pinNumber];
     if (pinStyle?.bottomMargin) {
       currentDistanceFromEdge += pinStyle.bottomMargin;
@@ -2061,7 +2123,11 @@ var getAllDimensionsForSchematicBox = (params) => {
   }
   currentDistanceFromEdge = 0;
   for (let sideIndex = 0; sideIndex < sidePinCounts.topSize; sideIndex++) {
-    const pinNumber = params.schPortArrangement && isExplicitPinMappingArrangement(params.schPortArrangement) ? params.schPortArrangement.topSide?.pins[sideIndex] : truePinIndex + 1;
+    const pinNumber = getPinNumberUsingSideIndex({
+      side: "top",
+      sideIndex,
+      truePinIndex
+    });
     const pinStyle = params.schPinStyle?.[`pin${pinNumber}`] ?? params.schPinStyle?.[pinNumber];
     if (pinStyle?.rightMargin) {
       currentDistanceFromEdge += pinStyle.rightMargin;
@@ -2096,7 +2162,7 @@ var getAllDimensionsForSchematicBox = (params) => {
       // Estimated text width
     )
   ) : 0;
-  const LABEL_PADDING = 1.1;
+  const LABEL_PADDING = labelWidth > 0 ? 1.1 : 0;
   schWidth = Math.max(schWidth, labelWidth + LABEL_PADDING);
   let schHeight = params.schHeight;
   if (!schHeight) {
@@ -2389,6 +2455,7 @@ var NormalComponent = class extends PrimitiveComponent {
   _impliedFootprint;
   isPrimitiveContainer = true;
   _asyncSupplierPartNumbers;
+  pcb_missing_footprint_error_id;
   constructor(props) {
     super(props);
     this._addChildrenFromStringFootprint();
@@ -2412,11 +2479,15 @@ var NormalComponent = class extends PrimitiveComponent {
     const { config } = this;
     const portsToCreate = [];
     const schPortArrangement = this._parsedProps.schPortArrangement;
-    if (schPortArrangement) {
+    if (schPortArrangement && !this._parsedProps.pinLabels) {
       for (const side in schPortArrangement) {
         const pins = schPortArrangement[side].pins;
         if (Array.isArray(pins)) {
-          for (const pinNumber of pins) {
+          for (const pinNumberOrLabel of pins) {
+            const pinNumber = parsePinNumberFromLabelsOrThrow(
+              pinNumberOrLabel,
+              this._parsedProps.pinLabels
+            );
             portsToCreate.push(
               new Port(
                 {
@@ -2510,6 +2581,47 @@ var NormalComponent = class extends PrimitiveComponent {
         }
       }
     }
+    for (let pn = 1; pn <= this._getPinCount(); pn++) {
+      if (!this._parsedProps.schPortArrangement) continue;
+      if (portsToCreate.find((p) => p._parsedProps.pinNumber === pn)) continue;
+      let explicitlyListedPinNumbersInSchPortArrangement = [
+        ...this._parsedProps.schPortArrangement?.leftSide?.pins ?? [],
+        ...this._parsedProps.schPortArrangement?.rightSide?.pins ?? [],
+        ...this._parsedProps.schPortArrangement?.topSide?.pins ?? [],
+        ...this._parsedProps.schPortArrangement?.bottomSide?.pins ?? []
+      ].map(
+        (pn2) => parsePinNumberFromLabelsOrThrow(pn2, this._parsedProps.pinLabels)
+      );
+      if ([
+        "leftSize",
+        "rightSize",
+        "topSize",
+        "bottomSize",
+        "leftPinCount",
+        "rightPinCount",
+        "topPinCount",
+        "bottomPinCount"
+      ].some((key) => key in this._parsedProps.schPortArrangement)) {
+        explicitlyListedPinNumbersInSchPortArrangement = Array.from(
+          { length: this._getPinCount() },
+          (_, i) => i + 1
+        );
+      }
+      if (!explicitlyListedPinNumbersInSchPortArrangement.includes(pn)) {
+        continue;
+      }
+      portsToCreate.push(
+        new Port(
+          {
+            pinNumber: pn,
+            aliases: opts.additionalAliases?.[`pin${pn}`] ?? []
+          },
+          {
+            originDescription: `notOtherwiseAddedButDeducedFromPinCount:${pn}`
+          }
+        )
+      );
+    }
     if (portsToCreate.length > 0) {
       this.addAll(portsToCreate);
     }
@@ -2636,6 +2748,14 @@ var NormalComponent = class extends PrimitiveComponent {
       rotation: props.pcbRotation ?? 0,
       source_component_id: this.source_component_id
     });
+    if (!props.footprint) {
+      const footprint_error = db.pcb_missing_footprint_error.insert({
+        message: `No footprint found for component: ${this.componentName}`,
+        source_component_id: `${this.source_component_id}`,
+        error_type: "pcb_missing_footprint_error"
+      });
+      this.pcb_missing_footprint_error_id = footprint_error.pcb_missing_footprint_error_id;
+    }
     this.pcb_component_id = pcb_component.pcb_component_id;
   }
   /**
@@ -2832,7 +2952,17 @@ var NormalComponent = class extends PrimitiveComponent {
   _getPinCount() {
     const schPortArrangement = this._getSchematicPortArrangement();
     if (schPortArrangement) {
-      return (schPortArrangement.leftSize ?? 0) + (schPortArrangement.rightSize ?? 0) + (schPortArrangement.topSize ?? 0) + (schPortArrangement.bottomSize ?? 0);
+      const isExplicitPinMapping = isExplicitPinMappingArrangement(schPortArrangement);
+      if (!isExplicitPinMapping) {
+        return (schPortArrangement.leftSize ?? schPortArrangement.leftPinCount ?? 0) + (schPortArrangement.rightSize ?? schPortArrangement.rightPinCount ?? 0) + (schPortArrangement.topSize ?? schPortArrangement.topPinCount ?? 0) + (schPortArrangement.bottomSize ?? schPortArrangement.bottomPinCount ?? 0);
+      }
+      const { leftSide, rightSide, topSide, bottomSide } = schPortArrangement;
+      return Math.max(
+        ...leftSide?.pins ?? [],
+        ...rightSide?.pins ?? [],
+        ...topSide?.pins ?? [],
+        ...bottomSide?.pins ?? []
+      );
     }
     return this.getPortsFromFootprint().length;
   }
@@ -4908,9 +5038,11 @@ var PinHeader = class extends NormalComponent {
     }
   }
   _getSchematicPortArrangement() {
+    const pinCount = this._parsedProps.pinCount ?? 1;
+    const facingDirection = this._parsedProps.facingDirection ?? "right";
     return {
-      leftSize: 0,
-      rightSize: this._parsedProps.pinCount ?? 1
+      leftSize: facingDirection === "left" ? pinCount : 0,
+      rightSize: facingDirection === "right" ? pinCount : 0
     };
   }
   doInitialSourceRender() {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@tscircuit/core",
   "type": "module",
-  "version": "0.0.172",
+  "version": "0.0.173",
   "types": "dist/index.d.ts",
   "main": "dist/index.js",
   "module": "dist/index.js",
@@ -40,12 +40,12 @@
     "@tscircuit/footprinter": "^0.0.77",
     "@tscircuit/infgrid-ijump-astar": "^0.0.24",
     "@tscircuit/math-utils": "^0.0.5",
-    "@tscircuit/props": "^0.0.93",
+    "@tscircuit/props": "^0.0.94",
     "@tscircuit/schematic-autolayout": "^0.0.6",
     "@tscircuit/soup-util": "^0.0.40",
-    "circuit-json": "^0.0.99",
+    "circuit-json": "^0.0.101",
     "circuit-json-to-connectivity-map": "^0.0.17",
-    "circuit-to-svg": "^0.0.71",
+    "circuit-to-svg": "^0.0.74",
     "format-si-unit": "^0.0.2",
     "nanoid": "^5.0.7",
     "performance-now": "^2.1.0",