@tscircuit/props 0.0.708 → 0.0.710

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/analogtransientsimulation.ts

@@ -1,4 +1,4 @@
-import { ms } from "circuit-json"
+import { frequency, length, ms } from "circuit-json"
 import { expectTypesMatch } from "lib/typecheck"
 import { z } from "zod"
 import { ibisPinRunState, type IbisPinRunState } from "lib/common/ibis"
@@ -17,8 +17,119 @@ export interface AnalogTransientSimulationProps
   timePerStep?: number | string
   /** Physical pin selectors and per-experiment direction/enable states. Requires spiceEngine="pcb_spice"; rendering only declares the experiment. */
   ibisPinStates?: Record<string, IbisPinRunState>
+  pcbSpiceChannel?: PcbSpiceChannelProps
 }
 
+export interface PcbSpiceChannelProps {
+  reduction: "routed-copper" | "straightened-stages"
+  sections: number
+  lanes: Array<{ name: string; from: string; to: string }>
+  referencePinRef: string
+  passiveComponentRefs?: string[]
+  extraction: {
+    minimumFrequency: number | string
+    maximumFrequency: number | string
+    modelFrequency: number | string
+    filaments: number
+    refinementFilaments: number
+    convergenceTolerance: number
+    capacitanceTolerance: number
+    reciprocityTolerance: number
+    dcResistanceTolerance: number
+    maxPanelLength: number | string
+    groundMeshSize?: number | string
+  }
+  relativePermittivity?: number
+  via?: {
+    platingThickness?: number | string
+    equivalentWidth?: number | string
+    omitThroughViaStubs?: boolean
+  }
+  straightenedStageProfiles?: Record<
+    string,
+    {
+      spacing: number | string
+      relativePermittivity: number
+      return: {
+        width: number | string
+        thickness: number | string
+        lengthFactor: number
+        centerY: number | string
+        centerZ: number | string
+      }
+    }
+  >
+}
+
+const positiveLength = length.pipe(z.number().finite().positive())
+const signedLength = length.pipe(z.number().finite())
+const positiveFrequency = frequency.pipe(z.number().finite().positive())
+
+export const pcbSpiceChannelProps = z.object({
+  reduction: z.enum(["routed-copper", "straightened-stages"]),
+  sections: z.number().int().min(1).max(128),
+  lanes: z
+    .array(
+      z.object({
+        name: z.string().min(1),
+        from: z.string().min(1),
+        to: z.string().min(1),
+      }),
+    )
+    .min(1)
+    .max(3),
+  referencePinRef: z.string().min(1),
+  passiveComponentRefs: z.array(z.string().min(1)).optional(),
+  extraction: z
+    .object({
+      minimumFrequency: positiveFrequency,
+      maximumFrequency: positiveFrequency,
+      modelFrequency: positiveFrequency,
+      filaments: z.number().int().positive(),
+      refinementFilaments: z.number().int().positive(),
+      convergenceTolerance: z.number().finite().positive(),
+      capacitanceTolerance: z.number().finite().positive(),
+      reciprocityTolerance: z.number().finite().positive(),
+      dcResistanceTolerance: z.number().finite().positive(),
+      maxPanelLength: positiveLength,
+      groundMeshSize: positiveLength.optional(),
+    })
+    .refine(
+      (extraction) => extraction.refinementFilaments > extraction.filaments,
+      {
+        path: ["refinementFilaments"],
+        message: "refinementFilaments must be greater than filaments",
+      },
+    ),
+  relativePermittivity: z.number().finite().positive().optional(),
+  via: z
+    .object({
+      platingThickness: positiveLength.optional(),
+      equivalentWidth: positiveLength.optional(),
+      omitThroughViaStubs: z.boolean().optional(),
+    })
+    .optional(),
+  straightenedStageProfiles: z
+    .record(
+      z.object({
+        spacing: positiveLength,
+        relativePermittivity: z.number().finite().positive(),
+        return: z.object({
+          width: positiveLength,
+          thickness: positiveLength,
+          lengthFactor: z.number().finite().positive(),
+          centerY: signedLength,
+          centerZ: signedLength,
+        }),
+      }),
+    )
+    .optional(),
+})
+
+expectTypesMatch<PcbSpiceChannelProps, z.input<typeof pcbSpiceChannelProps>>(
+  true,
+)
+
 const positiveMilliseconds = ms.refine(
   (milliseconds) => milliseconds > 0,
   "Time must be positive",
@@ -30,9 +141,17 @@ export const analogTransientSimulationProps = z
     duration: positiveMilliseconds.default("10ms"),
     startTime: ms.default("0ms"),
     timePerStep: positiveMilliseconds.default("0.01ms"),
+    pcbSpiceChannel: pcbSpiceChannelProps.optional(),
     ibisPinStates: z.record(z.string().min(1), ibisPinRunState).optional(),
   })
   .superRefine((simulation, context) => {
+    if (simulation.pcbSpiceChannel && simulation.spiceEngine !== "pcb_spice") {
+      context.addIssue({
+        code: z.ZodIssueCode.custom,
+        path: ["pcbSpiceChannel"],
+        message: "PCB SPICE channel settings require spiceEngine=pcb_spice",
+      })
+    }
     if (simulation.ibisPinStates && simulation.spiceEngine !== "pcb_spice") {
       context.addIssue({
         code: z.ZodIssueCode.custom,

package/package.json

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