@tscircuit/cli 0.1.2209 → 0.1.2211

package/dist/cli/main.js

@@ -154298,7 +154298,7 @@ var import_perfect_cli = __toESM3(require_dist3(), 1);
 // lib/getVersion.ts
 import { createRequire as createRequire2 } from "node:module";
 // package.json
-var version = "0.1.2208";
+var version = "0.1.2210";
 var package_default = {
   name: "@tscircuit/cli",
   version,
@@ -154327,7 +154327,7 @@ var package_default = {
     "@tscircuit/krt-wasm": "^0.1.6",
     "@tscircuit/math-utils": "0.0.36",
     "@tscircuit/props": "^0.0.657",
-    "@tscircuit/runframe": "^0.0.2866",
+    "@tscircuit/runframe": "^0.0.2867",
     "@tscircuit/schematic-match-adapt": "^0.0.22",
     "@tscircuit/schematic-trace-solver": "^0.0.204",
     "@tscircuit/solver-utils": "0.0.16",
@@ -154355,7 +154355,7 @@ var package_default = {
     "circuit-json-to-readable-netlist": "^0.0.15",
     "circuit-json-to-spice": "^0.0.45",
     "circuit-json-to-step": "^0.0.38",
-    "circuit-json-to-tscircuit": "^0.0.42",
+    "circuit-json-to-tscircuit": "^0.0.50",
     "circuit-json-trace-length-analysis": "github:tscircuit/circuit-json-trace-length-analysis#2b44792a40df0ca83b6bfb6ac95ed5e35e7168b8",
     "circuit-to-canvas": "^0.0.123",
     "circuit-to-svg": "^0.0.430",
@@ -335799,7 +335799,7 @@ var mmStr = (n) => {
   return `${mm3(n)}mm`;
 };
 
-// node_modules/circuit-json-to-tscircuit/dist/chunk-UXTI3RT6.js
+// node_modules/circuit-json-to-tscircuit/dist/chunk-6TIIS52N.js
 import { su as su122 } from "@tscircuit/soup-util";
 import { su as su13 } from "@tscircuit/soup-util";
 import { su as su24 } from "@tscircuit/soup-util";
@@ -336180,7 +336180,14 @@ var convertSilkscreen = (circuitJson) => {
   const silkscreenCircles = su92(circuitJson).pcb_silkscreen_circle.list();
   const elementStrings = [];
   for (const silkscreenPath of silkscreenPaths) {
-    elementStrings.push(`<silkscreenpath route={${JSON.stringify(silkscreenPath.route)}} />`);
+    const attrs = [`route={${JSON.stringify(silkscreenPath.route)}}`];
+    if (silkscreenPath.stroke_width !== undefined) {
+      attrs.push(`strokeWidth={${silkscreenPath.stroke_width}}`);
+    }
+    if (silkscreenPath.layer === "bottom") {
+      attrs.push(`layer="bottom"`);
+    }
+    elementStrings.push(`<silkscreenpath ${attrs.join(" ")} />`);
   }
   for (const silkscreenRect of silkscreenRects) {
     const center = silkscreenRect.center ?? { x: 0, y: 0 };
@@ -336277,7 +336284,7 @@ var convertSmtPads = (circuitJson) => {
       elementStrings.push(`<smtpad ${commonAttrs.join(" ")}${solderMaskAttrs} shape="polygon" points={${JSON.stringify(smtPad.points)}} />`);
     } else if (smtPad.shape === "rotated_rect") {
       const cornerRadius = smtPad.corner_radius ?? smtPad.rect_border_radius ?? undefined;
-      elementStrings.push(`<smtpad ${commonAttrs.join(" ")}${solderMaskAttrs}${formatOptionalMmAttr("cornerRadius", cornerRadius)}${formatOptionalMmAttr("solderMaskMarginLeft", smtPad.soldermask_margin_left)}${formatOptionalMmAttr("solderMaskMarginTop", smtPad.soldermask_margin_top)}${formatOptionalMmAttr("solderMaskMarginRight", smtPad.soldermask_margin_right)}${formatOptionalMmAttr("solderMaskMarginBottom", smtPad.soldermask_margin_bottom)} width="${mmStr(smtPad.width ?? 0)}" height="${mmStr(smtPad.height ?? 0)}"${formatPcbRotationAttr(smtPad.ccw_rotation)} shape="rotated_rect" />`);
+      elementStrings.push(`<smtpad ${commonAttrs.join(" ")}${solderMaskAttrs}${formatOptionalMmAttr("cornerRadius", cornerRadius)}${formatOptionalMmAttr("solderMaskMarginLeft", smtPad.soldermask_margin_left)}${formatOptionalMmAttr("solderMaskMarginTop", smtPad.soldermask_margin_top)}${formatOptionalMmAttr("solderMaskMarginRight", smtPad.soldermask_margin_right)}${formatOptionalMmAttr("solderMaskMarginBottom", smtPad.soldermask_margin_bottom)} width="${mmStr(smtPad.width ?? 0)}" height="${mmStr(smtPad.height ?? 0)}" ccwRotation={${smtPad.ccw_rotation ?? 0}} shape="rotated_rect" />`);
     }
   }
   return elementStrings;
@@ -336555,6 +336562,82 @@ var generateSymbolTsx = (circuitJson) => {
 </symbol>
   `.trim();
 };
+var attributeNames2 = {
+  is_input: "isInput",
+  is_output: "isOutput",
+  is_bidirectional: "isBidirectional",
+  is_passive: "isPassive",
+  can_use_tri_state: "canUseTriState",
+  is_using_tri_state: "isUsingTriState",
+  can_use_open_collector: "canUseOpenCollector",
+  is_using_open_collector: "isUsingOpenCollector",
+  can_use_open_emitter: "canUseOpenEmitter",
+  is_using_open_emitter: "isUsingOpenEmitter",
+  is_gpio: "isGpio",
+  highlight_color: "highlightColor",
+  must_be_connected: "mustBeConnected",
+  provides_power: "providesPower",
+  requires_power: "requiresPower",
+  provides_ground: "providesGround",
+  requires_ground: "requiresGround",
+  provides_voltage: "providesVoltage",
+  requires_voltage: "requiresVoltage",
+  do_not_connect: "doNotConnect",
+  include_in_board_pinout: "includeInBoardPinout",
+  can_use_internal_pullup: "canUseInternalPullup",
+  is_using_internal_pullup: "isUsingInternalPullup",
+  needs_external_pullup: "needsExternalPullup",
+  can_use_internal_pulldown: "canUseInternalPulldown",
+  is_using_internal_pulldown: "isUsingInternalPulldown",
+  needs_external_pulldown: "needsExternalPulldown",
+  can_use_open_drain: "canUseOpenDrain",
+  is_using_open_drain: "isUsingOpenDrain",
+  can_use_push_pull: "canUsePushPull",
+  is_using_push_pull: "isUsingPushPull",
+  should_have_decoupling_capacitor: "shouldHaveDecouplingCapacitor",
+  recommended_decoupling_capacitor_capacitance: "recommendedDecouplingCapacitorCapacitance"
+};
+var capabilities = [
+  "i2c_sda",
+  "i2c_scl",
+  "spi_mosi",
+  "spi_miso",
+  "spi_sck",
+  "spi_cs",
+  "uart_tx",
+  "uart_rx"
+];
+var getPinAttributes = (circuitJson) => {
+  const components = circuitJson.filter((e) => e.type === "source_component");
+  if (components.length > 1)
+    return;
+  const componentId = components[0]?.source_component_id;
+  const pins = /* @__PURE__ */ new Map;
+  for (const port of circuitJson) {
+    if (port.type !== "source_port")
+      continue;
+    if (componentId && port.source_component_id && port.source_component_id !== componentId)
+      continue;
+    const source = { ...port };
+    const attributes = {};
+    for (const [sourceName, propName] of Object.entries(attributeNames2)) {
+      if (source[sourceName] !== undefined) {
+        attributes[propName] = source[sourceName];
+      }
+    }
+    const supported = capabilities.filter((c) => source[`supports_${c}`] === true);
+    const active = capabilities.filter((c) => source[`is_configured_for_${c}`] === true);
+    if (supported.length)
+      attributes.capabilities = supported;
+    if (active.length)
+      attributes.activeCapabilities = active;
+    if (Object.keys(attributes).length === 0)
+      continue;
+    const key = port.pin_number !== undefined ? `pin${port.pin_number}` : port.name;
+    pins.set(key, { ...pins.get(key), ...attributes });
+  }
+  return pins.size ? Object.fromEntries(pins) : undefined;
+};
 var getComponentUsingTemplate = ({
   pinLabels,
   componentName,
@@ -336565,6 +336648,7 @@ var getComponentUsingTemplate = ({
 }) => {
   const footprintTsx = generateFootprintTsx(circuitJson);
   const symbolTsx = generateSymbolTsx(circuitJson);
+  const pinAttributes = getPinAttributes(circuitJson);
   return `
 import { type ChipProps } from "tscircuit"
 ${pinLabels ? `const pinLabels = ${JSON.stringify(pinLabels, null, "  ")} as const
@@ -336573,6 +336657,7 @@ ${pinLabels ? `const pinLabels = ${JSON.stringify(pinLabels, null, "  ")} as con
     ${footprintTsx ? `footprint={${footprintTsx}}` : ""}
     ${symbolTsx ? `symbol={${symbolTsx}}` : ""}
     ${pinLabels ? "pinLabels={pinLabels}" : ""}
+    ${pinAttributes ? `pinAttributes={${JSON.stringify(pinAttributes, null, "  ")}}` : ""}
     ${objUrl ? `cadModel={{
         objUrl: "${objUrl}",
         rotationOffset: { x: 0, y: 0, z: 0 },
@@ -375180,6 +375265,76 @@ function normalizeManufacturerPartNumber2(partNumber) {
 import fs66 from "node:fs/promises";
 import path75 from "node:path";
 
+// lib/import/fetch-datasheet-pin-attributes.ts
+import { commonComponentProps as commonComponentProps2 } from "@tscircuit/props";
+import { z as z204 } from "zod";
+var responseSchema = z204.object({
+  datasheet: z204.object({
+    chip_name: z204.string(),
+    pin_attributes: commonComponentProps2.shape.pinAttributes.nullable()
+  })
+});
+var normalizeChipName = (name) => name.replace(/[^0-9a-zA-Z_-]/g, "").toLowerCase();
+var fetchDatasheetPinAttributes = async (manufacturerPartNumber) => {
+  if (!manufacturerPartNumber)
+    return;
+  const chipName = normalizeChipName(manufacturerPartNumber);
+  if (!/[a-z0-9]/.test(chipName))
+    return;
+  const signal = AbortSignal.timeout(5000);
+  try {
+    const url = new URL(`${getRegistryApiUrl().replace(/\/$/, "")}/datasheets/get`);
+    url.searchParams.set("chip_name", chipName);
+    const response = await fetch(url, { signal });
+    if (response.status === 404)
+      return;
+    if (!response.ok)
+      throw new Error(`HTTP ${response.status}`);
+    const parsed = responseSchema.safeParse(await response.json());
+    if (!parsed.success)
+      throw new Error("invalid datasheet response");
+    const { datasheet } = parsed.data;
+    if (normalizeChipName(datasheet.chip_name) !== chipName) {
+      throw new Error("datasheet manufacturer part number does not match");
+    }
+    return datasheet.pin_attributes ?? undefined;
+  } catch (error) {
+    const message = signal.aborted || error instanceof Error && error.name === "TimeoutError" ? `Datasheet API did not respond within 5 seconds for ${manufacturerPartNumber}` : `Could not load datasheet pin attributes for ${manufacturerPartNumber}: ${error instanceof Error ? error.message : "request failed"}`;
+    console.warn(`${message}. pinAttributes may not be populated. Continuing with imported attributes.`);
+    return;
+  }
+};
+
+// lib/import/add-datasheet-attributes-to-circuit-json.ts
+var addDatasheetAttributesToCircuitJson = (circuitJson, pinAttributes) => {
+  const components = circuitJson.filter((element) => element.type === "source_component");
+  if (components.length !== 1)
+    return circuitJson;
+  return circuitJson.map((element) => {
+    if (element.type !== "source_port" || element.source_component_id !== components[0].source_component_id)
+      return element;
+    const pinKey = element.pin_number !== undefined ? `pin${element.pin_number}` : element.name;
+    const keys = new Set([...element.port_hints ?? [], element.name]);
+    keys.delete(pinKey);
+    keys.add(pinKey);
+    const attributes = Object.assign({}, ...[...keys].map((key) => pinAttributes[key]));
+    const sourceAttributes = {};
+    for (const [key, value] of Object.entries(attributes)) {
+      if (value === undefined)
+        continue;
+      if (key === "capabilities" || key === "activeCapabilities" || key === "activeCapability") {
+        const prefix = key === "capabilities" ? "supports_" : "is_configured_for_";
+        for (const capability of Array.isArray(value) ? value : [value]) {
+          sourceAttributes[`${prefix}${capability}`] = true;
+        }
+      } else {
+        sourceAttributes[key.replace(/[A-Z]/g, (letter) => `_${letter.toLowerCase()}`)] = value;
+      }
+    }
+    return { ...element, ...sourceAttributes };
+  });
+};
+
 // lib/import/add-cad-model-to-tsx.ts
 var addCadModelToTsx = (tsx, cadModel, cadComponent) => {
   if (tsx.includes("cadModel={{") || !cadModel.objUrl && !cadModel.stepUrl) {
@@ -375411,11 +375566,35 @@ var importComponentFromJlcpcb = async (jlcpcbPartNumber, projectDir = process.cw
   const rawEasy = await fetchEasyEDAComponent(jlcpcbPartNumber);
   const betterEasy = EasyEdaJsonSchema2.parse(rawEasy);
   const rawPn = betterEasy.dataStr.head.c_para["Manufacturer Part"];
+  const datasheetAttributesPromise = options.excludePinAttributes ? undefined : fetchDatasheetPinAttributes(rawPn);
   const componentName = rawPn ? normalizeManufacturerPartNumber2(rawPn) : jlcpcbPartNumber;
-  let tsx = await convertRawEasyToTsx({ rawEasy });
-  const circuitJson = convertEasyEdaJsonToCircuitJson2(betterEasy, {
+  let circuitJson = convertEasyEdaJsonToCircuitJson2(betterEasy, {
     useModelCdn: true
   });
+  const datasheetAttributes = await datasheetAttributesPromise;
+  let tsx;
+  if (datasheetAttributes && Object.keys(datasheetAttributes).length > 0) {
+    circuitJson = addDatasheetAttributesToCircuitJson(circuitJson, datasheetAttributes);
+    const pinLabels = Object.fromEntries(circuitJson.flatMap((element) => {
+      if (element.type !== "source_port")
+        return [];
+      const pinKey = element.pin_number !== undefined ? `pin${element.pin_number}` : element.name;
+      return [
+        [
+          pinKey,
+          (element.port_hints ?? [element.name]).filter((label) => label !== pinKey)
+        ]
+      ];
+    }));
+    tsx = convertCircuitJsonToTscircuit(circuitJson, {
+      componentName,
+      pinLabels,
+      manufacturerPartNumber: rawPn ?? undefined,
+      supplierPartNumbers: { jlcpcb: [jlcpcbPartNumber] }
+    });
+  } else {
+    tsx = await convertRawEasyToTsx({ rawEasy });
+  }
   const footprintConversion = options.useExactFootprint ? { mode: "exact-requested", tsx } : convertImportedFootprintToFootprinter({
     circuitJson,
     sourceHints: getEasyEdaFootprinterSourceHints(rawEasy),
@@ -375465,7 +375644,8 @@ var logFootprintConversion = (conversion) => {
 var importJlcpcbPart = async ({
   download,
   partNumber,
-  useExactFootprint
+  useExactFootprint,
+  excludePinAttributes
 }) => {
   const spinner = ora({
     text: `Importing "${partNumber}" from JLCPCB...`,
@@ -375474,7 +375654,8 @@ var importJlcpcbPart = async ({
   try {
     const { filePath, footprintConversion } = await importComponentFromJlcpcb(partNumber, process.cwd(), {
       download,
-      useExactFootprint
+      useExactFootprint,
+      excludePinAttributes
     });
     spinner.succeed(kleur_default.green(`Imported ${filePath}`));
     logFootprintConversion(footprintConversion);
@@ -375496,7 +375677,7 @@ var parseDirectLcscPartNumber = (query) => {
 
 // cli/import/register.ts
 var registerImport = (program) => {
-  program.command("import").description("Search JLCPCB or the tscircuit registry and import a component").argument("<query...>", "Chip name, part number, or package name").option("--jlcpcb", "Search JLCPCB components").option("--lcsc", "Alias for --jlcpcb").option("--tscircuit", "Search tscircuit registry packages").option("--download", "Download 3D model assets (.step, .obj) locally").option("--use-exact-footprint", "Keep the exact EasyEDA footprint instead of using a >98% footprinter match").action(async (queryParts, opts) => {
+  program.command("import").description("Search JLCPCB or the tscircuit registry and import a component").argument("<query...>", "Chip name, part number, or package name").option("--jlcpcb", "Search JLCPCB components").option("--lcsc", "Alias for --jlcpcb").option("--tscircuit", "Search tscircuit registry packages").option("--download", "Download 3D model assets (.step, .obj) locally").option("--exclude-pin-attributes", "Skip datasheet pin attributes when importing").option("--use-exact-footprint", "Keep the exact EasyEDA footprint instead of using a >98% footprinter match").action(async (queryParts, opts) => {
     const query = getQueryFromParts(queryParts);
     const hasFilters = opts.jlcpcb || opts.lcsc || opts.tscircuit;
     const searchJlc = opts.jlcpcb || opts.lcsc || !hasFilters;
@@ -375536,7 +375717,8 @@ var registerImport = (program) => {
         await importJlcpcbPart({
           download: opts.download,
           partNumber: directLcscPartNumber,
-          useExactFootprint: opts.useExactFootprint
+          useExactFootprint: opts.useExactFootprint,
+          excludePinAttributes: opts.excludePinAttributes
         });
         return;
       }
@@ -375586,7 +375768,8 @@ var registerImport = (program) => {
       await importJlcpcbPart({
         download: opts.download,
         partNumber: `C${String(choice.part)}`,
-        useExactFootprint: opts.useExactFootprint
+        useExactFootprint: opts.useExactFootprint,
+        excludePinAttributes: opts.excludePinAttributes
       });
     }
   });

package/dist/lib/index.js

@@ -69109,7 +69109,7 @@ var getNodeHandler = (winterSpec, { port, middleware = [] }) => {
   }));
 };
 // package.json
-var version = "0.1.2208";
+var version = "0.1.2210";
 var package_default = {
   name: "@tscircuit/cli",
   version,
@@ -69138,7 +69138,7 @@ var package_default = {
     "@tscircuit/krt-wasm": "^0.1.6",
     "@tscircuit/math-utils": "0.0.36",
     "@tscircuit/props": "^0.0.657",
-    "@tscircuit/runframe": "^0.0.2866",
+    "@tscircuit/runframe": "^0.0.2867",
     "@tscircuit/schematic-match-adapt": "^0.0.22",
     "@tscircuit/schematic-trace-solver": "^0.0.204",
     "@tscircuit/solver-utils": "0.0.16",
@@ -69166,7 +69166,7 @@ var package_default = {
     "circuit-json-to-readable-netlist": "^0.0.15",
     "circuit-json-to-spice": "^0.0.45",
     "circuit-json-to-step": "^0.0.38",
-    "circuit-json-to-tscircuit": "^0.0.42",
+    "circuit-json-to-tscircuit": "^0.0.50",
     "circuit-json-trace-length-analysis": "github:tscircuit/circuit-json-trace-length-analysis#2b44792a40df0ca83b6bfb6ac95ed5e35e7168b8",
     "circuit-to-canvas": "^0.0.123",
     "circuit-to-svg": "^0.0.430",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tscircuit/cli",
-  "version": "0.1.2209",
+  "version": "0.1.2211",
   "repository": {
     "type": "git",
     "url": "https://github.com/tscircuit/cli"
@@ -26,7 +26,7 @@
     "@tscircuit/krt-wasm": "^0.1.6",
     "@tscircuit/math-utils": "0.0.36",
     "@tscircuit/props": "^0.0.657",
-    "@tscircuit/runframe": "^0.0.2866",
+    "@tscircuit/runframe": "^0.0.2867",
     "@tscircuit/schematic-match-adapt": "^0.0.22",
     "@tscircuit/schematic-trace-solver": "^0.0.204",
     "@tscircuit/solver-utils": "0.0.16",
@@ -54,7 +54,7 @@
     "circuit-json-to-readable-netlist": "^0.0.15",
     "circuit-json-to-spice": "^0.0.45",
     "circuit-json-to-step": "^0.0.38",
-    "circuit-json-to-tscircuit": "^0.0.42",
+    "circuit-json-to-tscircuit": "^0.0.50",
     "circuit-json-trace-length-analysis": "github:tscircuit/circuit-json-trace-length-analysis#2b44792a40df0ca83b6bfb6ac95ed5e35e7168b8",
     "circuit-to-canvas": "^0.0.123",
     "circuit-to-svg": "^0.0.430",