@jlcpcb/cli 0.3.2 → 0.4.0

package/dist/index.js

@@ -861,7 +861,7 @@ Expecting one of '${allowedValues.join("', '")}'`);
         this._exitCallback = (err) => {
           if (err.code !== "commander.executeSubCommandAsync") {
             throw err;
-          } else {}
+          }
         };
       }
       return this;
@@ -9687,7 +9687,7 @@ Learn more about data fetching with Hooks: https://react.dev/link/hooks-data-fet
           offscreenSubtreeIsHidden = prevOffscreenSubtreeIsHidden;
           wasHidden && !hoistableRoot && !prevOffscreenSubtreeIsHidden && !prevOffscreenSubtreeWasHidden && (finishedWork.mode & 2) !== NoMode && 0 <= componentEffectStartTime && 0 <= componentEffectEndTime && 0.05 < componentEffectEndTime - componentEffectStartTime && logComponentReappeared(finishedWork, componentEffectStartTime, componentEffectEndTime);
           commitReconciliationEffects(finishedWork);
-          if (flags & 8192 && (root = finishedWork.stateNode, root._visibility = hoistableRoot ? root._visibility & ~OffscreenVisible : root._visibility | OffscreenVisible, !hoistableRoot || current2 === null || wasHidden || offscreenSubtreeIsHidden || offscreenSubtreeWasHidden || (recursivelyTraverseDisappearLayoutEffects(finishedWork), (finishedWork.mode & 2) !== NoMode && 0 <= componentEffectStartTime && 0 <= componentEffectEndTime && 0.05 < componentEffectEndTime - componentEffectStartTime && logComponentTrigger(finishedWork, componentEffectStartTime, componentEffectEndTime, "Disconnect")), supportsMutation))
+          if (flags & 8192 && (root = finishedWork.stateNode, root._visibility = hoistableRoot ? root._visibility & ~OffscreenVisible : root._visibility | OffscreenVisible, !hoistableRoot || current2 === null || wasHidden || offscreenSubtreeIsHidden || offscreenSubtreeWasHidden || (recursivelyTraverseDisappearLayoutEffects(finishedWork), (finishedWork.mode & 2) !== NoMode && 0 <= componentEffectStartTime && 0 <= componentEffectEndTime && 0.05 < componentEffectEndTime - componentEffectStartTime && logComponentTrigger(finishedWork, componentEffectStartTime, componentEffectEndTime, "Disconnect")), supportsMutation)) {
             a:
               if (current2 = null, supportsMutation)
                 for (root = finishedWork;; ) {
@@ -9737,6 +9737,7 @@ Learn more about data fetching with Hooks: https://react.dev/link/hooks-data-fet
                   root.sibling.return = root.return;
                   root = root.sibling;
                 }
+          }
           flags & 4 && (flags = finishedWork.updateQueue, flags !== null && (current2 = flags.retryQueue, current2 !== null && (flags.retryQueue = null, attachSuspenseRetryListeners(finishedWork, current2))));
           break;
         case 19:
@@ -17250,7 +17251,7 @@ var require_backend = __commonJS((exports, module) => {
         987: (module2, __unused_webpack_exports, __webpack_require__2) => {
           if (true) {
             module2.exports = __webpack_require__2(786);
-          } else {}
+          }
         },
         126: (__unused_webpack_module, exports2, __webpack_require__2) => {
           var process3 = __webpack_require__2(169);
@@ -17700,7 +17701,7 @@ var require_backend = __commonJS((exports, module) => {
         189: (module2, __unused_webpack_exports, __webpack_require__2) => {
           if (true) {
             module2.exports = __webpack_require__2(126);
-          } else {}
+          }
         },
         206: function(module2, exports2, __webpack_require__2) {
           var __WEBPACK_AMD_DEFINE_FACTORY__, __WEBPACK_AMD_DEFINE_ARRAY__, __WEBPACK_AMD_DEFINE_RESULT__;
@@ -17715,7 +17716,7 @@ var require_backend = __commonJS((exports, module) => {
           (function(root, factory) {
             if (true) {
               __WEBPACK_AMD_DEFINE_ARRAY__ = [__webpack_require__2(430)], __WEBPACK_AMD_DEFINE_FACTORY__ = factory, __WEBPACK_AMD_DEFINE_RESULT__ = typeof __WEBPACK_AMD_DEFINE_FACTORY__ === "function" ? __WEBPACK_AMD_DEFINE_FACTORY__.apply(exports2, __WEBPACK_AMD_DEFINE_ARRAY__) : __WEBPACK_AMD_DEFINE_FACTORY__, __WEBPACK_AMD_DEFINE_RESULT__ !== undefined && (module2.exports = __WEBPACK_AMD_DEFINE_RESULT__);
-            } else {}
+            }
           })(this, function ErrorStackParser(StackFrame) {
             var FIREFOX_SAFARI_STACK_REGEXP = /(^|@)\S+:\d+/;
             var CHROME_IE_STACK_REGEXP = /^\s*at .*(\S+:\d+|\(native\))/m;
@@ -18411,7 +18412,7 @@ var require_backend = __commonJS((exports, module) => {
           (function(root, factory) {
             if (true) {
               __WEBPACK_AMD_DEFINE_ARRAY__ = [], __WEBPACK_AMD_DEFINE_FACTORY__ = factory, __WEBPACK_AMD_DEFINE_RESULT__ = typeof __WEBPACK_AMD_DEFINE_FACTORY__ === "function" ? __WEBPACK_AMD_DEFINE_FACTORY__.apply(exports2, __WEBPACK_AMD_DEFINE_ARRAY__) : __WEBPACK_AMD_DEFINE_FACTORY__, __WEBPACK_AMD_DEFINE_RESULT__ !== undefined && (module2.exports = __WEBPACK_AMD_DEFINE_RESULT__);
-            } else {}
+            }
           })(this, function() {
             function _isNumber(n) {
               return !isNaN(parseFloat(n)) && isFinite(n);
@@ -23785,7 +23786,7 @@ In order to be iterable, non-array objects must have a [Symbol.iterator]() metho
           var suffix = "";
           if (true) {
             suffix = " (<anonymous>)";
-          } else {}
+          }
           return `
 ` + prefix + name + suffix;
         }
@@ -26514,7 +26515,7 @@ In order to be iterable, non-array objects must have a [Symbol.iterator]() metho
                     hasChanges = true;
                     updateMostRecentlyInspectedElementIfNecessary(devtoolsInstance.id);
                   }
-                } else {}
+                }
               }
             } catch (err) {
               _iterator2.e(err);
@@ -28293,7 +28294,7 @@ In order to be iterable, non-array objects must have a [Symbol.iterator]() metho
                       if (contentFiber === null) {
                         throw new Error("There should always be an Offscreen Fiber child in a hydrated Suspense boundary.");
                       }
-                    } else {}
+                    }
                     var _isTimedOut = fiber.memoizedState !== null;
                     if (!_isTimedOut) {
                       newSuspenseNode.rects = measureInstance(newInstance);
@@ -28327,7 +28328,7 @@ In order to be iterable, non-array objects must have a [Symbol.iterator]() metho
                     if (_contentFiber === null) {
                       throw new Error("There should always be an Offscreen Fiber child in a hydrated Suspense boundary.");
                     }
-                  } else {}
+                  }
                   var suspenseState = fiber.memoizedState;
                   var _isTimedOut3 = suspenseState !== null;
                   if (!_isTimedOut3) {
@@ -28427,7 +28428,7 @@ In order to be iterable, non-array objects must have a [Symbol.iterator]() metho
                   trackThrownPromisesFromRetryCache(newSuspenseNode, fiber.stateNode);
                   mountSuspenseChildrenRecursively(_contentFiber2, traceNearestHostComponentUpdate, stashedSuspenseParent, stashedSuspensePrevious, stashedSuspenseRemaining);
                   shouldPopSuspenseNode = false;
-                } else {}
+                }
               } else {
                 if (fiber.child !== null) {
                   mountChildrenRecursively(fiber.child, traceNearestHostComponentUpdate);
@@ -29013,7 +29014,7 @@ In order to be iterable, non-array objects must have a [Symbol.iterator]() metho
                   shouldPopSuspenseNode = false;
                 } else if (previousHydrated && !nextHydrated) {
                   throw new Error("Encountered a dehydrated Suspense boundary that was previously hydrated.");
-                } else {}
+                }
               } else {
                 if (nextFiber.child !== prevFiber.child) {
                   updateFlags |= updateChildrenRecursively(nextFiber.child, prevFiber.child, traceNearestHostComponentUpdate);
@@ -29059,8 +29060,8 @@ In order to be iterable, non-array objects must have a [Symbol.iterator]() metho
                     recordResetChildren(fiberInstance);
                   }
                   updateFlags &= ~ShouldResetChildren;
-                } else {}
-              } else {}
+                }
+              }
               if ((updateFlags & ShouldResetSuspenseChildren) !== NoUpdate) {
                 if (fiberInstance !== null && fiberInstance.kind === FIBER_INSTANCE) {
                   var _suspenseNode3 = fiberInstance.suspenseNode;
@@ -29068,7 +29069,7 @@ In order to be iterable, non-array objects must have a [Symbol.iterator]() metho
                     recordResetSuspenseChildren(_suspenseNode3);
                     updateFlags &= ~ShouldResetSuspenseChildren;
                   }
-                } else {}
+                }
               }
               if ((updateFlags & ShouldResetParentSuspenseChildren) !== NoUpdate) {
                 if (fiberInstance !== null && fiberInstance.kind === FIBER_INSTANCE) {
@@ -29077,7 +29078,7 @@ In order to be iterable, non-array objects must have a [Symbol.iterator]() metho
                     updateFlags &= ~ShouldResetParentSuspenseChildren;
                     updateFlags |= ShouldResetSuspenseChildren;
                   }
-                } else {}
+                }
               }
               return updateFlags;
             } finally {
@@ -32141,7 +32142,7 @@ The error thrown in the component is:
               rendererInterface = renderer_attach(hook, id, renderer, global2, shouldStartProfilingNow, profilingSettings);
             } else if (renderer.ComponentTree) {
               rendererInterface = legacy_renderer_attach(hook, id, renderer, global2);
-            } else {}
+            }
           }
           return rendererInterface;
         }
@@ -34089,6 +34090,9 @@ var {
   Help
 } = import__.default;
 
+// src/index.ts
+import { createRequire as createRequire2 } from "module";
+
 // ../core/dist/index.js
 import { readFile as readFile2, writeFile as writeFile2 } from "fs/promises";
 import { existsSync as existsSync2 } from "fs";
@@ -34102,7 +34106,7 @@ import { join, dirname, extname, basename } from "path";
 import { existsSync } from "fs";
 import { homedir, platform } from "os";
 import { join as join2 } from "path";
-import { execSync } from "child_process";
+import { execFileSync } from "child_process";
 import { existsSync as existsSync4 } from "fs";
 import { readFile as readFile4, readdir as readdir2, unlink } from "fs/promises";
 import { homedir as homedir3, platform as platform3 } from "os";
@@ -39235,6 +39239,8 @@ class JLCClient {
       const components = data.data?.componentPageInfo?.list || [];
       logger3.debug(`Found ${components.length} components`);
       return components.map((c) => ({
+        id: c.componentCode,
+        idType: "lcsc",
         lcscId: c.componentCode,
         name: c.componentModelEn,
         manufacturer: c.componentBrandEn,
@@ -39281,6 +39287,7 @@ var jlcClient = new JLCClient;
 var logger4 = createLogger("http-client");
 async function fetchWithCurlFallback(url, options = {}) {
   const method = options.method || "GET";
+  const timeoutMs = options.timeoutMs ?? 30000;
   const headers = {
     Accept: "application/json",
     "User-Agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36"
@@ -39288,10 +39295,13 @@ async function fetchWithCurlFallback(url, options = {}) {
   if (options.contentType) {
     headers["Content-Type"] = options.contentType;
   }
+  const controller = new AbortController;
+  const timeout = setTimeout(() => controller.abort(), timeoutMs);
   try {
     const fetchOptions = {
       method,
-      headers
+      headers,
+      signal: controller.signal
     };
     if (options.body) {
       fetchOptions.body = options.body;
@@ -39305,26 +39315,28 @@ async function fetchWithCurlFallback(url, options = {}) {
     }
   } catch (error) {
     logger4.debug(`Native fetch failed, falling back to curl: ${error}`);
+  } finally {
+    clearTimeout(timeout);
   }
   try {
-    const curlArgs = ["curl", "-s"];
+    const curlArgs = ["-sS", "--max-time", String(Math.ceil(timeoutMs / 1000))];
     if (method === "POST") {
       curlArgs.push("-X", "POST");
     }
-    curlArgs.push("-H", '"Accept: application/json"');
-    curlArgs.push("-H", '"User-Agent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7)"');
+    curlArgs.push("-H", "Accept: application/json");
+    curlArgs.push("-H", "User-Agent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7)");
     if (options.contentType) {
-      curlArgs.push("-H", `"Content-Type: ${options.contentType}"`);
+      curlArgs.push("-H", `Content-Type: ${options.contentType}`);
     }
     if (options.body) {
-      curlArgs.push("-d", `'${options.body}'`);
+      curlArgs.push("-d", options.body);
     }
-    curlArgs.push(`"${url}"`);
+    curlArgs.push(url);
     if (options.binary) {
-      const result2 = execSync(curlArgs.join(" "), { maxBuffer: 50 * 1024 * 1024 });
+      const result2 = execFileSync("curl", curlArgs, { maxBuffer: 50 * 1024 * 1024 });
       return result2;
     }
-    const result = execSync(curlArgs.join(" "), {
+    const result = execFileSync("curl", curlArgs, {
       encoding: "utf-8",
       maxBuffer: 50 * 1024 * 1024
     });
@@ -39893,22 +39905,24 @@ var ENDPOINT_3D_MODEL_OBJ = "https://modules.easyeda.com/3dmodel/{uuid}";
 class EasyEDAClient {
   userAgent = "ai-eda-lcsc-mcp/1.0.0";
   async getComponentData(lcscPartNumber) {
-    const url = API_ENDPOINT.replace("{lcsc_id}", lcscPartNumber);
-    logger5.debug(`Fetching component data for: ${lcscPartNumber}`);
+    const validatedLcscPartNumber = LCSCPartNumberSchema.parse(lcscPartNumber);
+    const url = API_ENDPOINT.replace("{lcsc_id}", validatedLcscPartNumber);
+    logger5.debug(`Fetching component data for: ${validatedLcscPartNumber}`);
     try {
       const responseText = await fetchWithCurlFallback(url);
       const data = JSON.parse(responseText);
       if (!data.result) {
         return null;
       }
-      return this.parseComponentData(data.result, lcscPartNumber);
+      return this.parseComponentData(data.result, validatedLcscPartNumber);
     } catch (error) {
       logger5.error(`Failed to fetch component ${lcscPartNumber}:`, error);
       throw error;
     }
   }
   async get3DModel(uuid, format = "step") {
-    const url = format === "step" ? ENDPOINT_3D_MODEL_STEP.replace("{uuid}", uuid) : ENDPOINT_3D_MODEL_OBJ.replace("{uuid}", uuid);
+    const validatedUuid = EasyEDAUuidSchema.parse(uuid);
+    const url = format === "step" ? ENDPOINT_3D_MODEL_STEP.replace("{uuid}", validatedUuid) : ENDPOINT_3D_MODEL_OBJ.replace("{uuid}", validatedUuid);
     try {
       const result = await fetchWithCurlFallback(url, { binary: true });
       return result;
@@ -40028,8 +40042,9 @@ class EasyEDACommunityClient {
     }
   }
   async getComponent(uuid) {
-    const url = `${API_COMPONENT_ENDPOINT}/${uuid}?version=${API_VERSION}&uuid=${uuid}`;
-    logger6.debug(`Fetching component: ${uuid}`);
+    const validatedUuid = EasyEDAUuidSchema.parse(uuid);
+    const url = `${API_COMPONENT_ENDPOINT}/${validatedUuid}?version=${API_VERSION}&uuid=${validatedUuid}`;
+    logger6.debug(`Fetching component: ${validatedUuid}`);
     try {
       const responseText = await fetchWithCurlFallback(url);
       const data = JSON.parse(responseText);
@@ -40038,12 +40053,13 @@ class EasyEDACommunityClient {
       }
       return this.parseComponent(data.result);
     } catch (error) {
-      logger6.error(`Failed to fetch component ${uuid}:`, error);
+      logger6.error(`Failed to fetch component ${validatedUuid}:`, error);
       throw error;
     }
   }
   async get3DModel(uuid, format = "step") {
-    const url = format === "step" ? ENDPOINT_3D_MODEL_STEP2.replace("{uuid}", uuid) : ENDPOINT_3D_MODEL_OBJ2.replace("{uuid}", uuid);
+    const validatedUuid = EasyEDAUuidSchema.parse(uuid);
+    const url = format === "step" ? ENDPOINT_3D_MODEL_STEP2.replace("{uuid}", validatedUuid) : ENDPOINT_3D_MODEL_OBJ2.replace("{uuid}", validatedUuid);
     try {
       const result = await fetchWithCurlFallback(url, { binary: true });
       return result;
@@ -40178,13 +40194,37 @@ function createComponentService() {
   return {
     async search(query, options = {}) {
       const { source = "lcsc", limit = 20, inStock, basicOnly } = options;
+      if (source === "all") {
+        const [lcscResults, communityResults] = await Promise.all([
+          jlcClient.search(query, { limit, inStock, basicOnly }),
+          easyedaCommunityClient.search({
+            query,
+            limit
+          })
+        ]);
+        return [
+          ...lcscResults,
+          ...communityResults.map((r) => ({
+            id: r.uuid,
+            idType: "easyeda_uuid",
+            easyedaUuid: r.uuid,
+            name: r.title,
+            manufacturer: r.owner?.nickname || "Community",
+            description: r.description || "",
+            package: r.package || "",
+            stock: 0
+          }))
+        ].slice(0, limit);
+      }
       if (source === "community" || source === "easyeda-community") {
         const results = await easyedaCommunityClient.search({
           query,
           limit
         });
         return results.map((r) => ({
-          lcscId: r.uuid,
+          id: r.uuid,
+          idType: "easyeda_uuid",
+          easyedaUuid: r.uuid,
           name: r.title,
           manufacturer: r.owner?.nickname || "Community",
           description: r.description || "",
@@ -42890,6 +42930,40 @@ function adaptCommunityComponent(component) {
     rawData: component.rawData
   };
 }
+function buildValidationData(component, footprintRef, footprintType, isKicadStandardFootprint) {
+  return {
+    component: {
+      name: component.info.name,
+      description: component.info.description,
+      package: component.info.package,
+      manufacturer: component.info.manufacturer,
+      datasheet_url: component.info.datasheetPdf || component.info.datasheet
+    },
+    symbol: {
+      pin_count: component.symbol.pins.length,
+      pins: component.symbol.pins.map((p) => ({
+        number: p.number,
+        name: p.name,
+        electrical_type: p.electricalType
+      }))
+    },
+    footprint: {
+      type: component.footprint.type,
+      pad_count: component.footprint.pads.length,
+      pads: footprintType === "generated" ? component.footprint.pads.map((p) => ({
+        number: p.number,
+        shape: p.shape
+      })) : null,
+      is_kicad_standard: isKicadStandardFootprint,
+      kicad_ref: footprintRef
+    },
+    checks: {
+      pin_pad_count_match: component.symbol.pins.length === component.footprint.pads.length,
+      has_power_pins: component.symbol.pins.some((p) => p.electricalType === "power_in" || p.electricalType === "power_out"),
+      has_ground_pins: component.symbol.pins.some((p) => p.name.toLowerCase().includes("gnd") || p.name.toLowerCase().includes("vss"))
+    }
+  };
+}
 function createLibraryService() {
   return {
     async install(id, options = {}) {
@@ -42959,6 +43033,34 @@ function createLibraryService() {
         await ensureDir(footprintDir);
         symbolFile = join5(symbolsDir, symLibFile);
         symbolName = component.info.name.replace(/[^a-zA-Z0-9_-]/g, "_");
+        footprintPath = join5(footprintDir, `${symbolName}.kicad_mod`);
+        footprintRef = `${libName}:${symbolName}`;
+        symbolRef = `${libName}:${symbolName}`;
+        component.info.package = footprintRef;
+        if (!options.force && existsSync4(symbolFile)) {
+          const existingContent = await readFile4(symbolFile, "utf-8");
+          if (symbolConverter.symbolExistsInLibrary(existingContent, component.info.name)) {
+            return {
+              success: true,
+              id,
+              source: "easyeda_community",
+              storageMode: isGlobal ? "global" : "project-local",
+              category,
+              symbolName,
+              symbolRef,
+              footprintRef,
+              footprintType: "generated",
+              datasheet: component.info.datasheet,
+              files: {
+                symbolLibrary: symbolFile,
+                footprint: footprintPath,
+                model3d: undefined
+              },
+              symbolAction: "exists",
+              validationData: buildValidationData(component, footprintRef, "generated", false)
+            };
+          }
+        }
         const include3d = options.include3d ?? true;
         let modelRelativePath;
         if (include3d && component.model3d) {
@@ -42980,10 +43082,7 @@ function createLibraryService() {
           include3DModel: !!modelRelativePath,
           modelPath: modelRelativePath
         });
-        footprintPath = join5(footprintDir, `${symbolName}.kicad_mod`);
-        footprintRef = `${libName}:${symbolName}`;
         await writeText(footprintPath, footprint);
-        component.info.package = footprintRef;
         if (isGlobal) {
           const { ensureGlobalEasyEDALibrary: ensureGlobalEasyEDALibrary2 } = await Promise.resolve().then(() => (init_global_lib_table(), exports_global_lib_table));
           await ensureGlobalEasyEDALibrary2();
@@ -42991,7 +43090,6 @@ function createLibraryService() {
           await ensureSymLibTable(options.projectPath, symbolFile, libName, libDesc);
           await ensureFpLibTable(options.projectPath, footprintDir, libName, libDesc);
         }
-        symbolRef = `${libName}:${symbolName}`;
       } else {
         category = getLibraryCategory(component.info.prefix, component.info.category, component.info.description);
         const symbolLibraryFilename = getLibraryFilename(category);
@@ -43001,6 +43099,41 @@ function createLibraryService() {
         await ensureDir(paths.symbolsDir);
         await ensureDir(paths.footprintDir);
         symbolName = symbolConverter.getSymbolName(component);
+        symbolRef = getSymbolReference(category, symbolName);
+        if (!options.force && existsSync4(symbolFile)) {
+          const existingContent = await readFile4(symbolFile, "utf-8");
+          if (symbolConverter.symbolExistsInLibrary(existingContent, component.info.name)) {
+            const existingFootprintResult = footprintConverter.getFootprint(component);
+            if (existingFootprintResult.type === "reference") {
+              footprintRef = existingFootprintResult.reference;
+              footprintPath = undefined;
+            } else {
+              footprintPath = join5(footprintDir, `${existingFootprintResult.name}.kicad_mod`);
+              footprintRef = getFootprintReference(existingFootprintResult.name);
+            }
+            component.info.package = footprintRef;
+            const footprintType2 = existingFootprintResult.type === "reference" ? "reference" : "generated";
+            return {
+              success: true,
+              id,
+              source: "lcsc",
+              storageMode: isGlobal ? "global" : "project-local",
+              category,
+              symbolName,
+              symbolRef,
+              footprintRef,
+              footprintType: footprintType2,
+              datasheet: component.info.datasheet || `https://www.lcsc.com/datasheet/lcsc_datasheet_${id}.pdf`,
+              files: {
+                symbolLibrary: symbolFile,
+                footprint: footprintPath,
+                model3d: undefined
+              },
+              symbolAction: "exists",
+              validationData: buildValidationData(component, footprintRef, footprintType2, existingFootprintResult.type === "reference")
+            };
+          }
+        }
         const include3d = options.include3d ?? true;
         let modelRelativePath;
         if (include3d && component.model3d) {
@@ -43025,7 +43158,6 @@ function createLibraryService() {
           await writeText(footprintPath, footprintResult.content);
         }
         component.info.package = footprintRef;
-        symbolRef = getSymbolReference(category, symbolName);
         if (!isGlobal && options.projectPath) {
           await ensureSymLibTable(options.projectPath, symbolFile);
           await ensureFpLibTable(options.projectPath, footprintDir);
@@ -43065,38 +43197,7 @@ function createLibraryService() {
       }
       const isKicadStandardFootprint = !isCommunityComponent && !footprintPath;
       const footprintType = isKicadStandardFootprint ? "reference" : "generated";
-      const validationData = {
-        component: {
-          name: component.info.name,
-          description: component.info.description,
-          package: component.info.package,
-          manufacturer: component.info.manufacturer,
-          datasheet_url: component.info.datasheetPdf || component.info.datasheet
-        },
-        symbol: {
-          pin_count: component.symbol.pins.length,
-          pins: component.symbol.pins.map((p) => ({
-            number: p.number,
-            name: p.name,
-            electrical_type: p.electricalType
-          }))
-        },
-        footprint: {
-          type: component.footprint.type,
-          pad_count: component.footprint.pads.length,
-          pads: footprintType === "generated" ? component.footprint.pads.map((p) => ({
-            number: p.number,
-            shape: p.shape
-          })) : null,
-          is_kicad_standard: isKicadStandardFootprint,
-          kicad_ref: footprintRef
-        },
-        checks: {
-          pin_pad_count_match: component.symbol.pins.length === component.footprint.pads.length,
-          has_power_pins: component.symbol.pins.some((p) => p.electricalType === "power_in" || p.electricalType === "power_out"),
-          has_ground_pins: component.symbol.pins.some((p) => p.name.toLowerCase().includes("gnd") || p.name.toLowerCase().includes("vss"))
-        }
-      };
+      const validationData = buildValidationData(component, footprintRef, footprintType, isKicadStandardFootprint);
       return {
         success: true,
         id,
@@ -52526,7 +52627,7 @@ function ListView({
               ]
             }, undefined, true, undefined, this)
           ]
-        }, r.lcscId, true, undefined, this);
+        }, r.id ?? r.lcscId, true, undefined, this);
       }),
       /* @__PURE__ */ jsx_dev_runtime4.jsxDEV(Box_default, {
         marginTop: 1,
@@ -52573,10 +52674,17 @@ function SearchScreen() {
     } else if (key.downArrow) {
       setSelectedIndex(Math.min(results.length - 1, selectedIndex + 1));
     } else if (key.return && results[selectedIndex]) {
-      push("info", {
-        componentId: results[selectedIndex].lcscId,
-        component: results[selectedIndex]
-      });
+      const selected = results[selectedIndex];
+      if (selected.idType === "easyeda_uuid") {
+        push("easyeda-info", {
+          uuid: selected.easyedaUuid ?? selected.id
+        });
+      } else {
+        push("info", {
+          componentId: selected.lcscId ?? selected.id,
+          component: selected
+        });
+      }
     } else if (key.tab) {
       setIsSearching(true);
       const newFiltered = !isFiltered;
@@ -52863,7 +52971,7 @@ async function defaultBrowserId() {
 // ../../node_modules/run-applescript/index.js
 import process16 from "node:process";
 import { promisify as promisify4 } from "node:util";
-import { execFile as execFile4, execFileSync } from "node:child_process";
+import { execFile as execFile4, execFileSync as execFileSync2 } from "node:child_process";
 var execFileAsync2 = promisify4(execFile4);
 async function runAppleScript(script, { humanReadableOutput = true, signal } = {}) {
   if (process16.platform !== "darwin") {
@@ -53572,6 +53680,7 @@ function InfoScreen() {
     fetchData();
   }, [params.componentId, params.component]);
   const datasheetUrl = component && ("datasheetPdf" in component ? component.datasheetPdf : ("datasheet" in component) ? component.datasheet : undefined);
+  const componentLcscId = component?.lcscId ?? params.componentId;
   const [isRegenerating, setIsRegenerating] = import_react30.useState(false);
   const [isDeleting, setIsDeleting] = import_react30.useState(false);
   const [regenerateMessage, setRegenerateMessage] = import_react30.useState(null);
@@ -53579,10 +53688,10 @@ function InfoScreen() {
     if (isLoading || !component || isCheckingLibrary || isRegenerating || isDeleting)
       return;
     const lowerInput = input.toLowerCase();
-    if (lowerInput === "r" && installedInfo) {
+    if (lowerInput === "r" && installedInfo && componentLcscId) {
       setIsRegenerating(true);
       setRegenerateMessage("Regenerating symbol and footprint...");
-      libraryService.install(component.lcscId, { force: true }).then((result2) => {
+      libraryService.install(componentLcscId, { force: true }).then((result2) => {
         setRegenerateMessage(`✓ Regenerated: ${result2.symbolAction}`);
         setTimeout(() => setRegenerateMessage(null), 2000);
       }).catch((err) => {
@@ -53609,20 +53718,25 @@ function InfoScreen() {
       return;
     }
     if (key.return && !installedInfo) {
+      if (!componentLcscId) {
+        setRegenerateMessage("✗ Missing LCSC part number");
+        setTimeout(() => setRegenerateMessage(null), 3000);
+        return;
+      }
       if (checkingRef.current)
         return;
       checkingRef.current = true;
       setIsCheckingLibrary(true);
       if (libraryStatus && (!libraryStatus.installed || !libraryStatus.linked)) {
         push("library-setup", {
-          componentId: component.lcscId,
+          componentId: componentLcscId,
           component
         });
         setIsCheckingLibrary(false);
         checkingRef.current = false;
       } else {
         push("install", {
-          componentId: component.lcscId,
+          componentId: componentLcscId,
           component
         });
         setIsCheckingLibrary(false);
@@ -53670,6 +53784,21 @@ function InfoScreen() {
       ]
     }, undefined, true, undefined, this);
   }
+  if (!componentLcscId) {
+    return /* @__PURE__ */ jsx_dev_runtime7.jsxDEV(Box_default, {
+      flexDirection: "column",
+      children: [
+        /* @__PURE__ */ jsx_dev_runtime7.jsxDEV(Text, {
+          color: "red",
+          children: "✗ Missing LCSC part number"
+        }, undefined, false, undefined, this),
+        /* @__PURE__ */ jsx_dev_runtime7.jsxDEV(Text, {
+          dimColor: true,
+          children: "Press Esc to go back"
+        }, undefined, false, undefined, this)
+      ]
+    }, undefined, true, undefined, this);
+  }
   return /* @__PURE__ */ jsx_dev_runtime7.jsxDEV(Box_default, {
     flexDirection: "column",
     children: [
@@ -53681,7 +53810,7 @@ function InfoScreen() {
             "Component: ",
             /* @__PURE__ */ jsx_dev_runtime7.jsxDEV(Text, {
               color: "cyan",
-              children: component.lcscId
+              children: componentLcscId
             }, undefined, false, undefined, this),
             " ",
             /* @__PURE__ */ jsx_dev_runtime7.jsxDEV(Text, {
@@ -53700,7 +53829,7 @@ function InfoScreen() {
         }, undefined, true, undefined, this)
       }, undefined, false, undefined, this),
       /* @__PURE__ */ jsx_dev_runtime7.jsxDEV(DetailView, {
-        component,
+        component: { ...component, lcscId: componentLcscId },
         terminalWidth,
         isInstalled: !!installedInfo,
         installedInfo,
@@ -53923,7 +54052,7 @@ function InstalledScreen() {
         }, undefined, true, undefined, this)
       }, undefined, false, undefined, this),
       /* @__PURE__ */ jsx_dev_runtime10.jsxDEV(InstalledView, {
-        component: params.component,
+        component: { ...params.component, lcscId: params.componentId },
         result: result2,
         error: params.error || null,
         terminalWidth
@@ -54972,10 +55101,53 @@ async function renderApp(initialScreen, initialParams) {
   await instance.waitUntilExit();
 }
 
+// src/utils/agent-output.ts
+function printJson(value) {
+  process.stdout.write(`${JSON.stringify(value, null, 2)}
+`);
+}
+function printJsonError(code, message, options = {}) {
+  const payload = {
+    success: false,
+    error: {
+      code,
+      message,
+      retryable: options.retryable ?? false,
+      details: options.details
+    }
+  };
+  printJson(payload);
+}
+function getErrorMessage(error) {
+  return error instanceof Error ? error.message : String(error);
+}
+
+// src/utils/search-result-output.ts
+function formatSearchResultForJson(result2) {
+  return {
+    id: result2.id,
+    id_type: result2.idType,
+    lcsc_id: result2.idType === "lcsc" ? result2.lcscId : undefined,
+    easyeda_uuid: result2.idType === "easyeda_uuid" ? result2.easyedaUuid ?? result2.id : undefined,
+    name: result2.name,
+    manufacturer: result2.manufacturer,
+    description: result2.description,
+    package: result2.package,
+    datasheet: result2.datasheetPdf,
+    stock: result2.stock,
+    price: result2.price,
+    library_type: result2.libraryType,
+    category: result2.category,
+    attributes: result2.attributes
+  };
+}
+
 // src/commands/search.ts
 var componentService5 = createComponentService();
 async function searchCommand(query, options) {
-  console.log(`Searching for "${query}"...`);
+  if (!options.json) {
+    console.log(`Searching for "${query}"...`);
+  }
   try {
     let results = await componentService5.search(query, options);
     if (!options.basicOnly) {
@@ -54988,17 +55160,58 @@ async function searchCommand(query, options) {
       });
     }
     if (results.length === 0) {
+      if (options.json) {
+        printJson({
+          success: true,
+          query,
+          count: 0,
+          results: []
+        });
+        return;
+      }
       console.log("No components found. Try a different search term.");
       return;
     }
+    if (options.json) {
+      printJson({
+        success: true,
+        query,
+        count: results.length,
+        results: results.map(formatSearchResultForJson)
+      });
+      return;
+    }
     process.stdout.write("\x1B[1A\x1B[2K");
     await renderApp("search", { query, results });
   } catch (error) {
-    console.error(`Search failed: ${error instanceof Error ? error.message : "Unknown error"}`);
+    if (options.json) {
+      printJsonError("search_failed", getErrorMessage(error), { retryable: true });
+    } else {
+      console.error(`Search failed: ${getErrorMessage(error)}`);
+    }
     process.exit(1);
   }
 }
 
+// src/commands/info.ts
+var componentService6 = createComponentService();
+async function infoCommand(id, options) {
+  if (options.json) {
+    try {
+      const details = await componentService6.getDetails(id);
+      printJson({
+        success: true,
+        component: details
+      });
+    } catch (error) {
+      printJsonError("component_fetch_failed", getErrorMessage(error), { retryable: true });
+      process.exit(1);
+    }
+    return;
+  }
+  await renderApp("info", { componentId: id });
+}
+
 // ../../node_modules/@clack/core/dist/index.mjs
 var import_sisteransi = __toESM(require_src(), 1);
 var import_picocolors = __toESM(require_picocolors(), 1);
@@ -55576,26 +55789,6 @@ var L2 = () => {
   } };
 };
 
-// src/commands/info.ts
-var componentService6 = createComponentService();
-async function infoCommand(id, options) {
-  if (options.json) {
-    const spinner = L2();
-    spinner.start(`Fetching component ${id}...`);
-    try {
-      const details = await componentService6.getDetails(id);
-      spinner.stop("Component found");
-      console.log(JSON.stringify(details, null, 2));
-    } catch (error) {
-      spinner.stop("Failed to fetch component");
-      v2.error(`Error: ${error instanceof Error ? error.message : "Unknown error"}`);
-      process.exit(1);
-    }
-    return;
-  }
-  await renderApp("info", { componentId: id });
-}
-
 // src/commands/install.ts
 var componentService7 = createComponentService();
 var libraryService6 = createLibraryService();
@@ -55603,22 +55796,43 @@ function isLcscId(id) {
   return /^C\d+$/i.test(id);
 }
 async function installCommand(id, options) {
+  if (!id && (options.yes || options.json)) {
+    if (options.json) {
+      printJsonError("missing_id", "Direct install requires an LCSC part number");
+    } else {
+      v2.error("Direct install requires an LCSC part number.");
+    }
+    process.exit(1);
+  }
   if (id && !isLcscId(id)) {
+    if (options.json) {
+      printJsonError("invalid_lcsc_id", `"${id}" is not an LCSC part number`, {
+        details: { hint: `Use jlc easyeda install ${id}` }
+      });
+      process.exit(1);
+    }
     v2.error(`"${id}" is not an LCSC part number (e.g., C2040).`);
     v2.info(`For EasyEDA community components, use: ${source_default.cyan(`jlc easyeda install ${id}`)}`);
     process.exit(1);
   }
-  if (id && options.force) {
-    const spinner = L2();
-    spinner.start(`Installing component ${id}...`);
+  if (id && (options.yes || options.json)) {
+    const spinner = options.json ? null : L2();
+    spinner?.start(`Installing component ${id}...`);
     try {
       await libraryService6.ensureGlobalTables();
       const result2 = await libraryService6.install(id, {
         projectPath: options.projectPath,
         include3d: options.include3d,
-        force: true
+        force: options.force
       });
-      spinner.stop(source_default.green("✓ Component installed"));
+      spinner?.stop(source_default.green("✓ Component installed"));
+      if (options.json) {
+        printJson({
+          success: true,
+          result: result2
+        });
+        return;
+      }
       console.log();
       console.log(source_default.cyan("Symbol:    "), result2.symbolRef);
       console.log(source_default.cyan("Footprint: "), result2.footprintRef);
@@ -55629,8 +55843,12 @@ async function installCommand(id, options) {
       console.log();
       console.log(source_default.dim(`Library: ${result2.files.symbolLibrary}`));
     } catch (error) {
-      spinner.stop(source_default.red("✗ Installation failed"));
-      v2.error(`Error: ${error instanceof Error ? error.message : "Unknown error"}`);
+      spinner?.stop(source_default.red("✗ Installation failed"));
+      if (options.json) {
+        printJsonError("install_failed", getErrorMessage(error), { retryable: true });
+      } else {
+        v2.error(`Error: ${getErrorMessage(error)}`);
+      }
       process.exit(1);
     }
     return;
@@ -55682,15 +55900,13 @@ async function installCommand(id, options) {
 var libraryService7 = createLibraryService();
 async function libraryCommand(options) {
   if (options.json) {
-    const spinner = L2();
-    spinner.start("Loading library status...");
     try {
       const [status, components] = await Promise.all([
         libraryService7.getStatus(),
         libraryService7.listInstalled({})
       ]);
-      spinner.stop(`Found ${components.length} installed components`);
-      console.log(JSON.stringify({
+      printJson({
+        success: true,
         status: {
           installed: status.installed,
           linked: status.linked,
@@ -55699,10 +55915,9 @@ async function libraryCommand(options) {
           paths: status.paths
         },
         components
-      }, null, 2));
+      });
     } catch (error) {
-      spinner.stop("Failed to get library status");
-      v2.error(`Error: ${error instanceof Error ? error.message : "Unknown error"}`);
+      printJsonError("library_status_failed", getErrorMessage(error), { retryable: false });
       process.exit(1);
     }
     return;
@@ -55748,6 +55963,24 @@ async function regenerateCommand(options) {
 var componentService8 = createComponentService();
 var libraryService8 = createLibraryService();
 async function easyedaSearchCommand(query, options) {
+  if (options.json) {
+    try {
+      const results = await componentService8.search(query, {
+        limit: 20,
+        source: "easyeda-community"
+      });
+      printJson({
+        success: true,
+        query,
+        count: results.length,
+        results: results.map(formatSearchResultForJson)
+      });
+    } catch (error) {
+      printJsonError("easyeda_search_failed", getErrorMessage(error), { retryable: true });
+      process.exit(1);
+    }
+    return;
+  }
   const port = options.port ?? 3847;
   console.log("Starting component browser...");
   startHttpServer({
@@ -55755,7 +55988,13 @@ async function easyedaSearchCommand(query, options) {
     onReady: async (url) => {
       const searchUrl = query ? `${url}?q=${encodeURIComponent(query)}` : url;
       console.log(`Browser opened at ${searchUrl}`);
-      await open_default(searchUrl);
+      if (options.open !== false) {
+        await open_default(searchUrl);
+      }
+      if (options.once) {
+        stopHttpServer();
+        process.exit(0);
+      }
       console.log("Press Ctrl+C to stop the server and exit");
     }
   });
@@ -55770,17 +56009,32 @@ Shutting down server...`);
   });
 }
 async function easyedaInstallCommand(uuid, options) {
-  if (uuid && options.force) {
-    const spinner = L2();
-    spinner.start(`Installing EasyEDA component ${uuid}...`);
+  if (!uuid && (options.yes || options.json)) {
+    if (options.json) {
+      printJsonError("missing_uuid", "Direct EasyEDA install requires a component UUID");
+    } else {
+      v2.error("Direct EasyEDA install requires a component UUID.");
+    }
+    process.exit(1);
+  }
+  if (uuid && (options.yes || options.json)) {
+    const spinner = options.json ? null : L2();
+    spinner?.start(`Installing EasyEDA component ${uuid}...`);
     try {
       await libraryService8.ensureGlobalTables();
       const result2 = await libraryService8.install(uuid, {
         projectPath: options.projectPath,
         include3d: options.include3d,
-        force: true
+        force: options.force
       });
-      spinner.stop(source_default.green("✓ Component installed"));
+      spinner?.stop(source_default.green("✓ Component installed"));
+      if (options.json) {
+        printJson({
+          success: true,
+          result: result2
+        });
+        return;
+      }
       console.log();
       console.log(source_default.cyan("Symbol:    "), result2.symbolRef);
       console.log(source_default.cyan("Footprint: "), result2.footprintRef);
@@ -55791,8 +56045,12 @@ async function easyedaInstallCommand(uuid, options) {
       console.log();
       console.log(source_default.dim(`Library: ${result2.files.symbolLibrary}`));
     } catch (error) {
-      spinner.stop(source_default.red("✗ Installation failed"));
-      v2.error(`Error: ${error instanceof Error ? error.message : "Unknown error"}`);
+      spinner?.stop(source_default.red("✗ Installation failed"));
+      if (options.json) {
+        printJsonError("easyeda_install_failed", getErrorMessage(error), { retryable: true });
+      } else {
+        v2.error(`Error: ${getErrorMessage(error)}`);
+      }
       process.exit(1);
     }
     return;
@@ -55894,33 +56152,25 @@ async function validateComponent(lcscCode, options) {
   }
 }
 async function validateCommand(id, options) {
+  if (options.footprintOnly && options.symbolOnly) {
+    if (options.json) {
+      printJsonError("invalid_options", "--footprint-only and --symbol-only are mutually exclusive");
+    } else {
+      v2.error("--footprint-only and --symbol-only are mutually exclusive");
+    }
+    process.exit(1);
+  }
   const validateFootprint = !options.symbolOnly;
   const validateSymbol = !options.footprintOnly;
   if (id && !options.category && !options.all) {
-    const spinner = L2();
-    spinner.start(`Validating ${id}...`);
+    const spinner = options.json ? null : L2();
+    spinner?.start(`Validating ${id}...`);
     const result2 = await validateComponent(id, {
       footprint: validateFootprint,
       symbol: validateSymbol
     });
-    spinner.stop(result2.passed ? source_default.green("✓ Validation passed") : source_default.red("✗ Validation failed"));
-    console.log();
-    console.log(source_default.bold(`${result2.componentName} (${result2.lcscCode})`));
-    console.log(source_default.dim(`Duration: ${result2.durationMs}ms`));
-    console.log();
-    if (result2.error) {
-      console.log(source_default.red(`Error: ${result2.error}`));
-      process.exit(1);
-    }
-    if (result2.footprint) {
-      console.log(formatComparisonResult(result2.footprint));
-    }
-    if (result2.symbol) {
-      console.log(formatSymbolComparisonResult(result2.symbol));
-    }
-    if (options.json) {
-      console.log(JSON.stringify(result2, null, 2));
-    }
+    spinner?.stop(result2.passed ? source_default.green("✓ Validation passed") : source_default.red("✗ Validation failed"));
+    let htmlPath2;
     if (options.html) {
       const reference = await fetchReferenceSVG(id);
       const componentData = await easyedaClient.getComponentData(id);
@@ -55942,12 +56192,41 @@ async function validateCommand(id, options) {
       }
       const html = generateValidationReport(result2, svgs);
       writeFileSync(options.html, html);
-      console.log(source_default.dim(`HTML report: ${options.html}`));
+      htmlPath2 = options.html;
+    }
+    if (options.json) {
+      printJson({
+        success: result2.passed && !result2.error,
+        result: result2,
+        html: htmlPath2
+      });
+      process.exit(result2.passed && !result2.error ? 0 : 1);
+    }
+    console.log();
+    console.log(source_default.bold(`${result2.componentName} (${result2.lcscCode})`));
+    console.log(source_default.dim(`Duration: ${result2.durationMs}ms`));
+    console.log();
+    if (result2.error) {
+      console.log(source_default.red(`Error: ${result2.error}`));
+      process.exit(1);
+    }
+    if (result2.footprint) {
+      console.log(formatComparisonResult(result2.footprint));
+    }
+    if (result2.symbol) {
+      console.log(formatSymbolComparisonResult(result2.symbol));
+    }
+    if (htmlPath2) {
+      console.log(source_default.dim(`HTML report: ${htmlPath2}`));
     }
     process.exit(result2.passed ? 0 : 1);
   }
   let components = options.all ? getAllTestComponents() : options.category ? getTestComponentsByCategory(options.category) : [];
   if (components.length === 0 && !id) {
+    if (options.json) {
+      printJsonError("missing_validation_target", "JSON validation requires an id, --category, or --all");
+      process.exit(1);
+    }
     const categories = getCategoryNames();
     const selected = await de({
       message: "Select a category to validate:",
@@ -55964,18 +56243,30 @@ async function validateCommand(id, options) {
   }
   components = components.filter((c2) => !c2.skip);
   if (components.length === 0) {
+    if (options.json) {
+      printJson({
+        success: true,
+        summary: { total: 0, passed: 0, failed: 0, errors: 0 },
+        results: []
+      });
+      process.exit(0);
+    }
     v2.warn("No components to validate");
     process.exit(0);
   }
-  console.log(source_default.bold(`
+  if (!options.json) {
+    console.log(source_default.bold(`
 Validating ${components.length} components...
 `));
+  }
   const results = [];
   let passed = 0;
   let failed = 0;
   let errors = 0;
   for (const component of components) {
-    process.stdout.write(`  ${component.lcsc.padEnd(12)} ${component.name.slice(0, 40).padEnd(42)} `);
+    if (!options.json) {
+      process.stdout.write(`  ${component.lcsc.padEnd(12)} ${component.name.slice(0, 40).padEnd(42)} `);
+    }
     const result2 = await validateComponent(component.lcsc, {
       footprint: validateFootprint,
       symbol: validateSymbol
@@ -55983,49 +56274,79 @@ Validating ${components.length} components...
     results.push(result2);
     if (result2.error) {
       errors++;
-      console.log(source_default.yellow("⚠ ERROR"));
+      if (!options.json)
+        console.log(source_default.yellow("⚠ ERROR"));
     } else if (result2.passed) {
       passed++;
-      console.log(source_default.green("✓ PASS"));
+      if (!options.json)
+        console.log(source_default.green("✓ PASS"));
     } else {
       failed++;
-      console.log(source_default.red("✗ FAIL"));
+      if (!options.json)
+        console.log(source_default.red("✗ FAIL"));
     }
   }
+  let htmlPath;
+  if (options.html) {
+    const html = generateBatchReport(results, "JLC-CLI Validation Report");
+    writeFileSync(options.html, html);
+    htmlPath = options.html;
+  }
+  if (options.json) {
+    printJson({
+      success: failed === 0 && errors === 0,
+      summary: {
+        total: results.length,
+        passed,
+        failed,
+        errors
+      },
+      results,
+      html: htmlPath
+    });
+    process.exit(failed > 0 || errors > 0 ? 1 : 0);
+  }
   console.log();
   console.log(source_default.bold("Summary:"));
   console.log(`  ${source_default.green(`${passed} passed`)}  ${source_default.red(`${failed} failed`)}  ${source_default.yellow(`${errors} errors`)}`);
   console.log();
-  if (options.json) {
-    console.log(JSON.stringify(results, null, 2));
-  }
-  if (options.html) {
-    const html = generateBatchReport(results, "JLC-CLI Validation Report");
-    writeFileSync(options.html, html);
-    console.log(source_default.dim(`HTML report: ${options.html}`));
+  if (htmlPath) {
+    console.log(source_default.dim(`HTML report: ${htmlPath}`));
   }
   process.exit(failed > 0 || errors > 0 ? 1 : 0);
 }
 
 // src/index.ts
+var require2 = createRequire2(import.meta.url);
+var { version } = require2("../package.json");
 var program2 = new Command;
-program2.name("jlc").description("JLC/EasyEDA component sourcing and KiCad library management").version("0.1.0");
-program2.command("search <query...>").description("Search for components (basic parts sorted first)").option("-l, --limit <number>", "Maximum results", "20").option("--in-stock", "Only show in-stock components").option("--basic-only", "Only show basic parts (no extended)").option("--community", "Search EasyEDA community library").action(async (queryParts, options) => {
+function parsePositiveInt(value) {
+  const parsed = Number.parseInt(value, 10);
+  if (!Number.isInteger(parsed) || parsed <= 0) {
+    throw new Error(`Expected a positive integer, got "${value}"`);
+  }
+  return parsed;
+}
+program2.name("jlc").description("JLC/EasyEDA component sourcing and KiCad library management").version(version);
+program2.command("search <query...>").description("Search for components (basic parts sorted first)").option("-l, --limit <number>", "Maximum results", parsePositiveInt, 20).option("--in-stock", "Only show in-stock components").option("--basic-only", "Only show basic parts (no extended)").option("--community", "Search EasyEDA community library").option("--json", "Output clean JSON and do not launch the TUI").action(async (queryParts, options) => {
   const query = queryParts.join(" ");
   await searchCommand(query, {
-    limit: parseInt(options.limit, 10),
+    limit: options.limit,
     inStock: options.inStock,
     basicOnly: options.basicOnly || false,
-    source: options.community ? "easyeda-community" : "lcsc"
+    source: options.community ? "easyeda-community" : "lcsc",
+    json: options.json
   });
 });
 program2.command("info <id>").description("Get component details").option("--json", "Output as JSON").action(async (id, options) => {
   await infoCommand(id, { json: options.json });
 });
-program2.command("install [id]").description("Install component to KiCad libraries").option("-p, --project <path>", "Install to project-local library").option("--with-3d", "Include 3D model").option("-f, --force", "Force reinstall (regenerate symbol and footprint)").action(async (id, options) => {
+program2.command("install [id]").description("Install component to KiCad libraries").option("-p, --project <path>", "Install to project-local library").option("--with-3d", "Include 3D model").option("-y, --yes", "Install directly without launching the TUI").option("--json", "Output clean JSON and install directly").option("-f, --force", "Force reinstall (regenerate symbol and footprint)").action(async (id, options) => {
   await installCommand(id, {
     projectPath: options.project,
     include3d: options.with3d,
+    yes: options.yes,
+    json: options.json,
     force: options.force
   });
 });
@@ -56052,17 +56373,25 @@ program2.command("validate [id]").description("Validate footprint/symbol generat
   });
 });
 var easyeda = program2.command("easyeda").description("EasyEDA community component browser");
-easyeda.command("search <query...>").description("Open browser-based component search").option("-p, --port <number>", "HTTP server port", "3847").action(async (queryParts, options) => {
+easyeda.command("search <query...>").description("Open browser-based component search").option("-p, --port <number>", "HTTP server port", parsePositiveInt, 3847).option("--json", "Output clean JSON search results and do not open a browser").option("--no-open", "Start the browser server without opening a browser").option("--once", "Print the browser URL and exit after the server is ready").action(async (queryParts, options) => {
   const query = queryParts.join(" ");
   await easyedaSearchCommand(query, {
-    port: options.port ? parseInt(options.port, 10) : undefined
+    port: options.port,
+    json: options.json,
+    open: options.open,
+    once: options.once
   });
 });
-easyeda.command("install [uuid]").description("Install EasyEDA community component to KiCad libraries").option("-p, --project <path>", "Install to project-local library").option("--with-3d", "Include 3D model").option("-f, --force", "Force reinstall (regenerate symbol and footprint)").action(async (uuid, options) => {
+easyeda.command("install [uuid]").description("Install EasyEDA community component to KiCad libraries").option("-p, --project <path>", "Install to project-local library").option("--with-3d", "Include 3D model").option("-y, --yes", "Install directly without launching the TUI").option("--json", "Output clean JSON and install directly").option("-f, --force", "Force reinstall (regenerate symbol and footprint)").action(async (uuid, options) => {
   await easyedaInstallCommand(uuid, {
     projectPath: options.project,
     include3d: options.with3d,
+    yes: options.yes,
+    json: options.json,
     force: options.force
   });
 });
-program2.parse();
+program2.parseAsync().catch((error) => {
+  console.error(`Error: ${getErrorMessage(error)}`);
+  process.exit(1);
+});