@acorex/components 19.15.0-next.21 → 19.15.0-next.22

package/map/lib/map.component.d.ts

@@ -1,5 +1,5 @@
 import { OnDestroy } from '@angular/core';
-import { AXMapControlPlace, AXMapData, AXMapMarker, AXMapPolygon } from './map.type';
+import { AXMapControlPlace, AXMapData, AXMapMarker, AXMapPolygon, AXPoiMarker } from './map.type';
 import * as i0 from "@angular/core";
 /**
  * @description
@@ -75,6 +75,12 @@ export declare class AXMapComponent implements OnDestroy {
      * @default 'bottomright'
      */
     locatePlace: import("@angular/core").InputSignal<AXMapControlPlace>;
+    /**
+     * @description
+     * Minimum zoom level at which POI markers become visible.
+     * @default 10
+     */
+    poiMinZoom: import("@angular/core").InputSignal<number>;
     /**
      * @description
      * Array or single marker location(s) to be placed on the map.
@@ -87,6 +93,12 @@ export declare class AXMapComponent implements OnDestroy {
      * @default undefined
      */
     polygons: import("@angular/core").InputSignal<AXMapPolygon | AXMapPolygon[]>;
+    /**
+     * @description
+     * Array or single POI marker(s) to be placed on the map.
+     * @default undefined
+     */
+    pois: import("@angular/core").InputSignal<AXPoiMarker | AXPoiMarker[]>;
     /**
      * @description
      * Event triggered when a new marker is added to the map.
@@ -112,6 +124,16 @@ export declare class AXMapComponent implements OnDestroy {
      * Event triggered when a location is found via the location control.
      */
     onLocationFound: import("@angular/core").OutputEmitterRef<AXMapMarker>;
+    /**
+     * @description
+     * Event triggered when POI positions are changed on the map.
+     */
+    onPoiChanged: import("@angular/core").OutputEmitterRef<AXPoiMarker[]>;
+    /**
+     * @description
+     * Event triggered when a new POI is added to the map.
+     */
+    onPoiAdded: import("@angular/core").OutputEmitterRef<AXPoiMarker>;
     /**
      * @description
      * Event triggered map is loaded.
@@ -128,12 +150,14 @@ export declare class AXMapComponent implements OnDestroy {
     private onMarkerAddedSubscription?;
     private onPolygonChangedSubscription?;
     private onPolygonAddedSubscription?;
+    private onPoiChangedSubscription?;
+    private onPoiAddedSubscription?;
     /**
      * @description
      * Adds a marker to the specified location on the map.
      * @param location - The location where the marker should be placed.
      */
-    addMarker(location: AXMapMarker | AXMapMarker[]): void;
+    addMarker(location: AXMapMarker | AXMapMarker[]): Promise<void>;
     /**
      * @description
      * Adds a polygon to the specified location on the map.
@@ -153,6 +177,12 @@ export declare class AXMapComponent implements OnDestroy {
      * @returns An array of `AXMapPolygon` representing all polygons.
      */
     getPolygons(): AXMapPolygon[];
+    /**
+     * @description
+     * Retrieves all POI markers currently placed on the map.
+     * @returns An array of `AXPoiMarker` representing all POI markers.
+     */
+    getPois(): AXPoiMarker[];
     /**
      * @description
      * Clear all markers and polygons
@@ -167,7 +197,7 @@ export declare class AXMapComponent implements OnDestroy {
      * @description
      * set markers and polygons
      */
-    setDrawItem(data: AXMapData): void;
+    setDrawItem(data: AXMapData): Promise<void>;
     /**
      * Adjusts the map view to fit all markers and polygons currently on the map.
      */
@@ -205,10 +235,32 @@ export declare class AXMapComponent implements OnDestroy {
      * Unsubscribe from draw events
      */
     private unsubscribeFromDrawEvents;
+    /**
+     * @description
+     * Update popup for a specific marker
+     * @param marker - The marker to update
+     * @param popup - The new popup text
+     * @param open - Whether the popup should be opened after update
+     * @param closeButton - Whether the popup should have a close button
+     * @returns True if the update was successful, false otherwise
+     */
+    updateMarkerPopup(marker: AXMapMarker, popup: string, open?: boolean, closeButton?: boolean): boolean;
+    /**
+     * @description
+     * Update popup for multiple markers
+     * @param updates - Array of marker popup updates
+     * @returns Number of markers successfully updated
+     */
+    updateMarkersPopups(updates: {
+        marker: AXMapMarker;
+        popup: string;
+        open?: boolean;
+        closeButton?: boolean;
+    }[]): number;
     /**
      * Cleanup function that destroys the map and unsubscribes from all subscriptions.
      */
     ngOnDestroy(): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<AXMapComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<AXMapComponent, "ax-map", never, { "zoomLevel": { "alias": "zoomLevel"; "required": false; "isSignal": true; }; "latitude": { "alias": "latitude"; "required": false; "isSignal": true; }; "longitude": { "alias": "longitude"; "required": false; "isSignal": true; }; "maxMarker": { "alias": "maxMarker"; "required": false; "isSignal": true; }; "maxPolygon": { "alias": "maxPolygon"; "required": false; "isSignal": true; }; "hasDraw": { "alias": "hasDraw"; "required": false; "isSignal": true; }; "hasLocator": { "alias": "hasLocator"; "required": false; "isSignal": true; }; "fitToDraw": { "alias": "fitToDraw"; "required": false; "isSignal": true; }; "limitDraw": { "alias": "limitDraw"; "required": false; "isSignal": true; }; "markerPlace": { "alias": "markerPlace"; "required": false; "isSignal": true; }; "locatePlace": { "alias": "locatePlace"; "required": false; "isSignal": true; }; "markers": { "alias": "markers"; "required": false; "isSignal": true; }; "polygons": { "alias": "polygons"; "required": false; "isSignal": true; }; }, { "zoomLevel": "zoomLevelChange"; "latitude": "latitudeChange"; "longitude": "longitudeChange"; "onMarkerAdded": "onMarkerAdded"; "onMarkerChanged": "onMarkerChanged"; "onPolygonAdded": "onPolygonAdded"; "onPolygonChanged": "onPolygonChanged"; "onLocationFound": "onLocationFound"; "onMapReady": "onMapReady"; }, never, never, true, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<AXMapComponent, "ax-map", never, { "zoomLevel": { "alias": "zoomLevel"; "required": false; "isSignal": true; }; "latitude": { "alias": "latitude"; "required": false; "isSignal": true; }; "longitude": { "alias": "longitude"; "required": false; "isSignal": true; }; "maxMarker": { "alias": "maxMarker"; "required": false; "isSignal": true; }; "maxPolygon": { "alias": "maxPolygon"; "required": false; "isSignal": true; }; "hasDraw": { "alias": "hasDraw"; "required": false; "isSignal": true; }; "hasLocator": { "alias": "hasLocator"; "required": false; "isSignal": true; }; "fitToDraw": { "alias": "fitToDraw"; "required": false; "isSignal": true; }; "limitDraw": { "alias": "limitDraw"; "required": false; "isSignal": true; }; "markerPlace": { "alias": "markerPlace"; "required": false; "isSignal": true; }; "locatePlace": { "alias": "locatePlace"; "required": false; "isSignal": true; }; "poiMinZoom": { "alias": "poiMinZoom"; "required": false; "isSignal": true; }; "markers": { "alias": "markers"; "required": false; "isSignal": true; }; "polygons": { "alias": "polygons"; "required": false; "isSignal": true; }; "pois": { "alias": "pois"; "required": false; "isSignal": true; }; }, { "zoomLevel": "zoomLevelChange"; "latitude": "latitudeChange"; "longitude": "longitudeChange"; "onMarkerAdded": "onMarkerAdded"; "onMarkerChanged": "onMarkerChanged"; "onPolygonAdded": "onPolygonAdded"; "onPolygonChanged": "onPolygonChanged"; "onLocationFound": "onLocationFound"; "onPoiChanged": "onPoiChanged"; "onPoiAdded": "onPoiAdded"; "onMapReady": "onMapReady"; }, never, never, true, never>;
 }

package/map/lib/map.service.d.ts

@@ -1,21 +1,25 @@
 import { EventEmitter } from '@angular/core';
-import { AXMapControlPlace, AXMapData, AXMapLatLng, AXMapLocation, AXMapMarker, AXMapPolygon } from './map.type';
+import { AXMapControlPlace, AXMapData, AXMapLatLng, AXMapLocation, AXMapMarker, AXMapPolygon, AXPoiMarker } from './map.type';
 import * as i0 from "@angular/core";
 /**
  * Service for managing Leaflet maps and related functionalities.
  */
 export declare class AXLeafletService {
     private mapConfig;
-    private icon;
+    private iconResolver;
+    private defaultIcon;
     private position;
     private maxMarkers;
     private maxPolygons;
     private polygonColor;
+    private poiMinZoom;
+    private poiMarkers;
     protected L: typeof import('leaflet');
     private map?;
     private drawControl?;
     private locateControl?;
     private drawnItems;
+    private poiLayer?;
     private boundary;
     private boundaryLayer;
     /**
@@ -34,6 +38,14 @@ export declare class AXLeafletService {
      * Emits when marker data changes.
      */
     onMarkerChanged: EventEmitter<AXMapMarker[]>;
+    /**
+     * Emits when a poi is added.
+     */
+    onPoiAdded: EventEmitter<AXPoiMarker>;
+    /**
+     * Emits when a poi is changed.
+     */
+    onPoiChanged: EventEmitter<AXPoiMarker[]>;
     /**
      * Emits when a marker is added.
      */
@@ -63,6 +75,18 @@ export declare class AXLeafletService {
     initMap(mapElement: HTMLElement, location: AXMapLatLng, zoom?: number): Promise<void>;
     private handleZoomChange;
     private handleCenterChange;
+    /**
+     * Creates a custom icon from SVG string or URL using the icon resolver if possible
+     * @param iconSrc Path to the icon, SVG string, or icon key
+     * @returns Leaflet icon
+     */
+    setCustomIcon(iconSrc: string): Promise<any>;
+    /**
+     * Creates a Leaflet icon from SVG or URL
+     * @param iconSrc The icon source (SVG string or URL)
+     * @returns Leaflet icon
+     */
+    private createLeafletIcon;
     /**
      * Gets the Leaflet map instance.
      * @returns The Leaflet map instance, or undefined if not initialized.
@@ -91,17 +115,6 @@ export declare class AXLeafletService {
      * @param duration The duration of the fly animation in seconds.
      */
     flyTo(location: AXMapLatLng, zoom?: number, setMarker?: boolean, duration?: number): void;
-    /**
-     * Adds a marker or markers to the map.
-     * @param locations The marker or markers to add.
-     */
-    addMarker(locations: AXMapMarker | AXMapMarker[]): void;
-    /**
-     * Adds a polygon or polygons to the map, respecting the boundary if set.
-     * @param polygons The polygon or polygons to add.
-     * @param clickCallback Optional callback function to be executed on polygon click.
-     */
-    addPolygon(polygons: AXMapPolygon | AXMapPolygon[], clickCallback?: (event: L.LeafletMouseEvent) => void): void;
     /**
      * Gets all markers currently on the map.
      * @returns An array of AXMapMarker objects.
@@ -112,6 +125,11 @@ export declare class AXLeafletService {
      * @returns An array of AXMapPolygon objects.
      */
     getPolygons(): AXMapPolygon[];
+    /**
+     * Gets POI markers from the POI layer.
+     * @returns Array of POI markers.
+     */
+    getPois(): AXPoiMarker[];
     /**
      * Adds a draw control to the map for creating markers and polygons.
      * @param position The position of the control on the map. Defaults to 'topleft'.
@@ -136,7 +154,7 @@ export declare class AXLeafletService {
      */
     removeLocateControl(): void;
     /**
-     * Clears all drawn items (markers and polygons) from the map.
+     * Clears all drawn items, including markers, polygons, and POIs.
      */
     clearDrawItems(): void;
     /**
@@ -148,7 +166,7 @@ export declare class AXLeafletService {
      * Sets the drawn items (markers and polygons) on the map.
      * @param data An object containing arrays of markers and polygons.
      */
-    setDrawItem(data: AXMapData): void;
+    setDrawItem(data: AXMapData): Promise<void>;
     /**
      * Adjusts the map view to fit all markers, polygons, and boundaries currently on the map.
      */
@@ -167,6 +185,63 @@ export declare class AXLeafletService {
      * Destroys the map instance and removes all event listeners.
      */
     destroyMap(): void;
+    /**
+     * Updates a marker's popup text and options
+     * @param marker The marker to update
+     * @param popup The new popup text
+     * @param open Whether the popup should be opened after update
+     * @param closeButton Whether the popup should have a close button
+     * @returns True if the update was successful, false otherwise
+     */
+    updateMarkerPopup(marker: AXMapMarker, popup: string, open?: boolean, closeButton?: boolean): boolean;
+    /**
+     * Finds a marker layer by its latitude and longitude
+     * @param marker The marker to find
+     * @returns The Leaflet marker layer or undefined if not found
+     */
+    private findMarkerLayer;
+    /**
+     * Updates popups for multiple markers in a single operation
+     * @param updates Array of marker popup updates
+     * @returns Number of markers successfully updated
+     */
+    updateMarkerPopups(updates: {
+        marker: AXMapMarker;
+        popup: string;
+        open?: boolean;
+        closeButton?: boolean;
+    }[]): number;
+    /**
+     * Adds a marker or markers to the map.
+     * @param locations The marker or markers to add.
+     */
+    addMarker(locations: AXMapMarker | AXMapMarker[]): Promise<void>;
+    /**
+     * Adds a polygon or polygons to the map, respecting the boundary if set.
+     * @param polygons The polygon or polygons to add.
+     * @param clickCallback Optional callback function to be executed on polygon click.
+     */
+    addPolygon(polygons: AXMapPolygon | AXMapPolygon[], clickCallback?: (event: L.LeafletMouseEvent) => void): void;
+    /**
+     * Adds a POI marker to the map.
+     * @param locations One or more POI markers to add.
+     */
+    addPoi(locations: AXPoiMarker | AXPoiMarker[]): Promise<void>;
+    /**
+     * Updates the visibility of POI markers based on the current zoom level
+     * @param currentZoom The current zoom level of the map
+     */
+    private updatePoiVisibility;
+    /**
+     * Sets the minimum zoom level at which POI markers become visible
+     * @param minZoom The minimum zoom level (default is 10)
+     */
+    setPoiMinZoom(minZoom: number): void;
+    /**
+     * Gets the current minimum zoom level for POI visibility
+     * @returns The minimum zoom level
+     */
+    getPoiMinZoom(): number;
     static ɵfac: i0.ɵɵFactoryDeclaration<AXLeafletService, never>;
     static ɵprov: i0.ɵɵInjectableDeclaration<AXLeafletService>;
 }

package/map/lib/map.type.d.ts

@@ -2,8 +2,40 @@ export interface AXMapLatLng {
     latitude: number;
     longitude: number;
 }
+/**
+ * Represents a marker on the map with position and optional display properties.
+ *
+ * @example
+ * ```typescript
+ * const marker: AXMapMarker = {
+ *   latitude: 51.505,
+ *   longitude: -0.09,
+ *   title: "London",
+ *   popup: "Capital of UK",
+ *   popupOpen: false,
+ *   popupCloseButton: true,
+ *   iconKey: "map-marker" // Icon key to be resolved by icon resolver service
+ *   // OR
+ *   icon: "<svg>...</svg>" // Direct SVG content or image URL
+ * };
+ * ```
+ */
 export interface AXMapMarker extends AXMapLatLng {
     title?: string;
+    iconKey?: string;
+    popup?: string;
+    popupOpen?: boolean;
+    popupCloseButton?: boolean;
+}
+/**
+ * Represents a Point of Interest marker on the map with the same properties as AXMapMarker.
+ */
+export interface AXPoiMarker extends AXMapLatLng {
+    title?: string;
+    iconKey?: string;
+    popup?: string;
+    popupOpen?: boolean;
+    popupCloseButton?: boolean;
 }
 export interface AXMapLocation extends AXMapMarker {
     precision?: number;
@@ -16,5 +48,6 @@ export interface AXMapPolygon {
 export interface AXMapData {
     markers: AXMapMarker[];
     polygons: AXMapPolygon[];
+    pois: AXPoiMarker[];
 }
 export type AXMapControlPlace = 'topleft' | 'topright' | 'bottomleft' | 'bottomright';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@acorex/components",
-  "version": "19.15.0-next.21",
+  "version": "19.15.0-next.22",
   "peerDependencies": {
     "@angular/common": ">=19.0.0",
     "@angular/core": ">=19.0.0",
@@ -29,6 +29,14 @@
       "types": "./action-sheet/index.d.ts",
       "default": "./fesm2022/acorex-components-action-sheet.mjs"
     },
+    "./alert": {
+      "types": "./alert/index.d.ts",
+      "default": "./fesm2022/acorex-components-alert.mjs"
+    },
+    "./audio-wave": {
+      "types": "./audio-wave/index.d.ts",
+      "default": "./fesm2022/acorex-components-audio-wave.mjs"
+    },
     "./autocomplete": {
       "types": "./autocomplete/index.d.ts",
       "default": "./fesm2022/acorex-components-autocomplete.mjs"
@@ -41,18 +49,10 @@
       "types": "./badge/index.d.ts",
       "default": "./fesm2022/acorex-components-badge.mjs"
     },
-    "./alert": {
-      "types": "./alert/index.d.ts",
-      "default": "./fesm2022/acorex-components-alert.mjs"
-    },
     "./bottom-navigation": {
       "types": "./bottom-navigation/index.d.ts",
       "default": "./fesm2022/acorex-components-bottom-navigation.mjs"
     },
-    "./audio-wave": {
-      "types": "./audio-wave/index.d.ts",
-      "default": "./fesm2022/acorex-components-audio-wave.mjs"
-    },
     "./breadcrumbs": {
       "types": "./breadcrumbs/index.d.ts",
       "default": "./fesm2022/acorex-components-breadcrumbs.mjs"
@@ -137,14 +137,14 @@
       "types": "./drawer/index.d.ts",
       "default": "./fesm2022/acorex-components-drawer.mjs"
     },
-    "./dropdown": {
-      "types": "./dropdown/index.d.ts",
-      "default": "./fesm2022/acorex-components-dropdown.mjs"
-    },
     "./drawer-2": {
       "types": "./drawer-2/index.d.ts",
       "default": "./fesm2022/acorex-components-drawer-2.mjs"
     },
+    "./dropdown": {
+      "types": "./dropdown/index.d.ts",
+      "default": "./fesm2022/acorex-components-dropdown.mjs"
+    },
     "./dropdown-button": {
       "types": "./dropdown-button/index.d.ts",
       "default": "./fesm2022/acorex-components-dropdown-button.mjs"
@@ -157,14 +157,14 @@
       "types": "./flow-chart/index.d.ts",
       "default": "./fesm2022/acorex-components-flow-chart.mjs"
     },
-    "./grid-layout-builder": {
-      "types": "./grid-layout-builder/index.d.ts",
-      "default": "./fesm2022/acorex-components-grid-layout-builder.mjs"
-    },
     "./form": {
       "types": "./form/index.d.ts",
       "default": "./fesm2022/acorex-components-form.mjs"
     },
+    "./grid-layout-builder": {
+      "types": "./grid-layout-builder/index.d.ts",
+      "default": "./fesm2022/acorex-components-grid-layout-builder.mjs"
+    },
     "./image": {
       "types": "./image/index.d.ts",
       "default": "./fesm2022/acorex-components-image.mjs"