fix(overlays): assign incremental id to overlay host (#27278)

Issue number: Internal

---------

<!-- Please refer to our contributing documentation for any questions on
submitting a pull request, or let us know here if you need any help:
https://ionicframework.com/docs/building/contributing -->

<!-- Some docs updates need to be made in the `ionic-docs` repo, in a
separate PR. See
https://github.com/ionic-team/ionic-framework/blob/main/.github/CONTRIBUTING.md#modifying-documentation
for details. -->

<!-- Please do not submit updates to dependencies unless it fixes an
issue. -->

<!-- Please try to limit your pull request to one type (bugfix, feature,
etc). Submit multiple pull requests if needed. -->

## What is the current behavior?
<!-- Please describe the current behavior that you are modifying. -->

The counter for incrementing the `id` and `z-index` of an overlay is
incremented whenever the `connectedCallback` is fired for an overlay.

When an overlay is presented and/or conditionally rendered, the overlay
`id` can increment by `n+2` instead of `n+1`.

## What is the new behavior?
<!-- Please describe the behavior or changes that are being added by
this PR. -->

- Increments all overlay ids consistently
- Removes legacy `ion-modal-{id}` and `ion-popover-{id}` logic
- Adds unit tests for the id behavior
- Tests are split up into separate files so that the counter is always
starting from `0`
- Adds an integration test with the Angular test app to verify
conditional rendering behavior

## Does this introduce a breaking change?

- [ ] Yes
- [x] No

<!-- If this introduces a breaking change, please describe the impact
and migration path for existing applications below. -->


## Other information

<!-- Any other information that is important to this PR such as
screenshots of how the component looks before and after the change. -->

core/src/components/toast/test/toast-id.spec.ts

@@ -0,0 +1,41 @@
+import { newSpecPage } from '@stencil/core/testing';
+
+import { Toast } from '../toast';
+
+it('toast should be assigned an incrementing id', async () => {
+  const page = await newSpecPage({
+    components: [Toast],
+    html: `<ion-toast is-open="true"></ion-toast>`,
+  });
+  let toast: HTMLIonToastElement;
+
+  toast = page.body.querySelector('ion-toast')!;
+
+  expect(toast).not.toBe(null);
+  expect(toast.getAttribute('id')).toBe('ion-overlay-1');
+
+  // Remove the toast from the DOM
+  toast.remove();
+  await page.waitForChanges();
+
+  // Create a new toast to verify the id is incremented
+  toast = document.createElement('ion-toast');
+  toast.isOpen = true;
+  page.body.appendChild(toast);
+  await page.waitForChanges();
+
+  toast = page.body.querySelector('ion-toast')!;
+
+  expect(toast.getAttribute('id')).toBe('ion-overlay-2');
+
+  // Presenting the same toast again should reuse the existing id
+
+  toast.isOpen = false;
+  await page.waitForChanges();
+  toast.isOpen = true;
+  await page.waitForChanges();
+
+  toast = page.body.querySelector('ion-toast')!;
+
+  expect(toast.getAttribute('id')).toBe('ion-overlay-2');
+});

core/src/components/toast/toast.tsx

@@ -15,6 +15,7 @@ import {
   prepareOverlay,
   present,
   safeCall,
+  setOverlayId,
 } from '../../utils/overlays';
 import type { OverlayEventDetail } from '../../utils/overlays-interface';
 import type { IonicSafeString } from '../../utils/sanitization';
@@ -248,6 +249,10 @@ export class Toast implements ComponentInterface, OverlayInterface {
     this.triggerController.removeClickListener();
   }
 
+  componentWillLoad() {
+    setOverlayId(this.el);
+  }
+
   /**
    * Present the toast overlay after it has been created.
    */