docs: add nuxtApp.runWithContext

[fimion]

🔗 Linked issue

#14723

❓ Type of change

• 📖 Documentation (updates to the documentation, readme or JSdoc annotations)
• 🐞 Bug fix (a non-breaking change that fixes an issue)
• 👌 Enhancement (improving an existing functionality like performance)
• ✨ New feature (a non-breaking change that adds functionality)
• 🧹 Chore (updates to the build process or auxiliary tools and libraries)
• ⚠️ Breaking change (fix or feature that would cause existing functionality to change)

📚 Description

@danielroe suggested I take a crack at this as there was not any public documentation about callWithNuxt.

I've added a header stating that this method should be used sparingly, and that ultimately this is something that would ideally be solved at the framework level.

I've also included the detailed explanation with edits that make more sense for documentation.

Let me know if there is any further details I should add, or if the format needs to change at all.

📝 Checklist

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

[stackblitz]

Run & review this pull request in StackBlitz Codeflow.

[nuxt-studio]

✅ Live Preview ready!

Name	Edit	Preview	Latest Commit
Nuxt Docs	Edit on Studio ↗︎	View Live Preview	ede2e7a

[danielroe]

This is absolutely beautiful work.

The only thing I'd suggest is that we document nuxtApp.runWithContext(() => fn()) instead, as it's a bit more intuitive how it works, and I think largely replaces callWithNuxt.

Very little would need to change for us to do this, just the function signature...

[fimion]

Alright, I've moved it into the useNuxtApp docs and reworked the signature.

Are y'all using details/summary to collapse extra info? or would the detailed context documentation be better in a separate file under Advanced?

[danielroe]

I think this is great, and as it's in the API section I think we can include all of this there. It's possible we could add something less/abbreviated in future in Concepts, maybe within https://nuxt.com/docs/guide/concepts/vuejs-development, or possibly a bit longer in a Composables section in Get Started.