@yaebal/rich 0.0.1 → 0.0.2

package/lib/guards.test.js

@@ -0,0 +1,85 @@
+import assert from "node:assert/strict";
+import test from "node:test";
+import { isAnchorBlock, isAnchorLink, isAnchorText, isAnimation, isAudio, isBankCardNumber, isBlockquote, isBold, isBotCommand, isCashtag, isCodeText, isCollage, isCustomEmoji, isDateTime, isDetails, isDivider, isEmailAddress, isFooter, isHashtag, isHeading, isItalic, isList, isMap, isMarked, isMathBlock, isMathText, isMentionText, isParagraph, isPhoneNumber, isPhoto, isPreformatted, isPullquote, isReference, isReferenceLink, isSlideshow, isSpoilerText, isStrikethrough, isSubscript, isSuperscript, isTable, isTextMention, isThinking, isUnderline, isUrlText, isVideo, isVoiceNote, } from "./guards.js";
+const BLOCK_GUARDS = [
+    ["paragraph", isParagraph],
+    ["heading", isHeading],
+    ["pre", isPreformatted],
+    ["footer", isFooter],
+    ["divider", isDivider],
+    ["mathematical_expression", isMathBlock],
+    ["anchor", isAnchorBlock],
+    ["list", isList],
+    ["blockquote", isBlockquote],
+    ["pullquote", isPullquote],
+    ["collage", isCollage],
+    ["slideshow", isSlideshow],
+    ["table", isTable],
+    ["details", isDetails],
+    ["map", isMap],
+    ["animation", isAnimation],
+    ["audio", isAudio],
+    ["photo", isPhoto],
+    ["video", isVideo],
+    ["voice_note", isVoiceNote],
+    ["thinking", isThinking],
+];
+const TEXT_GUARDS = [
+    ["bold", isBold],
+    ["italic", isItalic],
+    ["underline", isUnderline],
+    ["strikethrough", isStrikethrough],
+    ["spoiler", isSpoilerText],
+    ["date_time", isDateTime],
+    ["text_mention", isTextMention],
+    ["subscript", isSubscript],
+    ["superscript", isSuperscript],
+    ["marked", isMarked],
+    ["code", isCodeText],
+    ["custom_emoji", isCustomEmoji],
+    ["mathematical_expression", isMathText],
+    ["url", isUrlText],
+    ["email_address", isEmailAddress],
+    ["phone_number", isPhoneNumber],
+    ["bank_card_number", isBankCardNumber],
+    ["mention", isMentionText],
+    ["hashtag", isHashtag],
+    ["cashtag", isCashtag],
+    ["bot_command", isBotCommand],
+    ["anchor", isAnchorText],
+    ["anchor_link", isAnchorLink],
+    ["reference", isReference],
+    ["reference_link", isReferenceLink],
+];
+test("every RichBlock guard matches its own .type and rejects every other guard's", () => {
+    for (const [type, guard] of BLOCK_GUARDS) {
+        const block = { type };
+        assert.equal(guard(block), true, `${type} guard should match its own type`);
+        for (const [otherType, otherGuard] of BLOCK_GUARDS) {
+            if (otherType === type)
+                continue;
+            assert.equal(otherGuard(block), false, `${otherType} guard should reject a "${type}" block`);
+        }
+    }
+});
+test("every RichText guard matches its own .type and rejects every other guard's", () => {
+    for (const [type, guard] of TEXT_GUARDS) {
+        const text = { type };
+        assert.equal(guard(text), true, `${type} guard should match its own type`);
+        for (const [otherType, otherGuard] of TEXT_GUARDS) {
+            if (otherType === type)
+                continue;
+            assert.equal(otherGuard(text), false, `${otherType} guard should reject a "${type}" text`);
+        }
+    }
+});
+test("guards narrow RichBlock by .type despite the generated field being `string`", () => {
+    const blocks = [
+        { type: "table", cells: [[{ text: "x", align: "left", valign: "top" }]] },
+        { type: "photo", photo: [] },
+    ];
+    assert.equal(isTable(blocks[0]), true);
+    assert.equal(isPhoto(blocks[1]), true);
+    assert.equal(isTable(blocks[1]), false);
+});
+//# sourceMappingURL=guards.test.js.map

package/lib/guards.test.js.map

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

package/lib/index.d.ts

@@ -6,12 +6,17 @@
  * parses it server-side, and you get the same tree back on `message.rich_message`.
  * this package covers all three parts of that surface:
  *
- * - **write**: `document()` + block builders (blocks.ts) and inline mark builders
- *   (inline.ts) assemble an `InputRichMessage` without hand-written angle brackets.
+ * - **write**: one dual-dialect builder set. every builder (`bold`, `paragraph`,
+ *   `table`, …) returns a dialect-agnostic `RichNode`; the `html`/`md` template
+ *   tags (or `document()`) pick the wire dialect once, at the edge, and emit a
+ *   `RichDocument` — the `rich_message` envelope with fluent `.rtl()` /
+ *   `.noEntityDetection()` flags. interpolated text is always dialect-escaped,
+ *   so user input can never inject markup in either dialect.
  * - **stream**: `RichMessageDraft` (draft.ts) owns the fiddly part of
  *   `sendRichMessageDraft` — the draft is ephemeral (telegram drops it 30s after
- *   the last push) and must be closed with a real `sendRichMessage` or explicitly
- *   cancelled.
+ *   the last push) and must be closed with a real `sendRichMessage` (`send()`) or
+ *   explicitly `cancel()`led. `rewrite()` replaces the whole draft, `write()`
+ *   appends to it.
  * - **read**: type guards (guards.ts) and plain-text flattening (plaintext.ts)
  *   cover every `RichBlock`/`RichText` variant telegram can hand back.
  *
@@ -23,11 +28,15 @@
  * /bot_command) auto-detected from plain text by telegram itself.
  */
 export type { InputRichMessage, InputRichMessageContent, RichBlock, RichBlockAnchor, RichBlockAnimation, RichBlockAudio, RichBlockBlockQuotation, RichBlockCaption, RichBlockCollage, RichBlockDetails, RichBlockDivider, RichBlockFooter, RichBlockList, RichBlockListItem, RichBlockMap, RichBlockMathematicalExpression, RichBlockParagraph, RichBlockPhoto, RichBlockPreformatted, RichBlockPullQuotation, RichBlockSectionHeading, RichBlockSlideshow, RichBlockTable, RichBlockTableCell, RichBlockThinking, RichBlockVideo, RichBlockVoiceNote, RichMessage, RichText, RichTextAnchor, RichTextAnchorLink, RichTextBankCardNumber, RichTextBold, RichTextBotCommand, RichTextCashtag, RichTextCode, RichTextCustomEmoji, RichTextDateTime, RichTextEmailAddress, RichTextHashtag, RichTextItalic, RichTextMarked, RichTextMathematicalExpression, RichTextMention, RichTextPhoneNumber, RichTextReference, RichTextReferenceLink, RichTextSpoiler, RichTextStrikethrough, RichTextSubscript, RichTextSuperscript, RichTextTextMention, RichTextUnderline, RichTextUrl, SendRichMessageDraftParams, SendRichMessageParams, } from "@yaebal/types";
-export { anchorBlock, audio, blockquote, type Caption, cell, collage, type DetailsOptions, details, divider, footer, heading, image, item, type ListItemOptions, type ListOptions, list, type MapOptions, type MediaOptions, map, mathBlock, paragraph, preformatted, pullquote, slideshow, type TableCellOptions, type TableOptions, table, thinking, video, } from "./blocks.js";
+export { anchorBlock, audio, blockquote, type Caption, cell, collage, type DetailsOptions, details, divider, footer, h1, h2, h3, h4, h5, h6, heading, image, item, join, type ListItem, type ListItemOptions, type ListOptions, list, type MapOptions, type MediaOptions, map, mathBlock, paragraph, preformatted, pullquote, slideshow, type TableCell, type TableCellOptions, type TableOptions, table, thinking, video, } from "./blocks.js";
+export { RichDocument } from "./document.js";
 export { RichMessageDraft, type RichMessageDraftOptions } from "./draft.js";
-export { isAnchorBlock, isAnchorLink, isAnchorText, isAnimation, isAudio, isBankCardNumber, isBlockquote, isBold, isBotCommand, isCashtag, isCodeText, isCollage, isCustomEmoji, isDateTime, isDetails, isDivider, isEmailAddress, isFooter, isHashtag, isHeading, isList, isMap, isMarked, isMathBlock, isMathText, isMentionText, isParagraph, isPhoneNumber, isPhoto, isPreformatted, isPullquote, isReference, isReferenceLink, isSlideshow, isSpoilerText, isStrikethrough, isSubscript, isSuperscript, isTable, isTextMention, isThinking, isUnderline, isUrlText, isVideo, isVoiceNote, } from "./guards.js";
-export { anchor, anchorLink, bold, code, customEmoji, dateTime, html, type Insertable, isRichNode, italic, link, marked, math, type RichNode, reference, referenceLink, spoiler, strikethrough, subscript, superscript, textMention, toHtml, underline, } from "./inline.js";
-export { type DocumentOptions, document, markdown } from "./message.js";
+export { escapeMarkdown, escapeMarkdownUrl } from "./escape.js";
+export { isAnchorBlock, isAnchorLink, isAnchorText, isAnimation, isAudio, isBankCardNumber, isBlockquote, isBold, isBotCommand, isCashtag, isCodeText, isCollage, isCustomEmoji, isDateTime, isDetails, isDivider, isEmailAddress, isFooter, isHashtag, isHeading, isItalic, isList, isMap, isMarked, isMathBlock, isMathText, isMentionText, isParagraph, isPhoneNumber, isPhoto, isPreformatted, isPullquote, isReference, isReferenceLink, isSlideshow, isSpoilerText, isStrikethrough, isSubscript, isSuperscript, isTable, isTextMention, isThinking, isUnderline, isUrlText, isVideo, isVoiceNote, } from "./guards.js";
+export { anchor, anchorLink, bold, br, code, customEmoji, dateTime, italic, link, marked, math, reference, referenceLink, spoiler, strikethrough, subscript, superscript, textMention, underline, } from "./inline.js";
+export { type Dialect, isRichNode, type Level, RichError, type RichNode } from "./node.js";
 export { richBlockToPlainText, richMessageToPlainText, richTextToPlainText } from "./plaintext.js";
-export { type RichContext, rich, sendRichMessage, sendRichMessageDraft, } from "./send.js";
+export { escapeFor, type Insertable, render } from "./render.js";
+export { type RichContext, type RichSource, rich, sendRichMessage, sendRichMessageDraft, } from "./send.js";
+export { type DocumentOptions, document, html, md, type RichTemplate } from "./template.js";
 //# sourceMappingURL=index.d.ts.map

package/lib/index.d.ts.map

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

package/lib/index.js

@@ -6,12 +6,17 @@
  * parses it server-side, and you get the same tree back on `message.rich_message`.
  * this package covers all three parts of that surface:
  *
- * - **write**: `document()` + block builders (blocks.ts) and inline mark builders
- *   (inline.ts) assemble an `InputRichMessage` without hand-written angle brackets.
+ * - **write**: one dual-dialect builder set. every builder (`bold`, `paragraph`,
+ *   `table`, …) returns a dialect-agnostic `RichNode`; the `html`/`md` template
+ *   tags (or `document()`) pick the wire dialect once, at the edge, and emit a
+ *   `RichDocument` — the `rich_message` envelope with fluent `.rtl()` /
+ *   `.noEntityDetection()` flags. interpolated text is always dialect-escaped,
+ *   so user input can never inject markup in either dialect.
  * - **stream**: `RichMessageDraft` (draft.ts) owns the fiddly part of
  *   `sendRichMessageDraft` — the draft is ephemeral (telegram drops it 30s after
- *   the last push) and must be closed with a real `sendRichMessage` or explicitly
- *   cancelled.
+ *   the last push) and must be closed with a real `sendRichMessage` (`send()`) or
+ *   explicitly `cancel()`led. `rewrite()` replaces the whole draft, `write()`
+ *   appends to it.
  * - **read**: type guards (guards.ts) and plain-text flattening (plaintext.ts)
  *   cover every `RichBlock`/`RichText` variant telegram can hand back.
  *
@@ -22,11 +27,15 @@
  * documented tag or (for url/email/phone/bank-card/@mention/#hashtag/$cashtag/
  * /bot_command) auto-detected from plain text by telegram itself.
  */
-export { anchorBlock, audio, blockquote, cell, collage, details, divider, footer, heading, image, item, list, map, mathBlock, paragraph, preformatted, pullquote, slideshow, table, thinking, video, } from "./blocks.js";
+export { anchorBlock, audio, blockquote, cell, collage, details, divider, footer, h1, h2, h3, h4, h5, h6, heading, image, item, join, list, map, mathBlock, paragraph, preformatted, pullquote, slideshow, table, thinking, video, } from "./blocks.js";
+export { RichDocument } from "./document.js";
 export { RichMessageDraft } from "./draft.js";
-export { isAnchorBlock, isAnchorLink, isAnchorText, isAnimation, isAudio, isBankCardNumber, isBlockquote, isBold, isBotCommand, isCashtag, isCodeText, isCollage, isCustomEmoji, isDateTime, isDetails, isDivider, isEmailAddress, isFooter, isHashtag, isHeading, isList, isMap, isMarked, isMathBlock, isMathText, isMentionText, isParagraph, isPhoneNumber, isPhoto, isPreformatted, isPullquote, isReference, isReferenceLink, isSlideshow, isSpoilerText, isStrikethrough, isSubscript, isSuperscript, isTable, isTextMention, isThinking, isUnderline, isUrlText, isVideo, isVoiceNote, } from "./guards.js";
-export { anchor, anchorLink, bold, code, customEmoji, dateTime, html, isRichNode, italic, link, marked, math, reference, referenceLink, spoiler, strikethrough, subscript, superscript, textMention, toHtml, underline, } from "./inline.js";
-export { document, markdown } from "./message.js";
+export { escapeMarkdown, escapeMarkdownUrl } from "./escape.js";
+export { isAnchorBlock, isAnchorLink, isAnchorText, isAnimation, isAudio, isBankCardNumber, isBlockquote, isBold, isBotCommand, isCashtag, isCodeText, isCollage, isCustomEmoji, isDateTime, isDetails, isDivider, isEmailAddress, isFooter, isHashtag, isHeading, isItalic, isList, isMap, isMarked, isMathBlock, isMathText, isMentionText, isParagraph, isPhoneNumber, isPhoto, isPreformatted, isPullquote, isReference, isReferenceLink, isSlideshow, isSpoilerText, isStrikethrough, isSubscript, isSuperscript, isTable, isTextMention, isThinking, isUnderline, isUrlText, isVideo, isVoiceNote, } from "./guards.js";
+export { anchor, anchorLink, bold, br, code, customEmoji, dateTime, italic, link, marked, math, reference, referenceLink, spoiler, strikethrough, subscript, superscript, textMention, underline, } from "./inline.js";
+export { isRichNode, RichError } from "./node.js";
 export { richBlockToPlainText, richMessageToPlainText, richTextToPlainText } from "./plaintext.js";
+export { escapeFor, render } from "./render.js";
 export { rich, sendRichMessage, sendRichMessageDraft, } from "./send.js";
+export { document, html, md } from "./template.js";
 //# sourceMappingURL=index.js.map

package/lib/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AA+DH,OAAO,EACN,WAAW,EACX,KAAK,EACL,UAAU,EAEV,IAAI,EACJ,OAAO,EAEP,OAAO,EACP,OAAO,EACP,MAAM,EACN,OAAO,EACP,KAAK,EACL,IAAI,EAGJ,IAAI,EAGJ,GAAG,EACH,SAAS,EACT,SAAS,EACT,YAAY,EACZ,SAAS,EACT,SAAS,EAGT,KAAK,EACL,QAAQ,EACR,KAAK,GACL,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,gBAAgB,EAAgC,MAAM,YAAY,CAAC;AAC5E,OAAO,EACN,aAAa,EACb,YAAY,EACZ,YAAY,EACZ,WAAW,EACX,OAAO,EACP,gBAAgB,EAChB,YAAY,EACZ,MAAM,EACN,YAAY,EACZ,SAAS,EACT,UAAU,EACV,SAAS,EACT,aAAa,EACb,UAAU,EACV,SAAS,EACT,SAAS,EACT,cAAc,EACd,QAAQ,EACR,SAAS,EACT,SAAS,EACT,MAAM,EACN,KAAK,EACL,QAAQ,EACR,WAAW,EACX,UAAU,EACV,aAAa,EACb,WAAW,EACX,aAAa,EACb,OAAO,EACP,cAAc,EACd,WAAW,EACX,WAAW,EACX,eAAe,EACf,WAAW,EACX,aAAa,EACb,eAAe,EACf,WAAW,EACX,aAAa,EACb,OAAO,EACP,aAAa,EACb,UAAU,EACV,WAAW,EACX,SAAS,EACT,OAAO,EACP,WAAW,GACX,MAAM,aAAa,CAAC;AACrB,OAAO,EACN,MAAM,EACN,UAAU,EACV,IAAI,EACJ,IAAI,EACJ,WAAW,EACX,QAAQ,EACR,IAAI,EAEJ,UAAU,EACV,MAAM,EACN,IAAI,EACJ,MAAM,EACN,IAAI,EAEJ,SAAS,EACT,aAAa,EACb,OAAO,EACP,aAAa,EACb,SAAS,EACT,WAAW,EACX,WAAW,EACX,MAAM,EACN,SAAS,GACT,MAAM,aAAa,CAAC;AACrB,OAAO,EAAwB,QAAQ,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAExE,OAAO,EAAE,oBAAoB,EAAE,sBAAsB,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AACnG,OAAO,EAEN,IAAI,EACJ,eAAe,EACf,oBAAoB,GACpB,MAAM,WAAW,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AA+DH,OAAO,EACN,WAAW,EACX,KAAK,EACL,UAAU,EAEV,IAAI,EACJ,OAAO,EAEP,OAAO,EACP,OAAO,EACP,MAAM,EACN,EAAE,EACF,EAAE,EACF,EAAE,EACF,EAAE,EACF,EAAE,EACF,EAAE,EACF,OAAO,EACP,KAAK,EACL,IAAI,EACJ,IAAI,EAIJ,IAAI,EAGJ,GAAG,EACH,SAAS,EACT,SAAS,EACT,YAAY,EACZ,SAAS,EACT,SAAS,EAIT,KAAK,EACL,QAAQ,EACR,KAAK,GACL,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,EAAE,gBAAgB,EAAgC,MAAM,YAAY,CAAC;AAC5E,OAAO,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAChE,OAAO,EACN,aAAa,EACb,YAAY,EACZ,YAAY,EACZ,WAAW,EACX,OAAO,EACP,gBAAgB,EAChB,YAAY,EACZ,MAAM,EACN,YAAY,EACZ,SAAS,EACT,UAAU,EACV,SAAS,EACT,aAAa,EACb,UAAU,EACV,SAAS,EACT,SAAS,EACT,cAAc,EACd,QAAQ,EACR,SAAS,EACT,SAAS,EACT,QAAQ,EACR,MAAM,EACN,KAAK,EACL,QAAQ,EACR,WAAW,EACX,UAAU,EACV,aAAa,EACb,WAAW,EACX,aAAa,EACb,OAAO,EACP,cAAc,EACd,WAAW,EACX,WAAW,EACX,eAAe,EACf,WAAW,EACX,aAAa,EACb,eAAe,EACf,WAAW,EACX,aAAa,EACb,OAAO,EACP,aAAa,EACb,UAAU,EACV,WAAW,EACX,SAAS,EACT,OAAO,EACP,WAAW,GACX,MAAM,aAAa,CAAC;AACrB,OAAO,EACN,MAAM,EACN,UAAU,EACV,IAAI,EACJ,EAAE,EACF,IAAI,EACJ,WAAW,EACX,QAAQ,EACR,MAAM,EACN,IAAI,EACJ,MAAM,EACN,IAAI,EACJ,SAAS,EACT,aAAa,EACb,OAAO,EACP,aAAa,EACb,SAAS,EACT,WAAW,EACX,WAAW,EACX,SAAS,GACT,MAAM,aAAa,CAAC;AACrB,OAAO,EAAgB,UAAU,EAAc,SAAS,EAAiB,MAAM,WAAW,CAAC;AAC3F,OAAO,EAAE,oBAAoB,EAAE,sBAAsB,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AACnG,OAAO,EAAE,SAAS,EAAmB,MAAM,EAAE,MAAM,aAAa,CAAC;AACjE,OAAO,EAGN,IAAI,EACJ,eAAe,EACf,oBAAoB,GACpB,MAAM,WAAW,CAAC;AACnB,OAAO,EAAwB,QAAQ,EAAE,IAAI,EAAE,EAAE,EAAqB,MAAM,eAAe,CAAC"}

package/lib/index.test.js

@@ -1,72 +1,44 @@
 import assert from "node:assert/strict";
 import test from "node:test";
 import { Composer, Context } from "@yaebal/core";
-import { bold, cell, details, document, heading, html, image, isPhoto, isTable, item, link, list, paragraph, RichMessageDraft, rich, richMessageToPlainText, sendRichMessage, sendRichMessageDraft, table, thinking, } from "./index.js";
-function mockApi() {
-    const calls = [];
-    return {
-        calls,
-        call: async (method, params) => {
-            calls.push([method, params]);
-            return {};
-        },
-    };
-}
-test("html template escapes interpolations and splices RichNode subs", () => {
-    const node = html `<p>hi ${"<b>hax</b>"} — ${bold("safe")}</p>`;
-    assert.equal(node.html, "<p>hi &lt;b&gt;hax&lt;/b&gt; — <b>safe</b></p>");
-});
-test("inline builders emit the documented tags", () => {
-    assert.equal(bold("x").html, "<b>x</b>");
-    assert.equal(link("https://yaeb.al", "docs").html, '<a href="https://yaeb.al">docs</a>');
-});
-test("block builders compose into a document", () => {
-    const input = document([
-        heading(1, "title"),
-        paragraph("hello ", bold("world")),
-        list([item(["a"]), item(["b"], { checkbox: true, checked: true })]),
-        details("more", [paragraph("hidden")], { open: false }),
-    ]);
-    assert.equal(input.html, "<h1>title</h1>" +
-        "<p>hello <b>world</b></p>" +
-        '<ul><li>a</li><li><input type="checkbox" checked/> b</li></ul>' +
-        "<details><summary>more</summary><p>hidden</p></details>");
-});
-test("table() and cell() render alignment attributes telegram's schema documents", () => {
-    const node = table([
-        [cell("a", { header: true, align: "center" }), cell("b", { valign: "middle" })],
-    ]);
-    assert.equal(node.html, '<table><tr><th align="center">a</th><td valign="middle">b</td></tr></table>');
-});
-test("image() wraps caption/credit in figure/figcaption/cite", () => {
-    const node = image("https://example.com/x.jpg", { caption: "a cat", credit: "photographer" });
-    assert.equal(node.html, '<figure><img src="https://example.com/x.jpg"></img><figcaption>a cat<cite>photographer</cite></figcaption></figure>');
-});
-test("thinking() is exposed for draft-only use", () => {
-    assert.equal(thinking("…").html, "<tg-thinking>…</tg-thinking>");
-});
+import { mockApi } from "@yaebal/test";
+import { bold, document, md, paragraph, RichMessageDraft, rich, sendRichMessage, sendRichMessageDraft, } from "./index.js";
+// integration-level coverage for the parts that tie the package together: the raw
+// send/draft functions, and the `rich()` plugin's ctx decoration. per-builder output
+// (blocks.test.ts/inline.test.ts/markdown.test.ts), guards (guards.test.ts),
+// plaintext flattening (plaintext.test.ts), and RichMessageDraft's rewrite/write/send
+// state machine (draft.test.ts) all have their own dedicated test files.
 test("sendRichMessage posts chat_id + rich_message to the raw api", async () => {
-    const api = mockApi();
+    const { api, calls } = mockApi();
     await sendRichMessage(api, 42, document([paragraph("hi")]), { reply_markup: { x: 1 } });
-    assert.deepEqual(api.calls, [
-        [
-            "sendRichMessage",
-            { chat_id: 42, rich_message: { html: "<p>hi</p>" }, reply_markup: { x: 1 } },
-        ],
-    ]);
+    assert.equal(calls[0]?.method, "sendRichMessage");
+    assert.deepEqual(calls[0]?.params, {
+        chat_id: 42,
+        rich_message: { html: "<p>hi</p>" },
+        reply_markup: { x: 1 },
+    });
+});
+test("sendRichMessage unwraps a markdown RichDocument with its fluent flags", async () => {
+    const { api, calls } = mockApi();
+    await sendRichMessage(api, 42, md `# hi ${bold("there")}`.rtl());
+    assert.equal(calls[0]?.method, "sendRichMessage");
+    assert.deepEqual(calls[0]?.params, {
+        chat_id: 42,
+        rich_message: { markdown: "# hi **there**", is_rtl: true },
+    });
 });
 test("sendRichMessageDraft posts draft_id alongside chat_id + rich_message", async () => {
-    const api = mockApi();
+    const { api, calls } = mockApi();
     await sendRichMessageDraft(api, 42, 7, "<tg-thinking>…</tg-thinking>");
-    assert.deepEqual(api.calls, [
-        [
-            "sendRichMessageDraft",
-            { chat_id: 42, draft_id: 7, rich_message: { html: "<tg-thinking>…</tg-thinking>" } },
-        ],
-    ]);
+    assert.equal(calls[0]?.method, "sendRichMessageDraft");
+    assert.deepEqual(calls[0]?.params, {
+        chat_id: 42,
+        draft_id: 7,
+        rich_message: { html: "<tg-thinking>…</tg-thinking>" },
+    });
 });
-test("rich() plugin decorates ctx.sendRichMessage bound to the current chat", async () => {
-    const api = mockApi();
+test("rich() plugin decorates ctx.sendRichMessage/ctx.richMessageDraft bound to the current chat", async () => {
+    const { api, calls } = mockApi();
     const composer = new Composer().install(rich());
     const ctx = new Context({
         api,
@@ -79,52 +51,50 @@ test("rich() plugin decorates ctx.sendRichMessage bound to the current chat", as
     await composer.toMiddleware()(ctx, async () => { });
     const decorated = ctx;
     await decorated.sendRichMessage(document([paragraph("hi")]));
-    assert.deepEqual(api.calls[0], [
-        "sendRichMessage",
-        { chat_id: 5, rich_message: { html: "<p>hi</p>" } },
-    ]);
+    assert.equal(calls[0]?.method, "sendRichMessage");
+    assert.deepEqual(calls[0]?.params, { chat_id: 5, rich_message: { html: "<p>hi</p>" } });
     const draft = decorated.richMessageDraft(1);
     assert.ok(draft instanceof RichMessageDraft);
 });
-test("RichMessageDraft.push() re-arms a keep-alive timer and commit() stops it", async () => {
-    const api = mockApi();
-    const draft = new RichMessageDraft(api, 1, 1, { keepAliveMs: 60_000 });
-    await draft.push(thinking("…"));
-    assert.equal(api.calls[0]?.[0], "sendRichMessageDraft");
-    await draft.commit(document([paragraph("done")]));
-    assert.equal(api.calls[1]?.[0], "sendRichMessage");
-    assert.equal(draft.closed, true);
-    await assert.rejects(() => draft.push("late"), /after commit\(\)\/cancel\(\)/);
-});
-test("RichMessageDraft.cancel() closes without persisting", async () => {
-    const api = mockApi();
-    const draft = new RichMessageDraft(api, 1, 2);
-    await draft.push("draft text");
-    draft.cancel();
-    assert.equal(draft.closed, true);
-    assert.equal(api.calls.some(([method]) => method === "sendRichMessage"), false);
-});
-test("guards narrow RichBlock by .type despite the generated field being `string`", () => {
-    const blocks = [
-        { type: "table", cells: [[{ text: "x", align: "left", valign: "top" }]] },
-        { type: "photo", photo: [] },
-    ];
-    assert.equal(isTable(blocks[0]), true);
-    assert.equal(isPhoto(blocks[1]), true);
-    assert.equal(isTable(blocks[1]), false);
-});
-test("richMessageToPlainText flattens a full block tree", () => {
-    const message = {
-        blocks: [
-            { type: "heading", text: "title", size: 1 },
-            { type: "paragraph", text: [{ type: "bold", text: "hi" }, " there"] },
-            { type: "divider" },
-            {
-                type: "list",
-                items: [{ label: "1", blocks: [{ type: "paragraph", text: "one" }] }],
+test("rich() plugin routes ctx.sendRichMessage through the business connection/topic", async () => {
+    const { api, calls } = mockApi();
+    const composer = new Composer().install(rich());
+    const ctx = new Context({
+        api,
+        update: {
+            update_id: 1,
+            business_message: {
+                message_id: 1,
+                date: 0,
+                chat: { id: 5, type: "private" },
+                business_connection_id: "bc1",
+                message_thread_id: 9,
             },
-        ],
-    };
-    assert.equal(richMessageToPlainText(message), "title\nhi there\n---\n- one");
+        },
+        updateType: "business_message",
+    });
+    await composer.toMiddleware()(ctx, async () => { });
+    const decorated = ctx;
+    await decorated.sendRichMessage(document([paragraph("hi")]));
+    assert.equal(calls[0]?.method, "sendRichMessage");
+    assert.deepEqual(calls[0]?.params, {
+        chat_id: 5,
+        rich_message: { html: "<p>hi</p>" },
+        business_connection_id: "bc1",
+        message_thread_id: 9,
+    });
+});
+test("sendRichMessage()/richMessageDraft() reject when the update has no chat", async () => {
+    const { api } = mockApi();
+    const composer = new Composer().install(rich());
+    const ctx = new Context({
+        api,
+        update: { update_id: 1 },
+        updateType: "message",
+    });
+    await composer.toMiddleware()(ctx, async () => { });
+    const decorated = ctx;
+    await assert.rejects(() => decorated.sendRichMessage("x"), /no chat in this update/);
+    assert.throws(() => decorated.richMessageDraft(1), /no chat in this update/);
 });
 //# sourceMappingURL=index.test.js.map

package/lib/index.test.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.test.js","sourceRoot":"","sources":["../src/index.test.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,oBAAoB,CAAC;AACxC,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAY,QAAQ,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAE3D,OAAO,EACN,IAAI,EACJ,IAAI,EACJ,OAAO,EACP,QAAQ,EACR,OAAO,EACP,IAAI,EACJ,KAAK,EACL,OAAO,EACP,OAAO,EACP,IAAI,EACJ,IAAI,EACJ,IAAI,EACJ,SAAS,EACT,gBAAgB,EAChB,IAAI,EACJ,sBAAsB,EACtB,eAAe,EACf,oBAAoB,EACpB,KAAK,EACL,QAAQ,GACR,MAAM,YAAY,CAAC;AAEpB,SAAS,OAAO;IACf,MAAM,KAAK,GAAoD,EAAE,CAAC;IAElE,OAAO;QACN,KAAK;QACL,IAAI,EAAE,KAAK,EAAE,MAAc,EAAE,MAAgC,EAAE,EAAE;YAChE,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;YAC7B,OAAO,EAAW,CAAC;QACpB,CAAC;KAC8E,CAAC;AAClF,CAAC;AAED,IAAI,CAAC,gEAAgE,EAAE,GAAG,EAAE;IAC3E,MAAM,IAAI,GAAG,IAAI,CAAA,SAAS,YAAY,MAAM,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC;IAE/D,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,gDAAgD,CAAC,CAAC;AAC3E,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,0CAA0C,EAAE,GAAG,EAAE;IACrD,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;IACzC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,iBAAiB,EAAE,MAAM,CAAC,CAAC,IAAI,EAAE,oCAAoC,CAAC,CAAC;AAC1F,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,wCAAwC,EAAE,GAAG,EAAE;IACnD,MAAM,KAAK,GAAG,QAAQ,CAAC;QACtB,OAAO,CAAC,CAAC,EAAE,OAAO,CAAC;QACnB,SAAS,CAAC,QAAQ,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;QAClC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,GAAG,CAAC,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;QACnE,OAAO,CAAC,MAAM,EAAE,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;KACvD,CAAC,CAAC;IAEH,MAAM,CAAC,KAAK,CACX,KAAK,CAAC,IAAI,EACV,gBAAgB;QACf,2BAA2B;QAC3B,gEAAgE;QAChE,yDAAyD,CAC1D,CAAC;AACH,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,4EAA4E,EAAE,GAAG,EAAE;IACvF,MAAM,IAAI,GAAG,KAAK,CAAC;QAClB,CAAC,IAAI,CAAC,GAAG,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,CAAC;KAC/E,CAAC,CAAC;IAEH,MAAM,CAAC,KAAK,CACX,IAAI,CAAC,IAAI,EACT,6EAA6E,CAC7E,CAAC;AACH,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,wDAAwD,EAAE,GAAG,EAAE;IACnE,MAAM,IAAI,GAAG,KAAK,CAAC,2BAA2B,EAAE,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,CAAC,CAAC;IAE9F,MAAM,CAAC,KAAK,CACX,IAAI,CAAC,IAAI,EACT,qHAAqH,CACrH,CAAC;AACH,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,0CAA0C,EAAE,GAAG,EAAE;IACrD,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,8BAA8B,CAAC,CAAC;AAClE,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,6DAA6D,EAAE,KAAK,IAAI,EAAE;IAC9E,MAAM,GAAG,GAAG,OAAO,EAAE,CAAC;IAEtB,MAAM,eAAe,CAAC,GAAG,EAAE,EAAE,EAAE,QAAQ,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,YAAY,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;IAExF,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,EAAE;QAC3B;YACC,iBAAiB;YACjB,EAAE,OAAO,EAAE,EAAE,EAAE,YAAY,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,EAAE,YAAY,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE;SAC5E;KACD,CAAC,CAAC;AACJ,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,sEAAsE,EAAE,KAAK,IAAI,EAAE;IACvF,MAAM,GAAG,GAAG,OAAO,EAAE,CAAC;IAEtB,MAAM,oBAAoB,CAAC,GAAG,EAAE,EAAE,EAAE,CAAC,EAAE,8BAA8B,CAAC,CAAC;IAEvE,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,EAAE;QAC3B;YACC,sBAAsB;YACtB,EAAE,OAAO,EAAE,EAAE,EAAE,QAAQ,EAAE,CAAC,EAAE,YAAY,EAAE,EAAE,IAAI,EAAE,8BAA8B,EAAE,EAAE;SACpF;KACD,CAAC,CAAC;AACJ,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,uEAAuE,EAAE,KAAK,IAAI,EAAE;IACxF,MAAM,GAAG,GAAG,OAAO,EAAE,CAAC;IACtB,MAAM,QAAQ,GAAG,IAAI,QAAQ,EAAE,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;IAEhD,MAAM,GAAG,GAAG,IAAI,OAAO,CAAC;QACvB,GAAG;QACH,MAAM,EAAE;YACP,SAAS,EAAE,CAAC;YACZ,OAAO,EAAE,EAAE,UAAU,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,EAAE,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE;SAC5D;QACV,UAAU,EAAE,SAAS;KACrB,CAAC,CAAC;IAEH,MAAM,QAAQ,CAAC,YAAY,EAAE,CAAC,GAAY,EAAE,KAAK,IAAI,EAAE,GAAE,CAAC,CAAC,CAAC;IAE5D,MAAM,SAAS,GAAG,GAGjB,CAAC;IAEF,MAAM,SAAS,CAAC,eAAe,CAAC,QAAQ,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;IAC7D,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE;QAC9B,iBAAiB;QACjB,EAAE,OAAO,EAAE,CAAC,EAAE,YAAY,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,EAAE;KACnD,CAAC,CAAC;IAEH,MAAM,KAAK,GAAG,SAAS,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC;IAC5C,MAAM,CAAC,EAAE,CAAC,KAAK,YAAY,gBAAgB,CAAC,CAAC;AAC9C,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,0EAA0E,EAAE,KAAK,IAAI,EAAE;IAC3F,MAAM,GAAG,GAAG,OAAO,EAAE,CAAC;IACtB,MAAM,KAAK,GAAG,IAAI,gBAAgB,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,WAAW,EAAE,MAAM,EAAE,CAAC,CAAC;IAEvE,MAAM,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC;IAChC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,sBAAsB,CAAC,CAAC;IAExD,MAAM,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;IAClD,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,iBAAiB,CAAC,CAAC;IACnD,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IAEjC,MAAM,MAAM,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,8BAA8B,CAAC,CAAC;AAChF,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,qDAAqD,EAAE,KAAK,IAAI,EAAE;IACtE,MAAM,GAAG,GAAG,OAAO,EAAE,CAAC;IACtB,MAAM,KAAK,GAAG,IAAI,gBAAgB,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;IAE9C,MAAM,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IAC/B,KAAK,CAAC,MAAM,EAAE,CAAC;IAEf,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IACjC,MAAM,CAAC,KAAK,CACX,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC,MAAM,KAAK,iBAAiB,CAAC,EAC1D,KAAK,CACL,CAAC;AACH,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,6EAA6E,EAAE,GAAG,EAAE;IACxF,MAAM,MAAM,GAAG;QACd,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC,EAAE;QACzE,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE;KACF,CAAC;IAE5B,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAc,CAAC,EAAE,IAAI,CAAC,CAAC;IACpD,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAc,CAAC,EAAE,IAAI,CAAC,CAAC;IACpD,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAc,CAAC,EAAE,KAAK,CAAC,CAAC;AACtD,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,mDAAmD,EAAE,GAAG,EAAE;IAC9D,MAAM,OAAO,GAAG;QACf,MAAM,EAAE;YACP,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,EAAE;YAC3C,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,QAAQ,CAAC,EAAE;YACrE,EAAE,IAAI,EAAE,SAAS,EAAE;YACnB;gBACC,IAAI,EAAE,MAAM;gBACZ,KAAK,EAAE,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC;aACrE;SACD;KACyB,CAAC;IAE5B,MAAM,CAAC,KAAK,CAAC,sBAAsB,CAAC,OAAO,CAAC,EAAE,6BAA6B,CAAC,CAAC;AAC9E,CAAC,CAAC,CAAC"}
+{"version":3,"file":"index.test.js","sourceRoot":"","sources":["../src/index.test.ts"],"names":[],"mappings":"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"}

package/lib/inline.d.ts

@@ -1,79 +1,68 @@
 import type { User } from "@yaebal/core";
+import { type RichNode } from "./node.js";
+import { type Insertable } from "./render.js";
+/** `RichTextBold` — `<b>` / `**x**`. */
+export declare const bold: (...items: Insertable[]) => RichNode;
+/** `RichTextItalic` — `<i>` / `*x*`. */
+export declare const italic: (...items: Insertable[]) => RichNode;
+/** `RichTextUnderline` — `<u>`; no markdown token, the raw tag is embedded there too. */
+export declare const underline: (...items: Insertable[]) => RichNode;
+/** `RichTextStrikethrough` — `<s>` / `~~x~~`. */
+export declare const strikethrough: (...items: Insertable[]) => RichNode;
+/** `RichTextSpoiler` — `<tg-spoiler>` / `||x||`. */
+export declare const spoiler: (...items: Insertable[]) => RichNode;
+/** `RichTextCode` — `<code>` / `` `x` ``. */
+export declare const code: (...items: Insertable[]) => RichNode;
+/** line break — hard newline in markdown, `<br/>` in html. */
+export declare function br(): RichNode;
 /**
- * a fragment of the extended html telegram parses into a `RichMessage` (see
- * `InputRichMessage.html`). unlike `@yaebal/fmt`'s `FormatResult` (a flat
- * `{ text, entities }` pair), rich messages are a block tree parsed server-side —
- * there is nothing to build client-side except this html string.
- */
-export interface RichNode {
-    readonly html: string;
-}
-export type Insertable = RichNode | string | number | bigint | boolean | null | undefined;
-export declare function isRichNode(value: unknown): value is RichNode;
-/** render one interpolation: a `RichNode` is spliced raw, anything else is escaped text. */
-export declare function toHtml(value: Insertable): string;
-/**
- * an extended-html template: interpolations are auto-escaped (never re-parsed as
- * markup), and a nested `RichNode` (from these builders, or another `html`
- * template) is spliced in raw. mirrors `@yaebal/fmt`'s `html` tag, but for the
- * rich-message dialect instead of the classic entity one.
- */
-export declare function html(strings: TemplateStringsArray, ...subs: Insertable[]): RichNode;
-/** `RichTextBold`, `<b>`. */
-export declare const bold: (...children: Insertable[]) => RichNode;
-/** `RichTextItalic`, `<i>`. */
-export declare const italic: (...children: Insertable[]) => RichNode;
-/** `RichTextUnderline`, `<u>`. */
-export declare const underline: (...children: Insertable[]) => RichNode;
-/** `RichTextStrikethrough`, `<s>`. */
-export declare const strikethrough: (...children: Insertable[]) => RichNode;
-/** `RichTextSpoiler`, `<tg-spoiler>`. */
-export declare const spoiler: (...children: Insertable[]) => RichNode;
-/** `RichTextCode`, `<code>`. */
-export declare const code: (...children: Insertable[]) => RichNode;
-/**
- * `RichTextCustomEmoji`, `<tg-emoji emoji-id="…">`. same custom tag classic
- * `parse_mode: "HTML"` uses for custom emoji — telegram documents it as reused
- * verbatim here. `fallback` is the plain emoji shown where custom emoji can't render.
+ * `RichTextCustomEmoji` — `<tg-emoji emoji-id="…">`, the same custom tag classic
+ * `parse_mode: "HTML"` uses (telegram documents it as reused verbatim here);
+ * best-effort `![fallback](tg://emoji?id=…)` in markdown. `fallback` is the
+ * plain emoji shown where custom emoji can't render.
  */
 export declare function customEmoji(emojiId: string, fallback: string): RichNode;
+/** `RichTextUrl`, an explicit link. for a bare auto-linked url, just write it as plain text. */
+export declare function link(url: string, ...items: Insertable[]): RichNode;
 /**
- * `RichTextTextMention`, a mention of a user who may have no `@username` — same
- * `tg://user?id=…` link telegram's classic html dialect uses for `text_mention`.
+ * `RichTextTextMention`, a mention of a user who may have no `@username` — the
+ * same `tg://user?id=…` link telegram's classic dialects use for `text_mention`.
  * for `@username` mentions (`RichTextMention`), just write `@username` as plain
- * text — the schema lists it as auto-detected (see `skipEntityDetection`).
+ * text — the schema lists it as auto-detected (see `noEntityDetection`).
  */
-export declare function textMention(user: Pick<User, "id">, ...children: Insertable[]): RichNode;
-/** `RichTextUrl`, an explicit link. for a bare auto-linked url, just write it as plain text. */
-export declare function link(url: string, ...children: Insertable[]): RichNode;
-/** `RichTextAnchor` (inline form) — a named jump target, `<a name="…">`. */
+export declare function textMention(user: Pick<User, "id">, ...items: Insertable[]): RichNode;
+/** `RichTextAnchor` (inline form) — a named jump target, `<a name="…">` in both dialects. */
 export declare function anchor(name: string): RichNode;
 /**
  * `RichTextAnchorLink`, a link to an `anchor()` elsewhere in the message —
- * `<a href="#name">`. an empty `name` jumps back to the top (per the schema).
+ * `<a href="#name">` / `[text](#name)`. an empty `name` jumps back to the top
+ * (per the schema).
  */
-export declare function anchorLink(name: string, ...children: Insertable[]): RichNode;
-/** `RichTextMarked`, best-effort `<mark>` (standard html5 highlight). */
-export declare const marked: (...children: Insertable[]) => RichNode;
-/** `RichTextSubscript`, best-effort `<sub>`. */
-export declare const subscript: (...children: Insertable[]) => RichNode;
-/** `RichTextSuperscript`, best-effort `<sup>`. */
-export declare const superscript: (...children: Insertable[]) => RichNode;
+export declare function anchorLink(name: string, ...items: Insertable[]): RichNode;
+/** `RichTextMarked`, highlighted text — best-effort `<mark>` / `==x==`. */
+export declare const marked: (...items: Insertable[]) => RichNode;
+/** `RichTextSubscript` — best-effort `<sub>`; no markdown token, raw tag embedded there too. */
+export declare const subscript: (...items: Insertable[]) => RichNode;
+/** `RichTextSuperscript` — best-effort `<sup>`; no markdown token, raw tag embedded there too. */
+export declare const superscript: (...items: Insertable[]) => RichNode;
 /**
- * `RichTextMathematicalExpression` (inline), best-effort `<tg-math>` (the block
- * form is confirmed as `<tg-math-block>` — see `mathBlock` in blocks.ts).
+ * `RichTextMathematicalExpression` (inline) — best-effort `<tg-math>` / `$x$`
+ * (the block form is confirmed as `<tg-math-block>` — see `mathBlock` in
+ * blocks.ts). `expression` is raw LaTeX — not markdown-escaped.
  */
 export declare function math(expression: string): RichNode;
 /**
- * `RichTextDateTime`, best-effort `<time>`. `format` is telegram's date-time
- * entity format string; attribute name is a guess (`data-format`).
+ * `RichTextDateTime`, auto-formatted date-time — best-effort `<time>` (attribute
+ * name `data-format` is a guess) / `![label](tg://time?unix=…&format=…)`.
+ * `format` is telegram's date-time entity format string.
  */
-export declare function dateTime(unixTime: number, format: string, ...children: Insertable[]): RichNode;
+export declare function dateTime(unixTime: number, format: string, ...items: Insertable[]): RichNode;
 /**
  * `RichTextReference`, a footnote definition. no tag is documented anywhere in
- * the scraped schema — this is a from-scratch `tg-*`-style guess.
+ * the scraped schema — `<tg-reference>` is a from-scratch `tg-*`-style guess,
+ * `[^name]: …` the standard markdown footnote line (place it at line start).
  */
-export declare function reference(name: string, ...children: Insertable[]): RichNode;
-/** `RichTextReferenceLink`, a link to a `reference()`. same caveat as `reference`. */
-export declare function referenceLink(name: string, ...children: Insertable[]): RichNode;
+export declare function reference(name: string, ...items: Insertable[]): RichNode;
+/** `RichTextReferenceLink`, a link to a `reference()` — same caveat as `reference`. */
+export declare function referenceLink(name: string, ...items: Insertable[]): RichNode;
 //# sourceMappingURL=inline.d.ts.map

package/lib/inline.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"inline.d.ts","sourceRoot":"","sources":["../src/inline.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC;AAGzC;;;;;GAKG;AACH,MAAM,WAAW,QAAQ;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,MAAM,UAAU,GAAG,QAAQ,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,GAAG,SAAS,CAAC;AAE1F,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,QAAQ,CAI5D;AAED,4FAA4F;AAC5F,wBAAgB,MAAM,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,CAGhD;AAUD;;;;;GAKG;AACH,wBAAgB,IAAI,CAAC,OAAO,EAAE,oBAAoB,EAAE,GAAG,IAAI,EAAE,UAAU,EAAE,GAAG,QAAQ,CASnF;AAID,6BAA6B;AAC7B,eAAO,MAAM,IAAI,gBAvBK,UAAU,EAAE,KAAG,QAuBR,CAAC;AAC9B,+BAA+B;AAC/B,eAAO,MAAM,MAAM,gBAzBG,UAAU,EAAE,KAAG,QAyBN,CAAC;AAChC,kCAAkC;AAClC,eAAO,MAAM,SAAS,gBA3BA,UAAU,EAAE,KAAG,QA2BH,CAAC;AACnC,sCAAsC;AACtC,eAAO,MAAM,aAAa,gBA7BJ,UAAU,EAAE,KAAG,QA6BC,CAAC;AACvC,yCAAyC;AACzC,eAAO,MAAM,OAAO,gBA/BE,UAAU,EAAE,KAAG,QA+BI,CAAC;AAC1C,gCAAgC;AAChC,eAAO,MAAM,IAAI,gBAjCK,UAAU,EAAE,KAAG,QAiCL,CAAC;AAEjC;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,QAAQ,CAEvE;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE,GAAG,QAAQ,EAAE,UAAU,EAAE,GAAG,QAAQ,CAEvF;AAED,gGAAgG;AAChG,wBAAgB,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,QAAQ,EAAE,UAAU,EAAE,GAAG,QAAQ,CAErE;AAED,4EAA4E;AAC5E,wBAAgB,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,CAE7C;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,QAAQ,EAAE,UAAU,EAAE,GAAG,QAAQ,CAE5E;AAWD,yEAAyE;AACzE,eAAO,MAAM,MAAM,gBAlFG,UAAU,EAAE,KAAG,QAkFH,CAAC;AACnC,gDAAgD;AAChD,eAAO,MAAM,SAAS,gBApFA,UAAU,EAAE,KAAG,QAoFD,CAAC;AACrC,kDAAkD;AAClD,eAAO,MAAM,WAAW,gBAtFF,UAAU,EAAE,KAAG,QAsFC,CAAC;AAEvC;;;GAGG;AACH,wBAAgB,IAAI,CAAC,UAAU,EAAE,MAAM,GAAG,QAAQ,CAEjD;AAED;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,QAAQ,EAAE,UAAU,EAAE,GAAG,QAAQ,CAI9F;AAED;;;GAGG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,QAAQ,EAAE,UAAU,EAAE,GAAG,QAAQ,CAE3E;AAED,sFAAsF;AACtF,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,QAAQ,EAAE,UAAU,EAAE,GAAG,QAAQ,CAI/E"}
+{"version":3,"file":"inline.d.ts","sourceRoot":"","sources":["../src/inline.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC;AAEzC,OAAO,EAA0B,KAAK,QAAQ,EAAE,MAAM,WAAW,CAAC;AAClE,OAAO,EAAa,KAAK,UAAU,EAAU,MAAM,aAAa,CAAC;AAkBjE,wCAAwC;AACxC,eAAO,MAAM,IAAI,aAPE,UAAU,EAAE,KAAG,QAUjC,CAAC;AACF,wCAAwC;AACxC,eAAO,MAAM,MAAM,aAZA,UAAU,EAAE,KAAG,QAejC,CAAC;AACF,yFAAyF;AACzF,eAAO,MAAM,SAAS,aAjBH,UAAU,EAAE,KAAG,QAoBjC,CAAC;AACF,iDAAiD;AACjD,eAAO,MAAM,aAAa,aAtBP,UAAU,EAAE,KAAG,QAyBjC,CAAC;AACF,oDAAoD;AACpD,eAAO,MAAM,OAAO,aA3BD,UAAU,EAAE,KAAG,QA8BjC,CAAC;AACF,6CAA6C;AAC7C,eAAO,MAAM,IAAI,aAhCE,UAAU,EAAE,KAAG,QAmCjC,CAAC;AAEF,8DAA8D;AAC9D,wBAAgB,EAAE,IAAI,QAAQ,CAE7B;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,QAAQ,CAMvE;AAQD,gGAAgG;AAChG,wBAAgB,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,KAAK,EAAE,UAAU,EAAE,GAAG,QAAQ,CAMlE;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE,GAAG,KAAK,EAAE,UAAU,EAAE,GAAG,QAAQ,CAEpF;AAED,6FAA6F;AAC7F,wBAAgB,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,CAE7C;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,KAAK,EAAE,UAAU,EAAE,GAAG,QAAQ,CAMzE;AAWD,2EAA2E;AAC3E,eAAO,MAAM,MAAM,aA7GA,UAAU,EAAE,KAAG,QAgHjC,CAAC;AACF,gGAAgG;AAChG,eAAO,MAAM,SAAS,aAlHH,UAAU,EAAE,KAAG,QAqHjC,CAAC;AACF,kGAAkG;AAClG,eAAO,MAAM,WAAW,aAvHL,UAAU,EAAE,KAAG,QA0HjC,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,IAAI,CAAC,UAAU,EAAE,MAAM,GAAG,QAAQ,CAIjD;AAED;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,KAAK,EAAE,UAAU,EAAE,GAAG,QAAQ,CAQ3F;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,KAAK,EAAE,UAAU,EAAE,GAAG,QAAQ,CAMxE;AAED,uFAAuF;AACvF,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,KAAK,EAAE,UAAU,EAAE,GAAG,QAAQ,CAM5E"}