@tscircuit/props 0.0.605 → 0.0.607

package/README.md

@@ -879,8 +879,21 @@ export interface FootprintProps {
    */
   src?: FootprintProp;
   /**
-   * Direction a cable or mating part is inserted into this footprint in its
-   * unrotated orientation.
+   * Direction a cable or mating part is attached from, in the footprint's own
+   * frame -- the same frame its pads are drawn in. Directions are named for the
+   * footprint as drawn in the 2D PCB view: `from_top` is +Y, `from_bottom` -Y,
+   * `from_left` -X, `from_right` +X, `from_above` +Z and `from_below` -Z.
+   * Cartesian spellings such as `from_y_pos` are also accepted.
+   *
+   * This names a side, not a motion. A receptacle on the +Y edge is `from_top`
+   * because that is the side the plug comes from, even though the plug itself
+   * moves in -Y as it seats.
+   *
+   * This is a property of the part, so it is authored without regard to where
+   * the part is placed. Rotating or flipping the component rotates this with it,
+   * and `pcb_component.insertion_direction` reports the result in board
+   * coordinates. The two frames coincide for an unrotated top-layer part, which
+   * makes the distinction easy to miss.
    */
   insertionDirection?: FootprintInsertionDirection;
 }

package/dist/index.d.ts

@@ -2,7 +2,7 @@ import * as zod from 'zod';
 import { z } from 'zod';
 import * as react from 'react';
 import { ReactElement, ReactNode } from 'react';
-import { LayerRef, AnyCircuitElement, LayerRefInput, SourceNet, PcbPort, SourcePort, PcbComponent, SourceComponentBase, CircuitJsonError, Point as Point$1, RouteHintPoint, PcbTrace, AnySourceComponent, VisibleLayer, RouteHintPointInput } from 'circuit-json';
+import { LayerRef, AnyCircuitElement, LayerRefInput, SourceNet, PcbPort, SourcePort, PcbComponent, SourceComponentBase, CircuitJsonError, Point as Point$1, RouteHintPoint, PcbTrace, AnySourceComponent, InsertionDirectionInput, VisibleLayer, RouteHintPointInput } from 'circuit-json';
 
 declare const direction: z.ZodEnum<["up", "down", "left", "right"]>;
 type Direction = "up" | "down" | "left" | "right";
@@ -104990,8 +104990,18 @@ declare const differentialPairProps: z.ZodObject<{
     maxLengthSkew?: number | undefined;
 }>;
 
-type FootprintInsertionDirection = "from_above" | "from_left" | "from_right" | "from_front" | "from_back";
-declare const footprintInsertionDirection: z.ZodEnum<["from_above", "from_left", "from_right", "from_front", "from_back"]>;
+/**
+ * Direction a cable or mating part is attached from, named for the side of the
+ * footprint it approaches from.
+ *
+ * Aliased to Circuit JSON's input union so the two cannot drift apart. Both the
+ * named spellings and their Cartesian equivalents are accepted here, as are the
+ * deprecated `from_front` (now `from_top`) and `from_back` (now `from_bottom`).
+ * Core normalizes them to the six named values before writing
+ * `pcb_component.insertion_direction`.
+ */
+type FootprintInsertionDirection = InsertionDirectionInput;
+declare const footprintInsertionDirection: z.ZodEnum<["from_left", "from_right", "from_top", "from_bottom", "from_above", "from_below", "from_x_neg", "from_x_pos", "from_y_pos", "from_y_neg", "from_z_pos", "from_z_neg", "from_front", "from_back"]>;
 interface FootprintProps {
     children?: any;
     name?: string;
@@ -105015,8 +105025,21 @@ interface FootprintProps {
      */
     src?: FootprintProp;
     /**
-     * Direction a cable or mating part is inserted into this footprint in its
-     * unrotated orientation.
+     * Direction a cable or mating part is attached from, in the footprint's own
+     * frame -- the same frame its pads are drawn in. Directions are named for the
+     * footprint as drawn in the 2D PCB view: `from_top` is +Y, `from_bottom` -Y,
+     * `from_left` -X, `from_right` +X, `from_above` +Z and `from_below` -Z.
+     * Cartesian spellings such as `from_y_pos` are also accepted.
+     *
+     * This names a side, not a motion. A receptacle on the +Y edge is `from_top`
+     * because that is the side the plug comes from, even though the plug itself
+     * moves in -Y as it seats.
+     *
+     * This is a property of the part, so it is authored without regard to where
+     * the part is placed. Rotating or flipping the component rotates this with it,
+     * and `pcb_component.insertion_direction` reports the result in board
+     * coordinates. The two frames coincide for an unrotated top-layer part, which
+     * makes the distinction easy to miss.
      */
     insertionDirection?: FootprintInsertionDirection;
 }
@@ -105034,14 +105057,14 @@ declare const footprintProps: z.ZodObject<{
     }>>>;
     circuitJson: z.ZodOptional<z.ZodArray<z.ZodAny, "many">>;
     src: z.ZodOptional<z.ZodType<FootprintProp, z.ZodTypeDef, FootprintProp>>;
-    insertionDirection: z.ZodOptional<z.ZodEnum<["from_above", "from_left", "from_right", "from_front", "from_back"]>>;
+    insertionDirection: z.ZodOptional<z.ZodEnum<["from_left", "from_right", "from_top", "from_bottom", "from_above", "from_below", "from_x_neg", "from_x_pos", "from_y_pos", "from_y_neg", "from_z_pos", "from_z_neg", "from_front", "from_back"]>>;
 }, "strip", z.ZodTypeAny, {
     name?: string | undefined;
     children?: any;
     circuitJson?: any[] | undefined;
     originalLayer?: "top" | "bottom" | "inner1" | "inner2" | "inner3" | "inner4" | "inner5" | "inner6" | "inner7" | "inner8" | undefined;
     src?: FootprintProp | undefined;
-    insertionDirection?: "from_above" | "from_left" | "from_right" | "from_front" | "from_back" | undefined;
+    insertionDirection?: "from_left" | "from_right" | "from_top" | "from_bottom" | "from_above" | "from_below" | "from_x_neg" | "from_x_pos" | "from_y_pos" | "from_y_neg" | "from_z_pos" | "from_z_neg" | "from_front" | "from_back" | undefined;
 }, {
     name?: string | undefined;
     children?: any;
@@ -105050,7 +105073,7 @@ declare const footprintProps: z.ZodObject<{
         name: "top" | "bottom" | "inner1" | "inner2" | "inner3" | "inner4" | "inner5" | "inner6" | "inner7" | "inner8";
     } | undefined;
     src?: FootprintProp | undefined;
-    insertionDirection?: "from_above" | "from_left" | "from_right" | "from_front" | "from_back" | undefined;
+    insertionDirection?: "from_left" | "from_right" | "from_top" | "from_bottom" | "from_above" | "from_below" | "from_x_neg" | "from_x_pos" | "from_y_pos" | "from_y_neg" | "from_z_pos" | "from_z_neg" | "from_front" | "from_back" | undefined;
 }>;
 type FootprintPropsInput = z.input<typeof footprintProps>;
 
@@ -141811,6 +141834,7 @@ declare const inductorProps: z.ZodObject<{
 declare const diodePins: readonly ["pin1", "left", "anode", "pos", "pin2", "right", "cathode", "neg"];
 type DiodePinLabels = (typeof diodePins)[number];
 type DiodePinLabelsProp<PinLabel extends string = string> = Partial<Record<DiodePinLabels, PinLabel | PinLabel[] | readonly PinLabel[]>>;
+declare const diodePinLabelsProp: z.ZodRecord<z.ZodEnum<["pin1", "left", "anode", "pos", "pin2", "right", "cathode", "neg"]>, z.ZodUnion<[z.ZodUnion<[z.ZodString, z.ZodReadonly<z.ZodArray<z.ZodString, "many">>]>, z.ZodArray<z.ZodString, "many">]>>;
 declare const diodeProps: z.ZodEffects<z.ZodEffects<z.ZodObject<{
     pcbX: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodEffects<z.ZodUnion<[z.ZodString, z.ZodNumber]>, number, string | number>]>>;
     pcbY: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodEffects<z.ZodUnion<[z.ZodString, z.ZodNumber]>, number, string | number>]>>;
@@ -152102,6 +152126,7 @@ declare const ledProps: z.ZodObject<{
     wavelength: z.ZodOptional<z.ZodString>;
     schDisplayValue: z.ZodOptional<z.ZodString>;
     schOrientation: z.ZodOptional<z.ZodEnum<["vertical", "horizontal", "pos_top", "pos_bottom", "pos_left", "pos_right", "neg_top", "neg_bottom", "neg_left", "neg_right"]>>;
+    pinLabels: z.ZodOptional<z.ZodRecord<z.ZodEnum<["pin1", "left", "anode", "pos", "pin2", "right", "cathode", "neg"]>, z.ZodUnion<[z.ZodUnion<[z.ZodString, z.ZodReadonly<z.ZodArray<z.ZodString, "many">>]>, z.ZodArray<z.ZodString, "many">]>>>;
     connections: z.ZodOptional<z.ZodRecord<z.ZodEnum<["pin1", "left", "anode", "pos", "pin2", "right", "cathode", "neg"]>, z.ZodUnion<[z.ZodUnion<[z.ZodString, z.ZodReadonly<z.ZodArray<z.ZodString, "many">>]>, z.ZodArray<z.ZodString, "many">]>>>;
     laser: z.ZodOptional<z.ZodBoolean>;
 }, "strip", z.ZodTypeAny, {
@@ -152683,6 +152708,7 @@ declare const ledProps: z.ZodObject<{
     schSectionName?: string | undefined;
     schSheetName?: string | undefined;
     connections?: Partial<Record<"left" | "right" | "pin1" | "pin2" | "anode" | "pos" | "cathode" | "neg", string | readonly string[] | string[]>> | undefined;
+    pinLabels?: Partial<Record<"left" | "right" | "pin1" | "pin2" | "anode" | "pos" | "cathode" | "neg", string | readonly string[] | string[]>> | undefined;
     schOrientation?: "vertical" | "horizontal" | "pos_top" | "pos_bottom" | "pos_left" | "pos_right" | "neg_top" | "neg_bottom" | "neg_left" | "neg_right" | undefined;
     color?: string | undefined;
     wavelength?: string | undefined;
@@ -153269,6 +153295,7 @@ declare const ledProps: z.ZodObject<{
     schSectionName?: string | undefined;
     schSheetName?: string | undefined;
     connections?: Partial<Record<"left" | "right" | "pin1" | "pin2" | "anode" | "pos" | "cathode" | "neg", string | readonly string[] | string[]>> | undefined;
+    pinLabels?: Partial<Record<"left" | "right" | "pin1" | "pin2" | "anode" | "pos" | "cathode" | "neg", string | readonly string[] | string[]>> | undefined;
     schOrientation?: "vertical" | "horizontal" | "pos_top" | "pos_bottom" | "pos_left" | "pos_right" | "neg_top" | "neg_bottom" | "neg_left" | "neg_right" | undefined;
     color?: string | undefined;
     wavelength?: string | undefined;
@@ -192739,4 +192766,4 @@ interface ProjectConfig extends Pick<PlatformConfig, "projectName" | "projectBas
 }
 declare const projectConfig: z.ZodType<ProjectConfig>;
 
-export { type AmmeterPinLabels, type AmmeterProps, type AnalogAcSweepSimulationProps, type AnalogAnalysisSimulationBaseProps, type AnalogCapacitanceSweepParameterProps, type AnalogCurrentSweepParameterProps, type AnalogDcOperatingPointSimulationProps, type AnalogDcSweepSimulationProps, type AnalogInductanceSweepParameterProps, type AnalogResistanceSweepParameterProps, type AnalogSimulationProps, type AnalogSweepParameterProps, type AnalogTransientSimulationProps, type AnalogVoltageSweepParameterProps, type AssemblyDeviceProps, type AssemblyDevicePropsInput, type AutocompleteString, type AutorouterConfig, type AutorouterDefinition, type AutorouterInstance, type AutorouterPreset, type AutorouterProp, type AutoroutingPhaseProps, type BaseGroupProps, type BaseManualEditEvent, type BaseManualEditEventInput, type BasicFootprint, type BatteryPinLabels, type BatteryProps, type BoardColor, type BoardColorPreset, type BoardProps, type Border, type BreakoutPointProps, type BreakoutProps, type BusFanoutDirection, type BusName, type BusProps, type CadAssemblyProps, type CadAssemblyPropsInput, type CadModelAxisDirection, type CadModelBase, type CadModelFootprinterString, type CadModelGlb, type CadModelGltf, type CadModelJscad, type CadModelObj, type CadModelProp, type CadModelProps, type CadModelPropsInput, type CadModelStep, type CadModelStl, type CadModelWrl, type CapacitorPinLabels, type CapacitorProps, type ChipConnections, type ChipPinLabels, type ChipProps, type ChipPropsSU, type CircleCutoutProps, type CircleEnclosureCutoutApertureProps, type CircleHoleProps, type CirclePlatedHoleProps, type CircleShapeProps, type CircleSmtPadProps, type CircleSolderPasteProps, type CircuitJson, type CircularHoleWithRectPlatedProps, type CommonComponentProps, type CommonLayoutProps, type CommonShapeProps, type ComponentProps, type ConnectionTarget, type Connections, type ConnectorProps, type ConstrainedLayoutProps, type ConstraintProps, type CopperPourProps, type CopperPourPropsInput, type CopperTextProps, type CourtyardCircleProps, type CourtyardOutlineProps, type CourtyardPillProps, type CourtyardRectProps, type CrystalPinLabels, type CrystalProps, type CurrentSourcePinLabels, type CurrentSourceProps, type CustomDrcCheckContext, type CustomDrcCheckFn, type CustomDrcCheckInput, type CustomDrcConnectable, type CustomDrcSelect, type CustomDrcSelectAll, type CutoutProps, type CutoutPropsInput, type DifferentialPairProps, type DiodePinLabels, type DiodePinLabelsProp, type DiodeProps, type Direction, type DirectionAlongEdge, type DirectionalFanoutBoundaryPadding, type DrcCheckProps, type EditPcbComponentLocationEvent, type EditPcbComponentLocationEventInput, type EditPcbGroupLocationEvent, type EditPcbGroupLocationEventInput, type EditSchematicComponentLocationEvent, type EditSchematicComponentLocationEventInput, type EditSchematicGroupLocationEvent, type EditSchematicGroupLocationEventInput, type EditTraceHintEvent, type EditTraceHintEventInput, type EnclosureCutoutApertureProps, type EnclosureCutoutApertureShape, type EnclosureFdmBoxProps, type EnclosureFdmBoxPropsInput, type FabricationNoteDimensionProps, type FabricationNoteDimensionPropsInput, type FabricationNotePathProps, type FabricationNoteRectProps, type FabricationNoteTextProps, type FabricationNoteTextPropsInput, type FanoutBoundaryPadding, type FanoutPourNetMap, type FanoutProps, type FiducialProps, type FootprintFileParserEntry, type FootprintInsertionDirection, type FootprintLibraryResult, type FootprintProp, type FootprintProps, type FootprintPropsInput, type FootprintSoupElements, type FootprinterAutocompleteString, type FootprinterStringExample, type FusePinLabels, type FuseProps, type GroupProps, type HoleProps, type HoleWithPolygonPadPlatedHoleProps, type InductorPinLabels, type InductorProps, type InferredChipProps, type InferredConstrainedLayoutProps, type InferredDiodeProps, type InferredFuseProps, type InferredHoleProps, type InferredSchematicArcProps, type InferredSchematicBoxProps, type InferredSchematicCircleProps, type InferredSchematicLineProps, type InferredSchematicPathProps, type InferredSchematicRectProps, type InferredSchematicSectionProps, type InferredSchematicSheetProps, type InferredSchematicSymbolProps, type InferredSchematicTextProps, type InferredSmtPadProps, type InferredSolderPasteProps, type InferredSwitchProps, type InferredTestpointProps, type InferredViaProps, type InterconnectProps, type InternalCircuitElement, type InternalCircuitProps, type JlcpcbAutocompleteStringPath, type JlcpcbKnownPartNumber, type JumperProps, type KicadAt, type KicadAutocompleteStringPath, type KicadEffects, type KicadFont, type KicadFootprintAttributes, type KicadFootprintMetadata, type KicadFootprintModel, type KicadFootprintPad, type KicadFootprintProperties, type KicadPath, type KicadPinElectricalType, type KicadPinGraphicStyle, type KicadPinMetadata, type KicadProperty, type KicadSymbolEffects, type KicadSymbolMetadata, type KicadSymbolPinNames, type KicadSymbolPinNumbers, type KicadSymbolProperties, type KicadSymbolProperty, type LayoutConfig, type LedPinLabels, type LedProps, type ManualEditEvent, type ManualEditEventInput, type ManualEditsFile, type ManualEditsFileInput, type ManualPcbPlacement, type ManualPcbPlacementInput, type ManualSchematicPlacement, type ManualSchematicPlacementInput, type ManualTraceHint, type ManualTraceHintInput, type MosfetPinLabels, type MosfetProps, type MountedBoardProps, type NetAliasProps, type NetLabelProps, type NetProps, type NinePointAnchor, type NonSubcircuitGroupProps, type OpAmpPinLabels, type OpAmpProps, type OvalHoleProps, type OvalPlatedHoleProps, type PanelProps, type ParsedEnclosureCutoutApertureProps, type PartsEngine, type PcbKeepoutProps, type PcbLayoutProps, type PcbNoteDimensionProps, type PcbNoteDimensionPropsInput, type PcbNoteLineProps, type PcbNoteLinePropsInput, type PcbNotePathProps, type PcbNotePathPropsInput, type PcbNoteRectProps, type PcbNoteRectPropsInput, type PcbNoteTextProps, type PcbNoteTextPropsInput, type PcbPositionMode, type PcbRouteCache, type PcbSameXConstraint, type PcbSameYConstraint, type PcbStyle, type PcbSx, type PcbSxSelector, type PcbSxValue, type PcbTraceProps, type PcbXDistConstraint, type PcbYDistConstraint, type PillEnclosureCutoutApertureProps, type PillHoleProps, type PillPlatedHoleProps, type PillShapeProps, type PillSmtPadProps, type PillWithRectPadPlatedHoleProps, type PinAttributeMap, type PinCapability, type PinCompatibleVariant, type PinHeaderProps, type PinLabelFromPinLabelMap, type PinLabelsProp, type PinSideDefinition, type PinSideDefinitionInput, type PinVariant, type PinoutProps, type PlatedHoleProps, type PlatformConfig, type PolygonCutoutProps, type PolygonSmtPadProps, type PortHints, type PortProps, type PositionMode, type PotentiometerPinLabels, type PotentiometerPinVariant, type PotentiometerProps, type PowerSourceProps, type ProjectConfig, type PushButtonProps, type RectCutoutProps, type RectEnclosureCutoutApertureProps, type RectHoleProps, type RectShapeProps, type RectSmtPadProps, type RectSolderPasteProps, type ResistorPinLabels, type ResistorProps, type ResonatorPinVariant, type ResonatorProps, type RotatedRectSmtPadProps, type RoutingTolerances, type SchStyle, type SchematicArcProps, type SchematicBoxProps, type SchematicCellProps, type SchematicCircleProps, type SchematicLineProps, type SchematicOrientation, type SchematicPathProps, type SchematicPinArrangement, type SchematicPinArrangementWithPinCounts, type SchematicPinArrangementWithSides, type SchematicPinArrangementWithSizes, type SchematicPinLabel, type SchematicPinStyle, type SchematicPortArrangement, type SchematicPortArrangementWithPinCounts, type SchematicPortArrangementWithSides, type SchematicPortArrangementWithSizes, type SchematicRectProps, type SchematicRowProps, type SchematicSectionProps, type SchematicSheetProps, type SchematicSymbolProps, type SchematicSymbolSize, type SchematicTableProps, type SchematicTextProps, type SelectionResult, type SelectionResultComponent, type SelectionResultNet, type SelectionResultPort, type Selectors, type SilkscreenCircleProps, type SilkscreenGraphicProps, type SilkscreenLineProps, type SilkscreenPathProps, type SilkscreenRectProps, type SilkscreenTextProps, type SimpleRouteJson, type SmtPadProps, type SolderJumperProps, type SolderPasteProps, type SpiceEngine, type SpiceEngineSimulationResult, type SpiceModelElement, type SpiceModelProps, type SpiceOptions, type StampboardProps, type SubcircuitGroupProps, type SubcircuitGroupPropsWithBool, type SubcircuitProps, type SubpanelProps, type SupplierName, type SupplierPartNumbers, type SupplierProps, type SwitchProps, type SymbolProp, type SymbolProps, type SymbolPropsInput, type TestpointConnections, type TestpointPinLabels, type TestpointProps, type ToolingrailProps, type TraceHintProps, type TraceProps, type TransistorPinLabels, type TransistorProps, type ViaProps, type VoltageProbeProps, type VoltageSourcePinLabels, type VoltageSourceProps, type WaveShape, ammeterPinLabels, ammeterPins, ammeterProps, analogAcSweepSimulationProps, analogAnalysisSimulationBaseProps, analogCapacitanceSweepParameterProps, analogCurrentSweepParameterProps, analogDcOperatingPointSimulationProps, analogDcSweepSimulationProps, analogInductanceSweepParameterProps, analogResistanceSweepParameterProps, analogSimulationProps, analogSweepParameterProps, analogTransientSimulationProps, analogVoltageSweepParameterProps, assemblyDeviceProps, assemblyProps, autorouterConfig, autorouterEffortLevel, autorouterPreset, autorouterProp, autoroutingPhaseProps, baseGroupProps, base_manual_edit_event, batteryPins, batteryProps, boardProps, border, breakoutPointProps, breakoutProps, bugProps, busFanoutDirection, busProps, cadModelAxisDirection, cadModelAxisDirections, cadModelBase, cadModelGlb, cadModelGltf, cadModelJscad, cadModelObj, cadModelProp, cadModelStep, cadModelStl, cadModelWrl, cadassemblyProps, cadmodelProps, capacitorPinLabels, capacitorPins, capacitorProps, chipProps, circleCutoutProps, circleShapeProps, circleSmtPadProps, circleSolderPasteProps, commonComponentProps, commonLayoutProps, commonShapeProps, componentProps, connectorProps, constrainedLayoutProps, constraintProps, copperPourProps, copperTextProps, courtyardCircleProps, courtyardOutlineProps, courtyardPillProps, courtyardRectProps, crystalPins, crystalProps, currentSourcePinLabels, currentSourcePins, currentSourceProps, customDrcCheckFn, cutoutProps, differentialPairProps, diodePins, diodeProps, direction, directionAlongEdge, distanceOrMultiplier, drcCheckProps, edit_component_location_event, edit_pcb_component_location_event, edit_pcb_group_location_event, edit_schematic_component_location_event, edit_schematic_group_location_event, edit_trace_hint_event, enclosureCutoutApertureProps, enclosureCutoutApertureShapes, enclosureFdmBoxProps, enclosureProps, explicitPinSideDefinition, fabricationNoteDimensionProps, fabricationNotePathProps, fabricationNoteRectProps, fabricationNoteTextProps, fanoutBoundaryPadding, fanoutProps, fiducialProps, footprintInsertionDirection, footprintProp, footprintProps, footprinterStringExamples, fusePinLabels, fuseProps, groupProps, holeProps, inductorPins, inductorProps, interconnectProps, internalCircuitProps, jumperProps, kicadAt, kicadEffects, kicadFont, kicadFootprintAttributes, kicadFootprintKeys, kicadFootprintMetadata, kicadFootprintModel, kicadFootprintPad, kicadFootprintProperties, kicadFootprintStrings, kicadPinElectricalType, kicadPinGraphicStyle, kicadPinMetadata, kicadProperty, kicadSymbolEffects, kicadSymbolMetadata, kicadSymbolPinNames, kicadSymbolPinNumbers, kicadSymbolProperties, kicadSymbolProperty, layoutConfig, ledPins, ledProps, lrPins, lrPolarPins, manual_edit_event, manual_edits_file, manual_pcb_placement, manual_schematic_placement, manual_trace_hint, mosfetPins, mosfetProps, mountedboardProps, netAliasProps, netLabelProps, netProps, ninePointAnchor, opampPinLabels, opampPins, opampProps, panelProps, partsEngine, pcbKeepoutProps, pcbLayoutProps, pcbNoteDimensionProps, pcbNoteLineProps, pcbNotePathProps, pcbNoteRectProps, pcbNoteTextProps, pcbSameXConstraintProps, pcbSameYConstraintProps, pcbStyle, pcbSx, pcbSxValue, pcbTraceProps, pcbXDistConstraintProps, pcbYDistConstraintProps, pillShapeProps, pillSmtPadProps, pinAttributeMap, pinCapability, pinCompatibleVariant, pinHeaderProps, pinLabelsProp, pinoutProps, platedHoleProps, platformConfig, point3, polygonCutoutProps, polygonSmtPadProps, portHints, portProps, portRef, potentiometerPinLabels, potentiometerProps, powerSourceProps, projectConfig, pushButtonProps, rectCutoutProps, rectShapeProps, rectSmtPadProps, rectSolderPasteProps, resistorPinLabels, resistorPins, resistorProps, resonatorProps, rotatedRectSmtPadProps, rotationPoint3, routeHintPointProps, routingTolerances, schStyle, schematicArcProps, schematicBoxProps, schematicCellProps, schematicCircleProps, schematicLineProps, schematicOrientation, schematicPathProps, schematicPinArrangement, schematicPinLabel, schematicPinStyle, schematicPortArrangement, schematicRectProps, schematicRowProps, schematicSectionProps, schematicSheetProps, schematicSymbolProps, schematicSymbolSize, schematicTableProps, schematicTextProps, silkscreenCircleProps, silkscreenGraphicProps, silkscreenLineProps, silkscreenPathProps, silkscreenRectProps, silkscreenTextProps, smtPadProps, solderPasteProps, solderjumperProps, spicemodelProps, stampboardProps, subcircuitGroupProps, subcircuitGroupPropsWithBool, subcircuitProps, subpanelProps, supplierProps, switchProps, symbolProp, symbolProps, testpointPins, testpointProps, toolingrailProps, traceHintProps, traceProps, transistorPins, transistorPinsLabels, transistorProps, viaProps, voltageProbeProps, voltageSourcePinLabels, voltageSourcePins, voltageSourceProps };
+export { type AmmeterPinLabels, type AmmeterProps, type AnalogAcSweepSimulationProps, type AnalogAnalysisSimulationBaseProps, type AnalogCapacitanceSweepParameterProps, type AnalogCurrentSweepParameterProps, type AnalogDcOperatingPointSimulationProps, type AnalogDcSweepSimulationProps, type AnalogInductanceSweepParameterProps, type AnalogResistanceSweepParameterProps, type AnalogSimulationProps, type AnalogSweepParameterProps, type AnalogTransientSimulationProps, type AnalogVoltageSweepParameterProps, type AssemblyDeviceProps, type AssemblyDevicePropsInput, type AutocompleteString, type AutorouterConfig, type AutorouterDefinition, type AutorouterInstance, type AutorouterPreset, type AutorouterProp, type AutoroutingPhaseProps, type BaseGroupProps, type BaseManualEditEvent, type BaseManualEditEventInput, type BasicFootprint, type BatteryPinLabels, type BatteryProps, type BoardColor, type BoardColorPreset, type BoardProps, type Border, type BreakoutPointProps, type BreakoutProps, type BusFanoutDirection, type BusName, type BusProps, type CadAssemblyProps, type CadAssemblyPropsInput, type CadModelAxisDirection, type CadModelBase, type CadModelFootprinterString, type CadModelGlb, type CadModelGltf, type CadModelJscad, type CadModelObj, type CadModelProp, type CadModelProps, type CadModelPropsInput, type CadModelStep, type CadModelStl, type CadModelWrl, type CapacitorPinLabels, type CapacitorProps, type ChipConnections, type ChipPinLabels, type ChipProps, type ChipPropsSU, type CircleCutoutProps, type CircleEnclosureCutoutApertureProps, type CircleHoleProps, type CirclePlatedHoleProps, type CircleShapeProps, type CircleSmtPadProps, type CircleSolderPasteProps, type CircuitJson, type CircularHoleWithRectPlatedProps, type CommonComponentProps, type CommonLayoutProps, type CommonShapeProps, type ComponentProps, type ConnectionTarget, type Connections, type ConnectorProps, type ConstrainedLayoutProps, type ConstraintProps, type CopperPourProps, type CopperPourPropsInput, type CopperTextProps, type CourtyardCircleProps, type CourtyardOutlineProps, type CourtyardPillProps, type CourtyardRectProps, type CrystalPinLabels, type CrystalProps, type CurrentSourcePinLabels, type CurrentSourceProps, type CustomDrcCheckContext, type CustomDrcCheckFn, type CustomDrcCheckInput, type CustomDrcConnectable, type CustomDrcSelect, type CustomDrcSelectAll, type CutoutProps, type CutoutPropsInput, type DifferentialPairProps, type DiodePinLabels, type DiodePinLabelsProp, type DiodeProps, type Direction, type DirectionAlongEdge, type DirectionalFanoutBoundaryPadding, type DrcCheckProps, type EditPcbComponentLocationEvent, type EditPcbComponentLocationEventInput, type EditPcbGroupLocationEvent, type EditPcbGroupLocationEventInput, type EditSchematicComponentLocationEvent, type EditSchematicComponentLocationEventInput, type EditSchematicGroupLocationEvent, type EditSchematicGroupLocationEventInput, type EditTraceHintEvent, type EditTraceHintEventInput, type EnclosureCutoutApertureProps, type EnclosureCutoutApertureShape, type EnclosureFdmBoxProps, type EnclosureFdmBoxPropsInput, type FabricationNoteDimensionProps, type FabricationNoteDimensionPropsInput, type FabricationNotePathProps, type FabricationNoteRectProps, type FabricationNoteTextProps, type FabricationNoteTextPropsInput, type FanoutBoundaryPadding, type FanoutPourNetMap, type FanoutProps, type FiducialProps, type FootprintFileParserEntry, type FootprintInsertionDirection, type FootprintLibraryResult, type FootprintProp, type FootprintProps, type FootprintPropsInput, type FootprintSoupElements, type FootprinterAutocompleteString, type FootprinterStringExample, type FusePinLabels, type FuseProps, type GroupProps, type HoleProps, type HoleWithPolygonPadPlatedHoleProps, type InductorPinLabels, type InductorProps, type InferredChipProps, type InferredConstrainedLayoutProps, type InferredDiodeProps, type InferredFuseProps, type InferredHoleProps, type InferredSchematicArcProps, type InferredSchematicBoxProps, type InferredSchematicCircleProps, type InferredSchematicLineProps, type InferredSchematicPathProps, type InferredSchematicRectProps, type InferredSchematicSectionProps, type InferredSchematicSheetProps, type InferredSchematicSymbolProps, type InferredSchematicTextProps, type InferredSmtPadProps, type InferredSolderPasteProps, type InferredSwitchProps, type InferredTestpointProps, type InferredViaProps, type InterconnectProps, type InternalCircuitElement, type InternalCircuitProps, type JlcpcbAutocompleteStringPath, type JlcpcbKnownPartNumber, type JumperProps, type KicadAt, type KicadAutocompleteStringPath, type KicadEffects, type KicadFont, type KicadFootprintAttributes, type KicadFootprintMetadata, type KicadFootprintModel, type KicadFootprintPad, type KicadFootprintProperties, type KicadPath, type KicadPinElectricalType, type KicadPinGraphicStyle, type KicadPinMetadata, type KicadProperty, type KicadSymbolEffects, type KicadSymbolMetadata, type KicadSymbolPinNames, type KicadSymbolPinNumbers, type KicadSymbolProperties, type KicadSymbolProperty, type LayoutConfig, type LedPinLabels, type LedProps, type ManualEditEvent, type ManualEditEventInput, type ManualEditsFile, type ManualEditsFileInput, type ManualPcbPlacement, type ManualPcbPlacementInput, type ManualSchematicPlacement, type ManualSchematicPlacementInput, type ManualTraceHint, type ManualTraceHintInput, type MosfetPinLabels, type MosfetProps, type MountedBoardProps, type NetAliasProps, type NetLabelProps, type NetProps, type NinePointAnchor, type NonSubcircuitGroupProps, type OpAmpPinLabels, type OpAmpProps, type OvalHoleProps, type OvalPlatedHoleProps, type PanelProps, type ParsedEnclosureCutoutApertureProps, type PartsEngine, type PcbKeepoutProps, type PcbLayoutProps, type PcbNoteDimensionProps, type PcbNoteDimensionPropsInput, type PcbNoteLineProps, type PcbNoteLinePropsInput, type PcbNotePathProps, type PcbNotePathPropsInput, type PcbNoteRectProps, type PcbNoteRectPropsInput, type PcbNoteTextProps, type PcbNoteTextPropsInput, type PcbPositionMode, type PcbRouteCache, type PcbSameXConstraint, type PcbSameYConstraint, type PcbStyle, type PcbSx, type PcbSxSelector, type PcbSxValue, type PcbTraceProps, type PcbXDistConstraint, type PcbYDistConstraint, type PillEnclosureCutoutApertureProps, type PillHoleProps, type PillPlatedHoleProps, type PillShapeProps, type PillSmtPadProps, type PillWithRectPadPlatedHoleProps, type PinAttributeMap, type PinCapability, type PinCompatibleVariant, type PinHeaderProps, type PinLabelFromPinLabelMap, type PinLabelsProp, type PinSideDefinition, type PinSideDefinitionInput, type PinVariant, type PinoutProps, type PlatedHoleProps, type PlatformConfig, type PolygonCutoutProps, type PolygonSmtPadProps, type PortHints, type PortProps, type PositionMode, type PotentiometerPinLabels, type PotentiometerPinVariant, type PotentiometerProps, type PowerSourceProps, type ProjectConfig, type PushButtonProps, type RectCutoutProps, type RectEnclosureCutoutApertureProps, type RectHoleProps, type RectShapeProps, type RectSmtPadProps, type RectSolderPasteProps, type ResistorPinLabels, type ResistorProps, type ResonatorPinVariant, type ResonatorProps, type RotatedRectSmtPadProps, type RoutingTolerances, type SchStyle, type SchematicArcProps, type SchematicBoxProps, type SchematicCellProps, type SchematicCircleProps, type SchematicLineProps, type SchematicOrientation, type SchematicPathProps, type SchematicPinArrangement, type SchematicPinArrangementWithPinCounts, type SchematicPinArrangementWithSides, type SchematicPinArrangementWithSizes, type SchematicPinLabel, type SchematicPinStyle, type SchematicPortArrangement, type SchematicPortArrangementWithPinCounts, type SchematicPortArrangementWithSides, type SchematicPortArrangementWithSizes, type SchematicRectProps, type SchematicRowProps, type SchematicSectionProps, type SchematicSheetProps, type SchematicSymbolProps, type SchematicSymbolSize, type SchematicTableProps, type SchematicTextProps, type SelectionResult, type SelectionResultComponent, type SelectionResultNet, type SelectionResultPort, type Selectors, type SilkscreenCircleProps, type SilkscreenGraphicProps, type SilkscreenLineProps, type SilkscreenPathProps, type SilkscreenRectProps, type SilkscreenTextProps, type SimpleRouteJson, type SmtPadProps, type SolderJumperProps, type SolderPasteProps, type SpiceEngine, type SpiceEngineSimulationResult, type SpiceModelElement, type SpiceModelProps, type SpiceOptions, type StampboardProps, type SubcircuitGroupProps, type SubcircuitGroupPropsWithBool, type SubcircuitProps, type SubpanelProps, type SupplierName, type SupplierPartNumbers, type SupplierProps, type SwitchProps, type SymbolProp, type SymbolProps, type SymbolPropsInput, type TestpointConnections, type TestpointPinLabels, type TestpointProps, type ToolingrailProps, type TraceHintProps, type TraceProps, type TransistorPinLabels, type TransistorProps, type ViaProps, type VoltageProbeProps, type VoltageSourcePinLabels, type VoltageSourceProps, type WaveShape, ammeterPinLabels, ammeterPins, ammeterProps, analogAcSweepSimulationProps, analogAnalysisSimulationBaseProps, analogCapacitanceSweepParameterProps, analogCurrentSweepParameterProps, analogDcOperatingPointSimulationProps, analogDcSweepSimulationProps, analogInductanceSweepParameterProps, analogResistanceSweepParameterProps, analogSimulationProps, analogSweepParameterProps, analogTransientSimulationProps, analogVoltageSweepParameterProps, assemblyDeviceProps, assemblyProps, autorouterConfig, autorouterEffortLevel, autorouterPreset, autorouterProp, autoroutingPhaseProps, baseGroupProps, base_manual_edit_event, batteryPins, batteryProps, boardProps, border, breakoutPointProps, breakoutProps, bugProps, busFanoutDirection, busProps, cadModelAxisDirection, cadModelAxisDirections, cadModelBase, cadModelGlb, cadModelGltf, cadModelJscad, cadModelObj, cadModelProp, cadModelStep, cadModelStl, cadModelWrl, cadassemblyProps, cadmodelProps, capacitorPinLabels, capacitorPins, capacitorProps, chipProps, circleCutoutProps, circleShapeProps, circleSmtPadProps, circleSolderPasteProps, commonComponentProps, commonLayoutProps, commonShapeProps, componentProps, connectorProps, constrainedLayoutProps, constraintProps, copperPourProps, copperTextProps, courtyardCircleProps, courtyardOutlineProps, courtyardPillProps, courtyardRectProps, crystalPins, crystalProps, currentSourcePinLabels, currentSourcePins, currentSourceProps, customDrcCheckFn, cutoutProps, differentialPairProps, diodePinLabelsProp, diodePins, diodeProps, direction, directionAlongEdge, distanceOrMultiplier, drcCheckProps, edit_component_location_event, edit_pcb_component_location_event, edit_pcb_group_location_event, edit_schematic_component_location_event, edit_schematic_group_location_event, edit_trace_hint_event, enclosureCutoutApertureProps, enclosureCutoutApertureShapes, enclosureFdmBoxProps, enclosureProps, explicitPinSideDefinition, fabricationNoteDimensionProps, fabricationNotePathProps, fabricationNoteRectProps, fabricationNoteTextProps, fanoutBoundaryPadding, fanoutProps, fiducialProps, footprintInsertionDirection, footprintProp, footprintProps, footprinterStringExamples, fusePinLabels, fuseProps, groupProps, holeProps, inductorPins, inductorProps, interconnectProps, internalCircuitProps, jumperProps, kicadAt, kicadEffects, kicadFont, kicadFootprintAttributes, kicadFootprintKeys, kicadFootprintMetadata, kicadFootprintModel, kicadFootprintPad, kicadFootprintProperties, kicadFootprintStrings, kicadPinElectricalType, kicadPinGraphicStyle, kicadPinMetadata, kicadProperty, kicadSymbolEffects, kicadSymbolMetadata, kicadSymbolPinNames, kicadSymbolPinNumbers, kicadSymbolProperties, kicadSymbolProperty, layoutConfig, ledPins, ledProps, lrPins, lrPolarPins, manual_edit_event, manual_edits_file, manual_pcb_placement, manual_schematic_placement, manual_trace_hint, mosfetPins, mosfetProps, mountedboardProps, netAliasProps, netLabelProps, netProps, ninePointAnchor, opampPinLabels, opampPins, opampProps, panelProps, partsEngine, pcbKeepoutProps, pcbLayoutProps, pcbNoteDimensionProps, pcbNoteLineProps, pcbNotePathProps, pcbNoteRectProps, pcbNoteTextProps, pcbSameXConstraintProps, pcbSameYConstraintProps, pcbStyle, pcbSx, pcbSxValue, pcbTraceProps, pcbXDistConstraintProps, pcbYDistConstraintProps, pillShapeProps, pillSmtPadProps, pinAttributeMap, pinCapability, pinCompatibleVariant, pinHeaderProps, pinLabelsProp, pinoutProps, platedHoleProps, platformConfig, point3, polygonCutoutProps, polygonSmtPadProps, portHints, portProps, portRef, potentiometerPinLabels, potentiometerProps, powerSourceProps, projectConfig, pushButtonProps, rectCutoutProps, rectShapeProps, rectSmtPadProps, rectSolderPasteProps, resistorPinLabels, resistorPins, resistorProps, resonatorProps, rotatedRectSmtPadProps, rotationPoint3, routeHintPointProps, routingTolerances, schStyle, schematicArcProps, schematicBoxProps, schematicCellProps, schematicCircleProps, schematicLineProps, schematicOrientation, schematicPathProps, schematicPinArrangement, schematicPinLabel, schematicPinStyle, schematicPortArrangement, schematicRectProps, schematicRowProps, schematicSectionProps, schematicSheetProps, schematicSymbolProps, schematicSymbolSize, schematicTableProps, schematicTextProps, silkscreenCircleProps, silkscreenGraphicProps, silkscreenLineProps, silkscreenPathProps, silkscreenRectProps, silkscreenTextProps, smtPadProps, solderPasteProps, solderjumperProps, spicemodelProps, stampboardProps, subcircuitGroupProps, subcircuitGroupPropsWithBool, subcircuitProps, subpanelProps, supplierProps, switchProps, symbolProp, symbolProps, testpointPins, testpointProps, toolingrailProps, traceHintProps, traceProps, transistorPins, transistorPinsLabels, transistorProps, viaProps, voltageProbeProps, voltageSourcePinLabels, voltageSourcePins, voltageSourceProps };

package/dist/index.js

@@ -17405,12 +17405,24 @@ var differentialPairProps = z72.object({
 expectTypesMatch(true);
 
 // lib/components/footprint.ts
-import { layer_ref as layer_ref6 } from "circuit-json";
+import {
+  layer_ref as layer_ref6
+} from "circuit-json";
 import { z as z73 } from "zod";
 var footprintInsertionDirection = z73.enum([
-  "from_above",
   "from_left",
   "from_right",
+  "from_top",
+  "from_bottom",
+  "from_above",
+  "from_below",
+  "from_x_neg",
+  "from_x_pos",
+  "from_y_pos",
+  "from_y_neg",
+  "from_z_pos",
+  "from_z_neg",
+  // Deprecated, accepted so existing sources keep type-checking.
   "from_front",
   "from_back"
 ]);
@@ -17422,7 +17434,7 @@ var footprintProps = z73.object({
   circuitJson: z73.array(z73.any()).optional(),
   src: footprintProp.describe("Can be a footprint or kicad string").optional(),
   insertionDirection: footprintInsertionDirection.optional().describe(
-    "Direction a cable or mating part is inserted into this footprint in its unrotated orientation."
+    "Direction a cable or mating part is attached from, named for the side of the footprint it approaches from, in its unrotated orientation."
   )
 });
 expectTypesMatch(true);
@@ -18015,6 +18027,7 @@ var ledProps = commonComponentProps.extend({
   wavelength: z96.string().optional(),
   schDisplayValue: z96.string().optional(),
   schOrientation: schematicOrientation.optional(),
+  pinLabels: diodePinLabelsProp.optional(),
   connections: createConnectionsProp(lrPolarPins).optional(),
   laser: z96.boolean().optional()
 });
@@ -19070,6 +19083,7 @@ export {
   customDrcCheckFn,
   cutoutProps,
   differentialPairProps,
+  diodePinLabelsProp,
   diodePins,
   diodeProps,
   direction,