@accelint/geo 0.6.0 → 0.7.0

package/dist/coordinates/latlon/degrees-decimal-minutes/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
@@ -11,7 +11,9 @@
  */
 
 
-import { BEARINGS, SYMBOLS, SYMBOL_PATTERNS } from "../internal/index.js";
+import { toPlainDecimalString } from "../internal/plain-decimal.js";
+import { SYMBOL_PATTERNS } from "../internal/index.js";
+import { formatCoordinateSystem } from "../internal/format.js";
 import { parseDegreesDecimalMinutes } from "./parser.js";
 
 //#region src/coordinates/latlon/degrees-decimal-minutes/system.ts
@@ -53,12 +55,11 @@ const systemDegreesDecimalMinutes = {
 		const [degrees, minutes, bear] = arg;
 		return Number.parseFloat(((Number.parseFloat(degrees) + Number.parseFloat(minutes) / 60) * (SYMBOL_PATTERNS.NEGATIVE_BEARINGS.test(bear) ? -1 : 1)).toFixed(9));
 	},
-	toFormat(format, [left, right]) {
-		return [left, right].map((num, index) => {
-			const abs = Math.abs(num);
+	toFormat(format, coordinates) {
+		return formatCoordinateSystem(format, coordinates, (abs) => {
 			const deg = Math.floor(abs);
-			return `${deg} ${Number.parseFloat(((abs - deg) * 60).toFixed(10))} ${BEARINGS[format][index][+(num < 0)]}`;
-		}).join(` ${SYMBOLS.DIVIDER} `);
+			return `${deg} ${toPlainDecimalString(Number.parseFloat(((abs - deg) * 60).toFixed(10)))}`;
+		});
 	}
 };
 

package/dist/coordinates/latlon/degrees-decimal-minutes/system.js.map

@@ -1 +1 @@
-{"version":3,"file":"system.js","names":["systemDegreesDecimalMinutes: CoordinateSystem"],"sources":["../../../../src/coordinates/latlon/degrees-decimal-minutes/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 {\n  BEARINGS,\n  type Compass,\n  type Format,\n  SYMBOL_PATTERNS,\n  SYMBOLS,\n} from '../internal';\nimport { parseDegreesDecimalMinutes } from './parser';\nimport type { CoordinateSystem } from '../internal/coordinate-system';\n\n/**\n * Degrees Decimal Minutes coordinate system implementation.\n *\n * Provides parsing, conversion, and formatting for coordinates in degrees decimal minutes notation.\n * Coordinates are expressed as integer degrees and decimal minutes (e.g., 37° 46.4940' N).\n *\n * @property name - Human-readable name of the coordinate system.\n * @property parse - Parses degrees decimal minutes coordinate strings.\n * @property toFloat - Converts parsed coordinate components to floating point numbers.\n * @property toFormat - Formats numeric coordinates back to degrees decimal minutes string.\n *\n * @example\n * ```typescript\n * // Parse a coordinate string\n * const [coords, errors] = systemDegreesDecimalMinutes.parse('37° 46.4940' N / 122° 25.1640' W', 'LATLON');\n * ```\n *\n * @example\n * ```typescript\n * // Convert to float\n * const lat = systemDegreesDecimalMinutes.toFloat(['37', '46.4940', 'N']);\n * // 37.7749\n * ```\n *\n * @example\n * ```typescript\n * // Format to string\n * const formatted = systemDegreesDecimalMinutes.toFormat('LATLON', [37.7749, -122.4194]);\n * // '37 46.494 N / 122 25.164 W'\n * ```\n */\nexport const systemDegreesDecimalMinutes: CoordinateSystem = {\n  name: 'Degrees Decimal Minutes',\n\n  parse: parseDegreesDecimalMinutes,\n\n  toFloat(arg) {\n    const [degrees, minutes, bear] = arg as [string, string, Compass];\n\n    return Number.parseFloat(\n      (\n        (Number.parseFloat(degrees) + Number.parseFloat(minutes) / 60) *\n        (SYMBOL_PATTERNS.NEGATIVE_BEARINGS.test(bear) ? -1 : 1)\n      ).toFixed(9),\n    );\n  },\n\n  toFormat(format: Format, [left, right]: [number, number]) {\n    return [left, right]\n      .map((num, index) => {\n        const abs = Math.abs(num);\n        const deg = Math.floor(abs);\n        const min = Number.parseFloat(((abs - deg) * 60).toFixed(10));\n\n        return `${deg} ${min} ${BEARINGS[format][index as 0 | 1][+(num < 0)]}`;\n      })\n      .join(` ${SYMBOLS.DIVIDER} `);\n  },\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAsDA,MAAaA,8BAAgD;CAC3D,MAAM;CAEN,OAAO;CAEP,QAAQ,KAAK;EACX,MAAM,CAAC,SAAS,SAAS,QAAQ;AAEjC,SAAO,OAAO,aAET,OAAO,WAAW,QAAQ,GAAG,OAAO,WAAW,QAAQ,GAAG,OAC1D,gBAAgB,kBAAkB,KAAK,KAAK,GAAG,KAAK,IACrD,QAAQ,EAAE,CACb;;CAGH,SAAS,QAAgB,CAAC,MAAM,QAA0B;AACxD,SAAO,CAAC,MAAM,MAAM,CACjB,KAAK,KAAK,UAAU;GACnB,MAAM,MAAM,KAAK,IAAI,IAAI;GACzB,MAAM,MAAM,KAAK,MAAM,IAAI;AAG3B,UAAO,GAAG,IAAI,GAFF,OAAO,aAAa,MAAM,OAAO,IAAI,QAAQ,GAAG,CAAC,CAExC,GAAG,SAAS,QAAQ,OAAgB,EAAE,MAAM;IACjE,CACD,KAAK,IAAI,QAAQ,QAAQ,GAAG;;CAElC"}
+{"version":3,"file":"system.js","names":["systemDegreesDecimalMinutes: CoordinateSystem"],"sources":["../../../../src/coordinates/latlon/degrees-decimal-minutes/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 '../internal';\nimport { formatCoordinateSystem } from '../internal/format';\nimport { toPlainDecimalString } from '../internal/plain-decimal';\nimport { parseDegreesDecimalMinutes } from './parser';\nimport type { CoordinateSystem } from '../internal/coordinate-system';\n\n/**\n * Degrees Decimal Minutes coordinate system implementation.\n *\n * Provides parsing, conversion, and formatting for coordinates in degrees decimal minutes notation.\n * Coordinates are expressed as integer degrees and decimal minutes (e.g., 37° 46.4940' N).\n *\n * @property name - Human-readable name of the coordinate system.\n * @property parse - Parses degrees decimal minutes coordinate strings.\n * @property toFloat - Converts parsed coordinate components to floating point numbers.\n * @property toFormat - Formats numeric coordinates back to degrees decimal minutes string.\n *\n * @example\n * ```typescript\n * // Parse a coordinate string\n * const [coords, errors] = systemDegreesDecimalMinutes.parse('37° 46.4940' N / 122° 25.1640' W', 'LATLON');\n * ```\n *\n * @example\n * ```typescript\n * // Convert to float\n * const lat = systemDegreesDecimalMinutes.toFloat(['37', '46.4940', 'N']);\n * // 37.7749\n * ```\n *\n * @example\n * ```typescript\n * // Format to string\n * const formatted = systemDegreesDecimalMinutes.toFormat('LATLON', [37.7749, -122.4194]);\n * // '37 46.494 N / 122 25.164 W'\n * ```\n */\nexport const systemDegreesDecimalMinutes: CoordinateSystem = {\n  name: 'Degrees Decimal Minutes',\n\n  parse: parseDegreesDecimalMinutes,\n\n  toFloat(arg) {\n    const [degrees, minutes, bear] = arg as [string, string, Compass];\n\n    return Number.parseFloat(\n      (\n        (Number.parseFloat(degrees) + Number.parseFloat(minutes) / 60) *\n        (SYMBOL_PATTERNS.NEGATIVE_BEARINGS.test(bear) ? -1 : 1)\n      ).toFixed(9),\n    );\n  },\n\n  toFormat(format: Format, coordinates: [number, number]) {\n    return formatCoordinateSystem(format, coordinates, (abs) => {\n      const deg = Math.floor(abs);\n      const min = Number.parseFloat(((abs - deg) * 60).toFixed(10));\n\n      return `${deg} ${toPlainDecimalString(min)}`;\n    });\n  },\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAkDA,MAAaA,8BAAgD;CAC3D,MAAM;CAEN,OAAO;CAEP,QAAQ,KAAK;EACX,MAAM,CAAC,SAAS,SAAS,QAAQ;AAEjC,SAAO,OAAO,aAET,OAAO,WAAW,QAAQ,GAAG,OAAO,WAAW,QAAQ,GAAG,OAC1D,gBAAgB,kBAAkB,KAAK,KAAK,GAAG,KAAK,IACrD,QAAQ,EAAE,CACb;;CAGH,SAAS,QAAgB,aAA+B;AACtD,SAAO,uBAAuB,QAAQ,cAAc,QAAQ;GAC1D,MAAM,MAAM,KAAK,MAAM,IAAI;AAG3B,UAAO,GAAG,IAAI,GAAG,qBAFL,OAAO,aAAa,MAAM,OAAO,IAAI,QAAQ,GAAG,CAAC,CAEnB;IAC1C;;CAEL"}

package/dist/coordinates/latlon/degrees-minutes-seconds/formatter.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
@@ -11,9 +11,52 @@
  */
 
 import { FormatOptions } from "../internal/format.js";
+import { Axis, Hemisphere } from "../internal/ordinal.js";
 
 //#region src/coordinates/latlon/degrees-minutes-seconds/formatter.d.ts
-
+/** Default number of decimal places for degrees-minutes-seconds formatting. */
+declare const DMS_PRECISION = 2;
+/**
+ * Structured degrees-minutes-seconds parts for a single signed coordinate value.
+ *
+ * `degrees`, `minutes`, and `seconds` are non-negative; carry keeps `seconds`
+ * and `minutes` below `60`. The signed value is recoverable from the axis and
+ * `hemisphere`.
+ */
+type DmsParts = {
+  degrees: number;
+  minutes: number;
+  seconds: number;
+  hemisphere: Hemisphere;
+};
+/**
+ * Converts a single signed coordinate value into degrees-minutes-seconds parts.
+ *
+ * Applies the seconds/minutes carry (`60″ → +1′`, `60′ → +1°`) after rounding
+ * so `seconds` and `minutes` never reach `60`, then attaches the hemisphere
+ * letter for the axis.
+ *
+ * This is the display path: it rounds to `precision` and carries. The
+ * lossless round-trip representation returned by `createCoordinate(...).dms()`
+ * lives separately in `degrees-minutes-seconds/system.ts` (`toFormat`, via the
+ * shared `formatCoordinateSystem`), which keeps full precision and applies no
+ * carry so a value survives format → parse unchanged. The two are
+ * intentionally not shared — do not route one through the other.
+ *
+ * @param value - The signed coordinate value.
+ * @param axis - Whether the value is a latitude (`'lat'`) or longitude (`'lon'`).
+ * @param precision - Decimal places for the seconds (default `2`).
+ * @returns The `{ degrees, minutes, seconds, hemisphere }` parts object.
+ *
+ * @remarks pure function
+ *
+ * @example
+ * ```typescript
+ * toDmsParts(-77.0369, 'lon');
+ * // { degrees: 77, minutes: 2, seconds: 12.84, hemisphere: 'W' }
+ * ```
+ */
+declare const toDmsParts: (value: number, axis: Axis, precision?: number) => DmsParts;
 /**
  * Formats latitude/longitude coordinates in degrees minutes seconds notation.
  *
@@ -35,5 +78,5 @@ import { FormatOptions } from "../internal/format.js";
  */
 declare const formatDegreesMinutesSeconds: (coordinates: [number, number], config?: FormatOptions) => string;
 //#endregion
-export { formatDegreesMinutesSeconds };
+export { DMS_PRECISION, DmsParts, formatDegreesMinutesSeconds, toDmsParts };
 //# sourceMappingURL=formatter.d.ts.map

package/dist/coordinates/latlon/degrees-minutes-seconds/formatter.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
@@ -11,13 +11,74 @@
  */
 
 
+import { getHemisphere } from "../internal/ordinal.js";
 import { createFormatter } from "../internal/format.js";
 
 //#region src/coordinates/latlon/degrees-minutes-seconds/formatter.ts
+/** Default number of decimal places for degrees-minutes-seconds formatting. */
+const DMS_PRECISION = 2;
+/**
+* Splits a non-negative magnitude into whole degrees, whole minutes, and
+* decimal seconds, rounding the seconds to `precision` and carrying
+* `60″ → +1′ → +1°` so the output stays a valid coordinate. Shared core of
+* {@link toDmsParts} and the display string formatter.
+*
+* @param magnitude - Non-negative coordinate magnitude in degrees.
+* @param precision - Decimal places for the seconds.
+* @returns The `{ degrees, minutes, seconds }` triple.
+*
+* @remarks pure function
+*/
+const toDmsMagnitude = (magnitude, precision) => {
+	let degrees = Math.floor(magnitude);
+	const minutesFull = (magnitude - degrees) * 60;
+	let minutes = Math.floor(minutesFull);
+	let seconds = Number(((minutesFull - minutes) * 60).toFixed(precision));
+	minutes += Math.floor(seconds / 60);
+	seconds %= 60;
+	degrees += Math.floor(minutes / 60);
+	minutes %= 60;
+	return {
+		degrees,
+		minutes,
+		seconds
+	};
+};
+/**
+* Converts a single signed coordinate value into degrees-minutes-seconds parts.
+*
+* Applies the seconds/minutes carry (`60″ → +1′`, `60′ → +1°`) after rounding
+* so `seconds` and `minutes` never reach `60`, then attaches the hemisphere
+* letter for the axis.
+*
+* This is the display path: it rounds to `precision` and carries. The
+* lossless round-trip representation returned by `createCoordinate(...).dms()`
+* lives separately in `degrees-minutes-seconds/system.ts` (`toFormat`, via the
+* shared `formatCoordinateSystem`), which keeps full precision and applies no
+* carry so a value survives format → parse unchanged. The two are
+* intentionally not shared — do not route one through the other.
+*
+* @param value - The signed coordinate value.
+* @param axis - Whether the value is a latitude (`'lat'`) or longitude (`'lon'`).
+* @param precision - Decimal places for the seconds (default `2`).
+* @returns The `{ degrees, minutes, seconds, hemisphere }` parts object.
+*
+* @remarks pure function
+*
+* @example
+* ```typescript
+* toDmsParts(-77.0369, 'lon');
+* // { degrees: 77, minutes: 2, seconds: 12.84, hemisphere: 'W' }
+* ```
+*/
+const toDmsParts = (value, axis, precision = DMS_PRECISION) => ({
+	...toDmsMagnitude(Math.abs(value), precision),
+	hemisphere: getHemisphere(value, axis)
+});
 /**
 * Converts a coordinate value to degrees minutes seconds format.
 *
-* @param num - The coordinate value to format.
+* @param value - The coordinate value to format.
 * @returns Formatted coordinate string with degrees, minutes, and seconds (e.g., "45° 30' 15.23″").
 *
 * @example
@@ -32,11 +93,9 @@ import { createFormatter } from "../internal/format.js";
 * // '122° 25' 9.84″'
 * ```
 */
-const toDegreesMinutesSeconds = (num) => {
-	const degrees = Math.floor(Math.abs(num));
-	const minutesFull = (Math.abs(num) - degrees) * 60;
-	const minutes = Math.floor(minutesFull);
-	return `${degrees}° ${minutes}' ${((minutesFull - minutes) * 60).toFixed(2)}″`;
+const toDegreesMinutesSeconds = (value) => {
+	const { degrees, minutes, seconds } = toDmsMagnitude(Math.abs(value), DMS_PRECISION);
+	return `${degrees}° ${minutes}' ${seconds.toFixed(DMS_PRECISION)}″`;
 };
 /**
 * Formats latitude/longitude coordinates in degrees minutes seconds notation.
@@ -60,5 +119,5 @@ const toDegreesMinutesSeconds = (num) => {
 const formatDegreesMinutesSeconds = createFormatter(toDegreesMinutesSeconds);
 
 //#endregion
-export { formatDegreesMinutesSeconds };
+export { DMS_PRECISION, formatDegreesMinutesSeconds, toDmsParts };
 //# sourceMappingURL=formatter.js.map

package/dist/coordinates/latlon/degrees-minutes-seconds/formatter.js.map

@@ -1 +1 @@
-{"version":3,"file":"formatter.js","names":[],"sources":["../../../../src/coordinates/latlon/degrees-minutes-seconds/formatter.ts"],"sourcesContent":["/*\n * Copyright 2025 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 { createFormatter } from '../internal/format';\n\n/**\n * Converts a coordinate value to degrees minutes seconds format.\n *\n * @param num - The coordinate value to format.\n * @returns Formatted coordinate string with degrees, minutes, and seconds (e.g., \"45° 30' 15.23″\").\n *\n * @example\n * ```typescript\n * toDegreesMinutesSeconds(45.5042);\n * // '45° 30' 15.12″'\n * ```\n *\n * @example\n * ```typescript\n * toDegreesMinutesSeconds(-122.4194);\n * // '122° 25' 9.84″'\n * ```\n */\nconst toDegreesMinutesSeconds = (num: number): string => {\n  const degrees = Math.floor(Math.abs(num));\n  const minutesFull = (Math.abs(num) - degrees) * 60;\n  const minutes = Math.floor(minutesFull);\n  const seconds = ((minutesFull - minutes) * 60).toFixed(2);\n\n  return `${degrees}° ${minutes}' ${seconds}″`;\n};\n\n/**\n * Formats latitude/longitude coordinates in degrees minutes seconds notation.\n *\n * @param coordinates - Tuple of [latitude, longitude] values.\n * @param config - Optional formatting configuration.\n * @returns Formatted coordinate string in degrees minutes seconds format.\n *\n * @example\n * ```typescript\n * formatDegreesMinutesSeconds([37.7749, -122.4194]);\n * // '37° 46' 29.64″ N, 122° 25' 9.84″ W'\n * ```\n *\n * @example\n * ```typescript\n * formatDegreesMinutesSeconds([37.7749, -122.4194], { separator: ' / ' });\n * // '37° 46' 29.64″ N / 122° 25' 9.84″ W'\n * ```\n */\nexport const formatDegreesMinutesSeconds = createFormatter(\n  toDegreesMinutesSeconds,\n);\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAgCA,MAAM,2BAA2B,QAAwB;CACvD,MAAM,UAAU,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC;CACzC,MAAM,eAAe,KAAK,IAAI,IAAI,GAAG,WAAW;CAChD,MAAM,UAAU,KAAK,MAAM,YAAY;AAGvC,QAAO,GAAG,QAAQ,IAAI,QAAQ,MAFZ,cAAc,WAAW,IAAI,QAAQ,EAAE,CAEf;;;;;;;;;;;;;;;;;;;;;AAsB5C,MAAa,8BAA8B,gBACzC,wBACD"}
+{"version":3,"file":"formatter.js","names":[],"sources":["../../../../src/coordinates/latlon/degrees-minutes-seconds/formatter.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 { createFormatter } from '../internal/format';\nimport { type Axis, getHemisphere, type Hemisphere } from '../internal/ordinal';\n\n/** Default number of decimal places for degrees-minutes-seconds formatting. */\nexport const DMS_PRECISION = 2;\n\n/**\n * Structured degrees-minutes-seconds parts for a single signed coordinate value.\n *\n * `degrees`, `minutes`, and `seconds` are non-negative; carry keeps `seconds`\n * and `minutes` below `60`. The signed value is recoverable from the axis and\n * `hemisphere`.\n */\nexport type DmsParts = {\n  degrees: number;\n  minutes: number;\n  seconds: number;\n  hemisphere: Hemisphere;\n};\n\n/**\n * Splits a non-negative magnitude into whole degrees, whole minutes, and\n * decimal seconds, rounding the seconds to `precision` and carrying\n * `60″ → +1′ → +1°` so the output stays a valid coordinate. Shared core of\n * {@link toDmsParts} and the display string formatter.\n *\n * @param magnitude - Non-negative coordinate magnitude in degrees.\n * @param precision - Decimal places for the seconds.\n * @returns The `{ degrees, minutes, seconds }` triple.\n *\n * @remarks pure function\n */\nconst toDmsMagnitude = (\n  magnitude: number,\n  precision: number,\n): Pick<DmsParts, 'degrees' | 'minutes' | 'seconds'> => {\n  let degrees = Math.floor(magnitude);\n  const minutesFull = (magnitude - degrees) * 60;\n  let minutes = Math.floor(minutesFull);\n  let seconds = Number(((minutesFull - minutes) * 60).toFixed(precision));\n\n  // Rounding can produce 60 seconds (e.g. 40.9999999 -> 40° 59' 60.00″);\n  // carry into minutes (and degrees) so the output stays a valid coordinate.\n  minutes += Math.floor(seconds / 60);\n  seconds %= 60;\n  degrees += Math.floor(minutes / 60);\n  minutes %= 60;\n\n  return { degrees, minutes, seconds };\n};\n\n/**\n * Converts a single signed coordinate value into degrees-minutes-seconds parts.\n *\n * Applies the seconds/minutes carry (`60″ → +1′`, `60′ → +1°`) after rounding\n * so `seconds` and `minutes` never reach `60`, then attaches the hemisphere\n * letter for the axis.\n *\n * This is the display path: it rounds to `precision` and carries. The\n * lossless round-trip representation returned by `createCoordinate(...).dms()`\n * lives separately in `degrees-minutes-seconds/system.ts` (`toFormat`, via the\n * shared `formatCoordinateSystem`), which keeps full precision and applies no\n * carry so a value survives format → parse unchanged. The two are\n * intentionally not shared — do not route one through the other.\n *\n * @param value - The signed coordinate value.\n * @param axis - Whether the value is a latitude (`'lat'`) or longitude (`'lon'`).\n * @param precision - Decimal places for the seconds (default `2`).\n * @returns The `{ degrees, minutes, seconds, hemisphere }` parts object.\n *\n * @remarks pure function\n *\n * @example\n * ```typescript\n * toDmsParts(-77.0369, 'lon');\n * // { degrees: 77, minutes: 2, seconds: 12.84, hemisphere: 'W' }\n * ```\n */\nexport const toDmsParts = (\n  value: number,\n  axis: Axis,\n  precision: number = DMS_PRECISION,\n): DmsParts => ({\n  ...toDmsMagnitude(Math.abs(value), precision),\n  hemisphere: getHemisphere(value, axis),\n});\n\n/**\n * Converts a coordinate value to degrees minutes seconds format.\n *\n * @param value - The coordinate value to format.\n * @returns Formatted coordinate string with degrees, minutes, and seconds (e.g., \"45° 30' 15.23″\").\n *\n * @example\n * ```typescript\n * toDegreesMinutesSeconds(45.5042);\n * // '45° 30' 15.12″'\n * ```\n *\n * @example\n * ```typescript\n * toDegreesMinutesSeconds(-122.4194);\n * // '122° 25' 9.84″'\n * ```\n */\nconst toDegreesMinutesSeconds = (value: number): string => {\n  const { degrees, minutes, seconds } = toDmsMagnitude(\n    Math.abs(value),\n    DMS_PRECISION,\n  );\n\n  return `${degrees}° ${minutes}' ${seconds.toFixed(DMS_PRECISION)}″`;\n};\n\n/**\n * Formats latitude/longitude coordinates in degrees minutes seconds notation.\n *\n * @param coordinates - Tuple of [latitude, longitude] values.\n * @param config - Optional formatting configuration.\n * @returns Formatted coordinate string in degrees minutes seconds format.\n *\n * @example\n * ```typescript\n * formatDegreesMinutesSeconds([37.7749, -122.4194]);\n * // '37° 46' 29.64″ N, 122° 25' 9.84″ W'\n * ```\n *\n * @example\n * ```typescript\n * formatDegreesMinutesSeconds([37.7749, -122.4194], { separator: ' / ' });\n * // '37° 46' 29.64″ N / 122° 25' 9.84″ W'\n * ```\n */\nexport const formatDegreesMinutesSeconds = createFormatter(\n  toDegreesMinutesSeconds,\n);\n"],"mappings":";;;;;;;;;;;;;;;;;;AAgBA,MAAa,gBAAgB;;;;;;;;;;;;;AA4B7B,MAAM,kBACJ,WACA,cACsD;CACtD,IAAI,UAAU,KAAK,MAAM,UAAU;CACnC,MAAM,eAAe,YAAY,WAAW;CAC5C,IAAI,UAAU,KAAK,MAAM,YAAY;CACrC,IAAI,UAAU,SAAS,cAAc,WAAW,IAAI,QAAQ,UAAU,CAAC;AAIvE,YAAW,KAAK,MAAM,UAAU,GAAG;AACnC,YAAW;AACX,YAAW,KAAK,MAAM,UAAU,GAAG;AACnC,YAAW;AAEX,QAAO;EAAE;EAAS;EAAS;EAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA8BtC,MAAa,cACX,OACA,MACA,YAAoB,mBACN;CACd,GAAG,eAAe,KAAK,IAAI,MAAM,EAAE,UAAU;CAC7C,YAAY,cAAc,OAAO,KAAK;CACvC;;;;;;;;;;;;;;;;;;;AAoBD,MAAM,2BAA2B,UAA0B;CACzD,MAAM,EAAE,SAAS,SAAS,YAAY,eACpC,KAAK,IAAI,MAAM,EACf,cACD;AAED,QAAO,GAAG,QAAQ,IAAI,QAAQ,IAAI,QAAQ,QAAQ,cAAc,CAAC;;;;;;;;;;;;;;;;;;;;;AAsBnE,MAAa,8BAA8B,gBACzC,wBACD"}

package/dist/coordinates/latlon/degrees-minutes-seconds/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/latlon/degrees-minutes-seconds/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/latlon/degrees-minutes-seconds/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/latlon/degrees-minutes-seconds/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
@@ -11,7 +11,9 @@
  */
 
 
-import { BEARINGS, SYMBOLS, SYMBOL_PATTERNS } from "../internal/index.js";
+import { toPlainDecimalString } from "../internal/plain-decimal.js";
+import { SYMBOL_PATTERNS } from "../internal/index.js";
+import { formatCoordinateSystem } from "../internal/format.js";
 import { parseDegreesMinutesSeconds } from "./parser.js";
 
 //#region src/coordinates/latlon/degrees-minutes-seconds/system.ts
@@ -53,14 +55,13 @@ const systemDegreesMinutesSeconds = {
 		const [degrees, minutes, seconds, bear] = arg;
 		return Number.parseFloat(((Number.parseFloat(degrees) + Number.parseFloat(minutes) / 60 + Number.parseFloat(seconds) / 3600) * (SYMBOL_PATTERNS.NEGATIVE_BEARINGS.test(bear) ? -1 : 1)).toFixed(9));
 	},
-	toFormat(format, [left, right]) {
-		return [left, right].map((num, index) => {
-			const abs = Math.abs(num);
+	toFormat(format, coordinates) {
+		return formatCoordinateSystem(format, coordinates, (abs) => {
 			const deg = Math.floor(abs);
 			const rem = (abs - deg) * 60;
 			const min = Math.floor(rem);
-			return `${deg} ${min} ${Number.parseFloat(((rem - min) * 60).toFixed(10))} ${BEARINGS[format][index][+(num < 0)]}`;
-		}).join(` ${SYMBOLS.DIVIDER} `);
+			return `${deg} ${min} ${toPlainDecimalString(Number.parseFloat(((rem - min) * 60).toFixed(10)))}`;
+		});
 	}
 };
 

package/dist/coordinates/latlon/degrees-minutes-seconds/system.js.map

@@ -1 +1 @@
-{"version":3,"file":"system.js","names":["systemDegreesMinutesSeconds: CoordinateSystem"],"sources":["../../../../src/coordinates/latlon/degrees-minutes-seconds/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 {\n  BEARINGS,\n  type Compass,\n  type Format,\n  SYMBOL_PATTERNS,\n  SYMBOLS,\n} from '../internal';\nimport { parseDegreesMinutesSeconds } from './parser';\nimport type { CoordinateSystem } from '../internal/coordinate-system';\n\n/**\n * Degrees Minutes Seconds coordinate system implementation.\n *\n * Provides parsing, conversion, and formatting for coordinates in degrees minutes seconds notation.\n * Coordinates are expressed as integer degrees, integer minutes, and decimal seconds (e.g., 37° 46' 29.64″ N).\n *\n * @property name - Human-readable name of the coordinate system.\n * @property parse - Parses degrees minutes seconds coordinate strings.\n * @property toFloat - Converts parsed coordinate components to floating point numbers.\n * @property toFormat - Formats numeric coordinates back to degrees minutes seconds string.\n *\n * @example\n * ```typescript\n * // Parse a coordinate string\n * const [coords, errors] = systemDegreesMinutesSeconds.parse('37° 46' 29.64″ N / 122° 25' 9.84″ W', 'LATLON');\n * ```\n *\n * @example\n * ```typescript\n * // Convert to float\n * const lat = systemDegreesMinutesSeconds.toFloat(['37', '46', '29.64', 'N']);\n * // 37.7749\n * ```\n *\n * @example\n * ```typescript\n * // Format to string\n * const formatted = systemDegreesMinutesSeconds.toFormat('LATLON', [37.7749, -122.4194]);\n * // '37 46 29.64 N / 122 25 9.84 W'\n * ```\n */\nexport const systemDegreesMinutesSeconds: CoordinateSystem = {\n  name: 'Degrees Minutes Seconds',\n\n  parse: parseDegreesMinutesSeconds,\n\n  toFloat(arg) {\n    const [degrees, minutes, seconds, bear] = arg as [\n      string,\n      string,\n      string,\n      Compass,\n    ];\n\n    return Number.parseFloat(\n      (\n        (Number.parseFloat(degrees) +\n          Number.parseFloat(minutes) / 60 +\n          Number.parseFloat(seconds) / 3600) *\n        (SYMBOL_PATTERNS.NEGATIVE_BEARINGS.test(bear) ? -1 : 1)\n      ).toFixed(9),\n    );\n  },\n\n  toFormat(format: Format, [left, right]: [number, number]) {\n    return [left, right]\n      .map((num, index) => {\n        const abs = Math.abs(num);\n        const deg = Math.floor(abs);\n        const rem = (abs - deg) * 60;\n        const min = Math.floor(rem);\n        const sec = Number.parseFloat(((rem - min) * 60).toFixed(10));\n\n        return `${deg} ${min} ${sec} ${BEARINGS[format][index as 0 | 1][+(num < 0)]}`;\n      })\n      .join(` ${SYMBOLS.DIVIDER} `);\n  },\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAsDA,MAAaA,8BAAgD;CAC3D,MAAM;CAEN,OAAO;CAEP,QAAQ,KAAK;EACX,MAAM,CAAC,SAAS,SAAS,SAAS,QAAQ;AAO1C,SAAO,OAAO,aAET,OAAO,WAAW,QAAQ,GACzB,OAAO,WAAW,QAAQ,GAAG,KAC7B,OAAO,WAAW,QAAQ,GAAG,SAC9B,gBAAgB,kBAAkB,KAAK,KAAK,GAAG,KAAK,IACrD,QAAQ,EAAE,CACb;;CAGH,SAAS,QAAgB,CAAC,MAAM,QAA0B;AACxD,SAAO,CAAC,MAAM,MAAM,CACjB,KAAK,KAAK,UAAU;GACnB,MAAM,MAAM,KAAK,IAAI,IAAI;GACzB,MAAM,MAAM,KAAK,MAAM,IAAI;GAC3B,MAAM,OAAO,MAAM,OAAO;GAC1B,MAAM,MAAM,KAAK,MAAM,IAAI;AAG3B,UAAO,GAAG,IAAI,GAAG,IAAI,GAFT,OAAO,aAAa,MAAM,OAAO,IAAI,QAAQ,GAAG,CAAC,CAEjC,GAAG,SAAS,QAAQ,OAAgB,EAAE,MAAM;IACxE,CACD,KAAK,IAAI,QAAQ,QAAQ,GAAG;;CAElC"}
+{"version":3,"file":"system.js","names":["systemDegreesMinutesSeconds: CoordinateSystem"],"sources":["../../../../src/coordinates/latlon/degrees-minutes-seconds/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 '../internal';\nimport { formatCoordinateSystem } from '../internal/format';\nimport { toPlainDecimalString } from '../internal/plain-decimal';\nimport { parseDegreesMinutesSeconds } from './parser';\nimport type { CoordinateSystem } from '../internal/coordinate-system';\n\n/**\n * Degrees Minutes Seconds coordinate system implementation.\n *\n * Provides parsing, conversion, and formatting for coordinates in degrees minutes seconds notation.\n * Coordinates are expressed as integer degrees, integer minutes, and decimal seconds (e.g., 37° 46' 29.64″ N).\n *\n * @property name - Human-readable name of the coordinate system.\n * @property parse - Parses degrees minutes seconds coordinate strings.\n * @property toFloat - Converts parsed coordinate components to floating point numbers.\n * @property toFormat - Formats numeric coordinates back to degrees minutes seconds string.\n *\n * @example\n * ```typescript\n * // Parse a coordinate string\n * const [coords, errors] = systemDegreesMinutesSeconds.parse('37° 46' 29.64″ N / 122° 25' 9.84″ W', 'LATLON');\n * ```\n *\n * @example\n * ```typescript\n * // Convert to float\n * const lat = systemDegreesMinutesSeconds.toFloat(['37', '46', '29.64', 'N']);\n * // 37.7749\n * ```\n *\n * @example\n * ```typescript\n * // Format to string\n * const formatted = systemDegreesMinutesSeconds.toFormat('LATLON', [37.7749, -122.4194]);\n * // '37 46 29.64 N / 122 25 9.84 W'\n * ```\n */\nexport const systemDegreesMinutesSeconds: CoordinateSystem = {\n  name: 'Degrees Minutes Seconds',\n\n  parse: parseDegreesMinutesSeconds,\n\n  toFloat(arg) {\n    const [degrees, minutes, seconds, bear] = arg as [\n      string,\n      string,\n      string,\n      Compass,\n    ];\n\n    return Number.parseFloat(\n      (\n        (Number.parseFloat(degrees) +\n          Number.parseFloat(minutes) / 60 +\n          Number.parseFloat(seconds) / 3600) *\n        (SYMBOL_PATTERNS.NEGATIVE_BEARINGS.test(bear) ? -1 : 1)\n      ).toFixed(9),\n    );\n  },\n\n  toFormat(format: Format, coordinates: [number, number]) {\n    return formatCoordinateSystem(format, coordinates, (abs) => {\n      const deg = Math.floor(abs);\n      const rem = (abs - deg) * 60;\n      const min = Math.floor(rem);\n      const sec = Number.parseFloat(((rem - min) * 60).toFixed(10));\n\n      return `${deg} ${min} ${toPlainDecimalString(sec)}`;\n    });\n  },\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAkDA,MAAaA,8BAAgD;CAC3D,MAAM;CAEN,OAAO;CAEP,QAAQ,KAAK;EACX,MAAM,CAAC,SAAS,SAAS,SAAS,QAAQ;AAO1C,SAAO,OAAO,aAET,OAAO,WAAW,QAAQ,GACzB,OAAO,WAAW,QAAQ,GAAG,KAC7B,OAAO,WAAW,QAAQ,GAAG,SAC9B,gBAAgB,kBAAkB,KAAK,KAAK,GAAG,KAAK,IACrD,QAAQ,EAAE,CACb;;CAGH,SAAS,QAAgB,aAA+B;AACtD,SAAO,uBAAuB,QAAQ,cAAc,QAAQ;GAC1D,MAAM,MAAM,KAAK,MAAM,IAAI;GAC3B,MAAM,OAAO,MAAM,OAAO;GAC1B,MAAM,MAAM,KAAK,MAAM,IAAI;AAG3B,UAAO,GAAG,IAAI,GAAG,IAAI,GAAG,qBAFZ,OAAO,aAAa,MAAM,OAAO,IAAI,QAAQ,GAAG,CAAC,CAEZ;IACjD;;CAEL"}

package/dist/coordinates/latlon/internal/coordinate-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/latlon/internal/coordinate-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

package/dist/coordinates/latlon/internal/create-cache.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/latlon/internal/create-cache.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/latlon/internal/exhaustive-errors.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/latlon/internal/format.d.ts

@@ -1,10 +1,53 @@
+/*
+ * 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 { Format } from "./index.js";
+
 //#region src/coordinates/latlon/internal/format.d.ts
-interface FormatOptions {
+/**
+ * Display options for the `format*` coordinate formatters: text wrapped around
+ * the whole string, the divider between axes, and whether each axis carries
+ * its `N`/`S`/`E`/`W` letter.
+ */
+type FormatOptions = {
   prefix: string;
   suffix: string;
   separator: string;
   withOrdinal?: boolean;
-}
+};
+/**
+ * Shared scaffold for a `CoordinateSystem`'s `toFormat` round-trip string.
+ *
+ * This is the loss-less internal representation `createCoordinate(...).dd()` /
+ * `.ddm()` / `.dms()` returns — deliberately distinct from the display
+ * formatters in each system's `formatter.ts`. The `to*Parts` / `format*`
+ * functions round and carry to a fixed precision for human display; this path
+ * keeps full precision and applies **no** carry so a value survives a
+ * format → parse → float round-trip unchanged. The two must not be merged.
+ *
+ * Owns the parts every system's `toFormat` shares — the `[lat, lon]` map, the
+ * ` / ` divider join, and the signed → `N`/`S`/`E`/`W` direction lookup — and
+ * defers only the per-axis magnitude rendering (which is all that differs
+ * between DD, DDM, and DMS) to `renderMagnitude`.
+ *
+ * @param format - Axis ordering (`'LATLON'` or `'LONLAT'`).
+ * @param coordinates - Signed `[left, right]` values in the given ordering.
+ * @param renderMagnitude - Renders the space-separated magnitude components of
+ *   one axis (e.g. `"37 46.494"` for DDM) from its absolute value.
+ * @returns The joined round-trip string, e.g. `"37 46.494 N / 122 25.164 W"`.
+ *
+ * @remarks pure function
+ */
+declare const formatCoordinateSystem: (format: Format, [left, right]: [number, number], renderMagnitude: (magnitude: number) => string) => string;
 /**
  * Creates a coordinate formatter function from a coordinate conversion function.
  *
@@ -13,8 +56,10 @@ interface FormatOptions {
  *
  * @example
  * ```typescript
- * const formatDD = createFormatter((num) => `${num.toFixed(6)}°`);
- * formatDD([37.7749, -122.4194]);
+ * const formatDD = createFormatter(
+ *   (value, withOrdinal) => `${(withOrdinal ? Math.abs(value) : value).toFixed(6)}°`,
+ * );
+ * formatDD([37.7749, -122.4194], { withOrdinal: true });
  * // '37.774900° N, 122.419400° W'
  * ```
  *
@@ -27,5 +72,5 @@ interface FormatOptions {
  */
 declare const createFormatter: (fn: (coord: number, withOrdinal?: boolean) => string) => (coordinates: [number, number], config?: FormatOptions) => string;
 //#endregion
-export { FormatOptions, createFormatter };
+export { FormatOptions, createFormatter, formatCoordinateSystem };
 //# sourceMappingURL=format.d.ts.map

package/dist/coordinates/latlon/internal/format.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
@@ -11,10 +11,38 @@
  */
 
 
-import { getOrdinal } from "./ordinal.js";
+import { BEARINGS, SYMBOLS } from "./index.js";
+import { getHemisphere } from "./ordinal.js";
 
 //#region src/coordinates/latlon/internal/format.ts
 /**
+* Shared scaffold for a `CoordinateSystem`'s `toFormat` round-trip string.
+*
+* This is the loss-less internal representation `createCoordinate(...).dd()` /
+* `.ddm()` / `.dms()` returns — deliberately distinct from the display
+* formatters in each system's `formatter.ts`. The `to*Parts` / `format*`
+* functions round and carry to a fixed precision for human display; this path
+* keeps full precision and applies **no** carry so a value survives a
+* format → parse → float round-trip unchanged. The two must not be merged.
+*
+* Owns the parts every system's `toFormat` shares — the `[lat, lon]` map, the
+* ` / ` divider join, and the signed → `N`/`S`/`E`/`W` direction lookup — and
+* defers only the per-axis magnitude rendering (which is all that differs
+* between DD, DDM, and DMS) to `renderMagnitude`.
+*
+* @param format - Axis ordering (`'LATLON'` or `'LONLAT'`).
+* @param coordinates - Signed `[left, right]` values in the given ordering.
+* @param renderMagnitude - Renders the space-separated magnitude components of
+*   one axis (e.g. `"37 46.494"` for DDM) from its absolute value.
+* @returns The joined round-trip string, e.g. `"37 46.494 N / 122 25.164 W"`.
+*
+* @remarks pure function
+*/
+const formatCoordinateSystem = (format, [left, right], renderMagnitude) => [left, right].map((value, index) => {
+	const direction = BEARINGS[format][index][+(value < 0)];
+	return `${renderMagnitude(Math.abs(value))} ${direction}`;
+}).join(` ${SYMBOLS.DIVIDER} `);
+/**
 * Creates a coordinate formatter function from a coordinate conversion function.
 *
 * @param fn - Function that converts a single coordinate value to a formatted string.
@@ -22,8 +50,10 @@ import { getOrdinal } from "./ordinal.js";
 *
 * @example
 * ```typescript
-* const formatDD = createFormatter((num) => `${num.toFixed(6)}°`);
-* formatDD([37.7749, -122.4194]);
+* const formatDD = createFormatter(
+*   (value, withOrdinal) => `${(withOrdinal ? Math.abs(value) : value).toFixed(6)}°`,
+* );
+* formatDD([37.7749, -122.4194], { withOrdinal: true });
 * // '37.774900° N, 122.419400° W'
 * ```
 *
@@ -36,15 +66,15 @@ import { getOrdinal } from "./ordinal.js";
 */
 const createFormatter = (fn) => (coordinates, config) => {
 	const [latitude, longitude] = coordinates;
-	const latOrdinal = `${config?.withOrdinal ? ` ${getOrdinal(latitude, true)}` : ""}`;
-	const lonOrdinal = `${config?.withOrdinal ? ` ${getOrdinal(longitude, false)}` : ""}`;
-	const lat = fn(latitude, config?.withOrdinal);
-	const lon = fn(longitude, config?.withOrdinal);
+	const latOrdinal = config?.withOrdinal ? ` ${getHemisphere(latitude, "lat")}` : "";
+	const lonOrdinal = config?.withOrdinal ? ` ${getHemisphere(longitude, "lon")}` : "";
+	const latValue = fn(latitude, config?.withOrdinal);
+	const lonValue = fn(longitude, config?.withOrdinal);
 	const prefix = config?.prefix ?? "";
 	const suffix = config?.suffix ?? "";
-	return `${prefix}${lat}${latOrdinal}${config?.separator ?? ", "}${lon}${lonOrdinal}${suffix}`;
+	return `${prefix}${latValue}${latOrdinal}${config?.separator ?? ", "}${lonValue}${lonOrdinal}${suffix}`;
 };
 
 //#endregion
-export { createFormatter };
+export { createFormatter, formatCoordinateSystem };
 //# sourceMappingURL=format.js.map

package/dist/coordinates/latlon/internal/format.js.map

@@ -1 +1 @@
-{"version":3,"file":"format.js","names":[],"sources":["../../../../src/coordinates/latlon/internal/format.ts"],"sourcesContent":["/*\n * Copyright 2025 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\n// __private-exports\n\nimport { getOrdinal } from './ordinal';\n\nexport interface FormatOptions {\n  prefix: string;\n  suffix: string;\n  separator: string;\n  withOrdinal?: boolean;\n}\n\n/**\n * Creates a coordinate formatter function from a coordinate conversion function.\n *\n * @param fn - Function that converts a single coordinate value to a formatted string.\n * @returns Formatter function that takes coordinate pair and optional config.\n *\n * @example\n * ```typescript\n * const formatDD = createFormatter((num) => `${num.toFixed(6)}°`);\n * formatDD([37.7749, -122.4194]);\n * // '37.774900° N, 122.419400° W'\n * ```\n *\n * @example\n * ```typescript\n * const formatDMS = createFormatter(toDegreesMinutesSeconds);\n * formatDMS([37.7749, -122.4194], { separator: ' / ', withOrdinal: true });\n * // '37° 46' 29.64″ N / 122° 25' 9.84″ W'\n * ```\n */\nexport const createFormatter =\n  (fn: (coord: number, withOrdinal?: boolean) => string) =>\n  (coordinates: [number, number], config?: FormatOptions): string => {\n    const [latitude, longitude] = coordinates;\n    const latOrdinal = `${config?.withOrdinal ? ` ${getOrdinal(latitude, true)}` : ''}`;\n    const lonOrdinal = `${config?.withOrdinal ? ` ${getOrdinal(longitude, false)}` : ''}`;\n    const lat = fn(latitude, config?.withOrdinal);\n    const lon = fn(longitude, config?.withOrdinal);\n    const prefix = config?.prefix ?? '';\n    const suffix = config?.suffix ?? '';\n    const separator = config?.separator ?? ', ';\n\n    return `${prefix}${lat}${latOrdinal}${separator}${lon}${lonOrdinal}${suffix}`;\n  };\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA2CA,MAAa,mBACV,QACA,aAA+B,WAAmC;CACjE,MAAM,CAAC,UAAU,aAAa;CAC9B,MAAM,aAAa,GAAG,QAAQ,cAAc,IAAI,WAAW,UAAU,KAAK,KAAK;CAC/E,MAAM,aAAa,GAAG,QAAQ,cAAc,IAAI,WAAW,WAAW,MAAM,KAAK;CACjF,MAAM,MAAM,GAAG,UAAU,QAAQ,YAAY;CAC7C,MAAM,MAAM,GAAG,WAAW,QAAQ,YAAY;CAC9C,MAAM,SAAS,QAAQ,UAAU;CACjC,MAAM,SAAS,QAAQ,UAAU;AAGjC,QAAO,GAAG,SAAS,MAAM,aAFP,QAAQ,aAAa,OAEW,MAAM,aAAa"}
+{"version":3,"file":"format.js","names":[],"sources":["../../../../src/coordinates/latlon/internal/format.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\n// __private-exports\n\nimport { BEARINGS, type Format, SYMBOLS } from '.';\nimport { getHemisphere } from './ordinal';\n\n/**\n * Display options for the `format*` coordinate formatters: text wrapped around\n * the whole string, the divider between axes, and whether each axis carries\n * its `N`/`S`/`E`/`W` letter.\n */\nexport type FormatOptions = {\n  prefix: string;\n  suffix: string;\n  separator: string;\n  withOrdinal?: boolean;\n};\n\n/**\n * Shared scaffold for a `CoordinateSystem`'s `toFormat` round-trip string.\n *\n * This is the loss-less internal representation `createCoordinate(...).dd()` /\n * `.ddm()` / `.dms()` returns — deliberately distinct from the display\n * formatters in each system's `formatter.ts`. The `to*Parts` / `format*`\n * functions round and carry to a fixed precision for human display; this path\n * keeps full precision and applies **no** carry so a value survives a\n * format → parse → float round-trip unchanged. The two must not be merged.\n *\n * Owns the parts every system's `toFormat` shares — the `[lat, lon]` map, the\n * ` / ` divider join, and the signed → `N`/`S`/`E`/`W` direction lookup — and\n * defers only the per-axis magnitude rendering (which is all that differs\n * between DD, DDM, and DMS) to `renderMagnitude`.\n *\n * @param format - Axis ordering (`'LATLON'` or `'LONLAT'`).\n * @param coordinates - Signed `[left, right]` values in the given ordering.\n * @param renderMagnitude - Renders the space-separated magnitude components of\n *   one axis (e.g. `\"37 46.494\"` for DDM) from its absolute value.\n * @returns The joined round-trip string, e.g. `\"37 46.494 N / 122 25.164 W\"`.\n *\n * @remarks pure function\n */\nexport const formatCoordinateSystem = (\n  format: Format,\n  [left, right]: [number, number],\n  renderMagnitude: (magnitude: number) => string,\n): string =>\n  [left, right]\n    .map((value, index) => {\n      const direction = BEARINGS[format][index as 0 | 1][+(value < 0)];\n\n      return `${renderMagnitude(Math.abs(value))} ${direction}`;\n    })\n    .join(` ${SYMBOLS.DIVIDER} `);\n\n/**\n * Creates a coordinate formatter function from a coordinate conversion function.\n *\n * @param fn - Function that converts a single coordinate value to a formatted string.\n * @returns Formatter function that takes coordinate pair and optional config.\n *\n * @example\n * ```typescript\n * const formatDD = createFormatter(\n *   (value, withOrdinal) => `${(withOrdinal ? Math.abs(value) : value).toFixed(6)}°`,\n * );\n * formatDD([37.7749, -122.4194], { withOrdinal: true });\n * // '37.774900° N, 122.419400° W'\n * ```\n *\n * @example\n * ```typescript\n * const formatDMS = createFormatter(toDegreesMinutesSeconds);\n * formatDMS([37.7749, -122.4194], { separator: ' / ', withOrdinal: true });\n * // '37° 46' 29.64″ N / 122° 25' 9.84″ W'\n * ```\n */\nexport const createFormatter =\n  (fn: (coord: number, withOrdinal?: boolean) => string) =>\n  (coordinates: [number, number], config?: FormatOptions): string => {\n    const [latitude, longitude] = coordinates;\n    const latOrdinal = config?.withOrdinal\n      ? ` ${getHemisphere(latitude, 'lat')}`\n      : '';\n    const lonOrdinal = config?.withOrdinal\n      ? ` ${getHemisphere(longitude, 'lon')}`\n      : '';\n    const latValue = fn(latitude, config?.withOrdinal);\n    const lonValue = fn(longitude, config?.withOrdinal);\n    const prefix = config?.prefix ?? '';\n    const suffix = config?.suffix ?? '';\n    const separator = config?.separator ?? ', ';\n\n    return `${prefix}${latValue}${latOrdinal}${separator}${lonValue}${lonOrdinal}${suffix}`;\n  };\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAoDA,MAAa,0BACX,QACA,CAAC,MAAM,QACP,oBAEA,CAAC,MAAM,MAAM,CACV,KAAK,OAAO,UAAU;CACrB,MAAM,YAAY,SAAS,QAAQ,OAAgB,EAAE,QAAQ;AAE7D,QAAO,GAAG,gBAAgB,KAAK,IAAI,MAAM,CAAC,CAAC,GAAG;EAC9C,CACD,KAAK,IAAI,QAAQ,QAAQ,GAAG;;;;;;;;;;;;;;;;;;;;;;;AAwBjC,MAAa,mBACV,QACA,aAA+B,WAAmC;CACjE,MAAM,CAAC,UAAU,aAAa;CAC9B,MAAM,aAAa,QAAQ,cACvB,IAAI,cAAc,UAAU,MAAM,KAClC;CACJ,MAAM,aAAa,QAAQ,cACvB,IAAI,cAAc,WAAW,MAAM,KACnC;CACJ,MAAM,WAAW,GAAG,UAAU,QAAQ,YAAY;CAClD,MAAM,WAAW,GAAG,WAAW,QAAQ,YAAY;CACnD,MAAM,SAAS,QAAQ,UAAU;CACjC,MAAM,SAAS,QAAQ,UAAU;AAGjC,QAAO,GAAG,SAAS,WAAW,aAFZ,QAAQ,aAAa,OAEgB,WAAW,aAAa"}

package/dist/coordinates/latlon/internal/in-range.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/latlon/internal/index.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
@@ -11,7 +11,8 @@
  */
 
 import { CoordinateInput, CoordinateInternalValue, CoordinateObject, CoordinateTuple, LatLonTuple, LonLatTuple, isCoordinateObject, isCoordinateTuple, normalizeObjectToLatLon, tupleToLatLon } from "./normalize.js";
-import { isFiniteNumber, validateNumericCoordinate, validateSignedRange } from "./validate.js";
+import { toPlainDecimalString } from "./plain-decimal.js";
+import { isFiniteNumber, isValidNumericCoordinate, validateNumericCoordinate, validateSignedRange } from "./validate.js";
 
 //#region src/coordinates/latlon/internal/index.d.ts
 type Axes = 'LAT' | 'LON';
@@ -72,5 +73,5 @@ declare const PARTIAL_PATTERNS: {
   readonly secDec: RegExp;
 };
 //#endregion
-export { Axes, BEARINGS, Compass, type CoordinateInput, type CoordinateInternalValue, type CoordinateObject, type CoordinateTuple, Errors, FORMATS, FORMATS_DEFAULT, Format, LIMITS, type LatLonTuple, type LonLatTuple, PARTIAL_PATTERNS, SYMBOLS, SYMBOL_PATTERNS, isCoordinateObject, isCoordinateTuple, isFiniteNumber, normalizeObjectToLatLon, tupleToLatLon, validateNumericCoordinate, validateSignedRange };
+export { Axes, BEARINGS, Compass, type CoordinateInput, type CoordinateInternalValue, type CoordinateObject, type CoordinateTuple, Errors, FORMATS, FORMATS_DEFAULT, Format, LIMITS, type LatLonTuple, type LonLatTuple, PARTIAL_PATTERNS, SYMBOLS, SYMBOL_PATTERNS, isCoordinateObject, isCoordinateTuple, isFiniteNumber, isValidNumericCoordinate, normalizeObjectToLatLon, toPlainDecimalString, tupleToLatLon, validateNumericCoordinate, validateSignedRange };
 //# sourceMappingURL=index.d.ts.map

package/dist/coordinates/latlon/internal/index.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,8 @@
 
 import { capture, merge, optional } from "../../../patterning.js";
 import { isCoordinateObject, isCoordinateTuple, normalizeObjectToLatLon, tupleToLatLon } from "./normalize.js";
-import { isFiniteNumber, validateNumericCoordinate, validateSignedRange } from "./validate.js";
+import { toPlainDecimalString } from "./plain-decimal.js";
+import { isFiniteNumber, isValidNumericCoordinate, validateNumericCoordinate, validateSignedRange } from "./validate.js";
 
 //#region src/coordinates/latlon/internal/index.ts
 /**
@@ -98,5 +99,5 @@ const PARTIAL_PATTERNS = {
 };
 
 //#endregion
-export { BEARINGS, FORMATS, FORMATS_DEFAULT, LIMITS, PARTIAL_PATTERNS, SYMBOLS, SYMBOL_PATTERNS, isCoordinateObject, isCoordinateTuple, isFiniteNumber, normalizeObjectToLatLon, tupleToLatLon, validateNumericCoordinate, validateSignedRange };
+export { BEARINGS, FORMATS, FORMATS_DEFAULT, LIMITS, PARTIAL_PATTERNS, SYMBOLS, SYMBOL_PATTERNS, isCoordinateObject, isCoordinateTuple, isFiniteNumber, isValidNumericCoordinate, normalizeObjectToLatLon, toPlainDecimalString, tupleToLatLon, validateNumericCoordinate, validateSignedRange };
 //# sourceMappingURL=index.js.map