@yaebal/rich 0.0.1

package/lib/guards.d.ts

@@ -0,0 +1,106 @@
+import type { RichBlock, RichBlockAnchor, RichBlockAnimation, RichBlockAudio, RichBlockBlockQuotation, RichBlockCollage, RichBlockDetails, RichBlockDivider, RichBlockFooter, RichBlockList, RichBlockMap, RichBlockMathematicalExpression, RichBlockParagraph, RichBlockPhoto, RichBlockPreformatted, RichBlockPullQuotation, RichBlockSectionHeading, RichBlockSlideshow, RichBlockTable, RichBlockThinking, RichBlockVideo, RichBlockVoiceNote, 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 } from "@yaebal/types";
+/**
+ * the generated `.type` field is typed as plain `string` (the codegen doesn't turn
+ * telegram's "always X" doc convention into a literal type), so `RichBlock["type"]`
+ * can't discriminate the union on its own — `Extract<RichBlock, { type: "table" }>`
+ * would just be `never`. this lookup map is the narrowing telescope instead: one
+ * entry per `.type` string, hand-matched to its interface.
+ */
+interface RichBlockByType {
+    paragraph: RichBlockParagraph;
+    heading: RichBlockSectionHeading;
+    pre: RichBlockPreformatted;
+    footer: RichBlockFooter;
+    divider: RichBlockDivider;
+    mathematical_expression: RichBlockMathematicalExpression;
+    anchor: RichBlockAnchor;
+    list: RichBlockList;
+    blockquote: RichBlockBlockQuotation;
+    pullquote: RichBlockPullQuotation;
+    collage: RichBlockCollage;
+    slideshow: RichBlockSlideshow;
+    table: RichBlockTable;
+    details: RichBlockDetails;
+    map: RichBlockMap;
+    animation: RichBlockAnimation;
+    audio: RichBlockAudio;
+    photo: RichBlockPhoto;
+    video: RichBlockVideo;
+    voice_note: RichBlockVoiceNote;
+    thinking: RichBlockThinking;
+}
+interface RichTextByType {
+    bold: RichTextBold;
+    italic: RichTextItalic;
+    underline: RichTextUnderline;
+    strikethrough: RichTextStrikethrough;
+    spoiler: RichTextSpoiler;
+    date_time: RichTextDateTime;
+    text_mention: RichTextTextMention;
+    subscript: RichTextSubscript;
+    superscript: RichTextSuperscript;
+    marked: RichTextMarked;
+    code: RichTextCode;
+    custom_emoji: RichTextCustomEmoji;
+    mathematical_expression: RichTextMathematicalExpression;
+    url: RichTextUrl;
+    email_address: RichTextEmailAddress;
+    phone_number: RichTextPhoneNumber;
+    bank_card_number: RichTextBankCardNumber;
+    mention: RichTextMention;
+    hashtag: RichTextHashtag;
+    cashtag: RichTextCashtag;
+    bot_command: RichTextBotCommand;
+    anchor: RichTextAnchor;
+    anchor_link: RichTextAnchorLink;
+    reference: RichTextReference;
+    reference_link: RichTextReferenceLink;
+}
+export declare const isParagraph: (block: RichBlock) => block is RichBlockByType["paragraph"];
+export declare const isHeading: (block: RichBlock) => block is RichBlockByType["heading"];
+export declare const isPreformatted: (block: RichBlock) => block is RichBlockByType["pre"];
+export declare const isFooter: (block: RichBlock) => block is RichBlockByType["footer"];
+export declare const isDivider: (block: RichBlock) => block is RichBlockByType["divider"];
+export declare const isMathBlock: (block: RichBlock) => block is RichBlockByType["mathematical_expression"];
+export declare const isAnchorBlock: (block: RichBlock) => block is RichBlockByType["anchor"];
+export declare const isList: (block: RichBlock) => block is RichBlockByType["list"];
+export declare const isBlockquote: (block: RichBlock) => block is RichBlockByType["blockquote"];
+export declare const isPullquote: (block: RichBlock) => block is RichBlockByType["pullquote"];
+export declare const isCollage: (block: RichBlock) => block is RichBlockByType["collage"];
+export declare const isSlideshow: (block: RichBlock) => block is RichBlockByType["slideshow"];
+export declare const isTable: (block: RichBlock) => block is RichBlockByType["table"];
+export declare const isDetails: (block: RichBlock) => block is RichBlockByType["details"];
+export declare const isMap: (block: RichBlock) => block is RichBlockByType["map"];
+export declare const isAnimation: (block: RichBlock) => block is RichBlockByType["animation"];
+export declare const isAudio: (block: RichBlock) => block is RichBlockByType["audio"];
+export declare const isPhoto: (block: RichBlock) => block is RichBlockByType["photo"];
+export declare const isVideo: (block: RichBlock) => block is RichBlockByType["video"];
+export declare const isVoiceNote: (block: RichBlock) => block is RichBlockByType["voice_note"];
+export declare const isThinking: (block: RichBlock) => block is RichBlockByType["thinking"];
+export declare const isBold: (text: RichText) => text is RichTextByType["bold"];
+export declare const isItalic: (text: RichText) => text is RichTextByType["italic"];
+export declare const isUnderline: (text: RichText) => text is RichTextByType["underline"];
+export declare const isStrikethrough: (text: RichText) => text is RichTextByType["strikethrough"];
+export declare const isSpoilerText: (text: RichText) => text is RichTextByType["spoiler"];
+export declare const isDateTime: (text: RichText) => text is RichTextByType["date_time"];
+export declare const isTextMention: (text: RichText) => text is RichTextByType["text_mention"];
+export declare const isSubscript: (text: RichText) => text is RichTextByType["subscript"];
+export declare const isSuperscript: (text: RichText) => text is RichTextByType["superscript"];
+export declare const isMarked: (text: RichText) => text is RichTextByType["marked"];
+export declare const isCodeText: (text: RichText) => text is RichTextByType["code"];
+export declare const isCustomEmoji: (text: RichText) => text is RichTextByType["custom_emoji"];
+export declare const isMathText: (text: RichText) => text is RichTextByType["mathematical_expression"];
+export declare const isUrlText: (text: RichText) => text is RichTextByType["url"];
+export declare const isEmailAddress: (text: RichText) => text is RichTextByType["email_address"];
+export declare const isPhoneNumber: (text: RichText) => text is RichTextByType["phone_number"];
+export declare const isBankCardNumber: (text: RichText) => text is RichTextByType["bank_card_number"];
+export declare const isMentionText: (text: RichText) => text is RichTextByType["mention"];
+export declare const isHashtag: (text: RichText) => text is RichTextByType["hashtag"];
+export declare const isCashtag: (text: RichText) => text is RichTextByType["cashtag"];
+export declare const isBotCommand: (text: RichText) => text is RichTextByType["bot_command"];
+export declare const isAnchorText: (text: RichText) => text is RichTextByType["anchor"];
+export declare const isAnchorLink: (text: RichText) => text is RichTextByType["anchor_link"];
+export declare const isReference: (text: RichText) => text is RichTextByType["reference"];
+export declare const isReferenceLink: (text: RichText) => text is RichTextByType["reference_link"];
+export {};
+//# sourceMappingURL=guards.d.ts.map

package/lib/guards.d.ts.map

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

package/lib/guards.js

@@ -0,0 +1,55 @@
+function blockGuard(type) {
+    return (block) => block.type === type;
+}
+function textGuard(type) {
+    return (text) => text.type === type;
+}
+// --- RichBlock (21 variants) — one guard per `.type` discriminant ---
+export const isParagraph = blockGuard("paragraph");
+export const isHeading = blockGuard("heading");
+export const isPreformatted = blockGuard("pre");
+export const isFooter = blockGuard("footer");
+export const isDivider = blockGuard("divider");
+export const isMathBlock = blockGuard("mathematical_expression");
+export const isAnchorBlock = blockGuard("anchor");
+export const isList = blockGuard("list");
+export const isBlockquote = blockGuard("blockquote");
+export const isPullquote = blockGuard("pullquote");
+export const isCollage = blockGuard("collage");
+export const isSlideshow = blockGuard("slideshow");
+export const isTable = blockGuard("table");
+export const isDetails = blockGuard("details");
+export const isMap = blockGuard("map");
+export const isAnimation = blockGuard("animation");
+export const isAudio = blockGuard("audio");
+export const isPhoto = blockGuard("photo");
+export const isVideo = blockGuard("video");
+export const isVoiceNote = blockGuard("voice_note");
+export const isThinking = blockGuard("thinking");
+// --- RichText (25 variants) ---
+export const isBold = textGuard("bold");
+export const isItalic = textGuard("italic");
+export const isUnderline = textGuard("underline");
+export const isStrikethrough = textGuard("strikethrough");
+export const isSpoilerText = textGuard("spoiler");
+export const isDateTime = textGuard("date_time");
+export const isTextMention = textGuard("text_mention");
+export const isSubscript = textGuard("subscript");
+export const isSuperscript = textGuard("superscript");
+export const isMarked = textGuard("marked");
+export const isCodeText = textGuard("code");
+export const isCustomEmoji = textGuard("custom_emoji");
+export const isMathText = textGuard("mathematical_expression");
+export const isUrlText = textGuard("url");
+export const isEmailAddress = textGuard("email_address");
+export const isPhoneNumber = textGuard("phone_number");
+export const isBankCardNumber = textGuard("bank_card_number");
+export const isMentionText = textGuard("mention");
+export const isHashtag = textGuard("hashtag");
+export const isCashtag = textGuard("cashtag");
+export const isBotCommand = textGuard("bot_command");
+export const isAnchorText = textGuard("anchor");
+export const isAnchorLink = textGuard("anchor_link");
+export const isReference = textGuard("reference");
+export const isReferenceLink = textGuard("reference_link");
+//# sourceMappingURL=guards.js.map

package/lib/guards.js.map

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

package/lib/index.d.ts

@@ -0,0 +1,33 @@
+/**
+ * @yaebal/rich — telegram's `sendRichMessage` / `sendRichMessageDraft`.
+ *
+ * unlike classic `parse_mode`/entities (see `@yaebal/fmt`), a rich message is a
+ * block-tree document: you write extended html (or markdown) once, telegram
+ * 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.
+ * - **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.
+ * - **read**: type guards (guards.ts) and plain-text flattening (plaintext.ts)
+ *   cover every `RichBlock`/`RichText` variant telegram can hand back.
+ *
+ * a handful of inline/block tags have no "corresponding to the html tag …" note in
+ * the schema (marked, subscript, superscript, date_time, inline math, map,
+ * reference/reference_link, table borders) — those are flagged best-effort in
+ * their doc comments in inline.ts/blocks.ts. everything else is either a
+ * documented tag or (for url/email/phone/bank-card/@mention/#hashtag/$cashtag/
+ * /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 { 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 { richBlockToPlainText, richMessageToPlainText, richTextToPlainText } from "./plaintext.js";
+export { type RichContext, rich, sendRichMessage, sendRichMessageDraft, } from "./send.js";
+//# sourceMappingURL=index.d.ts.map

package/lib/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAIH,YAAY,EACX,gBAAgB,EAChB,uBAAuB,EACvB,SAAS,EACT,eAAe,EACf,kBAAkB,EAClB,cAAc,EACd,uBAAuB,EACvB,gBAAgB,EAChB,gBAAgB,EAChB,gBAAgB,EAChB,gBAAgB,EAChB,eAAe,EACf,aAAa,EACb,iBAAiB,EACjB,YAAY,EACZ,+BAA+B,EAC/B,kBAAkB,EAClB,cAAc,EACd,qBAAqB,EACrB,sBAAsB,EACtB,uBAAuB,EACvB,kBAAkB,EAClB,cAAc,EACd,kBAAkB,EAClB,iBAAiB,EACjB,cAAc,EACd,kBAAkB,EAClB,WAAW,EACX,QAAQ,EACR,cAAc,EACd,kBAAkB,EAClB,sBAAsB,EACtB,YAAY,EACZ,kBAAkB,EAClB,eAAe,EACf,YAAY,EACZ,mBAAmB,EACnB,gBAAgB,EAChB,oBAAoB,EACpB,eAAe,EACf,cAAc,EACd,cAAc,EACd,8BAA8B,EAC9B,eAAe,EACf,mBAAmB,EACnB,iBAAiB,EACjB,qBAAqB,EACrB,eAAe,EACf,qBAAqB,EACrB,iBAAiB,EACjB,mBAAmB,EACnB,mBAAmB,EACnB,iBAAiB,EACjB,WAAW,EACX,0BAA0B,EAC1B,qBAAqB,GACrB,MAAM,eAAe,CAAC;AAEvB,OAAO,EACN,WAAW,EACX,KAAK,EACL,UAAU,EACV,KAAK,OAAO,EACZ,IAAI,EACJ,OAAO,EACP,KAAK,cAAc,EACnB,OAAO,EACP,OAAO,EACP,MAAM,EACN,OAAO,EACP,KAAK,EACL,IAAI,EACJ,KAAK,eAAe,EACpB,KAAK,WAAW,EAChB,IAAI,EACJ,KAAK,UAAU,EACf,KAAK,YAAY,EACjB,GAAG,EACH,SAAS,EACT,SAAS,EACT,YAAY,EACZ,SAAS,EACT,SAAS,EACT,KAAK,gBAAgB,EACrB,KAAK,YAAY,EACjB,KAAK,EACL,QAAQ,EACR,KAAK,GACL,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,gBAAgB,EAAE,KAAK,uBAAuB,EAAE,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,EACJ,KAAK,UAAU,EACf,UAAU,EACV,MAAM,EACN,IAAI,EACJ,MAAM,EACN,IAAI,EACJ,KAAK,QAAQ,EACb,SAAS,EACT,aAAa,EACb,OAAO,EACP,aAAa,EACb,SAAS,EACT,WAAW,EACX,WAAW,EACX,MAAM,EACN,SAAS,GACT,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,KAAK,eAAe,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAExE,OAAO,EAAE,oBAAoB,EAAE,sBAAsB,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AACnG,OAAO,EACN,KAAK,WAAW,EAChB,IAAI,EACJ,eAAe,EACf,oBAAoB,GACpB,MAAM,WAAW,CAAC"}

package/lib/index.js

@@ -0,0 +1,32 @@
+/**
+ * @yaebal/rich — telegram's `sendRichMessage` / `sendRichMessageDraft`.
+ *
+ * unlike classic `parse_mode`/entities (see `@yaebal/fmt`), a rich message is a
+ * block-tree document: you write extended html (or markdown) once, telegram
+ * 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.
+ * - **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.
+ * - **read**: type guards (guards.ts) and plain-text flattening (plaintext.ts)
+ *   cover every `RichBlock`/`RichText` variant telegram can hand back.
+ *
+ * a handful of inline/block tags have no "corresponding to the html tag …" note in
+ * the schema (marked, subscript, superscript, date_time, inline math, map,
+ * reference/reference_link, table borders) — those are flagged best-effort in
+ * their doc comments in inline.ts/blocks.ts. everything else is either a
+ * 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 { 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 { richBlockToPlainText, richMessageToPlainText, richTextToPlainText } from "./plaintext.js";
+export { rich, sendRichMessage, sendRichMessageDraft, } from "./send.js";
+//# sourceMappingURL=index.js.map

package/lib/index.js.map

@@ -0,0 +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"}

package/lib/index.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.test.d.ts.map

package/lib/index.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.test.d.ts","sourceRoot":"","sources":["../src/index.test.ts"],"names":[],"mappings":""}

package/lib/index.test.js

@@ -0,0 +1,130 @@
+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>");
+});
+test("sendRichMessage posts chat_id + rich_message to the raw api", async () => {
+    const api = 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 } },
+        ],
+    ]);
+});
+test("sendRichMessageDraft posts draft_id alongside chat_id + rich_message", async () => {
+    const api = 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>" } },
+        ],
+    ]);
+});
+test("rich() plugin decorates ctx.sendRichMessage bound to the current chat", async () => {
+    const api = mockApi();
+    const composer = new Composer().install(rich());
+    const ctx = new Context({
+        api,
+        update: {
+            update_id: 1,
+            message: { message_id: 1, date: 0, chat: { id: 5, type: "private" } },
+        },
+        updateType: "message",
+    });
+    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>" } },
+    ]);
+    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" }] }],
+            },
+        ],
+    };
+    assert.equal(richMessageToPlainText(message), "title\nhi there\n---\n- one");
+});
+//# sourceMappingURL=index.test.js.map

package/lib/index.test.js.map

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

package/lib/inline.d.ts

@@ -0,0 +1,79 @@
+import type { User } from "@yaebal/core";
+/**
+ * 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.
+ */
+export declare function customEmoji(emojiId: string, fallback: string): 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`.
+ * for `@username` mentions (`RichTextMention`), just write `@username` as plain
+ * text — the schema lists it as auto-detected (see `skipEntityDetection`).
+ */
+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 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).
+ */
+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;
+/**
+ * `RichTextMathematicalExpression` (inline), best-effort `<tg-math>` (the block
+ * form is confirmed as `<tg-math-block>` — see `mathBlock` in blocks.ts).
+ */
+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`).
+ */
+export declare function dateTime(unixTime: number, format: string, ...children: Insertable[]): RichNode;
+/**
+ * `RichTextReference`, a footnote definition. no tag is documented anywhere in
+ * the scraped schema — this is a from-scratch `tg-*`-style guess.
+ */
+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;
+//# sourceMappingURL=inline.d.ts.map

package/lib/inline.d.ts.map

@@ -0,0 +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"}

package/lib/inline.js

@@ -0,0 +1,120 @@
+import { escapeAttr, escapeText } from "./escape.js";
+export function isRichNode(value) {
+    return (typeof value === "object" && value !== null && typeof value.html === "string");
+}
+/** render one interpolation: a `RichNode` is spliced raw, anything else is escaped text. */
+export function toHtml(value) {
+    if (isRichNode(value))
+        return value.html;
+    return value == null ? "" : escapeText(String(value));
+}
+function join(children) {
+    return children.map(toHtml).join("");
+}
+function wrap(tag) {
+    return (...children) => ({ html: `<${tag}>${join(children)}</${tag}>` });
+}
+/**
+ * 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 function html(strings, ...subs) {
+    let out = "";
+    for (let i = 0; i < strings.length; i++) {
+        out += strings[i] ?? "";
+        if (i < subs.length)
+            out += toHtml(subs[i]);
+    }
+    return { html: out };
+}
+// --- inline marks — confirmed tags (same dialect as classic parse_mode html) ---
+/** `RichTextBold`, `<b>`. */
+export const bold = wrap("b");
+/** `RichTextItalic`, `<i>`. */
+export const italic = wrap("i");
+/** `RichTextUnderline`, `<u>`. */
+export const underline = wrap("u");
+/** `RichTextStrikethrough`, `<s>`. */
+export const strikethrough = wrap("s");
+/** `RichTextSpoiler`, `<tg-spoiler>`. */
+export const spoiler = wrap("tg-spoiler");
+/** `RichTextCode`, `<code>`. */
+export const code = wrap("code");
+/**
+ * `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.
+ */
+export function customEmoji(emojiId, fallback) {
+    return { html: `<tg-emoji emoji-id="${escapeAttr(emojiId)}">${escapeText(fallback)}</tg-emoji>` };
+}
+/**
+ * `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`.
+ * for `@username` mentions (`RichTextMention`), just write `@username` as plain
+ * text — the schema lists it as auto-detected (see `skipEntityDetection`).
+ */
+export function textMention(user, ...children) {
+    return { html: `<a href="tg://user?id=${user.id}">${join(children)}</a>` };
+}
+/** `RichTextUrl`, an explicit link. for a bare auto-linked url, just write it as plain text. */
+export function link(url, ...children) {
+    return { html: `<a href="${escapeAttr(url)}">${join(children)}</a>` };
+}
+/** `RichTextAnchor` (inline form) — a named jump target, `<a name="…">`. */
+export function anchor(name) {
+    return { html: `<a name="${escapeAttr(name)}"></a>` };
+}
+/**
+ * `RichTextAnchorLink`, a link to an `anchor()` elsewhere in the message —
+ * `<a href="#name">`. an empty `name` jumps back to the top (per the schema).
+ */
+export function anchorLink(name, ...children) {
+    return { html: `<a href="#${escapeAttr(name)}">${join(children)}</a>` };
+}
+// --- inline marks — best-effort tags ---
+//
+// telegram's schema names these types and their fields, but (as scraped) does not
+// state an explicit "corresponding to the html tag …" for them the way it does for
+// bold/italic/code/etc above. the guesses below follow telegram's own pattern of
+// reusing standard html5 semantics (sub/sup/mark/time) or its `tg-*` custom-tag
+// convention — verify against the live "rich message formatting options" docs
+// before depending on the exact tag/attribute spelling in production.
+/** `RichTextMarked`, best-effort `<mark>` (standard html5 highlight). */
+export const marked = wrap("mark");
+/** `RichTextSubscript`, best-effort `<sub>`. */
+export const subscript = wrap("sub");
+/** `RichTextSuperscript`, best-effort `<sup>`. */
+export const superscript = wrap("sup");
+/**
+ * `RichTextMathematicalExpression` (inline), best-effort `<tg-math>` (the block
+ * form is confirmed as `<tg-math-block>` — see `mathBlock` in blocks.ts).
+ */
+export function math(expression) {
+    return { html: `<tg-math>${escapeText(expression)}</tg-math>` };
+}
+/**
+ * `RichTextDateTime`, best-effort `<time>`. `format` is telegram's date-time
+ * entity format string; attribute name is a guess (`data-format`).
+ */
+export function dateTime(unixTime, format, ...children) {
+    return {
+        html: `<time datetime="${unixTime}" data-format="${escapeAttr(format)}">${join(children)}</time>`,
+    };
+}
+/**
+ * `RichTextReference`, a footnote definition. no tag is documented anywhere in
+ * the scraped schema — this is a from-scratch `tg-*`-style guess.
+ */
+export function reference(name, ...children) {
+    return { html: `<tg-reference name="${escapeAttr(name)}">${join(children)}</tg-reference>` };
+}
+/** `RichTextReferenceLink`, a link to a `reference()`. same caveat as `reference`. */
+export function referenceLink(name, ...children) {
+    return {
+        html: `<tg-reference-link name="${escapeAttr(name)}">${join(children)}</tg-reference-link>`,
+    };
+}
+//# sourceMappingURL=inline.js.map