@accelint/geo 0.5.1 → 0.6.0

package/dist/coordinates/latlon/decimal-degrees/formatter.js.map

@@ -1 +1 @@
-{"version":3,"file":"formatter.js","names":[],"sources":["../../../../src/coordinates/latlon/decimal-degrees/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\nconst toDecimalDegrees = (num: number, withOrdinal?: boolean): string => {\n  const value = withOrdinal ? Math.abs(num) : num;\n  return `${value.toFixed(6)}°`;\n};\n\nexport const formatDecimalDegrees = createFormatter(toDecimalDegrees);\n"],"mappings":";;;;;;;;;;;;;;;;AAcA,MAAM,oBAAoB,KAAa,gBAAkC;AAEvE,QAAO,IADO,cAAc,KAAK,IAAI,IAAI,GAAG,KAC5B,QAAQ,EAAE,CAAC;;AAG7B,MAAa,uBAAuB,gBAAgB,iBAAiB"}
+{"version":3,"file":"formatter.js","names":[],"sources":["../../../../src/coordinates/latlon/decimal-degrees/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 decimal degrees format.\n *\n * @param num - The coordinate value to format.\n * @param withOrdinal - Whether to use absolute value (when ordinal directions are shown separately).\n * @returns Formatted coordinate string with degree symbol and 6 decimal places.\n *\n * @example\n * ```typescript\n * toDecimalDegrees(45.123456);\n * // '45.123456°'\n * ```\n *\n * @example\n * ```typescript\n * toDecimalDegrees(-122.4194, true);\n * // '122.419400°'\n * ```\n */\nconst toDecimalDegrees = (num: number, withOrdinal?: boolean): string => {\n  const value = withOrdinal ? Math.abs(num) : num;\n  return `${value.toFixed(6)}°`;\n};\n\n/**\n * Formats latitude/longitude coordinates in decimal degrees notation.\n *\n * @param coordinates - Tuple of [latitude, longitude] values.\n * @param config - Optional formatting configuration.\n * @returns Formatted coordinate string in decimal degrees format.\n *\n * @example\n * ```typescript\n * formatDecimalDegrees([37.7749, -122.4194]);\n * // '37.774900° N, 122.419400° W'\n * ```\n *\n * @example\n * ```typescript\n * formatDecimalDegrees([37.7749, -122.4194], { separator: ' / ' });\n * // '37.774900° N / 122.419400° W'\n * ```\n */\nexport const formatDecimalDegrees = createFormatter(toDecimalDegrees);\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAiCA,MAAM,oBAAoB,KAAa,gBAAkC;AAEvE,QAAO,IADO,cAAc,KAAK,IAAI,IAAI,GAAG,KAC5B,QAAQ,EAAE,CAAC;;;;;;;;;;;;;;;;;;;;;AAsB7B,MAAa,uBAAuB,gBAAgB,iBAAiB"}

package/dist/coordinates/latlon/decimal-degrees/parser.d.ts

@@ -14,8 +14,74 @@ import { Format } from "../internal/index.js";
 import { ParseResults } from "../internal/parse.js";
 
 //#region src/coordinates/latlon/decimal-degrees/parser.d.ts
-/** Parse a Decimal Degrees coordinate. */
+type DecimalDegrees = {
+  bear: string;
+  deg: string;
+};
+/**
+ * Creates an error identification function for decimal degrees coordinates.
+ *
+ * Validates that degree values are within acceptable ranges and that
+ * minutes/seconds indicators are not present in decimal degrees notation.
+ *
+ * @param format - The coordinate format (LATLON or LONLAT).
+ * @returns Function that validates coordinate components and returns parse results.
+ *
+ * @example
+ * ```typescript
+ * const validator = identifyErrors('LATLON');
+ * const result = validator({ deg: '91', bear: 'N' }, 0);
+ * // [[], ['Degrees value (91) exceeds max value (90).']]
+ * ```
+ */
+declare function identifyErrors(format: Format): (arg: DecimalDegrees | undefined, i: number) => ParseResults;
+/**
+ * Identifies and organizes coordinate components from parsed tokens.
+ *
+ * Separates bearing indicators (N/S/E/W) from degree values in a coordinate half.
+ *
+ * @param half - Array of tokens representing one coordinate component.
+ * @returns Object with `bear` and `deg` properties, or undefined if invalid.
+ *
+ * @example
+ * ```typescript
+ * identifyPieces(['45.5', 'N']);
+ * // { bear: 'N', deg: '45.5' }
+ * ```
+ *
+ * @example
+ * ```typescript
+ * identifyPieces(['122.4', 'W']);
+ * // { bear: 'W', deg: '122.4' }
+ * ```
+ */
+declare function identifyPieces(half: string[]): {
+  bear: string;
+  deg: string;
+} | undefined;
+/**
+ * Parses a Decimal Degrees coordinate string.
+ *
+ * Accepts coordinates in decimal degrees format with optional bearing indicators.
+ * Validates ranges and ensures no minutes/seconds indicators are present.
+ *
+ * @param input - Raw coordinate string to parse.
+ * @param format - Expected format (LATLON or LONLAT).
+ * @returns Parsed coordinate values or errors.
+ *
+ * @example
+ * ```typescript
+ * parseDecimalDegrees('37.7749° N / 122.4194° W', 'LATLON');
+ * // [[37.7749, -122.4194], []]
+ * ```
+ *
+ * @example
+ * ```typescript
+ * parseDecimalDegrees('45.5 N, 122.6 W');
+ * // [[45.5, -122.6], []]
+ * ```
+ */
 declare const parseDecimalDegrees: (format: Format, input: string) => ParseResults;
 //#endregion
-export { parseDecimalDegrees };
+export { identifyErrors as _identifyErrors, identifyPieces as _identifyPieces, parseDecimalDegrees };
 //# sourceMappingURL=parser.d.ts.map

package/dist/coordinates/latlon/decimal-degrees/parser.js

@@ -18,7 +18,9 @@ import { createParser } from "../internal/parse-format.js";
 //#region src/coordinates/latlon/decimal-degrees/parser.ts
 const checks = {
 	deg: (deg, limit) => {
-		if (Number.parseFloat(deg) > limit) return `Degrees value (${deg}) exceeds max value (${limit}).`;
+		const num = Number.parseFloat(deg);
+		if (Number.isNaN(num)) return `Degrees value (${deg}) is not a valid number.`;
+		if (num > limit) return `Degrees value (${deg}) exceeds max value (${limit}).`;
 	},
 	min: (val) => {
 		if (val.includes(SYMBOLS.MINUTES)) return `Seconds indicator (${SYMBOLS.MINUTES}) not valid in Decimal Degrees.`;
@@ -31,6 +33,22 @@ const formats = {
 	LATLON: fromTemplate(PARTIAL_PATTERNS, `degLatDec NS ${SYMBOLS.DIVIDER} degLonDec EW`),
 	LONLAT: fromTemplate(PARTIAL_PATTERNS, `degLonDec EW ${SYMBOLS.DIVIDER} degLatDec NS`)
 };
+/**
+* Creates an error identification function for decimal degrees coordinates.
+*
+* Validates that degree values are within acceptable ranges and that
+* minutes/seconds indicators are not present in decimal degrees notation.
+*
+* @param format - The coordinate format (LATLON or LONLAT).
+* @returns Function that validates coordinate components and returns parse results.
+*
+* @example
+* ```typescript
+* const validator = identifyErrors('LATLON');
+* const result = validator({ deg: '91', bear: 'N' }, 0);
+* // [[], ['Degrees value (91) exceeds max value (90).']]
+* ```
+*/
 function identifyErrors(format) {
 	return (arg, i) => {
 		if (!arg) return [[], ["Invalid coordinate value."]];
@@ -51,18 +69,61 @@ function identifyErrors(format) {
 		return errors.length ? [[], errors] : [[deg, bear], []];
 	};
 }
+/**
+* Identifies and organizes coordinate components from parsed tokens.
+*
+* Separates bearing indicators (N/S/E/W) from degree values in a coordinate half.
+*
+* @param half - Array of tokens representing one coordinate component.
+* @returns Object with `bear` and `deg` properties, or undefined if invalid.
+*
+* @example
+* ```typescript
+* identifyPieces(['45.5', 'N']);
+* // { bear: 'N', deg: '45.5' }
+* ```
+*
+* @example
+* ```typescript
+* identifyPieces(['122.4', 'W']);
+* // { bear: 'W', deg: '122.4' }
+* ```
+*/
 function identifyPieces(half) {
 	if (half.length > 2 || half.length < 1) return;
 	return half.reduce((acc, token) => {
-		if (SYMBOL_PATTERNS.NSEW.test(token) && !acc.bear) acc.bear ||= token;
-		else acc.deg ||= token;
+		const isBearing = SYMBOL_PATTERNS.NSEW.test(token) && !acc?.bear;
+		if (!acc || !isBearing && acc.deg) return;
+		if (isBearing) acc.bear = token;
+		else acc.deg = token;
 		return acc;
 	}, {
 		bear: "",
 		deg: ""
 	});
 }
-/** Parse a Decimal Degrees coordinate. */
+/**
+* Parses a Decimal Degrees coordinate string.
+*
+* Accepts coordinates in decimal degrees format with optional bearing indicators.
+* Validates ranges and ensures no minutes/seconds indicators are present.
+*
+* @param input - Raw coordinate string to parse.
+* @param format - Expected format (LATLON or LONLAT).
+* @returns Parsed coordinate values or errors.
+*
+* @example
+* ```typescript
+* parseDecimalDegrees('37.7749° N / 122.4194° W', 'LATLON');
+* // [[37.7749, -122.4194], []]
+* ```
+*
+* @example
+* ```typescript
+* parseDecimalDegrees('45.5 N, 122.6 W');
+* // [[45.5, -122.6], []]
+* ```
+*/
 const parseDecimalDegrees = createParser({
 	formats,
 	identifyErrors,
@@ -70,5 +131,5 @@ const parseDecimalDegrees = createParser({
 });
 
 //#endregion
-export { parseDecimalDegrees };
+export { identifyErrors as _identifyErrors, identifyPieces as _identifyPieces, parseDecimalDegrees };
 //# sourceMappingURL=parser.js.map

package/dist/coordinates/latlon/decimal-degrees/parser.js.map

@@ -1 +1 @@
-{"version":3,"file":"parser.js","names":["Patterning.fromTemplate","isNegative: 0 | 1"],"sources":["../../../../src/coordinates/latlon/decimal-degrees/parser.ts"],"sourcesContent":["/*\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 * as Patterning from '@/patterning';\nimport {\n  BEARINGS,\n  type Format,\n  LIMITS,\n  PARTIAL_PATTERNS,\n  SYMBOL_PATTERNS,\n  SYMBOLS,\n} from '../internal';\nimport { createParser } from '../internal/parse-format';\nimport type { ParseResults } from '../internal/parse';\n\ntype DecimalDegrees = {\n  bear: string;\n  deg: string;\n};\n\nconst checks = {\n  deg: (deg: string, limit: number) => {\n    if (Number.parseFloat(deg) > limit) {\n      return `Degrees value (${deg}) exceeds max value (${limit}).`;\n    }\n  },\n  min: (val: string) => {\n    if (val.includes(SYMBOLS.MINUTES)) {\n      return `Seconds indicator (${SYMBOLS.MINUTES}) not valid in Decimal Degrees.`;\n    }\n  },\n  sec: (val: string) => {\n    if (val.includes(SYMBOLS.SECONDS)) {\n      return `Seconds indicator (${SYMBOLS.SECONDS}) not valid in Decimal Degrees.`;\n    }\n  },\n};\n\nconst formats = {\n  LATLON: Patterning.fromTemplate(\n    PARTIAL_PATTERNS,\n    `degLatDec NS ${SYMBOLS.DIVIDER} degLonDec EW`,\n  ),\n  LONLAT: Patterning.fromTemplate(\n    PARTIAL_PATTERNS,\n    `degLonDec EW ${SYMBOLS.DIVIDER} degLatDec NS`,\n  ),\n};\n\nfunction identifyErrors(format: Format) {\n  return (arg: DecimalDegrees | undefined, i: number) => {\n    if (!arg) {\n      return [[], ['Invalid coordinate value.']] as ParseResults;\n    }\n\n    let { bear, deg } = arg;\n\n    deg ??= '0';\n\n    let isNegative: 0 | 1 = SYMBOL_PATTERNS.NEGATIVE_SIGN.test(deg) ? 1 : 0;\n    const bearingOptions = BEARINGS[format][i] as [string, string];\n\n    if (!bear || isNegative) {\n      bear = bearingOptions[isNegative];\n      deg = Math.abs(Number.parseFloat(deg)).toString();\n      isNegative = 0;\n    }\n\n    const errors = [\n      ...[checks.deg(deg, LIMITS[format][i] ?? 0)],\n      ...[checks.min([bear, deg].join(''))],\n      ...[checks.sec([bear, deg].join(''))],\n    ].filter(Boolean);\n\n    return (errors.length ? [[], errors] : [[deg, bear], []]) as ParseResults;\n  };\n}\n\nfunction identifyPieces(half: string[]) {\n  if (half.length > 2 || half.length < 1) {\n    return;\n  }\n\n  const places = { bear: '', deg: '' };\n\n  return half.reduce((acc, token) => {\n    if (SYMBOL_PATTERNS.NSEW.test(token) && !acc.bear) {\n      acc.bear ||= token;\n    } else {\n      acc.deg ||= token;\n    }\n\n    return acc;\n  }, places);\n}\n\n/** Parse a Decimal Degrees coordinate. */\nexport const parseDecimalDegrees = createParser<DecimalDegrees>({\n  formats,\n  identifyErrors,\n  identifyPieces,\n});\n"],"mappings":";;;;;;;;;;;;;;;;;;AA6BA,MAAM,SAAS;CACb,MAAM,KAAa,UAAkB;AACnC,MAAI,OAAO,WAAW,IAAI,GAAG,MAC3B,QAAO,kBAAkB,IAAI,uBAAuB,MAAM;;CAG9D,MAAM,QAAgB;AACpB,MAAI,IAAI,SAAS,QAAQ,QAAQ,CAC/B,QAAO,sBAAsB,QAAQ,QAAQ;;CAGjD,MAAM,QAAgB;AACpB,MAAI,IAAI,SAAS,QAAQ,QAAQ,CAC/B,QAAO,sBAAsB,QAAQ,QAAQ;;CAGlD;AAED,MAAM,UAAU;CACd,QAAQA,aACN,kBACA,gBAAgB,QAAQ,QAAQ,eACjC;CACD,QAAQA,aACN,kBACA,gBAAgB,QAAQ,QAAQ,eACjC;CACF;AAED,SAAS,eAAe,QAAgB;AACtC,SAAQ,KAAiC,MAAc;AACrD,MAAI,CAAC,IACH,QAAO,CAAC,EAAE,EAAE,CAAC,4BAA4B,CAAC;EAG5C,IAAI,EAAE,MAAM,QAAQ;AAEpB,UAAQ;EAER,IAAIC,aAAoB,gBAAgB,cAAc,KAAK,IAAI,GAAG,IAAI;EACtE,MAAM,iBAAiB,SAAS,QAAQ;AAExC,MAAI,CAAC,QAAQ,YAAY;AACvB,UAAO,eAAe;AACtB,SAAM,KAAK,IAAI,OAAO,WAAW,IAAI,CAAC,CAAC,UAAU;AACjD,gBAAa;;EAGf,MAAM,SAAS;GACb,GAAG,CAAC,OAAO,IAAI,KAAK,OAAO,QAAQ,MAAM,EAAE,CAAC;GAC5C,GAAG,CAAC,OAAO,IAAI,CAAC,MAAM,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC;GACrC,GAAG,CAAC,OAAO,IAAI,CAAC,MAAM,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC;GACtC,CAAC,OAAO,QAAQ;AAEjB,SAAQ,OAAO,SAAS,CAAC,EAAE,EAAE,OAAO,GAAG,CAAC,CAAC,KAAK,KAAK,EAAE,EAAE,CAAC;;;AAI5D,SAAS,eAAe,MAAgB;AACtC,KAAI,KAAK,SAAS,KAAK,KAAK,SAAS,EACnC;AAKF,QAAO,KAAK,QAAQ,KAAK,UAAU;AACjC,MAAI,gBAAgB,KAAK,KAAK,MAAM,IAAI,CAAC,IAAI,KAC3C,KAAI,SAAS;MAEb,KAAI,QAAQ;AAGd,SAAO;IATM;EAAE,MAAM;EAAI,KAAK;EAAI,CAU1B;;;AAIZ,MAAa,sBAAsB,aAA6B;CAC9D;CACA;CACA;CACD,CAAC"}
+{"version":3,"file":"parser.js","names":["Patterning.fromTemplate","isNegative: 0 | 1"],"sources":["../../../../src/coordinates/latlon/decimal-degrees/parser.ts"],"sourcesContent":["/*\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 * as Patterning from '@/patterning';\nimport {\n  BEARINGS,\n  type Format,\n  LIMITS,\n  PARTIAL_PATTERNS,\n  SYMBOL_PATTERNS,\n  SYMBOLS,\n} from '../internal';\nimport { createParser } from '../internal/parse-format';\nimport type { ParseResults } from '../internal/parse';\n\ntype DecimalDegrees = {\n  bear: string;\n  deg: string;\n};\n\nconst checks = {\n  deg: (deg: string, limit: number) => {\n    const num = Number.parseFloat(deg);\n    if (Number.isNaN(num)) {\n      return `Degrees value (${deg}) is not a valid number.`;\n    }\n    if (num > limit) {\n      return `Degrees value (${deg}) exceeds max value (${limit}).`;\n    }\n  },\n  min: (val: string) => {\n    if (val.includes(SYMBOLS.MINUTES)) {\n      return `Seconds indicator (${SYMBOLS.MINUTES}) not valid in Decimal Degrees.`;\n    }\n  },\n  sec: (val: string) => {\n    if (val.includes(SYMBOLS.SECONDS)) {\n      return `Seconds indicator (${SYMBOLS.SECONDS}) not valid in Decimal Degrees.`;\n    }\n  },\n};\n\nconst formats = {\n  LATLON: Patterning.fromTemplate(\n    PARTIAL_PATTERNS,\n    `degLatDec NS ${SYMBOLS.DIVIDER} degLonDec EW`,\n  ),\n  LONLAT: Patterning.fromTemplate(\n    PARTIAL_PATTERNS,\n    `degLonDec EW ${SYMBOLS.DIVIDER} degLatDec NS`,\n  ),\n};\n\n/**\n * Creates an error identification function for decimal degrees coordinates.\n *\n * Validates that degree values are within acceptable ranges and that\n * minutes/seconds indicators are not present in decimal degrees notation.\n *\n * @param format - The coordinate format (LATLON or LONLAT).\n * @returns Function that validates coordinate components and returns parse results.\n *\n * @example\n * ```typescript\n * const validator = identifyErrors('LATLON');\n * const result = validator({ deg: '91', bear: 'N' }, 0);\n * // [[], ['Degrees value (91) exceeds max value (90).']]\n * ```\n */\nfunction identifyErrors(format: Format) {\n  return (arg: DecimalDegrees | undefined, i: number) => {\n    if (!arg) {\n      return [[], ['Invalid coordinate value.']] as ParseResults;\n    }\n\n    let { bear, deg } = arg;\n\n    deg ??= '0';\n\n    let isNegative: 0 | 1 = SYMBOL_PATTERNS.NEGATIVE_SIGN.test(deg) ? 1 : 0;\n    const bearingOptions = BEARINGS[format][i] as [string, string];\n\n    if (!bear || isNegative) {\n      bear = bearingOptions[isNegative];\n      deg = Math.abs(Number.parseFloat(deg)).toString();\n      isNegative = 0;\n    }\n\n    const errors = [\n      ...[checks.deg(deg, LIMITS[format][i] ?? 0)],\n      ...[checks.min([bear, deg].join(''))],\n      ...[checks.sec([bear, deg].join(''))],\n    ].filter(Boolean);\n\n    return (errors.length ? [[], errors] : [[deg, bear], []]) as ParseResults;\n  };\n}\n\n/**\n * Identifies and organizes coordinate components from parsed tokens.\n *\n * Separates bearing indicators (N/S/E/W) from degree values in a coordinate half.\n *\n * @param half - Array of tokens representing one coordinate component.\n * @returns Object with `bear` and `deg` properties, or undefined if invalid.\n *\n * @example\n * ```typescript\n * identifyPieces(['45.5', 'N']);\n * // { bear: 'N', deg: '45.5' }\n * ```\n *\n * @example\n * ```typescript\n * identifyPieces(['122.4', 'W']);\n * // { bear: 'W', deg: '122.4' }\n * ```\n */\nfunction identifyPieces(half: string[]) {\n  if (half.length > 2 || half.length < 1) {\n    return;\n  }\n\n  const places = { bear: '', deg: '' };\n\n  return half.reduce<typeof places | undefined>((acc, token) => {\n    const isBearing = SYMBOL_PATTERNS.NSEW.test(token) && !acc?.bear;\n\n    if (!acc || (!isBearing && acc.deg)) {\n      return undefined;\n    }\n\n    if (isBearing) {\n      acc.bear = token;\n    } else {\n      acc.deg = token;\n    }\n\n    return acc;\n  }, places);\n}\n\n/**\n * Parses a Decimal Degrees coordinate string.\n *\n * Accepts coordinates in decimal degrees format with optional bearing indicators.\n * Validates ranges and ensures no minutes/seconds indicators are present.\n *\n * @param input - Raw coordinate string to parse.\n * @param format - Expected format (LATLON or LONLAT).\n * @returns Parsed coordinate values or errors.\n *\n * @example\n * ```typescript\n * parseDecimalDegrees('37.7749° N / 122.4194° W', 'LATLON');\n * // [[37.7749, -122.4194], []]\n * ```\n *\n * @example\n * ```typescript\n * parseDecimalDegrees('45.5 N, 122.6 W');\n * // [[45.5, -122.6], []]\n * ```\n */\nexport const parseDecimalDegrees = createParser<DecimalDegrees>({\n  formats,\n  identifyErrors,\n  identifyPieces,\n});\n\nexport { identifyErrors as _identifyErrors, identifyPieces as _identifyPieces };\n"],"mappings":";;;;;;;;;;;;;;;;;;AA6BA,MAAM,SAAS;CACb,MAAM,KAAa,UAAkB;EACnC,MAAM,MAAM,OAAO,WAAW,IAAI;AAClC,MAAI,OAAO,MAAM,IAAI,CACnB,QAAO,kBAAkB,IAAI;AAE/B,MAAI,MAAM,MACR,QAAO,kBAAkB,IAAI,uBAAuB,MAAM;;CAG9D,MAAM,QAAgB;AACpB,MAAI,IAAI,SAAS,QAAQ,QAAQ,CAC/B,QAAO,sBAAsB,QAAQ,QAAQ;;CAGjD,MAAM,QAAgB;AACpB,MAAI,IAAI,SAAS,QAAQ,QAAQ,CAC/B,QAAO,sBAAsB,QAAQ,QAAQ;;CAGlD;AAED,MAAM,UAAU;CACd,QAAQA,aACN,kBACA,gBAAgB,QAAQ,QAAQ,eACjC;CACD,QAAQA,aACN,kBACA,gBAAgB,QAAQ,QAAQ,eACjC;CACF;;;;;;;;;;;;;;;;;AAkBD,SAAS,eAAe,QAAgB;AACtC,SAAQ,KAAiC,MAAc;AACrD,MAAI,CAAC,IACH,QAAO,CAAC,EAAE,EAAE,CAAC,4BAA4B,CAAC;EAG5C,IAAI,EAAE,MAAM,QAAQ;AAEpB,UAAQ;EAER,IAAIC,aAAoB,gBAAgB,cAAc,KAAK,IAAI,GAAG,IAAI;EACtE,MAAM,iBAAiB,SAAS,QAAQ;AAExC,MAAI,CAAC,QAAQ,YAAY;AACvB,UAAO,eAAe;AACtB,SAAM,KAAK,IAAI,OAAO,WAAW,IAAI,CAAC,CAAC,UAAU;AACjD,gBAAa;;EAGf,MAAM,SAAS;GACb,GAAG,CAAC,OAAO,IAAI,KAAK,OAAO,QAAQ,MAAM,EAAE,CAAC;GAC5C,GAAG,CAAC,OAAO,IAAI,CAAC,MAAM,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC;GACrC,GAAG,CAAC,OAAO,IAAI,CAAC,MAAM,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC;GACtC,CAAC,OAAO,QAAQ;AAEjB,SAAQ,OAAO,SAAS,CAAC,EAAE,EAAE,OAAO,GAAG,CAAC,CAAC,KAAK,KAAK,EAAE,EAAE,CAAC;;;;;;;;;;;;;;;;;;;;;;;AAwB5D,SAAS,eAAe,MAAgB;AACtC,KAAI,KAAK,SAAS,KAAK,KAAK,SAAS,EACnC;AAKF,QAAO,KAAK,QAAmC,KAAK,UAAU;EAC5D,MAAM,YAAY,gBAAgB,KAAK,KAAK,MAAM,IAAI,CAAC,KAAK;AAE5D,MAAI,CAAC,OAAQ,CAAC,aAAa,IAAI,IAC7B;AAGF,MAAI,UACF,KAAI,OAAO;MAEX,KAAI,MAAM;AAGZ,SAAO;IAfM;EAAE,MAAM;EAAI,KAAK;EAAI,CAgB1B;;;;;;;;;;;;;;;;;;;;;;;;AAyBZ,MAAa,sBAAsB,aAA6B;CAC9D;CACA;CACA;CACD,CAAC"}

package/dist/coordinates/latlon/decimal-degrees/system.d.ts

@@ -13,6 +13,38 @@
 import { CoordinateSystem } from "../internal/coordinate-system.js";
 
 //#region src/coordinates/latlon/decimal-degrees/system.d.ts
+
+/**
+ * Decimal Degrees coordinate system implementation.
+ *
+ * Provides parsing, conversion, and formatting for coordinates in decimal degrees notation.
+ * Coordinates are expressed as decimal numbers with degree symbols (e.g., 37.7749° N).
+ *
+ * @property name - Human-readable name of the coordinate system.
+ * @property parse - Parses decimal degrees coordinate strings.
+ * @property toFloat - Converts parsed coordinate components to floating point numbers.
+ * @property toFormat - Formats numeric coordinates back to decimal degrees string.
+ *
+ * @example
+ * ```ts
+ * // Parse a coordinate string
+ * const [coords, errors] = systemDecimalDegrees.parse('37.7749° N / 122.4194° W', 'LATLON');
+ * ```
+ *
+ * @example
+ * ```ts
+ * // Convert to float
+ * const lat = systemDecimalDegrees.toFloat(['37.7749', 'N']);
+ * // 37.7749
+ * ```
+ *
+ * @example
+ * ```ts
+ * // Format to string
+ * const formatted = systemDecimalDegrees.toFormat('LATLON', [37.7749, -122.4194]);
+ * // '37.7749 N / 122.4194 W'
+ * ```
+ */
 declare const systemDecimalDegrees: CoordinateSystem;
 //#endregion
 export { systemDecimalDegrees };

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

@@ -15,6 +15,37 @@ import { BEARINGS, SYMBOLS, SYMBOL_PATTERNS } from "../internal/index.js";
 import { parseDecimalDegrees } from "./parser.js";
 
 //#region src/coordinates/latlon/decimal-degrees/system.ts
+/**
+* Decimal Degrees coordinate system implementation.
+*
+* Provides parsing, conversion, and formatting for coordinates in decimal degrees notation.
+* Coordinates are expressed as decimal numbers with degree symbols (e.g., 37.7749° N).
+*
+* @property name - Human-readable name of the coordinate system.
+* @property parse - Parses decimal degrees coordinate strings.
+* @property toFloat - Converts parsed coordinate components to floating point numbers.
+* @property toFormat - Formats numeric coordinates back to decimal degrees string.
+*
+* @example
+* ```ts
+* // Parse a coordinate string
+* const [coords, errors] = systemDecimalDegrees.parse('37.7749° N / 122.4194° W', 'LATLON');
+* ```
+*
+* @example
+* ```ts
+* // Convert to float
+* const lat = systemDecimalDegrees.toFloat(['37.7749', 'N']);
+* // 37.7749
+* ```
+*
+* @example
+* ```ts
+* // Format to string
+* const formatted = systemDecimalDegrees.toFormat('LATLON', [37.7749, -122.4194]);
+* // '37.7749 N / 122.4194 W'
+* ```
+*/
 const systemDecimalDegrees = {
 	name: "Decimal Degrees",
 	parse: parseDecimalDegrees,

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

@@ -1 +1 @@
-{"version":3,"file":"system.js","names":["systemDecimalDegrees: CoordinateSystem"],"sources":["../../../../src/coordinates/latlon/decimal-degrees/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 { parseDecimalDegrees } from './parser';\nimport type { CoordinateSystem } from '../internal/coordinate-system';\n\nexport const systemDecimalDegrees: CoordinateSystem = {\n  name: 'Decimal Degrees',\n\n  parse: parseDecimalDegrees,\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    return [left, right]\n      .map(\n        (num, index) =>\n          `${Math.abs(num)} ${BEARINGS[format][index as 0 | 1][+(num < 0)]}`,\n      )\n      .join(` ${SYMBOLS.DIVIDER} `);\n  },\n};\n"],"mappings":";;;;;;;;;;;;;;;;;AAuBA,MAAaA,uBAAyC;CACpD,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;AACxD,SAAO,CAAC,MAAM,MAAM,CACjB,KACE,KAAK,UACJ,GAAG,KAAK,IAAI,IAAI,CAAC,GAAG,SAAS,QAAQ,OAAgB,EAAE,MAAM,MAChE,CACA,KAAK,IAAI,QAAQ,QAAQ,GAAG;;CAElC"}
+{"version":3,"file":"system.js","names":["systemDecimalDegrees: CoordinateSystem"],"sources":["../../../../src/coordinates/latlon/decimal-degrees/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 { parseDecimalDegrees } from './parser';\nimport type { CoordinateSystem } from '../internal/coordinate-system';\n\n/**\n * Decimal Degrees coordinate system implementation.\n *\n * Provides parsing, conversion, and formatting for coordinates in decimal degrees notation.\n * Coordinates are expressed as decimal numbers with degree symbols (e.g., 37.7749° N).\n *\n * @property name - Human-readable name of the coordinate system.\n * @property parse - Parses decimal degrees coordinate strings.\n * @property toFloat - Converts parsed coordinate components to floating point numbers.\n * @property toFormat - Formats numeric coordinates back to decimal degrees string.\n *\n * @example\n * ```ts\n * // Parse a coordinate string\n * const [coords, errors] = systemDecimalDegrees.parse('37.7749° N / 122.4194° W', 'LATLON');\n * ```\n *\n * @example\n * ```ts\n * // Convert to float\n * const lat = systemDecimalDegrees.toFloat(['37.7749', 'N']);\n * // 37.7749\n * ```\n *\n * @example\n * ```ts\n * // Format to string\n * const formatted = systemDecimalDegrees.toFormat('LATLON', [37.7749, -122.4194]);\n * // '37.7749 N / 122.4194 W'\n * ```\n */\nexport const systemDecimalDegrees: CoordinateSystem = {\n  name: 'Decimal Degrees',\n\n  parse: parseDecimalDegrees,\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    return [left, right]\n      .map(\n        (num, index) =>\n          `${Math.abs(num)} ${BEARINGS[format][index as 0 | 1][+(num < 0)]}`,\n      )\n      .join(` ${SYMBOLS.DIVIDER} `);\n  },\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAsDA,MAAaA,uBAAyC;CACpD,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;AACxD,SAAO,CAAC,MAAM,MAAM,CACjB,KACE,KAAK,UACJ,GAAG,KAAK,IAAI,IAAI,CAAC,GAAG,SAAS,QAAQ,OAAgB,EAAE,MAAM,MAChE,CACA,KAAK,IAAI,QAAQ,QAAQ,GAAG;;CAElC"}

package/dist/coordinates/latlon/degrees-decimal-minutes/formatter.d.ts

@@ -13,6 +13,26 @@
 import { FormatOptions } from "../internal/format.js";
 
 //#region src/coordinates/latlon/degrees-decimal-minutes/formatter.d.ts
+
+/**
+ * Formats latitude/longitude coordinates in degrees decimal minutes notation.
+ *
+ * @param coordinates - Tuple of [latitude, longitude] values.
+ * @param config - Optional formatting configuration.
+ * @returns Formatted coordinate string in degrees decimal minutes format.
+ *
+ * @example
+ * ```typescript
+ * formatDegreesDecimalMinutes([37.7749, -122.4194]);
+ * // '37° 46.4940' N, 122° 25.1640' W'
+ * ```
+ *
+ * @example
+ * ```typescript
+ * formatDegreesDecimalMinutes([37.7749, -122.4194], { separator: ' / ' });
+ * // '37° 46.4940' N / 122° 25.1640' W'
+ * ```
+ */
 declare const formatDegreesDecimalMinutes: (coordinates: [number, number], config?: FormatOptions) => string;
 //#endregion
 export { formatDegreesDecimalMinutes };

package/dist/coordinates/latlon/degrees-decimal-minutes/formatter.js

@@ -14,10 +14,47 @@
 import { createFormatter } from "../internal/format.js";
 
 //#region src/coordinates/latlon/degrees-decimal-minutes/formatter.ts
+/**
+* Converts a coordinate value to degrees decimal minutes format.
+*
+* @param num - The coordinate value to format.
+* @returns Formatted coordinate string with degrees and decimal minutes (e.g., "45° 30.1234'").
+*
+* @example
+* ```typescript
+* toDegreesDecimalMinutes(45.5);
+* // '45° 30.0000''
+* ```
+*
+* @example
+* ```typescript
+* toDegreesDecimalMinutes(-122.4194);
+* // '122° 25.1640''
+* ```
+*/
 const toDegreesDecimalMinutes = (num) => {
 	const degrees = Math.floor(Math.abs(num));
 	return `${degrees}° ${((Math.abs(num) - degrees) * 60).toFixed(4)}'`;
 };
+/**
+* Formats latitude/longitude coordinates in degrees decimal minutes notation.
+*
+* @param coordinates - Tuple of [latitude, longitude] values.
+* @param config - Optional formatting configuration.
+* @returns Formatted coordinate string in degrees decimal minutes format.
+*
+* @example
+* ```typescript
+* formatDegreesDecimalMinutes([37.7749, -122.4194]);
+* // '37° 46.4940' N, 122° 25.1640' W'
+* ```
+*
+* @example
+* ```typescript
+* formatDegreesDecimalMinutes([37.7749, -122.4194], { separator: ' / ' });
+* // '37° 46.4940' N / 122° 25.1640' W'
+* ```
+*/
 const formatDegreesDecimalMinutes = createFormatter(toDegreesDecimalMinutes);
 
 //#endregion

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

@@ -1 +1 @@
-{"version":3,"file":"formatter.js","names":[],"sources":["../../../../src/coordinates/latlon/degrees-decimal-minutes/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\nconst toDegreesDecimalMinutes = (num: number): string => {\n  const degrees = Math.floor(Math.abs(num));\n  const minutes = ((Math.abs(num) - degrees) * 60).toFixed(4);\n\n  return `${degrees}° ${minutes}'`;\n};\n\nexport const formatDegreesDecimalMinutes = createFormatter(\n  toDegreesDecimalMinutes,\n);\n"],"mappings":";;;;;;;;;;;;;;;;AAcA,MAAM,2BAA2B,QAAwB;CACvD,MAAM,UAAU,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC;AAGzC,QAAO,GAAG,QAAQ,MAFA,KAAK,IAAI,IAAI,GAAG,WAAW,IAAI,QAAQ,EAAE,CAE7B;;AAGhC,MAAa,8BAA8B,gBACzC,wBACD"}
+{"version":3,"file":"formatter.js","names":[],"sources":["../../../../src/coordinates/latlon/degrees-decimal-minutes/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 decimal minutes format.\n *\n * @param num - The coordinate value to format.\n * @returns Formatted coordinate string with degrees and decimal minutes (e.g., \"45° 30.1234'\").\n *\n * @example\n * ```typescript\n * toDegreesDecimalMinutes(45.5);\n * // '45° 30.0000''\n * ```\n *\n * @example\n * ```typescript\n * toDegreesDecimalMinutes(-122.4194);\n * // '122° 25.1640''\n * ```\n */\nconst toDegreesDecimalMinutes = (num: number): string => {\n  const degrees = Math.floor(Math.abs(num));\n  const minutes = ((Math.abs(num) - degrees) * 60).toFixed(4);\n\n  return `${degrees}° ${minutes}'`;\n};\n\n/**\n * Formats latitude/longitude coordinates in degrees decimal minutes notation.\n *\n * @param coordinates - Tuple of [latitude, longitude] values.\n * @param config - Optional formatting configuration.\n * @returns Formatted coordinate string in degrees decimal minutes format.\n *\n * @example\n * ```typescript\n * formatDegreesDecimalMinutes([37.7749, -122.4194]);\n * // '37° 46.4940' N, 122° 25.1640' W'\n * ```\n *\n * @example\n * ```typescript\n * formatDegreesDecimalMinutes([37.7749, -122.4194], { separator: ' / ' });\n * // '37° 46.4940' N / 122° 25.1640' W'\n * ```\n */\nexport const formatDegreesDecimalMinutes = createFormatter(\n  toDegreesDecimalMinutes,\n);\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAgCA,MAAM,2BAA2B,QAAwB;CACvD,MAAM,UAAU,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC;AAGzC,QAAO,GAAG,QAAQ,MAFA,KAAK,IAAI,IAAI,GAAG,WAAW,IAAI,QAAQ,EAAE,CAE7B;;;;;;;;;;;;;;;;;;;;;AAsBhC,MAAa,8BAA8B,gBACzC,wBACD"}

package/dist/coordinates/latlon/degrees-decimal-minutes/parser.d.ts

@@ -14,8 +14,78 @@ import { Format } from "../internal/index.js";
 import { ParseResults } from "../internal/parse.js";
 
 //#region src/coordinates/latlon/degrees-decimal-minutes/parser.d.ts
-/** Parse a Degrees Decimal Minutes coordinate. */
+type DegreesDecimalMinutes = {
+  bear: string;
+  deg: string;
+  min: string;
+};
+/**
+ * Creates an error identification function for degrees decimal minutes coordinates.
+ *
+ * Validates that degree values are integers, minutes are in valid range (0-59.999...),
+ * and that seconds indicators are not present.
+ *
+ * @param format - The coordinate format (LATLON or LONLAT).
+ * @returns Function that validates coordinate components and returns parse results.
+ *
+ * @example
+ * ```typescript
+ * const validator = identifyErrors('LATLON');
+ * const result = validator({ deg: '91', min: '0', bear: 'N' }, 0);
+ * // [[], ['Degrees value (91) exceeds max value (90).']]
+ * ```
+ */
+declare function identifyErrors(format: Format): (arg: DegreesDecimalMinutes | undefined, i: number) => ParseResults;
+/**
+ * Identifies and organizes coordinate components from parsed tokens.
+ *
+ * Separates bearing indicators (N/S/E/W), degree values, and minute values from tokens.
+ * Uses symbol patterns to identify component types and positional logic as fallback.
+ *
+ * @param half - Array of tokens representing one coordinate component.
+ * @returns Object with `bear`, `deg`, and `min` properties, or undefined if invalid.
+ *
+ * @example
+ * ```typescript
+ * identifyPieces(['45', '30.5', 'N']);
+ * // { bear: 'N', deg: '45', min: '30.5' }
+ * ```
+ *
+ * @example
+ * ```typescript
+ * identifyPieces(['122°', '25.164'', 'W']);
+ * // { bear: 'W', deg: '122', min: '25.164' }
+ * ```
+ */
+declare function identifyPieces(half: string[]): {
+  bear: string;
+  deg: string;
+  min: string;
+} | undefined;
+/**
+ * Parses a Degrees Decimal Minutes coordinate string.
+ *
+ * Accepts coordinates in degrees decimal minutes format with bearing indicators.
+ * Validates that degrees are integers, minutes are in valid range (0-59.999...),
+ * and ensures no seconds indicators are present.
+ *
+ * @param input - Raw coordinate string to parse.
+ * @param format - Expected format (LATLON or LONLAT).
+ * @returns Parsed coordinate values or errors.
+ *
+ * @example
+ * ```typescript
+ * parseDegreesDecimalMinutes('37° 46.4940' N / 122° 25.1640' W', 'LATLON');
+ * // [[37.7749, -122.4194], []]
+ * ```
+ *
+ * @example
+ * ```typescript
+ * parseDegreesDecimalMinutes('45 30.5 N, 122 15.3 W');
+ * // [[45.508333, -122.255], []]
+ * ```
+ */
 declare const parseDegreesDecimalMinutes: (format: Format, input: string) => ParseResults;
 //#endregion
-export { parseDegreesDecimalMinutes };
+export { identifyErrors as _identifyErrors, identifyPieces as _identifyPieces, parseDegreesDecimalMinutes };
 //# sourceMappingURL=parser.d.ts.map

package/dist/coordinates/latlon/degrees-decimal-minutes/parser.js

@@ -19,7 +19,9 @@ import { inRange } from "../internal/in-range.js";
 //#region src/coordinates/latlon/degrees-decimal-minutes/parser.ts
 const checks = {
 	deg: (deg, limit) => {
-		if (Number.parseFloat(deg) > limit) return `Degrees value (${deg}) exceeds max value (${limit}).`;
+		const num = Number.parseFloat(deg);
+		if (Number.isNaN(num)) return `Degrees value (${deg}) is not a valid number.`;
+		if (num > limit) return `Degrees value (${deg}) exceeds max value (${limit}).`;
 		if (/\./.test(deg)) return `Degrees value (${deg}) must not include decimal value.`;
 	},
 	min: (min) => inRange("Minutes", min, 59.999999999),
@@ -31,6 +33,22 @@ const formats = {
 	LATLON: fromTemplate(PARTIAL_PATTERNS, `degLat minDec NS ${SYMBOLS.DIVIDER} degLon minDec EW`),
 	LONLAT: fromTemplate(PARTIAL_PATTERNS, `degLon minDec EW ${SYMBOLS.DIVIDER} degLat minDec NS`)
 };
+/**
+* Creates an error identification function for degrees decimal minutes coordinates.
+*
+* Validates that degree values are integers, minutes are in valid range (0-59.999...),
+* and that seconds indicators are not present.
+*
+* @param format - The coordinate format (LATLON or LONLAT).
+* @returns Function that validates coordinate components and returns parse results.
+*
+* @example
+* ```typescript
+* const validator = identifyErrors('LATLON');
+* const result = validator({ deg: '91', min: '0', bear: 'N' }, 0);
+* // [[], ['Degrees value (91) exceeds max value (90).']]
+* ```
+*/
 function identifyErrors(format) {
 	return (arg, i) => {
 		if (!arg) return [[], ["Invalid coordinate value."]];
@@ -60,6 +78,27 @@ function identifyErrors(format) {
 		], []];
 	};
 }
+/**
+* Identifies and organizes coordinate components from parsed tokens.
+*
+* Separates bearing indicators (N/S/E/W), degree values, and minute values from tokens.
+* Uses symbol patterns to identify component types and positional logic as fallback.
+*
+* @param half - Array of tokens representing one coordinate component.
+* @returns Object with `bear`, `deg`, and `min` properties, or undefined if invalid.
+*
+* @example
+* ```typescript
+* identifyPieces(['45', '30.5', 'N']);
+* // { bear: 'N', deg: '45', min: '30.5' }
+* ```
+*
+* @example
+* ```typescript
+* identifyPieces(['122°', '25.164'', 'W']);
+* // { bear: 'W', deg: '122', min: '25.164' }
+* ```
+*/
 function identifyPieces(half) {
 	if (half.length < 1 || half.length > 3) return;
 	const asString = half.join(" ");
@@ -71,17 +110,41 @@ function identifyPieces(half) {
 	const keys = ["deg", "min"];
 	const test = (r, b, v) => r.test(v) || r.test(asString) && b;
 	return half.reduce((acc, token, i, { length }) => {
+		if (!acc) return;
 		if (test(SYMBOL_PATTERNS.NSEW, i === length - 1, token)) acc.bear ||= token;
 		else if (test(SYMBOL_PATTERNS.DEGREES, i === 0, token)) acc.deg ||= token;
 		else if (test(SYMBOL_PATTERNS.MINUTES, i === 1, token)) acc.min ||= token;
 		else {
 			const key = keys.find((k) => !acc[k]);
+			if (!key) return;
 			acc[key] = token;
 		}
 		return acc;
 	}, places);
 }
-/** Parse a Degrees Decimal Minutes coordinate. */
+/**
+* Parses a Degrees Decimal Minutes coordinate string.
+*
+* Accepts coordinates in degrees decimal minutes format with bearing indicators.
+* Validates that degrees are integers, minutes are in valid range (0-59.999...),
+* and ensures no seconds indicators are present.
+*
+* @param input - Raw coordinate string to parse.
+* @param format - Expected format (LATLON or LONLAT).
+* @returns Parsed coordinate values or errors.
+*
+* @example
+* ```typescript
+* parseDegreesDecimalMinutes('37° 46.4940' N / 122° 25.1640' W', 'LATLON');
+* // [[37.7749, -122.4194], []]
+* ```
+*
+* @example
+* ```typescript
+* parseDegreesDecimalMinutes('45 30.5 N, 122 15.3 W');
+* // [[45.508333, -122.255], []]
+* ```
+*/
 const parseDegreesDecimalMinutes = createParser({
 	formats,
 	identifyErrors,
@@ -89,5 +152,5 @@ const parseDegreesDecimalMinutes = createParser({
 });
 
 //#endregion
-export { parseDegreesDecimalMinutes };
+export { identifyErrors as _identifyErrors, identifyPieces as _identifyPieces, parseDegreesDecimalMinutes };
 //# sourceMappingURL=parser.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"parser.js","names":["Patterning.fromTemplate","isNegative: 0 | 1"],"sources":["../../../../src/coordinates/latlon/degrees-decimal-minutes/parser.ts"],"sourcesContent":["/*\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 * as Patterning from '@/patterning';\nimport {\n  BEARINGS,\n  type Format,\n  LIMITS,\n  PARTIAL_PATTERNS,\n  SYMBOL_PATTERNS,\n  SYMBOLS,\n} from '../internal';\nimport { inRange } from '../internal/in-range';\nimport { createParser } from '../internal/parse-format';\nimport type { ParseResults } from '../internal/parse';\n\ntype DegreesDecimalMinutes = {\n  bear: string;\n  deg: string;\n  min: string;\n};\n\nconst checks = {\n  deg: (deg: string, limit: number) => {\n    if (Number.parseFloat(deg) > limit) {\n      return `Degrees value (${deg}) exceeds max value (${limit}).`;\n    }\n\n    if (/\\./.test(deg)) {\n      return `Degrees value (${deg}) must not include decimal value.`;\n    }\n  },\n  min: (min: string) => inRange('Minutes', min, 59.999999999),\n  sec: (val: string) => {\n    if (val.includes(SYMBOLS.SECONDS)) {\n      return `Seconds indicator (${SYMBOLS.SECONDS}) not valid in Degree Decimal Minutes.`;\n    }\n  },\n};\n\nconst formats = {\n  LATLON: Patterning.fromTemplate(\n    PARTIAL_PATTERNS,\n    `degLat minDec NS ${SYMBOLS.DIVIDER} degLon minDec EW`,\n  ),\n  LONLAT: Patterning.fromTemplate(\n    PARTIAL_PATTERNS,\n    `degLon minDec EW ${SYMBOLS.DIVIDER} degLat minDec NS`,\n  ),\n};\n\nfunction identifyErrors(format: Format) {\n  return (arg: DegreesDecimalMinutes | undefined, i: number) => {\n    if (!arg) {\n      return [[], ['Invalid coordinate value.']] as ParseResults;\n    }\n\n    let { bear, deg, min } = arg;\n\n    deg ??= '0';\n    min ??= '0';\n\n    let isNegative: 0 | 1 = SYMBOL_PATTERNS.NEGATIVE_SIGN.test(deg) ? 1 : 0;\n    const bearingOptions = BEARINGS[format][i] as [string, string];\n\n    if (!bear || isNegative) {\n      bear = bearingOptions[isNegative];\n      deg = Math.abs(Number.parseFloat(deg)).toString();\n      isNegative = 0;\n    }\n\n    const errors = [\n      ...[checks.deg(deg, LIMITS[format][i] ?? 0)],\n      ...[checks.min(min)],\n      ...[checks.sec([bear, deg, min].join(''))],\n    ].filter(Boolean);\n\n    return (\n      errors.length ? [[], errors] : [[deg, min, bear], []]\n    ) as ParseResults;\n  };\n}\n\nfunction identifyPieces(half: string[]) {\n  if (half.length < 1 || half.length > 3) {\n    return;\n  }\n\n  const asString = half.join(' ');\n  const places = { bear: '', deg: '', min: '' };\n  const keys = ['deg', 'min'] as (keyof typeof places)[];\n  const test = (r: RegExp, b: boolean, v: string) =>\n    r.test(v) || (r.test(asString) && b);\n\n  return half.reduce((acc, token, i, { length }) => {\n    if (test(SYMBOL_PATTERNS.NSEW, i === length - 1, token)) {\n      acc.bear ||= token;\n    } else if (test(SYMBOL_PATTERNS.DEGREES, i === 0, token)) {\n      acc.deg ||= token;\n    } else if (test(SYMBOL_PATTERNS.MINUTES, i === 1, token)) {\n      acc.min ||= token;\n    } else {\n      const key = keys.find((k) => !acc[k]);\n\n      acc[key as keyof typeof acc] = token;\n    }\n\n    return acc;\n  }, places);\n}\n\n/** Parse a Degrees Decimal Minutes coordinate. */\nexport const parseDegreesDecimalMinutes = createParser<DegreesDecimalMinutes>({\n  formats,\n  identifyErrors,\n  identifyPieces,\n});\n"],"mappings":";;;;;;;;;;;;;;;;;;;AA+BA,MAAM,SAAS;CACb,MAAM,KAAa,UAAkB;AACnC,MAAI,OAAO,WAAW,IAAI,GAAG,MAC3B,QAAO,kBAAkB,IAAI,uBAAuB,MAAM;AAG5D,MAAI,KAAK,KAAK,IAAI,CAChB,QAAO,kBAAkB,IAAI;;CAGjC,MAAM,QAAgB,QAAQ,WAAW,KAAK,aAAa;CAC3D,MAAM,QAAgB;AACpB,MAAI,IAAI,SAAS,QAAQ,QAAQ,CAC/B,QAAO,sBAAsB,QAAQ,QAAQ;;CAGlD;AAED,MAAM,UAAU;CACd,QAAQA,aACN,kBACA,oBAAoB,QAAQ,QAAQ,mBACrC;CACD,QAAQA,aACN,kBACA,oBAAoB,QAAQ,QAAQ,mBACrC;CACF;AAED,SAAS,eAAe,QAAgB;AACtC,SAAQ,KAAwC,MAAc;AAC5D,MAAI,CAAC,IACH,QAAO,CAAC,EAAE,EAAE,CAAC,4BAA4B,CAAC;EAG5C,IAAI,EAAE,MAAM,KAAK,QAAQ;AAEzB,UAAQ;AACR,UAAQ;EAER,IAAIC,aAAoB,gBAAgB,cAAc,KAAK,IAAI,GAAG,IAAI;EACtE,MAAM,iBAAiB,SAAS,QAAQ;AAExC,MAAI,CAAC,QAAQ,YAAY;AACvB,UAAO,eAAe;AACtB,SAAM,KAAK,IAAI,OAAO,WAAW,IAAI,CAAC,CAAC,UAAU;AACjD,gBAAa;;EAGf,MAAM,SAAS;GACb,GAAG,CAAC,OAAO,IAAI,KAAK,OAAO,QAAQ,MAAM,EAAE,CAAC;GAC5C,GAAG,CAAC,OAAO,IAAI,IAAI,CAAC;GACpB,GAAG,CAAC,OAAO,IAAI;IAAC;IAAM;IAAK;IAAI,CAAC,KAAK,GAAG,CAAC,CAAC;GAC3C,CAAC,OAAO,QAAQ;AAEjB,SACE,OAAO,SAAS,CAAC,EAAE,EAAE,OAAO,GAAG,CAAC;GAAC;GAAK;GAAK;GAAK,EAAE,EAAE,CAAC;;;AAK3D,SAAS,eAAe,MAAgB;AACtC,KAAI,KAAK,SAAS,KAAK,KAAK,SAAS,EACnC;CAGF,MAAM,WAAW,KAAK,KAAK,IAAI;CAC/B,MAAM,SAAS;EAAE,MAAM;EAAI,KAAK;EAAI,KAAK;EAAI;CAC7C,MAAM,OAAO,CAAC,OAAO,MAAM;CAC3B,MAAM,QAAQ,GAAW,GAAY,MACnC,EAAE,KAAK,EAAE,IAAK,EAAE,KAAK,SAAS,IAAI;AAEpC,QAAO,KAAK,QAAQ,KAAK,OAAO,GAAG,EAAE,aAAa;AAChD,MAAI,KAAK,gBAAgB,MAAM,MAAM,SAAS,GAAG,MAAM,CACrD,KAAI,SAAS;WACJ,KAAK,gBAAgB,SAAS,MAAM,GAAG,MAAM,CACtD,KAAI,QAAQ;WACH,KAAK,gBAAgB,SAAS,MAAM,GAAG,MAAM,CACtD,KAAI,QAAQ;OACP;GACL,MAAM,MAAM,KAAK,MAAM,MAAM,CAAC,IAAI,GAAG;AAErC,OAAI,OAA2B;;AAGjC,SAAO;IACN,OAAO;;;AAIZ,MAAa,6BAA6B,aAAoC;CAC5E;CACA;CACA;CACD,CAAC"}
+{"version":3,"file":"parser.js","names":["Patterning.fromTemplate","isNegative: 0 | 1"],"sources":["../../../../src/coordinates/latlon/degrees-decimal-minutes/parser.ts"],"sourcesContent":["/*\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 * as Patterning from '@/patterning';\nimport {\n  BEARINGS,\n  type Format,\n  LIMITS,\n  PARTIAL_PATTERNS,\n  SYMBOL_PATTERNS,\n  SYMBOLS,\n} from '../internal';\nimport { inRange } from '../internal/in-range';\nimport { createParser } from '../internal/parse-format';\nimport type { ParseResults } from '../internal/parse';\n\ntype DegreesDecimalMinutes = {\n  bear: string;\n  deg: string;\n  min: string;\n};\n\nconst checks = {\n  deg: (deg: string, limit: number) => {\n    const num = Number.parseFloat(deg);\n    if (Number.isNaN(num)) {\n      return `Degrees value (${deg}) is not a valid number.`;\n    }\n    if (num > limit) {\n      return `Degrees value (${deg}) exceeds max value (${limit}).`;\n    }\n\n    if (/\\./.test(deg)) {\n      return `Degrees value (${deg}) must not include decimal value.`;\n    }\n  },\n  min: (min: string) => inRange('Minutes', min, 59.999999999),\n  sec: (val: string) => {\n    if (val.includes(SYMBOLS.SECONDS)) {\n      return `Seconds indicator (${SYMBOLS.SECONDS}) not valid in Degree Decimal Minutes.`;\n    }\n  },\n};\n\nconst formats = {\n  LATLON: Patterning.fromTemplate(\n    PARTIAL_PATTERNS,\n    `degLat minDec NS ${SYMBOLS.DIVIDER} degLon minDec EW`,\n  ),\n  LONLAT: Patterning.fromTemplate(\n    PARTIAL_PATTERNS,\n    `degLon minDec EW ${SYMBOLS.DIVIDER} degLat minDec NS`,\n  ),\n};\n\n/**\n * Creates an error identification function for degrees decimal minutes coordinates.\n *\n * Validates that degree values are integers, minutes are in valid range (0-59.999...),\n * and that seconds indicators are not present.\n *\n * @param format - The coordinate format (LATLON or LONLAT).\n * @returns Function that validates coordinate components and returns parse results.\n *\n * @example\n * ```typescript\n * const validator = identifyErrors('LATLON');\n * const result = validator({ deg: '91', min: '0', bear: 'N' }, 0);\n * // [[], ['Degrees value (91) exceeds max value (90).']]\n * ```\n */\nfunction identifyErrors(format: Format) {\n  return (arg: DegreesDecimalMinutes | undefined, i: number) => {\n    if (!arg) {\n      return [[], ['Invalid coordinate value.']] as ParseResults;\n    }\n\n    let { bear, deg, min } = arg;\n\n    deg ??= '0';\n    min ??= '0';\n\n    let isNegative: 0 | 1 = SYMBOL_PATTERNS.NEGATIVE_SIGN.test(deg) ? 1 : 0;\n    const bearingOptions = BEARINGS[format][i] as [string, string];\n\n    if (!bear || isNegative) {\n      bear = bearingOptions[isNegative];\n      deg = Math.abs(Number.parseFloat(deg)).toString();\n      isNegative = 0;\n    }\n\n    const errors = [\n      ...[checks.deg(deg, LIMITS[format][i] ?? 0)],\n      ...[checks.min(min)],\n      ...[checks.sec([bear, deg, min].join(''))],\n    ].filter(Boolean);\n\n    return (\n      errors.length ? [[], errors] : [[deg, min, bear], []]\n    ) as ParseResults;\n  };\n}\n\n/**\n * Identifies and organizes coordinate components from parsed tokens.\n *\n * Separates bearing indicators (N/S/E/W), degree values, and minute values from tokens.\n * Uses symbol patterns to identify component types and positional logic as fallback.\n *\n * @param half - Array of tokens representing one coordinate component.\n * @returns Object with `bear`, `deg`, and `min` properties, or undefined if invalid.\n *\n * @example\n * ```typescript\n * identifyPieces(['45', '30.5', 'N']);\n * // { bear: 'N', deg: '45', min: '30.5' }\n * ```\n *\n * @example\n * ```typescript\n * identifyPieces(['122°', '25.164'', 'W']);\n * // { bear: 'W', deg: '122', min: '25.164' }\n * ```\n */\nfunction identifyPieces(half: string[]) {\n  if (half.length < 1 || half.length > 3) {\n    return;\n  }\n\n  const asString = half.join(' ');\n  const places = { bear: '', deg: '', min: '' };\n  const keys = ['deg', 'min'] as (keyof typeof places)[];\n  const test = (r: RegExp, b: boolean, v: string) =>\n    r.test(v) || (r.test(asString) && b);\n\n  return half.reduce<typeof places | undefined>((acc, token, i, { length }) => {\n    if (!acc) {\n      return undefined;\n    }\n    if (test(SYMBOL_PATTERNS.NSEW, i === length - 1, token)) {\n      acc.bear ||= token;\n    } else if (test(SYMBOL_PATTERNS.DEGREES, i === 0, token)) {\n      acc.deg ||= token;\n    } else if (test(SYMBOL_PATTERNS.MINUTES, i === 1, token)) {\n      acc.min ||= token;\n    } else {\n      const key = keys.find((k) => !acc[k]);\n      if (!key) {\n        return undefined;\n      }\n      acc[key] = token;\n    }\n\n    return acc;\n  }, places);\n}\n\n/**\n * Parses a Degrees Decimal Minutes coordinate string.\n *\n * Accepts coordinates in degrees decimal minutes format with bearing indicators.\n * Validates that degrees are integers, minutes are in valid range (0-59.999...),\n * and ensures no seconds indicators are present.\n *\n * @param input - Raw coordinate string to parse.\n * @param format - Expected format (LATLON or LONLAT).\n * @returns Parsed coordinate values or errors.\n *\n * @example\n * ```typescript\n * parseDegreesDecimalMinutes('37° 46.4940' N / 122° 25.1640' W', 'LATLON');\n * // [[37.7749, -122.4194], []]\n * ```\n *\n * @example\n * ```typescript\n * parseDegreesDecimalMinutes('45 30.5 N, 122 15.3 W');\n * // [[45.508333, -122.255], []]\n * ```\n */\nexport const parseDegreesDecimalMinutes = createParser<DegreesDecimalMinutes>({\n  formats,\n  identifyErrors,\n  identifyPieces,\n});\n\nexport { identifyErrors as _identifyErrors, identifyPieces as _identifyPieces };\n"],"mappings":";;;;;;;;;;;;;;;;;;;AA+BA,MAAM,SAAS;CACb,MAAM,KAAa,UAAkB;EACnC,MAAM,MAAM,OAAO,WAAW,IAAI;AAClC,MAAI,OAAO,MAAM,IAAI,CACnB,QAAO,kBAAkB,IAAI;AAE/B,MAAI,MAAM,MACR,QAAO,kBAAkB,IAAI,uBAAuB,MAAM;AAG5D,MAAI,KAAK,KAAK,IAAI,CAChB,QAAO,kBAAkB,IAAI;;CAGjC,MAAM,QAAgB,QAAQ,WAAW,KAAK,aAAa;CAC3D,MAAM,QAAgB;AACpB,MAAI,IAAI,SAAS,QAAQ,QAAQ,CAC/B,QAAO,sBAAsB,QAAQ,QAAQ;;CAGlD;AAED,MAAM,UAAU;CACd,QAAQA,aACN,kBACA,oBAAoB,QAAQ,QAAQ,mBACrC;CACD,QAAQA,aACN,kBACA,oBAAoB,QAAQ,QAAQ,mBACrC;CACF;;;;;;;;;;;;;;;;;AAkBD,SAAS,eAAe,QAAgB;AACtC,SAAQ,KAAwC,MAAc;AAC5D,MAAI,CAAC,IACH,QAAO,CAAC,EAAE,EAAE,CAAC,4BAA4B,CAAC;EAG5C,IAAI,EAAE,MAAM,KAAK,QAAQ;AAEzB,UAAQ;AACR,UAAQ;EAER,IAAIC,aAAoB,gBAAgB,cAAc,KAAK,IAAI,GAAG,IAAI;EACtE,MAAM,iBAAiB,SAAS,QAAQ;AAExC,MAAI,CAAC,QAAQ,YAAY;AACvB,UAAO,eAAe;AACtB,SAAM,KAAK,IAAI,OAAO,WAAW,IAAI,CAAC,CAAC,UAAU;AACjD,gBAAa;;EAGf,MAAM,SAAS;GACb,GAAG,CAAC,OAAO,IAAI,KAAK,OAAO,QAAQ,MAAM,EAAE,CAAC;GAC5C,GAAG,CAAC,OAAO,IAAI,IAAI,CAAC;GACpB,GAAG,CAAC,OAAO,IAAI;IAAC;IAAM;IAAK;IAAI,CAAC,KAAK,GAAG,CAAC,CAAC;GAC3C,CAAC,OAAO,QAAQ;AAEjB,SACE,OAAO,SAAS,CAAC,EAAE,EAAE,OAAO,GAAG,CAAC;GAAC;GAAK;GAAK;GAAK,EAAE,EAAE,CAAC;;;;;;;;;;;;;;;;;;;;;;;;AA0B3D,SAAS,eAAe,MAAgB;AACtC,KAAI,KAAK,SAAS,KAAK,KAAK,SAAS,EACnC;CAGF,MAAM,WAAW,KAAK,KAAK,IAAI;CAC/B,MAAM,SAAS;EAAE,MAAM;EAAI,KAAK;EAAI,KAAK;EAAI;CAC7C,MAAM,OAAO,CAAC,OAAO,MAAM;CAC3B,MAAM,QAAQ,GAAW,GAAY,MACnC,EAAE,KAAK,EAAE,IAAK,EAAE,KAAK,SAAS,IAAI;AAEpC,QAAO,KAAK,QAAmC,KAAK,OAAO,GAAG,EAAE,aAAa;AAC3E,MAAI,CAAC,IACH;AAEF,MAAI,KAAK,gBAAgB,MAAM,MAAM,SAAS,GAAG,MAAM,CACrD,KAAI,SAAS;WACJ,KAAK,gBAAgB,SAAS,MAAM,GAAG,MAAM,CACtD,KAAI,QAAQ;WACH,KAAK,gBAAgB,SAAS,MAAM,GAAG,MAAM,CACtD,KAAI,QAAQ;OACP;GACL,MAAM,MAAM,KAAK,MAAM,MAAM,CAAC,IAAI,GAAG;AACrC,OAAI,CAAC,IACH;AAEF,OAAI,OAAO;;AAGb,SAAO;IACN,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;AA0BZ,MAAa,6BAA6B,aAAoC;CAC5E;CACA;CACA;CACD,CAAC"}