@springfield/ham-radio-api 18.0.1 → 18.1.0

package/LICENSE

@@ -0,0 +1,18 @@
+MIT License
+
+Copyright (c) 2026 Bryan Hunt
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and
+associated documentation files (the "Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the
+following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial
+portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT
+LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO
+EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
+IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE
+USE OR OTHER DEALINGS IN THE SOFTWARE.

package/README.md

@@ -6,6 +6,10 @@ Packages that talk to radios depend on this library. It does not open a serial p
 
 Docs: [HamBench developer docs](https://springfield-ham-radio.github.io/ham-radio-docs/developer/)
 
+## License
+
+MIT — Copyright (c) 2026 Bryan Hunt. See [LICENSE](LICENSE).
+
 ```bash
 corepack enable
 yarn install

package/dist/index.d.ts

@@ -38,6 +38,7 @@ export * from "./spectrum/channel.js";
 export * from "./spectrum/mode.js";
 export * from "./spectrum/privilege.js";
 export * from "./antenna/type.js";
+export * from "./station/geo-point.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;AAExC,cAAc,mBAAmB,CAAC;AAElC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,sBAAsB,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,wBAAwB,CAAC;AACvC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,sBAAsB,CAAC"}

package/dist/index.js

@@ -38,6 +38,7 @@ export * from "./spectrum/channel.js";
 export * from "./spectrum/mode.js";
 export * from "./spectrum/privilege.js";
 export * from "./antenna/type.js";
+export * from "./station/geo-point.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;AAExC,cAAc,mBAAmB,CAAC;AAElC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,sBAAsB,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,wBAAwB,CAAC;AACvC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,sBAAsB,CAAC"}

package/dist/station/geo-point.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Canonical geographic point for station sites and related APIs.
+ *
+ * **Decision (issue #19):** coordinates are {@link GeoPoint} with signed decimal
+ * degrees on WGS84. SQLite stores two REAL columns (`latitude`, `longitude`).
+ * GeoJSON Point (`[longitude, latitude]`, RFC 7946) is used only at map/API
+ * boundaries — no GeoJSON blobs in the database and no spatial extensions or
+ * indexes. Maidenhead grid squares are a derived display format, stored only
+ * where exchanged (station `gridsquare`, QSO grids). String sources such as
+ * Callook are parsed at the edge; lat/lon in this package are always numbers.
+ */
+export declare const MIN_LATITUDE = -90;
+export declare const MAX_LATITUDE = 90;
+export declare const MIN_LONGITUDE = -180;
+export declare const MAX_LONGITUDE = 180;
+/**
+ * A point on the WGS84 ellipsoid as signed decimal degrees (south / west negative).
+ */
+export interface GeoPoint {
+    latitude: number;
+    longitude: number;
+}
+/**
+ * Returns whether `value` is a {@link GeoPoint} with finite coordinates inside
+ * {@link MIN_LATITUDE}–{@link MAX_LATITUDE} and {@link MIN_LONGITUDE}–{@link MAX_LONGITUDE}.
+ */
+export declare function isGeoPoint(value: unknown): value is GeoPoint;
+//# sourceMappingURL=geo-point.d.ts.map

package/dist/station/geo-point.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"geo-point.d.ts","sourceRoot":"","sources":["../../src/station/geo-point.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,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;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,QAAQ,CAgB5D"}

package/dist/station/geo-point.js

@@ -0,0 +1,34 @@
+/**
+ * Canonical geographic point for station sites and related APIs.
+ *
+ * **Decision (issue #19):** coordinates are {@link GeoPoint} with signed decimal
+ * degrees on WGS84. SQLite stores two REAL columns (`latitude`, `longitude`).
+ * GeoJSON Point (`[longitude, latitude]`, RFC 7946) is used only at map/API
+ * boundaries — no GeoJSON blobs in the database and no spatial extensions or
+ * indexes. Maidenhead grid squares are a derived display format, stored only
+ * where exchanged (station `gridsquare`, QSO grids). String sources such as
+ * Callook are parsed at the edge; lat/lon in this package are always numbers.
+ */
+export const MIN_LATITUDE = -90;
+export const MAX_LATITUDE = 90;
+export const MIN_LONGITUDE = -180;
+export const MAX_LONGITUDE = 180;
+/**
+ * Returns whether `value` is a {@link GeoPoint} with finite coordinates inside
+ * {@link MIN_LATITUDE}–{@link MAX_LATITUDE} and {@link MIN_LONGITUDE}–{@link MAX_LONGITUDE}.
+ */
+export function isGeoPoint(value) {
+    if (typeof value !== "object" || value === null) {
+        return false;
+    }
+    const candidate = value;
+    return (typeof candidate.latitude === "number" &&
+        typeof candidate.longitude === "number" &&
+        Number.isFinite(candidate.latitude) &&
+        Number.isFinite(candidate.longitude) &&
+        candidate.latitude >= MIN_LATITUDE &&
+        candidate.latitude <= MAX_LATITUDE &&
+        candidate.longitude >= MIN_LONGITUDE &&
+        candidate.longitude <= MAX_LONGITUDE);
+}
+//# sourceMappingURL=geo-point.js.map

package/dist/station/geo-point.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"geo-point.js","sourceRoot":"","sources":["../../src/station/geo-point.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,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;AAUjC;;;GAGG;AACH,MAAM,UAAU,UAAU,CAAC,KAAc;IACvC,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QAChD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,SAAS,GAAG,KAAiB,CAAC;IACpC,OAAO,CACL,OAAO,SAAS,CAAC,QAAQ,KAAK,QAAQ;QACtC,OAAO,SAAS,CAAC,SAAS,KAAK,QAAQ;QACvC,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAC,QAAQ,CAAC;QACnC,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAC,SAAS,CAAC;QACpC,SAAS,CAAC,QAAQ,IAAI,YAAY;QAClC,SAAS,CAAC,QAAQ,IAAI,YAAY;QAClC,SAAS,CAAC,SAAS,IAAI,aAAa;QACpC,SAAS,CAAC,SAAS,IAAI,aAAa,CACrC,CAAC;AACJ,CAAC"}

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

@@ -1,11 +1,9 @@
+import type { GeoPoint } from "./geo-point.js";
 /**
  * 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;
+export { MAX_LATITUDE, MAX_LONGITUDE, MIN_LATITUDE, MIN_LONGITUDE, } from "./geo-point.js";
 /**
  * Whether the operator last edited the Maidenhead grid or the coordinates.
  *
@@ -19,12 +17,10 @@ export type StationLocationSource = "grid" | "coordinates";
  * Latitude and longitude are signed decimal degrees (south / west negative).
  * UIs may collect them as degrees, minutes, and decimal seconds.
  */
-export interface RadioStation {
+export interface RadioStation extends Partial<GeoPoint> {
     id: string;
     nickname: string;
     gridsquare?: string;
-    latitude?: number;
-    longitude?: number;
     locationSource?: StationLocationSource;
     createdAt: number;
     updatedAt: number;

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

@@ -1 +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"}
+{"version":3,"file":"radio-station.d.ts","sourceRoot":"","sources":["../../src/station/radio-station.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE/C;;GAEG;AACH,eAAO,MAAM,eAAe,iBAAiB,CAAC;AAE9C,OAAO,EACL,YAAY,EACZ,aAAa,EACb,YAAY,EACZ,aAAa,GACd,MAAM,gBAAgB,CAAC;AAExB;;;;;GAKG;AACH,MAAM,MAAM,qBAAqB,GAAG,MAAM,GAAG,aAAa,CAAC;AAE3D;;;;;GAKG;AACH,MAAM,WAAW,YAAa,SAAQ,OAAO,CAAC,QAAQ,CAAC;IACrD,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,cAAc,CAAC,EAAE,qBAAqB,CAAC;IACvC,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB"}

package/dist/station/radio-station.js

@@ -2,8 +2,5 @@
  * 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;
+export { MAX_LATITUDE, MAX_LONGITUDE, MIN_LATITUDE, MIN_LONGITUDE, } from "./geo-point.js";
 //# sourceMappingURL=radio-station.js.map

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

@@ -1 +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"}
+{"version":3,"file":"radio-station.js","sourceRoot":"","sources":["../../src/station/radio-station.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,cAAc,CAAC;AAE9C,OAAO,EACL,YAAY,EACZ,aAAa,EACb,YAAY,EACZ,aAAa,GACd,MAAM,gBAAgB,CAAC"}

package/package.json

@@ -1,7 +1,8 @@
 {
   "name": "@springfield/ham-radio-api",
-  "version": "18.0.1",
+  "version": "18.1.0",
   "author": "Bryan Hunt",
+  "license": "MIT",
   "files": [
     "dist/",
     "src/"
@@ -35,15 +36,15 @@
     "@commitlint/config-conventional": "21.2.3",
     "@semantic-release/changelog": "7.0.0",
     "@semantic-release/git": "11.0.1",
-    "@semantic-release/github": "12.0.9",
-    "@semantic-release/npm": "13.1.5",
+    "@semantic-release/github": "12.0.10",
+    "@semantic-release/npm": "13.2.0",
     "husky": "9.1.7",
-    "oxfmt": "^0.68.0",
-    "oxlint": "1.83.0",
+    "oxfmt": "^0.71.0",
+    "oxlint": "1.86.0",
     "semantic-release": "25.0.9",
     "typescript": "7.0.2",
-    "vite": "^8.3.0",
-    "vitest": "^5.0.1"
+    "vite": "^8.3.2",
+    "vitest": "^5.0.3"
   },
   "resolutions": {
     "conventional-changelog-conventionalcommits": "9.3.1"

package/src/index.ts

@@ -43,5 +43,6 @@ export * from "./spectrum/privilege.js";
 
 export * from "./antenna/type.js";
 
+export * from "./station/geo-point.js";
 export * from "./station/radio-station.js";
 export * from "./station/antenna.js";

package/src/station/geo-point.ts

@@ -0,0 +1,45 @@
+/**
+ * Canonical geographic point for station sites and related APIs.
+ *
+ * **Decision (issue #19):** coordinates are {@link GeoPoint} with signed decimal
+ * degrees on WGS84. SQLite stores two REAL columns (`latitude`, `longitude`).
+ * GeoJSON Point (`[longitude, latitude]`, RFC 7946) is used only at map/API
+ * boundaries — no GeoJSON blobs in the database and no spatial extensions or
+ * indexes. Maidenhead grid squares are a derived display format, stored only
+ * where exchanged (station `gridsquare`, QSO grids). String sources such as
+ * Callook are parsed at the edge; lat/lon in this package are always numbers.
+ */
+export const MIN_LATITUDE = -90;
+export const MAX_LATITUDE = 90;
+export const MIN_LONGITUDE = -180;
+export const MAX_LONGITUDE = 180;
+
+/**
+ * A point on the WGS84 ellipsoid as signed decimal degrees (south / west negative).
+ */
+export interface GeoPoint {
+  latitude: number;
+  longitude: number;
+}
+
+/**
+ * Returns whether `value` is a {@link GeoPoint} with finite coordinates inside
+ * {@link MIN_LATITUDE}–{@link MAX_LATITUDE} and {@link MIN_LONGITUDE}–{@link MAX_LONGITUDE}.
+ */
+export function isGeoPoint(value: unknown): value is GeoPoint {
+  if (typeof value !== "object" || value === null) {
+    return false;
+  }
+
+  const candidate = value as GeoPoint;
+  return (
+    typeof candidate.latitude === "number" &&
+    typeof candidate.longitude === "number" &&
+    Number.isFinite(candidate.latitude) &&
+    Number.isFinite(candidate.longitude) &&
+    candidate.latitude >= MIN_LATITUDE &&
+    candidate.latitude <= MAX_LATITUDE &&
+    candidate.longitude >= MIN_LONGITUDE &&
+    candidate.longitude <= MAX_LONGITUDE
+  );
+}

package/src/station/radio-station.ts

@@ -1,12 +1,16 @@
+import type { GeoPoint } from "./geo-point.js";
+
 /**
  * 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;
+export {
+  MAX_LATITUDE,
+  MAX_LONGITUDE,
+  MIN_LATITUDE,
+  MIN_LONGITUDE,
+} from "./geo-point.js";
 
 /**
  * Whether the operator last edited the Maidenhead grid or the coordinates.
@@ -22,12 +26,10 @@ export type StationLocationSource = "grid" | "coordinates";
  * Latitude and longitude are signed decimal degrees (south / west negative).
  * UIs may collect them as degrees, minutes, and decimal seconds.
  */
-export interface RadioStation {
+export interface RadioStation extends Partial<GeoPoint> {
   id: string;
   nickname: string;
   gridsquare?: string;
-  latitude?: number;
-  longitude?: number;
   locationSource?: StationLocationSource;
   createdAt: number;
   updatedAt: number;