@tscircuit/hypergraph 0.0.29 → 0.0.31

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 {
@@ -785,7 +785,7 @@ declare class ViaGraphSolver extends HyperGraphSolver<JRegion, JPort> {
     visualize(): GraphicsObject;
 }
 
-type Bounds = {
+type Bounds$1 = {
     minX: number;
     maxX: number;
     minY: number;
@@ -802,7 +802,7 @@ type Bounds = {
  */
 declare function generateViaTopologyGrid(opts: {
     viasByNet: ViasByNet;
-    bounds: Bounds;
+    bounds: Bounds$1;
     tileSize?: number;
     portPitch?: number;
 }): {
@@ -845,6 +845,38 @@ declare function generateDefaultViaTopologyGrid(opts: Omit<Parameters<typeof gen
     };
 };
 
+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;
@@ -885,4 +917,35 @@ type ViaGraphWithConnections = JumperGraph & {
  */
 declare const createViaGraphWithConnections: (baseGraph: JumperGraph, xyConnections: XYConnection[]) => ViaGraphWithConnections;
 
-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, generateDefaultViaTopologyGrid, generateDefaultViaTopologyRegions, generateJumperGrid, generateJumperX4Grid, generateViaTopologyGrid, generateViaTopologyRegions, rotateGraph90Degrees, viasByNet };
+type Bounds = {
+    minX: number;
+    maxX: number;
+    minY: number;
+    maxY: number;
+};
+/**
+ * Generates a via topology using convex regions computed by ConvexRegionsSolver.
+ *
+ * 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 generateConvexViaTopologyRegions(opts: {
+    viasByNet: ViasByNet;
+    bounds: Bounds;
+    tileSize?: number;
+    portPitch?: number;
+    clearance?: number;
+    concavityTolerance?: number;
+}): {
+    regions: JRegion[];
+    ports: JPort[];
+    tiledViasByNet: ViasByNet;
+    tileCount: {
+        rows: number;
+        cols: number;
+    };
+};
+
+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 };