@tscircuit/props 0.0.675 → 0.0.677

package/lib/components/group.ts

@@ -352,9 +352,9 @@ export interface AutorouterConfig {
   /** Override the solver used to place implicit breakout points. */
   implicitBreakoutPointSolverFn?: ImplicitBreakoutPointSolverFn
   /**
-   * single_layer_bus and single_layer_buses are aliases that parse as bus_lanes.
-   * Omitted leaves the preset unset. Existing presets remain unchanged; no
-   * conflicting fields or migration are introduced.
+   * single_layer_routing is an alias that parses as bus_lanes.
+   * Replaces single_layer_bus and single_layer_buses. Omitted leaves the preset
+   * unset; other presets remain unchanged and no conflicting fields are introduced.
    */
   preset?:
     | /** @deprecated Disabled by default in core. Use the default autorouter with <autoroutingphase /> or <fanout /> as needed. Legacy support requires platformConfig.allowLegacyAutorouters: true. */ "sequential_trace"
@@ -373,8 +373,7 @@ export interface AutorouterConfig {
     | "fanout"
     | "dogbone"
     | "bus_lanes"
-    | "single_layer_bus"
-    | "single_layer_buses"
+    | "single_layer_routing"
     | /** @deprecated Use "auto_jumper" */ "auto-jumper"
     | /** @deprecated Disabled by default in core. Use the default autorouter with <autoroutingphase /> or <fanout /> as needed. Legacy support requires platformConfig.allowLegacyAutorouters: true. */ "sequential-trace"
     | /** @deprecated Use "auto_local" */ "auto-local"
@@ -400,9 +399,7 @@ export type AutorouterPreset =
   | "dogbone"
   | "bus_lanes"
   /** Alias for bus_lanes; parsing normalizes to bus_lanes. */
-  | "single_layer_bus"
-  /** Alias for bus_lanes; parsing normalizes to bus_lanes. */
-  | "single_layer_buses"
+  | "single_layer_routing"
   | "auto-jumper"
   | /** @deprecated Disabled by default in core. Use the default autorouter with <autoroutingphase /> or <fanout /> as needed. Legacy support requires platformConfig.allowLegacyAutorouters: true. */ "sequential-trace"
   | "auto-local"
@@ -478,17 +475,14 @@ export const autorouterConfig = z.object({
       "fanout",
       "dogbone",
       "bus_lanes",
-      "single_layer_bus",
-      "single_layer_buses",
+      "single_layer_routing",
       "auto-jumper",
       "sequential-trace",
       "auto-local",
       "auto-cloud",
     ])
     .transform((preset) =>
-      preset === "single_layer_bus" || preset === "single_layer_buses"
-        ? "bus_lanes"
-        : preset,
+      preset === "single_layer_routing" ? "bus_lanes" : preset,
     )
     .optional(),
   local: z.boolean().optional(),
@@ -511,8 +505,7 @@ export const autorouterPreset = z.union([
   z.literal("fanout"),
   z.literal("dogbone"),
   z.literal("bus_lanes"),
-  z.literal("single_layer_bus").transform(() => "bus_lanes" as const),
-  z.literal("single_layer_buses").transform(() => "bus_lanes" as const),
+  z.literal("single_layer_routing").transform(() => "bus_lanes" as const),
   z.literal("auto-jumper"),
   z.literal("sequential-trace"),
   z.literal("auto-local"),

package/lib/components/pcb-soldermask-opening.ts

@@ -0,0 +1,56 @@
+import { distance } from "lib/common/distance"
+import { pcbLayoutProps } from "lib/common/layout"
+import { z } from "zod"
+
+const finiteDistance = distance.pipe(z.number().finite())
+const positiveDistance = distance.pipe(z.number().finite().positive())
+const openingBaseProps = pcbLayoutProps.omit({ layer: true }).extend({
+  name: z.string().optional(),
+  /** Face whose solder mask or flex coverlay is removed. Required. */
+  layer: z.enum(["top", "bottom"]),
+})
+
+export const pcbSoldermaskOpeningProps = z.discriminatedUnion("shape", [
+  openingBaseProps.extend({
+    shape: z.literal("rect"),
+    width: positiveDistance,
+    height: positiveDistance,
+    radius: z.never().optional(),
+    points: z.never().optional(),
+  }),
+  openingBaseProps.extend({
+    shape: z.literal("circle"),
+    radius: positiveDistance,
+    width: z.never().optional(),
+    height: z.never().optional(),
+    points: z.never().optional(),
+  }),
+  openingBaseProps.extend({
+    shape: z.literal("polygon"),
+    /** Local vertices; pcbX/pcbY/pcbRotation place the implicitly closed boundary. */
+    points: z
+      .array(z.object({ x: finiteDistance, y: finiteDistance }))
+      .min(3)
+      .refine((points) => {
+        const twiceArea = points.reduce((sum, point, index) => {
+          const next = points[(index + 1) % points.length]!
+          return sum + point.x * next.y - next.x * point.y
+        }, 0)
+        return Number.isFinite(twiceArea) && twiceArea !== 0
+      }, "Solder-mask opening must enclose a nonzero area"),
+    width: z.never().optional(),
+    height: z.never().optional(),
+    radius: z.never().optional(),
+  }),
+])
+
+/**
+ * A solder-mask or flex-coverlay aperture independent of pads and holes.
+ * Exposes underlying copper or substrate without adding copper, paste, or connectivity.
+ * Geometry is local to its parent, in mm (+X right, +Y top); use pcbRotation for rectangles.
+ */
+export type PcbSoldermaskOpeningProps = z.input<
+  typeof pcbSoldermaskOpeningProps
+>
+
+export type PcbSoldermaskOpeningPropsInput = PcbSoldermaskOpeningProps

package/lib/index.ts

@@ -28,6 +28,7 @@ export * from "./customDrc"
 
 export * from "./components/board"
 export * from "./components/pcb-bend"
+export * from "./components/pcb-soldermask-opening"
 export * from "./components/pcb-stiffener"
 export * from "./components/panel"
 export * from "./components/subpanel"

package/package.json

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