feat(bridge): add useNuxtApp and defineNuxtPlugin composables

[danielroe]

🔗 Linked issue

nuxt/bridge#105

❓ Type of change

• New feature (a non-breaking change that adds functionality)

📚 Description

This adds a shim for useNuxtApp intended to be compatible in API:

framework/packages/nuxt3/src/app/nuxt.ts

Lines 67 to 79 in a9c4bfa

	export function createNuxt (options: CreateOptions) {
	const nuxt: NuxtApp = {
	provide: undefined,
	globalName: 'nuxt',
	state: {},
	payload: {},
	isHydrating: process.client,
	...options
	} as any as NuxtApp
	nuxt.hooks = createHooks<RuntimeNuxtHooks>()
	nuxt.hook = nuxt.hooks.hook
	nuxt.callHook = nuxt.hooks.callHook

.

I have noted a question below about nuxt.state as this is currently unused in nuxt3.

I can follow-up with a second PR to add defineNuxtPlugin which will work quite closely with this composable, or can implement it here too.

Finally, perhaps we can update docs after nuxt/bridge#102 is complete. (Or I can document this individually if preferred.)

📝 Checklist

• I have linked an issue or discussion.
• I have updated the documentation accordingly.

[cloudflare-workers-and-pages]

Deploying with    Cloudflare Pages

Latest commit:	a599b84
Status:	✅  Deploy successful!
Preview URL:	https://4e50da91.framework-1rm.pages.dev

View logs

[pi0]

Check nuxt 3 implementation: https://github.com/nuxt/framework/blob/main/packages/nuxt3/src/app/nuxt.ts#L181

We should be able to use nuxt app instance outside of vue lifecycle in the client-side (replacing global $nuxt usage) and during the execution of nuxt plugins (making composables for plugins)

[danielroe]

on its way!

[pi0]

This is inconsistent with n3 and finally app instances are not the same. Maybe keeping ctx.app and this (created app) as different vue2 only names in the nuxt?

[pi0]

PS: We would need to expose NuxtAppCompat interface ;)

[danielroe]

Good point. So something like:

{
  legacyApp, // => ctx.app (app options)
  legacyThis, // => this
}

[pi0]

I would call first legacyNuxt (it is nuxt interface right?) and legacyApp (vue2 app instance?)