@accelint/geo 0.6.0 → 0.7.0

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":["Patterning.optional","Patterning.capture","Patterning.merge"],"sources":["../../../../src/coordinates/latlon/internal/index.ts"],"sourcesContent":["// __private-exports\n/*\n * Copyright 2024 Hypergiant Galactic Systems Inc. All rights reserved.\n * This file is licensed to you under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License. You may obtain a copy\n * of the License at https://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software distributed under\n * the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\n * OF ANY KIND, either express or implied. See the License for the specific language\n * governing permissions and limitations under the License.\n */\n\nimport * as Patterning from '@/patterning';\n\nexport type Axes = 'LAT' | 'LON';\nexport type Compass = 'N' | 'S' | 'E' | 'W';\nexport type Errors = string[];\nexport type Format = (typeof FORMATS)[number];\n\n/**\n * Bearings are the consistent/explicit identifiers of directionality of a\n * coordinate component; this library has opted for these over implicit\n * indication by number sign not because there is an inherent superiority\n * but because something had to be chosen.\n *\n * NOTE: these arrays are position-important; negative values are [1] and\n * positive values are [0] so that they can be consistently indexed using\n * an `isNegative` boolean to reference the negative bearing of each axis\n */\nexport const BEARINGS = {\n  LAT: ['N', 'S'],\n  LON: ['E', 'W'],\n  LATLON: [\n    ['N', 'S'],\n    ['E', 'W'],\n  ],\n  LONLAT: [\n    ['E', 'W'],\n    ['N', 'S'],\n  ],\n} as const;\n\nexport const FORMATS = ['LATLON', 'LONLAT'] as const;\nexport const FORMATS_DEFAULT = FORMATS[0];\n\nexport const LIMITS = { LATLON: [90, 180], LONLAT: [180, 90] } as const;\n\nexport const SYMBOLS = {\n  DEGREES: '°',\n  MINUTES: \"'\",\n  SECONDS: '\"',\n  DIVIDER: '/',\n};\n\nexport const SYMBOL_PATTERNS = {\n  LAT: new RegExp(`[${BEARINGS.LAT.join('')}]`),\n  LON: new RegExp(`[${BEARINGS.LON.join('')}]`),\n  NSEW: new RegExp(`[${[...BEARINGS.LAT, ...BEARINGS.LON].join('')}]`),\n  NEGATIVE_BEARINGS: /[SW]/i,\n  NEGATIVE_SIGN: /-/,\n\n  DEGREES: new RegExp(SYMBOLS.DEGREES),\n  MINUTES: new RegExp(SYMBOLS.MINUTES),\n  SECONDS: new RegExp(SYMBOLS.SECONDS),\n\n  DIVIDER: new RegExp(SYMBOLS.DIVIDER),\n\n  DMS: new RegExp(\n    `[${[SYMBOLS.DEGREES, SYMBOLS.MINUTES, SYMBOLS.SECONDS].join('')}]`,\n  ),\n\n  // divider: {\n  //   first: /(?<NAMED_SEPARATOR>:?)/,\n  //   follow: new RegExp(`\\\\s?\\\\k<${'NAMED_SEPARATOR'}>\\\\s?`),\n  // },\n} as const;\n\n/**\n * Creates a regex pattern for matching decimal minutes or seconds values.\n *\n * Generates a pattern that matches numeric values in the range 0-59.999... with optional\n * leading zeros, decimal points, and symbol indicators, using lookbehind and lookahead\n * to prevent partial matches within larger numbers.\n *\n * @param symbol - Regular expression for the symbol (minutes ' or seconds \" indicator).\n * @returns Combined regex pattern with precise boundary matching.\n *\n * @example\n * ```typescript\n * const minutesPattern = decimalSecAndMin(SYMBOL_PATTERNS.MINUTES);\n * // Matches: \"30.5'\", \"59.999999999\", \".5'\", \"001'\", etc.\n * ```\n *\n * @example\n * ```typescript\n * const secondsPattern = decimalSecAndMin(SYMBOL_PATTERNS.SECONDS);\n * // Matches: '45.23\"', '0.5', '59.9999999999\"', etc.\n * ```\n */\nconst decimalSecAndMin = (symbol: RegExp) =>\n  Patterning.optional(\n    // Negative lookbehind\n    // to ensure that the match is not preceded by a digit,\n    // avoiding partial matches within larger numbers.\n    /(?<!\\d)/,\n\n    // 0-59 including 10 decimal places and leading zeros or no number before\n    // acceptable values: 0, 0.1234567890, .9876543210, 001, 59.9999999999\n    /([-+]?0*(?:[0-5]?\\d|\\.\\d{1,10})(?:\\.\\d{1,10})?)/,\n\n    Patterning.optional(symbol),\n\n    // Negative lookahead\n    // to ensure that the match is not followed by a digit,\n    // avoiding partial matches within larger numbers.\n    /(?!\\d)/,\n  );\n\nexport const PARTIAL_PATTERNS = {\n  ' ': /\\s*/,\n  '/': Patterning.capture(SYMBOL_PATTERNS.DIVIDER),\n  NS: Patterning.optional(Patterning.capture(SYMBOL_PATTERNS.LAT)),\n  EW: Patterning.optional(Patterning.capture(SYMBOL_PATTERNS.LON)),\n\n  degLatDec: Patterning.merge(\n    Patterning.capture(\n      /0*(?:90(?:\\.0{1,10})?)/, // 90[.0]\n      /|/,\n      /(?:0?[0-8]?\\d(?:\\.\\d{1,10})?)/, // [0]0[.0]-89[.9]\n    ),\n    Patterning.optional(SYMBOL_PATTERNS.DEGREES),\n  ),\n  degLonDec: Patterning.merge(\n    Patterning.capture(\n      /(?:180(?:\\.0{1,10})?)/, // 180[.0]\n      /|/,\n      /(?:0*(?:\\d{1,2}|1[0-7]\\d)(?:\\.\\d{1,10})?)/, // [00]0[.0]-179[.9]\n    ),\n    Patterning.optional(SYMBOL_PATTERNS.DEGREES),\n  ),\n  degLat: Patterning.merge(\n    Patterning.capture(\n      /(?:0?90)/, // 90\n      /|/,\n      /(?:0?[0-8]?\\d)/, // [0]0-89\n    ),\n    Patterning.optional(SYMBOL_PATTERNS.DEGREES),\n  ),\n  degLon: Patterning.merge(\n    Patterning.capture(\n      /(?:180)/, // 180\n      /|/,\n      /(?:0*(?:\\d{1,2}|1[0-7]\\d))/, // [00]0-179\n    ),\n    Patterning.optional(SYMBOL_PATTERNS.DEGREES),\n  ),\n  min: Patterning.merge(\n    Patterning.optional(\n      Patterning.capture(\n        /(?:0?[0-5]?\\d)?/, // [0]0-59\n      ),\n      Patterning.optional(SYMBOL_PATTERNS.MINUTES),\n    ),\n  ),\n  minDec: decimalSecAndMin(SYMBOL_PATTERNS.MINUTES),\n  secDec: decimalSecAndMin(SYMBOL_PATTERNS.SECONDS),\n} as const;\n\nexport {\n  type CoordinateInput,\n  type CoordinateInternalValue,\n  type CoordinateObject,\n  type CoordinateTuple,\n  type LatLonTuple,\n  type LonLatTuple,\n  isCoordinateObject,\n  isCoordinateTuple,\n  normalizeObjectToLatLon,\n  tupleToLatLon,\n} from './normalize';\nexport {\n  isFiniteNumber,\n  validateNumericCoordinate,\n  validateSignedRange,\n} from './validate';\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;AA8BA,MAAa,WAAW;CACtB,KAAK,CAAC,KAAK,IAAI;CACf,KAAK,CAAC,KAAK,IAAI;CACf,QAAQ,CACN,CAAC,KAAK,IAAI,EACV,CAAC,KAAK,IAAI,CACX;CACD,QAAQ,CACN,CAAC,KAAK,IAAI,EACV,CAAC,KAAK,IAAI,CACX;CACF;AAED,MAAa,UAAU,CAAC,UAAU,SAAS;AAC3C,MAAa,kBAAkB,QAAQ;AAEvC,MAAa,SAAS;CAAE,QAAQ,CAAC,IAAI,IAAI;CAAE,QAAQ,CAAC,KAAK,GAAG;CAAE;AAE9D,MAAa,UAAU;CACrB,SAAS;CACT,SAAS;CACT,SAAS;CACT,SAAS;CACV;AAED,MAAa,kBAAkB;CAC7B,qBAAK,IAAI,OAAO,IAAI,SAAS,IAAI,KAAK,GAAG,CAAC,GAAG;CAC7C,qBAAK,IAAI,OAAO,IAAI,SAAS,IAAI,KAAK,GAAG,CAAC,GAAG;CAC7C,sBAAM,IAAI,OAAO,IAAI,CAAC,GAAG,SAAS,KAAK,GAAG,SAAS,IAAI,CAAC,KAAK,GAAG,CAAC,GAAG;CACpE,mBAAmB;CACnB,eAAe;CAEf,SAAS,IAAI,OAAO,QAAQ,QAAQ;CACpC,SAAS,IAAI,OAAO,QAAQ,QAAQ;CACpC,SAAS,IAAI,OAAO,QAAQ,QAAQ;CAEpC,SAAS,IAAI,OAAO,QAAQ,QAAQ;CAEpC,qBAAK,IAAI,OACP,IAAI;EAAC,QAAQ;EAAS,QAAQ;EAAS,QAAQ;EAAQ,CAAC,KAAK,GAAG,CAAC,GAClE;CAMF;;;;;;;;;;;;;;;;;;;;;;;AAwBD,MAAM,oBAAoB,WACxBA,SAIE,WAIA,mDAEAA,SAAoB,OAAO,EAK3B,SACD;AAEH,MAAa,mBAAmB;CAC9B,KAAK;CACL,KAAKC,QAAmB,gBAAgB,QAAQ;CAChD,IAAID,SAAoBC,QAAmB,gBAAgB,IAAI,CAAC;CAChE,IAAID,SAAoBC,QAAmB,gBAAgB,IAAI,CAAC;CAEhE,WAAWC,MACTD,QACE,0BACA,KACA,gCACD,EACDD,SAAoB,gBAAgB,QAAQ,CAC7C;CACD,WAAWE,MACTD,QACE,yBACA,KACA,4CACD,EACDD,SAAoB,gBAAgB,QAAQ,CAC7C;CACD,QAAQE,MACND,QACE,YACA,KACA,iBACD,EACDD,SAAoB,gBAAgB,QAAQ,CAC7C;CACD,QAAQE,MACND,QACE,WACA,KACA,6BACD,EACDD,SAAoB,gBAAgB,QAAQ,CAC7C;CACD,KAAKE,MACHF,SACEC,QACE,kBACD,EACDD,SAAoB,gBAAgB,QAAQ,CAC7C,CACF;CACD,QAAQ,iBAAiB,gBAAgB,QAAQ;CACjD,QAAQ,iBAAiB,gBAAgB,QAAQ;CAClD"}
+{"version":3,"file":"index.js","names":["Patterning.optional","Patterning.capture","Patterning.merge"],"sources":["../../../../src/coordinates/latlon/internal/index.ts"],"sourcesContent":["// __private-exports\n/*\n * Copyright 2024 Hypergiant Galactic Systems Inc. All rights reserved.\n * This file is licensed to you under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License. You may obtain a copy\n * of the License at https://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software distributed under\n * the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\n * OF ANY KIND, either express or implied. See the License for the specific language\n * governing permissions and limitations under the License.\n */\n\nimport * as Patterning from '@/patterning';\n\nexport type Axes = 'LAT' | 'LON';\nexport type Compass = 'N' | 'S' | 'E' | 'W';\nexport type Errors = string[];\nexport type Format = (typeof FORMATS)[number];\n\n/**\n * Bearings are the consistent/explicit identifiers of directionality of a\n * coordinate component; this library has opted for these over implicit\n * indication by number sign not because there is an inherent superiority\n * but because something had to be chosen.\n *\n * NOTE: these arrays are position-important; negative values are [1] and\n * positive values are [0] so that they can be consistently indexed using\n * an `isNegative` boolean to reference the negative bearing of each axis\n */\nexport const BEARINGS = {\n  LAT: ['N', 'S'],\n  LON: ['E', 'W'],\n  LATLON: [\n    ['N', 'S'],\n    ['E', 'W'],\n  ],\n  LONLAT: [\n    ['E', 'W'],\n    ['N', 'S'],\n  ],\n} as const;\n\nexport const FORMATS = ['LATLON', 'LONLAT'] as const;\nexport const FORMATS_DEFAULT = FORMATS[0];\n\nexport const LIMITS = { LATLON: [90, 180], LONLAT: [180, 90] } as const;\n\nexport const SYMBOLS = {\n  DEGREES: '°',\n  MINUTES: \"'\",\n  SECONDS: '\"',\n  DIVIDER: '/',\n};\n\nexport const SYMBOL_PATTERNS = {\n  LAT: new RegExp(`[${BEARINGS.LAT.join('')}]`),\n  LON: new RegExp(`[${BEARINGS.LON.join('')}]`),\n  NSEW: new RegExp(`[${[...BEARINGS.LAT, ...BEARINGS.LON].join('')}]`),\n  NEGATIVE_BEARINGS: /[SW]/i,\n  NEGATIVE_SIGN: /-/,\n\n  DEGREES: new RegExp(SYMBOLS.DEGREES),\n  MINUTES: new RegExp(SYMBOLS.MINUTES),\n  SECONDS: new RegExp(SYMBOLS.SECONDS),\n\n  DIVIDER: new RegExp(SYMBOLS.DIVIDER),\n\n  DMS: new RegExp(\n    `[${[SYMBOLS.DEGREES, SYMBOLS.MINUTES, SYMBOLS.SECONDS].join('')}]`,\n  ),\n\n  // divider: {\n  //   first: /(?<NAMED_SEPARATOR>:?)/,\n  //   follow: new RegExp(`\\\\s?\\\\k<${'NAMED_SEPARATOR'}>\\\\s?`),\n  // },\n} as const;\n\n/**\n * Creates a regex pattern for matching decimal minutes or seconds values.\n *\n * Generates a pattern that matches numeric values in the range 0-59.999... with optional\n * leading zeros, decimal points, and symbol indicators, using lookbehind and lookahead\n * to prevent partial matches within larger numbers.\n *\n * @param symbol - Regular expression for the symbol (minutes ' or seconds \" indicator).\n * @returns Combined regex pattern with precise boundary matching.\n *\n * @example\n * ```typescript\n * const minutesPattern = decimalSecAndMin(SYMBOL_PATTERNS.MINUTES);\n * // Matches: \"30.5'\", \"59.999999999\", \".5'\", \"001'\", etc.\n * ```\n *\n * @example\n * ```typescript\n * const secondsPattern = decimalSecAndMin(SYMBOL_PATTERNS.SECONDS);\n * // Matches: '45.23\"', '0.5', '59.9999999999\"', etc.\n * ```\n */\nconst decimalSecAndMin = (symbol: RegExp) =>\n  Patterning.optional(\n    // Negative lookbehind\n    // to ensure that the match is not preceded by a digit,\n    // avoiding partial matches within larger numbers.\n    /(?<!\\d)/,\n\n    // 0-59 including 10 decimal places and leading zeros or no number before\n    // acceptable values: 0, 0.1234567890, .9876543210, 001, 59.9999999999\n    /([-+]?0*(?:[0-5]?\\d|\\.\\d{1,10})(?:\\.\\d{1,10})?)/,\n\n    Patterning.optional(symbol),\n\n    // Negative lookahead\n    // to ensure that the match is not followed by a digit,\n    // avoiding partial matches within larger numbers.\n    /(?!\\d)/,\n  );\n\nexport const PARTIAL_PATTERNS = {\n  ' ': /\\s*/,\n  '/': Patterning.capture(SYMBOL_PATTERNS.DIVIDER),\n  NS: Patterning.optional(Patterning.capture(SYMBOL_PATTERNS.LAT)),\n  EW: Patterning.optional(Patterning.capture(SYMBOL_PATTERNS.LON)),\n\n  degLatDec: Patterning.merge(\n    Patterning.capture(\n      /0*(?:90(?:\\.0{1,10})?)/, // 90[.0]\n      /|/,\n      /(?:0?[0-8]?\\d(?:\\.\\d{1,10})?)/, // [0]0[.0]-89[.9]\n    ),\n    Patterning.optional(SYMBOL_PATTERNS.DEGREES),\n  ),\n  degLonDec: Patterning.merge(\n    Patterning.capture(\n      /(?:180(?:\\.0{1,10})?)/, // 180[.0]\n      /|/,\n      /(?:0*(?:\\d{1,2}|1[0-7]\\d)(?:\\.\\d{1,10})?)/, // [00]0[.0]-179[.9]\n    ),\n    Patterning.optional(SYMBOL_PATTERNS.DEGREES),\n  ),\n  degLat: Patterning.merge(\n    Patterning.capture(\n      /(?:0?90)/, // 90\n      /|/,\n      /(?:0?[0-8]?\\d)/, // [0]0-89\n    ),\n    Patterning.optional(SYMBOL_PATTERNS.DEGREES),\n  ),\n  degLon: Patterning.merge(\n    Patterning.capture(\n      /(?:180)/, // 180\n      /|/,\n      /(?:0*(?:\\d{1,2}|1[0-7]\\d))/, // [00]0-179\n    ),\n    Patterning.optional(SYMBOL_PATTERNS.DEGREES),\n  ),\n  min: Patterning.merge(\n    Patterning.optional(\n      Patterning.capture(\n        /(?:0?[0-5]?\\d)?/, // [0]0-59\n      ),\n      Patterning.optional(SYMBOL_PATTERNS.MINUTES),\n    ),\n  ),\n  minDec: decimalSecAndMin(SYMBOL_PATTERNS.MINUTES),\n  secDec: decimalSecAndMin(SYMBOL_PATTERNS.SECONDS),\n} as const;\n\nexport {\n  type CoordinateInput,\n  type CoordinateInternalValue,\n  type CoordinateObject,\n  type CoordinateTuple,\n  isCoordinateObject,\n  isCoordinateTuple,\n  type LatLonTuple,\n  type LonLatTuple,\n  normalizeObjectToLatLon,\n  tupleToLatLon,\n} from './normalize';\nexport { toPlainDecimalString } from './plain-decimal';\nexport {\n  isFiniteNumber,\n  isValidNumericCoordinate,\n  validateNumericCoordinate,\n  validateSignedRange,\n} from './validate';\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA8BA,MAAa,WAAW;CACtB,KAAK,CAAC,KAAK,IAAI;CACf,KAAK,CAAC,KAAK,IAAI;CACf,QAAQ,CACN,CAAC,KAAK,IAAI,EACV,CAAC,KAAK,IAAI,CACX;CACD,QAAQ,CACN,CAAC,KAAK,IAAI,EACV,CAAC,KAAK,IAAI,CACX;CACF;AAED,MAAa,UAAU,CAAC,UAAU,SAAS;AAC3C,MAAa,kBAAkB,QAAQ;AAEvC,MAAa,SAAS;CAAE,QAAQ,CAAC,IAAI,IAAI;CAAE,QAAQ,CAAC,KAAK,GAAG;CAAE;AAE9D,MAAa,UAAU;CACrB,SAAS;CACT,SAAS;CACT,SAAS;CACT,SAAS;CACV;AAED,MAAa,kBAAkB;CAC7B,qBAAK,IAAI,OAAO,IAAI,SAAS,IAAI,KAAK,GAAG,CAAC,GAAG;CAC7C,qBAAK,IAAI,OAAO,IAAI,SAAS,IAAI,KAAK,GAAG,CAAC,GAAG;CAC7C,sBAAM,IAAI,OAAO,IAAI,CAAC,GAAG,SAAS,KAAK,GAAG,SAAS,IAAI,CAAC,KAAK,GAAG,CAAC,GAAG;CACpE,mBAAmB;CACnB,eAAe;CAEf,SAAS,IAAI,OAAO,QAAQ,QAAQ;CACpC,SAAS,IAAI,OAAO,QAAQ,QAAQ;CACpC,SAAS,IAAI,OAAO,QAAQ,QAAQ;CAEpC,SAAS,IAAI,OAAO,QAAQ,QAAQ;CAEpC,qBAAK,IAAI,OACP,IAAI;EAAC,QAAQ;EAAS,QAAQ;EAAS,QAAQ;EAAQ,CAAC,KAAK,GAAG,CAAC,GAClE;CAMF;;;;;;;;;;;;;;;;;;;;;;;AAwBD,MAAM,oBAAoB,WACxBA,SAIE,WAIA,mDAEAA,SAAoB,OAAO,EAK3B,SACD;AAEH,MAAa,mBAAmB;CAC9B,KAAK;CACL,KAAKC,QAAmB,gBAAgB,QAAQ;CAChD,IAAID,SAAoBC,QAAmB,gBAAgB,IAAI,CAAC;CAChE,IAAID,SAAoBC,QAAmB,gBAAgB,IAAI,CAAC;CAEhE,WAAWC,MACTD,QACE,0BACA,KACA,gCACD,EACDD,SAAoB,gBAAgB,QAAQ,CAC7C;CACD,WAAWE,MACTD,QACE,yBACA,KACA,4CACD,EACDD,SAAoB,gBAAgB,QAAQ,CAC7C;CACD,QAAQE,MACND,QACE,YACA,KACA,iBACD,EACDD,SAAoB,gBAAgB,QAAQ,CAC7C;CACD,QAAQE,MACND,QACE,WACA,KACA,6BACD,EACDD,SAAoB,gBAAgB,QAAQ,CAC7C;CACD,KAAKE,MACHF,SACEC,QACE,kBACD,EACDD,SAAoB,gBAAgB,QAAQ,CAC7C,CACF;CACD,QAAQ,iBAAiB,gBAAgB,QAAQ;CACjD,QAAQ,iBAAiB,gBAAgB,QAAQ;CAClD"}

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

@@ -1,5 +1,5 @@
 /*
- * Copyright 2025 Hypergiant Galactic Systems Inc. All rights reserved.
+ * Copyright 2026 Hypergiant Galactic Systems Inc. All rights reserved.
  * This file is licensed to you under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License. You may obtain a copy
  * of the License at https://www.apache.org/licenses/LICENSE-2.0
@@ -12,6 +12,7 @@
 
 
 import { capture, group, merge, optional } from "../../../patterning.js";
+import { toPlainDecimalString } from "./plain-decimal.js";
 import { SYMBOLS, SYMBOL_PATTERNS } from "./index.js";
 
 //#region src/coordinates/latlon/internal/lexer.ts
@@ -62,7 +63,7 @@ const TOKENS = new RegExp(merge(DIVIDERS, /|/, SYMBOL_PATTERNS.NSEW, /|/, group(
 */
 function fixLeadingAndTrailing(t) {
 	const [sign, num, pos] = (FLOATS.exec(t) ?? []).slice(1);
-	if (num) return `${sign}${Number.parseFloat(num)}${pos}`;
+	if (num) return `${sign}${toPlainDecimalString(Number.parseFloat(num))}${pos}`;
 	return t;
 }
 /**

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

@@ -1 +1 @@
-{"version":3,"file":"lexer.js","names":["Patterning.merge","Patterning.capture","Patterning.group","Patterning.optional"],"sources":["../../../../src/coordinates/latlon/internal/lexer.ts"],"sourcesContent":["// __private-exports\n/*\n * Copyright 2024 Hypergiant Galactic Systems Inc. All rights reserved.\n * This file is licensed to you under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License. You may obtain a copy\n * of the License at https://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software distributed under\n * the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\n * OF ANY KIND, either express or implied. See the License for the specific language\n * governing permissions and limitations under the License.\n */\n\nimport * as Patterning from '@/patterning';\nimport { SYMBOL_PATTERNS, SYMBOLS } from '.';\n\nexport type Tokens = ReturnType<typeof lexer>;\n\n/**\n * Separating latitude from longitude portions of a coordinate. At this level\n * of pattern matching this list can not include the \"space\" character since\n * that is valid between components of either side of a divider; higher level\n * parsers will be able to make up for this shortcoming and be more intelligent\n * about deducing where a divider could be added or would not be valid.\n */\nconst DIVIDERS = /[,/]/g;\nconst FLOATS = /^(-?)([\\d.]+)([^.\\d]?)$/;\n/** Positional indicators for: degrees, minutes, and seconds */\nconst POSITIONAL = new RegExp(\n  Patterning.merge(/\\s*/, Patterning.capture(SYMBOL_PATTERNS.DMS), /\\s*/),\n  'g',\n);\nconst POSITIVE = /\\+/g;\nconst SIGNS = /([-+])\\s*/g;\n/**\n * Any recognizably significant tokens anywhere (non-positional-y) within a\n * string; because at this level (lexing) actual position is not important.\n *\n * - [Regex Vis](https://regex-vis.com/?r=%2F%5B%2C%2F%5D%7C%5BNSEW%5D%7C%28%3F%3A%5B-%2B%5D%3F%28%3F%3A%28%3F%3A%5Cd%2B%28%3F%3A%5C.%5Cd*%29%3F%29%7C%28%3F%3A%5C.%5Cd%2B%29%29%28%3F%3A%5B%C2%B0%27%22%5D%29%3F%29%2Fgi)\n * - [Nodexr](https://www.nodexr.net/?parse=%2F%5B,%2F%5D%7C%5BNSEW%5D%7C(%3F%3A%5B-%2B%5D%3F(%3F%3A(%3F%3A%5Cd%2B(%3F%3A%5C.%5Cd*)%3F)%7C(%3F%3A%5C.%5Cd%2B))%5B%C2%B0%27%22%5D%3F)%2Fgi)\n */\n// NOTE: the links (above) for \"Regex Vis\" and \"Nodexr\" would need to be updated if/when the pattern is changed.\nconst TOKENS = new RegExp(\n  Patterning.merge(\n    DIVIDERS,\n    /|/,\n    SYMBOL_PATTERNS.NSEW,\n    /|/,\n    Patterning.group(\n      /[-+]?/,\n      Patterning.group(\n        // left of decimal REQUIRED, right of decimal optional\n        /(?:\\d+(?:\\.\\d*)?)|/,\n        // left of decimal omitted, right of decimal REQUIRED\n        /(?:\\.\\d+)/,\n      ),\n      Patterning.optional(SYMBOL_PATTERNS.DMS),\n    ),\n  ),\n  'gi',\n);\n\n/**\n * Remove trailing zeros '?.0' and ensure leading zero '0.?' in numbers.\n *\n * @param t - Token string to normalize.\n * @returns Normalized token with cleaned numeric formatting.\n *\n * @example\n * ```typescript\n * fixLeadingAndTrailing('45.0°');\n * // '45°'\n * ```\n *\n * @example\n * ```typescript\n * fixLeadingAndTrailing('.5'');\n * // '0.5''\n * ```\n *\n * @example\n * ```typescript\n * fixLeadingAndTrailing('-122.00');\n * // '-122'\n * ```\n */\nfunction fixLeadingAndTrailing(t: string) {\n  const [sign, num, pos] = (FLOATS.exec(t) ?? []).slice(1);\n\n  if (num) {\n    return `${sign}${Number.parseFloat(num)}${pos}`;\n  }\n\n  return t;\n}\n\n/**\n * Take an input string - possibly from user input - and clean it up enough to\n * be something to work with at a higher level of processing (with more\n * information) than is available at this level. Generating a list of \"tokens\"\n * that are potentially valid parts of a coordinate. The values being looked\n * for are: numbers (with positional indicators) and axes (NSEW).\n *\n * NOTE: No validation is done at this level to keep it simple as agnostic.\n *\n * @remarks\n * pure function\n *\n * @example\n * ```typescript\n * lexer('N 55,E 44') === ['N' '55', '/', 'E', '44']\n * lexer(` + 89  ° 59   59.999 \" N, 179° 59 59.999\"  `) === ['89', '59', '59.999', 'N', '/', '179', '59', '59.999', 'E']\n * ```\n */\nexport function lexer(input: string) {\n  const tokens =\n    input\n      .trim()\n      .toUpperCase()\n      .replace(POSITIVE, '') // positive signs are redundant\n      .replace(POSITIONAL, '$1 ') // group positional indicators with numbers\n      .replace(SIGNS, '$1') // group signs with numbers\n      .replace(DIVIDERS, SYMBOLS.DIVIDER) // standardize the divider\n      .match(TOKENS)\n      ?.map(fixLeadingAndTrailing)\n      ?.slice() ?? [];\n\n  return tokens;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;AAyBA,MAAM,WAAW;AACjB,MAAM,SAAS;;AAEf,MAAM,aAAa,IAAI,OACrBA,MAAiB,OAAOC,QAAmB,gBAAgB,IAAI,EAAE,MAAM,EACvE,IACD;AACD,MAAM,WAAW;AACjB,MAAM,QAAQ;;;;;;;;AASd,MAAM,SAAS,IAAI,OACjBD,MACE,UACA,KACA,gBAAgB,MAChB,KACAE,MACE,SACAA,MAEE,sBAEA,YACD,EACDC,SAAoB,gBAAgB,IAAI,CACzC,CACF,EACD,KACD;;;;;;;;;;;;;;;;;;;;;;;;;AA0BD,SAAS,sBAAsB,GAAW;CACxC,MAAM,CAAC,MAAM,KAAK,QAAQ,OAAO,KAAK,EAAE,IAAI,EAAE,EAAE,MAAM,EAAE;AAExD,KAAI,IACF,QAAO,GAAG,OAAO,OAAO,WAAW,IAAI,GAAG;AAG5C,QAAO;;;;;;;;;;;;;;;;;;;;AAqBT,SAAgB,MAAM,OAAe;AAanC,QAXE,MACG,MAAM,CACN,aAAa,CACb,QAAQ,UAAU,GAAG,CACrB,QAAQ,YAAY,MAAM,CAC1B,QAAQ,OAAO,KAAK,CACpB,QAAQ,UAAU,QAAQ,QAAQ,CAClC,MAAM,OAAO,EACZ,IAAI,sBAAsB,EAC1B,OAAO,IAAI,EAAE"}
+{"version":3,"file":"lexer.js","names":["Patterning.merge","Patterning.capture","Patterning.group","Patterning.optional"],"sources":["../../../../src/coordinates/latlon/internal/lexer.ts"],"sourcesContent":["// __private-exports\n/*\n * Copyright 2024 Hypergiant Galactic Systems Inc. All rights reserved.\n * This file is licensed to you under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License. You may obtain a copy\n * of the License at https://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software distributed under\n * the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\n * OF ANY KIND, either express or implied. See the License for the specific language\n * governing permissions and limitations under the License.\n */\n\nimport * as Patterning from '@/patterning';\nimport { SYMBOL_PATTERNS, SYMBOLS } from '.';\nimport { toPlainDecimalString } from './plain-decimal';\n\nexport type Tokens = ReturnType<typeof lexer>;\n\n/**\n * Separating latitude from longitude portions of a coordinate. At this level\n * of pattern matching this list can not include the \"space\" character since\n * that is valid between components of either side of a divider; higher level\n * parsers will be able to make up for this shortcoming and be more intelligent\n * about deducing where a divider could be added or would not be valid.\n */\nconst DIVIDERS = /[,/]/g;\nconst FLOATS = /^(-?)([\\d.]+)([^.\\d]?)$/;\n/** Positional indicators for: degrees, minutes, and seconds */\nconst POSITIONAL = new RegExp(\n  Patterning.merge(/\\s*/, Patterning.capture(SYMBOL_PATTERNS.DMS), /\\s*/),\n  'g',\n);\nconst POSITIVE = /\\+/g;\nconst SIGNS = /([-+])\\s*/g;\n/**\n * Any recognizably significant tokens anywhere (non-positional-y) within a\n * string; because at this level (lexing) actual position is not important.\n *\n * - [Regex Vis](https://regex-vis.com/?r=%2F%5B%2C%2F%5D%7C%5BNSEW%5D%7C%28%3F%3A%5B-%2B%5D%3F%28%3F%3A%28%3F%3A%5Cd%2B%28%3F%3A%5C.%5Cd*%29%3F%29%7C%28%3F%3A%5C.%5Cd%2B%29%29%28%3F%3A%5B%C2%B0%27%22%5D%29%3F%29%2Fgi)\n * - [Nodexr](https://www.nodexr.net/?parse=%2F%5B,%2F%5D%7C%5BNSEW%5D%7C(%3F%3A%5B-%2B%5D%3F(%3F%3A(%3F%3A%5Cd%2B(%3F%3A%5C.%5Cd*)%3F)%7C(%3F%3A%5C.%5Cd%2B))%5B%C2%B0%27%22%5D%3F)%2Fgi)\n */\n// NOTE: the links (above) for \"Regex Vis\" and \"Nodexr\" would need to be updated if/when the pattern is changed.\nconst TOKENS = new RegExp(\n  Patterning.merge(\n    DIVIDERS,\n    /|/,\n    SYMBOL_PATTERNS.NSEW,\n    /|/,\n    Patterning.group(\n      /[-+]?/,\n      Patterning.group(\n        // left of decimal REQUIRED, right of decimal optional\n        /(?:\\d+(?:\\.\\d*)?)|/,\n        // left of decimal omitted, right of decimal REQUIRED\n        /(?:\\.\\d+)/,\n      ),\n      Patterning.optional(SYMBOL_PATTERNS.DMS),\n    ),\n  ),\n  'gi',\n);\n\n/**\n * Remove trailing zeros '?.0' and ensure leading zero '0.?' in numbers.\n *\n * @param t - Token string to normalize.\n * @returns Normalized token with cleaned numeric formatting.\n *\n * @example\n * ```typescript\n * fixLeadingAndTrailing('45.0°');\n * // '45°'\n * ```\n *\n * @example\n * ```typescript\n * fixLeadingAndTrailing('.5'');\n * // '0.5''\n * ```\n *\n * @example\n * ```typescript\n * fixLeadingAndTrailing('-122.00');\n * // '-122'\n * ```\n */\nfunction fixLeadingAndTrailing(t: string) {\n  const [sign, num, pos] = (FLOATS.exec(t) ?? []).slice(1);\n\n  if (num) {\n    // Plain notation: `${1e-7}` would be '1e-7', whose '-7' re-lexes as a sign.\n    return `${sign}${toPlainDecimalString(Number.parseFloat(num))}${pos}`;\n  }\n\n  return t;\n}\n\n/**\n * Take an input string - possibly from user input - and clean it up enough to\n * be something to work with at a higher level of processing (with more\n * information) than is available at this level. Generating a list of \"tokens\"\n * that are potentially valid parts of a coordinate. The values being looked\n * for are: numbers (with positional indicators) and axes (NSEW).\n *\n * NOTE: No validation is done at this level to keep it simple as agnostic.\n *\n * @remarks\n * pure function\n *\n * @example\n * ```typescript\n * lexer('N 55,E 44') === ['N' '55', '/', 'E', '44']\n * lexer(` + 89  ° 59   59.999 \" N, 179° 59 59.999\"  `) === ['89', '59', '59.999', 'N', '/', '179', '59', '59.999', 'E']\n * ```\n */\nexport function lexer(input: string) {\n  const tokens =\n    input\n      .trim()\n      .toUpperCase()\n      .replace(POSITIVE, '') // positive signs are redundant\n      .replace(POSITIONAL, '$1 ') // group positional indicators with numbers\n      .replace(SIGNS, '$1') // group signs with numbers\n      .replace(DIVIDERS, SYMBOLS.DIVIDER) // standardize the divider\n      .match(TOKENS)\n      ?.map(fixLeadingAndTrailing)\n      ?.slice() ?? [];\n\n  return tokens;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;AA0BA,MAAM,WAAW;AACjB,MAAM,SAAS;;AAEf,MAAM,aAAa,IAAI,OACrBA,MAAiB,OAAOC,QAAmB,gBAAgB,IAAI,EAAE,MAAM,EACvE,IACD;AACD,MAAM,WAAW;AACjB,MAAM,QAAQ;;;;;;;;AASd,MAAM,SAAS,IAAI,OACjBD,MACE,UACA,KACA,gBAAgB,MAChB,KACAE,MACE,SACAA,MAEE,sBAEA,YACD,EACDC,SAAoB,gBAAgB,IAAI,CACzC,CACF,EACD,KACD;;;;;;;;;;;;;;;;;;;;;;;;;AA0BD,SAAS,sBAAsB,GAAW;CACxC,MAAM,CAAC,MAAM,KAAK,QAAQ,OAAO,KAAK,EAAE,IAAI,EAAE,EAAE,MAAM,EAAE;AAExD,KAAI,IAEF,QAAO,GAAG,OAAO,qBAAqB,OAAO,WAAW,IAAI,CAAC,GAAG;AAGlE,QAAO;;;;;;;;;;;;;;;;;;;;AAqBT,SAAgB,MAAM,OAAe;AAanC,QAXE,MACG,MAAM,CACN,aAAa,CACb,QAAQ,UAAU,GAAG,CACrB,QAAQ,YAAY,MAAM,CAC1B,QAAQ,OAAO,KAAK,CACpB,QAAQ,UAAU,QAAQ,QAAQ,CAClC,MAAM,OAAO,EACZ,IAAI,sBAAsB,EAC1B,OAAO,IAAI,EAAE"}

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

@@ -1,5 +1,5 @@
 /*
- * Copyright 2025 Hypergiant Galactic Systems Inc. All rights reserved.
+ * Copyright 2026 Hypergiant Galactic Systems Inc. All rights reserved.
  * This file is licensed to you under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License. You may obtain a copy
  * of the License at https://www.apache.org/licenses/LICENSE-2.0

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

@@ -1,11 +1,47 @@
 //#region src/coordinates/latlon/internal/ordinal.d.ts
+/**
+ * Axis discriminator for a single coordinate value.
+ *
+ * `'lat'` selects the N/S hemisphere pair; `'lon'` selects E/W.
+ */
+type Axis = 'lat' | 'lon';
+/**
+ * Hemisphere letter for a coordinate value, following geo's `>= 0`
+ * convention (0 maps to `N` on the lat axis and `E` on the lon axis).
+ */
+type Hemisphere = 'N' | 'S' | 'E' | 'W';
+/**
+ * Gets the typed hemisphere letter for a signed coordinate value on an axis.
+ *
+ * Follows the same `>= 0` convention as {@link getOrdinal}: a value of exactly
+ * `0` maps to `N` on the latitude axis and `E` on the longitude axis.
+ *
+ * @param value - The signed coordinate value.
+ * @param axis - Whether the value is a latitude (`'lat'`) or longitude (`'lon'`).
+ * @returns Hemisphere letter: `'N'`, `'S'`, `'E'`, or `'W'`.
+ *
+ * @remarks pure function
+ *
+ * @example
+ * ```typescript
+ * getHemisphere(-77.0369, 'lon');
+ * // 'W'
+ * ```
+ */
+declare const getHemisphere: (value: number, axis: Axis) => Hemisphere;
 /**
  * Gets the ordinal direction (N/S/E/W) for a coordinate value.
  *
- * @param num - The coordinate value (positive or negative).
+ * Retained as the established public API. Adapts {@link getHemisphere} — which
+ * owns the `>= 0` convention — to a boolean axis and the wider `string` return
+ * its existing callers expect.
+ *
+ * @param value - The coordinate value (positive or negative).
  * @param isLatitude - Whether this is a latitude coordinate (true) or longitude (false).
  * @returns Ordinal direction character: 'N', 'S', 'E', or 'W'.
  *
+ * @remarks pure function
+ *
  * @example
  * ```typescript
  * getOrdinal(37.7749, true);
@@ -17,14 +53,8 @@
  * getOrdinal(-122.4194, false);
  * // 'W'
  * ```
- *
- * @example
- * ```typescript
- * getOrdinal(-45, true);
- * // 'S'
- * ```
  */
-declare const getOrdinal: (num: number, isLatitude: boolean) => string;
+declare const getOrdinal: (value: number, isLatitude: boolean) => string;
 //#endregion
-export { getOrdinal };
+export { Axis, Hemisphere, getHemisphere, getOrdinal };
 //# sourceMappingURL=ordinal.d.ts.map

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

@@ -1,5 +1,5 @@
 /*
- * Copyright 2025 Hypergiant Galactic Systems Inc. All rights reserved.
+ * Copyright 2026 Hypergiant Galactic Systems Inc. All rights reserved.
  * This file is licensed to you under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License. You may obtain a copy
  * of the License at https://www.apache.org/licenses/LICENSE-2.0
@@ -13,12 +13,40 @@
 
 //#region src/coordinates/latlon/internal/ordinal.ts
 /**
+* Gets the typed hemisphere letter for a signed coordinate value on an axis.
+*
+* Follows the same `>= 0` convention as {@link getOrdinal}: a value of exactly
+* `0` maps to `N` on the latitude axis and `E` on the longitude axis.
+*
+* @param value - The signed coordinate value.
+* @param axis - Whether the value is a latitude (`'lat'`) or longitude (`'lon'`).
+* @returns Hemisphere letter: `'N'`, `'S'`, `'E'`, or `'W'`.
+*
+* @remarks pure function
+*
+* @example
+* ```typescript
+* getHemisphere(-77.0369, 'lon');
+* // 'W'
+* ```
+*/
+const getHemisphere = (value, axis) => {
+	if (axis === "lat") return value >= 0 ? "N" : "S";
+	return value >= 0 ? "E" : "W";
+};
+/**
 * Gets the ordinal direction (N/S/E/W) for a coordinate value.
 *
-* @param num - The coordinate value (positive or negative).
+* Retained as the established public API. Adapts {@link getHemisphere} — which
+* owns the `>= 0` convention — to a boolean axis and the wider `string` return
+* its existing callers expect.
+*
+* @param value - The coordinate value (positive or negative).
 * @param isLatitude - Whether this is a latitude coordinate (true) or longitude (false).
 * @returns Ordinal direction character: 'N', 'S', 'E', or 'W'.
 *
+* @remarks pure function
+*
 * @example
 * ```typescript
 * getOrdinal(37.7749, true);
@@ -30,18 +58,9 @@
 * getOrdinal(-122.4194, false);
 * // 'W'
 * ```
-*
-* @example
-* ```typescript
-* getOrdinal(-45, true);
-* // 'S'
-* ```
 */
-const getOrdinal = (num, isLatitude) => {
-	if (isLatitude) return num >= 0 ? "N" : "S";
-	return num >= 0 ? "E" : "W";
-};
+const getOrdinal = (value, isLatitude) => getHemisphere(value, isLatitude ? "lat" : "lon");
 
 //#endregion
-export { getOrdinal };
+export { getHemisphere, getOrdinal };
 //# sourceMappingURL=ordinal.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"ordinal.js","names":[],"sources":["../../../../src/coordinates/latlon/internal/ordinal.ts"],"sourcesContent":["/*\n * Copyright 2025 Hypergiant Galactic Systems Inc. All rights reserved.\n * This file is licensed to you under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License. You may obtain a copy\n * of the License at https://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software distributed under\n * the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\n * OF ANY KIND, either express or implied. See the License for the specific language\n * governing permissions and limitations under the License.\n */\n\n// __private-exports\n\n/**\n * Gets the ordinal direction (N/S/E/W) for a coordinate value.\n *\n * @param num - The coordinate value (positive or negative).\n * @param isLatitude - Whether this is a latitude coordinate (true) or longitude (false).\n * @returns Ordinal direction character: 'N', 'S', 'E', or 'W'.\n *\n * @example\n * ```typescript\n * getOrdinal(37.7749, true);\n * // 'N'\n * ```\n *\n * @example\n * ```typescript\n * getOrdinal(-122.4194, false);\n * // 'W'\n * ```\n *\n * @example\n * ```typescript\n * getOrdinal(-45, true);\n * // 'S'\n * ```\n */\nexport const getOrdinal = (num: number, isLatitude: boolean): string => {\n  if (isLatitude) {\n    return num >= 0 ? 'N' : 'S';\n  }\n  return num >= 0 ? 'E' : 'W';\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAuCA,MAAa,cAAc,KAAa,eAAgC;AACtE,KAAI,WACF,QAAO,OAAO,IAAI,MAAM;AAE1B,QAAO,OAAO,IAAI,MAAM"}
+{"version":3,"file":"ordinal.js","names":[],"sources":["../../../../src/coordinates/latlon/internal/ordinal.ts"],"sourcesContent":["/*\n * Copyright 2026 Hypergiant Galactic Systems Inc. All rights reserved.\n * This file is licensed to you under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License. You may obtain a copy\n * of the License at https://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software distributed under\n * the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\n * OF ANY KIND, either express or implied. See the License for the specific language\n * governing permissions and limitations under the License.\n */\n\n// __private-exports\n\n/**\n * Axis discriminator for a single coordinate value.\n *\n * `'lat'` selects the N/S hemisphere pair; `'lon'` selects E/W.\n */\nexport type Axis = 'lat' | 'lon';\n\n/**\n * Hemisphere letter for a coordinate value, following geo's `>= 0`\n * convention (0 maps to `N` on the lat axis and `E` on the lon axis).\n */\nexport type Hemisphere = 'N' | 'S' | 'E' | 'W';\n\n/**\n * Gets the typed hemisphere letter for a signed coordinate value on an axis.\n *\n * Follows the same `>= 0` convention as {@link getOrdinal}: a value of exactly\n * `0` maps to `N` on the latitude axis and `E` on the longitude axis.\n *\n * @param value - The signed coordinate value.\n * @param axis - Whether the value is a latitude (`'lat'`) or longitude (`'lon'`).\n * @returns Hemisphere letter: `'N'`, `'S'`, `'E'`, or `'W'`.\n *\n * @remarks pure function\n *\n * @example\n * ```typescript\n * getHemisphere(-77.0369, 'lon');\n * // 'W'\n * ```\n */\nexport const getHemisphere = (value: number, axis: Axis): Hemisphere => {\n  if (axis === 'lat') {\n    return value >= 0 ? 'N' : 'S';\n  }\n\n  return value >= 0 ? 'E' : 'W';\n};\n\n/**\n * Gets the ordinal direction (N/S/E/W) for a coordinate value.\n *\n * Retained as the established public API. Adapts {@link getHemisphere} — which\n * owns the `>= 0` convention — to a boolean axis and the wider `string` return\n * its existing callers expect.\n *\n * @param value - The coordinate value (positive or negative).\n * @param isLatitude - Whether this is a latitude coordinate (true) or longitude (false).\n * @returns Ordinal direction character: 'N', 'S', 'E', or 'W'.\n *\n * @remarks pure function\n *\n * @example\n * ```typescript\n * getOrdinal(37.7749, true);\n * // 'N'\n * ```\n *\n * @example\n * ```typescript\n * getOrdinal(-122.4194, false);\n * // 'W'\n * ```\n */\nexport const getOrdinal = (value: number, isLatitude: boolean): string =>\n  getHemisphere(value, isLatitude ? 'lat' : 'lon');\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA6CA,MAAa,iBAAiB,OAAe,SAA2B;AACtE,KAAI,SAAS,MACX,QAAO,SAAS,IAAI,MAAM;AAG5B,QAAO,SAAS,IAAI,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;AA4B5B,MAAa,cAAc,OAAe,eACxC,cAAc,OAAO,aAAa,QAAQ,MAAM"}

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

@@ -1,5 +1,5 @@
 /*
- * Copyright 2025 Hypergiant Galactic Systems Inc. All rights reserved.
+ * Copyright 2026 Hypergiant Galactic Systems Inc. All rights reserved.
  * This file is licensed to you under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License. You may obtain a copy
  * of the License at https://www.apache.org/licenses/LICENSE-2.0

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

@@ -1,5 +1,5 @@
 /*
- * Copyright 2025 Hypergiant Galactic Systems Inc. All rights reserved.
+ * Copyright 2026 Hypergiant Galactic Systems Inc. All rights reserved.
  * This file is licensed to you under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License. You may obtain a copy
  * of the License at https://www.apache.org/licenses/LICENSE-2.0

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

@@ -1,5 +1,5 @@
 /*
- * Copyright 2025 Hypergiant Galactic Systems Inc. All rights reserved.
+ * Copyright 2026 Hypergiant Galactic Systems Inc. All rights reserved.
  * This file is licensed to you under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License. You may obtain a copy
  * of the License at https://www.apache.org/licenses/LICENSE-2.0

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

@@ -1,5 +1,5 @@
 /*
- * Copyright 2025 Hypergiant Galactic Systems Inc. All rights reserved.
+ * Copyright 2026 Hypergiant Galactic Systems Inc. All rights reserved.
  * This file is licensed to you under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License. You may obtain a copy
  * of the License at https://www.apache.org/licenses/LICENSE-2.0

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

@@ -1,5 +1,5 @@
 /*
- * Copyright 2025 Hypergiant Galactic Systems Inc. All rights reserved.
+ * Copyright 2026 Hypergiant Galactic Systems Inc. All rights reserved.
  * This file is licensed to you under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License. You may obtain a copy
  * of the License at https://www.apache.org/licenses/LICENSE-2.0

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

@@ -1,5 +1,5 @@
 /*
- * Copyright 2025 Hypergiant Galactic Systems Inc. All rights reserved.
+ * Copyright 2026 Hypergiant Galactic Systems Inc. All rights reserved.
  * This file is licensed to you under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License. You may obtain a copy
  * of the License at https://www.apache.org/licenses/LICENSE-2.0

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

@@ -1,5 +1,5 @@
 /*
- * Copyright 2025 Hypergiant Galactic Systems Inc. All rights reserved.
+ * Copyright 2026 Hypergiant Galactic Systems Inc. All rights reserved.
  * This file is licensed to you under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License. You may obtain a copy
  * of the License at https://www.apache.org/licenses/LICENSE-2.0

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

@@ -1,5 +1,5 @@
 /*
- * Copyright 2025 Hypergiant Galactic Systems Inc. All rights reserved.
+ * Copyright 2026 Hypergiant Galactic Systems Inc. All rights reserved.
  * This file is licensed to you under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License. You may obtain a copy
  * of the License at https://www.apache.org/licenses/LICENSE-2.0

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

@@ -1,5 +1,5 @@
 /*
- * Copyright 2025 Hypergiant Galactic Systems Inc. All rights reserved.
+ * Copyright 2026 Hypergiant Galactic Systems Inc. All rights reserved.
  * This file is licensed to you under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License. You may obtain a copy
  * of the License at https://www.apache.org/licenses/LICENSE-2.0

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

@@ -1,5 +1,5 @@
 /*
- * Copyright 2025 Hypergiant Galactic Systems Inc. All rights reserved.
+ * Copyright 2026 Hypergiant Galactic Systems Inc. All rights reserved.
  * This file is licensed to you under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License. You may obtain a copy
  * of the License at https://www.apache.org/licenses/LICENSE-2.0

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

@@ -1,5 +1,5 @@
 /*
- * Copyright 2025 Hypergiant Galactic Systems Inc. All rights reserved.
+ * Copyright 2026 Hypergiant Galactic Systems Inc. All rights reserved.
  * This file is licensed to you under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License. You may obtain a copy
  * of the License at https://www.apache.org/licenses/LICENSE-2.0

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

@@ -1,5 +1,5 @@
 /*
- * Copyright 2025 Hypergiant Galactic Systems Inc. All rights reserved.
+ * Copyright 2026 Hypergiant Galactic Systems Inc. All rights reserved.
  * This file is licensed to you under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License. You may obtain a copy
  * of the License at https://www.apache.org/licenses/LICENSE-2.0

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

@@ -1,5 +1,5 @@
 /*
- * Copyright 2025 Hypergiant Galactic Systems Inc. All rights reserved.
+ * Copyright 2026 Hypergiant Galactic Systems Inc. All rights reserved.
  * This file is licensed to you under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License. You may obtain a copy
  * of the License at https://www.apache.org/licenses/LICENSE-2.0

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

@@ -1,5 +1,5 @@
 /*
- * Copyright 2025 Hypergiant Galactic Systems Inc. All rights reserved.
+ * Copyright 2026 Hypergiant Galactic Systems Inc. All rights reserved.
  * This file is licensed to you under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License. You may obtain a copy
  * of the License at https://www.apache.org/licenses/LICENSE-2.0

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

@@ -1,5 +1,5 @@
 /*
- * Copyright 2025 Hypergiant Galactic Systems Inc. All rights reserved.
+ * Copyright 2026 Hypergiant Galactic Systems Inc. All rights reserved.
  * This file is licensed to you under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License. You may obtain a copy
  * of the License at https://www.apache.org/licenses/LICENSE-2.0

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

@@ -1,5 +1,5 @@
 /*
- * Copyright 2025 Hypergiant Galactic Systems Inc. All rights reserved.
+ * Copyright 2026 Hypergiant Galactic Systems Inc. All rights reserved.
  * This file is licensed to you under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License. You may obtain a copy
  * of the License at https://www.apache.org/licenses/LICENSE-2.0

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

@@ -1,5 +1,5 @@
 /*
- * Copyright 2025 Hypergiant Galactic Systems Inc. All rights reserved.
+ * Copyright 2026 Hypergiant Galactic Systems Inc. All rights reserved.
  * This file is licensed to you under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License. You may obtain a copy
  * of the License at https://www.apache.org/licenses/LICENSE-2.0

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

@@ -1,5 +1,5 @@
 /*
- * Copyright 2025 Hypergiant Galactic Systems Inc. All rights reserved.
+ * Copyright 2026 Hypergiant Galactic Systems Inc. All rights reserved.
  * This file is licensed to you under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License. You may obtain a copy
  * of the License at https://www.apache.org/licenses/LICENSE-2.0

package/dist/coordinates/latlon/internal/plain-decimal.d.ts

@@ -0,0 +1,35 @@
+//#region src/coordinates/latlon/internal/plain-decimal.d.ts
+/**
+ * Renders a small number in plain decimal notation instead of exponential.
+ *
+ * JavaScript's default number-to-string conversion switches to exponential
+ * notation below `1e-6` (`String(0.0000001)` is `'1e-7'`), which the
+ * coordinate lexer would mis-tokenize (`-7` reads as a sign) and which the
+ * round-trip formatters must not emit. Values that already render plainly are
+ * returned unchanged, so this is a no-op for ordinary coordinates.
+ *
+ * Only negative exponents are expanded, to at most 20 fraction digits — enough
+ * for any coordinate magnitude. Numbers at or above `1e21` (positive exponent)
+ * are returned as JavaScript renders them.
+ *
+ * @param value - The number to render.
+ * @returns The value in plain decimal notation with no trailing zeros.
+ *
+ * @remarks pure function
+ *
+ * @example
+ * ```typescript
+ * toPlainDecimalString(0.0000001);
+ * // '0.0000001'
+ * ```
+ *
+ * @example
+ * ```typescript
+ * toPlainDecimalString(-122.4194);
+ * // '-122.4194'
+ * ```
+ */
+declare const toPlainDecimalString: (value: number) => string;
+//#endregion
+export { toPlainDecimalString };
+//# sourceMappingURL=plain-decimal.d.ts.map

package/dist/coordinates/latlon/internal/plain-decimal.js

@@ -0,0 +1,59 @@
+/*
+ * Copyright 2026 Hypergiant Galactic Systems Inc. All rights reserved.
+ * This file is licensed to you under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License. You may obtain a copy
+ * of the License at https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software distributed under
+ * the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS
+ * OF ANY KIND, either express or implied. See the License for the specific language
+ * governing permissions and limitations under the License.
+ */
+
+
+//#region src/coordinates/latlon/internal/plain-decimal.ts
+/**
+* Fraction digits used to expand an exponential-notation number. Twenty covers
+* every magnitude that is meaningful for a coordinate (`1e-20°` is far below
+* the width of an atom) while staying within `toFixed`'s supported range.
+*/
+const EXPANDED_FRACTION_DIGITS = 20;
+/**
+* Renders a small number in plain decimal notation instead of exponential.
+*
+* JavaScript's default number-to-string conversion switches to exponential
+* notation below `1e-6` (`String(0.0000001)` is `'1e-7'`), which the
+* coordinate lexer would mis-tokenize (`-7` reads as a sign) and which the
+* round-trip formatters must not emit. Values that already render plainly are
+* returned unchanged, so this is a no-op for ordinary coordinates.
+*
+* Only negative exponents are expanded, to at most 20 fraction digits — enough
+* for any coordinate magnitude. Numbers at or above `1e21` (positive exponent)
+* are returned as JavaScript renders them.
+*
+* @param value - The number to render.
+* @returns The value in plain decimal notation with no trailing zeros.
+*
+* @remarks pure function
+*
+* @example
+* ```typescript
+* toPlainDecimalString(0.0000001);
+* // '0.0000001'
+* ```
+*
+* @example
+* ```typescript
+* toPlainDecimalString(-122.4194);
+* // '-122.4194'
+* ```
+*/
+const toPlainDecimalString = (value) => {
+	const rendered = `${value}`;
+	if (!rendered.includes("e-")) return rendered;
+	return value.toFixed(EXPANDED_FRACTION_DIGITS).replace(/\.?0+$/, "");
+};
+
+//#endregion
+export { toPlainDecimalString };
+//# sourceMappingURL=plain-decimal.js.map

package/dist/coordinates/latlon/internal/plain-decimal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plain-decimal.js","names":[],"sources":["../../../../src/coordinates/latlon/internal/plain-decimal.ts"],"sourcesContent":["/*\n * Copyright 2026 Hypergiant Galactic Systems Inc. All rights reserved.\n * This file is licensed to you under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License. You may obtain a copy\n * of the License at https://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software distributed under\n * the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\n * OF ANY KIND, either express or implied. See the License for the specific language\n * governing permissions and limitations under the License.\n */\n\n/**\n * Fraction digits used to expand an exponential-notation number. Twenty covers\n * every magnitude that is meaningful for a coordinate (`1e-20°` is far below\n * the width of an atom) while staying within `toFixed`'s supported range.\n */\nconst EXPANDED_FRACTION_DIGITS = 20;\n\n/**\n * Renders a small number in plain decimal notation instead of exponential.\n *\n * JavaScript's default number-to-string conversion switches to exponential\n * notation below `1e-6` (`String(0.0000001)` is `'1e-7'`), which the\n * coordinate lexer would mis-tokenize (`-7` reads as a sign) and which the\n * round-trip formatters must not emit. Values that already render plainly are\n * returned unchanged, so this is a no-op for ordinary coordinates.\n *\n * Only negative exponents are expanded, to at most 20 fraction digits — enough\n * for any coordinate magnitude. Numbers at or above `1e21` (positive exponent)\n * are returned as JavaScript renders them.\n *\n * @param value - The number to render.\n * @returns The value in plain decimal notation with no trailing zeros.\n *\n * @remarks pure function\n *\n * @example\n * ```typescript\n * toPlainDecimalString(0.0000001);\n * // '0.0000001'\n * ```\n *\n * @example\n * ```typescript\n * toPlainDecimalString(-122.4194);\n * // '-122.4194'\n * ```\n */\nexport const toPlainDecimalString = (value: number): string => {\n  const rendered = `${value}`;\n\n  if (!rendered.includes('e-')) {\n    return rendered;\n  }\n\n  return value.toFixed(EXPANDED_FRACTION_DIGITS).replace(/\\.?0+$/, '');\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;;AAiBA,MAAM,2BAA2B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAgCjC,MAAa,wBAAwB,UAA0B;CAC7D,MAAM,WAAW,GAAG;AAEpB,KAAI,CAAC,SAAS,SAAS,KAAK,CAC1B,QAAO;AAGT,QAAO,MAAM,QAAQ,yBAAyB,CAAC,QAAQ,UAAU,GAAG"}

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

@@ -70,6 +70,33 @@ declare function validateSignedRange(label: string, value: number, limit: number
  * ```
  */
 declare function validateNumericCoordinate(lat: number, lon: number): string[];
+/**
+ * Reports whether latitude and longitude are both finite and in range.
+ *
+ * A boolean-only probe for hot paths that need validity but not the error
+ * messages: it short-circuits on the first finite/range failure and allocates
+ * nothing, unlike {@link validateNumericCoordinate}, which builds an error
+ * array. Use that function when the messages are consumed.
+ *
+ * @param lat - The latitude value to validate (must be -90 to 90).
+ * @param lon - The longitude value to validate (must be -180 to 180).
+ * @returns `true` when both values are finite and within range.
+ *
+ * @remarks pure function
+ *
+ * @example
+ * ```typescript
+ * isValidNumericCoordinate(45.5, -122.6);
+ * // => true
+ * ```
+ *
+ * @example
+ * ```typescript
+ * isValidNumericCoordinate(91, -122.6);
+ * // => false
+ * ```
+ */
+declare function isValidNumericCoordinate(lat: number, lon: number): boolean;
 //#endregion
-export { isFiniteNumber, validateNumericCoordinate, validateSignedRange };
+export { isFiniteNumber, isValidNumericCoordinate, validateNumericCoordinate, validateSignedRange };
 //# sourceMappingURL=validate.d.ts.map

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

@@ -1,5 +1,5 @@
 /*
- * Copyright 2025 Hypergiant Galactic Systems Inc. All rights reserved.
+ * Copyright 2026 Hypergiant Galactic Systems Inc. All rights reserved.
  * This file is licensed to you under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License. You may obtain a copy
  * of the License at https://www.apache.org/licenses/LICENSE-2.0
@@ -99,7 +99,36 @@ function validateNumericCoordinate(lat, lon) {
 	if (lonError) errors.push(lonError);
 	return errors;
 }
+/**
+* Reports whether latitude and longitude are both finite and in range.
+*
+* A boolean-only probe for hot paths that need validity but not the error
+* messages: it short-circuits on the first finite/range failure and allocates
+* nothing, unlike {@link validateNumericCoordinate}, which builds an error
+* array. Use that function when the messages are consumed.
+*
+* @param lat - The latitude value to validate (must be -90 to 90).
+* @param lon - The longitude value to validate (must be -180 to 180).
+* @returns `true` when both values are finite and within range.
+*
+* @remarks pure function
+*
+* @example
+* ```typescript
+* isValidNumericCoordinate(45.5, -122.6);
+* // => true
+* ```
+*
+* @example
+* ```typescript
+* isValidNumericCoordinate(91, -122.6);
+* // => false
+* ```
+*/
+function isValidNumericCoordinate(lat, lon) {
+	return isFiniteNumber(lat) && isFiniteNumber(lon) && lat >= -LAT_LIMIT && lat <= LAT_LIMIT && lon >= -LON_LIMIT && lon <= LON_LIMIT;
+}
 
 //#endregion
-export { isFiniteNumber, validateNumericCoordinate, validateSignedRange };
+export { isFiniteNumber, isValidNumericCoordinate, validateNumericCoordinate, validateSignedRange };
 //# sourceMappingURL=validate.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"validate.js","names":["errors: string[]"],"sources":["../../../../src/coordinates/latlon/internal/validate.ts"],"sourcesContent":["/*\n * Copyright 2024 Hypergiant Galactic Systems Inc. All rights reserved.\n * This file is licensed to you under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License. You may obtain a copy\n * of the License at https://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software distributed under\n * the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\n * OF ANY KIND, either express or implied. See the License for the specific language\n * governing permissions and limitations under the License.\n */\n\nimport { violation } from './violation';\n\nconst LAT_LIMIT = 90;\nconst LON_LIMIT = 180;\n\n/**\n * Checks if a value is a finite number (not NaN, not Infinity, not -Infinity).\n *\n * @param value - The numeric value to check\n * @returns True if the value is a finite number, false otherwise\n *\n * @example\n * ```typescript\n * isFiniteNumber(42);        // true\n * isFiniteNumber(NaN);       // false\n * isFiniteNumber(Infinity);  // false\n * ```\n */\nexport function isFiniteNumber(value: number): boolean {\n  return typeof value === 'number' && Number.isFinite(value);\n}\n\n/**\n * Validates that a value is within a signed range (-limit to +limit).\n *\n * @param label - The label for error messages (used as-is for range errors,\n *                lowercased for \"Invalid\" errors)\n * @param value - The numeric value to validate\n * @param limit - The absolute limit (validates -limit to +limit)\n * @returns Error message string if validation fails, undefined if valid\n *\n * @example\n * ```typescript\n * validateSignedRange('Latitude', 45, 90);\n * // => undefined\n * ```\n *\n * @example\n * ```typescript\n * validateSignedRange('Latitude', 95, 90);\n * // => '[ERROR] Latitude value (95) is outside valid range (-90 to 90).'\n * ```\n *\n * @example\n * ```typescript\n * validateSignedRange('Longitude', NaN, 180);\n * // => '[ERROR] Invalid longitude value (NaN); expected a finite number.'\n * ```\n */\nexport function validateSignedRange(\n  label: string,\n  value: number,\n  limit: number,\n): string | undefined {\n  if (!isFiniteNumber(value)) {\n    return violation(\n      `Invalid ${label.toLowerCase()} value (${value}); expected a finite number.`,\n    );\n  }\n\n  if (value < -limit || value > limit) {\n    return violation(\n      `${label} value (${value}) is outside valid range (-${limit} to ${limit}).`,\n    );\n  }\n}\n\n/**\n * Validates numeric latitude and longitude coordinate values.\n *\n * @param lat - The latitude value to validate (must be -90 to 90)\n * @param lon - The longitude value to validate (must be -180 to 180)\n * @returns Array of error message strings, empty if all validations pass\n *\n * @example\n * ```typescript\n * validateNumericCoordinate(45.5, -122.6);\n * // => []\n * ```\n *\n * @example\n * ```typescript\n * validateNumericCoordinate(91, -122.6);\n * // => ['[ERROR] Latitude value (91) is outside valid range (-90 to 90).']\n * ```\n *\n * @example\n * ```typescript\n * validateNumericCoordinate(NaN, 200);\n * // => [\n * //   '[ERROR] Invalid latitude value (NaN); expected a finite number.',\n * //   '[ERROR] Longitude value (200) is outside valid range (-180 to 180).'\n * // ]\n * ```\n */\nexport function validateNumericCoordinate(lat: number, lon: number): string[] {\n  const errors: string[] = [];\n\n  const latError = validateSignedRange('Latitude', lat, LAT_LIMIT);\n  if (latError) {\n    errors.push(latError);\n  }\n\n  const lonError = validateSignedRange('Longitude', lon, LON_LIMIT);\n  if (lonError) {\n    errors.push(lonError);\n  }\n\n  return errors;\n}\n"],"mappings":";;;;;;;;;;;;;;;;AAcA,MAAM,YAAY;AAClB,MAAM,YAAY;;;;;;;;;;;;;;AAelB,SAAgB,eAAe,OAAwB;AACrD,QAAO,OAAO,UAAU,YAAY,OAAO,SAAS,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA8B5D,SAAgB,oBACd,OACA,OACA,OACoB;AACpB,KAAI,CAAC,eAAe,MAAM,CACxB,QAAO,UACL,WAAW,MAAM,aAAa,CAAC,UAAU,MAAM,8BAChD;AAGH,KAAI,QAAQ,CAAC,SAAS,QAAQ,MAC5B,QAAO,UACL,GAAG,MAAM,UAAU,MAAM,6BAA6B,MAAM,MAAM,MAAM,IACzE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAgCL,SAAgB,0BAA0B,KAAa,KAAuB;CAC5E,MAAMA,SAAmB,EAAE;CAE3B,MAAM,WAAW,oBAAoB,YAAY,KAAK,UAAU;AAChE,KAAI,SACF,QAAO,KAAK,SAAS;CAGvB,MAAM,WAAW,oBAAoB,aAAa,KAAK,UAAU;AACjE,KAAI,SACF,QAAO,KAAK,SAAS;AAGvB,QAAO"}
+{"version":3,"file":"validate.js","names":["errors: string[]"],"sources":["../../../../src/coordinates/latlon/internal/validate.ts"],"sourcesContent":["/*\n * Copyright 2024 Hypergiant Galactic Systems Inc. All rights reserved.\n * This file is licensed to you under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License. You may obtain a copy\n * of the License at https://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software distributed under\n * the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\n * OF ANY KIND, either express or implied. See the License for the specific language\n * governing permissions and limitations under the License.\n */\n\nimport { violation } from './violation';\n\nconst LAT_LIMIT = 90;\nconst LON_LIMIT = 180;\n\n/**\n * Checks if a value is a finite number (not NaN, not Infinity, not -Infinity).\n *\n * @param value - The numeric value to check\n * @returns True if the value is a finite number, false otherwise\n *\n * @example\n * ```typescript\n * isFiniteNumber(42);        // true\n * isFiniteNumber(NaN);       // false\n * isFiniteNumber(Infinity);  // false\n * ```\n */\nexport function isFiniteNumber(value: number): boolean {\n  return typeof value === 'number' && Number.isFinite(value);\n}\n\n/**\n * Validates that a value is within a signed range (-limit to +limit).\n *\n * @param label - The label for error messages (used as-is for range errors,\n *                lowercased for \"Invalid\" errors)\n * @param value - The numeric value to validate\n * @param limit - The absolute limit (validates -limit to +limit)\n * @returns Error message string if validation fails, undefined if valid\n *\n * @example\n * ```typescript\n * validateSignedRange('Latitude', 45, 90);\n * // => undefined\n * ```\n *\n * @example\n * ```typescript\n * validateSignedRange('Latitude', 95, 90);\n * // => '[ERROR] Latitude value (95) is outside valid range (-90 to 90).'\n * ```\n *\n * @example\n * ```typescript\n * validateSignedRange('Longitude', NaN, 180);\n * // => '[ERROR] Invalid longitude value (NaN); expected a finite number.'\n * ```\n */\nexport function validateSignedRange(\n  label: string,\n  value: number,\n  limit: number,\n): string | undefined {\n  if (!isFiniteNumber(value)) {\n    return violation(\n      `Invalid ${label.toLowerCase()} value (${value}); expected a finite number.`,\n    );\n  }\n\n  if (value < -limit || value > limit) {\n    return violation(\n      `${label} value (${value}) is outside valid range (-${limit} to ${limit}).`,\n    );\n  }\n}\n\n/**\n * Validates numeric latitude and longitude coordinate values.\n *\n * @param lat - The latitude value to validate (must be -90 to 90)\n * @param lon - The longitude value to validate (must be -180 to 180)\n * @returns Array of error message strings, empty if all validations pass\n *\n * @example\n * ```typescript\n * validateNumericCoordinate(45.5, -122.6);\n * // => []\n * ```\n *\n * @example\n * ```typescript\n * validateNumericCoordinate(91, -122.6);\n * // => ['[ERROR] Latitude value (91) is outside valid range (-90 to 90).']\n * ```\n *\n * @example\n * ```typescript\n * validateNumericCoordinate(NaN, 200);\n * // => [\n * //   '[ERROR] Invalid latitude value (NaN); expected a finite number.',\n * //   '[ERROR] Longitude value (200) is outside valid range (-180 to 180).'\n * // ]\n * ```\n */\nexport function validateNumericCoordinate(lat: number, lon: number): string[] {\n  const errors: string[] = [];\n\n  const latError = validateSignedRange('Latitude', lat, LAT_LIMIT);\n  if (latError) {\n    errors.push(latError);\n  }\n\n  const lonError = validateSignedRange('Longitude', lon, LON_LIMIT);\n  if (lonError) {\n    errors.push(lonError);\n  }\n\n  return errors;\n}\n\n/**\n * Reports whether latitude and longitude are both finite and in range.\n *\n * A boolean-only probe for hot paths that need validity but not the error\n * messages: it short-circuits on the first finite/range failure and allocates\n * nothing, unlike {@link validateNumericCoordinate}, which builds an error\n * array. Use that function when the messages are consumed.\n *\n * @param lat - The latitude value to validate (must be -90 to 90).\n * @param lon - The longitude value to validate (must be -180 to 180).\n * @returns `true` when both values are finite and within range.\n *\n * @remarks pure function\n *\n * @example\n * ```typescript\n * isValidNumericCoordinate(45.5, -122.6);\n * // => true\n * ```\n *\n * @example\n * ```typescript\n * isValidNumericCoordinate(91, -122.6);\n * // => false\n * ```\n */\nexport function isValidNumericCoordinate(lat: number, lon: number): boolean {\n  return (\n    isFiniteNumber(lat) &&\n    isFiniteNumber(lon) &&\n    lat >= -LAT_LIMIT &&\n    lat <= LAT_LIMIT &&\n    lon >= -LON_LIMIT &&\n    lon <= LON_LIMIT\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;;AAcA,MAAM,YAAY;AAClB,MAAM,YAAY;;;;;;;;;;;;;;AAelB,SAAgB,eAAe,OAAwB;AACrD,QAAO,OAAO,UAAU,YAAY,OAAO,SAAS,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA8B5D,SAAgB,oBACd,OACA,OACA,OACoB;AACpB,KAAI,CAAC,eAAe,MAAM,CACxB,QAAO,UACL,WAAW,MAAM,aAAa,CAAC,UAAU,MAAM,8BAChD;AAGH,KAAI,QAAQ,CAAC,SAAS,QAAQ,MAC5B,QAAO,UACL,GAAG,MAAM,UAAU,MAAM,6BAA6B,MAAM,MAAM,MAAM,IACzE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAgCL,SAAgB,0BAA0B,KAAa,KAAuB;CAC5E,MAAMA,SAAmB,EAAE;CAE3B,MAAM,WAAW,oBAAoB,YAAY,KAAK,UAAU;AAChE,KAAI,SACF,QAAO,KAAK,SAAS;CAGvB,MAAM,WAAW,oBAAoB,aAAa,KAAK,UAAU;AACjE,KAAI,SACF,QAAO,KAAK,SAAS;AAGvB,QAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA6BT,SAAgB,yBAAyB,KAAa,KAAsB;AAC1E,QACE,eAAe,IAAI,IACnB,eAAe,IAAI,IACnB,OAAO,CAAC,aACR,OAAO,aACP,OAAO,CAAC,aACR,OAAO"}