@tscircuit/core 0.0.1447 → 0.0.1449

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 import * as circuit_json from 'circuit-json';
 import { PcbTraceError, PcbPlacementError, PcbManualEditConflictWarning, PcbViaClearanceError, LayerRef, AnyCircuitElement, Size, PcbTrace as PcbTrace$1, PcbVia as PcbVia$1, PcbTraceRoutePoint, AnySourceComponent, PcbComponent, SchematicPort, SchematicComponent, PcbSilkscreenGraphic, RouteHintPoint, CircuitJson } from 'circuit-json';
 import * as _tscircuit_props from '@tscircuit/props';
-import { PlatformConfig, traceProps, netProps, AutorouterProp, AutoroutingPhaseProps, subcircuitGroupProps, AutorouterConfig, PcbSx, portProps, SupplierPartNumbers, CadModelProp, SchematicPortArrangement, groupProps, boardProps, subcircuitProps, subpanelProps, capacitorProps, chipProps, pinoutProps, diodeProps, fuseProps, jumperProps, interconnectProps, solderjumperProps, ledProps, powerSourceProps, voltageSourceProps, currentSourceProps, ammeterProps, resistorProps, constraintProps, drcCheckProps, autoroutingPhaseProps, fabricationNoteRectProps, fabricationNotePathProps, fabricationNoteTextProps, fabricationNoteDimensionProps, pcbNoteLineProps, pcbNoteRectProps, pcbNoteTextProps, pcbNotePathProps, pcbNoteDimensionProps, footprintProps, breakoutProps, breakoutPointProps, holeProps, pcbKeepoutProps, netLabelProps, cadmodelProps, cadassemblyProps, platedHoleProps, courtyardCircleProps, courtyardOutlineProps, courtyardRectProps, silkscreenCircleProps, silkscreenPathProps, silkscreenRectProps, silkscreenTextProps, silkscreenLineProps, silkscreenGraphicProps, smtPadProps, fiducialProps, traceHintProps, viaProps, copperPourProps, copperTextProps, cutoutProps, batteryProps, pinHeaderProps, resonatorProps, inductorProps, potentiometerProps, pushButtonProps, crystalProps, CrystalPinLabels, transistorProps, mosfetProps, opampProps, OpAmpPinLabels, switchProps, SwitchProps, testpointProps, schematicTextProps, schematicLineProps, schematicRectProps, schematicArcProps, schematicCircleProps, schematicPathProps, schematicBoxProps, schematicSectionProps, schematicSheetProps, schematicTableProps, schematicRowProps, schematicCellProps, symbolProps, analogSimulationProps, voltageProbeProps, spicemodelProps, CapacitorProps, ChipProps, DiodeProps, ResistorProps, ManualEditEvent, ManualEditsFile, ChipConnections, manual_edits_file } from '@tscircuit/props';
+import { PlatformConfig, traceProps, netProps, AutorouterProp, AutoroutingPhaseProps, subcircuitGroupProps, AutorouterConfig, PcbSx, portProps, SupplierPartNumbers, CadModelProp, SchematicPortArrangement, groupProps, boardProps, subcircuitProps, subpanelProps, capacitorProps, chipProps, pinoutProps, diodeProps, fuseProps, jumperProps, interconnectProps, solderjumperProps, ledProps, powerSourceProps, voltageSourceProps, currentSourceProps, ammeterProps, resistorProps, constraintProps, drcCheckProps, autoroutingPhaseProps, fabricationNoteRectProps, fabricationNotePathProps, fabricationNoteTextProps, fabricationNoteDimensionProps, pcbNoteLineProps, pcbNoteRectProps, pcbNoteTextProps, pcbNotePathProps, pcbNoteDimensionProps, footprintProps, breakoutProps, breakoutPointProps, holeProps, pcbKeepoutProps, netLabelProps, cadmodelProps, cadassemblyProps, platedHoleProps, courtyardCircleProps, courtyardOutlineProps, courtyardRectProps, silkscreenCircleProps, silkscreenPathProps, silkscreenRectProps, silkscreenTextProps, silkscreenLineProps, silkscreenGraphicProps, smtPadProps, fiducialProps, differentialPairProps, traceHintProps, viaProps, copperPourProps, copperTextProps, cutoutProps, batteryProps, pinHeaderProps, resonatorProps, inductorProps, potentiometerProps, pushButtonProps, crystalProps, CrystalPinLabels, transistorProps, mosfetProps, opampProps, OpAmpPinLabels, switchProps, SwitchProps, testpointProps, schematicTextProps, schematicLineProps, schematicRectProps, schematicArcProps, schematicCircleProps, schematicPathProps, schematicBoxProps, schematicSectionProps, schematicSheetProps, schematicTableProps, schematicRowProps, schematicCellProps, symbolProps, analogSimulationProps, voltageProbeProps, spicemodelProps, CapacitorProps, ChipProps, DiodeProps, ResistorProps, ManualEditEvent, ManualEditsFile, ChipConnections, manual_edits_file } from '@tscircuit/props';
 export { kicadFootprintStrings } from '@tscircuit/props';
 import * as react from 'react';
 import react__default, { ReactElement } from 'react';
@@ -99,8 +99,10 @@ type Obstacle = {
     netIsAssignable?: boolean;
     offBoardConnectsTo?: string[];
 };
+/** A connection identifier in Simple Route JSON. */
+type SrjConnectionName = string;
 type SimpleRouteConnection = {
-    name: string;
+    name: SrjConnectionName;
     source_trace_id?: string;
     rootConnectionName?: string;
     mergedConnectionNames?: string[];
@@ -124,7 +126,12 @@ type SimpleRouteConnection = {
     /** @deprecated DO NOT USE **/
     externallyConnectedPointIds?: string[][];
 };
-type SimpleRouteJson = Omit<SimpleRouteJson$1, "connections" | "traces" | "obstacles" | "bounds" | "outline" | "allowJumpers" | "availableJumperTypes"> & {
+/** Length-matching constraints for two connections in Simple Route JSON. */
+type SimpleRouteDifferentialPair = {
+    connectionNames: [SrjConnectionName, SrjConnectionName];
+    lengthTolerance: number;
+};
+type SimpleRouteJson = Omit<SimpleRouteJson$1, "connections" | "traces" | "obstacles" | "bounds" | "outline" | "allowJumpers" | "availableJumperTypes" | "differentialPairs"> & {
     layerCount: number;
     minTraceWidth: number;
     nominalTraceWidth?: number;
@@ -167,6 +174,7 @@ type SimpleRouteJson = Omit<SimpleRouteJson$1, "connections" | "traces" | "obsta
     }>;
     allowJumpers?: boolean;
     availableJumperTypes?: Array<"1206x4" | "0603">;
+    differentialPairs?: SimpleRouteDifferentialPair[];
 };
 
 type RootCircuitEventName = "asyncEffect:start" | "asyncEffect:end" | "renderable:renderLifecycle:anyEvent" | `renderable:renderLifecycle:${RenderPhase}:start` | `renderable:renderLifecycle:${RenderPhase}:end` | `board:renderPhaseStarted` | "external:evalError" | "autorouting:start" | "autorouting:end" | "autorouting:error" | "autorouting:progress" | "packing:start" | "packing:end" | "packing:error" | "solver:started" | "renderComplete" | "debug:logOutput";
@@ -88198,6 +88206,13 @@ declare class Fiducial extends PrimitiveComponent<typeof fiducialProps> {
     }): void;
 }
 
+/**
+ * Declares the routing constraints for a positive and negative trace pair.
+ */
+declare class DifferentialPair extends PrimitiveComponent<typeof differentialPairProps> {
+    get config(): BaseComponentConfig;
+}
+
 declare const pcbTraceProps: z.ZodObject<{
     route: z.ZodArray<z.ZodUnion<[z.ZodObject<{
         route_type: z.ZodLiteral<"wire">;
@@ -158928,9 +158943,7 @@ declare const getSimpleRouteJsonFromCircuitJson: ({ db, circuitJson, subcircuit_
     minBoardEdgeClearance?: number;
     minViaHoleDiameter?: number;
     minViaPadDiameter?: number;
-    subcircuitComponent?: {
-        selectAll(selector: string): unknown[];
-    };
+    subcircuitComponent?: Pick<ISubcircuit, "selectAll">;
     /**
      * Excludes existing root-level PCB route state from a fresh routing problem.
      * Routed child-subcircuit traces and vias remain fixed routing geometry.
@@ -159138,6 +159151,7 @@ interface TscircuitElements {
     cadassembly: _tscircuit_props.CadAssemblyProps;
     net: _tscircuit_props.NetProps;
     trace: _tscircuit_props.TraceProps;
+    differentialpair: _tscircuit_props.DifferentialPairProps;
     breakout: _tscircuit_props.BreakoutProps;
     breakoutpoint: _tscircuit_props.BreakoutPointProps;
     fanout: _tscircuit_props.BreakoutProps;
@@ -159210,4 +159224,4 @@ declare module "react/jsx-runtime" {
     }
 }
 
-export { Ammeter, AnalogSimulation, type AsyncEffect, type AutorouterCompleteEvent, type AutorouterErrorEvent, type AutorouterEvent, type AutorouterProgressEvent, type AutoroutingEndEvent, type AutoroutingErrorEvent, AutoroutingPhase, type AutoroutingProgressEvent, type AutoroutingStartEvent, Battery, Board, Breakout, BreakoutPoint, CadAssembly, CadModel, Capacitor, Chip, Circuit, type ComponentWithPins, Connector, Constraint, CopperPour, CopperText, CourtyardCircle, CourtyardOutline, CourtyardRect, Crystal, CurrentSource, Cutout, type DebugLogOutputEvent, Diode, DrcCheck, 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, Inductor, Interconnect, IsolatedCircuit, Jumper, Keepout, Led, type LocalCacheEngine, Mosfet, MountedBoard, Net, NetLabel, NormalComponent, type Obstacle, OpAmp, type PackingEndEvent, type PackingErrorEvent, type PackingStartEvent, Panel, PcbNoteDimension, PcbNoteLine, PcbNotePath, PcbNoteRect, PcbNoteText, 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, SchematicLine, SchematicPath, SchematicRect, SchematicRow, SchematicSection, SchematicSheet, SchematicTable, SchematicText, type Sel, SilkscreenCircle, SilkscreenGraphic, SilkscreenLine, SilkscreenPath, SilkscreenRect, SilkscreenText, type SimpleRouteConnection, type SimpleRouteJson, type SimplifiedPcbTrace, SmtPad, SolderJumper, type SolverName, type SolverStartedEvent, SpiceModel, Subcircuit, Subpanel, Switch, SymbolComponent as Symbol, TestPoint, Trace, TraceHint, Transistor, Via, VoltageProbe, VoltageSource, applyEditEvents, applyEditEventsToManualEditsFile, applyPcbEditEventsToManualEditsFile, applySchematicEditEventsToManualEditsFile, createUseComponent, getPhaseTimingsFromRenderEvents, getSimpleRouteJsonFromCircuitJson, normalizePinLabels, orderedRenderPhases, renderPhaseIndexMap, resolveStaticFileImport, sel, unrouteCircuitJson, useCapacitor, useChip, useDiode, useLed, useRenderedCircuit, useResistor };
+export { Ammeter, AnalogSimulation, type AsyncEffect, type AutorouterCompleteEvent, type AutorouterErrorEvent, type AutorouterEvent, type AutorouterProgressEvent, type AutoroutingEndEvent, type AutoroutingErrorEvent, AutoroutingPhase, type AutoroutingProgressEvent, type AutoroutingStartEvent, Battery, Board, Breakout, BreakoutPoint, CadAssembly, CadModel, Capacitor, Chip, Circuit, type ComponentWithPins, Connector, Constraint, CopperPour, CopperText, CourtyardCircle, CourtyardOutline, CourtyardRect, Crystal, CurrentSource, Cutout, type DebugLogOutputEvent, DifferentialPair, Diode, DrcCheck, 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, Inductor, Interconnect, IsolatedCircuit, Jumper, Keepout, Led, type LocalCacheEngine, Mosfet, MountedBoard, Net, NetLabel, NormalComponent, type Obstacle, OpAmp, type PackingEndEvent, type PackingErrorEvent, type PackingStartEvent, Panel, PcbNoteDimension, PcbNoteLine, PcbNotePath, PcbNoteRect, PcbNoteText, 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, SchematicLine, SchematicPath, SchematicRect, SchematicRow, SchematicSection, SchematicSheet, SchematicTable, SchematicText, type Sel, SilkscreenCircle, SilkscreenGraphic, SilkscreenLine, SilkscreenPath, SilkscreenRect, SilkscreenText, type SimpleRouteConnection, type SimpleRouteDifferentialPair, type SimpleRouteJson, type SimplifiedPcbTrace, SmtPad, SolderJumper, type SolverName, type SolverStartedEvent, SpiceModel, type SrjConnectionName, Subcircuit, Subpanel, Switch, SymbolComponent as Symbol, TestPoint, Trace, TraceHint, Transistor, Via, VoltageProbe, VoltageSource, applyEditEvents, applyEditEventsToManualEditsFile, applyPcbEditEventsToManualEditsFile, applySchematicEditEventsToManualEditsFile, createUseComponent, getPhaseTimingsFromRenderEvents, getSimpleRouteJsonFromCircuitJson, normalizePinLabels, orderedRenderPhases, renderPhaseIndexMap, resolveStaticFileImport, sel, unrouteCircuitJson, useCapacitor, useChip, useDiode, useLed, useRenderedCircuit, useResistor };

package/dist/index.js

@@ -28,6 +28,7 @@ __export(components_exports, {
   Crystal: () => Crystal,
   CurrentSource: () => CurrentSource,
   Cutout: () => Cutout,
+  DifferentialPair: () => DifferentialPair,
   Diode: () => Diode,
   DrcCheck: () => DrcCheck,
   FabricationNoteDimension: () => FabricationNoteDimension,
@@ -16258,6 +16259,153 @@ import {
   getFullConnectivityMapFromCircuitJson as getFullConnectivityMapFromCircuitJson3
 } from "circuit-json-to-connectivity-map";
 
+// lib/components/primitive-components/DifferentialPair.ts
+import { differentialPairProps } from "@tscircuit/props";
+var DifferentialPair = class extends PrimitiveComponent2 {
+  get config() {
+    return {
+      componentName: "DifferentialPair",
+      zodProps: differentialPairProps
+    };
+  }
+};
+
+// lib/utils/autorouting/getDifferentialPairsForSimpleRouteJson.ts
+var getDifferentialPairSourceTracesByTraceName = (differentialPairSourceTraces, traceName) => differentialPairSourceTraces.filter(
+  (sourceTrace) => sourceTrace.name === traceName
+);
+var getDifferentialPairSourceTracesByPortId = (differentialPairSourceTraces, sourcePortId) => differentialPairSourceTraces.filter(
+  (sourceTrace) => sourceTrace.connected_source_port_ids.includes(sourcePortId)
+);
+var getDifferentialPairTraceSubcircuitConnectivityMapKeyOrThrow = ({
+  differentialPair,
+  differentialPairSourceTraces,
+  traceNameOrPortSelector
+}) => {
+  const differentialPairSubcircuit = differentialPair.getSubcircuit();
+  const sourceTracesWithMatchingName = getDifferentialPairSourceTracesByTraceName(
+    differentialPairSourceTraces,
+    traceNameOrPortSelector
+  );
+  const selectedPort = sourceTracesWithMatchingName.length === 0 ? differentialPairSubcircuit.selectOne(traceNameOrPortSelector, {
+    type: "port"
+  }) : null;
+  const selectedSourcePortId = selectedPort?.source_port_id ?? void 0;
+  const matchingSourceTraces = selectedSourcePortId ? getDifferentialPairSourceTracesByPortId(
+    differentialPairSourceTraces,
+    selectedSourcePortId
+  ) : sourceTracesWithMatchingName;
+  if (matchingSourceTraces.length === 0) {
+    throw new Error(
+      `Could not find source trace for trace name or port selector "${traceNameOrPortSelector}" in differential pair "${differentialPair.name}"`
+    );
+  }
+  if (matchingSourceTraces.length > 1) {
+    throw new Error(
+      `Trace name or port selector "${traceNameOrPortSelector}" matches multiple source traces for differential pair "${differentialPair.name}"`
+    );
+  }
+  const sourceTrace = matchingSourceTraces[0];
+  if (!sourceTrace) {
+    throw new Error(
+      `Expected one source trace for trace name or port selector "${traceNameOrPortSelector}" in differential pair "${differentialPair.name}"`
+    );
+  }
+  const subcircuitConnectivityMapKey = sourceTrace.subcircuit_connectivity_map_key;
+  if (!subcircuitConnectivityMapKey) {
+    throw new Error(
+      `Source trace "${sourceTrace.source_trace_id}" does not have a subcircuit connectivity map key for differential pair "${differentialPair.name}"`
+    );
+  }
+  return subcircuitConnectivityMapKey;
+};
+var getDifferentialPairSrjConnectionNameOrThrow = ({
+  srjConnections,
+  differentialPairName,
+  differentialPairSourceTraces,
+  traceSubcircuitConnectivityMapKey,
+  traceNameOrPortSelector
+}) => {
+  const differentialPairSourceTraceIds = [];
+  for (const sourceTrace of differentialPairSourceTraces) {
+    if (sourceTrace.subcircuit_connectivity_map_key === traceSubcircuitConnectivityMapKey) {
+      differentialPairSourceTraceIds.push(sourceTrace.source_trace_id);
+    }
+  }
+  const matchingSrjConnections = [];
+  for (const srjConnection2 of srjConnections) {
+    if (srjConnection2.source_trace_id && differentialPairSourceTraceIds.includes(srjConnection2.source_trace_id)) {
+      matchingSrjConnections.push(srjConnection2);
+    }
+  }
+  if (matchingSrjConnections.length === 0) {
+    throw new Error(
+      `Could not find an SRJ connection for trace name or port selector "${traceNameOrPortSelector}" in differential pair "${differentialPairName}"`
+    );
+  }
+  if (matchingSrjConnections.length > 1) {
+    throw new Error(
+      `Subcircuit connectivity map key "${traceSubcircuitConnectivityMapKey}" matches multiple SRJ connections for differential pair "${differentialPairName}"`
+    );
+  }
+  const srjConnection = matchingSrjConnections[0];
+  if (!srjConnection) {
+    throw new Error(
+      `Expected one SRJ connection for subcircuit connectivity map key "${traceSubcircuitConnectivityMapKey}"`
+    );
+  }
+  return srjConnection.name;
+};
+var getDifferentialPairsForSimpleRouteJson = ({
+  srjConnections,
+  differentialPairs,
+  sourceTraces,
+  subcircuitId
+}) => {
+  const srjDifferentialPairs = [];
+  for (const differentialPair of differentialPairs) {
+    const differentialPairSubcircuitId = differentialPair.getSubcircuit().subcircuit_id;
+    if (subcircuitId && differentialPairSubcircuitId !== subcircuitId) {
+      continue;
+    }
+    const differentialPairSourceTraces = sourceTraces.filter(
+      (sourceTrace) => sourceTrace.subcircuit_id === differentialPairSubcircuitId
+    );
+    const positiveTraceNameOrPortSelector = differentialPair._parsedProps.positiveConnection;
+    const negativeTraceNameOrPortSelector = differentialPair._parsedProps.negativeConnection;
+    const positiveSubcircuitConnectivityMapKey = getDifferentialPairTraceSubcircuitConnectivityMapKeyOrThrow({
+      differentialPair,
+      differentialPairSourceTraces,
+      traceNameOrPortSelector: positiveTraceNameOrPortSelector
+    });
+    const negativeSubcircuitConnectivityMapKey = getDifferentialPairTraceSubcircuitConnectivityMapKeyOrThrow({
+      differentialPair,
+      differentialPairSourceTraces,
+      traceNameOrPortSelector: negativeTraceNameOrPortSelector
+    });
+    const positiveSrjConnectionName = getDifferentialPairSrjConnectionNameOrThrow({
+      srjConnections,
+      differentialPairName: differentialPair.name,
+      differentialPairSourceTraces,
+      traceSubcircuitConnectivityMapKey: positiveSubcircuitConnectivityMapKey,
+      traceNameOrPortSelector: positiveTraceNameOrPortSelector
+    });
+    const negativeSrjConnectionName = getDifferentialPairSrjConnectionNameOrThrow({
+      srjConnections,
+      differentialPairName: differentialPair.name,
+      differentialPairSourceTraces,
+      traceSubcircuitConnectivityMapKey: negativeSubcircuitConnectivityMapKey,
+      traceNameOrPortSelector: negativeTraceNameOrPortSelector
+    });
+    const lengthTolerance = differentialPair._parsedProps.maxLengthSkew ?? 0.1;
+    srjDifferentialPairs.push({
+      connectionNames: [positiveSrjConnectionName, negativeSrjConnectionName],
+      lengthTolerance
+    });
+  }
+  return srjDifferentialPairs.length > 0 ? srjDifferentialPairs : void 0;
+};
+
 // lib/utils/autorouting/getPreservedRoutedSubcircuitTraces.ts
 var getPreservedTraceConnectionName = (trace) => trace.source_trace_id ?? trace.connection_name ?? trace.pcb_trace_id;
 var getConnectedToIdsForPreservedTrace = ({
@@ -16833,6 +16981,13 @@ var getSimpleRouteJsonFromCircuitJson = ({
     conn.nominalTraceWidth ??= defaultTraceWidth;
     conn.width ??= defaultTraceWidth;
   }
+  const differentialPairs = subcircuitComponent?.selectAll("differentialpair") ?? [];
+  const srjDifferentialPairs = getDifferentialPairsForSimpleRouteJson({
+    srjConnections: allConns,
+    differentialPairs,
+    sourceTraces: db.source_trace.list(),
+    subcircuitId: subcircuit_id
+  });
   if (subcircuit_id) {
     const pointIdToConn = /* @__PURE__ */ new Map();
     for (const conn of allConns) {
@@ -16874,6 +17029,7 @@ var getSimpleRouteJsonFromCircuitJson = ({
       bounds,
       obstacles,
       connections: allConns,
+      differentialPairs: srjDifferentialPairs,
       traces: preservedRoutedSubcircuitTraces.length > 0 ? preservedRoutedSubcircuitTraces : void 0,
       layerCount: board?.num_layers ?? 2,
       minTraceWidth: Math.min(
@@ -22654,7 +22810,7 @@ function Group_getRoutingPhasePlans(group) {
 var package_default = {
   name: "@tscircuit/core",
   type: "module",
-  version: "0.0.1446",
+  version: "0.0.1448",
   types: "dist/index.d.ts",
   main: "dist/index.js",
   module: "dist/index.js",
@@ -22958,9 +23114,29 @@ function Group_filterSimpleRouteJsonForPhase(simpleRouteJson, phasePlan) {
       connections.push(connection);
     }
   }
+  const includedConnectionNames = /* @__PURE__ */ new Set();
+  for (const connection of connections) {
+    includedConnectionNames.add(connection.name);
+  }
+  const differentialPairs = [];
+  for (const differentialPair of simpleRouteJson.differentialPairs ?? []) {
+    const positiveConnectionIncluded = includedConnectionNames.has(
+      differentialPair.connectionNames[0]
+    );
+    const negativeConnectionIncluded = includedConnectionNames.has(
+      differentialPair.connectionNames[1]
+    );
+    if (positiveConnectionIncluded !== negativeConnectionIncluded) {
+      throw new Error(
+        `Differential pair "${differentialPair.connectionNames.join("/")}" cannot be split across autorouting phases`
+      );
+    }
+    if (positiveConnectionIncluded) differentialPairs.push(differentialPair);
+  }
   return {
     ...simpleRouteJson,
-    connections
+    connections,
+    differentialPairs: differentialPairs.length > 0 ? differentialPairs : void 0
   };
 }
 function hasDrcTolerances(drcTolerances) {
@@ -25565,6 +25741,150 @@ function inflateSourceResistor(sourceElm, inflatorContext) {
   }
 }
 
+// lib/components/normal-components/Switch.ts
+import { switchProps } from "@tscircuit/props";
+import { frequency, ms } from "circuit-json";
+function hasSimProps(props) {
+  return props.simSwitchFrequency !== void 0 || props.simCloseAt !== void 0 || props.simOpenAt !== void 0 || props.simStartClosed !== void 0 || props.simStartOpen !== void 0;
+}
+var Switch = class extends NormalComponent3 {
+  _getSwitchType() {
+    const props = this._parsedProps;
+    if (!props) return "spst";
+    if (props.dpdt) return "dpdt";
+    if (props.spst) return "spst";
+    if (props.spdt) return "spdt";
+    if (props.dpst) return "dpst";
+    return props.type ?? "spst";
+  }
+  get config() {
+    const switchType = this._getSwitchType();
+    const isNormallyClosed = this._parsedProps?.isNormallyClosed ?? false;
+    const symbolMap = {
+      spst: isNormallyClosed ? "spst_normally_closed_switch" : "spst_switch",
+      spdt: isNormallyClosed ? "spdt_normally_closed_switch" : "spdt_switch",
+      dpst: isNormallyClosed ? "dpst_normally_closed_switch" : "dpst_switch",
+      dpdt: isNormallyClosed ? "dpdt_normally_closed_switch" : "dpdt_switch"
+    };
+    return {
+      componentName: "Switch",
+      schematicSymbolName: this.props.symbolName ?? symbolMap[switchType],
+      zodProps: switchProps,
+      shouldRenderAsSchematicBox: false
+    };
+  }
+  doInitialSourceRender() {
+    const { db } = this.root;
+    const props = this._parsedProps ?? {};
+    const source_component = db.source_component.insert({
+      ftype: "simple_switch",
+      name: this.name,
+      are_pins_interchangeable: this._getSwitchType() === "spst",
+      display_name: props?.displayName
+    });
+    this.source_component_id = source_component.source_component_id;
+  }
+  doInitialSimulationRender() {
+    const { _parsedProps: props } = this;
+    if (!hasSimProps(props)) {
+      return;
+    }
+    const { db } = this.root;
+    const simulationSwitch = {
+      type: "simulation_switch",
+      source_component_id: this.source_component_id || ""
+    };
+    if (props.simSwitchFrequency !== void 0) {
+      simulationSwitch.switching_frequency = frequency.parse(
+        props.simSwitchFrequency
+      );
+    }
+    if (props.simCloseAt !== void 0) {
+      simulationSwitch.closes_at = ms.parse(props.simCloseAt);
+    }
+    if (props.simOpenAt !== void 0) {
+      simulationSwitch.opens_at = ms.parse(props.simOpenAt);
+    }
+    if (props.simStartOpen !== void 0) {
+      simulationSwitch.starts_closed = !props.simStartOpen;
+    }
+    if (props.simStartClosed !== void 0) {
+      simulationSwitch.starts_closed = props.simStartClosed;
+    }
+    db.simulation_switch.insert(simulationSwitch);
+  }
+};
+
+// lib/components/primitive-components/Group/Subcircuit/inflators/inflateSourceSwitch.ts
+var getImportedSwitchProps = (sourceElm, inflatorContext) => {
+  const sourcePorts = inflatorContext.injectionDb.source_port.list().filter(
+    (port) => port.source_component_id === sourceElm.source_component_id
+  );
+  const pinLabels = {};
+  let highestPinNumber = 0;
+  for (const sourcePort of sourcePorts) {
+    const pinNumber = sourcePort.pin_number;
+    if (pinNumber === void 0 || pinNumber === null) continue;
+    highestPinNumber = Math.max(highestPinNumber, pinNumber);
+    const labels = Array.from(
+      new Set(
+        [sourcePort.name, ...sourcePort.port_hints ?? []].filter(
+          (label) => typeof label === "string" && label.length > 0
+        )
+      )
+    );
+    if (labels.length > 0) {
+      pinLabels[`pin${pinNumber}`] = labels;
+    }
+  }
+  let type = "spst";
+  if (highestPinNumber >= 5) type = "dpdt";
+  else if (highestPinNumber === 4) type = "dpst";
+  else if (highestPinNumber === 3) type = "spdt";
+  return {
+    type,
+    pinLabels: Object.keys(pinLabels).length > 0 ? pinLabels : void 0
+  };
+};
+function inflateSourceSwitch(sourceElm, inflatorContext) {
+  const { injectionDb, subcircuit, groupsMap } = inflatorContext;
+  const pcbElm = injectionDb.pcb_component.getWhere({
+    source_component_id: sourceElm.source_component_id
+  });
+  const { pcbX, pcbY } = getInflatedPcbPlacement({
+    pcbComponent: pcbElm,
+    sourceGroupId: sourceElm.source_group_id,
+    inflatorContext
+  });
+  const importedSwitchProps = getImportedSwitchProps(sourceElm, inflatorContext);
+  const switchComponent = new Switch({
+    name: sourceElm.name,
+    displayName: sourceElm.display_name,
+    ...importedSwitchProps,
+    layer: pcbElm?.layer,
+    pcbX,
+    pcbY,
+    pcbRotation: pcbElm?.rotation,
+    doNotPlace: pcbElm?.do_not_place,
+    obstructsWithinBounds: pcbElm?.obstructs_within_bounds
+  });
+  if (pcbElm) {
+    const footprint = inflateFootprintComponent(pcbElm, {
+      ...inflatorContext,
+      normalComponent: switchComponent
+    });
+    if (footprint) {
+      switchComponent.add(footprint);
+    }
+  }
+  if (sourceElm.source_group_id && groupsMap?.has(sourceElm.source_group_id)) {
+    const group = groupsMap.get(sourceElm.source_group_id);
+    group.add(switchComponent);
+  } else {
+    subcircuit.add(switchComponent);
+  }
+}
+
 // lib/utils/pcbTraceRouteToPcbPath.ts
 function pcbTraceRouteToPcbPath(route) {
   if (route.length <= 2) {
@@ -25877,6 +26197,9 @@ var inflateCircuitJson = (target, circuitJson, children) => {
       case "simple_push_button":
         inflateSourcePushButton(sourceComponent, inflationCtx);
         break;
+      case "simple_switch":
+        inflateSourceSwitch(sourceComponent, inflationCtx);
+        break;
       default:
         throw new Error(
           `No inflator implemented for source component ftype: "${sourceComponent.ftype}"`
@@ -32210,80 +32533,6 @@ var OpAmp = class extends NormalComponent3 {
   negative_supply = this.portMap.negative_supply;
 };
 
-// lib/components/normal-components/Switch.ts
-import { switchProps } from "@tscircuit/props";
-import { frequency, ms } from "circuit-json";
-function hasSimProps(props) {
-  return props.simSwitchFrequency !== void 0 || props.simCloseAt !== void 0 || props.simOpenAt !== void 0 || props.simStartClosed !== void 0 || props.simStartOpen !== void 0;
-}
-var Switch = class extends NormalComponent3 {
-  _getSwitchType() {
-    const props = this._parsedProps;
-    if (!props) return "spst";
-    if (props.dpdt) return "dpdt";
-    if (props.spst) return "spst";
-    if (props.spdt) return "spdt";
-    if (props.dpst) return "dpst";
-    return props.type ?? "spst";
-  }
-  get config() {
-    const switchType = this._getSwitchType();
-    const isNormallyClosed = this._parsedProps?.isNormallyClosed ?? false;
-    const symbolMap = {
-      spst: isNormallyClosed ? "spst_normally_closed_switch" : "spst_switch",
-      spdt: isNormallyClosed ? "spdt_normally_closed_switch" : "spdt_switch",
-      dpst: isNormallyClosed ? "dpst_normally_closed_switch" : "dpst_switch",
-      dpdt: isNormallyClosed ? "dpdt_normally_closed_switch" : "dpdt_switch"
-    };
-    return {
-      componentName: "Switch",
-      schematicSymbolName: this.props.symbolName ?? symbolMap[switchType],
-      zodProps: switchProps,
-      shouldRenderAsSchematicBox: false
-    };
-  }
-  doInitialSourceRender() {
-    const { db } = this.root;
-    const props = this._parsedProps ?? {};
-    const source_component = db.source_component.insert({
-      ftype: "simple_switch",
-      name: this.name,
-      are_pins_interchangeable: this._getSwitchType() === "spst",
-      display_name: props?.displayName
-    });
-    this.source_component_id = source_component.source_component_id;
-  }
-  doInitialSimulationRender() {
-    const { _parsedProps: props } = this;
-    if (!hasSimProps(props)) {
-      return;
-    }
-    const { db } = this.root;
-    const simulationSwitch = {
-      type: "simulation_switch",
-      source_component_id: this.source_component_id || ""
-    };
-    if (props.simSwitchFrequency !== void 0) {
-      simulationSwitch.switching_frequency = frequency.parse(
-        props.simSwitchFrequency
-      );
-    }
-    if (props.simCloseAt !== void 0) {
-      simulationSwitch.closes_at = ms.parse(props.simCloseAt);
-    }
-    if (props.simOpenAt !== void 0) {
-      simulationSwitch.opens_at = ms.parse(props.simOpenAt);
-    }
-    if (props.simStartOpen !== void 0) {
-      simulationSwitch.starts_closed = !props.simStartOpen;
-    }
-    if (props.simStartClosed !== void 0) {
-      simulationSwitch.starts_closed = props.simStartClosed;
-    }
-    db.simulation_switch.insert(simulationSwitch);
-  }
-};
-
 // lib/components/normal-components/TestPoint.ts
 import { testpointProps } from "@tscircuit/props";
 var TESTPOINT_DEFAULTS = {
@@ -33579,6 +33828,7 @@ export {
   Crystal,
   CurrentSource,
   Cutout,
+  DifferentialPair,
   Diode,
   DrcCheck,
   FabricationNoteDimension,

package/package.json

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