circuit-json 0.0.524 → 0.0.525

package/README.md

@@ -915,6 +915,10 @@ Defines a 3D-printed part in an assembly.
 /** Defines a 3D-printed part in an assembly. */
 interface SourcePrintedPart extends SourceComponentBase {
   ftype: "printedpart"
+  /** Printable material, when specified by the author. */
+  material?: "pla" | "petg" | "nylon"
+  /** Author-specified print color; also carried on the CAD geometry. */
+  color?: string
 }
 ```
 
@@ -1489,6 +1493,7 @@ interface CadCable {
 CAD geometry, optionally associated with a PCB component.
 
 ```typescript
+/** CAD geometry, optionally associated with a PCB component. */
 interface CadComponent {
   type: "cad_component"
   cad_component_id: string
@@ -1497,6 +1502,10 @@ interface CadComponent {
   source_component_id: string
   position: Point3
   rotation?: Point3
+  /** True for assembled folded position/rotation; false or omitted for flat.
+   * PCB records stay flat. pcb_component_id identifies the mount/owning board. */
+
+  is_on_folded_board?: boolean
   size?: Point3
   layer?: LayerRef
   subcircuit_id?: string
@@ -1519,6 +1528,8 @@ interface CadComponent {
     | "bottom_center_of_component"
   model_object_fit: "contain_within_bounds" | "fill_bounds"
   model_jscad?: any
+  /** Explicit CAD color override; omission preserves authored model materials. */
+  color?: string
   show_as_translucent_model?: boolean
   show_as_bounding_box?: boolean
   show_hidden_edges?: boolean

package/dist/index.d.mts

@@ -33374,12 +33374,16 @@ declare const source_printed_part: z.ZodObject<{
     subcircuit_id: z.ZodOptional<z.ZodString>;
 } & {
     ftype: z.ZodLiteral<"printedpart">;
+    material: z.ZodOptional<z.ZodEnum<["pla", "petg", "nylon"]>>;
+    color: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
     type: "source_component";
     name: string;
     source_component_id: string;
     ftype: "printedpart";
     subcircuit_id?: string | undefined;
+    material?: "pla" | "petg" | "nylon" | undefined;
+    color?: string | undefined;
     source_group_id?: string | undefined;
     display_name?: string | undefined;
     manufacturer_part_number?: string | undefined;
@@ -33393,6 +33397,8 @@ declare const source_printed_part: z.ZodObject<{
     source_component_id: string;
     ftype: "printedpart";
     subcircuit_id?: string | undefined;
+    material?: "pla" | "petg" | "nylon" | undefined;
+    color?: string | undefined;
     source_group_id?: string | undefined;
     display_name?: string | undefined;
     manufacturer_part_number?: string | undefined;
@@ -33405,6 +33411,10 @@ type SourcePrintedPartInput = z.input<typeof source_printed_part>;
 /** Defines a 3D-printed part in an assembly. */
 interface SourcePrintedPart extends SourceComponentBase {
     ftype: "printedpart";
+    /** Printable material, when specified by the author. */
+    material?: "pla" | "petg" | "nylon";
+    /** Author-specified print color; also carried on the CAD geometry. */
+    color?: string;
 }
 
 declare const source_subassembly: z.ZodObject<{
@@ -35780,12 +35790,16 @@ declare const any_source_component: z.ZodUnion<[z.ZodObject<{
     subcircuit_id: z.ZodOptional<z.ZodString>;
 } & {
     ftype: z.ZodLiteral<"printedpart">;
+    material: z.ZodOptional<z.ZodEnum<["pla", "petg", "nylon"]>>;
+    color: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
     type: "source_component";
     name: string;
     source_component_id: string;
     ftype: "printedpart";
     subcircuit_id?: string | undefined;
+    material?: "pla" | "petg" | "nylon" | undefined;
+    color?: string | undefined;
     source_group_id?: string | undefined;
     display_name?: string | undefined;
     manufacturer_part_number?: string | undefined;
@@ -35799,6 +35813,8 @@ declare const any_source_component: z.ZodUnion<[z.ZodObject<{
     source_component_id: string;
     ftype: "printedpart";
     subcircuit_id?: string | undefined;
+    material?: "pla" | "petg" | "nylon" | undefined;
+    color?: string | undefined;
     source_group_id?: string | undefined;
     display_name?: string | undefined;
     manufacturer_part_number?: string | undefined;
@@ -41025,6 +41041,7 @@ declare const cad_component: z.ZodObject<{
     model_origin_alignment: z.ZodOptional<z.ZodEnum<["unknown", "center", "center_of_component_on_board_surface", "bottom_center_of_component"]>>;
     model_object_fit: z.ZodDefault<z.ZodOptional<z.ZodEnum<["contain_within_bounds", "fill_bounds"]>>>;
     model_jscad: z.ZodOptional<z.ZodAny>;
+    color: z.ZodOptional<z.ZodString>;
     show_as_translucent_model: z.ZodOptional<z.ZodBoolean>;
     show_as_bounding_box: z.ZodOptional<z.ZodBoolean>;
     show_hidden_edges: z.ZodOptional<z.ZodBoolean>;
@@ -41053,6 +41070,7 @@ declare const cad_component: z.ZodObject<{
     layer?: "top" | "bottom" | "inner1" | "inner2" | "inner3" | "inner4" | "inner5" | "inner6" | "inner7" | "inner8" | undefined;
     pcb_component_id?: string | undefined;
     subcircuit_id?: string | undefined;
+    color?: string | undefined;
     footprinter_string?: string | undefined;
     is_on_folded_board?: boolean | undefined;
     model_obj_url?: string | undefined;
@@ -41104,6 +41122,7 @@ declare const cad_component: z.ZodObject<{
     pcb_component_id?: string | undefined;
     subcircuit_id?: string | undefined;
     anchor_alignment?: "center" | "center_of_component_on_board_surface" | undefined;
+    color?: string | undefined;
     footprinter_string?: string | undefined;
     is_on_folded_board?: boolean | undefined;
     model_obj_url?: string | undefined;
@@ -41166,6 +41185,8 @@ interface CadComponent {
     model_origin_alignment?: "unknown" | "center" | "center_of_component_on_board_surface" | "bottom_center_of_component";
     model_object_fit: "contain_within_bounds" | "fill_bounds";
     model_jscad?: any;
+    /** Explicit CAD color override; omission preserves authored model materials. */
+    color?: string;
     show_as_translucent_model?: boolean;
     show_as_bounding_box?: boolean;
     show_hidden_edges?: boolean;
@@ -42289,12 +42310,16 @@ declare const any_circuit_element: z.ZodUnion<[z.ZodObject<{
     subcircuit_id: z.ZodOptional<z.ZodString>;
 } & {
     ftype: z.ZodLiteral<"printedpart">;
+    material: z.ZodOptional<z.ZodEnum<["pla", "petg", "nylon"]>>;
+    color: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
     type: "source_component";
     name: string;
     source_component_id: string;
     ftype: "printedpart";
     subcircuit_id?: string | undefined;
+    material?: "pla" | "petg" | "nylon" | undefined;
+    color?: string | undefined;
     source_group_id?: string | undefined;
     display_name?: string | undefined;
     manufacturer_part_number?: string | undefined;
@@ -42308,6 +42333,8 @@ declare const any_circuit_element: z.ZodUnion<[z.ZodObject<{
     source_component_id: string;
     ftype: "printedpart";
     subcircuit_id?: string | undefined;
+    material?: "pla" | "petg" | "nylon" | undefined;
+    color?: string | undefined;
     source_group_id?: string | undefined;
     display_name?: string | undefined;
     manufacturer_part_number?: string | undefined;
@@ -62781,6 +62808,7 @@ declare const any_circuit_element: z.ZodUnion<[z.ZodObject<{
     model_origin_alignment: z.ZodOptional<z.ZodEnum<["unknown", "center", "center_of_component_on_board_surface", "bottom_center_of_component"]>>;
     model_object_fit: z.ZodDefault<z.ZodOptional<z.ZodEnum<["contain_within_bounds", "fill_bounds"]>>>;
     model_jscad: z.ZodOptional<z.ZodAny>;
+    color: z.ZodOptional<z.ZodString>;
     show_as_translucent_model: z.ZodOptional<z.ZodBoolean>;
     show_as_bounding_box: z.ZodOptional<z.ZodBoolean>;
     show_hidden_edges: z.ZodOptional<z.ZodBoolean>;
@@ -62809,6 +62837,7 @@ declare const any_circuit_element: z.ZodUnion<[z.ZodObject<{
     layer?: "top" | "bottom" | "inner1" | "inner2" | "inner3" | "inner4" | "inner5" | "inner6" | "inner7" | "inner8" | undefined;
     pcb_component_id?: string | undefined;
     subcircuit_id?: string | undefined;
+    color?: string | undefined;
     footprinter_string?: string | undefined;
     is_on_folded_board?: boolean | undefined;
     model_obj_url?: string | undefined;
@@ -62860,6 +62889,7 @@ declare const any_circuit_element: z.ZodUnion<[z.ZodObject<{
     pcb_component_id?: string | undefined;
     subcircuit_id?: string | undefined;
     anchor_alignment?: "center" | "center_of_component_on_board_surface" | undefined;
+    color?: string | undefined;
     footprinter_string?: string | undefined;
     is_on_folded_board?: boolean | undefined;
     model_obj_url?: string | undefined;
@@ -66073,12 +66103,16 @@ declare const any_soup_element: z.ZodUnion<[z.ZodObject<{
     subcircuit_id: z.ZodOptional<z.ZodString>;
 } & {
     ftype: z.ZodLiteral<"printedpart">;
+    material: z.ZodOptional<z.ZodEnum<["pla", "petg", "nylon"]>>;
+    color: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
     type: "source_component";
     name: string;
     source_component_id: string;
     ftype: "printedpart";
     subcircuit_id?: string | undefined;
+    material?: "pla" | "petg" | "nylon" | undefined;
+    color?: string | undefined;
     source_group_id?: string | undefined;
     display_name?: string | undefined;
     manufacturer_part_number?: string | undefined;
@@ -66092,6 +66126,8 @@ declare const any_soup_element: z.ZodUnion<[z.ZodObject<{
     source_component_id: string;
     ftype: "printedpart";
     subcircuit_id?: string | undefined;
+    material?: "pla" | "petg" | "nylon" | undefined;
+    color?: string | undefined;
     source_group_id?: string | undefined;
     display_name?: string | undefined;
     manufacturer_part_number?: string | undefined;
@@ -86565,6 +86601,7 @@ declare const any_soup_element: z.ZodUnion<[z.ZodObject<{
     model_origin_alignment: z.ZodOptional<z.ZodEnum<["unknown", "center", "center_of_component_on_board_surface", "bottom_center_of_component"]>>;
     model_object_fit: z.ZodDefault<z.ZodOptional<z.ZodEnum<["contain_within_bounds", "fill_bounds"]>>>;
     model_jscad: z.ZodOptional<z.ZodAny>;
+    color: z.ZodOptional<z.ZodString>;
     show_as_translucent_model: z.ZodOptional<z.ZodBoolean>;
     show_as_bounding_box: z.ZodOptional<z.ZodBoolean>;
     show_hidden_edges: z.ZodOptional<z.ZodBoolean>;
@@ -86593,6 +86630,7 @@ declare const any_soup_element: z.ZodUnion<[z.ZodObject<{
     layer?: "top" | "bottom" | "inner1" | "inner2" | "inner3" | "inner4" | "inner5" | "inner6" | "inner7" | "inner8" | undefined;
     pcb_component_id?: string | undefined;
     subcircuit_id?: string | undefined;
+    color?: string | undefined;
     footprinter_string?: string | undefined;
     is_on_folded_board?: boolean | undefined;
     model_obj_url?: string | undefined;
@@ -86644,6 +86682,7 @@ declare const any_soup_element: z.ZodUnion<[z.ZodObject<{
     pcb_component_id?: string | undefined;
     subcircuit_id?: string | undefined;
     anchor_alignment?: "center" | "center_of_component_on_board_surface" | undefined;
+    color?: string | undefined;
     footprinter_string?: string | undefined;
     is_on_folded_board?: boolean | undefined;
     model_obj_url?: string | undefined;

package/dist/index.mjs

@@ -421,7 +421,9 @@ expectTypesMatch(true);
 // src/source/source_printed_part.ts
 import { z as z22 } from "zod";
 var source_printed_part = source_component_base.extend({
-  ftype: z22.literal("printedpart")
+  ftype: z22.literal("printedpart"),
+  material: z22.enum(["pla", "petg", "nylon"]).optional(),
+  color: z22.string().trim().min(1).optional()
 });
 expectTypesMatch(true);
 
@@ -4479,6 +4481,9 @@ var cad_component = z198.object({
   ]).optional(),
   model_object_fit: z198.enum(["contain_within_bounds", "fill_bounds"]).optional().default("contain_within_bounds"),
   model_jscad: z198.any().optional(),
+  color: z198.string().trim().min(1).optional().describe(
+    "Explicit color override for CAD geometry, including authored JSCAD material colors. Omit to preserve model materials."
+  ),
   show_as_translucent_model: z198.boolean().optional(),
   show_as_bounding_box: z198.boolean().optional(),
   show_hidden_edges: z198.boolean().optional(),