docs(Toast): add note about Popover API (#6667)

Author: Lukas742

packages/main/src/components/Modals/index.tsx

@@ -226,6 +226,8 @@ function showToastFn(props: ToastPropTypes, container?: Element | DocumentFragme
  *
  * **In order to use these helpers, please make sure to render the `Modals` component somewhere in your application tree.**
  *
+ * __Note:__ The `Toast` component does not currently use the [Popover API](https://developer.mozilla.org/en-US/docs/Web/API/Popover_API), which may cause issues like incorrect positioning or alignment. If that's the case, please mount the `Modals` component after all other components, or define a custom container via the `container` parameter.
+ *
  * @since 0.22.2
  */
 export function Modals() {
@@ -257,4 +259,7 @@ Modals.showPopover = showPopoverFn;
 Modals.showResponsivePopover = showResponsivePopoverFn;
 Modals.showMenu = showMenuFn;
 Modals.showMessageBox = showMessageBoxFn;
+/**
+ * __Note:__ The `Toast` component does not currently use the [Popover API](https://developer.mozilla.org/en-US/docs/Web/API/Popover_API), which may cause issues like incorrect positioning or alignment. If that's the case, please mount the `Modals` component after all other components, or define a custom container via the `container` parameter.
+ */
 Modals.showToast = showToastFn;

packages/main/src/webComponents/Toast/index.tsx

@@ -73,6 +73,7 @@ interface ToastPropTypes extends ToastAttributes, Omit<CommonProps, keyof ToastA
  * - You want users to be able to copy some part of the message text.
  *
  *
+ * __Note:__ The `Toast` component does not currently use the [Popover API](https://developer.mozilla.org/en-US/docs/Web/API/Popover_API), which may cause issues like incorrect positioning or alignment. To avoid these side effects, we recommend mounting the `Toast` outside the parents' DOM hierarchy, either directly or by using `React.createPortal`, until the Popover API is integrated into this component as well.
  *
  * __Note__: This is a UI5 Web Component! [Repository](https://github.com/SAP/ui5-webcomponents) | [Documentation](https://sap.github.io/ui5-webcomponents/)
  */