@tscircuit/props 0.0.595 → 0.0.597

package/lib/common/cadModel.ts

@@ -113,10 +113,18 @@ export const cadModelJscad = cadModelBase.extend({
   jscad: z.record(z.any()),
 })
 
+/**
+ * A Footprinter string used to procedurally generate the component's CAD model,
+ * independently of the component's PCB footprint.
+ *
+ * @example "soic8"
+ */
+export type CadModelFootprinterString = string
+
 export type CadModelProp =
   | null
-  | string
   | ReactElement
+  | CadModelFootprinterString
   | CadModelStl
   | CadModelObj
   | CadModelGltf
@@ -127,7 +135,7 @@ export type CadModelProp =
 
 export const cadModelProp = z.union([
   z.null(),
-  url,
+  z.string().min(1),
   z.custom<ReactElement>((v) => {
     return v && typeof v === "object" && "type" in v && "props" in v
   }),

package/lib/common/fanoutBoundaryPadding.ts

@@ -0,0 +1,35 @@
+import { expectTypesMatch } from "lib/typecheck"
+import { z } from "zod"
+import { distance, type Distance } from "./distance"
+
+export interface DirectionalFanoutBoundaryPadding {
+  top?: Distance
+  right?: Distance
+  bottom?: Distance
+  left?: Distance
+}
+
+/**
+ * Padding between the union of the fanout source pads and the shared boundary
+ * where fanout traces terminate. Omitted directional values are treated as
+ * zero.
+ */
+export type FanoutBoundaryPadding = Distance | DirectionalFanoutBoundaryPadding
+
+const nonnegativeDistance = distance.refine((value) => value >= 0, {
+  message: "Fanout boundary padding cannot be negative",
+})
+
+export const fanoutBoundaryPadding = z.union([
+  nonnegativeDistance,
+  z.object({
+    top: nonnegativeDistance.optional(),
+    right: nonnegativeDistance.optional(),
+    bottom: nonnegativeDistance.optional(),
+    left: nonnegativeDistance.optional(),
+  }),
+])
+
+expectTypesMatch<FanoutBoundaryPadding, z.input<typeof fanoutBoundaryPadding>>(
+  true,
+)

package/lib/components/autoroutingphase.ts

@@ -1,5 +1,9 @@
 import { expectTypesMatch } from "lib/typecheck"
 import { z } from "zod"
+import {
+  type FanoutBoundaryPadding,
+  fanoutBoundaryPadding,
+} from "../common/fanoutBoundaryPadding"
 import {
   type NinePointAnchor,
   ninePointAnchor,
@@ -38,6 +42,11 @@ export interface AutoroutingPhaseProps extends RoutingTolerances {
    * direction unconstrained.
    */
   busFanoutDirections?: Record<BusName, BusFanoutDirection>
+  /**
+   * Padding between the union of the fanout source pads and the shared
+   * boundary where fanout traces terminate.
+   */
+  fanoutBoundaryPadding?: FanoutBoundaryPadding
 }
 
 const busFanoutDirection = z.union([
@@ -65,6 +74,7 @@ export const autoroutingPhaseProps = z
     connections: z.array(z.string()).optional(),
     reroute: z.boolean().optional(),
     busFanoutDirections: z.record(busFanoutDirection).optional(),
+    fanoutBoundaryPadding: fanoutBoundaryPadding.optional(),
   })
   .superRefine((value, ctx) => {
     if (

package/lib/components/breakout.ts

@@ -1,5 +1,8 @@
-import { distance } from "circuit-json"
-import type { Distance } from "lib/common/distance"
+import { distance, type Distance } from "lib/common/distance"
+import {
+  type FanoutBoundaryPadding,
+  fanoutBoundaryPadding,
+} from "lib/common/fanoutBoundaryPadding"
 import { expectTypesMatch } from "lib/typecheck"
 import { z } from "zod"
 import {
@@ -21,6 +24,12 @@ export interface BreakoutProps
   paddingRight?: Distance
   paddingTop?: Distance
   paddingBottom?: Distance
+  /**
+   * Padding between the union of the fanout source pads and the shared
+   * boundary where fanout traces terminate. This is independent of the
+   * breakout group's layout padding.
+   */
+  fanoutBoundaryPadding?: FanoutBoundaryPadding
 }
 
 export const breakoutProps = subcircuitGroupProps.extend({
@@ -30,6 +39,7 @@ export const breakoutProps = subcircuitGroupProps.extend({
   paddingRight: distance.optional(),
   paddingTop: distance.optional(),
   paddingBottom: distance.optional(),
+  fanoutBoundaryPadding: fanoutBoundaryPadding.optional(),
 })
 
 type InferredBreakoutProps = z.input<typeof breakoutProps>

package/lib/components/group.ts

@@ -335,6 +335,7 @@ export interface AutorouterConfig {
   cache?: PcbRouteCache
   traceClearance?: Distance
   availableJumperTypes?: Array<"1206x4" | "0603">
+  allowViaInPad?: boolean
   groupMode?:
     | "sequential_trace"
     | "subcircuit"
@@ -408,6 +409,12 @@ export const autorouterConfig = z.object({
   cache: z.custom<PcbRouteCache>((v) => true).optional(),
   traceClearance: length.optional(),
   availableJumperTypes: z.array(z.enum(["1206x4", "0603"])).optional(),
+  allowViaInPad: z
+    .boolean()
+    .optional()
+    .describe(
+      "Allows the autorouter to place vias inside connected pads. Omitted or false keeps via-in-pad routing disabled.",
+    ),
   groupMode: z
     .enum(["sequential_trace", "subcircuit", "sequential-trace"])
     .optional(),

package/lib/index.ts

@@ -139,3 +139,4 @@ export * from "./platformConfig"
 export * from "./projectConfig"
 export * from "./utility-types/connections-and-selectors"
 export * from "./common/ninePointAnchor"
+export * from "./common/fanoutBoundaryPadding"

package/package.json

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