@tscircuit/capacity-autorouter 0.0.58 → 0.0.60

package/dist/index.d.ts

@@ -102,6 +102,12 @@ declare class BaseSolver {
     failedSubSolvers?: BaseSolver[];
     timeToSolve?: number;
     stats: Record<string, number>;
+    /**
+     * For cached solvers
+     **/
+    cacheHit?: boolean;
+    cacheKey?: string;
+    cacheToSolveSpaceTransform?: any;
     /** DO NOT OVERRIDE! Override _step() instead */
     step(): void;
     _step(): void;
@@ -1146,6 +1152,9 @@ type SegmentPointMapAndReverseMaps = {
     segmentToSegmentPointMap: Map<SegmentId, SegmentPointId[]>;
 };
 
+interface UnravelSectionHyperParameters {
+    MAX_ITERATIONS_WITHOUT_IMPROVEMENT: number;
+}
 interface UnravelSectionSolverParams {
     rootNodeId: CapacityMeshNodeId;
     colorMap?: Record<string, string>;
@@ -1158,6 +1167,7 @@ interface UnravelSectionSolverParams {
     segmentPointMap?: SegmentPointMap;
     nodeToSegmentPointMap?: Map<CapacityMeshNodeId, SegmentPointId[]>;
     segmentToSegmentPointMap?: Map<SegmentId, SegmentPointId[]>;
+    hyperParameters?: Partial<UnravelSectionHyperParameters>;
 }
 /**
  * The UntangleSectionSolver optimizes a section of connected capacity nodes
@@ -1203,6 +1213,7 @@ declare class UnravelSectionSolver extends BaseSolver {
     tunedNodeCapacityMap: Map<CapacityMeshNodeId, number>;
     MAX_CANDIDATES: number;
     iterationsSinceImprovement: number;
+    hyperParameters: UnravelSectionHyperParameters;
     selectedCandidateIndex: number | "best" | "original" | null;
     queuedOrExploredCandidatePointModificationHashes: Set<string>;
     constructorParams: UnravelSectionSolverParams;
@@ -1231,6 +1242,18 @@ declare class UnravelSectionSolver extends BaseSolver {
     visualize(): GraphicsObject;
 }
 
+interface CacheProvider {
+    isSyncCache: boolean;
+    cacheHits: number;
+    cacheMisses: number;
+    getCachedSolutionSync(cacheKey: string): any;
+    getCachedSolution(cacheKey: string): Promise<any>;
+    setCachedSolutionSync(cacheKey: string, cachedSolution: any): void;
+    setCachedSolution(cacheKey: string, cachedSolution: any): Promise<void>;
+    getAllCacheKeys(): string[];
+    clearCache(): void;
+}
+
 declare class UnravelMultiSectionSolver extends BaseSolver {
     nodeMap: Map<CapacityMeshNodeId, CapacityMeshNode>;
     dedupedSegmentMap: Map<SegmentId, SegmentWithAssignedPoints>;
@@ -1252,7 +1275,8 @@ declare class UnravelMultiSectionSolver extends BaseSolver {
     attemptsToFixNode: Map<CapacityMeshNodeId, number>;
     activeSubSolver: UnravelSectionSolver | null;
     segmentPointMap: SegmentPointMap;
-    constructor({ assignedSegments, colorMap, nodes, }: {
+    cacheProvider: CacheProvider | null;
+    constructor({ assignedSegments, colorMap, nodes, cacheProvider, }: {
         assignedSegments: NodePortSegment[];
         colorMap?: Record<string, string>;
         /**
@@ -1260,6 +1284,7 @@ declare class UnravelMultiSectionSolver extends BaseSolver {
          * for the result datatype (the center, width, height of the node)
          */
         nodes: CapacityMeshNode[];
+        cacheProvider?: CacheProvider | null;
     });
     computeInitialPfMap(): Map<string, number>;
     computeNodePf(node: CapacityMeshNode): number;
@@ -1753,6 +1778,7 @@ declare class UselessViaRemovalSolver extends BaseSolver {
 interface CapacityMeshSolverOptions {
     capacityDepth?: number;
     targetMinCapacity?: number;
+    cacheProvider?: CacheProvider | null;
 }
 type PipelineStep<T extends new (...args: any[]) => BaseSolver> = {
     solverName: string;
@@ -1789,6 +1815,7 @@ declare class AutoroutingPipelineSolver extends BaseSolver {
     connMap: ConnectivityMap;
     srjWithPointPairs?: SimpleRouteJson;
     capacityNodes: CapacityMeshNode[] | null;
+    cacheProvider: CacheProvider | null;
     pipelineDef: (PipelineStep<typeof NetToPointPairsSolver> | PipelineStep<typeof CapacityMeshNodeSolver2_NodeUnderObstacle> | PipelineStep<typeof SingleLayerNodeMergerSolver> | PipelineStep<typeof StrawSolver> | PipelineStep<typeof CapacityMeshEdgeSolver2_NodeTreeOptimization> | PipelineStep<typeof CapacityPathingGreedySolver> | PipelineStep<typeof CapacityPathingMultiSectionSolver> | PipelineStep<typeof CapacityEdgeToPortSegmentSolver> | PipelineStep<typeof CapacitySegmentToPointSolver> | PipelineStep<typeof UnravelMultiSectionSolver> | PipelineStep<typeof HighDensitySolver> | PipelineStep<typeof MultipleHighDensityRouteStitchSolver> | PipelineStep<typeof UselessViaRemovalSolver> | PipelineStep<typeof MultiSimplifiedPathSolver>)[];
     constructor(srj: SimpleRouteJson, opts?: CapacityMeshSolverOptions);
     currentPipelineStepIndex: number;