fix(esl-media): fix play preconditions for toggle method (#2906)

Add the ability to pass `allowActivate` to the `ESLMedia.prototype.toggle`.
Remove `toggle` from provider API (only `play`/`pause`/`stop` are supported on the low level)

src/modules/esl-media/core/esl-media-provider.ts

@@ -126,18 +126,6 @@ export abstract class BaseProvider {
     this._el?.style.setProperty('aspect-ratio', aspectRatio > 0 ? `${aspectRatio}` : null);
   }
 
-  /**
-   * Executes toggle action:
-   * If the player is PAUSED then it starts playing otherwise it pause playing
-   */
-  protected toggle(): void | Promise<any> {
-    if ([PlayerStates.PAUSED, PlayerStates.UNSTARTED, PlayerStates.VIDEO_CUED].includes(this.state)) {
-      return this.play();
-    } else {
-      return this.pause();
-    }
-  }
-
   /** Executes onConfigChange action when api is ready */
   public onSafeConfigChange(param: ProviderObservedParams, value: boolean): void {
     this.ready.then(() => this.onConfigChange(param, value));
@@ -166,14 +154,6 @@ export abstract class BaseProvider {
     return this.ready.then(() => this.stop());
   }
 
-  /**
-   * Executes toggle when api is ready
-   * @returns Promise
-   */
-  public safeToggle(): Promise<void> {
-    return this.ready.then(() => this.toggle());
-  }
-
   /**
    * Register current provider.
    * Can be used as a decorator.

src/modules/esl-media/core/esl-media.ts

@@ -246,9 +246,13 @@ export class ESLMedia extends ESLBaseElement {
     return this._provider && this._provider.safeStop();
   }
 
-  /** Toggle play/pause state of the media */
-  public toggle(): Promise<void> | null {
-    return this._provider && this._provider.safeToggle();
+  /**
+   * Executes toggle action:
+   * If the player is PAUSED then it starts playing otherwise it pause playing
+   */
+  public toggle(allowActivate: boolean = false): Promise<void> | null {
+    const shouldActivate = [PlayerStates.PAUSED, PlayerStates.UNSTARTED, PlayerStates.VIDEO_CUED, PlayerStates.UNINITIALIZED].includes(this.state);
+    return shouldActivate ? this.play(allowActivate) : this.pause();
   }
 
   /** Focus inner player **/