Remap ESModule imports at link time in mdoc

.scalafmt.conf

@@ -1,4 +1,4 @@
-version = "3.8.2"
+version = "3.8.3"
 runner.dialect = scala213
 maxColumn = 100
 project.git = true

build.sbt

@@ -14,6 +14,11 @@ def isScala212(v: Option[(Long, Long)]): Boolean = v.exists(_._1 == 2) && v.exis
 def isScala213(v: Option[(Long, Long)]): Boolean = v.exists(_._1 == 2) && v.exists(_._2 == 13)
 def isScala3(v: Option[(Long, Long)]): Boolean = v.exists(_._1 == 3)
 
+def jsoniter = List(
+  "com.github.plokhotnyuk.jsoniter-scala" %% "jsoniter-scala-core" % "2.13.5.2",
+  "com.github.plokhotnyuk.jsoniter-scala" %% "jsoniter-scala-macros" % "2.13.5.2"
+)
+
 val isScala212 = Def.setting {
   VersionNumber(scalaVersion.value).matchesSemVer(SemanticSelector("2.12.x"))
 }
@@ -114,9 +119,9 @@ lazy val sharedJavaSettings = List(
 )
 
 val V = new {
-  val scalameta = "4.9.7"
+  val scalameta = "4.9.9"
 
-  val munit = "1.0.0"
+  val munit = "1.0.1"
 
   val coursier = "1.0.19"
 
@@ -128,7 +133,7 @@ val V = new {
 
   val fs2 = "3.10.2"
 
-  val metaconfig = "0.12.0"
+  val metaconfig = "0.13.0"
 }
 
 lazy val interfaces = project
@@ -194,7 +199,7 @@ lazy val cli = project
       "io.get-coursier" % "interface" % V.coursier,
       "com.vladsch.flexmark" % "flexmark-all" % "0.64.8",
       "com.lihaoyi" %% "pprint" % V.pprint,
-      "com.geirsson" %% "metaconfig-typesafe-config" % V.metaconfig
+      "org.scalameta" %% "metaconfig-typesafe-config" % V.metaconfig
     ),
     libraryDependencies ++= crossSetting(
       scalaVersion.value,
@@ -240,14 +245,15 @@ lazy val mdoc = project
           .excludeAll(excludePprint)
       )
     ),
+    libraryDependencies ++= jsoniter,
     libraryDependencies ++= List(
       "com.googlecode.java-diff-utils" % "diffutils" % "1.3.0",
       "io.methvin" % "directory-watcher" % "0.18.0",
       // live reload
       "io.undertow" % "undertow-core" % "2.2.24.Final",
       "org.jboss.xnio" % "xnio-nio" % "3.8.16.Final",
-      "org.slf4j" % "slf4j-api" % "2.0.13",
-      "com.geirsson" %% "metaconfig-typesafe-config" % V.metaconfig,
+      "org.slf4j" % "slf4j-api" % "2.0.16",
+      "org.scalameta" %% "metaconfig-typesafe-config" % V.metaconfig,
       "com.lihaoyi" %% "fansi" % V.fansi,
       "com.lihaoyi" %% "pprint" % V.pprint
     )
@@ -304,6 +310,20 @@ val jsdocs = project
   )
   .enablePlugins(ScalaJSPlugin, ScalaJSBundlerPlugin)
 
+val jswebsitedocs = project
+  .in(file("tests/websiteJs"))
+  .settings(
+    sharedSettings,
+    publish / skip := true,
+    scalaJSLinkerConfig ~= {
+      _.withModuleKind(ModuleKind.ESModule)
+    },
+    libraryDependencies ++= List(
+      "org.scala-js" %%% "scalajs-dom" % scalajsDom
+    )
+  )
+  .enablePlugins(ScalaJSPlugin)
+
 lazy val worksheets = project
   .in(file("tests/worksheets"))
   .settings(
@@ -432,7 +452,10 @@ lazy val jsWorker =
     .settings(
       sharedSettings,
       moduleName := "mdoc-js-worker",
-      libraryDependencies += ("org.scala-js" %% "scalajs-linker" % scalaJSVersion % Provided) cross CrossVersion.for3Use2_13
+      libraryDependencies ++= Seq(
+        "org.scala-js" %% "scalajs-linker" % scalaJSVersion % Provided cross CrossVersion.for3Use2_13,
+        "com.armanbilge" %% "scalajs-importmap" % "0.1.1" cross CrossVersion.for3Use2_13
+      )
     )
 
 lazy val js = project
@@ -441,6 +464,7 @@ lazy val js = project
   .settings(
     sharedSettings,
     moduleName := "mdoc-js",
+    libraryDependencies ++= jsoniter,
     Compile / unmanagedSourceDirectories ++= multiScalaDirectories("js").value
   )
   .dependsOn(mdoc)
@@ -463,8 +487,7 @@ lazy val docs = project
     watchSources += (ThisBuild / baseDirectory).value / "docs",
     Global / cancelable := true,
     MdocPlugin.autoImport.mdoc := (Compile / run).evaluated,
-    mdocJS := Some(jsdocs),
-    mdocJSLibraries := (jsdocs / Compile / fullOptJS / webpack).value,
+    mdocJS := Some(jswebsitedocs),
     MdocPlugin.mdocJSWorkerClasspath := {
       val _ = (jsWorker / Compile / compile).value
 

cli/src/main/scala/mdoc/internal/cli/MdocProperties.scala

@@ -36,8 +36,7 @@ object MdocProperties {
       out = getPath("out")
     )
   }
-  def default(cwd: AbsolutePath): MdocProperties = {
-    val path = "mdoc.properties"
+  def default(cwd: AbsolutePath, path: String): MdocProperties = {
     Option(this.getClass.getClassLoader.getResourceAsStream(path)) match {
       case Some(resource) =>
         val props = new java.util.Properties()

cli/src/main/scala/mdoc/internal/cli/Settings.scala

@@ -9,6 +9,7 @@ import java.nio.file.FileSystems
 import java.nio.file.Files
 import java.nio.file.InvalidPathException
 import java.nio.file.PathMatcher
+import java.nio.file.Path
 import mdoc.OnLoadContext
 import mdoc.PostModifier
 import mdoc.PreModifier
@@ -153,6 +154,14 @@ case class Settings(
     @Hidden()
     @Description("The pretty printer for variables")
     variablePrinter: Variable => String = ReplVariablePrinter,
+    @Description(
+      "The absolute path to a file containing an import map file in this format; https://developer.mozilla.org/en-US/docs/Web/HTML/Element/script/type/importmap"
+    )
+    importMapPath: Option[AbsolutePath] = None,
+    @Description(
+      "Defaults to mdoc.properties. This is the name of the properties file the CLI will read. It is assumed to be a resource on the classpath. Use the --extra-jars flag to customise the directory it is found in"
+    )
+    propertyFileName: String = "mdoc.properties",
     @Hidden()
     @Description("The Coursier logger used to report progress bars when downloading dependencies")
     coursierLogger: coursierapi.Logger = coursierapi.Logger.progressBars()
@@ -261,9 +270,9 @@ object Settings { // extends MetaconfigScalametaImplicits with Decoders with Set
       cwd = cwd
     )
   }
-  def default(cwd: AbsolutePath): Settings = {
+  def default(cwd: AbsolutePath, filename: String): Settings = {
     val base = baseDefault(cwd)
-    val props = MdocProperties.default(cwd)
+    val props = MdocProperties.default(cwd, filename)
     base.withProperties(props)
   }
 
@@ -294,14 +303,20 @@ object Settings { // extends MetaconfigScalametaImplicits with Decoders with Set
     generic.deriveDecoder[Settings](base)
   }
 
-  def fromCliArgs(args: List[String], base: Settings): Configured[Settings] = {
+  def fromCliArgs(args: List[String], workingDirectory: Path): Configured[Settings] = {
     Conf
       .parseCliArgs[Settings](args)
       .andThen(conf => {
+        val base =
+          Settings.default(
+            AbsolutePath(workingDirectory),
+            conf.get[String]("propertyFileName").getOrElse("mdoc.properties")
+          )
         val cwd = conf.get[String]("cwd").map(AbsolutePath(_)(base.cwd)).getOrElse(base.cwd)
-        conf.as[Settings](decoder(base.copy(cwd = cwd)))
+        conf
+          .as[Settings](decoder(base.copy(cwd = cwd)))
+          .map(_.addSite(base.site))
       })
-      .map(_.addSite(base.site))
   }
 
   def write(set: Settings) = ConfEncoder[Settings].write(set)