@jlcpcb/core 0.1.0

package/src/constants/design-rules.ts

@@ -0,0 +1,119 @@
+/**
+ * Default design rules for common PCB manufacturers
+ */
+
+export interface DesignRules {
+  name: string;
+  minTraceWidth: number;      // mm
+  minTraceClearance: number;  // mm
+  minViaDrill: number;        // mm
+  minViaPad: number;          // mm
+  minHoleDrill: number;       // mm
+  minAnnularRing: number;     // mm
+  minSilkscreenWidth: number; // mm
+  minSilkscreenClearance: number; // mm
+}
+
+// JLCPCB standard capabilities
+export const JLCPCB_STANDARD: DesignRules = {
+  name: 'JLCPCB Standard',
+  minTraceWidth: 0.127,       // 5 mil
+  minTraceClearance: 0.127,   // 5 mil
+  minViaDrill: 0.3,
+  minViaPad: 0.6,
+  minHoleDrill: 0.3,
+  minAnnularRing: 0.13,
+  minSilkscreenWidth: 0.15,
+  minSilkscreenClearance: 0.15,
+};
+
+// JLCPCB advanced capabilities (extra cost)
+export const JLCPCB_ADVANCED: DesignRules = {
+  name: 'JLCPCB Advanced',
+  minTraceWidth: 0.09,        // 3.5 mil
+  minTraceClearance: 0.09,    // 3.5 mil
+  minViaDrill: 0.15,
+  minViaPad: 0.4,
+  minHoleDrill: 0.15,
+  minAnnularRing: 0.075,
+  minSilkscreenWidth: 0.1,
+  minSilkscreenClearance: 0.1,
+};
+
+// PCBWay standard capabilities
+export const PCBWAY_STANDARD: DesignRules = {
+  name: 'PCBWay Standard',
+  minTraceWidth: 0.127,       // 5 mil
+  minTraceClearance: 0.127,   // 5 mil
+  minViaDrill: 0.3,
+  minViaPad: 0.6,
+  minHoleDrill: 0.3,
+  minAnnularRing: 0.15,
+  minSilkscreenWidth: 0.15,
+  minSilkscreenClearance: 0.15,
+};
+
+// OSH Park standard capabilities
+export const OSHPARK_STANDARD: DesignRules = {
+  name: 'OSH Park',
+  minTraceWidth: 0.152,       // 6 mil
+  minTraceClearance: 0.152,   // 6 mil
+  minViaDrill: 0.254,         // 10 mil
+  minViaPad: 0.508,
+  minHoleDrill: 0.254,
+  minAnnularRing: 0.127,
+  minSilkscreenWidth: 0.15,
+  minSilkscreenClearance: 0.15,
+};
+
+// Conservative rules for hobby/hand soldering
+export const HOBBY_RULES: DesignRules = {
+  name: 'Hobby/Hand Solder',
+  minTraceWidth: 0.3,         // 12 mil
+  minTraceClearance: 0.3,     // 12 mil
+  minViaDrill: 0.4,
+  minViaPad: 0.8,
+  minHoleDrill: 0.4,
+  minAnnularRing: 0.2,
+  minSilkscreenWidth: 0.2,
+  minSilkscreenClearance: 0.2,
+};
+
+// Standard trace widths for different current levels (1oz copper, 10C rise)
+export const TRACE_WIDTH_CURRENT: Record<string, number> = {
+  '0.5A': 0.2,
+  '1A': 0.5,
+  '2A': 1.0,
+  '3A': 1.5,
+  '5A': 2.5,
+  '10A': 5.0,
+};
+
+// Default layer stackups
+export const LAYER_STACKUPS = {
+  '2-layer': {
+    layers: ['F.Cu', 'B.Cu'],
+    copperThickness: 0.035,  // 1oz = 35um
+    boardThickness: 1.6,     // mm
+  },
+  '4-layer': {
+    layers: ['F.Cu', 'In1.Cu', 'In2.Cu', 'B.Cu'],
+    copperThickness: 0.035,
+    boardThickness: 1.6,
+  },
+} as const;
+
+export function getDesignRulesForManufacturer(manufacturer: string): DesignRules {
+  switch (manufacturer.toLowerCase()) {
+    case 'jlcpcb':
+      return JLCPCB_STANDARD;
+    case 'jlcpcb-advanced':
+      return JLCPCB_ADVANCED;
+    case 'pcbway':
+      return PCBWAY_STANDARD;
+    case 'oshpark':
+      return OSHPARK_STANDARD;
+    default:
+      return HOBBY_RULES;
+  }
+}

package/src/constants/footprints.ts

@@ -0,0 +1,68 @@
+/**
+ * Standard footprint patterns and dimensions
+ */
+
+// Common SMD resistor/capacitor sizes (metric)
+export const SMD_PACKAGE_SIZES: Record<string, { length: number; width: number }> = {
+  '0201': { length: 0.6, width: 0.3 },
+  '0402': { length: 1.0, width: 0.5 },
+  '0603': { length: 1.6, width: 0.8 },
+  '0805': { length: 2.0, width: 1.25 },
+  '1206': { length: 3.2, width: 1.6 },
+  '1210': { length: 3.2, width: 2.5 },
+  '1812': { length: 4.5, width: 3.2 },
+  '2010': { length: 5.0, width: 2.5 },
+  '2512': { length: 6.3, width: 3.2 },
+};
+
+// Common IC package patterns
+export const IC_PACKAGE_PATTERNS = {
+  // SOIC packages
+  SOIC8: { pins: 8, pitch: 1.27, width: 3.9 },
+  SOIC14: { pins: 14, pitch: 1.27, width: 3.9 },
+  SOIC16: { pins: 16, pitch: 1.27, width: 3.9 },
+
+  // TSSOP packages
+  TSSOP8: { pins: 8, pitch: 0.65, width: 3.0 },
+  TSSOP14: { pins: 14, pitch: 0.65, width: 4.4 },
+  TSSOP16: { pins: 16, pitch: 0.65, width: 4.4 },
+  TSSOP20: { pins: 20, pitch: 0.65, width: 4.4 },
+
+  // QFP packages
+  LQFP32: { pins: 32, pitch: 0.8, size: 7.0 },
+  LQFP48: { pins: 48, pitch: 0.5, size: 7.0 },
+  LQFP64: { pins: 64, pitch: 0.5, size: 10.0 },
+  LQFP100: { pins: 100, pitch: 0.5, size: 14.0 },
+  LQFP144: { pins: 144, pitch: 0.5, size: 20.0 },
+
+  // QFN packages
+  QFN16: { pins: 16, pitch: 0.5, size: 3.0 },
+  QFN20: { pins: 20, pitch: 0.5, size: 4.0 },
+  QFN24: { pins: 24, pitch: 0.5, size: 4.0 },
+  QFN32: { pins: 32, pitch: 0.5, size: 5.0 },
+  QFN48: { pins: 48, pitch: 0.5, size: 7.0 },
+
+  // BGA packages
+  BGA100: { pins: 100, pitch: 0.8 },
+  BGA144: { pins: 144, pitch: 0.8 },
+  BGA256: { pins: 256, pitch: 0.8 },
+} as const;
+
+// Standard connector pitches
+export const CONNECTOR_PITCHES = {
+  STANDARD_2_54MM: 2.54,  // 100 mil
+  STANDARD_2MM: 2.0,
+  FINE_1_27MM: 1.27,      // 50 mil
+  FINE_1MM: 1.0,
+  USB_C: 0.5,
+  FPC_0_5MM: 0.5,
+  FPC_1MM: 1.0,
+} as const;
+
+// Mounting hole sizes (M2, M2.5, M3, M4)
+export const MOUNTING_HOLES = {
+  M2: { drill: 2.2, pad: 4.0 },
+  M2_5: { drill: 2.7, pad: 5.0 },
+  M3: { drill: 3.2, pad: 6.0 },
+  M4: { drill: 4.3, pad: 8.0 },
+} as const;

package/src/constants/index.ts

@@ -0,0 +1,7 @@
+/**
+ * ai-eda-common constants
+ */
+
+export * from './kicad.js';
+export * from './footprints.js';
+export * from './design-rules.js';

package/src/constants/kicad.ts

@@ -0,0 +1,147 @@
+/**
+ * KiCad layer names and constants
+ */
+
+// Standard layer names
+export const KICAD_LAYERS = {
+  // Copper layers
+  F_CU: 'F.Cu',
+  B_CU: 'B.Cu',
+  IN1_CU: 'In1.Cu',
+  IN2_CU: 'In2.Cu',
+  IN3_CU: 'In3.Cu',
+  IN4_CU: 'In4.Cu',
+
+  // Technical layers - front
+  F_ADHES: 'F.Adhes',
+  F_PASTE: 'F.Paste',
+  F_SILKS: 'F.SilkS',
+  F_MASK: 'F.Mask',
+  F_CRTYD: 'F.CrtYd',
+  F_FAB: 'F.Fab',
+
+  // Technical layers - back
+  B_ADHES: 'B.Adhes',
+  B_PASTE: 'B.Paste',
+  B_SILKS: 'B.SilkS',
+  B_MASK: 'B.Mask',
+  B_CRTYD: 'B.CrtYd',
+  B_FAB: 'B.Fab',
+
+  // Other layers
+  EDGE_CUTS: 'Edge.Cuts',
+  MARGIN: 'Margin',
+  DWGS_USER: 'Dwgs.User',
+  CMTS_USER: 'Cmts.User',
+  ECO1_USER: 'Eco1.User',
+  ECO2_USER: 'Eco2.User',
+} as const;
+
+// Layer groups for common operations
+export const KICAD_LAYER_GROUPS = {
+  ALL_CU: ['*.Cu'],
+  ALL_MASK: ['*.Mask'],
+  FRONT_LAYERS: ['F.Cu', 'F.Paste', 'F.Mask'],
+  BACK_LAYERS: ['B.Cu', 'B.Paste', 'B.Mask'],
+  SMD_FRONT: ['F.Cu', 'F.Paste', 'F.Mask'],
+  SMD_BACK: ['B.Cu', 'B.Paste', 'B.Mask'],
+  THT: ['*.Cu', '*.Mask'],
+} as const;
+
+// Default text sizes
+export const KICAD_DEFAULTS = {
+  TEXT_SIZE: 1.27,      // mm (standard KiCad 9)
+  TEXT_THICKNESS: 0.15, // mm
+  WIRE_WIDTH: 0.25,    // mm (schematic)
+  GRID_SCHEMATIC: 2.54, // mm (100 mil)
+  GRID_PCB: 0.25,      // mm
+  PIN_LENGTH: 1.27,    // mm (50 mil - KiCad 9 default)
+  PIN_NAME_OFFSET: 0,  // mm (0 for hidden names)
+} as const;
+
+// Symbol generator version (KiCad 9 format)
+export const KICAD_SYMBOL_VERSION = '20241209';
+export const KICAD_FOOTPRINT_VERSION = '20241209';
+
+// Pin electrical types
+export const KICAD_PIN_TYPES = [
+  'input',
+  'output',
+  'bidirectional',
+  'tri_state',
+  'passive',
+  'free',
+  'unspecified',
+  'power_in',
+  'power_out',
+  'open_collector',
+  'open_emitter',
+  'no_connect',
+] as const;
+
+// Pad shapes
+export const KICAD_PAD_SHAPES = [
+  'circle',
+  'rect',
+  'oval',
+  'trapezoid',
+  'roundrect',
+  'custom',
+] as const;
+
+// Pad types
+export const KICAD_PAD_TYPES = [
+  'thru_hole',
+  'smd',
+  'connect',
+  'np_thru_hole',
+] as const;
+
+// Global library configuration
+export const KICAD_LIBRARY_NAME = 'EDA-MCP';
+export const KICAD_LIBRARY_DESCRIPTION = 'AI-EDA Component Library (JLC/EasyEDA)';
+
+// Supported KiCad versions (newest first)
+export const KICAD_VERSIONS = ['9.0', '8.0'] as const;
+
+/**
+ * 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 function getGlobalKicadLibraryPaths(
+  homeDir: string,
+  platform: 'darwin' | 'win32' | 'linux',
+  version: string = '9.0'
+): {
+  base: string;
+  symbols: string;
+  footprints: string;
+  models3d: string;
+} | null {
+  let baseDir: string;
+
+  switch (platform) {
+    case 'darwin':
+      // macOS: ~/Documents/KiCad/9.0/
+      baseDir = `${homeDir}/Documents/KiCad/${version}`;
+      break;
+    case 'win32':
+      // Windows: %USERPROFILE%/Documents/KiCad/9.0/
+      baseDir = `${homeDir}/Documents/KiCad/${version}`;
+      break;
+    case 'linux':
+      // Linux: ~/.local/share/kicad/9.0/ or ~/Documents/KiCad/9.0/
+      baseDir = `${homeDir}/Documents/KiCad/${version}`;
+      break;
+    default:
+      return null;
+  }
+
+  return {
+    base: baseDir,
+    symbols: `${baseDir}/symbols`,
+    footprints: `${baseDir}/footprints`,
+    models3d: `${baseDir}/3dmodels`,
+  };
+}