@tscircuit/props 0.0.642 → 0.0.644

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/lib/components/bus.ts

@@ -10,12 +10,12 @@ import { z } from "zod"
 export type BusName = string
 
 /**
- * Declares a group of connections that an autorouter should keep together.
+ * Declares one or more connections that an autorouter should route as a group.
  * Each connection may be a trace name or a port selector.
  */
 export interface BusProps {
   name?: string
-  /** Trace names or port selectors for the connections in the bus. */
+  /** One or more trace names or port selectors for the connections in the bus. */
   connections: string[]
   /** If set, every trace in this bus is assigned to this autorouting phase. */
   routingPhaseIndex?: number | null
@@ -35,7 +35,7 @@ export interface BusProps {
 
 export const busProps = z.object({
   name: z.string().optional(),
-  connections: z.array(z.string()).min(2),
+  connections: z.array(z.string()).min(1),
   routingPhaseIndex: z.number().nullable().optional(),
   maxLengthSkew: distance.pipe(z.number().min(0).finite()).optional(),
   targetImpedance: resistance.pipe(z.number().positive().finite()).optional(),

package/package.json

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