@tscircuit/props 0.0.665 → 0.0.667

package/lib/components/group.ts

@@ -321,6 +321,12 @@ export interface RoutingTolerances {
   minViaHoleEdgeToViaHoleEdgeClearance?: Distance
   minPlatedHoleDrillEdgeToDrillEdgeClearance?: Distance
   minTraceToPadEdgeClearance?: Distance
+  /**
+   * Minimum trace copper edge to non-plated hole edge clearance. Numbers are mm;
+   * unit strings are normalized to mm. Must be finite and non-negative. Omitted
+   * leaves the router default unchanged. Independent of pad clearance, with no aliases.
+   */
+  minTraceToHoleEdgeClearance?: Distance
   minPadEdgeToPadEdgeClearance?: Distance
   minBoardEdgeClearance?: Distance
   minViaEdgeToPadEdgeClearance?: Distance
@@ -402,6 +408,11 @@ export const routingTolerances = z.object({
   minViaEdgeToPadEdgeClearance: length.optional(),
   minPlatedHoleDrillEdgeToDrillEdgeClearance: length.optional(),
   minTraceToPadEdgeClearance: length.optional(),
+  minTraceToHoleEdgeClearance: length
+    .refine((value) => Number.isFinite(value) && value >= 0, {
+      message: "minTraceToHoleEdgeClearance must be finite and non-negative",
+    })
+    .optional(),
   minPadEdgeToPadEdgeClearance: length.optional(),
   minBoardEdgeClearance: length.optional(),
   minViaHoleDiameter: length.optional(),

package/lib/components/pcb-bend.ts

@@ -0,0 +1,42 @@
+import { rotation } from "circuit-json"
+import { distance, type Distance } from "lib/common/distance"
+import { expectTypesMatch } from "lib/typecheck"
+import { z } from "zod"
+
+/** A bend on a flat flex PCB. Does not change fabrication coordinates. */
+export interface PcbBendProps {
+  name?: string
+  /** Start/end of the bend-zone centerline in the parent PCB coordinate system. */
+  x1: Distance
+  y1: Distance
+  x2: Distance
+  y2: Distance
+  /** Signed degrees (or an angle string). Positive folds toward the local top face. */
+  bendAngle: number | string
+  /** Positive neutral-surface radius, in mm or a distance string. */
+  bendRadius: Distance
+  /** Moving side, looking from (x1, y1) toward (x2, y2) in the flat layout. */
+  bendSide: "left" | "right"
+}
+
+const finiteDistance = distance.pipe(z.number().finite())
+
+export const pcbBendProps = z
+  .object({
+    name: z.string().optional(),
+    x1: finiteDistance,
+    y1: finiteDistance,
+    x2: finiteDistance,
+    y2: finiteDistance,
+    bendAngle: rotation.pipe(z.number().finite()),
+    bendRadius: distance.pipe(z.number().finite().positive()),
+    bendSide: z.enum(["left", "right"]),
+  })
+  .refine(({ x1, y1, x2, y2 }) => x1 !== x2 || y1 !== y2, {
+    message: "Bend centerline endpoints must be distinct",
+    path: ["x2"],
+  })
+
+expectTypesMatch<PcbBendProps, z.input<typeof pcbBendProps>>(true)
+
+export type PcbBendPropsInput = z.input<typeof pcbBendProps>

package/lib/components/pcb-stiffener.ts

@@ -0,0 +1,48 @@
+import { distance } from "lib/common/distance"
+import { pcbLayoutProps } from "lib/common/layout"
+import { z } from "zod"
+
+const positiveDistance = distance.pipe(z.number().finite().positive())
+const finiteDistance = distance.pipe(z.number().finite())
+const stiffenerBaseProps = pcbLayoutProps.omit({ layer: true }).extend({
+  name: z.string().optional(),
+  /** Board attachment face, not a copper-layer assignment. Required. */
+  layer: z.enum(["top", "bottom"]),
+  material: z.enum(["fr4", "polyimide", "stainless_steel", "aluminum"]),
+  /** Stiffener material thickness only, excluding PCB and adhesive. */
+  thickness: positiveDistance,
+  /** Nonnegative adhesive thickness; omission means unspecified, not zero. */
+  adhesiveThickness: distance
+    .pipe(z.number().finite().nonnegative())
+    .optional(),
+})
+
+export const pcbStiffenerProps = z.discriminatedUnion("shape", [
+  stiffenerBaseProps.extend({
+    shape: z.literal("rect"),
+    width: positiveDistance,
+    height: positiveDistance,
+    outline: z.never().optional(),
+  }),
+  stiffenerBaseProps.extend({
+    shape: z.literal("polygon"),
+    /** Local vertices transformed by pcbX/pcbY/pcbRotation; implicitly closed. */
+    outline: z
+      .array(z.object({ x: finiteDistance, y: finiteDistance }))
+      .min(3)
+      .refine((points) => {
+        const twiceArea = points.reduce((sum, p, i) => {
+          const next = points[(i + 1) % points.length]!
+          return sum + p.x * next.y - next.x * p.y
+        }, 0)
+        return Number.isFinite(twiceArea) && twiceArea !== 0
+      }, "Stiffener outline must enclose a nonzero area"),
+    width: z.never().optional(),
+    height: z.never().optional(),
+  }),
+])
+
+/** Bonded mechanical reinforcement; does not add copper layers or a rigid stackup. */
+export type PcbStiffenerProps = z.input<typeof pcbStiffenerProps>
+
+export type PcbStiffenerPropsInput = z.input<typeof pcbStiffenerProps>

package/lib/index.ts

@@ -27,6 +27,8 @@ export * from "./common/kicadPinMetadata"
 export * from "./customDrc"
 
 export * from "./components/board"
+export * from "./components/pcb-bend"
+export * from "./components/pcb-stiffener"
 export * from "./components/panel"
 export * from "./components/subpanel"
 export * from "./components/breakout"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tscircuit/props",
-  "version": "0.0.665",
+  "version": "0.0.667",
   "description": "Props for tscircuit builtin component types",
   "main": "dist/index.js",
   "type": "module",