@springfield/ham-radio-api 17.8.0 → 17.9.0

package/README.md

@@ -1,6 +1,6 @@
 # ham-radio-api
 
-Shared TypeScript types and schemas for HamBench: protocol DSL, memory maps, serial config, branded frequencies, and license types.
+Shared TypeScript types and schemas for HamBench: protocol DSL, memory maps, serial config, branded frequencies, license types, stations, and antennas.
 
 Packages that talk to radios depend on this library. It does not open a serial port.
 
@@ -10,4 +10,5 @@ Docs: [HamBench developer docs](https://springfield-ham-radio.github.io/ham-radi
 corepack enable
 yarn install
 yarn build
+yarn test
 ```

package/dist/antenna/type.d.ts

@@ -0,0 +1,89 @@
+import { Wavelength } from "../branded-types/wavelength.js";
+export type AntennaTypeId = "dipole" | "inverted-v" | "quarter-wave-vertical" | "yagi-3el" | "magloop" | "end-fed" | "dual-band-vertical" | "vhf-yagi" | "uhf-yagi";
+/** How energy is distributed in azimuth. Heading is unused for omni. */
+export type AntennaPattern = "omni" | "bidirectional" | "directive";
+/** Coarse elevation character. Skip rings use type plus height, not this alone. */
+export type AntennaTakeoff = "high" | "medium" | "low";
+export interface AntennaType {
+    id: AntennaTypeId;
+    label: string;
+    description: string;
+    pattern: AntennaPattern;
+    /**
+     * Typical peak gain in dBi. Catalog estimate for a generic of this family,
+     * not a manufacturer measurement or NEC run.
+     */
+    gainDbi: number;
+    /** Azimuth beamwidth of the main lobe in degrees. Omni is 360. */
+    beamwidthDeg: number;
+    /** Typical front-to-back ratio in dB. Zero for omni and bidirectional. */
+    frontToBackDb: number;
+    takeoff: AntennaTakeoff;
+    /** Ham bands this family typically covers, as SpectrumBand.wavelength. */
+    defaultBands: Wavelength[];
+    defaultHeightAglM: number;
+    /** True heading of maximum radiation when the type is not omni. */
+    defaultHeadingDeg: number;
+    /** Dipoles, inverted-Vs, and HF beams can use LC traps for extra bands. */
+    supportsTraps: boolean;
+    /** Tribanders start trapped; a single-band dipole does not. */
+    defaultTrapped: boolean;
+}
+/**
+ * Built-in generic antenna families. Commercial SKUs can parameterize these later.
+ */
+export declare const ANTENNA_TYPES: readonly AntennaType[];
+/**
+ * Returns whether `value` is a built-in antenna type id.
+ */
+export declare function isAntennaTypeId(value: unknown): value is AntennaTypeId;
+/**
+ * Looks up a built-in antenna type, or undefined when the id is unknown.
+ */
+export declare function antennaTypeById(id: AntennaTypeId | string | undefined): AntennaType | undefined;
+/**
+ * True when the operator should enter a heading (not omnidirectional).
+ */
+export declare function antennaTypeUsesHeading(type: AntennaType): boolean;
+/**
+ * True for dipoles, inverted-Vs, and HF Yagis — not VHF/UHF beams or omni verticals.
+ */
+export declare function antennaTypeSupportsTraps(type: AntennaType): boolean;
+/**
+ * HF / 6 m. 2 m (2) and 70 cm (0.7) are VHF/UHF.
+ */
+export declare function isHfAntennaBand(wavelength: Wavelength): boolean;
+/**
+ * Catalog order: longest wavelength first.
+ */
+export declare function sortAntennaBands(bands: readonly Wavelength[]): Wavelength[];
+/**
+ * True when every tagged band is VHF/UHF FM (2 m / 70 cm), not HF skywave.
+ */
+export declare function antennaBandsAreLineOfSight(bands: readonly Wavelength[]): boolean;
+/**
+ * Trap resonant frequencies: every tagged HF band except the lowest (the full-size fundamental).
+ *
+ * An 80/40 dipole traps at 40 m. A 20/15/10 tribander traps at 15 m and 10 m.
+ */
+export declare function trapResonantBands(bands: readonly Wavelength[]): Wavelength[];
+/**
+ * True when this installation uses traps on two or more HF bands.
+ */
+export declare function antennaIsTrapped(type: AntennaType, trapped: boolean | undefined, bands: readonly Wavelength[]): boolean;
+/**
+ * When traps are turned on with only one HF band, add the next-lower ham band as the fundamental
+ * (40 m → 80/40). If the tag is already 160 m, add 80 m as the trap frequency.
+ */
+export declare function bandsForEnabledTraps(bands: readonly Wavelength[]): Wavelength[];
+/**
+ * Peak gain with a small catalog derate when traps are in the elements.
+ */
+export declare function estimateGainDbi(type: AntennaType, trapped: boolean): number;
+/**
+ * Heuristic takeoff of the main lobe in degrees, from type and height in wavelengths.
+ *
+ * This is a catalog rule of thumb for skip rings, not an EZNEC elevation plot.
+ */
+export declare function estimateTakeoffDeg(type: AntennaType, heightAglM: number, wavelength?: Wavelength): number;
+//# sourceMappingURL=type.d.ts.map

package/dist/antenna/type.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"type.d.ts","sourceRoot":"","sources":["../../src/antenna/type.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,gCAAgC,CAAC;AAE5D,MAAM,MAAM,aAAa,GAAG,QAAQ,GAAG,YAAY,GAAG,uBAAuB,GAAG,UAAU,GAAG,SAAS,GAAG,SAAS,GAAG,oBAAoB,GAAG,UAAU,GAAG,UAAU,CAAC;AAEpK,wEAAwE;AACxE,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,eAAe,GAAG,WAAW,CAAC;AAEpE,mFAAmF;AACnF,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;AAEvD,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,aAAa,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,cAAc,CAAC;IACxB;;;OAGG;IACH,OAAO,EAAE,MAAM,CAAC;IAChB,kEAAkE;IAClE,YAAY,EAAE,MAAM,CAAC;IACrB,0EAA0E;IAC1E,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,cAAc,CAAC;IACxB,0EAA0E;IAC1E,YAAY,EAAE,UAAU,EAAE,CAAC;IAC3B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,mEAAmE;IACnE,iBAAiB,EAAE,MAAM,CAAC;IAC1B,2EAA2E;IAC3E,aAAa,EAAE,OAAO,CAAC;IACvB,+DAA+D;IAC/D,cAAc,EAAE,OAAO,CAAC;CACzB;AAqBD;;GAEG;AACH,eAAO,MAAM,aAAa,EAAE,SAAS,WAAW,EAwI/C,CAAC;AAOF;;GAEG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,aAAa,CAEtE;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,EAAE,EAAE,aAAa,GAAG,MAAM,GAAG,SAAS,GAAG,WAAW,GAAG,SAAS,CAM/F;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,CAEjE;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,CAEnE;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,UAAU,EAAE,UAAU,GAAG,OAAO,CAE/D;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,SAAS,UAAU,EAAE,GAAG,UAAU,EAAE,CAE3E;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,SAAS,UAAU,EAAE,GAAG,OAAO,CAEhF;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,SAAS,UAAU,EAAE,GAAG,UAAU,EAAE,CAI5E;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,OAAO,GAAG,SAAS,EAAE,KAAK,EAAE,SAAS,UAAU,EAAE,GAAG,OAAO,CAEvH;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,SAAS,UAAU,EAAE,GAAG,UAAU,EAAE,CAe/E;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,OAAO,GAAG,MAAM,CAM3E;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,EAAE,UAAU,GAAE,UAAkD,GAAG,MAAM,CAYhJ"}

package/dist/antenna/type.js

@@ -0,0 +1,265 @@
+import { Wavelength } from "../branded-types/wavelength.js";
+const WAVELENGTH_160 = Wavelength(160);
+const WAVELENGTH_80 = Wavelength(80);
+const WAVELENGTH_40 = Wavelength(40);
+const WAVELENGTH_30 = Wavelength(30);
+const WAVELENGTH_20 = Wavelength(20);
+const WAVELENGTH_17 = Wavelength(17);
+const WAVELENGTH_15 = Wavelength(15);
+const WAVELENGTH_12 = Wavelength(12);
+const WAVELENGTH_10 = Wavelength(10);
+const WAVELENGTH_6 = Wavelength(6);
+const WAVELENGTH_2 = Wavelength(2);
+const WAVELENGTH_70_CM = Wavelength(0.7);
+/** HF + 6 m wavelengths, longest first. Matches amateur SpectrumBand.wavelength values. */
+const HF_WAVELENGTHS = [WAVELENGTH_160, WAVELENGTH_80, WAVELENGTH_40, WAVELENGTH_30, WAVELENGTH_20, WAVELENGTH_17, WAVELENGTH_15, WAVELENGTH_12, WAVELENGTH_10, WAVELENGTH_6];
+const HF_40_TO_10 = [WAVELENGTH_40, WAVELENGTH_30, WAVELENGTH_20, WAVELENGTH_17, WAVELENGTH_15, WAVELENGTH_12, WAVELENGTH_10];
+const VHF_UHF = [WAVELENGTH_2, WAVELENGTH_70_CM];
+/**
+ * Built-in generic antenna families. Commercial SKUs can parameterize these later.
+ */
+export const ANTENNA_TYPES = [
+    {
+        id: "dipole",
+        label: "Dipole",
+        description: "Half-wave center-fed wire. Heading is the broadside direction of maximum radiation. Enable traps for a multi-band (for example 80/40) dipole.",
+        pattern: "bidirectional",
+        gainDbi: 2.15,
+        beamwidthDeg: 78,
+        frontToBackDb: 0,
+        takeoff: "medium",
+        defaultBands: [WAVELENGTH_40],
+        defaultHeightAglM: 10,
+        defaultHeadingDeg: 45,
+        supportsTraps: true,
+        defaultTrapped: false,
+    },
+    {
+        id: "inverted-v",
+        label: "Inverted-V",
+        description: "Center-supported dipole with sloping legs. Higher takeoff than a flat-top at the same apex. Enable traps for a multi-band wire.",
+        pattern: "bidirectional",
+        gainDbi: 1.5,
+        beamwidthDeg: 90,
+        frontToBackDb: 0,
+        takeoff: "high",
+        defaultBands: [WAVELENGTH_40],
+        defaultHeightAglM: 8,
+        defaultHeadingDeg: 45,
+        supportsTraps: true,
+        defaultTrapped: false,
+    },
+    {
+        id: "quarter-wave-vertical",
+        label: "Quarter-wave vertical",
+        description: "Ground-mounted or elevated vertical. Omnidirectional; heading is not used.",
+        pattern: "omni",
+        gainDbi: 1.5,
+        beamwidthDeg: 360,
+        frontToBackDb: 0,
+        takeoff: "medium",
+        defaultBands: [WAVELENGTH_40],
+        defaultHeightAglM: 2,
+        defaultHeadingDeg: 0,
+        supportsTraps: false,
+        defaultTrapped: false,
+    },
+    {
+        id: "yagi-3el",
+        label: "3-element Yagi",
+        description: "Directive trap tribander (typically 20/15/10). Heading is the boom direction of maximum gain.",
+        pattern: "directive",
+        gainDbi: 7,
+        beamwidthDeg: 66,
+        frontToBackDb: 20,
+        takeoff: "low",
+        defaultBands: [WAVELENGTH_20, WAVELENGTH_15, WAVELENGTH_10],
+        defaultHeightAglM: 15,
+        defaultHeadingDeg: 45,
+        supportsTraps: true,
+        defaultTrapped: true,
+    },
+    {
+        id: "magloop",
+        label: "Magnetic loop",
+        description: "Small transmitting loop. Roughly omnidirectional; efficiency is lower than a full-size wire.",
+        pattern: "omni",
+        gainDbi: 0,
+        beamwidthDeg: 360,
+        frontToBackDb: 0,
+        takeoff: "high",
+        defaultBands: HF_40_TO_10,
+        defaultHeightAglM: 2,
+        defaultHeadingDeg: 0,
+        supportsTraps: false,
+        defaultTrapped: false,
+    },
+    {
+        id: "end-fed",
+        label: "End-fed",
+        description: "End-fed half-wave or random wire. Heading is the broadside of the wire.",
+        pattern: "bidirectional",
+        gainDbi: 2,
+        beamwidthDeg: 90,
+        frontToBackDb: 0,
+        takeoff: "medium",
+        defaultBands: HF_40_TO_10,
+        defaultHeightAglM: 10,
+        defaultHeadingDeg: 45,
+        supportsTraps: false,
+        defaultTrapped: false,
+    },
+    {
+        id: "dual-band-vertical",
+        label: "Dual-band vertical",
+        description: "2 m / 70 cm omnidirectional (J-pole, collinear, or dual-band whip). Heading is not used.",
+        pattern: "omni",
+        gainDbi: 4.5,
+        beamwidthDeg: 360,
+        frontToBackDb: 0,
+        takeoff: "low",
+        defaultBands: VHF_UHF,
+        defaultHeightAglM: 8,
+        defaultHeadingDeg: 0,
+        supportsTraps: false,
+        defaultTrapped: false,
+    },
+    {
+        id: "vhf-yagi",
+        label: "2 m Yagi",
+        description: "Directive 2 m beam. Heading is the boom direction of maximum gain.",
+        pattern: "directive",
+        gainDbi: 10,
+        beamwidthDeg: 42,
+        frontToBackDb: 18,
+        takeoff: "low",
+        defaultBands: [WAVELENGTH_2],
+        defaultHeightAglM: 10,
+        defaultHeadingDeg: 45,
+        supportsTraps: false,
+        defaultTrapped: false,
+    },
+    {
+        id: "uhf-yagi",
+        label: "70 cm Yagi",
+        description: "Directive 70 cm beam. Heading is the boom direction of maximum gain.",
+        pattern: "directive",
+        gainDbi: 12,
+        beamwidthDeg: 36,
+        frontToBackDb: 18,
+        takeoff: "low",
+        defaultBands: [WAVELENGTH_70_CM],
+        defaultHeightAglM: 10,
+        defaultHeadingDeg: 45,
+        supportsTraps: false,
+        defaultTrapped: false,
+    },
+];
+/** Catalog loss for LC traps. Not a manufacturer efficiency spec. */
+const TRAP_GAIN_LOSS_DBI = 0.5;
+const ANTENNA_TYPE_IDS = new Set(ANTENNA_TYPES.map((type) => type.id));
+/**
+ * Returns whether `value` is a built-in antenna type id.
+ */
+export function isAntennaTypeId(value) {
+    return typeof value === "string" && ANTENNA_TYPE_IDS.has(value);
+}
+/**
+ * Looks up a built-in antenna type, or undefined when the id is unknown.
+ */
+export function antennaTypeById(id) {
+    if (!id) {
+        return undefined;
+    }
+    return ANTENNA_TYPES.find((type) => type.id === id);
+}
+/**
+ * True when the operator should enter a heading (not omnidirectional).
+ */
+export function antennaTypeUsesHeading(type) {
+    return type.pattern !== "omni";
+}
+/**
+ * True for dipoles, inverted-Vs, and HF Yagis — not VHF/UHF beams or omni verticals.
+ */
+export function antennaTypeSupportsTraps(type) {
+    return type.supportsTraps;
+}
+/**
+ * HF / 6 m. 2 m (2) and 70 cm (0.7) are VHF/UHF.
+ */
+export function isHfAntennaBand(wavelength) {
+    return wavelength >= 6;
+}
+/**
+ * Catalog order: longest wavelength first.
+ */
+export function sortAntennaBands(bands) {
+    return [...new Set(bands)].sort((left, right) => right - left);
+}
+/**
+ * True when every tagged band is VHF/UHF FM (2 m / 70 cm), not HF skywave.
+ */
+export function antennaBandsAreLineOfSight(bands) {
+    return bands.length > 0 && bands.every((wavelength) => wavelength <= 2);
+}
+/**
+ * Trap resonant frequencies: every tagged HF band except the lowest (the full-size fundamental).
+ *
+ * An 80/40 dipole traps at 40 m. A 20/15/10 tribander traps at 15 m and 10 m.
+ */
+export function trapResonantBands(bands) {
+    const hf = sortAntennaBands(bands).filter(isHfAntennaBand);
+    return hf.slice(1);
+}
+/**
+ * True when this installation uses traps on two or more HF bands.
+ */
+export function antennaIsTrapped(type, trapped, bands) {
+    return type.supportsTraps && trapped === true && trapResonantBands(bands).length > 0;
+}
+/**
+ * When traps are turned on with only one HF band, add the next-lower ham band as the fundamental
+ * (40 m → 80/40). If the tag is already 160 m, add 80 m as the trap frequency.
+ */
+export function bandsForEnabledTraps(bands) {
+    if (trapResonantBands(bands).length > 0) {
+        return sortAntennaBands(bands);
+    }
+    const present = HF_WAVELENGTHS.filter((wavelength) => bands.includes(wavelength));
+    const current = present[0] ?? WAVELENGTH_40;
+    const index = HF_WAVELENGTHS.indexOf(current);
+    const added = index > 0 ? HF_WAVELENGTHS[index - 1] : HF_WAVELENGTHS[index + 1];
+    if (!added) {
+        return sortAntennaBands(bands.length > 0 ? bands : [current]);
+    }
+    return sortAntennaBands([...bands, current, added]);
+}
+/**
+ * Peak gain with a small catalog derate when traps are in the elements.
+ */
+export function estimateGainDbi(type, trapped) {
+    if (!trapped) {
+        return type.gainDbi;
+    }
+    return Math.round((type.gainDbi - TRAP_GAIN_LOSS_DBI) * 100) / 100;
+}
+/**
+ * Heuristic takeoff of the main lobe in degrees, from type and height in wavelengths.
+ *
+ * This is a catalog rule of thumb for skip rings, not an EZNEC elevation plot.
+ */
+export function estimateTakeoffDeg(type, heightAglM, wavelength = type.defaultBands[0] ?? WAVELENGTH_40) {
+    const heights = Math.max(0.1, heightAglM / wavelength);
+    if (type.takeoff === "high") {
+        return clamp(Math.round(52 - heights * 10), 25, 70);
+    }
+    if (type.takeoff === "low") {
+        return clamp(Math.round(24 - heights * 8), 6, 25);
+    }
+    return clamp(Math.round(36 - heights * 12), 10, 45);
+}
+function clamp(value, min, max) {
+    return Math.min(max, Math.max(min, value));
+}
+//# sourceMappingURL=type.js.map

package/dist/antenna/type.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"type.js","sourceRoot":"","sources":["../../src/antenna/type.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -37,4 +37,7 @@ export * from "./spectrum/band.js";
 export * from "./spectrum/channel.js";
 export * from "./spectrum/mode.js";
 export * from "./spectrum/privilege.js";
+export * from "./antenna/type.js";
+export * from "./station/radio-station.js";
+export * from "./station/antenna.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,8BAA8B,CAAC;AAC7C,cAAc,qCAAqC,CAAC;AACpD,cAAc,qCAAqC,CAAC;AACpD,cAAc,mCAAmC,CAAC;AAClD,cAAc,oCAAoC,CAAC;AACnD,cAAc,qCAAqC,CAAC;AACpD,cAAc,qCAAqC,CAAC;AACpD,cAAc,0CAA0C,CAAC;AACzD,cAAc,+BAA+B,CAAC;AAE9C,cAAc,oBAAoB,CAAC;AAEnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC;AACjC,cAAc,0BAA0B,CAAC;AACzC,cAAc,uBAAuB,CAAC;AACtC,cAAc,kBAAkB,CAAC;AACjC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,mBAAmB,CAAC;AAClC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,eAAe,CAAC;AAC9B,cAAc,0BAA0B,CAAC;AACzC,cAAc,uBAAuB,CAAC;AACtC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,qBAAqB,CAAC;AACpC,cAAc,kBAAkB,CAAC;AACjC,cAAc,mBAAmB,CAAC;AAClC,cAAc,0BAA0B,CAAC;AACzC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,qBAAqB,CAAC;AACpC,cAAc,iBAAiB,CAAC;AAChC,cAAc,uBAAuB,CAAC;AAEtC,cAAc,oBAAoB,CAAC;AACnC,cAAc,uBAAuB,CAAC;AACtC,cAAc,oBAAoB,CAAC;AACnC,cAAc,yBAAyB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,8BAA8B,CAAC;AAC7C,cAAc,qCAAqC,CAAC;AACpD,cAAc,qCAAqC,CAAC;AACpD,cAAc,mCAAmC,CAAC;AAClD,cAAc,oCAAoC,CAAC;AACnD,cAAc,qCAAqC,CAAC;AACpD,cAAc,qCAAqC,CAAC;AACpD,cAAc,0CAA0C,CAAC;AACzD,cAAc,+BAA+B,CAAC;AAE9C,cAAc,oBAAoB,CAAC;AAEnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC;AACjC,cAAc,0BAA0B,CAAC;AACzC,cAAc,uBAAuB,CAAC;AACtC,cAAc,kBAAkB,CAAC;AACjC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,mBAAmB,CAAC;AAClC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,eAAe,CAAC;AAC9B,cAAc,0BAA0B,CAAC;AACzC,cAAc,uBAAuB,CAAC;AACtC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,qBAAqB,CAAC;AACpC,cAAc,kBAAkB,CAAC;AACjC,cAAc,mBAAmB,CAAC;AAClC,cAAc,0BAA0B,CAAC;AACzC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,qBAAqB,CAAC;AACpC,cAAc,iBAAiB,CAAC;AAChC,cAAc,uBAAuB,CAAC;AAEtC,cAAc,oBAAoB,CAAC;AACnC,cAAc,uBAAuB,CAAC;AACtC,cAAc,oBAAoB,CAAC;AACnC,cAAc,yBAAyB,CAAC;AAExC,cAAc,mBAAmB,CAAC;AAElC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,sBAAsB,CAAC"}

package/dist/index.js

@@ -37,4 +37,7 @@ export * from "./spectrum/band.js";
 export * from "./spectrum/channel.js";
 export * from "./spectrum/mode.js";
 export * from "./spectrum/privilege.js";
+export * from "./antenna/type.js";
+export * from "./station/radio-station.js";
+export * from "./station/antenna.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,8BAA8B,CAAC;AAC7C,cAAc,qCAAqC,CAAC;AACpD,cAAc,qCAAqC,CAAC;AACpD,cAAc,mCAAmC,CAAC;AAClD,cAAc,oCAAoC,CAAC;AACnD,cAAc,qCAAqC,CAAC;AACpD,cAAc,qCAAqC,CAAC;AACpD,cAAc,0CAA0C,CAAC;AACzD,cAAc,+BAA+B,CAAC;AAE9C,cAAc,oBAAoB,CAAC;AAEnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC;AACjC,cAAc,0BAA0B,CAAC;AACzC,cAAc,uBAAuB,CAAC;AACtC,cAAc,kBAAkB,CAAC;AACjC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,mBAAmB,CAAC;AAClC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,eAAe,CAAC;AAC9B,cAAc,0BAA0B,CAAC;AACzC,cAAc,uBAAuB,CAAC;AACtC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,qBAAqB,CAAC;AACpC,cAAc,kBAAkB,CAAC;AACjC,cAAc,mBAAmB,CAAC;AAClC,cAAc,0BAA0B,CAAC;AACzC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,qBAAqB,CAAC;AACpC,cAAc,iBAAiB,CAAC;AAChC,cAAc,uBAAuB,CAAC;AAEtC,cAAc,oBAAoB,CAAC;AACnC,cAAc,uBAAuB,CAAC;AACtC,cAAc,oBAAoB,CAAC;AACnC,cAAc,yBAAyB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,8BAA8B,CAAC;AAC7C,cAAc,qCAAqC,CAAC;AACpD,cAAc,qCAAqC,CAAC;AACpD,cAAc,mCAAmC,CAAC;AAClD,cAAc,oCAAoC,CAAC;AACnD,cAAc,qCAAqC,CAAC;AACpD,cAAc,qCAAqC,CAAC;AACpD,cAAc,0CAA0C,CAAC;AACzD,cAAc,+BAA+B,CAAC;AAE9C,cAAc,oBAAoB,CAAC;AAEnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC;AACjC,cAAc,0BAA0B,CAAC;AACzC,cAAc,uBAAuB,CAAC;AACtC,cAAc,kBAAkB,CAAC;AACjC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,mBAAmB,CAAC;AAClC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,eAAe,CAAC;AAC9B,cAAc,0BAA0B,CAAC;AACzC,cAAc,uBAAuB,CAAC;AACtC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,qBAAqB,CAAC;AACpC,cAAc,kBAAkB,CAAC;AACjC,cAAc,mBAAmB,CAAC;AAClC,cAAc,0BAA0B,CAAC;AACzC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,qBAAqB,CAAC;AACpC,cAAc,iBAAiB,CAAC;AAChC,cAAc,uBAAuB,CAAC;AAEtC,cAAc,oBAAoB,CAAC;AACnC,cAAc,uBAAuB,CAAC;AACtC,cAAc,oBAAoB,CAAC;AACnC,cAAc,yBAAyB,CAAC;AAExC,cAAc,mBAAmB,CAAC;AAElC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,sBAAsB,CAAC"}

package/dist/station/antenna.d.ts

@@ -0,0 +1,25 @@
+import type { Wavelength } from "../branded-types/wavelength.js";
+import type { AntennaTypeId } from "../antenna/type.js";
+export declare const MIN_ANTENNA_HEIGHT_AGL_M = 0.5;
+export declare const MAX_ANTENNA_HEIGHT_AGL_M = 120;
+/**
+ * One physical antenna at one station.
+ *
+ * The same radiator at two sites is two records. `bands` are ham
+ * {@link SpectrumBand.wavelength} values, not a second band catalog.
+ */
+export interface StationAntenna {
+    id: string;
+    stationId: string;
+    nickname: string;
+    typeId: AntennaTypeId;
+    heightAglM: number;
+    /** True heading of maximum radiation, 0–359. Omitted for omni types. */
+    headingDeg?: number;
+    bands: Wavelength[];
+    /** LC traps in the elements. Omitted when the type is a single-band or trapless. */
+    trapped?: boolean;
+    createdAt: number;
+    updatedAt: number;
+}
+//# sourceMappingURL=antenna.d.ts.map

package/dist/station/antenna.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"antenna.d.ts","sourceRoot":"","sources":["../../src/station/antenna.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gCAAgC,CAAC;AACjE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAExD,eAAO,MAAM,wBAAwB,MAAM,CAAC;AAC5C,eAAO,MAAM,wBAAwB,MAAM,CAAC;AAE5C;;;;;GAKG;AACH,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,aAAa,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,wEAAwE;IACxE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,UAAU,EAAE,CAAC;IACpB,oFAAoF;IACpF,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB"}

package/dist/station/antenna.js

@@ -0,0 +1,3 @@
+export const MIN_ANTENNA_HEIGHT_AGL_M = 0.5;
+export const MAX_ANTENNA_HEIGHT_AGL_M = 120;
+//# sourceMappingURL=antenna.js.map

package/dist/station/antenna.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"antenna.js","sourceRoot":"","sources":["../../src/station/antenna.ts"],"names":[],"mappings":"AAGA,MAAM,CAAC,MAAM,wBAAwB,GAAG,GAAG,CAAC;AAC5C,MAAM,CAAC,MAAM,wBAAwB,GAAG,GAAG,CAAC"}

package/dist/station/radio-station.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Default Home site id. HamBench always has at least this station.
+ */
+export declare const HOME_STATION_ID = "station-home";
+export declare const MIN_LATITUDE = -90;
+export declare const MAX_LATITUDE = 90;
+export declare const MIN_LONGITUDE = -180;
+export declare const MAX_LONGITUDE = 180;
+/**
+ * Whether the operator last edited the Maidenhead grid or the coordinates.
+ *
+ * Editing the grid sets lat/lon to the cell center. Editing coordinates keeps
+ * that point and derives a 6-character grid.
+ */
+export type StationLocationSource = "grid" | "coordinates";
+/**
+ * An operating site (Home, Cabin, Portable), not a log STATION_CALLSIGN.
+ *
+ * Latitude and longitude are signed decimal degrees (south / west negative).
+ * UIs may collect them as degrees, minutes, and decimal seconds.
+ */
+export interface RadioStation {
+    id: string;
+    nickname: string;
+    gridsquare?: string;
+    latitude?: number;
+    longitude?: number;
+    locationSource?: StationLocationSource;
+    createdAt: number;
+    updatedAt: number;
+}
+//# sourceMappingURL=radio-station.d.ts.map

package/dist/station/radio-station.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"radio-station.d.ts","sourceRoot":"","sources":["../../src/station/radio-station.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,eAAO,MAAM,eAAe,iBAAiB,CAAC;AAE9C,eAAO,MAAM,YAAY,MAAM,CAAC;AAChC,eAAO,MAAM,YAAY,KAAK,CAAC;AAC/B,eAAO,MAAM,aAAa,OAAO,CAAC;AAClC,eAAO,MAAM,aAAa,MAAM,CAAC;AAEjC;;;;;GAKG;AACH,MAAM,MAAM,qBAAqB,GAAG,MAAM,GAAG,aAAa,CAAC;AAE3D;;;;;GAKG;AACH,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,qBAAqB,CAAC;IACvC,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB"}

package/dist/station/radio-station.js

@@ -0,0 +1,9 @@
+/**
+ * Default Home site id. HamBench always has at least this station.
+ */
+export const HOME_STATION_ID = "station-home";
+export const MIN_LATITUDE = -90;
+export const MAX_LATITUDE = 90;
+export const MIN_LONGITUDE = -180;
+export const MAX_LONGITUDE = 180;
+//# sourceMappingURL=radio-station.js.map

package/dist/station/radio-station.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"radio-station.js","sourceRoot":"","sources":["../../src/station/radio-station.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,cAAc,CAAC;AAE9C,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,EAAE,CAAC;AAChC,MAAM,CAAC,MAAM,YAAY,GAAG,EAAE,CAAC;AAC/B,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,GAAG,CAAC;AAClC,MAAM,CAAC,MAAM,aAAa,GAAG,GAAG,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@springfield/ham-radio-api",
-  "version": "17.8.0",
+  "version": "17.9.0",
   "author": "Bryan Hunt",
   "files": [
     "dist/",
@@ -18,6 +18,7 @@
   },
   "scripts": {
     "build": "tsc",
+    "test": "node --experimental-strip-types --test test/unit/*.test.ts",
     "commitlint": "commitlint --edit",
     "format": "oxfmt",
     "lint": "oxlint",

package/src/antenna/type.ts

@@ -0,0 +1,326 @@
+import { Wavelength } from "../branded-types/wavelength.js";
+
+export type AntennaTypeId = "dipole" | "inverted-v" | "quarter-wave-vertical" | "yagi-3el" | "magloop" | "end-fed" | "dual-band-vertical" | "vhf-yagi" | "uhf-yagi";
+
+/** How energy is distributed in azimuth. Heading is unused for omni. */
+export type AntennaPattern = "omni" | "bidirectional" | "directive";
+
+/** Coarse elevation character. Skip rings use type plus height, not this alone. */
+export type AntennaTakeoff = "high" | "medium" | "low";
+
+export interface AntennaType {
+  id: AntennaTypeId;
+  label: string;
+  description: string;
+  pattern: AntennaPattern;
+  /**
+   * Typical peak gain in dBi. Catalog estimate for a generic of this family,
+   * not a manufacturer measurement or NEC run.
+   */
+  gainDbi: number;
+  /** Azimuth beamwidth of the main lobe in degrees. Omni is 360. */
+  beamwidthDeg: number;
+  /** Typical front-to-back ratio in dB. Zero for omni and bidirectional. */
+  frontToBackDb: number;
+  takeoff: AntennaTakeoff;
+  /** Ham bands this family typically covers, as SpectrumBand.wavelength. */
+  defaultBands: Wavelength[];
+  defaultHeightAglM: number;
+  /** True heading of maximum radiation when the type is not omni. */
+  defaultHeadingDeg: number;
+  /** Dipoles, inverted-Vs, and HF beams can use LC traps for extra bands. */
+  supportsTraps: boolean;
+  /** Tribanders start trapped; a single-band dipole does not. */
+  defaultTrapped: boolean;
+}
+
+const WAVELENGTH_160 = Wavelength(160);
+const WAVELENGTH_80 = Wavelength(80);
+const WAVELENGTH_40 = Wavelength(40);
+const WAVELENGTH_30 = Wavelength(30);
+const WAVELENGTH_20 = Wavelength(20);
+const WAVELENGTH_17 = Wavelength(17);
+const WAVELENGTH_15 = Wavelength(15);
+const WAVELENGTH_12 = Wavelength(12);
+const WAVELENGTH_10 = Wavelength(10);
+const WAVELENGTH_6 = Wavelength(6);
+const WAVELENGTH_2 = Wavelength(2);
+const WAVELENGTH_70_CM = Wavelength(0.7);
+
+/** HF + 6 m wavelengths, longest first. Matches amateur SpectrumBand.wavelength values. */
+const HF_WAVELENGTHS: readonly Wavelength[] = [WAVELENGTH_160, WAVELENGTH_80, WAVELENGTH_40, WAVELENGTH_30, WAVELENGTH_20, WAVELENGTH_17, WAVELENGTH_15, WAVELENGTH_12, WAVELENGTH_10, WAVELENGTH_6];
+
+const HF_40_TO_10: Wavelength[] = [WAVELENGTH_40, WAVELENGTH_30, WAVELENGTH_20, WAVELENGTH_17, WAVELENGTH_15, WAVELENGTH_12, WAVELENGTH_10];
+const VHF_UHF: Wavelength[] = [WAVELENGTH_2, WAVELENGTH_70_CM];
+
+/**
+ * Built-in generic antenna families. Commercial SKUs can parameterize these later.
+ */
+export const ANTENNA_TYPES: readonly AntennaType[] = [
+  {
+    id: "dipole",
+    label: "Dipole",
+    description: "Half-wave center-fed wire. Heading is the broadside direction of maximum radiation. Enable traps for a multi-band (for example 80/40) dipole.",
+    pattern: "bidirectional",
+    gainDbi: 2.15,
+    beamwidthDeg: 78,
+    frontToBackDb: 0,
+    takeoff: "medium",
+    defaultBands: [WAVELENGTH_40],
+    defaultHeightAglM: 10,
+    defaultHeadingDeg: 45,
+    supportsTraps: true,
+    defaultTrapped: false,
+  },
+  {
+    id: "inverted-v",
+    label: "Inverted-V",
+    description: "Center-supported dipole with sloping legs. Higher takeoff than a flat-top at the same apex. Enable traps for a multi-band wire.",
+    pattern: "bidirectional",
+    gainDbi: 1.5,
+    beamwidthDeg: 90,
+    frontToBackDb: 0,
+    takeoff: "high",
+    defaultBands: [WAVELENGTH_40],
+    defaultHeightAglM: 8,
+    defaultHeadingDeg: 45,
+    supportsTraps: true,
+    defaultTrapped: false,
+  },
+  {
+    id: "quarter-wave-vertical",
+    label: "Quarter-wave vertical",
+    description: "Ground-mounted or elevated vertical. Omnidirectional; heading is not used.",
+    pattern: "omni",
+    gainDbi: 1.5,
+    beamwidthDeg: 360,
+    frontToBackDb: 0,
+    takeoff: "medium",
+    defaultBands: [WAVELENGTH_40],
+    defaultHeightAglM: 2,
+    defaultHeadingDeg: 0,
+    supportsTraps: false,
+    defaultTrapped: false,
+  },
+  {
+    id: "yagi-3el",
+    label: "3-element Yagi",
+    description: "Directive trap tribander (typically 20/15/10). Heading is the boom direction of maximum gain.",
+    pattern: "directive",
+    gainDbi: 7,
+    beamwidthDeg: 66,
+    frontToBackDb: 20,
+    takeoff: "low",
+    defaultBands: [WAVELENGTH_20, WAVELENGTH_15, WAVELENGTH_10],
+    defaultHeightAglM: 15,
+    defaultHeadingDeg: 45,
+    supportsTraps: true,
+    defaultTrapped: true,
+  },
+  {
+    id: "magloop",
+    label: "Magnetic loop",
+    description: "Small transmitting loop. Roughly omnidirectional; efficiency is lower than a full-size wire.",
+    pattern: "omni",
+    gainDbi: 0,
+    beamwidthDeg: 360,
+    frontToBackDb: 0,
+    takeoff: "high",
+    defaultBands: HF_40_TO_10,
+    defaultHeightAglM: 2,
+    defaultHeadingDeg: 0,
+    supportsTraps: false,
+    defaultTrapped: false,
+  },
+  {
+    id: "end-fed",
+    label: "End-fed",
+    description: "End-fed half-wave or random wire. Heading is the broadside of the wire.",
+    pattern: "bidirectional",
+    gainDbi: 2,
+    beamwidthDeg: 90,
+    frontToBackDb: 0,
+    takeoff: "medium",
+    defaultBands: HF_40_TO_10,
+    defaultHeightAglM: 10,
+    defaultHeadingDeg: 45,
+    supportsTraps: false,
+    defaultTrapped: false,
+  },
+  {
+    id: "dual-band-vertical",
+    label: "Dual-band vertical",
+    description: "2 m / 70 cm omnidirectional (J-pole, collinear, or dual-band whip). Heading is not used.",
+    pattern: "omni",
+    gainDbi: 4.5,
+    beamwidthDeg: 360,
+    frontToBackDb: 0,
+    takeoff: "low",
+    defaultBands: VHF_UHF,
+    defaultHeightAglM: 8,
+    defaultHeadingDeg: 0,
+    supportsTraps: false,
+    defaultTrapped: false,
+  },
+  {
+    id: "vhf-yagi",
+    label: "2 m Yagi",
+    description: "Directive 2 m beam. Heading is the boom direction of maximum gain.",
+    pattern: "directive",
+    gainDbi: 10,
+    beamwidthDeg: 42,
+    frontToBackDb: 18,
+    takeoff: "low",
+    defaultBands: [WAVELENGTH_2],
+    defaultHeightAglM: 10,
+    defaultHeadingDeg: 45,
+    supportsTraps: false,
+    defaultTrapped: false,
+  },
+  {
+    id: "uhf-yagi",
+    label: "70 cm Yagi",
+    description: "Directive 70 cm beam. Heading is the boom direction of maximum gain.",
+    pattern: "directive",
+    gainDbi: 12,
+    beamwidthDeg: 36,
+    frontToBackDb: 18,
+    takeoff: "low",
+    defaultBands: [WAVELENGTH_70_CM],
+    defaultHeightAglM: 10,
+    defaultHeadingDeg: 45,
+    supportsTraps: false,
+    defaultTrapped: false,
+  },
+];
+
+/** Catalog loss for LC traps. Not a manufacturer efficiency spec. */
+const TRAP_GAIN_LOSS_DBI = 0.5;
+
+const ANTENNA_TYPE_IDS = new Set<string>(ANTENNA_TYPES.map((type) => type.id));
+
+/**
+ * Returns whether `value` is a built-in antenna type id.
+ */
+export function isAntennaTypeId(value: unknown): value is AntennaTypeId {
+  return typeof value === "string" && ANTENNA_TYPE_IDS.has(value);
+}
+
+/**
+ * Looks up a built-in antenna type, or undefined when the id is unknown.
+ */
+export function antennaTypeById(id: AntennaTypeId | string | undefined): AntennaType | undefined {
+  if (!id) {
+    return undefined;
+  }
+
+  return ANTENNA_TYPES.find((type) => type.id === id);
+}
+
+/**
+ * True when the operator should enter a heading (not omnidirectional).
+ */
+export function antennaTypeUsesHeading(type: AntennaType): boolean {
+  return type.pattern !== "omni";
+}
+
+/**
+ * True for dipoles, inverted-Vs, and HF Yagis — not VHF/UHF beams or omni verticals.
+ */
+export function antennaTypeSupportsTraps(type: AntennaType): boolean {
+  return type.supportsTraps;
+}
+
+/**
+ * HF / 6 m. 2 m (2) and 70 cm (0.7) are VHF/UHF.
+ */
+export function isHfAntennaBand(wavelength: Wavelength): boolean {
+  return wavelength >= 6;
+}
+
+/**
+ * Catalog order: longest wavelength first.
+ */
+export function sortAntennaBands(bands: readonly Wavelength[]): Wavelength[] {
+  return [...new Set(bands)].sort((left, right) => right - left);
+}
+
+/**
+ * True when every tagged band is VHF/UHF FM (2 m / 70 cm), not HF skywave.
+ */
+export function antennaBandsAreLineOfSight(bands: readonly Wavelength[]): boolean {
+  return bands.length > 0 && bands.every((wavelength) => wavelength <= 2);
+}
+
+/**
+ * Trap resonant frequencies: every tagged HF band except the lowest (the full-size fundamental).
+ *
+ * An 80/40 dipole traps at 40 m. A 20/15/10 tribander traps at 15 m and 10 m.
+ */
+export function trapResonantBands(bands: readonly Wavelength[]): Wavelength[] {
+  const hf = sortAntennaBands(bands).filter(isHfAntennaBand);
+
+  return hf.slice(1);
+}
+
+/**
+ * True when this installation uses traps on two or more HF bands.
+ */
+export function antennaIsTrapped(type: AntennaType, trapped: boolean | undefined, bands: readonly Wavelength[]): boolean {
+  return type.supportsTraps && trapped === true && trapResonantBands(bands).length > 0;
+}
+
+/**
+ * When traps are turned on with only one HF band, add the next-lower ham band as the fundamental
+ * (40 m → 80/40). If the tag is already 160 m, add 80 m as the trap frequency.
+ */
+export function bandsForEnabledTraps(bands: readonly Wavelength[]): Wavelength[] {
+  if (trapResonantBands(bands).length > 0) {
+    return sortAntennaBands(bands);
+  }
+
+  const present = HF_WAVELENGTHS.filter((wavelength) => bands.includes(wavelength));
+  const current = present[0] ?? WAVELENGTH_40;
+  const index = HF_WAVELENGTHS.indexOf(current);
+  const added = index > 0 ? HF_WAVELENGTHS[index - 1] : HF_WAVELENGTHS[index + 1];
+
+  if (!added) {
+    return sortAntennaBands(bands.length > 0 ? bands : [current]);
+  }
+
+  return sortAntennaBands([...bands, current, added]);
+}
+
+/**
+ * Peak gain with a small catalog derate when traps are in the elements.
+ */
+export function estimateGainDbi(type: AntennaType, trapped: boolean): number {
+  if (!trapped) {
+    return type.gainDbi;
+  }
+
+  return Math.round((type.gainDbi - TRAP_GAIN_LOSS_DBI) * 100) / 100;
+}
+
+/**
+ * Heuristic takeoff of the main lobe in degrees, from type and height in wavelengths.
+ *
+ * This is a catalog rule of thumb for skip rings, not an EZNEC elevation plot.
+ */
+export function estimateTakeoffDeg(type: AntennaType, heightAglM: number, wavelength: Wavelength = type.defaultBands[0] ?? WAVELENGTH_40): number {
+  const heights = Math.max(0.1, heightAglM / wavelength);
+
+  if (type.takeoff === "high") {
+    return clamp(Math.round(52 - heights * 10), 25, 70);
+  }
+
+  if (type.takeoff === "low") {
+    return clamp(Math.round(24 - heights * 8), 6, 25);
+  }
+
+  return clamp(Math.round(36 - heights * 12), 10, 45);
+}
+
+function clamp(value: number, min: number, max: number): number {
+  return Math.min(max, Math.max(min, value));
+}

package/src/index.ts

@@ -40,3 +40,8 @@ export * from "./spectrum/band.js";
 export * from "./spectrum/channel.js";
 export * from "./spectrum/mode.js";
 export * from "./spectrum/privilege.js";
+
+export * from "./antenna/type.js";
+
+export * from "./station/radio-station.js";
+export * from "./station/antenna.js";

package/src/station/antenna.ts

@@ -0,0 +1,26 @@
+import type { Wavelength } from "../branded-types/wavelength.js";
+import type { AntennaTypeId } from "../antenna/type.js";
+
+export const MIN_ANTENNA_HEIGHT_AGL_M = 0.5;
+export const MAX_ANTENNA_HEIGHT_AGL_M = 120;
+
+/**
+ * One physical antenna at one station.
+ *
+ * The same radiator at two sites is two records. `bands` are ham
+ * {@link SpectrumBand.wavelength} values, not a second band catalog.
+ */
+export interface StationAntenna {
+  id: string;
+  stationId: string;
+  nickname: string;
+  typeId: AntennaTypeId;
+  heightAglM: number;
+  /** True heading of maximum radiation, 0–359. Omitted for omni types. */
+  headingDeg?: number;
+  bands: Wavelength[];
+  /** LC traps in the elements. Omitted when the type is a single-band or trapless. */
+  trapped?: boolean;
+  createdAt: number;
+  updatedAt: number;
+}

package/src/station/radio-station.ts

@@ -0,0 +1,34 @@
+/**
+ * Default Home site id. HamBench always has at least this station.
+ */
+export const HOME_STATION_ID = "station-home";
+
+export const MIN_LATITUDE = -90;
+export const MAX_LATITUDE = 90;
+export const MIN_LONGITUDE = -180;
+export const MAX_LONGITUDE = 180;
+
+/**
+ * Whether the operator last edited the Maidenhead grid or the coordinates.
+ *
+ * Editing the grid sets lat/lon to the cell center. Editing coordinates keeps
+ * that point and derives a 6-character grid.
+ */
+export type StationLocationSource = "grid" | "coordinates";
+
+/**
+ * An operating site (Home, Cabin, Portable), not a log STATION_CALLSIGN.
+ *
+ * Latitude and longitude are signed decimal degrees (south / west negative).
+ * UIs may collect them as degrees, minutes, and decimal seconds.
+ */
+export interface RadioStation {
+  id: string;
+  nickname: string;
+  gridsquare?: string;
+  latitude?: number;
+  longitude?: number;
+  locationSource?: StationLocationSource;
+  createdAt: number;
+  updatedAt: number;
+}