feat: function-based router

[innocenzi]

This pull request adds support for passing a function as the value of the router option. When specified, this function will be passed as the navigate prop of BaseLink.

This enables the ability for any front-end framework to provide their own routing logic in a better way than intercepting all <a> clicks on the DOM.

For instance, to add Hybridly support, the following options can be passed to the Vite plugin:

import { router } from 'hybridly'

//...

vue.use(ui, {
	router: (event: MouseEvent, { href, external }: { href: string; external: boolean }) => {
		const target = event.currentTarget as HTMLElement
		const method = target.dataset.method as Method || 'GET'

		if (external) {
			return
		}

		event.preventDefault()

		router.navigate({
			url: href,
			method,
			preserveState: method !== 'GET',
		})
	},
})

Theoretically, the Inertia implementation could be migrated to use this pattern too instead of swapping components entirely.

[pkg-pr-new]

npm i https://pkg.pr.new/@nuxt/ui@5860

commit: bd74317