@tscircuit/hypergraph 0.0.28 → 0.0.30

package/dist/index.d.ts

@@ -292,7 +292,7 @@ declare class HyperGraphSolver<RegionType extends Region = Region, RegionPortTyp
     _step(): void;
 }
 
-type Bounds$1 = {
+type Bounds$2 = {
     minX: number;
     minY: number;
     maxX: number;
@@ -301,7 +301,7 @@ type Bounds$1 = {
 
 interface JRegion extends Region {
     d: {
-        bounds: Bounds$1;
+        bounds: Bounds$2;
         center: {
             x: number;
             y: number;
@@ -383,7 +383,7 @@ declare class JumperGraphSolver extends HyperGraphSolver<JRegion, JPort> {
     visualize(): GraphicsObject;
 }
 
-declare const calculateGraphBounds: (regions: JRegion[]) => Bounds$1;
+declare const calculateGraphBounds: (regions: JRegion[]) => Bounds$2;
 
 type XYConnection = {
     start: {
@@ -479,7 +479,7 @@ type SharedBoundary = {
 };
 type RegionData = {
     id: string;
-    bounds: Bounds$1 | null;
+    bounds: Bounds$2 | null;
     polygon: {
         x: number;
         y: number;
@@ -520,7 +520,7 @@ declare class RegionBuilder implements RegionRef {
     private data;
     constructor(id: string);
     get id(): string;
-    rect(b: Bounds$1): this;
+    rect(b: Bounds$2): this;
     polygon(points: {
         x: number;
         y: number;
@@ -549,7 +549,7 @@ declare class ConnectBuilder {
     private portIds;
     private boundary;
     private prefixWasExplicitlySet;
-    constructor(region1Id: string, region2Id: string, bounds1: Bounds$1, bounds2: Bounds$1, addPortFn: AddPortFn$1, prefixIdFn: PrefixIdFn, opts?: {
+    constructor(region1Id: string, region2Id: string, bounds1: Bounds$2, bounds2: Bounds$2, addPortFn: AddPortFn$1, prefixIdFn: PrefixIdFn, opts?: {
         idPrefix?: string;
         tolerance?: number;
     });
@@ -569,7 +569,7 @@ declare class ConnectBuilder {
 
 type ResolveRegionFn = (ref: RegionRef | string) => {
     id: string;
-    bounds: Bounds$1;
+    bounds: Bounds$2;
 };
 type AddPortFn = (port: PortData) => void;
 declare class PortBuilder {
@@ -625,6 +625,117 @@ declare class Topology {
     getPortIds(): string[];
 }
 
+var Net6 = [
+	{
+		viaId: "4ef04070-bacf-4a8a-8ac9-ea222cf4bf2c",
+		diameter: 0.6,
+		position: {
+			x: 1.483834,
+			y: 0.582296
+		}
+	},
+	{
+		viaId: "79364d38-c966-4eff-aa4a-e3ff6cca6339",
+		diameter: 0.6,
+		position: {
+			x: -0.8,
+			y: -1.893395
+		}
+	},
+	{
+		viaId: "f1d52fd5-ddd2-4440-8772-da3d096b033f",
+		diameter: 0.6,
+		position: {
+			x: -0.703066,
+			y: 1.2
+		}
+	}
+];
+var Net5 = [
+	{
+		viaId: "4e57cee8-0910-4c83-9ec1-1ed2c9d16dcc",
+		diameter: 0.6,
+		position: {
+			x: 1.268717,
+			y: -1.698536
+		}
+	},
+	{
+		viaId: "a3797f13-73f9-48c3-a448-bea3980cdd65",
+		diameter: 0.6,
+		position: {
+			x: -1.115754,
+			y: -0.799377
+		}
+	},
+	{
+		viaId: "b0c56bb1-ea80-4154-9bb7-cb0fd760de8f",
+		diameter: 0.6,
+		position: {
+			x: 0.397934,
+			y: 1.458567
+		}
+	}
+];
+var Net7 = [
+	{
+		viaId: "3719876b-17c8-4ee3-9cce-5b5c073d6614",
+		diameter: 0.6,
+		position: {
+			x: 1.186721,
+			y: 1.32508
+		}
+	},
+	{
+		viaId: "4e46d759-a04a-4f7e-99cd-9e05adf5fa23",
+		diameter: 0.6,
+		position: {
+			x: -1.275,
+			y: 0
+		}
+	},
+	{
+		viaId: "63afce65-b94e-47da-ae14-51ff0ee8eb39",
+		diameter: 0.6,
+		position: {
+			x: 1.655408,
+			y: -0.998198
+		}
+	}
+];
+var Net8 = [
+	{
+		viaId: "26d3bef1-a78f-4947-b551-c48f04289a98",
+		diameter: 0.6,
+		position: {
+			x: 1.553029,
+			y: -0.164505
+		}
+	},
+	{
+		viaId: "548acbca-8b68-4186-a589-681ec44fba42",
+		diameter: 0.6,
+		position: {
+			x: 0.222457,
+			y: -1.866711
+		}
+	},
+	{
+		viaId: "d6bf60bf-4b90-4967-a295-fc930b1f2549",
+		diameter: 0.6,
+		position: {
+			x: -1.419706,
+			y: 0.868747
+		}
+	}
+];
+var viasByNet = {
+	Net6: Net6,
+	Net5: Net5,
+	Net7: Net7,
+	Net8: Net8
+};
+
 declare const VIA_GRAPH_SOLVER_DEFAULTS: {
     portUsagePenalty: number;
     portUsagePenaltySq: number;
@@ -674,6 +785,98 @@ declare class ViaGraphSolver extends HyperGraphSolver<JRegion, JPort> {
     visualize(): GraphicsObject;
 }
 
+type Bounds$1 = {
+    minX: number;
+    maxX: number;
+    minY: number;
+    maxY: number;
+};
+/**
+ * Generates a tiled grid of via topologies with outer frame regions.
+ *
+ * The via tiles are centered within the given bounds. If the bounds are smaller
+ * than one tile, no via tiles are created - only outer frame regions.
+ *
+ * The outer frame consists of rectangular regions (T, B, L, R) that fill the
+ * space between the tiled area and the problem bounds.
+ */
+declare function generateViaTopologyGrid(opts: {
+    viasByNet: ViasByNet;
+    bounds: Bounds$1;
+    tileSize?: number;
+    portPitch?: number;
+}): {
+    regions: JRegion[];
+    ports: JPort[];
+    tiledViasByNet: ViasByNet;
+    tileCount: {
+        rows: number;
+        cols: number;
+    };
+};
+
+/**
+ * Generates four outer topology regions (top, bottom, left, right) that wrap
+ * around all vias, forming a closed frame that extends to the graph boundary.
+ *
+ * Each region is a polygon whose inner edge follows the extreme via edges
+ * (connected by straight diagonal lines between segments), and whose outer
+ * edge is the graph boundary.
+ */
+declare const generateViaTopologyRegions: (viasByNet: ViasByNet, opts?: {
+    graphSize?: number;
+    idPrefix?: string;
+}) => {
+    regions: JRegion[];
+    ports: JPort[];
+};
+
+declare function generateDefaultViaTopologyRegions(opts: Parameters<typeof generateViaTopologyRegions>[1]): {
+    regions: JRegion[];
+    ports: JPort[];
+};
+declare function generateDefaultViaTopologyGrid(opts: Omit<Parameters<typeof generateViaTopologyGrid>[0], "viasByNet">): {
+    regions: JRegion[];
+    ports: JPort[];
+    tiledViasByNet: ViasByNet;
+    tileCount: {
+        rows: number;
+        cols: number;
+    };
+};
+
+type ConvexViaGraphFromXYConnectionsResult = JumperGraph & {
+    connections: Connection[];
+    tiledViasByNet: ViasByNet;
+    tileCount: {
+        rows: number;
+        cols: number;
+    };
+};
+/**
+ * Creates a complete via topology graph from XY connections using convex regions.
+ *
+ * This function uses ConvexRegionsSolver to compute convex regions around
+ * via region obstacles, instead of the manual T/B/L/R outer regions.
+ *
+ * It:
+ * 1. Calculates bounds from connection XY coordinates (no margin)
+ * 2. Generates per-net via region polygons on a tiled grid
+ * 3. Uses ConvexRegionsSolver to compute convex regions around via regions
+ * 4. Creates ports between adjacent convex regions and via regions
+ * 5. Attaches connection regions to the graph
+ *
+ * @param xyConnections - Array of connections with start/end XY coordinates
+ * @param viasByNet - Via positions grouped by net name (defaults to built-in vias-by-net.json)
+ * @param opts - Optional configuration
+ */
+declare function createConvexViaGraphFromXYConnections(xyConnections: XYConnection[], viasByNet?: ViasByNet, opts?: {
+    tileSize?: number;
+    portPitch?: number;
+    clearance?: number;
+    concavityTolerance?: number;
+}): ConvexViaGraphFromXYConnectionsResult;
+
 type ViaGraphFromXYConnectionsResult = JumperGraph & {
     connections: Connection[];
     tiledViasByNet: ViasByNet;
@@ -721,19 +924,20 @@ type Bounds = {
     maxY: number;
 };
 /**
- * Generates a tiled grid of via topologies with outer frame regions.
+ * Generates a via topology using convex regions computed by ConvexRegionsSolver.
  *
- * The via tiles are centered within the given bounds. If the bounds are smaller
- * than one tile, no via tiles are created - only outer frame regions.
- *
- * The outer frame consists of rectangular regions (T, B, L, R) that fill the
- * space between the tiled area and the problem bounds.
+ * 1. Via tiles are placed on a grid (5mm tiles by default)
+ * 2. Per-net via region polygons are created within each tile
+ * 3. Convex regions are computed globally with via region polygons as obstacles
+ * 4. Ports are created between adjacent convex regions and between convex/via regions
  */
-declare function generateViaTopologyGrid(opts: {
+declare function generateConvexViaTopologyRegions(opts: {
     viasByNet: ViasByNet;
     bounds: Bounds;
     tileSize?: number;
     portPitch?: number;
+    clearance?: number;
+    concavityTolerance?: number;
 }): {
     regions: JRegion[];
     ports: JPort[];
@@ -744,20 +948,4 @@ declare function generateViaTopologyGrid(opts: {
     };
 };
 
-/**
- * Generates four outer topology regions (top, bottom, left, right) that wrap
- * around all vias, forming a closed frame that extends to the graph boundary.
- *
- * Each region is a polygon whose inner edge follows the extreme via edges
- * (connected by straight diagonal lines between segments), and whose outer
- * edge is the graph boundary.
- */
-declare const generateViaTopologyRegions: (viasByNet: ViasByNet, opts?: {
-    graphSize?: number;
-    idPrefix?: string;
-}) => {
-    regions: JRegion[];
-    ports: JPort[];
-};
-
-export { type Bounds$1 as Bounds, type BuildOpts, type Candidate, ConnectBuilder, type ConnectOpts, type Connection, type ConnectionId, type GScore, type GraphEdgeId, type HyperGraph, HyperGraphSolver, type JPort, type JRegion, JUMPER_GRAPH_SOLVER_DEFAULTS, type JumperGraph, JumperGraphSolver, type JumperGraphWithConnections, type NetworkId, type PortAssignment, PortBuilder, type PortData, type PortId, type PortSpread, type Region, RegionBuilder, type RegionData, type RegionId, type RegionPort, type RegionPortAssignment, type RegionRef, type SerializedConnection, type SerializedGraphPort, type SerializedGraphRegion, type SerializedHyperGraph, type SerializedRegionPortAssignment, type SharedBoundary, type SolvedRoute, Topology, TopologyError, VIA_GRAPH_SOLVER_DEFAULTS, type ValidateOpts, type ViaData, type ViaGraphFromXYConnectionsResult, ViaGraphSolver, type ViaGraphWithConnections, type ViasByNet, type XYConnection, applyTransformToGraph, calculateGraphBounds, convertConnectionsToSerializedConnections, convertHyperGraphToSerializedHyperGraph, createGraphWithConnectionsFromBaseGraph, createViaGraphFromXYConnections, createViaGraphWithConnections, generateJumperGrid, generateJumperX4Grid, generateViaTopologyGrid, generateViaTopologyRegions, rotateGraph90Degrees };
+export { type Bounds$2 as Bounds, type BuildOpts, type Candidate, ConnectBuilder, type ConnectOpts, type Connection, type ConnectionId, type ConvexViaGraphFromXYConnectionsResult, type GScore, type GraphEdgeId, type HyperGraph, HyperGraphSolver, type JPort, type JRegion, JUMPER_GRAPH_SOLVER_DEFAULTS, type JumperGraph, JumperGraphSolver, type JumperGraphWithConnections, type NetworkId, type PortAssignment, PortBuilder, type PortData, type PortId, type PortSpread, type Region, RegionBuilder, type RegionData, type RegionId, type RegionPort, type RegionPortAssignment, type RegionRef, type SerializedConnection, type SerializedGraphPort, type SerializedGraphRegion, type SerializedHyperGraph, type SerializedRegionPortAssignment, type SharedBoundary, type SolvedRoute, Topology, TopologyError, VIA_GRAPH_SOLVER_DEFAULTS, type ValidateOpts, type ViaData, type ViaGraphFromXYConnectionsResult, ViaGraphSolver, type ViaGraphWithConnections, type ViasByNet, type XYConnection, applyTransformToGraph, calculateGraphBounds, convertConnectionsToSerializedConnections, convertHyperGraphToSerializedHyperGraph, createConvexViaGraphFromXYConnections, createGraphWithConnectionsFromBaseGraph, createViaGraphFromXYConnections, createViaGraphWithConnections, generateConvexViaTopologyRegions, generateDefaultViaTopologyGrid, generateDefaultViaTopologyRegions, generateJumperGrid, generateJumperX4Grid, generateViaTopologyGrid, generateViaTopologyRegions, rotateGraph90Degrees, viasByNet };