circuit-json 0.0.517 → 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[]
 }
@@ -2068,6 +2073,10 @@ interface PcbFabricationNotePath {
   route: Point[]
   stroke_width: Length
   color?: string
+  /** Fill the route as a closed polygon using color. Defaults to false. */
+  is_filled?: boolean
+  /** Draw the outline using stroke_width and color. Defaults to true. */
+  has_stroke?: boolean
 }
 ```
 

package/dist/index.d.mts

@@ -12260,6 +12260,8 @@ declare const pcb_fabrication_note_path: z.ZodObject<{
     }>, "many">;
     stroke_width: z.ZodEffects<z.ZodUnion<[z.ZodString, z.ZodNumber]>, number, string | number>;
     color: z.ZodOptional<z.ZodString>;
+    is_filled: z.ZodOptional<z.ZodBoolean>;
+    has_stroke: z.ZodOptional<z.ZodBoolean>;
 }, "strip", z.ZodTypeAny, {
     type: "pcb_fabrication_note_path";
     layer: "top" | "bottom" | "inner1" | "inner2" | "inner3" | "inner4" | "inner5" | "inner6" | "inner7" | "inner8";
@@ -12271,6 +12273,8 @@ declare const pcb_fabrication_note_path: z.ZodObject<{
     stroke_width: number;
     pcb_fabrication_note_path_id: string;
     subcircuit_id?: string | undefined;
+    is_filled?: boolean | undefined;
+    has_stroke?: boolean | undefined;
     color?: string | undefined;
 }, {
     type: "pcb_fabrication_note_path";
@@ -12284,6 +12288,8 @@ declare const pcb_fabrication_note_path: z.ZodObject<{
     }[];
     stroke_width: string | number;
     subcircuit_id?: string | undefined;
+    is_filled?: boolean | undefined;
+    has_stroke?: boolean | undefined;
     color?: string | undefined;
     pcb_fabrication_note_path_id?: string | undefined;
 }>;
@@ -12300,6 +12306,10 @@ interface PcbFabricationNotePath {
     route: Point[];
     stroke_width: Length;
     color?: string;
+    /** Fill the route as a closed polygon using color. Defaults to false. */
+    is_filled?: boolean;
+    /** Draw the outline using stroke_width and color. Defaults to true. */
+    has_stroke?: boolean;
 }
 /**
  * @deprecated use PcbFabricationNotePath
@@ -39780,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>;
@@ -39814,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;
@@ -39826,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 {
@@ -39838,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[];
 }
@@ -50689,6 +50766,8 @@ declare const any_circuit_element: z.ZodUnion<[z.ZodObject<{
     }>, "many">;
     stroke_width: z.ZodEffects<z.ZodUnion<[z.ZodString, z.ZodNumber]>, number, string | number>;
     color: z.ZodOptional<z.ZodString>;
+    is_filled: z.ZodOptional<z.ZodBoolean>;
+    has_stroke: z.ZodOptional<z.ZodBoolean>;
 }, "strip", z.ZodTypeAny, {
     type: "pcb_fabrication_note_path";
     layer: "top" | "bottom" | "inner1" | "inner2" | "inner3" | "inner4" | "inner5" | "inner6" | "inner7" | "inner8";
@@ -50700,6 +50779,8 @@ declare const any_circuit_element: z.ZodUnion<[z.ZodObject<{
     stroke_width: number;
     pcb_fabrication_note_path_id: string;
     subcircuit_id?: string | undefined;
+    is_filled?: boolean | undefined;
+    has_stroke?: boolean | undefined;
     color?: string | undefined;
 }, {
     type: "pcb_fabrication_note_path";
@@ -50713,6 +50794,8 @@ declare const any_circuit_element: z.ZodUnion<[z.ZodObject<{
     }[];
     stroke_width: string | number;
     subcircuit_id?: string | undefined;
+    is_filled?: boolean | undefined;
+    has_stroke?: boolean | undefined;
     color?: string | undefined;
     pcb_fabrication_note_path_id?: string | undefined;
 }>, z.ZodObject<{
@@ -60987,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>;
@@ -61021,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;
@@ -61033,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>;
@@ -73269,6 +73414,8 @@ declare const any_soup_element: z.ZodUnion<[z.ZodObject<{
     }>, "many">;
     stroke_width: z.ZodEffects<z.ZodUnion<[z.ZodString, z.ZodNumber]>, number, string | number>;
     color: z.ZodOptional<z.ZodString>;
+    is_filled: z.ZodOptional<z.ZodBoolean>;
+    has_stroke: z.ZodOptional<z.ZodBoolean>;
 }, "strip", z.ZodTypeAny, {
     type: "pcb_fabrication_note_path";
     layer: "top" | "bottom" | "inner1" | "inner2" | "inner3" | "inner4" | "inner5" | "inner6" | "inner7" | "inner8";
@@ -73280,6 +73427,8 @@ declare const any_soup_element: z.ZodUnion<[z.ZodObject<{
     stroke_width: number;
     pcb_fabrication_note_path_id: string;
     subcircuit_id?: string | undefined;
+    is_filled?: boolean | undefined;
+    has_stroke?: boolean | undefined;
     color?: string | undefined;
 }, {
     type: "pcb_fabrication_note_path";
@@ -73293,6 +73442,8 @@ declare const any_soup_element: z.ZodUnion<[z.ZodObject<{
     }[];
     stroke_width: string | number;
     subcircuit_id?: string | undefined;
+    is_filled?: boolean | undefined;
+    has_stroke?: boolean | undefined;
     color?: string | undefined;
     pcb_fabrication_note_path_id?: string | undefined;
 }>, z.ZodObject<{
@@ -83567,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>;
@@ -83601,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;
@@ -83613,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

@@ -3489,7 +3489,9 @@ var pcb_fabrication_note_path = z154.object({
   layer: layer_ref,
   route: z154.array(point),
   stroke_width: length,
-  color: z154.string().optional()
+  color: z154.string().optional(),
+  is_filled: z154.boolean().optional(),
+  has_stroke: z154.boolean().optional()
 }).describe(
   "Defines a fabrication path on the PCB for fabricators or assemblers"
 );
@@ -4436,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.'
   ),