refactor: rename forwardEventToHost to forwardEvent

src/elements/core/eventing/forward-event.ts

@@ -1,9 +1,16 @@
 /**
- * Forwards an event to the host element provided.
- * This way, an event triggered in the ShadowDOM can cross its boundary and can be listened on the host component.
+ * Forwards an event to the element provided.
+ * This way, an event triggered in the Shadow DOM can cross its boundary and can be listened on e.g. the host component.
  */
-export function forwardEventToHost(event: Event, host: HTMLElement | Document): void {
+export function forwardEvent(event: Event, element: HTMLElement | Document): void {
   const eventConstructor = Object.getPrototypeOf(event).constructor;
   const copiedEvent: Event = new eventConstructor(event.type, event);
-  host.dispatchEvent(copiedEvent);
+  element.dispatchEvent(copiedEvent);
 }
+
+/**
+ * Forwards an event to the host element provided.
+ * This way, an event triggered in the ShadowDOM can cross its boundary and can be listened on the host component.
+ * @deprecated will be removed with next major version, use forwardEvent as alternative
+ */
+export const forwardEventToHost = forwardEvent;

src/elements/datepicker/datepicker/datepicker.ts

@@ -13,7 +13,7 @@ import { SbbConnectedAbortController, SbbLanguageController } from '../../core/c
 import { type DateAdapter, defaultDateAdapter } from '../../core/datetime.js';
 import { forceType } from '../../core/decorators.js';
 import { findInput, findReferencedElement } from '../../core/dom.js';
-import { EventEmitter, forwardEventToHost } from '../../core/eventing.js';
+import { EventEmitter, forwardEvent } from '../../core/eventing.js';
 import { i18nDateChangedTo, i18nDatePickerPlaceholder } from '../../core/i18n.js';
 import type { SbbDateLike, SbbValidationChangeEvent } from '../../core/interfaces.js';
 import type { SbbDatepickerButton } from '../common.js';
@@ -243,7 +243,7 @@ class SbbDatepickerElement<T = Date> extends LitElement {
       input.addEventListener(
         'input',
         (e) => {
-          forwardEventToHost(e, this);
+          forwardEvent(e, this);
           this._parseInput();
         },
         options,

src/elements/dialog/dialog-content/dialog-content.ts

@@ -2,7 +2,7 @@ import type { CSSResultGroup, TemplateResult } from 'lit';
 import { html, LitElement } from 'lit';
 import { customElement } from 'lit/decorators.js';
 
-import { forwardEventToHost } from '../../core/eventing.js';
+import { forwardEvent } from '../../core/eventing.js';
 
 import style from './dialog-content.scss?lit&inline';
 
@@ -18,7 +18,7 @@ class SbbDialogContentElement extends LitElement {
 
   protected override render(): TemplateResult {
     return html`
-      <div class="sbb-dialog-content" @scroll=${(e: Event) => forwardEventToHost(e, document)}>
+      <div class="sbb-dialog-content" @scroll=${(e: Event) => forwardEvent(e, document)}>
         <slot></slot>
       </div>
     `;

src/elements/file-selector/common/file-selector-common.ts

@@ -9,7 +9,7 @@ import { sbbInputModalityDetector } from '../../core/a11y.js';
 import { SbbLanguageController } from '../../core/controllers.js';
 import { forceType } from '../../core/decorators.js';
 import { isLean } from '../../core/dom.js';
-import { EventEmitter, forwardEventToHost } from '../../core/eventing.js';
+import { EventEmitter, forwardEvent } from '../../core/eventing.js';
 import {
   i18nFileSelectorButtonLabel,
   i18nFileSelectorCurrentlySelected,
@@ -183,7 +183,7 @@ export const SbbFileSelectorCommonElementMixin = <T extends Constructor<LitEleme
       if (fileInput.files) {
         this.createFileList(fileInput.files);
       }
-      forwardEventToHost(event, this);
+      forwardEvent(event, this);
     }
 
     protected createFileList(files: FileList): void {

src/elements/map-container/map-container.ts

@@ -5,7 +5,7 @@ import { customElement, property, state } from 'lit/decorators.js';
 
 import { SbbLanguageController } from '../core/controllers.js';
 import { forceType } from '../core/decorators.js';
-import { forwardEventToHost } from '../core/eventing.js';
+import { forwardEvent } from '../core/eventing.js';
 import { i18nMapContainerButtonLabel } from '../core/i18n.js';
 
 import style from './map-container.scss?lit&inline';
@@ -97,10 +97,7 @@ class SbbMapContainerElement extends LitElement {
         <div class="sbb-map-container__map">
           <slot name="map"></slot>
         </div>
-        <div
-          class="sbb-map-container__sidebar"
-          @scroll=${(e: Event) => forwardEventToHost(e, document)}
-        >
+        <div class="sbb-map-container__sidebar" @scroll=${(e: Event) => forwardEvent(e, document)}>
           <span id="intersector"></span>
 
           <slot></slot>

src/elements/menu/menu/menu.ts

@@ -23,7 +23,7 @@ import {
   isZeroAnimationDuration,
   SbbScrollHandler,
 } from '../../core/dom.js';
-import { forwardEventToHost } from '../../core/eventing.js';
+import { forwardEvent } from '../../core/eventing.js';
 import { SbbNamedSlotListMixin } from '../../core/mixins.js';
 import {
   getElementPosition,
@@ -415,7 +415,7 @@ class SbbMenuElement extends SbbNamedSlotListMixin<
         >
           <div
             @click=${(event: Event) => this._closeOnInteractiveElementClick(event)}
-            @scroll=${(e: Event) => forwardEventToHost(e, document)}
+            @scroll=${(e: Event) => forwardEvent(e, document)}
             class="sbb-menu__content"
           >
             ${this.listChildren.length

src/elements/overlay/overlay.ts

@@ -6,7 +6,7 @@ import { html, unsafeStatic } from 'lit/static-html.js';
 import { getFirstFocusableElement, setModalityOnNextFocus } from '../core/a11y.js';
 import { forceType } from '../core/decorators.js';
 import { isZeroAnimationDuration } from '../core/dom.js';
-import { EventEmitter, forwardEventToHost } from '../core/eventing.js';
+import { EventEmitter, forwardEvent } from '../core/eventing.js';
 import { i18nCloseDialog, i18nGoBack } from '../core/i18n.js';
 
 import { overlayRefs, SbbOverlayBaseElement } from './overlay-base-element.js';
@@ -201,10 +201,7 @@ class SbbOverlayElement extends SbbOverlayBaseElement {
             <div class="sbb-overlay__header">
               ${this.backButton ? backButton : nothing} ${closeButton}
             </div>
-            <div
-              class="sbb-overlay__content"
-              @scroll=${(e: Event) => forwardEventToHost(e, document)}
-            >
+            <div class="sbb-overlay__content" @scroll=${(e: Event) => forwardEvent(e, document)}>
               <sbb-container
                 class="sbb-overlay__content-container"
                 ?expanded=${this.expanded}

src/elements/slider/slider.ts

@@ -6,7 +6,7 @@ import { styleMap } from 'lit/directives/style-map.js';
 
 import { SbbConnectedAbortController } from '../core/controllers.js';
 import { forceType, hostAttributes } from '../core/decorators.js';
-import { EventEmitter, forwardEventToHost } from '../core/eventing.js';
+import { EventEmitter, forwardEvent } from '../core/eventing.js';
 import {
   type FormRestoreReason,
   type FormRestoreState,
@@ -252,7 +252,7 @@ class SbbSliderElement extends SbbDisabledMixin(SbbFormAssociatedMixin(LitElemen
 
   /** Emits the change event. */
   private _emitChange(event: Event): void {
-    forwardEventToHost(event, this);
+    forwardEvent(event, this);
     this._didChange.emit();
   }
 

src/elements/time-input/time-input.ts

@@ -5,7 +5,7 @@ import { ref } from 'lit/directives/ref.js';
 
 import { SbbLanguageController } from '../core/controllers.js';
 import { findInput } from '../core/dom.js';
-import { EventEmitter, forwardEventToHost } from '../core/eventing.js';
+import { EventEmitter, forwardEvent } from '../core/eventing.js';
 import { i18nTimeInputChange } from '../core/i18n.js';
 import type { SbbDateLike, SbbValidationChangeEvent } from '../core/interfaces.js';
 
@@ -132,11 +132,9 @@ class SbbTimeInputElement extends LitElement {
       this._inputElement.placeholder = 'HH:MM';
     }
 
-    this._inputElement.addEventListener(
-      'input',
-      (event: Event) => forwardEventToHost(event, this),
-      { signal: this._abortController.signal },
-    );
+    this._inputElement.addEventListener('input', (event: Event) => forwardEvent(event, this), {
+      signal: this._abortController.signal,
+    });
     this._inputElement.addEventListener(
       'keydown',
       (event: KeyboardEvent) => this._preventCharInsert(event),
@@ -196,7 +194,7 @@ class SbbTimeInputElement extends LitElement {
 
   /** Emits the change event. */
   private _emitChange(event: Event): void {
-    forwardEventToHost(event, this);
+    forwardEvent(event, this);
     this._didChange.emit();
   }