@tscircuit/props 0.0.712 → 0.0.714

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;
 }
 ```
 
@@ -2545,7 +2562,8 @@ export interface SymbolProps {
    * Source sizing bounds in the local symbol coordinate space (mm, +X right, +Y up).
    * With width/height, maps the bounds center to the symbol position; all artwork
    * and ports use the same transform. Omitted uses automatic bounds including ports.
-   * maxX must exceed minX and maxY must exceed minY. No aliases; no change to existing defaults.
+   * maxX must exceed minX and maxY must exceed minY. Other shapes are rejected
+   * with a diagnostic listing the required bounds. No aliases; existing defaults are unchanged.
    */
   viewbox?: {
     minX: number | string;

package/dist/index.d.ts

@@ -168287,7 +168287,8 @@ interface SymbolProps {
      * Source sizing bounds in the local symbol coordinate space (mm, +X right, +Y up).
      * With width/height, maps the bounds center to the symbol position; all artwork
      * and ports use the same transform. Omitted uses automatic bounds including ports.
-     * maxX must exceed minX and maxY must exceed minY. No aliases; no change to existing defaults.
+     * maxX must exceed minX and maxY must exceed minY. Other shapes are rejected
+     * with a diagnostic listing the required bounds. No aliases; existing defaults are unchanged.
      */
     viewbox?: {
         minX: number | string;
@@ -168302,7 +168303,17 @@ declare const symbolProps: z.ZodObject<{
     width: z.ZodOptional<z.ZodEffects<z.ZodUnion<[z.ZodString, z.ZodNumber]>, number, string | number>>;
     height: z.ZodOptional<z.ZodEffects<z.ZodUnion<[z.ZodString, z.ZodNumber]>, number, string | number>>;
     fit: z.ZodOptional<z.ZodEnum<["fill", "contain", "stretch"]>>;
-    viewbox: z.ZodOptional<z.ZodEffects<z.ZodEffects<z.ZodObject<{
+    viewbox: z.ZodOptional<z.ZodPipeline<z.ZodType<{
+        minX: string | number;
+        maxX: string | number;
+        minY: string | number;
+        maxY: string | number;
+    }, z.ZodTypeDef, {
+        minX: string | number;
+        maxX: string | number;
+        minY: string | number;
+        maxY: string | number;
+    }>, z.ZodEffects<z.ZodEffects<z.ZodObject<{
         minX: z.ZodEffects<z.ZodUnion<[z.ZodString, z.ZodNumber]>, number, string | number>;
         maxX: z.ZodEffects<z.ZodUnion<[z.ZodString, z.ZodNumber]>, number, string | number>;
         minY: z.ZodEffects<z.ZodUnion<[z.ZodString, z.ZodNumber]>, number, string | number>;
@@ -168337,7 +168348,7 @@ declare const symbolProps: z.ZodObject<{
         maxX: string | number;
         minY: string | number;
         maxY: string | number;
-    }>>;
+    }>>>;
     name: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
     width?: number | undefined;
@@ -193141,6 +193152,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<{
@@ -193206,6 +193234,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>>;
@@ -193436,6 +193470,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;
@@ -193503,6 +193543,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;
@@ -193560,6 +193606,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;
@@ -193627,6 +193679,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

@@ -18722,23 +18722,29 @@ expectTypesMatch(true);
 
 // lib/components/symbol.ts
 import { z as z100 } from "zod";
+var symbolViewboxBounds = z100.object({
+  minX: distance,
+  maxX: distance,
+  minY: distance,
+  maxY: distance
+}).refine((bounds) => bounds.maxX > bounds.minX, {
+  message: "viewbox maxX must exceed minX",
+  path: ["maxX"]
+}).refine((bounds) => bounds.maxY > bounds.minY, {
+  message: "viewbox maxY must exceed minY",
+  path: ["maxY"]
+});
 var symbolProps = z100.object({
   originalFacingDirection: z100.enum(["up", "down", "left", "right"]).default("right").optional(),
   width: distance.optional(),
   height: distance.optional(),
   fit: z100.enum(["fill", "contain", "stretch"]).optional(),
-  viewbox: z100.object({
-    minX: distance,
-    maxX: distance,
-    minY: distance,
-    maxY: distance
-  }).refine((bounds) => bounds.maxX > bounds.minX, {
-    message: "viewbox maxX must exceed minX",
-    path: ["maxX"]
-  }).refine((bounds) => bounds.maxY > bounds.minY, {
-    message: "viewbox maxY must exceed minY",
-    path: ["maxY"]
-  }).optional(),
+  viewbox: z100.custom(
+    (bounds) => typeof bounds === "object" && bounds !== null && "minX" in bounds && "maxX" in bounds && "minY" in bounds && "maxY" in bounds,
+    {
+      message: "viewbox requires { minX, maxX, minY, maxY } bounds in the local symbol coordinate space."
+    }
+  ).pipe(symbolViewboxBounds).optional(),
   name: z100.string().optional()
 });
 expectTypesMatch(true);
@@ -19371,15 +19377,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",