@accelint/geo 0.1.3 → 0.2.0

package/README.md

@@ -0,0 +1,3 @@
+# @accelint/geo
+
+⚠️ Under Construction ⚠️

package/dist/cartesian.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Computes the Cartesian product of multiple arrays.
+ *
+ * @template T
+ * the type of elements in the input arrays.
+ * @param {...T[][]} all
+ * a variadic number of arrays to compute the Cartesian product of.
+ * @returns {T[][]}
+ * An array containing all possible combinations of elements from the input
+ * arrays, where each combination is represented as an array.
+ *
+ * @remarks
+ * pure function
+ *
+ * @example
+ * const result = cartesian([1, 2], ['a', 'b']);
+ * // result: [[1, 'a'], [1, 'b'], [2, 'a'], [2, 'b']]
+ */
+declare function cartesian<T>(...all: T[][]): T[][];
+
+export { cartesian };

package/dist/cartesian.js

@@ -0,0 +1,11 @@
+// src/cartesian.ts
+function cartesian(...all) {
+  return all.reduce(
+    (results, entries) => results.map((result) => entries.map((entry) => result.concat([entry]))).reduce((sub, res) => sub.concat(res), []),
+    [[]]
+  );
+}
+
+export { cartesian };
+//# sourceMappingURL=cartesian.js.map
+//# sourceMappingURL=cartesian.js.map

package/dist/cartesian.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/cartesian.ts"],"names":[],"mappings":";AA+BO,SAAS,aAAgB,GAAmB,EAAA;AACjD,EAAA,OAAO,GAAI,CAAA,MAAA;AAAA,IACT,CAAC,OAAA,EAAS,OACR,KAAA,OAAA,CACG,GAAI,CAAA,CAAC,MAAW,KAAA,OAAA,CAAQ,GAAI,CAAA,CAAC,KAAU,KAAA,MAAA,CAAO,MAAO,CAAA,CAAC,KAAK,CAAC,CAAC,CAAC,CAC9D,CAAA,MAAA,CAAO,CAAC,GAAA,EAAK,GAAQ,KAAA,GAAA,CAAI,MAAO,CAAA,GAAG,CAAG,EAAA,EAAE,CAAA;AAAA,IAC7C,CAAC,EAAE;AAAA,GACL;AACF","file":"cartesian.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\n/**\n * Computes the Cartesian product of multiple arrays.\n *\n * @template T\n * the type of elements in the input arrays.\n * @param {...T[][]} all\n * a variadic number of arrays to compute the Cartesian product of.\n * @returns {T[][]}\n * An array containing all possible combinations of elements from the input\n * arrays, where each combination is represented as an array.\n *\n * @remarks\n * pure function\n *\n * @example\n * const result = cartesian([1, 2], ['a', 'b']);\n * // result: [[1, 'a'], [1, 'b'], [2, 'a'], [2, 'b']]\n */\nexport function cartesian<T>(...all: T[][]): T[][] {\n  return all.reduce<T[][]>(\n    (results, entries) =>\n      results\n        .map((result) => entries.map((entry) => result.concat([entry])))\n        .reduce((sub, res) => sub.concat(res), []),\n    [[]],\n  );\n}\n"]}

package/dist/coordinates/coordinate.d.ts

@@ -0,0 +1,72 @@
+import { Format } from './latlon/internal/index.js';
+import { CoordinateSystem } from './latlon/internal/coordinate-system.js';
+import './latlon/internal/parse.js';
+import './latlon/internal/lexer.js';
+
+type Coordinate = {
+    /** {@interitDoc Formatter} */
+    dd: Formatter;
+    /** {@interitDoc Formatter} */
+    ddm: Formatter;
+    /** {@interitDoc Formatter} */
+    dms: Formatter;
+    /** {@interitDoc Formatter} */
+    mgrs: Formatter;
+    /** {@interitDoc Formatter} */
+    utm: Formatter;
+    errors: string[];
+    raw: CoordinateInternalValue;
+    valid: boolean;
+};
+type CoordinateInternalValue = {
+    LAT: number;
+    LON: number;
+};
+/**
+ * Output a string value of a coordinate using an available system. The
+ * original value is preserved without conversion to an internal
+ * representation - Decimal Degrees - to prevent the possibility of
+ * rounding errors. All alternative values are computed from a common
+ * internal value to reduce complexity.
+ *
+ * @remarks
+ * pure function
+ *
+ * @example
+ * const create = createCoordinate(coordinateSystems.dd, 'LATLON')
+ * const coord = create('89.765432109 / 123.456789012')
+ *
+ * // honors the instantiation format 'LATLON'
+ * coord.dd() === '89.765432109 N / 123.456789012 E'
+ * coord.ddm() === '89 45.92592654 N / 123 27.40734072 E'
+ * coord.dms() === '89 45 55.5555924 N / 123 27 24.4404432 E'
+ *
+ * // change format to 'LONLAT'
+ * coord.dms('LONLAT') === '123 27 24.4404432 E / 89 45 55.5555924 N'
+ */
+type Formatter = (f?: Format) => string;
+declare const coordinateSystems: Readonly<{
+    readonly dd: CoordinateSystem;
+    readonly ddm: CoordinateSystem;
+    readonly dms: CoordinateSystem;
+    readonly mgrs: CoordinateSystem;
+    readonly utm: CoordinateSystem;
+}>;
+/**
+ * Create a coordinate object enabling: lexing, parsing, validation, and
+ * formatting in alternative systems and formats. The system and format will be
+ * used for validation and eventually for output as defaults if no alternatives
+ * are provided.
+ *
+ * @param initSystem dd, ddm, dms, mgrs, or utm of coordinateSystems
+ *
+ * @remarks
+ * pure function
+ *
+ * @example
+ * const create = createCoordinate(coordinateSystems.dd, 'LATLON')
+ * const create = createCoordinate(coordinateSystems.ddm, 'LONLAT')
+ */
+declare function createCoordinate(initSystem?: CoordinateSystem, initFormat?: Format): (input: string) => Readonly<Coordinate>;
+
+export { coordinateSystems, createCoordinate };

package/dist/coordinates/coordinate.js

@@ -0,0 +1,87 @@
+import { systemDecimalDegrees } from './latlon/decimal-degrees/system.js';
+import { systemDegreesDecimalMinutes } from './latlon/degrees-decimal-minutes/system.js';
+import { systemDegreesMinutesSeconds } from './latlon/degrees-minutes-seconds/system.js';
+import { FORMATS_DEFAULT, SYMBOLS } from './latlon/internal/index.js';
+import { createCache } from './latlon/internal/create-cache.js';
+import { systemMGRS } from './mgrs/system.js';
+import { systemUTM } from './utm/system.js';
+
+// src/coordinates/coordinate.ts
+var coordinateSystems = Object.freeze({
+  dd: systemDecimalDegrees,
+  ddm: systemDegreesDecimalMinutes,
+  dms: systemDegreesMinutesSeconds,
+  mgrs: systemMGRS,
+  utm: systemUTM
+});
+var freezeCoordinate = (errors, to, raw, valid) => Object.freeze({
+  dd: (format) => to(systemDecimalDegrees, format),
+  ddm: (format) => to(systemDegreesDecimalMinutes, format),
+  dms: (format) => to(systemDegreesMinutesSeconds, format),
+  mgrs: (format) => to(systemMGRS, format),
+  errors,
+  raw,
+  valid
+});
+function createCoordinate(initSystem = coordinateSystems.dd, initFormat = FORMATS_DEFAULT) {
+  return (input) => {
+    let tokens;
+    let errors;
+    try {
+      [tokens, errors] = initSystem.parse(initFormat, input);
+      if (errors.length) {
+        throw errors;
+      }
+    } catch (errors2) {
+      return freezeCoordinate(
+        errors2,
+        () => "",
+        {},
+        false
+      );
+    }
+    const cachedValues = {
+      [initSystem.name]: createCache(
+        initFormat,
+        // because mgrs doesn't have two formats: LATLON v LONLAT
+        initSystem.name === systemMGRS.name ? input : tokens.join(" ")
+      )
+    };
+    const raw = Object.fromEntries([
+      [
+        initFormat.slice(0, 3),
+        initSystem.toFloat(
+          tokens.slice(0, tokens.indexOf(SYMBOLS.DIVIDER))
+        )
+      ],
+      [
+        initFormat.slice(3),
+        initSystem.toFloat(
+          tokens.slice(1 + tokens.indexOf(SYMBOLS.DIVIDER))
+        )
+      ]
+    ]);
+    function to(system = initSystem, format = initFormat) {
+      const key = system.name;
+      if (!cachedValues[key]?.[format]) {
+        cachedValues[key] = {
+          ...cachedValues[key],
+          // use the Format to build the object, correctly pairing the halves of
+          // the coordinate value with their labels
+          [format]: system.toFormat(
+            format,
+            [format.slice(0, 3), format.slice(3)].map(
+              (key2) => raw[key2]
+            )
+          )
+        };
+      }
+      return cachedValues[key][format];
+    }
+    return freezeCoordinate([], to, raw, true);
+  };
+}
+
+export { coordinateSystems, createCoordinate };
+//# sourceMappingURL=coordinate.js.map
+//# sourceMappingURL=coordinate.js.map

package/dist/coordinates/coordinate.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/coordinates/coordinate.ts"],"names":["errors","key"],"mappings":"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","file":"coordinate.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 { systemDecimalDegrees } from './latlon/decimal-degrees/system';\nimport { systemDegreesDecimalMinutes } from './latlon/degrees-decimal-minutes/system';\nimport { systemDegreesMinutesSeconds } from './latlon/degrees-minutes-seconds/system';\nimport {\n  type Axes,\n  type Errors,\n  FORMATS_DEFAULT,\n  type Format,\n  SYMBOLS,\n} from './latlon/internal';\nimport type { CoordinateSystem } from './latlon/internal/coordinate-system';\nimport {\n  type CoordinateCache,\n  createCache,\n} from './latlon/internal/create-cache';\nimport type { Tokens } from './latlon/internal/lexer';\nimport { systemMGRS } from './mgrs/system';\nimport { systemUTM } from './utm/system';\n\ntype Coordinate = {\n  /** {@interitDoc Formatter} */\n  dd: Formatter;\n  /** {@interitDoc Formatter} */\n  ddm: Formatter;\n  /** {@interitDoc Formatter} */\n  dms: Formatter;\n  /** {@interitDoc Formatter} */\n  mgrs: Formatter;\n  /** {@interitDoc Formatter} */\n  utm: Formatter;\n  errors: string[];\n  raw: CoordinateInternalValue;\n  valid: boolean;\n};\n\n// biome-ignore lint/style/useNamingConvention: consistency with Axes type\ntype CoordinateInternalValue = { LAT: number; LON: number };\n\n/**\n * Output a string value of a coordinate using an available system. The\n * original value is preserved without conversion to an internal\n * representation - Decimal Degrees - to prevent the possibility of\n * rounding errors. All alternative values are computed from a common\n * internal value to reduce complexity.\n *\n * @remarks\n * pure function\n *\n * @example\n * const create = createCoordinate(coordinateSystems.dd, 'LATLON')\n * const coord = create('89.765432109 / 123.456789012')\n *\n * // honors the instantiation format 'LATLON'\n * coord.dd() === '89.765432109 N / 123.456789012 E'\n * coord.ddm() === '89 45.92592654 N / 123 27.40734072 E'\n * coord.dms() === '89 45 55.5555924 N / 123 27 24.4404432 E'\n *\n * // change format to 'LONLAT'\n * coord.dms('LONLAT') === '123 27 24.4404432 E / 89 45 55.5555924 N'\n */\ntype Formatter = (f?: Format) => string;\n\ntype ToFloatArg = Parameters<CoordinateSystem['toFloat']>[0];\n\ntype OutputCache = Record<keyof typeof coordinateSystems, CoordinateCache>;\n\nexport const coordinateSystems = Object.freeze({\n  dd: systemDecimalDegrees,\n  ddm: systemDegreesDecimalMinutes,\n  dms: systemDegreesMinutesSeconds,\n  mgrs: systemMGRS,\n  utm: systemUTM,\n} as const);\n\nconst freezeCoordinate = (\n  errors: Coordinate['errors'],\n  to: (s?: CoordinateSystem, f?: Format) => string,\n  raw: CoordinateInternalValue,\n  valid: Coordinate['valid'],\n) =>\n  Object.freeze({\n    dd: (format?: Format) => to(systemDecimalDegrees, format),\n    ddm: (format?: Format) => to(systemDegreesDecimalMinutes, format),\n    dms: (format?: Format) => to(systemDegreesMinutesSeconds, format),\n    mgrs: (format?: Format) => to(systemMGRS, format),\n    errors,\n    raw,\n    valid,\n  } as Coordinate);\n\n/**\n * Create a coordinate object enabling: lexing, parsing, validation, and\n * formatting in alternative systems and formats. The system and format will be\n * used for validation and eventually for output as defaults if no alternatives\n * are provided.\n *\n * @param initSystem dd, ddm, dms, mgrs, or utm of coordinateSystems\n *\n * @remarks\n * pure function\n *\n * @example\n * const create = createCoordinate(coordinateSystems.dd, 'LATLON')\n * const create = createCoordinate(coordinateSystems.ddm, 'LONLAT')\n */\nexport function createCoordinate(\n  initSystem: CoordinateSystem = coordinateSystems.dd,\n  initFormat: Format = FORMATS_DEFAULT,\n) {\n  return (input: string) => {\n    let tokens: Tokens;\n    let errors: Errors;\n\n    try {\n      [tokens, errors] = initSystem.parse(initFormat, input);\n\n      if (errors.length) {\n        throw errors;\n      }\n    } catch (errors) {\n      return freezeCoordinate(\n        errors as Coordinate['errors'],\n        () => '',\n        {} as CoordinateInternalValue,\n        false,\n      );\n    }\n\n    // start with the original value for the original system in the original format\n    // other values will be computed as needed and cached per request\n    const cachedValues = {\n      [initSystem.name]: createCache(\n        initFormat,\n        // because mgrs doesn't have two formats: LATLON v LONLAT\n        initSystem.name === systemMGRS.name ? input : tokens.join(' '),\n      ),\n    } as OutputCache;\n\n    // Create the \"internal\" representation - Decimal Degrees - for\n    // consistency and ease of computation; all systems expect to\n    // start from a common starting point to reduce complexity.\n    const raw = Object.fromEntries([\n      [\n        initFormat.slice(0, 3),\n        initSystem.toFloat(\n          tokens.slice(0, tokens.indexOf(SYMBOLS.DIVIDER)) as ToFloatArg,\n        ),\n      ],\n      [\n        initFormat.slice(3),\n        initSystem.toFloat(\n          tokens.slice(1 + tokens.indexOf(SYMBOLS.DIVIDER)) as ToFloatArg,\n        ),\n      ],\n    ]) as CoordinateInternalValue;\n\n    function to(\n      system: CoordinateSystem = initSystem,\n      format: Format = initFormat,\n    ) {\n      const key = system.name as keyof typeof coordinateSystems;\n\n      if (!cachedValues[key]?.[format]) {\n        // cache \"miss\" - fill the missing value in the cache before returning it\n\n        // update the cache to include the newly computed value\n        cachedValues[key] = {\n          ...cachedValues[key],\n          // use the Format to build the object, correctly pairing the halves of\n          // the coordinate value with their labels\n          [format]: system.toFormat(\n            format,\n            ([format.slice(0, 3), format.slice(3)] as Axes[]).map(\n              (key) => raw[key],\n            ) as [number, number],\n          ),\n        };\n      }\n\n      return cachedValues[key][format];\n    }\n\n    return freezeCoordinate([] as Coordinate['errors'], to, raw, true);\n  };\n}\n"]}

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

@@ -0,0 +1,8 @@
+import { Format } from '../internal/index.js';
+import { ParseResults } from '../internal/parse.js';
+import '../internal/lexer.js';
+
+/** Parse a Decimal Degrees coordinate. */
+declare const parseDecimalDegrees: (format: Format, input: string) => ParseResults;
+
+export { parseDecimalDegrees };

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

@@ -0,0 +1,77 @@
+import * as Patterning from '@/patterning.js';
+import { PARTIAL_PATTERNS, SYMBOLS, SYMBOL_PATTERNS, BEARINGS, LIMITS } from '../internal/index.js';
+import { createParser } from '../internal/parse-format.js';
+
+// src/coordinates/latlon/decimal-degrees/parser.ts
+var checks = {
+  deg: (deg, limit) => {
+    if (Number.parseFloat(deg) > limit) {
+      return `Degrees value (${deg}) exceeds max value (${limit}).`;
+    }
+  },
+  min: (val) => {
+    if (val.includes(SYMBOLS.MINUTES)) {
+      return `Seconds indicator (${SYMBOLS.MINUTES}) not valid in Decimal Degrees.`;
+    }
+  },
+  sec: (val) => {
+    if (val.includes(SYMBOLS.SECONDS)) {
+      return `Seconds indicator (${SYMBOLS.SECONDS}) not valid in Decimal Degrees.`;
+    }
+  }
+};
+var formats = {
+  LATLON: Patterning.fromTemplate(
+    PARTIAL_PATTERNS,
+    `degLatDec NS ${SYMBOLS.DIVIDER} degLonDec EW`
+  ),
+  LONLAT: Patterning.fromTemplate(
+    PARTIAL_PATTERNS,
+    `degLonDec EW ${SYMBOLS.DIVIDER} degLatDec NS`
+  )
+};
+function identifyErrors(format) {
+  return (arg, i) => {
+    if (!arg) {
+      return [[], ["Invalid coordinate value."]];
+    }
+    let { bear, deg } = arg;
+    deg ??= "0";
+    let isNegative = SYMBOL_PATTERNS.NEGATIVE_SIGN.test(deg) ? 1 : 0;
+    const bearingOptions = BEARINGS[format][i];
+    if (!bear || isNegative) {
+      bear = bearingOptions[isNegative];
+      deg = Math.abs(Number.parseFloat(deg)).toString();
+      isNegative = 0;
+    }
+    const errors = [
+      ...[checks.deg(deg, LIMITS[format][i] ?? 0)],
+      ...[checks.min([bear, deg].join(""))],
+      ...[checks.sec([bear, deg].join(""))]
+    ].filter(Boolean);
+    return errors.length ? [[], errors] : [[deg, bear], []];
+  };
+}
+function identifyPieces(half) {
+  if (half.length > 2 || half.length < 1) {
+    return;
+  }
+  const places = { bear: "", deg: "" };
+  return half.reduce((acc, token) => {
+    if (SYMBOL_PATTERNS.NSEW.test(token) && !acc.bear) {
+      acc.bear ||= token;
+    } else {
+      acc.deg ||= token;
+    }
+    return acc;
+  }, places);
+}
+var parseDecimalDegrees = createParser({
+  formats,
+  identifyErrors,
+  identifyPieces
+});
+
+export { parseDecimalDegrees };
+//# sourceMappingURL=parser.js.map
+//# sourceMappingURL=parser.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/coordinates/latlon/decimal-degrees/parser.ts"],"names":[],"mappings":"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","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 * as Patterning from '@/patterning';\n\nimport {\n  BEARINGS,\n  type Format,\n  LIMITS,\n  PARTIAL_PATTERNS,\n  SYMBOLS,\n  SYMBOL_PATTERNS,\n} from '../internal';\nimport type { ParseResults } from '../internal/parse';\nimport { createParser } from '../internal/parse-format';\n\ntype DecimalDegrees = {\n  bear: string;\n  deg: string;\n};\n\nconst checks = {\n  deg: (deg: string, limit: number) => {\n    if (Number.parseFloat(deg) > limit) {\n      return `Degrees value (${deg}) exceeds max value (${limit}).`;\n    }\n  },\n  min: (val: string) => {\n    if (val.includes(SYMBOLS.MINUTES)) {\n      return `Seconds indicator (${SYMBOLS.MINUTES}) not valid in Decimal Degrees.`;\n    }\n  },\n  sec: (val: string) => {\n    if (val.includes(SYMBOLS.SECONDS)) {\n      return `Seconds indicator (${SYMBOLS.SECONDS}) not valid in Decimal Degrees.`;\n    }\n  },\n};\n\nconst formats = {\n  LATLON: Patterning.fromTemplate(\n    PARTIAL_PATTERNS,\n    `degLatDec NS ${SYMBOLS.DIVIDER} degLonDec EW`,\n  ),\n  LONLAT: Patterning.fromTemplate(\n    PARTIAL_PATTERNS,\n    `degLonDec EW ${SYMBOLS.DIVIDER} degLatDec NS`,\n  ),\n};\n\nfunction identifyErrors(format: Format) {\n  return (arg: DecimalDegrees | undefined, i: number) => {\n    if (!arg) {\n      return [[], ['Invalid coordinate value.']] as ParseResults;\n    }\n\n    let { bear, deg } = arg;\n\n    deg ??= '0';\n\n    let isNegative: 0 | 1 = SYMBOL_PATTERNS.NEGATIVE_SIGN.test(deg) ? 1 : 0;\n    const bearingOptions = BEARINGS[format][i] as [string, string];\n\n    if (!bear || isNegative) {\n      bear = bearingOptions[isNegative];\n      deg = Math.abs(Number.parseFloat(deg)).toString();\n      isNegative = 0;\n    }\n\n    const errors = [\n      ...[checks.deg(deg, LIMITS[format][i] ?? 0)],\n      ...[checks.min([bear, deg].join(''))],\n      ...[checks.sec([bear, deg].join(''))],\n    ].filter(Boolean);\n\n    return (errors.length ? [[], errors] : [[deg, bear], []]) as ParseResults;\n  };\n}\n\nfunction identifyPieces(half: string[]) {\n  if (half.length > 2 || half.length < 1) {\n    return;\n  }\n\n  const places = { bear: '', deg: '' };\n\n  return half.reduce((acc, token) => {\n    if (SYMBOL_PATTERNS.NSEW.test(token) && !acc.bear) {\n      acc.bear ||= token;\n    } else {\n      acc.deg ||= token;\n    }\n\n    return acc;\n  }, places);\n}\n\n/** Parse a Decimal Degrees coordinate. */\nexport const parseDecimalDegrees = createParser<DecimalDegrees>({\n  formats,\n  identifyErrors,\n  identifyPieces,\n});\n"]}

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

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

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

@@ -0,0 +1,21 @@
+import { BEARINGS, SYMBOLS, SYMBOL_PATTERNS } from '../internal/index.js';
+import { parseDecimalDegrees } from './parser.js';
+
+// src/coordinates/latlon/decimal-degrees/system.ts
+var systemDecimalDegrees = {
+  name: "Decimal Degrees",
+  parse: parseDecimalDegrees,
+  toFloat(arg) {
+    const [num, bear] = arg;
+    return Number.parseFloat(num) * (SYMBOL_PATTERNS.NEGATIVE_BEARINGS.test(bear) ? -1 : 1);
+  },
+  toFormat(format, [left, right]) {
+    return [left, right].map(
+      (num, index) => `${Math.abs(num)} ${BEARINGS[format][index][+(num < 0)]}`
+    ).join(` ${SYMBOLS.DIVIDER} `);
+  }
+};
+
+export { systemDecimalDegrees };
+//# sourceMappingURL=system.js.map
+//# sourceMappingURL=system.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/coordinates/latlon/decimal-degrees/system.ts"],"names":[],"mappings":";;;;AAwBO,IAAM,oBAAyC,GAAA;AAAA,EACpD,IAAM,EAAA,iBAAA;AAAA,EAEN,KAAO,EAAA,mBAAA;AAAA,EAEP,QAAQ,GAAK,EAAA;AACX,IAAM,MAAA,CAAC,GAAK,EAAA,IAAI,CAAI,GAAA,GAAA;AAEpB,IACE,OAAA,MAAA,CAAO,WAAW,GAAG,CAAA,IACpB,gBAAgB,iBAAkB,CAAA,IAAA,CAAK,IAAI,CAAA,GAAI,EAAK,GAAA,CAAA,CAAA;AAAA,GAEzD;AAAA,EAEA,QAAS,CAAA,MAAA,EAAgB,CAAC,IAAA,EAAM,KAAK,CAAqB,EAAA;AACxD,IAAO,OAAA,CAAC,IAAM,EAAA,KAAK,CAChB,CAAA,GAAA;AAAA,MACC,CAAC,GAAK,EAAA,KAAA,KACJ,CAAG,EAAA,IAAA,CAAK,IAAI,GAAG,CAAC,CAAI,CAAA,EAAA,QAAA,CAAS,MAAM,CAAE,CAAA,KAAc,EAAE,EAAE,GAAA,GAAM,EAAE,CAAC,CAAA;AAAA,KAEnE,CAAA,IAAA,CAAK,CAAI,CAAA,EAAA,OAAA,CAAQ,OAAO,CAAG,CAAA,CAAA,CAAA;AAAA;AAElC","file":"system.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 {\n  BEARINGS,\n  type Compass,\n  type Format,\n  SYMBOLS,\n  SYMBOL_PATTERNS,\n} from '../internal';\nimport type { CoordinateSystem } from '../internal/coordinate-system';\n\nimport { parseDecimalDegrees } from './parser';\n\nexport const systemDecimalDegrees: CoordinateSystem = {\n  name: 'Decimal Degrees',\n\n  parse: parseDecimalDegrees,\n\n  toFloat(arg) {\n    const [num, bear] = arg as [string, Compass];\n\n    return (\n      Number.parseFloat(num) *\n      (SYMBOL_PATTERNS.NEGATIVE_BEARINGS.test(bear) ? -1 : 1)\n    );\n  },\n\n  toFormat(format: Format, [left, right]: [number, number]) {\n    return [left, right]\n      .map(\n        (num, index) =>\n          `${Math.abs(num)} ${BEARINGS[format][index as 0 | 1][+(num < 0)]}`,\n      )\n      .join(` ${SYMBOLS.DIVIDER} `);\n  },\n};\n"]}

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

@@ -0,0 +1,8 @@
+import { Format } from '../internal/index.js';
+import { ParseResults } from '../internal/parse.js';
+import '../internal/lexer.js';
+
+/** Parse a Degrees Decimal Minutes coordinate. */
+declare const parseDegreesDecimalMinutes: (format: Format, input: string) => ParseResults;
+
+export { parseDegreesDecimalMinutes };

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

@@ -0,0 +1,86 @@
+import * as Patterning from '@/patterning.js';
+import { PARTIAL_PATTERNS, SYMBOLS, SYMBOL_PATTERNS, BEARINGS, LIMITS } from '../internal/index.js';
+import { inRange } from '../internal/in-range.js';
+import { createParser } from '../internal/parse-format.js';
+
+// src/coordinates/latlon/degrees-decimal-minutes/parser.ts
+var checks = {
+  deg: (deg, limit) => {
+    if (Number.parseFloat(deg) > limit) {
+      return `Degrees value (${deg}) exceeds max value (${limit}).`;
+    }
+    if (/\./.test(deg)) {
+      return `Degrees value (${deg}) must not include decimal value.`;
+    }
+  },
+  min: (min) => inRange("Minutes", min, 59.999999999),
+  sec: (val) => {
+    if (val.includes(SYMBOLS.SECONDS)) {
+      return `Seconds indicator (${SYMBOLS.SECONDS}) not valid in Degree Decimal Minutes.`;
+    }
+  }
+};
+var formats = {
+  LATLON: Patterning.fromTemplate(
+    PARTIAL_PATTERNS,
+    `degLat minDec NS ${SYMBOLS.DIVIDER} degLon minDec EW`
+  ),
+  LONLAT: Patterning.fromTemplate(
+    PARTIAL_PATTERNS,
+    `degLon minDec EW ${SYMBOLS.DIVIDER} degLat minDec NS`
+  )
+};
+function identifyErrors(format) {
+  return (arg, i) => {
+    if (!arg) {
+      return [[], ["Invalid coordinate value."]];
+    }
+    let { bear, deg, min } = arg;
+    deg ??= "0";
+    min ??= "0";
+    let isNegative = SYMBOL_PATTERNS.NEGATIVE_SIGN.test(deg) ? 1 : 0;
+    const bearingOptions = BEARINGS[format][i];
+    if (!bear || isNegative) {
+      bear = bearingOptions[isNegative];
+      deg = Math.abs(Number.parseFloat(deg)).toString();
+      isNegative = 0;
+    }
+    const errors = [
+      ...[checks.deg(deg, LIMITS[format][i] ?? 0)],
+      ...[checks.min(min)],
+      ...[checks.sec([bear, deg, min].join(""))]
+    ].filter(Boolean);
+    return errors.length ? [[], errors] : [[deg, min, bear], []];
+  };
+}
+function identifyPieces(half) {
+  if (half.length < 1 || half.length > 3) {
+    return;
+  }
+  const asString = half.join(" ");
+  const places = { bear: "", deg: "", min: "" };
+  const keys = ["deg", "min"];
+  const test = (r, b, v) => r.test(v) || r.test(asString) && b;
+  return half.reduce((acc, token, i, { length }) => {
+    if (test(SYMBOL_PATTERNS.NSEW, i === length - 1, token)) {
+      acc.bear ||= token;
+    } else if (test(SYMBOL_PATTERNS.DEGREES, i === 0, token)) {
+      acc.deg ||= token;
+    } else if (test(SYMBOL_PATTERNS.MINUTES, i === 1, token)) {
+      acc.min ||= token;
+    } else {
+      const key = keys.find((k) => !acc[k]);
+      acc[key] = token;
+    }
+    return acc;
+  }, places);
+}
+var parseDegreesDecimalMinutes = createParser({
+  formats,
+  identifyErrors,
+  identifyPieces
+});
+
+export { parseDegreesDecimalMinutes };
+//# sourceMappingURL=parser.js.map
+//# sourceMappingURL=parser.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/coordinates/latlon/degrees-decimal-minutes/parser.ts"],"names":[],"mappings":"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","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 * as Patterning from '@/patterning';\n\nimport {\n  BEARINGS,\n  type Format,\n  LIMITS,\n  PARTIAL_PATTERNS,\n  SYMBOLS,\n  SYMBOL_PATTERNS,\n} from '../internal';\nimport { inRange } from '../internal/in-range';\nimport type { ParseResults } from '../internal/parse';\nimport { createParser } from '../internal/parse-format';\n\ntype DegreesDecimalMinutes = {\n  bear: string;\n  deg: string;\n  min: string;\n};\n\nconst checks = {\n  deg: (deg: string, limit: number) => {\n    if (Number.parseFloat(deg) > limit) {\n      return `Degrees value (${deg}) exceeds max value (${limit}).`;\n    }\n\n    if (/\\./.test(deg)) {\n      return `Degrees value (${deg}) must not include decimal value.`;\n    }\n  },\n  min: (min: string) => inRange('Minutes', min, 59.999999999),\n  sec: (val: string) => {\n    if (val.includes(SYMBOLS.SECONDS)) {\n      return `Seconds indicator (${SYMBOLS.SECONDS}) not valid in Degree Decimal Minutes.`;\n    }\n  },\n};\n\nconst formats = {\n  LATLON: Patterning.fromTemplate(\n    PARTIAL_PATTERNS,\n    `degLat minDec NS ${SYMBOLS.DIVIDER} degLon minDec EW`,\n  ),\n  LONLAT: Patterning.fromTemplate(\n    PARTIAL_PATTERNS,\n    `degLon minDec EW ${SYMBOLS.DIVIDER} degLat minDec NS`,\n  ),\n};\n\nfunction identifyErrors(format: Format) {\n  return (arg: DegreesDecimalMinutes | undefined, i: number) => {\n    if (!arg) {\n      return [[], ['Invalid coordinate value.']] as ParseResults;\n    }\n\n    let { bear, deg, min } = arg;\n\n    deg ??= '0';\n    min ??= '0';\n\n    let isNegative: 0 | 1 = SYMBOL_PATTERNS.NEGATIVE_SIGN.test(deg) ? 1 : 0;\n    const bearingOptions = BEARINGS[format][i] as [string, string];\n\n    if (!bear || isNegative) {\n      bear = bearingOptions[isNegative];\n      deg = Math.abs(Number.parseFloat(deg)).toString();\n      isNegative = 0;\n    }\n\n    const errors = [\n      ...[checks.deg(deg, LIMITS[format][i] ?? 0)],\n      ...[checks.min(min)],\n      ...[checks.sec([bear, deg, min].join(''))],\n    ].filter(Boolean);\n\n    return (\n      errors.length ? [[], errors] : [[deg, min, bear], []]\n    ) as ParseResults;\n  };\n}\n\nfunction identifyPieces(half: string[]) {\n  if (half.length < 1 || half.length > 3) {\n    return;\n  }\n\n  const asString = half.join(' ');\n  const places = { bear: '', deg: '', min: '' };\n  const keys = ['deg', 'min'] as (keyof typeof places)[];\n  const test = (r: RegExp, b: boolean, v: string) =>\n    r.test(v) || (r.test(asString) && b);\n\n  return half.reduce((acc, token, i, { length }) => {\n    if (test(SYMBOL_PATTERNS.NSEW, i === length - 1, token)) {\n      acc.bear ||= token;\n    } else if (test(SYMBOL_PATTERNS.DEGREES, i === 0, token)) {\n      acc.deg ||= token;\n    } else if (test(SYMBOL_PATTERNS.MINUTES, i === 1, token)) {\n      acc.min ||= token;\n    } else {\n      const key = keys.find((k) => !acc[k]);\n\n      acc[key as keyof typeof acc] = token;\n    }\n\n    return acc;\n  }, places);\n}\n\n/** Parse a Degrees Decimal Minutes coordinate. */\nexport const parseDegreesDecimalMinutes = createParser<DegreesDecimalMinutes>({\n  formats,\n  identifyErrors,\n  identifyPieces,\n});\n"]}

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

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

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

@@ -0,0 +1,26 @@
+import { BEARINGS, SYMBOLS, SYMBOL_PATTERNS } from '../internal/index.js';
+import { parseDegreesDecimalMinutes } from './parser.js';
+
+// src/coordinates/latlon/degrees-decimal-minutes/system.ts
+var systemDegreesDecimalMinutes = {
+  name: "Degrees Decimal Minutes",
+  parse: parseDegreesDecimalMinutes,
+  toFloat(arg) {
+    const [degrees, minutes, bear] = arg;
+    return Number.parseFloat(
+      ((Number.parseFloat(degrees) + Number.parseFloat(minutes) / 60) * (SYMBOL_PATTERNS.NEGATIVE_BEARINGS.test(bear) ? -1 : 1)).toFixed(9)
+    );
+  },
+  toFormat(format, [left, right]) {
+    return [left, right].map((num, index) => {
+      const abs = Math.abs(num);
+      const deg = Math.floor(abs);
+      const min = Number.parseFloat(((abs - deg) * 60).toFixed(9));
+      return `${deg} ${min} ${BEARINGS[format][index][+(num < 0)]}`;
+    }).join(` ${SYMBOLS.DIVIDER} `);
+  }
+};
+
+export { systemDegreesDecimalMinutes };
+//# sourceMappingURL=system.js.map
+//# sourceMappingURL=system.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/coordinates/latlon/degrees-decimal-minutes/system.ts"],"names":[],"mappings":";;;;AAwBO,IAAM,2BAAgD,GAAA;AAAA,EAC3D,IAAM,EAAA,yBAAA;AAAA,EAEN,KAAO,EAAA,0BAAA;AAAA,EAEP,QAAQ,GAAK,EAAA;AACX,IAAA,MAAM,CAAC,OAAA,EAAS,OAAS,EAAA,IAAI,CAAI,GAAA,GAAA;AAEjC,IAAA,OAAO,MAAO,CAAA,UAAA;AAAA,MAAA,CAAA,CAET,OAAO,UAAW,CAAA,OAAO,CAAI,GAAA,MAAA,CAAO,WAAW,OAAO,CAAA,GAAI,EAC1D,KAAA,eAAA,CAAgB,kBAAkB,IAAK,CAAA,IAAI,IAAI,EAAK,GAAA,CAAA,CAAA,EACrD,QAAQ,CAAC;AAAA,KACb;AAAA,GACF;AAAA,EAEA,QAAS,CAAA,MAAA,EAAgB,CAAC,IAAA,EAAM,KAAK,CAAqB,EAAA;AACxD,IAAA,OAAO,CAAC,IAAM,EAAA,KAAK,EAChB,GAAI,CAAA,CAAC,KAAK,KAAU,KAAA;AACnB,MAAM,MAAA,GAAA,GAAM,IAAK,CAAA,GAAA,CAAI,GAAG,CAAA;AACxB,MAAM,MAAA,GAAA,GAAM,IAAK,CAAA,KAAA,CAAM,GAAG,CAAA;AAC1B,MAAM,MAAA,GAAA,GAAM,OAAO,UAAa,CAAA,CAAA,CAAA,GAAA,GAAM,OAAO,EAAI,EAAA,OAAA,CAAQ,CAAC,CAAC,CAAA;AAE3D,MAAA,OAAO,CAAG,EAAA,GAAG,CAAI,CAAA,EAAA,GAAG,CAAI,CAAA,EAAA,QAAA,CAAS,MAAM,CAAA,CAAE,KAAc,CAAA,CAAE,EAAE,GAAA,GAAM,EAAE,CAAC,CAAA,CAAA;AAAA,KACrE,CACA,CAAA,IAAA,CAAK,CAAI,CAAA,EAAA,OAAA,CAAQ,OAAO,CAAG,CAAA,CAAA,CAAA;AAAA;AAElC","file":"system.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 {\n  BEARINGS,\n  type Compass,\n  type Format,\n  SYMBOLS,\n  SYMBOL_PATTERNS,\n} from '../internal';\nimport type { CoordinateSystem } from '../internal/coordinate-system';\n\nimport { parseDegreesDecimalMinutes } from './parser';\n\nexport const systemDegreesDecimalMinutes: CoordinateSystem = {\n  name: 'Degrees Decimal Minutes',\n\n  parse: parseDegreesDecimalMinutes,\n\n  toFloat(arg) {\n    const [degrees, minutes, bear] = arg as [string, string, Compass];\n\n    return Number.parseFloat(\n      (\n        (Number.parseFloat(degrees) + Number.parseFloat(minutes) / 60) *\n        (SYMBOL_PATTERNS.NEGATIVE_BEARINGS.test(bear) ? -1 : 1)\n      ).toFixed(9),\n    );\n  },\n\n  toFormat(format: Format, [left, right]: [number, number]) {\n    return [left, right]\n      .map((num, index) => {\n        const abs = Math.abs(num);\n        const deg = Math.floor(abs);\n        const min = Number.parseFloat(((abs - deg) * 60).toFixed(9));\n\n        return `${deg} ${min} ${BEARINGS[format][index as 0 | 1][+(num < 0)]}`;\n      })\n      .join(` ${SYMBOLS.DIVIDER} `);\n  },\n};\n"]}

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

@@ -0,0 +1,8 @@
+import { Format } from '../internal/index.js';
+import { ParseResults } from '../internal/parse.js';
+import '../internal/lexer.js';
+
+/** Parse a Degrees Minutes Seconds coordinate. */
+declare const parseDegreesMinutesSeconds: (format: Format, input: string) => ParseResults;
+
+export { parseDegreesMinutesSeconds };

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

@@ -0,0 +1,85 @@
+import * as Patterning from '@/patterning.js';
+import { PARTIAL_PATTERNS, SYMBOLS, SYMBOL_PATTERNS, BEARINGS, LIMITS } from '../internal/index.js';
+import { inRange } from '../internal/in-range.js';
+import { createParser } from '../internal/parse-format.js';
+
+// src/coordinates/latlon/degrees-minutes-seconds/parser.ts
+var checks = {
+  deg: (deg, limit) => {
+    if (Number.parseFloat(deg) > limit) {
+      return `Degrees value (${deg}) exceeds max value (${limit}).`;
+    }
+    if (/\./.test(deg)) {
+      return `Degrees value (${deg}) must not include decimal value.`;
+    }
+  },
+  min: (min) => inRange("Minutes", min, 59),
+  sec: (sec) => inRange("Seconds", sec, 59.999999999)
+};
+var formats = {
+  LATLON: Patterning.fromTemplate(
+    PARTIAL_PATTERNS,
+    `degLat min secDec NS ${SYMBOLS.DIVIDER} degLon min secDec EW`
+  ),
+  LONLAT: Patterning.fromTemplate(
+    PARTIAL_PATTERNS,
+    `degLon min secDec EW ${SYMBOLS.DIVIDER} degLat min secDec NS`
+  )
+};
+function identifyErrors(format) {
+  return (arg, i) => {
+    if (!arg) {
+      return [[], ["Invalid coordinate value."]];
+    }
+    let { bear, deg, min, sec } = arg;
+    deg ??= "0";
+    min ||= "0";
+    sec ||= "0";
+    let isNegative = SYMBOL_PATTERNS.NEGATIVE_SIGN.test(deg) ? 1 : 0;
+    const bearingOptions = BEARINGS[format][i];
+    if (!bear || isNegative) {
+      bear = bearingOptions[isNegative];
+      deg = Math.abs(Number.parseFloat(deg)).toString();
+      isNegative = 0;
+    }
+    const errors = [
+      ...[checks.deg(deg, LIMITS[format][i] ?? 0)],
+      ...[checks.min(min)],
+      ...[checks.sec(sec)]
+    ].filter(Boolean);
+    return errors.length ? [[], errors] : [[deg, min, sec, bear], []];
+  };
+}
+function identifyPieces(half) {
+  if (half.length < 1 || half.length > 4) {
+    return;
+  }
+  const asString = half.join(" ");
+  const places = { bear: "", deg: "", min: "", sec: "" };
+  const keys = ["deg", "min", "sec"];
+  const test = (r, b, v) => r.test(v) || r.test(asString) && b;
+  return half.reduce((acc, token, i, { length }) => {
+    if (test(SYMBOL_PATTERNS.NSEW, i === length - 1, token)) {
+      acc.bear ||= token;
+    } else if (test(SYMBOL_PATTERNS.DEGREES, i === 0, token)) {
+      acc.deg ||= token;
+    } else if (test(SYMBOL_PATTERNS.MINUTES, i === 1, token)) {
+      acc.min ||= token;
+    } else if (test(SYMBOL_PATTERNS.SECONDS, i === 2, token)) {
+      acc.sec ||= token;
+    } else {
+      const key = keys.find((k) => !acc[k]);
+      acc[key] = token;
+    }
+    return acc;
+  }, places);
+}
+var parseDegreesMinutesSeconds = createParser({
+  formats,
+  identifyErrors,
+  identifyPieces
+});
+
+export { parseDegreesMinutesSeconds };
+//# sourceMappingURL=parser.js.map
+//# sourceMappingURL=parser.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/coordinates/latlon/degrees-minutes-seconds/parser.ts"],"names":[],"mappings":"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","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 * as Patterning from '@/patterning';\n\nimport {\n  BEARINGS,\n  type Format,\n  LIMITS,\n  PARTIAL_PATTERNS,\n  SYMBOLS,\n  SYMBOL_PATTERNS,\n} from '../internal';\nimport { inRange } from '../internal/in-range';\nimport type { ParseResults } from '../internal/parse';\nimport { createParser } from '../internal/parse-format';\n\ntype DegreesMinutesSeconds = {\n  bear: string;\n  deg: string;\n  min: string;\n  sec: string;\n};\n\nconst checks = {\n  deg: (deg: string, limit: number) => {\n    if (Number.parseFloat(deg) > limit) {\n      return `Degrees value (${deg}) exceeds max value (${limit}).`;\n    }\n\n    if (/\\./.test(deg)) {\n      return `Degrees value (${deg}) must not include decimal value.`;\n    }\n  },\n  min: (min: string) => inRange('Minutes', min, 59),\n  sec: (sec: string) => inRange('Seconds', sec, 59.999999999),\n};\n\nconst formats = {\n  LATLON: Patterning.fromTemplate(\n    PARTIAL_PATTERNS,\n    `degLat min secDec NS ${SYMBOLS.DIVIDER} degLon min secDec EW`,\n  ),\n  LONLAT: Patterning.fromTemplate(\n    PARTIAL_PATTERNS,\n    `degLon min secDec EW ${SYMBOLS.DIVIDER} degLat min secDec NS`,\n  ),\n};\n\nfunction identifyErrors(format: Format) {\n  return (arg: DegreesMinutesSeconds | undefined, i: number) => {\n    if (!arg) {\n      return [[], ['Invalid coordinate value.']] as ParseResults;\n    }\n\n    let { bear, deg, min, sec } = arg;\n\n    deg ??= '0';\n    // NOTE: need `||=` not `??=` because empty-string is not nullish\n    min ||= '0';\n    sec ||= '0';\n\n    let isNegative: 0 | 1 = SYMBOL_PATTERNS.NEGATIVE_SIGN.test(deg) ? 1 : 0;\n    const bearingOptions = BEARINGS[format][i] as [string, string];\n\n    if (!bear || isNegative) {\n      bear = bearingOptions[isNegative];\n      deg = Math.abs(Number.parseFloat(deg)).toString();\n      isNegative = 0;\n    }\n\n    const errors = [\n      ...[checks.deg(deg, LIMITS[format][i] ?? 0)],\n      ...[checks.min(min)],\n      ...[checks.sec(sec)],\n    ].filter(Boolean);\n\n    return (\n      errors.length ? [[], errors] : [[deg, min, sec, bear], []]\n    ) as ParseResults;\n  };\n}\n\nfunction identifyPieces(half: string[]) {\n  if (half.length < 1 || half.length > 4) {\n    return;\n  }\n\n  const asString = half.join(' ');\n  const places = { bear: '', deg: '', min: '', sec: '' };\n  const keys = ['deg', 'min', 'sec'] as (keyof typeof places)[];\n  const test = (r: RegExp, b: boolean, v: string) =>\n    r.test(v) || (r.test(asString) && b);\n\n  return half.reduce((acc, token, i, { length }) => {\n    if (test(SYMBOL_PATTERNS.NSEW, i === length - 1, token)) {\n      acc.bear ||= token;\n    } else if (test(SYMBOL_PATTERNS.DEGREES, i === 0, token)) {\n      acc.deg ||= token;\n    } else if (test(SYMBOL_PATTERNS.MINUTES, i === 1, token)) {\n      acc.min ||= token;\n    } else if (test(SYMBOL_PATTERNS.SECONDS, i === 2, token)) {\n      acc.sec ||= token;\n    } else {\n      const key = keys.find((k) => !acc[k]);\n\n      acc[key as keyof typeof acc] = token;\n    }\n\n    return acc;\n  }, places);\n}\n\n/** Parse a Degrees Minutes Seconds coordinate. */\nexport const parseDegreesMinutesSeconds = createParser<DegreesMinutesSeconds>({\n  formats,\n  identifyErrors,\n  identifyPieces,\n});\n"]}