@tscircuit/core 0.0.829 → 0.0.831

package/dist/index.d.ts

@@ -913,6 +913,7 @@ declare const portProps: z.ZodObject<{
     schX: z.ZodOptional<z.ZodNumber>;
     schY: z.ZodOptional<z.ZodNumber>;
     direction: z.ZodOptional<z.ZodEnum<["up", "down", "left", "right"]>>;
+    connectsTo: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString, "many">]>>;
 }, "strip", z.ZodTypeAny, {
     name?: string | undefined;
     layer?: string | undefined;
@@ -922,6 +923,7 @@ declare const portProps: z.ZodObject<{
     schX?: number | undefined;
     schY?: number | undefined;
     direction?: "left" | "right" | "up" | "down" | undefined;
+    connectsTo?: string | string[] | undefined;
 }, {
     name?: string | undefined;
     layer?: string | undefined;
@@ -931,6 +933,7 @@ declare const portProps: z.ZodObject<{
     schX?: number | undefined;
     schY?: number | undefined;
     direction?: "left" | "right" | "up" | "down" | undefined;
+    connectsTo?: string | string[] | undefined;
 }>;
 declare class Port extends PrimitiveComponent<typeof portProps> {
     source_port_id: string | null;
@@ -951,6 +954,7 @@ declare class Port extends PrimitiveComponent<typeof portProps> {
             schX: z.ZodOptional<z.ZodNumber>;
             schY: z.ZodOptional<z.ZodNumber>;
             direction: z.ZodOptional<z.ZodEnum<["up", "down", "left", "right"]>>;
+            connectsTo: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString, "many">]>>;
         }, "strip", z.ZodTypeAny, {
             name?: string | undefined;
             layer?: string | undefined;
@@ -960,6 +964,7 @@ declare class Port extends PrimitiveComponent<typeof portProps> {
             schX?: number | undefined;
             schY?: number | undefined;
             direction?: "left" | "right" | "up" | "down" | undefined;
+            connectsTo?: string | string[] | undefined;
         }, {
             name?: string | undefined;
             layer?: string | undefined;
@@ -969,11 +974,15 @@ declare class Port extends PrimitiveComponent<typeof portProps> {
             schX?: number | undefined;
             schY?: number | undefined;
             direction?: "left" | "right" | "up" | "down" | undefined;
+            connectsTo?: string | string[] | undefined;
         }>;
     };
     constructor(props: z.input<typeof portProps>, opts?: {
         originDescription?: string;
     });
+    isGroupPort(): boolean;
+    isComponentPort(): boolean;
+    _getConnectedPortsFromConnectsTo(): Port[];
     _isBoardPinoutFromAttributes(): boolean | undefined;
     _getGlobalPcbPositionBeforeLayout(): {
         x: number;
@@ -1040,6 +1049,11 @@ declare class Port extends PrimitiveComponent<typeof portProps> {
     doInitialSourceParentAttachment(): void;
     doInitialPcbPortRender(): void;
     updatePcbPortRender(): void;
+    /**
+     * Get the best display label for this port based on port_hints
+     * Filters out generic patterns and applies showPinAliases logic
+     */
+    _getBestDisplayPinLabel(): string | undefined;
     doInitialSchematicPortRender(): void;
     _getSubcircuitConnectivityKey(): string | undefined;
     _setPositionFromLayout(newCenter: {
@@ -1189,6 +1203,10 @@ declare class NormalComponent<ZodProps extends z.ZodType = any, PortNames extend
      * appear on a schematic box, e.g. for a pin header
      */
     _getSchematicPortArrangement(): SchematicPortArrangement | null;
+    /**
+     * Extract pin labels from ports using existing Port logic
+     */
+    _getPinLabelsFromPorts(): Record<string, string>;
     _getSchematicBoxDimensions(): SchematicBoxDimensions | null;
     getFootprinterString(): string | null;
     doInitialCadModelRender(): void;

package/dist/index.js

@@ -3481,7 +3481,8 @@ var portProps = z6.object({
   layers: z6.array(z6.string()).optional(),
   schX: z6.number().optional(),
   schY: z6.number().optional(),
-  direction: z6.enum(["up", "down", "left", "right"]).optional()
+  direction: z6.enum(["up", "down", "left", "right"]).optional(),
+  connectsTo: z6.union([z6.string(), z6.array(z6.string())]).optional()
 });
 var Port = class extends PrimitiveComponent2 {
   source_port_id = null;
@@ -3509,6 +3510,28 @@ var Port = class extends PrimitiveComponent2 {
     }
     this.matchedComponents = [];
   }
+  isGroupPort() {
+    return this.parent?.componentName === "Group";
+  }
+  isComponentPort() {
+    return !this.isGroupPort();
+  }
+  _getConnectedPortsFromConnectsTo() {
+    const { _parsedProps: props } = this;
+    const connectsTo = props.connectsTo;
+    if (!connectsTo) return [];
+    const connectedPorts = [];
+    const connectsToArray = Array.isArray(connectsTo) ? connectsTo : [connectsTo];
+    for (const connection of connectsToArray) {
+      const port = this.getSubcircuit().selectOne(connection, {
+        type: "port"
+      });
+      if (port) {
+        connectedPorts.push(port);
+      }
+    }
+    return connectedPorts;
+  }
   _isBoardPinoutFromAttributes() {
     const parent = this.parent;
     if (parent?._parsedProps?.pinAttributes) {
@@ -3737,6 +3760,13 @@ var Port = class extends PrimitiveComponent2 {
     const { db } = this.root;
     const parentNormalComponent = this.getParentNormalComponent();
     const parentWithSourceId = this.parent?.source_component_id ? this.parent : parentNormalComponent;
+    if (this.isGroupPort()) {
+      db.source_port.update(this.source_port_id, {
+        source_component_id: null,
+        subcircuit_id: this.getSubcircuit()?.subcircuit_id
+      });
+      return;
+    }
     if (!parentWithSourceId?.source_component_id) {
       throw new Error(
         `${this.getString()} has no parent source component (parent: ${this.parent?.getString()})`
@@ -3752,6 +3782,30 @@ var Port = class extends PrimitiveComponent2 {
     if (this.root?.pcbDisabled) return;
     const { db } = this.root;
     const { matchedComponents } = this;
+    if (this.isGroupPort()) {
+      const connectedPorts = this._getConnectedPortsFromConnectsTo();
+      if (connectedPorts.length === 0) {
+        return;
+      }
+      const connectedPort = connectedPorts[0];
+      if (!connectedPort.pcb_port_id) {
+        return;
+      }
+      const connectedPcbPort = db.pcb_port.get(connectedPort.pcb_port_id);
+      const matchCenter2 = { x: connectedPcbPort.x, y: connectedPcbPort.y };
+      const subcircuit = this.getSubcircuit();
+      const pcb_port = db.pcb_port.insert({
+        pcb_component_id: void 0,
+        layers: connectedPort.getAvailablePcbLayers(),
+        subcircuit_id: subcircuit?.subcircuit_id ?? void 0,
+        pcb_group_id: this.getGroup()?.pcb_group_id ?? void 0,
+        ...matchCenter2,
+        source_port_id: this.source_port_id,
+        is_board_pinout: false
+      });
+      this.pcb_port_id = pcb_port.pcb_port_id;
+      return;
+    }
     const parentNormalComponent = this.getParentNormalComponent();
     const parentWithPcbComponentId = this.parent?.pcb_component_id ? this.parent : parentNormalComponent;
     if (!parentWithPcbComponentId?.pcb_component_id) {
@@ -3798,6 +3852,26 @@ var Port = class extends PrimitiveComponent2 {
     if (this.root?.pcbDisabled) return;
     const { db } = this.root;
     if (this.pcb_port_id) return;
+    if (this.isGroupPort()) {
+      const connectedPorts = this._getConnectedPortsFromConnectsTo();
+      if (connectedPorts.length === 0) return;
+      const connectedPort = connectedPorts[0];
+      if (!connectedPort.pcb_port_id) return;
+      const connectedPcbPort = db.pcb_port.get(connectedPort.pcb_port_id);
+      const matchCenter2 = { x: connectedPcbPort.x, y: connectedPcbPort.y };
+      const subcircuit2 = this.getSubcircuit();
+      const pcb_port2 = db.pcb_port.insert({
+        pcb_component_id: void 0,
+        layers: connectedPort.getAvailablePcbLayers(),
+        subcircuit_id: subcircuit2?.subcircuit_id ?? void 0,
+        pcb_group_id: this.getGroup()?.pcb_group_id ?? void 0,
+        ...matchCenter2,
+        source_port_id: this.source_port_id,
+        is_board_pinout: false
+      });
+      this.pcb_port_id = pcb_port2.pcb_port_id;
+      return;
+    }
     const pcbMatches = this.matchedComponents.filter((c) => c.isPcbPrimitive);
     if (pcbMatches.length === 0) return;
     let matchCenter = null;
@@ -3829,6 +3903,29 @@ var Port = class extends PrimitiveComponent2 {
     });
     this.pcb_port_id = pcb_port.pcb_port_id;
   }
+  /**
+   * Get the best display label for this port based on port_hints
+   * Filters out generic patterns and applies showPinAliases logic
+   */
+  _getBestDisplayPinLabel() {
+    const { db } = this.root;
+    const sourcePort = db.source_port.get(this.source_port_id);
+    const labelHints = [];
+    for (const portHint of sourcePort?.port_hints ?? []) {
+      if (portHint.match(/^(pin)?\d+$/)) continue;
+      if (portHint.match(/^(left|right)/) && !sourcePort?.name.match(/^(left|right)/))
+        continue;
+      labelHints.push(portHint);
+    }
+    const parentNormalComponent = this.getParentNormalComponent();
+    const showPinAliases = parentNormalComponent?.props?.showPinAliases;
+    if (showPinAliases && labelHints.length > 0) {
+      return labelHints.join("/");
+    } else if (labelHints.length > 0) {
+      return labelHints[0];
+    }
+    return void 0;
+  }
   doInitialSchematicPortRender() {
     const { db } = this.root;
     const { _parsedProps: props } = this;
@@ -3864,22 +3961,8 @@ var Port = class extends PrimitiveComponent2 {
         bottom: "down"
       }[localPortInfo.side];
     }
-    const sourcePort = db.source_port.get(this.source_port_id);
-    const labelHints = [];
-    for (const portHint of sourcePort?.port_hints ?? []) {
-      if (portHint.match(/^(pin)?\d+$/)) continue;
-      if (portHint.match(/^(left|right)/) && !sourcePort?.name.match(/^(left|right)/))
-        continue;
-      labelHints.push(portHint);
-    }
-    let bestDisplayPinLabel = void 0;
+    const bestDisplayPinLabel = this._getBestDisplayPinLabel();
     const parentNormalComponent = this.getParentNormalComponent();
-    const showPinAliases = parentNormalComponent?.props?.showPinAliases;
-    if (showPinAliases && labelHints.length > 0) {
-      bestDisplayPinLabel = labelHints.join("/");
-    } else if (labelHints.length > 0) {
-      bestDisplayPinLabel = labelHints[0];
-    }
     const schematicPortInsertProps = {
       type: "schematic_port",
       schematic_component_id: parentNormalComponent?.schematic_component_id,
@@ -3980,6 +4063,7 @@ var getSizeOfSidesFromPortArrangement = (pa) => {
 };
 
 // lib/utils/schematic/getAllDimensionsForSchematicBox.ts
+var DEFAULT_SCHEMATIC_BOX_PADDING_MM = 0.4;
 function isExplicitPinMappingArrangement(arrangement) {
   const a = arrangement;
   return a.leftSide !== void 0 || a.rightSide !== void 0 || a.topSide !== void 0 || a.bottomSide !== void 0;
@@ -4157,12 +4241,24 @@ var getAllDimensionsForSchematicBox = (params) => {
     }
     truePinIndex++;
   }
-  let schWidth = params.schWidth;
-  if (schWidth === void 0) {
-    schWidth = Math.max(
-      sideLengths.top + params.schPinSpacing * 2,
-      sideLengths.bottom + params.schPinSpacing * 2
+  let resolvedSchWidth = params.schWidth;
+  if (resolvedSchWidth === void 0) {
+    resolvedSchWidth = Math.max(
+      sideLengths.top + DEFAULT_SCHEMATIC_BOX_PADDING_MM,
+      sideLengths.bottom + DEFAULT_SCHEMATIC_BOX_PADDING_MM
     );
+    if (params.pinLabels) {
+      const leftRightPins = orderedTruePorts.filter(
+        (p) => p.side === "left" || p.side === "right"
+      );
+      const hasLeftRightLabels = leftRightPins.some(
+        (p) => params.pinLabels?.[`pin${p.pinNumber}`] || params.pinLabels?.[p.pinNumber]
+      );
+      if (hasLeftRightLabels) {
+        const MIN_WIDTH_FOR_SIDE_PINS = 0.5;
+        resolvedSchWidth = Math.max(resolvedSchWidth, MIN_WIDTH_FOR_SIDE_PINS);
+      }
+    }
     const labelWidth = params.pinLabels ? Math.max(
       ...Object.values(params.pinLabels).map(
         (label) => label.length * 0.1
@@ -4170,19 +4266,19 @@ var getAllDimensionsForSchematicBox = (params) => {
       )
     ) : 0;
     const LABEL_PADDING = labelWidth > 0 ? 1.1 : 0;
-    schWidth = Math.max(schWidth, labelWidth + LABEL_PADDING);
+    resolvedSchWidth = Math.max(resolvedSchWidth, labelWidth + LABEL_PADDING);
   }
   let schHeight = params.schHeight;
   if (!schHeight) {
     schHeight = Math.max(
-      sideLengths.left + params.schPinSpacing * 2,
-      sideLengths.right + params.schPinSpacing * 2
+      sideLengths.left + DEFAULT_SCHEMATIC_BOX_PADDING_MM,
+      sideLengths.right + DEFAULT_SCHEMATIC_BOX_PADDING_MM
     );
   }
   const trueEdgePositions = {
     // Top left corner
     left: {
-      x: -schWidth / 2 - portDistanceFromEdge,
+      x: -resolvedSchWidth / 2 - portDistanceFromEdge,
       y: sideLengths.left / 2
     },
     // bottom left corner
@@ -4192,7 +4288,7 @@ var getAllDimensionsForSchematicBox = (params) => {
     },
     // bottom right corner
     right: {
-      x: schWidth / 2 + portDistanceFromEdge,
+      x: resolvedSchWidth / 2 + portDistanceFromEdge,
       y: -sideLengths.right / 2
     },
     // top right corner
@@ -4228,11 +4324,11 @@ var getAllDimensionsForSchematicBox = (params) => {
       return port;
     },
     getSize() {
-      return { width: schWidth, height: schHeight };
+      return { width: resolvedSchWidth, height: schHeight };
     },
     getSizeIncludingPins() {
       return {
-        width: schWidth + (sidePinCounts.leftSize || sidePinCounts.rightSize ? 0.4 : 0),
+        width: resolvedSchWidth + (sidePinCounts.leftSize || sidePinCounts.rightSize ? 0.4 : 0),
         height: schHeight + (sidePinCounts.topSize || sidePinCounts.bottomSize ? 0.4 : 0)
       };
     },
@@ -8405,23 +8501,45 @@ var NormalComponent3 = class extends PrimitiveComponent2 {
   _getSchematicPortArrangement() {
     return this._parsedProps.schPinArrangement ?? this._parsedProps.schPortArrangement;
   }
+  /**
+   * Extract pin labels from ports using existing Port logic
+   */
+  _getPinLabelsFromPorts() {
+    const ports = this.selectAll("port");
+    const pinLabels = {};
+    for (const port of ports) {
+      const pinNumber = port.props.pinNumber;
+      if (pinNumber !== void 0) {
+        const bestLabel = port._getBestDisplayPinLabel();
+        if (bestLabel) {
+          pinLabels[`pin${pinNumber}`] = bestLabel;
+        }
+      }
+    }
+    return pinLabels;
+  }
   _getSchematicBoxDimensions() {
     if (this.getSchematicSymbol()) return null;
     if (!this.config.shouldRenderAsSchematicBox) return null;
     const { _parsedProps: props } = this;
     const pinCount = this._getPinCount();
     const pinSpacing = props.schPinSpacing ?? 0.2;
+    const pinLabelsFromPorts = this._getPinLabelsFromPorts();
+    const allPinLabels = {
+      ...pinLabelsFromPorts,
+      ...props.pinLabels
+    };
     const dimensions = getAllDimensionsForSchematicBox({
       schWidth: props.schWidth,
       schHeight: props.schHeight,
       schPinSpacing: pinSpacing,
       numericSchPinStyle: getNumericSchPinStyle(
         props.schPinStyle,
-        props.pinLabels
+        allPinLabels
       ),
       pinCount,
       schPortArrangement: this._getSchematicPortArrangement(),
-      pinLabels: props.pinLabels
+      pinLabels: allPinLabels
     });
     return dimensions;
   }
@@ -17365,7 +17483,7 @@ import { identity as identity6 } from "transformation-matrix";
 var package_default = {
   name: "@tscircuit/core",
   type: "module",
-  version: "0.0.828",
+  version: "0.0.830",
   types: "dist/index.d.ts",
   main: "dist/index.js",
   module: "dist/index.js",
@@ -17420,7 +17538,7 @@ var package_default = {
     "bun-match-svg": "0.0.12",
     "calculate-elbow": "^0.0.12",
     "chokidar-cli": "^3.0.0",
-    "circuit-json": "^0.0.291",
+    "circuit-json": "^0.0.295",
     "circuit-json-to-bpc": "^0.0.13",
     "circuit-json-to-connectivity-map": "^0.0.22",
     "circuit-json-to-gltf": "^0.0.31",

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@tscircuit/core",
   "type": "module",
-  "version": "0.0.829",
+  "version": "0.0.831",
   "types": "dist/index.d.ts",
   "main": "dist/index.js",
   "module": "dist/index.js",
@@ -56,7 +56,7 @@
     "bun-match-svg": "0.0.12",
     "calculate-elbow": "^0.0.12",
     "chokidar-cli": "^3.0.0",
-    "circuit-json": "^0.0.291",
+    "circuit-json": "^0.0.295",
     "circuit-json-to-bpc": "^0.0.13",
     "circuit-json-to-connectivity-map": "^0.0.22",
     "circuit-json-to-gltf": "^0.0.31",