@tscircuit/props 0.0.643 → 0.0.645

package/lib/assembly/index.ts

@@ -1,7 +1,10 @@
 import { assemblyDeviceProps } from "./device"
+import { assemblyScreenProps } from "./screen"
 
 export * from "./device"
+export * from "./screen"
 
 export const assemblyProps = {
   device: assemblyDeviceProps,
+  screen: assemblyScreenProps,
 } as const

package/lib/assembly/screen.ts

@@ -0,0 +1,69 @@
+import { type Distance, distance } from "lib/common/distance"
+import { expectTypesMatch } from "lib/typecheck"
+import { z } from "zod"
+
+export interface AssemblyScreenProps {
+  /** Stable product-level identity for the screen assembly. */
+  name: string
+  /** Selector for the connector that the screen attaches to. */
+  connectsTo: string
+  /**
+   * Outer width of the screen body, including its bezel but excluding the flex
+   * cable. When supplied, it must be provided together with `height`.
+   */
+  width?: Distance
+  /**
+   * Outer height of the screen body, including its bezel but excluding the flex
+   * cable. When supplied, it must be provided together with `width`.
+   */
+  height?: Distance
+  /**
+   * Advanced modelprinter string used to render the screen assembly. Required
+   * when `width` and `height` are omitted.
+   */
+  cadModel?: string
+}
+
+const nonemptyString = (fieldName: "name" | "connectsTo" | "cadModel") =>
+  z.string().refine((value) => value.trim().length > 0, {
+    message: `${fieldName} cannot be empty`,
+  })
+
+const positiveDistance = (fieldName: "width" | "height") =>
+  distance.refine((value) => Number.isFinite(value) && value > 0, {
+    message: `${fieldName} must be a positive finite distance`,
+  })
+
+export const assemblyScreenProps = z
+  .object({
+    name: nonemptyString("name"),
+    connectsTo: nonemptyString("connectsTo"),
+    width: positiveDistance("width").optional(),
+    height: positiveDistance("height").optional(),
+    cadModel: nonemptyString("cadModel").optional(),
+  })
+  .superRefine((screen, context) => {
+    const hasWidth = screen.width !== undefined
+    const hasHeight = screen.height !== undefined
+
+    if (hasWidth !== hasHeight) {
+      context.addIssue({
+        code: z.ZodIssueCode.custom,
+        message: "width and height must be provided together",
+        path: hasWidth ? ["height"] : ["width"],
+      })
+      return
+    }
+
+    if (!hasWidth && screen.cadModel === undefined) {
+      context.addIssue({
+        code: z.ZodIssueCode.custom,
+        message: "provide either width and height or cadModel",
+        path: [],
+      })
+    }
+  })
+
+export type AssemblyScreenPropsInput = z.input<typeof assemblyScreenProps>
+
+expectTypesMatch<AssemblyScreenProps, AssemblyScreenPropsInput>(true)

package/lib/components/antenna.ts

@@ -6,8 +6,44 @@ import { type PcbPath, pcbPath } from "lib/common/pcbPath"
 import { expectTypesMatch } from "lib/typecheck"
 import { z } from "zod"
 
-/** Props for an antenna component with an optional explicit PCB path. */
+/** Band-qualified PCB-trace antenna topologies. */
+export const antennaShapes = [
+  "2.4ghz_quarter_wave_monopole",
+  "2.4ghz_meandered_monopole",
+  "2.4ghz_inverted_f",
+  "2.4ghz_meandered_inverted_f",
+  "2.4ghz_folded_dipole",
+] as const
+
+export type AntennaShape = (typeof antennaShapes)[number]
+export const antennaShape = z.enum(antennaShapes)
+
+/** Nominal Wi-Fi and Bluetooth operating-band configurations. */
+export const antennaFrequencyBands = [
+  "2.4ghz",
+  "5ghz",
+  "6ghz",
+  "dual_band_2.4ghz_5ghz",
+  "tri_band_2.4ghz_5ghz_6ghz",
+] as const
+
+export type AntennaFrequencyBand = (typeof antennaFrequencyBands)[number]
+export const antennaFrequencyBand = z.enum(antennaFrequencyBands)
+
+/** Props for an antenna component with optional generated or explicit geometry. */
 export interface AntennaProps extends CommonComponentProps {
+  /**
+   * Band-qualified PCB-trace topology to generate. The encoded band is enough
+   * to select the geometry without frequencyBand. No shape is assumed when
+   * omitted. An explicit pcbPath takes precedence when both are provided.
+   */
+  antennaShape?: AntennaShape
+  /**
+   * Nominal operating band or multiband configuration. This is redundant when
+   * antennaShape is present; the band encoded in antennaShape controls generated
+   * geometry.
+   */
+  frequencyBand?: AntennaFrequencyBand
   /**
    * Explicit antenna path. Entries use the same selector, point, and via
    * syntax as trace pcbPath entries.
@@ -16,6 +52,8 @@ export interface AntennaProps extends CommonComponentProps {
 }
 
 export const antennaProps = commonComponentProps.extend({
+  antennaShape: antennaShape.optional(),
+  frequencyBand: antennaFrequencyBand.optional(),
   pcbPath: pcbPath.optional(),
 })
 

package/package.json

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