@tscircuit/footprinter 0.0.11 → 0.0.13

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@tscircuit/footprinter",
   "type": "module",
-  "version": "0.0.11",
+  "version": "0.0.13",
   "description": "",
   "main": "dist/index.cjs",
   "scripts": {

package/src/fn/dip.ts

@@ -1,4 +1,5 @@
 import type { AnySoupElement, PcbSilkscreenPath } from "@tscircuit/soup"
+import { u_curve } from "../helpers/u-curve"
 import { platedhole } from "../helpers/platedhole"
 import { z } from "zod"
 import { length } from "@tscircuit/soup"
@@ -91,5 +92,27 @@ export const dip = (raw_params: {
       platedhole(i + 1, x, y, params.id ?? "0.8mm", params.od ?? "1mm")
     )
   }
-  return platedHoles
+  /** silkscreen width */
+  const sw = params.w - params.od - 0.4
+  const sh = (params.num_pins / 2 - 1) * params.p + params.od + 0.4
+  const silkscreenBorder: PcbSilkscreenPath = {
+    layer: "top",
+    pcb_component_id: "",
+    pcb_silkscreen_path_id: "silkscreen_path_1",
+    route: [
+      { x: -sw / 2, y: -sh / 2 },
+      { x: -sw / 2, y: sh / 2 },
+      // Little U shape at the top
+      ...u_curve.map(({ x, y }) => ({
+        x: (x * sw) / 6,
+        y: (y * sw) / 6 + sh / 2,
+      })),
+      { x: sw / 2, y: sh / 2 },
+      { x: sw / 2, y: -sh / 2 },
+      { x: -sw / 2, y: -sh / 2 },
+    ],
+    type: "pcb_silkscreen_path",
+  }
+
+  return [...platedHoles, silkscreenBorder]
 }

package/src/fn/quad.ts

@@ -0,0 +1,131 @@
+import type { AnySoupElement } from "@tscircuit/soup"
+import { z } from "zod"
+import { length } from "@tscircuit/soup"
+import type { NowDefined } from "../helpers/zod/now-defined"
+import { rectpad } from "../helpers/rectpad"
+
+const pin_order_specifier = z.enum([
+  "leftside",
+  "topside",
+  "rightside",
+  "bottomside",
+  "toppin",
+  "bottompin",
+  "leftpin",
+  "rightpin",
+])
+
+const base_quad_def = z.object({
+  quad: z.literal(true),
+  cc: z.literal(true).optional(),
+  ccw: z.literal(true).optional(),
+  startingpin: z.array(pin_order_specifier).optional(),
+  num_pins: z.number(),
+  w: length.optional(),
+  h: length.optional(),
+  p: length.default(length.parse("0.5mm")),
+  pw: length.optional(),
+  pl: length.optional(),
+})
+
+const quad_def = base_quad_def.transform((v) => {
+  if (v.w && !v.h) {
+    v.h = v.w
+  } else if (!v.w && v.h) {
+    v.w = v.h
+  }
+
+  const side_pin_count = v.num_pins / 4
+
+  if (!v.p && !v.pw && !v.pl && v.w) {
+    // HACK: This is wayyy underspecified
+    const approx_pin_size_of_side = side_pin_count + 4
+    v.p = v.w / approx_pin_size_of_side
+  }
+
+  if (!v.p && v.w && v.h && v.pw && v.pl) {
+    // HACK: This is wayyy underspecified
+    v.p = (v.w - v.pl * 2) / (side_pin_count - 1)
+  }
+
+  if (v.p && !v.pw && !v.pl) {
+    v.pw = v.p / 2
+    v.pl = v.p / 2
+  } else if (!v.pw) {
+    v.pw = v.pl! * (0.6 / 1.0)
+  } else if (!v.pl) {
+    v.pl = v.pw! * (1.0 / 0.6)
+  }
+
+  return v as NowDefined<typeof v, "w" | "h" | "p" | "pw" | "pl">
+})
+
+const SIDES_CCW = ["left", "bottom", "right", "top"] as const
+
+export const getQuadCoords = (
+  pinCount: number,
+  pn: number, // pin number
+  w: number, // width of the package
+  h: number, // height (length) of the package
+  p: number // pitch between pins
+) => {
+  const sidePinCount = pinCount / 4
+  const side = SIDES_CCW[Math.floor((pn - 1) / sidePinCount)]
+  const pos = (pn - 1) % sidePinCount
+
+  const halfW = w / 2
+  const halfH = h / 2
+
+  /** inner box width */
+  const ibw = p * (sidePinCount - 1)
+  /** inner box height */
+  const ibh = p * (sidePinCount - 1)
+
+  switch (side) {
+    case "left":
+      return { x: -halfW / 2, y: ibh / 2 - pos * p, o: "vert" }
+    case "bottom":
+      return { x: -ibw / 2 + pos * p, y: -halfH / 2, o: "horz" }
+    case "right":
+      return { x: halfW / 2, y: -ibh / 2 + pos * p, o: "vert" }
+    case "top":
+      return { x: ibw / 2 - pos * p, y: halfH / 2, o: "horz" }
+    default:
+      throw new Error("Invalid pin number")
+  }
+}
+
+export const quad = (raw_params: {
+  quad: true
+  num_pins: number
+  w: number
+  l: number
+  p?: number
+  id?: string | number
+  od?: string | number
+}): AnySoupElement[] => {
+  const params = quad_def.parse(raw_params)
+  const pads: AnySoupElement[] = []
+  for (let i = 0; i < params.num_pins; i++) {
+    const {
+      x,
+      y,
+      o: orientation,
+    } = getQuadCoords(
+      params.num_pins,
+      i + 1,
+      params.w,
+      params.h,
+      params.p ?? 0.5
+    )
+
+    let pw = params.pw,
+      pl = params.pl
+    if (orientation === "vert") {
+      ;[pw, pl] = [pl, pw]
+    }
+
+    pads.push(rectpad(i + 1, x, y, pw, pl))
+  }
+  return pads
+}

package/src/footprinter.ts

@@ -5,6 +5,7 @@ import { led } from "./fn/led"
 import { res } from "./fn/res"
 import { bga } from "./fn/bga"
 import { soic } from "./fn/soic"
+import { quad } from "./fn/quad"
 import type { AnySoupElement } from "@tscircuit/soup"
 import { isNotNull } from "./helpers/is-not-null"
 
@@ -81,6 +82,7 @@ export const footprinter = (): Footprinter & { string: typeof string } => {
           if ("res" in target) return () => res(target)
           if ("bga" in target) return () => bga(target)
           if ("soic" in target) return () => soic(target)
+          if ("quad" in target) return () => quad(target)
 
           return () => {
             // TODO improve error

package/tests/quad.test.ts

@@ -0,0 +1,37 @@
+import test from "ava"
+import { fp } from "../src/footprinter"
+import type { AnySoupElement } from "@tscircuit/soup"
+import { getTestFixture, toPinPositionString } from "./fixtures"
+
+test("quad16_w4_l4_p0.4_pw0.25_pl0.4", async (t) => {
+  const { fp, logSoup } = await getTestFixture(t)
+  const soup = fp.string("quad16_w4_l4_p0.4_pw0.25_pl0.4").soup()
+
+  await logSoup(soup)
+  t.pass()
+})
+
+//   const ps = toPinPositionString(soup)
+
+//   t.is(
+//     ps,
+//     `
+// 1 : -1.75 -2.00
+// 2 : -1.25 -2.00
+// 3 : -0.75 -2.00
+// 4 : -0.25 -2.00
+// 5 :  0.25 -2.00
+// 6 :  0.75 -2.00
+// 7 :  1.25 -2.00
+// 8 :  1.75 -2.00
+// 9 :  2.00 -1.75
+// 10:  2.00 -1.25
+// 11:  2.00 -0.75
+// 12:  2.00 -0.25
+// 13:  2.00  0.25
+// 14:  2.00  0.75
+// 15:  2.00  1.25
+// 16:  2.00  1.75
+//   `.trim()
+//   )
+// })