@progress/kendo-angular-map 19.1.2-develop.2 → 19.1.2-develop.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (63) hide show
  1. package/directives.d.ts +2 -2
  2. package/esm2022/directives.mjs +2 -2
  3. package/esm2022/events/before-reset-event.mjs +2 -1
  4. package/esm2022/events/map-click-event.mjs +3 -2
  5. package/esm2022/events/marker-activate-event.mjs +2 -1
  6. package/esm2022/events/marker-click-event.mjs +2 -1
  7. package/esm2022/events/marker-created-event.mjs +3 -2
  8. package/esm2022/events/pan-end-event.mjs +3 -2
  9. package/esm2022/events/pan-event.mjs +3 -2
  10. package/esm2022/events/reset-event.mjs +2 -1
  11. package/esm2022/events/shape-click-event.mjs +3 -2
  12. package/esm2022/events/shape-created-event.mjs +3 -2
  13. package/esm2022/events/shape-feature-created-event.mjs +4 -3
  14. package/esm2022/events/shape-mouse-enter-event.mjs +5 -4
  15. package/esm2022/events/shape-mouse-leave-event.mjs +5 -4
  16. package/esm2022/events/zoom-end-event.mjs +3 -2
  17. package/esm2022/events/zoom-start-event.mjs +4 -4
  18. package/esm2022/map/bubble-layer.component.mjs +33 -11
  19. package/esm2022/map/layers.component.mjs +20 -1
  20. package/esm2022/map/marker-layer.component.mjs +29 -9
  21. package/esm2022/map/shape-layer.component.mjs +22 -3
  22. package/esm2022/map/tile-layer.component.mjs +24 -6
  23. package/esm2022/map.component.mjs +70 -69
  24. package/esm2022/map.module.mjs +18 -18
  25. package/esm2022/package-metadata.mjs +2 -2
  26. package/esm2022/tooltip/bubble-tooltip-template.directive.mjs +21 -0
  27. package/esm2022/tooltip/bubble-tooltip.component.mjs +24 -1
  28. package/esm2022/tooltip/marker-tooltip-template.directive.mjs +21 -0
  29. package/esm2022/tooltip/marker-tooltip.component.mjs +24 -1
  30. package/esm2022/tooltip/shape-tooltip-template.directive.mjs +21 -0
  31. package/esm2022/tooltip/shape-tooltip.component.mjs +24 -1
  32. package/events/before-reset-event.d.ts +2 -1
  33. package/events/map-click-event.d.ts +3 -2
  34. package/events/marker-activate-event.d.ts +2 -1
  35. package/events/marker-click-event.d.ts +2 -1
  36. package/events/marker-created-event.d.ts +3 -2
  37. package/events/pan-end-event.d.ts +3 -2
  38. package/events/pan-event.d.ts +3 -2
  39. package/events/reset-event.d.ts +2 -1
  40. package/events/shape-click-event.d.ts +3 -2
  41. package/events/shape-created-event.d.ts +3 -2
  42. package/events/shape-feature-created-event.d.ts +4 -3
  43. package/events/shape-mouse-enter-event.d.ts +5 -4
  44. package/events/shape-mouse-leave-event.d.ts +5 -4
  45. package/events/zoom-end-event.d.ts +3 -2
  46. package/events/zoom-start-event.d.ts +4 -4
  47. package/fesm2022/progress-kendo-angular-map.mjs +402 -157
  48. package/map/bubble-layer.component.d.ts +33 -11
  49. package/map/layers.component.d.ts +20 -1
  50. package/map/marker-layer.component.d.ts +29 -9
  51. package/map/shape-layer.component.d.ts +22 -3
  52. package/map/tile-layer.component.d.ts +24 -6
  53. package/map.component.d.ts +70 -69
  54. package/map.module.d.ts +18 -18
  55. package/package.json +7 -7
  56. package/schematics/ngAdd/index.js +1 -1
  57. package/tooltip/bubble-tooltip-template.directive.d.ts +21 -0
  58. package/tooltip/bubble-tooltip.component.d.ts +24 -1
  59. package/tooltip/marker-tooltip-template.directive.d.ts +21 -0
  60. package/tooltip/marker-tooltip.component.d.ts +24 -1
  61. package/tooltip/popup-settings.interface.d.ts +3 -3
  62. package/tooltip/shape-tooltip-template.directive.d.ts +21 -0
  63. package/tooltip/shape-tooltip.component.d.ts +24 -1
@@ -39,11 +39,14 @@ const svgIcons = {
39
39
  /**
40
40
  * Represents the [Kendo UI Map component for Angular]({% slug overview_map %}).
41
41
  *
42
+ * Use this component to display interactive maps with markers, layers, and controls.
43
+ * Configure zoom levels, center coordinates, and user interactions like panning and zooming.
44
+ *
42
45
  * @example
43
46
  * ```ts
44
47
  * import { Component } from '@angular/core';
45
48
  *
46
- * _@Component({
49
+ * @Component({
47
50
  * selector: 'my-app',
48
51
  * template: `
49
52
  * <kendo-map [center]="center" [zoom]="15">
@@ -72,7 +75,6 @@ const svgIcons = {
72
75
  * center = [30.2675, -97.7409];
73
76
  * markers = [{ latlng: [30.2675, -97.7409], name: "Zevo Toys" }];
74
77
  * }
75
- *
76
78
  * ```
77
79
  */
78
80
  export class MapComponent {
@@ -87,18 +89,16 @@ export class MapComponent {
87
89
  /**
88
90
  * Limits the automatic resizing of the Map. Sets the maximum number of times per second
89
91
  * that the component redraws its content when the size of its container changes.
90
- * Defaults to `10`. To disable the automatic resizing, set it to `0`.
92
+ * To disable the automatic resizing, set it to `0`.
93
+ *
94
+ * @default 10
91
95
  *
92
96
  * @example
93
97
  * ```ts
94
- * _@Component({
98
+ * @Component({
95
99
  * selector: 'my-app',
96
100
  * template: `
97
101
  * <kendo-map [resizeRateLimit]="2">
98
- * <!-- ^^^^^^^^^^^^^^^^^^^^^^
99
- * Will update the size of the Map up to two times a second.
100
- * Resize the example pane or window to try it out.
101
- * -->
102
102
  * </kendo-map>
103
103
  * `
104
104
  * })
@@ -108,11 +108,12 @@ export class MapComponent {
108
108
  */
109
109
  resizeRateLimit = 10;
110
110
  /**
111
- * The map center. Coordinates are listed as `[Latitude, Longitude]`.
111
+ * Specifies the map center coordinates.
112
+ * Provide coordinates as `[Latitude, Longitude]`.
112
113
  */
113
114
  center;
114
115
  /**
115
- * The configuration of built-in map controls.
116
+ * Specifies the configuration for built-in map controls.
116
117
  */
117
118
  controls;
118
119
  /**
@@ -150,101 +151,98 @@ export class MapComponent {
150
151
  */
151
152
  wraparound;
152
153
  /**
153
- * The initial zoom level.
154
- *
155
- * Typical web maps use zoom levels from 0 (whole world) to 19 (sub-meter features).
156
- *
157
- * The map size is derived from the zoom level and minScale options: `size = (2 ^ zoom) * minSize`
158
- *
159
- * > Map zoom rounds floating point numbers. This is done so as the majority of web maps use the whole [`zoom levels`](https://wiki.openstreetmap.org/wiki/Zoom_levels) 0 through to 19.
154
+ * Specifies the initial zoom level.
155
+ * Use values from 0 (whole world) to 19 (sub-meter features).
156
+ * The map size derives from the zoom level and `minScale` options: `size = (2 ^ zoom) * minSize`.
157
+ * Map zoom rounds floating point numbers to use whole [`zoom levels`](https://wiki.openstreetmap.org/wiki/Zoom_levels) 0 through 19.
160
158
  *
161
159
  * @default 3
162
160
  */
163
161
  zoom = 3;
164
162
  /**
165
- * Controls whether the map zoom level can be changed by the user.
163
+ * Determines whether users can change the map zoom level.
166
164
  *
167
165
  * @default true
168
166
  */
169
167
  zoomable;
170
168
  /**
171
- * Fired immediately before the map is reset. This event is typically used for cleanup by layer implementers.
169
+ * Fires immediately before the map resets. This event is typically used for cleanup by layer implementers.
172
170
  */
173
171
  beforeReset = new EventEmitter();
174
172
  /**
175
- * Fired when the user clicks on the map.
173
+ * Fires when the user clicks on the map.
176
174
  */
177
175
  mapClick = new EventEmitter();
178
176
  /**
179
- * Fired when a marker has been displayed and has a DOM element assigned.
177
+ * Fires when a marker appears on the map and its DOM element becomes available.
180
178
  */
181
179
  markerActivate = new EventEmitter();
182
180
  /**
183
- * Fired when a marker has been clicked or tapped.
181
+ * Fires when the user clicks or taps a marker.
184
182
  */
185
183
  markerClick = new EventEmitter();
186
184
  /**
187
- * Fired when a marker has been created and is about to be displayed.
185
+ * Fires once the map has created a marker, and just before the map displays it.
188
186
  *
189
- * Cancelling the event will prevent the marker from being shown.
187
+ * Cancelling the event prevents displaying the marker.
190
188
  */
191
189
  markerCreated = new EventEmitter();
192
190
  /**
193
- * Fires after the map viewport has been moved.
191
+ * Fires after the map viewport completes panning.
194
192
  */
195
193
  panEnd = new EventEmitter();
196
194
  /**
197
- * Fired while the map viewport is being moved.
195
+ * Fires while the map viewport is being moved.
198
196
  */
199
197
  pan = new EventEmitter();
200
198
  /**
201
- * Fired when the map is reset.
199
+ * Fires when the map resets.
202
200
  *
203
201
  * This typically occurs on initial load and after a zoom/center change.
204
202
  */
205
203
  reset = new EventEmitter();
206
204
  /**
207
- * Fired when a shape is clicked or tapped.
205
+ * Fires when a shape is clicked or tapped.
208
206
  */
209
207
  shapeClick = new EventEmitter();
210
208
  /**
211
- * Fired when a shape is created, but is not rendered yet.
209
+ * Fires when a shape is created, but is not rendered yet.
212
210
  */
213
211
  shapeCreated = new EventEmitter();
214
212
  /**
215
- * Fired when a [GeoJSON Feature](https://geojson.org/geojson-spec.html#feature-objects) is created on a shape layer.
213
+ * Fires when a [GeoJSON Feature](https://geojson.org/geojson-spec.html#feature-objects) is created on a shape layer.
216
214
  */
217
215
  shapeFeatureCreated = new EventEmitter();
218
216
  /**
219
- * Fired when the mouse enters a shape.
217
+ * Fires when the mouse enters a shape.
220
218
  *
221
219
  * > This event will fire reliably only for shapes that have set fill color.
222
220
  * > The opacity can still be set to 0 so the shapes appear to have no fill.
223
221
  */
224
222
  shapeMouseEnter = new EventEmitter();
225
223
  /**
226
- * Fired when the mouse leaves a shape.
224
+ * Fires when the mouse leaves a shape.
227
225
  *
228
226
  * > This event will fire reliably only for shapes that have set fill color.
229
227
  * > The opacity can still be set to 0 so the shapes appear to have no fill.
230
228
  */
231
229
  shapeMouseLeave = new EventEmitter();
232
230
  /**
233
- * Fired when the map zoom level is about to change.
231
+ * Fires when the map zoom level is about to change.
234
232
  *
235
233
  * Cancelling the event will prevent the user action.
236
234
  */
237
235
  zoomStart = new EventEmitter();
238
236
  /**
239
- * Fired when the map zoom level has changed.
237
+ * Fires when the map zoom level changes.
240
238
  */
241
239
  zoomEnd = new EventEmitter();
242
240
  /**
243
- * Fired when the map center has been changed.
241
+ * Fires when the map center has been changed.
244
242
  */
245
243
  centerChange = new EventEmitter();
246
244
  /**
247
- * Fired when the map zoom level has been changed.
245
+ * Fires when the map zoom level has been changed.
248
246
  */
249
247
  zoomChange = new EventEmitter();
250
248
  tooltipInstance;
@@ -331,7 +329,7 @@ export class MapComponent {
331
329
  }
332
330
  }
333
331
  /**
334
- * The marker layers instances.
332
+ * Gets the marker layers instances.
335
333
  */
336
334
  get layers() {
337
335
  return this.instance?.layers;
@@ -349,92 +347,95 @@ export class MapComponent {
349
347
  this.instance?.extent(extent);
350
348
  }
351
349
  /**
352
- * Detects the size of the container and redraws the Map.
353
- * Resizing is automatic unless you set the `resizeRateLimit` option to `0`.
350
+ * Detects the container size and redraws the Map.
351
+ * Resizing happens automatically unless you set `resizeRateLimit` to `0`.
354
352
  */
355
353
  resize() {
356
354
  //this.instance?.resize();
357
355
  }
358
356
  /**
359
- * Retrieves the size of the visible portion of the map.
357
+ * Gets the size of the visible map area.
360
358
  *
361
- * @returns The size (width and height) of the visible portion of the map.
359
+ * @returns {Object} The width and height of the visible map area.
362
360
  */
363
361
  viewSize() {
364
362
  return this.instance?.viewSize();
365
363
  }
366
364
  /**
367
- * Returns the event coordinates relative to the map element. Offset coordinates are not synchronized to a particular location on the map.
365
+ * Gets event coordinates relative to the map element.
366
+ * Offset coordinates do not sync to a specific map location.
368
367
  *
369
- * @param e The mouse event.
370
- * @returns The event coordinates relative to the map element.
368
+ * @param {any} e The mouse event.
369
+ * @returns {geometry.Point} The event coordinates relative to the map element.
371
370
  */
372
371
  eventOffset(e) {
373
372
  return this.instance?.eventOffset(e);
374
373
  }
375
374
  /**
376
- * Retrieves projected (layer) coordinates that correspond to this mouse event. Layer coordinates are absolute and change only when the zoom level is changed.
375
+ * Gets projected layer coordinates for this mouse event.
376
+ * Layer coordinates are absolute and change only when zoom level changes.
377
377
  *
378
- * @param e The mouse event.
379
- * @returns The projected (layer) coordinates that correspond to this event.
378
+ * @param {any} e The mouse event.
379
+ * @returns {geometry.Point} The projected layer coordinates for this event.
380
380
  */
381
381
  eventToLayer(e) {
382
382
  return this.instance?.eventToLayer(e);
383
383
  }
384
384
  /**
385
- * Retrieves the geographic location that correspond to this mouse event.
385
+ * Gets the geographic location for this mouse event.
386
386
  *
387
- * @param e The mouse event.
388
- * @returns The geographic location that correspond to this mouse event.
387
+ * @param {any} e The mouse event.
388
+ * @returns {geometry.Point} The geographic location for this mouse event.
389
389
  */
390
390
  eventToLocation(e) {
391
391
  return this.instance?.eventToLocation(e);
392
392
  }
393
393
  /**
394
- * Retrieves relative (view) coordinates that correspond to this mouse event. Layer elements positioned on these coordinates will appear under the mouse cursor.
395
- * View coordinates are no longer valid after a map reset.
394
+ * Gets relative view coordinates for this mouse event.
395
+ * Layer elements positioned on these coordinates appear under the mouse cursor.
396
+ * View coordinates become invalid after a map reset.
396
397
  *
397
- * @param e The mouse event.
398
- * @returns The relative (view) coordinates that correspond to this mouse event.
398
+ * @param {any} e The mouse event.
399
+ * @returns {geometry.Point} The relative view coordinates for this mouse event.
399
400
  */
400
401
  eventToView(e) {
401
402
  return this.instance?.eventToView(e);
402
403
  }
403
404
  /**
404
- * Transforms layer (projected) coordinates to geographical location.
405
+ * Converts layer coordinates to geographic location.
405
406
  *
406
- * @param point The layer (projected) coordinates. An array argument is assumed to be in x, y order.
407
- * @param zoom Optional. Assumed zoom level. Defaults to the current zoom level.
408
- * @returns The geographic location that corresponds to the layer coordinates.
407
+ * @param {geometry.Point | number[]} point The layer coordinates. Arrays use x, y order.
408
+ * @param {number} zoom Optional. Zoom level to use. Defaults to current zoom level.
409
+ * @returns {Location} The geographic location for the layer coordinates.
409
410
  */
410
411
  layerToLocation(point, zoom) {
411
412
  return this.instance?.layerToLocation(point, zoom);
412
413
  }
413
414
  /**
414
- * Returns the layer (projected) coordinates that correspond to a geographical location.
415
+ * Gets layer coordinates for a geographic location.
415
416
  *
416
- * @param location The geographic location. An array argument is assumed to be in [Latitude, Longitude] order.
417
- * @param zoom Optional. Assumed zoom level. Defaults to the current zoom level.
418
- * @returns The layer (projected) coordinates.
417
+ * @param {Location | number[]} location The geographic location. Arrays use [Latitude, Longitude] order.
418
+ * @param {number} zoom Optional. Zoom level to use. Defaults to current zoom level.
419
+ * @returns {geometry.Point} The layer coordinates.
419
420
  */
420
421
  locationToLayer(location, zoom) {
421
422
  return this.instance?.locationToLayer(location, zoom);
422
423
  }
423
424
  /**
424
- * Returns the view (relative) coordinates that correspond to a geographical location.
425
+ * Gets view coordinates for a geographic location.
425
426
  *
426
- * @param location The geographic location. An array argument is assumed to be in [Latitude, Longitude] order.
427
- * @returns The view coordinates that correspond to a geographical location.
427
+ * @param {Location | number[]} location The geographic location. Arrays use [Latitude, Longitude] order.
428
+ * @returns {geometry.Point} The view coordinates for the geographic location.
428
429
  */
429
430
  locationToView(location) {
430
431
  return this.instance?.locationToView(location);
431
432
  }
432
433
  /**
433
- * Returns the geographical location that correspond to the view (relative) coordinates.
434
+ * Gets the geographic location for view coordinates.
434
435
  *
435
- * @param point The view coordinates. An array argument is assumed to be in x, y order.
436
- * @param zoom Optional. Assumed zoom level. Defaults to the current zoom level.
437
- * @returns The geographic location that corresponds to the view coordinates.
436
+ * @param {geometry.Point | number[]} point The view coordinates. Arrays use x, y order.
437
+ * @param {number} zoom Optional. Zoom level to use. Defaults to current zoom level.
438
+ * @returns {Location} The geographic location for the view coordinates.
438
439
  */
439
440
  viewToLocation(point, zoom) {
440
441
  return this.instance?.viewToLocation(point, zoom);
@@ -22,24 +22,24 @@ import * as i12 from "./map/tile-layer.component";
22
22
  //IMPORTANT: NgModule export kept for backwards compatibility
23
23
  /**
24
24
  * Represents the [NgModule](link:site.data.urls.angular['ngmoduleapi'])
25
- * definition for the Map component.
26
- * @example
27
- *
28
- * ```ts
29
- * import { BrowserAnimationsModule } from '@angular/platform-browser/animations';
30
- * import { BrowserModule } from '@angular/platform-browser';
31
- * import { NgModule } from '@angular/core';
32
- * import { MapModule } from '@progress/kendo-angular-map';
33
- * import { AppComponent } from './app.component';
34
- *
35
- * @NgModule({
36
- * declarations: [AppComponent],
37
- * imports: [BrowserModule, BrowserAnimationsModule, MapModule],
38
- * bootstrap: [AppComponent]
39
- * })
40
- * export class AppModule {}
41
- *```
42
- */
25
+ * definition for the Map component.
26
+ *
27
+ * @example
28
+ * ```ts
29
+ * import { BrowserAnimationsModule } from '@angular/platform-browser/animations';
30
+ * import { BrowserModule } from '@angular/platform-browser';
31
+ * import { NgModule } from '@angular/core';
32
+ * import { MapModule } from '@progress/kendo-angular-map';
33
+ * import { AppComponent } from './app.component';
34
+ *
35
+ * @NgModule({
36
+ * declarations: [AppComponent],
37
+ * imports: [BrowserModule, BrowserAnimationsModule, MapModule],
38
+ * bootstrap: [AppComponent]
39
+ * })
40
+ * export class AppModule {}
41
+ * ```
42
+ */
43
43
  export class MapModule {
44
44
  static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "16.2.12", ngImport: i0, type: MapModule, deps: [], target: i0.ɵɵFactoryTarget.NgModule });
45
45
  static ɵmod = i0.ɵɵngDeclareNgModule({ minVersion: "14.0.0", version: "16.2.12", ngImport: i0, type: MapModule, imports: [i1.BubbleLayerComponent, i2.BubbleTooltipComponent, i3.BubbleTooltipTemplateDirective, i4.LayersComponent, i5.MapComponent, i6.MarkerLayerComponent, i7.MarkerTooltipComponent, i8.MarkerTooltipTemplateDirective, i9.ShapeLayerComponent, i10.ShapeTooltipComponent, i11.ShapeTooltipTemplateDirective, i12.TileLayerComponent], exports: [i1.BubbleLayerComponent, i2.BubbleTooltipComponent, i3.BubbleTooltipTemplateDirective, i4.LayersComponent, i5.MapComponent, i6.MarkerLayerComponent, i7.MarkerTooltipComponent, i8.MarkerTooltipTemplateDirective, i9.ShapeLayerComponent, i10.ShapeTooltipComponent, i11.ShapeTooltipTemplateDirective, i12.TileLayerComponent] });
@@ -10,7 +10,7 @@ export const packageMetadata = {
10
10
  productName: 'Kendo UI for Angular',
11
11
  productCode: 'KENDOUIANGULAR',
12
12
  productCodes: ['KENDOUIANGULAR'],
13
- publishDate: 1749820745,
14
- version: '19.1.2-develop.2',
13
+ publishDate: 1750152817,
14
+ version: '19.1.2-develop.3',
15
15
  licensingDocsUrl: 'https://www.telerik.com/kendo-angular-ui/my-license/'
16
16
  };
@@ -14,6 +14,27 @@ import * as i0 from "@angular/core";
14
14
  * * `layerIndex: number`&mdash;The index of the layer for the tooltip.
15
15
  * * `location: Location`&mdash;The location of the bubble.
16
16
  * * `value: number`&mdash;The value of the bubble.
17
+ *
18
+ * @example
19
+ * ```typescript
20
+ * @Component({
21
+ * selector: 'my-app',
22
+ * template: `
23
+ * <kendo-map>
24
+ * <kendo-map-layer type="bubble" [data]="data">
25
+ * <kendo-map-bubble-layer-tooltip>
26
+ * <ng-template kendoMapBubbleTooltipTemplate let-dataItem="dataItem" let-value="value">
27
+ * <div>{{ dataItem.name }}: {{ value }}</div>
28
+ * </ng-template>
29
+ * </kendo-map-bubble-layer-tooltip>
30
+ * </kendo-map-layer>
31
+ * </kendo-map>
32
+ * `
33
+ * })
34
+ * export class AppComponent {
35
+ * public data = [{ name: 'City', value: 100000 }];
36
+ * }
37
+ * ```
17
38
  */
18
39
  export class BubbleTooltipTemplateDirective {
19
40
  templateRef;
@@ -13,7 +13,30 @@ import * as i1 from "../common/configuration.service";
13
13
  import * as i2 from "./tooltip-template.service";
14
14
  import * as i3 from "../map/layer.component";
15
15
  /**
16
- * The configuration options of the [Bubble Layer Tooltip](slug:bubble_layers_map#toc-tooltips).
16
+ * Represents the Kendo UI BubbleTooltip component for Angular.
17
+ *
18
+ * Configures the [Bubble Layer Tooltip](slug:bubble_layers_map#toc-tooltips).
19
+ *
20
+ * @example
21
+ * ```typescript
22
+ * @Component({
23
+ * selector: 'my-app',
24
+ * template: `
25
+ * <kendo-map>
26
+ * <kendo-map-layer type="bubble" [data]="bubbleData">
27
+ * <kendo-map-bubble-layer-tooltip>
28
+ * <ng-template kendoMapBubbleTooltipTemplate let-dataItem="dataItem" let-value="value">
29
+ * <div>{{ dataItem.name }}: {{ value }}</div>
30
+ * </ng-template>
31
+ * </kendo-map-bubble-layer-tooltip>
32
+ * </kendo-map-layer>
33
+ * </kendo-map>
34
+ * `
35
+ * })
36
+ * export class AppComponent {
37
+ * public bubbleData = [{ name: 'Population', value: 50000 }];
38
+ * }
39
+ * ```
17
40
  */
18
41
  export class BubbleTooltipComponent extends SettingsComponent {
19
42
  configurationService;
@@ -13,6 +13,27 @@ import * as i0 from "@angular/core";
13
13
  * * `title: string`&mdash;The marker title.
14
14
  * * `layerIndex: number`&mdash;The index of the layer for the tooltip.
15
15
  * * `location: Location`&mdash;The marker location.
16
+ *
17
+ * @example
18
+ * ```typescript
19
+ * @Component({
20
+ * selector: 'my-app',
21
+ * template: `
22
+ * <kendo-map>
23
+ * <kendo-map-layer type="marker" [data]="markers">
24
+ * <kendo-map-marker-layer-tooltip>
25
+ * <ng-template kendoMapMarkerTooltipTemplate let-title="title" let-location="location">
26
+ * <div>{{ title }} at {{ location.lat }}, {{ location.lng }}</div>
27
+ * </ng-template>
28
+ * </kendo-map-marker-layer-tooltip>
29
+ * </kendo-map-layer>
30
+ * </kendo-map>
31
+ * `
32
+ * })
33
+ * export class AppComponent {
34
+ * public markers = [{ title: 'Office', location: [42.6977, 23.3219] }];
35
+ * }
36
+ * ```
16
37
  */
17
38
  export class MarkerTooltipTemplateDirective {
18
39
  templateRef;
@@ -13,7 +13,30 @@ import * as i1 from "../common/configuration.service";
13
13
  import * as i2 from "./tooltip-template.service";
14
14
  import * as i3 from "../map/layer.component";
15
15
  /**
16
- * The configuration options of the [Marker Layer Tooltip](slug:marker_layers_map#toc-tooltips).
16
+ * Represents the Kendo UI MarkerTooltip component for Angular.
17
+ *
18
+ * Configures the [Marker Layer Tooltip](slug:marker_layers_map#toc-tooltips).
19
+ *
20
+ * @example
21
+ * ```typescript
22
+ * @Component({
23
+ * selector: 'my-app',
24
+ * template: `
25
+ * <kendo-map>
26
+ * <kendo-map-layer type="marker" [data]="markers">
27
+ * <kendo-map-marker-layer-tooltip>
28
+ * <ng-template kendoMapMarkerTooltipTemplate let-title="title">
29
+ * <div>Marker: {{ title }}</div>
30
+ * </ng-template>
31
+ * </kendo-map-marker-layer-tooltip>
32
+ * </kendo-map-layer>
33
+ * </kendo-map>
34
+ * `
35
+ * })
36
+ * export class AppComponent {
37
+ * public markers = [{ title: 'Location A' }];
38
+ * }
39
+ * ```
17
40
  */
18
41
  export class MarkerTooltipComponent extends SettingsComponent {
19
42
  configurationService;
@@ -13,6 +13,27 @@ import * as i0 from "@angular/core";
13
13
  * * `dataItem: any`&mdash;The original data item used to create the shape.
14
14
  * * `layerIndex: number`&mdash;The index of the layer for the tooltip.
15
15
  * * `location: Location`&mdash;The location of the center of the shape.
16
+ *
17
+ * @example
18
+ * ```typescript
19
+ * @Component({
20
+ * selector: 'my-app',
21
+ * template: `
22
+ * <kendo-map>
23
+ * <kendo-map-layer type="shape" [data]="data">
24
+ * <kendo-map-shape-layer-tooltip>
25
+ * <ng-template kendoMapShapeTooltipTemplate let-dataItem="dataItem" let-layerIndex="layerIndex">
26
+ * <div>Shape: {{ dataItem.properties.name }} (Layer {{ layerIndex }})</div>
27
+ * </ng-template>
28
+ * </kendo-map-shape-layer-tooltip>
29
+ * </kendo-map-layer>
30
+ * </kendo-map>
31
+ * `
32
+ * })
33
+ * export class AppComponent {
34
+ * public data = [ ... ]; // GeoJSON data for shapes
35
+ * }
36
+ * ```
16
37
  */
17
38
  export class ShapeTooltipTemplateDirective {
18
39
  templateRef;
@@ -13,7 +13,30 @@ import * as i1 from "../common/configuration.service";
13
13
  import * as i2 from "./tooltip-template.service";
14
14
  import * as i3 from "../map/layer.component";
15
15
  /**
16
- * The configuration options of the [Shape Layer Tooltip](slug:shape_layers_map#toc-tooltips).
16
+ * Represents the Kendo UI ShapeTooltip component for Angular.
17
+ *
18
+ * Configures the [Shape Layer Tooltip](slug:shape_layers_map#toc-tooltips).
19
+ *
20
+ * @example
21
+ * ```typescript
22
+ * @Component({
23
+ * selector: 'my-app',
24
+ * template: `
25
+ * <kendo-map>
26
+ * <kendo-map-layer type="shape" [data]="shapeData">
27
+ * <kendo-map-shape-layer-tooltip>
28
+ * <ng-template kendoMapShapeTooltipTemplate let-dataItem="dataItem">
29
+ * <div>{{ dataItem.properties.name }}</div>
30
+ * </ng-template>
31
+ * </kendo-map-shape-layer-tooltip>
32
+ * </kendo-map-layer>
33
+ * </kendo-map>
34
+ * `
35
+ * })
36
+ * export class AppComponent {
37
+ * public shapeData = [ ... ]; // GeoJSON data for shapes
38
+ * }
39
+ * ```
17
40
  */
18
41
  export class ShapeTooltipComponent extends SettingsComponent {
19
42
  configurationService;
@@ -6,7 +6,8 @@ import { MapBeforeResetEvent } from '@progress/kendo-charts';
6
6
  import { MapComponent } from '../map.component';
7
7
  import { BaseEvent } from './base-event';
8
8
  /**
9
- * Fired immediately before the map is reset. This event is typically used for cleanup by layer implementers.
9
+ * Arguments for the `beforeReset` event.
10
+ * Fires immediately before the map resets. Layer implementers typically use this event for cleanup.
10
11
  */
11
12
  export declare class BeforeResetEvent extends BaseEvent implements MapBeforeResetEvent {
12
13
  /**
@@ -6,7 +6,8 @@ import { Location, MapClickEvent as BaseMapClickEvent } from '@progress/kendo-ch
6
6
  import { MapComponent } from '../map.component';
7
7
  import { BaseEvent } from './base-event';
8
8
  /**
9
- * Fired when the user clicks on the map.
9
+ * Arguments for the `mapClick` event.
10
+ * Fires when you click on the map.
10
11
  */
11
12
  export declare class MapClickEvent extends BaseEvent implements BaseMapClickEvent {
12
13
  /**
@@ -14,7 +15,7 @@ export declare class MapClickEvent extends BaseEvent implements BaseMapClickEven
14
15
  */
15
16
  location: Location;
16
17
  /**
17
- * The source DOM event instance
18
+ * The source DOM event instance.
18
19
  */
19
20
  originalEvent: any;
20
21
  /**
@@ -6,7 +6,8 @@ import { MapLayer, MapMarker, MapMarkerActivateEvent } from '@progress/kendo-cha
6
6
  import { MapComponent } from '../map.component';
7
7
  import { BaseEvent } from './base-event';
8
8
  /**
9
- * Fired when a marker has been displayed and has a DOM element assigned.
9
+ * Arguments for the `markerActivate` event.
10
+ * Fires when a marker displays and has a DOM element assigned.
10
11
  */
11
12
  export declare class MarkerActivateEvent extends BaseEvent implements MapMarkerActivateEvent {
12
13
  /**
@@ -6,7 +6,8 @@ import { MapLayer, MapMarker, MapMarkerClickEvent } from '@progress/kendo-charts
6
6
  import { MapComponent } from '../map.component';
7
7
  import { BaseEvent } from './base-event';
8
8
  /**
9
- * Fired when a marker has been clicked or tapped.
9
+ * Arguments for the `markerClick` event.
10
+ * Fires when the user clicks or taps a marker.
10
11
  */
11
12
  export declare class MarkerClickEvent extends BaseEvent implements MapMarkerClickEvent {
12
13
  /**
@@ -6,9 +6,10 @@ import { MapLayer, MapMarker, MapMarkerCreatedEvent } from '@progress/kendo-char
6
6
  import { MapComponent } from '../map.component';
7
7
  import { PreventableEvent } from './preventable-event';
8
8
  /**
9
- * Fired when a marker has been created and is about to be displayed.
9
+ * Arguments for the `markerCreated` event.
10
+ * Fires once the map has created a marker, and just before the map displays it.
10
11
  *
11
- * Cancelling the event will prevent the marker from being shown.
12
+ * Cancelling the event prevents displaying the marker.
12
13
  */
13
14
  export declare class MarkerCreatedEvent extends PreventableEvent implements MapMarkerCreatedEvent {
14
15
  /**
@@ -6,7 +6,8 @@ import { Location, MapPanEndEvent } from '@progress/kendo-charts';
6
6
  import { MapComponent } from '../map.component';
7
7
  import { BaseEvent } from './base-event';
8
8
  /**
9
- * Fires after the map viewport has been moved.
9
+ * Arguments for the `panEnd` event.
10
+ * Fires after the map viewport completes panning.
10
11
  */
11
12
  export declare class PanEndEvent extends BaseEvent implements MapPanEndEvent {
12
13
  /**
@@ -18,7 +19,7 @@ export declare class PanEndEvent extends BaseEvent implements MapPanEndEvent {
18
19
  */
19
20
  center: Location;
20
21
  /**
21
- * The source DOM event instance
22
+ * The source DOM event instance.
22
23
  */
23
24
  originalEvent: any;
24
25
  /**