@tscircuit/footprinter 0.0.156 → 0.0.158

package/dist/index.d.ts

@@ -1028,6 +1028,7 @@ type Footprinter = {
     sma: () => FootprinterParamsBuilder<"w" | "h" | "p" | "pl" | "pw">;
     smf: () => FootprinterParamsBuilder<"w" | "h" | "p" | "pl" | "pw">;
     smb: () => FootprinterParamsBuilder<"w" | "h" | "p" | "pl" | "pw">;
+    potentiometer: () => FootprinterParamsBuilder<"w" | "h" | "p" | "id" | "od" | "pw" | "ca">;
     sod923: () => FootprinterParamsBuilder<"w" | "h" | "p" | "pl" | "pw">;
     sod323: () => FootprinterParamsBuilder<"w" | "h" | "p" | "pl" | "pw">;
     sod80: () => FootprinterParamsBuilder<"w" | "h" | "p" | "pl" | "pw">;

package/dist/index.js

@@ -27,6 +27,7 @@ __export(fn_exports, {
   msop: () => msop,
   pad: () => pad,
   pinrow: () => pinrow,
+  potentiometer: () => potentiometer,
   pushbutton: () => pushbutton,
   qfn: () => qfn,
   qfp: () => qfp,
@@ -1580,43 +1581,103 @@ var pinrow_def = z11.object({
 });
 var pinrow = (raw_params) => {
   const parameters = pinrow_def.parse(raw_params);
-  const { p, id, od, rows } = parameters;
-  const numPins = parameters.num_pins;
+  const { p, id, od, rows, num_pins } = parameters;
   const holes = [];
+  const numPinsPerRow = Math.ceil(num_pins / rows);
+  const ySpacing = -p;
   const addPin = (pinNumber, xoff, yoff) => {
     holes.push(platedhole(pinNumber, xoff, yoff, id, od));
     holes.push(
       silkscreenPin({ x: xoff, y: yoff + p / 2, fs: od / 5, pn: pinNumber })
     );
   };
-  if (rows > 1) {
-    const numPinsPerRow = Math.ceil(numPins / rows);
-    const ySpacing = p;
-    for (let row = 0; row < rows; row++) {
-      const yoff = row * ySpacing;
-      const startPin = row * numPinsPerRow;
-      const xStart = -((numPinsPerRow - 1) / 2) * p;
-      for (let i = 0; i < numPinsPerRow; i++) {
-        const pinNumber = startPin + i + 1;
-        if (pinNumber > numPins)
-          break;
-        const xoff = xStart + i * p;
-        addPin(pinNumber, xoff, yoff);
-      }
-    }
-  } else {
-    const xStart = -((numPins - 1) / 2) * p;
-    for (let i = 0; i < numPins; i++) {
+  const usedPositions = /* @__PURE__ */ new Set();
+  const useBGAStyle = rows > 2 && numPinsPerRow > 2;
+  if (rows === 1) {
+    const xStart = -((num_pins - 1) / 2) * p;
+    for (let i = 0; i < num_pins; i++) {
       const pinNumber = i + 1;
       const xoff = xStart + i * p;
+      const posKey = `${xoff},${0}`;
+      if (usedPositions.has(posKey))
+        throw new Error(`Overlap at ${posKey}`);
+      usedPositions.add(posKey);
       addPin(pinNumber, xoff, 0);
     }
+  } else if (useBGAStyle) {
+    const xStart = -((numPinsPerRow - 1) / 2) * p;
+    let currentPin = 1;
+    for (let row = 0; row < rows && currentPin <= num_pins; row++) {
+      for (let col = 0; col < numPinsPerRow && currentPin <= num_pins; col++) {
+        const xoff = xStart + col * p;
+        const yoff = row * ySpacing;
+        const posKey = `${xoff},${yoff}`;
+        if (usedPositions.has(posKey))
+          throw new Error(`Overlap at ${posKey}`);
+        usedPositions.add(posKey);
+        addPin(currentPin++, xoff, yoff);
+      }
+    }
+  } else {
+    const xStart = -((numPinsPerRow - 1) / 2) * p;
+    let currentPin = 1;
+    let top = 0;
+    let bottom = rows - 1;
+    let left = 0;
+    let right = numPinsPerRow - 1;
+    while (currentPin <= num_pins && top <= bottom && left <= right) {
+      for (let row = top; row <= bottom && currentPin <= num_pins; row++) {
+        const xoff = xStart + left * p;
+        const yoff = row * ySpacing;
+        const posKey = `${xoff},${yoff}`;
+        if (usedPositions.has(posKey))
+          throw new Error(`Overlap at ${posKey}`);
+        usedPositions.add(posKey);
+        addPin(currentPin++, xoff, yoff);
+      }
+      left++;
+      for (let col = left; col <= right && currentPin <= num_pins; col++) {
+        const xoff = xStart + col * p;
+        const yoff = bottom * ySpacing;
+        const posKey = `${xoff},${yoff}`;
+        if (usedPositions.has(posKey))
+          throw new Error(`Overlap at ${posKey}`);
+        usedPositions.add(posKey);
+        addPin(currentPin++, xoff, yoff);
+      }
+      bottom--;
+      if (left <= right) {
+        for (let row = bottom; row >= top && currentPin <= num_pins; row--) {
+          const xoff = xStart + right * p;
+          const yoff = row * ySpacing;
+          const posKey = `${xoff},${yoff}`;
+          if (usedPositions.has(posKey))
+            throw new Error(`Overlap at ${posKey}`);
+          usedPositions.add(posKey);
+          addPin(currentPin++, xoff, yoff);
+        }
+        right--;
+      }
+      if (top <= bottom) {
+        for (let col = right; col >= left && currentPin <= num_pins; col--) {
+          const xoff = xStart + col * p;
+          const yoff = top * ySpacing;
+          const posKey = `${xoff},${yoff}`;
+          if (usedPositions.has(posKey))
+            throw new Error(`Overlap at ${posKey}`);
+          usedPositions.add(posKey);
+          addPin(currentPin++, xoff, yoff);
+        }
+        top++;
+      }
+    }
+    if (currentPin - 1 < num_pins) {
+      throw new Error(
+        `Missing pins: assigned ${currentPin - 1}, expected ${num_pins}`
+      );
+    }
   }
-  const perRow = rows > 1 ? Math.ceil(numPins / rows) : numPins;
-  const xStartGroup = -((perRow - 1) / 2) * p;
-  const groupTextX = xStartGroup + (perRow - 1) / 2 * p;
-  const groupTextY = rows * p;
-  const refText = silkscreenRef(groupTextX, groupTextY, 0.5);
+  const refText = silkscreenRef(0, p, 0.5);
   return {
     circuitJson: [...holes, refText],
     parameters
@@ -3938,8 +3999,8 @@ var to220_def = z34.object({
 });
 var to220 = (raw_params) => {
   const parameters = to220_def.parse(raw_params);
-  const { fn, id, od, w, h, string: string2 } = parameters;
-  const numPins = Number.parseInt(string2?.split("_")[1] ?? "3");
+  const { fn, id, od, w, h, string: string3 } = parameters;
+  const numPins = Number.parseInt(string3?.split("_")[1] ?? "3");
   const holeY = -1;
   const halfWidth = w / 2;
   const halfHeight = h / 2;
@@ -5703,13 +5764,91 @@ var solderjumper = (params) => {
   };
 };
 
+// src/fn/potentiometer.ts
+import { z as z52 } from "zod";
+var potentiometer_def = z52.object({
+  fn: z52.string(),
+  num_pins: z52.union([z52.literal(3), z52.literal(2)]).default(3),
+  p: z52.string().default("3.8mm"),
+  id: z52.string().default("1.25mm"),
+  od: z52.string().default("2.35mm"),
+  ca: z52.string().default("14mm").describe(
+    "Caliper axis (width or diameter of the potentiometer body or adjustment knob)"
+  ),
+  w: z52.string().default("5.35mm"),
+  h: z52.string().default("4mm"),
+  string: z52.string().optional()
+});
+var potentiometer_acp = (parameters) => {
+  const { p, id, od, h, ca } = parameters;
+  const y = Number.parseFloat(h);
+  const caliper = Number.parseFloat(ca);
+  return [
+    platedhole(1, 0, caliper / 4 + 0.3, id, od),
+    platedhole(2, y, 0, id, od),
+    platedhole(3, 0, -caliper / 4 - 0.3, id, od)
+  ];
+};
+var potentiometer = (raw_params) => {
+  const match = raw_params.string?.match(/^potentiometer_(\d+)/);
+  const numPins = match ? Number.parseInt(match[1], 10) : 3;
+  const parameters = potentiometer_def.parse({
+    ...raw_params,
+    num_pins: numPins
+  });
+  let platedHoles = [];
+  if (parameters.num_pins === 3) {
+    platedHoles = potentiometer_acp(parameters);
+  }
+  const y = Number.parseFloat(parameters.ca) / 2 + 0.15;
+  const x = Number.parseFloat(parameters.w);
+  const od = Number.parseFloat(parameters.od) / 2 + 0.35;
+  const silkscreenBody = {
+    type: "pcb_silkscreen_path",
+    layer: "top",
+    pcb_component_id: "",
+    route: [
+      { x: 0, y: y - 1.75 },
+      { x: 0, y },
+      { x, y },
+      { x, y: od }
+    ],
+    stroke_width: 0.1,
+    pcb_silkscreen_path_id: ""
+  };
+  const silkscreenBody2 = {
+    type: "pcb_silkscreen_path",
+    layer: "top",
+    pcb_component_id: "",
+    route: [
+      { x, y: -od },
+      { x, y: -y },
+      { x: 0, y: -y },
+      { x: 0, y: -y + 1.75 }
+    ],
+    stroke_width: 0.1,
+    pcb_silkscreen_path_id: ""
+  };
+  const W = Number.parseFloat(parameters.w) / 2;
+  const silkscreenRefText = silkscreenRef(W, y + 1, 0.5);
+  return {
+    circuitJson: [
+      ...platedHoles,
+      silkscreenBody,
+      silkscreenBody2,
+      silkscreenRefText
+    ],
+    parameters
+  };
+};
+
 // src/helpers/is-not-null.ts
 function isNotNull(value) {
   return value !== null;
 }
 
 // src/footprinter.ts
-var string = (def) => {
+var string2 = (def) => {
   let fp2 = footprinter();
   const modifiedDef = (def.length === 4 || def.length === 5) && /^\d+$/.test(def) ? `res${def}` : def;
   const def_parts = modifiedDef.split("_").map((s) => {
@@ -5813,7 +5952,7 @@ var footprinter = () => {
   );
   return proxy;
 };
-footprinter.string = string;
+footprinter.string = string2;
 footprinter.getFootprintNames = getFootprintNames;
 var fp = footprinter;
 export {
@@ -5822,6 +5961,6 @@ export {
   getFootprintNames,
   getFootprintNamesByType,
   getFootprintSizes,
-  string
+  string2 as string
 };
 //# sourceMappingURL=index.js.map