@accelint/geo 0.1.2 → 0.2.0

package/dist/coordinates/latlon/internal/parse.d.ts

@@ -0,0 +1,41 @@
+import { Errors, Format } from './index.js';
+import { Tokens } from './lexer.js';
+
+type ParseResults = [Tokens, Errors];
+/**
+ * Parse a raw input string into a validated and normalized coordinate
+ * primitive ready for further refinement/validation by a more specific parser.
+ *
+ * @param input
+ * raw input, from a user or external system, of unknown validity
+ *
+ * @param format
+ * the expected format - LATLON or LONLAT - the coordinate should conform to
+ *
+ * @returns
+ * tuple with two values: tokens, and errors
+ *
+ * @remarks
+ * pure function
+ *
+ * @example
+ * const input = '1 2 3 / 4 5 6'
+ * parse(input); // [['1', '2', '3', '/', '4', '5', '6'], []]
+ *
+ * @description
+ * __Assumptions/Specification__
+ * 1. Decimals are indicated by a "." and not ","
+ * 2. A degrees indicator is "°"
+ * 3. A minutes indicator is "'"
+ * 4. A seconds indicator is '"'
+ * 5. Each indicator is expected to follow the number it is annotating
+ * 6. Numeric parts - degrees, minutes, and seconds - are positional and can
+ *    not be arranged in alternative orders and be considered valid
+ * 7. Output will have explicit bearings characters (NSEW) and not rely on
+ *    positive and negative values; when bearings are available. Negative
+ *    values will only be replaced with absolute values if bearings are available.
+ *
+ */
+declare function parse(input: string, format?: Format): ParseResults;
+
+export { type ParseResults, parse };

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

@@ -0,0 +1,16 @@
+import { lexer } from './lexer.js';
+import { pipesRunner } from './pipes/index.js';
+import { violation } from './violation.js';
+
+// src/coordinates/latlon/internal/parse.ts
+function parse(input, format) {
+  if (!input?.length) {
+    return [[], [violation("No input.")]];
+  }
+  const [tokens, errors] = pipesRunner(lexer(input), format);
+  return [tokens, errors?.length ? errors.map(violation) : []];
+}
+
+export { parse };
+//# sourceMappingURL=parse.js.map
+//# sourceMappingURL=parse.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/coordinates/latlon/internal/parse.ts"],"names":[],"mappings":";;;;;AAsDO,SAAS,KAAA,CAAM,OAAe,MAA+B,EAAA;AAClE,EAAI,IAAA,CAAC,OAAO,MAAQ,EAAA;AAClB,IAAA,OAAO,CAAC,EAAC,EAAG,CAAC,SAAU,CAAA,WAAW,CAAC,CAAC,CAAA;AAAA;AAGtC,EAAM,MAAA,CAAC,QAAQ,MAAM,CAAA,GAAI,YAAY,KAAM,CAAA,KAAK,GAAG,MAAM,CAAA;AAEzD,EAAO,OAAA,CAAC,QAAQ,MAAQ,EAAA,MAAA,GAAS,OAAO,GAAI,CAAA,SAAS,CAAI,GAAA,EAAE,CAAA;AAC7D","file":"parse.js","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 { Errors, Format } from '.';\nimport { type Tokens, lexer } from './lexer';\nimport { pipesRunner } from './pipes';\nimport { violation } from './violation';\n\nexport type ParseResults = [Tokens, Errors];\n\n/**\n * Parse a raw input string into a validated and normalized coordinate\n * primitive ready for further refinement/validation by a more specific parser.\n *\n * @param input\n * raw input, from a user or external system, of unknown validity\n *\n * @param format\n * the expected format - LATLON or LONLAT - the coordinate should conform to\n *\n * @returns\n * tuple with two values: tokens, and errors\n *\n * @remarks\n * pure function\n *\n * @example\n * const input = '1 2 3 / 4 5 6'\n * parse(input); // [['1', '2', '3', '/', '4', '5', '6'], []]\n *\n * @description\n * __Assumptions/Specification__\n * 1. Decimals are indicated by a \".\" and not \",\"\n * 2. A degrees indicator is \"°\"\n * 3. A minutes indicator is \"'\"\n * 4. A seconds indicator is '\"'\n * 5. Each indicator is expected to follow the number it is annotating\n * 6. Numeric parts - degrees, minutes, and seconds - are positional and can\n *    not be arranged in alternative orders and be considered valid\n * 7. Output will have explicit bearings characters (NSEW) and not rely on\n *    positive and negative values; when bearings are available. Negative\n *    values will only be replaced with absolute values if bearings are available.\n *\n */\nexport function parse(input: string, format?: Format): ParseResults {\n  if (!input?.length) {\n    return [[], [violation('No input.')]];\n  }\n\n  const [tokens, errors] = pipesRunner(lexer(input), format);\n\n  return [tokens, errors?.length ? errors.map(violation) : []];\n}\n"]}

package/dist/coordinates/latlon/internal/pipes/check-ambiguous.d.ts

@@ -0,0 +1,10 @@
+import { Format } from '../index.js';
+import { Tokens } from '../lexer.js';
+
+/**
+ * Look for groupings of numbers that are ambiguous; no indicators, or no
+ * dividers and not possibility of deducing where a divider should be inserted.
+ */
+declare function checkAmbiguousGrouping(tokens: Tokens, _format?: Format): [string[], string | boolean];
+
+export { checkAmbiguousGrouping };

package/dist/coordinates/latlon/internal/pipes/check-ambiguous.js

@@ -0,0 +1,23 @@
+import { SYMBOLS, SYMBOL_PATTERNS } from '../index.js';
+import { pipesResult } from '../pipes/index.js';
+import { simpler } from './simpler.js';
+
+// src/coordinates/latlon/internal/pipes/check-ambiguous.ts
+function checkAmbiguousGrouping(tokens, _format) {
+  if (tokens.includes(SYMBOLS.DIVIDER)) {
+    return pipesResult(tokens, false);
+  }
+  const simple = simpler(tokens);
+  const ambiguous = /^(?:(?:BN{3,5})|(?:N{3,5}B))$/.test(simple);
+  const bookends = /^BN{3,5}B$/.test(simple);
+  const helpful = tokens.slice(1, -1).reduce((acc, t) => {
+    const helps = t.includes(SYMBOLS.DEGREES) || t.includes(SYMBOLS.SECONDS) || SYMBOL_PATTERNS.NSEW.test(t);
+    return `${acc}${helps ? "H" : "_"}`;
+  }, "").includes("H");
+  const hopeless = /^N{3,5}$/.test(simple) && !helpful;
+  return pipesResult(tokens, ambiguous || bookends || hopeless);
+}
+
+export { checkAmbiguousGrouping };
+//# sourceMappingURL=check-ambiguous.js.map
+//# sourceMappingURL=check-ambiguous.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../src/coordinates/latlon/internal/pipes/check-ambiguous.ts"],"names":[],"mappings":";;;;;AAuBO,SAAS,sBAAA,CAAuB,QAAgB,OAAkB,EAAA;AACvE,EAAA,IAAI,MAAO,CAAA,QAAA,CAAS,OAAQ,CAAA,OAAO,CAAG,EAAA;AACpC,IAAO,OAAA,WAAA,CAAY,QAAQ,KAAK,CAAA;AAAA;AAGlC,EAAM,MAAA,MAAA,GAAS,QAAQ,MAAM,CAAA;AAG7B,EAAM,MAAA,SAAA,GAAY,+BAAgC,CAAA,IAAA,CAAK,MAAM,CAAA;AAE7D,EAAM,MAAA,QAAA,GAAW,YAAa,CAAA,IAAA,CAAK,MAAM,CAAA;AAMzC,EAAM,MAAA,OAAA,GAAU,OAGb,KAAM,CAAA,CAAA,EAAG,EAAE,CACX,CAAA,MAAA,CAAO,CAAC,GAAA,EAAK,CAAM,KAAA;AAClB,IAAA,MAAM,KACJ,GAAA,CAAA,CAAE,QAAS,CAAA,OAAA,CAAQ,OAAO,CAC1B,IAAA,CAAA,CAAE,QAAS,CAAA,OAAA,CAAQ,OAAO,CAAA,IAC1B,eAAgB,CAAA,IAAA,CAAK,KAAK,CAAC,CAAA;AAE7B,IAAA,OAAO,CAAG,EAAA,GAAG,CAAG,EAAA,KAAA,GAAQ,MAAM,GAAG,CAAA,CAAA;AAAA,GAChC,EAAA,EAAE,CACJ,CAAA,QAAA,CAAS,GAAG,CAAA;AAEf,EAAA,MAAM,QAAW,GAAA,UAAA,CAAW,IAAK,CAAA,MAAM,KAAK,CAAC,OAAA;AAE7C,EAAA,OAAO,WAAY,CAAA,MAAA,EAAQ,SAAa,IAAA,QAAA,IAAY,QAAQ,CAAA;AAC9D","file":"check-ambiguous.js","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, SYMBOL_PATTERNS } from '..';\nimport type { Tokens } from '../lexer';\nimport { pipesResult } from '../pipes';\n\nimport { simpler } from './simpler';\n\n/**\n * Look for groupings of numbers that are ambiguous; no indicators, or no\n * dividers and not possibility of deducing where a divider should be inserted.\n */\nexport function checkAmbiguousGrouping(tokens: Tokens, _format?: Format) {\n  if (tokens.includes(SYMBOLS.DIVIDER)) {\n    return pipesResult(tokens, false);\n  }\n\n  const simple = simpler(tokens);\n\n  // 3-5 numbers after or before a single bearing indicator BNNN, NNNB\n  const ambiguous = /^(?:(?:BN{3,5})|(?:N{3,5}B))$/.test(simple);\n  // 3-5 numbers between 2 bearings indicators BNNNB\n  const bookends = /^BN{3,5}B$/.test(simple);\n  // \"helpful\" indicators:\n  //   1. degrees number in the right-of-divider position e.g. # #°\n  //   2. seconds number in the left-of-divider position e.g. # #\" #\n  //   3. trailing bearings in the left-of-divider position e.g. # N #\n  //   4. leading bearings in the right-of-divider position e.g. N # E #\n  const helpful = tokens\n    // helpful tokens are only helpful in the middle of the token list\n    // not the beginning or end of the list\n    .slice(1, -1)\n    .reduce((acc, t) => {\n      const helps =\n        t.includes(SYMBOLS.DEGREES) ||\n        t.includes(SYMBOLS.SECONDS) ||\n        SYMBOL_PATTERNS.NSEW.test(t);\n\n      return `${acc}${helps ? 'H' : '_'}`;\n    }, '')\n    .includes('H');\n  // 3-5 numbers with no bearings indicators, and no helpful indicators\n  const hopeless = /^N{3,5}$/.test(simple) && !helpful;\n\n  return pipesResult(tokens, ambiguous || bookends || hopeless);\n}\n"]}

package/dist/coordinates/latlon/internal/pipes/check-numbers.d.ts

@@ -0,0 +1,8 @@
+import { Tokens } from '../lexer.js';
+
+/**
+ * Check for problems in the numeric values.
+ */
+declare function checkNumberValues(tokens: Tokens): [string[], string | boolean];
+
+export { checkNumberValues };

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

@@ -0,0 +1,35 @@
+import { pipesResult } from '../pipes/index.js';
+import { simpler } from './simpler.js';
+
+// src/coordinates/latlon/internal/pipes/check-numbers.ts
+function checkNumberValues(tokens) {
+  const simple = simpler(tokens);
+  if ((simple.match(/N/g) ?? []).length < 2) {
+    return pipesResult(tokens, "Too few numbers.");
+  }
+  const error = (
+    // 4 consecutive numbers in specific formation is not going to be valid
+    /(?:N{4,}BN+)|(?:N+BN{4,})/.test(simple) || // more than 6 numbers total
+    (simple.match(/N/g) ?? []).length > 6
+  );
+  if (error) {
+    return pipesResult(tokens, "Too many numbers.");
+  }
+  const pattern = tokens.reduce((acc, t) => {
+    if (/\d/.test(t)) {
+      acc.push(Number.parseFloat(t) < 0 ? "-" : "+");
+    } else {
+      acc.push("_");
+    }
+    return acc;
+  }, []).join("");
+  const matches = pattern.match(/[^_]-./);
+  if (!!matches && pattern !== "_--_") {
+    return pipesResult(tokens, "Negative value for non-degrees value found.");
+  }
+  return pipesResult(tokens, false);
+}
+
+export { checkNumberValues };
+//# sourceMappingURL=check-numbers.js.map
+//# sourceMappingURL=check-numbers.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../src/coordinates/latlon/internal/pipes/check-numbers.ts"],"names":[],"mappings":";;;;AAqBO,SAAS,kBAAkB,MAAgB,EAAA;AAChD,EAAM,MAAA,MAAA,GAAS,QAAQ,MAAM,CAAA;AAE7B,EAAA,IAAA,CAAK,OAAO,KAAM,CAAA,IAAI,KAAK,EAAC,EAAG,SAAS,CAAG,EAAA;AACzC,IAAO,OAAA,WAAA,CAAY,QAAQ,kBAAkB,CAAA;AAAA;AAG/C,EAAM,MAAA,KAAA;AAAA;AAAA,IAEJ,2BAAA,CAA4B,KAAK,MAAM,CAAA;AAAA,IAAA,CAEtC,OAAO,KAAM,CAAA,IAAI,CAAK,IAAA,IAAI,MAAS,GAAA;AAAA,GAAA;AAEtC,EAAA,IAAI,KAAO,EAAA;AACT,IAAO,OAAA,WAAA,CAAY,QAAQ,mBAAmB,CAAA;AAAA;AAGhD,EAAA,MAAM,OAAU,GAAA,MAAA,CACb,MAAO,CAAA,CAAC,KAAK,CAAM,KAAA;AAClB,IAAI,IAAA,IAAA,CAAK,IAAK,CAAA,CAAC,CAAG,EAAA;AAChB,MAAA,GAAA,CAAI,KAAK,MAAO,CAAA,UAAA,CAAW,CAAC,CAAI,GAAA,CAAA,GAAI,MAAM,GAAG,CAAA;AAAA,KACxC,MAAA;AACL,MAAA,GAAA,CAAI,KAAK,GAAG,CAAA;AAAA;AAGd,IAAO,OAAA,GAAA;AAAA,GACN,EAAA,EAAc,CAAA,CAChB,KAAK,EAAE,CAAA;AAEV,EAAM,MAAA,OAAA,GAAU,OAAQ,CAAA,KAAA,CAAM,QAAQ,CAAA;AAItC,EAAA,IAAI,CAAC,CAAC,OAAW,IAAA,OAAA,KAAY,MAAQ,EAAA;AACnC,IAAO,OAAA,WAAA,CAAY,QAAQ,6CAA6C,CAAA;AAAA;AAG1E,EAAO,OAAA,WAAA,CAAY,QAAQ,KAAK,CAAA;AAClC","file":"check-numbers.js","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 { Tokens } from '../lexer';\nimport { pipesResult } from '../pipes';\n\nimport { simpler } from './simpler';\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"]}

package/dist/coordinates/latlon/internal/pipes/fix-bearings.d.ts

@@ -0,0 +1,12 @@
+import { Format } from '../index.js';
+import { Tokens } from '../lexer.js';
+import { PipeResult } from './index.js';
+
+/**
+ * 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.
+ */
+declare function fixBearings(tokens: Tokens, format?: Format): PipeResult;
+
+export { fixBearings };

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

@@ -0,0 +1,68 @@
+import { BEARINGS, SYMBOLS, SYMBOL_PATTERNS } from '../index.js';
+
+// src/coordinates/latlon/internal/pipes/fix-bearings.ts
+var orthogonal = {
+  N: BEARINGS.LON,
+  S: BEARINGS.LON,
+  E: BEARINGS.LAT,
+  W: BEARINGS.LAT
+};
+var bearingConflictsWithNumber = (tokens) => tokens[0] && tokens[1] && SYMBOL_PATTERNS.NEGATIVE_SIGN.test(tokens[1]) && SYMBOL_PATTERNS.NSEW.test(tokens[0]) && !SYMBOL_PATTERNS.NEGATIVE_BEARINGS.test(tokens[0]);
+var bePositive = (n) => n.replace(SYMBOL_PATTERNS.NEGATIVE_SIGN, "");
+var conflict = ([a, b]) => `Bearing (${a}) conflicts with negative number (${b}).`;
+function fixBearings(tokens, format) {
+  const [left, right] = [
+    tokens.slice(0, tokens.indexOf(SYMBOLS.DIVIDER)),
+    tokens.slice(1 + tokens.indexOf(SYMBOLS.DIVIDER))
+  ].map(moveBearingsToHead);
+  if (bearingConflictsWithNumber(left)) {
+    return [[], conflict(left)];
+  }
+  if (bearingConflictsWithNumber(right)) {
+    return [[], conflict(right)];
+  }
+  const [leftHasBearing, rightHasBearing] = [left, right].map(
+    (list) => !!(list?.[0] && SYMBOL_PATTERNS.NSEW.test(list[0]))
+  );
+  let leftBearing = "";
+  let rightBearing = "";
+  if (leftHasBearing && rightHasBearing) {
+    leftBearing = left.shift() ?? "";
+    rightBearing = right.shift() ?? "";
+  } else if (leftHasBearing) {
+    leftBearing = left.shift() ?? "";
+    rightBearing = orthogonal[leftBearing][+SYMBOL_PATTERNS.NEGATIVE_SIGN.test(right[0] ?? "")];
+  } else if (rightHasBearing) {
+    rightBearing = right.shift() ?? "";
+    leftBearing = orthogonal[rightBearing][+SYMBOL_PATTERNS.NEGATIVE_SIGN.test(right[0] ?? "")];
+  } else if (format) {
+    leftBearing = `${BEARINGS[format][0][+SYMBOL_PATTERNS.NEGATIVE_SIGN.test(`${left[0]}`)]}`;
+    rightBearing = `${BEARINGS[format][1][+SYMBOL_PATTERNS.NEGATIVE_SIGN.test(`${right[0]}`)]}`;
+  } else {
+    return [[...left, SYMBOLS.DIVIDER, ...right], false];
+  }
+  return [
+    [
+      ...left.map(bePositive),
+      leftBearing,
+      SYMBOLS.DIVIDER,
+      ...right.map(bePositive),
+      rightBearing
+    ],
+    false
+  ];
+}
+function moveBearingsToHead(coord) {
+  return coord.reduce((acc, t) => {
+    if (/\d/.test(t)) {
+      acc.push(t);
+    } else {
+      acc.unshift(t);
+    }
+    return acc;
+  }, []);
+}
+
+export { fixBearings };
+//# sourceMappingURL=fix-bearings.js.map
+//# sourceMappingURL=fix-bearings.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../src/coordinates/latlon/internal/pipes/fix-bearings.ts"],"names":[],"mappings":"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","file":"fix-bearings.js","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, SYMBOLS, SYMBOL_PATTERNS } 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"]}

package/dist/coordinates/latlon/internal/pipes/fix-dividers.d.ts

@@ -0,0 +1,15 @@
+import { Format } from '../index.js';
+import { Tokens } from '../lexer.js';
+import { PipeResult } from './index.js';
+
+/**
+ * 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.
+ *
+ * @remarks
+ * pure function
+ */
+declare function fixDivider(original: Tokens, _format?: Format): PipeResult;
+
+export { fixDivider };

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

@@ -0,0 +1,34 @@
+import { SYMBOLS } from '../index.js';
+import { getGenomeIndex } from './genome.js';
+import { simpler } from './simpler.js';
+
+// src/coordinates/latlon/internal/pipes/fix-dividers.ts
+var SIMPLER_PATTERNS = {
+  NN: 1,
+  NNB: 1,
+  BNNB: 2,
+  BNN: 2
+};
+var insertDivider = (tokens, index) => [
+  [...tokens.slice(0, index), SYMBOLS.DIVIDER, ...tokens.slice(index)],
+  false
+];
+function fixDivider(original, _format) {
+  if (original.includes(SYMBOLS.DIVIDER)) {
+    return [original, false];
+  }
+  const tokens = original.slice(0);
+  const genomeIndex = getGenomeIndex(tokens);
+  if (genomeIndex) {
+    return insertDivider(tokens, genomeIndex);
+  }
+  const simple = simpler(tokens);
+  if (SIMPLER_PATTERNS[simple]) {
+    return insertDivider(tokens, SIMPLER_PATTERNS[simple]);
+  }
+  return [[], true];
+}
+
+export { fixDivider };
+//# sourceMappingURL=fix-dividers.js.map
+//# sourceMappingURL=fix-dividers.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../src/coordinates/latlon/internal/pipes/fix-dividers.ts"],"names":[],"mappings":";;;;;AAqBA,IAAM,gBAAmB,GAAA;AAAA,EACvB,EAAI,EAAA,CAAA;AAAA,EACJ,GAAK,EAAA,CAAA;AAAA,EACL,IAAM,EAAA,CAAA;AAAA,EACN,GAAK,EAAA;AACP,CAAA;AAEA,IAAM,aAAA,GAAgB,CAAC,MAAA,EAAgB,KAA8B,KAAA;AAAA,EACnE,CAAC,GAAG,MAAO,CAAA,KAAA,CAAM,CAAG,EAAA,KAAK,CAAG,EAAA,OAAA,CAAQ,OAAS,EAAA,GAAG,MAAO,CAAA,KAAA,CAAM,KAAK,CAAC,CAAA;AAAA,EACnE;AACF,CAAA;AAUO,SAAS,UAAA,CAAW,UAAkB,OAA8B,EAAA;AAEzE,EAAA,IAAI,QAAS,CAAA,QAAA,CAAS,OAAQ,CAAA,OAAO,CAAG,EAAA;AACtC,IAAO,OAAA,CAAC,UAAU,KAAK,CAAA;AAAA;AAIzB,EAAM,MAAA,MAAA,GAAS,QAAS,CAAA,KAAA,CAAM,CAAC,CAAA;AAE/B,EAAM,MAAA,WAAA,GAAc,eAAe,MAAM,CAAA;AAEzC,EAAA,IAAI,WAAa,EAAA;AACf,IAAO,OAAA,aAAA,CAAc,QAAQ,WAAW,CAAA;AAAA;AAG1C,EAAM,MAAA,MAAA,GAAS,QAAQ,MAAM,CAAA;AAE7B,EAAI,IAAA,gBAAA,CAAiB,MAAM,CAAG,EAAA;AAC5B,IAAA,OAAO,aAAc,CAAA,MAAA,EAAQ,gBAAiB,CAAA,MAAM,CAAC,CAAA;AAAA;AAKvD,EAAO,OAAA,CAAC,EAAC,EAAG,IAAI,CAAA;AAClB","file":"fix-dividers.js","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 type { Tokens } from '../lexer';\nimport type { PipeResult } from '../pipes';\nimport { getGenomeIndex } from './genome';\nimport { simpler } from './simpler';\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"]}

package/dist/coordinates/latlon/internal/pipes/genome.d.ts

@@ -0,0 +1,9 @@
+import { Tokens } from '../lexer.js';
+
+/**
+ * Use the "genome" sequence of the token list to find the index for inserting
+ * a missing divider token.
+ */
+declare function getGenomeIndex(tokens: Tokens): number;
+
+export { getGenomeIndex };

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

@@ -0,0 +1,37 @@
+import { SYMBOLS, SYMBOL_PATTERNS } from '../index.js';
+
+// src/coordinates/latlon/internal/pipes/genome.ts
+var GENOME_PATTERN = /^(B?)([DN]?[MN]?[SN]?)(B?)(?:B?)([DN]?[MN]?[SN]?)(?:B?)$/;
+function dividerIndexer(_full, ...args) {
+  const [bearing1 = "", number1, bearing2 = "", number2] = args;
+  if (!(number1?.length && number2?.length)) {
+    return "0";
+  }
+  return `${number1.length + (bearing1.length || bearing2.length)}`;
+}
+function genomeSequencer(acc, t) {
+  if (t.includes(SYMBOLS.DEGREES)) {
+    return `${acc}D`;
+  }
+  if (t.includes(SYMBOLS.MINUTES)) {
+    return `${acc}M`;
+  }
+  if (t.includes(SYMBOLS.SECONDS)) {
+    return `${acc}S`;
+  }
+  if (SYMBOL_PATTERNS.NSEW.test(t)) {
+    return `${acc}B`;
+  }
+  if (/\d/.test(t)) {
+    return `${acc}N`;
+  }
+  return `${acc}X`;
+}
+function getGenomeIndex(tokens) {
+  const seq = tokens.reduce(genomeSequencer, "");
+  return GENOME_PATTERN.test(seq) ? Number.parseInt(seq.replace(GENOME_PATTERN, dividerIndexer)) : 0;
+}
+
+export { getGenomeIndex };
+//# sourceMappingURL=genome.js.map
+//# sourceMappingURL=genome.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../src/coordinates/latlon/internal/pipes/genome.ts"],"names":[],"mappings":";;;AAgBA,IAAM,cACJ,GAAA,0DAAA;AAOF,SAAS,cAAA,CAAe,UAAkB,IAAgB,EAAA;AACxD,EAAA,MAAM,CAAC,QAAW,GAAA,EAAA,EAAI,SAAS,QAAW,GAAA,EAAA,EAAI,OAAO,CAAI,GAAA,IAAA;AAGzD,EAAA,IAAI,EAAE,OAAA,EAAS,MAAU,IAAA,OAAA,EAAS,MAAS,CAAA,EAAA;AACzC,IAAO,OAAA,GAAA;AAAA;AAGT,EAAA,OAAO,GAAG,OAAQ,CAAA,MAAA,IAAU,QAAS,CAAA,MAAA,IAAU,SAAS,MAAO,CAAA,CAAA,CAAA;AACjE;AAYA,SAAS,eAAA,CAAgB,KAAa,CAAW,EAAA;AAC/C,EAAA,IAAI,CAAE,CAAA,QAAA,CAAS,OAAQ,CAAA,OAAO,CAAG,EAAA;AAC/B,IAAA,OAAO,GAAG,GAAG,CAAA,CAAA,CAAA;AAAA;AAGf,EAAA,IAAI,CAAE,CAAA,QAAA,CAAS,OAAQ,CAAA,OAAO,CAAG,EAAA;AAC/B,IAAA,OAAO,GAAG,GAAG,CAAA,CAAA,CAAA;AAAA;AAGf,EAAA,IAAI,CAAE,CAAA,QAAA,CAAS,OAAQ,CAAA,OAAO,CAAG,EAAA;AAC/B,IAAA,OAAO,GAAG,GAAG,CAAA,CAAA,CAAA;AAAA;AAGf,EAAA,IAAI,eAAgB,CAAA,IAAA,CAAK,IAAK,CAAA,CAAC,CAAG,EAAA;AAChC,IAAA,OAAO,GAAG,GAAG,CAAA,CAAA,CAAA;AAAA;AAGf,EAAI,IAAA,IAAA,CAAK,IAAK,CAAA,CAAC,CAAG,EAAA;AAChB,IAAA,OAAO,GAAG,GAAG,CAAA,CAAA,CAAA;AAAA;AAGf,EAAA,OAAO,GAAG,GAAG,CAAA,CAAA,CAAA;AACf;AAMO,SAAS,eAAe,MAAgB,EAAA;AAC7C,EAAA,MAAM,GAAM,GAAA,MAAA,CAAO,MAAO,CAAA,eAAA,EAAiB,EAAE,CAAA;AAE7C,EAAO,OAAA,cAAA,CAAe,IAAK,CAAA,GAAG,CAC1B,GAAA,MAAA,CAAO,QAAS,CAAA,GAAA,CAAI,OAAQ,CAAA,cAAA,EAAgB,cAAc,CAAC,CAC3D,GAAA,CAAA;AACN","file":"genome.js","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, SYMBOL_PATTERNS } 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))\n    : 0;\n}\n"]}

package/dist/coordinates/latlon/internal/pipes/index.d.ts

@@ -0,0 +1,24 @@
+import { Format } from '../index.js';
+import { Tokens } from '../lexer.js';
+
+type Pipe = (t: Tokens, f?: Format) => [Tokens, boolean | string];
+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
+ *
+ * @remarks
+ * pure function
+ */
+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
+ */
+declare function pipesRunner(tokens: Tokens, format?: Format): [Tokens, string[]];
+
+export { type PipeResult, pipesResult, pipesRunner };

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

@@ -0,0 +1,46 @@
+import { SYMBOL_PATTERNS } from '../index.js';
+import { checkAmbiguousGrouping } from './check-ambiguous.js';
+import { checkNumberValues } from './check-numbers.js';
+import { fixBearings } from './fix-bearings.js';
+import { fixDivider } from './fix-dividers.js';
+
+// src/coordinates/latlon/internal/pipes/index.ts
+var makeGlobal = (k) => new RegExp(SYMBOL_PATTERNS[k], "g");
+var pipesResult = (t, e) => [
+  // if there are errors do NOT return the tokens
+  e ? [] : t,
+  e
+];
+var tooMany = (p) => (t) => pipesResult(t, (t.join("").match(p) ?? []).length > 2);
+var pipes = [
+  // Unrecoverable violations
+  ["Too many bearings.", tooMany(makeGlobal("NSEW"))],
+  ["Too many numeric signs.", tooMany(/[-+]/g)],
+  ["Too many degrees indicators.", tooMany(makeGlobal("DEGREES"))],
+  ["Too many minutes indicators.", tooMany(makeGlobal("MINUTES"))],
+  ["Too many seconds indicators.", tooMany(makeGlobal("SECONDS"))],
+  ["Number values checks.", checkNumberValues],
+  ["Ambiguous grouping of numbers with no divider.", checkAmbiguousGrouping],
+  // fix values and formatting to be consistent
+  ["Unable to identify latitude from longitude.", fixDivider],
+  ["Unable to identify bearings.", fixBearings]
+];
+function pipesRunner(tokens, format) {
+  let copy = tokens.slice(0);
+  let error = false;
+  const errors = [];
+  for (const [message, op] of pipes) {
+    [copy, error] = op(copy, format);
+    if (error) {
+      errors.push(error === true ? message : error);
+      if (!copy.length) {
+        return [copy, [error === true ? message : error]];
+      }
+    }
+  }
+  return [copy, errors];
+}
+
+export { pipesResult, pipesRunner };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../src/coordinates/latlon/internal/pipes/index.ts"],"names":[],"mappings":";;;;;;;AA0BA,IAAM,UAAA,GAAa,CAAC,CAClB,KAAA,IAAI,OAAO,eAAgB,CAAA,CAAC,GAAG,GAAG,CAAA;AAWvB,IAAA,WAAA,GAAc,CAAC,CAAA,EAAW,CAAoC,KAAA;AAAA;AAAA,EAEzE,CAAA,GAAI,EAAK,GAAA,CAAA;AAAA,EACT;AACF;AAGA,IAAM,UAAU,CAAC,CAAA,KAAc,CAAC,CAAA,KAC9B,YAAY,CAAI,EAAA,CAAA,CAAA,CAAE,IAAK,CAAA,EAAE,EAAE,KAAM,CAAA,CAAC,KAAK,EAAC,EAAG,SAAS,CAAC,CAAA;AAEvD,IAAM,KAA0B,GAAA;AAAA;AAAA,EAE9B,CAAC,oBAAsB,EAAA,OAAA,CAAQ,UAAW,CAAA,MAAM,CAAC,CAAC,CAAA;AAAA,EAClD,CAAC,yBAAA,EAA2B,OAAQ,CAAA,OAAO,CAAC,CAAA;AAAA,EAC5C,CAAC,8BAAgC,EAAA,OAAA,CAAQ,UAAW,CAAA,SAAS,CAAC,CAAC,CAAA;AAAA,EAC/D,CAAC,8BAAgC,EAAA,OAAA,CAAQ,UAAW,CAAA,SAAS,CAAC,CAAC,CAAA;AAAA,EAC/D,CAAC,8BAAgC,EAAA,OAAA,CAAQ,UAAW,CAAA,SAAS,CAAC,CAAC,CAAA;AAAA,EAC/D,CAAC,yBAAyB,iBAAiB,CAAA;AAAA,EAC3C,CAAC,kDAAkD,sBAAsB,CAAA;AAAA;AAAA,EAGzE,CAAC,+CAA+C,UAAU,CAAA;AAAA,EAC1D,CAAC,gCAAgC,WAAW;AAC9C,CAAA;AAQO,SAAS,WAAA,CACd,QACA,MACoB,EAAA;AACpB,EAAI,IAAA,IAAA,GAAO,MAAO,CAAA,KAAA,CAAM,CAAC,CAAA;AACzB,EAAA,IAAI,KAAuB,GAAA,KAAA;AAC3B,EAAA,MAAM,SAAS,EAAC;AAEhB,EAAA,KAAA,MAAW,CAAC,OAAA,EAAS,EAAE,CAAA,IAAK,KAAO,EAAA;AACjC,IAAA,CAAC,IAAM,EAAA,KAAK,CAAI,GAAA,EAAA,CAAG,MAAM,MAAM,CAAA;AAE/B,IAAA,IAAI,KAAO,EAAA;AAGT,MAAA,MAAA,CAAO,IAAK,CAAA,KAAA,KAAU,IAAO,GAAA,OAAA,GAAU,KAAK,CAAA;AAE5C,MAAI,IAAA,CAAC,KAAK,MAAQ,EAAA;AAChB,QAAA,OAAO,CAAC,IAAM,EAAA,CAAC,UAAU,IAAO,GAAA,OAAA,GAAU,KAAK,CAAC,CAAA;AAAA;AAClD;AACF;AAGF,EAAO,OAAA,CAAC,MAAM,MAAM,CAAA;AACtB","file":"index.js","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 type { Tokens } from '../lexer';\n\nimport { checkAmbiguousGrouping } from './check-ambiguous';\nimport { checkNumberValues } from './check-numbers';\nimport { fixBearings } from './fix-bearings';\nimport { fixDivider } from './fix-dividers';\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"]}

package/dist/coordinates/latlon/internal/pipes/simpler.d.ts

@@ -0,0 +1,15 @@
+import { Tokens } from '../lexer.js';
+
+/**
+ * Create a simplified pattern string - numbers = 'N', bearings = 'B' - to
+ * allow for simpler pattern matching.
+ *
+ * @remarks
+ * pure function
+ *
+ * @example
+ * simplify(tokens); // 'NNNBNNNB' or similar
+ */
+declare const simpler: (tokens: Tokens) => string;
+
+export { simpler };

package/dist/coordinates/latlon/internal/pipes/simpler.js

@@ -0,0 +1,6 @@
+// src/coordinates/latlon/internal/pipes/simpler.ts
+var simpler = (tokens) => tokens.map((t) => /\d/.test(t) ? "N" : "B").join("");
+
+export { simpler };
+//# sourceMappingURL=simpler.js.map
+//# sourceMappingURL=simpler.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../src/coordinates/latlon/internal/pipes/simpler.ts"],"names":[],"mappings":";AAyBO,IAAM,OAAU,GAAA,CAAC,MACtB,KAAA,MAAA,CAAO,IAAI,CAAC,CAAA,KAAO,IAAK,CAAA,IAAA,CAAK,CAAC,CAAI,GAAA,GAAA,GAAM,GAAI,CAAA,CAAE,KAAK,EAAE","file":"simpler.js","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 { Tokens } from '../lexer';\n\n/**\n * Create a simplified pattern string - numbers = 'N', bearings = 'B' - to\n * allow for simpler pattern matching.\n *\n * @remarks\n * pure function\n *\n * @example\n * simplify(tokens); // 'NNNBNNNB' or similar\n */\nexport const simpler = (tokens: Tokens) =>\n  tokens.map((t) => (/\\d/.test(t) ? 'N' : 'B')).join('');\n"]}

package/dist/coordinates/latlon/internal/violation.d.ts

@@ -0,0 +1,3 @@
+declare const violation: (s: string) => string;
+
+export { violation };

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

@@ -0,0 +1,6 @@
+// src/coordinates/latlon/internal/violation.ts
+var violation = (s) => `[ERROR] ${s}`;
+
+export { violation };
+//# sourceMappingURL=violation.js.map
+//# sourceMappingURL=violation.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/coordinates/latlon/internal/violation.ts"],"names":[],"mappings":";AAaO,IAAM,SAAY,GAAA,CAAC,CAAc,KAAA,CAAA,QAAA,EAAW,CAAC,CAAA","file":"violation.js","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\nexport const violation = (s: string) => `[ERROR] ${s}`;\n"]}

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

@@ -0,0 +1,7 @@
+import { ParseResults } from '../latlon/internal/parse.js';
+import '../latlon/internal/index.js';
+import '../latlon/internal/lexer.js';
+
+declare function parseMGRS(_format: any, input: string): ParseResults;
+
+export { parseMGRS };

package/dist/coordinates/mgrs/parser.js

@@ -0,0 +1,45 @@
+import { MGRS } from '@ngageoint/mgrs-js';
+import { parse } from '../latlon/internal/parse.js';
+import { violation } from '../latlon/internal/violation.js';
+
+// src/coordinates/mgrs/parser.ts
+var PATTERN_PARTS = /^((?:..?)?)(\w?)\s*((?:\w{2})?)\s*(?:(\d+(?:\.\d*)?)?)\s*(?:(\d+(?:\.\d*)?)?)$/i;
+var error = (message) => [
+  [],
+  [`${violation(message)}; expected format DDZ AA DDD DDD.`]
+];
+function detailedErrors(input) {
+  if (!input) {
+    return error("No input provided");
+  }
+  const [utm, bnd, hkm, east, north] = (input.trim().replace(/\s+/g, " ").match(PATTERN_PARTS) ?? []).slice(1);
+  if (!utm || +utm > 60 || +utm < 1) {
+    return error(
+      `Invalid UTM zone number (${utm}) found in grid zone designation`
+    );
+  }
+  if (!/[C-HJ-NP-X]/i.test(bnd)) {
+    return error(
+      `Invalid Latitude band letter (${bnd}) found in grid zone designation`
+    );
+  }
+  if (!/^[A-HJ-NP-Z]*$/i.test(hkm)) {
+    return error(`Invalid 100K m square identification (${hkm}) found`);
+  }
+  if (!(east && north && +east > 0 && +north > 0)) {
+    return error(`Invalid numerical location (${[east, north].join()}) found`);
+  }
+  return error("Uncaught error condition.");
+}
+function parseMGRS(_format, input) {
+  try {
+    const point = MGRS.parse(input).toPoint();
+    return parse(`${point.getLatitude()} / ${point.getLongitude()}`, "LATLON");
+  } catch (_e) {
+    return detailedErrors(input);
+  }
+}
+
+export { parseMGRS };
+//# sourceMappingURL=parser.js.map
+//# sourceMappingURL=parser.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/coordinates/mgrs/parser.ts"],"names":[],"mappings":";;;;;AAmBA,IAAM,aACJ,GAAA,iFAAA;AAEF,IAAM,KAAA,GAAQ,CAAC,OACb,KAAA;AAAA,EACE,EAAC;AAAA,EACD,CAAC,CAAA,EAAG,SAAU,CAAA,OAAO,CAAC,CAAmC,iCAAA,CAAA;AAC3D,CAAA;AAEF,SAAS,eAAe,KAAe,EAAA;AACrC,EAAA,IAAI,CAAC,KAAO,EAAA;AACV,IAAA,OAAO,MAAM,mBAAmB,CAAA;AAAA;AAGlC,EAAM,MAAA,CAAC,KAAK,GAAK,EAAA,GAAA,EAAK,MAAM,KAAK,CAAA,GAAA,CAC/B,MAAM,IAAK,EAAA,CAAE,QAAQ,MAAQ,EAAA,GAAG,EAAE,KAAM,CAAA,aAAa,KAAK,EAAC,EAC3D,MAAM,CAAC,CAAA;AAET,EAAA,IAAI,CAAC,GAAO,IAAA,CAAC,MAAM,EAAM,IAAA,CAAC,MAAM,CAAG,EAAA;AACjC,IAAO,OAAA,KAAA;AAAA,MACL,4BAA4B,GAAG,CAAA,gCAAA;AAAA,KACjC;AAAA;AAGF,EAAA,IAAI,CAAC,cAAA,CAAe,IAAK,CAAA,GAAG,CAAG,EAAA;AAC7B,IAAO,OAAA,KAAA;AAAA,MACL,iCAAiC,GAAG,CAAA,gCAAA;AAAA,KACtC;AAAA;AAGF,EAAA,IAAI,CAAC,iBAAA,CAAkB,IAAK,CAAA,GAAG,CAAG,EAAA;AAChC,IAAO,OAAA,KAAA,CAAM,CAAyC,sCAAA,EAAA,GAAG,CAAS,OAAA,CAAA,CAAA;AAAA;AAGpE,EAAI,IAAA,EAAE,QAAQ,KAAS,IAAA,CAAC,OAAO,CAAK,IAAA,CAAC,QAAQ,CAAI,CAAA,EAAA;AAC/C,IAAO,OAAA,KAAA,CAAM,+BAA+B,CAAC,IAAA,EAAM,KAAK,CAAE,CAAA,IAAA,EAAM,CAAS,OAAA,CAAA,CAAA;AAAA;AAG3E,EAAA,OAAO,MAAM,2BAA2B,CAAA;AAC1C;AAIO,SAAS,SAAA,CAAU,SAAc,KAAe,EAAA;AACrD,EAAI,IAAA;AACF,IAAA,MAAM,KAAQ,GAAA,IAAA,CAAK,KAAM,CAAA,KAAK,EAAE,OAAQ,EAAA;AAExC,IAAO,OAAA,KAAA,CAAM,CAAG,EAAA,KAAA,CAAM,WAAY,EAAC,MAAM,KAAM,CAAA,YAAA,EAAc,CAAA,CAAA,EAAI,QAAQ,CAAA;AAAA,WAClE,EAAI,EAAA;AACX,IAAA,OAAO,eAAe,KAAK,CAAA;AAAA;AAE/B","file":"parser.js","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 { MGRS } from '@ngageoint/mgrs-js';\n\nimport { type ParseResults, parse } from '../latlon/internal/parse';\nimport { violation } from '../latlon/internal/violation';\n\ntype Match = [string, string, string, string, string];\n\nconst PATTERN_PARTS =\n  /^((?:..?)?)(\\w?)\\s*((?:\\w{2})?)\\s*(?:(\\d+(?:\\.\\d*)?)?)\\s*(?:(\\d+(?:\\.\\d*)?)?)$/i;\n\nconst error = (message: string) =>\n  [\n    [],\n    [`${violation(message)}; expected format DDZ AA DDD DDD.`],\n  ] as ParseResults;\n\nfunction detailedErrors(input: string) {\n  if (!input) {\n    return error('No input provided');\n  }\n\n  const [utm, bnd, hkm, east, north] = (\n    input.trim().replace(/\\s+/g, ' ').match(PATTERN_PARTS) ?? []\n  ).slice(1) as Match;\n\n  if (!utm || +utm > 60 || +utm < 1) {\n    return error(\n      `Invalid UTM zone number (${utm}) found in grid zone designation`,\n    );\n  }\n\n  if (!/[C-HJ-NP-X]/i.test(bnd)) {\n    return error(\n      `Invalid Latitude band letter (${bnd}) found in grid zone designation`,\n    );\n  }\n\n  if (!/^[A-HJ-NP-Z]*$/i.test(hkm)) {\n    return error(`Invalid 100K m square identification (${hkm}) found`);\n  }\n\n  if (!(east && north && +east > 0 && +north > 0)) {\n    return error(`Invalid numerical location (${[east, north].join()}) found`);\n  }\n\n  return error('Uncaught error condition.');\n}\n\n// biome-ignore lint/style/useNamingConvention: <explanation>\n// biome-ignore lint/suspicious/noExplicitAny: <explanation>\nexport function parseMGRS(_format: any, input: string) {\n  try {\n    const point = MGRS.parse(input).toPoint();\n\n    return parse(`${point.getLatitude()} / ${point.getLongitude()}`, 'LATLON');\n  } catch (_e) {\n    return detailedErrors(input);\n  }\n}\n"]}

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

@@ -0,0 +1,8 @@
+import { CoordinateSystem } from '../latlon/internal/coordinate-system.js';
+import '../latlon/internal/index.js';
+import '../latlon/internal/parse.js';
+import '../latlon/internal/lexer.js';
+
+declare const systemMGRS: CoordinateSystem;
+
+export { systemMGRS };

package/dist/coordinates/mgrs/system.js

@@ -0,0 +1,25 @@
+import { Point } from '@ngageoint/grid-js';
+import { MGRS } from '@ngageoint/mgrs-js';
+import { SYMBOL_PATTERNS } from '../latlon/internal/index.js';
+import { parseMGRS } from './parser.js';
+
+// src/coordinates/mgrs/system.ts
+var systemMGRS = {
+  name: "Military Grid Reference System",
+  parse: parseMGRS,
+  toFloat(arg) {
+    const [num, bear] = arg;
+    return Number.parseFloat(num) * (SYMBOL_PATTERNS.NEGATIVE_BEARINGS.test(bear) ? -1 : 1);
+  },
+  toFormat(format, [left, right]) {
+    const { LAT, LON } = Object.fromEntries([
+      [format.slice(0, 3), left],
+      [format.slice(3), right]
+    ]);
+    return MGRS.from(Point.point(LON, LAT)).toString();
+  }
+};
+
+export { systemMGRS };
+//# sourceMappingURL=system.js.map
+//# sourceMappingURL=system.js.map