@tscircuit/schematic-trace-solver 0.0.149 → 0.0.151

package/.agents/skills/schematic-trace-visualization/SKILL.md

@@ -48,7 +48,8 @@ const png = await getPngBufferFromGraphicsObject(graphics, {
 
 ## Existing Repo Helpers
 
-- `tests/fixtures/matcher.ts`: `expect(solver).toMatchSolverSnapshot(import.meta.path)` converts `solver.visualize()` to SVG and snapshots it.
+- `tests/fixtures/matcher.ts`: `expect(solver).toMatchSolverSnapshot(import.meta.path)` converts the solver's semantic output to Circuit JSON and renders it with `circuit-to-svg`. These snapshots hide the input rats nest by default.
+- `tests/fixtures/convertSolverOutputToCircuitJson.ts`: builds snapshot Circuit JSON with schematic components/symbols, ports, routed traces, net labels, text, and boxes.
 - `tests/fixtures/getLastStepGraphicsObject.ts`: filters a `GraphicsObject` to its highest numbered `step`.
 - `tests/fixtures/getLastStepSvg.ts`: converts only the last step to SVG.
 - `lib/testing/PipelineStageDebugRunner.ts`: runs `SchematicTracePipelineSolver` and writes per-stage PNG/SVG/graphics JSON artifacts.
@@ -56,7 +57,8 @@ const png = await getPngBufferFromGraphicsObject(graphics, {
 
 ## Minimal SVG Tests
 
-Prefer focused solver SVG snapshots over broad dumps:
+Prefer focused solver SVG snapshots over broad dumps. Solver snapshots use the
+semantic Circuit JSON renderer by default:
 
 ```ts
 const solver = new SchematicTracePipelineSolver(inputProblem as any)
@@ -64,6 +66,9 @@ solver.solve()
 expect(solver).toMatchSolverSnapshot(import.meta.path)
 ```
 
+Use `solver.visualize()` with `getSvgFromGraphicsObject` directly when a test is
+specifically about internal candidates, failed geometry, or staged debug state.
+
 For multi-step graphics where only the final stage matters:
 
 ```ts

package/README.md

@@ -48,10 +48,12 @@ decides which connections deserve one; the solver only honors the request when
 the connection actually got routed, since there is nothing to run parallel to
 otherwise.
 
-The `InlineNetLabelSolver` runs last in the pipeline and exposes
-`inlineNetLabelPlacements`. A net that receives an inline label has its anchored
-`NetLabelPlacement` removed from `getOutput().netLabelPlacements`, so a net is
-never labeled twice.
+The `InlineNetLabelSolver` exposes `inlineNetLabelPlacements`. A net that
+receives an inline label has its anchored `NetLabelPlacement` removed from
+`getOutput().netLabelPlacements`, so a net is never labeled twice.
+`NetLabelToTraceSolver` then replaces pairs of port-only fallback labels with
+real traces whenever the router finds a clear path. Its `getOutput()` is the
+pipeline's final output.
 
 ```tsx
 directConnections: [

package/dist/index.d.ts

@@ -75,6 +75,13 @@ interface TextBoxes {
 }
 interface InputChip {
     chipId: ChipId;
+    /**
+     * Exact directional/oriented schematic-symbol name when the caller has it.
+     * `center`, `width`, and `height` describe the solver obstacle and may be
+     * expanded to include reference/value or manufacturer-part-number text, so
+     * renderers should use this symbol's geometry for the component body.
+     */
+    symbolName?: string;
     center: {
         x: number;
         y: number;
@@ -87,6 +94,13 @@ interface InputChip {
 interface InputDirectConnection {
     pinIds: [PinId, PinId];
     netId?: string;
+    /**
+     * User-facing text to render for this net label. `netId` remains the stable
+     * connectivity identifier and may be an internal id. When this is omitted
+     * but a label width is provided, renderers should use a width-preserving
+     * placeholder instead of exposing `netId` as label text.
+     */
+    netLabelText?: string;
     netLabelWidth?: number;
     /**
      * Width of the conventional anchored label to use only when an inline label
@@ -109,7 +123,8 @@ interface InputDirectConnection {
     allowInlineNetLabel?: boolean;
     /**
      * Extent of the inline net label along the trace. Falls back to
-     * `netLabelWidth`, then to an estimate from the netId text.
+     * `netLabelWidth`, then to an estimate from `netLabelText` (or `netId` for
+     * backwards compatibility).
      */
     inlineNetLabelWidth?: number;
     /**
@@ -121,6 +136,13 @@ interface InputDirectConnection {
 interface InputNetConnection {
     netId: string;
     pinIds: Array<PinId>;
+    /**
+     * User-facing text to render for this net label. `netId` remains the stable
+     * connectivity identifier and may be an internal id. When this is omitted
+     * but a label width is provided, renderers should use a width-preserving
+     * placeholder instead of exposing `netId` as label text.
+     */
+    netLabelText?: string;
     netLabelWidth?: number;
     fallbackNetLabelWidth?: number;
     netLabelHeight?: number;
@@ -425,6 +447,7 @@ declare class SingleNetLabelPlacementSolver extends BaseSolver {
 type OverlappingSameNetTraceGroup = {
     globalConnNetId: string;
     netId?: string;
+    netLabelText?: string;
     overlappingTraces?: SolvedTracePath;
     portOnlyPinId?: string;
     mspConnectionPairIds?: MspConnectionPairId[];
@@ -436,6 +459,8 @@ interface NetLabelPlacement {
      * Optional user-provided net identifier (if present in the input problem).
      */
     netId?: string;
+    /** User-facing label content, separate from the connectivity identifier. */
+    netLabelText?: string;
     /**
      * MSP pair ids that the label is associated with. Port-only labels use [].
      */
@@ -1209,6 +1234,8 @@ declare const INLINE_NET_LABEL_MAX_SPAN_JOG = 0.4;
 interface InlineNetLabelPlacement {
     globalConnNetId: string;
     netId?: string;
+    /** User-facing label content, separate from the connectivity identifier. */
+    netLabelText?: string;
     mspPairId?: string;
     pinIds: PinId[];
     /**
@@ -1239,6 +1266,12 @@ interface InlineNetLabelSolverInput {
     traces: SolvedTracePath[];
     netLabelPlacements: NetLabelPlacement[];
 }
+interface InlineNetLabelOutput {
+    inputProblem: InputProblem;
+    traces: SolvedTracePath[];
+    netLabelPlacements: NetLabelPlacement[];
+    inlineNetLabelPlacements: InlineNetLabelPlacement[];
+}
 type InlineEligibleConnection = InputDirectConnection | InputNetConnection;
 /**
  * Places "inline net labels" - net names drawn alongside the trace they belong
@@ -1295,12 +1328,39 @@ declare class InlineNetLabelSolver extends BaseSolver {
     };
     visualize(): GraphicsObject;
 }
+declare const visualizeInlineNetLabelOutput: ({ inputProblem, traces, netLabelPlacements, inlineNetLabelPlacements, }: InlineNetLabelOutput) => GraphicsObject;
 /**
  * Mirrors the net label text width used by @tscircuit/core so a label that core
  * did not measure for us still reserves a sane amount of space.
  */
 declare const estimateInlineNetLabelWidth: (text: string, fontSize?: number) => number;
 
+declare class NetLabelToTraceSolver extends BaseSolver {
+    private input;
+    inputProblem: InputProblem;
+    outputTraces: SolvedTracePath[];
+    outputNetLabelPlacements: NetLabelPlacement[];
+    private chipMap;
+    private pinMap;
+    private queuedCandidates;
+    private currentCandidate;
+    activeSubSolver: SchematicTraceSingleLineSolver2 | null;
+    constructor(input: InlineNetLabelOutput);
+    getConstructorParams(): [InlineNetLabelOutput];
+    private isEligiblePortOnlyDirectConnectionLabel;
+    private buildCandidatePairs;
+    private isSupersededConnectorTrace;
+    private routeIntersectsRemainingLabels;
+    private tryAcceptCurrentRoute;
+    _step(): void;
+    getOutput(): {
+        traces: SolvedTracePath[];
+        netLabelPlacements: NetLabelPlacement[];
+        inlineNetLabelPlacements: InlineNetLabelPlacement[];
+    };
+    visualize(): GraphicsObject;
+}
+
 /**
  * Pipeline solver that runs a series of solvers to find the best schematic layout.
  * Coordinates the entire layout process from chip partitioning through final packing.
@@ -1341,13 +1401,14 @@ declare class SchematicTracePipelineSolver extends BaseSolver {
     finalTraceElbowTransitionSimplificationSolver?: TraceElbowTransitionSimplificationSolver;
     sameNetJunctionAlignmentSolver?: SameNetJunctionAlignmentSolver;
     inlineNetLabelSolver?: InlineNetLabelSolver;
+    netLabelToTraceSolver?: NetLabelToTraceSolver;
     startTimeOfPhase: Record<string, number>;
     endTimeOfPhase: Record<string, number>;
     timeSpentOnPhase: Record<string, number>;
     firstIterationOfPhase: Record<string, number>;
     inputProblem: InputProblem;
     hideRatsNet: boolean;
-    pipelineDef: (PipelineStep<typeof MspConnectionPairSolver> | PipelineStep<typeof SchematicTraceLinesSolver> | PipelineStep<typeof LongDistancePairSolver> | PipelineStep<typeof UnroutedTraceRecoverySolver> | PipelineStep<typeof TraceOverlapShiftSolver> | PipelineStep<typeof NetLabelPlacementSolver> | PipelineStep<typeof TraceLabelOverlapAvoidanceSolver> | PipelineStep<typeof TraceElbowTransitionSimplificationSolver> | PipelineStep<typeof TraceCleanupSolver> | PipelineStep<typeof Example28Solver> | PipelineStep<typeof AvailableNetOrientationSolver> | PipelineStep<typeof RailNetLabelCornerPlacementSolver> | PipelineStep<typeof TraceAnchoredNetLabelOverlapSolver> | PipelineStep<typeof NetLabelTraceCollisionSolver> | PipelineStep<typeof NetLabelNetLabelCollisionSolver> | PipelineStep<typeof SameNetJunctionAlignmentSolver> | PipelineStep<typeof InlineNetLabelSolver>)[];
+    pipelineDef: (PipelineStep<typeof MspConnectionPairSolver> | PipelineStep<typeof SchematicTraceLinesSolver> | PipelineStep<typeof LongDistancePairSolver> | PipelineStep<typeof UnroutedTraceRecoverySolver> | PipelineStep<typeof TraceOverlapShiftSolver> | PipelineStep<typeof NetLabelPlacementSolver> | PipelineStep<typeof TraceLabelOverlapAvoidanceSolver> | PipelineStep<typeof TraceElbowTransitionSimplificationSolver> | PipelineStep<typeof TraceCleanupSolver> | PipelineStep<typeof Example28Solver> | PipelineStep<typeof AvailableNetOrientationSolver> | PipelineStep<typeof RailNetLabelCornerPlacementSolver> | PipelineStep<typeof TraceAnchoredNetLabelOverlapSolver> | PipelineStep<typeof NetLabelTraceCollisionSolver> | PipelineStep<typeof NetLabelNetLabelCollisionSolver> | PipelineStep<typeof SameNetJunctionAlignmentSolver> | PipelineStep<typeof InlineNetLabelSolver> | PipelineStep<typeof NetLabelToTraceSolver>)[];
     constructor(inputProblem: InputProblem, opts?: Options);
     getConstructorParams(): ConstructorParameters<typeof SchematicTracePipelineSolver>;
     currentPipelineStepIndex: number;
@@ -1363,4 +1424,4 @@ declare class SchematicTracePipelineSolver extends BaseSolver {
     preview(): GraphicsObject;
 }
 
-export { type ChipId, DEFAULT_INLINE_NET_LABEL_HEIGHT, INLINE_NET_LABEL_MAX_SPAN_JOG, INLINE_NET_LABEL_STUB_TRACE_CLEARANCE, INLINE_NET_LABEL_TRACE_MARGIN, type InlineNetLabelPlacement, InlineNetLabelSolver, type InputChip, type InputDirectConnection, type InputNetConnection, type InputPin, type InputProblem, type NetId, type NetLabelPlacement, type PinId, SchematicTracePipelineSolver, SchematicTraceSingleLineSolver2, type SectionId, type TextBoxes, estimateInlineNetLabelWidth };
+export { type ChipId, DEFAULT_INLINE_NET_LABEL_HEIGHT, INLINE_NET_LABEL_MAX_SPAN_JOG, INLINE_NET_LABEL_STUB_TRACE_CLEARANCE, INLINE_NET_LABEL_TRACE_MARGIN, type InlineNetLabelOutput, type InlineNetLabelPlacement, InlineNetLabelSolver, type InputChip, type InputDirectConnection, type InputNetConnection, type InputPin, type InputProblem, type NetId, type NetLabelPlacement, type PinId, SchematicTracePipelineSolver, SchematicTraceSingleLineSolver2, type SectionId, type TextBoxes, estimateInlineNetLabelWidth, visualizeInlineNetLabelOutput };