Scaladoc: Integrate Scastie into Scaladoc

[pikinier20]

also fixes #13275

Release notes template

Integrated Scastie into Scaladoc to make snippets interactive.

[pikinier20]

closes #13065

[KacperFKorban]

Looks good to me. Two nitpicks/questions:

1. Should the resources (like font-awesome) be downloaded (like inkuire.js) or added to the repo as static files?
2. Does scastie API allow to change the initial cursor position? IMHO it would be better for it to be at the end.

[deusaquilus]

Hey @pikinier20. I'm really curious about how this scastieConfiguration.js works. I'd love to put protoquill examples into Scala3doc but nearly all of them will need a bunch of pre-created code to work. Can scastieConfiguration.js specify sbt dependencies for Scastie to load?

[pikinier20]

Hey @pikinier20. I'm really curious about how this scastieConfiguration.js works. I'd love to put protoquill examples into Scala3doc but nearly all of them will need a bunch of pre-created code to work. Can scastieConfiguration.js specify sbt dependencies for Scastie to load?

Hey, yes, there's a setting in Scaladoc:

val scastieConfiguration: Setting[String] =
    StringSetting("-scastie-configuration", "Scastie configuration", "Additional configuration passed to Scastie in code snippets", "")

You can there specify libraryDependencies setting. It will probably be done better in future (automatically get this configuration from sbt) but for now it works like that.

From what I remember, it may be tricky to properly escape quotes.