@tscircuit/schematic-trace-solver 0.0.148 → 0.0.150

package/lib/solvers/NetLabelPlacementSolver/NetLabelPlacementSolver.ts

@@ -18,6 +18,7 @@ import { getNetLabelWidthForConnection } from "lib/utils/getNetLabelWidthForConn
 export type OverlappingSameNetTraceGroup = {
   globalConnNetId: string
   netId?: string
+  netLabelText?: string
   overlappingTraces?: SolvedTracePath
   portOnlyPinId?: string
   mspConnectionPairIds?: MspConnectionPairId[]
@@ -30,6 +31,8 @@ export 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 [].
    */
@@ -116,18 +119,27 @@ export class NetLabelPlacementSolver extends BaseSolver {
       }
     }
 
-    // Map pins to user-provided netIds (if any)
+    // Map pins to user-provided connectivity ids and display text (if any).
     const userNetIdByPinId: Record<string, string | undefined> = {}
+    const netLabelTextByPinId: Record<string, string | undefined> = {}
     for (const dc of this.inputProblem.directConnections) {
       if (dc.netId) {
         const [a, b] = dc.pinIds
         userNetIdByPinId[a] = dc.netId
         userNetIdByPinId[b] = dc.netId
       }
+      const netLabelText = dc.netLabelText?.trim()
+      if (netLabelText) {
+        const [a, b] = dc.pinIds
+        netLabelTextByPinId[a] = netLabelText
+        netLabelTextByPinId[b] = netLabelText
+      }
     }
     for (const nc of this.inputProblem.netConnections) {
       for (const pid of nc.pinIds) {
         userNetIdByPinId[pid] = nc.netId
+        const netLabelText = nc.netLabelText?.trim()
+        if (netLabelText) netLabelTextByPinId[pid] = netLabelText
       }
     }
 
@@ -237,6 +249,9 @@ export class NetLabelPlacementSolver extends BaseSolver {
           const group = {
             globalConnNetId,
             netId: userNetId,
+            netLabelText: [...component]
+              .map((pinId) => netLabelTextByPinId[pinId])
+              .find((text): text is string => Boolean(text)),
             overlappingTraces: rep,
             mspConnectionPairIds,
           }
@@ -249,6 +264,7 @@ export class NetLabelPlacementSolver extends BaseSolver {
             groups.push({
               globalConnNetId,
               netId: userNetId,
+              netLabelText: netLabelTextByPinId[p],
               portOnlyPinId: p,
             })
           }

package/lib/solvers/NetLabelPlacementSolver/SingleNetLabelPlacementSolver/SingleNetLabelPlacementSolver.ts

@@ -354,6 +354,7 @@ export class SingleNetLabelPlacementSolver extends BaseSolver {
                 this.overlappingSameNetTraceGroup.globalConnNetId,
               dcConnNetId: curr.dcConnNetId,
               netId: this.overlappingSameNetTraceGroup.netId,
+              netLabelText: this.overlappingSameNetTraceGroup.netLabelText,
               mspConnectionPairIds: [curr.mspPairId],
               pinIds: [curr.pins[0].pinId, curr.pins[1].pinId],
               orientation,
@@ -374,6 +375,7 @@ export class SingleNetLabelPlacementSolver extends BaseSolver {
         globalConnNetId: this.overlappingSameNetTraceGroup.globalConnNetId,
         dcConnNetId: bestCandidate.dcConnNetId,
         netId: this.overlappingSameNetTraceGroup.netId,
+        netLabelText: this.overlappingSameNetTraceGroup.netLabelText,
         mspConnectionPairIds: [bestCandidate.mspPairId],
         pinIds: bestCandidate.pinIds,
         orientation: bestCandidate.orientation,

package/lib/solvers/NetLabelPlacementSolver/SingleNetLabelPlacementSolver/solvePortOnlyPin.ts

@@ -195,6 +195,7 @@ export function solveNetLabelPlacementForPortOnlyPin(params: {
       globalConnNetId: overlappingSameNetTraceGroup.globalConnNetId,
       dcConnNetId: undefined,
       netId: overlappingSameNetTraceGroup.netId,
+      netLabelText: overlappingSameNetTraceGroup.netLabelText,
       mspConnectionPairIds: [],
       pinIds: [pinId],
       orientation,
@@ -230,6 +231,7 @@ export function solveNetLabelPlacementForPortOnlyPin(params: {
     globalConnNetId: overlappingSameNetTraceGroup.globalConnNetId,
     dcConnNetId: undefined,
     netId: overlappingSameNetTraceGroup.netId,
+    netLabelText: overlappingSameNetTraceGroup.netLabelText,
     mspConnectionPairIds: [],
     pinIds: [pinId],
     orientation: fallbackOrientation,

package/lib/types/InputProblem.ts

@@ -24,6 +24,15 @@ export interface TextBoxes {
 
 export 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 }
   width: number
   height: number
@@ -33,6 +42,14 @@ export interface InputChip {
 export 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
 
   /**
@@ -58,7 +75,8 @@ export interface InputDirectConnection {
 
   /**
    * 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
 
@@ -72,6 +90,14 @@ export interface InputDirectConnection {
 export 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

package/package.json

@@ -5,7 +5,7 @@
     "url": "https://github.com/tscircuit/schematic-trace-solver.git"
   },
   "main": "dist/index.js",
-  "version": "0.0.148",
+  "version": "0.0.150",
   "type": "module",
   "scripts": {
     "start": "cosmos",
@@ -17,10 +17,15 @@
   "devDependencies": {
     "@biomejs/biome": "^2.2.2",
     "@react-hook/resize-observer": "^2.0.2",
+    "@tscircuit/alphabet": "^0.0.26",
+    "@tscircuit/circuit-json-util": "^0.0.111",
     "@tscircuit/math-utils": "^0.0.36",
     "@types/bun": "^1.2.21",
     "bun-match-svg": "^0.0.13",
     "calculate-elbow": "^0.0.12",
+    "circuit-json": "^0.0.475",
+    "circuit-json-to-connectivity-map": "^0.0.29",
+    "circuit-to-svg": "^0.0.407",
     "connectivity-map": "^1.0.0",
     "flatbush": "^4.5.0",
     "graphics-debug": "^0.0.98",
@@ -28,6 +33,8 @@
     "react-cosmos": "^7.0.0",
     "react-cosmos-plugin-vite": "^7.0.0",
     "react-dom": "^19.1.1",
+    "schematic-symbols": "^0.0.241",
+    "stack-svgs": "^0.0.1",
     "tsup": "^8.5.0",
     "vite": "^7.1.3"
   },

package/site/examples/example51.page.tsx

@@ -0,0 +1,4 @@
+import { PipelineDebugger } from "site/components/PipelineDebugger"
+import inputProblem from "../../tests/assets/example51.json"
+
+export default () => <PipelineDebugger inputProblem={inputProblem as any} />