circuit-json 0.0.518 → 0.0.519

package/README.md

@@ -1432,7 +1432,10 @@ interface UnknownErrorFindingPart extends BaseCircuitJsonError {
 
 ```typescript
 /** Resolved cable geometry in circuit-world XYZ, mm, +Z up. Path samples are
- * points; first and last are wire exits. Connector poses follow path tangents.
+ * points; first and last are wire exits. Optional pin 1 positions are absolute
+ * points at the connector mating faces, resolved by the circuit producer.
+ * Their transverse offsets from the endpoint centerlines fix connector roll.
+ * Omitted positions preserve legacy parallel-transport orientation.
  * Rendering consumes this path without rerouting or adding sag. */
 interface CadCable {
   type: "cad_cable"
@@ -1440,6 +1443,8 @@ interface CadCable {
   name: string
   from_source_component_id: string
   to_source_component_id: string
+  from_connector_pin1_position?: Point3
+  to_connector_pin1_position?: Point3
   cableprinter_string: string
   path: Point3[]
 }

package/dist/index.d.mts

@@ -39790,6 +39790,48 @@ declare const cad_cable: z.ZodObject<{
     name: z.ZodString;
     from_source_component_id: z.ZodString;
     to_source_component_id: z.ZodString;
+    from_connector_pin1_position: z.ZodOptional<z.ZodEffects<z.ZodObject<{
+        x: z.ZodEffects<z.ZodUnion<[z.ZodString, z.ZodNumber]>, number, string | number>;
+        y: z.ZodEffects<z.ZodUnion<[z.ZodString, z.ZodNumber]>, number, string | number>;
+        z: z.ZodEffects<z.ZodUnion<[z.ZodString, z.ZodNumber]>, number, string | number>;
+    }, "strip", z.ZodTypeAny, {
+        x: number;
+        y: number;
+        z: number;
+    }, {
+        x: string | number;
+        y: string | number;
+        z: string | number;
+    }>, {
+        x: number;
+        y: number;
+        z: number;
+    }, {
+        x: string | number;
+        y: string | number;
+        z: string | number;
+    }>>;
+    to_connector_pin1_position: z.ZodOptional<z.ZodEffects<z.ZodObject<{
+        x: z.ZodEffects<z.ZodUnion<[z.ZodString, z.ZodNumber]>, number, string | number>;
+        y: z.ZodEffects<z.ZodUnion<[z.ZodString, z.ZodNumber]>, number, string | number>;
+        z: z.ZodEffects<z.ZodUnion<[z.ZodString, z.ZodNumber]>, number, string | number>;
+    }, "strip", z.ZodTypeAny, {
+        x: number;
+        y: number;
+        z: number;
+    }, {
+        x: string | number;
+        y: string | number;
+        z: string | number;
+    }>, {
+        x: number;
+        y: number;
+        z: number;
+    }, {
+        x: string | number;
+        y: string | number;
+        z: string | number;
+    }>>;
     cableprinter_string: z.ZodString;
     path: z.ZodEffects<z.ZodArray<z.ZodObject<{
         x: z.ZodEffects<z.ZodUnion<[z.ZodString, z.ZodNumber]>, number, string | number>;
@@ -39824,6 +39866,16 @@ declare const cad_cable: z.ZodObject<{
     from_source_component_id: string;
     to_source_component_id: string;
     cableprinter_string: string;
+    from_connector_pin1_position?: {
+        x: number;
+        y: number;
+        z: number;
+    } | undefined;
+    to_connector_pin1_position?: {
+        x: number;
+        y: number;
+        z: number;
+    } | undefined;
 }, {
     path: {
         x: string | number;
@@ -39836,10 +39888,23 @@ declare const cad_cable: z.ZodObject<{
     from_source_component_id: string;
     to_source_component_id: string;
     cableprinter_string: string;
+    from_connector_pin1_position?: {
+        x: string | number;
+        y: string | number;
+        z: string | number;
+    } | undefined;
+    to_connector_pin1_position?: {
+        x: string | number;
+        y: string | number;
+        z: string | number;
+    } | undefined;
 }>;
 type CadCableInput = z.input<typeof cad_cable>;
 /** Resolved cable geometry in circuit-world XYZ, mm, +Z up. Path samples are
- * points; first and last are wire exits. Connector poses follow path tangents.
+ * points; first and last are wire exits. Optional pin 1 positions are absolute
+ * points at the connector mating faces, resolved by the circuit producer.
+ * Their transverse offsets from the endpoint centerlines fix connector roll.
+ * Omitted positions preserve legacy parallel-transport orientation.
  * Rendering consumes this path without rerouting or adding sag.
  */
 interface CadCable {
@@ -39848,6 +39913,8 @@ interface CadCable {
     name: string;
     from_source_component_id: string;
     to_source_component_id: string;
+    from_connector_pin1_position?: Point3;
+    to_connector_pin1_position?: Point3;
     cableprinter_string: string;
     path: Point3[];
 }
@@ -61003,6 +61070,48 @@ declare const any_circuit_element: z.ZodUnion<[z.ZodObject<{
     name: z.ZodString;
     from_source_component_id: z.ZodString;
     to_source_component_id: z.ZodString;
+    from_connector_pin1_position: z.ZodOptional<z.ZodEffects<z.ZodObject<{
+        x: z.ZodEffects<z.ZodUnion<[z.ZodString, z.ZodNumber]>, number, string | number>;
+        y: z.ZodEffects<z.ZodUnion<[z.ZodString, z.ZodNumber]>, number, string | number>;
+        z: z.ZodEffects<z.ZodUnion<[z.ZodString, z.ZodNumber]>, number, string | number>;
+    }, "strip", z.ZodTypeAny, {
+        x: number;
+        y: number;
+        z: number;
+    }, {
+        x: string | number;
+        y: string | number;
+        z: string | number;
+    }>, {
+        x: number;
+        y: number;
+        z: number;
+    }, {
+        x: string | number;
+        y: string | number;
+        z: string | number;
+    }>>;
+    to_connector_pin1_position: z.ZodOptional<z.ZodEffects<z.ZodObject<{
+        x: z.ZodEffects<z.ZodUnion<[z.ZodString, z.ZodNumber]>, number, string | number>;
+        y: z.ZodEffects<z.ZodUnion<[z.ZodString, z.ZodNumber]>, number, string | number>;
+        z: z.ZodEffects<z.ZodUnion<[z.ZodString, z.ZodNumber]>, number, string | number>;
+    }, "strip", z.ZodTypeAny, {
+        x: number;
+        y: number;
+        z: number;
+    }, {
+        x: string | number;
+        y: string | number;
+        z: string | number;
+    }>, {
+        x: number;
+        y: number;
+        z: number;
+    }, {
+        x: string | number;
+        y: string | number;
+        z: string | number;
+    }>>;
     cableprinter_string: z.ZodString;
     path: z.ZodEffects<z.ZodArray<z.ZodObject<{
         x: z.ZodEffects<z.ZodUnion<[z.ZodString, z.ZodNumber]>, number, string | number>;
@@ -61037,6 +61146,16 @@ declare const any_circuit_element: z.ZodUnion<[z.ZodObject<{
     from_source_component_id: string;
     to_source_component_id: string;
     cableprinter_string: string;
+    from_connector_pin1_position?: {
+        x: number;
+        y: number;
+        z: number;
+    } | undefined;
+    to_connector_pin1_position?: {
+        x: number;
+        y: number;
+        z: number;
+    } | undefined;
 }, {
     path: {
         x: string | number;
@@ -61049,6 +61168,16 @@ declare const any_circuit_element: z.ZodUnion<[z.ZodObject<{
     from_source_component_id: string;
     to_source_component_id: string;
     cableprinter_string: string;
+    from_connector_pin1_position?: {
+        x: string | number;
+        y: string | number;
+        z: string | number;
+    } | undefined;
+    to_connector_pin1_position?: {
+        x: string | number;
+        y: string | number;
+        z: string | number;
+    } | undefined;
 }>, z.ZodObject<{
     message: z.ZodString;
     is_fatal: z.ZodOptional<z.ZodBoolean>;
@@ -83589,6 +83718,48 @@ declare const any_soup_element: z.ZodUnion<[z.ZodObject<{
     name: z.ZodString;
     from_source_component_id: z.ZodString;
     to_source_component_id: z.ZodString;
+    from_connector_pin1_position: z.ZodOptional<z.ZodEffects<z.ZodObject<{
+        x: z.ZodEffects<z.ZodUnion<[z.ZodString, z.ZodNumber]>, number, string | number>;
+        y: z.ZodEffects<z.ZodUnion<[z.ZodString, z.ZodNumber]>, number, string | number>;
+        z: z.ZodEffects<z.ZodUnion<[z.ZodString, z.ZodNumber]>, number, string | number>;
+    }, "strip", z.ZodTypeAny, {
+        x: number;
+        y: number;
+        z: number;
+    }, {
+        x: string | number;
+        y: string | number;
+        z: string | number;
+    }>, {
+        x: number;
+        y: number;
+        z: number;
+    }, {
+        x: string | number;
+        y: string | number;
+        z: string | number;
+    }>>;
+    to_connector_pin1_position: z.ZodOptional<z.ZodEffects<z.ZodObject<{
+        x: z.ZodEffects<z.ZodUnion<[z.ZodString, z.ZodNumber]>, number, string | number>;
+        y: z.ZodEffects<z.ZodUnion<[z.ZodString, z.ZodNumber]>, number, string | number>;
+        z: z.ZodEffects<z.ZodUnion<[z.ZodString, z.ZodNumber]>, number, string | number>;
+    }, "strip", z.ZodTypeAny, {
+        x: number;
+        y: number;
+        z: number;
+    }, {
+        x: string | number;
+        y: string | number;
+        z: string | number;
+    }>, {
+        x: number;
+        y: number;
+        z: number;
+    }, {
+        x: string | number;
+        y: string | number;
+        z: string | number;
+    }>>;
     cableprinter_string: z.ZodString;
     path: z.ZodEffects<z.ZodArray<z.ZodObject<{
         x: z.ZodEffects<z.ZodUnion<[z.ZodString, z.ZodNumber]>, number, string | number>;
@@ -83623,6 +83794,16 @@ declare const any_soup_element: z.ZodUnion<[z.ZodObject<{
     from_source_component_id: string;
     to_source_component_id: string;
     cableprinter_string: string;
+    from_connector_pin1_position?: {
+        x: number;
+        y: number;
+        z: number;
+    } | undefined;
+    to_connector_pin1_position?: {
+        x: number;
+        y: number;
+        z: number;
+    } | undefined;
 }, {
     path: {
         x: string | number;
@@ -83635,6 +83816,16 @@ declare const any_soup_element: z.ZodUnion<[z.ZodObject<{
     from_source_component_id: string;
     to_source_component_id: string;
     cableprinter_string: string;
+    from_connector_pin1_position?: {
+        x: string | number;
+        y: string | number;
+        z: string | number;
+    } | undefined;
+    to_connector_pin1_position?: {
+        x: string | number;
+        y: string | number;
+        z: string | number;
+    } | undefined;
 }>, z.ZodObject<{
     message: z.ZodString;
     is_fatal: z.ZodOptional<z.ZodBoolean>;

package/dist/index.mjs

@@ -4438,12 +4438,20 @@ expectTypesMatch(true);
 
 // src/cad/cad_cable.ts
 import { z as z197 } from "zod";
+var connectorPin1Position = point3.refine(
+  (point2) => [point2.x, point2.y, point2.z].every(Number.isFinite),
+  "Connector pin 1 positions must be finite"
+).describe(
+  "Resolved pin 1 position at the connector mating face, in right-handed circuit world, millimeters: +X right, +Y top, +Z above. An absolute point, not a direction. Computed by the circuit producer from endpoint geometry. Together with the endpoint path tangent, fixes connector roll and identifies its pin 1 side; renderers must not infer it from footprints."
+);
 var cad_cable = z197.object({
   type: z197.literal("cad_cable"),
   cad_cable_id: z197.string(),
   name: z197.string().min(1),
   from_source_component_id: z197.string(),
   to_source_component_id: z197.string(),
+  from_connector_pin1_position: connectorPin1Position.optional(),
+  to_connector_pin1_position: connectorPin1Position.optional(),
   cableprinter_string: z197.string().min(1).describe(
     'Physical cable definition, e.g. "usb_c" or "jst_ph_pins6". Independent of the route.'
   ),