circuit-json-to-kicad 0.0.36 → 0.0.38

package/dist/index.d.ts

@@ -2,6 +2,7 @@ import { CircuitJson } from 'circuit-json';
 import { CircuitJsonUtilObjects, cju } from '@tscircuit/circuit-json-util';
 import { KicadSch, KicadPcb, SchematicSymbol } from 'kicadts';
 import { Matrix } from 'transformation-matrix';
+import { KicadFootprintMetadata } from '@tscircuit/props';
 
 type PaperSize = "A0" | "A1" | "A2" | "A3" | "A4" | "A5";
 interface PaperDimensions {
@@ -248,6 +249,12 @@ interface KicadLibraryConverterOptions {
      * Default: true
      */
     includeBuiltins?: boolean;
+    /**
+     * Callback to get KiCad footprint metadata from a component via prop introspection.
+     * This allows extracting kicadFootprintMetadata props without rendering the component.
+     * Return null if no metadata is available.
+     */
+    getComponentKicadMetadata?: (filePath: string, componentName: string) => Promise<KicadFootprintMetadata | null>;
 }
 interface KicadLibraryConverterOutput {
     /**

package/dist/index.js

@@ -2705,6 +2705,7 @@ var ExtractFootprintsStage = class extends ConverterStage {
         value: "Ref**",
         position: [0, 0, 0],
         layer: "F.SilkS",
+        uuid: generateDeterministicUuid(`${footprintName}-property-Reference`),
         effects: defaultEffects
       }),
       new Property({
@@ -2712,6 +2713,7 @@ var ExtractFootprintsStage = class extends ConverterStage {
         value: "Val**",
         position: [0, 0, 0],
         layer: "F.Fab",
+        uuid: generateDeterministicUuid(`${footprintName}-property-Value`),
         effects: defaultEffects
       }),
       new Property({
@@ -2720,6 +2722,7 @@ var ExtractFootprintsStage = class extends ConverterStage {
         position: [0, 0, 0],
         layer: "F.Fab",
         hidden: true,
+        uuid: generateDeterministicUuid(`${footprintName}-property-Datasheet`),
         effects: defaultEffects
       }),
       new Property({
@@ -2728,6 +2731,9 @@ var ExtractFootprintsStage = class extends ConverterStage {
         position: [0, 0, 0],
         layer: "F.Fab",
         hidden: true,
+        uuid: generateDeterministicUuid(
+          `${footprintName}-property-Description`
+        ),
         effects: defaultEffects
       })
     ];
@@ -2742,9 +2748,14 @@ var ExtractFootprintsStage = class extends ConverterStage {
     }
     footprint.fpTexts = texts;
     const pads = footprint.fpPads ?? [];
-    for (const pad of pads) {
-      pad.uuid = void 0;
-      pad.net = void 0;
+    for (let i = 0; i < pads.length; i++) {
+      const pad = pads[i];
+      if (pad) {
+        pad.uuid = generateDeterministicUuid(
+          `${footprintName}-pad-${pad.number ?? i}`
+        );
+        pad.net = void 0;
+      }
     }
     footprint.fpPads = pads;
     const models = footprint.models ?? [];
@@ -2945,6 +2956,126 @@ function renameKicadFootprint(params) {
   };
 }
 
+// lib/kicad-library/kicad-library-converter-utils/applyKicadFootprintMetadata.ts
+import {
+  parseKicadSexpr as parseKicadSexpr3,
+  Footprint as Footprint3,
+  Property as Property2,
+  TextEffects as TextEffects7,
+  TextEffectsFont as TextEffectsFont7
+} from "kicadts";
+function applyKicadFootprintMetadata(kicadModString, metadata, footprintName) {
+  try {
+    const parsed = parseKicadSexpr3(kicadModString);
+    const footprint = parsed.find(
+      (node) => node instanceof Footprint3
+    );
+    if (!footprint) {
+      return kicadModString;
+    }
+    if (metadata.version !== void 0) {
+      footprint.version = Number(metadata.version);
+    }
+    if (metadata.generator !== void 0) {
+      footprint.generator = metadata.generator;
+    }
+    if (metadata.generatorVersion !== void 0) {
+      footprint.generatorVersion = String(metadata.generatorVersion);
+    }
+    if (metadata.embeddedFonts !== void 0) {
+    }
+    if (metadata.properties) {
+      const defaultFont = new TextEffectsFont7();
+      defaultFont.size = { width: 1.27, height: 1.27 };
+      defaultFont.thickness = 0.15;
+      const defaultEffects = new TextEffects7({ font: defaultFont });
+      const newProperties = [];
+      const refMeta = metadata.properties.Reference;
+      newProperties.push(
+        new Property2({
+          key: "Reference",
+          value: refMeta?.value ?? "REF**",
+          position: refMeta?.at ? [
+            Number(refMeta.at.x),
+            Number(refMeta.at.y),
+            Number(refMeta.at.rotation ?? 0)
+          ] : [0, 0, 0],
+          layer: refMeta?.layer ?? "F.SilkS",
+          uuid: refMeta?.uuid ?? generateDeterministicUuid(`${footprintName}-property-Reference`),
+          effects: defaultEffects,
+          hidden: refMeta?.hide
+        })
+      );
+      const valMeta = metadata.properties.Value;
+      newProperties.push(
+        new Property2({
+          key: "Value",
+          value: valMeta?.value ?? footprintName,
+          position: valMeta?.at ? [
+            Number(valMeta.at.x),
+            Number(valMeta.at.y),
+            Number(valMeta.at.rotation ?? 0)
+          ] : [0, 0, 0],
+          layer: valMeta?.layer ?? "F.Fab",
+          uuid: valMeta?.uuid ?? generateDeterministicUuid(`${footprintName}-property-Value`),
+          effects: defaultEffects,
+          hidden: valMeta?.hide
+        })
+      );
+      const dsMeta = metadata.properties.Datasheet;
+      newProperties.push(
+        new Property2({
+          key: "Datasheet",
+          value: dsMeta?.value ?? "",
+          position: dsMeta?.at ? [
+            Number(dsMeta.at.x),
+            Number(dsMeta.at.y),
+            Number(dsMeta.at.rotation ?? 0)
+          ] : [0, 0, 0],
+          layer: dsMeta?.layer ?? "F.Fab",
+          uuid: dsMeta?.uuid ?? generateDeterministicUuid(`${footprintName}-property-Datasheet`),
+          effects: defaultEffects,
+          hidden: dsMeta?.hide ?? true
+        })
+      );
+      const descMeta = metadata.properties.Description;
+      newProperties.push(
+        new Property2({
+          key: "Description",
+          value: descMeta?.value ?? "",
+          position: descMeta?.at ? [
+            Number(descMeta.at.x),
+            Number(descMeta.at.y),
+            Number(descMeta.at.rotation ?? 0)
+          ] : [0, 0, 0],
+          layer: descMeta?.layer ?? "F.Fab",
+          uuid: descMeta?.uuid ?? generateDeterministicUuid(`${footprintName}-property-Description`),
+          effects: defaultEffects,
+          hidden: descMeta?.hide ?? true
+        })
+      );
+      footprint.properties = newProperties;
+    }
+    if (metadata.attributes && footprint.attr) {
+      if (metadata.attributes.through_hole) {
+        footprint.attr.type = "through_hole";
+      } else if (metadata.attributes.smd) {
+        footprint.attr.type = "smd";
+      }
+      if (metadata.attributes.exclude_from_pos_files !== void 0) {
+        footprint.attr.excludeFromPosFiles = metadata.attributes.exclude_from_pos_files;
+      }
+      if (metadata.attributes.exclude_from_bom !== void 0) {
+        footprint.attr.excludeFromBom = metadata.attributes.exclude_from_bom;
+      }
+    }
+    return footprint.getString();
+  } catch (error) {
+    console.warn(`Failed to apply kicadFootprintMetadata:`, error);
+    return kicadModString;
+  }
+}
+
 // lib/kicad-library/stages/ClassifyKicadFootprintsStage.ts
 function classifyKicadFootprints(ctx) {
   for (const extractedKicadComponent of ctx.extractedKicadComponents) {
@@ -2960,17 +3091,28 @@ function classifyFootprintsForComponent({
 }) {
   const { tscircuitComponentName, kicadFootprints } = extractedKicadComponent;
   let hasAddedUserFootprint = false;
+  const metadata = ctx.footprintMetadataMap.get(tscircuitComponentName);
   for (const kicadFootprint of kicadFootprints) {
     if (kicadFootprint.isBuiltin) {
       addBuiltinFootprint({ ctx, kicadFootprint });
     } else {
       if (!hasAddedUserFootprint) {
         hasAddedUserFootprint = true;
-        const renamedFootprint = renameKicadFootprint({
+        let renamedFootprint = renameKicadFootprint({
           kicadFootprint,
           newKicadFootprintName: tscircuitComponentName,
           kicadLibraryName: ctx.kicadLibraryName
         });
+        if (metadata) {
+          renamedFootprint = {
+            ...renamedFootprint,
+            kicadModString: applyKicadFootprintMetadata(
+              renamedFootprint.kicadModString,
+              metadata,
+              tscircuitComponentName
+            )
+          };
+        }
         addUserFootprint({ ctx, kicadFootprint: renamedFootprint });
       } else {
         addUserFootprint({ ctx, kicadFootprint });
@@ -3218,7 +3360,8 @@ var KicadLibraryConverter = class {
     this.options = options;
     this.ctx = createKicadLibraryConverterContext({
       kicadLibraryName: options.kicadLibraryName ?? "tscircuit_library",
-      includeBuiltins: options.includeBuiltins ?? true
+      includeBuiltins: options.includeBuiltins ?? true,
+      getComponentKicadMetadata: options.getComponentKicadMetadata
     });
   }
   async run() {
@@ -3251,6 +3394,15 @@ var KicadLibraryConverter = class {
         );
         if (resolved) componentPath = resolved;
       }
+      if (this.ctx.getComponentKicadMetadata) {
+        const metadata = await this.ctx.getComponentKicadMetadata(
+          componentPath,
+          exportName
+        );
+        if (metadata) {
+          this.ctx.footprintMetadataMap.set(exportName, metadata);
+        }
+      }
       const circuitJson = await this.options.buildFileToCircuitJson(
         componentPath,
         exportName
@@ -3272,6 +3424,15 @@ var KicadLibraryConverter = class {
         if (resolved) componentPath = resolved;
       }
       const componentName = deriveComponentNameFromPath(componentPath);
+      if (this.ctx.getComponentKicadMetadata) {
+        const metadata = await this.ctx.getComponentKicadMetadata(
+          componentPath,
+          "default"
+        );
+        if (metadata) {
+          this.ctx.footprintMetadataMap.set(componentName, metadata);
+        }
+      }
       const circuitJson = await this.options.buildFileToCircuitJson(
         componentPath,
         "default"
@@ -3325,6 +3486,8 @@ function createKicadLibraryConverterContext(params) {
   return {
     kicadLibraryName: params.kicadLibraryName,
     includeBuiltins: params.includeBuiltins,
+    getComponentKicadMetadata: params.getComponentKicadMetadata,
+    footprintMetadataMap: /* @__PURE__ */ new Map(),
     builtTscircuitComponents: [],
     extractedKicadComponents: [],
     userKicadFootprints: [],

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "circuit-json-to-kicad",
   "main": "dist/index.js",
-  "version": "0.0.36",
+  "version": "0.0.38",
   "type": "module",
   "files": [
     "dist"
@@ -21,11 +21,11 @@
     "@types/bun": "latest",
     "circuit-json": "^0.0.302",
     "circuit-to-svg": "^0.0.208",
-    "kicadts": "^0.0.23",
+    "kicadts": "^0.0.24",
     "schematic-symbols": "^0.0.202",
     "sharp": "^0.34.4",
     "transformation-matrix": "^3.1.0",
-    "tscircuit": "^0.0.866",
+    "tscircuit": "^0.0.1186",
     "tsup": "^8.5.0"
   },
   "peerDependencies": {