core/io.github.youndie.telek/MessageTextBuilder

MessageTextBuilder

class MessageTextBuilder

Builds a MessageText.

One builder, in :core, used by both transports. It replaces a TelegramTextBuilder that was duplicated verbatim in :ktg and :telegram — the copy's own comment apologised for itself and asked the next person to keep the two in sync, which is a job nothing checked.

text, bold, br, br2, row and list are the ones the old builder had and behave as they did, so a call site that only used those reads the same; the rest is what legacy Markdown could not express.

Nothing here escapes anything, because nothing downstream parses the text. A name with _, *, [ and a backtick in it goes through text and arrives exactly as typed.

Constructors

MessageTextBuilder

constructor()

Functions

fun blockquote(block: MessageTextBuilder.() -> Unit)

fun bold(block: MessageTextBuilder.() -> Unit)

fun bold(value: String)

fun br()

fun br2()

fun build(): MessageText

fun code(value: String)

Inline monospace. Does not nest — see TextPiece.Code.

fun codeBlock(value: String, language: String? = null)

A monospace block; language only tells the client's highlighter what to do.

expandableBlockquote

fun expandableBlockquote(block: MessageTextBuilder.() -> Unit)

A quote the client shows collapsed. Long output belongs here rather than in the message body.

fun italic(block: MessageTextBuilder.() -> Unit)

fun italic(value: String)

fun link(url: String, block: MessageTextBuilder.() -> Unit)

fun link(url: String, value: String)

fun <T> list(items: List<T>, block: MessageTextBuilder.(T) -> Unit)

Each item rendered by block, separated by a blank line — the old builder's behaviour.

fun row(block: MessageTextBuilder.() -> Unit)

The block's content on its own line, with a newline before it if one is not already there.

fun spoiler(block: MessageTextBuilder.() -> Unit)

fun spoiler(value: String)

fun strikethrough(block: MessageTextBuilder.() -> Unit)

fun strikethrough(value: String)

fun text(value: String)

fun underline(block: MessageTextBuilder.() -> Unit)

fun underline(value: String)