How tscircuit/tscircuit-autorouter works
This is tscircuit’s PCB autorouter: it accepts SimpleRouteJson and produces routed traces, using successive approximation and hypergraph-based routing. The public workflow is to construct a pipeline solver, step or solve it, then retrieve output SRJ; Pipeline 11 separately simplifies existing traces. The graph preserves the documented pipeline families and major routing stages. Relationships inside unsampled pipeline variants are omitted where the excerpts do not establish their calls.
Main entry points: index.ts Solver exports · AutoroutingPipelineSolver4_TinyHypergraph.ts Tiny hypergraph pipeline · AssignableAutoroutingPipeline3.ts Assignable pipeline · PortPointPathingSolver.ts Port-point pathing
Components 19
Public API
- Solver exports
lib/index.ts - Tiny hypergraph pipeline
lib/autorouter-pipelines/AutoroutingPipeline4_TinyHypergraph/AutoroutingPipelineSolver4_TinyHypergraph.ts - Assignable pipeline
lib/autorouter-pipelines/AssignableAutoroutingPipeline3/AssignableAutoroutingPipeline3.ts - Capacity mesh pipeline
lib/autorouter-pipelines/AutoroutingPipeline8/AutoroutingPipelineSolver8.ts - Preloaded trace pipeline
lib/autorouter-pipelines/AutoroutingPipeline9_PreloadedTraceGraph/AutoroutingPipelineSolver9_PreloadedTraceGraph.ts - Networked pipeline
lib/autorouter-pipelines/AutoroutingPipeline9_Networked/AutoroutingPipelineSolver9_Networked.ts - Trace simplification
lib/autorouter-pipelines/AutoroutingPipeline11_Simplification/AutoroutingPipelineSolver11_Simplification.ts
Route Planning
- Connection pairing
lib/solvers/NetToPointPairsSolver/NetToPointPairsSolver.ts - Capacity mesh
lib/solvers/CapacityMeshSolver/CapacityMeshEdgeSolver.ts - Port-point pathing
lib/solvers/PortPointPathingSolver/PortPointPathingSolver.ts - BGA fanout
lib/solvers/BgaTopologyGeneratorSolver/BgaTopologyGeneratorSolver.ts
Route Generation
- High-density routes
lib/solvers/HighDensitySolver/HighDensitySolver.ts - Route stitching
lib/solvers/RouteStitchingSolver/MultipleHighDensityRouteStitchSolver2.ts
Repair And Cleanup
- High-density repair
lib/solvers/HighDensityRepairSolver/Pipeline4HighDensityRepairSolver.ts - Regional DRC repair
lib/autorouter-pipelines/AutoroutingPipeline9_PreloadedTraceGraph/Pipeline9BoundedRegionalRepairSolver.ts
Shared Runtime
- Solver lifecycle
lib/solvers/BaseSolver.ts - Route cache
lib/cache/LocalStorageCache.ts
Other components
- Library caller
- Routed SRJ traces
Connections 22
- Library caller → Solver exports: imports
- Library caller → Tiny hypergraph pipeline: constructs solver
- Library caller → Routed SRJ traces: retrieves result
- Solver exports → Tiny hypergraph pipeline: exports
lib/index.ts - Solver exports → Assignable pipeline: exports
lib/index.ts - Solver exports → Capacity mesh pipeline: exports
lib/index.ts - Solver exports → Preloaded trace pipeline: exports
lib/index.ts - Solver exports → Networked pipeline: exports
lib/index.ts - Solver exports → Trace simplification: exports
lib/index.ts - Tiny hypergraph pipeline → Connection pairing: creates pairs
lib/autorouter-pipelines/AutoroutingPipeline4_TinyHypergraph/AutoroutingPipelineSolver4_TinyHypergraph.ts - Tiny hypergraph pipeline → Port-point pathing: builds hypergraph
lib/autorouter-pipelines/AutoroutingPipeline4_TinyHypergraph/AutoroutingPipelineSolver4_TinyHypergraph.ts - Capacity mesh pipeline → Port-point pathing: builds hypergraph
lib/autorouter-pipelines/AutoroutingPipeline8/AutoroutingPipelineSolver8.ts - Assignable pipeline → Connection pairing: creates pairs
lib/autorouter-pipelines/AssignableAutoroutingPipeline3/AssignableAutoroutingPipeline3.ts - Tiny hypergraph pipeline → High-density repair: invokes repair
lib/autorouter-pipelines/AutoroutingPipeline4_TinyHypergraph/AutoroutingPipelineSolver4_TinyHypergraph.ts - High-density routes → Solver lifecycle: extends lifecycle
lib/solvers/HighDensitySolver/HighDensitySolver.ts - High-density repair → Routed SRJ traces: returns routes
lib/solvers/HighDensityRepairSolver/Pipeline4HighDensityRepairSolver.ts - Route stitching → Port-point pathing: uses pathing
lib/solvers/RouteStitchingSolver/MultipleHighDensityRouteStitchSolver2.ts - Trace simplification → Routed SRJ traces: produces simplified traces
- Preloaded trace pipeline → Regional DRC repair: runs repair
- Tiny hypergraph pipeline → High-density routes: routes dense nodes
lib/autorouter-pipelines/AutoroutingPipeline4_TinyHypergraph/AutoroutingPipelineSolver4_TinyHypergraph.ts - Assignable pipeline → BGA fanout: supports fanout
- Networked pipeline → Route cache: uses cache