@yaebal/rich 0.0.1

package/lib/inline.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"inline.js","sourceRoot":"","sources":["../src/inline.ts"],"names":[],"mappings":"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"}

package/lib/message.d.ts

@@ -0,0 +1,26 @@
+import type { InputRichMessage } from "@yaebal/types";
+import type { Insertable } from "./inline.js";
+export interface DocumentOptions {
+    /** `InputRichMessage.is_rtl` — show the message right-to-left. */
+    rtl?: boolean;
+    /**
+     * `InputRichMessage.skip_entity_detection` — turn off auto-detection of urls,
+     * emails, `@mentions`, `#hashtags`, `$cashtags`, `/bot_commands`, and phone
+     * numbers in plain text.
+     */
+    skipEntityDetection?: boolean;
+}
+/**
+ * assemble top-level blocks (from blocks.ts) into an `InputRichMessage.html`
+ * payload. pass the result straight to `sendRichMessage`/`sendRichMessageDraft`
+ * or a `RichMessageDraft`.
+ */
+export declare function document(blocks: Insertable[], options?: DocumentOptions): InputRichMessage;
+/**
+ * a raw markdown payload — telegram parses `InputRichMessage.markdown` the same
+ * way as `html`, but the extended block syntax (tables, `tg-thinking`, …) is not
+ * documented in markdown form, so unlike `document()` this has no builder: pass a
+ * literal string.
+ */
+export declare function markdown(source: string, options?: DocumentOptions): InputRichMessage;
+//# sourceMappingURL=message.d.ts.map

package/lib/message.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"message.d.ts","sourceRoot":"","sources":["../src/message.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACtD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAG9C,MAAM,WAAW,eAAe;IAC/B,kEAAkE;IAClE,GAAG,CAAC,EAAE,OAAO,CAAC;IACd;;;;OAIG;IACH,mBAAmB,CAAC,EAAE,OAAO,CAAC;CAC9B;AAED;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,MAAM,EAAE,UAAU,EAAE,EAAE,OAAO,GAAE,eAAoB,GAAG,gBAAgB,CAQ9F;AAED;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,GAAE,eAAoB,GAAG,gBAAgB,CAQxF"}

package/lib/message.js

@@ -0,0 +1,31 @@
+import { toHtml } from "./inline.js";
+/**
+ * assemble top-level blocks (from blocks.ts) into an `InputRichMessage.html`
+ * payload. pass the result straight to `sendRichMessage`/`sendRichMessageDraft`
+ * or a `RichMessageDraft`.
+ */
+export function document(blocks, options = {}) {
+    return {
+        html: blocks.map(toHtml).join(""),
+        ...(options.rtl !== undefined ? { is_rtl: options.rtl } : {}),
+        ...(options.skipEntityDetection !== undefined
+            ? { skip_entity_detection: options.skipEntityDetection }
+            : {}),
+    };
+}
+/**
+ * a raw markdown payload — telegram parses `InputRichMessage.markdown` the same
+ * way as `html`, but the extended block syntax (tables, `tg-thinking`, …) is not
+ * documented in markdown form, so unlike `document()` this has no builder: pass a
+ * literal string.
+ */
+export function markdown(source, options = {}) {
+    return {
+        markdown: source,
+        ...(options.rtl !== undefined ? { is_rtl: options.rtl } : {}),
+        ...(options.skipEntityDetection !== undefined
+            ? { skip_entity_detection: options.skipEntityDetection }
+            : {}),
+    };
+}
+//# sourceMappingURL=message.js.map

package/lib/message.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"message.js","sourceRoot":"","sources":["../src/message.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAarC;;;;GAIG;AACH,MAAM,UAAU,QAAQ,CAAC,MAAoB,EAAE,UAA2B,EAAE;IAC3E,OAAO;QACN,IAAI,EAAE,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC;QACjC,GAAG,CAAC,OAAO,CAAC,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC7D,GAAG,CAAC,OAAO,CAAC,mBAAmB,KAAK,SAAS;YAC5C,CAAC,CAAC,EAAE,qBAAqB,EAAE,OAAO,CAAC,mBAAmB,EAAE;YACxD,CAAC,CAAC,EAAE,CAAC;KACN,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,QAAQ,CAAC,MAAc,EAAE,UAA2B,EAAE;IACrE,OAAO;QACN,QAAQ,EAAE,MAAM;QAChB,GAAG,CAAC,OAAO,CAAC,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC7D,GAAG,CAAC,OAAO,CAAC,mBAAmB,KAAK,SAAS;YAC5C,CAAC,CAAC,EAAE,qBAAqB,EAAE,OAAO,CAAC,mBAAmB,EAAE;YACxD,CAAC,CAAC,EAAE,CAAC;KACN,CAAC;AACH,CAAC"}

package/lib/plaintext.d.ts

@@ -0,0 +1,16 @@
+import type { RichBlock, RichMessage, RichText } from "@yaebal/types";
+/**
+ * the schema documents `RichText` fields as "either a String for plain text, an
+ * Array of RichText, or" one of the marked-up variants — but the generated
+ * `RichText` type only lists the object variants. widen locally so plain-string
+ * leaves (by far the common case) don't need a cast at every call site.
+ */
+type RichTextLike = RichText | string | RichTextLike[] | undefined;
+/** flatten a `RichText` field (bold/link/spoiler/…) down to its plain characters. */
+export declare function richTextToPlainText(text: RichTextLike): string;
+/** flatten one `RichBlock` (and its nested blocks) down to plain text, one block per line. */
+export declare function richBlockToPlainText(block: RichBlock): string;
+/** flatten a whole `RichMessage.blocks` tree to plain text — search indices, logs, notifications. */
+export declare function richMessageToPlainText(message: RichMessage): string;
+export {};
+//# sourceMappingURL=plaintext.d.ts.map

package/lib/plaintext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plaintext.d.ts","sourceRoot":"","sources":["../src/plaintext.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACX,SAAS,EAqBT,WAAW,EACX,QAAQ,EAGR,MAAM,eAAe,CAAC;AAEvB;;;;;GAKG;AACH,KAAK,YAAY,GAAG,QAAQ,GAAG,MAAM,GAAG,YAAY,EAAE,GAAG,SAAS,CAAC;AAenE,qFAAqF;AACrF,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,YAAY,GAAG,MAAM,CAiB9D;AASD,8FAA8F;AAC9F,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,SAAS,GAAG,MAAM,CA4D7D;AAED,qGAAqG;AACrG,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,WAAW,GAAG,MAAM,CAEnE"}

package/lib/plaintext.js

@@ -0,0 +1,104 @@
+/**
+ * every generated `.type` field is plain `string`, not a literal — so unlike a
+ * normal discriminated union, `switch (x.type)` narrows the *string*, not `x`
+ * itself, and (worse) several `RichBlock`/`RichText` interfaces are structurally
+ * identical (e.g. `RichBlockParagraph`/`RichBlockFooter`/`RichBlockThinking` are
+ * all just `{ type; text }`), which makes typescript's guard-based negative
+ * narrowing collapse to `never` if you lean on it across a chain. so: switch on
+ * the string, cast once per case instead of narrowing.
+ */
+function as(value) {
+    return value;
+}
+/** flatten a `RichText` field (bold/link/spoiler/…) down to its plain characters. */
+export function richTextToPlainText(text) {
+    if (text === undefined)
+        return "";
+    if (typeof text === "string")
+        return text;
+    if (Array.isArray(text))
+        return text.map(richTextToPlainText).join("");
+    switch (text.type) {
+        case "custom_emoji":
+            return as(text).alternative_text;
+        case "mathematical_expression":
+            return as(text).expression;
+        case "anchor":
+            return "";
+        // every remaining variant wraps a nested `text` field (bold, italic, url,
+        // mention, hashtag, date_time, reference, anchor_link, text_mention, …).
+        default:
+            return richTextToPlainText(as(text).text);
+    }
+}
+function captionToPlainText(caption) {
+    if (!caption)
+        return "";
+    const credit = caption.credit ? ` (${richTextToPlainText(caption.credit)})` : "";
+    return `${richTextToPlainText(caption.text)}${credit}\n`;
+}
+/** flatten one `RichBlock` (and its nested blocks) down to plain text, one block per line. */
+export function richBlockToPlainText(block) {
+    switch (block.type) {
+        case "paragraph":
+            return `${richTextToPlainText(as(block).text)}\n`;
+        case "heading":
+            return `${richTextToPlainText(as(block).text)}\n`;
+        case "pre":
+            return `${richTextToPlainText(as(block).text)}\n`;
+        case "footer":
+            return `${richTextToPlainText(as(block).text)}\n`;
+        case "thinking":
+            return `${richTextToPlainText(as(block).text)}\n`;
+        case "divider":
+            return "---\n";
+        case "anchor":
+            return "";
+        case "mathematical_expression":
+            return `${as(block).expression}\n`;
+        case "list": {
+            const { items } = as(block);
+            return `${items
+                .map((entry) => `- ${entry.blocks.map(richBlockToPlainText).join("").trim()}`)
+                .join("\n")}\n`;
+        }
+        case "blockquote": {
+            const { blocks, credit } = as(block);
+            return `${blocks.map(richBlockToPlainText).join("")}${credit ? ` — ${richTextToPlainText(credit)}` : ""}\n`;
+        }
+        case "pullquote": {
+            const { text, credit } = as(block);
+            return `${richTextToPlainText(text)}${credit ? ` — ${richTextToPlainText(credit)}` : ""}\n`;
+        }
+        case "collage":
+        case "slideshow": {
+            const { blocks, caption } = as(block);
+            return `${blocks.map(richBlockToPlainText).join("")}${captionToPlainText(caption)}`;
+        }
+        case "table": {
+            const { cells } = as(block);
+            return `${cells.map((row) => row.map((c) => richTextToPlainText(c.text)).join(" | ")).join("\n")}\n`;
+        }
+        case "details": {
+            const { summary, blocks } = as(block);
+            return `${richTextToPlainText(summary)}\n${blocks.map(richBlockToPlainText).join("")}`;
+        }
+        case "map":
+            return captionToPlainText(as(block).caption);
+        case "animation":
+        case "audio":
+        case "photo":
+        case "video":
+        case "voice_note": {
+            const { caption } = as(block);
+            return captionToPlainText(caption);
+        }
+        default:
+            return "";
+    }
+}
+/** flatten a whole `RichMessage.blocks` tree to plain text — search indices, logs, notifications. */
+export function richMessageToPlainText(message) {
+    return message.blocks.map(richBlockToPlainText).join("").trim();
+}
+//# sourceMappingURL=plaintext.js.map

package/lib/plaintext.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plaintext.js","sourceRoot":"","sources":["../src/plaintext.ts"],"names":[],"mappings":"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"}

package/lib/send.d.ts

@@ -0,0 +1,27 @@
+import type { Api, Context, Message, Plugin } from "@yaebal/core";
+import type { InputRichMessage } from "@yaebal/types";
+import { RichMessageDraft, type RichMessageDraftOptions } from "./draft.js";
+/**
+ * `sendRichMessage` — standalone, no plugin install required (the `@yaebal/fmt` /
+ * `@yaebal/keyboard` "pure helper" style). `extra` covers the rest of
+ * `SendRichMessageParams`: `reply_markup`, `reply_parameters`,
+ * `message_effect_id`, `disable_notification`, `protect_content`,
+ * `business_connection_id`, `message_thread_id`, `direct_messages_topic_id`,
+ * `allow_paid_broadcast`, `suggested_post_parameters`.
+ */
+export declare function sendRichMessage(api: Api, chatId: number | string, input: InputRichMessage | string, extra?: Record<string, unknown>): Promise<Message>;
+/**
+ * `sendRichMessageDraft` — a single ephemeral (30s-ttl) push. private chats
+ * only. most callers want `RichMessageDraft` (draft.ts) instead, which keeps the
+ * ttl alive across a stream and forces a final `sendRichMessage` commit.
+ */
+export declare function sendRichMessageDraft(api: Api, chatId: number, draftId: number, input: InputRichMessage | string, extra?: Record<string, unknown>): Promise<boolean>;
+export interface RichContext {
+    /** `ctx.send`-flavored `sendRichMessage`, bound to the current chat. */
+    sendRichMessage(input: InputRichMessage | string, extra?: Record<string, unknown>): Promise<Message>;
+    /** open a `RichMessageDraft` streaming session bound to the current chat. */
+    richMessageDraft(draftId: number, options?: RichMessageDraftOptions): RichMessageDraft;
+}
+/** `bot.install(rich())` — adds `ctx.sendRichMessage` / `ctx.richMessageDraft`. */
+export declare function rich(): Plugin<Context, RichContext>;
+//# sourceMappingURL=send.d.ts.map

package/lib/send.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"send.d.ts","sourceRoot":"","sources":["../src/send.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAClE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACtD,OAAO,EAAE,gBAAgB,EAAE,KAAK,uBAAuB,EAAE,MAAM,YAAY,CAAC;AAM5E;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAC9B,GAAG,EAAE,GAAG,EACR,MAAM,EAAE,MAAM,GAAG,MAAM,EACvB,KAAK,EAAE,gBAAgB,GAAG,MAAM,EAChC,KAAK,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GACjC,OAAO,CAAC,OAAO,CAAC,CAMlB;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CACnC,GAAG,EAAE,GAAG,EACR,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,gBAAgB,GAAG,MAAM,EAChC,KAAK,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GACjC,OAAO,CAAC,OAAO,CAAC,CAOlB;AAED,MAAM,WAAW,WAAW;IAC3B,wEAAwE;IACxE,eAAe,CACd,KAAK,EAAE,gBAAgB,GAAG,MAAM,EAChC,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC7B,OAAO,CAAC,OAAO,CAAC,CAAC;IACpB,6EAA6E;IAC7E,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,uBAAuB,GAAG,gBAAgB,CAAC;CACvF;AAED,mFAAmF;AACnF,wBAAgB,IAAI,IAAI,MAAM,CAAC,OAAO,EAAE,WAAW,CAAC,CAoBnD"}

package/lib/send.js

@@ -0,0 +1,52 @@
+import { RichMessageDraft } from "./draft.js";
+function toInput(input) {
+    return typeof input === "string" ? { html: input } : input;
+}
+/**
+ * `sendRichMessage` — standalone, no plugin install required (the `@yaebal/fmt` /
+ * `@yaebal/keyboard` "pure helper" style). `extra` covers the rest of
+ * `SendRichMessageParams`: `reply_markup`, `reply_parameters`,
+ * `message_effect_id`, `disable_notification`, `protect_content`,
+ * `business_connection_id`, `message_thread_id`, `direct_messages_topic_id`,
+ * `allow_paid_broadcast`, `suggested_post_parameters`.
+ */
+export function sendRichMessage(api, chatId, input, extra = {}) {
+    return api.call("sendRichMessage", {
+        chat_id: chatId,
+        rich_message: toInput(input),
+        ...extra,
+    });
+}
+/**
+ * `sendRichMessageDraft` — a single ephemeral (30s-ttl) push. private chats
+ * only. most callers want `RichMessageDraft` (draft.ts) instead, which keeps the
+ * ttl alive across a stream and forces a final `sendRichMessage` commit.
+ */
+export function sendRichMessageDraft(api, chatId, draftId, input, extra = {}) {
+    return api.call("sendRichMessageDraft", {
+        chat_id: chatId,
+        draft_id: draftId,
+        rich_message: toInput(input),
+        ...extra,
+    });
+}
+/** `bot.install(rich())` — adds `ctx.sendRichMessage` / `ctx.richMessageDraft`. */
+export function rich() {
+    return (composer) => composer.decorate({
+        sendRichMessage(input, extra = {}) {
+            const chatId = this.chat?.id;
+            if (chatId === undefined) {
+                return Promise.reject(new Error("sendRichMessage(): no chat in this update"));
+            }
+            return sendRichMessage(this.api, chatId, input, extra);
+        },
+        richMessageDraft(draftId, options) {
+            const chatId = this.chat?.id;
+            if (chatId === undefined) {
+                throw new Error("richMessageDraft(): no chat in this update");
+            }
+            return new RichMessageDraft(this.api, chatId, draftId, options);
+        },
+    });
+}
+//# sourceMappingURL=send.js.map

package/lib/send.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"send.js","sourceRoot":"","sources":["../src/send.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,gBAAgB,EAAgC,MAAM,YAAY,CAAC;AAE5E,SAAS,OAAO,CAAC,KAAgC;IAChD,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC;AAC5D,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,eAAe,CAC9B,GAAQ,EACR,MAAuB,EACvB,KAAgC,EAChC,QAAiC,EAAE;IAEnC,OAAO,GAAG,CAAC,IAAI,CAAU,iBAAiB,EAAE;QAC3C,OAAO,EAAE,MAAM;QACf,YAAY,EAAE,OAAO,CAAC,KAAK,CAAC;QAC5B,GAAG,KAAK;KACR,CAAC,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,oBAAoB,CACnC,GAAQ,EACR,MAAc,EACd,OAAe,EACf,KAAgC,EAChC,QAAiC,EAAE;IAEnC,OAAO,GAAG,CAAC,IAAI,CAAU,sBAAsB,EAAE;QAChD,OAAO,EAAE,MAAM;QACf,QAAQ,EAAE,OAAO;QACjB,YAAY,EAAE,OAAO,CAAC,KAAK,CAAC;QAC5B,GAAG,KAAK;KACR,CAAC,CAAC;AACJ,CAAC;AAYD,mFAAmF;AACnF,MAAM,UAAU,IAAI;IACnB,OAAO,CAAC,QAAQ,EAAE,EAAE,CACnB,QAAQ,CAAC,QAAQ,CAAc;QAC9B,eAAe,CAAgB,KAAK,EAAE,KAAK,GAAG,EAAE;YAC/C,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC;YAC7B,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;gBAC1B,OAAO,OAAO,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,2CAA2C,CAAC,CAAC,CAAC;YAC/E,CAAC;YAED,OAAO,eAAe,CAAC,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC;QACxD,CAAC;QACD,gBAAgB,CAAgB,OAAO,EAAE,OAAO;YAC/C,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC;YAC7B,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;gBAC1B,MAAM,IAAI,KAAK,CAAC,4CAA4C,CAAC,CAAC;YAC/D,CAAC;YAED,OAAO,IAAI,gBAAgB,CAAC,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;QACjE,CAAC;KACD,CAAC,CAAC;AACL,CAAC"}

package/package.json

@@ -0,0 +1,51 @@
+{
+  "name": "@yaebal/rich",
+  "version": "0.0.1",
+  "description": "yaebal rich — sendRichMessage / sendRichMessageDraft: a typed block builder, a 30s-ttl draft/streaming session, and full read-side coverage of telegram's rich message model.",
+  "type": "module",
+  "main": "./lib/index.js",
+  "types": "./lib/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./lib/index.d.ts",
+      "import": "./lib/index.js"
+    }
+  },
+  "files": [
+    "lib",
+    "src"
+  ],
+  "dependencies": {
+    "@yaebal/core": "0.0.7",
+    "@yaebal/types": "10.1.0"
+  },
+  "devDependencies": {
+    "@types/node": "latest"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "keywords": [
+    "telegram",
+    "telegram-bot",
+    "yaebal",
+    "rich-message",
+    "sendRichMessage",
+    "sendRichMessageDraft",
+    "streaming"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/neverlane/yaebal",
+    "directory": "packages/rich"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "node --test lib"
+  }
+}

package/src/blocks.ts

@@ -0,0 +1,250 @@
+import { escapeAttr, escapeText } from "./escape.js";
+import { type Insertable, type RichNode, toHtml } from "./inline.js";
+
+function join(children: Insertable[]): string {
+	return children.map(toHtml).join("");
+}
+
+/** a caption + optional credit for a media/collage/slideshow/map block (`RichBlockCaption`). */
+export interface Caption {
+	caption?: Insertable;
+	/** `RichBlockCaption.credit`, confirmed `<cite>`. */
+	credit?: Insertable;
+}
+
+function figcaption({ caption, credit }: Caption): string {
+	if (caption === undefined && credit === undefined) return "";
+
+	const creditHtml = credit === undefined ? "" : `<cite>${toHtml(credit)}</cite>`;
+	return `<figcaption>${toHtml(caption)}${creditHtml}</figcaption>`;
+}
+
+// --- confirmed tags ---
+
+/** `RichBlockParagraph`, `<p>`. */
+export function paragraph(...children: Insertable[]): RichNode {
+	return { html: `<p>${join(children)}</p>` };
+}
+
+/** `RichBlockSectionHeading`, `<h1>`–`<h6>`. `level` is telegram's `size` (1 largest, 6 smallest). */
+export function heading(level: 1 | 2 | 3 | 4 | 5 | 6, ...children: Insertable[]): RichNode {
+	return { html: `<h${level}>${join(children)}</h${level}>` };
+}
+
+/** `RichBlockPreformatted`, nested `<pre><code>`, matching classic parse_mode html. */
+export function preformatted(text: string, language?: string): RichNode {
+	const cls = language ? ` class="language-${escapeAttr(language)}"` : "";
+	return { html: `<pre><code${cls}>${escapeText(text)}</code></pre>` };
+}
+
+/** `RichBlockFooter`, `<footer>`. */
+export function footer(...children: Insertable[]): RichNode {
+	return { html: `<footer>${join(children)}</footer>` };
+}
+
+/** `RichBlockDivider`, `<hr/>`. */
+export function divider(): RichNode {
+	return { html: "<hr/>" };
+}
+
+/** `RichBlockMathematicalExpression`, confirmed `<tg-math-block>` (LaTeX). */
+export function mathBlock(expression: string): RichNode {
+	return { html: `<tg-math-block>${escapeText(expression)}</tg-math-block>` };
+}
+
+/** `RichBlockAnchor`, `<a name="…">` at block level. */
+export function anchorBlock(name: string): RichNode {
+	return { html: `<a name="${escapeAttr(name)}"></a>` };
+}
+
+/** `RichBlockBlockQuotation`, `<blockquote>`, with an optional `<cite>` credit. */
+export function blockquote(children: Insertable[], credit?: Insertable): RichNode {
+	const creditHtml = credit === undefined ? "" : `<cite>${toHtml(credit)}</cite>`;
+	return { html: `<blockquote>${join(children)}${creditHtml}</blockquote>` };
+}
+
+/** `RichBlockPullQuotation`, loosely `<aside>` per the schema, with an optional `<cite>` credit. */
+export function pullquote(text: Insertable, credit?: Insertable): RichNode {
+	const creditHtml = credit === undefined ? "" : `<cite>${toHtml(credit)}</cite>`;
+	return { html: `<aside>${toHtml(text)}${creditHtml}</aside>` };
+}
+
+/** `RichBlockCollage`, confirmed custom tag `<tg-collage>`. */
+export function collage(blocks: Insertable[], caption: Caption = {}): RichNode {
+	return { html: `<tg-collage>${join(blocks)}${figcaption(caption)}</tg-collage>` };
+}
+
+/** `RichBlockSlideshow`, confirmed custom tag `<tg-slideshow>`. */
+export function slideshow(blocks: Insertable[], caption: Caption = {}): RichNode {
+	return { html: `<tg-slideshow>${join(blocks)}${figcaption(caption)}</tg-slideshow>` };
+}
+
+export interface TableCellOptions {
+	header?: boolean;
+	colspan?: number;
+	rowspan?: number;
+	/** default `"left"`, matching `RichBlockTableCell.align`. */
+	align?: "left" | "center" | "right";
+	/** default `"top"`, matching `RichBlockTableCell.valign`. */
+	valign?: "top" | "middle" | "bottom";
+}
+
+/** one `<td>`/`<th>` cell; `content` omitted ⇒ an invisible cell (per `RichBlockTableCell`). */
+export function cell(content?: Insertable, options: TableCellOptions = {}): RichNode {
+	const tag = options.header ? "th" : "td";
+	const attrs =
+		(options.colspan ? ` colspan="${options.colspan}"` : "") +
+		(options.rowspan ? ` rowspan="${options.rowspan}"` : "") +
+		// `align`/`valign` are telegram's own field names for this cell — the values
+		// (left/center/right, top/middle/bottom) match the classic html attributes exactly.
+		(options.align ? ` align="${options.align}"` : "") +
+		(options.valign ? ` valign="${options.valign}"` : "");
+
+	return {
+		html:
+			content === undefined
+				? `<${tag}${attrs}></${tag}>`
+				: `<${tag}${attrs}>${toHtml(content)}</${tag}>`,
+	};
+}
+
+export interface TableOptions {
+	/** best-effort: rendered as the `border` attribute. */
+	bordered?: boolean;
+	/** best-effort: no standard html equivalent, rendered as `data-striped`. */
+	striped?: boolean;
+	caption?: Insertable;
+}
+
+/** `RichBlockTable`, confirmed `<table>`. build rows with `cell()`. */
+export function table(rows: Insertable[][], options: TableOptions = {}): RichNode {
+	const attrs = (options.bordered ? " border" : "") + (options.striped ? " data-striped" : "");
+	const body = rows.map((row) => `<tr>${join(row)}</tr>`).join("");
+	const captionHtml =
+		options.caption === undefined ? "" : `<caption>${toHtml(options.caption)}</caption>`;
+
+	return { html: `<table${attrs}>${captionHtml}${body}</table>` };
+}
+
+export interface DetailsOptions {
+	/** `RichBlockDetails.is_open` — content visible by default. defaults to `false`. */
+	open?: boolean;
+}
+
+/** `RichBlockDetails`, confirmed `<details>`/`<summary>`. */
+export function details(
+	summary: Insertable,
+	blocks: Insertable[],
+	options: DetailsOptions = {},
+): RichNode {
+	return {
+		html: `<details${options.open ? " open" : ""}><summary>${toHtml(summary)}</summary>${join(blocks)}</details>`,
+	};
+}
+
+export interface ListItemOptions {
+	/** an unchecked/checked checkbox prefix (`RichBlockListItem.has_checkbox`/`is_checked`). */
+	checkbox?: boolean;
+	checked?: boolean;
+	/** ordered-list numeric override (`RichBlockListItem.value`) — standard `<li value>`. */
+	value?: number;
+	/** ordered-list label style override (`RichBlockListItem.type`) — standard `<li type>`. */
+	type?: "a" | "A" | "i" | "I";
+}
+
+/** one `<li>` for `list()`. */
+export function item(blocks: Insertable[], options: ListItemOptions = {}): RichNode {
+	const attrs =
+		(options.value !== undefined ? ` value="${options.value}"` : "") +
+		(options.type ? ` type="${options.type}"` : "");
+
+	const checkboxHtml =
+		options.checkbox === undefined
+			? ""
+			: `<input type="checkbox"${options.checked ? " checked" : ""}/> `;
+
+	return { html: `<li${attrs}>${checkboxHtml}${join(blocks)}</li>` };
+}
+
+export interface ListOptions {
+	/** `<ol>` instead of `<ul>`. defaults to `false`. */
+	ordered?: boolean;
+}
+
+/** `RichBlockList`, `<ul>`/`<ol>` of `item()`s. */
+export function list(items: Insertable[], options: ListOptions = {}): RichNode {
+	const tag = options.ordered ? "ol" : "ul";
+	return { html: `<${tag}>${join(items)}</${tag}>` };
+}
+
+export interface MapOptions {
+	/** 13–20, per `RichBlockMap.zoom`. */
+	zoom: number;
+	width: number;
+	height: number;
+}
+
+/**
+ * `RichBlockMap`, confirmed custom tag `<tg-map>` — attribute names/encoding are a
+ * best-effort guess (lat/long/zoom/width/height are telegram's own field names).
+ */
+export function map(
+	location: { latitude: number; longitude: number },
+	options: MapOptions,
+	caption: Caption = {},
+): RichNode {
+	const attrs =
+		` latitude="${location.latitude}" longitude="${location.longitude}"` +
+		` zoom="${options.zoom}" width="${options.width}" height="${options.height}"`;
+
+	return { html: `<tg-map${attrs}>${figcaption(caption)}</tg-map>` };
+}
+
+export interface MediaOptions extends Caption {
+	/** cover the media with a spoiler animation until tapped. */
+	spoiler?: boolean;
+}
+
+function figure(tag: string, src: string, options: MediaOptions): RichNode {
+	const spoilerAttr = options.spoiler ? " data-media-spoiler" : "";
+	const media = `<${tag} src="${escapeAttr(src)}"${spoilerAttr}></${tag}>`;
+	const cap = figcaption(options);
+
+	return { html: cap ? `<figure>${media}${cap}</figure>` : media };
+}
+
+/**
+ * `RichBlockPhoto`, confirmed `<img>`. media is referenced by url — `sendRichMessage`
+ * has no multipart/`attach://` upload path (unlike `sendPhoto`), so there is no
+ * `MediaSource` overload here; host the file and pass its url.
+ */
+export function image(src: string, options: MediaOptions = {}): RichNode {
+	return figure("img", src, options);
+}
+
+/**
+ * `RichBlockVideo` **and** `RichBlockAnimation` both map to `<video>` per the
+ * schema (telegram tells the two apart server-side, e.g. by looping/silence —
+ * not by tag). there is no separate `animation()` builder for that reason.
+ */
+export function video(src: string, options: MediaOptions = {}): RichNode {
+	return figure("video", src, options);
+}
+
+/**
+ * `RichBlockAudio` **and** `RichBlockVoiceNote` both map to `<audio>` per the
+ * schema (again disambiguated server-side, not by tag) — there is no separate
+ * `voiceNote()` builder for that reason.
+ */
+export function audio(src: string, options: MediaOptions = {}): RichNode {
+	return figure("audio", src, options);
+}
+
+/**
+ * `RichBlockThinking`, confirmed custom tag `<tg-thinking>`. **draft-only** — the
+ * schema states it can be used in `sendRichMessageDraft` payloads but is never
+ * received back on a real message. see `RichMessageDraft` in draft.ts.
+ */
+export function thinking(...children: Insertable[]): RichNode {
+	return { html: `<tg-thinking>${join(children)}</tg-thinking>` };
+}