@tscircuit/core 0.0.1273 → 0.0.1275

package/dist/index.d.ts

@@ -236,9 +236,9 @@ interface IIsolatedCircuit {
 interface IRootCircuit extends IIsolatedCircuit {
 }
 
-declare const orderedRenderPhases: readonly ["ReactSubtreesRender", "RenderIsolatedSubcircuits", "InflateSubcircuitCircuitJson", "SourceNameDuplicateComponentRemoval", "PcbFootprintStringRender", "FetchPartFootprint", "InitializePortsFromChildren", "CreateNetsFromProps", "AssignFallbackProps", "CreateTracesFromProps", "CreateTracesFromNetLabels", "CreateTraceHintsFromProps", "CreateAutoplacedBreakoutPoints", "SourceGroupRender", "AssignNameToUnnamedComponents", "SourceRender", "SourceComponentPropertyValidation", "SourceParentAttachment", "PortMatching", "OptimizeSelectorCache", "SourceTraceRender", "SourceAddConnectivityMapKey", "SourceDesignRuleChecks", "SimulationRender", "SchematicComponentRender", "SchematicPortRender", "SymbolContainerRender", "SchematicPrimitiveRender", "SchematicSymbolResize", "SchematicComponentSizeCalculation", "SchematicLayout", "SchematicSectionRender", "SchematicTraceRender", "SchematicReplaceNetLabelsWithSymbols", "PanelBoardLayout", "ValidatePcbCoordinates", "PcbComponentRender", "PcbPrimitiveRender", "PcbFootprintLayout", "PcbPortRender", "PcbPortAttachment", "PcbComponentSizeCalculation", "PcbComponentAnchorAlignment", "PcbCalcPlacementResolution", "PcbLayout", "PcbBoardAutoSize", "PanelLayout", "PcbTraceHintRender", "PcbManualTraceRender", "PcbTraceRender", "PcbRouteNetIslands", "PcbCopperPourRender", "PcbDesignRuleChecks", "SilkscreenOverlapAdjustment", "CadModelRender", "PartsEngineRender", "SupplierFootprintMismatchWarning", "SimulationSpiceEngineRender"];
+declare const orderedRenderPhases: readonly ["ReactSubtreesRender", "RenderIsolatedSubcircuits", "InflateSubcircuitCircuitJson", "SourceNameDuplicateComponentRemoval", "PcbFootprintStringRender", "FetchPartFootprint", "InitializePortsFromChildren", "CreateNetsFromProps", "AssignFallbackProps", "CreateTracesFromProps", "CreateTracesFromNetLabels", "CreateTraceHintsFromProps", "CreateAutoplacedBreakoutPoints", "SourceGroupRender", "AssignNameToUnnamedComponents", "SourceRender", "SourceComponentPropertyValidation", "SourceParentAttachment", "PortMatching", "OptimizeSelectorCache", "SourceTraceRender", "SourceAddConnectivityMapKey", "SourceDesignRuleChecks", "SimulationRender", "SchematicComponentRender", "SchematicPortRender", "SymbolContainerRender", "SchematicPrimitiveRender", "SchematicSymbolResize", "SchematicComponentSizeCalculation", "SchematicLayout", "SchematicSectionRender", "SchematicTraceRender", "SchematicReplaceNetLabelsWithSymbols", "PanelBoardLayout", "ValidatePcbCoordinates", "PcbComponentRender", "PcbPrimitiveRender", "PcbFootprintLayout", "PcbPortRender", "PcbPortAttachment", "PcbComponentSizeCalculation", "PcbComponentAnchorAlignment", "PcbCalcPlacementResolution", "PcbLayout", "PcbBoardAutoSize", "PanelLayout", "PcbAutoplaceBreakoutPoints", "PcbTraceHintRender", "PcbManualTraceRender", "PcbTraceRender", "PcbRouteNetIslands", "PcbCopperPourRender", "PcbDesignRuleChecks", "SilkscreenOverlapAdjustment", "CadModelRender", "PartsEngineRender", "SupplierFootprintMismatchWarning", "SimulationSpiceEngineRender"];
 type RenderPhase = (typeof orderedRenderPhases)[number];
-declare const renderPhaseIndexMap: Map<"ReactSubtreesRender" | "RenderIsolatedSubcircuits" | "InflateSubcircuitCircuitJson" | "SourceNameDuplicateComponentRemoval" | "PcbFootprintStringRender" | "FetchPartFootprint" | "InitializePortsFromChildren" | "CreateNetsFromProps" | "AssignFallbackProps" | "CreateTracesFromProps" | "CreateTracesFromNetLabels" | "CreateTraceHintsFromProps" | "CreateAutoplacedBreakoutPoints" | "SourceGroupRender" | "AssignNameToUnnamedComponents" | "SourceRender" | "SourceComponentPropertyValidation" | "SourceParentAttachment" | "PortMatching" | "OptimizeSelectorCache" | "SourceTraceRender" | "SourceAddConnectivityMapKey" | "SourceDesignRuleChecks" | "SimulationRender" | "SchematicComponentRender" | "SchematicPortRender" | "SymbolContainerRender" | "SchematicPrimitiveRender" | "SchematicSymbolResize" | "SchematicComponentSizeCalculation" | "SchematicLayout" | "SchematicSectionRender" | "SchematicTraceRender" | "SchematicReplaceNetLabelsWithSymbols" | "PanelBoardLayout" | "ValidatePcbCoordinates" | "PcbComponentRender" | "PcbPrimitiveRender" | "PcbFootprintLayout" | "PcbPortRender" | "PcbPortAttachment" | "PcbComponentSizeCalculation" | "PcbComponentAnchorAlignment" | "PcbCalcPlacementResolution" | "PcbLayout" | "PcbBoardAutoSize" | "PanelLayout" | "PcbTraceHintRender" | "PcbManualTraceRender" | "PcbTraceRender" | "PcbRouteNetIslands" | "PcbCopperPourRender" | "PcbDesignRuleChecks" | "SilkscreenOverlapAdjustment" | "CadModelRender" | "PartsEngineRender" | "SupplierFootprintMismatchWarning" | "SimulationSpiceEngineRender", number>;
+declare const renderPhaseIndexMap: Map<"ReactSubtreesRender" | "RenderIsolatedSubcircuits" | "InflateSubcircuitCircuitJson" | "SourceNameDuplicateComponentRemoval" | "PcbFootprintStringRender" | "FetchPartFootprint" | "InitializePortsFromChildren" | "CreateNetsFromProps" | "AssignFallbackProps" | "CreateTracesFromProps" | "CreateTracesFromNetLabels" | "CreateTraceHintsFromProps" | "CreateAutoplacedBreakoutPoints" | "SourceGroupRender" | "AssignNameToUnnamedComponents" | "SourceRender" | "SourceComponentPropertyValidation" | "SourceParentAttachment" | "PortMatching" | "OptimizeSelectorCache" | "SourceTraceRender" | "SourceAddConnectivityMapKey" | "SourceDesignRuleChecks" | "SimulationRender" | "SchematicComponentRender" | "SchematicPortRender" | "SymbolContainerRender" | "SchematicPrimitiveRender" | "SchematicSymbolResize" | "SchematicComponentSizeCalculation" | "SchematicLayout" | "SchematicSectionRender" | "SchematicTraceRender" | "SchematicReplaceNetLabelsWithSymbols" | "PanelBoardLayout" | "ValidatePcbCoordinates" | "PcbComponentRender" | "PcbPrimitiveRender" | "PcbFootprintLayout" | "PcbPortRender" | "PcbPortAttachment" | "PcbComponentSizeCalculation" | "PcbComponentAnchorAlignment" | "PcbCalcPlacementResolution" | "PcbLayout" | "PcbBoardAutoSize" | "PanelLayout" | "PcbAutoplaceBreakoutPoints" | "PcbTraceHintRender" | "PcbManualTraceRender" | "PcbTraceRender" | "PcbRouteNetIslands" | "PcbCopperPourRender" | "PcbDesignRuleChecks" | "SilkscreenOverlapAdjustment" | "CadModelRender" | "PartsEngineRender" | "SupplierFootprintMismatchWarning" | "SimulationSpiceEngineRender", number>;
 type RenderPhaseFn<K extends RenderPhase = RenderPhase> = `doInitial${K}` | `update${K}` | `remove${K}`;
 type RenderPhaseStates = Record<RenderPhase, {
     initialized: boolean;
@@ -73055,14 +73055,191 @@ 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;
+    doInitialPcbAutoplaceBreakoutPoints(): 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 +73376,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

@@ -364,6 +364,7 @@ var orderedRenderPhases = [
   "PcbLayout",
   "PcbBoardAutoSize",
   "PanelLayout",
+  "PcbAutoplaceBreakoutPoints",
   "PcbTraceHintRender",
   "PcbManualTraceRender",
   "PcbTraceRender",
@@ -21806,7 +21807,7 @@ import { identity as identity5 } from "transformation-matrix";
 var package_default = {
   name: "@tscircuit/core",
   type: "module",
-  version: "0.0.1272",
+  version: "0.0.1274",
   types: "dist/index.d.ts",
   main: "dist/index.js",
   module: "dist/index.js",
@@ -21838,6 +21839,7 @@ var package_default = {
     "@biomejs/biome": "^1.8.3",
     "@resvg/resvg-js": "^2.6.2",
     "@tscircuit/alphabet": "0.0.25",
+    "@tscircuit/breakout-point-solver": "github:tscircuit/breakout-point-solver#bac9629",
     "@tscircuit/capacity-autorouter": "^0.0.529",
     "@tscircuit/checks": "0.0.133",
     "@tscircuit/circuit-json-util": "^0.0.94",
@@ -21879,7 +21881,7 @@ var package_default = {
     debug: "^4.3.6",
     "eecircuit-engine": "^1.5.6",
     flatbush: "^4.5.0",
-    "graphics-debug": "^0.0.89",
+    "graphics-debug": "^0.0.95",
     howfat: "^0.3.8",
     "kicad-to-circuit-json": "^0.0.60",
     kicadts: "^0.0.35",
@@ -24803,63 +24805,19 @@ 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
-      }
-    });
-  }
-};
+import { BreakoutPointSolver } from "@tscircuit/breakout-point-solver";
 
-// 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 +24828,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 +24889,237 @@ 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/createBreakoutPointSolverInput.ts
+import {
+  findBoundsAndCenter
+} from "@tscircuit/circuit-json-util";
+var getPortLabel = (db, sourcePortId) => {
+  if (!sourcePortId) return void 0;
+  const sourcePort = db.source_port.get(sourcePortId);
+  const sourceComponent = sourcePort?.source_component_id ? db.source_component.get(sourcePort.source_component_id) : void 0;
+  if (!sourcePort) return void 0;
+  return sourceComponent?.name ? `${sourceComponent.name}.${sourcePort.name}` : sourcePort.name;
+};
+var getPadElement = (db, pcbPortId) => {
+  return db.pcb_smtpad.getWhere({ pcb_port_id: pcbPortId }) ?? db.pcb_plated_hole.getWhere({ pcb_port_id: pcbPortId });
+};
+var toBreakoutPort = (db, pcbPort) => {
+  const pad = getPadElement(db, pcbPort.pcb_port_id);
+  const padBounds = pad ? findBoundsAndCenter([pad]) : null;
+  return {
+    sourcePortId: pcbPort.source_port_id,
+    position: { x: pcbPort.x, y: pcbPort.y },
+    ...padBounds ? { width: padBounds.width, height: padBounds.height } : {},
+    layer: pcbPort.layers?.[0] ?? "top",
+    label: getPortLabel(db, pcbPort.source_port_id)
+  };
+};
+var createBreakoutPointSolverInput = (breakout) => {
+  if (!breakout.root || !breakout.pcb_group_id) return null;
+  const { db } = breakout.root;
+  const pcbGroup = db.pcb_group.get(breakout.pcb_group_id);
+  if (!pcbGroup || !pcbGroup.width || !pcbGroup.height) return null;
+  const sourcePortIdToPcbPort = /* @__PURE__ */ new Map();
+  for (const pcbPort of db.pcb_port.list()) {
+    if (!pcbPort.source_port_id) continue;
+    sourcePortIdToPcbPort.set(pcbPort.source_port_id, pcbPort);
+  }
+  const boundsMinX = pcbGroup.center.x - pcbGroup.width / 2;
+  const boundsMaxX = pcbGroup.center.x + pcbGroup.width / 2;
+  const boundsMinY = pcbGroup.center.y - pcbGroup.height / 2;
+  const boundsMaxY = pcbGroup.center.y + pcbGroup.height / 2;
+  const traces = [];
+  for (const sourceTrace of db.source_trace.list()) {
+    const pcbPorts = sourceTrace.connected_source_port_ids.map((sourcePortId) => sourcePortIdToPcbPort.get(sourcePortId)).filter((port) => Boolean(port));
+    const insidePorts = pcbPorts.filter(
+      (port) => port.pcb_group_id === breakout.pcb_group_id
+    );
+    const outsidePorts = pcbPorts.filter(
+      (port) => port.pcb_group_id !== breakout.pcb_group_id && !(port.x >= boundsMinX && port.x <= boundsMaxX && port.y >= boundsMinY && port.y <= boundsMaxY)
+    );
+    if (insidePorts.length === 0 || outsidePorts.length === 0) continue;
+    traces.push({
+      sourceTraceId: sourceTrace.source_trace_id,
+      insidePorts: insidePorts.map((port) => toBreakoutPort(db, port)),
+      outsidePorts: outsidePorts.map((port) => toBreakoutPort(db, port))
+    });
+  }
+  if (traces.length === 0) return null;
+  const allPadElements = [...db.pcb_smtpad.list(), ...db.pcb_plated_hole.list()];
+  const pads = [];
+  for (const pad of allPadElements) {
+    const padBounds = findBoundsAndCenter([pad]);
+    if (!padBounds.width || !padBounds.height) continue;
+    const pcbPort = pad.pcb_port_id ? db.pcb_port.get(pad.pcb_port_id) : null;
+    pads.push({
+      center: padBounds.center,
+      width: padBounds.width,
+      height: padBounds.height,
+      layer: pad.layer ?? "top",
+      sourcePortIds: pcbPort?.source_port_id ? [pcbPort.source_port_id] : [],
+      label: getPortLabel(db, pcbPort?.source_port_id)
+    });
+  }
+  const components = db.pcb_component.list().filter((component) => component.width && component.height).map((component) => ({
+    center: component.center,
+    width: component.width,
+    height: component.height,
+    ccwRotationDegrees: component.rotation,
+    layer: component.layer,
+    label: component.pcb_component_id
+  }));
+  const usedBoundaryPoints = db.pcb_breakout_point.list().filter((point6) => point6.pcb_group_id === breakout.pcb_group_id).map((point6) => ({ x: point6.x, y: point6.y }));
+  return {
+    bounds: {
+      minX: boundsMinX,
+      maxX: boundsMaxX,
+      minY: boundsMinY,
+      maxY: boundsMaxY
+    },
+    boundaryPointSpacing: 0.5,
+    traces,
+    pads,
+    components,
+    usedBoundaryPoints
+  };
+};
+
+// 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);
+      }
+    }
+  }
+  doInitialPcbAutoplaceBreakoutPoints() {
+    if (this.root?.pcbDisabled) return;
+    const solverInput = createBreakoutPointSolverInput(this);
+    if (!solverInput) return;
+    const solver = new BreakoutPointSolver(solverInput);
+    solver.solve();
+    const output = solver.getOutput();
+    const autoBreakoutPoints = this.children.filter(
+      (c) => c instanceof AutoplacedBreakoutPoint
+    );
+    for (const solvedPoint of output.breakoutPoints) {
+      const matchingBreakoutPoint = autoBreakoutPoints.find(
+        (child) => child.matchedPort?.source_port_id === solvedPoint.sourcePortId
+      );
+      if (matchingBreakoutPoint) {
+        matchingBreakoutPoint._setPositionFromLayout({
+          x: solvedPoint.x,
+          y: solvedPoint.y
+        });
+      }
+    }
+  }
+  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.1275",
   "types": "dist/index.d.ts",
   "main": "dist/index.js",
   "module": "dist/index.js",
@@ -33,6 +33,7 @@
     "@biomejs/biome": "^1.8.3",
     "@resvg/resvg-js": "^2.6.2",
     "@tscircuit/alphabet": "0.0.25",
+    "@tscircuit/breakout-point-solver": "github:tscircuit/breakout-point-solver#bac9629",
     "@tscircuit/capacity-autorouter": "^0.0.529",
     "@tscircuit/checks": "0.0.133",
     "@tscircuit/circuit-json-util": "^0.0.94",
@@ -74,7 +75,7 @@
     "debug": "^4.3.6",
     "eecircuit-engine": "^1.5.6",
     "flatbush": "^4.5.0",
-    "graphics-debug": "^0.0.89",
+    "graphics-debug": "^0.0.95",
     "howfat": "^0.3.8",
     "kicad-to-circuit-json": "^0.0.60",
     "kicadts": "^0.0.35",