@tmlmobilidade/ui 20250307.1656.54 → 20250307.1723.25

package/dist/index.d.ts

@@ -644,4 +644,32 @@ declare function useSearchQuery<T>(data: T[], { accessors, customSearch, debounc
     setSearchQuery: React$1.Dispatch<React$1.SetStateAction<string | undefined>>;
 };
 
-export { ActionIcon, AppProvider, type AppProviderProps, AppWrapper, Badge, Button, CMIcon, CMLogo, Checkbox, ComboboxComponent as Combobox, type DataItem, DataTable, type DataTableColumn, type DataTableColumnProps, type DataTableHeaderProps, type DataTableProps, type DataTableRowProps, type DataTableSearchProps, type DataTableTitleProps, DateTimePicker, DeleteActionIcon, Description, FileButton, Grid, Label, type MapStyle, MapView, MapViewStyleActiveStops, MapViewStyleActiveStopsInteractiveLayerId, MapViewStyleActiveStopsPrimaryLayerId, MapViewStylePath, MapViewStylePathInteractiveLayerId, MapViewStylePathPrimaryLayerId, MapViewStyleStops, MapViewStyleStopsInteractiveLayerId, MapViewStyleStopsPrimaryLayerId, MapViewStyleVehicles, MapViewStyleVehiclesInteractiveLayerId, MapViewStyleVehiclesPrimaryLayerId, Menu, PasswordInput, Section, SegmentedControl, Sidebar, type SidebarItemProps, SimpleSurface, Slider, Spacer, Surface, Switch, TMLogo, TMLogoDark, TMLogoLight, Tag, Text, Component$1 as TextArea, Component as TextInput, ThemeDark, ThemeLight, ThemeProvider, type ThemeProviderProps, ThemeSwitcher, Themer, type ToastPromiseParams, type ToastProps, Tooltip, useScreenSize, useSearchQuery, useTheme, useToast };
+interface CenterMapOptions {
+    padding: number;
+}
+/**
+ *
+ * @param mapObject The map that should be manipulated
+ * @param features The features to center the map on
+ * @param options Optional settings to customize the centering
+ */
+declare const centerMap: (mapObject: any, features: GeoJSON.Feature<GeoJSON.Geometry, GeoJSON.GeoJsonProperties>[], options?: CenterMapOptions) => void;
+/**
+ *
+ * @param mapObject THe map that should be manipulated
+ * @param coordinates The destination coordinates to move the map to
+ * @param options Optional settings to customize the movement
+ */
+declare const moveMap: (mapObject: any, coordinates: GeoJSON.Position) => void;
+/**
+ * Return a base GeoJSON Feature for LineString object
+ * @returns A GeoJSON Feature for LineString object with an empty features array
+ */
+declare const getBaseGeoJsonFeatureLineString: () => GeoJSON.Feature<GeoJSON.LineString>;
+/**
+ * Return a base GeoJSON FeatureCollection object
+ * @returns A GeoJSON FeatureCollection object with an empty features array
+ */
+declare const getBaseGeoJsonFeatureCollection: () => GeoJSON.FeatureCollection<GeoJSON.LineString | GeoJSON.Point, GeoJSON.GeoJsonProperties>;
+
+export { ActionIcon, AppProvider, type AppProviderProps, AppWrapper, Badge, Button, CMIcon, CMLogo, Checkbox, ComboboxComponent as Combobox, type DataItem, DataTable, type DataTableColumn, type DataTableColumnProps, type DataTableHeaderProps, type DataTableProps, type DataTableRowProps, type DataTableSearchProps, type DataTableTitleProps, DateTimePicker, DeleteActionIcon, Description, FileButton, Grid, Label, type MapStyle, MapView, MapViewStyleActiveStops, MapViewStyleActiveStopsInteractiveLayerId, MapViewStyleActiveStopsPrimaryLayerId, MapViewStylePath, MapViewStylePathInteractiveLayerId, MapViewStylePathPrimaryLayerId, MapViewStyleStops, MapViewStyleStopsInteractiveLayerId, MapViewStyleStopsPrimaryLayerId, MapViewStyleVehicles, MapViewStyleVehiclesInteractiveLayerId, MapViewStyleVehiclesPrimaryLayerId, Menu, PasswordInput, Section, SegmentedControl, Sidebar, type SidebarItemProps, SimpleSurface, Slider, Spacer, Surface, Switch, TMLogo, TMLogoDark, TMLogoLight, Tag, Text, Component$1 as TextArea, Component as TextInput, ThemeDark, ThemeLight, ThemeProvider, type ThemeProviderProps, ThemeSwitcher, Themer, type ToastPromiseParams, type ToastProps, Tooltip, centerMap, getBaseGeoJsonFeatureCollection, getBaseGeoJsonFeatureLineString, moveMap, useScreenSize, useSearchQuery, useTheme, useToast };

package/dist/src/index.d.ts

@@ -3,6 +3,7 @@ export * from './components';
 export * from './hooks/toast';
 export * from './hooks/use-screen-size';
 export * from './hooks/use-search-query';
+export * from './lib/map.utils';
 export * from '@mantine/form';
 export * from '@mantine/hooks';
 export * from '@mantine/modals';

package/dist/src/index.js

@@ -41,6 +41,7 @@ export { default as ThemeSwitcher } from './components/theme/ThemeSwitcher/index
 export { useToast } from './hooks/toast.js';
 export { useScreenSize } from './hooks/use-screen-size.js';
 export { useSearchQuery } from './hooks/use-search-query.js';
+export { centerMap, getBaseGeoJsonFeatureCollection, getBaseGeoJsonFeatureLineString, moveMap } from './lib/map.utils.js';
 export * from '@mantine/form';
 export * from '@mantine/hooks';
 export * from '@mantine/modals';

package/dist/src/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;"}
+{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;"}

package/dist/src/lib/map.utils.js

@@ -1,7 +1,94 @@
-import '../settings/map.settings.js';
-import '@turf/turf';
+import { mapDefaultValues } from '../settings/map.settings.js';
+import * as turf from '@turf/turf';
 
 /* * */
+/**
+ *
+ * @param mapObject The map that should be manipulated
+ * @param features The features to center the map on
+ * @param options Optional settings to customize the centering
+ */
+const centerMap = (mapObject, features, options) => {
+    //
+    //
+    // Validate input parameters
+    if (!mapObject)
+        return;
+    if (!features.length)
+        return;
+    //
+    // Create a feature collection from the given features, and get the corresponding envelope.
+    // Return if the envelope is not valid.
+    const featureCollection = turf.featureCollection(features);
+    const featureCollectionEnvelope = turf.envelope(featureCollection);
+    if (!featureCollectionEnvelope || !featureCollectionEnvelope.bbox)
+        return;
+    //
+    // Validate if the envelope is valid
+    if (featureCollectionEnvelope.bbox.length < 4)
+        return;
+    if (featureCollectionEnvelope.bbox[0] < 90 || featureCollectionEnvelope.bbox[0] > 90)
+        return;
+    if (featureCollectionEnvelope.bbox[1] < 180 || featureCollectionEnvelope.bbox[1] > 180)
+        return;
+    if (featureCollectionEnvelope.bbox[2] < 90 || featureCollectionEnvelope.bbox[2] > 90)
+        return;
+    if (featureCollectionEnvelope.bbox[3] < 180 || featureCollectionEnvelope.bbox[3] > 180)
+        return;
+    //
+    // Center the map on the envelope
+    mapObject.fitBounds([
+        featureCollectionEnvelope.bbox[0],
+        featureCollectionEnvelope.bbox[1],
+        featureCollectionEnvelope.bbox[2],
+        featureCollectionEnvelope.bbox[3],
+    ], { padding: options?.padding || 25 });
+    //
+};
+/* * */
+/**
+ *
+ * @param mapObject THe map that should be manipulated
+ * @param coordinates The destination coordinates to move the map to
+ * @param options Optional settings to customize the movement
+ */
+const moveMap = (mapObject, coordinates) => {
+    //
+    //
+    // Validate the input parameters
+    if (!mapObject)
+        return;
+    if (!coordinates || !coordinates.length)
+        return;
+    //
+    // Get map current zoom level
+    const currentZoom = mapObject.getZoom();
+    const currentZoomWithMargin = currentZoom + mapDefaultValues.zoom_margin;
+    const thresholdZoomWithMargin = mapDefaultValues.zoom + mapDefaultValues.zoom_margin;
+    //
+    // Check if the given coordinates are inside the currently rendered map bounds
+    const currentMapBounds = mapObject.getBounds().toArray();
+    const isInside = turf.booleanIntersects(turf.point(coordinates), turf.bboxPolygon([...currentMapBounds[0], ...currentMapBounds[1]]));
+    //
+    // If the given coordinates are visible and the zoom is not too far back (plus a little margin)...
+    if (isInside && currentZoomWithMargin > (thresholdZoomWithMargin * 1.15)) {
+        // ...then simply ease to it.
+        mapObject.easeTo({ center: coordinates, duration: mapDefaultValues.speed * 0.25, zoom: currentZoom });
+    }
+    else {
+        // If the zoom is too far, or the given coordinates are not visible, then fly to it
+        mapObject.flyTo({ center: coordinates, duration: mapDefaultValues.speed, zoom: thresholdZoomWithMargin });
+    }
+    //
+};
+/* * */
+/**
+ * Return a base GeoJSON Feature for LineString object
+ * @returns A GeoJSON Feature for LineString object with an empty features array
+ */
+const getBaseGeoJsonFeatureLineString = () => {
+    return Object.assign({ geometry: { coordinates: [], type: 'LineString' }, properties: {}, type: 'Feature' });
+};
 /**
  * Return a base GeoJSON FeatureCollection object
  * @returns A GeoJSON FeatureCollection object with an empty features array
@@ -10,5 +97,5 @@ const getBaseGeoJsonFeatureCollection = () => {
     return Object.assign({ features: [], type: 'FeatureCollection' });
 };
 
-export { getBaseGeoJsonFeatureCollection };
+export { centerMap, getBaseGeoJsonFeatureCollection, getBaseGeoJsonFeatureLineString, moveMap };
 //# sourceMappingURL=map.utils.js.map

package/dist/src/lib/map.utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"map.utils.js","sources":["../../../../src/lib/map.utils.ts"],"sourcesContent":[null],"names":[],"mappings":";;;AAAA;AAmHA;;;AAGG;AAEI,MAAM,+BAA+B,GAAG,MAA+F;AAC7I,IAAA,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,QAAQ,EAAE,EAAE,EAAE,IAAI,EAAE,mBAAmB,EAAE,CAAC;AAClE;;;;"}
+{"version":3,"file":"map.utils.js","sources":["../../../../src/lib/map.utils.ts"],"sourcesContent":[null],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@tmlmobilidade/ui",
-	"version": "20250307.1656.54",
+	"version": "20250307.1723.25",
 	"author": "",
 	"license": "ISC",
 	"publishConfig": {