feat: add href handler for ButtonLink component

Fixes #58

This PR adds the option to specify a link handler in order to make use of client side navigation. This is fully backward compatible, without introducing any new parameters which have to be passed around.

This is achieved by extending the type of href in the ButtonLink component to also accept a tuple of a URL and a handler. When this tuple is defined, the default click event will be prevented and the handler will be called with the URL.

In it's simplest form, this allows to easily use React's navigation feature like this:

const Login = () : JSX.Element => {
    const navigate = useNavigate();

    // …

    return (
        <UserAuthCard
          flow={flow}
          flowType="login"
          additionalProps={{ logoutURL: ["/logout", navigate] }}
        />,
    );
};

Checklist

[x] I have read the contributing guidelines and signed the CLA.
[x] I have referenced an issue containing the design document if my change introduces a new feature.
[x] I have read the security policy.
[x] I confirm that this pull request does not address a security vulnerability. If this pull request addresses a security vulnerability, I confirm that I got green light (please contact security@ory.sh) from the maintainers to push the changes.
[x] I have added tests that prove my fix is effective or that my feature works.
[ ] I have added necessary documentation within the code base (if appropriate).

ory / elements

feat: add href handler for ButtonLink component #103

Checklist