Add RichTextBlock support to Block Kit Kotlin DSL builder

[KENNYSOFT]

This PR adds RichTextBlock support to Block Kit Kotlin DSL builder. With this changes, we can now use DSL like:

withBlocks {
    richText {
        richTextSection {
            text("Check out these different block types with paragraph breaks between them:\n\n")
        }
        richTextPreformatted {
            text("Hello there, I am preformatted block!\n\nI can have multiple paragraph breaks within the block.")
        }
        richTextSection {
            text("\nI am rich text with a paragraph break following preformatted text. \n\nI can have multiple paragraph breaks within the block.\n\n")
        }
        richTextQuote {
            text("I am a basic rich text quote, \n\nI can have multiple paragraph breaks within the block.")
        }
        richTextSection {
            text("\nI am rich text with a paragraph after the quote block\n\n")
        }
        richTextQuote {
            text("I am a basic quote block following rich text")
        }
        richTextSection {
            text("\n")
        }
        richTextPreformatted {
            text("I am more preformatted text following a quote block")
        }
        richTextSection {
            text("\n")
        }
        richTextQuote {
            text("I am a basic quote block following preformatted text")
        }
        richTextSection {
            text("\n")
        }
        richTextList {
            style(ListStyle.BULLET)
            richTextSection {
                text("list item one")
            }
            richTextSection {
                text("list item two")
            }
        }
        richTextSection {
            text("\nI am rich text with a paragraph break after a list")
        }
    }
}

Category (place an x in each of the [ ])

• bolt (Bolt for Java)
• bolt-{sub modules} (Bolt for Java - optional modules)
• slack-api-client (Slack API Clients)
• slack-api-model (Slack API Data Models)
• slack-api-*-kotlin-extension (Kotlin Extensions for Slack API Clients)
• slack-app-backend (The primitive layer of Bolt for Java)

Requirements

Please read the Contributing guidelines and Code of Conduct before creating this issue or pull request. By submitting, you agree to those rules.

[salesforce-cla]

Thanks for the contribution! Before we can merge this, we need @KENNYSOFT to sign the Salesforce Inc. Contributor License Agreement.

[seratch]

Great work! Overall, your changes look great to me but could you take a bit more time to adjust the following?

• A few more adjustments to your changes; see my review comments
• Run ./scripts/run_no_prep_tests.sh to generate corresponding JSON files
• Sign our CLA; without it, we are unable to accept any external contribution

Thank you!

[seratch]

emoji method should accept two patterns:

• name: String, skinTone: Int? = null, style: TextStyle? = null
• unicode: String

overloading with string type may not work; if that's the case, skipping unicode here is okay

[KENNYSOFT]

https://api.slack.com/reference/block-kit/blocks#emoji-element-type

I've implemented based on the documents, but yes I've seen that RichTextSectionElement.Emoji has those fields and will take a look for them.

[KENNYSOFT]

Resolved in 1be897c

By the way, Kotlin allows for overloading but I think it can be confusing. With this interface:

fun emoji(name: String, skinTone: Int? = null, style: LimitedTextStyle? = null)
fun emoji(unicode: String)

The call emoji("aaa") is directed to the second one, and to use the first method then we should use a named parameter like emoji(name = "aaa").

So I've skipped the Unicode version for now, but also suggesting a different DSL like emojiUnicode("U+AC00") with little confidence.

[KENNYSOFT]

Thanks!

[seratch]

As a workaround, I closed and reopend this PR to let the CLA bot check it again. It seems your status is now correctly updated!

[seratch]

Looks good to me! Once the CI builds pass, I will merge this PR. Thank you so much for the contribution!

[seratch]

Oops, let me correct myself about the merge timing, we'll release this patch release before it: https://github.com/slackapi/java-slack-sdk/milestone/108 After that, this enhancement will be included in an upcoming minor release.

[codecov]

Codecov Report

All modified and coverable lines are covered by tests ✅

Project coverage is 74.49%. Comparing base (e5565e7) to head (8aa01ca).
Report is 1 commits behind head on main.

Additional details and impacted files

@@             Coverage Diff              @@
##               main    #1376      +/-   ##
============================================
+ Coverage     74.24%   74.49%   +0.24%     
- Complexity     4273     4324      +51     
============================================
  Files           461      472      +11     
  Lines         13364    13491     +127     
  Branches       1377     1377              
============================================
+ Hits           9922    10050     +128     
+ Misses         2629     2628       -1     
  Partials        813      813              

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.