Run & review this pull request in StackBlitz Codeflow.

This needs a bit of refactoring:

• we don't expose useStyles anymore
• inline asset strategy is not supported
• the composable names convention is to be prefixed with useScript which is already updated upstream

We need quite a bit of documentation and I don't think the Nuxt core repo is the place for it, so I'm making a dedicated docs site. I intend to pick any usable content from this draft into that.

So not sure what you want to do with this PR

For now, I think we need authoritative source of docs in standalone nuxt/scripts docs website. Ultimately we might reconsider merging them back into nuxt.com when API surface is stable and docs changes are few or nuxt/scripts is automatically installed as a dependency of Nuxt.

But until then, we should document key utilities like useScript and any other composables that will trigger auto-install of nuxt/scripts with minimal docs pointing to the separate scripts docs website (like we do with nuxt/image).

Feel free to directly push to this branch 🙏

What shall we do about this PR?

Thank you for the reminder!

I would love to see these documented on nuxt.com, with links to the latest info on https://scripts.nuxt.com, much as we do for nuxt/image.

If someone has the time to sync the PR with the latest state on scripts.nuxt.com, that would be perfect 🙏

cc @Mini-ghost is this something you feel you can tackle?

Sounds good to me.

I'll flag that there will be likely many breaking changes for v1 and the documentation will become more complex. For example the Google Maps integration will feature a lot more components so these may get split on to other doc pages.

If we want a quick & easy solution, I'd just copy + paste from https://github.com/nuxt/scripts/blob/main/docs/content/docs/3.api/1.use-script.md with a canonical URL back to scripts.nuxt.com. I'd leave out specific third-parties for now while I work on getting them more stable.

It’s my honor! I will do my best to understand the implementation of nuxt scripts and try to complete this part. 💪