@tscircuit/schematic-trace-solver 0.0.44 → 0.0.45

package/dist/index.d.ts

@@ -517,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;
@@ -536,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[];
     };