fix: docs generation

Author: kc-vl

MODULE.bazel

@@ -24,6 +24,7 @@ bazel_dep(name = "rules_jvm_external", version = "6.7")
 maven = use_extension("@rules_jvm_external//:extensions.bzl", "maven")
 maven.install(
     artifacts = [
+        "javax.annotation:javax.annotation-api:1.2",
         "com.google.protobuf:protobuf-java:4.29.3",
         "ch.epfl.scala:bsp4j:2.2.0-M2",
         "com.fasterxml.jackson.core:jackson-databind:2.18.2",

maven_install.json

@@ -1,7 +1,7 @@
 {
   "__AUTOGENERATED_FILE_DO_NOT_MODIFY_THIS_FILE_MANUALLY": "THERE_IS_NO_DATA_ONLY_ZUUL",
-  "__INPUT_ARTIFACTS_HASH": 1267820339,
-  "__RESOLVED_ARTIFACTS_HASH": 1984398607,
+  "__INPUT_ARTIFACTS_HASH": 828238765,
+  "__RESOLVED_ARTIFACTS_HASH": -33843454,
   "conflict_resolution": {
     "com.google.api.grpc:proto-google-common-protos:2.29.0": "com.google.api.grpc:proto-google-common-protos:2.48.0",
     "com.google.code.gson:gson:2.11.0": "com.google.code.gson:gson:2.12.1",
@@ -474,6 +474,12 @@
       },
       "version": "0.27.0"
     },
+    "javax.annotation:javax.annotation-api": {
+      "shasums": {
+        "jar": "5909b396ca3a2be10d0eea32c74ef78d816e1b4ead21de1d78de1f890d033e04"
+      },
+      "version": "1.2"
+    },
     "junit:junit": {
       "shasums": {
         "jar": "8e495b634469d64fb8acfa3495a065cbacc8a0fff55ce1e31007be4c16dc57d3"
@@ -1901,6 +1907,11 @@
     "io.perfmark:perfmark-api": [
       "io.perfmark"
     ],
+    "javax.annotation:javax.annotation-api": [
+      "javax.annotation",
+      "javax.annotation.security",
+      "javax.annotation.sql"
+    ],
     "junit:junit": [
       "junit.extensions",
       "junit.framework",
@@ -2734,6 +2745,7 @@
       "io.opentelemetry:opentelemetry-sdk-metrics",
       "io.opentelemetry:opentelemetry-sdk-trace",
       "io.perfmark:perfmark-api",
+      "javax.annotation:javax.annotation-api",
       "junit:junit",
       "net.java.dev.jna:jna",
       "org.apache.commons:commons-lang3",
@@ -2868,6 +2880,7 @@
       "io.opentelemetry:opentelemetry-sdk-metrics",
       "io.opentelemetry:opentelemetry-sdk-trace",
       "io.perfmark:perfmark-api",
+      "javax.annotation:javax.annotation-api",
       "junit:junit",
       "net.java.dev.jna:jna",
       "org.apache.commons:commons-lang3",
@@ -3002,6 +3015,7 @@
       "io.opentelemetry:opentelemetry-sdk-metrics",
       "io.opentelemetry:opentelemetry-sdk-trace",
       "io.perfmark:perfmark-api",
+      "javax.annotation:javax.annotation-api",
       "junit:junit",
       "net.java.dev.jna:jna",
       "org.apache.commons:commons-lang3",
@@ -3136,6 +3150,7 @@
       "io.opentelemetry:opentelemetry-sdk-metrics",
       "io.opentelemetry:opentelemetry-sdk-trace",
       "io.perfmark:perfmark-api",
+      "javax.annotation:javax.annotation-api",
       "junit:junit",
       "net.java.dev.jna:jna",
       "org.apache.commons:commons-lang3",

rules/publishing/publish_sonatype.bzl

@@ -9,7 +9,8 @@ def publish_sonatype(
         coord = None,
         jar = None,
         source = None,
-        pom = None):
+        pom = None,
+        doc = None):
     """Macro for generating a Sonatype's release bundle and running publish action with a
     new Sonatype release API: https://central.sonatype.org/publish/publish-portal-api/#uploading-a-deployment-bundle
 
@@ -42,15 +43,15 @@ def publish_sonatype(
             name = "{}_{}".format(name, suffix),
             artifact = artifact,
         )
-        for artifact, suffix in [(pom, "pom"), (jar, "jar"), (source, "source")]
+        for artifact, suffix in [(pom, "pom"), (jar, "jar"), (source, "source"), (doc, "doc")]
     ]
 
     [
         _sign(
             name = "{}_{}".format(name, suffix),
             artifact = artifact,
         )
-        for artifact, suffix in [(pom, "pom"), (jar, "jar"), (source, "source")]
+        for artifact, suffix in [(pom, "pom"), (jar, "jar"), (source, "source"), (doc, "doc")]
     ]
 
     pkg_files(
@@ -69,6 +70,12 @@ def publish_sonatype(
             "{}_jar_sha256".format(name),
             "{}_jar_sha512".format(name),
             "{}_jar_asc".format(name),
+            doc,
+            "{}_doc_md5".format(name),
+            "{}_doc_sha1".format(name),
+            "{}_doc_sha256".format(name),
+            "{}_doc_sha512".format(name),
+            "{}_doc_asc".format(name),
             source,
             "{}_source_md5".format(name),
             "{}_source_sha1".format(name),
@@ -89,6 +96,12 @@ def publish_sonatype(
             "{}_jar_sha1".format(name): "{}-{}.jar.sha1".format(coordinates.artifact, coordinates.version),
             "{}_jar_sha256".format(name): "{}-{}.jar.sha256".format(coordinates.artifact, coordinates.version),
             "{}_jar_sha512".format(name): "{}-{}.jar.sha512".format(coordinates.artifact, coordinates.version),
+            doc: "{}-{}.doc".format(coordinates.artifact, coordinates.version),
+            "{}_doc_asc".format(name): "{}-{}.doc.asc".format(coordinates.artifact, coordinates.version),
+            "{}_doc_md5".format(name): "{}-{}.doc.md5".format(coordinates.artifact, coordinates.version),
+            "{}_doc_sha1".format(name): "{}-{}.doc.sha1".format(coordinates.artifact, coordinates.version),
+            "{}_doc_sha256".format(name): "{}-{}.doc.sha256".format(coordinates.artifact, coordinates.version),
+            "{}_doc_sha512".format(name): "{}-{}.doc.sha512".format(coordinates.artifact, coordinates.version),
             source: "{}-{}-sources.jar".format(coordinates.artifact, coordinates.version),
             "{}_source_asc".format(name): "{}-{}-sources.jar.asc".format(coordinates.artifact, coordinates.version),
             "{}_source_md5".format(name): "{}-{}-sources.jar.md5".format(coordinates.artifact, coordinates.version),

server/install/BUILD

@@ -1,3 +1,4 @@
+load("@rules_jvm_external//:defs.bzl", "javadoc")
 load("@rules_jvm_external//:kt_defs.bzl", "kt_jvm_export")
 load("@rules_kotlin//kotlin:jvm.bzl", "kt_jvm_binary", "kt_jvm_library")
 load("//:versions.bzl", "BAZEL_BSP_ARTIFACT_VERSION")
@@ -32,13 +33,14 @@ kt_jvm_export(
     pom_template = "//server/server/src/main/resources:pom.xml",
     tags = [
         "manual",
-        "no-javadocs",
     ],
     visibility = ["//visibility:public"],
     runtime_deps = [
         "//server/commons",
         "//server/install:install-lib",
         "//server/server/src/main/kotlin/org/jetbrains/bsp/bazel/server",
+        # Needed for javadoc generation:
+        "@maven//:javax_annotation_javax_annotation_api",
         # Needed for protobuf runtime version consitency, otherwise NoClassDefFoundError is raised
         "@maven//:original_com_google_protobuf_protobuf_java_4_29_3",
         # Needed because the installer injects its own classpath as the one to be used by the installed server
@@ -50,6 +52,7 @@ kt_jvm_export(
 publish_sonatype(
     name = "publish",
     coord = "com.virtuslab:bazel-bsp:{}".format(BAZEL_BSP_ARTIFACT_VERSION),
+    doc = ":install_export-docs",
     jar = ":install_export-maven-artifact",
     pom = ":install_export-pom",
     source = ":install_export-maven-source",