circuit-json 0.0.321 → 0.0.323

package/README.md

@@ -1625,7 +1625,6 @@ interface PcbPlatedHoleCircle {
   pcb_port_id?: string
   pcb_plated_hole_id: string
   soldermask_margin?: number
-  is_covered_with_solder_mask?: boolean
 }
 
 interface PcbHolePillWithRectPad {
@@ -2713,17 +2712,19 @@ interface SimulationUnknownExperimentError {
 
 [Source](https://github.com/tscircuit/circuit-json/blob/main/src/simulation/simulation_voltage_probe.ts)
 
-Defines a voltage probe for simulation, connected to a port or a net.
-
 ```typescript
-/** Defines a voltage probe for simulation, connected to a port or a net. */
+/** Defines a voltage probe for simulation. If a reference input is not provided,
+ * it measures against ground. If a reference input is provided, it measures
+ * the differential voltage between two points. */
 interface SimulationVoltageProbe {
   type: "simulation_voltage_probe"
   simulation_voltage_probe_id: string
   source_component_id?: string
   name?: string
-  source_port_id?: string
-  source_net_id?: string
+  signal_input_source_port_id?: string
+  signal_input_source_net_id?: string
+  reference_input_source_port_id?: string
+  reference_input_source_net_id?: string
   subcircuit_id?: string
   color?: string
 }

package/dist/index.d.mts

@@ -1257,7 +1257,6 @@ interface PcbPlatedHoleCircle {
     pcb_port_id?: string;
     pcb_plated_hole_id: string;
     soldermask_margin?: number;
-    is_covered_with_solder_mask?: boolean;
 }
 /**
  * Defines an oval or pill-shaped plated hole on the PCB
@@ -1406,7 +1405,6 @@ declare const pcb_plated_hole: z.ZodUnion<[z.ZodObject<{
     pcb_port_id: z.ZodOptional<z.ZodString>;
     pcb_plated_hole_id: z.ZodDefault<z.ZodOptional<z.ZodString>>;
     soldermask_margin: z.ZodOptional<z.ZodNumber>;
-    is_covered_with_solder_mask: z.ZodOptional<z.ZodBoolean>;
 }, "strip", z.ZodTypeAny, {
     x: number;
     y: number;
@@ -1419,7 +1417,6 @@ declare const pcb_plated_hole: z.ZodUnion<[z.ZodObject<{
     pcb_component_id?: string | undefined;
     subcircuit_id?: string | undefined;
     pcb_group_id?: string | undefined;
-    is_covered_with_solder_mask?: boolean | undefined;
     soldermask_margin?: number | undefined;
     port_hints?: string[] | undefined;
     pcb_port_id?: string | undefined;
@@ -1436,7 +1433,6 @@ declare const pcb_plated_hole: z.ZodUnion<[z.ZodObject<{
     pcb_component_id?: string | undefined;
     subcircuit_id?: string | undefined;
     pcb_group_id?: string | undefined;
-    is_covered_with_solder_mask?: boolean | undefined;
     soldermask_margin?: number | undefined;
     port_hints?: string[] | undefined;
     pcb_port_id?: string | undefined;
@@ -9713,8 +9709,10 @@ declare const simulation_voltage_probe: z.ZodEffects<z.ZodObject<{
     simulation_voltage_probe_id: z.ZodDefault<z.ZodOptional<z.ZodString>>;
     source_component_id: z.ZodOptional<z.ZodString>;
     name: z.ZodOptional<z.ZodString>;
-    source_port_id: z.ZodOptional<z.ZodString>;
-    source_net_id: z.ZodOptional<z.ZodString>;
+    signal_input_source_port_id: z.ZodOptional<z.ZodString>;
+    signal_input_source_net_id: z.ZodOptional<z.ZodString>;
+    reference_input_source_port_id: z.ZodOptional<z.ZodString>;
+    reference_input_source_net_id: z.ZodOptional<z.ZodString>;
     subcircuit_id: z.ZodOptional<z.ZodString>;
     color: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
@@ -9723,48 +9721,60 @@ declare const simulation_voltage_probe: z.ZodEffects<z.ZodObject<{
     name?: string | undefined;
     source_component_id?: string | undefined;
     subcircuit_id?: string | undefined;
-    source_port_id?: string | undefined;
-    source_net_id?: string | undefined;
     color?: string | undefined;
+    signal_input_source_port_id?: string | undefined;
+    signal_input_source_net_id?: string | undefined;
+    reference_input_source_port_id?: string | undefined;
+    reference_input_source_net_id?: string | undefined;
 }, {
     type: "simulation_voltage_probe";
     name?: string | undefined;
     source_component_id?: string | undefined;
     subcircuit_id?: string | undefined;
-    source_port_id?: string | undefined;
-    source_net_id?: string | undefined;
     color?: string | undefined;
     simulation_voltage_probe_id?: string | undefined;
+    signal_input_source_port_id?: string | undefined;
+    signal_input_source_net_id?: string | undefined;
+    reference_input_source_port_id?: string | undefined;
+    reference_input_source_net_id?: string | undefined;
 }>, {
     type: "simulation_voltage_probe";
     simulation_voltage_probe_id: string;
     name?: string | undefined;
     source_component_id?: string | undefined;
     subcircuit_id?: string | undefined;
-    source_port_id?: string | undefined;
-    source_net_id?: string | undefined;
     color?: string | undefined;
+    signal_input_source_port_id?: string | undefined;
+    signal_input_source_net_id?: string | undefined;
+    reference_input_source_port_id?: string | undefined;
+    reference_input_source_net_id?: string | undefined;
 }, {
     type: "simulation_voltage_probe";
     name?: string | undefined;
     source_component_id?: string | undefined;
     subcircuit_id?: string | undefined;
-    source_port_id?: string | undefined;
-    source_net_id?: string | undefined;
     color?: string | undefined;
     simulation_voltage_probe_id?: string | undefined;
+    signal_input_source_port_id?: string | undefined;
+    signal_input_source_net_id?: string | undefined;
+    reference_input_source_port_id?: string | undefined;
+    reference_input_source_net_id?: string | undefined;
 }>;
 type SimulationVoltageProbeInput = z.input<typeof simulation_voltage_probe>;
 /**
- * Defines a voltage probe for simulation, connected to a port or a net.
+ * Defines a voltage probe for simulation. If a reference input is not provided,
+ * it measures against ground. If a reference input is provided, it measures
+ * the differential voltage between two points.
  */
 interface SimulationVoltageProbe {
     type: "simulation_voltage_probe";
     simulation_voltage_probe_id: string;
     source_component_id?: string;
     name?: string;
-    source_port_id?: string;
-    source_net_id?: string;
+    signal_input_source_port_id?: string;
+    signal_input_source_net_id?: string;
+    reference_input_source_port_id?: string;
+    reference_input_source_net_id?: string;
     subcircuit_id?: string;
     color?: string;
 }
@@ -15229,7 +15239,6 @@ declare const any_circuit_element: z.ZodUnion<[z.ZodObject<{
     pcb_port_id: z.ZodOptional<z.ZodString>;
     pcb_plated_hole_id: z.ZodDefault<z.ZodOptional<z.ZodString>>;
     soldermask_margin: z.ZodOptional<z.ZodNumber>;
-    is_covered_with_solder_mask: z.ZodOptional<z.ZodBoolean>;
 }, "strip", z.ZodTypeAny, {
     x: number;
     y: number;
@@ -15242,7 +15251,6 @@ declare const any_circuit_element: z.ZodUnion<[z.ZodObject<{
     pcb_component_id?: string | undefined;
     subcircuit_id?: string | undefined;
     pcb_group_id?: string | undefined;
-    is_covered_with_solder_mask?: boolean | undefined;
     soldermask_margin?: number | undefined;
     port_hints?: string[] | undefined;
     pcb_port_id?: string | undefined;
@@ -15259,7 +15267,6 @@ declare const any_circuit_element: z.ZodUnion<[z.ZodObject<{
     pcb_component_id?: string | undefined;
     subcircuit_id?: string | undefined;
     pcb_group_id?: string | undefined;
-    is_covered_with_solder_mask?: boolean | undefined;
     soldermask_margin?: number | undefined;
     port_hints?: string[] | undefined;
     pcb_port_id?: string | undefined;
@@ -20621,8 +20628,10 @@ declare const any_circuit_element: z.ZodUnion<[z.ZodObject<{
     simulation_voltage_probe_id: z.ZodDefault<z.ZodOptional<z.ZodString>>;
     source_component_id: z.ZodOptional<z.ZodString>;
     name: z.ZodOptional<z.ZodString>;
-    source_port_id: z.ZodOptional<z.ZodString>;
-    source_net_id: z.ZodOptional<z.ZodString>;
+    signal_input_source_port_id: z.ZodOptional<z.ZodString>;
+    signal_input_source_net_id: z.ZodOptional<z.ZodString>;
+    reference_input_source_port_id: z.ZodOptional<z.ZodString>;
+    reference_input_source_net_id: z.ZodOptional<z.ZodString>;
     subcircuit_id: z.ZodOptional<z.ZodString>;
     color: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
@@ -20631,36 +20640,44 @@ declare const any_circuit_element: z.ZodUnion<[z.ZodObject<{
     name?: string | undefined;
     source_component_id?: string | undefined;
     subcircuit_id?: string | undefined;
-    source_port_id?: string | undefined;
-    source_net_id?: string | undefined;
     color?: string | undefined;
+    signal_input_source_port_id?: string | undefined;
+    signal_input_source_net_id?: string | undefined;
+    reference_input_source_port_id?: string | undefined;
+    reference_input_source_net_id?: string | undefined;
 }, {
     type: "simulation_voltage_probe";
     name?: string | undefined;
     source_component_id?: string | undefined;
     subcircuit_id?: string | undefined;
-    source_port_id?: string | undefined;
-    source_net_id?: string | undefined;
     color?: string | undefined;
     simulation_voltage_probe_id?: string | undefined;
+    signal_input_source_port_id?: string | undefined;
+    signal_input_source_net_id?: string | undefined;
+    reference_input_source_port_id?: string | undefined;
+    reference_input_source_net_id?: string | undefined;
 }>, {
     type: "simulation_voltage_probe";
     simulation_voltage_probe_id: string;
     name?: string | undefined;
     source_component_id?: string | undefined;
     subcircuit_id?: string | undefined;
-    source_port_id?: string | undefined;
-    source_net_id?: string | undefined;
     color?: string | undefined;
+    signal_input_source_port_id?: string | undefined;
+    signal_input_source_net_id?: string | undefined;
+    reference_input_source_port_id?: string | undefined;
+    reference_input_source_net_id?: string | undefined;
 }, {
     type: "simulation_voltage_probe";
     name?: string | undefined;
     source_component_id?: string | undefined;
     subcircuit_id?: string | undefined;
-    source_port_id?: string | undefined;
-    source_net_id?: string | undefined;
     color?: string | undefined;
     simulation_voltage_probe_id?: string | undefined;
+    signal_input_source_port_id?: string | undefined;
+    signal_input_source_net_id?: string | undefined;
+    reference_input_source_port_id?: string | undefined;
+    reference_input_source_net_id?: string | undefined;
 }>, z.ZodObject<{
     type: z.ZodLiteral<"simulation_unknown_experiment_error">;
     simulation_unknown_experiment_error_id: z.ZodDefault<z.ZodOptional<z.ZodString>>;
@@ -23166,7 +23183,6 @@ declare const any_soup_element: z.ZodUnion<[z.ZodObject<{
     pcb_port_id: z.ZodOptional<z.ZodString>;
     pcb_plated_hole_id: z.ZodDefault<z.ZodOptional<z.ZodString>>;
     soldermask_margin: z.ZodOptional<z.ZodNumber>;
-    is_covered_with_solder_mask: z.ZodOptional<z.ZodBoolean>;
 }, "strip", z.ZodTypeAny, {
     x: number;
     y: number;
@@ -23179,7 +23195,6 @@ declare const any_soup_element: z.ZodUnion<[z.ZodObject<{
     pcb_component_id?: string | undefined;
     subcircuit_id?: string | undefined;
     pcb_group_id?: string | undefined;
-    is_covered_with_solder_mask?: boolean | undefined;
     soldermask_margin?: number | undefined;
     port_hints?: string[] | undefined;
     pcb_port_id?: string | undefined;
@@ -23196,7 +23211,6 @@ declare const any_soup_element: z.ZodUnion<[z.ZodObject<{
     pcb_component_id?: string | undefined;
     subcircuit_id?: string | undefined;
     pcb_group_id?: string | undefined;
-    is_covered_with_solder_mask?: boolean | undefined;
     soldermask_margin?: number | undefined;
     port_hints?: string[] | undefined;
     pcb_port_id?: string | undefined;
@@ -28558,8 +28572,10 @@ declare const any_soup_element: z.ZodUnion<[z.ZodObject<{
     simulation_voltage_probe_id: z.ZodDefault<z.ZodOptional<z.ZodString>>;
     source_component_id: z.ZodOptional<z.ZodString>;
     name: z.ZodOptional<z.ZodString>;
-    source_port_id: z.ZodOptional<z.ZodString>;
-    source_net_id: z.ZodOptional<z.ZodString>;
+    signal_input_source_port_id: z.ZodOptional<z.ZodString>;
+    signal_input_source_net_id: z.ZodOptional<z.ZodString>;
+    reference_input_source_port_id: z.ZodOptional<z.ZodString>;
+    reference_input_source_net_id: z.ZodOptional<z.ZodString>;
     subcircuit_id: z.ZodOptional<z.ZodString>;
     color: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
@@ -28568,36 +28584,44 @@ declare const any_soup_element: z.ZodUnion<[z.ZodObject<{
     name?: string | undefined;
     source_component_id?: string | undefined;
     subcircuit_id?: string | undefined;
-    source_port_id?: string | undefined;
-    source_net_id?: string | undefined;
     color?: string | undefined;
+    signal_input_source_port_id?: string | undefined;
+    signal_input_source_net_id?: string | undefined;
+    reference_input_source_port_id?: string | undefined;
+    reference_input_source_net_id?: string | undefined;
 }, {
     type: "simulation_voltage_probe";
     name?: string | undefined;
     source_component_id?: string | undefined;
     subcircuit_id?: string | undefined;
-    source_port_id?: string | undefined;
-    source_net_id?: string | undefined;
     color?: string | undefined;
     simulation_voltage_probe_id?: string | undefined;
+    signal_input_source_port_id?: string | undefined;
+    signal_input_source_net_id?: string | undefined;
+    reference_input_source_port_id?: string | undefined;
+    reference_input_source_net_id?: string | undefined;
 }>, {
     type: "simulation_voltage_probe";
     simulation_voltage_probe_id: string;
     name?: string | undefined;
     source_component_id?: string | undefined;
     subcircuit_id?: string | undefined;
-    source_port_id?: string | undefined;
-    source_net_id?: string | undefined;
     color?: string | undefined;
+    signal_input_source_port_id?: string | undefined;
+    signal_input_source_net_id?: string | undefined;
+    reference_input_source_port_id?: string | undefined;
+    reference_input_source_net_id?: string | undefined;
 }, {
     type: "simulation_voltage_probe";
     name?: string | undefined;
     source_component_id?: string | undefined;
     subcircuit_id?: string | undefined;
-    source_port_id?: string | undefined;
-    source_net_id?: string | undefined;
     color?: string | undefined;
     simulation_voltage_probe_id?: string | undefined;
+    signal_input_source_port_id?: string | undefined;
+    signal_input_source_net_id?: string | undefined;
+    reference_input_source_port_id?: string | undefined;
+    reference_input_source_net_id?: string | undefined;
 }>, z.ZodObject<{
     type: z.ZodLiteral<"simulation_unknown_experiment_error">;
     simulation_unknown_experiment_error_id: z.ZodDefault<z.ZodOptional<z.ZodString>>;

package/dist/index.mjs

@@ -1431,8 +1431,7 @@ var pcb_plated_hole_circle = z73.object({
   pcb_component_id: z73.string().optional(),
   pcb_port_id: z73.string().optional(),
   pcb_plated_hole_id: getZodPrefixedIdWithDefault("pcb_plated_hole"),
-  soldermask_margin: z73.number().optional(),
-  is_covered_with_solder_mask: z73.boolean().optional()
+  soldermask_margin: z73.number().optional()
 });
 var pcb_plated_hole_oval = z73.object({
   type: z73.literal("pcb_plated_hole"),
@@ -2891,18 +2890,48 @@ var simulation_voltage_probe = z130.object({
   ),
   source_component_id: z130.string().optional(),
   name: z130.string().optional(),
-  source_port_id: z130.string().optional(),
-  source_net_id: z130.string().optional(),
+  signal_input_source_port_id: z130.string().optional(),
+  signal_input_source_net_id: z130.string().optional(),
+  reference_input_source_port_id: z130.string().optional(),
+  reference_input_source_net_id: z130.string().optional(),
   subcircuit_id: z130.string().optional(),
   color: z130.string().optional()
 }).describe(
-  "Defines a voltage probe for simulation, connected to a port or a net"
-).refine(
-  (data) => Boolean(data.source_port_id) !== Boolean(data.source_net_id),
-  {
-    message: "Exactly one of source_port_id or source_net_id must be provided to simulation_voltage_probe"
+  "Defines a voltage probe for simulation. If a reference input is not provided, it measures against ground. If a reference input is provided, it measures the differential voltage between two points."
+).superRefine((data, ctx) => {
+  const is_differential = data.reference_input_source_port_id || data.reference_input_source_net_id;
+  if (is_differential) {
+    const has_ports = !!data.signal_input_source_port_id || !!data.reference_input_source_port_id;
+    const has_nets = !!data.signal_input_source_net_id || !!data.reference_input_source_net_id;
+    if (has_ports && has_nets) {
+      ctx.addIssue({
+        code: z130.ZodIssueCode.custom,
+        message: "Cannot mix port and net connections in a differential probe."
+      });
+    } else if (has_ports) {
+      if (!data.signal_input_source_port_id || !data.reference_input_source_port_id) {
+        ctx.addIssue({
+          code: z130.ZodIssueCode.custom,
+          message: "Differential port probe requires both signal_input_source_port_id and reference_input_source_port_id."
+        });
+      }
+    } else if (has_nets) {
+      if (!data.signal_input_source_net_id || !data.reference_input_source_net_id) {
+        ctx.addIssue({
+          code: z130.ZodIssueCode.custom,
+          message: "Differential net probe requires both signal_input_source_net_id and reference_input_source_net_id."
+        });
+      }
+    }
+  } else {
+    if (!!data.signal_input_source_port_id === !!data.signal_input_source_net_id) {
+      ctx.addIssue({
+        code: z130.ZodIssueCode.custom,
+        message: "A voltage probe must have exactly one of signal_input_source_port_id or signal_input_source_net_id."
+      });
+    }
   }
-);
+});
 expectTypesMatch(true);
 
 // src/simulation/simulation_unknown_experiment_error.ts