[lsp] fix formatting of indented java doc

GitOrigin-RevId: 9a3df4002cb30f1c5ae2b5248bd842c900a3d0b6

Author: darthorimar

features-impl/common/src/com/jetbrains/ls/api/features/impl/common/documentaiton/documentationUtils.kt

@@ -0,0 +1,12 @@
+// Copyright 2000-2025 JetBrains s.r.o. and contributors. Use of this source code is governed by the Apache 2.0 license.
+package com.jetbrains.ls.api.features.impl.common.documentaiton
+
+/**
+ * Formats a given documentation comment string by cleaning up any extra spaces
+ * and ensuring proper alignment for each line. Java/Kotlin-style comments are
+ * expected.
+ */
+fun formatDocComment(docComment: String): String {
+    val trimmedLines = docComment.trim().lines().map { it.trim() }.filter { it.isNotEmpty() }
+    return trimmedLines.joinToString(separator = "\n") { if (it.startsWith("/*")) it else " $it" }
+}

features-impl/kotlin/src/com/jetbrains/ls/api/features/impl/common/kotlin/hover/LSMarkdownDocProviderKotlinImpl.kt

@@ -2,6 +2,7 @@
 package com.jetbrains.ls.api.features.impl.common.kotlin.hover
 
 import com.intellij.psi.PsiElement
+import com.jetbrains.ls.api.features.impl.common.documentaiton.formatDocComment
 import com.jetbrains.ls.api.features.impl.common.hover.AbstractLSHoverProvider
 import com.jetbrains.ls.api.features.impl.common.hover.markdownMultilineCode
 import com.jetbrains.ls.api.features.impl.common.kotlin.language.LSKotlinLanguage
@@ -13,13 +14,8 @@ internal class LSMarkdownDocProviderKotlinImpl : AbstractLSHoverProvider.LSMarkd
         val ktElement = element.unwrapped as? KtDeclaration ?: return null
         val kdDocText = ktElement.docComment?.text ?: return null
         return markdownMultilineCode(
-            kdDocText.formatKdoc(),
+            formatDocComment(kdDocText),
             language = LSKotlinLanguage.lspName
         )
     }
-
-    private fun String.formatKdoc(): String {
-        val trimmedLines = trim().lines().map { it.trim() }.filter { it.isNotEmpty() }
-        return trimmedLines.joinToString(separator = "\n") { if (it.startsWith("/*")) it else " $it" }
-    }
 }