@tscircuit/props 0.0.711 → 0.0.713

package/lib/assembly/drawing/dimension.ts

@@ -1,6 +1,9 @@
 import { z } from "zod"
 import { expectTypesMatch } from "lib/typecheck"
 
+const dimensionAnchor = z.enum(["center", "left", "right", "top", "bottom"])
+export type AssemblyDrawingDimensionAnchor = z.infer<typeof dimensionAnchor>
+
 /** Authoring intent for a dimension of model geometry or a part view's extent.
  * Core resolves geometry, measurement text and paper placement in a follow-up.
  */
@@ -13,6 +16,14 @@ export interface AssemblyDrawingDimensionProps {
   widthOfView?: boolean
   /** Request the selected geometry's height in the view. Conflicts with edgeRef and widthOfView=true. */
   heightOfView?: boolean
+  /** Paired selectors for holes, boards or named model outlines. Both are required; conflicts with edgeRef and true view targets. */
+  fromRef?: string
+  toRef?: string
+  /** Anchor on the reference's projected bounds. Defaults to center; directions are relative to the drawing view, not CAD world axes. */
+  fromAnchor?: AssemblyDrawingDimensionAnchor
+  toAnchor?: AssemblyDrawingDimensionAnchor
+  /** Measure separation on the view's horizontal (x) or vertical (y) axis. Omitted chooses the larger separation, x on ties. Requires paired references. */
+  axis?: "x" | "y"
 }
 
 export const assemblyDrawingDimensionProps = z
@@ -21,18 +32,39 @@ export const assemblyDrawingDimensionProps = z
     edgeRef: z.string().trim().min(1).optional(),
     widthOfView: z.boolean().optional(),
     heightOfView: z.boolean().optional(),
+    fromRef: z.string().trim().min(1).optional(),
+    toRef: z.string().trim().min(1).optional(),
+    fromAnchor: dimensionAnchor.optional(),
+    toAnchor: dimensionAnchor.optional(),
+    axis: z.enum(["x", "y"]).optional(),
   })
   .superRefine((dimension, ctx) => {
     const targets = [
       dimension.edgeRef !== undefined,
       dimension.widthOfView === true,
       dimension.heightOfView === true,
+      dimension.fromRef !== undefined || dimension.toRef !== undefined,
     ].filter(Boolean).length
     if (targets !== 1)
       ctx.addIssue({
         code: "custom",
         message:
-          "Specify exactly one of edgeRef, widthOfView=true, or heightOfView=true",
+          "Specify exactly one of edgeRef, widthOfView=true, heightOfView=true, or paired fromRef/toRef",
+      })
+    if ((dimension.fromRef === undefined) !== (dimension.toRef === undefined))
+      ctx.addIssue({
+        code: "custom",
+        message: "fromRef and toRef must be specified together",
+      })
+    if (
+      (dimension.axis !== undefined ||
+        dimension.fromAnchor !== undefined ||
+        dimension.toAnchor !== undefined) &&
+      (dimension.fromRef === undefined || dimension.toRef === undefined)
+    )
+      ctx.addIssue({
+        code: "custom",
+        message: "axis, fromAnchor and toAnchor require paired fromRef/toRef",
       })
   })
 

package/lib/components/symbol.ts

@@ -18,7 +18,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
@@ -29,6 +30,22 @@ export interface SymbolProps {
   name?: string
 }
 
+const symbolViewboxBounds = z
+  .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"],
+  })
+
 export const symbolProps = z.object({
   originalFacingDirection: z
     .enum(["up", "down", "left", "right"])
@@ -38,20 +55,20 @@ export const symbolProps = z.object({
   height: distance.optional(),
   fit: z.enum(["fill", "contain", "stretch"]).optional(),
   viewbox: z
-    .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"],
-    })
+    .custom<z.input<typeof symbolViewboxBounds>>(
+      (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: z.string().optional(),
 })

package/package.json

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