@jlcpcb/core 0.1.0 → 0.2.0

package/dist/parsers/easyeda-shapes.d.ts

@@ -0,0 +1,115 @@
+/**
+ * Unified EasyEDA shape parser
+ * Parses both symbol and footprint shapes from EasyEDA format
+ *
+ * Shape format reference (from easyeda2kicad):
+ * - All shapes use tilde (~) as field delimiter
+ * - Coordinates are in 10mil units (0.254mm per unit)
+ * - Symbol shapes have Y-axis flipped relative to footprint
+ */
+import type { EasyEDAPin, EasyEDASymbolRect, EasyEDASymbolCircle, EasyEDASymbolEllipse, EasyEDASymbolArc, EasyEDASymbolPolyline, EasyEDASymbolPolygon, EasyEDASymbolPath, ParsedSymbolData, EasyEDAPad, EasyEDATrack, EasyEDAHole, EasyEDACircle, EasyEDAArc, EasyEDARect, EasyEDAVia, EasyEDAText, EasyEDASolidRegion, ParsedFootprintData } from '../types/easyeda.js';
+/**
+ * Parse EasyEDA symbol pin format
+ * Format: P~show~type~number~x~y~rotation~id~locked^^dotData^^pathData^^nameData^^numData^^dot^^clock
+ *
+ * Segments:
+ * [0] = P~show~type~number~x~y~rotation~id~locked (main settings)
+ * [1] = dot display data (visual dot, not inversion)
+ * [2] = SVG path for pin line (M x y h LENGTH or v LENGTH)
+ * [3] = name text data (1~x~y~rotation~name~fontSize~...)
+ * [4] = number text data
+ * [5] = inverted bubble indicator - "1" if inverted
+ * [6] = clock triangle indicator - non-empty if clock
+ */
+export declare function parseSymbolPin(pinData: string): EasyEDAPin | null;
+/**
+ * Parse symbol Rectangle shape
+ * Format: R~x~y~rx~ry~width~height~strokeColor~strokeWidth~strokeStyle~fillColor~id~locked
+ */
+export declare function parseSymbolRect(data: string): EasyEDASymbolRect | null;
+/**
+ * Parse symbol Circle shape
+ * Format: C~cx~cy~radius~strokeColor~strokeWidth~strokeStyle~fillColor~id~locked
+ */
+export declare function parseSymbolCircle(data: string): EasyEDASymbolCircle | null;
+/**
+ * Parse symbol Ellipse shape
+ * Format: E~cx~cy~rx~ry~strokeColor~strokeWidth~strokeStyle~fillColor~id~locked
+ */
+export declare function parseSymbolEllipse(data: string): EasyEDASymbolEllipse | null;
+/**
+ * Parse symbol Arc shape (SVG path format)
+ * Format: A~path~strokeColor~strokeWidth~strokeStyle~fillColor~id~locked
+ */
+export declare function parseSymbolArc(data: string): EasyEDASymbolArc | null;
+/**
+ * Parse symbol Polyline shape (open path)
+ * Format: PL~points~strokeColor~strokeWidth~strokeStyle~fillColor~id~locked
+ */
+export declare function parseSymbolPolyline(data: string): EasyEDASymbolPolyline | null;
+/**
+ * Parse symbol Polygon shape (closed filled path)
+ * Format: PG~points~strokeColor~strokeWidth~strokeStyle~fillColor~id~locked
+ */
+export declare function parseSymbolPolygon(data: string): EasyEDASymbolPolygon | null;
+/**
+ * Parse symbol SVG Path shape
+ * Format: PT~path~strokeColor~strokeWidth~strokeStyle~fillColor~id~locked
+ */
+export declare function parseSymbolPath(data: string): EasyEDASymbolPath | null;
+/**
+ * Parse PAD element - 18 fields
+ * Format: PAD~shape~cx~cy~width~height~layerId~net~number~holeRadius~points~rotation~id~holeLength~holePoint~isPlated~isLocked
+ */
+export declare function parsePad(data: string): EasyEDAPad | null;
+/**
+ * Parse TRACK element - silkscreen/fab lines
+ * Format: TRACK~strokeWidth~layerId~net~points~id~isLocked
+ */
+export declare function parseTrack(data: string): EasyEDATrack | null;
+/**
+ * Parse HOLE element - NPTH
+ * Format: HOLE~cx~cy~radius~id~isLocked
+ */
+export declare function parseHole(data: string): EasyEDAHole | null;
+/**
+ * Parse CIRCLE element (footprint)
+ * Format: CIRCLE~cx~cy~radius~strokeWidth~layerId~id~isLocked
+ */
+export declare function parseCircle(data: string): EasyEDACircle | null;
+/**
+ * Parse ARC element (footprint) with SVG path
+ * Format: ARC~strokeWidth~layerId~net~path~helperDots~id~isLocked
+ */
+export declare function parseArc(data: string): EasyEDAArc | null;
+/**
+ * Parse RECT element (footprint)
+ * Format: RECT~x~y~width~height~strokeWidth~id~layerId~isLocked
+ */
+export declare function parseRect(data: string): EasyEDARect | null;
+/**
+ * Parse VIA element
+ * Format: VIA~cx~cy~diameter~net~radius~id~isLocked
+ */
+export declare function parseVia(data: string): EasyEDAVia | null;
+/**
+ * Parse TEXT element
+ * Format: TEXT~type~cx~cy~strokeWidth~rotation~mirror~layerId~net~fontSize~text~textPath~isDisplayed~id~isLocked
+ */
+export declare function parseText(data: string): EasyEDAText | null;
+/**
+ * Parse SOLIDREGION element - filled polygon region
+ * Format: SOLIDREGION~layerId~~path~fillType~id~~~~
+ */
+export declare function parseSolidRegion(data: string): EasyEDASolidRegion | null;
+/**
+ * Parse all symbol shapes from raw shape strings
+ * Returns parsed data without origin - origin is added by client after parsing.
+ */
+export declare function parseSymbolShapes(shapes: string[]): ParsedSymbolData;
+/**
+ * Parse all footprint shapes from raw shape strings
+ * Returns parsed data without origin - origin is added by client after parsing.
+ */
+export declare function parseFootprintShapes(shapes: string[]): ParsedFootprintData;
+//# sourceMappingURL=easyeda-shapes.d.ts.map

package/dist/parsers/easyeda-shapes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"easyeda-shapes.d.ts","sourceRoot":"","sources":["../../src/parsers/easyeda-shapes.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAEV,UAAU,EACV,iBAAiB,EACjB,mBAAmB,EACnB,oBAAoB,EACpB,gBAAgB,EAChB,qBAAqB,EACrB,oBAAoB,EACpB,iBAAiB,EACjB,gBAAgB,EAEhB,UAAU,EACV,YAAY,EACZ,WAAW,EACX,aAAa,EACb,UAAU,EACV,WAAW,EACX,UAAU,EACV,WAAW,EACX,kBAAkB,EAClB,mBAAmB,EACpB,MAAM,qBAAqB,CAAC;AAQ7B;;;;;;;;;;;;GAYG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI,CA2CjE;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,iBAAiB,GAAG,IAAI,CAiBtE;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,mBAAmB,GAAG,IAAI,CAc1E;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,oBAAoB,GAAG,IAAI,CAe5E;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,gBAAgB,GAAG,IAAI,CAYpE;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,qBAAqB,GAAG,IAAI,CAY9E;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,oBAAoB,GAAG,IAAI,CAY5E;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,iBAAiB,GAAG,IAAI,CAYtE;AAMD;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI,CAwBxD;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI,CAc5D;AAED;;;GAGG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI,CAa1D;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI,CAe9D;AAED;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI,CAexD;AAED;;;GAGG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI,CAgB1D;AAED;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI,CAexD;AAED;;;GAGG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI,CAuB1D;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,kBAAkB,GAAG,IAAI,CAexE;AAMD;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,gBAAgB,CAwEpE;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,mBAAmB,CAoG1E"}

package/dist/parsers/http-client.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Shared HTTP client for EasyEDA API calls
+ * Used by both LCSC and Community API clients
+ */
+export interface FetchOptions {
+    method?: 'GET' | 'POST';
+    body?: string;
+    contentType?: string;
+    binary?: boolean;
+}
+/**
+ * Fetch URL with curl fallback for reliability
+ * Falls back to curl when Node fetch fails (proxy issues, etc.)
+ */
+export declare function fetchWithCurlFallback(url: string, options?: FetchOptions): Promise<string | Buffer>;
+//# sourceMappingURL=http-client.d.ts.map

package/dist/parsers/http-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-client.d.ts","sourceRoot":"","sources":["../../src/parsers/http-client.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAOH,MAAM,WAAW,YAAY;IAC3B,MAAM,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC;IACxB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED;;;GAGG;AACH,wBAAsB,qBAAqB,CACzC,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,YAAiB,GACzB,OAAO,CAAC,MAAM,GAAG,MAAM,CAAC,CAuE1B"}

package/dist/parsers/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Shared EasyEDA parsing utilities
+ *
+ * This module consolidates all EasyEDA parsing logic used by both
+ * the LCSC API client and EasyEDA Community API client.
+ */
+export { fetchWithCurlFallback, type FetchOptions } from './http-client.js';
+export { parseBool, safeParseFloat, safeParseInt } from './utils.js';
+export { parseSymbolPin, parseSymbolRect, parseSymbolCircle, parseSymbolEllipse, parseSymbolArc, parseSymbolPolyline, parseSymbolPolygon, parseSymbolPath, parseSymbolShapes, } from './easyeda-shapes.js';
+export { parsePad, parseTrack, parseHole, parseCircle, parseArc, parseRect, parseVia, parseText, parseFootprintShapes, } from './easyeda-shapes.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/parsers/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,qBAAqB,EAAE,KAAK,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAG5E,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAGrE,OAAO,EACL,cAAc,EACd,eAAe,EACf,iBAAiB,EACjB,kBAAkB,EAClB,cAAc,EACd,mBAAmB,EACnB,kBAAkB,EAClB,eAAe,EACf,iBAAiB,GAClB,MAAM,qBAAqB,CAAC;AAG7B,OAAO,EACL,QAAQ,EACR,UAAU,EACV,SAAS,EACT,WAAW,EACX,QAAQ,EACR,SAAS,EACT,QAAQ,EACR,SAAS,EACT,oBAAoB,GACrB,MAAM,qBAAqB,CAAC"}

package/dist/parsers/utils.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Shared parsing utilities for EasyEDA data
+ */
+/**
+ * Parse boolean from EasyEDA format
+ * Empty string = false, "0" = false, any other value = true
+ */
+export declare function parseBool(value: string | undefined): boolean;
+/**
+ * Safely parse float with default value
+ */
+export declare function safeParseFloat(value: string | undefined, defaultValue?: number): number;
+/**
+ * Safely parse int with default value
+ */
+export declare function safeParseInt(value: string | undefined, defaultValue?: number): number;
+//# sourceMappingURL=utils.d.ts.map

package/dist/parsers/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/parsers/utils.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;GAGG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAE5D;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,EAAE,YAAY,SAAI,GAAG,MAAM,CAIlF;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,EAAE,YAAY,SAAI,GAAG,MAAM,CAIhF"}

package/dist/services/component-service.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Component Service
+ * High-level API for searching and fetching components
+ */
+import type { ComponentSearchResult, EasyEDAComponentData, EasyEDACommunityComponent } from '../types/index.js';
+export interface SearchOptions {
+    limit?: number;
+    inStock?: boolean;
+    basicOnly?: boolean;
+    source?: 'lcsc' | 'easyeda-community' | 'all';
+}
+export interface ComponentDetails {
+    lcscId: string;
+    name: string;
+    manufacturer: string;
+    description: string;
+    category: string;
+    package: string;
+    pinCount: number;
+    padCount: number;
+    has3DModel: boolean;
+    datasheet?: string;
+}
+export interface ComponentService {
+    search(query: string, options?: SearchOptions): Promise<ComponentSearchResult[]>;
+    fetch(id: string): Promise<EasyEDAComponentData | null>;
+    fetchCommunity(uuid: string): Promise<EasyEDACommunityComponent | null>;
+    getDetails(lcscId: string): Promise<ComponentDetails>;
+}
+export declare function createComponentService(): ComponentService;
+//# sourceMappingURL=component-service.d.ts.map

package/dist/services/component-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"component-service.d.ts","sourceRoot":"","sources":["../../src/services/component-service.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,yBAAyB,EAAE,MAAM,mBAAmB,CAAC;AAKhH,MAAM,WAAW,aAAa;IAC5B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,GAAG,mBAAmB,GAAG,KAAK,CAAC;CAC/C;AAED,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,OAAO,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,gBAAgB;IAC/B,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,qBAAqB,EAAE,CAAC,CAAC;IACjF,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,GAAG,IAAI,CAAC,CAAC;IACxD,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,yBAAyB,GAAG,IAAI,CAAC,CAAC;IACxE,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;CACvD;AASD,wBAAgB,sBAAsB,IAAI,gBAAgB,CAuDzD"}

package/dist/services/fix-service.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Fix Service
+ * High-level API for applying pin corrections to components
+ */
+import type { LibraryCategory } from '../converter/category-router.js';
+export interface PinCorrection {
+    action: 'modify' | 'swap' | 'add' | 'remove';
+    pinNumber?: string;
+    newName?: string;
+    newType?: string;
+    swapWith?: string;
+    addPin?: {
+        number: string;
+        name: string;
+        type: string;
+    };
+}
+export interface FixOptions {
+    projectPath?: string;
+    force?: boolean;
+}
+export interface FixResult {
+    success: boolean;
+    id: string;
+    category: LibraryCategory;
+    symbolRef: string;
+    footprintRef: string;
+    correctionsApplied: number;
+    files: {
+        symbolLibrary: string;
+        footprint?: string;
+    };
+}
+export interface FixService {
+    fix(lcscId: string, corrections: {
+        pins?: PinCorrection[];
+    }, options?: FixOptions): Promise<FixResult>;
+}
+export declare function createFixService(): FixService;
+//# sourceMappingURL=fix-service.d.ts.map

package/dist/services/fix-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fix-service.d.ts","sourceRoot":"","sources":["../../src/services/fix-service.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAEvE,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,QAAQ,GAAG,MAAM,GAAG,KAAK,GAAG,QAAQ,CAAC;IAC7C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE;QACP,MAAM,EAAE,MAAM,CAAC;QACf,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;KACd,CAAC;CACH;AAED,MAAM,WAAW,UAAU;IACzB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,SAAS;IACxB,OAAO,EAAE,OAAO,CAAC;IACjB,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,eAAe,CAAC;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,KAAK,EAAE;QACL,aAAa,EAAE,MAAM,CAAC;QACtB,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,CAAC;CACH;AAED,MAAM,WAAW,UAAU;IACzB,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE;QAAE,IAAI,CAAC,EAAE,aAAa,EAAE,CAAA;KAAE,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC;CACxG;AAED,wBAAgB,gBAAgB,IAAI,UAAU,CAO7C"}

package/dist/services/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * High-level services for jlc-core
+ * Provides a clean API for common operations
+ */
+export { createComponentService, type ComponentService, type SearchOptions, type ComponentDetails } from './component-service.js';
+export { createLibraryService, type LibraryService, type InstallOptions, type InstallResult, type InstalledComponent, type ListOptions, type LibraryStatus } from './library-service.js';
+export { createFixService, type FixService, type FixOptions, type FixResult } from './fix-service.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/services/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,sBAAsB,EAAE,KAAK,gBAAgB,EAAE,KAAK,aAAa,EAAE,KAAK,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAClI,OAAO,EAAE,oBAAoB,EAAE,KAAK,cAAc,EAAE,KAAK,cAAc,EAAE,KAAK,aAAa,EAAE,KAAK,kBAAkB,EAAE,KAAK,WAAW,EAAE,KAAK,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACzL,OAAO,EAAE,gBAAgB,EAAE,KAAK,UAAU,EAAE,KAAK,UAAU,EAAE,KAAK,SAAS,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/services/library-service.d.ts

@@ -0,0 +1,112 @@
+/**
+ * Library Service
+ * High-level API for installing components to KiCad libraries
+ */
+import type { LibraryCategory } from '../converter/category-router.js';
+export interface InstallOptions {
+    projectPath?: string;
+    include3d?: boolean;
+    force?: boolean;
+}
+export interface InstallResult {
+    success: boolean;
+    id: string;
+    source: 'lcsc' | 'easyeda_community';
+    storageMode: 'global' | 'project-local';
+    category?: string;
+    symbolName: string;
+    symbolRef: string;
+    footprintRef: string;
+    footprintType: 'reference' | 'generated';
+    datasheet?: string;
+    files: {
+        symbolLibrary: string;
+        footprint?: string;
+        model3d?: string;
+    };
+    symbolAction: 'created' | 'appended' | 'exists' | 'replaced';
+    validationData: ValidationData;
+}
+export interface ValidationData {
+    component: {
+        name: string;
+        description?: string;
+        package?: string;
+        manufacturer?: string;
+        datasheet_url?: string;
+    };
+    symbol: {
+        pin_count: number;
+        pins: Array<{
+            number: string;
+            name: string;
+            electrical_type?: string;
+        }>;
+    };
+    footprint: {
+        type: string;
+        pad_count: number;
+        pads?: Array<{
+            number: string;
+            shape: string;
+        }> | null;
+        is_kicad_standard: boolean;
+        kicad_ref: string;
+    };
+    checks: {
+        pin_pad_count_match: boolean;
+        has_power_pins: boolean;
+        has_ground_pins: boolean;
+    };
+}
+export interface InstalledComponent {
+    lcscId: string;
+    name: string;
+    category: LibraryCategory;
+    symbolRef: string;
+    footprintRef: string;
+    library: string;
+    has3dModel: boolean;
+}
+export interface LibraryStatus {
+    installed: boolean;
+    linked: boolean;
+    version: string;
+    componentCount: number;
+    paths: {
+        symbolsDir: string;
+        footprintsDir: string;
+        models3dDir: string;
+        symLibTable: string;
+        fpLibTable: string;
+    };
+}
+export interface ListOptions {
+    category?: LibraryCategory;
+    projectPath?: string;
+}
+export interface UpdateOptions {
+    category?: LibraryCategory;
+    projectPath?: string;
+    dryRun?: boolean;
+}
+export interface UpdateResult {
+    updated: number;
+    failed: number;
+    skipped: number;
+    components: Array<{
+        id: string;
+        status: 'updated' | 'failed' | 'skipped';
+        error?: string;
+    }>;
+}
+export interface LibraryService {
+    install(id: string, options?: InstallOptions): Promise<InstallResult>;
+    listInstalled(options?: ListOptions): Promise<InstalledComponent[]>;
+    update(options?: UpdateOptions): Promise<UpdateResult>;
+    ensureGlobalTables(): Promise<void>;
+    getStatus(): Promise<LibraryStatus>;
+    isEasyEDAInstalled(componentName: string): Promise<boolean>;
+}
+export declare function createLibraryService(): LibraryService;
+//# sourceMappingURL=library-service.d.ts.map

package/dist/services/library-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"library-service.d.ts","sourceRoot":"","sources":["../../src/services/library-service.ts"],"names":[],"mappings":"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"}

package/dist/types/component.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Component and part types for the AI-EDA toolkit
+ */
+export interface Component {
+    lcscPartNumber: string;
+    manufacturerPart: string;
+    manufacturer: string;
+    description: string;
+    category: string;
+    subcategory: string;
+    package: string;
+    stock: number;
+    price: PriceTier[];
+    datasheet?: string;
+    footprint?: FootprintRef;
+    symbol?: SymbolRef;
+}
+export interface PriceTier {
+    quantity: number;
+    price: number;
+    currency: string;
+}
+export interface FootprintRef {
+    source: 'easyeda' | 'kicad' | 'local';
+    id: string;
+    localPath?: string;
+}
+export interface SymbolRef {
+    source: 'easyeda' | 'kicad' | 'local';
+    id: string;
+    localPath?: string;
+}
+export interface ComponentSelection {
+    role: string;
+    selected?: Component;
+    alternatives?: Component[];
+    requirements: string[];
+    status: 'pending' | 'selected' | 'placed' | 'routed';
+}
+export interface ComponentSearchResult {
+    lcscId: string;
+    name: string;
+    manufacturer: string;
+    package: string;
+    price?: number;
+    stock: number;
+    description: string;
+    productUrl?: string;
+    datasheetPdf?: string;
+    category?: string;
+    /** JLCPCB assembly type: "basic" = no setup fee, "extended" = setup fee required */
+    libraryType?: 'basic' | 'extended';
+    /** Component specifications (e.g., "Output Voltage": "3.3V", "Output Current": "100mA") */
+    attributes?: Record<string, string>;
+}
+//# sourceMappingURL=component.d.ts.map

package/dist/types/component.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"component.d.ts","sourceRoot":"","sources":["../../src/types/component.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,SAAS;IACxB,cAAc,EAAE,MAAM,CAAC;IACvB,gBAAgB,EAAE,MAAM,CAAC;IACzB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,SAAS,EAAE,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,YAAY,CAAC;IACzB,MAAM,CAAC,EAAE,SAAS,CAAC;CACpB;AAED,MAAM,WAAW,SAAS;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,SAAS,GAAG,OAAO,GAAG,OAAO,CAAC;IACtC,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,SAAS;IACxB,MAAM,EAAE,SAAS,GAAG,OAAO,GAAG,OAAO,CAAC;IACtC,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,SAAS,CAAC;IACrB,YAAY,CAAC,EAAE,SAAS,EAAE,CAAC;IAC3B,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,MAAM,EAAE,SAAS,GAAG,UAAU,GAAG,QAAQ,GAAG,QAAQ,CAAC;CACtD;AAED,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,oFAAoF;IACpF,WAAW,CAAC,EAAE,OAAO,GAAG,UAAU,CAAC;IACnC,2FAA2F;IAC3F,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACrC"}

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

@@ -0,0 +1,74 @@
+/**
+ * Types for EasyEDA community library API
+ * These are for user-contributed components (not official LCSC parts)
+ *
+ * NOTE: Community components now use the same parsed structure as LCSC components.
+ * The only differences are community-specific metadata (owner, creator, etc.)
+ */
+import type { EasyEDASymbolData, EasyEDAFootprintData } from './easyeda.js';
+/**
+ * Owner information for a community component
+ */
+export interface EasyEDACommunityOwner {
+    uuid: string;
+    username: string;
+    nickname: string;
+    avatar?: string;
+    team?: boolean;
+}
+/**
+ * Search result from EasyEDA community library
+ */
+export interface EasyEDACommunitySearchResult {
+    uuid: string;
+    title: string;
+    thumb: string;
+    description: string;
+    tags: string[];
+    package: string;
+    packageUuid?: string;
+    manufacturer?: string;
+    owner: EasyEDACommunityOwner;
+    contributor?: string;
+    has3DModel: boolean;
+    docType: number;
+    updateTime?: number;
+}
+/**
+ * Search parameters for EasyEDA community library
+ */
+export interface EasyEDACommunitySearchParams {
+    query: string;
+    source?: 'user' | 'lcsc' | 'easyeda' | 'all';
+    limit?: number;
+    page?: number;
+}
+/**
+ * Full component data from EasyEDA community library
+ * Uses the same symbol/footprint structure as EasyEDAComponentData with
+ * additional community-specific metadata.
+ */
+export interface EasyEDACommunityComponent {
+    uuid: string;
+    title: string;
+    description: string;
+    tags: string[];
+    owner: EasyEDACommunityOwner;
+    creator?: EasyEDACommunityOwner;
+    updateTime: number;
+    docType: number;
+    verify: boolean;
+    symbol: EasyEDASymbolData & {
+        head: Record<string, unknown>;
+    };
+    footprint: EasyEDAFootprintData & {
+        uuid: string;
+        head: Record<string, unknown>;
+    };
+    model3d?: {
+        name: string;
+        uuid: string;
+    };
+    rawData: object;
+}
+//# sourceMappingURL=easyeda-community.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"easyeda-community.d.ts","sourceRoot":"","sources":["../../src/types/easyeda-community.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAE5E;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,4BAA4B;IAC3C,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,qBAAqB,CAAC;IAC7B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,OAAO,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,4BAA4B;IAC3C,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,GAAG,KAAK,CAAC;IAC7C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;;;GAIG;AACH,MAAM,WAAW,yBAAyB;IACxC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,KAAK,EAAE,qBAAqB,CAAC;IAC7B,OAAO,CAAC,EAAE,qBAAqB,CAAC;IAChC,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,OAAO,CAAC;IAChB,MAAM,EAAE,iBAAiB,GAAG;QAC1B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KAC/B,CAAC;IACF,SAAS,EAAE,oBAAoB,GAAG;QAChC,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KAC/B,CAAC;IACF,OAAO,CAAC,EAAE;QACR,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;KACd,CAAC;IACF,OAAO,EAAE,MAAM,CAAC;CACjB"}