Fix doc generation for projects with compile-only dependencies (#3990)

Author: Gedochao

modules/build/src/main/scala/scala/build/Build.scala

@@ -55,12 +55,15 @@ object Build {
     isPartial: Boolean,
     logger: Logger
   ) extends Build {
-    def success: Boolean                  = true
-    def cancelled: Boolean                = false
-    def successfulOpt: Some[this.type]    = Some(this)
-    def outputOpt: Some[os.Path]          = Some(output)
-    def dependencyClassPath: Seq[os.Path] = sources.resourceDirs ++ artifacts.classPath
-    def fullClassPath: Seq[os.Path]       = Seq(output) ++ dependencyClassPath
+    def success: Boolean                         = true
+    def cancelled: Boolean                       = false
+    def successfulOpt: Some[this.type]           = Some(this)
+    def outputOpt: Some[os.Path]                 = Some(output)
+    def dependencyClassPath: Seq[os.Path]        = sources.resourceDirs ++ artifacts.classPath
+    def dependencyCompileClassPath: Seq[os.Path] =
+      sources.resourceDirs ++ artifacts.compileClassPath
+    def fullClassPath: Seq[os.Path]        = Seq(output) ++ dependencyClassPath
+    def fullCompileClassPath: Seq[os.Path] = fullClassPath ++ dependencyCompileClassPath
     private lazy val mainClassesFoundInProject: Seq[String] = MainClass.find(output, logger).sorted
     private lazy val mainClassesFoundOnExtraClasspath: Seq[String] =
       options.classPathOptions.extraClassPath.flatMap(MainClass.find(_, logger)).sorted

modules/cli/src/main/scala/scala/cli/commands/doc/Doc.scala

@@ -2,6 +2,7 @@ package scala.cli.commands.doc
 
 import caseapp.*
 import caseapp.core.help.HelpFormat
+import coursier.Fetch
 import dependency.*
 
 import java.io.File
@@ -147,7 +148,7 @@ object Doc extends ScalaCommand[DocOptions] {
         builds.find(_.scope == Scope.Test).getOrElse(builds.head).project.scaladocDir
       case Some((_, true))        => builds.head.project.scaladocDir
       case Some((scalaParams, _)) =>
-        val res = value {
+        val res: Fetch.Result = value {
           Artifacts.fetchAnyDependencies(
             Seq(Positioned.none(dep"org.scala-lang::scaladoc:${scalaParams.scalaVersion}")),
             value(builds.head.options.finalRepositories),
@@ -162,7 +163,11 @@ object Doc extends ScalaCommand[DocOptions] {
         val ext      = if Properties.isWin then ".exe" else ""
         val baseArgs = Seq(
           "-classpath",
-          builds.flatMap(_.fullClassPath).distinct.map(_.toString).mkString(File.pathSeparator),
+          builds
+            .flatMap(_.fullCompileClassPath)
+            .distinct
+            .map(_.toString)
+            .mkString(File.pathSeparator),
           "-d",
           destDir.toString
         )

modules/integration/src/test/scala/scala/cli/integration/DocTestDefinitions.scala

@@ -80,4 +80,21 @@ abstract class DocTestDefinitions extends ScalaCliSuite with TestScalaVersionArg
         }
       }
     }
+
+  if actualScalaVersion.startsWith("3") then
+    test("doc with compileOnly.dep") {
+      TestInputs(
+        os.rel / "project.scala" ->
+          s"""//> using compileOnly.dep org.springframework.boot:spring-boot:3.5.6
+             |//> using test.dep org.springframework.boot:spring-boot:3.5.6
+             |""".stripMargin,
+        os.rel / "RootLoggerConfigurer.scala" ->
+          s"""import org.springframework.beans.factory.annotation.Autowired
+             |import scala.compiletime.uninitialized
+             |
+             |class RootLoggerConfigurer:
+             |  @Autowired var sentryClient: String = uninitialized
+             |""".stripMargin
+      ).fromRoot(root => os.proc(TestUtil.cli, "doc", ".", extraOptions).call(cwd = root))
+    }
 }

modules/integration/src/test/scala/scala/cli/integration/PublishLocalTestDefinitions.scala

@@ -348,4 +348,40 @@ abstract class PublishLocalTestDefinitions extends ScalaCliSuite with TestScalaV
       expect(r.out.trim() == expectedMessage)
     }
   }
+
+  if actualScalaVersion.startsWith("3") then
+    test("publish local with compileOnly.dep") {
+      TestInputs(
+        os.rel / "project.scala" ->
+          s"""//> using compileOnly.dep org.springframework.boot:spring-boot:3.5.6
+             |//> using test.dep org.springframework.boot:spring-boot:3.5.6
+             |
+             |//> using publish.organization my.org
+             |//> using publish.name scala-cli-publish-bug
+             |//> using publish.version 1.0.0
+             |""".stripMargin,
+        os.rel / "RootLoggerConfigurer.scala" ->
+          s"""import org.springframework.beans.factory.annotation.Autowired
+             |import scala.compiletime.uninitialized
+             |
+             |class RootLoggerConfigurer:
+             |  @Autowired var sentryClient: String = uninitialized
+             |""".stripMargin
+      ).fromRoot { root =>
+        val scalaVersionArgs =
+          if (actualScalaVersion == Constants.scala3Next)
+            Seq("-S", actualScalaVersion)
+          else Nil
+        os.proc(
+          TestUtil.cli,
+          "--power",
+          "publish",
+          "local",
+          ".",
+          scalaVersionArgs,
+          extraOptions
+        )
+          .call(cwd = root)
+      }
+    }
 }