@tscircuit/core 0.0.1273 → 0.0.1274

package/dist/index.d.ts

@@ -73055,14 +73055,190 @@ declare class Footprint extends PrimitiveComponent<typeof footprintProps> {
 
 declare class Breakout extends Group<typeof breakoutProps> {
     constructor(props: z.input<typeof breakoutProps>);
+    /**
+     * Find ports inside this breakout group that are connected to traces
+     * crossing the breakout boundary, and create auto-placed BreakoutPoint
+     * children for them. Positions are not set here — they will be determined
+     * after PcbLayout.
+     */
+    doInitialCreateAutoplacedBreakoutPoints(): void;
     doInitialPcbPrimitiveRender(): void;
 }
 
-declare class BreakoutPoint extends PrimitiveComponent<typeof breakoutPointProps> {
+/**
+ * Shared base props for breakout points — layout props without rotation/layer.
+ * Subclasses extend this schema with additional fields (e.g. `connection`).
+ */
+declare const baseBreakoutPointProps: zod.ZodObject<Omit<{
+    pcbX: zod.ZodOptional<zod.ZodUnion<[zod.ZodString, zod.ZodEffects<zod.ZodUnion<[zod.ZodString, zod.ZodNumber]>, number, string | number>]>>;
+    pcbY: zod.ZodOptional<zod.ZodUnion<[zod.ZodString, zod.ZodEffects<zod.ZodUnion<[zod.ZodString, zod.ZodNumber]>, number, string | number>]>>;
+    pcbLeftEdgeX: zod.ZodOptional<zod.ZodUnion<[zod.ZodString, zod.ZodEffects<zod.ZodUnion<[zod.ZodString, zod.ZodNumber]>, number, string | number>]>>;
+    pcbRightEdgeX: zod.ZodOptional<zod.ZodUnion<[zod.ZodString, zod.ZodEffects<zod.ZodUnion<[zod.ZodString, zod.ZodNumber]>, number, string | number>]>>;
+    pcbTopEdgeY: zod.ZodOptional<zod.ZodUnion<[zod.ZodString, zod.ZodEffects<zod.ZodUnion<[zod.ZodString, zod.ZodNumber]>, number, string | number>]>>;
+    pcbBottomEdgeY: zod.ZodOptional<zod.ZodUnion<[zod.ZodString, zod.ZodEffects<zod.ZodUnion<[zod.ZodString, zod.ZodNumber]>, number, string | number>]>>;
+    pcbOffsetX: zod.ZodOptional<zod.ZodEffects<zod.ZodUnion<[zod.ZodString, zod.ZodNumber]>, number, string | number>>;
+    pcbOffsetY: zod.ZodOptional<zod.ZodEffects<zod.ZodUnion<[zod.ZodString, zod.ZodNumber]>, number, string | number>>;
+    pcbRotation: zod.ZodOptional<zod.ZodEffects<zod.ZodUnion<[zod.ZodString, zod.ZodNumber]>, number, string | number>>;
+    pcbPositionAnchor: zod.ZodOptional<zod.ZodString>;
+    pcbPositionMode: zod.ZodOptional<zod.ZodEnum<["relative_to_group_anchor", "auto", "relative_to_board_anchor", "relative_to_component_anchor"]>>;
+    shouldBeOnEdgeOfBoard: zod.ZodOptional<zod.ZodBoolean>;
+    layer: zod.ZodOptional<zod.ZodEffects<zod.ZodUnion<[zod.ZodEnum<["top", "bottom", "inner1", "inner2", "inner3", "inner4", "inner5", "inner6"]>, zod.ZodObject<{
+        name: zod.ZodEnum<["top", "bottom", "inner1", "inner2", "inner3", "inner4", "inner5", "inner6"]>;
+    }, "strip", zod.ZodTypeAny, {
+        name: "top" | "bottom" | "inner1" | "inner2" | "inner3" | "inner4" | "inner5" | "inner6";
+    }, {
+        name: "top" | "bottom" | "inner1" | "inner2" | "inner3" | "inner4" | "inner5" | "inner6";
+    }>]>, "top" | "bottom" | "inner1" | "inner2" | "inner3" | "inner4" | "inner5" | "inner6", "top" | "bottom" | "inner1" | "inner2" | "inner3" | "inner4" | "inner5" | "inner6" | {
+        name: "top" | "bottom" | "inner1" | "inner2" | "inner3" | "inner4" | "inner5" | "inner6";
+    }>>;
+    pcbMarginTop: zod.ZodOptional<zod.ZodEffects<zod.ZodUnion<[zod.ZodString, zod.ZodNumber]>, number, string | number>>;
+    pcbMarginRight: zod.ZodOptional<zod.ZodEffects<zod.ZodUnion<[zod.ZodString, zod.ZodNumber]>, number, string | number>>;
+    pcbMarginBottom: zod.ZodOptional<zod.ZodEffects<zod.ZodUnion<[zod.ZodString, zod.ZodNumber]>, number, string | number>>;
+    pcbMarginLeft: zod.ZodOptional<zod.ZodEffects<zod.ZodUnion<[zod.ZodString, zod.ZodNumber]>, number, string | number>>;
+    pcbMarginX: zod.ZodOptional<zod.ZodEffects<zod.ZodUnion<[zod.ZodString, zod.ZodNumber]>, number, string | number>>;
+    pcbMarginY: zod.ZodOptional<zod.ZodEffects<zod.ZodUnion<[zod.ZodString, zod.ZodNumber]>, number, string | number>>;
+    pcbStyle: zod.ZodOptional<zod.ZodObject<{
+        silkscreenFontSize: zod.ZodOptional<zod.ZodEffects<zod.ZodUnion<[zod.ZodString, zod.ZodNumber]>, number, string | number>>;
+        viaPadDiameter: zod.ZodOptional<zod.ZodEffects<zod.ZodUnion<[zod.ZodString, zod.ZodNumber]>, number, string | number>>;
+        viaHoleDiameter: zod.ZodOptional<zod.ZodEffects<zod.ZodUnion<[zod.ZodString, zod.ZodNumber]>, number, string | number>>;
+        silkscreenTextPosition: zod.ZodOptional<zod.ZodUnion<[zod.ZodEnum<["centered", "outside", "none"]>, zod.ZodObject<{
+            offsetX: zod.ZodNumber;
+            offsetY: zod.ZodNumber;
+        }, "strip", zod.ZodTypeAny, {
+            offsetX: number;
+            offsetY: number;
+        }, {
+            offsetX: number;
+            offsetY: number;
+        }>]>>;
+        silkscreenTextVisibility: zod.ZodOptional<zod.ZodEnum<["hidden", "visible", "inherit"]>>;
+    }, "strip", zod.ZodTypeAny, {
+        silkscreenFontSize?: number | undefined;
+        viaPadDiameter?: number | undefined;
+        viaHoleDiameter?: number | undefined;
+        silkscreenTextPosition?: "centered" | "outside" | "none" | {
+            offsetX: number;
+            offsetY: number;
+        } | undefined;
+        silkscreenTextVisibility?: "hidden" | "visible" | "inherit" | undefined;
+    }, {
+        silkscreenFontSize?: string | number | undefined;
+        viaPadDiameter?: string | number | undefined;
+        viaHoleDiameter?: string | number | undefined;
+        silkscreenTextPosition?: "centered" | "outside" | "none" | {
+            offsetX: number;
+            offsetY: number;
+        } | undefined;
+        silkscreenTextVisibility?: "hidden" | "visible" | "inherit" | undefined;
+    }>>;
+    pcbSx: zod.ZodOptional<ZodType<_tscircuit_props.PcbSx, zod.ZodTypeDef, _tscircuit_props.PcbSx>>;
+    pcbRelative: zod.ZodOptional<zod.ZodBoolean>;
+    relative: zod.ZodOptional<zod.ZodBoolean>;
+}, "layer" | "pcbRotation">, "strip", zod.ZodTypeAny, {
+    pcbX?: string | number | undefined;
+    pcbY?: string | number | undefined;
+    pcbLeftEdgeX?: string | number | undefined;
+    pcbRightEdgeX?: string | number | undefined;
+    pcbTopEdgeY?: string | number | undefined;
+    pcbBottomEdgeY?: string | number | undefined;
+    relative?: boolean | undefined;
+    pcbOffsetX?: number | undefined;
+    pcbOffsetY?: number | undefined;
+    pcbPositionAnchor?: string | undefined;
+    pcbPositionMode?: "auto" | "relative_to_group_anchor" | "relative_to_board_anchor" | "relative_to_component_anchor" | undefined;
+    shouldBeOnEdgeOfBoard?: boolean | undefined;
+    pcbMarginTop?: number | undefined;
+    pcbMarginRight?: number | undefined;
+    pcbMarginBottom?: number | undefined;
+    pcbMarginLeft?: number | undefined;
+    pcbMarginX?: number | undefined;
+    pcbMarginY?: number | undefined;
+    pcbStyle?: {
+        silkscreenFontSize?: number | undefined;
+        viaPadDiameter?: number | undefined;
+        viaHoleDiameter?: number | undefined;
+        silkscreenTextPosition?: "centered" | "outside" | "none" | {
+            offsetX: number;
+            offsetY: number;
+        } | undefined;
+        silkscreenTextVisibility?: "hidden" | "visible" | "inherit" | undefined;
+    } | undefined;
+    pcbSx?: _tscircuit_props.PcbSx | undefined;
+    pcbRelative?: boolean | undefined;
+}, {
+    pcbX?: string | number | undefined;
+    pcbY?: string | number | undefined;
+    pcbLeftEdgeX?: string | number | undefined;
+    pcbRightEdgeX?: string | number | undefined;
+    pcbTopEdgeY?: string | number | undefined;
+    pcbBottomEdgeY?: string | number | undefined;
+    relative?: boolean | undefined;
+    pcbOffsetX?: string | number | undefined;
+    pcbOffsetY?: string | number | undefined;
+    pcbPositionAnchor?: string | undefined;
+    pcbPositionMode?: "auto" | "relative_to_group_anchor" | "relative_to_board_anchor" | "relative_to_component_anchor" | undefined;
+    shouldBeOnEdgeOfBoard?: boolean | undefined;
+    pcbMarginTop?: string | number | undefined;
+    pcbMarginRight?: string | number | undefined;
+    pcbMarginBottom?: string | number | undefined;
+    pcbMarginLeft?: string | number | undefined;
+    pcbMarginX?: string | number | undefined;
+    pcbMarginY?: string | number | undefined;
+    pcbStyle?: {
+        silkscreenFontSize?: string | number | undefined;
+        viaPadDiameter?: string | number | undefined;
+        viaHoleDiameter?: string | number | undefined;
+        silkscreenTextPosition?: "centered" | "outside" | "none" | {
+            offsetX: number;
+            offsetY: number;
+        } | undefined;
+        silkscreenTextVisibility?: "hidden" | "visible" | "inherit" | undefined;
+    } | undefined;
+    pcbSx?: _tscircuit_props.PcbSx | undefined;
+    pcbRelative?: boolean | undefined;
+}>;
+/**
+ * Base class for both user-facing `BreakoutPoint` (which requires a
+ * `connection` prop) and the internal `AutoplacedBreakoutPoint` (which
+ * receives its `matchedPort` programmatically).
+ */
+declare class BaseBreakoutPoint<TProps extends ZodType = typeof baseBreakoutPointProps> extends PrimitiveComponent<TProps> {
     pcb_breakout_point_id: string | null;
     matchedPort: Port | null;
     matchedNet: Net | null;
     isPcbPrimitive: boolean;
+    _getSourceTraceIdForPort(port: Port): string | undefined;
+    _getSourceNetIdForPort(port: Port): string | undefined;
+    _renderPcbBreakoutPoint(): void;
+    _getPcbCircuitJsonBounds(): {
+        center: {
+            x: number;
+            y: number;
+        };
+        bounds: {
+            left: number;
+            top: number;
+            right: number;
+            bottom: number;
+        };
+        width: number;
+        height: number;
+    };
+    _setPositionFromLayout(newCenter: {
+        x: number;
+        y: number;
+    }): void;
+    _moveCircuitJsonElements({ deltaX, deltaY, }: {
+        deltaX: number;
+        deltaY: number;
+    }): void;
+    getPcbSize(): {
+        width: number;
+        height: number;
+    };
+}
+
+declare class BreakoutPoint extends BaseBreakoutPoint<typeof breakoutPointProps> {
     get config(): {
         componentName: string;
         zodProps: zod.ZodObject<Omit<{
@@ -73199,35 +73375,7 @@ declare class BreakoutPoint extends PrimitiveComponent<typeof breakoutPointProps
         }>;
     };
     _matchConnection(): void;
-    _getSourceTraceIdForPort(port: Port): string | undefined;
-    _getSourceNetIdForPort(port: Port): string | undefined;
     doInitialPcbPrimitiveRender(): void;
-    _getPcbCircuitJsonBounds(): {
-        center: {
-            x: number;
-            y: number;
-        };
-        bounds: {
-            left: number;
-            top: number;
-            right: number;
-            bottom: number;
-        };
-        width: number;
-        height: number;
-    };
-    _setPositionFromLayout(newCenter: {
-        x: number;
-        y: number;
-    }): void;
-    _moveCircuitJsonElements({ deltaX, deltaY, }: {
-        deltaX: number;
-        deltaY: number;
-    }): void;
-    getPcbSize(): {
-        width: number;
-        height: number;
-    };
 }
 
 declare class Hole extends PrimitiveComponent<typeof holeProps> {

package/dist/index.js

@@ -21806,7 +21806,7 @@ import { identity as identity5 } from "transformation-matrix";
 var package_default = {
   name: "@tscircuit/core",
   type: "module",
-  version: "0.0.1272",
+  version: "0.0.1273",
   types: "dist/index.d.ts",
   main: "dist/index.js",
   module: "dist/index.js",
@@ -24803,63 +24803,18 @@ var PcbNoteDimension = class extends PrimitiveComponent2 {
 
 // lib/components/primitive-components/Breakout/Breakout.ts
 import "@tscircuit/props";
-var Breakout = class extends Group5 {
-  constructor(props) {
-    super({
-      ...props,
-      // @ts-ignore
-      subcircuit: true
-    });
-  }
-  doInitialPcbPrimitiveRender() {
-    super.doInitialPcbPrimitiveRender();
-    if (this.root?.pcbDisabled) return;
-    const { db } = this.root;
-    const props = this._parsedProps;
-    if (!this.pcb_group_id) return;
-    const pcb_group = db.pcb_group.get(this.pcb_group_id);
-    const padLeft = props.paddingLeft ?? props.padding ?? 0;
-    const padRight = props.paddingRight ?? props.padding ?? 0;
-    const padTop = props.paddingTop ?? props.padding ?? 0;
-    const padBottom = props.paddingBottom ?? props.padding ?? 0;
-    db.pcb_group.update(this.pcb_group_id, {
-      width: (pcb_group.width ?? 0) + padLeft + padRight,
-      height: (pcb_group.height ?? 0) + padTop + padBottom,
-      center: {
-        x: pcb_group.center.x + (padRight - padLeft) / 2,
-        y: pcb_group.center.y + (padTop - padBottom) / 2
-      }
-    });
-  }
-};
 
-// lib/components/primitive-components/BreakoutPoint.ts
-import { breakoutPointProps } from "@tscircuit/props";
-var BreakoutPoint = class extends PrimitiveComponent2 {
+// lib/components/primitive-components/BaseBreakoutPoint.ts
+import { pcbLayoutProps } from "@tscircuit/props";
+var baseBreakoutPointProps = pcbLayoutProps.omit({
+  pcbRotation: true,
+  layer: true
+});
+var BaseBreakoutPoint = class extends PrimitiveComponent2 {
   pcb_breakout_point_id = null;
   matchedPort = null;
   matchedNet = null;
   isPcbPrimitive = true;
-  get config() {
-    return {
-      componentName: "BreakoutPoint",
-      zodProps: breakoutPointProps
-    };
-  }
-  _matchConnection() {
-    const { connection } = this._parsedProps;
-    const subcircuit = this.getSubcircuit();
-    if (!subcircuit) return;
-    this.matchedPort = subcircuit.selectOne(connection, {
-      type: "port"
-    });
-    if (!this.matchedPort) {
-      this.matchedNet = subcircuit.selectOne(connection, { type: "net" });
-    }
-    if (!this.matchedPort && !this.matchedNet) {
-      this.renderError(`Could not find connection target "${connection}"`);
-    }
-  }
   _getSourceTraceIdForPort(port) {
     const { db } = this.root;
     const trace = db.source_trace.list().find((st) => st.connected_source_port_ids.includes(port.source_port_id));
@@ -24870,10 +24825,10 @@ var BreakoutPoint = class extends PrimitiveComponent2 {
     const trace = db.source_trace.list().find((st) => st.connected_source_port_ids.includes(port.source_port_id));
     return trace?.connected_source_net_ids[0];
   }
-  doInitialPcbPrimitiveRender() {
+  _renderPcbBreakoutPoint() {
+    if (this.pcb_breakout_point_id) return;
     if (this.root?.pcbDisabled) return;
     const { db } = this.root;
-    this._matchConnection();
     const position = this._getGlobalPcbPositionBeforeLayout();
     const group = this.parent?.getGroup();
     const subcircuit = this.getSubcircuit();
@@ -24931,6 +24886,120 @@ var BreakoutPoint = class extends PrimitiveComponent2 {
   }
 };
 
+// lib/components/primitive-components/AutoplacedBreakoutPoint.ts
+var AutoplacedBreakoutPoint = class extends BaseBreakoutPoint {
+  get config() {
+    return {
+      componentName: "AutoplacedBreakoutPoint",
+      zodProps: baseBreakoutPointProps
+    };
+  }
+  doInitialPcbPrimitiveRender() {
+    this._renderPcbBreakoutPoint();
+  }
+};
+
+// lib/components/primitive-components/BreakoutPoint.ts
+import { breakoutPointProps } from "@tscircuit/props";
+var BreakoutPoint = class extends BaseBreakoutPoint {
+  get config() {
+    return {
+      componentName: "BreakoutPoint",
+      zodProps: breakoutPointProps
+    };
+  }
+  _matchConnection() {
+    if (this.matchedPort) return;
+    const { connection } = this._parsedProps;
+    const subcircuit = this.getSubcircuit();
+    if (!subcircuit) return;
+    this.matchedPort = subcircuit.selectOne(connection, {
+      type: "port"
+    });
+    if (!this.matchedPort) {
+      this.matchedNet = subcircuit.selectOne(connection, { type: "net" });
+    }
+    if (!this.matchedPort && !this.matchedNet) {
+      this.renderError(`Could not find connection target "${connection}"`);
+    }
+  }
+  doInitialPcbPrimitiveRender() {
+    this._matchConnection();
+    this._renderPcbBreakoutPoint();
+  }
+};
+
+// lib/components/primitive-components/Breakout/Breakout.ts
+var Breakout = class extends Group5 {
+  constructor(props) {
+    super({
+      ...props,
+      // @ts-ignore
+      subcircuit: true
+    });
+  }
+  /**
+   * Find ports inside this breakout group that are connected to traces
+   * crossing the breakout boundary, and create auto-placed BreakoutPoint
+   * children for them. Positions are not set here — they will be determined
+   * after PcbLayout.
+   */
+  doInitialCreateAutoplacedBreakoutPoints() {
+    const portsInBreakout = this.selectAll("port");
+    const breakoutPortSet = new Set(portsInBreakout);
+    const manualBreakoutPoints = this.children.filter(
+      (c) => c instanceof BreakoutPoint
+    );
+    const manuallyMappedPorts = new Set(
+      manualBreakoutPoints.map((bp) => {
+        bp._matchConnection();
+        return bp.matchedPort;
+      }).filter(Boolean)
+    );
+    const board = this.parent;
+    if (!board) return;
+    const allTraces = board.children.filter(
+      (c) => c instanceof Trace3
+    );
+    const autoPlacedPorts = /* @__PURE__ */ new Set();
+    for (const trace of allTraces) {
+      const result = trace._findConnectedPorts();
+      if (!result.allPortsFound || !result.ports) continue;
+      for (const port of result.ports) {
+        const isInside = breakoutPortSet.has(port);
+        const hasOutsidePort = result.ports.some((p) => !breakoutPortSet.has(p));
+        if (!isInside || !hasOutsidePort) continue;
+        if (manuallyMappedPorts.has(port)) continue;
+        if (autoPlacedPorts.has(port)) continue;
+        autoPlacedPorts.add(port);
+        const breakoutPoint = new AutoplacedBreakoutPoint({});
+        breakoutPoint.matchedPort = port;
+        this.add(breakoutPoint);
+      }
+    }
+  }
+  doInitialPcbPrimitiveRender() {
+    super.doInitialPcbPrimitiveRender();
+    if (this.root?.pcbDisabled) return;
+    const { db } = this.root;
+    const props = this._parsedProps;
+    if (!this.pcb_group_id) return;
+    const pcb_group = db.pcb_group.get(this.pcb_group_id);
+    const padLeft = props.paddingLeft ?? props.padding ?? 0;
+    const padRight = props.paddingRight ?? props.padding ?? 0;
+    const padTop = props.paddingTop ?? props.padding ?? 0;
+    const padBottom = props.paddingBottom ?? props.padding ?? 0;
+    db.pcb_group.update(this.pcb_group_id, {
+      width: (pcb_group.width ?? 0) + padLeft + padRight,
+      height: (pcb_group.height ?? 0) + padTop + padBottom,
+      center: {
+        x: pcb_group.center.x + (padRight - padLeft) / 2,
+        y: pcb_group.center.y + (padTop - padBottom) / 2
+      }
+    });
+  }
+};
+
 // lib/components/primitive-components/NetLabel.ts
 import { netLabelProps } from "@tscircuit/props";
 import {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@tscircuit/core",
   "type": "module",
-  "version": "0.0.1273",
+  "version": "0.0.1274",
   "types": "dist/index.d.ts",
   "main": "dist/index.js",
   "module": "dist/index.js",