mirror of
https://github.com/bilawalsidhu/gods-eye-view.git
synced 2026-11-04 02:14:01 +00:00
German KhokhlovandClaude Opus 5.5
20f4cf3763
- i18n scanner: lastError sink, no false sinks on defaults and ternaries - shared src/i18n/marker.js for modules that only mark strings - wind field messages move to wind/fields.js; CITY_POIS imports from cityPois.js - drop review IDs, change history and stale references from comments and docs Co-Authored-By: Claude Opus 5.5 <[email protected]>
75 lines
2.9 KiB
JavaScript
75 lines
2.9 KiB
JavaScript
/**
|
|
* @module hudLocality
|
|
* @description The locality half of the HUD summary line — either "NEAR <landmark>"
|
|
* or the "SECTOR <lat/lon>" fallback.
|
|
*
|
|
* Split out of `hud.js` purely so it is unit-testable: `hud.js` pulls in the `mgrs`
|
|
* CommonJS package, which Vite resolves but plain Node cannot import by named export.
|
|
*/
|
|
|
|
/**
|
|
* Maximum distance to a curated POI that still reads as "NEAR" it.
|
|
*
|
|
* The 2026-08-20 QA hunt found the HUD announcing NEAR SACRE-COEUR (PARIS) 2470KM
|
|
* while parked over Moscow, and NEAR LINCOLN MEMORIAL 962KM over Chicago — the old
|
|
* bound was 2,500 km, roughly a continent. The POI catalogue only covers eight
|
|
* cities, so anywhere else on Earth matched whichever landmark happened to be
|
|
* closest and reported an absurd distance as if it were a locality.
|
|
*
|
|
* 150 km is metro scale: a camera over San Francisco still reads NEAR ALCATRAZ, a
|
|
* camera over DC still reads NEAR its monuments, and Chicago (962 km from the
|
|
* nearest catalogued POI) correctly falls through to the SECTOR readout that
|
|
* already worked for Honolulu and Rio.
|
|
*/
|
|
export const NEAR_POI_MAX_KM = 150;
|
|
|
|
/** The English locality line; the HUD passes hudLocalityFormat.js instead. */
|
|
const ENGLISH_LOCALITY = Object.freeze({
|
|
near: ({ poi, city, distKm }) =>
|
|
`NEAR ${poi.toUpperCase()} (${city.toUpperCase()}) ${Math.round(distKm)}KM`,
|
|
sector: ({ latDeg, lonDeg }) =>
|
|
`SECTOR ${coordinateTag(latDeg, 'N', 'S')} ${coordinateTag(lonDeg, 'E', 'W')}`,
|
|
});
|
|
|
|
/**
|
|
* Format one hemisphere-tagged coordinate, e.g. `21.33N` / `157.80W`.
|
|
* @param {number} value Signed decimal degrees.
|
|
* @param {string} positive Suffix when the value is >= 0.
|
|
* @param {string} negative Suffix when the value is < 0.
|
|
* @returns {string}
|
|
*/
|
|
function coordinateTag(value, positive, negative) {
|
|
return `${Math.abs(value).toFixed(2)}${value >= 0 ? positive : negative}`;
|
|
}
|
|
|
|
/**
|
|
* Build the locality tag for the HUD summary line.
|
|
*
|
|
* @param {{poi: string, city: string, distKm: number}|null|undefined} nearest
|
|
* Closest catalogued POI with its great-circle distance, or null when the
|
|
* catalogue is empty.
|
|
* @param {number} latDeg Camera latitude in decimal degrees.
|
|
* @param {number} lonDeg Camera longitude in decimal degrees.
|
|
* @param {{near: Function, sector: Function}} [format] Builds the line from
|
|
* `{ poi, city, distKm }` or `{ latDeg, lonDeg }`; names arrive as
|
|
* catalogued (`Tokyo`), not upper-cased.
|
|
* @returns {string} `NEAR <POI> (<CITY>) <N>KM` within the bound (inclusive),
|
|
* otherwise `SECTOR <lat> <lon>`.
|
|
*/
|
|
export function composeLocalityTag(
|
|
nearest,
|
|
latDeg,
|
|
lonDeg,
|
|
format = ENGLISH_LOCALITY,
|
|
) {
|
|
const distKm = Number(nearest?.distKm);
|
|
if (nearest && Number.isFinite(distKm) && distKm <= NEAR_POI_MAX_KM) {
|
|
return format.near({
|
|
poi: String(nearest.poi),
|
|
city: String(nearest.city),
|
|
distKm,
|
|
});
|
|
}
|
|
return format.sector({ latDeg, lonDeg });
|
|
}
|