@tscircuit/capacity-autorouter 0.0.864 → 0.0.866

package/README.md

@@ -49,6 +49,26 @@ if (solver.failed) {
 }
 ```
 
+### Simplifying Existing Traces
+
+Use `AutoroutingPipelineSolver11_Simplification` when the input already
+contains routed traces and only needs post-route cleanup. This pipeline does
+not route missing SRJ connections. Constant-width traces are simplified while
+variable-width traces retain their exact copper widths and geometry.
+
+```typescript
+import { AutoroutingPipelineSolver11_Simplification } from "@tscircuit/capacity-autorouter"
+
+const solver = new AutoroutingPipelineSolver11_Simplification(simpleRouteJson)
+solver.solve()
+
+if (solver.failed) {
+  throw new Error(solver.error ?? "Trace simplification failed")
+}
+
+const simplified = solver.getOutputSimpleRouteJson()
+```
+
 ### Input Format: SimpleRouteJson
 
 The input to the autorouter is a `SimpleRouteJson` object with the following structure:

package/dist/index.d.ts

@@ -2541,6 +2541,8 @@ declare class TraceSimplificationSolver extends BaseSolver {
      *   - enableCrossingViaReduction: Enables coordinated crossing layer swaps
      *   - preserveRouteEndpoints: Prevents simplification from moving endpoint
      *     coordinates or layers when routes represent spliceable local sections
+     *   - useTraceWidthAwareClearance: Uses each route segment's actual copper
+     *     width when checking path-simplification clearance
      *   - terminalLayerIndicesByPcbPortId: Physical copper-layer indices on
      *     which each PCB-port terminal can directly accept a route endpoint
      *     without a via
@@ -2563,6 +2565,7 @@ declare class TraceSimplificationSolver extends BaseSolver {
         readonly netByConnectionName?: ReadonlyMap<string, string>;
         readonly enableCrossingViaReduction?: boolean;
         readonly preserveRouteEndpoints?: boolean;
+        readonly useTraceWidthAwareClearance?: boolean;
         readonly terminalLayerIndicesByPcbPortId?: ReadonlyMap<string, ReadonlySet<number>>;
     });
     private validatePreservedRouteEndpoints;
@@ -6664,6 +6667,136 @@ declare class AutoroutingPipelineSolver10_BgaFanout extends BasePipelineSolver<A
     finalVisualize(): GraphicsObject;
 }
 
+type PreparedPipeline11Trace = {
+    originalTrace: SimplifiedPcbTrace;
+    mutableHdRoute?: HighDensityRoute$1;
+    leadingTerminalVias: SimplifiedPcbTrace["route"];
+    trailingTerminalVias: SimplifiedPcbTrace["route"];
+    uniformTraceWidth?: number;
+    viaHoleDiameter: number;
+};
+type PreparedPipeline11Simplification = {
+    originalSrj: SimpleRouteJson;
+    srj: SimpleRouteJson;
+    connMap: ConnectivityMap;
+    colorMap: Record<string, string>;
+    immutableHdRoutes: HighDensityRoute$1[];
+    mutableHdRoutes: HighDensityRoute$1[];
+    netByConnectionName: Map<string, string>;
+    options: AutoroutingPipelineSolver11SimplificationOptions;
+    preparedTraces: PreparedPipeline11Trace[];
+};
+type PrepareTraceSimplificationSolverInput = {
+    inputSrj: SimpleRouteJson;
+    options: AutoroutingPipelineSolver11SimplificationOptions;
+};
+declare class PrepareTraceSimplificationSolver extends BaseSolver$1 {
+    private readonly preparedInput;
+    private readonly seenTraceIds;
+    private nextTraceIndex;
+    constructor(input: PrepareTraceSimplificationSolverInput);
+    getSolverName(): string;
+    _step(): void;
+    private prepareTrace;
+    getOutput(): PreparedPipeline11Simplification;
+}
+
+type ApplyTraceSimplificationSolverInput = {
+    preparedInput: PreparedPipeline11Simplification;
+    simplifiedHdRoutes: HighDensityRoute$1[];
+};
+/** Converts one simplified high-density route back to SRJ per step. */
+declare class ApplyTraceSimplificationSolver extends BaseSolver$1 {
+    readonly inputProblem: ApplyTraceSimplificationSolverInput;
+    private readonly simplifiedRouteByTraceId;
+    private readonly outputTraces;
+    private nextTraceIndex;
+    constructor(inputProblem: ApplyTraceSimplificationSolverInput);
+    getSolverName(): string;
+    _step(): void;
+    private applyTrace;
+    private finishApplication;
+    getConstructorParams(): readonly [
+        ApplyTraceSimplificationSolverInput
+    ];
+    getOutput(): SimpleRouteJson;
+}
+
+type TraceSimplificationStageSolverInput = {
+    preparedInput: PreparedPipeline11Simplification;
+};
+/** Adapts the incremental cleanup solver to the conventional pipeline API. */
+declare class TraceSimplificationStageSolver extends BaseSolver$1 {
+    readonly inputProblem: TraceSimplificationStageSolverInput;
+    readonly traceSimplificationSolver: TraceSimplificationSolver;
+    constructor(inputProblem: TraceSimplificationStageSolverInput);
+    getSolverName(): string;
+    /** Advances exactly one incremental unit of the wrapped solver. */
+    _step(): void;
+    getConstructorParams(): readonly [
+        TraceSimplificationStageSolverInput
+    ];
+    getOutput(): HighDensityRoute$1[];
+    visualize(): GraphicsObject;
+    preview(): GraphicsObject;
+}
+
+type ValidateTraceSimplificationSolverInput = {
+    preparedInput: PreparedPipeline11Simplification;
+    outputSrj: SimpleRouteJson;
+};
+/** Rejects simplification whenever it introduces an autorouting DRC category. */
+declare class ValidateTraceSimplificationSolver extends BaseSolver$1 {
+    readonly inputProblem: ValidateTraceSimplificationSolverInput;
+    private readonly drcEngine;
+    private phase;
+    private baselineErrorCounts;
+    private outputErrorCounts;
+    constructor(inputProblem: ValidateTraceSimplificationSolverInput);
+    getSolverName(): string;
+    _step(): void;
+    private evaluateErrorCounts;
+    private assertNoNewDrcErrors;
+    getConstructorParams(): readonly [
+        ValidateTraceSimplificationSolverInput
+    ];
+    getOutput(): SimpleRouteJson;
+}
+
+interface AutoroutingPipelineSolver11SimplificationOptions {
+    /** Number of complete cleanup passes. Defaults to two. */
+    iterations?: number;
+    /** Enables coordinated layer swaps that reduce vias at crossings. */
+    enableCrossingViaReduction?: boolean;
+}
+type AutoroutingPipeline11SimplificationInput = {
+    inputSrj: SimpleRouteJson;
+    options: AutoroutingPipelineSolver11SimplificationOptions;
+};
+/**
+ * Pipeline 11 only cleans traces already present in the input SRJ. It never
+ * routes missing connections. Mixed-width traces remain immutable because the
+ * cleanup solvers operate on constant-width high-density routes.
+ */
+declare class AutoroutingPipelineSolver11_Simplification extends BasePipelineSolver<AutoroutingPipeline11SimplificationInput> {
+    prepareTraceSimplificationSolver?: PrepareTraceSimplificationSolver;
+    traceSimplificationStageSolver?: TraceSimplificationStageSolver;
+    applyTraceSimplificationSolver?: ApplyTraceSimplificationSolver;
+    validateTraceSimplificationSolver?: ValidateTraceSimplificationSolver;
+    pipelineDef: PipelineStep$b<BaseSolver$1>[];
+    constructor(inputSrj: SimpleRouteJson, options?: AutoroutingPipelineSolver11SimplificationOptions);
+    getSolverName(): string;
+    getConstructorParams(): readonly [
+        SimpleRouteJson,
+        AutoroutingPipelineSolver11SimplificationOptions
+    ];
+    getOutput(): SimpleRouteJson;
+    getOutputSimpleRouteJson(): SimpleRouteJson;
+    getOutputSimplifiedPcbTraces(): SimplifiedPcbTraces;
+    initialVisualize(): GraphicsObject;
+    finalVisualize(): GraphicsObject;
+}
+
 /**
  * Calculate the capacity of a node based on its width
  *
@@ -6937,6 +7070,7 @@ declare class MultiSimplifiedPathSolver extends BaseSolver {
     }>;
     minBoardEdgeClearance: number;
     defaultViaDiameter: number;
+    useTraceWidthAwareClearance: boolean;
     constructor(params: {
         unsimplifiedHdRoutes: HighDensityIntraNodeRoute$1[];
         /** Routed copper that participates in collision checks but is never changed. */
@@ -6950,6 +7084,7 @@ declare class MultiSimplifiedPathSolver extends BaseSolver {
         }>;
         minBoardEdgeClearance?: number;
         defaultViaDiameter?: number;
+        useTraceWidthAwareClearance?: boolean;
     });
     _step(): void;
     visualize(): GraphicsObject;
@@ -7784,4 +7919,4 @@ declare const HyperSingleIntraNodeSolver: typeof PortfolioSingleIntraNodeSolver;
  */
 type HyperSingleIntraNodeSolver = InstanceType<typeof PortfolioSingleIntraNodeSolver>;
 
-export { AUTOROUTER_VERSION, AssignableAutoroutingPipeline1Solver, AssignableAutoroutingPipeline2, AssignableAutoroutingPipeline3, AttachProjectedRectsSolver, AutoroutingPipeline1_OriginalUnravel, AutoroutingPipelineSolver7_MultiGraph as AutoroutingPipelineSolver, AutoroutingPipelineSolver10_BgaFanout, AutoroutingPipelineSolver2_PortPointPathing, AutoroutingPipelineSolver3_HgPortPointPathing, AutoroutingPipelineSolver4_TinyHypergraph as AutoroutingPipelineSolver4, AutoroutingPipelineSolver4_TinyHypergraph, AutoroutingPipelineSolver5_HdCache as AutoroutingPipelineSolver5, AutoroutingPipelineSolver5_HdCache, AutoroutingPipelineSolver6_PolyHypergraph as AutoroutingPipelineSolver6, AutoroutingPipelineSolver6_PolyHypergraph, AutoroutingPipelineSolver7_MultiGraph, AutoroutingPipelineSolver8, type AutoroutingPipelineSolver9NetworkedOptions, AutoroutingPipelineSolver9_Networked, AutoroutingPipelineSolver9_PreloadedTraceGraph, type AutoroutingPipelineSolverOptions, type BusId, type CachableSolver, type CacheProvider, CapacityMeshSolver, type ConnectionPoint$1 as ConnectionPoint, type ConvertSrjToGraphicsObjectOptions, CurvyIntraNodeSolver, DEFAULT_HD_CACHE2_SERVER_URL, type DifferentialPair, GrowShrinkHighDensityIntraNodeSolver, type HighDensityIntraNodeRouteWithJumpers, JumperHighDensitySolver as HighDensitySolver, HyperSingleIntraNodeSolver, InMemoryCache, IntraNodeSolverWithJumpers, type Jumper, LocalStorageCache, type MultiLayerConnectionPoint, type Obstacle, PIPELINE9_NETWORKED_SOLVE_POLICY, type Pipeline9NetworkedCacheSource, type Pipeline9NetworkedHighDensityNodeInput, type Pipeline9NetworkedHighDensityNodeOutput, type Pipeline9NetworkedSolveBatchCacheMiss, type Pipeline9NetworkedSolveBatchItem, type Pipeline9NetworkedSolveBatchRequest, type Pipeline9NetworkedSolveBatchResult, type Pipeline9NetworkedSolveRequest, type Pipeline9NetworkedSolveResponse, PolyHighDensitySolver, PolySingleIntraNodeSolver as PolyIntraNodeSolver, PolySingleIntraNodeSolver, PortfolioSingleIntraNodeSolver, ProjectHighDensityToPolygonSolver, type RerouteRectRegion, type SimpleRouteBus, type SimpleRouteConnection, type SimpleRouteJson, type SimplifiedPcbTrace, type SimplifiedPcbTraces, SingleHighDensityRouteWithJumpersSolver, type SingleLayerConnectionPoint, type TerminalViaHint, type TraceColorMode, calculateOptimalCapacityDepth, convertSrjToGraphicsObject, getGlobalInMemoryCache, getGlobalLocalStorageCache, getRerouteSimpleRouteJson, getTunedTotalCapacity1, reconnectReroutedSimpleRouteJsonRegion, setupGlobalCaches, solvePipeline9NetworkedHighDensityNode };
+export { AUTOROUTER_VERSION, AssignableAutoroutingPipeline1Solver, AssignableAutoroutingPipeline2, AssignableAutoroutingPipeline3, AttachProjectedRectsSolver, AutoroutingPipeline1_OriginalUnravel, AutoroutingPipelineSolver7_MultiGraph as AutoroutingPipelineSolver, AutoroutingPipelineSolver10_BgaFanout, type AutoroutingPipelineSolver11SimplificationOptions, AutoroutingPipelineSolver11_Simplification, AutoroutingPipelineSolver2_PortPointPathing, AutoroutingPipelineSolver3_HgPortPointPathing, AutoroutingPipelineSolver4_TinyHypergraph as AutoroutingPipelineSolver4, AutoroutingPipelineSolver4_TinyHypergraph, AutoroutingPipelineSolver5_HdCache as AutoroutingPipelineSolver5, AutoroutingPipelineSolver5_HdCache, AutoroutingPipelineSolver6_PolyHypergraph as AutoroutingPipelineSolver6, AutoroutingPipelineSolver6_PolyHypergraph, AutoroutingPipelineSolver7_MultiGraph, AutoroutingPipelineSolver8, type AutoroutingPipelineSolver9NetworkedOptions, AutoroutingPipelineSolver9_Networked, AutoroutingPipelineSolver9_PreloadedTraceGraph, type AutoroutingPipelineSolverOptions, type BusId, type CachableSolver, type CacheProvider, CapacityMeshSolver, type ConnectionPoint$1 as ConnectionPoint, type ConvertSrjToGraphicsObjectOptions, CurvyIntraNodeSolver, DEFAULT_HD_CACHE2_SERVER_URL, type DifferentialPair, GrowShrinkHighDensityIntraNodeSolver, type HighDensityIntraNodeRouteWithJumpers, JumperHighDensitySolver as HighDensitySolver, HyperSingleIntraNodeSolver, InMemoryCache, IntraNodeSolverWithJumpers, type Jumper, LocalStorageCache, type MultiLayerConnectionPoint, type Obstacle, PIPELINE9_NETWORKED_SOLVE_POLICY, type Pipeline9NetworkedCacheSource, type Pipeline9NetworkedHighDensityNodeInput, type Pipeline9NetworkedHighDensityNodeOutput, type Pipeline9NetworkedSolveBatchCacheMiss, type Pipeline9NetworkedSolveBatchItem, type Pipeline9NetworkedSolveBatchRequest, type Pipeline9NetworkedSolveBatchResult, type Pipeline9NetworkedSolveRequest, type Pipeline9NetworkedSolveResponse, PolyHighDensitySolver, PolySingleIntraNodeSolver as PolyIntraNodeSolver, PolySingleIntraNodeSolver, PortfolioSingleIntraNodeSolver, ProjectHighDensityToPolygonSolver, type RerouteRectRegion, type SimpleRouteBus, type SimpleRouteConnection, type SimpleRouteJson, type SimplifiedPcbTrace, type SimplifiedPcbTraces, SingleHighDensityRouteWithJumpersSolver, type SingleLayerConnectionPoint, type TerminalViaHint, type TraceColorMode, calculateOptimalCapacityDepth, convertSrjToGraphicsObject, getGlobalInMemoryCache, getGlobalLocalStorageCache, getRerouteSimpleRouteJson, getTunedTotalCapacity1, reconnectReroutedSimpleRouteJsonRegion, setupGlobalCaches, solvePipeline9NetworkedHighDensityNode };