fix: Fixes description indenting

[ctasada]

When the description field includes a long description it may not be properly rendered, mainly in Kotlin, where the way of managing the text-blocks is different.

This PR improves the way descriptions are managed by:

• Removes empty lines at the beginning of the text-block
• Removes indention due to alignment, but keeps indention in the lines that need it

[netlify]

✅ Deploy Preview for springwolf-ui canceled.

Name	Link
🔨 Latest commit	c755ff1
🔍 Latest deploy log	https://app.netlify.com/sites/springwolf-ui/deploys/661d5fefbb97d60008d5610e

[ctasada]

I think this issue may be exclusive from Kotlin, when using text-blocks. The change should be transparent (or nearly transparent) for Java code, but we can wrap it in a special setting if needed.

[timonback]

I am assuming you use multi–line strings aka text blocks.
If it is kotlin specific, would it be sufficient for the users to call trimIndent themselves?

https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/trim-indent.html

(I haven't looked through the code. This sounds like a method that should be part of a standard lib)

[ctasada]

Sadly it's not possible. Annotations must be compile-time constants, so it's not possible to do any manipulation, like .trimIndent()

[timonback]

Argh. Unfortunate that https://youtrack.jetbrains.com/issue/KT-22505/Support-calls-to-trimMargin-trimIndent-as-initializer-for-const-vals is not getting resolved.
And there seems to be no easy Apache Commons or similar implementation.

Will review the PR on Friday

[sam0r040]

Kind of unfortunate that there is no nice solution and we have to provide the Utils for it. I think I found some simplifications, but not as much as I wished :(. However, I would add two more test cases: String with no empty lines and null input.

[ctasada]

@sam0r040 All the comments addressed. I also added more tests covering the different corner cases. Coverage is now 100%