@tscircuit/props 0.0.709 → 0.0.711

package/lib/assembly/drawing/dimension.ts

@@ -0,0 +1,45 @@
+import { z } from "zod"
+import { expectTypesMatch } from "lib/typecheck"
+
+/** 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.
+ */
+export interface AssemblyDrawingDimensionProps {
+  /** Stable circuit identity; does not choose a measurement or its formatting. */
+  name?: string
+  /** Selector for one model-defined named edge or outline, e.g. .tube > .inner_top; never a preset or mesh edge index. */
+  edgeRef?: string
+  /** Request the selected geometry's width in the view. Conflicts with edgeRef and heightOfView=true. */
+  widthOfView?: boolean
+  /** Request the selected geometry's height in the view. Conflicts with edgeRef and widthOfView=true. */
+  heightOfView?: boolean
+}
+
+export const assemblyDrawingDimensionProps = z
+  .object({
+    name: z.string().optional(),
+    edgeRef: z.string().trim().min(1).optional(),
+    widthOfView: z.boolean().optional(),
+    heightOfView: z.boolean().optional(),
+  })
+  .superRefine((dimension, ctx) => {
+    const targets = [
+      dimension.edgeRef !== undefined,
+      dimension.widthOfView === true,
+      dimension.heightOfView === true,
+    ].filter(Boolean).length
+    if (targets !== 1)
+      ctx.addIssue({
+        code: "custom",
+        message:
+          "Specify exactly one of edgeRef, widthOfView=true, or heightOfView=true",
+      })
+  })
+
+export type InferredAssemblyDrawingDimensionProps = z.input<
+  typeof assemblyDrawingDimensionProps
+>
+expectTypesMatch<
+  AssemblyDrawingDimensionProps,
+  z.input<typeof assemblyDrawingDimensionProps>
+>(true)

package/lib/assembly/drawing/index.ts

@@ -1,15 +1,18 @@
 import { assemblyDrawingTitleBlockProps } from "./titleblock"
 import { assemblyDrawingPageProps } from "./page"
 import { assemblyDrawingPartViewProps } from "./partview"
+import { assemblyDrawingDimensionProps } from "./dimension"
 
 export * from "./page"
 export * from "./page-size"
 export * from "./titleblock"
 export * from "./partview"
+export * from "./dimension"
 
 /** Drawing namespace; pages contain configured part views. */
 export const assemblyDrawingProps = {
   page: assemblyDrawingPageProps,
   titleblock: assemblyDrawingTitleBlockProps,
   partview: assemblyDrawingPartViewProps,
+  dimension: assemblyDrawingDimensionProps,
 } as const

package/lib/assembly/drawing/partview.ts

@@ -56,6 +56,8 @@ export interface AssemblyDrawingPartViewProps {
   showHiddenEdges?: boolean
   /** A planar cut with diagonal hatching on closed cut surfaces. */
   section?: AssemblyDrawingSectionPlane
+  /** Nested assembly.drawing.dimension annotations; these do not change the selected geometry. */
+  children?: any
 }
 
 export const assemblyDrawingPartViewProps = z
@@ -74,6 +76,7 @@ export const assemblyDrawingPartViewProps = z
     height: distance.pipe(z.number().finite().positive()),
     showHiddenEdges: z.boolean().default(false),
     section: assemblyDrawingSectionPlane.optional(),
+    children: z.any().optional(),
   })
   .superRefine((view, ctx) => {
     for (const [center, negative, positive] of [

package/lib/components/transistor.ts

@@ -5,6 +5,7 @@ import {
 import { expectTypesMatch } from "lib/typecheck"
 import { z } from "zod"
 import type { Connections } from "lib/utility-types/connections-and-selectors"
+import { pinLabelsProp, type PinLabelsProp } from "./chip"
 import { createConnectionsProp } from "lib/common/connectionsProp"
 
 export const transistorPinsLabels = [
@@ -23,11 +24,19 @@ export type transistorPinsLabels = (typeof transistorPinsLabels)[number]
 export interface TransistorProps<PinLabel extends string = string>
   extends CommonComponentProps<PinLabel> {
   type: "npn" | "pnp" | "bjt" | "jfet" | "mosfet" | "igbt"
+  /**
+   * Physical package pins mapped to semantic terminal names (and optional aliases).
+   * For MMBT3904 SOT-23: { pin1: "base", pin2: "emitter", pin3: "collector" }.
+   * Use full terminal names to retain schematic and simulation semantics.
+   * Omit to retain the symbol's default pin order; no package pinout is inferred.
+   */
+  pinLabels?: PinLabelsProp<string, PinLabel>
   connections?: Connections<transistorPinsLabels>
 }
 
 export const transistorProps = commonComponentProps.extend({
   type: z.enum(["npn", "pnp", "bjt", "jfet", "mosfet", "igbt"]),
+  pinLabels: pinLabelsProp.optional(),
   connections: createConnectionsProp(transistorPinsLabels).optional(),
 })
 

package/package.json

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