@tscircuit/footprinter 0.0.168 → 0.0.169

package/dist/index.d.ts

@@ -364,6 +364,12 @@ declare const any_footprinter_def: z.ZodUnion<[z.ZodObject<{
     od: z.ZodDefault<z.ZodEffects<z.ZodUnion<[z.ZodString, z.ZodNumber]>, number, string | number>>;
     male: z.ZodOptional<z.ZodBoolean>;
     female: z.ZodOptional<z.ZodBoolean>;
+    pinlabeltop: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    pinlabelbottom: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    pinlabelleft: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    pinlabelright: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    pinlabelparallel: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    pinlabelorthogonal: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
     nosquareplating: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
 }, "strip", z.ZodTypeAny, {
     fn: string;
@@ -371,7 +377,13 @@ declare const any_footprinter_def: z.ZodUnion<[z.ZodObject<{
     p: number;
     id: number;
     od: number;
+    pinlabelparallel: boolean;
+    pinlabelorthogonal: boolean;
     rows: number;
+    pinlabeltop: boolean;
+    pinlabelbottom: boolean;
+    pinlabelleft: boolean;
+    pinlabelright: boolean;
     nosquareplating: boolean;
     male?: boolean | undefined;
     female?: boolean | undefined;
@@ -383,9 +395,16 @@ declare const any_footprinter_def: z.ZodUnion<[z.ZodObject<{
     od?: string | number | undefined;
     male?: boolean | undefined;
     female?: boolean | undefined;
+    pinlabelparallel?: boolean | undefined;
+    pinlabelorthogonal?: boolean | undefined;
     rows?: string | number | undefined;
+    pinlabeltop?: boolean | undefined;
+    pinlabelbottom?: boolean | undefined;
+    pinlabelleft?: boolean | undefined;
+    pinlabelright?: boolean | undefined;
     nosquareplating?: boolean | undefined;
 }>, {
+    resolvedPinLabelPosition: "top" | "bottom" | "left" | "right";
     male: boolean;
     female: boolean;
     fn: string;
@@ -393,7 +412,13 @@ declare const any_footprinter_def: z.ZodUnion<[z.ZodObject<{
     p: number;
     id: number;
     od: number;
+    pinlabelparallel: boolean;
+    pinlabelorthogonal: boolean;
     rows: number;
+    pinlabeltop: boolean;
+    pinlabelbottom: boolean;
+    pinlabelleft: boolean;
+    pinlabelright: boolean;
     nosquareplating: boolean;
 }, {
     fn: string;
@@ -403,9 +428,16 @@ declare const any_footprinter_def: z.ZodUnion<[z.ZodObject<{
     od?: string | number | undefined;
     male?: boolean | undefined;
     female?: boolean | undefined;
+    pinlabelparallel?: boolean | undefined;
+    pinlabelorthogonal?: boolean | undefined;
     rows?: string | number | undefined;
+    pinlabeltop?: boolean | undefined;
+    pinlabelbottom?: boolean | undefined;
+    pinlabelleft?: boolean | undefined;
+    pinlabelright?: boolean | undefined;
     nosquareplating?: boolean | undefined;
 }>, {
+    resolvedPinLabelPosition: "top" | "bottom" | "left" | "right";
     male: boolean;
     female: boolean;
     fn: string;
@@ -413,7 +445,13 @@ declare const any_footprinter_def: z.ZodUnion<[z.ZodObject<{
     p: number;
     id: number;
     od: number;
+    pinlabelparallel: boolean;
+    pinlabelorthogonal: boolean;
     rows: number;
+    pinlabeltop: boolean;
+    pinlabelbottom: boolean;
+    pinlabelleft: boolean;
+    pinlabelright: boolean;
     nosquareplating: boolean;
 }, {
     fn: string;
@@ -423,7 +461,13 @@ declare const any_footprinter_def: z.ZodUnion<[z.ZodObject<{
     od?: string | number | undefined;
     male?: boolean | undefined;
     female?: boolean | undefined;
+    pinlabelparallel?: boolean | undefined;
+    pinlabelorthogonal?: boolean | undefined;
     rows?: string | number | undefined;
+    pinlabeltop?: boolean | undefined;
+    pinlabelbottom?: boolean | undefined;
+    pinlabelleft?: boolean | undefined;
+    pinlabelright?: boolean | undefined;
     nosquareplating?: boolean | undefined;
 }>, z.ZodEffects<z.ZodObject<z.objectUtil.extendShape<{
     fn: z.ZodString;
@@ -1014,7 +1058,7 @@ type Footprinter = {
     ssop: (num_pins?: number) => FootprinterParamsBuilder<"w" | "p">;
     tssop: (num_pins?: number) => FootprinterParamsBuilder<"w" | "p">;
     dfn: (num_pins?: number) => FootprinterParamsBuilder<"w" | "p">;
-    pinrow: (num_pins?: number) => FootprinterParamsBuilder<"p" | "id" | "od" | "male" | "female" | "rows" | "nosquareplating">;
+    pinrow: (num_pins?: number) => FootprinterParamsBuilder<"p" | "id" | "od" | "male" | "female" | "rows" | "pinlabeltop" | "pinlabelbottom" | "pinlabelleft" | "pinlabelright" | "pinlabelparallel" | "pinlabelorthogonal" | "nosquareplating">;
     axial: () => FootprinterParamsBuilder<"p" | "id" | "od">;
     hc49: () => FootprinterParamsBuilder<"p" | "id" | "od" | "w" | "h">;
     to220: () => FootprinterParamsBuilder<"w" | "h" | "p" | "id" | "od">;

package/dist/index.js

@@ -1558,23 +1558,48 @@ var platedHoleWithRectPad = (pn, x, y, holeDiameter, rectPadWidth, rectPadHeight
 };
 
 // src/helpers/silkscreenPin.ts
+var fullyExplicitAlignmentMap = {
+  top: { 0: "center", 90: "center_right", 180: "center", 270: "center_left" },
+  bottom: {
+    0: "center",
+    90: "center_left",
+    180: "center",
+    270: "center_right"
+  },
+  left: { 0: "center_right", 90: "center", 180: "center_left", 270: "center" },
+  right: { 0: "center_left", 90: "center", 180: "center_right", 270: "center" }
+};
 var silkscreenPin = ({
-  x,
-  y,
   fs,
-  pn
+  pn,
+  anchor_x,
+  anchor_y,
+  pinlabelposition = "top",
+  pinlabelparallel = false,
+  pinlabelorthogonal = false
 }) => {
+  let ccw_rotation = 0;
+  if (!pinlabelparallel && !pinlabelorthogonal) {
+    ccw_rotation = 0;
+  } else if (pinlabelparallel && !pinlabelorthogonal) {
+    ccw_rotation = 90;
+  } else if (!pinlabelparallel && pinlabelorthogonal) {
+    ccw_rotation = 180;
+  } else if (pinlabelparallel && pinlabelorthogonal) {
+    ccw_rotation = 270;
+  }
+  const anchor_alignment = fullyExplicitAlignmentMap[pinlabelposition][ccw_rotation];
   return {
     type: "pcb_silkscreen_text",
     pcb_silkscreen_text_id: "silkscreen_text_1",
     font: "tscircuit2024",
     font_size: fs,
-    stroke_width: fs / 100,
     pcb_component_id: "pcb_component_1",
     text: `{PIN${pn}}`,
     layer: "top",
-    anchor_position: { x, y },
-    anchor_alignment: "center"
+    anchor_position: { x: anchor_x, y: anchor_y },
+    anchor_alignment,
+    ccw_rotation
   };
 };
 
@@ -1589,12 +1614,39 @@ var pinrow_def = z11.object({
   od: length5.default("1.5mm").describe("outer diameter"),
   male: z11.boolean().optional().describe("for male pin headers"),
   female: z11.boolean().optional().describe("for female pin headers"),
+  pinlabeltop: z11.boolean().optional().default(false),
+  pinlabelbottom: z11.boolean().optional().default(false),
+  pinlabelleft: z11.boolean().optional().default(false),
+  pinlabelright: z11.boolean().optional().default(false),
+  pinlabelparallel: z11.boolean().optional().default(false),
+  pinlabelorthogonal: z11.boolean().optional().default(false),
   nosquareplating: z11.boolean().optional().default(false).describe("do not use rectangular pad for pin 1")
-}).transform((data) => ({
-  ...data,
-  male: data.male ?? (data.female ? false : true),
-  female: data.female ?? false
-})).superRefine((data, ctx) => {
+}).transform((data) => {
+  let resolvedPinLabelPosition;
+  const { pinlabeltop, pinlabelbottom, pinlabelleft, pinlabelright } = data;
+  const truePositionFlags = [];
+  if (pinlabeltop)
+    truePositionFlags.push("top");
+  if (pinlabelbottom)
+    truePositionFlags.push("bottom");
+  if (pinlabelleft)
+    truePositionFlags.push("left");
+  if (pinlabelright)
+    truePositionFlags.push("right");
+  if (truePositionFlags.includes("top")) {
+    resolvedPinLabelPosition = "top";
+  } else if (truePositionFlags.length === 1) {
+    resolvedPinLabelPosition = truePositionFlags[0];
+  } else {
+    resolvedPinLabelPosition = "top";
+  }
+  return {
+    ...data,
+    resolvedPinLabelPosition,
+    male: data.male ?? (data.female ? false : true),
+    female: data.female ?? false
+  };
+}).superRefine((data, ctx) => {
   if (data.male && data.female) {
     ctx.addIssue({
       code: z11.ZodIssueCode.custom,
@@ -1605,18 +1657,67 @@ var pinrow_def = z11.object({
 });
 var pinrow = (raw_params) => {
   const parameters = pinrow_def.parse(raw_params);
-  const { p, id, od, rows, num_pins } = parameters;
+  const {
+    p,
+    id,
+    od,
+    rows,
+    num_pins,
+    resolvedPinLabelPosition,
+    pinlabelparallel,
+    pinlabelorthogonal
+  } = parameters;
   const holes = [];
   const numPinsPerRow = Math.ceil(num_pins / rows);
   const ySpacing = -p;
+  const calculateAnchorPosition = (xoff, yoff, od2, resolvedPinLabelPosition2) => {
+    let dx = 0, dy = 0;
+    const offset = od2 * 0.75;
+    switch (resolvedPinLabelPosition2) {
+      case "right":
+        dx = offset;
+        dy = 0;
+        break;
+      case "top":
+        dx = 0;
+        dy = offset;
+        break;
+      case "bottom":
+        dx = 0;
+        dy = -offset;
+        break;
+      case "left":
+        dx = -offset;
+        dy = 0;
+        break;
+      default:
+        dx = 0;
+        dy = 0;
+    }
+    return { anchor_x: xoff + dx, anchor_y: yoff + dy };
+  };
   const addPin = (pinNumber, xoff, yoff) => {
     if (pinNumber === 1 && !parameters.nosquareplating) {
       holes.push(platedHoleWithRectPad(pinNumber, xoff, yoff, id, od, od));
     } else {
       holes.push(platedhole(pinNumber, xoff, yoff, id, od));
     }
+    const { anchor_x, anchor_y } = calculateAnchorPosition(
+      xoff,
+      yoff,
+      od,
+      resolvedPinLabelPosition
+    );
     holes.push(
-      silkscreenPin({ x: xoff, y: yoff + p / 2, fs: od / 5, pn: pinNumber })
+      silkscreenPin({
+        fs: od / 5,
+        pn: pinNumber,
+        anchor_x,
+        anchor_y,
+        pinlabelposition: resolvedPinLabelPosition,
+        pinlabelparallel,
+        pinlabelorthogonal
+      })
     );
   };
   const usedPositions = /* @__PURE__ */ new Set();