@accelint/geo 0.6.1 → 0.7.0

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.js

@@ -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"}

package/dist/index.d.ts

@@ -11,16 +11,19 @@
  */
 
 import { CoordinateInput, CoordinateInternalValue, CoordinateObject, CoordinateTuple, LatLonTuple, LonLatTuple, isCoordinateObject, isCoordinateTuple, normalizeObjectToLatLon, tupleToLatLon } from "./coordinates/latlon/internal/normalize.js";
-import { isFiniteNumber, validateNumericCoordinate, validateSignedRange } from "./coordinates/latlon/internal/validate.js";
+import { toPlainDecimalString } from "./coordinates/latlon/internal/plain-decimal.js";
+import { isFiniteNumber, isValidNumericCoordinate, validateNumericCoordinate, validateSignedRange } from "./coordinates/latlon/internal/validate.js";
 import { coordinateSystems, createCoordinate } from "./coordinates/coordinate.js";
-import { FormatOptions, createFormatter } from "./coordinates/latlon/internal/format.js";
-import { formatDecimalDegrees } from "./coordinates/latlon/decimal-degrees/formatter.js";
+import { FormatOptions, createFormatter, formatCoordinateSystem } from "./coordinates/latlon/internal/format.js";
+import { Axis, Hemisphere, getHemisphere, getOrdinal } from "./coordinates/latlon/internal/ordinal.js";
+import { DECIMAL_DEGREES_PRECISION, DecimalDegreesParts, formatDecimalDegrees, toDecimalDegreesParts } from "./coordinates/latlon/decimal-degrees/formatter.js";
 import { parseDecimalDegrees } from "./coordinates/latlon/decimal-degrees/parser.js";
-import { formatDegreesDecimalMinutes } from "./coordinates/latlon/degrees-decimal-minutes/formatter.js";
+import { DDM_PRECISION, DdmParts, formatDegreesDecimalMinutes, toDdmParts } from "./coordinates/latlon/degrees-decimal-minutes/formatter.js";
 import { parseDegreesDecimalMinutes } from "./coordinates/latlon/degrees-decimal-minutes/parser.js";
-import { formatDegreesMinutesSeconds } from "./coordinates/latlon/degrees-minutes-seconds/formatter.js";
+import { DMS_PRECISION, DmsParts, formatDegreesMinutesSeconds, toDmsParts } from "./coordinates/latlon/degrees-minutes-seconds/formatter.js";
 import { parseDegreesMinutesSeconds } from "./coordinates/latlon/degrees-minutes-seconds/parser.js";
-import { getOrdinal } from "./coordinates/latlon/internal/ordinal.js";
 import { parseMGRS } from "./coordinates/mgrs/parser.js";
+import { GRID_LATITUDE_MAX, GRID_LATITUDE_MIN, GridPartsResult, UtmParts, formatUtmParts, isGridProjectable, isOnEasternAntimeridian, isWithinGridBand, toUtmParts } from "./coordinates/utm/parts.js";
+import { MgrsParts, formatMgrsParts, toMgrsParts } from "./coordinates/mgrs/parts.js";
 import { parseUTM } from "./coordinates/utm/parser.js";
-export { type CoordinateInput, type CoordinateInternalValue, type CoordinateObject, type CoordinateTuple, type FormatOptions, type LatLonTuple, type LonLatTuple, coordinateSystems, createCoordinate, createFormatter, formatDecimalDegrees, formatDegreesDecimalMinutes, formatDegreesMinutesSeconds, getOrdinal, isCoordinateObject, isCoordinateTuple, isFiniteNumber, normalizeObjectToLatLon, parseDecimalDegrees, parseDegreesDecimalMinutes, parseDegreesMinutesSeconds, parseMGRS, parseUTM, tupleToLatLon, validateNumericCoordinate, validateSignedRange };
+export { type Axis, type CoordinateInput, type CoordinateInternalValue, type CoordinateObject, type CoordinateTuple, DDM_PRECISION, DECIMAL_DEGREES_PRECISION, DMS_PRECISION, type DdmParts, type DecimalDegreesParts, type DmsParts, type FormatOptions, GRID_LATITUDE_MAX, GRID_LATITUDE_MIN, type GridPartsResult, type Hemisphere, type LatLonTuple, type LonLatTuple, type MgrsParts, type UtmParts, coordinateSystems, createCoordinate, createFormatter, formatCoordinateSystem, formatDecimalDegrees, formatDegreesDecimalMinutes, formatDegreesMinutesSeconds, formatMgrsParts, formatUtmParts, getHemisphere, getOrdinal, isCoordinateObject, isCoordinateTuple, isFiniteNumber, isGridProjectable, isOnEasternAntimeridian, isValidNumericCoordinate, isWithinGridBand, normalizeObjectToLatLon, parseDecimalDegrees, parseDegreesDecimalMinutes, parseDegreesMinutesSeconds, parseMGRS, parseUTM, toDdmParts, toDecimalDegreesParts, toDmsParts, toMgrsParts, toPlainDecimalString, toUtmParts, tupleToLatLon, validateNumericCoordinate, validateSignedRange };

package/dist/index.js

@@ -12,17 +12,20 @@
 
 
 import { isCoordinateObject, isCoordinateTuple, normalizeObjectToLatLon, tupleToLatLon } from "./coordinates/latlon/internal/normalize.js";
-import { isFiniteNumber, validateNumericCoordinate, validateSignedRange } from "./coordinates/latlon/internal/validate.js";
+import { toPlainDecimalString } from "./coordinates/latlon/internal/plain-decimal.js";
+import { isFiniteNumber, isValidNumericCoordinate, validateNumericCoordinate, validateSignedRange } from "./coordinates/latlon/internal/validate.js";
+import { getHemisphere, getOrdinal } from "./coordinates/latlon/internal/ordinal.js";
+import { createFormatter, formatCoordinateSystem } from "./coordinates/latlon/internal/format.js";
 import { parseDecimalDegrees } from "./coordinates/latlon/decimal-degrees/parser.js";
 import { parseDegreesDecimalMinutes } from "./coordinates/latlon/degrees-decimal-minutes/parser.js";
 import { parseDegreesMinutesSeconds } from "./coordinates/latlon/degrees-minutes-seconds/parser.js";
 import { parseMGRS } from "./coordinates/mgrs/parser.js";
+import { GRID_LATITUDE_MAX, GRID_LATITUDE_MIN, formatUtmParts, isGridProjectable, isOnEasternAntimeridian, isWithinGridBand, toUtmParts } from "./coordinates/utm/parts.js";
+import { formatMgrsParts, toMgrsParts } from "./coordinates/mgrs/parts.js";
 import { parseUTM } from "./coordinates/utm/parser.js";
 import { coordinateSystems, createCoordinate } from "./coordinates/coordinate.js";
-import { getOrdinal } from "./coordinates/latlon/internal/ordinal.js";
-import { createFormatter } from "./coordinates/latlon/internal/format.js";
-import { formatDecimalDegrees } from "./coordinates/latlon/decimal-degrees/formatter.js";
-import { formatDegreesDecimalMinutes } from "./coordinates/latlon/degrees-decimal-minutes/formatter.js";
-import { formatDegreesMinutesSeconds } from "./coordinates/latlon/degrees-minutes-seconds/formatter.js";
+import { DECIMAL_DEGREES_PRECISION, formatDecimalDegrees, toDecimalDegreesParts } from "./coordinates/latlon/decimal-degrees/formatter.js";
+import { DDM_PRECISION, formatDegreesDecimalMinutes, toDdmParts } from "./coordinates/latlon/degrees-decimal-minutes/formatter.js";
+import { DMS_PRECISION, formatDegreesMinutesSeconds, toDmsParts } from "./coordinates/latlon/degrees-minutes-seconds/formatter.js";
 
-export { coordinateSystems, createCoordinate, createFormatter, formatDecimalDegrees, formatDegreesDecimalMinutes, formatDegreesMinutesSeconds, getOrdinal, isCoordinateObject, isCoordinateTuple, isFiniteNumber, normalizeObjectToLatLon, parseDecimalDegrees, parseDegreesDecimalMinutes, parseDegreesMinutesSeconds, parseMGRS, parseUTM, tupleToLatLon, validateNumericCoordinate, validateSignedRange };
+export { DDM_PRECISION, DECIMAL_DEGREES_PRECISION, DMS_PRECISION, GRID_LATITUDE_MAX, GRID_LATITUDE_MIN, coordinateSystems, createCoordinate, createFormatter, formatCoordinateSystem, formatDecimalDegrees, formatDegreesDecimalMinutes, formatDegreesMinutesSeconds, formatMgrsParts, formatUtmParts, getHemisphere, getOrdinal, isCoordinateObject, isCoordinateTuple, isFiniteNumber, isGridProjectable, isOnEasternAntimeridian, isValidNumericCoordinate, isWithinGridBand, normalizeObjectToLatLon, parseDecimalDegrees, parseDegreesDecimalMinutes, parseDegreesMinutesSeconds, parseMGRS, parseUTM, toDdmParts, toDecimalDegreesParts, toDmsParts, toMgrsParts, toPlainDecimalString, toUtmParts, tupleToLatLon, validateNumericCoordinate, validateSignedRange };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@accelint/geo",
   "description": "A collection of JavaScript functions for working with coordinates and geospatial data.",
-  "version": "0.6.1",
+  "version": "0.7.0",
   "author": "https://hypergiant.com",
   "$schema": "https://json.schemastore.org/package",
   "dependencies": {
@@ -12,8 +12,8 @@
     "tsdown": "^0.18.0",
     "typescript": "^5.9.3",
     "vitest": "^4.0.15",
-    "@accelint/vitest-config": "0.1.6",
-    "@accelint/typescript-config": "0.1.4"
+    "@accelint/typescript-config": "0.1.4",
+    "@accelint/vitest-config": "0.1.6"
   },
   "engines": {
     "node": ">=22",
@@ -50,11 +50,14 @@
     "./coordinates/latlon/internal/pipes/fix-dividers": "./dist/coordinates/latlon/internal/pipes/fix-dividers.js",
     "./coordinates/latlon/internal/pipes/genome": "./dist/coordinates/latlon/internal/pipes/genome.js",
     "./coordinates/latlon/internal/pipes/simpler": "./dist/coordinates/latlon/internal/pipes/simpler.js",
+    "./coordinates/latlon/internal/plain-decimal": "./dist/coordinates/latlon/internal/plain-decimal.js",
     "./coordinates/latlon/internal/validate": "./dist/coordinates/latlon/internal/validate.js",
     "./coordinates/latlon/internal/violation": "./dist/coordinates/latlon/internal/violation.js",
     "./coordinates/mgrs/parser": "./dist/coordinates/mgrs/parser.js",
+    "./coordinates/mgrs/parts": "./dist/coordinates/mgrs/parts.js",
     "./coordinates/mgrs/system": "./dist/coordinates/mgrs/system.js",
     "./coordinates/utm/parser": "./dist/coordinates/utm/parser.js",
+    "./coordinates/utm/parts": "./dist/coordinates/utm/parts.js",
     "./coordinates/utm/system": "./dist/coordinates/utm/system.js",
     "./patterning": "./dist/patterning.js",
     "./package.json": "./package.json"