@jlcpcb/core 0.1.0 → 0.1.1

package/CHANGELOG.md

@@ -1,5 +1,15 @@
 # @jlcpcb/core
 
+## 0.1.1
+
+### Patch Changes
+
+- **@jlcpcb/core:**
+  - Fix: Restrict built-in footprints to 2-pad passives only — prevents pin-flip issues on multi-pin components
+
+  **@jlcpcb/cli & @jlcpcb/mcp:**
+  - Updated dependencies
+
 ## 0.1.0
 
 ### Minor Changes

package/dist/api/easyeda-community.d.ts

@@ -0,0 +1,36 @@
+/**
+ * EasyEDA Community Library API client
+ * For searching and fetching user-contributed components
+ *
+ * Uses shared parsers from common/parsers for all shape types.
+ */
+import type { EasyEDACommunitySearchParams, EasyEDACommunitySearchResult, EasyEDACommunityComponent } from '../types/index.js';
+export declare class EasyEDACommunityClient {
+    /**
+     * Search the EasyEDA community library
+     */
+    search(params: EasyEDACommunitySearchParams): Promise<EasyEDACommunitySearchResult[]>;
+    /**
+     * Get full component details by UUID
+     */
+    getComponent(uuid: string): Promise<EasyEDACommunityComponent | null>;
+    /**
+     * Download 3D model for a component
+     */
+    get3DModel(uuid: string, format?: 'step' | 'obj'): Promise<Buffer | null>;
+    /**
+     * Parse search results from the API response
+     */
+    private parseSearchResults;
+    /**
+     * Parse a single search result item
+     */
+    private parseSearchItem;
+    /**
+     * Parse full component data from the API response
+     * Uses shared parsers for consistent shape parsing with LCSC client.
+     */
+    private parseComponent;
+}
+export declare const easyedaCommunityClient: EasyEDACommunityClient;
+//# sourceMappingURL=easyeda-community.d.ts.map

package/dist/api/easyeda-community.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"easyeda-community.d.ts","sourceRoot":"","sources":["../../src/api/easyeda-community.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EACV,4BAA4B,EAC5B,4BAA4B,EAC5B,yBAAyB,EAC1B,MAAM,mBAAmB,CAAA;AAkB1B,qBAAa,sBAAsB;IACjC;;OAEG;IACG,MAAM,CACV,MAAM,EAAE,4BAA4B,GACnC,OAAO,CAAC,4BAA4B,EAAE,CAAC;IAgC1C;;OAEG;IACG,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,yBAAyB,GAAG,IAAI,CAAC;IAoB3E;;OAEG;IACG,UAAU,CACd,IAAI,EAAE,MAAM,EACZ,MAAM,GAAE,MAAM,GAAG,KAAc,GAC9B,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAczB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAyB1B;;OAEG;IACH,OAAO,CAAC,eAAe;IA+BvB;;;OAGG;IACH,OAAO,CAAC,cAAc;CAgFvB;AAED,eAAO,MAAM,sBAAsB,wBAA+B,CAAA"}

package/dist/api/easyeda.d.ts

@@ -0,0 +1,23 @@
+/**
+ * EasyEDA API client for component library fetching
+ *
+ * Uses shared parsers from common/parsers for all shape types.
+ */
+import type { EasyEDAComponentData } from '../types/index.js';
+export declare class EasyEDAClient {
+    private userAgent;
+    /**
+     * Fetch component data from EasyEDA API
+     */
+    getComponentData(lcscPartNumber: string): Promise<EasyEDAComponentData | null>;
+    /**
+     * Download 3D model for a component
+     */
+    get3DModel(uuid: string, format?: 'step' | 'obj'): Promise<Buffer | null>;
+    /**
+     * Parse raw EasyEDA API response into structured data
+     */
+    private parseComponentData;
+}
+export declare const easyedaClient: EasyEDAClient;
+//# sourceMappingURL=easyeda.d.ts.map

package/dist/api/easyeda.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"easyeda.d.ts","sourceRoot":"","sources":["../../src/api/easyeda.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAc9D,qBAAa,aAAa;IACxB,OAAO,CAAC,SAAS,CAA2B;IAE5C;;OAEG;IACG,gBAAgB,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,GAAG,IAAI,CAAC;IAoBpF;;OAEG;IACG,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,GAAE,MAAM,GAAG,KAAc,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAavF;;OAEG;IACH,OAAO,CAAC,kBAAkB;CAqF3B;AAED,eAAO,MAAM,aAAa,eAAsB,CAAC"}

package/dist/api/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * API clients for JLC and EasyEDA
+ */
+export { JLCClient, jlcClient } from './jlc.js';
+export { EasyEDAClient, easyedaClient } from './easyeda.js';
+export { EasyEDACommunityClient, easyedaCommunityClient } from './easyeda-community.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/api/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/api/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAChD,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC5D,OAAO,EAAE,sBAAsB,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/api/jlc.d.ts

@@ -0,0 +1,41 @@
+/**
+ * JLC API client for component search and details
+ * Uses JLCPCB's parts library API which provides LCSC component data
+ */
+import type { LCSCSearchOptions, ComponentSearchResult } from '../types/index.js';
+export interface LCSCProduct {
+    productCode: string;
+    productModel: string;
+    brandNameEn: string;
+    encapStandard: string;
+    productPriceList: Array<{
+        ladder: number;
+        productPrice: number;
+        currencySymbol: string;
+    }>;
+    stockNumber: number;
+    productIntroEn: string;
+}
+export declare class JLCClient {
+    /**
+     * Search for components via JLCPCB API
+     */
+    search(query: string, options?: LCSCSearchOptions): Promise<ComponentSearchResult[]>;
+    /**
+     * Get stock and pricing information for a component
+     */
+    getStock(lcscPartNumber: string): Promise<{
+        stock: number;
+        priceBreaks: Array<{
+            quantity: number;
+            price: number;
+        }>;
+    }>;
+    /**
+     * Get detailed component information including attributes
+     * Used to enrich EasyEDA data with JLC-specific attributes
+     */
+    getComponentDetails(lcscPartNumber: string): Promise<ComponentSearchResult | null>;
+}
+export declare const jlcClient: JLCClient;
+//# sourceMappingURL=jlc.d.ts.map

package/dist/api/jlc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jlc.d.ts","sourceRoot":"","sources":["../../src/api/jlc.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AA6ClF,MAAM,WAAW,WAAW;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,gBAAgB,EAAE,KAAK,CAAC;QACtB,MAAM,EAAE,MAAM,CAAC;QACf,YAAY,EAAE,MAAM,CAAC;QACrB,cAAc,EAAE,MAAM,CAAC;KACxB,CAAC,CAAC;IACH,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,qBAAa,SAAS;IACpB;;OAEG;IACG,MAAM,CACV,KAAK,EAAE,MAAM,EACb,OAAO,GAAE,iBAAsB,GAC9B,OAAO,CAAC,qBAAqB,EAAE,CAAC;IA+EnC;;OAEG;IACG,QAAQ,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC;QAC9C,KAAK,EAAE,MAAM,CAAC;QACd,WAAW,EAAE,KAAK,CAAC;YAAE,QAAQ,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;KACzD,CAAC;IAeF;;;OAGG;IACG,mBAAmB,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,qBAAqB,GAAG,IAAI,CAAC;CAOzF;AAED,eAAO,MAAM,SAAS,WAAkB,CAAC"}

package/dist/constants/design-rules.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Default design rules for common PCB manufacturers
+ */
+export interface DesignRules {
+    name: string;
+    minTraceWidth: number;
+    minTraceClearance: number;
+    minViaDrill: number;
+    minViaPad: number;
+    minHoleDrill: number;
+    minAnnularRing: number;
+    minSilkscreenWidth: number;
+    minSilkscreenClearance: number;
+}
+export declare const JLCPCB_STANDARD: DesignRules;
+export declare const JLCPCB_ADVANCED: DesignRules;
+export declare const PCBWAY_STANDARD: DesignRules;
+export declare const OSHPARK_STANDARD: DesignRules;
+export declare const HOBBY_RULES: DesignRules;
+export declare const TRACE_WIDTH_CURRENT: Record<string, number>;
+export declare const LAYER_STACKUPS: {
+    readonly '2-layer': {
+        readonly layers: readonly ["F.Cu", "B.Cu"];
+        readonly copperThickness: 0.035;
+        readonly boardThickness: 1.6;
+    };
+    readonly '4-layer': {
+        readonly layers: readonly ["F.Cu", "In1.Cu", "In2.Cu", "B.Cu"];
+        readonly copperThickness: 0.035;
+        readonly boardThickness: 1.6;
+    };
+};
+export declare function getDesignRulesForManufacturer(manufacturer: string): DesignRules;
+//# sourceMappingURL=design-rules.d.ts.map

package/dist/constants/design-rules.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"design-rules.d.ts","sourceRoot":"","sources":["../../src/constants/design-rules.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,EAAE,MAAM,CAAC;IACtB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,sBAAsB,EAAE,MAAM,CAAC;CAChC;AAGD,eAAO,MAAM,eAAe,EAAE,WAU7B,CAAC;AAGF,eAAO,MAAM,eAAe,EAAE,WAU7B,CAAC;AAGF,eAAO,MAAM,eAAe,EAAE,WAU7B,CAAC;AAGF,eAAO,MAAM,gBAAgB,EAAE,WAU9B,CAAC;AAGF,eAAO,MAAM,WAAW,EAAE,WAUzB,CAAC;AAGF,eAAO,MAAM,mBAAmB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAOtD,CAAC;AAGF,eAAO,MAAM,cAAc;;;;;;;;;;;CAWjB,CAAC;AAEX,wBAAgB,6BAA6B,CAAC,YAAY,EAAE,MAAM,GAAG,WAAW,CAa/E"}

package/dist/constants/footprints.d.ts

@@ -0,0 +1,134 @@
+/**
+ * Standard footprint patterns and dimensions
+ */
+export declare const SMD_PACKAGE_SIZES: Record<string, {
+    length: number;
+    width: number;
+}>;
+export declare const IC_PACKAGE_PATTERNS: {
+    readonly SOIC8: {
+        readonly pins: 8;
+        readonly pitch: 1.27;
+        readonly width: 3.9;
+    };
+    readonly SOIC14: {
+        readonly pins: 14;
+        readonly pitch: 1.27;
+        readonly width: 3.9;
+    };
+    readonly SOIC16: {
+        readonly pins: 16;
+        readonly pitch: 1.27;
+        readonly width: 3.9;
+    };
+    readonly TSSOP8: {
+        readonly pins: 8;
+        readonly pitch: 0.65;
+        readonly width: 3;
+    };
+    readonly TSSOP14: {
+        readonly pins: 14;
+        readonly pitch: 0.65;
+        readonly width: 4.4;
+    };
+    readonly TSSOP16: {
+        readonly pins: 16;
+        readonly pitch: 0.65;
+        readonly width: 4.4;
+    };
+    readonly TSSOP20: {
+        readonly pins: 20;
+        readonly pitch: 0.65;
+        readonly width: 4.4;
+    };
+    readonly LQFP32: {
+        readonly pins: 32;
+        readonly pitch: 0.8;
+        readonly size: 7;
+    };
+    readonly LQFP48: {
+        readonly pins: 48;
+        readonly pitch: 0.5;
+        readonly size: 7;
+    };
+    readonly LQFP64: {
+        readonly pins: 64;
+        readonly pitch: 0.5;
+        readonly size: 10;
+    };
+    readonly LQFP100: {
+        readonly pins: 100;
+        readonly pitch: 0.5;
+        readonly size: 14;
+    };
+    readonly LQFP144: {
+        readonly pins: 144;
+        readonly pitch: 0.5;
+        readonly size: 20;
+    };
+    readonly QFN16: {
+        readonly pins: 16;
+        readonly pitch: 0.5;
+        readonly size: 3;
+    };
+    readonly QFN20: {
+        readonly pins: 20;
+        readonly pitch: 0.5;
+        readonly size: 4;
+    };
+    readonly QFN24: {
+        readonly pins: 24;
+        readonly pitch: 0.5;
+        readonly size: 4;
+    };
+    readonly QFN32: {
+        readonly pins: 32;
+        readonly pitch: 0.5;
+        readonly size: 5;
+    };
+    readonly QFN48: {
+        readonly pins: 48;
+        readonly pitch: 0.5;
+        readonly size: 7;
+    };
+    readonly BGA100: {
+        readonly pins: 100;
+        readonly pitch: 0.8;
+    };
+    readonly BGA144: {
+        readonly pins: 144;
+        readonly pitch: 0.8;
+    };
+    readonly BGA256: {
+        readonly pins: 256;
+        readonly pitch: 0.8;
+    };
+};
+export declare const CONNECTOR_PITCHES: {
+    readonly STANDARD_2_54MM: 2.54;
+    readonly STANDARD_2MM: 2;
+    readonly FINE_1_27MM: 1.27;
+    readonly FINE_1MM: 1;
+    readonly USB_C: 0.5;
+    readonly FPC_0_5MM: 0.5;
+    readonly FPC_1MM: 1;
+};
+export declare const MOUNTING_HOLES: {
+    readonly M2: {
+        readonly drill: 2.2;
+        readonly pad: 4;
+    };
+    readonly M2_5: {
+        readonly drill: 2.7;
+        readonly pad: 5;
+    };
+    readonly M3: {
+        readonly drill: 3.2;
+        readonly pad: 6;
+    };
+    readonly M4: {
+        readonly drill: 4.3;
+        readonly pad: 8;
+    };
+};
+//# sourceMappingURL=footprints.d.ts.map

package/dist/constants/footprints.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"footprints.d.ts","sourceRoot":"","sources":["../../src/constants/footprints.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAU/E,CAAC;AAGF,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA8BtB,CAAC;AAGX,eAAO,MAAM,iBAAiB;;;;;;;;CAQpB,CAAC;AAGX,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;CAKjB,CAAC"}

package/dist/constants/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * ai-eda-common constants
+ */
+export * from './kicad.js';
+export * from './footprints.js';
+export * from './design-rules.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/constants/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/constants/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC"}

package/dist/constants/kicad.d.ts

@@ -0,0 +1,67 @@
+/**
+ * KiCad layer names and constants
+ */
+export declare const KICAD_LAYERS: {
+    readonly F_CU: "F.Cu";
+    readonly B_CU: "B.Cu";
+    readonly IN1_CU: "In1.Cu";
+    readonly IN2_CU: "In2.Cu";
+    readonly IN3_CU: "In3.Cu";
+    readonly IN4_CU: "In4.Cu";
+    readonly F_ADHES: "F.Adhes";
+    readonly F_PASTE: "F.Paste";
+    readonly F_SILKS: "F.SilkS";
+    readonly F_MASK: "F.Mask";
+    readonly F_CRTYD: "F.CrtYd";
+    readonly F_FAB: "F.Fab";
+    readonly B_ADHES: "B.Adhes";
+    readonly B_PASTE: "B.Paste";
+    readonly B_SILKS: "B.SilkS";
+    readonly B_MASK: "B.Mask";
+    readonly B_CRTYD: "B.CrtYd";
+    readonly B_FAB: "B.Fab";
+    readonly EDGE_CUTS: "Edge.Cuts";
+    readonly MARGIN: "Margin";
+    readonly DWGS_USER: "Dwgs.User";
+    readonly CMTS_USER: "Cmts.User";
+    readonly ECO1_USER: "Eco1.User";
+    readonly ECO2_USER: "Eco2.User";
+};
+export declare const KICAD_LAYER_GROUPS: {
+    readonly ALL_CU: readonly ["*.Cu"];
+    readonly ALL_MASK: readonly ["*.Mask"];
+    readonly FRONT_LAYERS: readonly ["F.Cu", "F.Paste", "F.Mask"];
+    readonly BACK_LAYERS: readonly ["B.Cu", "B.Paste", "B.Mask"];
+    readonly SMD_FRONT: readonly ["F.Cu", "F.Paste", "F.Mask"];
+    readonly SMD_BACK: readonly ["B.Cu", "B.Paste", "B.Mask"];
+    readonly THT: readonly ["*.Cu", "*.Mask"];
+};
+export declare const KICAD_DEFAULTS: {
+    readonly TEXT_SIZE: 1.27;
+    readonly TEXT_THICKNESS: 0.15;
+    readonly WIRE_WIDTH: 0.25;
+    readonly GRID_SCHEMATIC: 2.54;
+    readonly GRID_PCB: 0.25;
+    readonly PIN_LENGTH: 1.27;
+    readonly PIN_NAME_OFFSET: 0;
+};
+export declare const KICAD_SYMBOL_VERSION = "20241209";
+export declare const KICAD_FOOTPRINT_VERSION = "20241209";
+export declare const KICAD_PIN_TYPES: readonly ["input", "output", "bidirectional", "tri_state", "passive", "free", "unspecified", "power_in", "power_out", "open_collector", "open_emitter", "no_connect"];
+export declare const KICAD_PAD_SHAPES: readonly ["circle", "rect", "oval", "trapezoid", "roundrect", "custom"];
+export declare const KICAD_PAD_TYPES: readonly ["thru_hole", "smd", "connect", "np_thru_hole"];
+export declare const KICAD_LIBRARY_NAME = "EDA-MCP";
+export declare const KICAD_LIBRARY_DESCRIPTION = "AI-EDA Component Library (JLC/EasyEDA)";
+export declare const KICAD_VERSIONS: readonly ["9.0", "8.0"];
+/**
+ * Get global KiCad library paths for a specific platform
+ * Returns paths in the format that kicad-sch-mcp's search pattern expects:
+ * ~/Documents/KiCad/{version}/symbols/*.kicad_sym
+ */
+export declare function getGlobalKicadLibraryPaths(homeDir: string, platform: 'darwin' | 'win32' | 'linux', version?: string): {
+    base: string;
+    symbols: string;
+    footprints: string;
+    models3d: string;
+} | null;
+//# sourceMappingURL=kicad.d.ts.map

package/dist/constants/kicad.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"kicad.d.ts","sourceRoot":"","sources":["../../src/constants/kicad.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;CAgCf,CAAC;AAGX,eAAO,MAAM,kBAAkB;;;;;;;;CAQrB,CAAC;AAGX,eAAO,MAAM,cAAc;;;;;;;;CAQjB,CAAC;AAGX,eAAO,MAAM,oBAAoB,aAAa,CAAC;AAC/C,eAAO,MAAM,uBAAuB,aAAa,CAAC;AAGlD,eAAO,MAAM,eAAe,uKAalB,CAAC;AAGX,eAAO,MAAM,gBAAgB,yEAOnB,CAAC;AAGX,eAAO,MAAM,eAAe,0DAKlB,CAAC;AAGX,eAAO,MAAM,kBAAkB,YAAY,CAAC;AAC5C,eAAO,MAAM,yBAAyB,2CAA2C,CAAC;AAGlF,eAAO,MAAM,cAAc,yBAA0B,CAAC;AAEtD;;;;GAIG;AACH,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,QAAQ,GAAG,OAAO,GAAG,OAAO,EACtC,OAAO,GAAE,MAAc,GACtB;IACD,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;CAClB,GAAG,IAAI,CA0BP"}

package/dist/converter/category-router.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Category Router
+ * Routes components to category-based symbol libraries with robust keyword matching
+ * JLC-MCP-Resistors.kicad_sym, JLC-MCP-MCUs.kicad_sym, etc.
+ */
+export type LibraryCategory = 'Resistors' | 'Capacitors' | 'Inductors' | 'Diodes' | 'Transistors' | 'Crystals' | 'Power' | 'MCUs' | 'Memory' | 'Sensors' | 'Interface' | 'Optocouplers' | 'Connectors' | 'ICs' | 'Misc';
+/**
+ * Determine library category from component prefix, LCSC category, and description
+ * Uses priority-ordered keyword matching with fuzzy detection
+ */
+export declare function getLibraryCategory(prefix: string, category?: string, description?: string): LibraryCategory;
+/**
+ * Get symbol library filename for a category
+ * Returns: "JLC-MCP-Resistors.kicad_sym"
+ */
+export declare function getLibraryFilename(category: LibraryCategory): string;
+/**
+ * Get footprint library directory name
+ * All footprints go in a single directory
+ * Returns: "JLC-MCP.pretty"
+ */
+export declare function getFootprintDirName(): string;
+/**
+ * Get 3D models directory name
+ * Returns: "JLC-MCP.3dshapes"
+ */
+export declare function get3DModelsDirName(): string;
+/**
+ * Get full symbol reference for use in schematics
+ * Format: "JLC-MCP-Resistors:SymbolName"
+ */
+export declare function getSymbolReference(category: LibraryCategory, symbolName: string): string;
+/**
+ * Get full footprint reference for use in schematics/boards
+ * Format: "JLC-MCP:FootprintName"
+ */
+export declare function getFootprintReference(footprintName: string): string;
+/**
+ * Get all possible library categories
+ */
+export declare function getAllCategories(): LibraryCategory[];
+/**
+ * Parse library name to extract category
+ * "JLC-MCP-Resistors" -> "Resistors"
+ */
+export declare function parseLibraryName(libraryName: string): LibraryCategory | null;
+//# sourceMappingURL=category-router.d.ts.map

package/dist/converter/category-router.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"category-router.d.ts","sourceRoot":"","sources":["../../src/converter/category-router.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,MAAM,eAAe,GACvB,WAAW,GACX,YAAY,GACZ,WAAW,GACX,QAAQ,GACR,aAAa,GACb,UAAU,GACV,OAAO,GACP,MAAM,GACN,QAAQ,GACR,SAAS,GACT,WAAW,GACX,cAAc,GACd,YAAY,GACZ,KAAK,GACL,MAAM,CAAC;AAyfX;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,MAAM,EACd,QAAQ,CAAC,EAAE,MAAM,EACjB,WAAW,CAAC,EAAE,MAAM,GACnB,eAAe,CAuBjB;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,eAAe,GAAG,MAAM,CAEpE;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,IAAI,MAAM,CAE5C;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,IAAI,MAAM,CAE3C;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAGxF;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,CAEnE;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,eAAe,EAAE,CAkBpD;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG,eAAe,GAAG,IAAI,CAS5E"}

package/dist/converter/footprint-mapper.d.ts

@@ -0,0 +1,40 @@
+/**
+ * KiCad Standard Footprint Mapper
+ * Maps common package names to KiCad built-in footprints for hybrid approach
+ *
+ * CONSERVATIVE APPROACH: Only uses KiCad built-ins for 2-pad unpolarized passives (R/C/L).
+ * All other components (ICs, transistors, diodes, etc.) generate custom footprints
+ * to avoid pin-flip issues from pad numbering mismatches.
+ */
+export interface FootprintMapping {
+    library: string;
+    footprint: string;
+}
+/**
+ * Map package name to KiCad standard footprint
+ *
+ * CONSERVATIVE APPROACH: Only returns built-in mappings for 2-pad unpolarized passives.
+ * This avoids pin-flip issues that can occur when pad numbering differs between
+ * EasyEDA data and KiCad built-in footprints (e.g., SOT-23 transistors have
+ * different BCE/CBE/EBC pinouts across manufacturers).
+ *
+ * Returns null if no standard mapping exists (will fall back to generated footprint)
+ */
+export declare function mapToKicadFootprint(packageName: string, componentPrefix: string, _category?: string, _description?: string): FootprintMapping | null;
+/**
+ * Get expected pad count for a KiCad footprint mapping
+ * Used to validate that EasyEDA footprint matches before using built-in
+ *
+ * Returns null if pad count is unknown (caller should allow the mapping)
+ */
+export declare function getExpectedPadCount(mapping: FootprintMapping): number | null;
+/**
+ * Get full KiCad footprint reference string
+ * Format: "Library:Footprint"
+ */
+export declare function getKicadFootprintRef(mapping: FootprintMapping): string;
+/**
+ * Check if a package is likely a standard passive that can use KiCad footprints
+ */
+export declare function isStandardPassive(packageName: string, prefix: string): boolean;
+//# sourceMappingURL=footprint-mapper.d.ts.map

package/dist/converter/footprint-mapper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"footprint-mapper.d.ts","sourceRoot":"","sources":["../../src/converter/footprint-mapper.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;CACnB;AA4DD;;;;;;;;;GASG;AACH,wBAAgB,mBAAmB,CACjC,WAAW,EAAE,MAAM,EACnB,eAAe,EAAE,MAAM,EACvB,SAAS,CAAC,EAAE,MAAM,EAClB,YAAY,CAAC,EAAE,MAAM,GACpB,gBAAgB,GAAG,IAAI,CAqBzB;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,gBAAgB,GAAG,MAAM,GAAG,IAAI,CAW5E;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,gBAAgB,GAAG,MAAM,CAEtE;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAG9E"}

package/dist/converter/footprint-mapper.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=footprint-mapper.test.d.ts.map

package/dist/converter/footprint-mapper.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"footprint-mapper.test.d.ts","sourceRoot":"","sources":["../../src/converter/footprint-mapper.test.ts"],"names":[],"mappings":""}

package/dist/converter/footprint.d.ts

@@ -0,0 +1,106 @@
+/**
+ * EasyEDA Footprint to KiCad Footprint Converter
+ * Complete rewrite to handle all EasyEDA shape types
+ *
+ * Supported shapes: PAD, TRACK, HOLE, CIRCLE, ARC, RECT, VIA, TEXT, SOLIDREGION
+ */
+import type { EasyEDAComponentData } from '../types/index.js';
+export interface FootprintConversionOptions {
+    libraryName?: string;
+    include3DModel?: boolean;
+    modelPath?: string;
+}
+export interface FootprintResult {
+    type: 'reference' | 'generated';
+    reference?: string;
+    content?: string;
+    name: string;
+}
+export declare class FootprintConverter {
+    /**
+     * Convert EasyEDA component data to KiCad footprint format string
+     */
+    convert(component: EasyEDAComponentData, options?: FootprintConversionOptions): string;
+    /**
+     * Get footprint using hybrid approach:
+     * - Use KiCad standard footprint if available (for common 2-pad passives)
+     * - Generate custom footprint for all other components
+     *
+     * CONSERVATIVE APPROACH: Only uses KiCad built-ins for R/C/L passives.
+     * This prevents pin-flip issues from pad numbering mismatches in ICs/transistors.
+     */
+    getFootprint(component: EasyEDAComponentData, options?: FootprintConversionOptions): FootprintResult;
+    /**
+     * Generate PAD element
+     * Handles all shapes: RECT, ELLIPSE, OVAL, POLYGON
+     */
+    private generatePad;
+    /**
+     * Generate custom POLYGON pad using gr_poly primitive
+     * Supports both SMD and through-hole polygon pads
+     */
+    private generatePolygonPad;
+    /**
+     * Generate HOLE as NPTH pad
+     */
+    private generateHole;
+    /**
+     * Generate VIA as through-hole pad (no number)
+     */
+    private generateVia;
+    /**
+     * Generate TRACK as fp_line segments
+     */
+    private generateTrack;
+    /**
+     * Generate CIRCLE as fp_circle
+     */
+    private generateCircle;
+    /**
+     * Generate ARC as fp_arc (from SVG path)
+     */
+    private generateArc;
+    /**
+     * Generate RECT as 4 fp_line elements
+     */
+    private generateRect;
+    /**
+     * Generate TEXT as fp_text (user text, not REF/VAL)
+     */
+    private generateText;
+    /**
+     * Generate SOLIDREGION as fp_poly (filled polygon)
+     * Parses SVG path with M/L/Z commands and converts to KiCad polygon
+     */
+    private generateSolidRegion;
+    /**
+     * Parse SVG path string (M/L/Z commands) to array of points
+     * Format: "M x1,y1 L x2,y2 L x3,y3 Z" or "M x1,y1 L x2,y2 ..."
+     */
+    private parseSvgPathToPoints;
+    /**
+     * Calculate bounding box from all footprint elements
+     */
+    private calculateBounds;
+    /**
+     * Generate footprint properties
+     * Positions Reference above courtyard and Value below courtyard
+     */
+    private generateProperties;
+    /**
+     * Generate fab reference text
+     */
+    private generateFabReference;
+    /**
+     * Generate courtyard outline
+     */
+    private generateCourtyard;
+    /**
+     * Generate 3D model reference
+     */
+    private generate3DModel;
+    private sanitizeName;
+    private escapeString;
+}
+export declare const footprintConverter: FootprintConverter;
+//# sourceMappingURL=footprint.d.ts.map

package/dist/converter/footprint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"footprint.d.ts","sourceRoot":"","sources":["../../src/converter/footprint.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EACV,oBAAoB,EAUrB,MAAM,mBAAmB,CAAC;AAyD3B,MAAM,WAAW,0BAA0B;IACzC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,WAAW,GAAG,WAAW,CAAC;IAChC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;CACd;AAiKD,qBAAa,kBAAkB;IAC7B;;OAEG;IACH,OAAO,CAAC,SAAS,EAAE,oBAAoB,EAAE,OAAO,GAAE,0BAA+B,GAAG,MAAM;IA2F1F;;;;;;;OAOG;IACH,YAAY,CACV,SAAS,EAAE,oBAAoB,EAC/B,OAAO,GAAE,0BAA+B,GACvC,eAAe;IA2ClB;;;OAGG;IACH,OAAO,CAAC,WAAW;IAiDnB;;;OAGG;IACH,OAAO,CAAC,kBAAkB;IAwD1B;;OAEG;IACH,OAAO,CAAC,YAAY;IAapB;;OAEG;IACH,OAAO,CAAC,WAAW;IAcnB;;OAEG;IACH,OAAO,CAAC,aAAa;IA4BrB;;OAEG;IACH,OAAO,CAAC,cAAc;IAqBtB;;OAEG;IACH,OAAO,CAAC,WAAW;IAqBnB;;OAEG;IACH,OAAO,CAAC,YAAY;IAiCpB;;OAEG;IACH,OAAO,CAAC,YAAY;IAkCpB;;;OAGG;IACH,OAAO,CAAC,mBAAmB;IAyB3B;;;OAGG;IACH,OAAO,CAAC,oBAAoB;IAyB5B;;OAEG;IACH,OAAO,CAAC,eAAe;IA2DvB;;;OAGG;IACH,OAAO,CAAC,kBAAkB;IAkE1B;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAa5B;;OAEG;IACH,OAAO,CAAC,iBAAiB;IA8BzB;;OAEG;IACH,OAAO,CAAC,eAAe;IAkBvB,OAAO,CAAC,YAAY;IAIpB,OAAO,CAAC,YAAY;CAGrB;AAED,eAAO,MAAM,kBAAkB,oBAA2B,CAAC"}

package/dist/converter/global-lib-table.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Global Library Table Manager
+ * Registers JLC libraries in KiCad's global sym-lib-table and fp-lib-table
+ * Works cross-platform: macOS, Windows, Linux
+ */
+interface TableUpdateResult {
+    path: string;
+    created: boolean;
+    modified: boolean;
+    entriesAdded: number;
+}
+export interface GlobalRegistrationResult {
+    success: boolean;
+    version: string;
+    symLibTable: TableUpdateResult;
+    fpLibTable: TableUpdateResult;
+    libraryStubs: {
+        symbolsCreated: string[];
+        directoriesCreated: string[];
+    };
+    errors: string[];
+}
+/**
+ * Main entry point: Ensure JLC libraries are registered in KiCad global tables
+ * Call this on MCP server startup
+ */
+export declare function ensureGlobalLibraryTables(): Promise<GlobalRegistrationResult>;
+export {};
+//# sourceMappingURL=global-lib-table.d.ts.map

package/dist/converter/global-lib-table.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"global-lib-table.d.ts","sourceRoot":"","sources":["../../src/converter/global-lib-table.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AA2JH,UAAU,iBAAiB;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,OAAO,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;CACtB;AA0JD,MAAM,WAAW,wBAAwB;IACvC,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,iBAAiB,CAAC;IAC/B,UAAU,EAAE,iBAAiB,CAAC;IAC9B,YAAY,EAAE;QACZ,cAAc,EAAE,MAAM,EAAE,CAAC;QACzB,kBAAkB,EAAE,MAAM,EAAE,CAAC;KAC9B,CAAC;IACF,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED;;;GAGG;AACH,wBAAsB,yBAAyB,IAAI,OAAO,CAAC,wBAAwB,CAAC,CA2DnF"}