@tscircuit/props 0.0.664 → 0.0.666

package/lib/components/autoroutingphase.ts

@@ -6,9 +6,11 @@ import {
   fanoutTracePath,
 } from "../common/fanoutTracePath"
 import {
+  type AutorouterConfig,
   type AutorouterProp,
   type PreflightRoutingCheckPolicy,
   type RoutingTolerances,
+  autorouterConfig,
   autorouterProp,
   preflightRoutingCheckPolicy,
   routingTolerances,
@@ -26,6 +28,13 @@ export interface AutoroutingPhaseProps extends RoutingTolerances, FanoutProps {
   key?: any
   name?: string
   autorouter?: AutorouterProp
+  /**
+   * Custom async routing function accepting simple route JSON and returning the
+   * routing result, using the same contract as autorouter.algorithmFn. Parsing
+   * preserves the function unchanged. Omitted by default; no aliases or prop
+   * conflicts are introduced, and existing phases require no migration.
+   */
+  algorithmFn?: AutorouterConfig["algorithmFn"]
   preflightRoutingCheckPolicy?: PreflightRoutingCheckPolicy
   phaseIndex?: number
   /**
@@ -54,6 +63,7 @@ export const autoroutingPhaseProps = z
     key: z.any().optional(),
     name: z.string().optional(),
     autorouter: autorouterProp.optional(),
+    algorithmFn: autorouterConfig.shape.algorithmFn,
     preflightRoutingCheckPolicy: preflightRoutingCheckPolicy.optional(),
     phaseIndex: z.number().optional(),
     pcbTracePaths: z.array(fanoutTracePath).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.664",
+  "version": "0.0.666",
   "description": "Props for tscircuit builtin component types",
   "main": "dist/index.js",
   "type": "module",