@tmlmobilidade/utils 20250822.1813.23 → 20250822.1829.15

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

@@ -0,0 +1,30 @@
+/**
+ * Checks if the given latitude value is valid.
+ * @param value The latitude value to check.
+ * @returns True if the latitude is valid, false otherwise.
+ */
+export declare function isValidLatitude(value: number): boolean;
+/**
+ * Checks if the given longitude value is valid.
+ * @param value The longitude value to check.
+ * @returns True if the longitude is valid, false otherwise.
+ */
+export declare function isValidLongitude(value: number): boolean;
+/**
+ * Checks if the given latitude and longitude values form a valid coordinate pair.
+ * @param lat The latitude value to check.
+ * @param lng The longitude value to check.
+ * @returns True if the coordinate pair is valid, false otherwise.
+ */
+export declare function isValidCoordinatePair(lat: number, lng: number): boolean;
+/**
+ * Parses a coordinate string in the following formats:
+ * - `lat, lng`
+ * - `lat lng` (with a space or a tab)
+ * @param input The coordinate string to parse.
+ * @returns The parsed coordinates as an object, or null if the input is invalid.
+ */
+export declare const parseCoordinateString: (input: string) => null | {
+    lat: number;
+    lng: number;
+};

package/dist/src/geo/coordinates.js

@@ -0,0 +1,42 @@
+/* * */
+/**
+ * Checks if the given latitude value is valid.
+ * @param value The latitude value to check.
+ * @returns True if the latitude is valid, false otherwise.
+ */
+export function isValidLatitude(value) {
+    return value >= -90 && value <= 90;
+}
+/**
+ * Checks if the given longitude value is valid.
+ * @param value The longitude value to check.
+ * @returns True if the longitude is valid, false otherwise.
+ */
+export function isValidLongitude(value) {
+    return value >= -180 && value <= 180;
+}
+/**
+ * Checks if the given latitude and longitude values form a valid coordinate pair.
+ * @param lat The latitude value to check.
+ * @param lng The longitude value to check.
+ * @returns True if the coordinate pair is valid, false otherwise.
+ */
+export function isValidCoordinatePair(lat, lng) {
+    return isValidLatitude(lat) && isValidLongitude(lng);
+}
+/**
+ * Parses a coordinate string in the following formats:
+ * - `lat, lng`
+ * - `lat lng` (with a space or a tab)
+ * @param input The coordinate string to parse.
+ * @returns The parsed coordinates as an object, or null if the input is invalid.
+ */
+export const parseCoordinateString = (input) => {
+    const regex = /^\s*([+-]?\d+(?:\.\d+)?)\s*(?:,|\s)\s*([+-]?\d+(?:\.\d+)?)\s*$/;
+    const match = input.match(regex);
+    if (!match)
+        return null;
+    const lat = parseFloat(match[1]);
+    const lng = parseFloat(match[2]);
+    return isValidCoordinatePair(lat, lng) ? { lat, lng } : null;
+};

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

@@ -1,6 +1,7 @@
 export * from './chunk-line.js';
 export * from './constants.js';
 export * from './conversions.js';
+export * from './coordinates.js';
 export * from './cut-line-at-length.js';
 export * from './geojson-collections.js';
 export * from './get-geofence-on-point.js';

package/dist/src/geo/index.js

@@ -1,6 +1,7 @@
 export * from './chunk-line.js';
 export * from './constants.js';
 export * from './conversions.js';
+export * from './coordinates.js';
 export * from './cut-line-at-length.js';
 export * from './geojson-collections.js';
 export * from './get-geofence-on-point.js';

package/package.json

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