@tscircuit/capacity-autorouter 0.0.857 → 0.0.858

package/dist/index.d.ts

@@ -6275,11 +6275,12 @@ declare class Pipeline9HighDensitySolver extends BaseSolver {
     constructor(params: Pipeline9HighDensitySolverParams);
     getSolverName(): string;
     getUpdatedFixedHdRoutes(): PreloadedHighDensityRoute[];
-    private finishActiveNode;
-    private startRegularSolver;
+    protected finishActiveNode(routes: HighDensityIntraNodeRoute$1[]): void;
+    protected startRegularSolver(node: NodeWithPortPoints): void;
     private startRegionalFallback;
     private finishRegionalFallback;
     private recordRegionalCandidateRejections;
+    protected finishRegularSolverFailure(error: string): void;
     _step(): void;
     visualize(): GraphicsObject;
 }
@@ -6491,6 +6492,121 @@ declare class AutoroutingPipelineSolver9_PreloadedTraceGraph extends BaseSolver
     getOutputSimpleRouteJson(): SimpleRouteJson;
 }
 
+type AutoroutingPipelineSolver9NetworkedOptions = Omit<AutoroutingPipelineSolverOptions$1, "effort"> & {
+    effort?: 1;
+    /** Base URL of an hd-cache2-compatible server. */
+    hdCache2ServerUrl?: string;
+    /** Optional cache namespace, used to isolate cold/hot benchmark runs. */
+    hdCache2CacheVersion?: string;
+};
+/** Pipeline9 with exact, version-scoped remote terminal node solving. */
+declare class AutoroutingPipelineSolver9_Networked extends AutoroutingPipelineSolver9_PreloadedTraceGraph {
+    readonly hdCache2ServerUrl: string;
+    readonly hdCache2CacheVersion?: string;
+    getSolverName(): string;
+    constructor(srj: SimpleRouteJson, opts?: AutoroutingPipelineSolver9NetworkedOptions);
+    private replaceHighDensityPipelineStep;
+    stepAsync(): Promise<void>;
+    solveAsync(): Promise<void>;
+    solveUntilPhaseAsync(phase: string): Promise<void>;
+    solve(): void;
+    solveUntilPhase(_phase: string): void;
+}
+
+/** The exact published autorouter version used to isolate network cache keys. */
+declare const AUTOROUTER_VERSION: string;
+
+type Pipeline9NetworkedCacheSource = "cache" | "solver";
+declare const PIPELINE9_NETWORKED_SOLVE_POLICY: "ordinary_then_regional_without_fixed_copper_v1";
+/**
+ * Every solution-affecting input for Pipeline9's terminal single-node policy:
+ * ordinary high-density routing followed, when enabled, by the regional
+ * no-fixed-copper fallback. The shape is JSON-serializable so the exact same
+ * helper can run in the cache service.
+ */
+type Pipeline9NetworkedHighDensityNodeInput = {
+    solvePolicy: typeof PIPELINE9_NETWORKED_SOLVE_POLICY;
+    enableRegionalFallback: boolean;
+    nodeWithPortPoints: NodeWithPortPoints;
+    connectivityNetMap: Record<string, string[]>;
+    colorMap: Record<string, string>;
+    viaDiameter: number;
+    traceWidth: number;
+    obstacleMargin: number;
+    effort: 1;
+    obstacles: Obstacle[];
+    regionalObstacles: Obstacle[];
+    layerCount: number;
+    nodePf: number | null;
+};
+type Pipeline9NetworkedHighDensityNodeOutput = {
+    status: "solved";
+    solutionStage: "ordinary";
+    routes: HighDensityIntraNodeRoute$1[];
+} | {
+    status: "solved";
+    solutionStage: "regional-fallback";
+    ordinaryFailure: string;
+    routes: HighDensityIntraNodeRoute$1[];
+} | {
+    status: "failed";
+    solutionStage: "ordinary";
+    error: string;
+} | {
+    status: "failed";
+    solutionStage: "regional-fallback";
+    ordinaryFailure: string;
+    error: string;
+};
+type Pipeline9NetworkedSolveRequest = {
+    autorouterVersion: string;
+    /** Optional cache namespace used to isolate benchmark runs. */
+    cacheVersion?: string;
+    input: Pipeline9NetworkedHighDensityNodeInput;
+};
+type Pipeline9NetworkedSolveBatchItem = {
+    requestId: string;
+    input: Pipeline9NetworkedHighDensityNodeInput;
+};
+type Pipeline9NetworkedSolveBatchRequest = {
+    autorouterVersion: string;
+    /** Optional cache namespace used to isolate benchmark runs. */
+    cacheVersion?: string;
+    items: Pipeline9NetworkedSolveBatchItem[];
+};
+type Pipeline9NetworkedSolveResponse = ({
+    ok: true;
+    autorouterVersion: string;
+    cacheVersion?: string;
+    source: Pipeline9NetworkedCacheSource;
+} & Pipeline9NetworkedHighDensityNodeOutput) | {
+    ok: false;
+    autorouterVersion?: string;
+    cacheVersion?: string;
+    message: string;
+};
+type Pipeline9NetworkedSolveBatchCacheMiss = {
+    requestId: string;
+    ok: false;
+    autorouterVersion: string;
+    cacheVersion?: string;
+    code: "CACHE_MISS";
+    message: string;
+};
+/** One independently consumable NDJSON line returned by POST /solve-batch. */
+type Pipeline9NetworkedSolveBatchResult = ({
+    requestId: string;
+} & Pipeline9NetworkedSolveResponse) | Pipeline9NetworkedSolveBatchCacheMiss;
+
+declare const DEFAULT_HD_CACHE2_SERVER_URL = "https://hd-cache2.tscircuit.com";
+
+/**
+ * Runs Pipeline9's terminal no-fixed-copper node policy. hd-cache2 calls this
+ * exported helper so ordinary and regional cache entries can only be produced
+ * by its installed autorouter implementation.
+ */
+declare function solvePipeline9NetworkedHighDensityNode(input: Pipeline9NetworkedHighDensityNodeInput): Pipeline9NetworkedHighDensityNodeOutput;
+
 type AutoroutingPipeline10Input = {
     inputSrj: SimpleRouteJson;
     options: AutoroutingPipelineSolverOptions$1;
@@ -7667,4 +7783,4 @@ declare const HyperSingleIntraNodeSolver: typeof PortfolioSingleIntraNodeSolver;
  */
 type HyperSingleIntraNodeSolver = InstanceType<typeof PortfolioSingleIntraNodeSolver>;
 
-export { AssignableAutoroutingPipeline1Solver, AssignableAutoroutingPipeline2, AssignableAutoroutingPipeline3, AttachProjectedRectsSolver, AutoroutingPipeline1_OriginalUnravel, AutoroutingPipelineSolver7_MultiGraph as AutoroutingPipelineSolver, AutoroutingPipelineSolver10_BgaFanout, AutoroutingPipelineSolver2_PortPointPathing, AutoroutingPipelineSolver3_HgPortPointPathing, AutoroutingPipelineSolver4_TinyHypergraph as AutoroutingPipelineSolver4, AutoroutingPipelineSolver4_TinyHypergraph, AutoroutingPipelineSolver5_HdCache as AutoroutingPipelineSolver5, AutoroutingPipelineSolver5_HdCache, AutoroutingPipelineSolver6_PolyHypergraph as AutoroutingPipelineSolver6, AutoroutingPipelineSolver6_PolyHypergraph, AutoroutingPipelineSolver7_MultiGraph, AutoroutingPipelineSolver8, AutoroutingPipelineSolver9_PreloadedTraceGraph, type AutoroutingPipelineSolverOptions, type BusId, type CachableSolver, type CacheProvider, CapacityMeshSolver, type ConnectionPoint$1 as ConnectionPoint, type ConvertSrjToGraphicsObjectOptions, CurvyIntraNodeSolver, type DifferentialPair, GrowShrinkHighDensityIntraNodeSolver, type HighDensityIntraNodeRouteWithJumpers, JumperHighDensitySolver as HighDensitySolver, HyperSingleIntraNodeSolver, InMemoryCache, IntraNodeSolverWithJumpers, type Jumper, LocalStorageCache, type MultiLayerConnectionPoint, type Obstacle, PolyHighDensitySolver, PolySingleIntraNodeSolver as PolyIntraNodeSolver, PolySingleIntraNodeSolver, PortfolioSingleIntraNodeSolver, ProjectHighDensityToPolygonSolver, type RerouteRectRegion, type SimpleRouteBus, type SimpleRouteConnection, type SimpleRouteJson, type SimplifiedPcbTrace, type SimplifiedPcbTraces, SingleHighDensityRouteWithJumpersSolver, type SingleLayerConnectionPoint, type TerminalViaHint, type TraceColorMode, calculateOptimalCapacityDepth, convertSrjToGraphicsObject, getGlobalInMemoryCache, getGlobalLocalStorageCache, getRerouteSimpleRouteJson, getTunedTotalCapacity1, reconnectReroutedSimpleRouteJsonRegion, setupGlobalCaches };
+export { AUTOROUTER_VERSION, AssignableAutoroutingPipeline1Solver, AssignableAutoroutingPipeline2, AssignableAutoroutingPipeline3, AttachProjectedRectsSolver, AutoroutingPipeline1_OriginalUnravel, AutoroutingPipelineSolver7_MultiGraph as AutoroutingPipelineSolver, AutoroutingPipelineSolver10_BgaFanout, AutoroutingPipelineSolver2_PortPointPathing, AutoroutingPipelineSolver3_HgPortPointPathing, AutoroutingPipelineSolver4_TinyHypergraph as AutoroutingPipelineSolver4, AutoroutingPipelineSolver4_TinyHypergraph, AutoroutingPipelineSolver5_HdCache as AutoroutingPipelineSolver5, AutoroutingPipelineSolver5_HdCache, AutoroutingPipelineSolver6_PolyHypergraph as AutoroutingPipelineSolver6, AutoroutingPipelineSolver6_PolyHypergraph, AutoroutingPipelineSolver7_MultiGraph, AutoroutingPipelineSolver8, type AutoroutingPipelineSolver9NetworkedOptions, AutoroutingPipelineSolver9_Networked, AutoroutingPipelineSolver9_PreloadedTraceGraph, type AutoroutingPipelineSolverOptions, type BusId, type CachableSolver, type CacheProvider, CapacityMeshSolver, type ConnectionPoint$1 as ConnectionPoint, type ConvertSrjToGraphicsObjectOptions, CurvyIntraNodeSolver, DEFAULT_HD_CACHE2_SERVER_URL, type DifferentialPair, GrowShrinkHighDensityIntraNodeSolver, type HighDensityIntraNodeRouteWithJumpers, JumperHighDensitySolver as HighDensitySolver, HyperSingleIntraNodeSolver, InMemoryCache, IntraNodeSolverWithJumpers, type Jumper, LocalStorageCache, type MultiLayerConnectionPoint, type Obstacle, PIPELINE9_NETWORKED_SOLVE_POLICY, type Pipeline9NetworkedCacheSource, type Pipeline9NetworkedHighDensityNodeInput, type Pipeline9NetworkedHighDensityNodeOutput, type Pipeline9NetworkedSolveBatchCacheMiss, type Pipeline9NetworkedSolveBatchItem, type Pipeline9NetworkedSolveBatchRequest, type Pipeline9NetworkedSolveBatchResult, type Pipeline9NetworkedSolveRequest, type Pipeline9NetworkedSolveResponse, PolyHighDensitySolver, PolySingleIntraNodeSolver as PolyIntraNodeSolver, PolySingleIntraNodeSolver, PortfolioSingleIntraNodeSolver, ProjectHighDensityToPolygonSolver, type RerouteRectRegion, type SimpleRouteBus, type SimpleRouteConnection, type SimpleRouteJson, type SimplifiedPcbTrace, type SimplifiedPcbTraces, SingleHighDensityRouteWithJumpersSolver, type SingleLayerConnectionPoint, type TerminalViaHint, type TraceColorMode, calculateOptimalCapacityDepth, convertSrjToGraphicsObject, getGlobalInMemoryCache, getGlobalLocalStorageCache, getRerouteSimpleRouteJson, getTunedTotalCapacity1, reconnectReroutedSimpleRouteJsonRegion, setupGlobalCaches, solvePipeline9NetworkedHighDensityNode };