@tscircuit/capacity-autorouter 0.0.740 → 0.0.742

package/README.md

@@ -86,12 +86,24 @@ interface SimpleRouteBus {
   busId: string
   connectionNames: string[] // Ordered SimpleRouteConnection names
   maxLengthSkew?: number // Maximum routed-length difference in millimeters
+  traceWidth?: number // Resolved copper width in millimeters
+  allowedLayers?: string[] // Legal routing layers, including terminal layers
+}
+
+interface DifferentialPair {
+  connectionNames: [string, string]
+  lengthTolerance: number // Maximum pair skew in millimeters
+  traceGap?: number // Resolved edge-to-edge copper gap in millimeters
+  maxUncoupledLength?: number // Maximum uncoupled length in millimeters
 }
 ```
 
 `maxLengthSkew` records the maximum permitted routed-length difference for the
 bus. Bus metadata is preserved in the output so routing implementations can
 apply the constraint without losing the original membership or ordering.
+`traceWidth`, `traceGap`, and `allowedLayers` are resolved routing geometry;
+stackup-aware impedance targets should be converted to these dimensions before
+creating SimpleRouteJson.
 
 Via-in-pad repair is disabled by default because it generally requires filled
 and capped vias. Set `allowViaInPad: true` only when the fabrication process

package/dist/index.d.ts

@@ -15,8 +15,8 @@ export { DrcError, DrcEvaluator, DrcSnapshot, GlobalDrcBranchPortfolioSolver, Gl
 import { DatasetSample, HighDensityRepairSolver } from 'high-density-repair02';
 import { LayerMergeMode, ConvexRegionsComputeResult, SerializedPolyHyperGraph } from 'pcb-poly-hyper-graph';
 import { PolyHyperGraphLoadResult, PolyHyperGraphSolver } from 'tiny-hypergraph-poly/lib/index';
-import { PostProcessingSolver } from '@tscircuit/length-matching-solver';
 import { PowerTraceExpanderOptions, PowerTraceExpanderSolver } from '@tscircuit/power-trace-expander';
+import { PostProcessingSolverParams, PostProcessingSolver, PostProcessingSolverOutput } from '@tscircuit/length-matching-solver';
 
 interface CacheProvider {
     isSyncCache: boolean;
@@ -135,7 +135,12 @@ interface SimpleRouteJson {
 }
 interface DifferentialPair {
     connectionNames: [string, string];
+    /** Maximum permitted routed-length difference in millimeters. */
     lengthTolerance: number;
+    /** Resolved edge-to-edge copper gap in millimeters. */
+    traceGap?: number;
+    /** Maximum permitted length routed without pair coupling, in millimeters. */
+    maxUncoupledLength?: number;
 }
 interface SimpleRouteBus {
     busId: BusId;
@@ -143,6 +148,10 @@ interface SimpleRouteBus {
     connectionNames: string[];
     /** Maximum permitted routed-length difference in millimeters. */
     maxLengthSkew?: number;
+    /** Resolved copper width in millimeters for members without an override. */
+    traceWidth?: number;
+    /** Layers on which this bus may be routed, including its terminal layers. */
+    allowedLayers?: string[];
 }
 interface Obstacle {
     obstacleId?: string;
@@ -5787,6 +5796,26 @@ declare class PowerTraceExpansionSolver extends BaseSolver {
     visualize(): GraphicsObject;
 }
 
+/**
+ * Keeps post-processing optional at the autorouter integration boundary.
+ *
+ * The length-matching package deliberately reports an infeasible coupled pair
+ * as an error. Pipeline7 already has valid independently-routed copper at this
+ * point, so an infeasible pair must preserve that copper instead of failing the
+ * entire autoroute.
+ */
+declare class SafePostProcessingSolver extends BaseSolver {
+    readonly inputProblem: PostProcessingSolverParams;
+    readonly postProcessingSolver: PostProcessingSolver;
+    usedFallback: boolean;
+    constructor(inputProblem: PostProcessingSolverParams);
+    getSolverName(): string;
+    _step(): void;
+    getConstructorParams(): [PostProcessingSolverParams];
+    getOutput(): PostProcessingSolverOutput;
+    visualize(): GraphicsObject;
+}
+
 interface CapacityMeshSolverOptions$3 {
     capacityDepth?: number;
     targetMinCapacity?: number;
@@ -5829,7 +5858,7 @@ declare class AutoroutingPipelineSolver7_MultiGraph extends BaseSolver {
     strawSolver?: StrawSolver;
     deadEndSolver?: DeadEndSolver;
     traceSimplificationSolver?: TraceSimplificationSolver;
-    postProcessingSolver?: PostProcessingSolver;
+    lengthMatchingPostProcessingSolver?: SafePostProcessingSolver;
     powerTraceExpansionSolver?: PowerTraceExpansionSolver;
     availableSegmentPointSolver?: AvailableSegmentPointSolver;
     portPointPathingSolver?: TinyHypergraphPortPointPathingSolver;
@@ -5860,7 +5889,7 @@ declare class AutoroutingPipelineSolver7_MultiGraph extends BaseSolver {
     sharedEdgeSegmentsWithNecessaryCrampedPortPoints?: SharedEdgeSegment[];
     highDensityNodePortPoints?: NodeWithPortPoints[];
     cacheProvider: CacheProvider | null;
-    pipelineDef: (PipelineStep$3<typeof PreprocessSimpleRouteJsonSolver$1> | PipelineStep$3<typeof ComponentDetectionSolver> | PipelineStep$3<typeof EscapeViaLocationSolver> | PipelineStep$3<typeof NetToPointPairsSolver2_OffBoardConnection> | PipelineStep$3<typeof MultiGraphTopologyPlannerSolver> | PipelineStep$3<typeof TopologyMergingSolver> | PipelineStep$3<typeof NodeDimensionSubdivisionSolver> | PipelineStep$3<typeof CapacityMeshEdgeSolver2_NodeTreeOptimization> | PipelineStep$3<typeof AvailableSegmentPointSolver> | PipelineStep$3<typeof MultiTargetNecessaryCrampedPortPointSolver> | PipelineStep$3<typeof TinyHypergraphPortPointPathingSolver> | PipelineStep$3<typeof UniformPortDistributionSolver> | PipelineStep$3<typeof HighDensitySolver> | PipelineStep$3<typeof HighDensityForceImproveSolver> | PipelineStep$3<typeof Pipeline4HighDensityRepairSolver> | PipelineStep$3<typeof MultipleHighDensityRouteStitchSolver3> | PipelineStep$3<typeof TraceSimplificationSolver> | PipelineStep$3<typeof TraceWidthSolver> | PipelineStep$3<typeof GlobalDrcForceImproveSolver> | PipelineStep$3<typeof GlobalDrcBranchPortfolioSolver> | PipelineStep$3<typeof PostProcessingSolver> | PipelineStep$3<typeof PowerTraceExpansionSolver>)[];
+    pipelineDef: (PipelineStep$3<typeof PreprocessSimpleRouteJsonSolver$1> | PipelineStep$3<typeof ComponentDetectionSolver> | PipelineStep$3<typeof EscapeViaLocationSolver> | PipelineStep$3<typeof NetToPointPairsSolver2_OffBoardConnection> | PipelineStep$3<typeof MultiGraphTopologyPlannerSolver> | PipelineStep$3<typeof TopologyMergingSolver> | PipelineStep$3<typeof NodeDimensionSubdivisionSolver> | PipelineStep$3<typeof CapacityMeshEdgeSolver2_NodeTreeOptimization> | PipelineStep$3<typeof AvailableSegmentPointSolver> | PipelineStep$3<typeof MultiTargetNecessaryCrampedPortPointSolver> | PipelineStep$3<typeof TinyHypergraphPortPointPathingSolver> | PipelineStep$3<typeof UniformPortDistributionSolver> | PipelineStep$3<typeof HighDensitySolver> | PipelineStep$3<typeof HighDensityForceImproveSolver> | PipelineStep$3<typeof Pipeline4HighDensityRepairSolver> | PipelineStep$3<typeof MultipleHighDensityRouteStitchSolver3> | PipelineStep$3<typeof TraceSimplificationSolver> | PipelineStep$3<typeof TraceWidthSolver> | PipelineStep$3<typeof GlobalDrcForceImproveSolver> | PipelineStep$3<typeof GlobalDrcBranchPortfolioSolver> | PipelineStep$3<typeof SafePostProcessingSolver> | PipelineStep$3<typeof PowerTraceExpansionSolver>)[];
     constructor(srj: SimpleRouteJson, opts?: CapacityMeshSolverOptions$3);
     private setSimpleRouteJson;
     getConstructorParams(): readonly [SimpleRouteJson, CapacityMeshSolverOptions$3];
@@ -6051,7 +6080,7 @@ declare class AutoroutingPipelineSolver9_PreloadedTraceGraph extends BaseSolver
     strawSolver?: StrawSolver;
     deadEndSolver?: DeadEndSolver;
     traceSimplificationSolver?: TraceSimplificationSolver;
-    postProcessingSolver?: PostProcessingSolver;
+    lengthMatchingPostProcessingSolver?: PostProcessingSolver;
     availableSegmentPointSolver?: AvailableSegmentPointSolver;
     portPointPathingSolver?: TinyHypergraphPortPointPathingSolver;
     multiSectionPortPointOptimizer?: MultiSectionPortPointOptimizer;