@tscircuit/capacity-autorouter 0.0.221 → 0.0.223

package/dist/index.d.ts

@@ -188,6 +188,7 @@ declare class CapacityMeshEdgeSolver extends BaseSolver {
 type PortPoint = {
     connectionName: string;
     rootConnectionName?: string;
+    portPointId?: string;
     x: number;
     y: number;
     z: number;
@@ -1404,7 +1405,7 @@ declare class PortPointPathingSolver extends BaseSolver {
     offBoardNodes: InputNodeWithPortPoints[];
     /** Cache of base node cost (cost of node in current committed state) */
     private baseNodeCostCache;
-    constructor({ simpleRouteJson, inputNodes, capacityMeshNodes, colorMap, nodeMemoryPfMap, hyperParameters, precomputedInitialParams, }: {
+    constructor({ simpleRouteJson, inputNodes, capacityMeshNodes, colorMap, nodeMemoryPfMap, hyperParameters, precomputedInitialParams, fixedRoutes, }: {
         simpleRouteJson: SimpleRouteJson;
         capacityMeshNodes: CapacityMeshNode[];
         inputNodes: InputNodeWithPortPoints[];
@@ -1412,6 +1413,8 @@ declare class PortPointPathingSolver extends BaseSolver {
         nodeMemoryPfMap?: Map<CapacityMeshNodeId, number>;
         hyperParameters?: Partial<PortPointPathingHyperParameters>;
         precomputedInitialParams?: PrecomputedInitialParams;
+        /** Pre-routed connections that should not be re-routed but should appear in results */
+        fixedRoutes?: ConnectionPathResult[];
     });
     private clearCostCaches;
     private clampPf;
@@ -1533,6 +1536,10 @@ interface HyperPortPointPathingSolverParams {
     numShuffleSeeds?: number;
     minAllowedBoardScore?: number;
     hyperParameters?: Partial<PortPointPathingHyperParameters>;
+    /** Pre-routed connections that should not be re-routed but should appear in results */
+    fixedRoutes?: ConnectionPathResult[];
+    /** Custom precomputed params (if provided, skips internal precomputation) */
+    precomputedInitialParams?: PrecomputedInitialParams;
 }
 declare class HyperPortPointPathingSolver extends HyperParameterSupervisorSolver<PortPointPathingSolver> {
     private params;
@@ -1611,6 +1618,7 @@ interface SectionPath {
         y: number;
         z: number;
         nodeId: CapacityMeshNodeId;
+        portPointId?: string;
     }>;
     /** Index in original path where this segment starts */
     originalStartIndex: number;
@@ -1668,6 +1676,16 @@ interface MultiSectionPortPointOptimizerParams {
     /** Node assigned port points from initial run */
     initialNodeAssignedPortPoints: Map<CapacityMeshNodeId, PortPoint[]>;
     effort?: number;
+    /**
+     * Fraction of connections in a section to rip/replace (0-1).
+     * Default 1 means rip all connections. Values less than 1 keep some traces.
+     */
+    FRACTION_TO_REPLACE?: number;
+    /**
+     * If true, always rip connections that have same-layer intersections,
+     * even if they would otherwise be kept due to FRACTION_TO_REPLACE.
+     */
+    ALWAYS_RIP_INTERSECTIONS?: boolean;
 }
 /**
  * MultiSectionPortPointOptimizer runs local optimization on sections of the
@@ -1717,6 +1735,20 @@ declare class MultiSectionPortPointOptimizer extends BaseSolver {
     MAX_SECTION_ATTEMPTS: number;
     /** Acceptable probability of failure threshold */
     ACCEPTABLE_PF: number;
+    /**
+     * Fraction of connections in a section to rip/replace (0-1).
+     * Default 1 means rip all connections. Values less than 1 keep some traces.
+     */
+    FRACTION_TO_REPLACE: number;
+    /**
+     * If true, always rip connections that have same-layer intersections,
+     * even if they would otherwise be kept due to FRACTION_TO_REPLACE.
+     *
+     * Uses a greedy vertex cover approach: for each intersection, only one
+     * connection is ripped (chosen based on the shuffle seed), rather than
+     * ripping all connections involved in intersections.
+     */
+    ALWAYS_RIP_INTERSECTIONS: boolean;
     effort: number;
     constructor(params: MultiSectionPortPointOptimizerParams);
     /**
@@ -1756,10 +1788,22 @@ declare class MultiSectionPortPointOptimizer extends BaseSolver {
         sectionPath: SectionPath;
         originalConnectionResult: ConnectionPathResult;
     }>;
+    /** Port points from connections that are being kept (not ripped) in the current section */
+    currentSectionKeptPortPoints: Map<CapacityMeshNodeId, PortPoint[]>;
+    /** Connection results for connections being kept (not ripped) - used for visualization */
+    currentSectionFixedRoutes: ConnectionPathResult[];
+    /**
+     * Determine which connections to rip based on FRACTION_TO_REPLACE and ALWAYS_RIP_INTERSECTIONS.
+     * Returns a set of connection names that should be ripped (re-routed).
+     */
+    determineConnectionsToRip(section: PortPointSection, allConnectionNames: string[]): Set<string>;
     /**
      * Create a SimpleRouteJson for just the section's connections.
      * Includes both fully contained connections AND cut paths (partial connections
      * that pass through the section).
+     *
+     * Respects FRACTION_TO_REPLACE and ALWAYS_RIP_INTERSECTIONS to determine which
+     * connections to include for re-routing.
      */
     createSectionSimpleRouteJson(section: PortPointSection): SimpleRouteJson;
     /**
@@ -3209,7 +3253,7 @@ declare class AssignableAutoroutingPipeline2 extends BaseSolver {
     capacityNodes: CapacityMeshNode[] | null;
     capacityEdges: CapacityMeshEdge[] | null;
     cacheProvider: CacheProvider | null;
-    pipelineDef: (PipelineStep$1<typeof NetToPointPairsSolver> | PipelineStep$1<typeof RectDiffPipeline> | PipelineStep$1<typeof RelateNodesToOffBoardConnectionsSolver> | PipelineStep$1<typeof CapacityMeshEdgeSolver2_NodeTreeOptimization> | PipelineStep$1<typeof AvailableSegmentPointSolver> | PipelineStep$1<typeof HyperPortPointPathingSolver> | PipelineStep$1<typeof SimpleHighDensitySolver> | PipelineStep$1<typeof MultipleHighDensityRouteStitchSolver> | PipelineStep$1<typeof TraceSimplificationSolver> | PipelineStep$1<typeof TraceKeepoutSolver> | PipelineStep$1<typeof TraceWidthSolver>)[];
+    pipelineDef: (PipelineStep$1<typeof NetToPointPairsSolver> | PipelineStep$1<typeof RectDiffPipeline> | PipelineStep$1<typeof RelateNodesToOffBoardConnectionsSolver> | PipelineStep$1<typeof CapacityMeshEdgeSolver2_NodeTreeOptimization> | PipelineStep$1<typeof AvailableSegmentPointSolver> | PipelineStep$1<typeof HyperPortPointPathingSolver> | PipelineStep$1<typeof MultiSectionPortPointOptimizer> | PipelineStep$1<typeof SimpleHighDensitySolver> | PipelineStep$1<typeof MultipleHighDensityRouteStitchSolver> | PipelineStep$1<typeof TraceSimplificationSolver> | PipelineStep$1<typeof TraceKeepoutSolver> | PipelineStep$1<typeof TraceWidthSolver>)[];
     constructor(srj: SimpleRouteJson, opts?: CapacityMeshSolverOptions$1);
     getConstructorParams(): readonly [SimpleRouteJson, CapacityMeshSolverOptions$1];
     currentPipelineStepIndex: number;