@tmlmobilidade/utils 20250825.2309.5 → 20250825.2311.31

package/dist/src/geo/coordinates.d.ts

@@ -1,15 +1,15 @@
 /**
  * Checks if the given latitude value is valid given Portugal limits.
  * @param value The latitude value to check.
- * @returns True if the latitude is valid, false otherwise.
+ * @returns The clamped latitude value if valid, false otherwise.
  */
-export declare function isValidLatitude(value: number): boolean;
+export declare function isValidLatitude(value: number): false | number;
 /**
  * Checks if the given longitude value is valid given Portugal limits.
  * @param value The longitude value to check.
- * @returns True if the longitude is valid, false otherwise.
+ * @returns The clamped longitude value if valid, false otherwise.
  */
-export declare function isValidLongitude(value: number): boolean;
+export declare function isValidLongitude(value: number): false | number;
 /**
  * Checks if the given latitude and longitude values form a valid coordinate pair.
  * @param lat The latitude value to check.

package/dist/src/geo/coordinates.js

@@ -2,22 +2,26 @@
 /**
  * Checks if the given latitude value is valid given Portugal limits.
  * @param value The latitude value to check.
- * @returns True if the latitude is valid, false otherwise.
+ * @returns The clamped latitude value if valid, false otherwise.
  */
 export function isValidLatitude(value) {
     const hasValue = value !== undefined && value !== null;
     const isWithinPortugal = value >= 36.9 && value <= 42.0;
-    return hasValue && isWithinPortugal;
+    if (!hasValue || !isWithinPortugal)
+        return false;
+    return clampCoordinate(value);
 }
 /**
  * Checks if the given longitude value is valid given Portugal limits.
  * @param value The longitude value to check.
- * @returns True if the longitude is valid, false otherwise.
+ * @returns The clamped longitude value if valid, false otherwise.
  */
 export function isValidLongitude(value) {
     const hasValue = value !== undefined && value !== null;
     const isWithinPortugal = value >= -9.5 && value <= -6.0;
-    return hasValue && isWithinPortugal;
+    if (!hasValue || !isWithinPortugal)
+        return false;
+    return clampCoordinate(value);
 }
 /**
  * Checks if the given latitude and longitude values form a valid coordinate pair.
@@ -26,7 +30,9 @@ export function isValidLongitude(value) {
  * @returns True if the coordinate pair is valid, false otherwise.
  */
 export function isValidCoordinatePair(lat, lng) {
-    return isValidLatitude(lat) && isValidLongitude(lng);
+    const isValidLat = isValidLatitude(lat);
+    const isValidLng = isValidLongitude(lng);
+    return !!isValidLat && !!isValidLng;
 }
 /**
  * Clamps a coordinate value to 6 decimal places.

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@tmlmobilidade/utils",
-	"version": "20250825.2309.5",
+	"version": "20250825.2311.31",
 	"author": "João de Vasconcelos & Jusi Monteiro",
 	"license": "AGPL-3.0-or-later",
 	"homepage": "https://github.com/tmlmobilidade/services#readme",