@tscircuit/checks 0.0.148 → 0.0.150

package/dist/index.d.ts

@@ -80,6 +80,8 @@ declare function checkViaTraceClearance(circuitJson: AnyCircuitElement[], { conn
     minClearance?: number;
 }): PcbViaTraceClearanceError[];
 
+declare function checkViasInPads(circuitJson: AnyCircuitElement[]): PcbPlacementError[];
+
 /**
  * Removes generic pcb_trace_error records when a more specific pad-trace or
  * via-trace clearance error describes the same physical pair.
@@ -159,4 +161,4 @@ declare function checkConnectorAccessibleOrientation(circuitJson: AnyCircuitElem
  */
 declare function checkTestPointAccessibility(circuitJson: AnyCircuitElement[]): PcbPlacementError[];
 
-export { NetManager, checkAllPinsInComponentAreUnderspecified, checkConnectorAccessibleOrientation, checkDifferentNetViaSpacing, checkEachPcbPortConnectedToPcbTraces, checkEachPcbTraceNonOverlapping, checkNoGroundPinDefined, checkNoPowerPinDefined, checkPadPadClearance, checkPadTraceClearance, checkPcbComponentOverlap, checkPcbComponentsOutOfBoard, checkPcbTraceLengths, checkPcbTracesOutOfBoard, checkPinMustBeConnected, checkSameNetViaSpacing, checkSourceTracesHavePcbTraces, checkSourceTracesMatchPcbTraceThickness, checkTestPointAccessibility, checkTracesAreContiguous, checkViaTraceClearance, checkViasOffBoard, dedupePcbDrcErrors, runAllChecks, runAllNetlistChecks, runAllPinSpecificationChecks, runAllPlacementChecks, runAllRoutingChecks };
+export { NetManager, checkAllPinsInComponentAreUnderspecified, checkConnectorAccessibleOrientation, checkDifferentNetViaSpacing, checkEachPcbPortConnectedToPcbTraces, checkEachPcbTraceNonOverlapping, checkNoGroundPinDefined, checkNoPowerPinDefined, checkPadPadClearance, checkPadTraceClearance, checkPcbComponentOverlap, checkPcbComponentsOutOfBoard, checkPcbTraceLengths, checkPcbTracesOutOfBoard, checkPinMustBeConnected, checkSameNetViaSpacing, checkSourceTracesHavePcbTraces, checkSourceTracesMatchPcbTraceThickness, checkTestPointAccessibility, checkTracesAreContiguous, checkViaTraceClearance, checkViasInPads, checkViasOffBoard, dedupePcbDrcErrors, runAllChecks, runAllNetlistChecks, runAllPinSpecificationChecks, runAllPlacementChecks, runAllRoutingChecks };

package/dist/index.js

@@ -448,6 +448,16 @@ var getReadableNameForElementId = (circuitJson, elementId) => sanitizeReadableNa
   "element"
 );
 var containsCircuitJsonId = (message) => CIRCUIT_JSON_ID_PATTERN.test(message);
+function getReadableNameForFootprintPad(circuitJson, pad, ordinal) {
+  const padKind = pad.type === "pcb_smtpad" ? "SMD pad" : "through-hole pad";
+  const portRef = pad.pcb_port_id ? getReadableNameForPort(circuitJson, pad.pcb_port_id) : null;
+  const bounds = getBoundsOfPcbElements([pad]);
+  const centerX = (bounds.minX + bounds.maxX) / 2;
+  const centerY = (bounds.minY + bounds.maxY) / 2;
+  const location = `(${centerX.toFixed(2)}mm, ${centerY.toFixed(2)}mm)`;
+  if (portRef) return `${padKind} ${portRef} at ${location}`;
+  return `${padKind} #${ordinal + 1} at ${location}`;
+}
 
 // lib/check-each-pcb-port-connected-to-pcb-trace.ts
 function checkEachPcbPortConnectedToPcbTraces(circuitJson) {
@@ -2760,6 +2770,58 @@ function checkViaTraceClearance(circuitJson, {
   return Array.from(errors.values()).map(({ error }) => error);
 }
 
+// lib/check-vias-in-pads.ts
+import { getPrimaryId as getPrimaryId5 } from "@tscircuit/circuit-json-util";
+function checkViasInPads(circuitJson) {
+  const board = getPcbBoard(circuitJson);
+  if (board && "is_via_in_pad_allowed" in board && board.is_via_in_pad_allowed === true) {
+    return [];
+  }
+  const vias = circuitJson.filter(
+    (element) => element.type === "pcb_via"
+  );
+  const pads = getPads(circuitJson);
+  if (vias.length === 0 || pads.length === 0) return [];
+  const padOrdinals = new Map(
+    pads.map((pad, index) => [getPrimaryId5(pad), index])
+  );
+  const padIndex = new SpatialObjectIndex({
+    objects: pads,
+    getBounds: getPadBounds,
+    getId: getPrimaryId5
+  });
+  const errors = [];
+  for (const via of vias) {
+    const nearbyPads = padIndex.getObjectsInBounds({
+      minX: via.x,
+      minY: via.y,
+      maxX: via.x,
+      maxY: via.y
+    });
+    for (const pad of nearbyPads) {
+      const viaLayers = getLayersOfPcbElement(via);
+      const padLayers = getLayersOfPcbElement(pad);
+      if (!viaLayers.some((layer) => padLayers.includes(layer))) continue;
+      if (!isPointInPad(via, pad)) continue;
+      const padId = getPrimaryId5(pad);
+      const padOrdinal = padOrdinals.get(padId) ?? 0;
+      const padName = getReadableNameForFootprintPad(
+        circuitJson,
+        pad,
+        padOrdinal
+      );
+      errors.push({
+        type: "pcb_placement_error",
+        pcb_placement_error_id: `via_in_pad_${via.pcb_via_id}_${padId}`,
+        error_type: "pcb_placement_error",
+        message: `Via at (${via.x.toFixed(2)}mm, ${via.y.toFixed(2)}mm) is inside ${padName}`,
+        subcircuit_id: via.subcircuit_id ?? pad.subcircuit_id
+      });
+    }
+  }
+  return errors;
+}
+
 // lib/dedupe-pcb-drc-errors.ts
 var dedupePcbDrcErrors = (errors) => {
   const specificallyReportedPairIds = /* @__PURE__ */ new Set();
@@ -3256,6 +3318,7 @@ function checkTestPointAccessibility(circuitJson) {
 async function runAllPlacementChecks(circuitJson) {
   return [
     ...checkViasOffBoard(circuitJson),
+    ...checkViasInPads(circuitJson),
     ...checkPcbComponentsOutOfBoard(circuitJson),
     ...checkPcbComponentOverlap(circuitJson),
     ...checkPadPadClearance(circuitJson),
@@ -3318,6 +3381,7 @@ export {
   checkTestPointAccessibility,
   checkTracesAreContiguous,
   checkViaTraceClearance,
+  checkViasInPads,
   checkViasOffBoard,
   dedupePcbDrcErrors,
   runAllChecks,