@tscircuit/props 0.0.687 → 0.0.689

package/lib/common/pinAttributeMap.ts

@@ -44,6 +44,11 @@ export interface PinAttributeMap {
   requiresGround?: boolean
   providesVoltage?: string | number
   requiresVoltage?: string | number
+  /**
+   * Allowed relative deviation from requiresVoltage, e.g. 0.05 or "5%" for ±5%.
+   * Parsed as a fraction from 0 to 1; omitted values remain undefined.
+   */
+  requiredVoltageTolerance?: number | string
   doNotConnect?: boolean
   includeInBoardPinout?: boolean
   highlightColor?: string
@@ -83,6 +88,24 @@ export const pinAttributeMap = z.object({
   requiresGround: z.boolean().optional(),
   providesVoltage: z.union([z.string(), z.number()]).optional(),
   requiresVoltage: z.union([z.string(), z.number()]).optional(),
+  requiredVoltageTolerance: z
+    .union([
+      z.number(),
+      z
+        .string()
+        .trim()
+        .regex(
+          /^(?:\d+(?:\.\d*)?|\.\d+)(?:[eE][+-]?\d+)?\s*%?$/,
+          "Expected a tolerance fraction or percentage",
+        )
+        .transform((value) =>
+          value.endsWith("%")
+            ? Number(value.slice(0, -1)) / 100
+            : Number(value),
+        ),
+    ])
+    .pipe(z.number().finite().min(0).max(1))
+    .optional(),
   doNotConnect: z.boolean().optional(),
   includeInBoardPinout: z.boolean().optional(),
   highlightColor: z.string().optional(),

package/lib/components/cadmodel.ts

@@ -4,7 +4,9 @@ import { cadModelBase, type CadModelBase } from "../common/cadModel"
 import { url } from "lib/common/url"
 import { z } from "zod"
 
+/** Parsed CAD model props. Author model strings with CadModelPropsInput. */
 export interface CadModelProps extends CadModelBase {
+  /** Canonical model URL after parsing; authored model strings resolve to this field. */
   modelUrl: string
   stepUrl?: string
   pcbX?: Distance
@@ -38,6 +40,42 @@ const cadModelBaseWithUrl = cadModelBase.extend({
 const cadModelObject = cadModelBaseWithUrl.merge(pcbPosition)
 expectTypesMatch<CadModelProps, z.input<typeof cadModelObject>>(true)
 
-export const cadmodelProps = z.union([z.null(), url, cadModelObject])
+const cadModelInputObject = cadModelBase
+  .extend({
+    /** Modelprinter specification or HTTP(S) URL; mutually exclusive with modelUrl. */
+    model: z.string().trim().min(1).optional(),
+    modelUrl: url.optional(),
+  })
+  .merge(pcbPosition)
+  .refine(
+    (props) => (props.model === undefined) !== (props.modelUrl === undefined),
+    {
+      message: "Provide exactly one of model or modelUrl",
+      path: ["model"],
+    },
+  )
+  .transform(({ model, ...props }) => ({
+    ...props,
+    modelUrl:
+      model === undefined
+        ? props.modelUrl!
+        : /^https?:\/\//i.test(model)
+          ? model
+          : `https://modelcdn.tscircuit.com/jscad_models/${encodeURIComponent(model)}.glb`,
+  }))
+  .pipe(cadModelObject)
+
+expectTypesMatch<
+  z.output<typeof cadModelObject>,
+  z.output<typeof cadModelInputObject>
+>(true)
+
+/**
+ * Object inputs require exactly one of model or modelUrl. Modelprinter strings
+ * are trimmed and resolved to modelUrl; HTTP(S) model URLs are preserved.
+ * Parsed objects retain the existing CadModelProps shape, without a model field.
+ * Existing modelUrl objects, bare URL strings, and null remain supported.
+ */
+export const cadmodelProps = z.union([z.null(), url, cadModelInputObject])
 
 export type CadModelPropsInput = z.input<typeof cadmodelProps>

package/package.json

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