@tscircuit/core 0.0.2329 → 0.0.2330

package/dist/index.d.ts

@@ -2017,6 +2017,24 @@ interface AutoroutingStartEvent extends AutoroutingExecutionMetadata {
     phaseStageCount?: number;
     simpleRouteJson: SimpleRouteJson;
 }
+/** Hypergraph route search iterations. */
+type Iterations = number;
+/**
+ * Which connections were hardest to route in one stage, mirrored from the
+ * autorouter: each pair's solo search iterations, highest first.
+ */
+interface AutorouterComputeCostSummary {
+    readonly metric: "hypergraph_route_search_iterations";
+    /** Every pair that was measured, including those cut from topPairs. */
+    readonly measuredPairCount: number;
+    /** The most expensive pairs, highest first; at most 25. */
+    readonly topPairs: readonly {
+        readonly connectionName: string;
+        readonly rootConnectionNames: readonly string[];
+        readonly pcbPortIds: readonly [string | null, string | null];
+        readonly iterations: Iterations;
+    }[];
+}
 interface AutoroutingErrorEvent extends AutoroutingExecutionMetadata {
     type: "autorouting:error";
     subcircuit_id: string;
@@ -2030,6 +2048,7 @@ interface AutoroutingErrorEvent extends AutoroutingExecutionMetadata {
     };
     simpleRouteJson?: SimpleRouteJson;
     debugGraphics?: any;
+    computeCostSummary?: AutorouterComputeCostSummary;
 }
 interface AutoroutingProgressEvent extends AutoroutingExecutionMetadata {
     type: "autorouting:progress";
@@ -2041,6 +2060,7 @@ interface AutoroutingProgressEvent extends AutoroutingExecutionMetadata {
     progress: number;
     iterationsPerSecond?: number;
     debugGraphics?: any;
+    computeCostSummary?: AutorouterComputeCostSummary;
 }
 interface AutoroutingEndEvent extends AutoroutingExecutionMetadata {
     /**
@@ -2059,6 +2079,7 @@ interface AutoroutingEndEvent extends AutoroutingExecutionMetadata {
     phaseStageIndex?: number;
     phaseStageCount?: number;
     simpleRouteJson: SimpleRouteJson;
+    computeCostSummary?: AutorouterComputeCostSummary;
 }
 interface PackingStartEvent {
     type: "packing:start";
@@ -229364,6 +229385,7 @@ type AutorouterProgressEvent = {
     phase?: string;
     iterationsPerSecond?: number;
     debugGraphics?: GraphicsObject$1;
+    computeCostSummary?: AutorouterComputeCostSummary;
 };
 type AutorouterEvent = AutorouterCompleteEvent | AutorouterErrorEvent | AutorouterProgressEvent;
 interface GenericLocalAutorouter {
@@ -229375,6 +229397,7 @@ interface GenericLocalAutorouter {
     on(event: "error", callback: (ev: AutorouterErrorEvent) => void): void;
     on(event: "progress", callback: (ev: AutorouterProgressEvent) => void): void;
     solveSync(): SimplifiedPcbTrace[];
+    getComputeCostSummary?(): AutorouterComputeCostSummary | undefined;
     /**
      * Return a transformed routing problem for a subsequent autorouting phase.
      * Autorouters that only produce final traces can omit this method.
@@ -229604,4 +229627,4 @@ declare function checkCircuitJsonAssemblyExplosionCollisions(circuitJson: AnyCir
     manifold?: ManifoldToplevel;
 }): Promise<AssemblyExplosionCollisionCheck>;
 
-export { Ammeter, AnalogAcSweepSimulation, AnalogAnalysisSimulation, AnalogDcOperatingPointSimulation, AnalogDcSweepSimulation, AnalogDigitalStimulus, AnalogEyeDiagram, AnalogSimulation, AnalogSweepParameter, AnalogTransientSimulation, Antenna, AssemblyBolt, AssemblyCable, type AssemblyCableJsxProps, type AssemblyCadAssemblyJsxProps, AssemblyDevice, type AssemblyDeviceJsxProps, AssemblyDrawingDimension, AssemblyDrawingPage, AssemblyDrawingPartView, AssemblyDrawingTitleBlock, type AssemblyExplosionCollisionCheck, type AssemblyExplosionCollisionCheckStatus, type AssemblyExplosionLine, AssemblyExplosionMove, type AssemblyExplosionOptions, AssemblyExplosionStage, type AssemblyExplosionStageRef, type AssemblyExplosionView, AssemblyMotor, type AssemblyMotorJsxProps, AssemblyPart, type AssemblyPartJsxProps, AssemblyPrintedPart, type AssemblyPrintedPartJsxProps, AssemblyReferenceSurface, AssemblyScreen, type AssemblyScreenJsxProps, AssemblySubassembly, type AssemblySubassemblyJsxProps, type AsyncEffect, type AutorouterCompleteEvent, type AutorouterErrorEvent, type AutorouterEvent, type AutorouterProgressEvent, type AutoroutingCacheDisabledReason, type AutoroutingCacheStatus, type AutoroutingEndEvent, type AutoroutingErrorEvent, type AutoroutingExecutionMetadata, AutoroutingPhase, type AutoroutingProgressEvent, type AutoroutingStartEvent, Battery, Board, Breakout, BreakoutPoint, Bus, CadAssembly, CadModel, Capacitor, Chip, Circuit, type CircuitJsonMetadata, type ComponentWithPins, Connector, Constraint, CopperPour, CopperText, CourtyardCircle, CourtyardOutline, CourtyardRect, Crystal, CurrentSource, Cutout, type DebugLogOutputEvent, DifferentialPair, Diode, DrcCheck, EnclosureCutoutAperture, EnclosureFdmBox, FabricationNoteDimension, FabricationNotePath, FabricationNoteRect, FabricationNoteText, Breakout as Fanout, BreakoutPoint as FanoutPoint, Fiducial, Footprint, Fuse, type GenericConnectionsAndSelectorsSel, type GenericLocalAutorouter, Group, Hole, type IIsolatedCircuit, type IRenderable, type IRootCircuit, IbisModel, Inductor, Interconnect, IsolatedCircuit, Jumper, Keepout, Led, type LocalCacheEngine, Mosfet, MountedBoard, Net, NetLabel, NormalComponent, type Obstacle, OpAmp, type PackingEndEvent, type PackingErrorEvent, type PackingStartEvent, Panel, PcbBend, type PcbGroupId, PcbNoteDimension, PcbNoteLine, PcbNotePath, PcbNoteRect, PcbNoteText, PcbReturnCurrentExcitation, PcbReturnCurrentSimulation, PcbSoldermaskOpening, PcbStiffener, PcbTrace, PcbVia, PinHeader, type PinLabelSpec, Pinout, PlatedHole, Port, Potentiometer, PowerSource, PrimitiveComponent, Project, PushButton, type RenderPhase, type RenderPhaseFn, type RenderPhaseFunctions, type RenderPhaseStates, Renderable, Resistor, Resonator, RootCircuit, type RootCircuitEventName, SOLVERS, SchematicArc, SchematicBox, SchematicCell, SchematicCircle, SchematicGraphic, SchematicLine, SchematicPath, SchematicRect, SchematicRow, SchematicSection, SchematicSheet, SchematicSymbol, SchematicTable, SchematicText, type Sel, SilkscreenCircle, SilkscreenGraphic, SilkscreenLine, SilkscreenPath, SilkscreenRect, SilkscreenText, type SimpleRouteBounds, type SimpleRouteBus, type SimpleRouteBusTermination, type SimpleRouteConnection, type SimpleRouteDifferentialPair, type SimpleRouteJson, type SimpleRoutePoint, type SimplifiedPcbTrace, type SingleLayerConnectionPoint, SmtPad, SolderJumper, SolderPaste, type SolverEndedEvent, type SolverName, type SolverStartedEvent, SpiceModel, type SrjConnectionName, Subcircuit, Subpanel, Switch, SymbolComponent as Symbol, SystemBlockComponent, SystemBlockConnection, SystemBlockGroup, SystemBlockPage, TestPoint, Trace, TraceHint, Transistor, Via, VoltageProbe, VoltageSource, analog, applyEditEvents, applyEditEventsToManualEditsFile, applyPcbEditEventsToManualEditsFile, applySchematicEditEventsToManualEditsFile, assembly, assemblyPath, checkCircuitJsonAssemblyExplosionCollisions, createUseComponent, enclosure, getAssemblyExplosion, getCircuitJsonAssemblyExplosion, getPhaseTimingsFromRenderEvents, getSimpleRouteJsonFromCircuitJson, normalizePinLabels, orderedRenderPhases, renderPhaseIndexMap, resolveAssemblyExplosionStages, resolveStaticFileImport, sel, serializeAssemblyExplosion, simulation, systemblock, unrouteCircuitJson, useCapacitor, useChip, useDiode, useLed, useRenderedCircuit, useResistor };
+export { Ammeter, AnalogAcSweepSimulation, AnalogAnalysisSimulation, AnalogDcOperatingPointSimulation, AnalogDcSweepSimulation, AnalogDigitalStimulus, AnalogEyeDiagram, AnalogSimulation, AnalogSweepParameter, AnalogTransientSimulation, Antenna, AssemblyBolt, AssemblyCable, type AssemblyCableJsxProps, type AssemblyCadAssemblyJsxProps, AssemblyDevice, type AssemblyDeviceJsxProps, AssemblyDrawingDimension, AssemblyDrawingPage, AssemblyDrawingPartView, AssemblyDrawingTitleBlock, type AssemblyExplosionCollisionCheck, type AssemblyExplosionCollisionCheckStatus, type AssemblyExplosionLine, AssemblyExplosionMove, type AssemblyExplosionOptions, AssemblyExplosionStage, type AssemblyExplosionStageRef, type AssemblyExplosionView, AssemblyMotor, type AssemblyMotorJsxProps, AssemblyPart, type AssemblyPartJsxProps, AssemblyPrintedPart, type AssemblyPrintedPartJsxProps, AssemblyReferenceSurface, AssemblyScreen, type AssemblyScreenJsxProps, AssemblySubassembly, type AssemblySubassemblyJsxProps, type AsyncEffect, type AutorouterCompleteEvent, type AutorouterComputeCostSummary, type AutorouterErrorEvent, type AutorouterEvent, type AutorouterProgressEvent, type AutoroutingCacheDisabledReason, type AutoroutingCacheStatus, type AutoroutingEndEvent, type AutoroutingErrorEvent, type AutoroutingExecutionMetadata, AutoroutingPhase, type AutoroutingProgressEvent, type AutoroutingStartEvent, Battery, Board, Breakout, BreakoutPoint, Bus, CadAssembly, CadModel, Capacitor, Chip, Circuit, type CircuitJsonMetadata, type ComponentWithPins, Connector, Constraint, CopperPour, CopperText, CourtyardCircle, CourtyardOutline, CourtyardRect, Crystal, CurrentSource, Cutout, type DebugLogOutputEvent, DifferentialPair, Diode, DrcCheck, EnclosureCutoutAperture, EnclosureFdmBox, FabricationNoteDimension, FabricationNotePath, FabricationNoteRect, FabricationNoteText, Breakout as Fanout, BreakoutPoint as FanoutPoint, Fiducial, Footprint, Fuse, type GenericConnectionsAndSelectorsSel, type GenericLocalAutorouter, Group, Hole, type IIsolatedCircuit, type IRenderable, type IRootCircuit, IbisModel, Inductor, Interconnect, IsolatedCircuit, type Iterations, Jumper, Keepout, Led, type LocalCacheEngine, Mosfet, MountedBoard, Net, NetLabel, NormalComponent, type Obstacle, OpAmp, type PackingEndEvent, type PackingErrorEvent, type PackingStartEvent, Panel, PcbBend, type PcbGroupId, PcbNoteDimension, PcbNoteLine, PcbNotePath, PcbNoteRect, PcbNoteText, PcbReturnCurrentExcitation, PcbReturnCurrentSimulation, PcbSoldermaskOpening, PcbStiffener, PcbTrace, PcbVia, PinHeader, type PinLabelSpec, Pinout, PlatedHole, Port, Potentiometer, PowerSource, PrimitiveComponent, Project, PushButton, type RenderPhase, type RenderPhaseFn, type RenderPhaseFunctions, type RenderPhaseStates, Renderable, Resistor, Resonator, RootCircuit, type RootCircuitEventName, SOLVERS, SchematicArc, SchematicBox, SchematicCell, SchematicCircle, SchematicGraphic, SchematicLine, SchematicPath, SchematicRect, SchematicRow, SchematicSection, SchematicSheet, SchematicSymbol, SchematicTable, SchematicText, type Sel, SilkscreenCircle, SilkscreenGraphic, SilkscreenLine, SilkscreenPath, SilkscreenRect, SilkscreenText, type SimpleRouteBounds, type SimpleRouteBus, type SimpleRouteBusTermination, type SimpleRouteConnection, type SimpleRouteDifferentialPair, type SimpleRouteJson, type SimpleRoutePoint, type SimplifiedPcbTrace, type SingleLayerConnectionPoint, SmtPad, SolderJumper, SolderPaste, type SolverEndedEvent, type SolverName, type SolverStartedEvent, SpiceModel, type SrjConnectionName, Subcircuit, Subpanel, Switch, SymbolComponent as Symbol, SystemBlockComponent, SystemBlockConnection, SystemBlockGroup, SystemBlockPage, TestPoint, Trace, TraceHint, Transistor, Via, VoltageProbe, VoltageSource, analog, applyEditEvents, applyEditEventsToManualEditsFile, applyPcbEditEventsToManualEditsFile, applySchematicEditEventsToManualEditsFile, assembly, assemblyPath, checkCircuitJsonAssemblyExplosionCollisions, createUseComponent, enclosure, getAssemblyExplosion, getCircuitJsonAssemblyExplosion, getPhaseTimingsFromRenderEvents, getSimpleRouteJsonFromCircuitJson, normalizePinLabels, orderedRenderPhases, renderPhaseIndexMap, resolveAssemblyExplosionStages, resolveStaticFileImport, sel, serializeAssemblyExplosion, simulation, systemblock, unrouteCircuitJson, useCapacitor, useChip, useDiode, useLed, useRenderedCircuit, useResistor };

package/dist/index.js

@@ -148356,7 +148356,12 @@ var TscircuitAutorouter = class {
         run,
         (progress) => {
           this.cycleCount++;
-          this.emitEvent({ ...progress, steps: this.cycleCount });
+          const computeCostSummary = this.getComputeCostSummary();
+          this.emitEvent({
+            ...progress,
+            steps: this.cycleCount,
+            ...computeCostSummary !== void 0 ? { computeCostSummary } : {}
+          });
         }
       );
       if (run.stopped) return;
@@ -148422,13 +148427,15 @@ var TscircuitAutorouter = class {
       this.cycleCount++;
       const debugGraphics = this.solver?.preview() || void 0;
       const progress = this.solver.progress;
+      const computeCostSummary = this.getComputeCostSummary();
       this.emitEvent({
         type: "progress",
         steps: this.cycleCount,
         iterationsPerSecond,
         progress,
         phase: "getCurrentPhase" in this.solver ? this.solver.getCurrentPhase() : this.solver.activeSubSolver?.getSolverName() ?? this.solver.getSolverName(),
-        debugGraphics
+        debugGraphics,
+        ...computeCostSummary !== void 0 ? { computeCostSummary } : {}
       });
       if (this.stepDelay > 0) {
         this.timeoutId = setTimeout(
@@ -148518,6 +148525,9 @@ var TscircuitAutorouter = class {
     }
     return this.solver.getOutputSimplifiedPcbTraces();
   }
+  getComputeCostSummary() {
+    return this.solver.getComputeCostSummary?.();
+  }
   /**
    * Get the mapping of obstacle IDs to root connection names that were
    * connected via off-board paths (e.g., interconnects).
@@ -159602,7 +159612,7 @@ var RoutingPhasePreparationError = class extends Error {
 var package_default = {
   name: "@tscircuit/core",
   type: "module",
-  version: "0.0.2328",
+  version: "0.0.2329",
   types: "dist/index.d.ts",
   main: "dist/index.js",
   module: "dist/index.js",
@@ -162214,13 +162224,15 @@ var Group = class extends NormalComponent {
           traces: eventOutputPcbTraces
         };
         previousStageOutputSimpleRouteJson = transformedSimpleRouteJson ? outputSimpleRouteJson : void 0;
+        const computeCostSummary = cachedResult ? cachedResult.computeCostSummary : autorouter?.getComputeCostSummary?.();
         if (!cachedResult && cacheKey) {
           await cacheLocalAutoroutingPhaseResult({
             cacheEngine,
             cacheKey,
             result: {
               ...simpleRouteJson,
-              traces
+              traces,
+              ...computeCostSummary !== void 0 ? { computeCostSummary } : {}
             }
           });
         }
@@ -162237,6 +162249,7 @@ var Group = class extends NormalComponent {
         });
         this.root?.emit("autorouting:end", {
           ...savedPhasePaths,
+          ...computeCostSummary !== void 0 ? { computeCostSummary } : {},
           type: "autorouting:end",
           subcircuit_id: this.subcircuit_id,
           componentDisplayName: this.getString(),
@@ -162315,7 +162328,9 @@ var Group = class extends NormalComponent {
           error_type: "pcb_autorouting_error",
           message: error instanceof Error ? error.message : String(error)
         });
+        const computeCostSummary = autorouter?.getComputeCostSummary?.();
         this.root?.emit("autorouting:error", {
+          ...computeCostSummary !== void 0 ? { computeCostSummary } : {},
           type: "autorouting:error",
           subcircuit_id: this.subcircuit_id,
           componentDisplayName: this.getString(),

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@tscircuit/core",
   "type": "module",
-  "version": "0.0.2329",
+  "version": "0.0.2330",
   "types": "dist/index.d.ts",
   "main": "dist/index.js",
   "module": "dist/index.js",