@tscircuit/core 0.0.1156 → 0.0.1158

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 import * as circuit_json from 'circuit-json';
-import { PcbTraceError, PcbPlacementError, PcbManualEditConflictWarning, PcbViaClearanceError, LayerRef, AnyCircuitElement, Size, AnySourceComponent, PcbTraceRoutePoint, PcbTrace as PcbTrace$1, PcbVia, SchematicPort, SchematicComponent, RouteHintPoint, CircuitJson } from 'circuit-json';
+import { PcbTraceError, PcbPlacementError, PcbManualEditConflictWarning, PcbViaClearanceError, LayerRef, AnyCircuitElement, Size, PcbTraceRoutePoint, AnySourceComponent, PcbTrace as PcbTrace$1, PcbVia, SchematicPort, SchematicComponent, RouteHintPoint, CircuitJson } from 'circuit-json';
 import * as _tscircuit_props from '@tscircuit/props';
-import { PlatformConfig, subcircuitGroupProps, AutorouterConfig, PcbSx, traceProps, SupplierPartNumbers, CadModelProp, SchematicPortArrangement, groupProps, boardProps, subcircuitProps, subpanelProps, capacitorProps, chipProps, pinoutProps, diodeProps, fuseProps, jumperProps, interconnectProps, solderjumperProps, ledProps, powerSourceProps, voltageSourceProps, currentSourceProps, resistorProps, constraintProps, 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, smtPadProps, fiducialProps, traceHintProps, viaProps, copperPourProps, copperTextProps, cutoutProps, batteryProps, pinHeaderProps, resonatorProps, inductorProps, potentiometerProps, pushButtonProps, crystalProps, transistorProps, mosfetProps, opampProps, OpAmpPinLabels, switchProps, SwitchProps, testpointProps, schematicTextProps, schematicLineProps, schematicRectProps, schematicArcProps, schematicCircleProps, schematicPathProps, schematicBoxProps, schematicTableProps, schematicRowProps, schematicCellProps, symbolProps, analogSimulationProps, voltageProbeProps, CapacitorProps, ChipProps, DiodeProps, ResistorProps, ManualEditEvent, ManualEditsFile, ChipConnections, manual_edits_file } from '@tscircuit/props';
+import { PlatformConfig, traceProps, subcircuitGroupProps, AutorouterConfig, PcbSx, SupplierPartNumbers, CadModelProp, SchematicPortArrangement, groupProps, boardProps, subcircuitProps, subpanelProps, capacitorProps, chipProps, pinoutProps, diodeProps, fuseProps, jumperProps, interconnectProps, solderjumperProps, ledProps, powerSourceProps, voltageSourceProps, currentSourceProps, resistorProps, constraintProps, 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, smtPadProps, fiducialProps, traceHintProps, viaProps, copperPourProps, copperTextProps, cutoutProps, batteryProps, pinHeaderProps, resonatorProps, inductorProps, potentiometerProps, pushButtonProps, crystalProps, transistorProps, mosfetProps, opampProps, OpAmpPinLabels, switchProps, SwitchProps, testpointProps, schematicTextProps, schematicLineProps, schematicRectProps, schematicArcProps, schematicCircleProps, schematicPathProps, schematicBoxProps, schematicTableProps, schematicRowProps, schematicCellProps, symbolProps, analogSimulationProps, voltageProbeProps, 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, DetailedHTMLProps, SVGProps } from 'react';
@@ -397,402 +397,73 @@ interface IGroup extends PrimitiveComponent {
     }): void;
 }
 
-interface ISubcircuit extends PrimitiveComponent {
-    _shouldUseTraceByTraceRouting(): boolean;
-    _parsedProps: z.infer<typeof subcircuitGroupProps>;
-    _getAutorouterConfig(): AutorouterConfig;
-    _isAutoJumperAutorouter(autorouterConfig?: AutorouterConfig): boolean;
-    getNextAvailableName(elm: PrimitiveComponent): string;
-    _getSubcircuitLayerCount(): number;
-    subcircuit_id: string | null;
-    getNormalComponentNameMap?: () => Map<string, NormalComponent[]>;
-    _isInflatedFromCircuitJson: boolean;
-    _isIsolatedSubcircuit: boolean;
-    _isolatedCircuitJson: AnyCircuitElement[] | null;
-    _normalComponentNameMap: Map<string, NormalComponent[]> | null;
-    getSubcircuitPropHash?(): string;
-}
-
-interface SchematicSymbolBounds {
-    minX: number;
-    maxX: number;
-    minY: number;
-    maxY: number;
-}
-interface ISymbol {
-    /**
-     * The circuit-json schematic_symbol_id for this symbol.
-     * Created during SchematicPrimitiveRender phase.
-     */
-    schematic_symbol_id?: string;
-    /**
-     * The transformation matrix to convert from user coordinates (as specified
-     * in the symbol's children) to the final resized symbol coordinates.
-     * This is computed lazily when first requested.
-     */
-    userCoordinateToResizedSymbolTransformMat?: Matrix;
-    /**
-     * The computed bounds of the symbol's schematic primitives before any
-     * resizing is applied.
-     */
-    schematicSymbolBoundsInUserCoordinates?: SchematicSymbolBounds;
+declare const netProps: z.ZodObject<{
+    name: z.ZodEffects<z.ZodString, string, string>;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+}, {
+    name: string;
+}>;
+declare class Net extends PrimitiveComponent<typeof netProps> {
+    source_net_id?: string;
+    subcircuit_connectivity_map_key: string | null;
+    get config(): {
+        componentName: string;
+        zodProps: z.ZodObject<{
+            name: z.ZodEffects<z.ZodString, string, string>;
+        }, "strip", z.ZodTypeAny, {
+            name: string;
+        }, {
+            name: string;
+        }>;
+    };
+    getPortSelector(): string;
+    doInitialSourceRender(): void;
+    doInitialSourceParentAttachment(): void;
     /**
-     * Get the bounds of the symbol's schematic primitives.
-     * This triggers computation if not already done.
+     * Get all ports connected to this net.
+     *
+     * TODO currently we're not checking for indirect connections (traces that are
+     * connected to other traces that are in turn connected to the net)
      */
-    getSchematicSymbolBounds(): SchematicSymbolBounds | null;
+    getAllConnectedPorts(): Port[];
     /**
-     * Get the transformation matrix for resizing symbol contents.
-     * Returns null if no resizing is needed (no width/height specified).
+     * Get all traces that are directly connected to this net, i.e. they list
+     * this net in their path, from, or to props
      */
-    getUserCoordinateToResizedSymbolTransform(): Matrix | null;
+    _getAllDirectlyConnectedTraces(): Trace[];
     /**
-     * Check if this symbol has explicit width/height that requires resizing.
+     * Add PCB Traces to connect net islands together. A net island is a set of
+     * ports that are connected to each other. If a there are multiple net islands
+     * that means that the net is not fully connected and we need to add traces
+     * such that the nets are fully connected
+     *
+     * Sometimes this phase doesn't find any net islands if the autorouter did
+     * a good job and connected the islands. In some sense this is a "backup"
+     * routing phase for autorouters that don't care about connecting nets.
+     *
+     * This should only run if the autorouter is sequential-trace
      */
-    hasExplicitSize(): boolean;
+    doInitialPcbRouteNetIslands(): void;
+    renderError(message: Parameters<typeof PrimitiveComponent.prototype.renderError>[0]): void;
 }
 
-type Ftype = Extract<AnySourceComponent, {
-    ftype: string;
-}>["ftype"];
-type TwoPinPorts = "pin1" | "pin2";
-type PassivePorts = TwoPinPorts;
-type PolarizedPassivePorts = PassivePorts | "anode" | "cathode" | "pos" | "neg";
-type TransistorPorts = "pin1" | "pin2" | "pin3" | "emitter" | "collector" | "base";
-
-interface BaseComponentConfig {
-    componentName: string;
-    schematicSymbolName?: string | null;
-    zodProps: z.ZodType;
-    sourceFtype?: Ftype | null;
-    shouldRenderAsSchematicBox?: boolean;
+interface TraceI extends PrimitiveComponent<typeof traceProps> {
+    source_trace_id: string | null;
+    subcircuit_connectivity_map_key: string | null;
 }
-/**
- * A PrimitiveComponent (SmtPad, Port etc.) doesn't have the ability to contain
- * React subtrees or explicit handling of the "footprint" prop. But otherwise
- * has most of the features of a NormalComponent.
- */
-declare abstract class PrimitiveComponent<ZodProps extends ZodType = any> extends Renderable {
-    parent: PrimitiveComponent | null;
-    children: PrimitiveComponent[];
-    childrenPendingRemoval: PrimitiveComponent[];
-    get config(): BaseComponentConfig;
-    props: z.input<ZodProps>;
-    _parsedProps: z.infer<ZodProps>;
-    get componentName(): string;
-    getInheritedProperty(propertyName: string): any;
-    getInheritedMergedProperty(propertyName: string): any;
-    getResolvedPcbSx(): PcbSx;
-    get lowercaseComponentName(): string;
-    externallyAddedAliases: string[];
-    /**
-     * An subcircuit is self-contained. All the selectors inside
-     * a subcircuit are relative to the subcircuit group. You can have multiple
-     * subcircuits and their selectors will not interact with each other (even if the
-     * components share the same names) unless you explicitly break out some ports
-     */
-    get isSubcircuit(): any;
-    get isGroup(): boolean;
-    get name(): any;
-    /**
-     * A primitive container is a component that contains one or more ports and
-     * primitive components that are designed to interact.
-     *
-     * For example a resistor contains ports and smtpads that interact, so the
-     * resistor is a primitive container. Inside a primitive container, the ports
-     * and pads are likely to reference each other and look for eachother during
-     * the port matching phase.
-     *
-     */
-    isPrimitiveContainer: boolean;
-    canHaveTextChildren: boolean;
-    source_group_id: string | null;
-    source_component_id: string | null;
-    schematic_component_id: string | null;
-    pcb_component_id: string | null;
-    cad_component_id: string | null;
-    _reportedInvalidPcbCalcWarnings: Set<string>;
-    private _reportInvalidComponentPropertyError;
-    fallbackUnassignedName?: string;
-    constructor(props: z.input<ZodProps>);
-    setProps(props: Partial<z.input<ZodProps>>): void;
-    _getPcbRotationBeforeLayout(): number | null;
-    getResolvedPcbPositionProp(): {
-        pcbX: number;
-        pcbY: number;
-    };
-    doInitialValidatePcbCoordinates(): void;
-    protected _validatePcbCoordinateReferences(params: {
-        rawValue: unknown;
-        axis: "pcbX" | "pcbY";
-        propertyName?: string;
-    }): void;
-    protected _resolvePcbCoordinate(rawValue: unknown, axis: "pcbX" | "pcbY", options?: {
-        allowBoardVariables?: boolean;
-        allowComponentVariables?: boolean;
-        componentVariables?: Record<string, number>;
-        propertyName?: string;
-    }): number;
-    private _shouldAllowBoardVariablesByDefault;
-    private _isInsideFootprint;
-    private _isInsideNonBoardSubcircuit;
-    /**
-     * Check if this component has a user-defined PCB position.
-     * Position can be specified via pcbX/pcbY or edge-based props.
-     */
-    _hasUserDefinedPcbPosition(): boolean;
-    resolvePcbCoordinate(params: {
-        rawValue: unknown;
-        axis: "pcbX" | "pcbY";
-        allowBoardVariables?: boolean;
-        allowComponentVariables?: boolean;
-        componentVariables?: Record<string, number>;
-        propertyName?: string;
-    }): number;
-    /**
-     * Computes a transformation matrix from the props of this component for PCB
-     * components
-     */
-    computePcbPropsTransform(): Matrix;
-    /**
-     * Compute a transformation matrix combining all parent transforms for PCB
-     * components, including this component's translation and rotation.
-     *
-     * This is used to compute this component's position as well as all children
-     * components positions before layout is applied
-     */
-    _computePcbGlobalTransformBeforeLayout(): Matrix;
-    getPrimitiveContainer(): PrimitiveComponent | null;
-    /**
-     * Get the Symbol ancestor if this component is inside a Symbol primitive container.
-     * Used by schematic primitives to access the symbol's resize transform.
-     */
-    _getSymbolAncestor(): ISymbol | null;
-    /**
-     * Walk up the component hierarchy to find the nearest NormalComponent ancestor.
-     * This is useful for primitive components that need access to component IDs
-     * (pcb_component_id, schematic_component_id, source_component_id) from their
-     * parent NormalComponent, even when there are intermediate primitive containers
-     * like Symbol in the hierarchy.
-     */
-    getParentNormalComponent(): any | null;
-    /**
-     * Replaces text like {NAME}, {REF}, and {REFERENCE} with the
-     * reference designator (name) of the parent NormalComponent.
-     */
-    protected _resolveText(): string;
-    /**
-     * Emit a warning when coveredWithSolderMask is true but solderMaskMargin is also set
-     */
-    emitSolderMaskMarginWarning(isCoveredWithSolderMask: boolean, solderMaskMargin: number | undefined): void;
+
+declare class Trace extends PrimitiveComponent<typeof traceProps> implements TraceI {
+    source_trace_id: string | null;
+    pcb_trace_id: string | null;
+    schematic_trace_id: string | null;
+    _portsRoutedOnPcb: Port[];
+    subcircuit_connectivity_map_key: string | null;
+    _traceConnectionHash: string | null;
+    _couldNotFindPort?: boolean;
+    constructor(props: z.input<typeof traceProps>);
     /**
-     * Compute the PCB bounds of this component the circuit json elements
-     * associated with it.
-     */
-    _getPcbCircuitJsonBounds(): {
-        center: {
-            x: number;
-            y: number;
-        };
-        bounds: {
-            left: number;
-            top: number;
-            right: number;
-            bottom: number;
-        };
-        width: number;
-        height: number;
-    };
-    /**
-     * Determine if this pcb primitive should be flipped because the primitive
-     * container is flipped
-     *
-     * TODO use footprint.originalLayer instead of assuming everything is defined
-     * relative to the top layer
-     */
-    _getPcbPrimitiveFlippedHelpers(): {
-        isFlipped: boolean;
-        maybeFlipLayer: (layer: LayerRef) => LayerRef;
-    };
-    /**
-     * Set the position of this component from the layout solver. This method
-     * should operate using CircuitJson associated with this component, like
-     * _getPcbCircuitJsonBounds it can be called multiple times as different
-     * parents apply layout to their children.
-     */
-    _setPositionFromLayout(newCenter: {
-        x: number;
-        y: number;
-    }): void;
-    /**
-     * Computes a transformation matrix from the props of this component for
-     * schematic components
-     */
-    computeSchematicPropsTransform(): Matrix;
-    /**
-     * Compute a transformation matrix combining all parent transforms for this
-     * component
-     */
-    computeSchematicGlobalTransform(): Matrix;
-    _getSchematicSymbolName(): keyof typeof symbols | undefined;
-    _getSchematicSymbolNameOrThrow(): keyof typeof symbols;
-    getSchematicSymbol(): SchSymbol | null;
-    /**
-     * Subcircuit groups have a prop called "layout" that can include manual
-     * placements for pcb components. These are typically added from an IDE
-     */
-    _getPcbManualPlacementForComponent(component: PrimitiveComponent): {
-        x: number;
-        y: number;
-    } | null;
-    _getSchematicManualPlacementForComponent(component: PrimitiveComponent): {
-        x: number;
-        y: number;
-    } | null;
-    _getSchematicGlobalManualPlacementTransform(component: PrimitiveComponent): Matrix | null;
-    _getGlobalPcbPositionBeforeLayout(): {
-        x: number;
-        y: number;
-    };
-    _getGlobalSchematicPositionBeforeLayout(): {
-        x: number;
-        y: number;
-    };
-    _getBoard(): (PrimitiveComponent & BoardI) | undefined;
-    get root(): IsolatedCircuit | null;
-    onAddToParent(parent: PrimitiveComponent): void;
-    /**
-     * Called whenever the props change
-     */
-    onPropsChange(params: {
-        oldProps: z.infer<ZodProps>;
-        newProps: z.infer<ZodProps>;
-        changedProps: string[];
-    }): void;
-    onChildChanged(child: PrimitiveComponent): void;
-    add(component: PrimitiveComponent): void;
-    addAll(components: PrimitiveComponent[]): void;
-    remove(component: PrimitiveComponent): void;
-    getSubcircuitSelector(): string;
-    getFullPathSelector(): string;
-    getNameAndAliases(): string[];
-    isMatchingNameOrAlias(name: string): boolean;
-    isMatchingAnyOf(aliases: Array<string | number>): boolean;
-    getPcbSize(): {
-        width: number;
-        height: number;
-    };
-    doesSelectorMatch(selector: string): boolean;
-    getSubcircuit(): ISubcircuit;
-    getGroup(): IGroup | null;
-    doInitialAssignNameToUnnamedComponents(): void;
-    doInitialOptimizeSelectorCache(): void;
-    _cachedSelectAllQueries: Map<string, PrimitiveComponent[]>;
-    selectAll<T extends PrimitiveComponent = PrimitiveComponent>(selectorRaw: string): T[];
-    _cachedSelectOneQueries: Map<string, PrimitiveComponent | null>;
-    selectOne<T = PrimitiveComponent>(selectorRaw: string, options?: {
-        type?: string;
-        port?: boolean;
-        pcbPrimitive?: boolean;
-        schematicPrimitive?: boolean;
-    }): T | null;
-    getAvailablePcbLayers(): string[];
-    /**
-     * Returns all descendants
-     *
-     * NOTE: This crosses subcircuit boundaries, you may want to use
-     * getSelectableDescendants instead
-     */
-    getDescendants(): PrimitiveComponent[];
-    /**
-     * Returns all descendants that are accessible without crossing a subcircuit
-     * boundary
-     */
-    getSelectableDescendants(): PrimitiveComponent[];
-    /**
-     * Return the number of pins in this component, this is important for
-     * NormalComponents
-     */
-    _getPinCount(): number;
-    /**
-     * If this component represents a SchematicBox (like a Chip), return the
-     * dimensions of the box, which allows computing the position of ports etc.
-     */
-    _getSchematicBoxDimensions(): SchematicBoxDimensions | null;
-    _getSchematicBoxComponentDimensions(): SchematicBoxComponentDimensions | null;
-    renderError(message: Parameters<typeof Renderable.prototype.renderError>[0]): void;
-    getString(): string;
-    getDisplayName(): string;
-    get [Symbol.toStringTag](): string;
-}
-
-declare const netProps: z.ZodObject<{
-    name: z.ZodEffects<z.ZodString, string, string>;
-}, "strip", z.ZodTypeAny, {
-    name: string;
-}, {
-    name: string;
-}>;
-declare class Net extends PrimitiveComponent<typeof netProps> {
-    source_net_id?: string;
-    subcircuit_connectivity_map_key: string | null;
-    get config(): {
-        componentName: string;
-        zodProps: z.ZodObject<{
-            name: z.ZodEffects<z.ZodString, string, string>;
-        }, "strip", z.ZodTypeAny, {
-            name: string;
-        }, {
-            name: string;
-        }>;
-    };
-    getPortSelector(): string;
-    doInitialSourceRender(): void;
-    doInitialSourceParentAttachment(): void;
-    /**
-     * Get all ports connected to this net.
-     *
-     * TODO currently we're not checking for indirect connections (traces that are
-     * connected to other traces that are in turn connected to the net)
-     */
-    getAllConnectedPorts(): Port[];
-    /**
-     * Get all traces that are directly connected to this net, i.e. they list
-     * this net in their path, from, or to props
-     */
-    _getAllDirectlyConnectedTraces(): Trace[];
-    /**
-     * Add PCB Traces to connect net islands together. A net island is a set of
-     * ports that are connected to each other. If a there are multiple net islands
-     * that means that the net is not fully connected and we need to add traces
-     * such that the nets are fully connected
-     *
-     * Sometimes this phase doesn't find any net islands if the autorouter did
-     * a good job and connected the islands. In some sense this is a "backup"
-     * routing phase for autorouters that don't care about connecting nets.
-     *
-     * This should only run if the autorouter is sequential-trace
-     */
-    doInitialPcbRouteNetIslands(): void;
-    renderError(message: Parameters<typeof PrimitiveComponent.prototype.renderError>[0]): void;
-}
-
-interface TraceI extends PrimitiveComponent<typeof traceProps> {
-    source_trace_id: string | null;
-    subcircuit_connectivity_map_key: string | null;
-}
-
-declare class Trace extends PrimitiveComponent<typeof traceProps> implements TraceI {
-    source_trace_id: string | null;
-    pcb_trace_id: string | null;
-    schematic_trace_id: string | null;
-    _portsRoutedOnPcb: Port[];
-    subcircuit_connectivity_map_key: string | null;
-    _traceConnectionHash: string | null;
-    _couldNotFindPort?: boolean;
-    constructor(props: z.input<typeof traceProps>);
-    /**
-     * Get the explicit trace thickness, supporting 'width' as an alias for 'thickness'
+     * Get the explicit trace thickness, supporting 'width' as an alias for 'thickness'
      */
     _getExplicitTraceThickness(): number | undefined;
     get config(): {
@@ -1378,6 +1049,341 @@ declare class Trace extends PrimitiveComponent<typeof traceProps> implements Tra
     doInitialSchematicTraceRender(): void;
 }
 
+interface RoutingPhasePlan {
+    routingPhaseIndex: number | null;
+    traces: Trace[];
+}
+
+interface ISubcircuit extends PrimitiveComponent {
+    _shouldUseTraceByTraceRouting(): boolean;
+    _getRoutingPhasePlans(): RoutingPhasePlan[];
+    _parsedProps: z.infer<typeof subcircuitGroupProps>;
+    _getAutorouterConfig(): AutorouterConfig;
+    _isAutoJumperAutorouter(autorouterConfig?: AutorouterConfig): boolean;
+    getNextAvailableName(elm: PrimitiveComponent): string;
+    _getSubcircuitLayerCount(): number;
+    subcircuit_id: string | null;
+    getNormalComponentNameMap?: () => Map<string, NormalComponent[]>;
+    _isInflatedFromCircuitJson: boolean;
+    _isIsolatedSubcircuit: boolean;
+    _isolatedCircuitJson: AnyCircuitElement[] | null;
+    _normalComponentNameMap: Map<string, NormalComponent[]> | null;
+    getSubcircuitPropHash?(): string;
+}
+
+interface SchematicSymbolBounds {
+    minX: number;
+    maxX: number;
+    minY: number;
+    maxY: number;
+}
+interface ISymbol {
+    /**
+     * The circuit-json schematic_symbol_id for this symbol.
+     * Created during SchematicPrimitiveRender phase.
+     */
+    schematic_symbol_id?: string;
+    /**
+     * The transformation matrix to convert from user coordinates (as specified
+     * in the symbol's children) to the final resized symbol coordinates.
+     * This is computed lazily when first requested.
+     */
+    userCoordinateToResizedSymbolTransformMat?: Matrix;
+    /**
+     * The computed bounds of the symbol's schematic primitives before any
+     * resizing is applied.
+     */
+    schematicSymbolBoundsInUserCoordinates?: SchematicSymbolBounds;
+    /**
+     * Get the bounds of the symbol's schematic primitives.
+     * This triggers computation if not already done.
+     */
+    getSchematicSymbolBounds(): SchematicSymbolBounds | null;
+    /**
+     * Get the transformation matrix for resizing symbol contents.
+     * Returns null if no resizing is needed (no width/height specified).
+     */
+    getUserCoordinateToResizedSymbolTransform(): Matrix | null;
+    /**
+     * Check if this symbol has explicit width/height that requires resizing.
+     */
+    hasExplicitSize(): boolean;
+}
+
+type Ftype = Extract<AnySourceComponent, {
+    ftype: string;
+}>["ftype"];
+type TwoPinPorts = "pin1" | "pin2";
+type PassivePorts = TwoPinPorts;
+type PolarizedPassivePorts = PassivePorts | "anode" | "cathode" | "pos" | "neg";
+type TransistorPorts = "pin1" | "pin2" | "pin3" | "emitter" | "collector" | "base";
+
+interface BaseComponentConfig {
+    componentName: string;
+    schematicSymbolName?: string | null;
+    zodProps: z.ZodType;
+    sourceFtype?: Ftype | null;
+    shouldRenderAsSchematicBox?: boolean;
+}
+/**
+ * A PrimitiveComponent (SmtPad, Port etc.) doesn't have the ability to contain
+ * React subtrees or explicit handling of the "footprint" prop. But otherwise
+ * has most of the features of a NormalComponent.
+ */
+declare abstract class PrimitiveComponent<ZodProps extends ZodType = any> extends Renderable {
+    parent: PrimitiveComponent | null;
+    children: PrimitiveComponent[];
+    childrenPendingRemoval: PrimitiveComponent[];
+    get config(): BaseComponentConfig;
+    props: z.input<ZodProps>;
+    _parsedProps: z.infer<ZodProps>;
+    get componentName(): string;
+    getInheritedProperty(propertyName: string): any;
+    getInheritedMergedProperty(propertyName: string): any;
+    getResolvedPcbSx(): PcbSx;
+    get lowercaseComponentName(): string;
+    externallyAddedAliases: string[];
+    /**
+     * An subcircuit is self-contained. All the selectors inside
+     * a subcircuit are relative to the subcircuit group. You can have multiple
+     * subcircuits and their selectors will not interact with each other (even if the
+     * components share the same names) unless you explicitly break out some ports
+     */
+    get isSubcircuit(): any;
+    get isGroup(): boolean;
+    get name(): any;
+    /**
+     * A primitive container is a component that contains one or more ports and
+     * primitive components that are designed to interact.
+     *
+     * For example a resistor contains ports and smtpads that interact, so the
+     * resistor is a primitive container. Inside a primitive container, the ports
+     * and pads are likely to reference each other and look for eachother during
+     * the port matching phase.
+     *
+     */
+    isPrimitiveContainer: boolean;
+    canHaveTextChildren: boolean;
+    source_group_id: string | null;
+    source_component_id: string | null;
+    schematic_component_id: string | null;
+    pcb_component_id: string | null;
+    cad_component_id: string | null;
+    _reportedInvalidPcbCalcWarnings: Set<string>;
+    private _reportInvalidComponentPropertyError;
+    fallbackUnassignedName?: string;
+    constructor(props: z.input<ZodProps>);
+    setProps(props: Partial<z.input<ZodProps>>): void;
+    _getPcbRotationBeforeLayout(): number | null;
+    getResolvedPcbPositionProp(): {
+        pcbX: number;
+        pcbY: number;
+    };
+    doInitialValidatePcbCoordinates(): void;
+    protected _validatePcbCoordinateReferences(params: {
+        rawValue: unknown;
+        axis: "pcbX" | "pcbY";
+        propertyName?: string;
+    }): void;
+    protected _resolvePcbCoordinate(rawValue: unknown, axis: "pcbX" | "pcbY", options?: {
+        allowBoardVariables?: boolean;
+        allowComponentVariables?: boolean;
+        componentVariables?: Record<string, number>;
+        propertyName?: string;
+    }): number;
+    private _shouldAllowBoardVariablesByDefault;
+    private _isInsideFootprint;
+    private _isInsideNonBoardSubcircuit;
+    /**
+     * Check if this component has a user-defined PCB position.
+     * Position can be specified via pcbX/pcbY or edge-based props.
+     */
+    _hasUserDefinedPcbPosition(): boolean;
+    resolvePcbCoordinate(params: {
+        rawValue: unknown;
+        axis: "pcbX" | "pcbY";
+        allowBoardVariables?: boolean;
+        allowComponentVariables?: boolean;
+        componentVariables?: Record<string, number>;
+        propertyName?: string;
+    }): number;
+    /**
+     * Computes a transformation matrix from the props of this component for PCB
+     * components
+     */
+    computePcbPropsTransform(): Matrix;
+    /**
+     * Compute a transformation matrix combining all parent transforms for PCB
+     * components, including this component's translation and rotation.
+     *
+     * This is used to compute this component's position as well as all children
+     * components positions before layout is applied
+     */
+    _computePcbGlobalTransformBeforeLayout(): Matrix;
+    getPrimitiveContainer(): PrimitiveComponent | null;
+    /**
+     * Get the Symbol ancestor if this component is inside a Symbol primitive container.
+     * Used by schematic primitives to access the symbol's resize transform.
+     */
+    _getSymbolAncestor(): ISymbol | null;
+    /**
+     * Walk up the component hierarchy to find the nearest NormalComponent ancestor.
+     * This is useful for primitive components that need access to component IDs
+     * (pcb_component_id, schematic_component_id, source_component_id) from their
+     * parent NormalComponent, even when there are intermediate primitive containers
+     * like Symbol in the hierarchy.
+     */
+    getParentNormalComponent(): any | null;
+    /**
+     * Replaces text like {NAME}, {REF}, and {REFERENCE} with the
+     * reference designator (name) of the parent NormalComponent.
+     */
+    protected _resolveText(): string;
+    /**
+     * Emit a warning when coveredWithSolderMask is true but solderMaskMargin is also set
+     */
+    emitSolderMaskMarginWarning(isCoveredWithSolderMask: boolean, solderMaskMargin: number | undefined): void;
+    /**
+     * Compute the PCB bounds of this component the circuit json elements
+     * associated with it.
+     */
+    _getPcbCircuitJsonBounds(): {
+        center: {
+            x: number;
+            y: number;
+        };
+        bounds: {
+            left: number;
+            top: number;
+            right: number;
+            bottom: number;
+        };
+        width: number;
+        height: number;
+    };
+    /**
+     * Determine if this pcb primitive should be flipped because the primitive
+     * container is flipped
+     *
+     * TODO use footprint.originalLayer instead of assuming everything is defined
+     * relative to the top layer
+     */
+    _getPcbPrimitiveFlippedHelpers(): {
+        isFlipped: boolean;
+        maybeFlipLayer: (layer: LayerRef) => LayerRef;
+    };
+    /**
+     * Set the position of this component from the layout solver. This method
+     * should operate using CircuitJson associated with this component, like
+     * _getPcbCircuitJsonBounds it can be called multiple times as different
+     * parents apply layout to their children.
+     */
+    _setPositionFromLayout(newCenter: {
+        x: number;
+        y: number;
+    }): void;
+    /**
+     * Computes a transformation matrix from the props of this component for
+     * schematic components
+     */
+    computeSchematicPropsTransform(): Matrix;
+    /**
+     * Compute a transformation matrix combining all parent transforms for this
+     * component
+     */
+    computeSchematicGlobalTransform(): Matrix;
+    _getSchematicSymbolName(): keyof typeof symbols | undefined;
+    _getSchematicSymbolNameOrThrow(): keyof typeof symbols;
+    getSchematicSymbol(): SchSymbol | null;
+    /**
+     * Subcircuit groups have a prop called "layout" that can include manual
+     * placements for pcb components. These are typically added from an IDE
+     */
+    _getPcbManualPlacementForComponent(component: PrimitiveComponent): {
+        x: number;
+        y: number;
+    } | null;
+    _getSchematicManualPlacementForComponent(component: PrimitiveComponent): {
+        x: number;
+        y: number;
+    } | null;
+    _getSchematicGlobalManualPlacementTransform(component: PrimitiveComponent): Matrix | null;
+    _getGlobalPcbPositionBeforeLayout(): {
+        x: number;
+        y: number;
+    };
+    _getGlobalSchematicPositionBeforeLayout(): {
+        x: number;
+        y: number;
+    };
+    _getBoard(): (PrimitiveComponent & BoardI) | undefined;
+    get root(): IsolatedCircuit | null;
+    onAddToParent(parent: PrimitiveComponent): void;
+    /**
+     * Called whenever the props change
+     */
+    onPropsChange(params: {
+        oldProps: z.infer<ZodProps>;
+        newProps: z.infer<ZodProps>;
+        changedProps: string[];
+    }): void;
+    onChildChanged(child: PrimitiveComponent): void;
+    add(component: PrimitiveComponent): void;
+    addAll(components: PrimitiveComponent[]): void;
+    remove(component: PrimitiveComponent): void;
+    getSubcircuitSelector(): string;
+    getFullPathSelector(): string;
+    getNameAndAliases(): string[];
+    isMatchingNameOrAlias(name: string): boolean;
+    isMatchingAnyOf(aliases: Array<string | number>): boolean;
+    getPcbSize(): {
+        width: number;
+        height: number;
+    };
+    doesSelectorMatch(selector: string): boolean;
+    getSubcircuit(): ISubcircuit;
+    getGroup(): IGroup | null;
+    doInitialAssignNameToUnnamedComponents(): void;
+    doInitialOptimizeSelectorCache(): void;
+    _cachedSelectAllQueries: Map<string, PrimitiveComponent[]>;
+    selectAll<T extends PrimitiveComponent = PrimitiveComponent>(selectorRaw: string): T[];
+    _cachedSelectOneQueries: Map<string, PrimitiveComponent | null>;
+    selectOne<T = PrimitiveComponent>(selectorRaw: string, options?: {
+        type?: string;
+        port?: boolean;
+        pcbPrimitive?: boolean;
+        schematicPrimitive?: boolean;
+    }): T | null;
+    getAvailablePcbLayers(): string[];
+    /**
+     * Returns all descendants
+     *
+     * NOTE: This crosses subcircuit boundaries, you may want to use
+     * getSelectableDescendants instead
+     */
+    getDescendants(): PrimitiveComponent[];
+    /**
+     * Returns all descendants that are accessible without crossing a subcircuit
+     * boundary
+     */
+    getSelectableDescendants(): PrimitiveComponent[];
+    /**
+     * Return the number of pins in this component, this is important for
+     * NormalComponents
+     */
+    _getPinCount(): number;
+    /**
+     * If this component represents a SchematicBox (like a Chip), return the
+     * dimensions of the box, which allows computing the position of ports etc.
+     */
+    _getSchematicBoxDimensions(): SchematicBoxDimensions | null;
+    _getSchematicBoxComponentDimensions(): SchematicBoxComponentDimensions | null;
+    renderError(message: Parameters<typeof Renderable.prototype.renderError>[0]): void;
+    getString(): string;
+    getDisplayName(): string;
+    get [Symbol.toStringTag](): string;
+}
+
 declare const portProps: z.ZodObject<{
     name: z.ZodOptional<z.ZodString>;
     pinNumber: z.ZodOptional<z.ZodNumber>;
@@ -1805,6 +1811,7 @@ declare class Group<Props extends z.ZodType<any, any, any> = typeof groupProps>
     doInitialSourceAddConnectivityMapKey(): void;
     _areChildSubcircuitsRouted(): boolean;
     _shouldRouteAsync(): boolean;
+    _getRoutingPhasePlans(): RoutingPhasePlan[];
     _hasTracesToRoute(): boolean;
     _runEffectMakeHttpAutoroutingRequest(): Promise<void>;
     /**

package/dist/index.js

@@ -17321,6 +17321,18 @@ function Group_doInitialSourceAddConnectivityMapKey(group) {
   }
 }
 
+// lib/components/primitive-components/Group/Group_getRoutingPhasePlans.ts
+function Group_getRoutingPhasePlans(group) {
+  const traces = group.selectAll("trace");
+  if (traces.length === 0) return [];
+  return [
+    {
+      routingPhaseIndex: null,
+      traces
+    }
+  ];
+}
+
 // lib/components/primitive-components/Group/add-port-ids-to-traces-at-jumper-pads.ts
 function getJumperPadInfos(db) {
   const padInfos = [];
@@ -17865,11 +17877,18 @@ var Group6 = class extends NormalComponent3 {
     if (!autorouter.local) return true;
     return false;
   }
+  _getRoutingPhasePlans() {
+    return Group_getRoutingPhasePlans(this);
+  }
   _hasTracesToRoute() {
     const debug11 = Debug13("tscircuit:core:_hasTracesToRoute");
-    const traces = this.selectAll("trace");
-    debug11(`[${this.getString()}] has ${traces.length} traces to route`);
-    return traces.length > 0;
+    const routingPhasePlans = this._getRoutingPhasePlans();
+    let traceCount = 0;
+    for (const routingPhasePlan of routingPhasePlans) {
+      traceCount += routingPhasePlan.traces.length;
+    }
+    debug11(`[${this.getString()}] has ${traceCount} traces to route`);
+    return traceCount > 0;
   }
   async _runEffectMakeHttpAutoroutingRequest() {
     const { db } = this.root;
@@ -19296,7 +19315,7 @@ import { identity as identity5 } from "transformation-matrix";
 var package_default = {
   name: "@tscircuit/core",
   type: "module",
-  version: "0.0.1155",
+  version: "0.0.1157",
   types: "dist/index.d.ts",
   main: "dist/index.js",
   module: "dist/index.js",
@@ -23094,83 +23113,77 @@ import {
 } from "@tscircuit/props";
 import { unknown_error_finding_part as unknown_error_finding_part2 } from "circuit-json";
 
-// lib/utils/connectors/rewriteToStandardUsbCPortHints.ts
-var PIN_HINT_RE = /^(?:pin)?(\d+)$/i;
-var USB_C_STANDARD_PORT_HINT_ALIASES = {
-  GND1: [],
-  VBUS1: [],
-  SBU2: [],
-  CC1: [],
-  DM2: ["DN2"],
-  DP1: [],
-  DM1: ["DN1"],
-  DP2: [],
-  SBU1: [],
-  CC2: [],
-  VBUS2: [],
-  GND2: [],
-  SHELL1: [],
-  SHELL2: [],
-  SHELL3: [],
-  SHELL4: []
-};
-var unique = (hints) => Array.from(new Set(hints));
-var rewriteToStandardUsbCPortHints = (circuitJson) => {
-  const aliasToStandardHint = {};
-  for (const [standardHint, aliases] of Object.entries(
-    USB_C_STANDARD_PORT_HINT_ALIASES
-  )) {
-    aliasToStandardHint[standardHint] = standardHint;
-    for (const alias of aliases) {
-      aliasToStandardHint[alias] = standardHint;
-    }
-  }
-  const sourceAliasesByPin = /* @__PURE__ */ new Map();
-  for (const elm of circuitJson) {
-    if (elm && typeof elm === "object" && elm.type === "source_port" && typeof elm.pin_number === "number") {
-      const pin = elm.pin_number;
-      const hints = Array.isArray(elm.port_hints) ? elm.port_hints.filter((h) => typeof h === "string").map((h) => h.trim()).filter((h) => h.length > 0 && !PIN_HINT_RE.test(h)) : [];
-      if (hints.length > 0) sourceAliasesByPin.set(pin, unique(hints));
-    }
-  }
-  if (sourceAliasesByPin.size === 0) return circuitJson;
-  return circuitJson.map((elm) => {
-    if (!elm || typeof elm !== "object" || !("port_hints" in elm)) return elm;
-    if (!Array.isArray(elm.port_hints)) return elm;
+// lib/utils/connectors/convertCircuitJsonToUsbCStandardCircuitJson.ts
+var STANDARD_USB_C_PIN_LABELS = [
+  { label: "GND1", aliases: [] },
+  { label: "VBUS1", aliases: [] },
+  { label: "CC1", aliases: [] },
+  { label: "DP1", aliases: [] },
+  { label: "DM1", aliases: ["DN1"] },
+  { label: "SBU1", aliases: [] },
+  { label: "SBU2", aliases: [] },
+  { label: "DM2", aliases: ["DN2"] },
+  { label: "DP2", aliases: [] },
+  { label: "CC2", aliases: [] },
+  { label: "VBUS2", aliases: [] },
+  { label: "GND2", aliases: [] },
+  { label: "SHELL1", aliases: ["MH1", "EH1", "MOUNT1"] },
+  { label: "SHELL2", aliases: ["MH2", "EH2", "MOUNT2"] },
+  { label: "SHELL3", aliases: ["MH3", "EH3", "MOUNT3"] },
+  { label: "SHELL4", aliases: ["MH4", "EH4", "MOUNT4"] }
+];
+var PIN_NUMBER_HINT_PATTERN = /^(?:pin)?(\d+)$/i;
+var dedupeHintsPreservingOrder = (hints) => Array.from(new Set(hints));
+var convertCircuitJsonToUsbCStandardCircuitJson = (partCircuitJson) => {
+  const unassignedPorts = [];
+  for (const elm of partCircuitJson) {
+    if (elm.type !== "source_port") continue;
+    const pinNumber = elm.pin_number;
+    if (typeof pinNumber !== "number") continue;
+    const upperCaseHints = /* @__PURE__ */ new Set();
+    for (const hint of elm.port_hints ?? []) {
+      upperCaseHints.add(hint.trim().toUpperCase());
+    }
+    unassignedPorts.push({ pinKey: `pin${pinNumber}`, upperCaseHints });
+  }
+  const canonicalHintsByPin = {};
+  for (const { label, aliases } of STANDARD_USB_C_PIN_LABELS) {
+    const canonicalAndAliasHintsUpper = [label, ...aliases].map(
+      (s) => s.toUpperCase()
+    );
+    const matchIndex = unassignedPorts.findIndex(
+      (port) => canonicalAndAliasHintsUpper.some((hint) => port.upperCaseHints.has(hint))
+    );
+    if (matchIndex === -1) continue;
+    const { pinKey } = unassignedPorts[matchIndex];
+    canonicalHintsByPin[pinKey] = [label];
+    unassignedPorts.splice(matchIndex, 1);
+  }
+  if (Object.keys(canonicalHintsByPin).length === 0) return partCircuitJson;
+  return partCircuitJson.map((elm) => {
+    if (!("port_hints" in elm) || !Array.isArray(elm.port_hints)) return elm;
     const originalHints = elm.port_hints.filter((h) => typeof h === "string").map((h) => h.trim()).filter((h) => h.length > 0);
     if (originalHints.length === 0) return elm;
-    const pinNumbers = /* @__PURE__ */ new Set();
+    const pinKeys = /* @__PURE__ */ new Set();
     if (elm.type === "source_port" && typeof elm.pin_number === "number") {
-      pinNumbers.add(elm.pin_number);
+      pinKeys.add(`pin${elm.pin_number}`);
     }
     for (const hint of originalHints) {
-      const m = hint.match(PIN_HINT_RE);
-      if (m) pinNumbers.add(Number.parseInt(m[1], 10));
-    }
-    const sourceAliases = [];
-    for (const pin of pinNumbers) {
-      sourceAliases.push(...sourceAliasesByPin.get(pin) ?? []);
-    }
-    const standardHints = /* @__PURE__ */ new Set();
-    for (const hint of [...originalHints, ...sourceAliases]) {
-      const standard = aliasToStandardHint[hint.toUpperCase()];
-      if (standard) standardHints.add(standard);
-    }
-    const addedHints = [];
-    for (const standardHint of standardHints) {
-      addedHints.push(
-        standardHint,
-        ...USB_C_STANDARD_PORT_HINT_ALIASES[standardHint]
-      );
+      const matchedPin = hint.match(PIN_NUMBER_HINT_PATTERN);
+      if (!matchedPin) continue;
+      pinKeys.add(`pin${Number.parseInt(matchedPin[1], 10)}`);
     }
-    const rewrittenPortHints = unique([
-      ...originalHints,
-      ...sourceAliases,
-      ...addedHints
-    ]);
+    const canonicalHintsToAdd = [];
+    for (const pinKey of pinKeys) {
+      canonicalHintsToAdd.push(...canonicalHintsByPin[pinKey] ?? []);
+    }
+    if (canonicalHintsToAdd.length === 0) return elm;
     return {
       ...elm,
-      port_hints: rewrittenPortHints
+      port_hints: dedupeHintsPreservingOrder([
+        ...originalHints,
+        ...canonicalHintsToAdd
+      ])
     };
   });
 };
@@ -23316,8 +23329,8 @@ var Connector = class extends Chip {
     });
   }
   _addConnectorFootprintFromCircuitJson(standard, circuitJson) {
-    const rewrittenCircuitJson = standard === "usb_c" ? rewriteToStandardUsbCPortHints(circuitJson) : circuitJson;
     const props = this._getConnectorProps();
+    const standardizedCircuitJson = standard === "usb_c" ? convertCircuitJsonToUsbCStandardCircuitJson(circuitJson) : circuitJson;
     const fpComponents = createComponentsFromCircuitJson(
       {
         componentName: this.name,
@@ -23326,7 +23339,7 @@ var Connector = class extends Chip {
         pinLabels: props.pinLabels,
         pcbPinLabels: props.pcbPinLabels
       },
-      rewrittenCircuitJson
+      standardizedCircuitJson
     );
     this.addAll(fpComponents);
     this._markDirty("InitializePortsFromChildren");

package/package.json

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