Support Node.js and Native

[armanbilge]

Serializing this Discord discussion. Linking to scala-native/scala-native#2529.

I initially asked if it would be possible to support running Scala.js in Node.js for a (static) output more similar to JVM (as an alternative to the current mdoc.js which generates JS files for embedding in a webpage and running in the browser).

@olafurpg replies:

If we make it work then it would probably unlock native support as well. Requires the same IPC infrastructure

If you design a main method that reads serialized input from a file or stdin, and prints the evaluated output to a file or stdout, then you’ve drawn most of the owl already

the biggest change that I anticipate is that we'll need a way to serialize the mdoc-runtime Document class

mdoc/runtime/src/main/scala/mdoc/document/Document.scala

Line 8 in 9014e2d

final case class Document(instrumented: InstrumentedInput, sections: List[Section])

we may need to add constraints to the T type parameter on the Binder class
But it's maybe not necessary if we just stick with PPrint

mdoc/runtime/src/main/scala/mdoc/document/Binder.scala

Line 7 in 9014e2d

final class Binder[T](val value: T, val name: String, val tpe: TPrint[T], val pos: RangePosition) {

[Atry]

Also it would be nice if a code snippet could have multiple modifiers. For example, executing the Scala.js in Node.js and printing the output, while allowing the reader to interact with the HTML UI in a browser.

[armanbilge]

For example, executing the Scala.js in Node.js and printing the output, while allowing the reader to interact with the HTML UI in a browser.

@Atry hm, I'm not sure I understand. It's highly unlikely that some Scala.js would be able to run in both Node.js and in browsers. If it involves HTML, it won't work in Node.js (no DOM APIs). If it doesn't involve HTML, then there's nothing to interact with in the browser. /shrug

[Atry]

It's common to use jsdom in Node.js for testing purpose.