@tscircuit/schematic-trace-solver 0.0.43 → 0.0.45

package/dist/index.d.ts

@@ -238,6 +238,7 @@ declare class TraceOverlapShiftSolver extends BaseSolver {
      */
     traceNetIslands: Record<ConnNetId, Array<SolvedTracePath>>;
     correctedTraceMap: Record<MspConnectionPairId, SolvedTracePath>;
+    cleanupPhase: "diagonals" | "done" | null;
     constructor(params: {
         inputProblem: InputProblem;
         inputTracePaths: Array<SolvedTracePath>;
@@ -248,6 +249,8 @@ declare class TraceOverlapShiftSolver extends BaseSolver {
     findNextOverlapIssue(): {
         overlappingTraceSegments: Array<OverlappingTraceSegmentLocator>;
     } | null;
+    private findNextDiagonalSegment;
+    private findAndFixNextDiagonalSegment;
     _step(): void;
     visualize(): graphics_debug.GraphicsObject;
 }
@@ -514,17 +517,23 @@ declare class LongDistancePairSolver extends BaseSolver {
     };
 }
 
+/**
+ * Defines the input structure for the TraceCleanupSolver.
+ */
 interface TraceCleanupSolverInput {
     inputProblem: InputProblem;
     allTraces: SolvedTracePath[];
-    targetTraceIds: Set<string>;
     allLabelPlacements: NetLabelPlacement[];
     mergedLabelNetIdMap: Record<string, Set<string>>;
     paddingBuffer: number;
 }
 /**
- * Cleans up traces by minimizing turns and balancing L-shapes to improve
- * the overall aesthetics and readability of the schematic.
+ * The TraceCleanupSolver is responsible for improving the aesthetics and readability of schematic traces.
+ * It operates in a multi-step pipeline:
+ * 1. **Untangling Traces**: It first attempts to untangle any overlapping or highly convoluted traces using a sub-solver.
+ * 2. **Minimizing Turns**: After untangling, it iterates through each trace to minimize the number of turns, simplifying their paths.
+ * 3. **Balancing L-Shapes**: Finally, it balances L-shaped trace segments to create more visually appealing and consistent layouts.
+ * The solver processes traces one by one, applying these cleanup steps sequentially to refine the overall trace layout.
  */
 declare class TraceCleanupSolver extends BaseSolver {
     private input;
@@ -533,8 +542,13 @@ declare class TraceCleanupSolver extends BaseSolver {
     private tracesMap;
     private pipelineStep;
     private activeTraceId;
+    activeSubSolver: BaseSolver | null;
     constructor(solverInput: TraceCleanupSolverInput);
     _step(): void;
+    private _runUntangleTracesStep;
+    private _runMinimizeTurnsStep;
+    private _runBalanceLShapesStep;
+    private _processTrace;
     getOutput(): {
         traces: SolvedTracePath[];
     };