@tscircuit/props 0.0.713 → 0.0.715

package/README.md

@@ -442,6 +442,23 @@ export interface AutoroutingPhaseProps extends RoutingTolerances, FanoutProps {
   // Reroutes traces selected by region or connection. The simplify autorouter
   // may omit a selector to simplify every existing trace in the phase.
   reroute?: boolean;
+  /**
+   * Select the test-point autorouter. Requires reroute=true; omitted/false leaves
+   * existing routing unchanged. Optional connection(s) select traces, otherwise
+   * all routed traces are selected. Conflicts with region, pcbTracePaths,
+   * autorouter and algorithmFn. No alias for the unreleased pcbTestPoints object.
+   */
+  addTestPoints?: boolean;
+  /** Test-point layer; defaults to bottom when addTestPoints is enabled. */
+  testPointLayer?: "top" | "bottom";
+  /** Probe pad diameter, mm or unit string; defaults to 1 mm. Must be positive. */
+  testPointDiameter?: Distance;
+  /** Copper edge clearance, mm or unit string; defaults to 0.2 mm. */
+  testPointClearance?: Distance;
+  /** Minimum probe center spacing, mm or unit string; defaults to 2.54 mm. */
+  testPointMinProbeSpacing?: Distance;
+  /** Maximum local trace detour, mm or unit string; defaults to 1 mm. */
+  testPointMaxDetour?: Distance;
 }
 ```
 

package/dist/index.d.ts

@@ -14973,25 +14973,89 @@ interface AssemblyCableProps {
     standard?: AssemblyCableStandard;
     /** Explicit cable model specification. Omit to infer the cable from its endpoints. */
     model?: string;
+    waypoints?: {
+        x: number;
+        y: number;
+        z: number;
+    }[];
+    /** Reference endpoint for waypoint offsets. Required when waypoints is defined. */
+    waypointAnchor?: "start" | "end";
+    /** Board orientation for waypoint axes. Required when waypoints is defined. */
+    waypointAxisOrientation?: "board_at_start" | "board_at_end";
 }
-declare const assemblyCableProps: z.ZodObject<{
+declare const assemblyCableProps: z.ZodEffects<z.ZodObject<{
     name: z.ZodString;
     from: z.ZodString;
     to: z.ZodString;
     standard: z.ZodOptional<z.ZodLiteral<"usb_c">>;
     model: z.ZodOptional<z.ZodString>;
+    waypoints: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        x: z.ZodNumber;
+        y: z.ZodNumber;
+        z: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        x: number;
+        y: number;
+        z: number;
+    }, {
+        x: number;
+        y: number;
+        z: number;
+    }>, "many">>;
+    waypointAnchor: z.ZodOptional<z.ZodEnum<["start", "end"]>>;
+    waypointAxisOrientation: z.ZodOptional<z.ZodEnum<["board_at_start", "board_at_end"]>>;
 }, "strip", z.ZodTypeAny, {
     name: string;
     from: string;
     to: string;
     model?: string | undefined;
     standard?: "usb_c" | undefined;
+    waypoints?: {
+        x: number;
+        y: number;
+        z: number;
+    }[] | undefined;
+    waypointAnchor?: "start" | "end" | undefined;
+    waypointAxisOrientation?: "board_at_start" | "board_at_end" | undefined;
 }, {
     name: string;
     from: string;
     to: string;
     model?: string | undefined;
     standard?: "usb_c" | undefined;
+    waypoints?: {
+        x: number;
+        y: number;
+        z: number;
+    }[] | undefined;
+    waypointAnchor?: "start" | "end" | undefined;
+    waypointAxisOrientation?: "board_at_start" | "board_at_end" | undefined;
+}>, {
+    name: string;
+    from: string;
+    to: string;
+    model?: string | undefined;
+    standard?: "usb_c" | undefined;
+    waypoints?: {
+        x: number;
+        y: number;
+        z: number;
+    }[] | undefined;
+    waypointAnchor?: "start" | "end" | undefined;
+    waypointAxisOrientation?: "board_at_start" | "board_at_end" | undefined;
+}, {
+    name: string;
+    from: string;
+    to: string;
+    model?: string | undefined;
+    standard?: "usb_c" | undefined;
+    waypoints?: {
+        x: number;
+        y: number;
+        z: number;
+    }[] | undefined;
+    waypointAnchor?: "start" | "end" | undefined;
+    waypointAxisOrientation?: "board_at_start" | "board_at_end" | undefined;
 }>;
 type AssemblyCablePropsInput = z.input<typeof assemblyCableProps>;
 
@@ -33150,24 +33214,79 @@ declare const assemblyProps: {
         mountFace?: string | undefined;
         mountGap?: string | number | undefined;
     }>;
-    readonly cable: zod.ZodObject<{
+    readonly cable: zod.ZodEffects<zod.ZodObject<{
         name: zod.ZodString;
         from: zod.ZodString;
         to: zod.ZodString;
         standard: zod.ZodOptional<zod.ZodLiteral<"usb_c">>;
         model: zod.ZodOptional<zod.ZodString>;
+        waypoints: zod.ZodOptional<zod.ZodArray<zod.ZodObject<{
+            x: zod.ZodNumber;
+            y: zod.ZodNumber;
+            z: zod.ZodNumber;
+        }, "strip", zod.ZodTypeAny, {
+            x: number;
+            y: number;
+            z: number;
+        }, {
+            x: number;
+            y: number;
+            z: number;
+        }>, "many">>;
+        waypointAnchor: zod.ZodOptional<zod.ZodEnum<["start", "end"]>>;
+        waypointAxisOrientation: zod.ZodOptional<zod.ZodEnum<["board_at_start", "board_at_end"]>>;
     }, "strip", zod.ZodTypeAny, {
         name: string;
         from: string;
         to: string;
         model?: string | undefined;
         standard?: "usb_c" | undefined;
+        waypoints?: {
+            x: number;
+            y: number;
+            z: number;
+        }[] | undefined;
+        waypointAnchor?: "start" | "end" | undefined;
+        waypointAxisOrientation?: "board_at_start" | "board_at_end" | undefined;
     }, {
         name: string;
         from: string;
         to: string;
         model?: string | undefined;
         standard?: "usb_c" | undefined;
+        waypoints?: {
+            x: number;
+            y: number;
+            z: number;
+        }[] | undefined;
+        waypointAnchor?: "start" | "end" | undefined;
+        waypointAxisOrientation?: "board_at_start" | "board_at_end" | undefined;
+    }>, {
+        name: string;
+        from: string;
+        to: string;
+        model?: string | undefined;
+        standard?: "usb_c" | undefined;
+        waypoints?: {
+            x: number;
+            y: number;
+            z: number;
+        }[] | undefined;
+        waypointAnchor?: "start" | "end" | undefined;
+        waypointAxisOrientation?: "board_at_start" | "board_at_end" | undefined;
+    }, {
+        name: string;
+        from: string;
+        to: string;
+        model?: string | undefined;
+        standard?: "usb_c" | undefined;
+        waypoints?: {
+            x: number;
+            y: number;
+            z: number;
+        }[] | undefined;
+        waypointAnchor?: "start" | "end" | undefined;
+        waypointAxisOrientation?: "board_at_start" | "board_at_end" | undefined;
     }>;
     readonly device: zod.ZodEffects<zod.ZodObject<{
         name: zod.ZodOptional<zod.ZodString>;
@@ -193152,6 +193271,23 @@ interface AutoroutingPhaseProps extends RoutingTolerances, FanoutProps {
     connection?: string;
     connections?: string[];
     reroute?: boolean;
+    /**
+     * Select the test-point autorouter. Requires reroute=true; omitted/false leaves
+     * existing routing unchanged. Optional connection(s) select traces, otherwise
+     * all routed traces are selected. Conflicts with region, pcbTracePaths,
+     * autorouter and algorithmFn. No alias for the unreleased pcbTestPoints object.
+     */
+    addTestPoints?: boolean;
+    /** Test-point layer; defaults to bottom when addTestPoints is enabled. */
+    testPointLayer?: "top" | "bottom";
+    /** Probe pad diameter, mm or unit string; defaults to 1 mm. Must be positive. */
+    testPointDiameter?: Distance;
+    /** Copper edge clearance, mm or unit string; defaults to 0.2 mm. */
+    testPointClearance?: Distance;
+    /** Minimum probe center spacing, mm or unit string; defaults to 2.54 mm. */
+    testPointMinProbeSpacing?: Distance;
+    /** Maximum local trace detour, mm or unit string; defaults to 1 mm. */
+    testPointMaxDetour?: Distance;
 }
 declare const autoroutingPhaseProps: z.ZodEffects<z.ZodObject<{
     busFanoutDirections: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<[z.ZodEnum<["top_left", "top_center", "top_right", "center_left", "center", "center_right", "bottom_left", "bottom_center", "bottom_right"]>, z.ZodEnum<["topside_left", "topside_center", "topside_right", "rightside_top", "rightside_center", "rightside_bottom", "bottomside_right", "bottomside_center", "bottomside_left", "leftside_bottom", "leftside_center", "leftside_top", "center"]>, z.ZodObject<{
@@ -193217,6 +193353,12 @@ declare const autoroutingPhaseProps: z.ZodEffects<z.ZodObject<{
     connection: z.ZodOptional<z.ZodString>;
     connections: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
     reroute: z.ZodOptional<z.ZodBoolean>;
+    addTestPoints: z.ZodOptional<z.ZodBoolean>;
+    testPointLayer: z.ZodOptional<z.ZodEnum<["top", "bottom"]>>;
+    testPointDiameter: z.ZodOptional<z.ZodPipeline<z.ZodEffects<z.ZodUnion<[z.ZodString, z.ZodNumber]>, number, string | number>, z.ZodNumber>>;
+    testPointClearance: z.ZodOptional<z.ZodPipeline<z.ZodEffects<z.ZodUnion<[z.ZodString, z.ZodNumber]>, number, string | number>, z.ZodNumber>>;
+    testPointMinProbeSpacing: z.ZodOptional<z.ZodPipeline<z.ZodEffects<z.ZodUnion<[z.ZodString, z.ZodNumber]>, number, string | number>, z.ZodNumber>>;
+    testPointMaxDetour: z.ZodOptional<z.ZodPipeline<z.ZodEffects<z.ZodUnion<[z.ZodString, z.ZodNumber]>, number, string | number>, z.ZodNumber>>;
     minTraceWidth: z.ZodOptional<z.ZodEffects<z.ZodUnion<[z.ZodString, z.ZodNumber]>, number, string | number>>;
     minViaHoleEdgeToViaHoleEdgeClearance: z.ZodOptional<z.ZodEffects<z.ZodUnion<[z.ZodString, z.ZodNumber]>, number, string | number>>;
     minViaEdgeToPadEdgeClearance: z.ZodOptional<z.ZodEffects<z.ZodUnion<[z.ZodString, z.ZodNumber]>, number, string | number>>;
@@ -193447,6 +193589,12 @@ declare const autoroutingPhaseProps: z.ZodEffects<z.ZodObject<{
         shape?: "rect" | undefined;
     } | undefined;
     reroute?: boolean | undefined;
+    addTestPoints?: boolean | undefined;
+    testPointLayer?: "top" | "bottom" | undefined;
+    testPointDiameter?: number | undefined;
+    testPointClearance?: number | undefined;
+    testPointMinProbeSpacing?: number | undefined;
+    testPointMaxDetour?: number | undefined;
 }, {
     name?: string | undefined;
     key?: any;
@@ -193514,6 +193662,12 @@ declare const autoroutingPhaseProps: z.ZodEffects<z.ZodObject<{
         shape?: "rect" | undefined;
     } | undefined;
     reroute?: boolean | undefined;
+    addTestPoints?: boolean | undefined;
+    testPointLayer?: "top" | "bottom" | undefined;
+    testPointDiameter?: string | number | undefined;
+    testPointClearance?: string | number | undefined;
+    testPointMinProbeSpacing?: string | number | undefined;
+    testPointMaxDetour?: string | number | undefined;
 }>, {
     name?: string | undefined;
     key?: any;
@@ -193571,6 +193725,12 @@ declare const autoroutingPhaseProps: z.ZodEffects<z.ZodObject<{
         shape?: "rect" | undefined;
     } | undefined;
     reroute?: boolean | undefined;
+    addTestPoints?: boolean | undefined;
+    testPointLayer?: "top" | "bottom" | undefined;
+    testPointDiameter?: number | undefined;
+    testPointClearance?: number | undefined;
+    testPointMinProbeSpacing?: number | undefined;
+    testPointMaxDetour?: number | undefined;
 }, {
     name?: string | undefined;
     key?: any;
@@ -193638,6 +193798,12 @@ declare const autoroutingPhaseProps: z.ZodEffects<z.ZodObject<{
         shape?: "rect" | undefined;
     } | undefined;
     reroute?: boolean | undefined;
+    addTestPoints?: boolean | undefined;
+    testPointLayer?: "top" | "bottom" | undefined;
+    testPointDiameter?: string | number | undefined;
+    testPointClearance?: string | number | undefined;
+    testPointMinProbeSpacing?: string | number | undefined;
+    testPointMaxDetour?: string | number | undefined;
 }>;
 
 declare const transistorPinsLabels: readonly ["pin1", "pin2", "pin3", "emitter", "collector", "base", "gate", "source", "drain"];

package/dist/index.js

@@ -355,7 +355,32 @@ var assemblyCableProps = z13.object({
   from: z13.string().trim().min(1),
   to: z13.string().trim().min(1),
   standard: z13.literal("usb_c").optional(),
-  model: z13.string().trim().min(1).optional()
+  model: z13.string().trim().min(1).optional(),
+  waypoints: z13.array(
+    z13.object({
+      x: z13.number().finite(),
+      y: z13.number().finite(),
+      z: z13.number().finite()
+    })
+  ).optional(),
+  waypointAnchor: z13.enum(["start", "end"]).optional(),
+  waypointAxisOrientation: z13.enum(["board_at_start", "board_at_end"]).optional()
+}).superRefine((cable, context) => {
+  if (cable.waypoints === void 0) return;
+  if (cable.waypointAnchor === void 0) {
+    context.addIssue({
+      code: z13.ZodIssueCode.custom,
+      path: ["waypointAnchor"],
+      message: "waypointAnchor is required when waypoints is defined"
+    });
+  }
+  if (cable.waypointAxisOrientation === void 0) {
+    context.addIssue({
+      code: z13.ZodIssueCode.custom,
+      path: ["waypointAxisOrientation"],
+      message: "waypointAxisOrientation is required when waypoints is defined"
+    });
+  }
 });
 expectTypesMatch(true);
 
@@ -19377,15 +19402,43 @@ var autoroutingPhaseProps = z120.object({
   connection: z120.string().optional(),
   connections: z120.array(z120.string()).optional(),
   reroute: z120.boolean().optional(),
+  addTestPoints: z120.boolean().optional(),
+  testPointLayer: z120.enum(["top", "bottom"]).optional(),
+  testPointDiameter: distance.pipe(z120.number().finite().positive()).optional(),
+  testPointClearance: distance.pipe(z120.number().finite().nonnegative()).optional(),
+  testPointMinProbeSpacing: distance.pipe(z120.number().finite().nonnegative()).optional(),
+  testPointMaxDetour: distance.pipe(z120.number().finite().nonnegative()).optional(),
   ...fanoutProps.shape
 }).superRefine((value, ctx) => {
+  if (value.addTestPoints && (value.reroute !== true || value.region || value.pcbTracePaths || value.autorouter || value.algorithmFn)) {
+    ctx.addIssue({
+      code: z120.ZodIssueCode.custom,
+      path: ["addTestPoints"],
+      message: "addTestPoints requires reroute=true and cannot combine with region, pcbTracePaths, autorouter, or algorithmFn"
+    });
+  }
+  for (const option of [
+    "testPointLayer",
+    "testPointDiameter",
+    "testPointClearance",
+    "testPointMinProbeSpacing",
+    "testPointMaxDetour"
+  ]) {
+    if (value[option] !== void 0 && !value.addTestPoints) {
+      ctx.addIssue({
+        code: z120.ZodIssueCode.custom,
+        path: [option],
+        message: `${option} requires addTestPoints=true`
+      });
+    }
+  }
   const isSimplifyAutorouter = value.autorouter === "simplify" || typeof value.autorouter === "object" && value.autorouter?.preset === "simplify";
   if (isSimplifyAutorouter && value.reroute !== true) {
     console.warn(
       'The "simplify" autorouter preset should only be used with reroute=true'
     );
   }
-  if (value.reroute !== void 0 && !(isSimplifyAutorouter && value.reroute === true) && value.region === void 0 && value.connection === void 0 && value.connections === void 0) {
+  if (value.reroute !== void 0 && !((isSimplifyAutorouter || value.addTestPoints) && value.reroute === true) && value.region === void 0 && value.connection === void 0 && value.connections === void 0) {
     ctx.addIssue({
       code: z120.ZodIssueCode.custom,
       message: "region, connection, or connections is required when reroute is provided",