npm - @jlcpcb/core - Versions diffs - 0.1.0 → 0.2.0 - Mend

@jlcpcb/core 0.1.0 → 0.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (114) hide show

package/CHANGELOG.md +33 -0
package/dist/api/easyeda-community.d.ts +36 -0
package/dist/api/easyeda-community.d.ts.map +1 -0
package/dist/api/easyeda.d.ts +23 -0
package/dist/api/easyeda.d.ts.map +1 -0
package/dist/api/index.d.ts +7 -0
package/dist/api/index.d.ts.map +1 -0
package/dist/api/jlc.d.ts +41 -0
package/dist/api/jlc.d.ts.map +1 -0
package/dist/assets/search.html +528 -0
package/dist/browser/index.d.ts +8 -0
package/dist/browser/index.d.ts.map +1 -0
package/dist/browser/kicad-renderer.d.ts +13 -0
package/dist/browser/kicad-renderer.d.ts.map +1 -0
package/dist/browser/sexpr-parser.d.ts +84 -0
package/dist/browser/sexpr-parser.d.ts.map +1 -0
package/dist/constants/design-rules.d.ts +34 -0
package/dist/constants/design-rules.d.ts.map +1 -0
package/dist/constants/footprints.d.ts +134 -0
package/dist/constants/footprints.d.ts.map +1 -0
package/dist/constants/index.d.ts +7 -0
package/dist/constants/index.d.ts.map +1 -0
package/dist/constants/kicad.d.ts +67 -0
package/dist/constants/kicad.d.ts.map +1 -0
package/dist/converter/category-router.d.ts +47 -0
package/dist/converter/category-router.d.ts.map +1 -0
package/dist/converter/footprint-mapper.d.ts +40 -0
package/dist/converter/footprint-mapper.d.ts.map +1 -0
package/dist/converter/footprint-mapper.test.d.ts +2 -0
package/dist/converter/footprint-mapper.test.d.ts.map +1 -0
package/dist/converter/footprint.d.ts +116 -0
package/dist/converter/footprint.d.ts.map +1 -0
package/dist/converter/global-lib-table.d.ts +29 -0
package/dist/converter/global-lib-table.d.ts.map +1 -0
package/dist/converter/index.d.ts +12 -0
package/dist/converter/index.d.ts.map +1 -0
package/dist/converter/lib-table.d.ts +61 -0
package/dist/converter/lib-table.d.ts.map +1 -0
package/dist/converter/svg-arc.d.ts +45 -0
package/dist/converter/svg-arc.d.ts.map +1 -0
package/dist/converter/symbol-templates.d.ts +34 -0
package/dist/converter/symbol-templates.d.ts.map +1 -0
package/dist/converter/symbol.d.ts +223 -0
package/dist/converter/symbol.d.ts.map +1 -0
package/dist/converter/value-normalizer.d.ts +33 -0
package/dist/converter/value-normalizer.d.ts.map +1 -0
package/dist/http/index.d.ts +5 -0
package/dist/http/index.d.ts.map +1 -0
package/dist/http/routes.d.ts +12 -0
package/dist/http/routes.d.ts.map +1 -0
package/dist/http/server.d.ts +18 -0
package/dist/http/server.d.ts.map +1 -0
package/dist/index.d.ts +13 -0
package/dist/index.d.ts.map +1 -0
package/dist/index.js +9633 -0
package/dist/parsers/easyeda-shapes.d.ts +115 -0
package/dist/parsers/easyeda-shapes.d.ts.map +1 -0
package/dist/parsers/http-client.d.ts +16 -0
package/dist/parsers/http-client.d.ts.map +1 -0
package/dist/parsers/index.d.ts +11 -0
package/dist/parsers/index.d.ts.map +1 -0
package/dist/parsers/utils.d.ts +17 -0
package/dist/parsers/utils.d.ts.map +1 -0
package/dist/services/component-service.d.ts +31 -0
package/dist/services/component-service.d.ts.map +1 -0
package/dist/services/fix-service.d.ts +40 -0
package/dist/services/fix-service.d.ts.map +1 -0
package/dist/services/index.d.ts +8 -0
package/dist/services/index.d.ts.map +1 -0
package/dist/services/library-service.d.ts +112 -0
package/dist/services/library-service.d.ts.map +1 -0
package/dist/types/component.d.ts +56 -0
package/dist/types/component.d.ts.map +1 -0
package/dist/types/easyeda-community.d.ts +74 -0
package/dist/types/easyeda-community.d.ts.map +1 -0
package/dist/types/easyeda.d.ts +326 -0
package/dist/types/easyeda.d.ts.map +1 -0
package/dist/types/index.d.ts +12 -0
package/dist/types/index.d.ts.map +1 -0
package/dist/types/jlc.d.ts +78 -0
package/dist/types/jlc.d.ts.map +1 -0
package/dist/types/kicad.d.ts +141 -0
package/dist/types/kicad.d.ts.map +1 -0
package/dist/types/mcp.d.ts +66 -0
package/dist/types/mcp.d.ts.map +1 -0
package/dist/types/project.d.ts +60 -0
package/dist/types/project.d.ts.map +1 -0
package/dist/utils/conversion.d.ts +59 -0
package/dist/utils/conversion.d.ts.map +1 -0
package/dist/utils/file-system.d.ts +59 -0
package/dist/utils/file-system.d.ts.map +1 -0
package/dist/utils/index.d.ts +8 -0
package/dist/utils/index.d.ts.map +1 -0
package/dist/utils/logger.d.ts +26 -0
package/dist/utils/logger.d.ts.map +1 -0
package/dist/utils/validation.d.ts +259 -0
package/dist/utils/validation.d.ts.map +1 -0
package/package.json +5 -3
package/scripts/build-search-page.ts +68 -0
package/src/assets/search-built.html +528 -0
package/src/assets/search.html +458 -0
package/src/browser/index.ts +389 -0
package/src/browser/kicad-renderer.ts +813 -0
package/src/browser/sexpr-parser.ts +333 -0
package/src/converter/footprint-mapper.test.ts +159 -0
package/src/converter/footprint-mapper.ts +42 -134
package/src/converter/footprint.ts +208 -36
package/src/converter/global-lib-table.ts +71 -0
package/src/http/index.ts +5 -0
package/src/http/routes.ts +266 -0
package/src/http/server.ts +83 -0
package/src/index.ts +3 -0
package/src/parsers/easyeda-shapes.ts +2 -1
package/src/services/library-service.ts +73 -22

package/src/http/routes.ts ADDED Viewed

@@ -0,0 +1,266 @@
+/**
+ * HTTP routes for the EasyEDA Component Browser
+ * Handles serving the HTML page and proxying API requests
+ *
+ * Returns KiCad S-expression strings for symbol/footprint preview rendering
+ */
+import { readFileSync } from 'fs'
+import { join, dirname } from 'path'
+import { fileURLToPath } from 'url'
+import type { IncomingMessage, ServerResponse } from 'http'
+import { createLogger } from '../utils/logger.js'
+import type { EasyEDAComponentData, EasyEDACommunityComponent } from '../types/index.js'
+import { easyedaCommunityClient } from '../api/easyeda-community.js'
+import { symbolConverter } from '../converter/symbol.js'
+import { footprintConverter } from '../converter/footprint.js'
+const logger = createLogger('http-routes')
+// Get the directory of this file to find assets
+const __filename = fileURLToPath(import.meta.url)
+const __dirname = dirname(__filename)
+// Cache the HTML content in memory
+let htmlCache: string | null = null
+/**
+ * Load the HTML page from the assets directory
+ */
+function getHtmlPage(): string {
+  if (htmlCache) return htmlCache
+  try {
+    // When bundled, __dirname points to dist/ since everything is in index.js
+    // When running from source, __dirname is src/http/
+    const possiblePaths = [
+      // Bundled: dist/index.js looking for dist/assets/search.html
+      join(__dirname, 'assets/search.html'),
+      // Bundled alternative path
+      join(__dirname, '../dist/assets/search.html'),
+      // Source: src/http/ looking for src/assets/
+      join(__dirname, '../assets/search.html'),
+      join(__dirname, '../assets/search-built.html'),
+      // From project root (core package)
+      join(process.cwd(), 'dist/assets/search.html'),
+      join(process.cwd(), 'packages/core/dist/assets/search.html'),
+      // When imported from other packages
+      join(__dirname, '../../dist/assets/search.html'),
+      // When bundled into CLI or other package, look for core's assets relative to monorepo
+      join(__dirname, '../../../core/dist/assets/search.html'),
+      join(__dirname, '../../../../packages/core/dist/assets/search.html'),
+      // Look in node_modules if installed as dependency
+      join(__dirname, '../../node_modules/@jlcpcb/core/dist/assets/search.html'),
+    ]
+    for (const path of possiblePaths) {
+      try {
+        htmlCache = readFileSync(path, 'utf-8')
+        logger.debug(`Loaded HTML from: ${path}`)
+        return htmlCache
+      } catch {
+        // Try next path
+      }
+    }
+    throw new Error('HTML file not found')
+  } catch (error) {
+    logger.error('Failed to load HTML page:', error)
+    return `<!DOCTYPE html>
+<html>
+<head><title>Error</title></head>
+<body>
+<h1>Error: Search page not found</h1>
+<p>The search page has not been built. Run: bun run build</p>
+</body>
+</html>`
+  }
+}
+/**
+ * Main request handler
+ */
+export async function handleRequest(
+  req: IncomingMessage,
+  res: ServerResponse
+): Promise<void> {
+  const url = new URL(req.url || '/', `http://${req.headers.host || 'localhost'}`)
+  const pathname = url.pathname
+  logger.debug(`${req.method} ${pathname}`)
+  // Route requests
+  if (pathname === '/' || pathname === '/index.html') {
+    const query = url.searchParams.get('q') || undefined
+    serveHtml(res, query)
+  } else if (pathname === '/api/search') {
+    await handleSearch(url, res)
+  } else if (pathname.startsWith('/api/component/')) {
+    const uuid = pathname.replace('/api/component/', '')
+    await handleComponent(uuid, res)
+  } else if (pathname === '/health') {
+    res.writeHead(200, { 'Content-Type': 'application/json' })
+    res.end(JSON.stringify({ status: 'ok' }))
+  } else {
+    res.writeHead(404, { 'Content-Type': 'application/json' })
+    res.end(JSON.stringify({ error: 'Not found' }))
+  }
+}
+/**
+ * Serve the HTML page with optional initial query injection
+ */
+function serveHtml(res: ServerResponse, initialQuery?: string): void {
+  let html = getHtmlPage()
+  if (initialQuery) {
+    // Inject initial query via a script tag before </head>
+    const script = `<script>window.__INITIAL_QUERY__ = ${JSON.stringify(initialQuery)};</script>`
+    html = html.replace('</head>', `${script}</head>`)
+  }
+  res.writeHead(200, { 'Content-Type': 'text/html; charset=utf-8' })
+  res.end(html)
+}
+/**
+ * Handle search API requests
+ * GET /api/search?q=query&source=user|lcsc|all&page=1&limit=20
+ */
+async function handleSearch(
+  url: URL,
+  res: ServerResponse
+): Promise<void> {
+  const query = url.searchParams.get('q') || ''
+  const source = url.searchParams.get('source') || 'user'
+  const page = parseInt(url.searchParams.get('page') || '1', 10)
+  const limit = parseInt(url.searchParams.get('limit') || '20', 10)
+  if (!query) {
+    res.writeHead(400, { 'Content-Type': 'application/json' })
+    res.end(JSON.stringify({ error: 'Missing query parameter' }))
+    return
+  }
+  try {
+    // Fetch more than we need for pagination (EasyEDA doesn't support offset)
+    const allResults = await easyedaCommunityClient.search({
+      query,
+      source: source as 'user' | 'lcsc' | 'easyeda' | 'all',
+      limit: Math.min(limit * page + limit, 100), // Max 100 results
+    })
+    // Calculate pagination
+    const startIndex = (page - 1) * limit
+    const endIndex = startIndex + limit
+    const results = allResults.slice(startIndex, endIndex)
+    const totalPages = Math.ceil(allResults.length / limit)
+    res.writeHead(200, { 'Content-Type': 'application/json' })
+    res.end(JSON.stringify({
+      results,
+      pagination: {
+        page,
+        limit,
+        total: allResults.length,
+        totalPages,
+        hasNext: page < totalPages,
+        hasPrev: page > 1,
+      },
+    }))
+  } catch (error) {
+    logger.error('Search error:', error)
+    res.writeHead(500, { 'Content-Type': 'application/json' })
+    res.end(JSON.stringify({ error: 'Search failed' }))
+  }
+}
+/**
+ * Convert EasyEDACommunityComponent to EasyEDAComponentData format
+ * Required because converters expect the LCSC-style structure
+ */
+function communityToComponentData(
+  community: EasyEDACommunityComponent
+): EasyEDAComponentData {
+  // Extract component info from the head c_para
+  const cPara = community.symbol.head?.c_para as Record<string, string> | undefined ?? {}
+  const fpCPara = community.footprint.head?.c_para as Record<string, string> | undefined ?? {}
+  return {
+    info: {
+      name: community.title || cPara.name || 'Unknown',
+      prefix: cPara.pre || cPara.Prefix || 'U',
+      package: fpCPara.package || community.footprint.name,
+      manufacturer: cPara.Manufacturer || cPara.BOM_Manufacturer,
+      description: community.description || cPara.BOM_Manufacturer_Part,
+      category: cPara.package, // Best guess for category
+    },
+    symbol: community.symbol,
+    footprint: community.footprint,
+    model3d: community.model3d,
+    rawData: community.rawData,
+  }
+}
+/**
+ * Handle component fetch API requests
+ * GET /api/component/:uuid
+ *
+ * Returns KiCad S-expression strings for browser-side rendering
+ */
+async function handleComponent(
+  uuid: string,
+  res: ServerResponse
+): Promise<void> {
+  if (!uuid) {
+    res.writeHead(400, { 'Content-Type': 'application/json' })
+    res.end(JSON.stringify({ error: 'Missing UUID' }))
+    return
+  }
+  try {
+    const component = await easyedaCommunityClient.getComponent(uuid)
+    if (!component) {
+      res.writeHead(404, { 'Content-Type': 'application/json' })
+      res.end(JSON.stringify({ error: 'Component not found' }))
+      return
+    }
+    // Convert community component to converter-compatible format
+    const componentData = communityToComponentData(component)
+    // Generate KiCad S-expression strings using existing converters
+    let symbolSexpr = ''
+    let footprintSexpr = ''
+    try {
+      // Get just the symbol entry (not the full library wrapper)
+      symbolSexpr = symbolConverter.convertToSymbolEntry(componentData)
+    } catch (e) {
+      logger.warn('Symbol conversion failed:', e)
+    }
+    try {
+      footprintSexpr = footprintConverter.convert(componentData)
+    } catch (e) {
+      logger.warn('Footprint conversion failed:', e)
+    }
+    // Return S-expr strings for browser rendering
+    res.writeHead(200, { 'Content-Type': 'application/json' })
+    res.end(JSON.stringify({
+      uuid: component.uuid,
+      title: component.title,
+      description: component.description,
+      owner: component.owner,
+      symbolSexpr,
+      footprintSexpr,
+      model3d: component.model3d,
+    }))
+  } catch (error) {
+    logger.error('Component fetch error:', error)
+    res.writeHead(500, { 'Content-Type': 'application/json' })
+    res.end(JSON.stringify({ error: 'Failed to fetch component' }))
+  }
+}

package/src/http/server.ts ADDED Viewed

@@ -0,0 +1,83 @@
+/**
+ * HTTP server for the EasyEDA Component Browser
+ * Runs alongside the MCP stdio server to serve the web UI and proxy API requests
+ */
+import { createServer, type IncomingMessage, type ServerResponse } from 'http'
+import { createLogger } from '../utils/logger.js'
+import { handleRequest } from './routes.js'
+const logger = createLogger('http-server')
+const DEFAULT_PORT = 3847
+let serverInstance: ReturnType<typeof createServer> | null = null
+export interface HttpServerOptions {
+  port?: number
+  onReady?: (url: string) => void
+}
+/**
+ * Start the HTTP server
+ * @returns The port the server is listening on
+ */
+export function startHttpServer(options: HttpServerOptions = {}): number {
+  if (serverInstance) {
+    logger.debug('HTTP server already running')
+    const port = options.port ?? parseInt(process.env.JLC_MCP_HTTP_PORT || String(DEFAULT_PORT), 10)
+    options.onReady?.(`http://localhost:${port}`)
+    return port
+  }
+  const port = options.port ?? parseInt(process.env.JLC_MCP_HTTP_PORT || String(DEFAULT_PORT), 10)
+  serverInstance = createServer(async (req: IncomingMessage, res: ServerResponse) => {
+    // Add CORS headers to all responses
+    res.setHeader('Access-Control-Allow-Origin', '*')
+    res.setHeader('Access-Control-Allow-Methods', 'GET, POST, OPTIONS')
+    res.setHeader('Access-Control-Allow-Headers', 'Content-Type')
+    // Handle preflight requests
+    if (req.method === 'OPTIONS') {
+      res.writeHead(204)
+      res.end()
+      return
+    }
+    try {
+      await handleRequest(req, res)
+    } catch (error) {
+      logger.error('Request error:', error)
+      res.writeHead(500, { 'Content-Type': 'application/json' })
+      res.end(JSON.stringify({ error: 'Internal server error' }))
+    }
+  })
+  serverInstance.listen(port, () => {
+    const url = `http://localhost:${port}`
+    logger.info(`HTTP server listening on ${url}`)
+    options.onReady?.(url)
+  })
+  serverInstance.on('error', (error: NodeJS.ErrnoException) => {
+    if (error.code === 'EADDRINUSE') {
+      logger.warn(`Port ${port} already in use, HTTP server not started`)
+    } else {
+      logger.error('HTTP server error:', error)
+    }
+  })
+  return port
+}
+/**
+ * Stop the HTTP server
+ */
+export function stopHttpServer(): void {
+  if (serverInstance) {
+    serverInstance.close()
+    serverInstance = null
+    logger.info('HTTP server stopped')
+  }
+}

package/src/index.ts CHANGED Viewed

@@ -23,3 +23,6 @@ export * from './constants/index.js';
 // Parsers
 export * from './parsers/index.js';
+// HTTP Server
+export * from './http/index.js';

package/src/parsers/easyeda-shapes.ts CHANGED Viewed

@@ -609,7 +609,8 @@ export function parseFootprintShapes(shapes: string[]): ParsedFootprintData {
   }
   // Determine type based on pads
-  const type = pads.some(p => p.holeRadius > 0) ? 'tht' : 'smd';
+  // Check both holeRadius > 0 and isPlated polygon pads (EasyEDA often has holeRadius=0 for polygon THT)
+  const type = pads.some(p => p.holeRadius > 0 || (p.shape === 'POLYGON' && p.isPlated)) ? 'tht' : 'smd';
   return {
     name: 'Unknown', // Will be set by caller

package/src/services/library-service.ts CHANGED Viewed

@@ -38,12 +38,18 @@ const LIBRARY_NAMESPACE = 'jlc_mcp';
 // KiCad versions to check
 const KICAD_VERSIONS = ['9.0', '8.0'];
-// EasyEDA community library naming
+// EasyEDA community library naming (global)
 const EASYEDA_LIBRARY_NAME = 'EasyEDA';
 const EASYEDA_SYMBOL_LIBRARY_NAME = 'EasyEDA.kicad_sym';
 const EASYEDA_FOOTPRINT_LIBRARY_NAME = 'EasyEDA.pretty';
 const EASYEDA_LIBRARY_DESCRIPTION = 'EasyEDA Community Component Library';
+// EasyEDA community library naming (project-local) - different name to avoid collision
+const EASYEDA_LOCAL_LIBRARY_NAME = 'EasyEDA-local';
+const EASYEDA_LOCAL_SYMBOL_LIBRARY_NAME = 'EasyEDA-local.kicad_sym';
+const EASYEDA_LOCAL_FOOTPRINT_LIBRARY_NAME = 'EasyEDA-local.pretty';
+const EASYEDA_LOCAL_LIBRARY_DESCRIPTION = 'EasyEDA Community Component Library (Project-local)';
 export interface InstallOptions {
   projectPath?: string;
   include3d?: boolean;
@@ -144,6 +150,7 @@ export interface LibraryService {
   update(options?: UpdateOptions): Promise<UpdateResult>;
   ensureGlobalTables(): Promise<void>;
   getStatus(): Promise<LibraryStatus>;
+  isEasyEDAInstalled(componentName: string): Promise<boolean>;
 }
 interface LibraryPaths {
@@ -335,13 +342,8 @@ export function createLibraryService(): LibraryService {
     async install(id: string, options: InstallOptions = {}): Promise<InstallResult> {
       const isCommunityComponent = !isLcscId(id);
-      // Community components require projectPath
-      if (isCommunityComponent && !options.projectPath) {
-        throw new Error('EasyEDA community components require projectPath for local storage');
-      }
-      // Determine storage location
-      const isGlobal = !isCommunityComponent && !options.projectPath;
+      // Determine storage location (global if no projectPath provided)
+      const isGlobal = !options.projectPath;
       const paths = isGlobal
         ? getGlobalLibraryPaths()
         : getProjectLibraryPaths(options.projectPath!);
@@ -397,16 +399,35 @@ export function createLibraryService(): LibraryService {
       let modelPath: string | undefined;
       if (isCommunityComponent) {
-        // EasyEDA community component → project-local EasyEDA library
-        const librariesDir = join(options.projectPath!, 'libraries');
-        const symbolsDir = join(librariesDir, 'symbols');
-        footprintDir = join(librariesDir, 'footprints', EASYEDA_FOOTPRINT_LIBRARY_NAME);
-        models3dDir = join(librariesDir, '3dmodels', 'EasyEDA.3dshapes');
+        // EasyEDA community component → EasyEDA library (global or project-local)
+        // Use different library names to avoid collision
+        const libName = isGlobal ? EASYEDA_LIBRARY_NAME : EASYEDA_LOCAL_LIBRARY_NAME;
+        const symLibFile = isGlobal ? EASYEDA_SYMBOL_LIBRARY_NAME : EASYEDA_LOCAL_SYMBOL_LIBRARY_NAME;
+        const fpLibDir = isGlobal ? EASYEDA_FOOTPRINT_LIBRARY_NAME : EASYEDA_LOCAL_FOOTPRINT_LIBRARY_NAME;
+        const libDesc = isGlobal ? EASYEDA_LIBRARY_DESCRIPTION : EASYEDA_LOCAL_LIBRARY_DESCRIPTION;
+        const models3dDirName = isGlobal ? 'EasyEDA.3dshapes' : 'EasyEDA-local.3dshapes';
+        let symbolsDir: string;
+        let easyedaModelsDir: string;
+        if (isGlobal) {
+          // Global: use KiCad 3rd party directory
+          symbolsDir = paths.symbolsDir;
+          footprintDir = join(paths.footprintsDir, fpLibDir);
+          easyedaModelsDir = join(paths.models3dDir, models3dDirName);
+        } else {
+          // Project-local
+          const librariesDir = join(options.projectPath!, 'libraries');
+          symbolsDir = join(librariesDir, 'symbols');
+          footprintDir = join(librariesDir, 'footprints', fpLibDir);
+          easyedaModelsDir = join(librariesDir, '3dmodels', models3dDirName);
+        }
+        models3dDir = easyedaModelsDir;
         await ensureDir(symbolsDir);
         await ensureDir(footprintDir);
-        symbolFile = join(symbolsDir, EASYEDA_SYMBOL_LIBRARY_NAME);
+        symbolFile = join(symbolsDir, symLibFile);
         symbolName = component.info.name.replace(/[^a-zA-Z0-9_-]/g, '_');
         // Download 3D model first if available (needed for footprint generation)
@@ -421,28 +442,38 @@ export function createLibraryService(): LibraryService {
             const modelFilename = `${symbolName}.step`;
             modelPath = join(models3dDir, modelFilename);
             await writeBinary(modelPath, model);
-            // Use relative path for project-local libraries
-            modelRelativePath = `\${KIPRJMOD}/libraries/3dmodels/EasyEDA.3dshapes/${modelFilename}`;
+            // Use appropriate path variable
+            if (isGlobal) {
+              modelRelativePath = `\${KICAD9_3RD_PARTY}/${LIBRARY_NAMESPACE}/3dmodels/${models3dDirName}/${modelFilename}`;
+            } else {
+              modelRelativePath = `\${KIPRJMOD}/libraries/3dmodels/${models3dDirName}/${modelFilename}`;
+            }
           }
         }
         // Generate custom footprint with 3D model
         const footprint = footprintConverter.convert(component, {
-          libraryName: EASYEDA_LIBRARY_NAME,
+          libraryName: libName,
           include3DModel: !!modelRelativePath,
           modelPath: modelRelativePath,
         });
         footprintPath = join(footprintDir, `${symbolName}.kicad_mod`);
-        footprintRef = `${EASYEDA_LIBRARY_NAME}:${symbolName}`;
+        footprintRef = `${libName}:${symbolName}`;
         await writeText(footprintPath, footprint);
         component.info.package = footprintRef;
-        // Update lib tables
-        await ensureSymLibTable(options.projectPath!, symbolFile, EASYEDA_LIBRARY_NAME, EASYEDA_LIBRARY_DESCRIPTION);
-        await ensureFpLibTable(options.projectPath!, footprintDir, EASYEDA_LIBRARY_NAME, EASYEDA_LIBRARY_DESCRIPTION);
+        // Update lib tables (global or project-local)
+        if (isGlobal) {
+          // For global, use the global lib table registration
+          const { ensureGlobalEasyEDALibrary } = await import('../converter/global-lib-table.js');
+          await ensureGlobalEasyEDALibrary();
+        } else {
+          await ensureSymLibTable(options.projectPath!, symbolFile, libName, libDesc);
+          await ensureFpLibTable(options.projectPath!, footprintDir, libName, libDesc);
+        }
-        symbolRef = `${EASYEDA_LIBRARY_NAME}:${symbolName}`;
+        symbolRef = `${libName}:${symbolName}`;
       } else {
         // LCSC component → JLC-MCP category-based library
         category = getLibraryCategory(
@@ -692,5 +723,25 @@ export function createLibraryService(): LibraryService {
         },
       };
     },
+    async isEasyEDAInstalled(componentName: string): Promise<boolean> {
+      const paths = getGlobalLibraryPaths();
+      const easyedaLibPath = join(paths.symbolsDir, EASYEDA_SYMBOL_LIBRARY_NAME);
+      if (!existsSync(easyedaLibPath)) {
+        return false;
+      }
+      try {
+        const content = await readFile(easyedaLibPath, 'utf-8');
+        // Sanitize the name the same way we do when installing
+        const sanitizedName = componentName.replace(/[^a-zA-Z0-9_-]/g, '_');
+        // Check if symbol exists in library
+        const pattern = new RegExp(`\\(symbol\\s+"${sanitizedName}"`, 'm');
+        return pattern.test(content);
+      } catch {
+        return false;
+      }
+    },
   };
 }