@jlcpcb/core 0.1.0

package/src/parsers/index.ts

@@ -0,0 +1,38 @@
+/**
+ * Shared EasyEDA parsing utilities
+ *
+ * This module consolidates all EasyEDA parsing logic used by both
+ * the LCSC API client and EasyEDA Community API client.
+ */
+
+// HTTP client
+export { fetchWithCurlFallback, type FetchOptions } from './http-client.js';
+
+// Utility functions
+export { parseBool, safeParseFloat, safeParseInt } from './utils.js';
+
+// Shape parsers - Symbol
+export {
+  parseSymbolPin,
+  parseSymbolRect,
+  parseSymbolCircle,
+  parseSymbolEllipse,
+  parseSymbolArc,
+  parseSymbolPolyline,
+  parseSymbolPolygon,
+  parseSymbolPath,
+  parseSymbolShapes,
+} from './easyeda-shapes.js';
+
+// Shape parsers - Footprint
+export {
+  parsePad,
+  parseTrack,
+  parseHole,
+  parseCircle,
+  parseArc,
+  parseRect,
+  parseVia,
+  parseText,
+  parseFootprintShapes,
+} from './easyeda-shapes.js';

package/src/parsers/utils.ts

@@ -0,0 +1,29 @@
+/**
+ * Shared parsing utilities for EasyEDA data
+ */
+
+/**
+ * Parse boolean from EasyEDA format
+ * Empty string = false, "0" = false, any other value = true
+ */
+export function parseBool(value: string | undefined): boolean {
+  return value !== undefined && value !== '' && value !== '0';
+}
+
+/**
+ * Safely parse float with default value
+ */
+export function safeParseFloat(value: string | undefined, defaultValue = 0): number {
+  if (value === undefined || value === '') return defaultValue;
+  const parsed = parseFloat(value);
+  return isNaN(parsed) ? defaultValue : parsed;
+}
+
+/**
+ * Safely parse int with default value
+ */
+export function safeParseInt(value: string | undefined, defaultValue = 0): number {
+  if (value === undefined || value === '') return defaultValue;
+  const parsed = parseInt(value, 10);
+  return isNaN(parsed) ? defaultValue : parsed;
+}

package/src/services/component-service.ts

@@ -0,0 +1,100 @@
+/**
+ * Component Service
+ * High-level API for searching and fetching components
+ */
+
+import type { ComponentSearchResult, EasyEDAComponentData, EasyEDACommunityComponent } from '../types/index.js';
+import { jlcClient } from '../api/jlc.js';
+import { easyedaClient } from '../api/easyeda.js';
+import { easyedaCommunityClient } from '../api/easyeda-community.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>;
+}
+
+/**
+ * Check if an ID is an LCSC part number (starts with C followed by digits)
+ */
+function isLcscId(id: string): boolean {
+  return /^C\d+$/.test(id);
+}
+
+export function createComponentService(): ComponentService {
+  return {
+    async search(query: string, options: SearchOptions = {}): Promise<ComponentSearchResult[]> {
+      const { source = 'lcsc', limit = 20, inStock, basicOnly } = options;
+
+      if (source === 'easyeda-community') {
+        const results = await easyedaCommunityClient.search({
+          query,
+          limit,
+        });
+        return results.map(r => ({
+          lcscId: r.uuid,
+          name: r.title,
+          manufacturer: r.owner?.nickname || 'Community',
+          description: r.description || '',
+          package: r.package || '',
+          stock: 0,
+        }));
+      }
+
+      return jlcClient.search(query, { limit, inStock, basicOnly });
+    },
+
+    async fetch(id: string): Promise<EasyEDAComponentData | null> {
+      if (isLcscId(id)) {
+        return easyedaClient.getComponentData(id);
+      }
+      // For community components, caller should use fetchCommunity and adapt
+      return null;
+    },
+
+    async fetchCommunity(uuid: string): Promise<EasyEDACommunityComponent | null> {
+      return easyedaCommunityClient.getComponent(uuid);
+    },
+
+    async getDetails(lcscId: string): Promise<ComponentDetails> {
+      const component = await easyedaClient.getComponentData(lcscId);
+      if (!component) {
+        throw new Error(`Component ${lcscId} not found`);
+      }
+
+      return {
+        lcscId,
+        name: component.info.name,
+        manufacturer: component.info.manufacturer || '',
+        description: component.info.description || '',
+        category: component.info.category || '',
+        package: component.info.package || '',
+        pinCount: component.symbol?.pins?.length || 0,
+        padCount: component.footprint?.pads?.length || 0,
+        has3DModel: !!component.model3d,
+        datasheet: component.info.datasheet,
+      };
+    },
+  };
+}

package/src/services/fix-service.ts

@@ -0,0 +1,50 @@
+/**
+ * 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 function createFixService(): FixService {
+  return {
+    async fix(_lcscId: string, _corrections: { pins?: PinCorrection[] }, _options: FixOptions = {}): Promise<FixResult> {
+      // TODO: Implement by re-fetching component, applying corrections, and regenerating
+      throw new Error('Fix service not yet implemented');
+    },
+  };
+}

package/src/services/index.ts

@@ -0,0 +1,9 @@
+/**
+ * High-level services for jlc-core
+ * Provides a clean API for common operations
+ */
+
+// Services will be implemented after core files are validated
+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';