feat: provide easier way of extending/overriding built in animations

[crhistianramirez]

Prerequisites

• I have read the Contributing Guidelines.
• I agree to follow the Code of Conduct.
• I have searched for existing issues that already include this feature request, without success.

Describe the Feature Request

Export the already created animations for modals so that they can be publicly consumed by users of this library

Describe the Use Case

I understand that I can build my own animations which is great but sometimes I just want to tweak an existing animation slightly. Today the only way to do that is to bring the source code in to my project.

Describe Preferred Solution

Ideally, I would like to simply import the already created animations and then call the methods on the Animation object to enhance it for my purposes

Describe Alternatives

Perhaps an option when presenting the modal could pass to you the animation that would be used and allow you to act upon it before doing the final presentation.

Related Code

Here is an example of how I might expect this to work:

import { sheetEnterAnimation } from '@ionic/core';

export const myEnterAnimation = (
  baseEl: HTMLElement,
  opts: ModalAnimationOptions
): Animation => {
  const animation = sheetEnterAnimation(baseEl, opts);

  // here I'm moving the modal so it renders somewhere else but you can imagine any other tweaks
  // that are possible by hooking into the Animation object
  animation.beforeAddWrite(() => {
    const modal = document.querySelector('ion-modal');
    const appTabs = document.querySelector('app-tabs');
    appTabs.appendChild(modal);
  });

  return animation;
};

Additional Information

No response

[3zzy]

This is absolutely needed, would potentially also resolve my issue about page transitions if I could simply reuse the existing animation.

[sean-perkins]

Combining with #25243, when providing an easier way of extending/overriding and accessing the built-in animations, we should consider exporting the base animations from the library, so that developers can use them directly.