Wire footprint insertion direction into PCB components and align board DRC fields

lib/components/base-components/NormalComponent/NormalComponent.ts

@@ -9,11 +9,14 @@ import type {
   CadModelStep,
   CadModelStl,
   CadModelWrl,
+  FootprintInsertionDirection,
   SchematicPortArrangement,
   SupplierPartNumbers,
 } from "@tscircuit/props"
 import {
   type AnyCircuitElement,
+  type LayerRef,
+  type PcbComponent,
   distance,
   pcb_component_invalid_layer_error,
   pcb_manual_edit_conflict_warning,
@@ -39,6 +42,10 @@ import {
   getPinNumberFromLabels,
   getPortFromHints,
 } from "lib/utils/getPortFromHints"
+import {
+  isFootprintFlipped,
+  transformFootprintInsertionDirection,
+} from "lib/utils/pcb/transform-footprint-insertion-direction"
 import {
   type SchematicBoxDimensions,
   getAllDimensionsForSchematicBox,
@@ -826,10 +833,7 @@ export class NormalComponent<
     }
 
     // Calculate accumulated rotation from parent transforms
-    const globalTransform = this._computePcbGlobalTransformBeforeLayout()
-    const decomposedTransform = decomposeTSR(globalTransform)
-    const accumulatedRotation =
-      (decomposedTransform.rotation.angle * 180) / Math.PI
+    const globalTransformRotation = this.getGlobalTransformRotation()
 
     const pcb_component = db.pcb_component.insert({
       center: this._getGlobalPcbPositionBeforeLayout(),
@@ -840,7 +844,11 @@ export class NormalComponent<
         componentLayer === "top" || componentLayer === "bottom"
           ? componentLayer
           : "top",
-      rotation: props.pcbRotation ?? accumulatedRotation,
+      rotation: props.pcbRotation ?? globalTransformRotation,
+      insertion_direction: this._getPcbComponentInsertionDirection(
+        componentLayer,
+        globalTransformRotation,
+      ),
       source_component_id: this.source_component_id!,
       subcircuit_id: subcircuit.subcircuit_id ?? undefined,
       do_not_place: props.doNotPlace ?? false,
@@ -1046,6 +1054,73 @@ export class NormalComponent<
     this.initPorts()
   }
 
+  protected getGlobalTransformRotation(): number {
+    const globalTransform = this._computePcbGlobalTransformBeforeLayout()
+    const decomposedTransform = decomposeTSR(globalTransform)
+    return (decomposedTransform.rotation.angle * 180) / Math.PI
+  }
+
+  private _getFootprintMetadataForPcbComponent():
+    | {
+        insertionDirection?: FootprintInsertionDirection
+        originalLayer?: LayerRef
+      }
+    | undefined {
+    const footprintChild = this.children.find(
+      (c) => c.componentName === "Footprint",
+    )
+
+    if (footprintChild) {
+      return {
+        insertionDirection: footprintChild._parsedProps.insertionDirection,
+        originalLayer: footprintChild._parsedProps.originalLayer,
+      }
+    }
+
+    const footprint = this.props.footprint
+
+    if (isValidElement(footprint)) {
+      const footprintProps = footprint.props as {
+        insertionDirection?: FootprintInsertionDirection
+        originalLayer?: LayerRef
+      }
+      return {
+        insertionDirection: footprintProps.insertionDirection,
+        originalLayer: footprintProps.originalLayer,
+      }
+    }
+
+    if (footprint?.componentName === "Footprint") {
+      return {
+        insertionDirection:
+          footprint._parsedProps?.insertionDirection ??
+          footprint.props?.insertionDirection,
+        originalLayer:
+          footprint._parsedProps?.originalLayer ??
+          footprint.props?.originalLayer,
+      }
+    }
+
+    return undefined
+  }
+
+  protected _getPcbComponentInsertionDirection(
+    componentLayer: LayerRef,
+    rotationDegrees: number = this.getGlobalTransformRotation(),
+  ): PcbComponent["insertion_direction"] | undefined {
+    const footprintMetadata = this._getFootprintMetadataForPcbComponent()
+    if (!footprintMetadata?.insertionDirection) return undefined
+
+    return transformFootprintInsertionDirection({
+      insertionDirection: footprintMetadata.insertionDirection,
+      rotationDegrees,
+      isFlipped: isFootprintFlipped({
+        componentLayer,
+        originalLayer: footprintMetadata.originalLayer,
+      }),
+    })
+  }
+
   doInitialReactSubtreesRender(): void {
     // Add React-based footprint subtree if provided
     const fpElm = this.props.footprint

lib/components/base-components/PrimitiveComponent/PrimitiveComponent.ts

@@ -16,6 +16,7 @@ import {
   extractCalcIdentifiers,
 } from "lib/utils/evaluateCalcString"
 import { getSubcircuitPcbCalcVariables } from "lib/utils/getSubcircuitPcbCalcVariables"
+import { isFootprintFlipped } from "lib/utils/pcb/transform-footprint-insertion-direction"
 import { getResolvedPcbSx } from "lib/utils/pcbSx/get-resolved-pcb-sx"
 import type {
   SchematicBoxComponentDimensions,
@@ -511,17 +512,14 @@ export abstract class PrimitiveComponent<
     // If this is a primitive, and the parent primitive container is flipped,
     // we flip it's position
     if (this.isPcbPrimitive) {
-      const primitiveContainer = this.getPrimitiveContainer()
-      if (primitiveContainer) {
-        const isFlipped = primitiveContainer._parsedProps.layer === "bottom"
+      const { isFlipped } = this._getPcbPrimitiveFlippedHelpers()
 
-        if (isFlipped) {
-          return compose(
-            this.parent?._computePcbGlobalTransformBeforeLayout() ?? identity(),
-            flipY(),
-            this.computePcbPropsTransform(),
-          )
-        }
+      if (isFlipped) {
+        return compose(
+          this.parent?._computePcbGlobalTransformBeforeLayout() ?? identity(),
+          flipY(),
+          this.computePcbPropsTransform(),
+        )
       }
     }
 
@@ -531,6 +529,17 @@ export abstract class PrimitiveComponent<
     )
   }
 
+  private _getEnclosingFootprint(): PrimitiveComponent | null {
+    let current: PrimitiveComponent | null = this.parent
+    while (current) {
+      if (current.componentName === "Footprint") {
+        return current
+      }
+      current = current.parent
+    }
+    return null
+  }
+
   getPrimitiveContainer(): PrimitiveComponent | null {
     if (this.isPrimitiveContainer) return this
     return this.parent?.getPrimitiveContainer?.() ?? null
@@ -643,9 +652,14 @@ export abstract class PrimitiveComponent<
     maybeFlipLayer: (layer: LayerRef) => LayerRef
   } {
     const container = this.getPrimitiveContainer()
+    const footprint =
+      this.componentName === "Footprint" ? this : this._getEnclosingFootprint()
     const isFlipped = !container
       ? false
-      : container._parsedProps.layer === "bottom"
+      : isFootprintFlipped({
+          componentLayer: container._parsedProps.layer,
+          originalLayer: footprint?._parsedProps.originalLayer,
+        })
     const maybeFlipLayer = (layer: LayerRef) => {
       if (isFlipped) {
         return layer === "top" ? "bottom" : "top"

lib/components/normal-components/Board.ts

@@ -18,7 +18,7 @@ import type { SubcircuitI } from "../primitive-components/Group/Subcircuit/Subci
 import { Subcircuit_doInitialRenderIsolatedSubcircuits } from "../primitive-components/Group/Subcircuit/Subcircuit_doInitialRenderIsolatedSubcircuits"
 import { Subcircuit_getSubcircuitPropHash } from "../primitive-components/Group/Subcircuit_getSubcircuitPropHash"
 import type { BoardI } from "./BoardI"
-import { jlcMinTolerances } from "@tscircuit/jlcpcb-manufacturing-specs"
+import { jlcMinTolerances } from "../../utils/pcb/jlc-manufacturing-tolerances"
 
 const MIN_EFFECTIVE_BORDER_RADIUS_MM = 0.01
 
@@ -534,12 +534,15 @@ export class Board
       min_via_pad_diameter:
         subcircuitProps.minViaPadDiameter ??
         jlcMinTolerances.min_via_pad_diameter,
-      min_trace_to_pad_spacing:
-        subcircuitProps.minTraceToPadSpacing ??
-        jlcMinTolerances.min_trace_to_pad_spacing,
-      min_pad_to_pad_spacing:
-        subcircuitProps.minPadToPadSpacing ??
-        jlcMinTolerances.min_pad_to_pad_spacing,
+      min_via_to_via_clearance:
+        subcircuitProps.minViaToViaClearance ??
+        jlcMinTolerances.min_via_to_via_clearance,
+      min_trace_to_pad_clearance:
+        subcircuitProps.minTraceToPadClearance ??
+        jlcMinTolerances.min_trace_to_pad_clearance,
+      min_pad_to_pad_clearance:
+        subcircuitProps.minPadToPadClearance ??
+        jlcMinTolerances.min_pad_to_pad_clearance,
     } as Omit<PcbBoard, "type" | "pcb_board_id">)
 
     this.pcb_board_id = pcb_board.pcb_board_id!

lib/components/normal-components/Chip.ts

@@ -131,6 +131,8 @@ export class Chip<PinLabels extends string = never> extends NormalComponent<
       // Still create the component but with 'top' as fallback to avoid cascading errors
     }
 
+    const globalTransformRotation = this.getGlobalTransformRotation()
+
     const pcb_component = db.pcb_component.insert({
       center: { x: pcbX, y: pcbY },
       width: 2, // Default width, adjust as needed
@@ -139,7 +141,11 @@ export class Chip<PinLabels extends string = never> extends NormalComponent<
         componentLayer === "top" || componentLayer === "bottom"
           ? componentLayer
           : "top",
-      rotation: props.pcbRotation ?? 0,
+      rotation: props.pcbRotation ?? globalTransformRotation,
+      insertion_direction: this._getPcbComponentInsertionDirection(
+        componentLayer,
+        globalTransformRotation,
+      ),
       source_component_id: this.source_component_id!,
       subcircuit_id: this.getSubcircuit().subcircuit_id ?? undefined,
       do_not_place: props.doNotPlace ?? false,

lib/components/normal-components/Jumper.ts

@@ -67,13 +67,18 @@ export class Jumper<PinLabels extends string = never> extends NormalComponent<
     const { db } = this.root!
     const { _parsedProps: props } = this
     const { pcbX, pcbY } = this.getResolvedPcbPositionProp()
+    const globalTransformRotation = this.getGlobalTransformRotation()
 
     const pcb_component = db.pcb_component.insert({
       center: { x: pcbX, y: pcbY },
       width: 2, // Default width, adjust as needed
       height: 3, // Default height, adjust as needed
       layer: props.layer ?? "top",
-      rotation: props.pcbRotation ?? 0,
+      rotation: props.pcbRotation ?? globalTransformRotation,
+      insertion_direction: this._getPcbComponentInsertionDirection(
+        props.layer ?? "top",
+        globalTransformRotation,
+      ),
       source_component_id: this.source_component_id!,
       subcircuit_id: this.getSubcircuit().subcircuit_id ?? undefined,
       do_not_place: props.doNotPlace ?? false,

lib/components/normal-components/SolderJumper.ts

@@ -143,13 +143,18 @@ export class SolderJumper<
     const { db } = this.root!
     const { _parsedProps: props } = this
     const { pcbX, pcbY } = this.getResolvedPcbPositionProp()
+    const globalTransformRotation = this.getGlobalTransformRotation()
 
     const pcb_component = db.pcb_component.insert({
       center: { x: pcbX, y: pcbY },
       width: 2, // Default width, adjust as needed
       height: 3, // Default height, adjust as needed
       layer: props.layer ?? "top",
-      rotation: props.pcbRotation ?? 0,
+      rotation: props.pcbRotation ?? globalTransformRotation,
+      insertion_direction: this._getPcbComponentInsertionDirection(
+        props.layer ?? "top",
+        globalTransformRotation,
+      ),
       source_component_id: this.source_component_id!,
       subcircuit_id: this.getSubcircuit().subcircuit_id ?? undefined,
       do_not_place: props.doNotPlace ?? false,

lib/components/primitive-components/Group/Group_doInitialPcbLayoutPack/applyPackOutput.ts

@@ -7,6 +7,7 @@ import {
 import type { PackOutput } from "calculate-packing"
 import type { ClusterInfo } from "./applyComponentConstraintClusters"
 import { normalizeDegrees } from "@tscircuit/math-utils"
+import { updatePcbInsertionDirection } from "./updatePcbInsertionDirection"
 
 const updateCadRotation = ({
   db,
@@ -100,6 +101,11 @@ export const applyPackOutput = (
           rotationDegrees,
           layer: member.layer,
         })
+        updatePcbInsertionDirection({
+          db,
+          pcbComponentId: memberId,
+          rotationDegrees,
+        })
       }
       continue
     }
@@ -143,6 +149,11 @@ export const applyPackOutput = (
         rotationDegrees,
         layer: pcbComponent.layer,
       })
+      updatePcbInsertionDirection({
+        db,
+        pcbComponentId: componentId,
+        rotationDegrees,
+      })
       continue
     }
 
@@ -212,6 +223,15 @@ export const applyPackOutput = (
     }
 
     transformPCBElements(relatedElements as any, transformMatrix)
+    for (const elm of relatedElements) {
+      if (elm.type === "pcb_component") {
+        updatePcbInsertionDirection({
+          db,
+          pcbComponentId: elm.pcb_component_id,
+          rotationDegrees,
+        })
+      }
+    }
     db.pcb_group.update(pcbGroup.pcb_group_id, { center })
   }
 }

lib/components/primitive-components/Group/Group_doInitialPcbLayoutPack/updatePcbInsertionDirection.ts

@@ -0,0 +1,29 @@
+import type { CircuitJsonUtilObjects } from "@tscircuit/circuit-json-util"
+import { transformFootprintInsertionDirection } from "lib/utils/pcb/transform-footprint-insertion-direction"
+
+export const updatePcbInsertionDirection = ({
+  db,
+  pcbComponentId,
+  rotationDegrees,
+}: {
+  db: CircuitJsonUtilObjects
+  pcbComponentId: string
+  rotationDegrees: number
+}) => {
+  if (rotationDegrees == null) return
+
+  const pcbComponent = db.pcb_component.get(pcbComponentId)
+  if (!pcbComponent?.insertion_direction) return
+
+  const nextDirection = transformFootprintInsertionDirection({
+    insertionDirection: pcbComponent.insertion_direction,
+    rotationDegrees,
+  })
+
+  if (!nextDirection) return
+
+  db.pcb_component.update(pcbComponentId, {
+    insertion_direction: nextDirection,
+  })
+  pcbComponent.insertion_direction = nextDirection
+}

lib/components/primitive-components/Trace/Trace_doInitialPcbManualTraceRender.ts

@@ -8,7 +8,7 @@ import { getViaDiameterDefaults } from "../../../utils/pcbStyle/getViaDiameterDe
 import type { ManualPcbPathPoint } from "lib/utils/pcbTraceRouteToPcbPath"
 import { TraceConnectionError } from "lib/errors"
 import { getPcbSelectorErrorForTracePort } from "./getPcbSelectorErrorForTracePort"
-import { jlcMinTolerances } from "@tscircuit/jlcpcb-manufacturing-specs"
+import { jlcMinTolerances } from "lib/utils/pcb/jlc-manufacturing-tolerances"
 
 export function Trace_doInitialPcbManualTraceRender(trace: Trace) {
   if (trace.root?.pcbDisabled) return

lib/components/primitive-components/Trace/Trace_doInitialPcbTraceRender.ts

@@ -15,7 +15,7 @@ import { getObstaclesFromCircuitJson } from "lib/utils/obstacles/getObstaclesFro
 import { getViaDiameterDefaults } from "lib/utils/pcbStyle/getViaDiameterDefaults"
 import { TraceConnectionError } from "lib/errors"
 import { getPcbSelectorErrorForTracePort } from "./getPcbSelectorErrorForTracePort"
-import { jlcMinTolerances } from "@tscircuit/jlcpcb-manufacturing-specs"
+import { jlcMinTolerances } from "lib/utils/pcb/jlc-manufacturing-tolerances"
 
 type PcbRouteObjective =
   | RouteHintPoint

lib/utils/pcb/jlc-manufacturing-tolerances.ts

@@ -0,0 +1,12 @@
+import type { PcbBoard } from "circuit-json"
+
+export type JlcToleranceMap = Partial<Record<keyof PcbBoard, number>>
+
+export const jlcMinTolerances: JlcToleranceMap = {
+  min_trace_width: 0.1,
+  min_via_to_via_clearance: 0.1,
+  min_trace_to_pad_clearance: 0.1,
+  min_pad_to_pad_clearance: 0.1,
+  min_via_hole_diameter: 0.2,
+  min_via_pad_diameter: 0.3,
+}