Merge pull request #12416 from ahocevar/eventtype-generics

Use generics to limit event types in on(), once() and un()

src/ol/control/Control.js

@@ -41,6 +41,8 @@ import {removeNode} from '../dom.js';
  * You can also extend this base for your own control class. See
  * examples/custom-controls for an example of how to do this.
  *
+ * @template {string} EventTypes
+ * @extends BaseObject<EventTypes>
  * @api
  */
 class Control extends BaseObject {

src/ol/control/FullScreen.js

@@ -66,6 +66,7 @@ const FullScreenEventType = {
  *
  * @fires FullScreenEventType#enterfullscreen
  * @fires FullScreenEventType#leavefullscreen
+ * @extends Control<'enterfullscreen'|'leavefullscreen'>
  * @api
  */
 class FullScreen extends Control {

src/ol/control/MousePosition.js

@@ -49,6 +49,7 @@ const COORDINATE_FORMAT = 'coordinateFormat';
  * On touch devices, which usually do not have a mouse cursor, the coordinates
  * of the currently touched position are shown.
  *
+ * @extends Control<'change:coordinaetFormat'|'change:projection'>
  * @api
  */
 class MousePosition extends Control {

src/ol/control/ScaleLine.js

@@ -68,6 +68,7 @@ const DEFAULT_DPI = 25.4 / 0.28;
  * When specifying `bar` as `true`, a scalebar will be rendered instead
  * of a scaleline.
  *
+ * @extends Control<'change:units'>
  * @api
  */
 class ScaleLine extends Control {