@tscircuit/cli 0.1.1054 → 0.1.1056

package/dist/cli/main.js

@@ -71664,7 +71664,7 @@ var registerStaticAssetLoaders = () => {
 // cli/main.ts
 var import_perfect_cli = __toESM2(require_dist2(), 1);
 // package.json
-var version = "0.1.1053";
+var version = "0.1.1055";
 var package_default = {
   name: "@tscircuit/cli",
   version,
@@ -71676,7 +71676,7 @@ var package_default = {
   devDependencies: {
     "@babel/standalone": "^7.26.9",
     "@biomejs/biome": "^1.9.4",
-    "@tscircuit/circuit-json-placement-analysis": "^0.0.1",
+    "@tscircuit/circuit-json-placement-analysis": "^0.0.4",
     "@tscircuit/circuit-json-util": "0.0.81",
     "@tscircuit/fake-snippets": "^0.0.182",
     "@tscircuit/file-server": "^0.0.32",
@@ -82887,6 +82887,66 @@ var getComponentToBoardCalcString = (componentName, direction, distance) => {
       return `${componentName}.centerY=calc(board.centerY+${d})`;
   }
 };
+var getPadBounds = (element) => {
+  if (element.type === "pcb_smtpad") {
+    const x = toNumber2(element.x);
+    const y = toNumber2(element.y);
+    const width = toNumber2(element.width);
+    const height = toNumber2(element.height);
+    if (x === null || y === null || width === null || height === null)
+      return null;
+    return {
+      minX: x - width / 2,
+      maxX: x + width / 2,
+      minY: y - height / 2,
+      maxY: y + height / 2
+    };
+  }
+  if (element.type === "pcb_plated_hole") {
+    const x = toNumber2(element.x);
+    const y = toNumber2(element.y);
+    const rectPadWidth = toNumber2(element.rect_pad_width);
+    const rectPadHeight = toNumber2(element.rect_pad_height);
+    const holeDiameter = toNumber2(element.hole_diameter);
+    if (x === null || y === null)
+      return null;
+    const width = rectPadWidth ?? holeDiameter;
+    const height = rectPadHeight ?? holeDiameter;
+    if (width === null || height === null)
+      return null;
+    return {
+      minX: x - width / 2,
+      maxX: x + width / 2,
+      minY: y - height / 2,
+      maxY: y + height / 2
+    };
+  }
+  return null;
+};
+var getBoundsClearance = (a, b) => {
+  const dx = Math.max(0, a.minX - b.maxX, b.minX - a.maxX);
+  const dy = Math.max(0, a.minY - b.maxY, b.minY - a.maxY);
+  return Math.hypot(dx, dy);
+};
+var getPadDisplayName = (pad, componentName, sourcePortNameByPcbPortId) => {
+  const pcbPortId = typeof pad.pcb_port_id === "string" ? pad.pcb_port_id : null;
+  if (pcbPortId) {
+    const sourcePortName = sourcePortNameByPcbPortId.get(pcbPortId);
+    if (sourcePortName)
+      return `${componentName}.${sourcePortName}`;
+  }
+  if (Array.isArray(pad.port_hints)) {
+    const pinHint = pad.port_hints.find((hint) => typeof hint === "string" && /^pin\d+$/i.test(hint));
+    if (typeof pinHint === "string")
+      return `${componentName}.${pinHint}`;
+    const numericHint = pad.port_hints.find((hint) => typeof hint === "string" && /^\d+$/.test(hint));
+    if (typeof numericHint === "string")
+      return `${componentName}.pin${numericHint}`;
+  }
+  if (pcbPortId)
+    return `${componentName}.${pcbPortId}`;
+  return `${componentName}.pad`;
+};
 var getDirectionAndDistance = (fromX, fromY, toX, toY) => {
   const dx = toX - fromX;
   const dy = toY - fromY;
@@ -82903,6 +82963,13 @@ var getDirectionAndDistance = (fromX, fromY, toX, toY) => {
     axis: "y"
   };
 };
+var getPinCenter = (pad) => {
+  const x = toNumber2(pad.x);
+  const y = toNumber2(pad.y);
+  if (x === null || y === null)
+    return null;
+  return { x, y };
+};
 var lineItemToString = (lineItem) => {
   switch (lineItem.line_item_type) {
     case "absolute_component_position":
@@ -82933,6 +83000,10 @@ var lineItemToString = (lineItem) => {
       return `${lineItem.component_name}.orientation=${lineItem.orientation}`;
     case "relative_component_edge_to_board_edge_position":
       return `${lineItem.component_name}.${lineItem.component_edge}=calc(${lineItem.board_edge}${withSignedMm(lineItem.offset)})${isOffBoardEdgeOffset(lineItem.board_edge, lineItem.offset) ? " [offboard]" : ""}`;
+    case "component_pad_clearance":
+      return `${lineItem.component_name}.padClearance=${fmtMm(lineItem.clearance)} [nearest=${lineItem.nearest_pad_name}]`;
+    case "direct_pin_to_pin_distance":
+      return `${lineItem.from_pin_name} -> ${lineItem.to_pin_name} distance: ${fmtMm(lineItem.distance)}`;
     default:
       return "";
   }
@@ -83076,6 +83147,151 @@ var analyzeComponentPlacement = (circuitJson, componentName) => {
     };
     lineItems.push(boardLineItem);
   }
+  const sourcePortNameByPcbPortId = /* @__PURE__ */ new Map;
+  for (const el of circuitJson) {
+    if (el.type === "pcb_port" && typeof el.pcb_port_id === "string" && typeof el.source_port_id === "string") {
+      const sourcePort = circuitJson.find((candidate) => candidate.type === "source_port" && candidate.source_port_id === el.source_port_id && typeof candidate.name === "string");
+      if (sourcePort && typeof sourcePort.name === "string") {
+        sourcePortNameByPcbPortId.set(el.pcb_port_id, sourcePort.name);
+      }
+    }
+  }
+  const sourcePortById = /* @__PURE__ */ new Map;
+  for (const el of circuitJson) {
+    if (el.type === "source_port" && typeof el.source_port_id === "string") {
+      sourcePortById.set(el.source_port_id, el);
+    }
+  }
+  const sourcePortDisplayNameById = /* @__PURE__ */ new Map;
+  for (const el of circuitJson) {
+    if (el.type === "source_port" && typeof el.source_port_id === "string") {
+      if (typeof el.source_component_id === "string" && typeof el.name === "string") {
+        const sourceComp = circuitJson.find((candidate) => candidate.type === "source_component" && candidate.source_component_id === el.source_component_id && typeof candidate.name === "string");
+        if (sourceComp && typeof sourceComp.name === "string") {
+          sourcePortDisplayNameById.set(el.source_port_id, `${sourceComp.name}.${el.name}`);
+          continue;
+        }
+      }
+      if (typeof el.name === "string") {
+        sourcePortDisplayNameById.set(el.source_port_id, el.name);
+      }
+    }
+  }
+  const padBySourcePortId = /* @__PURE__ */ new Map;
+  if (typeof pcbComponent?.pcb_component_id === "string") {
+    for (const el of circuitJson) {
+      if ((el.type === "pcb_smtpad" || el.type === "pcb_plated_hole") && typeof el.pcb_component_id === "string" && typeof el.pcb_port_id === "string") {
+        const pcbPort = circuitJson.find((candidate) => candidate.type === "pcb_port" && candidate.pcb_port_id === el.pcb_port_id && typeof candidate.source_port_id === "string");
+        if (!pcbPort || typeof pcbPort.source_port_id !== "string")
+          continue;
+        const center2 = getPinCenter(el);
+        if (!center2)
+          continue;
+        const sourcePort = sourcePortById.get(pcbPort.source_port_id);
+        const sourcePortComponentId = typeof sourcePort?.source_component_id === "string" ? sourcePort.source_component_id : null;
+        if (sourcePortComponentId !== sourceComponentId)
+          continue;
+        padBySourcePortId.set(pcbPort.source_port_id, {
+          pad: el,
+          padName: getPadDisplayName(el, componentName, sourcePortNameByPcbPortId),
+          center: center2
+        });
+      }
+    }
+  }
+  const directPinDistanceLineItems = [];
+  for (const fromPortId of padBySourcePortId.keys()) {
+    const directPinToPinTraces = circuitJson.filter((el) => el.type === "source_trace" && Array.isArray(el.connected_source_port_ids) && el.connected_source_port_ids.length === 2 && el.connected_source_port_ids.includes(fromPortId) && Array.isArray(el.connected_source_net_ids) && el.connected_source_net_ids.length === 0);
+    if (directPinToPinTraces.length !== 1)
+      continue;
+    const trace = directPinToPinTraces[0];
+    if (!trace)
+      continue;
+    const connectedPortIds = Array.isArray(trace.connected_source_port_ids) ? trace.connected_source_port_ids.filter((value) => typeof value === "string") : [];
+    const otherPortId = connectedPortIds.find((portId) => portId !== fromPortId);
+    if (!otherPortId)
+      continue;
+    const fromPin = padBySourcePortId.get(fromPortId);
+    if (!fromPin)
+      continue;
+    const otherPcbPort = circuitJson.find((candidate) => candidate.type === "pcb_port" && candidate.source_port_id === otherPortId && typeof candidate.pcb_port_id === "string");
+    if (!otherPcbPort || typeof otherPcbPort.pcb_port_id !== "string")
+      continue;
+    const otherPad = circuitJson.find((candidate) => (candidate.type === "pcb_smtpad" || candidate.type === "pcb_plated_hole") && candidate.pcb_port_id === otherPcbPort.pcb_port_id);
+    if (!otherPad)
+      continue;
+    const otherCenter = getPinCenter(otherPad);
+    if (!otherCenter)
+      continue;
+    const fromPortDisplayName = sourcePortDisplayNameById.get(fromPortId);
+    const toPortDisplayName = sourcePortDisplayNameById.get(otherPortId);
+    if (!fromPortDisplayName || !toPortDisplayName)
+      continue;
+    directPinDistanceLineItems.push({
+      line_item_type: "direct_pin_to_pin_distance",
+      component_name: componentName,
+      from_pin_name: fromPortDisplayName,
+      to_pin_name: toPortDisplayName,
+      distance: Math.hypot(otherCenter.x - fromPin.center.x, otherCenter.y - fromPin.center.y)
+    });
+  }
+  lineItems.push(...directPinDistanceLineItems);
+  const componentPadBounds = typeof pcbComponent?.pcb_component_id === "string" ? circuitJson.filter((el) => (el.type === "pcb_smtpad" || el.type === "pcb_plated_hole") && el.pcb_component_id === pcbComponent.pcb_component_id).map((pad) => {
+    const bounds = getPadBounds(pad);
+    if (!bounds)
+      return null;
+    return {
+      bounds,
+      padName: getPadDisplayName(pad, componentName, sourcePortNameByPcbPortId)
+    };
+  }).filter((pad) => pad !== null) : [];
+  if (componentPadBounds.length > 0 && typeof pcbComponent?.pcb_component_id === "string") {
+    const sourceComponentNameByPcbComponentId = /* @__PURE__ */ new Map;
+    for (const el of circuitJson) {
+      if (el.type === "pcb_component" && typeof el.pcb_component_id === "string" && typeof el.source_component_id === "string") {
+        const sourceName = circuitJson.find((candidate) => candidate.type === "source_component" && candidate.source_component_id === el.source_component_id && typeof candidate.name === "string");
+        if (sourceName && typeof sourceName.name === "string") {
+          sourceComponentNameByPcbComponentId.set(el.pcb_component_id, sourceName.name);
+        }
+      }
+    }
+    const otherComponentPadBounds = circuitJson.filter((el) => (el.type === "pcb_smtpad" || el.type === "pcb_plated_hole") && typeof el.pcb_component_id === "string" && el.pcb_component_id !== pcbComponent.pcb_component_id).map((el) => {
+      const bounds = getPadBounds(el);
+      if (!bounds)
+        return null;
+      const otherComponentName = sourceComponentNameByPcbComponentId.get(el.pcb_component_id);
+      if (!otherComponentName)
+        return null;
+      return {
+        bounds,
+        componentName: otherComponentName,
+        padName: getPadDisplayName(el, otherComponentName, sourcePortNameByPcbPortId)
+      };
+    }).filter((entry) => entry !== null);
+    let nearestPadClearance = null;
+    for (const ownPad of componentPadBounds) {
+      for (const otherPad of otherComponentPadBounds) {
+        const clearance = getBoundsClearance(ownPad.bounds, otherPad.bounds);
+        if (!nearestPadClearance || clearance < nearestPadClearance.clearance) {
+          nearestPadClearance = {
+            clearance,
+            componentName: otherPad.componentName,
+            padName: otherPad.padName
+          };
+        }
+      }
+    }
+    if (nearestPadClearance) {
+      const padClearanceLineItem = {
+        line_item_type: "component_pad_clearance",
+        component_name: componentName,
+        clearance: nearestPadClearance.clearance,
+        nearest_component_name: nearestPadClearance.componentName,
+        nearest_pad_name: nearestPadClearance.padName
+      };
+      lineItems.push(padClearanceLineItem);
+    }
+  }
   if (centerX !== null && centerY !== null) {
     const sourceComponentsById = /* @__PURE__ */ new Map;
     for (const el of circuitJson) {
@@ -177307,7 +177523,7 @@ Fuse2.config = Config;
 
 // cli/search/register.ts
 var registerSearch = (program3) => {
-  program3.command("search").description("Search for footprints, CAD models or packages in the tscircuit ecosystem").argument("<query>", "Search query (e.g. keyword, author, or package name)").option("--kicad", "Search KiCad footprints").option("--jlcpcb", "Search JLCPCB components").option("--lcsc", "Alias for --jlcpcb").option("--tscircuit", "Search tscircuit registry packages").action(async (query, opts) => {
+  program3.command("search").description("Search for footprints, CAD models or packages in the tscircuit ecosystem").argument("<query>", "Search query (e.g. keyword, author, or package name)").option("--kicad", "Search KiCad footprints").option("--jlcpcb", "Search JLCPCB components").option("--lcsc", "Alias for --jlcpcb").option("--tscircuit", "Search tscircuit registry packages").option("--json", "Output search results as JSON").action(async (query, opts) => {
     const hasFilters = opts.kicad || opts.jlcpcb || opts.lcsc || opts.tscircuit;
     const searchKicad = opts.kicad || !hasFilters;
     const searchJlc = opts.jlcpcb || opts.lcsc || !hasFilters;
@@ -177336,6 +177552,27 @@ var registerSearch = (program3) => {
       console.error(kleur_default.red("Failed to search registry:"), error instanceof Error ? error.message : error);
       process.exit(1);
     }
+    if (opts.json) {
+      const unifiedResults = [
+        ...kicadResults.map((path62) => ({
+          source: "kicad",
+          path: path62
+        })),
+        ...results.packages.map((pkg) => ({
+          source: "tscircuit",
+          ...pkg
+        })),
+        ...jlcResults.map((comp) => ({
+          source: "jlcpcb",
+          ...comp
+        }))
+      ];
+      console.log(JSON.stringify({
+        query,
+        results: unifiedResults
+      }, null, 2));
+      return;
+    }
     if (!kicadResults.length && !results.packages.length && !jlcResults.length) {
       const sources = [
         searchTscircuit && "tscircuit registry",

package/dist/lib/index.js

@@ -60435,7 +60435,7 @@ var getNodeHandler = (winterSpec, { port, middleware = [] }) => {
   }));
 };
 // package.json
-var version = "0.1.1053";
+var version = "0.1.1055";
 var package_default = {
   name: "@tscircuit/cli",
   version,
@@ -60447,7 +60447,7 @@ var package_default = {
   devDependencies: {
     "@babel/standalone": "^7.26.9",
     "@biomejs/biome": "^1.9.4",
-    "@tscircuit/circuit-json-placement-analysis": "^0.0.1",
+    "@tscircuit/circuit-json-placement-analysis": "^0.0.4",
     "@tscircuit/circuit-json-util": "0.0.81",
     "@tscircuit/fake-snippets": "^0.0.182",
     "@tscircuit/file-server": "^0.0.32",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tscircuit/cli",
-  "version": "0.1.1054",
+  "version": "0.1.1056",
   "main": "dist/cli/main.js",
   "exports": {
     ".": "./dist/cli/main.js",
@@ -9,7 +9,7 @@
   "devDependencies": {
     "@babel/standalone": "^7.26.9",
     "@biomejs/biome": "^1.9.4",
-    "@tscircuit/circuit-json-placement-analysis": "^0.0.1",
+    "@tscircuit/circuit-json-placement-analysis": "^0.0.4",
     "@tscircuit/circuit-json-util": "0.0.81",
     "@tscircuit/fake-snippets": "^0.0.182",
     "@tscircuit/file-server": "^0.0.32",