@jlcpcb/core 0.1.0 → 0.2.0

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,116 @@
+/**
+ * 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
+     *
+     * Note: EasyEDA polygon pads may have holeRadius=0 even for through-hole pads.
+     * We use isPlated=true as a hint and calculate drill size from polygon geometry.
+     */
+    private generatePolygonPad;
+    /**
+     * Calculate drill radius from polygon points
+     * Uses inscribed circle approximation: smallest distance from center to any edge
+     * Returns radius in EasyEDA units (10mil)
+     */
+    private calculateDrillRadiusFromPolygon;
+    /**
+     * 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 to array of points
+     * Handles M, L, H, V, C, Q, A, Z commands
+     * Curves are simplified to their endpoints (no interpolation)
+     */
+    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;AA0D3B,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;;;;;;OAMG;IACH,OAAO,CAAC,kBAAkB;IAkE1B;;;;OAIG;IACH,OAAO,CAAC,+BAA+B;IA2BvC;;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;IAmCpB;;;OAGG;IACH,OAAO,CAAC,mBAAmB;IAiC3B;;;;OAIG;IACH,OAAO,CAAC,oBAAoB;IA8H5B;;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[];
+}
+/**
+ * Ensure EasyEDA library is registered in global sym-lib-table and fp-lib-table
+ */
+export declare function ensureGlobalEasyEDALibrary(): Promise<void>;
+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;AA0BD;;GAEG;AACH,wBAAsB,0BAA0B,IAAI,OAAO,CAAC,IAAI,CAAC,CA8ChE;AAED,wBAAsB,yBAAyB,IAAI,OAAO,CAAC,wBAAwB,CAAC,CA2DnF"}

package/dist/converter/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * EasyEDA to KiCad converters
+ */
+export { SymbolConverter, symbolConverter, type SymbolConversionOptions } from './symbol.js';
+export { FootprintConverter, footprintConverter, type FootprintConversionOptions, type FootprintResult } from './footprint.js';
+export { ensureSymLibTable, ensureFpLibTable, getSymbolReference, getFootprintReference, libraryExistsInTable, } from './lib-table.js';
+export { mapToKicadFootprint, getKicadFootprintRef, isStandardPassive, type FootprintMapping, } from './footprint-mapper.js';
+export { normalizeValue, detectComponentType, extractDisplayValue, type ComponentType, type NormalizedValue, } from './value-normalizer.js';
+export { getLibraryCategory, getLibraryFilename, getFootprintDirName, get3DModelsDirName, getSymbolReference as getCategorySymbolReference, getFootprintReference as getCategoryFootprintReference, getAllCategories, parseLibraryName, type LibraryCategory, } from './category-router.js';
+export { getSymbolTemplate, hasFixedTemplate, type SymbolTemplate, } from './symbol-templates.js';
+export { ensureGlobalLibraryTables, type GlobalRegistrationResult, } from './global-lib-table.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/converter/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,KAAK,uBAAuB,EAAE,MAAM,aAAa,CAAC;AAC7F,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,KAAK,0BAA0B,EAAE,KAAK,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAC/H,OAAO,EACL,iBAAiB,EACjB,gBAAgB,EAChB,kBAAkB,EAClB,qBAAqB,EACrB,oBAAoB,GACrB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,mBAAmB,EACnB,oBAAoB,EACpB,iBAAiB,EACjB,KAAK,gBAAgB,GACtB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,cAAc,EACd,mBAAmB,EACnB,mBAAmB,EACnB,KAAK,aAAa,EAClB,KAAK,eAAe,GACrB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EAClB,mBAAmB,EACnB,kBAAkB,EAClB,kBAAkB,IAAI,0BAA0B,EAChD,qBAAqB,IAAI,6BAA6B,EACtD,gBAAgB,EAChB,gBAAgB,EAChB,KAAK,eAAe,GACrB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,iBAAiB,EACjB,gBAAgB,EAChB,KAAK,cAAc,GACpB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,yBAAyB,EACzB,KAAK,wBAAwB,GAC9B,MAAM,uBAAuB,CAAC"}

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

@@ -0,0 +1,61 @@
+/**
+ * KiCad Library Table Management
+ * Handles sym-lib-table and fp-lib-table generation and updates
+ */
+/**
+ * Generate sym-lib-table content
+ */
+export declare function generateSymLibTable(symbolLibPath: string, libraryName?: string, description?: string): string;
+/**
+ * Generate fp-lib-table content
+ */
+export declare function generateFpLibTable(footprintLibPath: string, libraryName?: string, description?: string): string;
+/**
+ * Check if a library entry exists in a lib-table file
+ */
+export declare function libraryExistsInTable(tableContent: string, libraryName: string): boolean;
+/**
+ * Add a library entry to an existing lib-table content
+ */
+export declare function addLibraryToTable(tableContent: string, libraryName: string, libraryPath: string, type: 'sym' | 'fp', description?: string): string;
+/**
+ * Ensure sym-lib-table exists and contains specified library
+ * @param projectDir - Path to the KiCad project directory
+ * @param symbolLibPath - Path to the symbol library file (relative or absolute)
+ * @param libraryName - Library name (default: LCSC)
+ * @param description - Library description
+ * @returns true if table was created or modified, false if already correct
+ */
+export declare function ensureSymLibTable(projectDir: string, symbolLibPath: string, libraryName?: string, description?: string): Promise<{
+    created: boolean;
+    modified: boolean;
+    path: string;
+}>;
+/**
+ * Ensure fp-lib-table exists and contains specified library
+ * @param projectDir - Path to the KiCad project directory
+ * @param footprintLibPath - Path to the footprint library directory (relative or absolute)
+ * @param libraryName - Library name (default: LCSC)
+ * @param description - Library description
+ * @returns true if table was created or modified, false if already correct
+ */
+export declare function ensureFpLibTable(projectDir: string, footprintLibPath: string, libraryName?: string, description?: string): Promise<{
+    created: boolean;
+    modified: boolean;
+    path: string;
+}>;
+/**
+ * Get the symbol reference string for use in schematics
+ * @param symbolName - The symbol name within the library
+ * @param libraryName - Library name (default: LCSC)
+ * @returns Full reference like "LCSC:SymbolName"
+ */
+export declare function getSymbolReference(symbolName: string, libraryName?: string): string;
+/**
+ * Get the footprint reference string for use in symbols/schematics
+ * @param footprintName - The footprint filename (without .kicad_mod)
+ * @param libraryName - Library name (default: LCSC)
+ * @returns Full reference like "LCSC:FootprintName"
+ */
+export declare function getFootprintReference(footprintName: string, libraryName?: string): string;
+//# sourceMappingURL=lib-table.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"lib-table.d.ts","sourceRoot":"","sources":["../../src/converter/lib-table.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAUH;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,aAAa,EAAE,MAAM,EACrB,WAAW,GAAE,MAA6B,EAC1C,WAAW,GAAE,MAAoC,GAChD,MAAM,CAMR;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,gBAAgB,EAAE,MAAM,EACxB,WAAW,GAAE,MAA6B,EAC1C,WAAW,GAAE,MAAoC,GAChD,MAAM,CAMR;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,YAAY,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAGvF;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,YAAY,EAAE,MAAM,EACpB,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE,KAAK,GAAG,IAAI,EAClB,WAAW,GAAE,MAAoC,GAChD,MAAM,CAkBR;AAED;;;;;;;GAOG;AACH,wBAAsB,iBAAiB,CACrC,UAAU,EAAE,MAAM,EAClB,aAAa,EAAE,MAAM,EACrB,WAAW,GAAE,MAA6B,EAC1C,WAAW,GAAE,MAAoC,GAChD,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,QAAQ,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,CA0BhE;AAED;;;;;;;GAOG;AACH,wBAAsB,gBAAgB,CACpC,UAAU,EAAE,MAAM,EAClB,gBAAgB,EAAE,MAAM,EACxB,WAAW,GAAE,MAA6B,EAC1C,WAAW,GAAE,MAAoC,GAChD,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,QAAQ,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,CA0BhE;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,MAAM,EAAE,WAAW,GAAE,MAA6B,GAAG,MAAM,CAEzG;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,aAAa,EAAE,MAAM,EAAE,WAAW,GAAE,MAA6B,GAAG,MAAM,CAE/G"}

package/dist/converter/svg-arc.d.ts

@@ -0,0 +1,45 @@
+/**
+ * SVG Arc to Center Parameterization
+ *
+ * Converts SVG arc endpoint parameters to center point format used by KiCad.
+ * Based on SVG specification: https://www.w3.org/TR/SVG/implnote.html#ArcConversionEndpointToCenter
+ */
+export interface ArcEndpointParams {
+    x1: number;
+    y1: number;
+    rx: number;
+    ry: number;
+    phi: number;
+    largeArc: boolean;
+    sweep: boolean;
+    x2: number;
+    y2: number;
+}
+export interface ArcCenterParams {
+    cx: number;
+    cy: number;
+    rx: number;
+    ry: number;
+    startAngle: number;
+    endAngle: number;
+    deltaAngle: number;
+}
+/**
+ * Convert SVG arc endpoint parameterization to center parameterization
+ * Algorithm from SVG spec Appendix B.2.4
+ */
+export declare function svgArcToCenter(params: ArcEndpointParams): ArcCenterParams | null;
+/**
+ * Parse SVG arc path and extract parameters
+ * Format: "M x1 y1 A rx ry rotation largeArc sweep x2 y2"
+ */
+export declare function parseSvgArcPath(path: string): ArcEndpointParams | null;
+/**
+ * Convert radians to degrees
+ */
+export declare function radToDeg(rad: number): number;
+/**
+ * Normalize angle to 0-360 range
+ */
+export declare function normalizeAngle(degrees: number): number;
+//# sourceMappingURL=svg-arc.d.ts.map

package/dist/converter/svg-arc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"svg-arc.d.ts","sourceRoot":"","sources":["../../src/converter/svg-arc.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;IACX,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,OAAO,CAAC;IAClB,KAAK,EAAE,OAAO,CAAC;IACf,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;CACZ;AAED,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,iBAAiB,GAAG,eAAe,GAAG,IAAI,CA+FhF;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,iBAAiB,GAAG,IAAI,CA4BtE;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAE5C;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAItD"}