@tscircuit/capacity-autorouter 0.0.639 → 0.0.641

package/dist/index.d.ts

@@ -5540,26 +5540,111 @@ declare class ComponentDetectionSolver extends BasePipelineSolver<ComponentDetec
     initialVisualize(): GraphicsObject | null;
 }
 
-interface ComponentTopologyGeneratorSolverParams {
-    detectedComponents: DetectedComponent[];
-    inputSrj: SimpleRouteJson;
+/** Shared output collected from each component-specific topology generator. */
+interface TopologyGeneratorSolverOutput {
+    routingRegions: CapacityMeshNode[];
+}
+type TopologyGeneratorSolver = BaseSolver$1 & {
+    getOutput(): TopologyGeneratorSolverOutput;
+};
+
+interface ComponentTopologyBatchSolverParams {
+    componentSrjs: SimpleRouteJson[];
+    componentIds: string[];
+    componentKinds: ComponentKind[];
     viaDiameter?: number;
     obstacleMargin?: number;
 }
-type ComponentTopologyGeneratorSolverOutput = CapacityMeshNode[];
-declare class ComponentTopologyGeneratorSolver extends BaseSolver {
-    readonly inputProblem: ComponentTopologyGeneratorSolverParams;
-    private output;
-    private componentMeshNodes;
-    private currentComponentIndex;
-    private activeTopologyGenerator;
-    constructor(inputProblem: ComponentTopologyGeneratorSolverParams);
-    getConstructorParams(): readonly [ComponentTopologyGeneratorSolverParams];
+interface ComponentTopologyBatchSolverOutput {
+    componentMeshNodes: CapacityMeshNode[][];
+}
+/** Runs one component-local topology solve per component SRJ and collects the routing regions. */
+declare class ComponentTopologyBatchSolver extends BaseSolver$1 {
+    readonly inputProblem: ComponentTopologyBatchSolverParams;
+    activeSubSolver: TopologyGeneratorSolver | null;
+    currentIndex: number;
+    componentMeshNodes: CapacityMeshNode[][];
+    constructor(inputProblem: ComponentTopologyBatchSolverParams);
+    getConstructorParams(): readonly [ComponentTopologyBatchSolverParams];
+    /** Steps through component solves sequentially to keep solver state simple and explicit. */
     _step(): void;
-    private finalizeComponentTopology;
-    createComponentObstacleSrj(inputSrj?: SimpleRouteJson): SimpleRouteJson;
+    getOutput(): ComponentTopologyBatchSolverOutput;
+    visualize(): GraphicsObject;
+}
+
+interface SerializedTopologyComponentInput {
+    componentId: string;
+    componentKind: ComponentKind;
+    memberObstacleIds: string[];
+    memberObstacles: Obstacle[];
+    replacementObstacle: Obstacle & {
+        obstacleId: string;
+    };
+}
+interface MultiGraphTopologyPlannerSolverParams {
+    inputSrj: SimpleRouteJson;
+    globalNoConnectionSrj?: SimpleRouteJson;
+    components?: SerializedTopologyComponentInput[];
+    componentDetectionOutput?: DetectedComponent[];
+    viaDiameter?: number;
+    obstacleMargin?: number;
+    brokenSrj?: {
+        componentsAsObstaclesSrj: SimpleRouteJson;
+        components: SerializedTopologyComponentInput[];
+    };
+}
+interface MultiGraphTopologyPlannerSolverOutput {
+    globalNoConnectionSrj: SimpleRouteJson;
+    componentNoConnectionSrjs: SimpleRouteJson[];
+    globalMeshNodes: CapacityMeshNode[];
+    componentMeshNodes: CapacityMeshNode[][];
+    mergedMeshNodes: CapacityMeshNode[];
+}
+/**
+ * Produces a merged routing topology where component replacement regions from
+ * the global solve are substituted with component-local routing regions.
+ */
+declare class MultiGraphTopologyPlannerSolver extends BasePipelineSolver<MultiGraphTopologyPlannerSolverParams> {
+    globalTopologySolver?: RectDiffPipeline;
+    componentTopologyBatchSolver?: ComponentTopologyBatchSolver;
+    private normalizedInput;
+    pipelineDef: PipelineStep$a<BaseSolver$1>[];
+    constructor(params: MultiGraphTopologyPlannerSolverParams);
+    getConstructorParams(): readonly [MultiGraphTopologyPlannerSolverParams];
+    /**
+     * Returns the global solve, the per-component solves, and the merged routing
+     * regions used by downstream stages.
+     */
+    getOutput(): MultiGraphTopologyPlannerSolverOutput;
+    finalVisualize(): GraphicsObject | null;
+    visualize(): GraphicsObject;
+    preview(): GraphicsObject;
+    /** Rebuilds each component-local SRJ from its original member obstacles. */
+    private getComponentNoConnectionSrjs;
+    /** Adapts the global no-connection SRJ into the RectDiffPipeline input shape. */
+    private getGlobalTopologySolverInput;
+    /**
+     * Removes raw RectDiff node rects that are superseded by component-local
+     * topology regions.
+     *
+     * @param params.visualization - Graphics output produced by the base
+     *   pipeline visualizer, including nested stage visualizations.
+     * @returns A visualization with RectDiff node rectangles inside component
+     *   areas removed. Non-RectDiff rectangles and all lines, points, circles,
+     *   and text entries are returned unchanged.
+     *
+     * @note This keeps intermediate RectDiff visualization consistent with the
+     * merged topology output, which already removes those nodes from solver data.
+     */
+    private filterGlobalRectDiffNodesFromVisualization;
+}
+
+declare class MergedComponentTopologyView extends BaseSolver {
+    private readonly topologyPlanningSolver;
+    constructor(topologyPlanningSolver: MultiGraphTopologyPlannerSolver);
+    getOutput(): CapacityMeshNode[];
     visualize(): GraphicsObject;
-    getOutput(): ComponentTopologyGeneratorSolverOutput;
+    preview(): GraphicsObject;
 }
 
 interface CapacityMeshSolverOptions$2 {
@@ -5584,7 +5669,8 @@ declare class AutoroutingPipelineSolver7_MultiGraph extends BaseSolver {
     preprocessSimpleRouteJsonSolver?: PreprocessSimpleRouteJsonSolver$1;
     escapeViaLocationSolver?: EscapeViaLocationSolver;
     netToPointPairsSolver?: NetToPointPairsSolver;
-    componentTopologyGeneratorSolver?: ComponentTopologyGeneratorSolver;
+    componentTopologyGeneratorSolver?: MergedComponentTopologyView;
+    topologyPlanningSolver?: MultiGraphTopologyPlannerSolver;
     globalTopologyGeneratorSolver?: RectDiffPipeline;
     nodeDimensionSubdivisionSolver?: NodeDimensionSubdivisionSolver;
     nodeTargetMerger?: CapacityNodeTargetMerger;
@@ -5627,7 +5713,7 @@ declare class AutoroutingPipelineSolver7_MultiGraph extends BaseSolver {
     sharedEdgeSegmentsWithNecessaryCrampedPortPoints?: SharedEdgeSegment[];
     highDensityNodePortPoints?: NodeWithPortPoints[];
     cacheProvider: CacheProvider | null;
-    pipelineDef: (PipelineStep$2<typeof PreprocessSimpleRouteJsonSolver$1> | PipelineStep$2<typeof ComponentDetectionSolver> | PipelineStep$2<typeof ComponentTopologyGeneratorSolver> | PipelineStep$2<typeof EscapeViaLocationSolver> | PipelineStep$2<typeof NetToPointPairsSolver2_OffBoardConnection> | PipelineStep$2<typeof RectDiffPipeline> | PipelineStep$2<typeof NodeDimensionSubdivisionSolver> | PipelineStep$2<typeof CapacityMeshEdgeSolver2_NodeTreeOptimization> | PipelineStep$2<typeof AvailableSegmentPointSolver> | PipelineStep$2<typeof MultiTargetNecessaryCrampedPortPointSolver> | PipelineStep$2<typeof TinyHypergraphPortPointPathingSolver> | PipelineStep$2<typeof UniformPortDistributionSolver> | PipelineStep$2<typeof HighDensitySolver> | PipelineStep$2<typeof HighDensityForceImproveSolver> | PipelineStep$2<typeof Pipeline4HighDensityRepairSolver> | PipelineStep$2<typeof MultipleHighDensityRouteStitchSolver3> | PipelineStep$2<typeof TraceSimplificationSolver> | PipelineStep$2<typeof TraceWidthSolver> | PipelineStep$2<typeof GlobalDrcForceImproveSolver>)[];
+    pipelineDef: (PipelineStep$2<typeof PreprocessSimpleRouteJsonSolver$1> | PipelineStep$2<typeof ComponentDetectionSolver> | PipelineStep$2<typeof EscapeViaLocationSolver> | PipelineStep$2<typeof NetToPointPairsSolver2_OffBoardConnection> | PipelineStep$2<typeof MultiGraphTopologyPlannerSolver> | PipelineStep$2<typeof NodeDimensionSubdivisionSolver> | PipelineStep$2<typeof CapacityMeshEdgeSolver2_NodeTreeOptimization> | PipelineStep$2<typeof AvailableSegmentPointSolver> | PipelineStep$2<typeof MultiTargetNecessaryCrampedPortPointSolver> | PipelineStep$2<typeof TinyHypergraphPortPointPathingSolver> | PipelineStep$2<typeof UniformPortDistributionSolver> | PipelineStep$2<typeof HighDensitySolver> | PipelineStep$2<typeof HighDensityForceImproveSolver> | PipelineStep$2<typeof Pipeline4HighDensityRepairSolver> | PipelineStep$2<typeof MultipleHighDensityRouteStitchSolver3> | PipelineStep$2<typeof TraceSimplificationSolver> | PipelineStep$2<typeof TraceWidthSolver> | PipelineStep$2<typeof GlobalDrcForceImproveSolver>)[];
     constructor(srj: SimpleRouteJson, opts?: CapacityMeshSolverOptions$2);
     private setSimpleRouteJson;
     getConstructorParams(): readonly [SimpleRouteJson, CapacityMeshSolverOptions$2];
@@ -6037,39 +6123,31 @@ interface RouteSection {
     startIndex: number;
     endIndex: number;
     z: number;
-    points: HighDensityRoute["route"];
+    points: HighDensityRoute$1["route"];
 }
+
 declare class SingleRouteUselessViaRemovalSolver extends BaseSolver {
     getSolverName(): string;
     obstacleSHI: ObstacleSpatialHashIndex;
     hdRouteSHI: HighDensityRouteSpatialIndex;
     unsimplifiedRoute: HighDensityRoute;
+    connMap: ConnectivityMap;
     routeSections: Array<RouteSection>;
     currentSectionIndex: number;
     TRACE_THICKNESS: number;
     OBSTACLE_MARGIN: number;
-    ENDPOINT_LAYER_EPSILON: number;
     constructor(params: {
         obstacleSHI: ObstacleSpatialHashIndex;
         hdRouteSHI: HighDensityRouteSpatialIndex;
         unsimplifiedRoute: HighDensityRoute;
+        connMap: ConnectivityMap;
     });
-    breakRouteIntoSections(route: HighDensityRoute): never[] | this["routeSections"];
     _step(): void;
-    /**
-     * Check if an endpoint (first or last point of the route) can connect
-     * to a different layer. This is only allowed if the obstacles the endpoint
-     * connects to support that layer.
-     */
-    canEndpointConnectOnLayer(endpointX: number, endpointY: number, targetZ: number): boolean;
-    canSectionMoveToLayer({ currentSection, targetZ, }: {
-        currentSection: RouteSection;
-        targetZ: number;
-    }): boolean;
     getConstructorParams(): {
         obstacleSHI: ObstacleSpatialHashIndex;
         hdRouteSHI: HighDensityRouteSpatialIndex;
         unsimplifiedRoute: HighDensityIntraNodeRoute;
+        connMap: ConnectivityMap;
     };
     getOptimizedHdRoute(): HighDensityRoute;
     visualize(): GraphicsObject;
@@ -6080,6 +6158,7 @@ interface UselessViaRemovalSolverInput {
     obstacles: Obstacle[];
     colorMap: Record<string, string>;
     layerCount: number;
+    connMap: ConnectivityMap;
 }
 declare class UselessViaRemovalSolver extends BaseSolver {
     private input;