@tscircuit/parts-engine 0.0.9 → 0.0.10

package/lib/footprint-translators/get-footprinter-string-from-kicad.ts

@@ -0,0 +1,21 @@
+/**
+ * Transforms a KiCad footprint string into a generic "footprinter string".
+ * For now, this is a simplified conversion to a standard package name.
+ * e.g. "kicad:Resistor_SMD:R_0603_1608Metric" -> "0603"
+ */
+export const getFootprinterStringFromKicad = (
+  kicadFootprint: string,
+): string | undefined => {
+  // kicad:Resistor_SMD:R_0603_1608Metric -> 0603
+  let match = kicadFootprint.match(/:[RC]_(\d{4})_/)
+  if (match) return match[1]
+
+  // kicad:Package_SO:SOIC-8_3.9x4.9mm_P1.27mm -> SOIC-8
+  // kicad:Package_TO_SOT_SMD:SOT-23 -> SOT-23
+  match = kicadFootprint.match(
+    /:(SOIC-\d+|SOT-\d+|SOD-\d+|SSOP-\d+|TSSOP-\d+|QFP-\d+|QFN-\d+)/,
+  )
+  if (match) return match[1]
+
+  return undefined
+}

package/lib/footprint-translators/get-jlc-package-from-footprinter-string.ts

@@ -0,0 +1,12 @@
+/**
+ * Transforms a generic "footprinter string" into a JLC-compatible package name.
+ * e.g. "cap0603" -> "0603"
+ */
+export const getJlcPackageFromFootprinterString = (
+  footprinterString: string,
+): string => {
+  if (footprinterString.includes("cap")) {
+    return footprinterString.replace(/cap/g, "")
+  }
+  return footprinterString
+}

package/lib/footprint-translators/index.ts

@@ -0,0 +1,25 @@
+import { getFootprinterStringFromKicad } from "./get-footprinter-string-from-kicad"
+import { getJlcPackageFromFootprinterString } from "./get-jlc-package-from-footprinter-string"
+
+/**
+ * Get a JLC-compatible package name from a footprint string, which could be
+ * a KiCad footprint or a generic "footprinter string".
+ */
+export const getJlcpcbPackageName = (
+  footprint: string | undefined,
+): string | undefined => {
+  if (!footprint) return undefined
+
+  if (footprint.startsWith("kicad:")) {
+    const footprinterString = getFootprinterStringFromKicad(footprint)
+    if (footprinterString) {
+      return getJlcPackageFromFootprinterString(footprinterString)
+    }
+
+    // Fallback for un-matched KiCad strings
+    return footprint
+  }
+
+  // Not a KiCad string, assume it's a footprinter string
+  return getJlcPackageFromFootprinterString(footprint)
+}

package/lib/jlc-parts-engine.ts

@@ -1,4 +1,5 @@
 import type { PartsEngine, SupplierPartNumbers } from "@tscircuit/props"
+import { getJlcpcbPackageName } from "./footprint-translators/index"
 
 const cache = new Map<string, any>()
 
@@ -23,13 +24,15 @@ export const jlcPartsEngine: PartsEngine = {
     sourceComponent,
     footprinterString,
   }): Promise<SupplierPartNumbers> => {
+    const jlcpcbPackage = getJlcpcbPackageName(footprinterString)
+
     if (
       sourceComponent.type === "source_component" &&
       sourceComponent.ftype === "simple_resistor"
     ) {
       const { resistors } = await getJlcPartsCached("resistors", {
         resistance: sourceComponent.resistance,
-        package: footprinterString,
+        package: jlcpcbPackage,
       })
 
       return {
@@ -39,12 +42,9 @@ export const jlcPartsEngine: PartsEngine = {
       sourceComponent.type === "source_component" &&
       sourceComponent.ftype === "simple_capacitor"
     ) {
-      if (footprinterString?.includes("cap")) {
-        footprinterString = footprinterString.replace("cap", "")
-      }
       const { capacitors } = await getJlcPartsCached("capacitors", {
         capacitance: sourceComponent.capacitance,
-        package: footprinterString,
+        package: jlcpcbPackage,
       })
 
       return {
@@ -80,7 +80,7 @@ export const jlcPartsEngine: PartsEngine = {
     ) {
       const { potentiometers } = await getJlcPartsCached("potentiometers", {
         resistance: sourceComponent.max_resistance,
-        package: footprinterString,
+        package: jlcpcbPackage,
       })
       return {
         jlcpcb: (potentiometers ?? [])
@@ -92,7 +92,7 @@ export const jlcPartsEngine: PartsEngine = {
       sourceComponent.ftype === "simple_diode"
     ) {
       const { diodes } = await getJlcPartsCached("diodes", {
-        package: footprinterString,
+        package: jlcpcbPackage,
       })
       return {
         jlcpcb: (diodes ?? []).map((d: any) => `C${d.lcsc}`).slice(0, 3),
@@ -102,7 +102,7 @@ export const jlcPartsEngine: PartsEngine = {
       sourceComponent.ftype === "simple_chip"
     ) {
       const { chips } = await getJlcPartsCached("chips", {
-        package: footprinterString,
+        package: jlcpcbPackage,
       })
       return {
         jlcpcb: (chips ?? []).map((c: any) => `C${c.lcsc}`).slice(0, 3),
@@ -112,7 +112,7 @@ export const jlcPartsEngine: PartsEngine = {
       sourceComponent.ftype === "simple_transistor"
     ) {
       const { transistors } = await getJlcPartsCached("transistors", {
-        package: footprinterString,
+        package: jlcpcbPackage,
         transistor_type: sourceComponent.transistor_type,
       })
       return {
@@ -124,7 +124,7 @@ export const jlcPartsEngine: PartsEngine = {
     ) {
       const { power_sources } = await getJlcPartsCached("power_sources", {
         voltage: sourceComponent.voltage,
-        package: footprinterString,
+        package: jlcpcbPackage,
       })
       return {
         jlcpcb: (power_sources ?? []).map((p: any) => `C${p.lcsc}`).slice(0, 3),
@@ -135,7 +135,7 @@ export const jlcPartsEngine: PartsEngine = {
     ) {
       const { inductors } = await getJlcPartsCached("inductors", {
         inductance: sourceComponent.inductance,
-        package: footprinterString,
+        package: jlcpcbPackage,
       })
       return {
         jlcpcb: (inductors ?? []).map((i: any) => `C${i.lcsc}`).slice(0, 3),
@@ -147,7 +147,7 @@ export const jlcPartsEngine: PartsEngine = {
       const { crystals } = await getJlcPartsCached("crystals", {
         frequency: sourceComponent.frequency,
         load_capacitance: sourceComponent.load_capacitance,
-        package: footprinterString,
+        package: jlcpcbPackage,
       })
       return {
         jlcpcb: (crystals ?? []).map((c: any) => `C${c.lcsc}`).slice(0, 3),
@@ -157,7 +157,7 @@ export const jlcPartsEngine: PartsEngine = {
       sourceComponent.ftype === "simple_mosfet"
     ) {
       const { mosfets } = await getJlcPartsCached("mosfets", {
-        package: footprinterString,
+        package: jlcpcbPackage,
         mosfet_mode: sourceComponent.mosfet_mode,
         channel_type: sourceComponent.channel_type,
       })
@@ -170,7 +170,7 @@ export const jlcPartsEngine: PartsEngine = {
     ) {
       const { resonators } = await getJlcPartsCached("resonators", {
         frequency: sourceComponent.frequency,
-        package: footprinterString,
+        package: jlcpcbPackage,
       })
       return {
         jlcpcb: (resonators ?? []).map((r: any) => `C${r.lcsc}`).slice(0, 3),
@@ -181,7 +181,7 @@ export const jlcPartsEngine: PartsEngine = {
     ) {
       const { switches } = await getJlcPartsCached("switches", {
         switch_type: sourceComponent.type,
-        package: footprinterString,
+        package: jlcpcbPackage,
       })
       return {
         jlcpcb: (switches ?? []).map((s: any) => `C${s.lcsc}`).slice(0, 3),
@@ -191,7 +191,7 @@ export const jlcPartsEngine: PartsEngine = {
       sourceComponent.ftype === "simple_led"
     ) {
       const { leds } = await getJlcPartsCached("leds", {
-        package: footprinterString,
+        package: jlcpcbPackage,
       })
       return {
         jlcpcb: (leds ?? []).map((l: any) => `C${l.lcsc}`).slice(0, 3),
@@ -201,7 +201,7 @@ export const jlcPartsEngine: PartsEngine = {
       sourceComponent.ftype === "simple_fuse"
     ) {
       const { fuses } = await getJlcPartsCached("fuses", {
-        package: footprinterString,
+        package: jlcpcbPackage,
       })
       return {
         jlcpcb: (fuses ?? []).map((l: any) => `C${l.lcsc}`).slice(0, 3),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tscircuit/parts-engine",
-  "version": "0.0.9",
+  "version": "0.0.10",
   "type": "module",
   "main": "./dist/index.js",
   "devDependencies": {

package/tests/jlc-parts-engine.test.ts

@@ -127,6 +127,25 @@ describe("jlcPartsEngine", () => {
     })
   })
 
+  test("should find resistor parts with kicad footprint", async () => {
+    const resistor: AnySourceComponent = {
+      type: "source_component",
+      ftype: "simple_resistor",
+      resistance: 10000,
+      source_component_id: "source_component_0",
+      name: "R1",
+    }
+
+    const result = await jlcPartsEngine.findPart({
+      sourceComponent: resistor,
+      footprinterString: "kicad:Resistor_SMD:R_0603_1608Metric",
+    })
+
+    expect(result).toEqual({
+      jlcpcb: ["C1234", "C5678", "C9012"],
+    })
+  })
+
   test("should find capacitor parts", async () => {
     const capacitor: AnySourceComponent = {
       type: "source_component",
@@ -138,7 +157,7 @@ describe("jlcPartsEngine", () => {
 
     const result = await jlcPartsEngine.findPart({
       sourceComponent: capacitor,
-      footprinterString: "0603cap",
+      footprinterString: "cap0603",
     })
 
     expect(result).toEqual({
@@ -222,6 +241,24 @@ describe("jlcPartsEngine", () => {
     })
   })
 
+  test("should find chip parts with kicad footprint", async () => {
+    const chip: AnySourceComponent = {
+      type: "source_component",
+      ftype: "simple_chip",
+      source_component_id: "source_component_0",
+      name: "U1",
+    }
+
+    const result = await jlcPartsEngine.findPart({
+      sourceComponent: chip,
+      footprinterString: "kicad:Package_SO:SOIC-8_3.9x4.9mm_P1.27mm",
+    })
+
+    expect(result).toEqual({
+      jlcpcb: ["C5678", "C9012", "C3456"],
+    })
+  })
+
   test("should find transistor parts", async () => {
     const transistor: AnySourceComponent = {
       type: "source_component",