@accelint/geo 0.6.0 → 0.7.0

package/dist/coordinates/latlon/internal/violation.js

@@ -1,5 +1,5 @@
 /*
- * Copyright 2025 Hypergiant Galactic Systems Inc. All rights reserved.
+ * Copyright 2026 Hypergiant Galactic Systems Inc. All rights reserved.
  * This file is licensed to you under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License. You may obtain a copy
  * of the License at https://www.apache.org/licenses/LICENSE-2.0

package/dist/coordinates/mgrs/parser.d.ts

@@ -1,5 +1,5 @@
 /*
- * Copyright 2025 Hypergiant Galactic Systems Inc. All rights reserved.
+ * Copyright 2026 Hypergiant Galactic Systems Inc. All rights reserved.
  * This file is licensed to you under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License. You may obtain a copy
  * of the License at https://www.apache.org/licenses/LICENSE-2.0

package/dist/coordinates/mgrs/parser.js

@@ -1,5 +1,5 @@
 /*
- * Copyright 2025 Hypergiant Galactic Systems Inc. All rights reserved.
+ * Copyright 2026 Hypergiant Galactic Systems Inc. All rights reserved.
  * This file is licensed to you under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License. You may obtain a copy
  * of the License at https://www.apache.org/licenses/LICENSE-2.0

package/dist/coordinates/mgrs/parts.d.ts

@@ -0,0 +1,86 @@
+/*
+ * Copyright 2026 Hypergiant Galactic Systems Inc. All rights reserved.
+ * This file is licensed to you under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License. You may obtain a copy
+ * of the License at https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software distributed under
+ * the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS
+ * OF ANY KIND, either express or implied. See the License for the specific language
+ * governing permissions and limitations under the License.
+ */
+
+import { GridPartsResult } from "../utm/parts.js";
+
+//#region src/coordinates/mgrs/parts.d.ts
+/**
+ * Structured MGRS grid parts for a signed `[lat, lon]` coordinate.
+ *
+ * `zone`/`band`/`e100k`/`n100k` identify the grid square; `easting`/`northing`
+ * are the geodesy within-square metre values (`0`–`99999`) prior to truncation.
+ */
+type MgrsParts = {
+  zone: number;
+  band: string;
+  e100k: string;
+  n100k: string;
+  easting: number;
+  northing: number;
+};
+/**
+ * Converts a signed `[lat, lon]` coordinate into MGRS grid parts.
+ *
+ * Reads the geodesy `Mgrs` object fields directly instead of parsing a
+ * formatted string. The UTM/MGRS grid is defined for `-80 ≤ lat ≤ 84`
+ * inclusive; latitudes outside that band, a longitude of exactly `+180°` (the
+ * antimeridian zone singularity), or non-finite input, produce
+ * `{ ok: false, reason: 'out-of-range' }`.
+ *
+ * @param coordinate - Signed `[latitude, longitude]` tuple.
+ * @returns A discriminated result with `{ zone, band, e100k, n100k, easting, northing }` on success.
+ *
+ * @remarks pure function
+ *
+ * @example
+ * ```typescript
+ * toMgrsParts([38.8977, -77.0365]);
+ * // { ok: true, value: { zone: 18, band: 'S', e100k: 'U', n100k: 'J', easting: 23394.29…, northing: 7395.63… } }
+ * ```
+ *
+ * @example
+ * ```typescript
+ * toMgrsParts([-81, 0]);
+ * // { ok: false, reason: 'out-of-range' }
+ * ```
+ */
+declare const toMgrsParts: ([lat, lon]: [number, number]) => GridPartsResult<MgrsParts>;
+/**
+ * Renders MGRS grid parts as their canonical coordinate string.
+ *
+ * Mirrors geodesy's `Mgrs.toString(10)`: floors the within-square metres,
+ * left-pads the zone to two digits and easting/northing to five, and joins the
+ * zone+band, the `e100k`/`n100k` grid-square pair, and the padded metres with
+ * single spaces.
+ *
+ * @param parts - The MGRS grid parts to render.
+ * @returns The canonical MGRS string, e.g. `"18S UJ 23394 07396"`.
+ *
+ * @remarks pure function
+ *
+ * @example
+ * ```typescript
+ * formatMgrsParts({ zone: 18, band: 'S', e100k: 'U', n100k: 'J', easting: 23394, northing: 7396 });
+ * // '18S UJ 23394 07396'
+ * ```
+ */
+declare const formatMgrsParts: ({
+  zone,
+  band,
+  e100k,
+  n100k,
+  easting,
+  northing
+}: MgrsParts) => string;
+//#endregion
+export { MgrsParts, formatMgrsParts, toMgrsParts };
+//# sourceMappingURL=parts.d.ts.map

package/dist/coordinates/mgrs/parts.js

@@ -0,0 +1,94 @@
+/*
+ * Copyright 2026 Hypergiant Galactic Systems Inc. All rights reserved.
+ * This file is licensed to you under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License. You may obtain a copy
+ * of the License at https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software distributed under
+ * the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS
+ * OF ANY KIND, either express or implied. See the License for the specific language
+ * governing permissions and limitations under the License.
+ */
+
+
+import { isGridProjectable } from "../utm/parts.js";
+import { LatLon } from "geodesy/mgrs";
+
+//#region src/coordinates/mgrs/parts.ts
+/**
+* Converts a signed `[lat, lon]` coordinate into MGRS grid parts.
+*
+* Reads the geodesy `Mgrs` object fields directly instead of parsing a
+* formatted string. The UTM/MGRS grid is defined for `-80 ≤ lat ≤ 84`
+* inclusive; latitudes outside that band, a longitude of exactly `+180°` (the
+* antimeridian zone singularity), or non-finite input, produce
+* `{ ok: false, reason: 'out-of-range' }`.
+*
+* @param coordinate - Signed `[latitude, longitude]` tuple.
+* @returns A discriminated result with `{ zone, band, e100k, n100k, easting, northing }` on success.
+*
+* @remarks pure function
+*
+* @example
+* ```typescript
+* toMgrsParts([38.8977, -77.0365]);
+* // { ok: true, value: { zone: 18, band: 'S', e100k: 'U', n100k: 'J', easting: 23394.29…, northing: 7395.63… } }
+* ```
+*
+* @example
+* ```typescript
+* toMgrsParts([-81, 0]);
+* // { ok: false, reason: 'out-of-range' }
+* ```
+*/
+const toMgrsParts = ([lat, lon]) => {
+	if (!isGridProjectable([lat, lon])) return {
+		ok: false,
+		reason: "out-of-range"
+	};
+	try {
+		const mgrs = new LatLon(lat, lon).toUtm().toMgrs();
+		return {
+			ok: true,
+			value: {
+				zone: mgrs.zone,
+				band: mgrs.band,
+				e100k: mgrs.e100k,
+				n100k: mgrs.n100k,
+				easting: mgrs.easting,
+				northing: mgrs.northing
+			}
+		};
+	} catch {
+		return {
+			ok: false,
+			reason: "out-of-range"
+		};
+	}
+};
+/**
+* Renders MGRS grid parts as their canonical coordinate string.
+*
+* Mirrors geodesy's `Mgrs.toString(10)`: floors the within-square metres,
+* left-pads the zone to two digits and easting/northing to five, and joins the
+* zone+band, the `e100k`/`n100k` grid-square pair, and the padded metres with
+* single spaces.
+*
+* @param parts - The MGRS grid parts to render.
+* @returns The canonical MGRS string, e.g. `"18S UJ 23394 07396"`.
+*
+* @remarks pure function
+*
+* @example
+* ```typescript
+* formatMgrsParts({ zone: 18, band: 'S', e100k: 'U', n100k: 'J', easting: 23394, northing: 7396 });
+* // '18S UJ 23394 07396'
+* ```
+*/
+const formatMgrsParts = ({ zone, band, e100k, n100k, easting, northing }) => {
+	return `${zone.toString().padStart(2, "0")}${band} ${e100k}${n100k} ${Math.floor(easting).toString().padStart(5, "0")} ${Math.floor(northing).toString().padStart(5, "0")}`;
+};
+
+//#endregion
+export { formatMgrsParts, toMgrsParts };
+//# sourceMappingURL=parts.js.map

package/dist/coordinates/mgrs/parts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parts.js","names":[],"sources":["../../../src/coordinates/mgrs/parts.ts"],"sourcesContent":["/*\n * Copyright 2026 Hypergiant Galactic Systems Inc. All rights reserved.\n * This file is licensed to you under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License. You may obtain a copy\n * of the License at https://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software distributed under\n * the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\n * OF ANY KIND, either express or implied. See the License for the specific language\n * governing permissions and limitations under the License.\n */\n\nimport { LatLon } from 'geodesy/mgrs';\nimport { type GridPartsResult, isGridProjectable } from '../utm/parts';\n\n/**\n * Structured MGRS grid parts for a signed `[lat, lon]` coordinate.\n *\n * `zone`/`band`/`e100k`/`n100k` identify the grid square; `easting`/`northing`\n * are the geodesy within-square metre values (`0`–`99999`) prior to truncation.\n */\nexport type MgrsParts = {\n  zone: number;\n  band: string;\n  e100k: string;\n  n100k: string;\n  easting: number;\n  northing: number;\n};\n\n/**\n * Converts a signed `[lat, lon]` coordinate into MGRS grid parts.\n *\n * Reads the geodesy `Mgrs` object fields directly instead of parsing a\n * formatted string. The UTM/MGRS grid is defined for `-80 ≤ lat ≤ 84`\n * inclusive; latitudes outside that band, a longitude of exactly `+180°` (the\n * antimeridian zone singularity), or non-finite input, produce\n * `{ ok: false, reason: 'out-of-range' }`.\n *\n * @param coordinate - Signed `[latitude, longitude]` tuple.\n * @returns A discriminated result with `{ zone, band, e100k, n100k, easting, northing }` on success.\n *\n * @remarks pure function\n *\n * @example\n * ```typescript\n * toMgrsParts([38.8977, -77.0365]);\n * // { ok: true, value: { zone: 18, band: 'S', e100k: 'U', n100k: 'J', easting: 23394.29…, northing: 7395.63… } }\n * ```\n *\n * @example\n * ```typescript\n * toMgrsParts([-81, 0]);\n * // { ok: false, reason: 'out-of-range' }\n * ```\n */\nexport const toMgrsParts = ([lat, lon]: [\n  number,\n  number,\n]): GridPartsResult<MgrsParts> => {\n  if (!isGridProjectable([lat, lon])) {\n    return { ok: false, reason: 'out-of-range' };\n  }\n\n  try {\n    const mgrs = new LatLon(lat, lon).toUtm().toMgrs();\n\n    return {\n      ok: true,\n      value: {\n        zone: mgrs.zone,\n        band: mgrs.band,\n        e100k: mgrs.e100k,\n        n100k: mgrs.n100k,\n        easting: mgrs.easting,\n        northing: mgrs.northing,\n      },\n    };\n  } catch {\n    // geodesy re-verifies UTM bounds when building the MGRS reference; keep\n    // the result total rather than leaking a RangeError.\n    return { ok: false, reason: 'out-of-range' };\n  }\n};\n\n/**\n * Renders MGRS grid parts as their canonical coordinate string.\n *\n * Mirrors geodesy's `Mgrs.toString(10)`: floors the within-square metres,\n * left-pads the zone to two digits and easting/northing to five, and joins the\n * zone+band, the `e100k`/`n100k` grid-square pair, and the padded metres with\n * single spaces.\n *\n * @param parts - The MGRS grid parts to render.\n * @returns The canonical MGRS string, e.g. `\"18S UJ 23394 07396\"`.\n *\n * @remarks pure function\n *\n * @example\n * ```typescript\n * formatMgrsParts({ zone: 18, band: 'S', e100k: 'U', n100k: 'J', easting: 23394, northing: 7396 });\n * // '18S UJ 23394 07396'\n * ```\n */\nexport const formatMgrsParts = ({\n  zone,\n  band,\n  e100k,\n  n100k,\n  easting,\n  northing,\n}: MgrsParts): string => {\n  const zonePadded = zone.toString().padStart(2, '0');\n  const eastingPadded = Math.floor(easting).toString().padStart(5, '0');\n  const northingPadded = Math.floor(northing).toString().padStart(5, '0');\n\n  return `${zonePadded}${band} ${e100k}${n100k} ${eastingPadded} ${northingPadded}`;\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAwDA,MAAa,eAAe,CAAC,KAAK,SAGA;AAChC,KAAI,CAAC,kBAAkB,CAAC,KAAK,IAAI,CAAC,CAChC,QAAO;EAAE,IAAI;EAAO,QAAQ;EAAgB;AAG9C,KAAI;EACF,MAAM,OAAO,IAAI,OAAO,KAAK,IAAI,CAAC,OAAO,CAAC,QAAQ;AAElD,SAAO;GACL,IAAI;GACJ,OAAO;IACL,MAAM,KAAK;IACX,MAAM,KAAK;IACX,OAAO,KAAK;IACZ,OAAO,KAAK;IACZ,SAAS,KAAK;IACd,UAAU,KAAK;IAChB;GACF;SACK;AAGN,SAAO;GAAE,IAAI;GAAO,QAAQ;GAAgB;;;;;;;;;;;;;;;;;;;;;;AAuBhD,MAAa,mBAAmB,EAC9B,MACA,MACA,OACA,OACA,SACA,eACuB;AAKvB,QAAO,GAJY,KAAK,UAAU,CAAC,SAAS,GAAG,IAAI,GAI5B,KAAK,GAAG,QAAQ,MAAM,GAHvB,KAAK,MAAM,QAAQ,CAAC,UAAU,CAAC,SAAS,GAAG,IAAI,CAGP,GAFvC,KAAK,MAAM,SAAS,CAAC,UAAU,CAAC,SAAS,GAAG,IAAI"}

package/dist/coordinates/mgrs/system.d.ts

@@ -1,5 +1,5 @@
 /*
- * Copyright 2025 Hypergiant Galactic Systems Inc. All rights reserved.
+ * Copyright 2026 Hypergiant Galactic Systems Inc. All rights reserved.
  * This file is licensed to you under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License. You may obtain a copy
  * of the License at https://www.apache.org/licenses/LICENSE-2.0

package/dist/coordinates/mgrs/system.js

@@ -1,5 +1,5 @@
 /*
- * Copyright 2025 Hypergiant Galactic Systems Inc. All rights reserved.
+ * Copyright 2026 Hypergiant Galactic Systems Inc. All rights reserved.
  * This file is licensed to you under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License. You may obtain a copy
  * of the License at https://www.apache.org/licenses/LICENSE-2.0
@@ -13,7 +13,7 @@
 
 import { SYMBOL_PATTERNS } from "../latlon/internal/index.js";
 import { parseMGRS } from "./parser.js";
-import { LatLon } from "geodesy/mgrs";
+import { formatMgrsParts, toMgrsParts } from "./parts.js";
 
 //#region src/coordinates/mgrs/system.ts
 /**
@@ -55,7 +55,9 @@ const systemMGRS = {
 	},
 	toFormat(format, [left, right]) {
 		const { LAT, LON } = Object.fromEntries([[format.slice(0, 3), left], [format.slice(3), right]]);
-		return new LatLon(LAT, LON).toUtm().toMgrs().toString();
+		const result = toMgrsParts([LAT, LON]);
+		if (!result.ok) throw new RangeError(`Coordinate [${LAT}, ${LON}] cannot be represented in MGRS (outside 80°S–84°N, on the +180° antimeridian, or not finite).`);
+		return formatMgrsParts(result.value);
 	}
 };
 

package/dist/coordinates/mgrs/system.js.map

@@ -1 +1 @@
-{"version":3,"file":"system.js","names":["systemMGRS: CoordinateSystem"],"sources":["../../../src/coordinates/mgrs/system.ts"],"sourcesContent":["// __private-exports\n/*\n * Copyright 2024 Hypergiant Galactic Systems Inc. All rights reserved.\n * This file is licensed to you under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License. You may obtain a copy\n * of the License at https://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software distributed under\n * the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\n * OF ANY KIND, either express or implied. See the License for the specific language\n * governing permissions and limitations under the License.\n */\n\nimport { LatLon } from 'geodesy/mgrs';\nimport { type Compass, type Format, SYMBOL_PATTERNS } from '../latlon/internal';\nimport { parseMGRS } from './parser';\nimport type { CoordinateSystem } from '../latlon/internal/coordinate-system';\n\n/**\n * Military Grid Reference System (MGRS) coordinate system implementation.\n *\n * Provides parsing, conversion, and formatting for MGRS coordinates. MGRS is a geocoordinate\n * standard used by NATO militaries for locating points on Earth, based on the UTM coordinate\n * system. Format: Grid Zone Designation + 100km Square ID + Numerical Location (e.g., '31U BF 12345 67890').\n *\n * @property name - Human-readable name: 'Military Grid Reference System'.\n * @property parse - Parses MGRS coordinate strings into latitude/longitude values.\n * @property toFloat - Converts coordinate component with bearing to signed float value.\n * @property toFormat - Formats latitude/longitude pair back to MGRS coordinate string.\n *\n * @example\n * ```typescript\n * systemMGRS.parse(null, '31U BF 12345 67890');\n * // [[['48.123456', 'N'], ['11.234567', 'E']], []]\n * ```\n *\n * @example\n * ```typescript\n * systemMGRS.toFormat('LATLON', [48.123456, 11.234567]);\n * // '31U BF 12345 67890'\n * ```\n *\n * @example\n * ```typescript\n * systemMGRS.toFloat(['48.123456', 'N']);\n * // 48.123456\n * ```\n */\nexport const systemMGRS: CoordinateSystem = {\n  name: 'Military Grid Reference System',\n\n  parse: parseMGRS,\n\n  toFloat(arg) {\n    const [num, bear] = arg as [string, Compass];\n\n    return (\n      Number.parseFloat(num) *\n      (SYMBOL_PATTERNS.NEGATIVE_BEARINGS.test(bear) ? -1 : 1)\n    );\n  },\n\n  toFormat(format: Format, [left, right]: [number, number]) {\n    const { LAT, LON } = Object.fromEntries([\n      [format.slice(0, 3), left],\n      [format.slice(3), right],\n    ]) as Record<'LAT' | 'LON', number>;\n\n    const latlon = new LatLon(LAT, LON);\n\n    return latlon.toUtm().toMgrs().toString();\n  },\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAgDA,MAAaA,aAA+B;CAC1C,MAAM;CAEN,OAAO;CAEP,QAAQ,KAAK;EACX,MAAM,CAAC,KAAK,QAAQ;AAEpB,SACE,OAAO,WAAW,IAAI,IACrB,gBAAgB,kBAAkB,KAAK,KAAK,GAAG,KAAK;;CAIzD,SAAS,QAAgB,CAAC,MAAM,QAA0B;EACxD,MAAM,EAAE,KAAK,QAAQ,OAAO,YAAY,CACtC,CAAC,OAAO,MAAM,GAAG,EAAE,EAAE,KAAK,EAC1B,CAAC,OAAO,MAAM,EAAE,EAAE,MAAM,CACzB,CAAC;AAIF,SAFe,IAAI,OAAO,KAAK,IAAI,CAErB,OAAO,CAAC,QAAQ,CAAC,UAAU;;CAE5C"}
+{"version":3,"file":"system.js","names":["systemMGRS: CoordinateSystem"],"sources":["../../../src/coordinates/mgrs/system.ts"],"sourcesContent":["// __private-exports\n/*\n * Copyright 2024 Hypergiant Galactic Systems Inc. All rights reserved.\n * This file is licensed to you under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License. You may obtain a copy\n * of the License at https://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software distributed under\n * the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\n * OF ANY KIND, either express or implied. See the License for the specific language\n * governing permissions and limitations under the License.\n */\n\nimport { type Compass, type Format, SYMBOL_PATTERNS } from '../latlon/internal';\nimport { parseMGRS } from './parser';\nimport { formatMgrsParts, toMgrsParts } from './parts';\nimport type { CoordinateSystem } from '../latlon/internal/coordinate-system';\n\n/**\n * Military Grid Reference System (MGRS) coordinate system implementation.\n *\n * Provides parsing, conversion, and formatting for MGRS coordinates. MGRS is a geocoordinate\n * standard used by NATO militaries for locating points on Earth, based on the UTM coordinate\n * system. Format: Grid Zone Designation + 100km Square ID + Numerical Location (e.g., '31U BF 12345 67890').\n *\n * @property name - Human-readable name: 'Military Grid Reference System'.\n * @property parse - Parses MGRS coordinate strings into latitude/longitude values.\n * @property toFloat - Converts coordinate component with bearing to signed float value.\n * @property toFormat - Formats latitude/longitude pair back to MGRS coordinate string.\n *\n * @example\n * ```typescript\n * systemMGRS.parse(null, '31U BF 12345 67890');\n * // [[['48.123456', 'N'], ['11.234567', 'E']], []]\n * ```\n *\n * @example\n * ```typescript\n * systemMGRS.toFormat('LATLON', [48.123456, 11.234567]);\n * // '31U BF 12345 67890'\n * ```\n *\n * @example\n * ```typescript\n * systemMGRS.toFloat(['48.123456', 'N']);\n * // 48.123456\n * ```\n */\nexport const systemMGRS: CoordinateSystem = {\n  name: 'Military Grid Reference System',\n\n  parse: parseMGRS,\n\n  toFloat(arg) {\n    const [num, bear] = arg as [string, Compass];\n\n    return (\n      Number.parseFloat(num) *\n      (SYMBOL_PATTERNS.NEGATIVE_BEARINGS.test(bear) ? -1 : 1)\n    );\n  },\n\n  toFormat(format: Format, [left, right]: [number, number]) {\n    const { LAT, LON } = Object.fromEntries([\n      [format.slice(0, 3), left],\n      [format.slice(3), right],\n    ]) as Record<'LAT' | 'LON', number>;\n\n    const result = toMgrsParts([LAT, LON]);\n\n    if (!result.ok) {\n      // The legacy `toFormat` contract throws for coordinates the grid cannot\n      // represent; the parts API returns `{ ok: false }` for the same inputs.\n      throw new RangeError(\n        `Coordinate [${LAT}, ${LON}] cannot be represented in MGRS (outside 80°S–84°N, on the +180° antimeridian, or not finite).`,\n      );\n    }\n\n    return formatMgrsParts(result.value);\n  },\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAgDA,MAAaA,aAA+B;CAC1C,MAAM;CAEN,OAAO;CAEP,QAAQ,KAAK;EACX,MAAM,CAAC,KAAK,QAAQ;AAEpB,SACE,OAAO,WAAW,IAAI,IACrB,gBAAgB,kBAAkB,KAAK,KAAK,GAAG,KAAK;;CAIzD,SAAS,QAAgB,CAAC,MAAM,QAA0B;EACxD,MAAM,EAAE,KAAK,QAAQ,OAAO,YAAY,CACtC,CAAC,OAAO,MAAM,GAAG,EAAE,EAAE,KAAK,EAC1B,CAAC,OAAO,MAAM,EAAE,EAAE,MAAM,CACzB,CAAC;EAEF,MAAM,SAAS,YAAY,CAAC,KAAK,IAAI,CAAC;AAEtC,MAAI,CAAC,OAAO,GAGV,OAAM,IAAI,WACR,eAAe,IAAI,IAAI,IAAI,gGAC5B;AAGH,SAAO,gBAAgB,OAAO,MAAM;;CAEvC"}

package/dist/coordinates/utm/parser.d.ts

@@ -1,5 +1,5 @@
 /*
- * Copyright 2025 Hypergiant Galactic Systems Inc. All rights reserved.
+ * Copyright 2026 Hypergiant Galactic Systems Inc. All rights reserved.
  * This file is licensed to you under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License. You may obtain a copy
  * of the License at https://www.apache.org/licenses/LICENSE-2.0

package/dist/coordinates/utm/parser.js

@@ -1,5 +1,5 @@
 /*
- * Copyright 2025 Hypergiant Galactic Systems Inc. All rights reserved.
+ * Copyright 2026 Hypergiant Galactic Systems Inc. All rights reserved.
  * This file is licensed to you under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License. You may obtain a copy
  * of the License at https://www.apache.org/licenses/LICENSE-2.0

package/dist/coordinates/utm/parts.d.ts

@@ -0,0 +1,134 @@
+//#region src/coordinates/utm/parts.d.ts
+/**
+ * Lowest latitude (degrees) the UTM/MGRS grid is defined for, inclusive.
+ *
+ * Matches the patched geodesy valid range; latitudes below this yield an
+ * out-of-range result rather than a projected grid reference.
+ */
+declare const GRID_LATITUDE_MIN = -80;
+/**
+ * Highest latitude (degrees) the UTM/MGRS grid is defined for, inclusive.
+ *
+ * Matches the patched geodesy valid range; latitudes above this yield an
+ * out-of-range result rather than a projected grid reference.
+ */
+declare const GRID_LATITUDE_MAX = 84;
+/**
+ * Discriminated result for a grid-parts conversion.
+ *
+ * `ok: true` carries the structured grid parts; `ok: false` carries a typed
+ * `reason` so consumers branch on a field instead of matching error text.
+ *
+ * @template Value - The grid parts shape carried on success.
+ */
+type GridPartsResult<Value> = {
+  ok: true;
+  value: Value;
+} | {
+  ok: false;
+  reason: 'out-of-range';
+};
+/**
+ * Structured UTM grid parts for a signed `[lat, lon]` coordinate.
+ *
+ * `easting` and `northing` are the rounded integer metres geodesy yields.
+ */
+type UtmParts = {
+  zone: number;
+  hemisphere: 'N' | 'S';
+  easting: number;
+  northing: number;
+};
+/**
+ * Reports whether a latitude falls within the inclusive UTM/MGRS grid band.
+ *
+ * @param lat - The latitude in degrees.
+ * @returns `true` when `-80 ≤ lat ≤ 84`.
+ *
+ * @remarks pure function
+ */
+declare const isWithinGridBand: (lat: number) => boolean;
+/**
+ * Reports whether a longitude sits on the eastern antimeridian singularity.
+ *
+ * At exactly `+180°` the UTM zone formula yields the nonexistent zone `61`,
+ * for which geodesy throws. `-180°` and values beyond `±180°` project
+ * normally, so only `+180°` is excluded here — the same point is reachable as
+ * `-180°`, or via a caller's own longitude normalization.
+ *
+ * @param lon - The longitude in degrees.
+ * @returns `true` when `lon` is exactly `180`.
+ *
+ * @remarks pure function
+ */
+declare const isOnEasternAntimeridian: (lon: number) => boolean;
+/**
+ * Reports whether a signed `[lat, lon]` coordinate can be projected to a UTM
+ * zone (and therefore to MGRS).
+ *
+ * A coordinate is projectable when it is finite and in range, its latitude is
+ * within the inclusive `80°S`–`84°N` grid band, and it does not sit on the
+ * `+180°` antimeridian singularity. This is the single validity gate shared by
+ * {@link toUtmParts} and {@link toMgrsParts}.
+ *
+ * @param coordinate - Signed `[latitude, longitude]` tuple.
+ * @returns `true` when the coordinate projects to a grid reference.
+ *
+ * @remarks pure function
+ */
+declare const isGridProjectable: ([lat, lon]: [number, number]) => boolean;
+/**
+ * Converts a signed `[lat, lon]` coordinate into UTM grid parts.
+ *
+ * Reads the geodesy `Utm` fields directly and rounds `easting`/`northing` to
+ * integer metres (matching the existing UTM string renderer). The UTM/MGRS
+ * grid is defined for `-80 ≤ lat ≤ 84` inclusive; latitudes outside that band,
+ * a longitude of exactly `+180°` (the antimeridian zone singularity), or
+ * non-finite input, produce `{ ok: false, reason: 'out-of-range' }`.
+ *
+ * @param coordinate - Signed `[latitude, longitude]` tuple.
+ * @returns A discriminated result with `{ zone, hemisphere, easting, northing }` on success.
+ *
+ * @remarks pure function
+ *
+ * @example
+ * ```typescript
+ * toUtmParts([38.8977, -77.0365]);
+ * // { ok: true, value: { zone: 18, hemisphere: 'N', easting: 323394, northing: 4307396 } }
+ * ```
+ *
+ * @example
+ * ```typescript
+ * toUtmParts([85, 0]);
+ * // { ok: false, reason: 'out-of-range' }
+ * ```
+ */
+declare const toUtmParts: ([lat, lon]: [number, number]) => GridPartsResult<UtmParts>;
+/**
+ * Renders UTM grid parts as their canonical coordinate string.
+ *
+ * Left-pads the zone to two digits and joins zone+hemisphere, easting, and
+ * northing with single spaces, matching geodesy's `Utm.toString()` output.
+ * `easting`/`northing` are already the rounded integer metres `toUtmParts`
+ * yields, so no further rounding is applied here.
+ *
+ * @param parts - The UTM grid parts to render.
+ * @returns The canonical UTM string, e.g. `"18N 323394 4307396"`.
+ *
+ * @remarks pure function
+ *
+ * @example
+ * ```typescript
+ * formatUtmParts({ zone: 18, hemisphere: 'N', easting: 323394, northing: 4307396 });
+ * // '18N 323394 4307396'
+ * ```
+ */
+declare const formatUtmParts: ({
+  zone,
+  hemisphere,
+  easting,
+  northing
+}: UtmParts) => string;
+//#endregion
+export { GRID_LATITUDE_MAX, GRID_LATITUDE_MIN, GridPartsResult, UtmParts, formatUtmParts, isGridProjectable, isOnEasternAntimeridian, isWithinGridBand, toUtmParts };
+//# sourceMappingURL=parts.d.ts.map

package/dist/coordinates/utm/parts.js

@@ -0,0 +1,142 @@
+/*
+ * Copyright 2026 Hypergiant Galactic Systems Inc. All rights reserved.
+ * This file is licensed to you under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License. You may obtain a copy
+ * of the License at https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software distributed under
+ * the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS
+ * OF ANY KIND, either express or implied. See the License for the specific language
+ * governing permissions and limitations under the License.
+ */
+
+
+import { isValidNumericCoordinate } from "../latlon/internal/validate.js";
+import { LatLon } from "geodesy/utm";
+
+//#region src/coordinates/utm/parts.ts
+/**
+* Lowest latitude (degrees) the UTM/MGRS grid is defined for, inclusive.
+*
+* Matches the patched geodesy valid range; latitudes below this yield an
+* out-of-range result rather than a projected grid reference.
+*/
+const GRID_LATITUDE_MIN = -80;
+/**
+* Highest latitude (degrees) the UTM/MGRS grid is defined for, inclusive.
+*
+* Matches the patched geodesy valid range; latitudes above this yield an
+* out-of-range result rather than a projected grid reference.
+*/
+const GRID_LATITUDE_MAX = 84;
+/**
+* Reports whether a latitude falls within the inclusive UTM/MGRS grid band.
+*
+* @param lat - The latitude in degrees.
+* @returns `true` when `-80 ≤ lat ≤ 84`.
+*
+* @remarks pure function
+*/
+const isWithinGridBand = (lat) => lat >= GRID_LATITUDE_MIN && lat <= GRID_LATITUDE_MAX;
+/**
+* Reports whether a longitude sits on the eastern antimeridian singularity.
+*
+* At exactly `+180°` the UTM zone formula yields the nonexistent zone `61`,
+* for which geodesy throws. `-180°` and values beyond `±180°` project
+* normally, so only `+180°` is excluded here — the same point is reachable as
+* `-180°`, or via a caller's own longitude normalization.
+*
+* @param lon - The longitude in degrees.
+* @returns `true` when `lon` is exactly `180`.
+*
+* @remarks pure function
+*/
+const isOnEasternAntimeridian = (lon) => lon === 180;
+/**
+* Reports whether a signed `[lat, lon]` coordinate can be projected to a UTM
+* zone (and therefore to MGRS).
+*
+* A coordinate is projectable when it is finite and in range, its latitude is
+* within the inclusive `80°S`–`84°N` grid band, and it does not sit on the
+* `+180°` antimeridian singularity. This is the single validity gate shared by
+* {@link toUtmParts} and {@link toMgrsParts}.
+*
+* @param coordinate - Signed `[latitude, longitude]` tuple.
+* @returns `true` when the coordinate projects to a grid reference.
+*
+* @remarks pure function
+*/
+const isGridProjectable = ([lat, lon]) => isValidNumericCoordinate(lat, lon) && isWithinGridBand(lat) && !isOnEasternAntimeridian(lon);
+/**
+* Converts a signed `[lat, lon]` coordinate into UTM grid parts.
+*
+* Reads the geodesy `Utm` fields directly and rounds `easting`/`northing` to
+* integer metres (matching the existing UTM string renderer). The UTM/MGRS
+* grid is defined for `-80 ≤ lat ≤ 84` inclusive; latitudes outside that band,
+* a longitude of exactly `+180°` (the antimeridian zone singularity), or
+* non-finite input, produce `{ ok: false, reason: 'out-of-range' }`.
+*
+* @param coordinate - Signed `[latitude, longitude]` tuple.
+* @returns A discriminated result with `{ zone, hemisphere, easting, northing }` on success.
+*
+* @remarks pure function
+*
+* @example
+* ```typescript
+* toUtmParts([38.8977, -77.0365]);
+* // { ok: true, value: { zone: 18, hemisphere: 'N', easting: 323394, northing: 4307396 } }
+* ```
+*
+* @example
+* ```typescript
+* toUtmParts([85, 0]);
+* // { ok: false, reason: 'out-of-range' }
+* ```
+*/
+const toUtmParts = ([lat, lon]) => {
+	if (!isGridProjectable([lat, lon])) return {
+		ok: false,
+		reason: "out-of-range"
+	};
+	try {
+		const utm = new LatLon(lat, lon).toUtm();
+		return {
+			ok: true,
+			value: {
+				zone: utm.zone,
+				hemisphere: utm.hemisphere,
+				easting: Math.round(utm.easting),
+				northing: Math.round(utm.northing)
+			}
+		};
+	} catch {
+		return {
+			ok: false,
+			reason: "out-of-range"
+		};
+	}
+};
+/**
+* Renders UTM grid parts as their canonical coordinate string.
+*
+* Left-pads the zone to two digits and joins zone+hemisphere, easting, and
+* northing with single spaces, matching geodesy's `Utm.toString()` output.
+* `easting`/`northing` are already the rounded integer metres `toUtmParts`
+* yields, so no further rounding is applied here.
+*
+* @param parts - The UTM grid parts to render.
+* @returns The canonical UTM string, e.g. `"18N 323394 4307396"`.
+*
+* @remarks pure function
+*
+* @example
+* ```typescript
+* formatUtmParts({ zone: 18, hemisphere: 'N', easting: 323394, northing: 4307396 });
+* // '18N 323394 4307396'
+* ```
+*/
+const formatUtmParts = ({ zone, hemisphere, easting, northing }) => `${zone.toString().padStart(2, "0")}${hemisphere} ${easting} ${northing}`;
+
+//#endregion
+export { GRID_LATITUDE_MAX, GRID_LATITUDE_MIN, formatUtmParts, isGridProjectable, isOnEasternAntimeridian, isWithinGridBand, toUtmParts };
+//# sourceMappingURL=parts.js.map

package/dist/coordinates/utm/parts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parts.js","names":[],"sources":["../../../src/coordinates/utm/parts.ts"],"sourcesContent":["/*\n * Copyright 2026 Hypergiant Galactic Systems Inc. All rights reserved.\n * This file is licensed to you under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License. You may obtain a copy\n * of the License at https://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software distributed under\n * the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\n * OF ANY KIND, either express or implied. See the License for the specific language\n * governing permissions and limitations under the License.\n */\n\nimport { LatLon } from 'geodesy/utm';\nimport { isValidNumericCoordinate } from '../latlon/internal';\n\n/**\n * Lowest latitude (degrees) the UTM/MGRS grid is defined for, inclusive.\n *\n * Matches the patched geodesy valid range; latitudes below this yield an\n * out-of-range result rather than a projected grid reference.\n */\nexport const GRID_LATITUDE_MIN = -80;\n\n/**\n * Highest latitude (degrees) the UTM/MGRS grid is defined for, inclusive.\n *\n * Matches the patched geodesy valid range; latitudes above this yield an\n * out-of-range result rather than a projected grid reference.\n */\nexport const GRID_LATITUDE_MAX = 84;\n\n/**\n * Discriminated result for a grid-parts conversion.\n *\n * `ok: true` carries the structured grid parts; `ok: false` carries a typed\n * `reason` so consumers branch on a field instead of matching error text.\n *\n * @template Value - The grid parts shape carried on success.\n */\nexport type GridPartsResult<Value> =\n  | { ok: true; value: Value }\n  | { ok: false; reason: 'out-of-range' };\n\n/**\n * Structured UTM grid parts for a signed `[lat, lon]` coordinate.\n *\n * `easting` and `northing` are the rounded integer metres geodesy yields.\n */\nexport type UtmParts = {\n  zone: number;\n  hemisphere: 'N' | 'S';\n  easting: number;\n  northing: number;\n};\n\n/**\n * Reports whether a latitude falls within the inclusive UTM/MGRS grid band.\n *\n * @param lat - The latitude in degrees.\n * @returns `true` when `-80 ≤ lat ≤ 84`.\n *\n * @remarks pure function\n */\nexport const isWithinGridBand = (lat: number): boolean =>\n  lat >= GRID_LATITUDE_MIN && lat <= GRID_LATITUDE_MAX;\n\n/**\n * Reports whether a longitude sits on the eastern antimeridian singularity.\n *\n * At exactly `+180°` the UTM zone formula yields the nonexistent zone `61`,\n * for which geodesy throws. `-180°` and values beyond `±180°` project\n * normally, so only `+180°` is excluded here — the same point is reachable as\n * `-180°`, or via a caller's own longitude normalization.\n *\n * @param lon - The longitude in degrees.\n * @returns `true` when `lon` is exactly `180`.\n *\n * @remarks pure function\n */\nexport const isOnEasternAntimeridian = (lon: number): boolean => lon === 180;\n\n/**\n * Reports whether a signed `[lat, lon]` coordinate can be projected to a UTM\n * zone (and therefore to MGRS).\n *\n * A coordinate is projectable when it is finite and in range, its latitude is\n * within the inclusive `80°S`–`84°N` grid band, and it does not sit on the\n * `+180°` antimeridian singularity. This is the single validity gate shared by\n * {@link toUtmParts} and {@link toMgrsParts}.\n *\n * @param coordinate - Signed `[latitude, longitude]` tuple.\n * @returns `true` when the coordinate projects to a grid reference.\n *\n * @remarks pure function\n */\nexport const isGridProjectable = ([lat, lon]: [number, number]): boolean =>\n  isValidNumericCoordinate(lat, lon) &&\n  isWithinGridBand(lat) &&\n  !isOnEasternAntimeridian(lon);\n\n/**\n * Converts a signed `[lat, lon]` coordinate into UTM grid parts.\n *\n * Reads the geodesy `Utm` fields directly and rounds `easting`/`northing` to\n * integer metres (matching the existing UTM string renderer). The UTM/MGRS\n * grid is defined for `-80 ≤ lat ≤ 84` inclusive; latitudes outside that band,\n * a longitude of exactly `+180°` (the antimeridian zone singularity), or\n * non-finite input, produce `{ ok: false, reason: 'out-of-range' }`.\n *\n * @param coordinate - Signed `[latitude, longitude]` tuple.\n * @returns A discriminated result with `{ zone, hemisphere, easting, northing }` on success.\n *\n * @remarks pure function\n *\n * @example\n * ```typescript\n * toUtmParts([38.8977, -77.0365]);\n * // { ok: true, value: { zone: 18, hemisphere: 'N', easting: 323394, northing: 4307396 } }\n * ```\n *\n * @example\n * ```typescript\n * toUtmParts([85, 0]);\n * // { ok: false, reason: 'out-of-range' }\n * ```\n */\nexport const toUtmParts = ([lat, lon]: [\n  number,\n  number,\n]): GridPartsResult<UtmParts> => {\n  if (!isGridProjectable([lat, lon])) {\n    return { ok: false, reason: 'out-of-range' };\n  }\n\n  try {\n    const utm = new LatLon(lat, lon).toUtm();\n\n    return {\n      ok: true,\n      value: {\n        zone: utm.zone,\n        hemisphere: utm.hemisphere as 'N' | 'S',\n        easting: Math.round(utm.easting),\n        northing: Math.round(utm.northing),\n      },\n    };\n  } catch {\n    // geodesy applies its own bounds after projecting; keep the result total\n    // rather than leaking a RangeError (e.g. an unpatched geodesy at 84°N).\n    return { ok: false, reason: 'out-of-range' };\n  }\n};\n\n/**\n * Renders UTM grid parts as their canonical coordinate string.\n *\n * Left-pads the zone to two digits and joins zone+hemisphere, easting, and\n * northing with single spaces, matching geodesy's `Utm.toString()` output.\n * `easting`/`northing` are already the rounded integer metres `toUtmParts`\n * yields, so no further rounding is applied here.\n *\n * @param parts - The UTM grid parts to render.\n * @returns The canonical UTM string, e.g. `\"18N 323394 4307396\"`.\n *\n * @remarks pure function\n *\n * @example\n * ```typescript\n * formatUtmParts({ zone: 18, hemisphere: 'N', easting: 323394, northing: 4307396 });\n * // '18N 323394 4307396'\n * ```\n */\nexport const formatUtmParts = ({\n  zone,\n  hemisphere,\n  easting,\n  northing,\n}: UtmParts): string =>\n  `${zone.toString().padStart(2, '0')}${hemisphere} ${easting} ${northing}`;\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;AAqBA,MAAa,oBAAoB;;;;;;;AAQjC,MAAa,oBAAoB;;;;;;;;;AAkCjC,MAAa,oBAAoB,QAC/B,OAAO,qBAAqB,OAAO;;;;;;;;;;;;;;AAerC,MAAa,2BAA2B,QAAyB,QAAQ;;;;;;;;;;;;;;;AAgBzE,MAAa,qBAAqB,CAAC,KAAK,SACtC,yBAAyB,KAAK,IAAI,IAClC,iBAAiB,IAAI,IACrB,CAAC,wBAAwB,IAAI;;;;;;;;;;;;;;;;;;;;;;;;;;;AA4B/B,MAAa,cAAc,CAAC,KAAK,SAGA;AAC/B,KAAI,CAAC,kBAAkB,CAAC,KAAK,IAAI,CAAC,CAChC,QAAO;EAAE,IAAI;EAAO,QAAQ;EAAgB;AAG9C,KAAI;EACF,MAAM,MAAM,IAAI,OAAO,KAAK,IAAI,CAAC,OAAO;AAExC,SAAO;GACL,IAAI;GACJ,OAAO;IACL,MAAM,IAAI;IACV,YAAY,IAAI;IAChB,SAAS,KAAK,MAAM,IAAI,QAAQ;IAChC,UAAU,KAAK,MAAM,IAAI,SAAS;IACnC;GACF;SACK;AAGN,SAAO;GAAE,IAAI;GAAO,QAAQ;GAAgB;;;;;;;;;;;;;;;;;;;;;;AAuBhD,MAAa,kBAAkB,EAC7B,MACA,YACA,SACA,eAEA,GAAG,KAAK,UAAU,CAAC,SAAS,GAAG,IAAI,GAAG,WAAW,GAAG,QAAQ,GAAG"}

package/dist/coordinates/utm/system.d.ts

@@ -1,5 +1,5 @@
 /*
- * Copyright 2025 Hypergiant Galactic Systems Inc. All rights reserved.
+ * Copyright 2026 Hypergiant Galactic Systems Inc. All rights reserved.
  * This file is licensed to you under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License. You may obtain a copy
  * of the License at https://www.apache.org/licenses/LICENSE-2.0

package/dist/coordinates/utm/system.js

@@ -1,5 +1,5 @@
 /*
- * Copyright 2025 Hypergiant Galactic Systems Inc. All rights reserved.
+ * Copyright 2026 Hypergiant Galactic Systems Inc. All rights reserved.
  * This file is licensed to you under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License. You may obtain a copy
  * of the License at https://www.apache.org/licenses/LICENSE-2.0
@@ -12,8 +12,8 @@
 
 
 import { SYMBOL_PATTERNS } from "../latlon/internal/index.js";
+import { formatUtmParts, toUtmParts } from "./parts.js";
 import { parseUTM } from "./parser.js";
-import { LatLon } from "geodesy/utm";
 
 //#region src/coordinates/utm/system.ts
 /**
@@ -45,8 +45,9 @@ const systemUTM = {
 	},
 	toFormat(format, [left, right]) {
 		const { LAT, LON } = Object.fromEntries([[format.slice(0, 3), left], [format.slice(3), right]]);
-		const utm = new LatLon(LAT, LON).toUtm();
-		return `${utm.zone.toString().padStart(2, "0")}${utm.hemisphere} ${Math.round(utm.easting).toString()} ${Math.round(utm.northing).toString()}`;
+		const result = toUtmParts([LAT, LON]);
+		if (!result.ok) throw new RangeError(`Coordinate [${LAT}, ${LON}] cannot be represented in UTM (outside 80°S–84°N, on the +180° antimeridian, or not finite).`);
+		return formatUtmParts(result.value);
 	}
 };
 

package/dist/coordinates/utm/system.js.map

@@ -1 +1 @@
-{"version":3,"file":"system.js","names":["systemUTM: CoordinateSystem"],"sources":["../../../src/coordinates/utm/system.ts"],"sourcesContent":["// __private-exports\n/*\n * Copyright 2024 Hypergiant Galactic Systems Inc. All rights reserved.\n * This file is licensed to you under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License. You may obtain a copy\n * of the License at https://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software distributed under\n * the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\n * OF ANY KIND, either express or implied. See the License for the specific language\n * governing permissions and limitations under the License.\n */\n\nimport { LatLon } from 'geodesy/utm';\nimport { type Compass, type Format, SYMBOL_PATTERNS } from '../latlon/internal';\nimport { parseUTM } from './parser';\nimport type { CoordinateSystem } from '../latlon/internal/coordinate-system';\n\n/**\n * Universal Transverse Mercator (UTM) coordinate system implementation.\n *\n * Provides parsing, conversion, and formatting for UTM coordinates. UTM divides\n * the Earth into 60 zones, each 6 degrees of longitude wide, using a transverse\n * Mercator projection. Coordinates are expressed as zone number, hemisphere (N/S),\n * easting, and northing values.\n *\n * @example\n * ```typescript\n * systemUTM.parse(null, '18N 585628 4511644');\n * // [['40.7128', '/', '-74.0060'], []]\n * ```\n *\n * @example\n * ```typescript\n * systemUTM.toFormat('LATLON', [40.7128, -74.0060]);\n * // '18N 585628 4511644'\n * ```\n */\nexport const systemUTM: CoordinateSystem = {\n  name: 'Universal Transverse Mercator',\n\n  parse: parseUTM,\n\n  toFloat(arg) {\n    const [num, bear] = arg as [string, Compass];\n\n    return (\n      Number.parseFloat(num) *\n      (SYMBOL_PATTERNS.NEGATIVE_BEARINGS.test(bear) ? -1 : 1)\n    );\n  },\n\n  toFormat(format: Format, [left, right]: [number, number]) {\n    const { LAT, LON } = Object.fromEntries([\n      [format.slice(0, 3), left],\n      [format.slice(3), right],\n    ]) as Record<'LAT' | 'LON', number>;\n\n    const latlon = new LatLon(LAT, LON);\n    const utm = latlon.toUtm();\n\n    // Format UTM coordinates manually to ensure correct format\n    // Expected format: \"18N 585628 4511644\" (zone hemisphere easting northing)\n    const zone = utm.zone.toString().padStart(2, '0');\n    const hemisphere = utm.hemisphere;\n    const easting = Math.round(utm.easting).toString();\n    const northing = Math.round(utm.northing).toString();\n\n    return `${zone}${hemisphere} ${easting} ${northing}`;\n  },\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAsCA,MAAaA,YAA8B;CACzC,MAAM;CAEN,OAAO;CAEP,QAAQ,KAAK;EACX,MAAM,CAAC,KAAK,QAAQ;AAEpB,SACE,OAAO,WAAW,IAAI,IACrB,gBAAgB,kBAAkB,KAAK,KAAK,GAAG,KAAK;;CAIzD,SAAS,QAAgB,CAAC,MAAM,QAA0B;EACxD,MAAM,EAAE,KAAK,QAAQ,OAAO,YAAY,CACtC,CAAC,OAAO,MAAM,GAAG,EAAE,EAAE,KAAK,EAC1B,CAAC,OAAO,MAAM,EAAE,EAAE,MAAM,CACzB,CAAC;EAGF,MAAM,MADS,IAAI,OAAO,KAAK,IAAI,CAChB,OAAO;AAS1B,SAAO,GALM,IAAI,KAAK,UAAU,CAAC,SAAS,GAAG,IAAI,GAC9B,IAAI,WAIK,GAHZ,KAAK,MAAM,IAAI,QAAQ,CAAC,UAAU,CAGX,GAFtB,KAAK,MAAM,IAAI,SAAS,CAAC,UAAU;;CAIvD"}
+{"version":3,"file":"system.js","names":["systemUTM: CoordinateSystem"],"sources":["../../../src/coordinates/utm/system.ts"],"sourcesContent":["// __private-exports\n/*\n * Copyright 2024 Hypergiant Galactic Systems Inc. All rights reserved.\n * This file is licensed to you under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License. You may obtain a copy\n * of the License at https://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software distributed under\n * the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\n * OF ANY KIND, either express or implied. See the License for the specific language\n * governing permissions and limitations under the License.\n */\n\nimport { type Compass, type Format, SYMBOL_PATTERNS } from '../latlon/internal';\nimport { parseUTM } from './parser';\nimport { formatUtmParts, toUtmParts } from './parts';\nimport type { CoordinateSystem } from '../latlon/internal/coordinate-system';\n\n/**\n * Universal Transverse Mercator (UTM) coordinate system implementation.\n *\n * Provides parsing, conversion, and formatting for UTM coordinates. UTM divides\n * the Earth into 60 zones, each 6 degrees of longitude wide, using a transverse\n * Mercator projection. Coordinates are expressed as zone number, hemisphere (N/S),\n * easting, and northing values.\n *\n * @example\n * ```typescript\n * systemUTM.parse(null, '18N 585628 4511644');\n * // [['40.7128', '/', '-74.0060'], []]\n * ```\n *\n * @example\n * ```typescript\n * systemUTM.toFormat('LATLON', [40.7128, -74.0060]);\n * // '18N 585628 4511644'\n * ```\n */\nexport const systemUTM: CoordinateSystem = {\n  name: 'Universal Transverse Mercator',\n\n  parse: parseUTM,\n\n  toFloat(arg) {\n    const [num, bear] = arg as [string, Compass];\n\n    return (\n      Number.parseFloat(num) *\n      (SYMBOL_PATTERNS.NEGATIVE_BEARINGS.test(bear) ? -1 : 1)\n    );\n  },\n\n  toFormat(format: Format, [left, right]: [number, number]) {\n    const { LAT, LON } = Object.fromEntries([\n      [format.slice(0, 3), left],\n      [format.slice(3), right],\n    ]) as Record<'LAT' | 'LON', number>;\n\n    const result = toUtmParts([LAT, LON]);\n\n    if (!result.ok) {\n      // The legacy `toFormat` contract throws for coordinates the grid cannot\n      // represent; the parts API returns `{ ok: false }` for the same inputs.\n      throw new RangeError(\n        `Coordinate [${LAT}, ${LON}] cannot be represented in UTM (outside 80°S–84°N, on the +180° antimeridian, or not finite).`,\n      );\n    }\n\n    return formatUtmParts(result.value);\n  },\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAsCA,MAAaA,YAA8B;CACzC,MAAM;CAEN,OAAO;CAEP,QAAQ,KAAK;EACX,MAAM,CAAC,KAAK,QAAQ;AAEpB,SACE,OAAO,WAAW,IAAI,IACrB,gBAAgB,kBAAkB,KAAK,KAAK,GAAG,KAAK;;CAIzD,SAAS,QAAgB,CAAC,MAAM,QAA0B;EACxD,MAAM,EAAE,KAAK,QAAQ,OAAO,YAAY,CACtC,CAAC,OAAO,MAAM,GAAG,EAAE,EAAE,KAAK,EAC1B,CAAC,OAAO,MAAM,EAAE,EAAE,MAAM,CACzB,CAAC;EAEF,MAAM,SAAS,WAAW,CAAC,KAAK,IAAI,CAAC;AAErC,MAAI,CAAC,OAAO,GAGV,OAAM,IAAI,WACR,eAAe,IAAI,IAAI,IAAI,+FAC5B;AAGH,SAAO,eAAe,OAAO,MAAM;;CAEtC"}