@progress/kendo-react-map 5.6.0-dev.202208040930 → 5.6.0-dev.202208090813

package/dist/es/Map.d.ts

@@ -5,6 +5,8 @@ import './defaults';
 import { MapProps } from './MapProps';
 import { MapContextType } from './MapContext';
 import { DomEvent } from './events/dom-event';
+import { geometry } from '@progress/kendo-drawing';
+import { Extent, Location, MapLayer } from './common/map-types';
 /**
  * Represents the [KendoReact Map component]({% slug overview_map %}).
  */
@@ -55,6 +57,94 @@ export declare class Map extends React.Component<MapProps, {}> {
      * @hidden
      */
     getMapOptions(): any;
+    /**
+     * The marker layers instances.
+     */
+    get layers(): MapLayer[];
+    /**
+     * Gets the extent (visible area) of the map.
+     */
+    get extent(): Extent | undefined;
+    /**
+     * Sets the extent (visible area) of the map.
+     */
+    set extent(extent: Extent | undefined);
+    /**
+     * Detects the size of the container and redraws the Map.
+     * Resizing is automatic unless you set the `resizeRateLimit` option to `0`.
+     */
+    resize(): void;
+    /**
+     * Retrieves the size of the visible portion of the map.
+     *
+     * @returns The size (width and height) of the visible portion of the map.
+     */
+    viewSize(): {
+        width: number;
+        height: number;
+    };
+    /**
+     * Returns the event coordinates relative to the map element. Offset coordinates are not synchronized to a particular location on the map.
+     *
+     * @param e The mouse event.
+     * @returns The event coordinates relative to the map element.
+     */
+    eventOffset(e: any): geometry.Point | undefined;
+    /**
+     * Retrieves projected (layer) coordinates that correspond to this mouse event.
+     * Layer coordinates are absolute and change only when the zoom level is changed.
+     *
+     * @param e The mouse event.
+     * @returns The projected (layer) coordinates that correspond to this event.
+     */
+    eventToLayer(e: any): geometry.Point | undefined;
+    /**
+     * Retrieves the geographic location that correspond to this mouse event.
+     *
+     * @param e The mouse event.
+     * @returns The geographic location that correspond to this mouse event.
+     */
+    eventToLocation(e: any): geometry.Point | undefined;
+    /**
+     * Retrieves relative (view) coordinates that correspond to this mouse event.
+     * Layer elements positioned on these coordinates will appear under the mouse cursor.
+     * View coordinates are no longer valid after a map reset.
+     *
+     * @param e The mouse event.
+     * @returns The relative (view) coordinates that correspond to this mouse event.
+     */
+    eventToView(e: any): geometry.Point | undefined;
+    /**
+     * Transforms layer (projected) coordinates to geographical location.
+     *
+     * @param point The layer (projected) coordinates. An array argument is assumed to be in x, y order.
+     * @param zoom Optional. Assumed zoom level. Defaults to the current zoom level.
+     * @returns The geographic location that corresponds to the layer coordinates.
+     */
+    layerToLocation(point: geometry.Point | number[], zoom?: number): Location | undefined;
+    /**
+     * Returns the layer (projected) coordinates that correspond to a geographical location.
+     *
+     * @param location The geographic location. An array argument is assumed to be in [Latitude, Longitude] order.
+     * @param zoom Optional. Assumed zoom level. Defaults to the current zoom level.
+     * @returns The layer (projected) coordinates.
+     */
+    locationToLayer(location: Location | number[], zoom?: number): geometry.Point | undefined;
+    /**
+     * Returns the view (relative) coordinates that correspond to a geographical location.
+     *
+     * @param location The geographic location. An array argument is assumed to be in [Latitude, Longitude] order.
+     * @returns The view coordinates that correspond to a geographical location.
+     */
+    locationToView(location: Location | number[]): geometry.Point | undefined;
+    /**
+     * Returns the geographical location that correspond to the view (relative) coordinates.
+     *
+     * @param point The view coordinates. An array argument is assumed to be in x, y order.
+     * @param zoom Optional. Assumed zoom level. Defaults to the current zoom level.
+     * @returns The geographic location that corresponds to the view coordinates.
+     */
+    viewToLocation(point: geometry.Point | number[], zoom?: number): Location | undefined;
     /**
      * @hidden
      */
@@ -78,13 +168,13 @@ export declare class Map extends React.Component<MapProps, {}> {
     /**
      * @hidden
      */
-    onRender: (e: any) => void;
+    onInit: (e: any) => void;
     /**
      * @hidden
      */
-    onMapMouseLeave: (e: React.MouseEvent<HTMLDivElement>) => void;
+    onRender: (e: any) => void;
     /**
      * @hidden
      */
-    onWindowResize: () => void;
+    onMapMouseLeave: (e: React.MouseEvent<HTMLDivElement>) => void;
 }

package/dist/es/Map.js

@@ -52,6 +52,12 @@ var Map = /** @class */ (function (_super) {
         _this.optionsUnsubscriber = Function.prototype;
         _this.observersStore = {};
         /* Map handlers */
+        /**
+         * @hidden
+         */
+        _this.onInit = function (e) {
+            _this.mapInstance = e.sender;
+        };
         /**
          * @hidden
          */
@@ -74,14 +80,6 @@ var Map = /** @class */ (function (_super) {
                 _this.mapInstance.hideTooltip();
             }
         };
-        /**
-         * @hidden
-         */
-        _this.onWindowResize = function () {
-            if (_this.mapInstance !== null) {
-                // this.mapInstance.resize();
-            }
-        };
         validatePackage(packageMetadata);
         _this.optionsStore = createStore(optionsReducer);
         _this.observersStore = createStore(observersReducer);
@@ -92,7 +90,8 @@ var Map = /** @class */ (function (_super) {
             childrenObserver: _this.childrenObserver
         };
         _this.mapObserver = new InstanceObserver(_this, {
-        // render: 'onRender',
+            // render: 'onRender',
+            init: 'onInit'
         });
         return _this;
     }
@@ -112,7 +111,6 @@ var Map = /** @class */ (function (_super) {
     Map.prototype.componentDidMount = function () {
         this.instantiateCoreMap();
         this.optionsUnsubscriber = this.optionsStore.subscribe(this.refresh.bind(this));
-        window.addEventListener('resize', this.onWindowResize);
     };
     /**
      * @hidden
@@ -123,7 +121,6 @@ var Map = /** @class */ (function (_super) {
             this.mapInstance.destroy();
             this.mapInstance = null;
         }
-        window.removeEventListener('resize', this.onWindowResize);
     };
     /**
      * @hidden
@@ -181,6 +178,137 @@ var Map = /** @class */ (function (_super) {
         mapOptions = Object.assign(mapOptions, this.optionsStore.getState());
         return mapOptions;
     };
+    Object.defineProperty(Map.prototype, "layers", {
+        /**
+         * The marker layers instances.
+         */
+        get: function () {
+            var _a;
+            return (_a = this.mapInstance) === null || _a === void 0 ? void 0 : _a.layers;
+        },
+        enumerable: false,
+        configurable: true
+    });
+    Object.defineProperty(Map.prototype, "extent", {
+        /**
+         * Gets the extent (visible area) of the map.
+         */
+        get: function () {
+            var _a;
+            return (_a = this.mapInstance) === null || _a === void 0 ? void 0 : _a.extent();
+        },
+        /**
+         * Sets the extent (visible area) of the map.
+         */
+        set: function (extent) {
+            var _a;
+            (_a = this.mapInstance) === null || _a === void 0 ? void 0 : _a.extent(extent);
+        },
+        enumerable: false,
+        configurable: true
+    });
+    /**
+     * Detects the size of the container and redraws the Map.
+     * Resizing is automatic unless you set the `resizeRateLimit` option to `0`.
+     */
+    Map.prototype.resize = function () {
+        // this.mapInstance?.resize();
+    };
+    /**
+     * Retrieves the size of the visible portion of the map.
+     *
+     * @returns The size (width and height) of the visible portion of the map.
+     */
+    Map.prototype.viewSize = function () {
+        var _a;
+        return (_a = this.mapInstance) === null || _a === void 0 ? void 0 : _a.viewSize();
+    };
+    /**
+     * Returns the event coordinates relative to the map element. Offset coordinates are not synchronized to a particular location on the map.
+     *
+     * @param e The mouse event.
+     * @returns The event coordinates relative to the map element.
+     */
+    Map.prototype.eventOffset = function (e) {
+        var _a;
+        return (_a = this.mapInstance) === null || _a === void 0 ? void 0 : _a.eventOffset(e);
+    };
+    /**
+     * Retrieves projected (layer) coordinates that correspond to this mouse event.
+     * Layer coordinates are absolute and change only when the zoom level is changed.
+     *
+     * @param e The mouse event.
+     * @returns The projected (layer) coordinates that correspond to this event.
+     */
+    Map.prototype.eventToLayer = function (e) {
+        var _a;
+        return (_a = this.mapInstance) === null || _a === void 0 ? void 0 : _a.eventToLayer(e);
+    };
+    /**
+     * Retrieves the geographic location that correspond to this mouse event.
+     *
+     * @param e The mouse event.
+     * @returns The geographic location that correspond to this mouse event.
+     */
+    Map.prototype.eventToLocation = function (e) {
+        var _a;
+        return (_a = this.mapInstance) === null || _a === void 0 ? void 0 : _a.eventToLocation(e);
+    };
+    /**
+     * Retrieves relative (view) coordinates that correspond to this mouse event.
+     * Layer elements positioned on these coordinates will appear under the mouse cursor.
+     * View coordinates are no longer valid after a map reset.
+     *
+     * @param e The mouse event.
+     * @returns The relative (view) coordinates that correspond to this mouse event.
+     */
+    Map.prototype.eventToView = function (e) {
+        var _a;
+        return (_a = this.mapInstance) === null || _a === void 0 ? void 0 : _a.eventToView(e);
+    };
+    /**
+     * Transforms layer (projected) coordinates to geographical location.
+     *
+     * @param point The layer (projected) coordinates. An array argument is assumed to be in x, y order.
+     * @param zoom Optional. Assumed zoom level. Defaults to the current zoom level.
+     * @returns The geographic location that corresponds to the layer coordinates.
+     */
+    Map.prototype.layerToLocation = function (point, zoom) {
+        var _a;
+        return (_a = this.mapInstance) === null || _a === void 0 ? void 0 : _a.layerToLocation(point, zoom);
+    };
+    /**
+     * Returns the layer (projected) coordinates that correspond to a geographical location.
+     *
+     * @param location The geographic location. An array argument is assumed to be in [Latitude, Longitude] order.
+     * @param zoom Optional. Assumed zoom level. Defaults to the current zoom level.
+     * @returns The layer (projected) coordinates.
+     */
+    Map.prototype.locationToLayer = function (location, zoom) {
+        var _a;
+        return (_a = this.mapInstance) === null || _a === void 0 ? void 0 : _a.locationToLayer(location, zoom);
+    };
+    /**
+     * Returns the view (relative) coordinates that correspond to a geographical location.
+     *
+     * @param location The geographic location. An array argument is assumed to be in [Latitude, Longitude] order.
+     * @returns The view coordinates that correspond to a geographical location.
+     */
+    Map.prototype.locationToView = function (location) {
+        var _a;
+        return (_a = this.mapInstance) === null || _a === void 0 ? void 0 : _a.locationToView(location);
+    };
+    /**
+     * Returns the geographical location that correspond to the view (relative) coordinates.
+     *
+     * @param point The view coordinates. An array argument is assumed to be in x, y order.
+     * @param zoom Optional. Assumed zoom level. Defaults to the current zoom level.
+     * @returns The geographic location that corresponds to the view coordinates.
+     */
+    Map.prototype.viewToLocation = function (point, zoom) {
+        var _a;
+        return (_a = this.mapInstance) === null || _a === void 0 ? void 0 : _a.viewToLocation(point, zoom);
+    };
     /**
      * @hidden
      */

package/dist/es/package-metadata.js

@@ -5,7 +5,7 @@ export var packageMetadata = {
     name: '@progress/kendo-react-map',
     productName: 'KendoReact',
     productCodes: ['KENDOUIREACT', 'KENDOUICOMPLETE'],
-    publishDate: 1659604841,
+    publishDate: 1660032211,
     version: '',
     licensingDocsUrl: 'https://www.telerik.com/kendo-react-ui/my-license/?utm_medium=product&utm_source=kendoreact&utm_campaign=kendo-ui-react-purchase-license-keys-warning'
 };

package/dist/npm/Map.d.ts

@@ -5,6 +5,8 @@ import './defaults';
 import { MapProps } from './MapProps';
 import { MapContextType } from './MapContext';
 import { DomEvent } from './events/dom-event';
+import { geometry } from '@progress/kendo-drawing';
+import { Extent, Location, MapLayer } from './common/map-types';
 /**
  * Represents the [KendoReact Map component]({% slug overview_map %}).
  */
@@ -55,6 +57,94 @@ export declare class Map extends React.Component<MapProps, {}> {
      * @hidden
      */
     getMapOptions(): any;
+    /**
+     * The marker layers instances.
+     */
+    get layers(): MapLayer[];
+    /**
+     * Gets the extent (visible area) of the map.
+     */
+    get extent(): Extent | undefined;
+    /**
+     * Sets the extent (visible area) of the map.
+     */
+    set extent(extent: Extent | undefined);
+    /**
+     * Detects the size of the container and redraws the Map.
+     * Resizing is automatic unless you set the `resizeRateLimit` option to `0`.
+     */
+    resize(): void;
+    /**
+     * Retrieves the size of the visible portion of the map.
+     *
+     * @returns The size (width and height) of the visible portion of the map.
+     */
+    viewSize(): {
+        width: number;
+        height: number;
+    };
+    /**
+     * Returns the event coordinates relative to the map element. Offset coordinates are not synchronized to a particular location on the map.
+     *
+     * @param e The mouse event.
+     * @returns The event coordinates relative to the map element.
+     */
+    eventOffset(e: any): geometry.Point | undefined;
+    /**
+     * Retrieves projected (layer) coordinates that correspond to this mouse event.
+     * Layer coordinates are absolute and change only when the zoom level is changed.
+     *
+     * @param e The mouse event.
+     * @returns The projected (layer) coordinates that correspond to this event.
+     */
+    eventToLayer(e: any): geometry.Point | undefined;
+    /**
+     * Retrieves the geographic location that correspond to this mouse event.
+     *
+     * @param e The mouse event.
+     * @returns The geographic location that correspond to this mouse event.
+     */
+    eventToLocation(e: any): geometry.Point | undefined;
+    /**
+     * Retrieves relative (view) coordinates that correspond to this mouse event.
+     * Layer elements positioned on these coordinates will appear under the mouse cursor.
+     * View coordinates are no longer valid after a map reset.
+     *
+     * @param e The mouse event.
+     * @returns The relative (view) coordinates that correspond to this mouse event.
+     */
+    eventToView(e: any): geometry.Point | undefined;
+    /**
+     * Transforms layer (projected) coordinates to geographical location.
+     *
+     * @param point The layer (projected) coordinates. An array argument is assumed to be in x, y order.
+     * @param zoom Optional. Assumed zoom level. Defaults to the current zoom level.
+     * @returns The geographic location that corresponds to the layer coordinates.
+     */
+    layerToLocation(point: geometry.Point | number[], zoom?: number): Location | undefined;
+    /**
+     * Returns the layer (projected) coordinates that correspond to a geographical location.
+     *
+     * @param location The geographic location. An array argument is assumed to be in [Latitude, Longitude] order.
+     * @param zoom Optional. Assumed zoom level. Defaults to the current zoom level.
+     * @returns The layer (projected) coordinates.
+     */
+    locationToLayer(location: Location | number[], zoom?: number): geometry.Point | undefined;
+    /**
+     * Returns the view (relative) coordinates that correspond to a geographical location.
+     *
+     * @param location The geographic location. An array argument is assumed to be in [Latitude, Longitude] order.
+     * @returns The view coordinates that correspond to a geographical location.
+     */
+    locationToView(location: Location | number[]): geometry.Point | undefined;
+    /**
+     * Returns the geographical location that correspond to the view (relative) coordinates.
+     *
+     * @param point The view coordinates. An array argument is assumed to be in x, y order.
+     * @param zoom Optional. Assumed zoom level. Defaults to the current zoom level.
+     * @returns The geographic location that corresponds to the view coordinates.
+     */
+    viewToLocation(point: geometry.Point | number[], zoom?: number): Location | undefined;
     /**
      * @hidden
      */
@@ -78,13 +168,13 @@ export declare class Map extends React.Component<MapProps, {}> {
     /**
      * @hidden
      */
-    onRender: (e: any) => void;
+    onInit: (e: any) => void;
     /**
      * @hidden
      */
-    onMapMouseLeave: (e: React.MouseEvent<HTMLDivElement>) => void;
+    onRender: (e: any) => void;
     /**
      * @hidden
      */
-    onWindowResize: () => void;
+    onMapMouseLeave: (e: React.MouseEvent<HTMLDivElement>) => void;
 }

package/dist/npm/Map.js

@@ -55,6 +55,12 @@ var Map = /** @class */ (function (_super) {
         _this.optionsUnsubscriber = Function.prototype;
         _this.observersStore = {};
         /* Map handlers */
+        /**
+         * @hidden
+         */
+        _this.onInit = function (e) {
+            _this.mapInstance = e.sender;
+        };
         /**
          * @hidden
          */
@@ -77,14 +83,6 @@ var Map = /** @class */ (function (_super) {
                 _this.mapInstance.hideTooltip();
             }
         };
-        /**
-         * @hidden
-         */
-        _this.onWindowResize = function () {
-            if (_this.mapInstance !== null) {
-                // this.mapInstance.resize();
-            }
-        };
         (0, kendo_react_common_1.validatePackage)(package_metadata_1.packageMetadata);
         _this.optionsStore = (0, store_1.default)(reducer_1.optionsReducer);
         _this.observersStore = (0, store_1.default)(reducer_1.observersReducer);
@@ -95,7 +93,8 @@ var Map = /** @class */ (function (_super) {
             childrenObserver: _this.childrenObserver
         };
         _this.mapObserver = new kendo_charts_1.InstanceObserver(_this, {
-        // render: 'onRender',
+            // render: 'onRender',
+            init: 'onInit'
         });
         return _this;
     }
@@ -115,7 +114,6 @@ var Map = /** @class */ (function (_super) {
     Map.prototype.componentDidMount = function () {
         this.instantiateCoreMap();
         this.optionsUnsubscriber = this.optionsStore.subscribe(this.refresh.bind(this));
-        window.addEventListener('resize', this.onWindowResize);
     };
     /**
      * @hidden
@@ -126,7 +124,6 @@ var Map = /** @class */ (function (_super) {
             this.mapInstance.destroy();
             this.mapInstance = null;
         }
-        window.removeEventListener('resize', this.onWindowResize);
     };
     /**
      * @hidden
@@ -184,6 +181,137 @@ var Map = /** @class */ (function (_super) {
         mapOptions = Object.assign(mapOptions, this.optionsStore.getState());
         return mapOptions;
     };
+    Object.defineProperty(Map.prototype, "layers", {
+        /**
+         * The marker layers instances.
+         */
+        get: function () {
+            var _a;
+            return (_a = this.mapInstance) === null || _a === void 0 ? void 0 : _a.layers;
+        },
+        enumerable: false,
+        configurable: true
+    });
+    Object.defineProperty(Map.prototype, "extent", {
+        /**
+         * Gets the extent (visible area) of the map.
+         */
+        get: function () {
+            var _a;
+            return (_a = this.mapInstance) === null || _a === void 0 ? void 0 : _a.extent();
+        },
+        /**
+         * Sets the extent (visible area) of the map.
+         */
+        set: function (extent) {
+            var _a;
+            (_a = this.mapInstance) === null || _a === void 0 ? void 0 : _a.extent(extent);
+        },
+        enumerable: false,
+        configurable: true
+    });
+    /**
+     * Detects the size of the container and redraws the Map.
+     * Resizing is automatic unless you set the `resizeRateLimit` option to `0`.
+     */
+    Map.prototype.resize = function () {
+        // this.mapInstance?.resize();
+    };
+    /**
+     * Retrieves the size of the visible portion of the map.
+     *
+     * @returns The size (width and height) of the visible portion of the map.
+     */
+    Map.prototype.viewSize = function () {
+        var _a;
+        return (_a = this.mapInstance) === null || _a === void 0 ? void 0 : _a.viewSize();
+    };
+    /**
+     * Returns the event coordinates relative to the map element. Offset coordinates are not synchronized to a particular location on the map.
+     *
+     * @param e The mouse event.
+     * @returns The event coordinates relative to the map element.
+     */
+    Map.prototype.eventOffset = function (e) {
+        var _a;
+        return (_a = this.mapInstance) === null || _a === void 0 ? void 0 : _a.eventOffset(e);
+    };
+    /**
+     * Retrieves projected (layer) coordinates that correspond to this mouse event.
+     * Layer coordinates are absolute and change only when the zoom level is changed.
+     *
+     * @param e The mouse event.
+     * @returns The projected (layer) coordinates that correspond to this event.
+     */
+    Map.prototype.eventToLayer = function (e) {
+        var _a;
+        return (_a = this.mapInstance) === null || _a === void 0 ? void 0 : _a.eventToLayer(e);
+    };
+    /**
+     * Retrieves the geographic location that correspond to this mouse event.
+     *
+     * @param e The mouse event.
+     * @returns The geographic location that correspond to this mouse event.
+     */
+    Map.prototype.eventToLocation = function (e) {
+        var _a;
+        return (_a = this.mapInstance) === null || _a === void 0 ? void 0 : _a.eventToLocation(e);
+    };
+    /**
+     * Retrieves relative (view) coordinates that correspond to this mouse event.
+     * Layer elements positioned on these coordinates will appear under the mouse cursor.
+     * View coordinates are no longer valid after a map reset.
+     *
+     * @param e The mouse event.
+     * @returns The relative (view) coordinates that correspond to this mouse event.
+     */
+    Map.prototype.eventToView = function (e) {
+        var _a;
+        return (_a = this.mapInstance) === null || _a === void 0 ? void 0 : _a.eventToView(e);
+    };
+    /**
+     * Transforms layer (projected) coordinates to geographical location.
+     *
+     * @param point The layer (projected) coordinates. An array argument is assumed to be in x, y order.
+     * @param zoom Optional. Assumed zoom level. Defaults to the current zoom level.
+     * @returns The geographic location that corresponds to the layer coordinates.
+     */
+    Map.prototype.layerToLocation = function (point, zoom) {
+        var _a;
+        return (_a = this.mapInstance) === null || _a === void 0 ? void 0 : _a.layerToLocation(point, zoom);
+    };
+    /**
+     * Returns the layer (projected) coordinates that correspond to a geographical location.
+     *
+     * @param location The geographic location. An array argument is assumed to be in [Latitude, Longitude] order.
+     * @param zoom Optional. Assumed zoom level. Defaults to the current zoom level.
+     * @returns The layer (projected) coordinates.
+     */
+    Map.prototype.locationToLayer = function (location, zoom) {
+        var _a;
+        return (_a = this.mapInstance) === null || _a === void 0 ? void 0 : _a.locationToLayer(location, zoom);
+    };
+    /**
+     * Returns the view (relative) coordinates that correspond to a geographical location.
+     *
+     * @param location The geographic location. An array argument is assumed to be in [Latitude, Longitude] order.
+     * @returns The view coordinates that correspond to a geographical location.
+     */
+    Map.prototype.locationToView = function (location) {
+        var _a;
+        return (_a = this.mapInstance) === null || _a === void 0 ? void 0 : _a.locationToView(location);
+    };
+    /**
+     * Returns the geographical location that correspond to the view (relative) coordinates.
+     *
+     * @param point The view coordinates. An array argument is assumed to be in x, y order.
+     * @param zoom Optional. Assumed zoom level. Defaults to the current zoom level.
+     * @returns The geographic location that corresponds to the view coordinates.
+     */
+    Map.prototype.viewToLocation = function (point, zoom) {
+        var _a;
+        return (_a = this.mapInstance) === null || _a === void 0 ? void 0 : _a.viewToLocation(point, zoom);
+    };
     /**
      * @hidden
      */

package/dist/npm/package-metadata.js

@@ -8,7 +8,7 @@ exports.packageMetadata = {
     name: '@progress/kendo-react-map',
     productName: 'KendoReact',
     productCodes: ['KENDOUIREACT', 'KENDOUICOMPLETE'],
-    publishDate: 1659604841,
+    publishDate: 1660032211,
     version: '',
     licensingDocsUrl: 'https://www.telerik.com/kendo-react-ui/my-license/?utm_medium=product&utm_source=kendoreact&utm_campaign=kendo-ui-react-purchase-license-keys-warning'
 };