@jlcpcb/core 0.1.0

package/src/types/component.ts

@@ -0,0 +1,61 @@
+/**
+ * Component and part types for the AI-EDA toolkit
+ */
+
+export interface Component {
+  lcscPartNumber: string;        // e.g., "C2040"
+  manufacturerPart: string;      // e.g., "STM32F103C8T6"
+  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;                  // e.g., "Main MCU", "Power Regulator"
+  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;         // LCSC product page URL
+  datasheetPdf?: string;       // Actual PDF datasheet URL
+  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>;
+}

package/src/types/easyeda-community.ts

@@ -0,0 +1,78 @@
+/**
+ * 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; // UUID for the footprint/package (for image URL)
+  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;
+}

package/src/types/easyeda.ts

@@ -0,0 +1,356 @@
+/**
+ * EasyEDA format types for component data from LCSC/EasyEDA API
+ *
+ * Based on easyeda2kicad.py analysis - supports all footprint shape types
+ */
+
+export interface EasyEDAComponent {
+  uuid: string;
+  lcsc: string;
+  title: string;
+  description: string;
+  symbol: EasyEDASymbol;
+  footprint: EasyEDAFootprint;
+  attributes: Record<string, string>;
+}
+
+export interface EasyEDASymbol {
+  docType: string;
+  head: EasyEDAHead;
+  canvas: string;
+  shape: string[];
+}
+
+export interface EasyEDAFootprint {
+  docType: string;
+  head: EasyEDAHead;
+  canvas: string;
+  shape: string[];
+}
+
+export interface EasyEDAHead {
+  x: string;
+  y: string;
+  c_para?: Record<string, string>;
+  [key: string]: unknown;
+}
+
+export interface EasyEDAPin {
+  number: string;
+  name: string;
+  electricalType: string;
+  x: number;
+  y: number;
+  rotation: number;
+  // Pin style indicators (for inverted/clock pins)
+  hasDot: boolean;        // Inverted bubble indicator
+  hasClock: boolean;      // Clock triangle indicator
+  pinLength: number;      // Pin length in EasyEDA units (extracted from SVG path)
+}
+
+// =============================================================================
+// Symbol Shape Types (different from footprint shapes!)
+// =============================================================================
+
+/**
+ * Symbol Rectangle - body outlines, IC bodies
+ * Format: R~x~y~rx~ry~width~height~strokeColor~strokeWidth~strokeStyle~fillColor~id~locked
+ */
+export interface EasyEDASymbolRect {
+  x: number;
+  y: number;
+  width: number;
+  height: number;
+  strokeWidth: number;
+  strokeColor: string;
+  fillColor: string;
+  rx: number;            // corner radius X
+  ry: number;            // corner radius Y
+}
+
+/**
+ * Symbol Circle
+ * Format: C~cx~cy~radius~strokeColor~strokeWidth~strokeStyle~fillColor~id~locked
+ */
+export interface EasyEDASymbolCircle {
+  cx: number;
+  cy: number;
+  radius: number;
+  strokeWidth: number;
+  strokeColor: string;
+  fillColor: string;
+}
+
+/**
+ * Symbol Ellipse
+ * Format: E~cx~cy~rx~ry~strokeColor~strokeWidth~strokeStyle~fillColor~id~locked
+ */
+export interface EasyEDASymbolEllipse {
+  cx: number;
+  cy: number;
+  radiusX: number;
+  radiusY: number;
+  strokeWidth: number;
+  strokeColor: string;
+  fillColor: string;
+}
+
+/**
+ * Symbol Arc with SVG path
+ * Format: A~path~strokeColor~strokeWidth~strokeStyle~fillColor~id~locked
+ */
+export interface EasyEDASymbolArc {
+  path: string;          // SVG arc path "M x1 y1 A rx ry rotation largeArc sweep x2 y2"
+  strokeWidth: number;
+  strokeColor: string;
+  fillColor: string;
+}
+
+/**
+ * Symbol Polyline - open path
+ * Format: PL~points~strokeColor~strokeWidth~strokeStyle~fillColor~id~locked
+ */
+export interface EasyEDASymbolPolyline {
+  points: string;        // Space-separated "x1 y1 x2 y2 ..."
+  strokeWidth: number;
+  strokeColor: string;
+  fillColor: string;
+}
+
+/**
+ * Symbol Polygon - closed filled path
+ * Format: PG~points~strokeColor~strokeWidth~strokeStyle~fillColor~id~locked
+ */
+export interface EasyEDASymbolPolygon {
+  points: string;        // Space-separated "x1 y1 x2 y2 ..."
+  strokeWidth: number;
+  strokeColor: string;
+  fillColor: string;
+}
+
+/**
+ * Symbol Path - SVG path commands
+ * Format: PT~path~strokeColor~strokeWidth~strokeStyle~fillColor~id~locked
+ */
+export interface EasyEDASymbolPath {
+  path: string;          // SVG path commands (M/L/Z/C/A)
+  strokeWidth: number;
+  strokeColor: string;
+  fillColor: string;
+}
+
+/**
+ * Complete symbol data with all shape types
+ */
+export interface EasyEDASymbolData {
+  pins: EasyEDAPin[];
+  rectangles: EasyEDASymbolRect[];
+  circles: EasyEDASymbolCircle[];
+  ellipses: EasyEDASymbolEllipse[];
+  arcs: EasyEDASymbolArc[];
+  polylines: EasyEDASymbolPolyline[];
+  polygons: EasyEDASymbolPolygon[];
+  paths: EasyEDASymbolPath[];
+  origin: { x: number; y: number };
+}
+
+/** Parsed symbol data before origin is added */
+export type ParsedSymbolData = Omit<EasyEDASymbolData, 'origin'>;
+
+// =============================================================================
+// Footprint Shape Types (all coordinates in 10mil units)
+// =============================================================================
+
+/**
+ * PAD element - 18 fields
+ * Format: PAD~shape~cx~cy~width~height~layerId~net~number~holeRadius~points~rotation~id~holeLength~holePoint~isPlated~isLocked
+ */
+export interface EasyEDAPad {
+  shape: string;           // RECT, ELLIPSE, OVAL, POLYGON
+  centerX: number;         // center X coordinate
+  centerY: number;         // center Y coordinate
+  width: number;           // pad width
+  height: number;          // pad height
+  layerId: number;         // 1=F.Cu, 2=B.Cu, 11=*.Cu
+  net: string;             // net name (usually empty)
+  number: string;          // pad number "1", "2", "GND"
+  holeRadius: number;      // 0 for SMD, >0 for THT (radius, not diameter)
+  points: string;          // space-separated "x1 y1 x2 y2..." for POLYGON shape
+  rotation: number;        // rotation in degrees
+  id: string;              // unique element ID
+  holeLength: number;      // for slot/oval holes
+  holePoint: string;       // slot orientation
+  isPlated: boolean;       // true for PTH, false for NPTH
+  isLocked: boolean;       // locked in editor
+}
+
+/**
+ * TRACK element - silkscreen/fab lines
+ * Format: TRACK~strokeWidth~layerId~net~points~id~isLocked
+ */
+export interface EasyEDATrack {
+  strokeWidth: number;     // line width
+  layerId: number;         // layer ID
+  net: string;             // net name
+  points: string;          // space-separated "x1 y1 x2 y2..."
+  id: string;              // unique element ID
+  isLocked: boolean;
+}
+
+/**
+ * HOLE element - non-plated through hole (NPTH)
+ * Format: HOLE~cx~cy~radius~id~isLocked
+ */
+export interface EasyEDAHole {
+  centerX: number;
+  centerY: number;
+  radius: number;          // hole radius (NOT diameter)
+  id: string;
+  isLocked: boolean;
+}
+
+/**
+ * CIRCLE element - circular graphics
+ * Format: CIRCLE~cx~cy~radius~strokeWidth~layerId~id~isLocked
+ */
+export interface EasyEDACircle {
+  cx: number;
+  cy: number;
+  radius: number;
+  strokeWidth: number;
+  layerId: number;
+  id: string;
+  isLocked: boolean;
+}
+
+/**
+ * ARC element - arc graphics with SVG path
+ * Format: ARC~strokeWidth~layerId~net~path~helperDots~id~isLocked
+ */
+export interface EasyEDAArc {
+  strokeWidth: number;
+  layerId: number;
+  net: string;
+  path: string;            // SVG arc path "M x1 y1 A rx ry rotation largeArc sweep x2 y2"
+  helperDots: string;
+  id: string;
+  isLocked: boolean;
+}
+
+/**
+ * RECT element - rectangle graphics
+ * Format: RECT~x~y~width~height~strokeWidth~id~layerId~isLocked
+ */
+export interface EasyEDARect {
+  x: number;
+  y: number;
+  width: number;
+  height: number;
+  strokeWidth: number;
+  id: string;
+  layerId: number;
+  isLocked: boolean;
+}
+
+/**
+ * VIA element - through-hole via
+ * Format: VIA~cx~cy~diameter~net~radius~id~isLocked
+ */
+export interface EasyEDAVia {
+  centerX: number;
+  centerY: number;
+  diameter: number;
+  net: string;
+  radius: number;          // drill radius
+  id: string;
+  isLocked: boolean;
+}
+
+/**
+ * TEXT element - text graphics
+ * Format: TEXT~type~cx~cy~strokeWidth~rotation~mirror~layerId~net~fontSize~text~textPath~isDisplayed~id~isLocked
+ */
+export interface EasyEDAText {
+  type: string;            // text type
+  centerX: number;
+  centerY: number;
+  strokeWidth: number;
+  rotation: number;
+  mirror: string;
+  layerId: number;
+  net: string;
+  fontSize: number;
+  text: string;
+  textPath: string;
+  isDisplayed: boolean;
+  id: string;
+  isLocked: boolean;
+}
+
+/**
+ * SOLIDREGION element - filled polygon region
+ * Format: SOLIDREGION~layerId~~path~fillType~id~~~~
+ * Used for copper fills, solder paste regions, and documentation shapes
+ */
+export interface EasyEDASolidRegion {
+  layerId: number;
+  path: string;            // SVG path with M/L/Z commands (e.g., "M425,230L445,230L445,220L425,220Z")
+  fillType: string;        // "solid", "none", etc.
+  id: string;
+}
+
+// =============================================================================
+// Parsed Component Data
+// =============================================================================
+
+/**
+ * Complete footprint data with all shape types
+ */
+export interface EasyEDAFootprintData {
+  name: string;
+  type: 'smd' | 'tht';
+  pads: EasyEDAPad[];
+  tracks: EasyEDATrack[];
+  holes: EasyEDAHole[];
+  circles: EasyEDACircle[];
+  arcs: EasyEDAArc[];
+  rects: EasyEDARect[];
+  texts: EasyEDAText[];
+  vias: EasyEDAVia[];
+  solidRegions: EasyEDASolidRegion[];
+  origin: { x: number; y: number };
+  model3d?: { name: string; uuid: string }; // Extracted from SVGNODE
+}
+
+/** Parsed footprint data before origin is added */
+export type ParsedFootprintData = Omit<EasyEDAFootprintData, 'origin'>;
+
+export interface EasyEDAComponentData {
+  info: {
+    name: string;
+    prefix: string;
+    package?: string;
+    manufacturer?: string;
+    datasheet?: string;        // Product page URL
+    datasheetPdf?: string;     // Actual PDF datasheet URL
+    lcscId?: string;
+    jlcId?: string;
+    description?: string;
+    category?: string;
+    attributes?: Record<string, string>;
+    // CDFER parity fields
+    stock?: number;
+    price?: number;
+    minOrderQty?: number;
+    process?: 'SMT' | 'THT';
+    partClass?: string;
+    partNumber?: string;
+  };
+  symbol: EasyEDASymbolData;
+  footprint: EasyEDAFootprintData;
+  model3d?: {
+    name: string;
+    uuid: string;
+  };
+  rawData: object;
+}

package/src/types/index.ts

@@ -0,0 +1,12 @@
+/**
+ * ai-eda-common types
+ * Shared types for the AI-EDA toolkit
+ */
+
+export * from './component.js';
+export * from './kicad.js';
+export * from './easyeda.js';
+export * from './easyeda-community.js';
+export * from './jlc.js';
+export * from './project.js';
+export * from './mcp.js';

package/src/types/jlc.ts

@@ -0,0 +1,84 @@
+/**
+ * JLC/LCSC API response types
+ * Note: Interface names keep "LCSC" prefix as they represent LCSC part number formats
+ */
+
+export interface LCSCSearchResponse {
+  code: number;
+  result: {
+    productList: LCSCProduct[];
+    totalCount: number;
+    pageNumber: number;
+    pageSize: number;
+  };
+}
+
+export interface LCSCProduct {
+  productCode: string;           // LCSC part number (e.g., "C2040")
+  productModel: string;          // Manufacturer part number
+  brandNameEn: string;           // Manufacturer name
+  encapStandard: string;         // Package type
+  productPriceList: LCSCPriceItem[];
+  stockNumber: number;
+  productIntroEn: string;        // Description
+  productImages: string[];
+  productUrl: string;
+  datasheet?: string;
+}
+
+export interface LCSCPriceItem {
+  ladder: number;
+  productPrice: number;
+  currencySymbol: string;
+}
+
+export interface LCSCComponentResponse {
+  code: number;
+  result: {
+    dataStr: {
+      head: {
+        x: string;
+        y: string;
+        c_para: Record<string, string>;
+      };
+      shape: string[];
+    };
+    packageDetail: {
+      dataStr: {
+        head: {
+          x: string;
+          y: string;
+          c_para: Record<string, string>;
+        };
+        shape: string[];
+      };
+      title: string;
+    };
+    lcsc: {
+      number: string;
+      url: string;
+    };
+    SMT: boolean;
+  };
+}
+
+export interface LCSCSearchOptions {
+  category?: string;
+  inStock?: boolean;
+  basicOnly?: boolean;
+  limit?: number;
+  page?: number;
+}
+
+export interface LCSCStockInfo {
+  lcscPartNumber: string;
+  stock: number;
+  priceBreaks: PriceBreak[];
+  minimumOrder: number;
+}
+
+export interface PriceBreak {
+  quantity: number;
+  unitPrice: number;
+  currency: string;
+}