@accelint/geo 0.5.1 → 0.6.1

package/dist/coordinates/latlon/internal/pipes/check-numbers.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
@@ -13,8 +13,33 @@
 import { Tokens } from "../lexer.js";
 
 //#region src/coordinates/latlon/internal/pipes/check-numbers.d.ts
+
 /**
  * Check for problems in the numeric values.
+ *
+ * Validates that there are at least 2 numbers, no more than 6 numbers total,
+ * and that negative values only appear in the first position (degrees).
+ *
+ * @param tokens - Array of parsed coordinate tokens.
+ * @returns Pipe result with tokens and error message (or false if valid).
+ *
+ * @example
+ * ```typescript
+ * checkNumberValues(['45', '30']);
+ * // Returns tokens with error=false (valid number count)
+ * ```
+ *
+ * @example
+ * ```typescript
+ * checkNumberValues(['45']);
+ * // Returns error: 'Too few numbers.'
+ * ```
+ *
+ * @example
+ * ```typescript
+ * checkNumberValues(['1', '2', '3', '4', '5', '6', '7']);
+ * // Returns error: 'Too many numbers.'
+ * ```
  */
 declare function checkNumberValues(tokens: Tokens): [string[], string | boolean];
 //#endregion

package/dist/coordinates/latlon/internal/pipes/check-numbers.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,12 +11,37 @@
  */
 
 
+import { SYMBOLS } from "../index.js";
 import { simpler } from "./simpler.js";
 import { pipesResult } from "./index.js";
 
 //#region src/coordinates/latlon/internal/pipes/check-numbers.ts
 /**
 * Check for problems in the numeric values.
+*
+* Validates that there are at least 2 numbers, no more than 6 numbers total,
+* and that negative values only appear in the first position (degrees).
+*
+* @param tokens - Array of parsed coordinate tokens.
+* @returns Pipe result with tokens and error message (or false if valid).
+*
+* @example
+* ```typescript
+* checkNumberValues(['45', '30']);
+* // Returns tokens with error=false (valid number count)
+* ```
+*
+* @example
+* ```typescript
+* checkNumberValues(['45']);
+* // Returns error: 'Too few numbers.'
+* ```
+*
+* @example
+* ```typescript
+* checkNumberValues(['1', '2', '3', '4', '5', '6', '7']);
+* // Returns error: 'Too many numbers.'
+* ```
 */
 function checkNumberValues(tokens) {
 	const simple = simpler(tokens);
@@ -28,6 +53,14 @@ function checkNumberValues(tokens) {
 		return acc;
 	}, []).join("");
 	if (!!pattern.match(/[^_]-./) && pattern !== "_--_") return pipesResult(tokens, "Negative value for non-degrees value found.");
+	if (tokens.includes(SYMBOLS.DIVIDER)) {
+		const divIdx = tokens.indexOf(SYMBOLS.DIVIDER);
+		const halves = [tokens.slice(0, divIdx), tokens.slice(divIdx + 1)];
+		for (const half of halves) {
+			const nums = half.filter((t) => /\d/.test(t));
+			if (nums.length > 1 && nums.some((n, i) => i > 0 && Number.parseFloat(n) < 0)) return pipesResult(tokens, "Negative value for non-degrees value found.");
+		}
+	}
 	return pipesResult(tokens, false);
 }
 

package/dist/coordinates/latlon/internal/pipes/check-numbers.js.map

@@ -1 +1 @@
-{"version":3,"file":"check-numbers.js","names":[],"sources":["../../../../../src/coordinates/latlon/internal/pipes/check-numbers.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 { pipesResult } from '../pipes';\nimport { simpler } from './simpler';\nimport type { Tokens } from '../lexer';\n\n/**\n * Check for problems in the numeric values.\n */\nexport function checkNumberValues(tokens: Tokens) {\n  const simple = simpler(tokens);\n\n  if ((simple.match(/N/g) ?? []).length < 2) {\n    return pipesResult(tokens, 'Too few numbers.');\n  }\n\n  const error =\n    // 4 consecutive numbers in specific formation is not going to be valid\n    /(?:N{4,}BN+)|(?:N+BN{4,})/.test(simple) ||\n    // more than 6 numbers total\n    (simple.match(/N/g) ?? []).length > 6;\n\n  if (error) {\n    return pipesResult(tokens, 'Too many numbers.');\n  }\n\n  const pattern = tokens\n    .reduce((acc, t) => {\n      if (/\\d/.test(t)) {\n        acc.push(Number.parseFloat(t) < 0 ? '-' : '+');\n      } else {\n        acc.push('_');\n      }\n\n      return acc;\n    }, [] as string[])\n    .join('');\n\n  const matches = pattern.match(/[^_]-./);\n\n  // special case '_--_' when the input is something like 'S -1 -1 W'\n  // which is invalid for other reasons and will be caught elsewhere\n  if (!!matches && pattern !== '_--_') {\n    return pipesResult(tokens, 'Negative value for non-degrees value found.');\n  }\n\n  return pipesResult(tokens, false);\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAoBA,SAAgB,kBAAkB,QAAgB;CAChD,MAAM,SAAS,QAAQ,OAAO;AAE9B,MAAK,OAAO,MAAM,KAAK,IAAI,EAAE,EAAE,SAAS,EACtC,QAAO,YAAY,QAAQ,mBAAmB;AAShD,KAJE,4BAA4B,KAAK,OAAO,KAEvC,OAAO,MAAM,KAAK,IAAI,EAAE,EAAE,SAAS,EAGpC,QAAO,YAAY,QAAQ,oBAAoB;CAGjD,MAAM,UAAU,OACb,QAAQ,KAAK,MAAM;AAClB,MAAI,KAAK,KAAK,EAAE,CACd,KAAI,KAAK,OAAO,WAAW,EAAE,GAAG,IAAI,MAAM,IAAI;MAE9C,KAAI,KAAK,IAAI;AAGf,SAAO;IACN,EAAE,CAAa,CACjB,KAAK,GAAG;AAMX,KAAI,CAAC,CAJW,QAAQ,MAAM,SAAS,IAItB,YAAY,OAC3B,QAAO,YAAY,QAAQ,8CAA8C;AAG3E,QAAO,YAAY,QAAQ,MAAM"}
+{"version":3,"file":"check-numbers.js","names":[],"sources":["../../../../../src/coordinates/latlon/internal/pipes/check-numbers.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 { SYMBOLS } from '..';\nimport { pipesResult } from '../pipes';\nimport { simpler } from './simpler';\nimport type { Tokens } from '../lexer';\n\n/**\n * Check for problems in the numeric values.\n *\n * Validates that there are at least 2 numbers, no more than 6 numbers total,\n * and that negative values only appear in the first position (degrees).\n *\n * @param tokens - Array of parsed coordinate tokens.\n * @returns Pipe result with tokens and error message (or false if valid).\n *\n * @example\n * ```typescript\n * checkNumberValues(['45', '30']);\n * // Returns tokens with error=false (valid number count)\n * ```\n *\n * @example\n * ```typescript\n * checkNumberValues(['45']);\n * // Returns error: 'Too few numbers.'\n * ```\n *\n * @example\n * ```typescript\n * checkNumberValues(['1', '2', '3', '4', '5', '6', '7']);\n * // Returns error: 'Too many numbers.'\n * ```\n */\nexport function checkNumberValues(tokens: Tokens) {\n  const simple = simpler(tokens);\n\n  if ((simple.match(/N/g) ?? []).length < 2) {\n    return pipesResult(tokens, 'Too few numbers.');\n  }\n\n  const error =\n    // 4 consecutive numbers in specific formation is not going to be valid\n    /(?:N{4,}BN+)|(?:N+BN{4,})/.test(simple) ||\n    // more than 6 numbers total\n    (simple.match(/N/g) ?? []).length > 6;\n\n  if (error) {\n    return pipesResult(tokens, 'Too many numbers.');\n  }\n\n  const pattern = tokens\n    .reduce((acc, t) => {\n      if (/\\d/.test(t)) {\n        acc.push(Number.parseFloat(t) < 0 ? '-' : '+');\n      } else {\n        acc.push('_');\n      }\n\n      return acc;\n    }, [] as string[])\n    .join('');\n\n  const matches = pattern.match(/[^_]-./);\n\n  // special case '_--_' when the input is something like 'S -1 -1 W'\n  // which is invalid for other reasons and will be caught elsewhere\n  if (!!matches && pattern !== '_--_') {\n    return pipesResult(tokens, 'Negative value for non-degrees value found.');\n  }\n\n  if (tokens.includes(SYMBOLS.DIVIDER)) {\n    const divIdx = tokens.indexOf(SYMBOLS.DIVIDER);\n    const halves = [tokens.slice(0, divIdx), tokens.slice(divIdx + 1)];\n\n    for (const half of halves) {\n      const nums = half.filter((t) => /\\d/.test(t));\n\n      if (\n        nums.length > 1 &&\n        nums.some((n, i) => i > 0 && Number.parseFloat(n) < 0)\n      ) {\n        return pipesResult(\n          tokens,\n          'Negative value for non-degrees value found.',\n        );\n      }\n    }\n  }\n\n  return pipesResult(tokens, false);\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA6CA,SAAgB,kBAAkB,QAAgB;CAChD,MAAM,SAAS,QAAQ,OAAO;AAE9B,MAAK,OAAO,MAAM,KAAK,IAAI,EAAE,EAAE,SAAS,EACtC,QAAO,YAAY,QAAQ,mBAAmB;AAShD,KAJE,4BAA4B,KAAK,OAAO,KAEvC,OAAO,MAAM,KAAK,IAAI,EAAE,EAAE,SAAS,EAGpC,QAAO,YAAY,QAAQ,oBAAoB;CAGjD,MAAM,UAAU,OACb,QAAQ,KAAK,MAAM;AAClB,MAAI,KAAK,KAAK,EAAE,CACd,KAAI,KAAK,OAAO,WAAW,EAAE,GAAG,IAAI,MAAM,IAAI;MAE9C,KAAI,KAAK,IAAI;AAGf,SAAO;IACN,EAAE,CAAa,CACjB,KAAK,GAAG;AAMX,KAAI,CAAC,CAJW,QAAQ,MAAM,SAAS,IAItB,YAAY,OAC3B,QAAO,YAAY,QAAQ,8CAA8C;AAG3E,KAAI,OAAO,SAAS,QAAQ,QAAQ,EAAE;EACpC,MAAM,SAAS,OAAO,QAAQ,QAAQ,QAAQ;EAC9C,MAAM,SAAS,CAAC,OAAO,MAAM,GAAG,OAAO,EAAE,OAAO,MAAM,SAAS,EAAE,CAAC;AAElE,OAAK,MAAM,QAAQ,QAAQ;GACzB,MAAM,OAAO,KAAK,QAAQ,MAAM,KAAK,KAAK,EAAE,CAAC;AAE7C,OACE,KAAK,SAAS,KACd,KAAK,MAAM,GAAG,MAAM,IAAI,KAAK,OAAO,WAAW,EAAE,GAAG,EAAE,CAEtD,QAAO,YACL,QACA,8CACD;;;AAKP,QAAO,YAAY,QAAQ,MAAM"}

package/dist/coordinates/latlon/internal/pipes/fix-bearings.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
@@ -15,10 +15,27 @@ import { Tokens } from "../lexer.js";
 import { PipeResult } from "./index.js";
 
 //#region src/coordinates/latlon/internal/pipes/fix-bearings.d.ts
+
 /**
  * Normalize bearings - negative and positive numeric values to NSEW - and
  * positioning of bearings - after the numeric values - and fill in any missing
  * bearings if only one is provided.
+ *
+ * @param tokens - Array of parsed coordinate tokens containing a divider.
+ * @param format - Optional coordinate format (LATLON or LONLAT) to infer missing bearings.
+ * @returns Pipe result with normalized tokens and error status.
+ *
+ * @example
+ * ```typescript
+ * fixBearings(['45', 'N', '/', '122', 'W'], 'LATLON');
+ * // Returns ['45', 'N', '/', '122', 'W'] with error=false
+ * ```
+ *
+ * @example
+ * ```typescript
+ * fixBearings(['-45', '/', '122'], 'LATLON');
+ * // Returns ['45', 'S', '/', '122', 'E'] with error=false
+ * ```
  */
 declare function fixBearings(tokens: Tokens, format?: Format): PipeResult;
 //#endregion

package/dist/coordinates/latlon/internal/pipes/fix-bearings.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
@@ -27,6 +27,22 @@ const conflict = ([a, b]) => `Bearing (${a}) conflicts with negative number (${b
 * Normalize bearings - negative and positive numeric values to NSEW - and
 * positioning of bearings - after the numeric values - and fill in any missing
 * bearings if only one is provided.
+*
+* @param tokens - Array of parsed coordinate tokens containing a divider.
+* @param format - Optional coordinate format (LATLON or LONLAT) to infer missing bearings.
+* @returns Pipe result with normalized tokens and error status.
+*
+* @example
+* ```typescript
+* fixBearings(['45', 'N', '/', '122', 'W'], 'LATLON');
+* // Returns ['45', 'N', '/', '122', 'W'] with error=false
+* ```
+*
+* @example
+* ```typescript
+* fixBearings(['-45', '/', '122'], 'LATLON');
+* // Returns ['45', 'S', '/', '122', 'E'] with error=false
+* ```
 */
 function fixBearings(tokens, format) {
 	const [left, right] = [tokens.slice(0, tokens.indexOf(SYMBOLS.DIVIDER)), tokens.slice(1 + tokens.indexOf(SYMBOLS.DIVIDER))].map(moveBearingsToHead);
@@ -65,6 +81,21 @@ function fixBearings(tokens, format) {
 * module only - so that it is easier to work with; moving a bearing to the
 * "head" allows for `push()` of subsequent number processing will keep the
 * order of the numeric values intact.
+*
+* @param coord - Array of tokens for one coordinate half (before or after divider).
+* @returns New array with bearing moved to first position.
+*
+* @example
+* ```typescript
+* moveBearingsToHead(['45', '30', 'N']);
+* // ['N', '45', '30']
+* ```
+*
+* @example
+* ```typescript
+* moveBearingsToHead(['122', '15']);
+* // ['122', '15']
+* ```
 */
 function moveBearingsToHead(coord) {
 	return coord.reduce((acc, t) => {

package/dist/coordinates/latlon/internal/pipes/fix-bearings.js.map

@@ -1 +1 @@
-{"version":3,"file":"fix-bearings.js","names":[],"sources":["../../../../../src/coordinates/latlon/internal/pipes/fix-bearings.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 { BEARINGS, type Format, SYMBOL_PATTERNS, SYMBOLS } from '..';\nimport type { Tokens } from '../lexer';\nimport type { PipeResult } from '../pipes';\n\nconst orthogonal = {\n  N: BEARINGS.LON,\n  S: BEARINGS.LON,\n  E: BEARINGS.LAT,\n  W: BEARINGS.LAT,\n};\n\nconst bearingConflictsWithNumber = (tokens: Tokens) =>\n  tokens[0] &&\n  tokens[1] &&\n  SYMBOL_PATTERNS.NEGATIVE_SIGN.test(tokens[1]) &&\n  SYMBOL_PATTERNS.NSEW.test(tokens[0]) &&\n  !SYMBOL_PATTERNS.NEGATIVE_BEARINGS.test(tokens[0]);\n\nconst bePositive = (n: string) => n.replace(SYMBOL_PATTERNS.NEGATIVE_SIGN, '');\n\nconst conflict = ([a, b]: Tokens) =>\n  `Bearing (${a}) conflicts with negative number (${b}).`;\n\n/**\n * Normalize bearings - negative and positive numeric values to NSEW - and\n * positioning of bearings - after the numeric values - and fill in any missing\n * bearings if only one is provided.\n */\nexport function fixBearings(tokens: Tokens, format?: Format): PipeResult {\n  const [left, right] = [\n    tokens.slice(0, tokens.indexOf(SYMBOLS.DIVIDER)),\n    tokens.slice(1 + tokens.indexOf(SYMBOLS.DIVIDER)),\n  ].map(moveBearingsToHead) as [Tokens, Tokens];\n\n  if (bearingConflictsWithNumber(left)) {\n    return [[], conflict(left)];\n  }\n\n  if (bearingConflictsWithNumber(right)) {\n    return [[], conflict(right)];\n  }\n\n  const [leftHasBearing, rightHasBearing] = [left, right].map(\n    (list) => !!(list?.[0] && SYMBOL_PATTERNS.NSEW.test(list[0])),\n  );\n\n  let leftBearing = '';\n  let rightBearing = '';\n\n  if (leftHasBearing && rightHasBearing) {\n    leftBearing = left.shift() ?? '';\n    rightBearing = right.shift() ?? '';\n  } else if (leftHasBearing) {\n    leftBearing = left.shift() ?? '';\n    rightBearing =\n      orthogonal[leftBearing as keyof typeof orthogonal][\n        +SYMBOL_PATTERNS.NEGATIVE_SIGN.test(right[0] ?? '') as 0 | 1\n      ];\n  } else if (rightHasBearing) {\n    rightBearing = right.shift() ?? '';\n    leftBearing =\n      orthogonal[rightBearing as keyof typeof orthogonal][\n        +SYMBOL_PATTERNS.NEGATIVE_SIGN.test(right[0] ?? '') as 0 | 1\n      ];\n  } else if (format) {\n    leftBearing = `${BEARINGS[format][0][+SYMBOL_PATTERNS.NEGATIVE_SIGN.test(`${left[0]}`)]}`;\n    rightBearing = `${BEARINGS[format][1][+SYMBOL_PATTERNS.NEGATIVE_SIGN.test(`${right[0]}`)]}`;\n  } else {\n    // neither exist\n    return [[...left, SYMBOLS.DIVIDER, ...right], false];\n  }\n\n  return [\n    [\n      ...left.map(bePositive),\n      leftBearing,\n      SYMBOLS.DIVIDER,\n      ...right.map(bePositive),\n      rightBearing,\n    ],\n    false,\n  ];\n}\n\n/**\n * Move the bearings indicators to the first element in the list - in this\n * module only - so that it is easier to work with; moving a bearing to the\n * \"head\" allows for `push()` of subsequent number processing will keep the\n * order of the numeric values intact.\n */\nfunction moveBearingsToHead(coord: Tokens) {\n  return coord.reduce((acc, t) => {\n    if (/\\d/.test(t)) {\n      acc.push(t);\n    } else {\n      acc.unshift(t);\n    }\n\n    return acc;\n  }, [] as Tokens);\n}\n"],"mappings":";;;;;;;;;;;;;;;;AAiBA,MAAM,aAAa;CACjB,GAAG,SAAS;CACZ,GAAG,SAAS;CACZ,GAAG,SAAS;CACZ,GAAG,SAAS;CACb;AAED,MAAM,8BAA8B,WAClC,OAAO,MACP,OAAO,MACP,gBAAgB,cAAc,KAAK,OAAO,GAAG,IAC7C,gBAAgB,KAAK,KAAK,OAAO,GAAG,IACpC,CAAC,gBAAgB,kBAAkB,KAAK,OAAO,GAAG;AAEpD,MAAM,cAAc,MAAc,EAAE,QAAQ,gBAAgB,eAAe,GAAG;AAE9E,MAAM,YAAY,CAAC,GAAG,OACpB,YAAY,EAAE,oCAAoC,EAAE;;;;;;AAOtD,SAAgB,YAAY,QAAgB,QAA6B;CACvE,MAAM,CAAC,MAAM,SAAS,CACpB,OAAO,MAAM,GAAG,OAAO,QAAQ,QAAQ,QAAQ,CAAC,EAChD,OAAO,MAAM,IAAI,OAAO,QAAQ,QAAQ,QAAQ,CAAC,CAClD,CAAC,IAAI,mBAAmB;AAEzB,KAAI,2BAA2B,KAAK,CAClC,QAAO,CAAC,EAAE,EAAE,SAAS,KAAK,CAAC;AAG7B,KAAI,2BAA2B,MAAM,CACnC,QAAO,CAAC,EAAE,EAAE,SAAS,MAAM,CAAC;CAG9B,MAAM,CAAC,gBAAgB,mBAAmB,CAAC,MAAM,MAAM,CAAC,KACrD,SAAS,CAAC,EAAE,OAAO,MAAM,gBAAgB,KAAK,KAAK,KAAK,GAAG,EAC7D;CAED,IAAI,cAAc;CAClB,IAAI,eAAe;AAEnB,KAAI,kBAAkB,iBAAiB;AACrC,gBAAc,KAAK,OAAO,IAAI;AAC9B,iBAAe,MAAM,OAAO,IAAI;YACvB,gBAAgB;AACzB,gBAAc,KAAK,OAAO,IAAI;AAC9B,iBACE,WAAW,aACT,CAAC,gBAAgB,cAAc,KAAK,MAAM,MAAM,GAAG;YAE9C,iBAAiB;AAC1B,iBAAe,MAAM,OAAO,IAAI;AAChC,gBACE,WAAW,cACT,CAAC,gBAAgB,cAAc,KAAK,MAAM,MAAM,GAAG;YAE9C,QAAQ;AACjB,gBAAc,GAAG,SAAS,QAAQ,GAAG,CAAC,gBAAgB,cAAc,KAAK,GAAG,KAAK,KAAK;AACtF,iBAAe,GAAG,SAAS,QAAQ,GAAG,CAAC,gBAAgB,cAAc,KAAK,GAAG,MAAM,KAAK;OAGxF,QAAO,CAAC;EAAC,GAAG;EAAM,QAAQ;EAAS,GAAG;EAAM,EAAE,MAAM;AAGtD,QAAO,CACL;EACE,GAAG,KAAK,IAAI,WAAW;EACvB;EACA,QAAQ;EACR,GAAG,MAAM,IAAI,WAAW;EACxB;EACD,EACD,MACD;;;;;;;;AASH,SAAS,mBAAmB,OAAe;AACzC,QAAO,MAAM,QAAQ,KAAK,MAAM;AAC9B,MAAI,KAAK,KAAK,EAAE,CACd,KAAI,KAAK,EAAE;MAEX,KAAI,QAAQ,EAAE;AAGhB,SAAO;IACN,EAAE,CAAW"}
+{"version":3,"file":"fix-bearings.js","names":[],"sources":["../../../../../src/coordinates/latlon/internal/pipes/fix-bearings.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 { BEARINGS, type Format, SYMBOL_PATTERNS, SYMBOLS } from '..';\nimport type { Tokens } from '../lexer';\nimport type { PipeResult } from '../pipes';\n\nconst orthogonal = {\n  N: BEARINGS.LON,\n  S: BEARINGS.LON,\n  E: BEARINGS.LAT,\n  W: BEARINGS.LAT,\n};\n\nconst bearingConflictsWithNumber = (tokens: Tokens) =>\n  tokens[0] &&\n  tokens[1] &&\n  SYMBOL_PATTERNS.NEGATIVE_SIGN.test(tokens[1]) &&\n  SYMBOL_PATTERNS.NSEW.test(tokens[0]) &&\n  !SYMBOL_PATTERNS.NEGATIVE_BEARINGS.test(tokens[0]);\n\nconst bePositive = (n: string) => n.replace(SYMBOL_PATTERNS.NEGATIVE_SIGN, '');\n\nconst conflict = ([a, b]: Tokens) =>\n  `Bearing (${a}) conflicts with negative number (${b}).`;\n\n/**\n * Normalize bearings - negative and positive numeric values to NSEW - and\n * positioning of bearings - after the numeric values - and fill in any missing\n * bearings if only one is provided.\n *\n * @param tokens - Array of parsed coordinate tokens containing a divider.\n * @param format - Optional coordinate format (LATLON or LONLAT) to infer missing bearings.\n * @returns Pipe result with normalized tokens and error status.\n *\n * @example\n * ```typescript\n * fixBearings(['45', 'N', '/', '122', 'W'], 'LATLON');\n * // Returns ['45', 'N', '/', '122', 'W'] with error=false\n * ```\n *\n * @example\n * ```typescript\n * fixBearings(['-45', '/', '122'], 'LATLON');\n * // Returns ['45', 'S', '/', '122', 'E'] with error=false\n * ```\n */\nexport function fixBearings(tokens: Tokens, format?: Format): PipeResult {\n  const [left, right] = [\n    tokens.slice(0, tokens.indexOf(SYMBOLS.DIVIDER)),\n    tokens.slice(1 + tokens.indexOf(SYMBOLS.DIVIDER)),\n  ].map(moveBearingsToHead) as [Tokens, Tokens];\n\n  if (bearingConflictsWithNumber(left)) {\n    return [[], conflict(left)];\n  }\n\n  if (bearingConflictsWithNumber(right)) {\n    return [[], conflict(right)];\n  }\n\n  const [leftHasBearing, rightHasBearing] = [left, right].map(\n    (list) => !!(list?.[0] && SYMBOL_PATTERNS.NSEW.test(list[0])),\n  );\n\n  let leftBearing = '';\n  let rightBearing = '';\n\n  if (leftHasBearing && rightHasBearing) {\n    leftBearing = left.shift() ?? '';\n    rightBearing = right.shift() ?? '';\n  } else if (leftHasBearing) {\n    leftBearing = left.shift() ?? '';\n    rightBearing =\n      orthogonal[leftBearing as keyof typeof orthogonal][\n        +SYMBOL_PATTERNS.NEGATIVE_SIGN.test(right[0] ?? '') as 0 | 1\n      ];\n  } else if (rightHasBearing) {\n    rightBearing = right.shift() ?? '';\n    leftBearing =\n      orthogonal[rightBearing as keyof typeof orthogonal][\n        +SYMBOL_PATTERNS.NEGATIVE_SIGN.test(right[0] ?? '') as 0 | 1\n      ];\n  } else if (format) {\n    leftBearing = `${BEARINGS[format][0][+SYMBOL_PATTERNS.NEGATIVE_SIGN.test(`${left[0]}`)]}`;\n    rightBearing = `${BEARINGS[format][1][+SYMBOL_PATTERNS.NEGATIVE_SIGN.test(`${right[0]}`)]}`;\n  } else {\n    // neither exist\n    return [[...left, SYMBOLS.DIVIDER, ...right], false];\n  }\n\n  return [\n    [\n      ...left.map(bePositive),\n      leftBearing,\n      SYMBOLS.DIVIDER,\n      ...right.map(bePositive),\n      rightBearing,\n    ],\n    false,\n  ];\n}\n\n/**\n * Move the bearings indicators to the first element in the list - in this\n * module only - so that it is easier to work with; moving a bearing to the\n * \"head\" allows for `push()` of subsequent number processing will keep the\n * order of the numeric values intact.\n *\n * @param coord - Array of tokens for one coordinate half (before or after divider).\n * @returns New array with bearing moved to first position.\n *\n * @example\n * ```typescript\n * moveBearingsToHead(['45', '30', 'N']);\n * // ['N', '45', '30']\n * ```\n *\n * @example\n * ```typescript\n * moveBearingsToHead(['122', '15']);\n * // ['122', '15']\n * ```\n */\nfunction moveBearingsToHead(coord: Tokens) {\n  return coord.reduce((acc, t) => {\n    if (/\\d/.test(t)) {\n      acc.push(t);\n    } else {\n      acc.unshift(t);\n    }\n\n    return acc;\n  }, [] as Tokens);\n}\n"],"mappings":";;;;;;;;;;;;;;;;AAiBA,MAAM,aAAa;CACjB,GAAG,SAAS;CACZ,GAAG,SAAS;CACZ,GAAG,SAAS;CACZ,GAAG,SAAS;CACb;AAED,MAAM,8BAA8B,WAClC,OAAO,MACP,OAAO,MACP,gBAAgB,cAAc,KAAK,OAAO,GAAG,IAC7C,gBAAgB,KAAK,KAAK,OAAO,GAAG,IACpC,CAAC,gBAAgB,kBAAkB,KAAK,OAAO,GAAG;AAEpD,MAAM,cAAc,MAAc,EAAE,QAAQ,gBAAgB,eAAe,GAAG;AAE9E,MAAM,YAAY,CAAC,GAAG,OACpB,YAAY,EAAE,oCAAoC,EAAE;;;;;;;;;;;;;;;;;;;;;;AAuBtD,SAAgB,YAAY,QAAgB,QAA6B;CACvE,MAAM,CAAC,MAAM,SAAS,CACpB,OAAO,MAAM,GAAG,OAAO,QAAQ,QAAQ,QAAQ,CAAC,EAChD,OAAO,MAAM,IAAI,OAAO,QAAQ,QAAQ,QAAQ,CAAC,CAClD,CAAC,IAAI,mBAAmB;AAEzB,KAAI,2BAA2B,KAAK,CAClC,QAAO,CAAC,EAAE,EAAE,SAAS,KAAK,CAAC;AAG7B,KAAI,2BAA2B,MAAM,CACnC,QAAO,CAAC,EAAE,EAAE,SAAS,MAAM,CAAC;CAG9B,MAAM,CAAC,gBAAgB,mBAAmB,CAAC,MAAM,MAAM,CAAC,KACrD,SAAS,CAAC,EAAE,OAAO,MAAM,gBAAgB,KAAK,KAAK,KAAK,GAAG,EAC7D;CAED,IAAI,cAAc;CAClB,IAAI,eAAe;AAEnB,KAAI,kBAAkB,iBAAiB;AACrC,gBAAc,KAAK,OAAO,IAAI;AAC9B,iBAAe,MAAM,OAAO,IAAI;YACvB,gBAAgB;AACzB,gBAAc,KAAK,OAAO,IAAI;AAC9B,iBACE,WAAW,aACT,CAAC,gBAAgB,cAAc,KAAK,MAAM,MAAM,GAAG;YAE9C,iBAAiB;AAC1B,iBAAe,MAAM,OAAO,IAAI;AAChC,gBACE,WAAW,cACT,CAAC,gBAAgB,cAAc,KAAK,MAAM,MAAM,GAAG;YAE9C,QAAQ;AACjB,gBAAc,GAAG,SAAS,QAAQ,GAAG,CAAC,gBAAgB,cAAc,KAAK,GAAG,KAAK,KAAK;AACtF,iBAAe,GAAG,SAAS,QAAQ,GAAG,CAAC,gBAAgB,cAAc,KAAK,GAAG,MAAM,KAAK;OAGxF,QAAO,CAAC;EAAC,GAAG;EAAM,QAAQ;EAAS,GAAG;EAAM,EAAE,MAAM;AAGtD,QAAO,CACL;EACE,GAAG,KAAK,IAAI,WAAW;EACvB;EACA,QAAQ;EACR,GAAG,MAAM,IAAI,WAAW;EACxB;EACD,EACD,MACD;;;;;;;;;;;;;;;;;;;;;;;AAwBH,SAAS,mBAAmB,OAAe;AACzC,QAAO,MAAM,QAAQ,KAAK,MAAM;AAC9B,MAAI,KAAK,KAAK,EAAE,CACd,KAAI,KAAK,EAAE;MAEX,KAAI,QAAQ,EAAE;AAGhB,SAAO;IACN,EAAE,CAAW"}

package/dist/coordinates/latlon/internal/pipes/fix-dividers.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
@@ -15,11 +15,28 @@ import { Tokens } from "../lexer.js";
 import { PipeResult } from "./index.js";
 
 //#region src/coordinates/latlon/internal/pipes/fix-dividers.d.ts
+
 /**
  * For tokens lists without a divider, `fixDivider` attempts to determine the
  * __safe__ location to add a divider based on the existing formatting of the
  * coordinate: numbers, number positions, and number indicators.
  *
+ * @param original - Array of coordinate tokens without a divider.
+ * @param _format - Optional coordinate format (LATLON or LONLAT), currently unused.
+ * @returns Pipe result with divider inserted, or error=true if no safe location found.
+ *
+ * @example
+ * ```typescript
+ * fixDivider(['45°', '30'', 'N', '122°', '15'', 'W']);
+ * // Returns tokens with divider inserted between latitude and longitude
+ * ```
+ *
+ * @example
+ * ```typescript
+ * fixDivider(['45', '30', 'N']);
+ * // Returns error=true (cannot safely determine divider position)
+ * ```
+ *
  * @remarks
  * pure function
  */

package/dist/coordinates/latlon/internal/pipes/fix-dividers.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
@@ -22,6 +22,19 @@ const SIMPLER_PATTERNS = {
 	BNNB: 2,
 	BNN: 2
 };
+/**
+* Inserts a divider token at the specified index in the tokens array.
+*
+* @param tokens - Array of coordinate tokens without a divider.
+* @param index - Position where the divider should be inserted.
+* @returns Pipe result with divider inserted and error=false.
+*
+* @example
+* ```typescript
+* insertDivider(['45', '30', 'N', '122', '15', 'W'], 3);
+* // [['45', '30', 'N', '/', '122', '15', 'W'], false]
+* ```
+*/
 const insertDivider = (tokens, index) => [[
 	...tokens.slice(0, index),
 	SYMBOLS.DIVIDER,
@@ -32,6 +45,22 @@ const insertDivider = (tokens, index) => [[
 * __safe__ location to add a divider based on the existing formatting of the
 * coordinate: numbers, number positions, and number indicators.
 *
+* @param original - Array of coordinate tokens without a divider.
+* @param _format - Optional coordinate format (LATLON or LONLAT), currently unused.
+* @returns Pipe result with divider inserted, or error=true if no safe location found.
+*
+* @example
+* ```typescript
+* fixDivider(['45°', '30'', 'N', '122°', '15'', 'W']);
+* // Returns tokens with divider inserted between latitude and longitude
+* ```
+*
+* @example
+* ```typescript
+* fixDivider(['45', '30', 'N']);
+* // Returns error=true (cannot safely determine divider position)
+* ```
+*
 * @remarks
 * pure function
 */

package/dist/coordinates/latlon/internal/pipes/fix-dividers.js.map

@@ -1 +1 @@
-{"version":3,"file":"fix-dividers.js","names":[],"sources":["../../../../../src/coordinates/latlon/internal/pipes/fix-dividers.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 Format, SYMBOLS } from '..';\nimport { getGenomeIndex } from './genome';\nimport { simpler } from './simpler';\nimport type { Tokens } from '../lexer';\nimport type { PipeResult } from '../pipes';\n\n// N = number\n// B = bearing\nconst SIMPLER_PATTERNS = {\n  NN: 1,\n  NNB: 1,\n  BNNB: 2,\n  BNN: 2,\n};\n\nconst insertDivider = (tokens: Tokens, index: number): PipeResult => [\n  [...tokens.slice(0, index), SYMBOLS.DIVIDER, ...tokens.slice(index)],\n  false,\n];\n\n/**\n * For tokens lists without a divider, `fixDivider` attempts to determine the\n * __safe__ location to add a divider based on the existing formatting of the\n * coordinate: numbers, number positions, and number indicators.\n *\n * @remarks\n * pure function\n */\nexport function fixDivider(original: Tokens, _format?: Format): PipeResult {\n  // if there is already a divider then there is nothing to do\n  if (original.includes(SYMBOLS.DIVIDER)) {\n    return [original, false];\n  }\n\n  // disconnect from argument memory space so we aren't working on shared memory\n  const tokens = original.slice(0);\n\n  const genomeIndex = getGenomeIndex(tokens);\n\n  if (genomeIndex) {\n    return insertDivider(tokens, genomeIndex);\n  }\n\n  const simple = simpler(tokens) as keyof typeof SIMPLER_PATTERNS;\n\n  if (SIMPLER_PATTERNS[simple]) {\n    return insertDivider(tokens, SIMPLER_PATTERNS[simple]);\n  }\n\n  // no position is found to be a safe location to insert a divider; any placement\n  // would be a guess and therefor only has a 50% chance of being wrong or right\n  return [[], true];\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;AAqBA,MAAM,mBAAmB;CACvB,IAAI;CACJ,KAAK;CACL,MAAM;CACN,KAAK;CACN;AAED,MAAM,iBAAiB,QAAgB,UAA8B,CACnE;CAAC,GAAG,OAAO,MAAM,GAAG,MAAM;CAAE,QAAQ;CAAS,GAAG,OAAO,MAAM,MAAM;CAAC,EACpE,MACD;;;;;;;;;AAUD,SAAgB,WAAW,UAAkB,SAA8B;AAEzE,KAAI,SAAS,SAAS,QAAQ,QAAQ,CACpC,QAAO,CAAC,UAAU,MAAM;CAI1B,MAAM,SAAS,SAAS,MAAM,EAAE;CAEhC,MAAM,cAAc,eAAe,OAAO;AAE1C,KAAI,YACF,QAAO,cAAc,QAAQ,YAAY;CAG3C,MAAM,SAAS,QAAQ,OAAO;AAE9B,KAAI,iBAAiB,QACnB,QAAO,cAAc,QAAQ,iBAAiB,QAAQ;AAKxD,QAAO,CAAC,EAAE,EAAE,KAAK"}
+{"version":3,"file":"fix-dividers.js","names":[],"sources":["../../../../../src/coordinates/latlon/internal/pipes/fix-dividers.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 Format, SYMBOLS } from '..';\nimport { getGenomeIndex } from './genome';\nimport { simpler } from './simpler';\nimport type { Tokens } from '../lexer';\nimport type { PipeResult } from '../pipes';\n\n// N = number\n// B = bearing\nconst SIMPLER_PATTERNS = {\n  NN: 1,\n  NNB: 1,\n  BNNB: 2,\n  BNN: 2,\n};\n\n/**\n * Inserts a divider token at the specified index in the tokens array.\n *\n * @param tokens - Array of coordinate tokens without a divider.\n * @param index - Position where the divider should be inserted.\n * @returns Pipe result with divider inserted and error=false.\n *\n * @example\n * ```typescript\n * insertDivider(['45', '30', 'N', '122', '15', 'W'], 3);\n * // [['45', '30', 'N', '/', '122', '15', 'W'], false]\n * ```\n */\nconst insertDivider = (tokens: Tokens, index: number): PipeResult => [\n  [...tokens.slice(0, index), SYMBOLS.DIVIDER, ...tokens.slice(index)],\n  false,\n];\n\n/**\n * For tokens lists without a divider, `fixDivider` attempts to determine the\n * __safe__ location to add a divider based on the existing formatting of the\n * coordinate: numbers, number positions, and number indicators.\n *\n * @param original - Array of coordinate tokens without a divider.\n * @param _format - Optional coordinate format (LATLON or LONLAT), currently unused.\n * @returns Pipe result with divider inserted, or error=true if no safe location found.\n *\n * @example\n * ```typescript\n * fixDivider(['45°', '30'', 'N', '122°', '15'', 'W']);\n * // Returns tokens with divider inserted between latitude and longitude\n * ```\n *\n * @example\n * ```typescript\n * fixDivider(['45', '30', 'N']);\n * // Returns error=true (cannot safely determine divider position)\n * ```\n *\n * @remarks\n * pure function\n */\nexport function fixDivider(original: Tokens, _format?: Format): PipeResult {\n  // if there is already a divider then there is nothing to do\n  if (original.includes(SYMBOLS.DIVIDER)) {\n    return [original, false];\n  }\n\n  // disconnect from argument memory space so we aren't working on shared memory\n  const tokens = original.slice(0);\n\n  const genomeIndex = getGenomeIndex(tokens);\n\n  if (genomeIndex) {\n    return insertDivider(tokens, genomeIndex);\n  }\n\n  const simple = simpler(tokens) as keyof typeof SIMPLER_PATTERNS;\n\n  if (SIMPLER_PATTERNS[simple]) {\n    return insertDivider(tokens, SIMPLER_PATTERNS[simple]);\n  }\n\n  // no position is found to be a safe location to insert a divider; any placement\n  // would be a guess and therefor only has a 50% chance of being wrong or right\n  return [[], true];\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;AAqBA,MAAM,mBAAmB;CACvB,IAAI;CACJ,KAAK;CACL,MAAM;CACN,KAAK;CACN;;;;;;;;;;;;;;AAeD,MAAM,iBAAiB,QAAgB,UAA8B,CACnE;CAAC,GAAG,OAAO,MAAM,GAAG,MAAM;CAAE,QAAQ;CAAS,GAAG,OAAO,MAAM,MAAM;CAAC,EACpE,MACD;;;;;;;;;;;;;;;;;;;;;;;;;AA0BD,SAAgB,WAAW,UAAkB,SAA8B;AAEzE,KAAI,SAAS,SAAS,QAAQ,QAAQ,CACpC,QAAO,CAAC,UAAU,MAAM;CAI1B,MAAM,SAAS,SAAS,MAAM,EAAE;CAEhC,MAAM,cAAc,eAAe,OAAO;AAE1C,KAAI,YACF,QAAO,cAAc,QAAQ,YAAY;CAG3C,MAAM,SAAS,QAAQ,OAAO;AAE9B,KAAI,iBAAiB,QACnB,QAAO,cAAc,QAAQ,iBAAiB,QAAQ;AAKxD,QAAO,CAAC,EAAE,EAAE,KAAK"}

package/dist/coordinates/latlon/internal/pipes/genome.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
@@ -13,9 +13,25 @@
 import { Tokens } from "../lexer.js";
 
 //#region src/coordinates/latlon/internal/pipes/genome.d.ts
+
 /**
  * Use the "genome" sequence of the token list to find the index for inserting
  * a missing divider token.
+ *
+ * @param tokens - Array of coordinate tokens to analyze.
+ * @returns Index position where divider should be inserted, or 0 if pattern doesn't match.
+ *
+ * @example
+ * ```typescript
+ * getGenomeIndex(['45°', '30'', 'N', '122°', '15'', 'W']);
+ * // 3 (insert divider after latitude components)
+ * ```
+ *
+ * @example
+ * ```typescript
+ * getGenomeIndex(['45', '30', '15']);
+ * // 0 (pattern doesn't match genome sequence)
+ * ```
  */
 declare function getGenomeIndex(tokens: Tokens): number;
 //#endregion

package/dist/coordinates/latlon/internal/pipes/genome.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
@@ -19,6 +19,16 @@ const GENOME_PATTERN = /^(B?)([DN]?[MN]?[SN]?)(B?)(?:B?)([DN]?[MN]?[SN]?)(?:B?)$
 * Get the position (index) of where to insert a divider into the token list;
 * basically, the count of numeric components (left-of-divider position) plus
 * 1 if there is a bearing identifier (left-of-divider).
+*
+* @param _full - Full regex match string (unused).
+* @param args - Regex capture groups: [bearing1, number1, bearing2, number2].
+* @returns String representation of the divider index position.
+*
+* @example
+* ```typescript
+* dividerIndexer('BDNBDNB', 'B', 'DN', 'B', 'DN');
+* // '3' (bearing + 2 numeric components)
+* ```
 */
 function dividerIndexer(_full, ...args) {
 	const [bearing1 = "", number1, bearing2 = "", number2] = args;
@@ -34,6 +44,22 @@ function dividerIndexer(_full, ...args) {
 *   - S = seconds (number with seconds character following)
 *   - N = number (no identifying character following)
 *   - X = for unmatched token types
+*
+* @param acc - Accumulated genome sequence string.
+* @param t - Current token to classify.
+* @returns Updated genome sequence with new character appended.
+*
+* @example
+* ```typescript
+* genomeSequencer('', '45°');
+* // 'D'
+* ```
+*
+* @example
+* ```typescript
+* genomeSequencer('D', 'N');
+* // 'DB'
+* ```
 */
 function genomeSequencer(acc, t) {
 	if (t.includes(SYMBOLS.DEGREES)) return `${acc}D`;
@@ -46,6 +72,21 @@ function genomeSequencer(acc, t) {
 /**
 * Use the "genome" sequence of the token list to find the index for inserting
 * a missing divider token.
+*
+* @param tokens - Array of coordinate tokens to analyze.
+* @returns Index position where divider should be inserted, or 0 if pattern doesn't match.
+*
+* @example
+* ```typescript
+* getGenomeIndex(['45°', '30'', 'N', '122°', '15'', 'W']);
+* // 3 (insert divider after latitude components)
+* ```
+*
+* @example
+* ```typescript
+* getGenomeIndex(['45', '30', '15']);
+* // 0 (pattern doesn't match genome sequence)
+* ```
 */
 function getGenomeIndex(tokens) {
 	const seq = tokens.reduce(genomeSequencer, "");

package/dist/coordinates/latlon/internal/pipes/genome.js.map

@@ -1 +1 @@
-{"version":3,"file":"genome.js","names":[],"sources":["../../../../../src/coordinates/latlon/internal/pipes/genome.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 { SYMBOL_PATTERNS, SYMBOLS } from '..';\nimport type { Tokens } from '../lexer';\n\nconst GENOME_PATTERN =\n  /^(B?)([DN]?[MN]?[SN]?)(B?)(?:B?)([DN]?[MN]?[SN]?)(?:B?)$/;\n\n/**\n * Get the position (index) of where to insert a divider into the token list;\n * basically, the count of numeric components (left-of-divider position) plus\n * 1 if there is a bearing identifier (left-of-divider).\n */\nfunction dividerIndexer(_full: string, ...args: string[]) {\n  const [bearing1 = '', number1, bearing2 = '', number2] = args;\n\n  // if no numeric values exist there no way to infer a location to insert a divider\n  if (!(number1?.length && number2?.length)) {\n    return '0';\n  }\n\n  return `${number1.length + (bearing1.length || bearing2.length)}`;\n}\n\n/**\n * The genome sequence is a simplification of the tokens list:\n *\n *   - B = bearings (NSEW)\n *   - D = degrees (number with degree character following)\n *   - M = minutes (number with minutes character following)\n *   - S = seconds (number with seconds character following)\n *   - N = number (no identifying character following)\n *   - X = for unmatched token types\n */\nfunction genomeSequencer(acc: string, t: string) {\n  if (t.includes(SYMBOLS.DEGREES)) {\n    return `${acc}D`;\n  }\n\n  if (t.includes(SYMBOLS.MINUTES)) {\n    return `${acc}M`;\n  }\n\n  if (t.includes(SYMBOLS.SECONDS)) {\n    return `${acc}S`;\n  }\n\n  if (SYMBOL_PATTERNS.NSEW.test(t)) {\n    return `${acc}B`;\n  }\n\n  if (/\\d/.test(t)) {\n    return `${acc}N`;\n  }\n\n  return `${acc}X`;\n}\n\n/**\n * Use the \"genome\" sequence of the token list to find the index for inserting\n * a missing divider token.\n */\nexport function getGenomeIndex(tokens: Tokens) {\n  const seq = tokens.reduce(genomeSequencer, '');\n\n  return GENOME_PATTERN.test(seq)\n    ? Number.parseInt(seq.replace(GENOME_PATTERN, dividerIndexer), 10)\n    : 0;\n}\n"],"mappings":";;;;;;;;;;;;;;;;AAgBA,MAAM,iBACJ;;;;;;AAOF,SAAS,eAAe,OAAe,GAAG,MAAgB;CACxD,MAAM,CAAC,WAAW,IAAI,SAAS,WAAW,IAAI,WAAW;AAGzD,KAAI,EAAE,SAAS,UAAU,SAAS,QAChC,QAAO;AAGT,QAAO,GAAG,QAAQ,UAAU,SAAS,UAAU,SAAS;;;;;;;;;;;;AAa1D,SAAS,gBAAgB,KAAa,GAAW;AAC/C,KAAI,EAAE,SAAS,QAAQ,QAAQ,CAC7B,QAAO,GAAG,IAAI;AAGhB,KAAI,EAAE,SAAS,QAAQ,QAAQ,CAC7B,QAAO,GAAG,IAAI;AAGhB,KAAI,EAAE,SAAS,QAAQ,QAAQ,CAC7B,QAAO,GAAG,IAAI;AAGhB,KAAI,gBAAgB,KAAK,KAAK,EAAE,CAC9B,QAAO,GAAG,IAAI;AAGhB,KAAI,KAAK,KAAK,EAAE,CACd,QAAO,GAAG,IAAI;AAGhB,QAAO,GAAG,IAAI;;;;;;AAOhB,SAAgB,eAAe,QAAgB;CAC7C,MAAM,MAAM,OAAO,OAAO,iBAAiB,GAAG;AAE9C,QAAO,eAAe,KAAK,IAAI,GAC3B,OAAO,SAAS,IAAI,QAAQ,gBAAgB,eAAe,EAAE,GAAG,GAChE"}
+{"version":3,"file":"genome.js","names":[],"sources":["../../../../../src/coordinates/latlon/internal/pipes/genome.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 { SYMBOL_PATTERNS, SYMBOLS } from '..';\nimport type { Tokens } from '../lexer';\n\nconst GENOME_PATTERN =\n  /^(B?)([DN]?[MN]?[SN]?)(B?)(?:B?)([DN]?[MN]?[SN]?)(?:B?)$/;\n\n/**\n * Get the position (index) of where to insert a divider into the token list;\n * basically, the count of numeric components (left-of-divider position) plus\n * 1 if there is a bearing identifier (left-of-divider).\n *\n * @param _full - Full regex match string (unused).\n * @param args - Regex capture groups: [bearing1, number1, bearing2, number2].\n * @returns String representation of the divider index position.\n *\n * @example\n * ```typescript\n * dividerIndexer('BDNBDNB', 'B', 'DN', 'B', 'DN');\n * // '3' (bearing + 2 numeric components)\n * ```\n */\nfunction dividerIndexer(_full: string, ...args: string[]) {\n  const [bearing1 = '', number1, bearing2 = '', number2] = args;\n\n  // if no numeric values exist there no way to infer a location to insert a divider\n  if (!(number1?.length && number2?.length)) {\n    return '0';\n  }\n\n  return `${number1.length + (bearing1.length || bearing2.length)}`;\n}\n\n/**\n * The genome sequence is a simplification of the tokens list:\n *\n *   - B = bearings (NSEW)\n *   - D = degrees (number with degree character following)\n *   - M = minutes (number with minutes character following)\n *   - S = seconds (number with seconds character following)\n *   - N = number (no identifying character following)\n *   - X = for unmatched token types\n *\n * @param acc - Accumulated genome sequence string.\n * @param t - Current token to classify.\n * @returns Updated genome sequence with new character appended.\n *\n * @example\n * ```typescript\n * genomeSequencer('', '45°');\n * // 'D'\n * ```\n *\n * @example\n * ```typescript\n * genomeSequencer('D', 'N');\n * // 'DB'\n * ```\n */\nfunction genomeSequencer(acc: string, t: string) {\n  if (t.includes(SYMBOLS.DEGREES)) {\n    return `${acc}D`;\n  }\n\n  if (t.includes(SYMBOLS.MINUTES)) {\n    return `${acc}M`;\n  }\n\n  if (t.includes(SYMBOLS.SECONDS)) {\n    return `${acc}S`;\n  }\n\n  if (SYMBOL_PATTERNS.NSEW.test(t)) {\n    return `${acc}B`;\n  }\n\n  if (/\\d/.test(t)) {\n    return `${acc}N`;\n  }\n\n  return `${acc}X`;\n}\n\n/**\n * Use the \"genome\" sequence of the token list to find the index for inserting\n * a missing divider token.\n *\n * @param tokens - Array of coordinate tokens to analyze.\n * @returns Index position where divider should be inserted, or 0 if pattern doesn't match.\n *\n * @example\n * ```typescript\n * getGenomeIndex(['45°', '30'', 'N', '122°', '15'', 'W']);\n * // 3 (insert divider after latitude components)\n * ```\n *\n * @example\n * ```typescript\n * getGenomeIndex(['45', '30', '15']);\n * // 0 (pattern doesn't match genome sequence)\n * ```\n */\nexport function getGenomeIndex(tokens: Tokens) {\n  const seq = tokens.reduce(genomeSequencer, '');\n\n  return GENOME_PATTERN.test(seq)\n    ? Number.parseInt(seq.replace(GENOME_PATTERN, dividerIndexer), 10)\n    : 0;\n}\n"],"mappings":";;;;;;;;;;;;;;;;AAgBA,MAAM,iBACJ;;;;;;;;;;;;;;;;AAiBF,SAAS,eAAe,OAAe,GAAG,MAAgB;CACxD,MAAM,CAAC,WAAW,IAAI,SAAS,WAAW,IAAI,WAAW;AAGzD,KAAI,EAAE,SAAS,UAAU,SAAS,QAChC,QAAO;AAGT,QAAO,GAAG,QAAQ,UAAU,SAAS,UAAU,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA6B1D,SAAS,gBAAgB,KAAa,GAAW;AAC/C,KAAI,EAAE,SAAS,QAAQ,QAAQ,CAC7B,QAAO,GAAG,IAAI;AAGhB,KAAI,EAAE,SAAS,QAAQ,QAAQ,CAC7B,QAAO,GAAG,IAAI;AAGhB,KAAI,EAAE,SAAS,QAAQ,QAAQ,CAC7B,QAAO,GAAG,IAAI;AAGhB,KAAI,gBAAgB,KAAK,KAAK,EAAE,CAC9B,QAAO,GAAG,IAAI;AAGhB,KAAI,KAAK,KAAK,EAAE,CACd,QAAO,GAAG,IAAI;AAGhB,QAAO,GAAG,IAAI;;;;;;;;;;;;;;;;;;;;;AAsBhB,SAAgB,eAAe,QAAgB;CAC7C,MAAM,MAAM,OAAO,OAAO,iBAAiB,GAAG;AAE9C,QAAO,eAAe,KAAK,IAAI,GAC3B,OAAO,SAAS,IAAI,QAAQ,gBAAgB,eAAe,EAAE,GAAG,GAChE"}

package/dist/coordinates/latlon/internal/pipes/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
@@ -20,7 +20,21 @@ type PipeResult = ReturnType<Pipe>;
  * Consistently create a PipesResult array to return. Use this instead of
  * casting to PipesResult everywhere.
  *
- * @param e true = has error, false = no error
+ * @param t - Array of coordinate tokens.
+ * @param e - Error status: true = has error, false = no error, or error message string.
+ * @returns Pipe result tuple with tokens (empty if error) and error status.
+ *
+ * @example
+ * ```typescript
+ * pipesResult(['45', 'N', '/', '122', 'W'], false);
+ * // [['45', 'N', '/', '122', 'W'], false]
+ * ```
+ *
+ * @example
+ * ```typescript
+ * pipesResult(['45'], 'Too few numbers.');
+ * // [[], 'Too few numbers.']
+ * ```
  *
  * @remarks
  * pure function
@@ -30,7 +44,23 @@ declare const pipesResult: (t: Tokens, e: boolean | string) => PipeResult;
  * Run the tokens through a preset pipeline of violations checks exiting the
  * process as early as possible when violations are found because violations
  * will make further violations checks less accurate and could return inaccurate
- * violations that could be misleading or hide the most important violation
+ * violations that could be misleading or hide the most important violation.
+ *
+ * @param tokens - Array of parsed coordinate tokens to validate and normalize.
+ * @param format - Optional coordinate format (LATLON or LONLAT) for inference.
+ * @returns Tuple of [processed tokens, array of error messages].
+ *
+ * @example
+ * ```typescript
+ * pipesRunner(['45', 'N', '/', '122', 'W'], 'LATLON');
+ * // [['45', 'N', '/', '122', 'W'], []]
+ * ```
+ *
+ * @example
+ * ```typescript
+ * pipesRunner(['45'], 'LATLON');
+ * // [[], ['Too few numbers.']]
+ * ```
  */
 declare function pipesRunner(tokens: Tokens, format?: Format): [Tokens, string[]];
 //#endregion

package/dist/coordinates/latlon/internal/pipes/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
@@ -18,19 +18,56 @@ import { fixBearings } from "./fix-bearings.js";
 import { fixDivider } from "./fix-dividers.js";
 
 //#region src/coordinates/latlon/internal/pipes/index.ts
-/** Make a RegExp global. */
+/**
+* Make a RegExp global.
+*
+* @param k - Key of the SYMBOL_PATTERNS object.
+* @returns New global RegExp based on the pattern.
+*
+* @example
+* ```typescript
+* makeGlobal('NSEW');
+* // /[NSEW]/g
+* ```
+*/
 const makeGlobal = (k) => new RegExp(SYMBOL_PATTERNS[k], "g");
 /**
 * Consistently create a PipesResult array to return. Use this instead of
 * casting to PipesResult everywhere.
 *
-* @param e true = has error, false = no error
+* @param t - Array of coordinate tokens.
+* @param e - Error status: true = has error, false = no error, or error message string.
+* @returns Pipe result tuple with tokens (empty if error) and error status.
+*
+* @example
+* ```typescript
+* pipesResult(['45', 'N', '/', '122', 'W'], false);
+* // [['45', 'N', '/', '122', 'W'], false]
+* ```
+*
+* @example
+* ```typescript
+* pipesResult(['45'], 'Too few numbers.');
+* // [[], 'Too few numbers.']
+* ```
 *
 * @remarks
 * pure function
 */
 const pipesResult = (t, e) => [e ? [] : t, e];
-/** Check if there are more than 2 of something. */
+/**
+* Check if there are more than 2 of something.
+*
+* @param p - Regular expression pattern to match.
+* @returns Function that takes tokens and returns pipe result with error if >2 matches found.
+*
+* @example
+* ```typescript
+* const checkBearings = tooMany(/[NSEW]/g);
+* checkBearings(['N', 'S', 'E', 'W']);
+* // Returns error=true (more than 2 bearings)
+* ```
+*/
 const tooMany = (p) => (t) => pipesResult(t, (t.join("").match(p) ?? []).length > 2);
 const pipes = [
 	["Too many bearings.", tooMany(makeGlobal("NSEW"))],
@@ -47,7 +84,23 @@ const pipes = [
 * Run the tokens through a preset pipeline of violations checks exiting the
 * process as early as possible when violations are found because violations
 * will make further violations checks less accurate and could return inaccurate
-* violations that could be misleading or hide the most important violation
+* violations that could be misleading or hide the most important violation.
+*
+* @param tokens - Array of parsed coordinate tokens to validate and normalize.
+* @param format - Optional coordinate format (LATLON or LONLAT) for inference.
+* @returns Tuple of [processed tokens, array of error messages].
+*
+* @example
+* ```typescript
+* pipesRunner(['45', 'N', '/', '122', 'W'], 'LATLON');
+* // [['45', 'N', '/', '122', 'W'], []]
+* ```
+*
+* @example
+* ```typescript
+* pipesRunner(['45'], 'LATLON');
+* // [[], ['Too few numbers.']]
+* ```
 */
 function pipesRunner(tokens, format) {
 	let copy = tokens.slice(0);

package/dist/coordinates/latlon/internal/pipes/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":["pipes: [string, Pipe][]","error: PipeResult[1]"],"sources":["../../../../../src/coordinates/latlon/internal/pipes/index.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 Format, SYMBOL_PATTERNS } from '..';\nimport { checkAmbiguousGrouping } from './check-ambiguous';\nimport { checkNumberValues } from './check-numbers';\nimport { fixBearings } from './fix-bearings';\nimport { fixDivider } from './fix-dividers';\nimport type { Tokens } from '../lexer';\n\ntype Pipe = (t: Tokens, f?: Format) => [Tokens, boolean | string];\n\nexport type PipeResult = ReturnType<Pipe>;\n\n/** Make a RegExp global. */\nconst makeGlobal = (k: keyof typeof SYMBOL_PATTERNS) =>\n  new RegExp(SYMBOL_PATTERNS[k], 'g');\n\n/**\n * Consistently create a PipesResult array to return. Use this instead of\n * casting to PipesResult everywhere.\n *\n * @param e true = has error, false = no error\n *\n * @remarks\n * pure function\n */\nexport const pipesResult = (t: Tokens, e: boolean | string): PipeResult => [\n  // if there are errors do NOT return the tokens\n  e ? [] : t,\n  e,\n];\n\n/** Check if there are more than 2 of something. */\nconst tooMany = (p: RegExp) => (t: Tokens) =>\n  pipesResult(t, (t.join('').match(p) ?? []).length > 2);\n\nconst pipes: [string, Pipe][] = [\n  // Unrecoverable violations\n  ['Too many bearings.', tooMany(makeGlobal('NSEW'))],\n  ['Too many numeric signs.', tooMany(/[-+]/g)],\n  ['Too many degrees indicators.', tooMany(makeGlobal('DEGREES'))],\n  ['Too many minutes indicators.', tooMany(makeGlobal('MINUTES'))],\n  ['Too many seconds indicators.', tooMany(makeGlobal('SECONDS'))],\n  ['Number values checks.', checkNumberValues],\n  ['Ambiguous grouping of numbers with no divider.', checkAmbiguousGrouping],\n\n  // fix values and formatting to be consistent\n  ['Unable to identify latitude from longitude.', fixDivider],\n  ['Unable to identify bearings.', fixBearings],\n];\n\n/**\n * Run the tokens through a preset pipeline of violations checks exiting the\n * process as early as possible when violations are found because violations\n * will make further violations checks less accurate and could return inaccurate\n * violations that could be misleading or hide the most important violation\n */\nexport function pipesRunner(\n  tokens: Tokens,\n  format?: Format,\n): [Tokens, string[]] {\n  let copy = tokens.slice(0);\n  let error: PipeResult[1] = false;\n  const errors = [] as string[];\n\n  for (const [message, op] of pipes) {\n    [copy, error] = op(copy, format);\n\n    if (error) {\n      // accumulate the \"errors\" because if tokens are returned\n      // the errors are only warnings and are recoverable\n      errors.push(error === true ? message : error);\n\n      if (!copy.length) {\n        return [copy, [error === true ? message : error]];\n      }\n    }\n  }\n\n  return [copy, errors];\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;AAyBA,MAAM,cAAc,MAClB,IAAI,OAAO,gBAAgB,IAAI,IAAI;;;;;;;;;;AAWrC,MAAa,eAAe,GAAW,MAAoC,CAEzE,IAAI,EAAE,GAAG,GACT,EACD;;AAGD,MAAM,WAAW,OAAe,MAC9B,YAAY,IAAI,EAAE,KAAK,GAAG,CAAC,MAAM,EAAE,IAAI,EAAE,EAAE,SAAS,EAAE;AAExD,MAAMA,QAA0B;CAE9B,CAAC,sBAAsB,QAAQ,WAAW,OAAO,CAAC,CAAC;CACnD,CAAC,2BAA2B,QAAQ,QAAQ,CAAC;CAC7C,CAAC,gCAAgC,QAAQ,WAAW,UAAU,CAAC,CAAC;CAChE,CAAC,gCAAgC,QAAQ,WAAW,UAAU,CAAC,CAAC;CAChE,CAAC,gCAAgC,QAAQ,WAAW,UAAU,CAAC,CAAC;CAChE,CAAC,yBAAyB,kBAAkB;CAC5C,CAAC,kDAAkD,uBAAuB;CAG1E,CAAC,+CAA+C,WAAW;CAC3D,CAAC,gCAAgC,YAAY;CAC9C;;;;;;;AAQD,SAAgB,YACd,QACA,QACoB;CACpB,IAAI,OAAO,OAAO,MAAM,EAAE;CAC1B,IAAIC,QAAuB;CAC3B,MAAM,SAAS,EAAE;AAEjB,MAAK,MAAM,CAAC,SAAS,OAAO,OAAO;AACjC,GAAC,MAAM,SAAS,GAAG,MAAM,OAAO;AAEhC,MAAI,OAAO;AAGT,UAAO,KAAK,UAAU,OAAO,UAAU,MAAM;AAE7C,OAAI,CAAC,KAAK,OACR,QAAO,CAAC,MAAM,CAAC,UAAU,OAAO,UAAU,MAAM,CAAC;;;AAKvD,QAAO,CAAC,MAAM,OAAO"}
+{"version":3,"file":"index.js","names":["pipes: [string, Pipe][]","error: PipeResult[1]"],"sources":["../../../../../src/coordinates/latlon/internal/pipes/index.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 Format, SYMBOL_PATTERNS } from '..';\nimport { checkAmbiguousGrouping } from './check-ambiguous';\nimport { checkNumberValues } from './check-numbers';\nimport { fixBearings } from './fix-bearings';\nimport { fixDivider } from './fix-dividers';\nimport type { Tokens } from '../lexer';\n\ntype Pipe = (t: Tokens, f?: Format) => [Tokens, boolean | string];\n\nexport type PipeResult = ReturnType<Pipe>;\n\n/**\n * Make a RegExp global.\n *\n * @param k - Key of the SYMBOL_PATTERNS object.\n * @returns New global RegExp based on the pattern.\n *\n * @example\n * ```typescript\n * makeGlobal('NSEW');\n * // /[NSEW]/g\n * ```\n */\nconst makeGlobal = (k: keyof typeof SYMBOL_PATTERNS) =>\n  new RegExp(SYMBOL_PATTERNS[k], 'g');\n\n/**\n * Consistently create a PipesResult array to return. Use this instead of\n * casting to PipesResult everywhere.\n *\n * @param t - Array of coordinate tokens.\n * @param e - Error status: true = has error, false = no error, or error message string.\n * @returns Pipe result tuple with tokens (empty if error) and error status.\n *\n * @example\n * ```typescript\n * pipesResult(['45', 'N', '/', '122', 'W'], false);\n * // [['45', 'N', '/', '122', 'W'], false]\n * ```\n *\n * @example\n * ```typescript\n * pipesResult(['45'], 'Too few numbers.');\n * // [[], 'Too few numbers.']\n * ```\n *\n * @remarks\n * pure function\n */\nexport const pipesResult = (t: Tokens, e: boolean | string): PipeResult => [\n  // if there are errors do NOT return the tokens\n  e ? [] : t,\n  e,\n];\n\n/**\n * Check if there are more than 2 of something.\n *\n * @param p - Regular expression pattern to match.\n * @returns Function that takes tokens and returns pipe result with error if >2 matches found.\n *\n * @example\n * ```typescript\n * const checkBearings = tooMany(/[NSEW]/g);\n * checkBearings(['N', 'S', 'E', 'W']);\n * // Returns error=true (more than 2 bearings)\n * ```\n */\nconst tooMany = (p: RegExp) => (t: Tokens) =>\n  pipesResult(t, (t.join('').match(p) ?? []).length > 2);\n\nconst pipes: [string, Pipe][] = [\n  // Unrecoverable violations\n  ['Too many bearings.', tooMany(makeGlobal('NSEW'))],\n  ['Too many numeric signs.', tooMany(/[-+]/g)],\n  ['Too many degrees indicators.', tooMany(makeGlobal('DEGREES'))],\n  ['Too many minutes indicators.', tooMany(makeGlobal('MINUTES'))],\n  ['Too many seconds indicators.', tooMany(makeGlobal('SECONDS'))],\n  ['Number values checks.', checkNumberValues],\n  ['Ambiguous grouping of numbers with no divider.', checkAmbiguousGrouping],\n\n  // fix values and formatting to be consistent\n  ['Unable to identify latitude from longitude.', fixDivider],\n  ['Unable to identify bearings.', fixBearings],\n];\n\n/**\n * Run the tokens through a preset pipeline of violations checks exiting the\n * process as early as possible when violations are found because violations\n * will make further violations checks less accurate and could return inaccurate\n * violations that could be misleading or hide the most important violation.\n *\n * @param tokens - Array of parsed coordinate tokens to validate and normalize.\n * @param format - Optional coordinate format (LATLON or LONLAT) for inference.\n * @returns Tuple of [processed tokens, array of error messages].\n *\n * @example\n * ```typescript\n * pipesRunner(['45', 'N', '/', '122', 'W'], 'LATLON');\n * // [['45', 'N', '/', '122', 'W'], []]\n * ```\n *\n * @example\n * ```typescript\n * pipesRunner(['45'], 'LATLON');\n * // [[], ['Too few numbers.']]\n * ```\n */\nexport function pipesRunner(\n  tokens: Tokens,\n  format?: Format,\n): [Tokens, string[]] {\n  let copy = tokens.slice(0);\n  let error: PipeResult[1] = false;\n  const errors = [] as string[];\n\n  for (const [message, op] of pipes) {\n    [copy, error] = op(copy, format);\n\n    if (error) {\n      // accumulate the \"errors\" because if tokens are returned\n      // the errors are only warnings and are recoverable\n      errors.push(error === true ? message : error);\n\n      if (!copy.length) {\n        return [copy, [error === true ? message : error]];\n      }\n    }\n  }\n\n  return [copy, errors];\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAoCA,MAAM,cAAc,MAClB,IAAI,OAAO,gBAAgB,IAAI,IAAI;;;;;;;;;;;;;;;;;;;;;;;;AAyBrC,MAAa,eAAe,GAAW,MAAoC,CAEzE,IAAI,EAAE,GAAG,GACT,EACD;;;;;;;;;;;;;;AAeD,MAAM,WAAW,OAAe,MAC9B,YAAY,IAAI,EAAE,KAAK,GAAG,CAAC,MAAM,EAAE,IAAI,EAAE,EAAE,SAAS,EAAE;AAExD,MAAMA,QAA0B;CAE9B,CAAC,sBAAsB,QAAQ,WAAW,OAAO,CAAC,CAAC;CACnD,CAAC,2BAA2B,QAAQ,QAAQ,CAAC;CAC7C,CAAC,gCAAgC,QAAQ,WAAW,UAAU,CAAC,CAAC;CAChE,CAAC,gCAAgC,QAAQ,WAAW,UAAU,CAAC,CAAC;CAChE,CAAC,gCAAgC,QAAQ,WAAW,UAAU,CAAC,CAAC;CAChE,CAAC,yBAAyB,kBAAkB;CAC5C,CAAC,kDAAkD,uBAAuB;CAG1E,CAAC,+CAA+C,WAAW;CAC3D,CAAC,gCAAgC,YAAY;CAC9C;;;;;;;;;;;;;;;;;;;;;;;AAwBD,SAAgB,YACd,QACA,QACoB;CACpB,IAAI,OAAO,OAAO,MAAM,EAAE;CAC1B,IAAIC,QAAuB;CAC3B,MAAM,SAAS,EAAE;AAEjB,MAAK,MAAM,CAAC,SAAS,OAAO,OAAO;AACjC,GAAC,MAAM,SAAS,GAAG,MAAM,OAAO;AAEhC,MAAI,OAAO;AAGT,UAAO,KAAK,UAAU,OAAO,UAAU,MAAM;AAE7C,OAAI,CAAC,KAAK,OACR,QAAO,CAAC,MAAM,CAAC,UAAU,OAAO,UAAU,MAAM,CAAC;;;AAKvD,QAAO,CAAC,MAAM,OAAO"}