@yaebal/rich 0.0.1 → 0.0.3

package/lib/inline.js

@@ -1,78 +1,77 @@
-import { escapeAttr, escapeText } from "./escape.js";
-export function isRichNode(value) {
-    return (typeof value === "object" && value !== null && typeof value.html === "string");
+import { escapeAttr, escapeMarkdownUrl } from "./escape.js";
+import { makeNode } from "./node.js";
+import { escapeFor, render } from "./render.js";
+// every builder here returns a dialect-agnostic `RichNode` — the html/markdown
+// choice happens once, at the `html`/`md`/`document()` boundary. children render
+// lazily, so a node built from user input is safe in either dialect.
+function children(items, dialect) {
+    return items.map((item) => render(item, dialect)).join("");
 }
-/** 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 };
+// a wrapper mark: same shape in both dialects, differing only in the surrounding tokens.
+function wrap(md, html) {
+    return (...items) => makeNode("inline", (d) => (d === "markdown" ? md : html)(children(items, d)));
 }
 // --- 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");
+/** `RichTextBold` — `<b>` / `**x**`. */
+export const bold = wrap((x) => `**${x}**`, (x) => `<b>${x}</b>`);
+/** `RichTextItalic` — `<i>` / `*x*`. */
+export const italic = wrap((x) => `*${x}*`, (x) => `<i>${x}</i>`);
+/** `RichTextUnderline` — `<u>`; no markdown token, the raw tag is embedded there too. */
+export const underline = wrap((x) => `<u>${x}</u>`, (x) => `<u>${x}</u>`);
+/** `RichTextStrikethrough` — `<s>` / `~~x~~`. */
+export const strikethrough = wrap((x) => `~~${x}~~`, (x) => `<s>${x}</s>`);
+/** `RichTextSpoiler` — `<tg-spoiler>` / `||x||`. */
+export const spoiler = wrap((x) => `||${x}||`, (x) => `<tg-spoiler>${x}</tg-spoiler>`);
+/** `RichTextCode` — `<code>` / `` `x` ``. */
+export const code = wrap((x) => `\`${x}\``, (x) => `<code>${x}</code>`);
+/** line break — hard newline in markdown, `<br/>` in html. */
+export function br() {
+    return makeNode("inline", (d) => (d === "markdown" ? "\n" : "<br/>"));
+}
 /**
- * `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 function customEmoji(emojiId, fallback) {
-    return { html: `<tg-emoji emoji-id="${escapeAttr(emojiId)}">${escapeText(fallback)}</tg-emoji>` };
+    return makeNode("inline", (d) => d === "markdown"
+        ? `![${escapeFor(fallback, d)}](${escapeMarkdownUrl(`tg://emoji?id=${emojiId}`)})`
+        : `<tg-emoji emoji-id="${escapeAttr(emojiId)}">${escapeFor(fallback, d)}</tg-emoji>`);
+}
+// a markdown link destination: `[text](url)` is terminated by `)` or whitespace,
+// so the url must be escaped to keep an attacker-controlled value inside the link.
+function mdLink(text, url) {
+    return `[${text}](${escapeMarkdownUrl(url)})`;
+}
+/** `RichTextUrl`, an explicit link. for a bare auto-linked url, just write it as plain text. */
+export function link(url, ...items) {
+    return makeNode("inline", (d) => d === "markdown"
+        ? mdLink(children(items, d), url)
+        : `<a href="${escapeAttr(url)}">${children(items, d)}</a>`);
 }
 /**
- * `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 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>` };
+export function textMention(user, ...items) {
+    return link(`tg://user?id=${user.id}`, ...items);
 }
-/** `RichTextAnchor` (inline form) — a named jump target, `<a name="…">`. */
+/** `RichTextAnchor` (inline form) — a named jump target, `<a name="…">` in both dialects. */
 export function anchor(name) {
-    return { html: `<a name="${escapeAttr(name)}"></a>` };
+    return makeNode("inline", () => `<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).
+ * `<a href="#name">` / `[text](#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>` };
+export function anchorLink(name, ...items) {
+    return makeNode("inline", (d) => d === "markdown"
+        ? mdLink(children(items, d), `#${name}`)
+        : `<a href="#${escapeAttr(name)}">${children(items, d)}</a>`);
 }
 // --- inline marks — best-effort tags ---
 //
@@ -82,39 +81,45 @@ export function anchorLink(name, ...children) {
 // 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");
+/** `RichTextMarked`, highlighted text — best-effort `<mark>` / `==x==`. */
+export const marked = wrap((x) => `==${x}==`, (x) => `<mark>${x}</mark>`);
+/** `RichTextSubscript` — best-effort `<sub>`; no markdown token, raw tag embedded there too. */
+export const subscript = wrap((x) => `<sub>${x}</sub>`, (x) => `<sub>${x}</sub>`);
+/** `RichTextSuperscript` — best-effort `<sup>`; no markdown token, raw tag embedded there too. */
+export const superscript = wrap((x) => `<sup>${x}</sup>`, (x) => `<sup>${x}</sup>`);
 /**
- * `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 function math(expression) {
-    return { html: `<tg-math>${escapeText(expression)}</tg-math>` };
+    return makeNode("inline", (d) => d === "markdown" ? `$${expression}$` : `<tg-math>${escapeFor(expression, "html")}</tg-math>`);
 }
 /**
- * `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 function dateTime(unixTime, format, ...children) {
-    return {
-        html: `<time datetime="${unixTime}" data-format="${escapeAttr(format)}">${join(children)}</time>`,
-    };
+export function dateTime(unixTime, format, ...items) {
+    const query = `tg://time?unix=${unixTime}${format ? `&format=${format}` : ""}`;
+    return makeNode("inline", (d) => d === "markdown"
+        ? `![${children(items, d)}](${escapeMarkdownUrl(query)})`
+        : `<time datetime="${unixTime}" data-format="${escapeAttr(format)}">${children(items, d)}</time>`);
 }
 /**
  * `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 function reference(name, ...children) {
-    return { html: `<tg-reference name="${escapeAttr(name)}">${join(children)}</tg-reference>` };
+export function reference(name, ...items) {
+    return makeNode("inline", (d) => d === "markdown"
+        ? `[^${name}]: ${children(items, d)}`
+        : `<tg-reference name="${escapeAttr(name)}">${children(items, d)}</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>`,
-    };
+/** `RichTextReferenceLink`, a link to a `reference()` — same caveat as `reference`. */
+export function referenceLink(name, ...items) {
+    return makeNode("inline", (d) => d === "markdown"
+        ? `[^${name}]`
+        : `<tg-reference-link name="${escapeAttr(name)}">${children(items, d)}</tg-reference-link>`);
 }
 //# sourceMappingURL=inline.js.map

package/lib/inline.js.map

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

package/lib/inline.test.d.ts

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

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

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

package/lib/inline.test.js

@@ -0,0 +1,84 @@
+import assert from "node:assert/strict";
+import test from "node:test";
+import { anchor, anchorLink, bold, br, code, customEmoji, dateTime, italic, link, marked, math, reference, referenceLink, spoiler, strikethrough, subscript, superscript, textMention, underline, } from "./inline.js";
+// every inline builder is dual-dialect: one node, two renders.
+function both(node) {
+    return [node.render("html"), node.render("markdown")];
+}
+test("wrapper marks render their token pair in each dialect", () => {
+    assert.deepEqual(both(bold("x")), ["<b>x</b>", "**x**"]);
+    assert.deepEqual(both(italic("x")), ["<i>x</i>", "*x*"]);
+    assert.deepEqual(both(strikethrough("x")), ["<s>x</s>", "~~x~~"]);
+    assert.deepEqual(both(spoiler("x")), ["<tg-spoiler>x</tg-spoiler>", "||x||"]);
+    assert.deepEqual(both(code("x")), ["<code>x</code>", "`x`"]);
+    assert.deepEqual(both(marked("x")), ["<mark>x</mark>", "==x=="]);
+});
+test("marks with no markdown token embed the raw html tag in both dialects", () => {
+    assert.deepEqual(both(underline("x")), ["<u>x</u>", "<u>x</u>"]);
+    assert.deepEqual(both(subscript("x")), ["<sub>x</sub>", "<sub>x</sub>"]);
+    assert.deepEqual(both(superscript("x")), ["<sup>x</sup>", "<sup>x</sup>"]);
+});
+test("string children are escaped per dialect, so user input cannot inject markup", () => {
+    assert.equal(bold("<i>&</i>").render("html"), "<b>&lt;i&gt;&amp;&lt;/i&gt;</b>");
+    assert.equal(bold("a*b_c").render("markdown"), "**a\\*b\\_c**");
+    // html-significant chars become numeric entities in markdown (a backslash would show).
+    assert.equal(bold("<&>").render("markdown"), "**&#60;&#38;&#62;**");
+});
+test("nested nodes render into the chosen dialect; siblings concatenate", () => {
+    const node = bold("a ", italic("b"), " c");
+    assert.equal(node.render("html"), "<b>a <i>b</i> c</b>");
+    assert.equal(node.render("markdown"), "**a *b* c**");
+});
+test("null/undefined/false children render as nothing — `cond && node` composes", () => {
+    const cond = false;
+    assert.equal(bold("a", null, undefined, cond && italic("b")).render("html"), "<b>a</b>");
+});
+test("array children are flattened and concatenated", () => {
+    assert.equal(bold(["a", ["b", italic("c")]]).render("html"), "<b>ab<i>c</i></b>");
+});
+test("number and bigint children are stringified then escaped", () => {
+    assert.equal(bold(42, "|", 10n).render("markdown"), "**42\\|10**");
+});
+test("br() is a hard newline in markdown, <br/> in html", () => {
+    assert.deepEqual(both(br()), ["<br/>", "\n"]);
+});
+test("link() escapes the url per dialect so a hostile url cannot break out", () => {
+    assert.equal(link('https://x.dev/?a=1&b="2"', "t").render("html"), '<a href="https://x.dev/?a=1&amp;b=&quot;2&quot;">t</a>');
+    assert.equal(link("https://x.dev/a) b", "t").render("markdown"), "[t](https://x.dev/a\\)%20b)");
+});
+test("textMention() links tg://user?id=… in both dialects", () => {
+    assert.deepEqual(both(textMention({ id: 7 }, "dave")), [
+        '<a href="tg://user?id=7">dave</a>',
+        "[dave](tg://user?id=7)",
+    ]);
+});
+test("anchor()/anchorLink() — jump target and #link", () => {
+    assert.deepEqual(both(anchor("top")), ['<a name="top"></a>', '<a name="top"></a>']);
+    assert.deepEqual(both(anchorLink("top", "up")), ['<a href="#top">up</a>', "[up](#top)"]);
+});
+test("customEmoji() — tg-emoji tag / tg://emoji image link", () => {
+    assert.deepEqual(both(customEmoji("5368324170671202286", "👍")), [
+        '<tg-emoji emoji-id="5368324170671202286">👍</tg-emoji>',
+        "![👍](tg://emoji?id=5368324170671202286)",
+    ]);
+});
+test("math() keeps LaTeX raw in markdown, html-escapes it in html", () => {
+    assert.deepEqual(both(math("a_1 < b")), ["<tg-math>a_1 &lt; b</tg-math>", "$a_1 < b$"]);
+});
+test("dateTime() — best-effort <time> / tg://time image link", () => {
+    assert.deepEqual(both(dateTime(1735689600, "R", "soon")), [
+        '<time datetime="1735689600" data-format="R">soon</time>',
+        "![soon](tg://time?unix=1735689600&format=R)",
+    ]);
+});
+test("reference()/referenceLink() — tg-reference tags / markdown footnote syntax", () => {
+    assert.deepEqual(both(reference("1", "the fine print")), [
+        '<tg-reference name="1">the fine print</tg-reference>',
+        "[^1]: the fine print",
+    ]);
+    assert.deepEqual(both(referenceLink("1", "see note")), [
+        '<tg-reference-link name="1">see note</tg-reference-link>',
+        "[^1]",
+    ]);
+});
+//# sourceMappingURL=inline.test.js.map

package/lib/inline.test.js.map

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

package/lib/node.d.ts

@@ -0,0 +1,25 @@
+/** the two wire dialects of `InputRichMessage` — `html` and `markdown`. */
+export type Dialect = "html" | "markdown";
+/** whether a node is an inline mark (bold, link, …) or a top-level block (paragraph, table, …). */
+export type Level = "inline" | "block";
+declare const RICH_NODE: unique symbol;
+/**
+ * one builder result — a dialect-agnostic fragment of a rich message. every
+ * builder (`bold`, `paragraph`, `table`, …) returns one of these; nothing is
+ * serialized until the node lands in an `html`/`md` template or a `document()`,
+ * which picks the dialect and calls `render` once.
+ */
+export interface RichNode {
+    readonly [RICH_NODE]: true;
+    readonly level: Level;
+    render(dialect: Dialect): string;
+}
+/** construct a `RichNode` from a level + per-dialect renderer. */
+export declare function makeNode(level: Level, render: (dialect: Dialect) => string): RichNode;
+export declare function isRichNode(value: unknown): value is RichNode;
+/** thrown on misuse — a dialect-mismatched interpolation, unsupported content. */
+export declare class RichError extends Error {
+    constructor(message: string);
+}
+export {};
+//# sourceMappingURL=node.d.ts.map

package/lib/node.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node.d.ts","sourceRoot":"","sources":["../src/node.ts"],"names":[],"mappings":"AAAA,2EAA2E;AAC3E,MAAM,MAAM,OAAO,GAAG,MAAM,GAAG,UAAU,CAAC;AAE1C,mGAAmG;AACnG,MAAM,MAAM,KAAK,GAAG,QAAQ,GAAG,OAAO,CAAC;AAKvC,QAAA,MAAM,SAAS,eAAiC,CAAC;AAEjD;;;;;GAKG;AACH,MAAM,WAAW,QAAQ;IACxB,QAAQ,CAAC,CAAC,SAAS,CAAC,EAAE,IAAI,CAAC;IAC3B,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;IACtB,MAAM,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAAC;CACjC;AAED,kEAAkE;AAClE,wBAAgB,QAAQ,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,MAAM,GAAG,QAAQ,CAErF;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,QAAQ,CAM5D;AAED,kFAAkF;AAClF,qBAAa,SAAU,SAAQ,KAAK;gBACvB,OAAO,EAAE,MAAM;CAI3B"}

package/lib/node.js

@@ -0,0 +1,21 @@
+// `Symbol.for` so two copies of the package in one node_modules tree still
+// recognise each other's nodes (a duck-typed `.html` check would false-positive
+// on any object that happens to carry an `html: string` field).
+const RICH_NODE = Symbol.for("yaebal.rich.node");
+/** construct a `RichNode` from a level + per-dialect renderer. */
+export function makeNode(level, render) {
+    return { [RICH_NODE]: true, level, render };
+}
+export function isRichNode(value) {
+    return (typeof value === "object" &&
+        value !== null &&
+        value[RICH_NODE] === true);
+}
+/** thrown on misuse — a dialect-mismatched interpolation, unsupported content. */
+export class RichError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "RichError";
+    }
+}
+//# sourceMappingURL=node.js.map

package/lib/node.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"node.js","sourceRoot":"","sources":["../src/node.ts"],"names":[],"mappings":"AAMA,2EAA2E;AAC3E,gFAAgF;AAChF,gEAAgE;AAChE,MAAM,SAAS,GAAG,MAAM,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAC;AAcjD,kEAAkE;AAClE,MAAM,UAAU,QAAQ,CAAC,KAAY,EAAE,MAAoC;IAC1E,OAAO,EAAE,CAAC,SAAS,CAAC,EAAE,IAAa,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;AACtD,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,KAAc;IACxC,OAAO,CACN,OAAO,KAAK,KAAK,QAAQ;QACzB,KAAK,KAAK,IAAI;QACb,KAAiC,CAAC,SAAS,CAAC,KAAK,IAAI,CACtD,CAAC;AACH,CAAC;AAED,kFAAkF;AAClF,MAAM,OAAO,SAAU,SAAQ,KAAK;IACnC,YAAY,OAAe;QAC1B,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,WAAW,CAAC;IACzB,CAAC;CACD"}

package/lib/plaintext.test.d.ts

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

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

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

package/lib/plaintext.test.js

@@ -0,0 +1,100 @@
+import assert from "node:assert/strict";
+import test from "node:test";
+import { richBlockToPlainText, richMessageToPlainText, richTextToPlainText } from "./plaintext.js";
+test("richTextToPlainText flattens a plain string, nested marks, and arrays", () => {
+    assert.equal(richTextToPlainText("hi"), "hi");
+    assert.equal(richTextToPlainText({ type: "bold", text: "hi" }), "hi");
+    assert.equal(richTextToPlainText([{ type: "bold", text: "a" }, " ", { type: "italic", text: "b" }]), "a b");
+});
+test("richTextToPlainText special-cases custom_emoji/mathematical_expression/anchor", () => {
+    assert.equal(richTextToPlainText({ type: "custom_emoji", alternative_text: "😀" }), "😀");
+    assert.equal(richTextToPlainText({ type: "mathematical_expression", expression: "a^2" }), "a^2");
+    assert.equal(richTextToPlainText({ type: "anchor", name: "top" }), "");
+});
+test("richTextToPlainText returns empty string for undefined", () => {
+    assert.equal(richTextToPlainText(undefined), "");
+});
+test("richBlockToPlainText flattens simple text-bearing blocks with a trailing newline", () => {
+    assert.equal(richBlockToPlainText({ type: "paragraph", text: "hi" }), "hi\n");
+    assert.equal(richBlockToPlainText({ type: "heading", text: "title", size: 1 }), "title\n");
+    assert.equal(richBlockToPlainText({ type: "pre", text: "code" }), "code\n");
+    assert.equal(richBlockToPlainText({ type: "footer", text: "f" }), "f\n");
+    assert.equal(richBlockToPlainText({ type: "thinking", text: "…" }), "…\n");
+    assert.equal(richBlockToPlainText({ type: "divider" }), "---\n");
+    assert.equal(richBlockToPlainText({ type: "anchor", name: "top" }), "");
+    assert.equal(richBlockToPlainText({ type: "mathematical_expression", expression: "a^2" }), "a^2\n");
+});
+test("richBlockToPlainText flattens a list, one `- ` item per line", () => {
+    const block = {
+        type: "list",
+        items: [
+            { blocks: [{ type: "paragraph", text: "one" }] },
+            { blocks: [{ type: "paragraph", text: "two" }] },
+        ],
+    };
+    assert.equal(richBlockToPlainText(block), "- one\n- two\n");
+});
+test("richBlockToPlainText flattens blockquote/pullquote with an optional ' — credit' suffix", () => {
+    assert.equal(richBlockToPlainText({
+        type: "blockquote",
+        blocks: [{ type: "paragraph", text: "x" }],
+    }), "x\n\n");
+    assert.equal(richBlockToPlainText({
+        type: "blockquote",
+        blocks: [{ type: "paragraph", text: "x" }],
+        credit: "author",
+    }), "x\n — author\n");
+    assert.equal(richBlockToPlainText({ type: "pullquote", text: "x" }), "x\n");
+    assert.equal(richBlockToPlainText({ type: "pullquote", text: "x", credit: "author" }), "x — author\n");
+});
+test("richBlockToPlainText flattens collage/slideshow blocks with a captioned trailer", () => {
+    const block = {
+        type: "collage",
+        blocks: [{ type: "photo", photo: [], caption: undefined }],
+        caption: { text: "a cat", credit: "photographer" },
+    };
+    assert.equal(richBlockToPlainText(block), "a cat (photographer)\n");
+});
+test("richBlockToPlainText flattens a table, ` | `-joined cells, one row per line", () => {
+    const block = {
+        type: "table",
+        cells: [
+            [{ text: "a" }, { text: "b" }],
+            [{ text: "c" }, { text: "d" }],
+        ],
+    };
+    assert.equal(richBlockToPlainText(block), "a | b\nc | d\n");
+});
+test("richBlockToPlainText flattens details as its summary followed by its blocks", () => {
+    const block = {
+        type: "details",
+        summary: "more",
+        blocks: [{ type: "paragraph", text: "hidden" }],
+    };
+    assert.equal(richBlockToPlainText(block), "more\nhidden\n");
+});
+test("richBlockToPlainText flattens map/media blocks down to just their caption", () => {
+    assert.equal(richBlockToPlainText({ type: "map", caption: { text: "here" } }), "here\n");
+    assert.equal(richBlockToPlainText({ type: "photo", photo: [], caption: undefined }), "");
+    for (const type of ["animation", "audio", "photo", "video", "voice_note"]) {
+        assert.equal(richBlockToPlainText({ type, caption: { text: "cap" } }), "cap\n");
+    }
+});
+test("richBlockToPlainText falls back to empty string for an unrecognized block type", () => {
+    assert.equal(richBlockToPlainText({ type: "not-a-real-type" }), "");
+});
+test("richMessageToPlainText flattens a full block tree, joined and trimmed", () => {
+    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=plaintext.test.js.map

package/lib/plaintext.test.js.map

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

package/lib/render.d.ts

@@ -0,0 +1,17 @@
+import { RichDocument } from "./document.js";
+import { type Dialect, type RichNode } from "./node.js";
+/**
+ * anything a builder or template accepts as content:
+ *
+ * - `string` / `number` / `bigint` — escaped for the target dialect, renders literally;
+ * - a `RichNode` (builder result) — rendered into the target dialect;
+ * - a `RichDocument` — inlined as-is (its dialect must match, else `RichError`);
+ * - `null` / `undefined` / `false` — empty string, so `cond && bold(…)` composes;
+ * - an array — each item rendered and concatenated.
+ */
+export type Insertable = RichNode | RichDocument | string | number | bigint | null | undefined | false | readonly Insertable[];
+/** escape plain text for a dialect so it can never be re-parsed as markup. */
+export declare function escapeFor(text: string, dialect: Dialect): string;
+/** resolve one piece of content into a dialect string (text escaped, nodes rendered). */
+export declare function render(value: Insertable, dialect: Dialect): string;
+//# sourceMappingURL=render.d.ts.map

package/lib/render.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"render.d.ts","sourceRoot":"","sources":["../src/render.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAE7C,OAAO,EAAE,KAAK,OAAO,EAAyB,KAAK,QAAQ,EAAE,MAAM,WAAW,CAAC;AAE/E;;;;;;;;GAQG;AACH,MAAM,MAAM,UAAU,GACnB,QAAQ,GACR,YAAY,GACZ,MAAM,GACN,MAAM,GACN,MAAM,GACN,IAAI,GACJ,SAAS,GACT,KAAK,GACL,SAAS,UAAU,EAAE,CAAC;AAEzB,8EAA8E;AAC9E,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,MAAM,CAEhE;AAED,yFAAyF;AACzF,wBAAgB,MAAM,CAAC,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,OAAO,GAAG,MAAM,CAuBlE"}

package/lib/render.js

@@ -0,0 +1,30 @@
+import { RichDocument } from "./document.js";
+import { escapeMarkdown, escapeText } from "./escape.js";
+import { isRichNode, RichError } from "./node.js";
+/** escape plain text for a dialect so it can never be re-parsed as markup. */
+export function escapeFor(text, dialect) {
+    return dialect === "html" ? escapeText(text) : escapeMarkdown(text);
+}
+/** resolve one piece of content into a dialect string (text escaped, nodes rendered). */
+export function render(value, dialect) {
+    if (value === null || value === undefined || value === false)
+        return "";
+    if (typeof value === "string")
+        return escapeFor(value, dialect);
+    if (typeof value === "number" || typeof value === "bigint") {
+        return escapeFor(String(value), dialect);
+    }
+    if (Array.isArray(value)) {
+        return value.map((item) => render(item, dialect)).join("");
+    }
+    if (value instanceof RichDocument) {
+        if (value.dialect !== dialect) {
+            throw new RichError(`cannot inline a ${value.dialect} document into a ${dialect} template`);
+        }
+        return value.content;
+    }
+    if (isRichNode(value))
+        return value.render(dialect);
+    throw new RichError(`unsupported rich content: ${typeof value}`);
+}
+//# sourceMappingURL=render.js.map

package/lib/render.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"render.js","sourceRoot":"","sources":["../src/render.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzD,OAAO,EAAgB,UAAU,EAAE,SAAS,EAAiB,MAAM,WAAW,CAAC;AAsB/E,8EAA8E;AAC9E,MAAM,UAAU,SAAS,CAAC,IAAY,EAAE,OAAgB;IACvD,OAAO,OAAO,KAAK,MAAM,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC;AACrE,CAAC;AAED,yFAAyF;AACzF,MAAM,UAAU,MAAM,CAAC,KAAiB,EAAE,OAAgB;IACzD,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,KAAK;QAAE,OAAO,EAAE,CAAC;IAExE,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,SAAS,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IAChE,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC5D,OAAO,SAAS,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC,CAAC;IAC1C,CAAC;IAED,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QAC1B,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,MAAM,CAAC,IAAkB,EAAE,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC1E,CAAC;IAED,IAAI,KAAK,YAAY,YAAY,EAAE,CAAC;QACnC,IAAI,KAAK,CAAC,OAAO,KAAK,OAAO,EAAE,CAAC;YAC/B,MAAM,IAAI,SAAS,CAAC,mBAAmB,KAAK,CAAC,OAAO,oBAAoB,OAAO,WAAW,CAAC,CAAC;QAC7F,CAAC;QAED,OAAO,KAAK,CAAC,OAAO,CAAC;IACtB,CAAC;IAED,IAAI,UAAU,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAEpD,MAAM,IAAI,SAAS,CAAC,6BAA6B,OAAO,KAAK,EAAE,CAAC,CAAC;AAClE,CAAC"}

package/lib/send.d.ts

@@ -1,6 +1,9 @@
 import type { Api, Context, Message, Plugin } from "@yaebal/core";
 import type { InputRichMessage } from "@yaebal/types";
+import { RichDocument } from "./document.js";
 import { RichMessageDraft, type RichMessageDraftOptions } from "./draft.js";
+/** everything the send/draft surface accepts: a template/`document()` result, a raw payload, or an html string. */
+export type RichSource = RichDocument | InputRichMessage | string;
 /**
  * `sendRichMessage` — standalone, no plugin install required (the `@yaebal/fmt` /
  * `@yaebal/keyboard` "pure helper" style). `extra` covers the rest of
@@ -9,16 +12,16 @@ import { RichMessageDraft, type RichMessageDraftOptions } from "./draft.js";
  * `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>;
+export declare function sendRichMessage(api: Api, chatId: number | string, input: RichSource, 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 declare function sendRichMessageDraft(api: Api, chatId: number, draftId: number, input: RichSource, 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>;
+    sendRichMessage(input: RichSource, extra?: Record<string, unknown>): Promise<Message>;
     /** open a `RichMessageDraft` streaming session bound to the current chat. */
     richMessageDraft(draftId: number, options?: RichMessageDraftOptions): RichMessageDraft;
 }