@bd7pil/ocrc 0.9.0

package/dist/transport/telegram/render/chunker.js

@@ -0,0 +1,71 @@
+import { createLogger } from "../../../utils/logger.js";
+const logger = createLogger("render");
+import { DEFAULT_MAX_PART_BLOCKS, DEFAULT_MAX_PART_CHARS, PLAIN_MAX_PART_CHARS, } from "./limits.js";
+import { countRichBlocks, countRichChars } from "./rich-blocks.js";
+import { splitTextIntoChunks } from "./text-splitter.js";
+const DEFAULT_BLOCK_SEPARATOR = "\n\n";
+/**
+ * Cuts text into parts that fit a plain Telegram text message. Used by raw
+ * format mode and by every degradation from native blocks to plain text.
+ */
+export function chunkPlainText(text, options) {
+    const maxChars = Math.max(1, Math.floor(options?.maxChars ?? PLAIN_MAX_PART_CHARS));
+    return splitTextIntoChunks(text, maxChars).map((chunk) => ({
+        blocks: [],
+        fallbackText: chunk,
+        source: "plain",
+    }));
+}
+/**
+ * Groups rendered blocks so that every group stays within both Telegram
+ * budgets. Blocks are expected to fit individually already (see
+ * `block-splitter.ts`); an oversize one lands in a group of its own.
+ */
+function groupRenderedBlocks(blocks, options) {
+    const maxChars = Math.max(1, Math.floor(options?.maxChars ?? DEFAULT_MAX_PART_CHARS));
+    const maxBlocks = Math.max(1, Math.floor(options?.maxBlocks ?? DEFAULT_MAX_PART_BLOCKS));
+    const groups = [];
+    let current = [];
+    let currentChars = 0;
+    let currentUnits = 0;
+    for (const rendered of blocks) {
+        const chars = countRichChars(rendered.block);
+        const units = countRichBlocks(rendered.block);
+        if (current.length > 0 &&
+            (currentChars + chars > maxChars || currentUnits + units > maxBlocks)) {
+            groups.push(current);
+            current = [];
+            currentChars = 0;
+            currentUnits = 0;
+        }
+        current.push(rendered);
+        currentChars += chars;
+        currentUnits += units;
+    }
+    if (current.length > 0) {
+        groups.push(current);
+    }
+    return groups;
+}
+/**
+ * Packs rendered blocks into messages, respecting both Telegram budgets:
+ * characters and block count.
+ */
+export function chunkTelegramRenderedBlocks(blocks, options) {
+    const parts = groupRenderedBlocks(blocks, options).map((group) => ({
+        blocks: group.map((rendered) => rendered.block),
+        fallbackText: group
+            .map((rendered) => rendered.plainText)
+            .filter(Boolean)
+            .join(DEFAULT_BLOCK_SEPARATOR),
+        source: "blocks",
+    }));
+    if (parts.length > 1) {
+        logger.debug("[TelegramRender] Rendered blocks chunked", {
+            blockCount: blocks.length,
+            partCount: parts.length,
+        });
+    }
+    return parts;
+}
+//# sourceMappingURL=chunker.js.map

package/dist/transport/telegram/render/chunker.js.map

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

package/dist/transport/telegram/render/limits.js

@@ -0,0 +1,13 @@
+/**
+ * Telegram rich messages allow 32768 characters and 500 blocks (nested blocks,
+ * list items, table rows and details bodies all count). Plain text messages are
+ * still capped at 4096 characters, so the two representations of the same
+ * content are chunked with different budgets.
+ */
+export const DEFAULT_MAX_PART_CHARS = 32000;
+export const DEFAULT_MAX_PART_BLOCKS = 480;
+/** Budget for text that is delivered as a plain Telegram message. */
+export const PLAIN_MAX_PART_CHARS = 3800;
+/** Hard Telegram limit for `sendMessage` / `editMessageText` / `sendMessageDraft` text. */
+export const TELEGRAM_TEXT_MESSAGE_LIMIT = 4096;
+//# sourceMappingURL=limits.js.map

package/dist/transport/telegram/render/limits.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"limits.js","sourceRoot":"","sources":["../../../../src/transport/telegram/render/limits.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,KAAK,CAAC;AAC5C,MAAM,CAAC,MAAM,uBAAuB,GAAG,GAAG,CAAC;AAE3C,qEAAqE;AACrE,MAAM,CAAC,MAAM,oBAAoB,GAAG,IAAI,CAAC;AAEzC,2FAA2F;AAC3F,MAAM,CAAC,MAAM,2BAA2B,GAAG,IAAI,CAAC"}

package/dist/transport/telegram/render/markdown-normalizer.js

@@ -0,0 +1,102 @@
+function isCodeFenceLine(line) {
+    return line.trimStart().startsWith("```");
+}
+function isHorizontalRuleLine(line) {
+    const normalized = line.trim();
+    if (!normalized) {
+        return false;
+    }
+    return /^([-*_])(?:\s*\1){2,}$/.test(normalized);
+}
+function isHeadingLine(line) {
+    return /^\s{0,3}#{1,6}\s+\S/.test(line);
+}
+function normalizeHeadingLine(line) {
+    const match = line.match(/^\s{0,3}#{1,6}\s+(.+?)\s*$/);
+    const heading = match?.[1];
+    if (!heading) {
+        return line;
+    }
+    return `**${heading}**`;
+}
+function normalizeChecklistLine(line) {
+    const match = line.match(/^(\s*)(?:[-+*]|\d+\.)\s+\[( |x|X)\]\s+(.*)$/);
+    const indent = match?.[1];
+    const checked = match?.[2];
+    const rest = match?.[3];
+    if (indent === undefined || checked === undefined || rest === undefined) {
+        return null;
+    }
+    const marker = checked.toLowerCase() === "x" ? "✅" : "🔲";
+    return `${indent}${marker} ${rest}`;
+}
+function normalizeMarkdown(text, options) {
+    const lines = text.split("\n");
+    const output = [];
+    let inCodeFence = false;
+    let inQuote = false;
+    for (let index = 0; index < lines.length; index++) {
+        const line = lines[index];
+        if (line === undefined) {
+            continue;
+        }
+        if (isCodeFenceLine(line)) {
+            inCodeFence = !inCodeFence;
+            inQuote = false;
+            output.push(line);
+            continue;
+        }
+        if (inCodeFence) {
+            output.push(line);
+            continue;
+        }
+        if (!line.trim()) {
+            inQuote = false;
+            output.push(line);
+            continue;
+        }
+        if (isHeadingLine(line)) {
+            output.push(options.preserveBlockMarkup ? line : normalizeHeadingLine(line));
+            inQuote = false;
+            continue;
+        }
+        if (isHorizontalRuleLine(line)) {
+            output.push(options.preserveBlockMarkup ? line : "──────────");
+            inQuote = false;
+            continue;
+        }
+        const trimmedLeft = line.trimStart();
+        if (trimmedLeft.startsWith(">")) {
+            inQuote = true;
+            const quoteContent = trimmedLeft.replace(/^>\s?/, "");
+            const normalizedChecklistInQuote = normalizeChecklistLine(quoteContent);
+            output.push(normalizedChecklistInQuote && !options.preserveBlockMarkup
+                ? `> ${normalizedChecklistInQuote.trimStart()}`
+                : `> ${quoteContent.trimStart()}`);
+            continue;
+        }
+        const normalizedChecklist = normalizeChecklistLine(line);
+        if (normalizedChecklist) {
+            if (options.preserveBlockMarkup) {
+                output.push(inQuote ? `> ${trimmedLeft}` : line);
+            }
+            else {
+                output.push(inQuote ? `> ${normalizedChecklist.trimStart()}` : normalizedChecklist);
+            }
+            continue;
+        }
+        if (inQuote) {
+            output.push(`> ${trimmedLeft}`);
+            continue;
+        }
+        output.push(line);
+    }
+    return output.join("\n");
+}
+export function normalizeMarkdownForTelegramRendering(text) {
+    return normalizeMarkdown(text, { preserveBlockMarkup: false });
+}
+export function normalizeMarkdownForTelegramBlockParsing(text) {
+    return normalizeMarkdown(text, { preserveBlockMarkup: true });
+}
+//# sourceMappingURL=markdown-normalizer.js.map

package/dist/transport/telegram/render/markdown-normalizer.js.map

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

package/dist/transport/telegram/render/markdown-to-telegram-v2.js

@@ -0,0 +1,116 @@
+import { parseTelegramBlocks } from "./block-parser.js";
+import { normalizeMarkdownForTelegramRendering } from "./markdown-normalizer.js";
+/**
+ * Escapes characters reserved in Telegram MarkdownV2.
+ * These must be escaped everywhere except when used as syntactic delimiters
+ * we intentionally emit (e.g. the surrounding * of bold).
+ */
+function escapeMarkdownV2(text) {
+    return text.replace(/([_*[\]()~`>#+\-=|{}.!\\])/g, "\\$1");
+}
+function escapeMarkdownV2Code(text) {
+    return text.replace(/([`\\])/g, "\\$1");
+}
+function escapeMarkdownV2LinkUrl(text) {
+    return text.replace(/([)\\])/g, "\\$1");
+}
+function renderInlineNodes(nodes) {
+    return nodes
+        .map((node) => {
+        switch (node.type) {
+            case "text":
+                return escapeMarkdownV2(node.text);
+            case "bold":
+                return `*${renderInlineNodes(node.children)}*`;
+            case "italic":
+                return `_${renderInlineNodes(node.children)}_`;
+            case "strike":
+                return `~${renderInlineNodes(node.children)}~`;
+            case "code":
+                return `\`${escapeMarkdownV2Code(node.text)}\``;
+            case "link":
+                return `[${renderInlineNodes(node.text)}](${escapeMarkdownV2LinkUrl(node.url)})`;
+            case "underline":
+                return `__${renderInlineNodes(node.children)}__`;
+            case "spoiler":
+                return `||${renderInlineNodes(node.children)}||`;
+            // MarkdownV2 has no counterpart for these, so only the content survives.
+            case "subscript":
+            case "superscript":
+            case "marked":
+                return renderInlineNodes(node.children);
+            default:
+                return escapeMarkdownV2(String(node));
+        }
+    })
+        .join("");
+}
+function renderBlock(block) {
+    switch (block.type) {
+        case "paragraph":
+            return renderInlineNodes(block.inlines);
+        case "heading": {
+            const content = renderInlineNodes(block.inlines);
+            return `*${content}*`;
+        }
+        case "blockquote":
+            return block.blocks
+                .map(renderBlock)
+                .filter(Boolean)
+                .map((rendered) => rendered
+                .split("\n")
+                .map((line) => `> ${line}`)
+                .join("\n"))
+                .join("\n");
+        case "list":
+            return block.items
+                .map((item, index) => {
+                const marker = block.ordered ? `${(block.start ?? 1) + index}\\. ` : "\\- ";
+                const taskPrefix = item.checked === true ? "✅ " : item.checked === false ? "🔲 " : "";
+                const body = item.blocks.map(renderBlock).filter(Boolean).join("\n");
+                const continuation = " ".repeat(marker.length);
+                return `${taskPrefix}${body}`
+                    .split("\n")
+                    .map((line, lineIndex) => `${lineIndex === 0 ? marker : continuation}${line}`)
+                    .join("\n");
+            })
+                .join("\n");
+        case "code":
+            return `\`\`\`${escapeMarkdownV2Code(block.language ?? "")}\n${escapeMarkdownV2Code(block.text)}\n\`\`\``;
+        case "table": {
+            if (block.rows.length === 0) {
+                return "";
+            }
+            const headerRow = block.rows[0];
+            if (!headerRow) {
+                return "";
+            }
+            const header = `\\| ${headerRow.map(escapeMarkdownV2).join(" \\| ")} \\|`;
+            const separator = `\\| ${headerRow.map(() => "\\-\\-\\-").join(" \\| ")} \\|`;
+            const body = block.rows
+                .slice(1)
+                .map((row) => `\\| ${row.map(escapeMarkdownV2).join(" \\| ")} \\|`);
+            return [header, separator, ...body].join("\n");
+        }
+        case "rule":
+            return "---";
+        case "plain":
+            return escapeMarkdownV2(block.text);
+    }
+}
+/**
+ * Converts standard Markdown into Telegram MarkdownV2.
+ *
+ * Uses the project's existing block parser (unified/remark) so that
+ * headings, lists, tables, code blocks, etc. are handled consistently
+ * with the entity-based Telegram renderer.
+ */
+export function convertToTelegramMarkdownV2(markdown) {
+    const normalized = normalizeMarkdownForTelegramRendering(markdown);
+    const blocks = parseTelegramBlocks(normalized);
+    if (blocks.length === 0) {
+        return "";
+    }
+    return blocks.map(renderBlock).join("\n\n");
+}
+//# sourceMappingURL=markdown-to-telegram-v2.js.map

package/dist/transport/telegram/render/markdown-to-telegram-v2.js.map

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

package/dist/transport/telegram/render/part-signature.js

@@ -0,0 +1,14 @@
+/**
+ * Stable identity of what was actually delivered to Telegram. The streamer
+ * compares signatures to skip unchanged edits, so the signature must describe
+ * the representation that was sent, not the one that was rendered.
+ */
+export function getTelegramRenderedPartSignature(part) {
+    if (part.source === "plain" || part.blocks.length === 0) {
+        // Reasoning keeps the same text when it collapses, only the entity changes.
+        const entities = part.entities?.length ? JSON.stringify(part.entities) : "";
+        return `plain\n${entities}\n${part.fallbackText}`;
+    }
+    return `blocks\n${JSON.stringify(part.blocks)}`;
+}
+//# sourceMappingURL=part-signature.js.map

package/dist/transport/telegram/render/part-signature.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"part-signature.js","sourceRoot":"","sources":["../../../../src/transport/telegram/render/part-signature.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,MAAM,UAAU,gCAAgC,CAC9C,IAAmF;IAEnF,IAAI,IAAI,CAAC,MAAM,KAAK,OAAO,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxD,4EAA4E;QAC5E,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QAC5E,OAAO,UAAU,QAAQ,KAAK,IAAI,CAAC,YAAY,EAAE,CAAC;IACpD,CAAC;IAED,OAAO,WAAW,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;AAClD,CAAC"}

package/dist/transport/telegram/render/pipeline.js

@@ -0,0 +1,23 @@
+import { parseTelegramBlocks } from "./block-parser.js";
+import { toBlockPlainText } from "./block-plain-text.js";
+import { splitOversizeTelegramBlocks } from "./block-splitter.js";
+import { chunkTelegramRenderedBlocks } from "./chunker.js";
+import { liftTextListContent, toRichBlock } from "./rich-blocks.js";
+/**
+ * Lifts native content out of lists that are written as text, splits blocks
+ * that exceed the per-message budgets, then pairs every block with its native
+ * rich form and its plain-text projection.
+ */
+export function toRenderedBlocks(blocks, limits) {
+    return splitOversizeTelegramBlocks(liftTextListContent(blocks), limits).map((block) => ({
+        block: toRichBlock(block),
+        plainText: toBlockPlainText(block),
+    }));
+}
+export function renderTelegramBlocks(markdown, limits) {
+    return toRenderedBlocks(parseTelegramBlocks(markdown), limits);
+}
+export function renderTelegramParts(markdown, options) {
+    return chunkTelegramRenderedBlocks(renderTelegramBlocks(markdown, options), options);
+}
+//# sourceMappingURL=pipeline.js.map

package/dist/transport/telegram/render/pipeline.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipeline.js","sourceRoot":"","sources":["../../../../src/transport/telegram/render/pipeline.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,2BAA2B,EAAyB,MAAM,qBAAqB,CAAC;AACzF,OAAO,EAAE,2BAA2B,EAA+B,MAAM,cAAc,CAAC;AACxF,OAAO,EAAE,mBAAmB,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAIpE;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAC9B,MAAuB,EACvB,MAAkC;IAElC,OAAO,2BAA2B,CAAC,mBAAmB,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QACtF,KAAK,EAAE,WAAW,CAAC,KAAK,CAAC;QACzB,SAAS,EAAE,gBAAgB,CAAC,KAAK,CAAC;KACnC,CAAC,CAAC,CAAC;AACN,CAAC;AAED,MAAM,UAAU,oBAAoB,CAClC,QAAgB,EAChB,MAAkC;IAElC,OAAO,gBAAgB,CAAC,mBAAmB,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,CAAC;AACjE,CAAC;AAED,MAAM,UAAU,mBAAmB,CACjC,QAAgB,EAChB,OAAgC;IAEhC,OAAO,2BAA2B,CAAC,oBAAoB,CAAC,QAAQ,EAAE,OAAO,CAAC,EAAE,OAAO,CAAC,CAAC;AACvF,CAAC"}